73 lines
3.1 KiB
Markdown
73 lines
3.1 KiB
Markdown
|
<!-- gitea-wiki-mirror:start -->
|
||
|
|
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||
|
|
wiki_page: Task-3-Dev-Scripts-Rename
|
||
|
|
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-3-Dev-Scripts-Rename.-
|
||
|
|
wiki_revision: 5e961648835c5d8ba73d2cb515d335294e480ba2
|
||
|
|
synchronized_at: 2026-08-08T01:21:04Z
|
||
|
|
<!-- gitea-wiki-mirror:end -->
|
||
|
|
|
||
|
|
# 3 将 DevHarness 工具目录重命名为 dev_scripts
|
||
|
|
|
||
|
|
- 类型：重构
|
||
|
|
- 所属 Epic：无
|
||
|
|
- 所属 MVP / 版本：无
|
||
|
|
- 状态：待验收
|
||
|
|
- 日期：2026-08-08
|
||
|
|
- Gitea 工单：[opc/dev_harness#3](http://ilaer.eicp.net:8418/opc/dev_harness/issues/3)
|
||
|
|
- Wiki 页面：Task-3-Dev-Scripts-Rename
|
||
|
|
- Wiki revision：见本地镜像头
|
||
|
|
|
||
|
|
## 背景与目标
|
||
|
|
|
||
|
|
DevHarness 自身工具原来放在根目录 `scripts/`，容易和后续业务项目的脚本混淆。本任务把 Harness 检查、Wiki 同步和任务归档工具统一迁移到 `dev_scripts/`，不保留旧路径兼容入口。
|
||
|
|
|
||
|
|
## 最终方案
|
||
|
|
|
||
|
|
- `scripts/check_harness.py` → `dev_scripts/check_harness.py`。
|
||
|
|
- `scripts/wiki_docs.py` → `dev_scripts/wiki_docs.py`。
|
||
|
|
- `scripts/sync_wiki_docs.py` → `dev_scripts/sync_wiki_docs.py`。
|
||
|
|
- `scripts/new_task_archive.py` → `dev_scripts/new_task_archive.py`。
|
||
|
|
- 更新测试导入路径、必需文件检查、AGENTS、README 和稳定 Wiki 页面。
|
||
|
|
- Wiki 先修改并读取确认，再导出本地镜像。
|
||
|
|
- 历史任务 #1、#2 保留旧路径，避免改写历史事实。
|
||
|
|
- 旧 `scripts/` 目录不保留包装器，未来业务脚本必须与 `dev_scripts/` 分开。
|
||
|
|
|
||
|
|
## 修改文件
|
||
|
|
|
||
|
|
- `scripts/**` → `dev_scripts/**`：整体目录重命名。
|
||
|
|
- `dev_scripts/check_harness.py`：必需工具路径改为新目录。
|
||
|
|
- `tests/test_wiki_docs.py`、`tests/test_harness_docs.py`：导入新目录。
|
||
|
|
- `AGENTS.md`：更新同步、归档命令和目录边界。
|
||
|
|
- `README.md`：更新快速开始和目录说明。
|
||
|
|
- `docs/README.md`、项目档案、工作流、代码地图、开发验证、常见修改和新项目初始化：线上 Wiki 的更新镜像。
|
||
|
|
|
||
|
|
## 验收结果
|
||
|
|
|
||
|
|
| 验收标准 | 结果 |
|
||
|
|
|---|---|
|
||
|
|
| 四个工具位于 dev_scripts，旧目录不存在 | 通过 |
|
||
|
|
| 新命令可运行且不保留旧兼容入口 | 通过 |
|
||
|
|
| 测试导入和必需文件检查使用新路径 | 通过 |
|
||
|
|
| 稳定 Wiki 与本地镜像使用新路径 | 通过 |
|
||
|
|
| 非历史内容没有旧路径引用 | 通过 |
|
||
|
|
| 测试、严格检查、同步和编译通过 | 通过 |
|
||
|
|
|
||
|
|
## 测试
|
||
|
|
|
||
|
|
- 执行命令：`python -m unittest discover -s tests -v`
|
||
|
|
- 结果：16/16 通过。
|
||
|
|
- 执行命令：`python dev_scripts/check_harness.py --strict`
|
||
|
|
- 结果：通过。
|
||
|
|
- 执行命令：`python dev_scripts/sync_wiki_docs.py --check`
|
||
|
|
- 结果：12/12 映射一致。
|
||
|
|
- 执行命令：`python -m compileall -q dev_scripts tests`
|
||
|
|
- 结果：通过。
|
||
|
|
- 执行命令：旧目录和非历史旧路径搜索。
|
||
|
|
- 结果：旧目录不存在；非历史旧路径无残留。
|
||
|
|
- **未验证部分**：仓库外部未纳入版本管理的自动化如果仍使用旧命令，需要使用方自行更新。
|
||
|
|
|
||
|
|
## 相关提交
|
||
|
|
|
||
|
|
- `1c99867` refactor: 将 Harness 工具移至 dev_scripts (#3)
|
||
|
|
- `51278fa` docs: 修正 dev_scripts 编译检查命令 (#3)
|