本仓 2026-08-12 从 ssw main (192.168.1.18:13300/ssw/ssw-mvp) 的 dacli/ subpath 抽取,作为独立仓托管到 gitea:3000/ssw/dacli.git。 - 工作树为 ssw main dacli subpath 最新版 (110 commit, 08-12) - 历史未带 ssw main 整体历史(避免大仓污染) - 此为新仓基线 commit,未来以本仓历史为主
9.0 KiB
dacli/docs/archive/ — 历史归档 (v3.0+, 2026-06-29)
⚠️ 警告: 本目录所有内容均为历史快照, 与当前 dacli v3.0+ 架构 (应用隔离方案 / webapi 镜像 / 13 个核心 skill) 可能冲突.
权威源:
ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md(§一~§十九) +ccWorkDir/.claude/skills/dacli/SKILL.md误读防御: AI 在 dacli/ 工作时, 不要 仅基于本目录文件做决策. 这些是"我们怎么走到 v3.0+"的考古记录, 不是操作指南.
归档背景
v3.0 升级时, 项目从 AIBridge Python + 19 个独立 skill 跃迁到 dacli TS + 13 个核心 skill + 应用隔离方案.
期间产生的中间产物 (v0.11 各阶段计划 / 体检报告 / 技能审计) 已经全部落地, 但文件本身留在 dacli/docs/ 顶层,
容易被新会话 AI 误读为待执行任务 (例如把"v0.11-next-steps-plan.md"当成新的 todo).
为避免错误引导, 2026-06-29 集中归档到本目录, 同时新增 §四 应用隔离方案作为新架构权威源.
归档清单
cmd-review-2026-07/ (25 文件, 2026-07-23 归档)
2026-06-25 → 2026-06-30 一波生成的 22 个命令审计 + 2026-07-01 的 3 个 (app/bigscreen/bigscreen-components) + 2026-07-20 的 1 个 (kb-implementation-plan 实施计划), 全部已落地或基本已落地, 整体迁移到本目录.
| 性质 | 当前状态 |
|---|---|
| 命令清单 / 选项 / 默认值 | ⚠️ 以 dacli <cmd> --help 为准 (DacliHelp 注入 purpose/pitfalls/bestPractices/decisionTree, task 1.6+ 完整) |
| 决策理由 | ✅ 已沉淀到 dacli/docs/decisions/0001-0016 系列 ADR (权威) |
| 反模式 (踩坑) | ✅ 已沉淀到 dacli/docs/anti-patterns.md (auto-gen, _anti_patterns.ts 为单一权威源) |
为什么归档: 顶层文件 AI 新会话易误读为"待办 P0". 典型过期例子 (历史快照):
doc.md标记 P0 缺dacli doc toc / search→ 2026-07 已实现form.mdP0 缺form update / addFields / rmFields→ form update/addFields/rmFields 已实现kb-implementation-plan.md是"实施计划"性质, 执行完后降级
drift-rounds-2026-07/ (20 文件, 2026-07-23 归档)
2026-07-11 → 2026-07-20 共 17 个 round summary (round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17) + 3 个日期归档 (2026-07-11/2026-07-12/2026-07-20 d0720-jxcj), 全部是"我们怎么修的"考古记录, 修复完成即过期, 整体迁移到本目录.
dacli/docs/drift/ 保留 README.md / USAGE.md / fetch-baseline.sh 3 个基础设施文件.
| 性质 | 当前状态 |
|---|---|
| Round summary 内容 | ⚠️ 历史快照, 修复完成即过期, 不作操作指南 |
| 沉淀到决策 | ✅ 反模式 / 决策已沉淀到 decisions/ 系列 ADR, 后续 dacli <cmd> --help 注入 pitfalls |
| 沉淀到测试 | ✅ "0 漂移"测试留在 dacli/tests/integration/drift/{module}-drift.spec.ts (durable 资产) |
deprecated-v0.6-v0.8/ (25 文件, 2026-06-30 +2)
v0.6 → v0.8 阶段的旧 dacli 架构文档 (AIBridge 前, 静态 JSON + extract 脚本时代). 原 dacli/docs/doc/deprecated/, v3.0+ 移到本目录. 2026-06-30 用户反馈"dacli/prompt.md + dacli/README.md 很多描述不对", 已从顶层移到此处.
v0.11-history/ (7 文件, ~130K)
v0.10 → v0.11e+ 阶段的执行计划 / 体检报告, 已全部落地, 仅备查.
| 文件 | 大小 | 性质 | 当前状态 |
|---|---|---|---|
source-analysis.md |
6.8K | v0.10 源码分析 | v0.11+ webapi 镜像已替代 extract 脚本 |
v0.11-audit-report.md |
22K | v0.11+ 体检报告 (v2) | 已执行, 当前架构即其产物 |
v0.11-cleanup-execution-plan.md |
10K | cleanup 执行计划 | ✅ 已执行完 (2026-06-26) |
v0.11-cleanup-verification-plan.md |
12K | cleanup 验证计划 | ✅ 已执行完 (2026-06-26) |
v0.11-next-steps-plan.md |
37K | v0.11 下一阶段 10 项要求 | ✅ 已全部落地 |
v0.11d+-complete-mirror-plan.md |
16K | v0.11d+ 完整镜像计划 | ✅ 已闭环 (Phase 1-4.1 + di) |
v0.11e+-complete-mirror-plan.md |
25K | v0.11e+ 完整镜像计划 | ✅ 已闭环 (8 个 step machine + AI 增强) |
skill-audit-2026-06/ (26 文件)
2026-06-25 对 13 个 skill 的批量审计报告 (Phase 1, 5 批 × 5/批).
| 性质 | 当前状态 |
|---|---|
| 审计结果 | ✅ 已全部并入 .claude/skills/dacli/references/ (commands / errors / patterns / jnpf-design-rules / platform-mechanisms / form-data-model / web-source-map / playwright / anti-patterns / troubleshooting) |
| 审计文件本身 | ⚠️ 历史快照, 审计时引用的命令数 / 实现细节可能已过时 |
当前 dacli/docs/ 结构 (v3.0+ 权威)
| 文件类别 | 数量 | 性质 |
|---|---|---|
| README / RESUME | 2 | 旧会话恢复指引 (架构已重写) |
| 项目入口文档 (+2) | 2 | dacli-prompt.md.v0.7.1.md (v0.7.1 任务说明书) + dacli-README.md.v0.7.md (v0.7 项目入口), 原位于 dacli/ 顶层, 已被 v3.0 规范替代 |
| 架构 / 计划 / API | 4 | architecture.md / plan.md (6 周路线) / api.md / baseline.md |
| AI 错误 / 优化 | 2 | ai-error-analysis.md / ai-optimization-plan.md |
| extract / help | 2 | extractors.md / help-system.md (v0.11+ 已 webapi 化) |
| v0.6-v0.8 changelog | 9 | 完整版本变更日志 (2026-06-12 ~ 06-21) |
| v0.8 端点 / 扫描 / plan | 3 | v0.8-endpoints.md / v0.8-plan.md / v0.8-scan.md |
| 修复验证脚本 | 1 | verify-form-create-fix.mjs (路径错误, 已并归档) |
| 性质 | 当前状态 |
|---|---|
| 内容 | ⚠️ v0.6-v0.8 旧架构 (静态 JSON / extract 脚本 / 6 周路线 W0-W6), 与 v0.11+ webapi 镜像完全脱节 |
| 处置 | 全部归档, 不删 (考古价值: 还原 v0.11 之前的演进路径) |
当前 dacli/docs/ 结构 (v3.0+ 权威)
dacli/docs/
├── 尚数网基本开发规范v3.0.md ← v3 主规范 (权威源, §一~§十九)
├── decisions/ ← ADR 决策记录 (0001-0016, 权威源)
├── anti-patterns.md ← 反模式 (auto-gen, `_anti_patterns.ts` 单一权威源)
├── audit-2026-07-22.md ← ⚠️ 部分结论已误判, 见 audit-2026-07-23-deep §更正声明
├── audit-2026-07-23-deep.md ← 深度审计 (架构层, 容器内实跑复核 +12 章节)
├── web-patches/ ← web 端基线改动存档 (MEMORY 强制保留)
├── cmd-review/ ← ⚠️ 2026-07-23 整体归档, 仅 README 指针, 看 archive/cmd-review-2026-07/
├── drift/ ← Drift loop 基础设施 (README/USAGE/fetch-baseline.sh), round summary 已归档
└── archive/ ← 历史归档 (本目录, ⚠️ 不作操作指南)
├── README.md ← 本文件
├── cmd-review-2026-07/ ← 25 命令审计快照 (2026-06-30 ~ 2026-07-20)
├── drift-rounds-2026-07/ ← 20 round summary (2026-07-11 ~ 2026-07-20)
├── v0.11-history/ ← v0.10 → v0.11e+ 阶段产物 (已落地)
├── skill-audit-2026-06/ ← skill 审计快照 (结果已并入 references/)
├── deprecated-v0.6-v0.8/ ← 旧 dacli 架构文档 (extract 脚本时代)
└── dacli-ts/ ← 早期 SKILL 草稿 (已废弃)
AI 误读防御清单
新会话 AI 第一次进 dacli/docs/ 时, 优先看:
尚数网基本开发规范v3.0.md(主规范)decisions/0001-0016系列 ADR (决策记录)anti-patterns.md(反模式索引)
当前权威 (不用进 cmd-review/):
- 命令用法 →
dacli <cmd> --help(含 DacliHelp 注入 pitfalls/bestPractices/decisionTree, task 1.6+ 完整) - 命令评审历史 →
archive/cmd-review-2026-07/(历史快照, 不再更新) - Drift round 总结 →
archive/drift-rounds-2026-07/(历史快照, 不再更新)
跳过不看:
cmd-review/顶层 (已整体归档, 仅 README 指针, 自 2026-07-23 起不再更新)archive/任何文件 (除非用户明确要求查历史)doc/deprecated/任何文件 (已废弃)
例外: 当用户说 "查 v0.11 那次体检" / "回看 skill 审计" 时, 才进 archive/.
归档原则 (来自 CLAUDE.md §11)
- 应用特定信息 →
docs/{app_code}/(3 HTML + 4 MD) - 通用规则 / 命令用法 →
CLAUDE.md/ skill SKILL.md - 已完成的历史计划 / 审计快照 →
dacli/docs/archive/<scope>/(本目录) - 判别: 换一个应用能否直接用? 能 → 入 skill; 不能 → 入
docs/{app_code}/; 已过期 → 入 archive.
归档执行: 2026-06-29 (首次), 2026-07-23 (cmd-review 25 + drift round 20 加批次) 作者: Claude Code + dacli 团队 触发 (2026-07-23): 用户反馈 "dacli help 体系 cmd-review 22 文件 + drift 13 round 意义不大, 也可归档" → 整体迁移到本目录 触发 (2026-06-29): 用户反馈 "dacli/docs/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"