清理 help 体系干扰/过期信息, 整体归档: 1. cmd-review/ 25 文件 → archive/cmd-review-2026-07/ - 22 个 2026-06-30 一波生成的命令审计 - 1 个 bigscreen-components (2026-07-01) - 1 个 bigscreen (2026-07-01) - 1 个 app (2026-07-01) - 含 form/dm/menu M2 实战更新版 (建议已落地, 整体降级归档) - cmd-review/ 留 README.md 指针 2. drift/ 20 个 round summary → archive/drift-rounds-2026-07/ - round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17 + day summary - drift/ 保留 README/USAGE/fetch-baseline.sh 基础设施 - drift/README.md 加 ⚠️ 头 3. 改引用: - dacli/README.md §必读文档 改指 archive - 7 个 ADR (0001-0004/0011/0013/0015) 顶部加 ⚠️ 头说明引用路径已迁 - archive/README.md 加 cmd-review-2026-07/ + drift-rounds-2026-07/ 段, 更新结构图, 更新 AI 误读防御清单 新权威源: - 命令用法 → 'dacli <cmd> --help' (DacliHelp 注入 pitfalls/bestPractices/decisionTree) - 决策理由 → docs/decisions/0001-0016 ADR (git-tracked, 权威) - 反模式 → docs/anti-patterns.md (auto-gen, _anti_patterns.ts 为单一权威) 触发: 用户反馈 'dacli help 体系感觉很多干扰/过期信息, 看看怎么处理' + 'cmd-review 22 + drift 13 round 意义不大, 也可归档' Co-Authored-By: Claude <[email protected]>
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 集中归档到本目录, 同时新增 §四 应用隔离方案作为新架构权威源.
归档清单
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) |
| 审计文件本身 | ⚠️ 历史快照, 审计时引用的命令数 / 实现细节可能已过时 |
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 很多描述不对", 已从顶层移到此处.
| 文件类别 | 数量 | 性质 |
|---|---|---|
| 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 主规范 (权威源, §一~§十九)
├── cmd-review/ ← 命令审计 (24 文件, 权威源, v3 §18 引用)
│ ├── _summary.md ← 23 父命令审计总结
│ ├── app.md / dict.md / di.md ← 应用隔离相关审计 (含 BS-47 jxcj P1-5 修复)
│ └── ... (其余 21 命令)
├── web-patches/ ← web 端补丁 (MEMORY 强制保留)
│ └── <comp>.md ← 改 web 端必须存此
└── archive/ ← 历史归档 (本目录, ⚠️ 不作操作指南)
├── README.md ← 本文件
├── v0.11-history/ ← v0.10 → v0.11e+ 阶段产物 (已落地)
├── skill-audit-2026-06/ ← skill 审计快照 (结果已并入 references/)
└── deprecated-v0.6-v0.8/ ← 旧 dacli 架构文档 (extract 脚本时代)
AI 误读防御清单
新会话 AI 第一次进 dacli/docs/ 时, 优先看:
尚数网基本开发规范v3.0.md(主规范)cmd-review/app.md/cmd-review/dict.md/cmd-review/di.md(应用隔离相关审计)cmd-review/_summary.md(命令总览)
跳过不看:
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 作者: Claude Code + dacli 团队 触发: 用户反馈 "dacli/docs/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"