vault backup: 2026-06-09 23:15:17

claude-code-best/docs/task/task-004-assistant-session-attach.md

@@ -1,15 +1,27 @@
+---
+tags: [task, assistant, session, attach, KAIROS]
+create time: 2026-06-09 22:30
+---
+
 # Task 004: assistant [sessionId] — 分阶段恢复
 
-> 来源: [stub-recovery-design-1-4.md](../features/stub-recovery-design-1-4.md) 第 4 项
+## 概述
+
+不一次性恢复整个 KAIROS 助手系统。先做"明确 sessionId 的 viewer attach 可用"，再逐步补 discovery / chooser / install。
+
+> [!info]
+> 来源: [[claude-code-best/docs/features/stub-recovery-design-1-4]] 第 4 项
 > 优先级: P3
 > 工作量: Phase 4A 中等，4A-4D 全做完很大
 > 状态: Phase 4A DONE, 4B-4D TODO
 
-## 目标
+## 正文
+
+### 目标
 
 不一次性恢复整个 KAIROS 助手系统。先做"明确 sessionId 的 viewer attach 可用"，再逐步补 discovery / chooser / install。
 
-## 背景
+### 背景
 
 - attach 主流程已存在 (`src/main.tsx:4708`)
 - 远端 viewer 所需基础模块已存在:
@@ -22,9 +34,9 @@
   - `src/commands/assistant/assistant.tsx:7`
   - `src/assistant/index.ts`
 
-## 分阶段实现
+### 分阶段实现
 
-### Phase 4A: MVP — 显式 sessionId attach
+#### Phase 4A: MVP — 显式 sessionId attach
 
 **修改文件:**
 
@@ -42,7 +54,7 @@
 - [ ] 历史懒加载工作正常
 - [ ] 无参数模式给出明确提示
 
-### Phase 4B: session discovery
+#### Phase 4B: session discovery
 
 **修改文件:**
 
@@ -58,7 +70,7 @@
 - [ ] 无参数调用能列出可用 sessions
 - [ ] 数据来源复用现有通道
 
-### Phase 4C: session chooser
+#### Phase 4C: session chooser
 
 **修改文件:**
 
@@ -73,7 +85,7 @@
 - [ ] 多个 session 时弹出选择器
 - [ ] 选择后正确 attach
 
-### Phase 4D: install wizard
+#### Phase 4D: install wizard
 
 **修改文件:**
 
@@ -87,17 +99,22 @@
 **验证:**
 - [ ] 无可用 session 时引导用户创建/连接
 
-## 为什么拆分
+### 为什么拆分
 
 - attach 渲染层与远端消息通道大部分已在
 - 真正缺的是"如何发现目标 session"和"如何交互选择"
 - 如果把 `src/assistant/index.ts` 的整套 KAIROS 正常模式也一起拉进来，范围会失控
 
-## 风险
+### 风险
 
 - 这是四项里范围最大的
 - 一旦把 KAIROS 正常模式整体拉入，会从"viewer attach"膨胀成"完整 assistant mode 恢复"
 
-## 依赖
+### 依赖
 
 - Task 002 的 session registry 模式可复用
+
+## 关联笔记
+
+- [[claude-code-best/docs/features/stub-recovery-design-1-4]]
+- [[claude-code-best/docs/features/kairos]]