[kimi-agent-bot]

Requirement or Bug

修复 Web 会话中远程 HTTP(S) 图片偶现无法显示的问题，同时覆盖非回环 CSP、HTTPS 混合内容和远程浏览器无法访问 daemon 内网地址的场景。

Bug Reproduction Steps

1. 在回复正文中放入一张位于 daemon 内网的 HTTP 图片。
2. 非回环页面的 img-src 'self' data: blob: 会阻止该外部图片源；官方 Remote Control 的 HTTPS 页面还存在混合内容限制。
3. 远程浏览器即使放开 CSP，也可能无法路由到该内网地址，图片始终无法显示。

Root Cause

直接让浏览器加载远程 URL 同时受 CSP、页面协议和网络可达性约束，逐主机配置无法成为通用方案。本次由 daemon 获取并校验图片，再写入目标会话的媒体存储；前端只使用同源媒体，因此三类限制在同一资源模型下解决，不是继续放宽 img-src。

Code Changes

Markdown renderer 解析远程图片目标
  → image node 自动调用 resolver
  → POST /api/v1/sessions/{session_id}/media {url}
  → 协议、目标地址、重定向、超时和响应大小校验
  → 写入该 session 的 ISessionMediaStore
  → 既有 GET /sessions/{session_id}/media/{file_id} 返回同源内容

• 新增远程媒体创建路由，复用既有 session media 存储和下载路径。
• 允许明确需要的 RFC1918 私网图片，阻断回环、链路本地、组播及常见云元数据入口；每次重定向都重新校验。
• 代理按当前 URL 的实际协议覆盖和 NO_PROXY 决定；代理请求只连接已验证 IP，HTTP Host 与 HTTPS SNI 保留原域名。未配置可用代理、代理 URL 无效或命中 NO_PROXY 时固定 DNS，异常凭证按无效配置处理。
• DNS、重定向和正文读取共享 10 秒总预算；响应限制 10 MiB，最多 3 次重定向。
• 不转发 Cookie 或 Authorization，不信任 Content-Type，拒绝 HTML、SVG 和非支持格式。
• 以 URL 和实际图片字节生成确定性 fileId；同内容去重，内容变化生成新媒体记录，重复创建的 created_at 保留首次写入时间。
• 业务错误沿用 HTTP 200 和标准错误信封，与现有 JSON API 约定一致。
• 补充 undici 显式依赖、API surface 快照及中英文 server-api.md 参考；文档明确 Web Markdown 渲染会自动调用该端点，可能访问 daemon 可达的内网地址。
• 从 kimi-code-app b9b570d4 构建并同步 dist-web，使打包后的 kimi web 包含 renderer 自动加载、合法 Markdown 目标、raw HTML <img src> 属性解析与 parser token 上下文过滤、resolver 换代重取、重复图片缓存以及共享后台请求预算。dist 构建的 kc 基线为 979304401。

Behavior Changes and Affected Users

Behavior	Before	After	Who relies on the old behavior	Escape hatch
远程 HTTP(S) 图片加载	原地址直接进入图片加载路径，受 CSP、混合内容和网络可达性影响	渲染时自动经 daemon 转存并显示	使用内网 Web 和官方 Remote Control 的用户	转存失败保留原始来源及普通图片错误行为
daemon 网络请求	渲染远程图片不会主动经 daemon 取图	渲染即请求，可能访问 daemon 可达的 RFC1918 地址；切换会话会取消客户端读取，media POST 与 blob GET 共享后台预算，最多两个在途请求	会话正文包含远程图片的用户	无独立开关；@qilongyu 已明确选择自动加载方案，保留目标、重定向、超时、大小与格式限制
私网及特殊目标	内网地址能否显示取决于浏览器环境	允许 RFC1918；阻断回环、链路本地、组播及其他高风险目标，重定向逐跳复查	需要 daemon 内网图片的用户	不支持的地址返回 40001，不改为浏览器直连
代理与 DNS	没有该路径	代理连接使用已验证 IP 并保留 Host/SNI；直连、无效代理和 NO_PROXY 固定 DNS	使用 HTTP(S)/SOCKS 代理或直连的部署	不需要
响应格式和大小	没有该校验	仅接受 PNG、JPEG、GIF、WebP、AVIF，且不超过 10 MiB	依赖图片预览的用户	其他类型返回明确错误，不返回 HTML 或 SVG
重复图片与历史重挂	每个组件实例各自请求	并发和完成结果复用，成功结果进入有界历史缓存，created_at 保留首次写入时间	重复图片、长会话和窗口化历史	不需要
既有 session media 下载	按 fileId 下载	不变	既有附件、工具图片和历史会话	不需要

验证：

• 服务端 5 个聚焦测试文件、64 条用例通过，覆盖代理目标 IP、Host 非默认端口与 IPv6 authority、SNI、异常凭证、同源下载、去重、创建时间保持、HTML、超限、非法目标、重定向循环、API surface 和代理真值表。
• agent-core-v2 与 kap-server typecheck、变更文件 lint 通过；中英文文档 vitepress build 通过。
• 前端定向 42 条、app-core + app-markdown 全量 123 文件/1951 条、typecheck 和 lint 通过。
• b9b570d4 最终 dist 非回环生产页面：Markdown、单引号、等号空白和 & 共 4 张 640×360 图片零点击显示；原 URL 浏览器请求为 0，仅 2 个唯一 URL 经 daemon 转存，重载增量取图 2 次且媒体 ID 稳定，代码示例、引用缩进与转义文本不改写，Console 为空。
• 同一最终 dist 官方 code-rc.kimi.com 页面：上述指标全部一致，4 张图均为 data: 显示且零点击，代码示例与转义文本保留原文。

Checklist

• I have read the CONTRIBUTING document.
• I have linked a related issue, or explained the problem above.
• I have added tests that prove my feature works.
• The behavior-change table above is complete, and every removed behavior or flipped default is named in the changeset and either has an escape hatch or was explicitly approved by a maintainer in this PR.
• Ran gen-changesets skill and included the approved patch changeset.
• Ran gen-docs workflow and updated the bilingual server-api.md reference.

[changeset-bot]

🦋 Changeset detected

Latest commit: e8ab62a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@moonshot-ai/kimi-code	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-27T08:21:53.043885Z	ab1b924	Manual request

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[pkg-pr-new]

pnpm dlx https://pkg.pr.new/@moonshot-ai/kimi-code@e8ab62a

npx https://pkg.pr.new/@moonshot-ai/kimi-code@e8ab62a

commit: e8ab62a

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 295de97d50

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5015f346e4

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a61d1f9c07

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Chef's kiss.

Reviewed commit: f25f5f53f4

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c6d1965c0f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f29ccfba20

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kimi-agent-bot]

@codex review
已 resolve 的主题代表我们的判断取舍与当前代码现状，请勿重复提出（其余约定同首轮）。

[chatgpt-codex-connector]

💡 Codex Review

kimi-code/packages/agent-core-v2/src/_base/utils/proxy.ts

Line 111 in ab1b924

return resolveSocksProxy(env) !== undefined;

捕获非法 SOCKS 凭据的解码异常

当仅配置 ALL_PROXY=socks5://user:%ZZ@proxy:1080（或其他凭据含非法百分号转义的 SOCKS 变量）时，这个新调用会让 resolveSocksProxy 中的 decodeURIComponent 抛出 URIError，因此 session-media 端点在发起请求前就返回 50001；启动时的 createProxyDispatcher 对同一配置却会捕获异常并按约定回退直连。此前 HTTP %ZZ 修复之外的新证据是 SOCKS-only 分支没有经过 isValidHttpProxyUrl，请在这里同样验证或捕获解码失败并保留固定 DNS 的直连回退。

AGENTS.md reference: AGENTS.md:L127-L129

---

https://github.com/MoonshotAI/kimi-code/blob/ab1b92427bc8095b191a840e03567c180ac22435/apps/kimi-code/dist-web/assets/index-Cunl79RR.js#L589
解析合法的 raw HTML 图片属性

在已提交的 Web bundle 中，这个扫描器只识别精确的双引号形式 src="..."；当模型输出同样合法且常见的 <img src='https://...'>、src = "..." 或包含 HTML 实体的 URL 时，resolver 不会运行，标签仍直接请求远端。非回环 CSP、HTTPS 混合内容或远程浏览器无法访问 daemon 内网的场景下，这些 raw HTML 图片仍然无法显示；请在 code-app 源码中按 HTML 属性语义解析并重新同步 bundle。

AGENTS.md reference: AGENTS.md:L18-L18

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".