liqiang
b119135836
Build latest book artifacts / build (push) Canceled after 0s
dependency resolution / resolve (3.11) (push) Canceled after 0s
dependency resolution / resolve (3.13) (push) Canceled after 0s
deploy-pages / build (push) Canceled after 0s
deploy-pages / deploy (push) Canceled after 0s
i18n consistency check / check (push) Canceled after 0s
provider adoption tests / test (chapter2/context-compression) (push) Canceled after 0s
provider adoption tests / test (chapter2/prompt-injection) (push) Canceled after 0s
provider adoption tests / test (chapter2/system-hint) (push) Canceled after 0s
provider adoption tests / test (chapter3/log-sanitization) (push) Canceled after 0s
web-search-agent tests / test (push) Canceled after 0s
web-search-agent tests / agentbook (push) Canceled after 0s
40 lines
2.3 KiB
Markdown
40 lines
2.3 KiB
Markdown
# 中文技术文档符号与引用规范
|
|
|
|
## 何时加载
|
|
|
|
- 编辑或生成同时包含中文、英文、Markdown 和代码的技术文档。
|
|
- 用户反馈引号、反引号或代码边界格式错误时。
|
|
|
|
## 符号定义
|
|
|
|
- ASCII 直引号：`"`、`'`；常用于英文标点和代码字符串。
|
|
- 中文弯引号：`“”`、`‘’`；用于中文自然语言引用。
|
|
- Markdown 反引号：`` ` ``；用于行内代码和字面量。
|
|
|
|
## 决策优先级
|
|
|
|
1. 先保护可执行代码、JSON/schema、URL、路径和用户要求原样保留的引用文本。
|
|
2. 识别 Markdown 代码围栏、行内代码和代码注释边界。
|
|
3. 在中文自然语言作用域中，把成对的直引号改为弯引号，并正确处理嵌套引用。
|
|
4. 英文原文保持原文标点；英文标识符是否使用反引号由其是否为代码字面量决定，而不是由语言决定。
|
|
5. 无法判断作用域时保留原文并请求澄清，不做全局替换。
|
|
|
|
## 正反例约束
|
|
|
|
- 正例：`# 中文注释：显示 "状态"` → `# 中文注释：显示 “状态”`；同一代码块中的 `name = "status"`、`const name = "status"`、SQL 标识符和 JSON 键值保持 ASCII 语法。
|
|
- 反例：不能把代码字符串、JSON、URL、路径、英文原句或 Markdown 行内代码中的 `"`/`'` 改成弯引号；不能因为文件是中文就全局替换。
|
|
- 每种编程语言至少提供“该改的中文注释”和“该留的可执行字面量”成对样本，并在留出/边界集更换体裁、变量名和代码结构。
|
|
|
|
## 数据质量门禁
|
|
|
|
- 合成数据先按文章体裁、作用域类型和编程语言分层，再切分 train/eval/boundary，禁止 ID 和模板组合重叠。
|
|
- 机器门禁检查未解析变量、代码围栏、非注释代码行漂移和保护区；人工抽查每个分层的首条样本，记录在 `validation/manual_audit.md`。
|
|
- 任何语言类别的保护区或语法门禁失败，都应回到 Skill/数据蓝图修订后重训，不能只增加 epoch 或汇报总体平均分。
|
|
|
|
## 验证
|
|
|
|
- 修改必须是最小编辑，正文事实和代码内容不变。
|
|
- Markdown、JSON 和代码语法检查必须通过。
|
|
- 英文原文、代码和保护区域做字节级回归。
|
|
- 记录来源 Bad Case、适用范围、例外和验证结果。
|