Files
CodePilot/docs/handover
7418andClaude Opus 4.6 0eabed8c27 feat: Git integration, terminal, unified layout — full Phase 1-5 implementation
**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>
2026-03-13 00:38:00 +08:00
..

Handover / 交接文档

系统架构、数据流、关键设计决策的持久化记录,供后续开发者(含 AI)快速上手。

AI 须知:修改或新增文件后更新下方索引;检索本目录前先读此文件。

索引

文件 主题
agent-tooling-todo-bridge.md SDK → SSE → DB 事件流、TodoWrite 字段映射、去重策略
bridge-system.md 多 IM 远程桥接系统架构(目录结构、数据流、设计决策)
assistant-workspace.md 助理工作区:人格/记忆文件、对话式引导、自动触发、确定性落盘
theme-system.md 主题家族系统:两层架构、JSON schema、代码高亮三条渲染链、12 个主题清单
cli-tools.md CLI 工具管理:静态 catalog、系统检测、一键安装、AI 描述、聊天上下文注入、输入框选择器
ui-governance.md 设计模式治理:四层架构、ESLint 规则、图标/颜色统一、组件拆分记录、新增文件清单
git-terminal-layout.md Git 集成 + 终端 + 统一布局重构:四层布局、Git 后端/前端、终端抽屉、ResizeHandle 统一、已知债务