From f8d001105791f82fade754e0848fc10c854194b0 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Wed, 19 Aug 2026 09:20:32 +0800 Subject: [PATCH] docs(#47): mirror harness command entry changes Co-Authored-By: Claude Opus 5 --- docs/00-project-profile.md | 8 ++++---- docs/01-workflow.md | 6 +++--- docs/05-common-changes.md | 6 +++--- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/00-project-profile.md b/docs/00-project-profile.md index 0223c56..8c3f2cd 100644 --- a/docs/00-project-profile.md +++ b/docs/00-project-profile.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Project-Profile wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Project-Profile.- -wiki_revision: 00ed65faef08b23639fe1f7f5487f18a0d914440 -synchronized_at: 2026-08-18T00:47:47Z +wiki_revision: 1d9156c3b118f6458aa040ae6031ac400826385f +synchronized_at: 2026-08-19T01:19:44Z # 项目档案 @@ -25,12 +25,12 @@ synchronized_at: 2026-08-18T00:47:47Z | 基线 | 来源与版本 | 许可证 / 使用方式 | GoAuto 适配 | |---|---|---|---| -| DevHarness | `D:\OPC\dev_harness`，目标提交 `b1f500128d6eb100985792d4a715db8b6b5ae203` | 开发流程与文档模板 | 2026-08-17 增量升级；保留 GoAuto 专用规则并启用 Wiki-first | +| DevHarness | `D:\OPC\dev_harness`，目标提交 `bfdf648962d11a8024f62768380d8571e1f45f68` | 开发流程与文档模板 | 2026-08-19 升级（#47）：命令入口合并为 `harness.py`、项目档案改按需读取、新增 Wiki 初始化门禁与本地 HTML 审核快照、统一 LF 行尾；保留 GoAuto 专用规则 | | 服务端 | `go-admin` v2.3.0 | 上游开源管理端基线；升级时复核许可证和安全公告 | 保留认证、菜单、配置和管理端基础能力，新增 GoAuto 业务模块 | | 管理端 | `go-admin-ui` v3.0.0，`web/package.json` 标注 MIT | Vue 管理界面基线 | 保留应用外壳与通用组件，新增 GoAuto 页面 | | Android | 原生 Kotlin Agent | 自研业务客户端 | 通过 HTTPS 直连服务端，不保留 Windows 桌面 Client/ADB 作为生产拓扑 | -当前仓库没有记录最初采用的 DevHarness 完整提交，因此不能声称一个未经验证的旧基线。本次以现有 GoAuto 文档为旧事实，以以上目标提交为可复现的新基线。以后升级必须比较当前记录的目标提交与新的明确提交，不能笼统复制“最新版”。 +升级必须比较当前记录的目标提交与新的明确提交，不能笼统复制“最新版”。上一基线为 `b1f500128d6eb100985792d4a715db8b6b5ae203`（2026-08-17），本次升级区间共 12 个提交。模板内容一律按 GoAuto 事实改写：`harness.py` 的核心文档校验清单已改为 GoAuto 实际文档结构，README 校验改为产品 README 结构（新项目 Wiki 初始化门禁改由 `AGENTS.md` 与开发工作流承载）。 ## 交付单元 diff --git a/docs/01-workflow.md b/docs/01-workflow.md index 32d9ae9..9352039 100644 --- a/docs/01-workflow.md +++ b/docs/01-workflow.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Development-Workflow wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Development-Workflow.- -wiki_revision: d22ebd3709589b5defdf0abd705e76db6d0f1977 -synchronized_at: 2026-08-19T01:17:00Z +wiki_revision: ae87ca1d39dc196bccf2640d6fb868723cdd3e1d +synchronized_at: 2026-08-19T01:19:47Z # 开发工作流 @@ -126,6 +126,6 @@ synchronized_at: 2026-08-19T01:17:00Z ## 文档影响 -每个单元工单至少选择一项：无长期文档影响并说明原因；更新项目档案/运行验证；更新架构；更新业务规则；更新 API 契约；更新产品需求、常见修改或故障排查。长期页面先修改 Wiki，读取确认后运行 `python dev_scripts/sync_wiki_docs.py`；不得直接修改映射镜像。 +每个单元工单至少选择一项：无长期文档影响并说明原因；更新项目档案/运行验证；更新架构；更新业务规则；更新 API 契约；更新产品需求、常见修改或故障排查。长期页面先修改 Wiki，读取确认后运行 `python dev_scripts/harness.py sync`；不得直接修改映射镜像。 启动、测试、部署、排错命令，模块入口、目录职责、主要调用路径，配置、API、数据结构、状态、业务规则、安全边界或日志位置变化时必须更新对应文档。 diff --git a/docs/05-common-changes.md b/docs/05-common-changes.md index 7b3b9a0..2acc42f 100644 --- a/docs/05-common-changes.md +++ b/docs/05-common-changes.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Common-Changes wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Common-Changes.- -wiki_revision: 7d96409a13ef19d91df7cd74af24d8cdab473f32 -synchronized_at: 2026-08-17T03:28:08Z +wiki_revision: 6a77eb2e0d389ae34cdca04a1cb268ff4a7c233a +synchronized_at: 2026-08-19T01:19:56Z # 常见修改指南 @@ -65,7 +65,7 @@ GoAuto 的长期文档采用 Wiki-first： 1. 在单元工单列出受影响页面。 2. 修改对应 Gitea Wiki 页面，不写入密码、Token、个人数据或生产数据。 3. 通过 API 或页面回读确认正文和 revision。 -4. 运行 `python dev_scripts/sync_wiki_docs.py` 导出核心镜像。 +4. 运行 `python dev_scripts/harness.py sync` 导出核心镜像。 5. 运行 `python dev_scripts/sync_wiki_docs.py --check` 和 `git diff --check`，再审查差异。 停止条件：需要删除/重命名 Wiki 页面、修改映射、改变事实来源边界，或映射镜像存在未提交修改；这些必须在工单中单独确认，不得强制覆盖。