ULTRAPLAN — 增强规划

概述

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

[!info] Feature Flag: FEATURE_ULTRAPLAN=1 实现状态：关键字检测完整，命令处理完整，CCR 远程会话完整

正文

触发方式

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

实现架构

模块状态

模块	文件	行数	状态
命令处理器	`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`	—	布线

关键字检测

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

findUltraplanTriggerPositions(text) 智能过滤：

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

CCR 远程会话

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

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

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

数据流

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/`	空目录，可能是未合并的子命令结构

关键设计决策

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

使用方式

# 启用 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`	—	彩虹高亮

关联笔记

claude-code-best/docs/features/kairos

3.6 KiB Raw Blame History Unescape Escape