refactor: 将 Harness 工具移至 dev_scripts (#3)
This commit is contained in:
@@ -2,8 +2,8 @@
|
||||
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
|
||||
wiki_page: Common-Changes
|
||||
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Common-Changes.-
|
||||
wiki_revision: 2c41287656577564fc7b78b6cf8554ce81e16003
|
||||
synchronized_at: 2026-08-08T00:58:10Z
|
||||
wiki_revision: 9b223d2feada753a6d38bffce6eb0848c4067b85
|
||||
synchronized_at: 2026-08-08T01:16:55Z
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 常见修改指南
|
||||
@@ -27,8 +27,8 @@ synchronized_at: 2026-08-08T00:58:10Z
|
||||
1. 在相关工单确认目标。
|
||||
2. 读取线上 Wiki 页面和当前 revision。
|
||||
3. 修改线上 Wiki,不直接编辑 `docs/`。
|
||||
4. 运行 `python scripts/sync_wiki_docs.py`。
|
||||
5. 运行 `python scripts/sync_wiki_docs.py --check`。
|
||||
4. 运行 `python dev_scripts/sync_wiki_docs.py`。
|
||||
5. 运行 `python dev_scripts/sync_wiki_docs.py --check`。
|
||||
6. 审查本地镜像差异并提交。
|
||||
|
||||
停止条件:页面需要删除、重命名或改变事实源边界。
|
||||
@@ -45,7 +45,7 @@ synchronized_at: 2026-08-08T00:58:10Z
|
||||
|
||||
## 调整 Harness 检查
|
||||
|
||||
1. 从 `scripts/check_harness.py` 的 `main()` 开始读。
|
||||
1. 从 `dev_scripts/check_harness.py` 的 `main()` 开始读。
|
||||
2. 新检查应输出具体文件和缺失内容。
|
||||
3. 检查结构事实,不声称自动判断文档语义质量。
|
||||
4. 在 `tests/` 添加成功和失败用例。
|
||||
@@ -55,7 +55,7 @@ synchronized_at: 2026-08-08T00:58:10Z
|
||||
|
||||
## 修复 Wiki 同步 Bug
|
||||
|
||||
1. 从 `scripts/wiki_docs.py` 的 `WikiClient`、`parse_mirror` 和 `sync_all` 开始读。
|
||||
1. 从 `dev_scripts/wiki_docs.py` 的 `WikiClient`、`parse_mirror` 和 `sync_all` 开始读。
|
||||
2. 先编写能复现问题的测试。
|
||||
3. 保持 Wiki → docs 单向关系。
|
||||
4. 验证中文、路径编码、revision 和脏文件保护。
|
||||
|
||||
Reference in New Issue
Block a user