Files
openclaw/docs/zh-CN/AGENTS.md
yunxiafei 89a243be70
Some checks failed
CI / docs-scope (push) Has been cancelled
CI / secrets (push) Has been cancelled
CI / ios (push) Has been cancelled
Docker Release / validate_manual_backfill (push) Has been cancelled
Install Smoke / docs-scope (push) Has been cancelled
Sandbox Common Smoke / sandbox-common-smoke (push) Has been cancelled
Workflow Sanity / no-tabs (push) Has been cancelled
Workflow Sanity / actionlint (push) Has been cancelled
Workflow Sanity / config-docs-drift (push) Has been cancelled
CI / changed-scope (push) Has been cancelled
CI / build-artifacts (push) Has been cancelled
CI / release-check (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && bunx vitest run --config vitest.unit.config.ts, bun, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 1, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 2, test) (push) Has been cancelled
CI / checks (pnpm protocol:check, node, protocol) (push) Has been cancelled
CI / checks (pnpm test:channels, node, channels) (push) Has been cancelled
CI / checks (pnpm test:extensions, node, extensions) (push) Has been cancelled
CI / check (push) Has been cancelled
CI / startup-memory (push) Has been cancelled
CI / check-docs (push) Has been cancelled
CI / compat-node22 (push) Has been cancelled
CI / skills-python (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 1, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 2, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 3, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 4, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 5, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 6, test) (push) Has been cancelled
CI / macos (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:assembleDebug, build) (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:testDebugUnitTest, test) (push) Has been cancelled
Docker Release / approve_manual_backfill (push) Has been cancelled
Docker Release / build-amd64 (push) Has been cancelled
Docker Release / build-arm64 (push) Has been cancelled
Docker Release / create-manifest (push) Has been cancelled
Install Smoke / install-smoke (push) Has been cancelled
初版
2026-03-16 17:22:13 +08:00

2.1 KiB
Raw Blame History

AGENTS.md - zh-CN 文档翻译工作区

Read When

  • 维护 docs/zh-CN/**
  • 更新中文翻译流水线glossary/TM/prompt
  • 处理中文翻译反馈或回归

Pipelinedocs-i18n

  • 源文档:docs/**/*.md
  • 目标文档:docs/zh-CN/**/*.md
  • 术语表:docs/.i18n/glossary.zh-CN.json
  • 翻译记忆库:docs/.i18n/zh-CN.tm.jsonl
  • 提示词规则:scripts/docs-i18n/prompt.go

常用运行方式:

# 批量doc 模式,可并行)
go run scripts/docs-i18n/main.go -mode doc -parallel 6 docs/**/*.md

# 单文件

go run scripts/docs-i18n/main.go -mode doc docs/channels/matrix.md

# 小范围补丁segment 模式,使用 TM不支持并行
go run scripts/docs-i18n/main.go -mode segment docs/channels/matrix.md

注意事项:

  • doc 模式用于整页翻译segment 模式用于小范围修补(依赖 TM
  • 新增技术术语、页面标题或短导航标签时,先更新 docs/.i18n/glossary.zh-CN.json,再跑 doc 模式;不要指望模型自行保留英文术语或固定译名。
  • pnpm docs:check-i18n-glossary 会检查变更过的英文文档标题和短内部链接标签是否已写入 glossary。
  • 超大文件若超时,优先做定点替换或拆分后再跑。
  • 翻译后检查中文引号、CJK-Latin 间距和术语一致性。

zh-CN 样式规则

  • CJK-Latin 间距:遵循 W3C CLREQGateway 网关Skills 配置)。
  • 中文引号:正文/标题使用 “”;代码/CLI/键名保持 ASCII 引号。
  • 术语保留英文:Skillslocal loopbackTailscale
  • 代码块/内联代码:保持原样,不在代码内插入空格或引号替换。

关键术语(#6995 修复)

  • Gateway 网关
  • Skills 配置
  • 沙箱
  • 预期键名
  • 配套应用
  • 分块流式传输
  • 设备发现

反馈与变更记录

  • 反馈来源GitHub issue #6995
  • 反馈用户:@AaronWander、@taiyi747、@Explorer1092、@rendaoyuan
  • 变更要点:更新 prompt 规则、扩充 glossary、清理 TM、批量再生成 + 定点修复
  • 参考链接:https://github.com/openclaw/openclaw/issues/6995