You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
All repository documentation is available in Japanese. | 仓库所有文档都提供日文版本 #6072
Activity
[-]仓库所有文档都提供日文版本[/-][+]All repository documentation is available in Japanese. | 仓库所有文档都提供日文版本[/+]ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
🔍 查重结论:不重复。 与已合并的 #6000 / #6001 / #6004 相关但不同 —— 那三个已完成日文 README(
README.ja.md,731 行)并确立了根目录README.<locale>.md的例外规则,且 PR #6004 明确把「其余文档」留给后续 follow-up。本 issue 正是那个后续:把日文覆盖从 README 扩到全仓文档。机制不同(locale 例外规则 vs 全量文档翻译),单独立项合理。现状盘点(已在最新 master 上核对,非旧快照):
README.ja.md已有([PR] docs: add Japanese README (#6000) #6004)。docs/下 architecture 枢纽 + 9 个模块页、clients、technical-notes、message-identity、session-identity、session-identity-resolution、identity-channels、msgid-infrastructure、opencode-responses-websocket、index、README(dir),以及根目录几个 redirect stub(CLIENTS / CONFIGURATION / MESSAGE-IDENTITY / SESSION-IDENTITY / TECHNICAL-NOTES)。docs/configuration.md(58K 词)由website/config-reference/*.yaml+tools/gen-config-docs.mjs生成,还牵动 website UI 的 en/zh i18n(main.js/index.html)与 ci.yml:553 的确定性检查。reference/*构造流程(release / testing / architecture / design-decisions / env-vars 等 ~16K)、少数暂无 zh 的 docs(lifecycle / plugin-protocol / auto-merge-guardrails / unified-loop-spec ~9K)。方案(命名沿用 README.ja.md 已定的
.ja.md短 locale;既有.zh-CN.md与.ja.md不一致属历史遗留,本次不强行统一):.ja.md,登记进docs/index.md+docs/index.zh-CN.md,并在页面语言链接加「日本語」。按章节分批提交到同一个针对 All repository documentation is available in Japanese. | 仓库所有文档都提供日文版本 #6072 的长期 PR,CI 把关。desc_ja/site_ja+ website UI i18n + ci 确定性检查。工作量最大的一块。🔶 需要决策(仅一个边界,不阻塞开工)
reference/*要不要一并出日文版?标签:documentation / scope/docs / p3(纯文档本地化的功能补齐,非缺陷、不影响可用性 → p3)。注:本环境镜像标签接口返回「endpoint not implemented」、
tools/add-label.sh也不在 tools/ 下,无法程序化打标,故在此写明意图供你/平台补打。我现在开始 Phase 1 第一批(「身份与协议」整章:docs/README、index、message-identity、session-identity、session-identity-resolution、identity-channels、msgid-infrastructure、opencode-responses-websocket),完成后回帖 PR 链接。
ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
进度更新 · 第 1 批已交付
PR 已开:#6076 — #6076 (标签
documentation+p3,按本 PR diff 独立判定)。分支2026-11-10_japanese-docs,后续批次继续往同一分支追加提交(一个 thread 一个 PR)。本批范围(身份与协议 section,4 篇)
docs/session-identity-resolution.ja.mddocs/identity-channels.ja.mddocs/msgid-infrastructure.ja.mddocs/opencode-responses-websocket.ja.mddocs/index.md/docs/index.zh-CN.md:新增译文行各补一条[日本語]链接。顺手小修:
README.ja.md(#6004 已加)此前从未在 index 里被引用,这次在 README 行补上[日本語](../README.ja.md),与其它语言保持一致、可被发现。约定(沿用 #6004
README.ja.md先例).ja.md(短 BCP47),对齐最新 owner 决定;.zh-CN.md若属精简/重排过,日文不继承那些缺口。CI 安全:纯文档改动,无 config / wire / 代码变更、无新 env var;文件不在
docs/architecture/下,architecture-docs守卫不受影响;未动gen-config-docs.mjs产物,docs-sync确定性检查不受影响。剩余路线(同分支后续批次)
message-identity、session-identityclients、technical-notes;architecturehub + 各模块页(需同步改tools/check-architecture-docs.mjs接受.ja.mdslug)lifecycle、auto-merge-guardrails、unified-loop-spec、plugin-protocol、reference/*configuration.md(扩展tools/gen-config-docs.mjs+ci.yml那行确定性检查)🔶 需要决策
CHANGELOG.md、AGENTS.md、reference/*。AGENTS.md/CHANGELOG.md是面向贡献者/发版的活文档,日文化后每次更新都要跟翻、易漂移;reference/*是惰性加载的施工参考,读者本就是开发者。CHANGELOG/AGENTS长期维护负担明显上升。configuration.md)。若不回复,我按 A 推进、不停工。我继续往下译并追加到 #6076。
docs: add Japanese translations for message-identity & session-identi…
ranxianglei commentedon Nov 10, 2026
[bot] 🏷 (ai: vllm-qwen/qwen3.8-27b)
身份与协议板块收尾完成 —— 该章 6 篇日文本现已齐全。
PR #6076(本 issue 唯一长期 PR)又追加了一个提交
f1c13181:#6076
本次新增 2 篇(补齐该章):
docs/message-identity.ja.md(含 wire-bytes 代码块,逐字节与英文源一致)docs/session-identity.ja.mddocs/index.md/docs/index.zh-CN.md:这两行各补[日本語]链接。至此「身份与协议」整章 6 篇全部译出并登记:opencode-responses-websocket / session-identity-resolution / identity-channels / msgid-infrastructure / message-identity / session-identity。质量对账通过——EN↔JA 标题数、代码块数、表格列、issue 引用数逐项一致,围栏代码逐字节相等,扫过中文残留词与列表缩进均干净。
一个插曲(已妥善处理,无损失):本轮动手前发现分支上其实已有前几轮推送的提交 + 4 个质量修复(恢复漏掉的
responsesCodec名、列表项空格、图表缩进对齐、index 语言标签交叉修正)。我没有强推覆盖,而是把本地重置回远端最新(完整保留那 4 个修复),再把这 2 篇新译文以新提交 fast-forward 叠上去——历史线性、无 force-push、无丢失。CI:上一 head(fa31da6e)的快速门禁已全绿(docs-sync / config-surface-guard / lifecycle-ledger-guard / unused-exports 等);新 head 的检查刚触发、镜像缓存还没刷到它。纯 markdown 变更,无 config/wire/env 改动,功能风险为零。
🔶 决策仍待你一句(同 floor 3/4,不阻塞进行中工作):根级运维文件
CHANGELOG.md/AGENTS.md/reference/*默认保持英文不译(无中文先例、维护负担高)。要其中某些也出日文,点一下即可。我继续往下做「工程与运维」批(先 lifecycle / auto-merge-guardrails / unified-loop-spec / plugin-protocol,再啃 clients / technical-notes 两大篇),陆续追加到 #6076。
docs: add Japanese version of the docs directory landing page (#6072)
ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
进度更新 · 身份与协议部分已全部完成
PR #6076 当前 head
9ceb10f(已提交并推送):已完成
docs/README.ja.md(忠实镜像英文版),并在两个 index 的对应行补了日文链接index.md/index.zh-CN.md里所有已完成条目都挂了[日本語]链接CI(新 head 实测):快速门全绿(docs-sync / docs-coverage / architecture-docs / config-surface-guard / lifecycle-ledger-guard 等),0 失败,仅完整 test 分片还在跑。纯文档新增不影响代码测试。分支目前落后 master 几步,合并前我会 rebase。
范围修正(重要)
我上一条说"接下来做工程与运维"——细看后要修正:该分区里只有
technical-notes有中文版;lifecycle/auto-merge-guardrails/unified-loop-spec都没有中文版(刻意单语:auto-merge-guardrails 本就是中文专属的证据附录)。身份分区里的plugin-protocol同样无中文版(标注"实验性,无中文版")。所以这 4 篇不算核心日文工作,归入下方"默认排除"档。剩余在范围内(已有 en+zh、尚缺 ja)
clients.md(约 1.15 万词,大)technical-notes.md(约 1.1 万词,大)architecture总览页 + 9 个模块页(需扩展tools/check-architecture-docs.mjs接受.ja.mdslug;图的问题见下)configuration.md(生成物,见下)另:根目录 5 个重定向占位(CLIENTS / CONFIGURATION / MESSAGE-IDENTITY / SESSION-IDENTITY / TECHNICAL-NOTES)随各自目标一起补。
两个实现子问题(附建议,供拍板一并看)
.ja.svg。建议先复用现有图、页面加一行"图参照英文版",不重画 10 张矢量图(图内多为英文标识符,重画成本高价值低);要高保真再单独排期出 ja 版。configuration.md由tools/gen-config-docs.mjs从website/config-reference/*.yaml生成。正确做法是扩生成器 + 提供 ja 源串;否则只能手写一份快照,后续配置变更会漂移且不受守卫。建议这篇走生成器扩展或暂缓,单列处理。🔶 需要决策
CHANGELOG.md/AGENTS.md/reference/*及那 4 篇无中文文件。工作量可控、三语对齐、尊重既有单语设计。下一条我继续啃
clients.md。ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
本轮收工确认(上一条是详细展开,这里给结论):
docs/README.ja.md,均已提交并推送到 PR [PR] docs: add Japanese versions of repository documentation (#6072) #6076(head9ceb10f,工作树干净)。index.md/index.zh-CN.md对应行都补了[日本語]链接。clients.md(约 1115 行、代码标识符密集,单独一轮做以保证质量),随后 technical-notes → architecture → configuration。ranxianglei commentedon Nov 10, 2026
主要搞readme和docs即可 AGENTS.md是给llm看的 不需要日文
建议一个pr搞定 不要拆分
ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
收到,范围锁定:
docs/;AGENTS.md(给 LLM 看的)不出日文 —— 明白,排除。据此,剩余待做(全部进 #6076):
clients.md(约 1.1 万词,大)← 现在就开始technical-notes.md(约 1.1 万词)architecture总览页 + 9 个模块页(需扩展tools/check-architecture-docs.mjs收.ja.mdslug;图沿用英文版并加一行说明,不重画矢量图)configuration.md(生成物,走生成器扩展或单列处理)边界确认(若与你意图不符请纠正):
CHANGELOG.md与reference/*不在"readme + docs"范围内,默认不做;docs/里那 4 篇刻意单语、无中文版的(lifecycle/auto-merge-guardrails/plugin-protocol/unified-loop-spec)也默认保持英文。需要哪篇再单独说。现在开始啃
clients.md。ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
进度汇报(刚才进程在生成大文件时超时被重启,已恢复,继续推进):
已完成并推送(PR #6076,head
9ceb10f,CI 快速门全绿、0 失败):docs/README.ja.md[日本語]链接当前在做:
clients.md—— 全仓最大的一篇(约 1.1 万词 / 1115 行,670 个内联代码段、5 张表、3 个代码块、80 处 issue 引用)。刚才一次性整篇生成导致超时,改为分段写入避免再卡。你定的范围我照办:只做 README + docs/,
AGENTS.md排除,一个 PR 不拆分。剩余顺序:clients.md(现在)→technical-notes.md→architecture总览+9 模块页(需扩展check-architecture-docs.mjs收.ja.md)→configuration.md(生成物)。继续,稍后交付
clients.ja.md。ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
进度汇报(刚被强制重启过一次,原因是单个超大块生成超时——已改用小块追加,不会再卡):
已交付(PR #6076,head
9ceb10f,CI 绿):docs/目录落地页,均已提交推送。正在做:
clients.md(全仓最大的一篇,约 1100 行 / 1.1 万词)。当前磁盘状态已核实:下一步:把 OpenCode 一节拆成 3 个小块追加 → 全文做中英一致性校验(标题数/代码块/表格列/issue 引用逐项对账)→ 修掉几处已知笔误 → 在两份 index 注册
[日本語]链接 → 提交推送(自动更新 PR #6076)。范围按你定的执行:只做 README + docs/,AGENTS.md 不做,全部收进同一个 PR #6076 不拆分。继续推进中。
docs: add Japanese version of clients.md (#6072)
ranxianglei commentedon Nov 10, 2026
(ai: vllm-qwen/qwen3.8-27b)
clients.md已完成并推送(PR #6076,head438fbe8)——这是全仓最大的一篇(约 1100 行 / 1.1 万词),覆盖 dsh、Kimi、Hermes、ZCode、Codex、Gemini 家族、Pi、Kiro、未列表客户端、http.proxy、OpenCode 全部客户端小节。质量核对(对 EN 源逐项对账,全通过):
过程说明: 推送时发现远端在我这轮之外又落了 2 个质量修订单(README.ja.md / message-identity.ja.md),与本批零文件重叠 → 用 rebase 把本批叠到远端之上(线性历史、双方都保留、未 force-push)。
CI: 新 head 30 项检查全绿(0 失败);
behind只是 master 前进了,收尾批次前我会再 rebase。范围已按你的拍板写进 PR 描述:只做 README + docs/,
AGENTS.md不做;CHANGELOG / reference 不在 "readme+docs" 内;docs/ 里那 4 篇刻意单语、无中文版的默认保持英文。下一步:
technical-notes.md(约 1.1 万词,同样大),随后 architecture(需扩展 docs 守卫认.ja.md)→ configuration(生成物,走生成器扩展)。继续推进中。ranxianglei commentedon Nov 10, 2026
你是不是直接调用 api 翻译更快?你自己核对即可?
13 remaining items
docs: add Japanese architecture hub + 8 module pages (#6072)
docs: add Japanese version of configuration.md + generator/guard/CI s…
docs: root redirect stubs for Japanese + ja links in docs indexes (#6072
docs: add Japanese translations for identity & protocol docs (#6072)
docs: add Japanese translations for message-identity & session-identi…
docs: add Japanese version of the docs directory landing page (#6072)
docs: add Japanese version of clients.md (#6072)
docs: add Japanese version of technical-notes.md (#6072)
docs: add Japanese architecture hub + 8 module pages (#6072)
docs: add Japanese version of configuration.md + generator/guard/CI s…
docs: root redirect stubs for Japanese + ja links in docs indexes (#6072
Merge pull request #6076 from ranxianglei/2026-11-10_japanese-docs
Merge origin/master (243709b) into pr-4639
merge: sync origin/master into fetch-data-property-watchdog