Files
dacli/docs/archive/README.md
T
2026-07-17 12:20:48 +08:00

104 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/` 时, **优先看**:
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/ 历史打磨的信息与新架构很多事冲突, 不必要的文件清理掉, 或者放在一个备查文件夹, 避免错误引导"