Files
dacli/docs/archive/README.md
T
ssw 20b0e62312 feat(docs): 归档过期顶层入口文档 prompt.md + README.md (v3.0+) (archive)
- 移除顶层 dacli/prompt.md (v0.7.1 任务说明书, 8 父命令 / 27 子命令口径, 已全过期)
- 移除顶层 dacli/README.md (v0.7 项目入口, 误把 Java 版当生产, 结论与 v3.0 相反)
- 移到 docs/archive/deprecated-v0.6-v0.8/ 加版本后缀 (.v0.7.md / .v0.7.1.md), 避免与目录索引 README.md 同名覆盖
- 更新 docs/archive/README.md (外层索引): 文件数 23→25, 新增'项目入口文档'分类
- 更新 docs/archive/deprecated-v0.6-v0.8/README.md (内层索引): 新增'项目入口文档 (v0.7-v0.7.1, 已被 v3.0 规范替代)'段, 引用 v3.0 主规范 + dacli-ts SKILL.md 作为新权威源
- 不动其它预先存在的变更 (scripts/seed-tds-baseline.ts / snap-menu-page.mjs / .DS_Store)

权威源: ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md (v3.0+, 2026-06-29) + ccWorkDir/.claude/skills/dacli-ts/SKILL.md

测试: PASS (纯 doc move, 无 src/commands/* 改动, 不触发 CI 关卡 G)
2026-06-30 15:16:06 +08:00

6.0 KiB
Raw Blame History

dacli/docs/archive/ — 历史归档 (v3.0+, 2026-06-29)

⚠️ 警告: 本目录所有内容均为历史快照, 与当前 dacli v3.0+ 架构 (应用隔离方案 / webapi 镜像 / 13 个核心 skill) 可能冲突.

权威源: ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md (§一~§十九) + ccWorkDir/.claude/skills/dacli-ts/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-ts/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/ 时, 优先看:

  1. 尚数网基本开发规范v3.0.md (主规范)
  2. cmd-review/app.md / cmd-review/dict.md / cmd-review/di.md (应用隔离相关审计)
  3. 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/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"