docs: 为全部代码补充中文注释并加入 AGENTS 注释规范

2026-08-13 22:09:55 +08:00
parent 1c6e01087b
commit 664957b5ef
5 changed files with 56 additions and 1 deletions
@@ -17,3 +17,10 @@
 - `LLM_API_KEY`：可选。
 - `LLM_MODEL`：默认模型，默认值 `default`。
 - `LLM_TIMEOUT_SECONDS`：单次请求超时，默认 `600`。
+
+## 代码注释规范
+
+- 本仓库所有源码（Python、TOML 等支持注释的文件）必须配有详细中文注释，说明模块职责、LLM 分批调用与 SRT 回填逻辑，确保后续维护人员可以快速理解代码工作原理。
+- 新增或修改代码时，必须同步补充或更新对应注释；不得删除已有注释。
+- 测试代码同样必须配有中文注释，说明每条测试验证的行为。
+- JSON 数据文件（`node.manifest.json`）不支持注释，字段语义以 `wov-sdk` 的 `NodeManifest` 模型注释和本文档输入/输出说明为准。