Files
sushub f403a7e80e import: ssw/dacli@eea0ebc (2026-08-12) 起点版本
本仓 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,未来以本仓历史为主
2026-08-12 15:58:06 +08:00
..

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.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 <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/ 时, 优先看:

  1. 尚数网基本开发规范v3.0.md (主规范)
  2. decisions/0001-0016 系列 ADR (决策记录)
  3. 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/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"