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

claude-code-best/docs/features/ultraplan.md

@@ -1,13 +1,20 @@
+---
+tags: [ultraplan, 规划, CCR, 远程会话, feature-flag]
+create time: 2026-06-09 22:30
+---
+
 # ULTRAPLAN — 增强规划
 
-> Feature Flag: `FEATURE_ULTRAPLAN=1`
-> 实现状态：关键字检测完整，命令处理完整，CCR 远程会话完整
-> 引用数：10
-
-## 一、功能概述
+## 概述
 
 ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强计划模式。相比普通 plan mode，ultraplan 提供更深入的规划能力，支持本地和远程（CCR）执行。
 
+> [!info]
+> Feature Flag: `FEATURE_ULTRAPLAN=1`
+> 实现状态：关键字检测完整，命令处理完整，CCR 远程会话完整
+
+## 正文
+
 ### 触发方式
 
 | 方式 | 行为 |
@@ -16,9 +23,9 @@ ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强
 | `/ultraplan` 斜杠命令 | 直接执行 |
 | 彩虹高亮 | 输入框中 "ultraplan" 关键字彩虹动画 |
 
-## 二、实现架构
+### 实现架构
 
-### 2.1 模块状态
+#### 模块状态
 
 | 模块 | 文件 | 行数 | 状态 |
 |------|------|------|------|
@@ -29,7 +36,7 @@ ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强
 | REPL 对话框 | `src/screens/REPL.tsx` | — | **布线** |
 | 关键字高亮 | `src/components/PromptInput/PromptInput.tsx` | — | **布线** |
 
-### 2.2 关键字检测
+#### 关键字检测
 
 文件：`src/utils/ultraplan/keyword.ts`（127 行）
 
@@ -39,7 +46,7 @@ ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强
 - 排除斜杠命令以外的上下文
 - `replaceUltraplanKeyword(text)` 清理关键字
 
-### 2.3 CCR 远程会话
+#### CCR 远程会话
 
 文件：`src/utils/ultraplan/ccrSession.ts`（349 行）
 
@@ -48,43 +55,34 @@ ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强
 - 超时处理和重试
 - 支持远程（teleport）和本地执行
 
-### 2.4 数据流
+#### 数据流
 
-```
-用户输入 "帮我 ultraplan 重构这个模块"
-         │
-         ▼
-processUserInput 检测 "ultraplan"
-         │
-         ▼
-重定向到 /ultraplan 命令
-         │
-         ├── 本地执行 → EnterPlanMode
-         │
-         └── 远程执行 → teleportToRemote → CCR 会话
-                │
-                ▼
-         ExitPlanModeScanner 轮询
-                │
-                ▼
-         用户在远程审批 → 本地收到结果
+```mermaid
+flowchart TD
+    A["用户输入: 帮我 ultraplan 重构这个模块"] --> B["processUserInput 检测 ultraplan"]
+    B --> C["重定向到 /ultraplan 命令"]
+    C --> D{"执行模式"}
+    D -->|"本地"| E["EnterPlanMode"]
+    D -->|"远程"| F["teleportToRemote -> CCR 会话"]
+    F --> G["ExitPlanModeScanner 轮询"]
+    G --> H["用户在远程审批 -> 本地收到结果"]
 ```
 
-## 三、需要补全的内容
+### 需要补全的内容
 
 | 模块 | 说明 |
 |------|------|
 | `src/screens/REPL.tsx` 中的 UltraplanChoiceDialog / UltraplanLaunchDialog | 用户选择本地/远程执行的对话框组件 |
 | `src/commands/ultraplan/` | 空目录，可能是未合并的子命令结构 |
 
-## 四、关键设计决策
+### 关键设计决策
 
 1. **智能关键字过滤**：排除引号和路径中的 "ultraplan"，避免误触发
 2. **本地/远程双模式**：支持本地 plan mode 和 CCR 远程会话
 3. **彩虹高亮反馈**：输入框中 "ultraplan" 关键字使用彩虹动画，暗示这是特殊功能
 4. **processUserInput 集成**：在用户输入处理管道中拦截，无缝重定向
 
-## 五、使用方式
+### 使用方式
 
 ```bash
 # 启用 feature
@@ -95,7 +93,7 @@ FEATURE_ULTRAPLAN=1 bun run dev
 # > /ultraplan
 ```
 
-## 六、文件索引
+### 文件索引
 
 | 文件 | 行数 | 职责 |
 |------|------|------|
@@ -105,3 +103,7 @@ FEATURE_ULTRAPLAN=1 bun run dev
 | `src/utils/ultraplan/prompt.txt` | 1 | 嵌入式提示 |
 | `src/utils/processUserInput/processUserInput.ts:468` | — | 关键字重定向 |
 | `src/components/PromptInput/PromptInput.tsx` | — | 彩虹高亮 |
+
+## 关联笔记
+
+- [[claude-code-best/docs/features/kairos]]