mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-15 12:55:51 +00:00
* feat(workflow): add workflow engine, /workflows panel, /ultracode skill
将 feat/sdk-backend 分支中 workflow 相关的 20 个 commit 压缩为单 commit:
- 工作流引擎核心:phase / agent / parallel / pipeline 编排原语(packages/workflow-engine/)
- /workflows 面板:三区焦点布局(顶部 run tabs + 左侧 phase 侧栏 + 右侧 agent 列表)
- /ultracode skill:多 agent workflow 编排入口
- 进度存储 / journal / notification 系统
- WorkflowService 生命周期管理 + SentryErrorBoundary
- 脚本沙箱:禁用 dynamic import()、JSON args 防御性归一化
- journal 与 named-workflow 路径统一在 projectRoot
- 错误处理:parallel/pipeline hooks 错误日志、failure routing、semaphore abort
- workflow 工具升级为 core 工具 + PascalCase 命名
Co-Authored-By: glm-5.1 <zai-org@claude-code-best.win>
* feat(workflow): 复刻 ultracode 手册并修复 worktree/inline/opt-in 三处缺口
围绕 ultracode skill 审查 agent 系统一致性后:
- ultracode.ts: 用系统提示版完整 Workflow 编排手册替换中文精简版
- HIGH#1 isolation:'worktree': claudeCodeBackend.run() 用 createAgentWorktree +
runWithCwdOverride 包裹 runAgent + finally 清理实现真正的 cwd 隔离;slug 用
sha256(runId:agentId) 派生以匹配 cleanupStaleAgentWorktrees 清理正则
(修 runId 为 w+base36 非 UUID 导致的泄漏盲区);worktree.ts 注释同步修正
- HIGH#2 inline 持久化: 新增 persistInlineScript,WorkflowTool + service 两条
inline 路径对称持久化到 .claude/workflow-runs/<runId>/script.js,返回可复用
scriptPath(闭环 inline→编辑→scriptPath 重提迭代循环)
- HIGH#3 opt-in 分工: ultracode/WorkflowTool/effort 注明 session reminder 由
harness 注入,repo 内无 ultracode 信号,保持 feature('WORKFLOW_SCRIPTS') +
isEnabled 两层 gate,不自造注入
- 测试: 新增 persistInline.test.ts;扩展 claudeCodeBackend(isolation 4 用例)/
WorkflowTool(inline)/service(scriptPath)/ultracode(harness)
含配套 workflow engine/panel 完善与 run-state-persistence design doc。
Co-Authored-By: Claude <noreply@anthropic.com>
* feat(workflow): run 终态落盘 state.json 支持跨重启恢复
终态 RunProgress(含 returnValue/error)此前只在内存 ProgressStore,进程
重启即丢失。本次让其落盘到 .claude/workflow-runs/<runId>/state.json,使
(a) 重启后可按 runId 取 return、(b) /workflows 面板跨重启展示历史 run。
跨进程 resume 明确不在范围。
- persistence.ts: getRunsDir/writeRunState/readRunState/listPersistedRuns
+ attachRunStatePersistence;原子覆盖写(tmp+rename),读容错(缺文件/
损坏/schemaVersion 不符 → null),写 best-effort(IO 失败只 log warn)
- progress/store.ts: 加 hydrate(run) 直接注入磁盘 run(已存在 runId 跳过,
内存优先)
- service.ts: getWorkflowService() 接线 attachRunStatePersistence(bus,
store) 订阅 run_done(completed/failed/killed 三态共用,shutdown-kill
也走同路径,无需额外钩子);WorkflowService 加 getRunAsync(id) 内存
miss→读盘 fallback(不注入内存)+ loadPersistedRuns() 扫盘 hydrate
(persistedLoaded flag 守护幂等)
- panel/WorkflowsPanel.tsx: mount 时调一次 loadPersistedRuns(重 mount
不重复)
- ports.ts: runsDir 改用 getRunsDir() 消除拼接重复
- 测试: persistence.test.ts(11)/runStatePersistence.test.ts(5)/
progressStore(2)/service(5)/WorkflowsPanel(1) 共 24 个新测试;
precheck 5629 pass / 0 fail
设计偏离: 计划原写 monkey-patch getRunsDir 指向 tmpdir,Bun ESM namespace
不可变不可行;改用可选 runsDirProvider 参数(默认 getRunsDir)DI 注入,
加到 attachRunStatePersistence 与 makeService(cwdOverride 之后第 4 参),
与现有 cwdOverride 模式一致。makeService 的 cwdOverride 保持不变,不破坏
inline 持久化特性。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(workflow): 默认并发降为 3 并支持 per-run maxConcurrency 注入
- DEFAULT_MAX_CONCURRENCY=3 替代旧的 min(16, cores-2);MAX_CONCURRENCY_CAP=16 保留为用户输入的绝对上限
- 新增 clampMaxConcurrency() 处理 undefined/<1/>CAP 边界
- WorkflowInput schema 新增 maxConcurrency: number.int().min(1).max(16).optional()
- 引擎层 context/runWorkflow 全链路透传:semaphore 容量来自 per-run 入参
- WorkflowTool prompt 增加指引:fan-out 场景先用 AskUserQuestion 与用户确认并发再启动
- 同步 ultracode skill + audit workflow spec 的并发文字(删 cpu-cores 公式)
- 同步 docs/features/workflow-scripts.md 旧公式
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(workflow): 面板 UI 字符串英文化
WorkflowsPanel 中 4 处面向用户的中文(onDone 错误消息、键位提示行)
改为英文;其他面板组件(AgentList/TabsBar)原本已是英文。代码注释
保留中文,与 workflow 模块惯例一致。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(workflow): 中断系统(x 杀单 agent / K 杀整个 workflow,Dialog 二次确认)
- claudeCodeBackend 桥接 ctx.signal → runAgent.override.abortController(修 'x' 无效根因:abort 到不了内部 fetch)
- AbortError 识别为 throw WorkflowAbortedError(不再吞成 dead,workflow 能感知被 kill)
- ports.taskRegistrar 加 registerAgentAbort/unregisterAgentAbort/killAgent;service.killAgent(runId, agentId) 精确中断
- 面板键位:'x' 杀当前 agent(agents 列聚焦时) / 'K' 杀整个 workflow;Dialog 二次确认 + confirm 模式吞导航键防误触
- 新增测试 8 项(backend signal bridge / hooks inject / ports killAgent / service killAgent)
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* docs(workflow): ultracode skill 加 model tier 选择指引(haiku/sonnet/opus/best 场景匹配)
补足 agent() 已有 model 参数缺的判断依据:列出 4 个 tier 的成本/延迟量级和典型场景,
明确"无法 articulate 为什么换 tier 就 omit"的 rule of thumb。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(workflow): maxConcurrency≠3 必须先 AskUserQuestion(默认 3 推荐值)
把 fan-out 时才问改成任何 maxConcurrency≠3 都必须问。
唯一例外:用户在当前会话已明确说过并发数("use 6" / "maxConcurrency 9")。
prompt (WorkflowTool.ts) + skill (ultracode.ts) + audit spec 三处同步。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(workflow): agent 失败自动重试一次(dead 或非 abort throw)
- hooks.agent 包装 invokeBackend:第一次 dead 或非 abort throw → 重试一次
- WorkflowAbortedError(kill)不重试——是用户意图
- registry.resolve 配置错(AdapterNotFoundError 等)在 try 外直接上抛,不走重试——
配置问题重试无意义且掩盖 bug
- 重试仍失败:dead 保持 dead;throw 降级 dead(不击穿 workflow,
与 parallel/pipeline null-on-error 契约一致)
- budget 不重复扣:dead 不 addOutputTokens,重试 ok 才扣一次
- 新增 7 项 hooks 层重试测试 + 1 项 service 层降级测试
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(workflow): 面板 label 截断保留 #数字 后缀(同 dim 多 finding 可区分)
audit workflow 用 verify:\${dim}#\${findingIdx} 命名 verify agent。
旧逻辑 slice(0, 18) 从右切把 #idx 全吃了——同 dimension 多 finding
肉眼无法区分。新逻辑:含 #数字 后缀时保留后缀,前缀截断 + … 省略号。
例:verify:correctness#0 → verify:correctn…#0
verify:architecture#15 → verify:archite…#15
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(workflow): kill 整个 workflow 后立即回主 chat
run_done→store→notifications.ts 的通知路径已有,但 confirmYes 后面板继续
挂着挡住主 chat,用户看不到"已停止"反馈。kill 后调 onDone() 立即退出面板,
让主 chat 的 `Workflow "<name>" was stopped` 通知直接可见。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(workflow): agent dead 带 reason/detail + prompt 加压 StructuredOutput
12 agent audit workflow 8 个 dead,journal 只记 {kind:"dead"} 无信息,
事后无法区分 "agent 没产 StructuredOutput" vs "runAgent 抛错"。
证据指向主因:sonnet 长 tool chain 后忘记调 StructuredOutput,
extractStructuredOutput 返回 null 即降级 dead。
- types.ts: AgentRunResult.dead 加可选 reason/detail 字段
(no-structured-output / runagent-threw / worktree-failed / unknown)
兼容旧 journal(均 optional)。
- claudeCodeBackend.ts: 三处 dead 填 reason + detail;
no-structured-output 把 finalized 文本前 200 字符做 detail,
让日志/面板能立刻看到 agent 最后说了什么。
- claudeCodeBackend.ts: schema 模式 prompt 首尾各放一次
StructuredOutput 强制要求,针对 sonnet 长 tool chain 后忘记收尾。
- hooks.ts: retry 日志带 reason;retry 仍 throw 时降级 dead 也填
reason=runagent-threw + detail。
- types.test.ts: 加 reason JSON 往返 + 旧 journal 兼容测试。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(workflow): schema 模式弃用 StructuredOutput 工具契约,改鲁棒 JSON 文本解析
上一轮 70a2f76 把"agent 长 tool chain 后忘调 StructuredOutput"当作死因,
加 prompt 头尾双强制。但实测跑 5 个 review agent 4 个 dead,detail 全是
"StructuredOutput tool is not available as a deferred tool"——根因是
该工具从未注入 workflow sub-agent 的工具集(assembleToolPool 默认池不含,
只有 stop_hook 路径 execAgentHook.ts 显式 createStructuredOutputTool())。
prompt 反复要求调一个不可达的工具,agent 困扰、长篇辩解、最终没产 JSON。
- claudeCodeBackend.ts:
- extractStructuredOutput 重写:括号栈扫描替代 indexOf/lastIndexOf,
处理嵌套对象、字符串内的括号、转义符;新增 fenced code block
优先路径(```json / ```),多 JSON 块取第一个 parse 成功的;
只返回 plain object(拒 array/number/string/null)。不做语法修复
(尾逗号/单引号/注释)——避免在字符串内误改(如 "http://" 被 // 注释正则吃)。
- schema 模式 prompt 简化:删首尾双 STRUCTURED OUTPUT 强制(600+ token),
改成指示 agent 在最后文本块 emit raw JSON;明确告知"StructuredOutput
is not available in this environment",消除调用幻觉。
- hooks.ts: detail.slice 用 typeof === 'string' 守卫;catch 块用
e instanceof Error ? e.message : String(e)(旧 journal / 第三方 adapter
可能写非 string detail,直接 .slice 会抛 TypeError 击穿日志)。
- claudeCodeBackend.test.ts: +9 测试覆盖 fenced / 嵌套 / 字符串内括号 /
转义引号 / 多块取首 / 类型守卫 / 损坏 JSON。
precheck: 5663 pass / 0 fail。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* docs(effort): 新增 /effort 交互面板设计 spec
设计要点:
- /effort 无参 → 横向 slider 面板(low/medium/high/xhigh/max/ultracode)
- ←/→ 移动光标,Enter 确认,Esc 取消
- ultracode 仅视觉占位,确认后提示走 /ultracode <context>
- env override 时双标记 + 顶部警告
- 模型不支持时面板禁用
- 两阶段交付:先基础面板 commit,再做 ultracode 波纹动画
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* docs(effort): 新增 EffortPanel 基础面板实施计划(第一阶段)
按 TDD 分 6 个 task:纯函数状态 → keybinding 注册 → 组件 → 命令挂载 → 分支测试 → precheck。
波纹动画在第二阶段单独 commit。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* docs(effort): plan 补 q/ctrl+c 取消绑定,对齐 spec §5 状态机
verifier 抓到的 gap:spec §5 写明 Esc / Ctrl+C / q 都是取消事件,
但 plan Task 2.3 只绑了 escape。补上 q 和 ctrl+c → effortPanel:cancel。
同时把 Step 2.2 直接写成 6 个 action 版本(home/end),删除迂回表达。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* docs(effort): plan 修订执行前 review 发现的 5 处 gap
- Task 3.3 EffortPanel.tsx 草稿:Faster/Smarter padEnd 语法错乱重写;
useKeybindings import 路径从 @anthropic/ink 修正为 ../../keybindings/useKeybinding.js;
移除冗余 renderSeparatorLine;保留 renderPaddedLine
- Task 5.2 computeConfirmOutcome 改为注入 ApplyFn 模式:
避免 effortPanelState → effort.tsx → EffortPanel 循环依赖;
测试可注入 mockApply,无需 mock settings
- Step 5.3 测试代码对齐注入版签名
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): 新增 EffortPanel 纯函数状态模块(PanelPosition + 移动/初始光标)
仅含纯函数与类型,无 React/Ink 依赖,便于单测。
- PANEL_POSITIONS:low → medium → high → xhigh → max → ultracode
- moveLeft/moveRight:边界钳制(low 不再左移、ultracode 不再右移)
- getInitialCursor:env override > displayed level
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(keybindings): 注册 EffortPanel context 与 6 个 action
绑定 ←/→/h/l/home/end/enter/escape/q/ctrl+c 到 effortPanel:* action。
与 ModelPicker context 范式一致,避免左右键被全局 keybinding 拦截。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): 实现 EffortPanel 组件主体(渲染 + 键盘交互 + 确认/取消分支)
- 横向 slider 布局:Faster ↔ Smarter 两极,6 档刻度
- useKeybindings 注册 EffortPanel context(←/→/h/l/home/end/enter/escape/q/ctrl+c)
- Enter 在 5 档之一 → 调 executeEffort 写 settings + AppState
- Enter 在 ultracode → 输出引导文案,不写状态
- Esc/q → "Effort unchanged."
- env override 时顶部黄色警告
- computeConfirmOutcome 注入 ApplyFn,便于测试(Task 5 补测试)
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): /effort 无参时挂载 EffortPanel 交互面板
- 无参 → <EffortPanelWrapper> 透传 AppState.effortValue
- current/status → 仍显示文本(不变)
- 有参 → 直跳 executeEffort(不变)
- help/-h/--help → 不变
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* test(effort): 补 computeConfirmOutcome 分支测试(注入 mockApply)
- ultracode → kind=ultracode-hint,不调 applyFn
- low → kind=apply,message/effortUpdate 来自 applyFn
- applyFn 返回无 effortUpdate 时 outcome.effortUpdate 为 undefined
- CANCEL_MESSAGE / ULTRACODE_HINT 常量
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 测试里 cursor cast 为 EffortValue,避免 PanelPosition 含 ultracode 触发 TS 错误
computeConfirmOutcome 的 ApplyFn 契约要求 EffortValue,但测试 mockApply 接收 PanelPosition。
实际运行时 computeConfirmOutcome 在 ultracode 档位走 hint 分支不会调 applyFn,
cast 安全。precheck 全量通过:5688 tests / 0 fail。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 面板对齐与配色修复
- 对齐:用 Box width={SEGMENT} + justifyContent="center" 让 ▲ 与档位名严格居中对齐,
替代之前 string padEnd(11) 与 SEGMENT=12 不一致导致的 1 列偏移
- 配色:所有面板文字改用 theme.claude(Claude Orange rgb(215,119,87)),
替代终端默认紫;分隔线/副标签/底栏用 theme.subtle;env 警告用 theme.warning
- 光标档位的档位名也加粗,强化视觉焦点
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 面板文字改紫色,ULTRACODE_HINT 英文化
- 颜色:theme.claude(橙)→ theme.purple_FOR_SUBAGENTS_ONLY(Purple 600, rgb(147,51,234)),
覆盖标题、Faster/Smarter、▲、档位名
- ULTRACODE_HINT:中文 → 英文
"ultracode is not an effort level. Use /ultracode <context> to start a multi-agent workflow."
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 统一用色版——选中 suggestion(蓝),未选中 subtle(灰)
弃用 purple_FOR_SUBAGENTS_ONLY(subagent 专用)。改与项目其他面板一致:
- 选中档位 + ▲:color="suggestion"(Medium blue rgb(87,105,247))+ bold
- 未选中档位 + 空 ▲ 占位:color="subtle"(Light gray rgb(175,175,175))
- 标题 / Faster / Smarter:color="suggestion"
- 分隔线 / 副标签 / 底栏:color="subtle"
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(workflow): 终态前补发 phase_done,面板自动退出 running→terminal 转换
runWorkflow:脚本结束时 hook.phase 不会触发最后一个 phase 的 phase_done,
UI 左栏会永远显示 running。三路径(completed/killed/failed)统一在 run_done
之前补发 emitTerminalPhaseDone。
WorkflowsPanel:抽 isRunTerminatedTransition 纯函数判定 running → terminal,
面板 useEffect 检测到转换后自动退出聚焦。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): 波纹动画纯函数 pickChar/computeRippleLine/mergeLayers + 18 测试
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): useRippleFrame hook 包装 useAnimationFrame,按需订阅时钟
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): EffortPanel 集成波纹背景——cursor 停在 ultracode 时切换波纹模式
仅在 cursor === 'ultracode' 时启用 useRippleFrame,渲染 5 行波纹背景
+ overlay 文字(Faster/Smarter、分隔线、▲、档位名、副标签)。
其余档位保持原 PlainContent 渲染路径不动。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* refactor(effort): 波纹动画从字符密度改为颜色渐变
按原版风格把波纹背景从 INTENSITY_CHARS 密度字符('·∙░▒▓')改为
suggestion 系颜色渐变(transparent → 暗深紫蓝 → suggestion → 高光):
rippleAnimation.ts:
- 删除 pickChar / INTENSITY_CHARS / WAVE_PEAK_CHARS / mergeLayers
- 新增 intensityToColor(intensity) → 'transparent' | '#xxxxxx'
- 新增 computeRippleCells 返回 Cell[](每位置 char+color)
- 新增 applyOverlaysToCells(cells, overlays) 替代 mergeLayers
- 新增 cellsToSegments(cells) 合并相邻同色段(减少 Text 节点)
EffortPanel.tsx:
- RippleContent 用 cells→segments→tokens 渲染
- 空格段用 BaseText backgroundColor 染色块(纯色块视觉)
- 文字段用 Text color 染色(亮色突出)
- tokens 按空格/文字二次拆分,避免混合段渲染歧义
测试: 29 个 rippleAnimation 测试覆盖 intensityToColor 边界、
computeRippleCells 长度/震源/衰减、applyOverlaysToCells 覆盖/截断/
防御式拷贝、cellsToSegments 合并逻辑。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 波纹参数调优——铺满左侧 + 速度调慢 + 全面板有底色
用户反馈三个问题:
1. "低峰部分没有颜色变化" → intensity ≤ 0.1 返回 transparent 导致波谷
位置看不见。改为永不返回 transparent,最低档 #0a0d1a 作为面板
底色(暗紫黑海洋),波峰在底色上流动。
2. "波浪速度太快" → time 系数 0.012 → 0.004(约 1/3 速)。波峰移动
速度从 34 cell/s 降到 11 cell/s,每帧颜色变化从 45% 降到 36%。
3. "波浪只到中间部分,没覆盖左侧" → falloff 覆盖半径 40 → 90。
震源 x=65,左侧 dist=65 < 90,波纹可达最左端(约 30-50% 覆盖)。
色阶调整:
- 删除 transparent 档,新增 #0a0d1a 作最暗档(底色)
- 最高档从 #8aa0ff(高光)改为 #5769F7(suggestion),避免与
文字 overlay 同色互相吞噬
- 7 档颜色:#0a0d1a → #15182b → #1f2543 → #2a3360 →
#3a4582 → #4a5bb0 → #5769F7
测试:删除 transparent 期望,改为期望具体颜色(#0a0d1a 等)。
新增"覆盖半径扩大"测试验证 dist=65 仍有非最暗颜色。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* fix(effort): 波纹 v3 — 去黑边 + 删中心高频涟漪 + y 轴覆盖快捷键行
用户反馈三个问题:
1. "黑色边感觉不太对" — 最暗档 #0a0d1a (rgb 10,13,26) 太接近纯黑,
远端波谷看起来像硬黑边。改为 #1a1f3a (rgb 26,31,58),紫蓝感
更强而非纯黑。
2. "中心的快速波纹有点奇怪" — 删除震源附近 dist<6 的高频涟漪叠加
(time*0.02,5 倍主波纹频率)。原本想让震源附近"水波感"更强,
实际效果像"快速闪烁"反而突兀。主波纹已经足够,无需叠加。
3. "y 方向覆盖快捷键" — RippleContent 新增 y=2 行渲染快捷键 overlay
("←/→ adjust · Enter confirm · Esc cancel")。PlainContent 路径
保持原 Box marginTop=1 + Text 渲染。
色阶调整(紫蓝感更强):
- #1a1f3a (原 #0a0d1a) — 最暗档
- #1f2543 / #252c55 / #2e3870 / #3a4582 / #4a5bb0 / #5769F7
(中间档略调亮度,保持平滑过渡)
测试:震源点测试更新为"time=0 时波谷最暗,time 推进后扫过波峰变亮",
反映删除高频涟漪后的纯主波纹行为。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* chore(workflow): 工作流相关代码中文文案全部英文化
源码(src/workflow/ + packages/workflow-engine/src/)的中文注释、
用户可见错误消息、字符串字面量;测试文件的标题与注释;同步 6 条
硬编码断言到英文化后的错误消息。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* feat(effort): 波纹 v4 — 平滑波 + 全色环旋转 + 淡入淡出 + 宽度自适应
- 波函数改 (sin+1)/2:消除 max(0,sin) 平直暗带(约 6 行宽)
- 主色相连续旋转(0.03°/ms,12s/圈全色环):蓝→紫→品红→红→橙→黄→绿→青
- 文字 overlay 同步色相旋转(rotateHue 应用到 Faster/▲/档位名/分隔线/副标签)
- 淡入淡出动画:fadeColor/fadeCells + fade 状态机 ~300ms 进出过渡
- 副标签固定 ultracode 段下方,不跟随光标移动
- 顶部/底部各加一行纯波纹行,视觉一致
- 宽度自适应终端列数:窄则 72,宽则铺满(computeSegment/computeRippleSourceX)
- 快捷键改 plain Text,不参与波纹背景渲染
- 新增 18 测试(fadeColor/fadeCells/rotateHue/getHueShiftAtTime)
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
* refactor: remove CYBER_RISK_MITIGATION_REMINDER from FileReadTool
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win>
* fix: prevent ReDoS in extractMeta regex by anchoring to splice boundary
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win>
* chore: 更新脚本
---------
Co-authored-by: glm-5.1 <zai-org@claude-code-best.win>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: deepseek-v4-pro <deepseek-ai@claude-code-best.win>
409 lines
14 KiB
TypeScript
409 lines
14 KiB
TypeScript
import * as React from 'react';
|
||
import { BaseText, Box, Text, useTerminalSize } from '@anthropic/ink';
|
||
import { useKeybindings } from '../../keybindings/useKeybinding.js';
|
||
import { type EffortValue, getDisplayedEffortLevel, getEffortEnvOverride } from '../../utils/effort.js';
|
||
import {
|
||
type PanelPosition,
|
||
CANCEL_MESSAGE,
|
||
computeConfirmOutcome,
|
||
getInitialCursor,
|
||
moveLeft,
|
||
moveRight,
|
||
PANEL_POSITIONS,
|
||
} from './effortPanelState.js';
|
||
import { executeEffort } from '../../commands/effort/effort.js';
|
||
import { useMainLoopModel } from '../../hooks/useMainLoopModel.js';
|
||
import { useSetAppState } from '../../state/AppState.js';
|
||
import { useRippleFrame } from './useRippleFrame.js';
|
||
import {
|
||
TRANSPARENT,
|
||
type Overlay,
|
||
type Segment,
|
||
applyOverlaysToCells,
|
||
cellsToSegments,
|
||
computeRippleCells,
|
||
fadeCells,
|
||
getHueShiftAtTime,
|
||
rotateHue,
|
||
} from './rippleAnimation.js';
|
||
|
||
/**
|
||
* 每档最小宽度(足够装下 'ultracode' 9 字符 + 居中留白)。
|
||
* 当终端窄时使用此值,保证最低可读性。
|
||
*/
|
||
const MIN_SEGMENT = 12;
|
||
|
||
const SUBLABEL_ULTRACODE = 'xhigh + workflows';
|
||
|
||
// 颜色:与项目主题对齐(suggestion=Medium blue #5769F7)。
|
||
const COLOR_LABEL_SELECTED = '#5769F7'; // 选中档位(suggestion)
|
||
const COLOR_LABEL_DEFAULT = '#7a8eff'; // 未选中档位(淡紫蓝,与波纹背景协调)
|
||
const COLOR_OVERLAY = '#5769F7'; // Faster / Smarter / ▲ 等 overlay 文字
|
||
|
||
// 淡入淡出每帧步长:60ms 间隔下 5 帧达到目标 ≈ 300ms 动画时长。
|
||
const FADE_STEP = 0.2;
|
||
|
||
// 波纹震源 y 坐标(相对波纹区域坐标系,y=0 是档位名行)。
|
||
const RIPPLE_SOURCE_Y = 0;
|
||
|
||
/**
|
||
* 根据终端宽度计算每档实际宽度(SEGMENT)。
|
||
*
|
||
* 规则:
|
||
* - 留出 paddingX={1} 的左右各 1 列 → 可用宽度 = columns - 2
|
||
* - 若可用宽度 <= MIN_SEGMENT * 6(72),用 MIN_SEGMENT(保持当前窄布局)
|
||
* - 否则铺满:floor(可用宽度 / 6)
|
||
*
|
||
* 即"窄则不变,宽则铺满"。最小宽度保证 'ultracode' 9 字符能正常显示。
|
||
*/
|
||
function computeSegment(terminalColumns: number): number {
|
||
const available = terminalColumns - 2; // paddingX={1} 两侧
|
||
const minNeeded = MIN_SEGMENT * PANEL_POSITIONS.length;
|
||
if (available <= minNeeded) return MIN_SEGMENT;
|
||
return Math.floor(available / PANEL_POSITIONS.length);
|
||
}
|
||
|
||
/**
|
||
* 计算波纹震源 x 坐标(ultracode 段内 'ultracode' 标签的中心列)。
|
||
*
|
||
* 'ultracode' 是 9 字符,在 SEGMENT 列内居中:
|
||
* offset = floor((SEGMENT - 9) / 2)
|
||
* labelCenter = SEGMENT * 5 + offset + 4 (4 是 9 字符串的中心偏移)
|
||
*
|
||
* SEGMENT=12 → 60 + 1 + 4 = 65(与历史值一致)
|
||
* SEGMENT=20 → 100 + 5 + 4 = 109
|
||
*/
|
||
function computeRippleSourceX(segment: number): number {
|
||
const LABEL_LEN = 9; // 'ultracode'
|
||
const offset = Math.max(0, Math.floor((segment - LABEL_LEN) / 2));
|
||
const labelCenter = Math.floor(LABEL_LEN / 2); // 4
|
||
return segment * (PANEL_POSITIONS.length - 1) + offset + labelCenter;
|
||
}
|
||
|
||
/**
|
||
* 计算某段 idx 内居中文字的起始列。
|
||
* 动态 segment:textLen 字符在 segment 列内居中。
|
||
*/
|
||
function segmentTextStartX(idx: number, textLen: number, segment: number): number {
|
||
return segment * idx + Math.max(0, Math.floor((segment - textLen) / 2));
|
||
}
|
||
|
||
type Props = {
|
||
appStateEffort: EffortValue | undefined;
|
||
onDone: (message: string) => void;
|
||
};
|
||
|
||
export function EffortPanel({ appStateEffort, onDone }: Props): React.ReactNode {
|
||
const setAppState = useSetAppState();
|
||
const model = useMainLoopModel();
|
||
const { columns } = useTerminalSize();
|
||
|
||
// 自适应宽度:根据终端列数计算每档宽度。
|
||
// 终端变化(resize)时 columns 改变 → 重新计算 → 重渲染。
|
||
const segment = React.useMemo(() => computeSegment(columns), [columns]);
|
||
const panelWidth = segment * PANEL_POSITIONS.length;
|
||
const rippleSourceX = React.useMemo(() => computeRippleSourceX(segment), [segment]);
|
||
|
||
const envOverride = getEffortEnvOverride();
|
||
const displayed = getDisplayedEffortLevel(model, appStateEffort);
|
||
const initialCursor = getInitialCursor({ envOverride, appStateEffort, displayed });
|
||
|
||
const [cursor, setCursor] = React.useState<PanelPosition>(initialCursor);
|
||
const [done, setDone] = React.useState(false);
|
||
|
||
const isOnUltracode = cursor === 'ultracode';
|
||
const [fade, setFade] = React.useState(0);
|
||
// 仍在波纹模式:cursor 在 ultracode,或退出动画未结束(fade > 0)
|
||
const showingRipple = isOnUltracode || fade > 0.001;
|
||
const [rippleRef, time] = useRippleFrame(showingRipple);
|
||
|
||
// 淡入淡出驱动:每 tick(time 推进)朝目标步进 FADE_STEP。
|
||
// 退出动画完成后 fade 归零,showingRipple 变 false,时钟停止订阅。
|
||
React.useEffect(() => {
|
||
if (!showingRipple) return;
|
||
const target = isOnUltracode ? 1 : 0;
|
||
setFade(prev => {
|
||
if (prev === target) return prev;
|
||
const next = target > prev ? prev + FADE_STEP : prev - FADE_STEP;
|
||
return target > prev ? Math.min(target, next) : Math.max(target, next);
|
||
});
|
||
}, [time, isOnUltracode, showingRipple]);
|
||
|
||
const handleConfirm = React.useCallback(() => {
|
||
if (done) return;
|
||
setDone(true);
|
||
const outcome = computeConfirmOutcome(cursor, executeEffort);
|
||
if (outcome.kind === 'apply' && outcome.effortUpdate) {
|
||
setAppState(prev => ({
|
||
...prev,
|
||
effortValue: outcome.effortUpdate!.value,
|
||
}));
|
||
}
|
||
onDone(outcome.message);
|
||
}, [cursor, done, onDone, setAppState]);
|
||
|
||
const handleCancel = React.useCallback(() => {
|
||
if (done) return;
|
||
setDone(true);
|
||
onDone(CANCEL_MESSAGE);
|
||
}, [done, onDone]);
|
||
|
||
useKeybindings(
|
||
{
|
||
'effortPanel:decrease': () => setCursor(c => moveLeft(c)),
|
||
'effortPanel:increase': () => setCursor(c => moveRight(c)),
|
||
'effortPanel:home': () => setCursor('low'),
|
||
'effortPanel:end': () => setCursor('ultracode'),
|
||
'effortPanel:confirm': handleConfirm,
|
||
'effortPanel:cancel': handleCancel,
|
||
},
|
||
{ context: 'EffortPanel' },
|
||
);
|
||
|
||
const envActive = envOverride !== null && envOverride !== undefined;
|
||
const envRaw = process.env.CLAUDE_CODE_EFFORT_LEVEL;
|
||
|
||
// 波纹行 cells 计算:返回该行所有 cell(含 overlay 文字)
|
||
// fade 控制背景颜色亮度(0 → 全 transparent,1 → 完整波纹)。
|
||
// 文字 overlay 也乘以 fade,让进入/退出动画整体淡入淡出。
|
||
const renderRippleRow = React.useCallback(
|
||
(relY: number, overlays: Overlay[]): Segment[] => {
|
||
const cells = computeRippleCells({
|
||
y: relY + RIPPLE_SOURCE_Y,
|
||
width: panelWidth,
|
||
time,
|
||
sourceX: rippleSourceX,
|
||
sourceY: RIPPLE_SOURCE_Y,
|
||
});
|
||
const overlayed = applyOverlaysToCells(cells, overlays);
|
||
const faded = fadeCells(overlayed, fade);
|
||
return cellsToSegments(faded);
|
||
},
|
||
[time, fade, panelWidth, rippleSourceX],
|
||
);
|
||
|
||
return (
|
||
<Box ref={rippleRef} flexDirection="column" paddingX={1} width={panelWidth + 2}>
|
||
<Text bold color="suggestion">
|
||
Effort
|
||
</Text>
|
||
{envActive && <Text color="warning">{`⚠ CLAUDE_CODE_EFFORT_LEVEL=${envRaw} overrides this session`}</Text>}
|
||
{showingRipple ? (
|
||
<RippleContent
|
||
renderRow={renderRippleRow}
|
||
cursor={cursor}
|
||
fade={fade}
|
||
segment={segment}
|
||
panelWidth={panelWidth}
|
||
time={time}
|
||
/>
|
||
) : (
|
||
<>
|
||
<PlainContent cursor={cursor} segment={segment} panelWidth={panelWidth} />
|
||
<Box marginTop={1}>
|
||
<Text color="subtle">←/→ adjust · Enter confirm · Esc cancel</Text>
|
||
</Box>
|
||
</>
|
||
)}
|
||
</Box>
|
||
);
|
||
}
|
||
|
||
// ---- 普通模式(无波纹)----
|
||
|
||
function PlainContent({
|
||
cursor,
|
||
segment,
|
||
panelWidth,
|
||
}: {
|
||
cursor: PanelPosition;
|
||
segment: number;
|
||
panelWidth: number;
|
||
}): React.ReactNode {
|
||
return (
|
||
<>
|
||
<Box marginTop={1} flexDirection="row" justifyContent="space-between">
|
||
<Text color="suggestion">Faster</Text>
|
||
<Text color="suggestion">Smarter</Text>
|
||
</Box>
|
||
<Text color="subtle">{'─'.repeat(panelWidth)}</Text>
|
||
<Box flexDirection="row">
|
||
{PANEL_POSITIONS.map(p => (
|
||
<Box key={`cursor-${p}`} width={segment} justifyContent="center">
|
||
<Text bold color={cursor === p ? 'suggestion' : 'subtle'}>
|
||
{cursor === p ? '▲' : ' '}
|
||
</Text>
|
||
</Box>
|
||
))}
|
||
</Box>
|
||
<Box flexDirection="row">
|
||
{PANEL_POSITIONS.map(p => (
|
||
<Box key={`label-${p}`} width={segment} justifyContent="center">
|
||
<Text bold={cursor === p} color={cursor === p ? 'suggestion' : 'subtle'}>
|
||
{p}
|
||
</Text>
|
||
</Box>
|
||
))}
|
||
</Box>
|
||
<Box flexDirection="row">
|
||
<Box width={segment * (PANEL_POSITIONS.length - 1)} />
|
||
<Box width={segment} justifyContent="center">
|
||
<Text color="subtle">{SUBLABEL_ULTRACODE}</Text>
|
||
</Box>
|
||
</Box>
|
||
</>
|
||
);
|
||
}
|
||
|
||
// ---- 波纹模式(cursor === 'ultracode')----
|
||
//
|
||
// 渲染策略:
|
||
// - 每行先 computeRippleCells 算出强度→颜色的 cell 数组(背景为空格 + 颜色)
|
||
// - applyOverlaysToCells 把文字 overlay(Faster/▲/档位名/副标签)写入对应 cell
|
||
// - cellsToSegments 合并相邻同色段
|
||
// - 渲染层遍历 segments:每个段判断是"空格波纹段"还是"文字段"
|
||
// - 空格段:用 backgroundColor 把空格染成色块(pure color block)
|
||
// - 文字段:用 color 染色文字(背景保持终端默认,让文字最清晰)
|
||
// - 混合段(既有空格又有文字,少见):拆为前后两个 Text
|
||
//
|
||
// 注意:Segment 内可能同时有空格和非空格字符(如 " Faster " 居中文字)。
|
||
// 这种段用 color 渲染时,空格部分不显示色块——视觉上"色块断裂"。
|
||
// 解决:渲染时把 segment 按字符类型二次拆分(runs of whitespace vs non-whitespace)。
|
||
|
||
type RippleContentProps = {
|
||
renderRow: (relY: number, overlays: Overlay[]) => Segment[];
|
||
cursor: PanelPosition;
|
||
fade: number;
|
||
segment: number;
|
||
panelWidth: number;
|
||
time: number;
|
||
};
|
||
|
||
function RippleContent({ renderRow, cursor, segment, panelWidth, time }: RippleContentProps): React.ReactNode {
|
||
// 光标索引跟随 cursor(退出动画期间 cursor 已移到别处,
|
||
// 让 ▲ overlay 跟着移走,ultracode 段恢复普通背景色)。
|
||
const cursorIdx = PANEL_POSITIONS.indexOf(cursor);
|
||
// 副标签固定在 ultracode 段下方,不跟随光标移动。
|
||
const ultracodeIdx = PANEL_POSITIONS.length - 1;
|
||
|
||
// 文字颜色跟随波浪色相旋转:取当前 time 的 hueShift,
|
||
// 应用到所有 overlay 颜色,让文字与背景色环保持同步。
|
||
const hueShift = getHueShiftAtTime(time);
|
||
const overlayColor = rotateHue(COLOR_OVERLAY, hueShift);
|
||
const labelSelectedColor = rotateHue(COLOR_LABEL_SELECTED, hueShift);
|
||
const labelDefaultColor = rotateHue(COLOR_LABEL_DEFAULT, hueShift);
|
||
|
||
const fasterOverlay: Overlay = { text: 'Faster', x: 0, color: overlayColor };
|
||
const smarterOverlay: Overlay = {
|
||
text: 'Smarter',
|
||
x: panelWidth - 'Smarter'.length,
|
||
color: overlayColor,
|
||
};
|
||
const separatorOverlay: Overlay = {
|
||
text: '─'.repeat(panelWidth),
|
||
x: 0,
|
||
color: labelDefaultColor,
|
||
};
|
||
const cursorOverlay: Overlay = {
|
||
text: '▲',
|
||
x: segmentTextStartX(cursorIdx, 1, segment),
|
||
color: overlayColor,
|
||
};
|
||
const labelOverlays: Overlay[] = PANEL_POSITIONS.map((p, idx) => ({
|
||
text: p,
|
||
x: segmentTextStartX(idx, p.length, segment),
|
||
color: p === cursor ? labelSelectedColor : labelDefaultColor,
|
||
}));
|
||
const sublabelOverlay: Overlay = {
|
||
text: SUBLABEL_ULTRACODE,
|
||
x: segmentTextStartX(ultracodeIdx, SUBLABEL_ULTRACODE.length, segment),
|
||
color: labelDefaultColor,
|
||
};
|
||
|
||
// 各行 y 坐标(相对震源 RIPPLE_SOURCE_Y = 档位名行)
|
||
// y=-4: 顶部纯波纹行(视觉一致,无 overlay)
|
||
// y=-3: Faster/Smarter
|
||
// y=-2: 分隔线
|
||
// y=-1: ▲
|
||
// y=0: 档位名(震源)
|
||
// y=1: 副标签
|
||
// y=2: 底部纯波纹行(视觉一致,无 overlay)
|
||
//
|
||
// 快捷键行:plain Text,不参与波纹渲染(无背景动画),紧贴底部波纹行。
|
||
return (
|
||
<>
|
||
<RippleRow segments={renderRow(-4, [])} />
|
||
<RippleRow segments={renderRow(-3, [fasterOverlay, smarterOverlay])} />
|
||
<RippleRow segments={renderRow(-2, [separatorOverlay])} />
|
||
<RippleRow segments={renderRow(-1, [cursorOverlay])} />
|
||
<RippleRow segments={renderRow(0, labelOverlays)} />
|
||
<RippleRow segments={renderRow(1, [sublabelOverlay])} />
|
||
<RippleRow segments={renderRow(2, [])} />
|
||
<Text color={COLOR_LABEL_DEFAULT}>←/→ adjust · Enter confirm · Esc cancel</Text>
|
||
</>
|
||
);
|
||
}
|
||
|
||
/**
|
||
* 渲染一行波纹 segments。
|
||
*
|
||
* 每个 segment 可能含空格 + 文字混合(如 " Faster "):
|
||
* - 空格部分用 backgroundColor 染色块(波纹颜色)
|
||
* - 文字部分用 color 染色(亮色,背景保持终端默认)
|
||
*
|
||
* 简化策略:遍历 segment 字符,按"是否为空格"二次拆分为 token。
|
||
* 相邻同类型 token 合并,避免 React key 爆炸。
|
||
*/
|
||
function RippleRow({ segments }: { segments: Segment[] }): React.ReactNode {
|
||
const tokens: Array<{ text: string; kind: 'space' | 'text'; color: string }> = [];
|
||
for (const seg of segments) {
|
||
// 拆分 seg.text 为空格段和非空格段
|
||
let buf = '';
|
||
let bufIsSpace: boolean | null = null;
|
||
const flush = (): void => {
|
||
if (buf === '' || bufIsSpace === null) return;
|
||
tokens.push({
|
||
text: buf,
|
||
kind: bufIsSpace ? 'space' : 'text',
|
||
color: seg.color,
|
||
});
|
||
buf = '';
|
||
bufIsSpace = null;
|
||
};
|
||
for (const ch of seg.text) {
|
||
const isSpace = ch === ' ';
|
||
if (bufIsSpace === null) {
|
||
buf = ch;
|
||
bufIsSpace = isSpace;
|
||
} else if (isSpace === bufIsSpace) {
|
||
buf += ch;
|
||
} else {
|
||
flush();
|
||
buf = ch;
|
||
bufIsSpace = isSpace;
|
||
}
|
||
}
|
||
flush();
|
||
}
|
||
|
||
return (
|
||
<Box flexDirection="row">
|
||
{tokens.map((tok, i) =>
|
||
tok.kind === 'space' ? (
|
||
tok.color === TRANSPARENT ? (
|
||
<BaseText key={i}>{tok.text}</BaseText>
|
||
) : (
|
||
<BaseText key={i} backgroundColor={tok.color as `#${string}`}>
|
||
{tok.text}
|
||
</BaseText>
|
||
)
|
||
) : (
|
||
<Text key={i} color={tok.color as `#${string}`} bold>
|
||
{tok.text}
|
||
</Text>
|
||
),
|
||
)}
|
||
</Box>
|
||
);
|
||
}
|