chore(接续包): 补「叙述旧名件不回改」口径 + 记体检日志
- 接续包 §3.1 增一行:本包与体检报告正文里的 AI技能 是旧名叙述,不是待执行路径 - 验收口径明确:用 §3.1 逐条清单统计,不用 grep -rl 全量计数 - 今日日志与 automation 记忆追加本棒执行摘要 - 接续包 md5 更新为 ab17bde7bb65782d10be7d122546a8c5(automation 8117f930 已同步)
This commit is contained in:
1 parent
75c661226b
commit
17e209279f
3 files changed
+84
-63
No files matched your search
@@ -116,66 +116,74 @@
|
||||
📌 **口径立此存照**:**状态不靠目录位置表达**(目录一摊平/搬家即失效)—— 主依据 = 单子头部 `- 状态:` 行 + `05-交接单/README.md` 台账表;目录(`交接单-已完成/`)只作辅助分类。
|
||||
⚠️ **发现的机制缺口**:`lock-guard-hook.py` 只在 **Write/Edit 工具**上拦"无锁改文档库",但**用脚本(bash 跑 python)改文件绕过了钩子** —— 本轮就出现"锁已释放但仍用脚本改了 docs"的情形。⇒ 规则补一条:**动文档库前先抢锁,与走哪个工具无关**。
|
||||
接续包 = `接续包_文档库结构治理_20260924.md`(md5 `29163f78bc990230d3da678a0ce7b0ba`)。
|
||||
|
||||
## 文档库结构治理接续棒(会话 `文档库治理4` · 06:3x–07:0x · 已收口)
|
||||
- §4-1/2/3/4 全做:状态字段补全 16 件(无状态 15→0)· T08 重号标记件清出到 `归档/dsh-server-docs-清理-20260924/` · 4 个空占号锁 rmdir。§4-5 只报告。
|
||||
- §5⑤ 引用体检抓出**上一棒遗留的功能性残留**:`07-scripts` 5 脚本 + 库 `CODEBUDDY.md` + 工作区 `.codebuddy/rules/archive-doc.md` 的旧目录名 `调整方案/`(21 处)⇒ 全部静默失效(manifest 档案号恒空、条件规则 paths 不匹配)⇒ 已修;三件套 rc=0/0/0。
|
||||
- 教训:**改目录名后,功能性常量不只是锁/hook —— 还有 07-scripts 自检脚本的前缀常量与 `.codebuddy/rules` 的 paths glob**;「脚本跑通了」≠「脚本真的在干活」(rc=0 也可能是扫到了空目录)。
|
||||
- 待办:`docs-manifest.json` 重建(改 INDEX.md 需拍板)· 散文类旧前缀清单未改 · `04-调整方案/` 存量不动为政策。
|
||||
|
||||
## 文档库结构治理接续棒 2(会话 `文档库治理5` · 06:42–07:0x · 已收口)
|
||||
- 用户拍板:「1、A 2、B」,按长期有利方向处理 ⇒ ①A 只重建 manifest 不动 INDEX ②B 连 08-skills 一起改并三处同步。
|
||||
- `docs-manifest.json` 重建:**档案 0 → 146 份**(上一棒假绿的根因已消除)。INDEX.md 未动(拍板 ①A)。
|
||||
- 散文旧前缀残留 **29 文件 / 74 处**已修(生效件 4 目录 + 08-skills 12 文件)⇒ 精确正则复验裸旧名 **0 处**。
|
||||
- 技能三处同步完成:库 `08-skills` → 本机 `.workbuddy/skills` → 服务器 `/opt/dsh/docs/skills`,**12/12 md5 全同**,服务器 `chmod 600 root:root` 已保。
|
||||
- 顺带修真悬挂引用:库内 `dsh-plugin-diagnose/SKILL.md` 的 `src/host/08-skills/plugin.ts` → `src/host/skills/plugin.ts`(本机副本原为正确值 ⇒ 证明是改名误替换)。
|
||||
- 自检:consistency rc=0 · handoff-status rc=0(无状态 0)· archive-index rc=1(**拍板 ①A 的预期中间态**:manifest 已重建 / INDEX 未刷)· docs-audit rc=1(**误报**:把 `08-skills/**/07-*.md` 当档案 07;同报「无悬空档案号引用」)。
|
||||
- 🔴 三条方法论(本棒实测教训):① 判旧名残留**必须带负向后顾**(裸 `grep` 把新前缀 `04-调整方案/` 也命中 ⇒ 假阳性 14 vs 真 0)② 判两端一致**必须忽略行尾**(Windows/Linux 换行令 `diff` 整块报差异,但 md5 逐行相同)③ 同步前做**归一化比较**定性差异。
|
||||
- 待办(下一棒):`archive-index --write` 刷 INDEX(需拍板)· `docs-audit.py` 档案号扫描范围限定到 `04-调整方案/`(上一棒修复暴露的既有缺陷)· `INDEX.md` 被 git 判 binary · 服务器上不在库内 08-skills 的技能未纳入 · 未 commit/push。
|
||||
|
||||
## 文档库结构治理接续棒 3(会话 `文档库治理6` · 06:54–07:1x · 已收口)
|
||||
- 用户令「都要执行一直到任务处理完毕」⇒ §9 遗留 1–3 全做完:① `archive-index --write` 刷 INDEX(rc=0,146 篇入索引)② 修 `docs-audit.py` 档案号提取范围(限定根级 + `04-调整方案/`)⇒ rc=0 ③ 修 `INDEX.md` 内 **2 处 NUL**(`\x004-调整方案/`,即 `0` 被写成 NUL;这是 git 判 binary 的根因)⇒ git 恢复文本判定。
|
||||
- 技能集合查明:服务器 12 = 库内 08-skills 12(上一棒"服务器有库外技能"是假阳性 grep 误判);本机多 12 个属跨项目个人技能,不在本线范围。
|
||||
- 自检 **本线首次全绿**:consistency / archive-index / handoff-status(无状态 0)/ audit / manifest 全部 rc=0。
|
||||
- 🔴 新发现(需拍板):**服务器 `/opt/dsh/docs/` 整体仍是「改名前的旧结构」**(`skills/` `交接单/` `scripts/` `archive/` + 顶层散文件),本机/库已是 `01-规范/`…`09-archive/` ⇒ sync-check 报「仅本地 136 / 仅服务器 121」,「一致 146」全来自同名的 `04-调整方案/`。已取证平台代码/env/unit **无 `docs/skills` 引用**(归档位非运行时依赖),但技能文档**自指写死** `/opt/dsh/docs/skills/<name>/SKILL.md` ⇒ 改造须同步改该约定(跨 36 份技能文档),且涉 121 文件重命名 + 删旧目录(不可逆)。
|
||||
- 方法论教训:**「grep 命中」不等于「问题存在」** —— 裸 `grep "调整方案/"` 把新前缀 `04-调整方案/` 一并算上(14 vs 真 0);同类误判还导致上一棒误报"服务器有库外技能"(实际服务器只有 12 个技能目录)。
|
||||
|
||||
## 文档库结构治理接续棒 4(会话 `文档库治理7` · 07:04–07:2x · 已收口)· A 方案
|
||||
- 用户令「A 方案」⇒ 服务器归档镜像 `/opt/dsh/docs/` 结构改造与本机对齐,执行到底。
|
||||
- 主体:全量备份 tar(`/opt/dsh/backups/docs-pre-restructure-20260924-071007.tar.gz`)→ 打包库 289 文件 → 解包新结构 → 旧结构 12 项/121 文件 `mv` 到 `backups/docs-old-structure-20260924-071032/`(⛔ 不 rm)→ 权限 700/755/600 root:root。
|
||||
- 结果:`docs-sync-check.sh` **双端一致 ✅**(289/0/0/0);旧结构归档清单与两条回滚命令写在接续包 §12 九。
|
||||
- 三分表:180 已一致 / 78 服务器旧版 / 0 纯改名 / 22 真独有(5 备份+17 历史旧档,随旧结构留档 ⇒ 零信息丢失)。发现服务器 `交接单/` 下还藏一层更早旧结构 `交接单/archive/`(12 个 T09–T21)。
|
||||
- 🔴 **纠正上一棒误判**:技能自指**本来就用新段名** `/opt/dsh/docs/08-skills/`(不是"写死旧路径")⇒ 改服务器把悬挂变正确。教训:判自指悬挂必须**逐处打印上下文**,不能凭"文档提到 skills"推断。
|
||||
- 库内旧名终扫:补修 **33 处**(第一批 25 + 第二批 8)+ `handoff-guard.sh` 注释 1 处;含修掉 `README.md` 的 `05-交接单/05-交接单/` 双前缀 bug。终验裸旧名 **0**。
|
||||
- 对账脚本 `docs-sync-check.sh` 补排除 `tmp/` 与 `.locks/`(3 处)⇒ 对账才可能归零。
|
||||
- 运行时依赖复查(systemd/env/cron/bashrc/平台代码/实例 profile)**零引用** ⇒ `/opt/dsh/docs` 是纯归档位。
|
||||
- 技能沉淀:`dsh-knowledge-upkeep` 新增 **§11「归档镜像结构治理与双端对账」**(三分表 · 负向后顾 · 忽略行尾 · 改名后必查六项 · 安全姿势),三处 md5 一致。⚠️ 自造坑:§11 里写「档案 0 篇」被 `docs-audit` 的【6】当成"引用档案号 0" ⇒ 改写后 rc=0(**写进文档的示例文案会进 lint 扫描面**)。
|
||||
- 自检五件套全 rc=0 + 对账双端一致。未 commit / 未 push。
|
||||
|
||||
## 文档库提交棒(会话 `文档库提交1` · 07:20–07:3x · 已收口)
|
||||
- 用户令:全部优化完成后提交,以本地为准,仓库与本地完全一致,不允许有多出文件。
|
||||
- 结果:commit **`e6207aa`**(239 文件:M47/R45/A107/D40)已**双推**(SSH 仓 + CNB 仓 sha 均 = e6207aa);提交后 `git status` **0 条**、HEAD 无磁盘缺失文件 ⇒ 仓库无「多出」;`/opt/dsh/docs` 对账 **289/289**;docs 自检四件套全 rc=0。
|
||||
- 三道门禁:① 敏感扫描(222 条 dry-run;命中 6 处全为类型声明/测试占位符 ⇒ 无真凭据)② **零丢失核对**(85 个删/改名源用 HEAD 内容 md5 全盘反查,13 个「按名找不到」逐个定性 ⇒ 零丢失)③ 政策边界(交接单 / `dsh-server-docs/tmp/` **不入库**,补 `tmp/` 到 docs 侧 .gitignore)。
|
||||
- 🔴 **本次提交含别的线代码**:`src/im/**`、`src/db/plugin-data/**`、`src/web/routes/im.ts`、`poc/im-*` 等(用户要求「完全一致」⇒ 全量对齐)。相关线须知悉。
|
||||
- 方法论:**判「有没有丢东西」不能只看文件名** —— 改名/移出仓库/内容更新三种都会让同名匹配落空;正确做法是「HEAD 内容 md5(先归一化行尾)+ 本地全盘反查」。另:`git status -sb` 报 `[gone]` 常只是本地引用未 fetch,`git fetch --prune` 即恢复,**别据此判远端被删**。
|
||||
|
||||
## 工作区整理分析(07:3x · 仅分析未动手)
|
||||
- 交付物:`交付物/工作区整理方案-20260924.md`。
|
||||
- 体量:工作区 **3078 文件 / ≈470 MB**。占比:tmp/ 1504 件 167.9M、待清理/ 1084 件 146.2M、归档/ 129 件 111.8M、.workbuddy/ 267 件 44.8M。
|
||||
- 🔴 五问题:① **工作区不是 git 仓库**(无版本控制 ⇒ 一切清理不可逆)② **6 份 33.7M 的 workbuddy.db 副本 = 202MB(占 43%)** + centrifugo 二进制 63.9M ③ `tmp/` 无保留期(847 件 >3 天未动,按棒命名堆积 507 子项)④ **`scripts/` 两个脚本都失效**(`_lock.sh` 引旧路径 `dsh-server-docs/scripts/` ⇒ 已改名 07-scripts,执行必败;`docs-sync-check.sh` 是文档库版的陈旧重复,md5 不同)——属文档库改名的工作区侧残留,此前治理未扫到 ⑤ `待清理/`(09-19 标记 5 天未清)与 `交接单/` 27 件(与文档库 05-交接单/ 21 件零重名,疑被取代)。
|
||||
- 建议:P0 立即可回收 ≈400MB(5 项低风险)|P1 需逐项核对(修 scripts、交接单定性、142M 中间产物、入口判在途)|P2 机制(收口清 tmp、7 天保留期、取消「待清理」中间态、工作区纳版本控制)。
|
||||
- 边界:**本轮只分析,未删/未移任何文件**(工作区无 git,删除不可逆,需先出清单确认)。
|
||||
|
||||
## 工作区回收 + 纳入 git(07:45–08:0x)
|
||||
- 用户令:工作区 git 用 `[email protected]:maogeigei/dsh_shenxian_workspace.git`;**先回收 → 提交 → 再整理**;>60KB 单文件需逐个判是否文档/是否提交。
|
||||
- **回收 411 MB**(470 M → 58.8 M),全部经回收站可恢复:待清理/ 146.2M · tmp/ 32.4M · .workbuddy/tmp/ 39.5M · 4 份 workbuddy.db 冗余副本 101M · centrifugo 63.9M · 缓存。
|
||||
- 建仓:`git init -b master` + remote origin;身份**仓库级** `maogeigei/[email protected]`(全局未配);`core.autocrlf=false`。commit **`ce8e6ce`** 已推(396 件)。
|
||||
- `.gitignore` 判据:只入库跨会话有价值内容。排除 tmp/、待清理/、运行态日志与缓存、`*.db*` 与 `归档/db-cwd归一-备份-20260923/` 整目录、`*.tar.gz|*.tgz`、`.workbuddy/memory/.backup-*/`。
|
||||
- >60KB 判定:28 个中 26 个是文档(memory/交接单/接续入口/docs/交付物);2 个非文档已清出(记忆修复前备份 207K 冗余、`deleted-20260923.tar.gz` 1.2M)。
|
||||
- 整理首项:**撤除工作区 `scripts/`** —— `_lock.sh` 是一次性临时脚本(会话名写死)、`docs-sync-check.sh` 是文档库版的陈旧重复 ⇒ 移入 `归档/工作区-scripts-撤除-20260924/`(含理由 README)。约定:脚本一律绝对路径调文档库 `07-scripts/`。
|
||||
|
||||
## 剩余整理项(按决策方法自决执行 · 07:5x)
|
||||
- **① 交接单 27 件归档** —— 逐件判据:16 件已被文档库正式版取代(实测对应 `交接单-已完成/T09–T21` 13 件 + `覆盖网络-24/25/26` 3 件,同标题、文档库为治理后版本 ⇒ 与旧件 md5 全不同但主题一一对应);4 件主题已被覆盖网络线入口汇总(命中 21/9/12/10 处);7 件历史接续包/规划件文档库无落点。⇒ 全部移入 `归档/交接单-20260924-归档/`(含逐件判定 README)。**依据归属约定:交接单正文落文档库,工作区只放指针。**
|
||||
- **② 4 个接续入口全保留** —— 判据:正文里的「收官/收口」是**历史记录词**,非线收官;4 条线均在推进(覆盖网络序46/IM线A–E/插件投放/技能重组)⇒ 删了代价不对称 ⇒ 不动。
|
||||
- **③ 机制条目** 写入 `CODEBUDDY.md`。
|
||||
- 🔴 **按 §4.5 上抛前三问自决,未开「需要你定的」一节** —— 三问全命中「是」(自有资源 / 已实测 / 第一名明显更优)。
|
||||
|
||||
## 文档库结构治理接续棒(会话 `文档库治理4` · 06:3x–07:0x · 已收口)
|
||||
- §4-1/2/3/4 全做:状态字段补全 16 件(无状态 15→0)· T08 重号标记件清出到 `归档/dsh-server-docs-清理-20260924/` · 4 个空占号锁 rmdir。§4-5 只报告。
|
||||
- §5⑤ 引用体检抓出**上一棒遗留的功能性残留**:`07-scripts` 5 脚本 + 库 `CODEBUDDY.md` + 工作区 `.codebuddy/rules/archive-doc.md` 的旧目录名 `调整方案/`(21 处)⇒ 全部静默失效(manifest 档案号恒空、条件规则 paths 不匹配)⇒ 已修;三件套 rc=0/0/0。
|
||||
- 教训:**改目录名后,功能性常量不只是锁/hook —— 还有 07-scripts 自检脚本的前缀常量与 `.codebuddy/rules` 的 paths glob**;「脚本跑通了」≠「脚本真的在干活」(rc=0 也可能是扫到了空目录)。
|
||||
- 待办:`docs-manifest.json` 重建(改 INDEX.md 需拍板)· 散文类旧前缀清单未改 · `04-调整方案/` 存量不动为政策。
|
||||
|
||||
## 文档库结构治理接续棒 2(会话 `文档库治理5` · 06:42–07:0x · 已收口)
|
||||
- 用户拍板:「1、A 2、B」,按长期有利方向处理 ⇒ ①A 只重建 manifest 不动 INDEX ②B 连 08-skills 一起改并三处同步。
|
||||
- `docs-manifest.json` 重建:**档案 0 → 146 份**(上一棒假绿的根因已消除)。INDEX.md 未动(拍板 ①A)。
|
||||
- 散文旧前缀残留 **29 文件 / 74 处**已修(生效件 4 目录 + 08-skills 12 文件)⇒ 精确正则复验裸旧名 **0 处**。
|
||||
- 技能三处同步完成:库 `08-skills` → 本机 `.workbuddy/skills` → 服务器 `/opt/dsh/docs/skills`,**12/12 md5 全同**,服务器 `chmod 600 root:root` 已保。
|
||||
- 顺带修真悬挂引用:库内 `dsh-plugin-diagnose/SKILL.md` 的 `src/host/08-skills/plugin.ts` → `src/host/skills/plugin.ts`(本机副本原为正确值 ⇒ 证明是改名误替换)。
|
||||
- 自检:consistency rc=0 · handoff-status rc=0(无状态 0)· archive-index rc=1(**拍板 ①A 的预期中间态**:manifest 已重建 / INDEX 未刷)· docs-audit rc=1(**误报**:把 `08-skills/**/07-*.md` 当档案 07;同报「无悬空档案号引用」)。
|
||||
- 🔴 三条方法论(本棒实测教训):① 判旧名残留**必须带负向后顾**(裸 `grep` 把新前缀 `04-调整方案/` 也命中 ⇒ 假阳性 14 vs 真 0)② 判两端一致**必须忽略行尾**(Windows/Linux 换行令 `diff` 整块报差异,但 md5 逐行相同)③ 同步前做**归一化比较**定性差异。
|
||||
- 待办(下一棒):`archive-index --write` 刷 INDEX(需拍板)· `docs-audit.py` 档案号扫描范围限定到 `04-调整方案/`(上一棒修复暴露的既有缺陷)· `INDEX.md` 被 git 判 binary · 服务器上不在库内 08-skills 的技能未纳入 · 未 commit/push。
|
||||
|
||||
## 文档库结构治理接续棒 3(会话 `文档库治理6` · 06:54–07:1x · 已收口)
|
||||
- 用户令「都要执行一直到任务处理完毕」⇒ §9 遗留 1–3 全做完:① `archive-index --write` 刷 INDEX(rc=0,146 篇入索引)② 修 `docs-audit.py` 档案号提取范围(限定根级 + `04-调整方案/`)⇒ rc=0 ③ 修 `INDEX.md` 内 **2 处 NUL**(`\x004-调整方案/`,即 `0` 被写成 NUL;这是 git 判 binary 的根因)⇒ git 恢复文本判定。
|
||||
- 技能集合查明:服务器 12 = 库内 08-skills 12(上一棒"服务器有库外技能"是假阳性 grep 误判);本机多 12 个属跨项目个人技能,不在本线范围。
|
||||
- 自检 **本线首次全绿**:consistency / archive-index / handoff-status(无状态 0)/ audit / manifest 全部 rc=0。
|
||||
- 🔴 新发现(需拍板):**服务器 `/opt/dsh/docs/` 整体仍是「改名前的旧结构」**(`skills/` `交接单/` `scripts/` `archive/` + 顶层散文件),本机/库已是 `01-规范/`…`09-archive/` ⇒ sync-check 报「仅本地 136 / 仅服务器 121」,「一致 146」全来自同名的 `04-调整方案/`。已取证平台代码/env/unit **无 `docs/skills` 引用**(归档位非运行时依赖),但技能文档**自指写死** `/opt/dsh/docs/skills/<name>/SKILL.md` ⇒ 改造须同步改该约定(跨 36 份技能文档),且涉 121 文件重命名 + 删旧目录(不可逆)。
|
||||
- 方法论教训:**「grep 命中」不等于「问题存在」** —— 裸 `grep "调整方案/"` 把新前缀 `04-调整方案/` 一并算上(14 vs 真 0);同类误判还导致上一棒误报"服务器有库外技能"(实际服务器只有 12 个技能目录)。
|
||||
|
||||
## 文档库结构治理接续棒 4(会话 `文档库治理7` · 07:04–07:2x · 已收口)· A 方案
|
||||
- 用户令「A 方案」⇒ 服务器归档镜像 `/opt/dsh/docs/` 结构改造与本机对齐,执行到底。
|
||||
- 主体:全量备份 tar(`/opt/dsh/backups/docs-pre-restructure-20260924-071007.tar.gz`)→ 打包库 289 文件 → 解包新结构 → 旧结构 12 项/121 文件 `mv` 到 `backups/docs-old-structure-20260924-071032/`(⛔ 不 rm)→ 权限 700/755/600 root:root。
|
||||
- 结果:`docs-sync-check.sh` **双端一致 ✅**(289/0/0/0);旧结构归档清单与两条回滚命令写在接续包 §12 九。
|
||||
- 三分表:180 已一致 / 78 服务器旧版 / 0 纯改名 / 22 真独有(5 备份+17 历史旧档,随旧结构留档 ⇒ 零信息丢失)。发现服务器 `交接单/` 下还藏一层更早旧结构 `交接单/archive/`(12 个 T09–T21)。
|
||||
- 🔴 **纠正上一棒误判**:技能自指**本来就用新段名** `/opt/dsh/docs/08-skills/`(不是"写死旧路径")⇒ 改服务器把悬挂变正确。教训:判自指悬挂必须**逐处打印上下文**,不能凭"文档提到 skills"推断。
|
||||
- 库内旧名终扫:补修 **33 处**(第一批 25 + 第二批 8)+ `handoff-guard.sh` 注释 1 处;含修掉 `README.md` 的 `05-交接单/05-交接单/` 双前缀 bug。终验裸旧名 **0**。
|
||||
- 对账脚本 `docs-sync-check.sh` 补排除 `tmp/` 与 `.locks/`(3 处)⇒ 对账才可能归零。
|
||||
- 运行时依赖复查(systemd/env/cron/bashrc/平台代码/实例 profile)**零引用** ⇒ `/opt/dsh/docs` 是纯归档位。
|
||||
- 技能沉淀:`dsh-knowledge-upkeep` 新增 **§11「归档镜像结构治理与双端对账」**(三分表 · 负向后顾 · 忽略行尾 · 改名后必查六项 · 安全姿势),三处 md5 一致。⚠️ 自造坑:§11 里写「档案 0 篇」被 `docs-audit` 的【6】当成"引用档案号 0" ⇒ 改写后 rc=0(**写进文档的示例文案会进 lint 扫描面**)。
|
||||
- 自检五件套全 rc=0 + 对账双端一致。未 commit / 未 push。
|
||||
|
||||
## 文档库提交棒(会话 `文档库提交1` · 07:20–07:3x · 已收口)
|
||||
- 用户令:全部优化完成后提交,以本地为准,仓库与本地完全一致,不允许有多出文件。
|
||||
- 结果:commit **`e6207aa`**(239 文件:M47/R45/A107/D40)已**双推**(SSH 仓 + CNB 仓 sha 均 = e6207aa);提交后 `git status` **0 条**、HEAD 无磁盘缺失文件 ⇒ 仓库无「多出」;`/opt/dsh/docs` 对账 **289/289**;docs 自检四件套全 rc=0。
|
||||
- 三道门禁:① 敏感扫描(222 条 dry-run;命中 6 处全为类型声明/测试占位符 ⇒ 无真凭据)② **零丢失核对**(85 个删/改名源用 HEAD 内容 md5 全盘反查,13 个「按名找不到」逐个定性 ⇒ 零丢失)③ 政策边界(交接单 / `dsh-server-docs/tmp/` **不入库**,补 `tmp/` 到 docs 侧 .gitignore)。
|
||||
- 🔴 **本次提交含别的线代码**:`src/im/**`、`src/db/plugin-data/**`、`src/web/routes/im.ts`、`poc/im-*` 等(用户要求「完全一致」⇒ 全量对齐)。相关线须知悉。
|
||||
- 方法论:**判「有没有丢东西」不能只看文件名** —— 改名/移出仓库/内容更新三种都会让同名匹配落空;正确做法是「HEAD 内容 md5(先归一化行尾)+ 本地全盘反查」。另:`git status -sb` 报 `[gone]` 常只是本地引用未 fetch,`git fetch --prune` 即恢复,**别据此判远端被删**。
|
||||
|
||||
## 工作区整理分析(07:3x · 仅分析未动手)
|
||||
- 交付物:`交付物/工作区整理方案-20260924.md`。
|
||||
- 体量:工作区 **3078 文件 / ≈470 MB**。占比:tmp/ 1504 件 167.9M、待清理/ 1084 件 146.2M、归档/ 129 件 111.8M、.workbuddy/ 267 件 44.8M。
|
||||
- 🔴 五问题:① **工作区不是 git 仓库**(无版本控制 ⇒ 一切清理不可逆)② **6 份 33.7M 的 workbuddy.db 副本 = 202MB(占 43%)** + centrifugo 二进制 63.9M ③ `tmp/` 无保留期(847 件 >3 天未动,按棒命名堆积 507 子项)④ **`scripts/` 两个脚本都失效**(`_lock.sh` 引旧路径 `dsh-server-docs/scripts/` ⇒ 已改名 07-scripts,执行必败;`docs-sync-check.sh` 是文档库版的陈旧重复,md5 不同)——属文档库改名的工作区侧残留,此前治理未扫到 ⑤ `待清理/`(09-19 标记 5 天未清)与 `交接单/` 27 件(与文档库 05-交接单/ 21 件零重名,疑被取代)。
|
||||
- 建议:P0 立即可回收 ≈400MB(5 项低风险)|P1 需逐项核对(修 scripts、交接单定性、142M 中间产物、入口判在途)|P2 机制(收口清 tmp、7 天保留期、取消「待清理」中间态、工作区纳版本控制)。
|
||||
- 边界:**本轮只分析,未删/未移任何文件**(工作区无 git,删除不可逆,需先出清单确认)。
|
||||
|
||||
## 工作区回收 + 纳入 git(07:45–08:0x)
|
||||
- 用户令:工作区 git 用 `[email protected]:maogeigei/dsh_shenxian_workspace.git`;**先回收 → 提交 → 再整理**;>60KB 单文件需逐个判是否文档/是否提交。
|
||||
- **回收 411 MB**(470 M → 58.8 M),全部经回收站可恢复:待清理/ 146.2M · tmp/ 32.4M · .workbuddy/tmp/ 39.5M · 4 份 workbuddy.db 冗余副本 101M · centrifugo 63.9M · 缓存。
|
||||
- 建仓:`git init -b master` + remote origin;身份**仓库级** `maogeigei/[email protected]`(全局未配);`core.autocrlf=false`。commit **`ce8e6ce`** 已推(396 件)。
|
||||
- `.gitignore` 判据:只入库跨会话有价值内容。排除 tmp/、待清理/、运行态日志与缓存、`*.db*` 与 `归档/db-cwd归一-备份-20260923/` 整目录、`*.tar.gz|*.tgz`、`.workbuddy/memory/.backup-*/`。
|
||||
- >60KB 判定:28 个中 26 个是文档(memory/交接单/接续入口/docs/交付物);2 个非文档已清出(记忆修复前备份 207K 冗余、`deleted-20260923.tar.gz` 1.2M)。
|
||||
- 整理首项:**撤除工作区 `scripts/`** —— `_lock.sh` 是一次性临时脚本(会话名写死)、`docs-sync-check.sh` 是文档库版的陈旧重复 ⇒ 移入 `归档/工作区-scripts-撤除-20260924/`(含理由 README)。约定:脚本一律绝对路径调文档库 `07-scripts/`。
|
||||
|
||||
## 剩余整理项(按决策方法自决执行 · 07:5x)
|
||||
- **① 交接单 27 件归档** —— 逐件判据:16 件已被文档库正式版取代(实测对应 `交接单-已完成/T09–T21` 13 件 + `覆盖网络-24/25/26` 3 件,同标题、文档库为治理后版本 ⇒ 与旧件 md5 全不同但主题一一对应);4 件主题已被覆盖网络线入口汇总(命中 21/9/12/10 处);7 件历史接续包/规划件文档库无落点。⇒ 全部移入 `归档/交接单-20260924-归档/`(含逐件判定 README)。**依据归属约定:交接单正文落文档库,工作区只放指针。**
|
||||
- **② 4 个接续入口全保留** —— 判据:正文里的「收官/收口」是**历史记录词**,非线收官;4 条线均在推进(覆盖网络序46/IM线A–E/插件投放/技能重组)⇒ 删了代价不对称 ⇒ 不动。
|
||||
- **③ 机制条目** 写入 `CODEBUDDY.md`。
|
||||
- 🔴 **按 §4.5 上抛前三问自决,未开「需要你定的」一节** —— 三问全命中「是」(自有资源 / 已实测 / 第一名明显更优)。
|
||||
|
||||
## 引用 / 技能 / 规则 全面体检(08:0x–08:2x · 会话 `整理收官1`)
|
||||
- **规则 ✅ 正常**:文档库自检四件套 rc=0/0/0/0(consistency / audit / archive-index / handoff-status,无状态 0)+ `docs-sync-check.sh` 双端 **289/289** 一致。
|
||||
- 🔴 **引用 ❌ 不正常(新病根)**:工作区 **09-23 20:12 由 `E:\ProgramData\AI技能\` 改名为 `AIProject\`**(兄弟目录 `_tools`/`dsh-ai1net-github`/`dsh-ai1net-capability`/`_skill_归档_去AI味_20260920` 同步改名)⇒ **153 文件**仍写旧路径(工作区 107 + 文档库 46)。分级:🔴必改 30 件(工作区 15:`CODEBUDDY.md` `README.md` 3 接续入口 1 接续包 `.workbuddy/tools` 4 `.workbuddy/待落地` 2 `docs/覆盖网络` 2;文档库 15:`08-skills` 8 `01-规范` 3 `07-scripts` 4 `INDEX.md` `BRIEF.md`)|⛔ 不回改 123 件(memory 45 · 归档 32 · docs 证据件 5 · session-sync 2 · 日志/DB 2 · `05-交接单` 21 · `04-调整方案` 8 · 其余档案)。**判据:这条路径会不会被后续会话当命令/当依据执行。**
|
||||
- 🔴 **技能 ❌ 不正常(第二个新病根,更难)**:**库 ↔ 本机 12 个技能中 8 个不一致(16 文件)**,且 **16 件全部是库侧较新(09-24 06:0x)**。根因 = 09-24 06:0x 那次「文档库目录加序号前缀」是**纯子串替换且跑遍了 `08-skills/**`** ⇒ 把**不属于文档库**的通用目录名也加了前缀。**决定性证据**:库写 `bash 07-scripts/install-egress-guard.sh`,本机写 `scripts/`,实测脚本实体在**平台代码仓** `D:\github\dsh_shenxian\scripts\`、文档库 `07-scripts/` 下**没有** ⇒ **本机对、库错**;同类还有 `~/.workbuddy/08-skills/`(库错,实为 `skills/`)、`/api/08-skills/shared`(库错,实为 `/api/skills/shared`)。🔴 **判据 = 「这条路径的目标到底属谁」,⛔ 不是看哪边"更新"。**
|
||||
- 顺带发现技能自身 2 处过时:`dsh-auto-handoff-chain/SKILL.md` §⑤ 仍写「cwds 必须反斜杠+大写盘符」,与 09-24 代码级实测(去重键 = `path.trim().toLowerCase()`,只小写、不统一斜杠;正解 = `E:/ProgramData/AIProject/aliyun-dsh-server` **正斜杠**)**打架**,且命令模板用的还是旧路径 ⇒ 待改。
|
||||
- **处置(自决,未上抛)**:两处修复合计 >160 文件 ⇒ 命中「批量 >10 文件」红线 + 技能一类**必须逐条判**(不可机械替换)⇒ **建接力棒**。产出:`交付物/引用技能规则-体检报告-20260924.md` + `接续包_引用与技能纠偏_20260924.md`(md5 `f42f967892b9a00c5b244f2b1855d4a9`)+ automation **`8117f930-0cce-4a0e-a18d-50b32eb86fb8`**(一次性 · 08:15 · `cwds = E:/ProgramData/AIProject/aliyun-dsh-server`)。commit **`75c6612`** 已推(远端 = 本地 = 75c6612)。
|
||||
- ⚠️ 口径约定:接续包**不自述 md5**(自述即自指)⇒ 校验值一律放 automation prompt 与 automation 记忆。
|
||||
@@ -42,3 +42,13 @@
|
||||
- 门禁:敏感扫描无真凭据 | 零丢失核对(85 删/改名源 md5 反查,零丢失)| 交接单与 docs/tmp 按政策不入库。
|
||||
- ⚠️ 提交含别的线代码(src/im、src/db/plugin-data、poc/im-* 等)——因用户要求全量一致。
|
||||
- 全局执行锁已 release;本棒为文档库治理线**收官**(接续包 §9–§13 全部动作完成)。
|
||||
|
||||
---
|
||||
## 2026-09-24 08:0x–08:2x 执行 — 引用/技能/规则全面体检(会话 `整理收官1`)· 只体检不修复 · 已收口
|
||||
- 用户令:全部整理优化完成后检查「引用 / 技能 / 规则」是否正常;超 token 阈值则建接续会话处理。
|
||||
- **规则 ✅**:文档库自检四件套全 rc=0 + `docs-sync-check.sh` 双端 **289/289** 一致。
|
||||
- **引用 ❌**:工作区 09-23 20:12 由 `E:\ProgramData\AI技能\` 改名 `AIProject\` ⇒ **153 文件**仍写旧路径(工作区 107 / 文档库 46);分级为「必改 30 件」+「不回改 123 件(历史件)」。
|
||||
- **技能 ❌**:库↔本机 12 技能中 **8 个不一致(16 文件)**,16 件**全部库侧较新(09-24 06:0x)**;根因 = 06:0x 批量改名**在 `08-skills/**` 内过度替换**通用目录名。决定性证据:库 `07-scripts/install-egress-guard.sh` 不存在,实体在平台仓 `scripts/` ⇒ **库错本机对**。
|
||||
- **产出**:`交付物/引用技能规则-体检报告-20260924.md` + `接续包_引用与技能纠偏_20260924.md`(md5 `f42f967892b9a00c5b244f2b1855d4a9`);commit **`75c6612`** 已推(工作区仓远端 = 本地)。
|
||||
- **接力棒**:automation **`8117f930-0cce-4a0e-a18d-50b32eb86fb8`**(一次性 · 08:15 · `cwds = E:/ProgramData/AIProject/aliyun-dsh-server` · 工具上限 45 · 域锁 = 08-skills/01-规范/07-scripts/INDEX.md)。**未 commit/push 文档库**(无授权)。
|
||||
- ⚠️ 约定:接续包不自述 md5;md5 校验值只放 automation prompt 与本记忆。
|
||||
@@ -90,6 +90,9 @@
|
||||
| 文档库 `INDEX.md` `BRIEF.md` | 2 | 🔴 改 |
|
||||
| 文档库 `05-交接单/**` | 21 | ⛔ 不改(正文不回改) |
|
||||
| 文档库 `04-调整方案/**` | 8 | ⛔ 不改(过程档案不回改) |
|
||||
| 本包 + `交付物/引用技能规则-体检报告-20260924.md` | 2 | ⛔ 不改(正文里 `AI技能` 是**旧名的叙述**,不是待执行路径) |
|
||||
|
||||
> 🔎 **验收口径**:§5-C 第 1 条「必改档残留 0」**不含**上表 ⛔ 档,也不含本包与体检报告这份「叙述旧名」的两件 —— 统计时请用 §3.1 的逐条清单,⛔ 别用 `grep -rl` 的全量计数(全量必然不是 0)。
|
||||
|
||||
### 3.2 技能库 ↔ 本机 差异(8 技能 / 16 文件,**库侧全部较新 = 09-24 06:0x**)
|
||||
|
||||
|
||||
Reference in new issue
Block a user