# 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 --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.md` P0 缺 `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 --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/` 时, **优先看**: 1. `尚数网基本开发规范v3.0.md` (主规范) 2. `decisions/0001-0016` 系列 ADR (决策记录) 3. `anti-patterns.md` (反模式索引) **当前权威 (不用进 cmd-review/)**: - 命令用法 → `dacli --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//` (本目录) - **判别**: 换一个应用能否直接用? 能 → 入 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/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"