7418andClaude Opus 4.6
62dbecd5dc
docs/exec-plans/（新建目录）: - README.md — 执行计划规范、模板、何时需要写执行计划 - active/context-storage-migration.md — 从 research/ 迁移，标注 Phase 0-3 进度状态 （Phase 0 部分完成：sdk_cwd 上线；projects 表和 canUpdateSdkCwd 未实现） - tech-debt-tracker.md — 4 项已知技术债务（ESLint 存量 error、内存态注册表、 固定 50 条 fallback、Phase 0 剩余项） CLAUDE.md: - 新增"执行计划"区块：中大型功能必须先写执行计划再开工 - 文档区块增加 exec-plans/ 索引 ARCHITECTURE.md: - 关键文档索引增加执行计划和技术债务条目 docs/research/README.md: - context-storage-migration-plan 条目增加交叉引用指向执行文档 docs/CLAUDE.md: - 增加 exec-plans/ 目录说明和文档分类规则 目的：确保 AI 后续会话能自动遵循执行计划流程， 读取进度状态而不需要重新口头解释历史。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
36 lines
1.5 KiB
Markdown
36 lines
1.5 KiB
Markdown
# 上下文共享与存储迁移
|
||
|
||
> 原始调研：`docs/research/context-storage-migration-plan.md`
|
||
> 创建时间：2026-02-26
|
||
> 最后更新：2026-03-04
|
||
|
||
## 状态
|
||
|
||
| Phase | 内容 | 状态 | 备注 |
|
||
|-------|------|------|------|
|
||
| Phase 0 | `sdk_cwd` 字段 + backfill | ✅ 部分完成 | `sdk_cwd` 已上线；`projects` 表和 `canUpdateSdkCwd` 逻辑未实现 |
|
||
| Phase 1 | `message_parts` 结构化消息 | 📋 待开始 | 暂用现有 `content` JSON 数组字段 |
|
||
| Phase 2 | `session_runtime_state` 运行态持久化 | 📋 待开始 | 当前依赖内存 Map |
|
||
| Phase 3 | 会话压缩摘要 + archive/fork | 📋 待开始 | |
|
||
|
||
## 决策日志
|
||
|
||
- **2026-02-26**: 完成调研文档，规划 Phase 0-3
|
||
- **2026-02-xx**: `sdk_cwd` 字段上线，backfill 逻辑确认工作正常（`db.ts` L320-323）
|
||
- **2026-03-04**: 迁移为执行文档。Phase 0 的 `projects` 表暂未创建——当前按 `working_directory` 隐式分组已满足需求；`canUpdateSdkCwd` 逻辑暂缺，但实际使用中会话创建时 `sdk_cwd = working_directory` 已固定
|
||
|
||
## Phase 0 剩余项
|
||
|
||
- [ ] 新建 `projects` 表，为历史 session 回填 `project_id`
|
||
- [ ] 在 `PATCH /api/chat/sessions/[id]` 中实现 `canUpdateSdkCwd` 逻辑
|
||
|
||
## Phase 1 前置条件
|
||
|
||
- 确认 Bridge 系统是否需要 `message_parts` 的结构化读取
|
||
- 评估当前 `content` JSON 数组方案的局限性
|
||
|
||
## 详细设计
|
||
|
||
完整的目标表结构、SQL 迁移草案、状态机设计、代码落点建议见原始调研文档：
|
||
`docs/research/context-storage-migration-plan.md`
|