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>
1.5 KiB
1.5 KiB
上下文共享与存储迁移
原始调研：
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.tsL320-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的结构化读取 - 评估当前
contentJSON 数组方案的局限性
详细设计
完整的目标表结构、SQL 迁移草案、状态机设计、代码落点建议见原始调研文档：
docs/research/context-storage-migration-plan.md