**Layout refactor (Phase 1):** - UnifiedTopBar replacing Header.tsx — chat title editing, project folder, commit/push split button, Git branch+dirty badge, terminal/file-tree toggles - PanelZone renders FileTree, GitPanel, PreviewPanel side-by-side on the right - Independent panel toggle states in PanelContext - ResizeHandle unified across all panels - Removed old RightPanel, Header, DocPreview components **Git backend (Phase 2):** - src/lib/git/service.ts — execFile-based Git operations with timeout + injection safety - API routes: status, branches, checkout, log, commit, push, commit-detail, worktrees, derive - Worktree derive creates DB session inheriting source session settings **Git frontend (Phase 3):** - GitPanel with 4 collapsible sections: Status, Branches, History, Worktrees - CommitDialog with commit vs commit-and-push modes - GitBranchSelector with inline error, worktree-occupied branches disabled - GitWorktreeSection with switch-to/derive actions, current/dirty indicators - useGitStatus polled in AppShell, derived into context (no redundant setState) **Terminal (Phase 4):** - electron/terminal-manager.ts — child_process.spawn fallback (PTY upgrade documented) - IPC handlers + TerminalDrawer/TerminalInstance components **Polish (Phase 5):** - Push inline feedback with 4s auto-dismiss - Branch detection fix, commit diff exit-code handling - Removed redundant git state: currentBranch/gitDirtyCount now derived, not setState - useTerminal isElectron uses lazy initializer instead of effect - i18n keys (en + zh), user tutorial docs, handover document Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Exec Plans / 执行计划
中大型功能的执行计划,包含分阶段目标、进度状态和决策日志。
AI 须知:
- 新建执行计划放在
active/,完成后移至completed/ - 纯调研/可行性分析仍放
docs/research/ - 修改或新增文件后更新下方索引
- 检索本目录前先读此文件
什么时候需要执行计划
- 涉及数据库 schema 变更
- 跨 3 个以上模块的功能
- 需要分阶段交付的中大型功能
- 重构或迁移类任务
执行计划模板
# {功能名称}
> 创建时间:YYYY-MM-DD
> 最后更新:YYYY-MM-DD
## 状态
| Phase | 内容 | 状态 | 备注 |
|-------|------|------|------|
| Phase 0 | ... | 📋 待开始 / 🔄 进行中 / ✅ 已完成 / ⏸ 暂缓 | |
## 决策日志
- YYYY-MM-DD: 决策内容及原因
## 详细设计
(目标、技术方案、拆分步骤、依赖项、验收标准)
索引
Active
| 文件 | 主题 | 状态 |
|---|---|---|
| active/context-storage-migration.md | 上下文共享与存储迁移 | Phase 0 部分完成,Phase 1-3 待开始 |
| active/site-and-docs.md | 官网 + 文档站(apps/site) | Phase 0-1 进行中 |
Completed
| 文件 | 主题 | 完成日期 |
|---|---|---|
| completed/engineering-quality-assurance.md | 工程质量保障体系(Harness Engineering)— 验证闭环、AI 文档、CDP、执行计划 | 2026-03-04 |