opc/dev_harness
2
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

将 DevHarness 工具目录重命名为 dev_scripts #3

New Issue
Closed
opened 2026-08-08 09:15:27 +08:00 by ila · 4 comments
ila commented 2026-08-08 09:15:27 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：重构
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：已完成

要解决什么

DevHarness 自身的检查、Wiki 同步和任务归档工具目前位于根目录 scripts/。后续业务项目也可能使用 scripts/ 存放产品脚本，两个用途容易混淆。

目标是把 DevHarness 自身工具目录重命名为 dev_scripts/，明确该目录只属于开发 Harness，并为业务脚本保留 scripts/ 名称。

做什么 / 不做什么

  • 做：
    • 将 scripts/ 下四个 Python 工具整体移动到 dev_scripts/。
    • 更新测试导入路径、Harness 必需文件检查和所有稳定命令入口。
    • 先更新线上 Wiki 稳定主题页，再导出本地 docs 镜像。
    • 更新 AGENTS、README 和 Claude 入口中受影响的说明。
    • 验证除历史任务归档外不再存在有效的 scripts/ 引用。
  • 不做：
    • 不保留旧 scripts/ 兼容包装器。
    • 不创建业务 scripts/ 目录或业务脚本。
    • 不改写任务 #1、#2 的历史归档路径。
    • 不改变 Wiki 同步、Harness 检查或任务归档的业务行为。

已确认方案

原命令：

python scripts/check_harness.py --strict

新命令：

python dev_scripts/check_harness.py --strict

同理更新 sync_wiki_docs.py、new_task_archive.py 和代码地图路径。wiki_docs.py 仍通过文件位置的父目录定位仓库根目录，目录层级不变，因此不修改根目录解析逻辑。

预计修改文件：

  • Gitea Wiki 稳定主题页
  • scripts/** → dev_scripts/**
  • tests/**
  • AGENTS.md
  • README.md
  • scripts/check_harness.py 移动后的必需路径常量
  • Wiki 导出的 docs/** 稳定镜像

文档影响

  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新常见修改或故障排查
  • 更新 Home、开发工作流和新项目初始化
  • 历史任务归档不更新，保留当时真实路径

验收标准

  • 根目录不再存在 DevHarness 的 scripts/，四个工具位于 dev_scripts/。
  • 新命令能够运行，旧命令不提供兼容入口。
  • 测试导入和 Harness 必需文件检查使用新路径。
  • 所有稳定 Wiki 页面和本地镜像使用 dev_scripts/。
  • scripts/ 残留引用只允许存在于历史任务归档。
  • 自动化测试、严格检查、Wiki 镜像检查和 Python 编译检查通过。

验证方式

python -m unittest discover -s tests -v
python dev_scripts/check_harness.py --strict
python dev_scripts/sync_wiki_docs.py --check
python -m compileall -q dev_scripts tests
git diff --check

另外使用固定字符串搜索 scripts/，人工确认剩余结果仅属于历史归档。

风险和回退

风险：外部环境仍使用旧命令时会失败；遗漏测试导入或文档引用会造成运行或理解错误。

控制：不静默兼容旧路径；更新所有稳定入口；执行测试、严格检查、在线镜像对照和残留搜索。

回退：通过 Git 提交将目录恢复为 scripts/，并使用 Wiki revision 恢复稳定文档。

## 基本信息 - 类型：重构 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 要解决什么 DevHarness 自身的检查、Wiki 同步和任务归档工具目前位于根目录 `scripts/`。后续业务项目也可能使用 `scripts/` 存放产品脚本，两个用途容易混淆。 目标是把 DevHarness 自身工具目录重命名为 `dev_scripts/`，明确该目录只属于开发 Harness，并为业务脚本保留 `scripts/` 名称。 ## 做什么 / 不做什么 - 做： - 将 `scripts/` 下四个 Python 工具整体移动到 `dev_scripts/`。 - 更新测试导入路径、Harness 必需文件检查和所有稳定命令入口。 - 先更新线上 Wiki 稳定主题页，再导出本地 docs 镜像。 - 更新 AGENTS、README 和 Claude 入口中受影响的说明。 - 验证除历史任务归档外不再存在有效的 `scripts/` 引用。 - 不做： - 不保留旧 `scripts/` 兼容包装器。 - 不创建业务 `scripts/` 目录或业务脚本。 - 不改写任务 #1、#2 的历史归档路径。 - 不改变 Wiki 同步、Harness 检查或任务归档的业务行为。 ## 已确认方案 原命令： ```powershell python scripts/check_harness.py --strict ``` 新命令： ```powershell python dev_scripts/check_harness.py --strict ``` 同理更新 `sync_wiki_docs.py`、`new_task_archive.py` 和代码地图路径。`wiki_docs.py` 仍通过文件位置的父目录定位仓库根目录，目录层级不变，因此不修改根目录解析逻辑。 预计修改文件： - Gitea Wiki 稳定主题页 - `scripts/**` → `dev_scripts/**` - `tests/**` - `AGENTS.md` - `README.md` - `scripts/check_harness.py` 移动后的必需路径常量 - Wiki 导出的 `docs/**` 稳定镜像 ## 文档影响 - [x] 更新项目档案或本地开发与验证 - [x] 更新架构与代码地图 - [x] 更新常见修改或故障排查 - [x] 更新 Home、开发工作流和新项目初始化 - [x] 历史任务归档不更新，保留当时真实路径 ## 验收标准 - [x] 根目录不再存在 DevHarness 的 `scripts/`，四个工具位于 `dev_scripts/`。 - [x] 新命令能够运行，旧命令不提供兼容入口。 - [x] 测试导入和 Harness 必需文件检查使用新路径。 - [x] 所有稳定 Wiki 页面和本地镜像使用 `dev_scripts/`。 - [x] `scripts/` 残留引用只允许存在于历史任务归档。 - [x] 自动化测试、严格检查、Wiki 镜像检查和 Python 编译检查通过。 ## 验证方式 ```powershell python -m unittest discover -s tests -v python dev_scripts/check_harness.py --strict python dev_scripts/sync_wiki_docs.py --check python -m compileall -q dev_scripts tests git diff --check ``` 另外使用固定字符串搜索 `scripts/`，人工确认剩余结果仅属于历史归档。 ## 风险和回退 风险：外部环境仍使用旧命令时会失败；遗漏测试导入或文档引用会造成运行或理解错误。 控制：不静默兼容旧路径；更新所有稳定入口；执行测试、严格检查、在线镜像对照和残留搜索。 回退：通过 Git 提交将目录恢复为 `scripts/`，并使用 Wiki revision 恢复稳定文档。
ila commented 2026-08-08 09:15:35 +08:00
Author
Owner
Copy Link
Copy Source

用户已确认方案，开始实施。工作区干净；先更新线上稳定 Wiki 页面，历史任务归档 #1、#2 保持原路径。

用户已确认方案，开始实施。工作区干净；先更新线上稳定 Wiki 页面，历史任务归档 #1、#2 保持原路径。
ila commented 2026-08-08 09:20:02 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入待验收

最终方案

  • 根目录 scripts/ 整体重命名为 dev_scripts/，四个工具保持同一层级，仓库根目录解析逻辑无需修改。
  • 测试导入路径和 Harness 必需文件检查使用 dev_scripts/。
  • AGENTS、README 和 7 个线上稳定 Wiki 页面先更新，再导出本地镜像。
  • 不提供旧路径兼容入口，为后续业务脚本保留清晰命名空间。
  • 任务 #1、#2 归档继续保留当时真实的旧路径。

方案差异

实施时残留搜索发现本地开发页的 python -m compileall -q scripts tests 没有斜杠，不在首轮机械替换范围内。已再次先更新 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：通过。
  • git diff --check：通过。
  • scripts/ 目录存在检查：不存在。
  • 非历史旧路径搜索：无结果；剩余旧路径仅在 docs/task/1-* 和 docs/task/2-* 历史归档。
  • 未验证部分：仓库外部若有未纳入版本管理的自动化仍调用旧命令，需要使用方自行改为 dev_scripts/。

实现提交

  • 1c99867 refactor: 将 Harness 工具移至 dev_scripts (#3)
  • 51278fa docs: 修正 dev_scripts 编译检查命令 (#3)

状态保持待验收，用户确认前不关闭。

## 实现完成，进入待验收 ### 最终方案 - 根目录 `scripts/` 整体重命名为 `dev_scripts/`，四个工具保持同一层级，仓库根目录解析逻辑无需修改。 - 测试导入路径和 Harness 必需文件检查使用 `dev_scripts/`。 - AGENTS、README 和 7 个线上稳定 Wiki 页面先更新，再导出本地镜像。 - 不提供旧路径兼容入口，为后续业务脚本保留清晰命名空间。 - 任务 #1、#2 归档继续保留当时真实的旧路径。 ### 方案差异 实施时残留搜索发现本地开发页的 `python -m compileall -q scripts tests` 没有斜杠，不在首轮机械替换范围内。已再次先更新 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`：通过。 - `git diff --check`：通过。 - `scripts/` 目录存在检查：不存在。 - 非历史旧路径搜索：无结果；剩余旧路径仅在 `docs/task/1-*` 和 `docs/task/2-*` 历史归档。 - 未验证部分：仓库外部若有未纳入版本管理的自动化仍调用旧命令，需要使用方自行改为 `dev_scripts/`。 ### 实现提交 - `1c99867` refactor: 将 Harness 工具移至 dev_scripts (#3) - `51278fa` docs: 修正 dev_scripts 编译检查命令 (#3) 状态保持待验收，用户确认前不关闭。
ila referenced this issue from a commit 2026-08-08 09:22:18 +08:00
docs: 归档任务 #3
ila commented 2026-08-08 09:22:27 +08:00
Author
Owner
Copy Link
Copy Source

归档与推送完成

  • Wiki 归档：Task-3-Dev-Scripts-Rename
  • Wiki revision：5e961648835c5d8ba73d2cb515d335294e480ba2
  • 本地镜像：docs/task/3-dev_scripts目录重命名.md
  • 实现提交：
    • 1c99867 refactor: 将 Harness 工具移至 dev_scripts (#3)
    • 51278fa docs: 修正 dev_scripts 编译检查命令 (#3)
  • 归档提交：1d3104c docs: 归档任务 #3
  • 三个任务提交已推送到 origin/main，远端当前为 1d3104c。
  • 最终验证：16/16 测试通过、Harness 严格检查通过、13/13 Wiki 映射一致、Python 编译和 diff 检查通过。
  • 旧 scripts/ 目录不存在；稳定内容无旧路径，旧路径只保留在 #1、#2 历史归档。
  • 工单保持“待验收”，用户确认前不关闭。
## 归档与推送完成 - Wiki 归档：[Task-3-Dev-Scripts-Rename](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-3-Dev-Scripts-Rename.-) - Wiki revision：`5e961648835c5d8ba73d2cb515d335294e480ba2` - 本地镜像：`docs/task/3-dev_scripts目录重命名.md` - 实现提交： - `1c99867` refactor: 将 Harness 工具移至 dev_scripts (#3) - `51278fa` docs: 修正 dev_scripts 编译检查命令 (#3) - 归档提交：`1d3104c` docs: 归档任务 #3 - 三个任务提交已推送到 `origin/main`，远端当前为 `1d3104c`。 - 最终验证：16/16 测试通过、Harness 严格检查通过、13/13 Wiki 映射一致、Python 编译和 diff 检查通过。 - 旧 `scripts/` 目录不存在；稳定内容无旧路径，旧路径只保留在 #1、#2 历史归档。 - 工单保持“待验收”，用户确认前不关闭。
ila commented 2026-08-08 09:25:16 +08:00
Author
Owner
Copy Link
Copy Source

用户已于 2026-08-08 明确验收通过。Wiki 归档状态已更新为“已完成”，revision：15e71e5f540039f3947754a4a17971e12604dff7；本地镜像已通过提交 e72b161 推送到 main。本工单无父级 MVP/Epic，现按流程关闭。

用户已于 2026-08-08 明确验收通过。Wiki 归档状态已更新为“已完成”，revision：`15e71e5f540039f3947754a4a17971e12604dff7`；本地镜像已通过提交 `e72b161` 推送到 `main`。本工单无父级 MVP/Epic，现按流程关闭。
ila closed this issue 2026-08-08 09:25:17 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: opc/dev_harness#3