> ## Documentation Index
> Fetch the complete documentation index at: https://ccb.agent-aura.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Ultraplan

# ULTRAPLAN — 增强规划

> Feature Flag: `FEATURE_ULTRAPLAN=1`
> 实现状态：关键字检测完整，命令处理完整，CCR 远程会话完整
> 引用数：10

## 一、功能概述

ULTRAPLAN 在用户输入中检测 "ultraplan" 关键字时，自动进入增强计划模式。相比普通 plan mode，ultraplan 提供更深入的规划能力，支持本地和远程（CCR）执行。

### 触发方式

| 方式                  | 行为                       |
| ------------------- | ------------------------ |
| 输入含 "ultraplan" 的文本 | 自动重定向到 `/ultraplan` 命令   |
| `/ultraplan` 斜杠命令   | 直接执行                     |
| 彩虹高亮                | 输入框中 "ultraplan" 关键字彩虹动画 |

## 二、实现架构

### 2.1 模块状态

| 模块       | 文件                                           | 行数  | 状态     |
| -------- | -------------------------------------------- | --- | ------ |
| 命令处理器    | `src/commands/ultraplan.tsx`                 | 525 | **完整** |
| CCR 会话   | `src/utils/ultraplan/ccrSession.ts`          | 349 | **完整** |
| 关键字检测    | `src/utils/ultraplan/keyword.ts`             | 127 | **完整** |
| 嵌入式提示    | `src/utils/ultraplan/prompt.txt`             | 1   | **完整** |
| REPL 对话框 | `src/screens/REPL.tsx`                       | —   | **布线** |
| 关键字高亮    | `src/components/PromptInput/PromptInput.tsx` | —   | **布线** |

### 2.2 关键字检测

文件：`src/utils/ultraplan/keyword.ts`（127 行）

`findUltraplanTriggerPositions(text)` 智能过滤：

* 排除引号内的 "ultraplan"
* 排除路径中的 "ultraplan"（如 `/path/to/ultraplan/`）
* 排除斜杠命令以外的上下文
* `replaceUltraplanKeyword(text)` 清理关键字

### 2.3 CCR 远程会话

文件：`src/utils/ultraplan/ccrSession.ts`（349 行）

`ExitPlanModeScanner` 类实现完整的事件状态机：

* `pollForApprovedExitPlanMode()` — 3 秒轮询间隔
* 超时处理和重试
* 支持远程（teleport）和本地执行

### 2.4 数据流

```
用户输入 "帮我 ultraplan 重构这个模块"
         │
         ▼
processUserInput 检测 "ultraplan"
         │
         ▼
重定向到 /ultraplan 命令
         │
         ├── 本地执行 → EnterPlanMode
         │
         └── 远程执行 → teleportToRemote → CCR 会话
                │
                ▼
         ExitPlanModeScanner 轮询
                │
                ▼
         用户在远程审批 → 本地收到结果
```

## 三、需要补全的内容

| 模块                                                                      | 说明                |
| ----------------------------------------------------------------------- | ----------------- |
| `src/screens/REPL.tsx` 中的 UltraplanChoiceDialog / UltraplanLaunchDialog | 用户选择本地/远程执行的对话框组件 |
| `src/commands/ultraplan/`                                               | 空目录，可能是未合并的子命令结构  |

## 四、关键设计决策

1. **智能关键字过滤**：排除引号和路径中的 "ultraplan"，避免误触发
2. **本地/远程双模式**：支持本地 plan mode 和 CCR 远程会话
3. **彩虹高亮反馈**：输入框中 "ultraplan" 关键字使用彩虹动画，暗示这是特殊功能
4. **processUserInput 集成**：在用户输入处理管道中拦截，无缝重定向

## 五、使用方式

```bash theme={null}
# 启用 feature
FEATURE_ULTRAPLAN=1 bun run dev

# 在 REPL 中使用
# > ultraplan 重构认证模块
# > /ultraplan
```

## 六、文件索引

| 文件                                                   | 行数  | 职责         |
| ---------------------------------------------------- | --- | ---------- |
| `src/commands/ultraplan.tsx`                         | 525 | 斜杠命令处理器    |
| `src/utils/ultraplan/ccrSession.ts`                  | 349 | CCR 远程会话管理 |
| `src/utils/ultraplan/keyword.ts`                     | 127 | 关键字检测和替换   |
| `src/utils/ultraplan/prompt.txt`                     | 1   | 嵌入式提示      |
| `src/utils/processUserInput/processUserInput.ts:468` | —   | 关键字重定向     |
| `src/components/PromptInput/PromptInput.tsx`         | —   | 彩虹高亮       |