claude-code-best
9dba90268f
fix: /workflows 面板 phase 状态在脚本省略 phase() 时显示错乱
...
ultracode canonical pipeline 脚本常在 agent() 直接传 opts.phase 而不调 phase()
hook，导致 phase_started 从未发出；同时 phase_done 只在下次 phase() 触发，上一
个 phase 在 run.phases 里一直停在 running。mergePhases 之前把 actual 当权威，
于是出现 "Map 8/8 全 done 还显示 running、Find 1/4 running 反而显示 pending"。
改为派生层修复：mergePhases 新增 derivePhaseStatus——actual.status==='done'
权威；否则有 agents 就按 agents 状态推（全 done→done，否则 running）；否则看
actual 是否 running。再补一层遍历，让只在 agents 上出现的 phase 也进 sidebar。
不改 store 状态语义，已有 state.json 无需迁移。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
1638728305
fix: /workflows 面板默认只显示运行中 run，根治 tab 行乱码
...
之前几次渲染层修复都失败，因为没动 tab 列表的数据源：打开 /workflows 会
自动 hydrate 最多 20 个历史 done/killed run，全部塞进一行 TabsBar，超出
终端宽度后 Ink 把字符画到屏外造成重影乱码。
- selectors.ts 加 filterActiveRuns（只留 status === 'running'）和
capTabsForDisplay（超额 fold 成 +N）两个 pure function
- WorkflowsPanel 接线 activeRuns：focus clamp、focused、nextTab/prevTab、
TabsBar 全部基于过滤后的 activeRuns
- TabsBar 复用 truncateLabel 限制每个 tab 名 18 字符 + 最多 6 个 tab，
多余显示 +N，从结构上钉死单行总宽度
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
ade9babee1
revert: 移除主屏幕周期性 self-healing 重绘
...
回退 f69c7051zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
f47ba3b5de
Revert "fix: 终端内容溢出 viewport 时的重影 bug"
...
This reverts commit 3d18e1da58
2026-06-21 09:30:56 +08:00
claude-code-best
d96323c769
chore: 移除 packages/ 下多处未引用的导出
...
涉及 11 个 workspace 包文件，每处均为独立的 unreferenced export 删除或 export 关键字冗余移除：
- @ant/ink/core/termio/csi.ts（eraseLine）
- acp-link/manager/types.ts、acp-link/ws-message.ts
- builtin-tools/AgentTool/agentMemory.ts、BashTool/bashSecurity.ts、BashTool/sedEditParser.ts
- builtin-tools/ConfigTool/supportedSettings.ts、FileEditTool/utils.ts
- remote-control-server/store.ts、transport/event-bus.ts、types/messages.ts
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
e8dd4419c2
chore: 移除 src/ 下多处未引用的导出
...
涉及 18 个文件，每处均为独立的 unreferenced export 删除或 export 关键字冗余移除：
- bridge/bridgeStatusUtil.ts、components/TrustDialog/utils.ts、context/stats.tsx
- keybindings/loadUserBindings.ts、memdir/paths.ts、remote/sdkMessageAdapter.ts
- services/acp/utils.ts（删除 nodeToWebReadable，全仓零引用）
- services/api/metricsOptOut.ts、services/lsp/LSPDiagnosticRegistry.ts、services/lsp/manager.ts
- services/mcp/utils.ts、services/skillLearning/projectContext.ts
- services/teamMemorySync/secretScanner.ts、services/teamMemorySync/watcher.ts
- skills/loadSkillsDir.ts、utils/attachments.ts、utils/filePersistence/filePersistence.ts
- utils/messageQueueManager.ts
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
f7875fcbb6
chore: 移除 bootstrap/state.ts 中 4 个未引用的 export
...
- clearRegisteredHooks（STATE.registeredHooks 仍由其他函数管理）
- getInvokedSkills（getInvokedSkillsForAgent 是活跃入口）
- getSessionSource（setSessionSource 仍活跃，sessionSource state 字段保留）
- markScrollActivity（scrollDraining/getIsScrollDraining/waitForScrollDrain 仍活跃）
仅删除孤儿访问器，不动模块级 state 副作用。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
9005432f86
chore: 移除 Tool.ts 中 backwards-compat 重导出 shim
...
删除 "// Re-export progress types for backwards compatibility" 注释块及其重导出语句。所有消费方已直接从 src/types/tools.js 导入，无需重导出转发。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
57f13d1c6b
chore: 删除 agentSdkTypes 第二批 not-implemented stub
...
移除运行时函数体仅为 throw new Error 或 placeholder 的 stub：
- createSdkMcpToolDefinition、createSdkMcpServer
- query 函数重载与实现
- unstable_v2_* 系列函数
- session 操作 stub（getSessionMessages/listSessions/getSessionInfo/renameSession/tagSession/forkSession）
- AbortError 类
保留所有 export type 重导出和类型别名（仍是公共类型面）。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
402d076bf8
chore: 移除 goalAudit stub 及其测试引用
...
- 删除 src/services/goal/goalAudit.ts（导出 COMPLETION_AUDIT_RULES/BLOCKED_AUDIT_RULES/isGoalTerminal 等未引用的 stub）
- 同步移除 tests/integration/goal-lifecycle.test.ts 中对 goalAudit 的 import 和一个测试用例（budget_limited is terminal）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
bdfe84bc94
chore: 移除 cachedMCConfig stub 及 prompts.ts 的 CACHED_MICROCOMPACT 死代码
...
- 删除 src/services/compact/cachedMCConfig.ts（自动生成的 stub）
- 同步移除 src/constants/prompts.ts 中依赖该 stub 的代码：
- getCachedMCConfigForFRC 变量（feature('CACHED_MICROCOMPACT') 守卫的 require）
- getFunctionResultClearingSection 函数（约 18 行）
- systemPrompt 数组中的 frc section 调用与注册
CACHED_MICROCOMPACT 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
704c2d7245
chore: 移除 ultrareview preflight stub 及其测试
...
- 删除 src/services/api/ultrareviewPreflight.ts（自动生成的 stub）
- 删除 src/commands/review/UltrareviewPreflightDialog.tsx（依赖前者的 UI stub）
- 删除 src/services/api/__tests__/ultrareviewPreflight.test.ts（测试已删代码）
- 同步移除 ultrareviewCommand.test.tsx 中对 UltrareviewPreflightDialog 的 mock
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
fe22aa71b2
chore: 删除孤立诊断脚本 probe-local-wiring.ts
...
#!/usr/bin/env bun shebang 的手动诊断脚本，全仓零引用，不在 package.json/build.ts/vite.config.ts/CI workflows 中。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
6d96173ae2
chore: 移除 environment-runner stub 及其 cli.tsx fast-path
...
与 self-hosted-runner 相同模式的 sibling（工作流 1 verifier 建议同步处理）：
- 删除 src/environment-runner/main.ts（自动生成的 Promise.resolve() stub）
- 同步移除 src/entrypoints/cli.tsx 中 feature('BYOC_ENVIRONMENT_RUNNER') 守卫的 fast-path 分支
- 清理两个空目录（src/self-hosted-runner/、src/environment-runner/）
BYOC_ENVIRONMENT_RUNNER flag 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
2711b638c8
chore: 移除 ccshareResume stub 及 main.tsx 的 ccshare fast-path
...
- 删除 src/utils/ccshareResume.ts（parseCcshareId 恒返回 null、loadCcshare 恒抛错的 stub）
- 同步移除 src/main.tsx 中 USER_TYPE === 'ant' 守卫下的 if (ccshareId) {...} else {...} 双分支
- 提升 else 块（文件路径 resume 处理）为直接进入 if (options.resume) 块内
ccshare 是 Anthropic 内部特性（go/ccshare URL），stub 未实现导致 ccshareId 恒为 null，整个 ccshare 分支永不进入；保留的文件路径 resume 路径不变。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:56 +08:00
claude-code-best
b55ae75bf8
chore: 清理注释代码块与 legacy shim
...
注释代码（已死的、引用不存在符号的注释块）：
- Onboarding.tsx: 注释化的 preflight if-block（引用不存在的 preflightStep）
- ultraplan.tsx: 两处引用不存在符号的注释（ULTRAPLAN_INSTRUCTIONS、getUltraplanModel）
- types/hooks.ts: 禁用的 type-fest IsEqual 类型断言块
- types/global.d.ts: 已被真实模块取代的 Ultraplan ambient declares
- types/textInputTypes.ts: 注释化的 onMessage interface 成员
legacy shim：
- cli/bg.ts: 删除 handleBgFlag 别名 export（同胞 handleBgStart 已被所有调用点使用）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
ef18f95cf4
chore: 移除多处仅内部使用的 export 关键字
...
下列符号均仅在本文件内被引用，export 关键字冗余；保留符号本体不动：
- internalLogging.ts: getContainerId（line 88 内部调用）
- api/errors.ts: isMediaSizeError（line 151 内部调用）
- api/withRetry.ts: parseMaxTokensContextOverflowError（line 389/724 内部调用）
- statsCache.ts: STATS_CACHE_VERSION（7 处内部使用）
- startupProfiler.ts: logStartupPerf（line 128 内部调用）
- bashCommandHelpers.ts: CommandIdentityCheckers（3 处内部参数类型）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
5929308f53
chore: 移除 binaryCheck/claudeAiLimits/codeIndexing 中未引用的导出
...
- binaryCheck.ts: 删除 clearBinaryCache（零调用，binaryCache 仍由 isBinaryInstalled 使用）
- claudeAiLimits.ts: 删除 RATE_LIMIT_DISPLAY_NAMES 常量 + getRateLimitDisplayName（互为唯一消费者）
- codeIndexing.ts: 删除 detectCodeIndexingFromMcpTool（同胞 detectCodeIndexingFromCommand/McpServerName 仍活跃）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
6194017e9e
chore: 移除 autonomyCommandSpec.ts 中未引用的导出
...
- 删除 AUTONOMY_CLI（CLI 子命令描述对象，零引用；handler 仅用 AUTONOMY_USAGE）
- 删除 AUTONOMY_COMMAND_DESCRIPTION（值已在 main.tsx:5181 内联）
- ParsedAutonomyCommand 仅移除 export 关键字（保留类型作为 parseAutonomyArgs 返回类型）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
55a1711e86
chore: 移除 insights.ts 中未引用的导出
...
- 删除 deduplicateSessionBranches（全仓零调用，含 JSDoc）
- 删除 buildExportData（全仓零调用，原 S3 上传路径实际用 HTML 而非 JSON）
- InsightsExport 仅移除 export 关键字（保留类型本体，仍作为内部返回类型）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
7242e5cb44
chore: 移除 Cursor.ts 中未引用的 kill ring 访问器
...
- 删除 getKillRingItem、getKillRingSize、clearKillRing、canYankPop（全仓零引用的独立 export）
- 移除 VIM_WORD_CHAR_REGEX 的 export 关键字（仍由 isVimWordChar 内部使用，保留常量本体）
kill ring 特性本身仍活跃（getLastKill/pushToKillRing/yankPop 在 useSearchInput/useTextInput 使用），仅这几个孤儿 helper 未接入。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
07a1a21028
chore: 删除 agentSdkTypes 中三个 not-implemented stub
...
移除 watchScheduledTasks、buildMissedTaskNotification、connectRemoteControl 三个 stub 函数（函数体仅 throw new Error('not implemented')），以及仅被这些 stub 引用的孤儿类型（ScheduledTasksHandle、ConnectRemoteControlOptions、RemoteControlHandle、InboundPrompt 等）。
全仓零外部引用。buildMissedTaskNotification 在 src/utils/cronScheduler.ts 有真实可用实现，未受影响。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
7c42e97de2
chore: 移除 self-hosted-runner stub 及其 cli.tsx fast-path
...
- 删除 src/self-hosted-runner/main.ts（自动生成的 Promise.resolve() stub）
- 同步移除 src/entrypoints/cli.tsx 中 feature('SELF_HOSTED_RUNNER') 守卫的 fast-path 分支
- 该 flag 不在 build.ts DEFAULT_BUILD_FEATURES 也不在 dev 默认列表，所有默认配置下整段为构建期死代码
删除 stub 单独会留下未解析的动态 import，必须协同拆除。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
67d9d34ff7
chore: 删除 3 个孤立诊断脚本
...
- scripts/verify-autofix-pr.ts: 一次性 autofix-pr 验证脚本，全仓零引用
- scripts/smoke-test-commands.ts: 开发期冒烟测试脚本，无任何 import
- scripts/probe-subscription-endpoints.ts: 手动 endpoint 探针，无引用
均不在 package.json scripts、build.ts、vite.config.ts、CI workflows 中。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-21 09:30:55 +08:00
claude-code-best
3d18e1da58
fix: 终端内容溢出 viewport 时的重影 bug
...
主屏幕模式下 frame 持续溢出 viewport 时，cursor-restore LF 把内容滚入 scrollback
导致相对光标追踪漂移，可见区 diff 落到错误行产生重影（重复 banner / 错位）。
扩展 log-update overflow 分支为无条件 fullReset（含 \x1b[3J 清 scrollback），
并将主屏 self-healing 清屏从 ERASE_SCREEN (CSI 2 J) 换成 ERASE_DOWN (CSI J)，
避免 xterm.js / VSCode 集成终端的 scrollback 边界副作用。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 22:35:12 +08:00
claude-code-best
8db85f1aaf
chore: 2.8.0
2026-06-20 19:53:00 +08:00
claude-code-best
084e487943
feat: 新增 artifacts 功能 ( #1278 )
...
* feat: 新增 cloud-artifacts 包（Cloudflare Worker HTML artifact 托管）
POST /upload 鉴权上传 HTML 到 R2 返回 hash URL，GET /<7d|30d>/<id>.html
由 Worker 代理读取并直出 text/html。R2 lifecycle rule 自动 7/30 天删除。
独立服务，不被主 CLI 引用（类似 packages/remote-control-server/ 定位）。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* docs: 完善 cloud-artifacts 文档并统一出口域名
- CLAUDE.md 加 cloud-artifacts 到 Workspace Packages 表和新增 HTML Artifact Hosting 段落
- docs.json 注册 cloud-artifacts 到运行模式 group
- README 加 Quickstart、架构图（含 Deno Deploy 代理层）、Security Considerations、Troubleshooting
- 统一出口域名为 https://cloud-artifacts.claude-code-best.win（wrangler.toml PUBLIC_URL、test.sh 默认 WORKER_URL、所有文档示例）
- test.sh expect() 加 [via body] fallback：经 Deno Deploy 代理（status 抹平为 200）时按 body 的 error 字段断言
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* docs: 修正 CLAUDE.md cloud-artifacts 引用死链
之前指向不存在的 docs/features/cloud-artifacts.md（用户未注册到 docs.json），
改为指向已存在的 packages/cloud-artifacts/README.md，并补充生产出口域名
与 Deno Deploy status 抹平副作用的说明。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* chore: 同步 cloud-artifacts 测试默认 TOKEN 到新值
用户已通过 wrangler secret put 把生产 TOKEN 改为 claude-code-best，
test.sh 的默认值（之前用旧 token 作 fallback）和注释示例同步更新。
现在直接 bash scripts/test.sh 即可跑通（无需显式传 TOKEN）。
src/index.ts 不依赖具体 token 值（只读 env.TOKEN 做比较），
wrangler.toml 不含 secret，README/.dev.vars.example 用 <your-token>
占位符故无需改。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* docs: add artifacts feature implementation plan
* feat(artifact): add cloud-artifacts config with token/URL defaults
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add HTTP client with body-error parsing
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add tool name, description, and prompt
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add buildTool definition with file validation
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* test(artifact): add end-to-end tool tests for upload/error paths
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): export ArtifactTool from builtin-tools barrel
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): register ArtifactTool in tools list
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add /use-artifacts bundled skill
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add extractArtifacts message scanner
Scans Message[] for artifact tool_use/tool_result pairs, parses URL/id/expires
from the upload response string, and returns ArtifactInfo[] newest-first.
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* fix(artifact): scanner type narrowing and url regex
- Use double assertion (`as unknown as Record<string, unknown>`) at lines 30
and 90 to fix TS2352 per project convention
- Tighten URL_REGEX to avoid capturing trailing punctuation (parens,
quotes, commas) when URL is embedded in text
- Add test case for array-form tool_result content path
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add ArtifactsMenu Ink component
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): add /artifacts slash command entry
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): register /artifacts command
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* fix(artifact): use setClipboard instead of pbcopy for cross-platform support
* fix(artifact): drop userFacingName override so display matches /artifacts
* fix(rcs): add resJson helper to resolve strict mode type errors in tests
Hono Response.json() returns Promise<unknown> under strict TypeScript,
causing 121 TS errors across middleware and routes test files.
Co-Authored-By: glm-5-turbo <zai-org@claude-code-best.win >
* fix(cloud-artifacts): add type stubs so tsc passes without worker-configuration.d.ts
The wrangler-generated worker-configuration.d.ts is gitignored, causing CI to
fail with missing ExportedHandler/Env/R2Bucket types. This file provides minimal
stubs for all Cloudflare Workers types used by the artifact upload Worker.
Co-Authored-By: glm-5-turbo <zai-org@claude-code-best.win >
* fix(query): shallow-copy messages before stripping toolUseResult
Previously the per-query cleanup mutated messagesForQuery entries in
place via `delete msg.toolUseResult`. Those entries are references
shared with mutableMessages (UI state), so the delete stripped the
field from the live message object. The next query can start within
milliseconds of tool_result creation — before the React UI commit
lands — so UserToolSuccessMessage's `!message.toolUseResult` check
returned null and tool.renderToolResultMessage was never called,
leaving tool-result rows blank.
Map to a stripped copy instead so mutableMessages keeps the original
for the UI. Downstream API transformations (applyToolResultBudget,
snip, microcompact) already build new arrays via .map(), so they
compose cleanly with this copy.
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* feat(artifact): show uploaded URL inline below ExecuteExtraTool
Deferred tools (shouldDefer: true) are invoked via SearchExtraTools →
ExecuteExtraTool, so their tool_result rows used to render blank —
the UI looked up ExecuteExtraTool, which had no renderToolResultMessage,
and returned null. Add a generic delegation in ExecuteTool that forwards
renderToolResultMessage to the inner tool when it defines one, unwrapping
the { result, tool_name } envelope and the params from the input shape.
All 28 deferred tools can now render their own UI by defining
renderToolResultMessage.
For ArtifactTool specifically, render the uploaded URL as an OSC 8
hyperlink (Link component) in warning color so it's visually prominent,
with the expiry timestamp on a second line and a separate error branch.
Also add `error: z.string().optional()` to outputSchema — zod's default
strip mode was dropping the field, so error states never reached the UI.
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* fix(cloud-artifacts): make Env stubs actually take effect in CI
The previous stub file (2e29e362zai-org@claude-code-best.win >
---------
Co-authored-by: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 19:52:08 +08:00
claude-code-best
5d74071ebf
Merge pull request #1276 from claude-code-best/fix/acp-protocol
...
Fix/acp protocol
2026-06-20 13:03:07 +08:00
claude-code-best
aa9dd4b096
Merge branch 'fix/workflow-run-accumulation' into fix/acp-protocol
2026-06-20 12:45:55 +08:00
claude-code-best
4e9b89c48b
fix: workflow 面板历史 run 堆积 + service.launch 丢失 title
...
- persistence: listPersistedRuns 加 limit 参数；新增 cleanupOldRuns 在 run_done 后异步清理超过 50 个的旧 run（负数 keepMax clamp 到 0）
- service: loadPersistedRuns 限制 hydrate 最近 20 个；resolveSource 读 input.title 对齐 WorkflowTool 优先级链
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:39:07 +08:00
claude-code-best
02d84bcab0
fix: listSessions 严格按 cwd 过滤并移除 session/load 过严校验
...
- listSessions: 客户端省略 cwd 时回退到 getOriginalCwd(),并对每个候选会话的
存储 cwd 做 canonicalizePath 规范化后与请求 cwd 严格匹配,确保只返回真正属
于当前工作区的会话(符合 session-list.mdx "Only sessions with a matching
cwd are returned")
- sessionLifecycle: 移除 getOrCreateSession 中审计 2.2 添加的 cwd 一致性校验,
它会拒绝 resolveSessionFilePath worktree fallback 找到的合法会话加载
- 补充 listSessions 的 5 个测试用例覆盖 cwd 透传/fallback/分页拒绝/无 cwd 过滤
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
0f2eec496c
feat(acp): bypassPermissions 默认显示，去掉 opt-in 限制
...
之前 bypassPermissions 需要本地显式 opt-in（ACP_PERMISSION_MODE 环境变量、
CLAUDE_CODE_ACP_ALLOW_BYPASS_PERMISSIONS 环境变量、或 settings.permissions.defaultMode）
才会出现在 modes 列表里 —— 标准客户端看不到这个 mode，永远没法切换。
去掉 opt-in 后，只要进程级允许（非 root 或 IS_SANDBOX=1）就显示。
- permissionMode: isAcpBypassPermissionModeAvailable 只保留进程级检查，删除
isAcpBypassLocallyEnabled / isSettingsBypassPermissionMode / isTruthyEnv 等
只服务于 opt-in 的辅助函数
- createSessionMethod: 调用方去掉 settingsMode 参数
- agent.test: 反转所有依赖 "bypass 需要 opt-in" 的断言
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
704c6c7814
fix: ACP NewSessionResponse 恢复返回 models 字段
...
67fdd4ca 那次合规审计误将 models 从响应里移除，但 SDK 0.19.2 的 schema 实际允许
models?: SessionModelState | null（标注 UNSTABLE 仅表示"未来可能变"，并非
"agent 禁止返回"）。标准 ACP 客户端（Cursor/Zed/VS Code/RCS）依赖此字段填充
模型选择器 —— 缺失会导致客户端 supportsModelSelection=false，模型切换 UI 不可用。
- createSessionMethod: return 里加回 models
- sessionLifecycle: getOrCreateSession 两处 return 透传 models（resume/load 路径）
- agent.test: 更新过时的 "models omitted for v1 compliance" 断言
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
0103f45109
feat: 实现 ACP session/delete + message-id 两个 UNSTABLE RFD
...
session/delete（rfds/session-delete.mdx）：
- sessionCapabilities.delete: {} 能力广告（类型增强写入,SDK 0.19.0 早于该 RFD）
- extMethod 钩子路由 session/delete → unstable_deleteSession
- 硬删除 .jsonl 文件,ENOENT 视为成功（幂等）
- 未知方法抛 RequestError.methodNotFound（JSON-RPC -32601）
message-id（rfds/message-id.mdx）：
- agent_message_chunk / user_message_chunk / agent_thought_chunk 携带 messageId
- forwardSessionUpdates 维护 currentAgentMessageId,lazy 生成 UUID
- streaming text/thinking chunks 与最终 assistant message 共享同一 ID
- replayHistoryMessages per-message 生成 UUID
- PromptRequest.messageId → PromptResponse.userMessageId 回显
- tool_call / plan / subagent 不带 messageId（spec 仅规定 chunk 类型）
测试：ACP service 从 176 → 191 (+15)
- bridge.test.ts: +9 个 message-id 测试
- agent.test.ts: +6 个 session/delete + userMessageId 测试
- 总测试 5851 → 5866,全通过
审计文档：新增附录 A.2 记录两个 UNSTABLE RFD 实现状态
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
cac23e62cc
fix: 恢复 ACP usage 传递（usage_update + PromptResponse.usage）
...
撤销审计 §4.1 的原修复（删除 usage_update 以求严格 v1 stable 合规）。
现实中的所有主流 ACP 客户端（Zed、Cursor 等）实现的是 unstable spec，
删除 usage_update 后客户端 context 使用量一律显示 0/0，严重破坏 UX。
SDK 已包含 UsageUpdate 类型（sessionUpdate: 'usage_update'，字段 used + size
+ 可选 cost）和 PromptResponse.usage 根字段（UNSTABLE 但被广泛实现），这是
context 使用量报告的唯一标准化载体，故选择优先保证 interop。
变更：
- bridge/forwarding.ts: 收到 'result' 消息且 lastAssistantTotalUsage !== null
时发送 usage_update
- used = 最近一条 assistant 消息的 input + output + cache_read + cache_creation
token 总和（≈ 当前上下文占用）
- size = lastContextWindowSize（默认 200000，通过 modelUsage prefix-match 解析）
- compact_boundary 时不发（不知道压缩后实际占用；下一轮 result 会自然修正）
- agent/promptFlow.ts: PromptResponse 根部添加 usage 字段，并镜像到
_meta.claudeCode.usage 供消费者任选读取路径
- 测试更新：bridge.test.ts 三个相关 test 改为断言 usage_update 被发出且
used/size 正确；agent.test.ts 改为断言 root usage 存在
- 审计文档 §4.1 标记为已撤销，添加决策回滚说明
验证：bun run precheck 全通过（typecheck + lint + 5851 tests）
ACP service tests: 176 pass / 0 fail
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
65f81de52b
refactor: 拆分 3 个过大 ACP 文件为模块化子文件（每个 <500 行）
...
通过 4 阶段 workflow（分析 → 计划 → 重构 → 验证）将 3 个超大的 ACP
源文件拆分为 28 个模块化子文件，每个均严格小于 500 行，且完整保留
所有公共 API（barrel 模式重导出）。
变更概要：
- packages/acp-link/src/server.ts: 1800 → 20 行（barrel），新增 11 个子模块
（server/types、payload-decode、permission-mode、runtime-state、dispatch、
handlers-agent、handlers-session、acp-client、client-send、start-server、
testing-internals）
- src/services/acp/agent.ts: 1297 → 33 行（barrel），新增 9 个子模块
（agent/AcpAgent、sessionTypes、permissionMode、configOptions、promptQueue、
internalAccessors、createSessionMethod、sessionLifecycle、promptFlow）
- src/services/acp/bridge.ts: 1516 → 29 行（barrel），新增 8 个子模块
（bridge/types、paths、contentBlocks、toolInfo、toolResults、modelUsage、
notifications、forwarding）
验证：
- bun run precheck 全通过（typecheck + lint + 5851 tests）
- ACP service tests: 176 pass / 0 fail
- ACP link tests: 47 pass / 0 fail
- 所有外部消费者（entry.ts、permissions.ts、__tests__/）的 import 路径不变
- 测试文件零修改
迁移计划详见 docs/acp-refactor-plan.md。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
35768837a7
fix: 补齐 ACP tool_call 完整生命周期（in_progress）+ 去除伪造 terminal 元数据
...
承接 acp 合规审计第二轮：修复 tool 调用完整性相关的 3 条遗留发现。
§4.2 [minor] tool_call 从不发出 in_progress 状态：
- bridge.ts toAcpNotifications 的 tool_use 分支：当同一 tool_use 块被第二次遇到
（streaming content_block_start 首次 + assistant 完整消息回放第二次）时，
alreadyCached 路径补发 tool_call_update with status: 'in_progress'。
语义为"input 已收齐，即将执行"。
- ToolCallStatus 完整生命周期现在是 pending → in_progress → completed|failed，
对齐 schema.json:3525-3548 与 tool-calls.mdx:76-91。
- 新增 forwardSessionUpdates 集成测试验证 streaming + 回放场景下发出
in_progress 中间状态。
§4.4 + §5.2 简化版（合并修复）：
- bridge.ts toolInfoFromToolUse Bash 分支：去除 _supportsTerminalOutput 为 true
时发出的 { type: 'terminal', terminalId: toolUse.id }（terminalId 从未通过
terminal/create 注册，合规客户端按此 id 查 terminal/output 会失败）。统一
回退到 description 文本内容。
- bridge.ts toolUpdateFromToolResult Bash 分支：去除 _supportsTerminalOutput
分支里伪造的 terminalId 与三个非标准 _meta 键（terminal_info / terminal_output
/ terminal_exit，违反 _meta 应使用 vendor namespace 的规范）。Bash 输出统一
以 ```console 围栏文本呈现。删除随之无用的 exitCode / terminalId 局部变量。
- _supportsTerminalOutput 参数保留（前向兼容），用 void 标注暂未使用。
- 完整版（真接 terminal/create + terminal/release + PTY）涉及 BashTool 执行
管线改造，需单独决策，留作待办。
测试更新：
- toolInfoFromToolUse Bash 测试改写：不再断言 terminalId，改为断言回退到空
content（无 description）或 description 文本（有 description）。
- toolUpdateFromToolResult Bash 测试改写：不再断言 terminal_info/terminal_output/
terminal_exit，改为断言走 ```console 文本路径且 _meta 为 undefined。
- bash_code_execution_result 测试同步更新。
验证：bun run precheck 全绿（tsc 零错误、biome ci 零警告、5851/5851 测试通过）。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
5e30697950
fix: 严格对齐 ACP 协议实现到 stable v1 规范
...
对照 /Users/konghayao/code/knowledgebase/origin/acp 规范审计并修复 53 条合规性
发现（critical 5 / major 17 / minor 20 / nit 11），完整审计报告见
docs/acp-compliance-audit.md。
Agent 端 (src/services/acp/agent.ts):
- initialize() 补齐 authMethods，promptCapabilities.image 降级为 false（声明与
实现脱节，按 initialization.mdx 不声明的 capability 视为不支持）
- sessionCapabilities.fork 移至 _meta.claudeCode.forkSession（fork 在
meta.unstable.json 中，避免在 stable sessionCapabilities 中暴露 unstable 特性）
- unstable_resumeSession 传 replay:false，不再通过 session/update 重放历史
（session-setup.mdx:239 明确禁止）
- PromptResponse.usage 移至 _meta.claudeCode.usage
（extensibility.mdx:39 禁止在 spec 类型根添加自定义字段）
- 空字符串 prompt 改为显式 throw（不再误返 end_turn）
Bridge (src/services/acp/bridge.ts):
- 删除全部 usage_update discriminator（不在 stable v1 schema 中）
- 显式映射 refusal stop_reason（之前误报 end_turn）
- max_tokens / isError 检查互斥
- Read/Write/Edit/Glob 路径全部绝对化（协议规定路径 MUST 绝对）
- 补全 resource_link / resource ContentBlock 渲染
Permissions (src/services/acp/permissions.ts):
- 补齐 reject_always PermissionOption（schema 规定的四个 option 之一）
- checkTerminalOutput 优先检查标准 clientCapabilities.terminal，
回退到 _meta.terminal_output
- 新增 onPermissionCancelled 回调：cancelled permission outcome →
StopReason::Cancelled（schema.json:629）
- ExitPlanMode cancelled 分支补上 toolUseID 字段
PromptConversion (src/services/acp/promptConversion.ts):
- resource 分支处理 BlobResource（之前静默丢弃 blob 内容）
acp-link 代理 (packages/acp-link/src/):
- WS 协议从专有 {type, payload} 改造为标准 JSON-RPC 2.0
（transports.mdx:52 要求自定义 transport MUST 保留 JSON-RPC 消息格式），
同时向后兼容旧 envelope
- 实现 $/cancel_request 处理
- 使用 JSON-RPC 标准错误码 -32700 / -32600 / -32601 / -32602 / -32603
- capability / agentInfo / protocolVersion 完整透传
验证：bun run precheck 全部通过（tsc 零错误、biome ci 零警告、5841/5841 测试通过）；
ACP 专项测试 221/221 通过。独立 verification agent 抽查全部 PASS。
已知暂缓项（审计文档附录 B/C）：
- §3.5 traceparent/trace-context 传播（QueryEngine 无 header hook）
- §5.2 terminal/create 完整生命周期（P1，非阻断，需新 RPC 流程）
- §4.2 in_progress tool_call status（SHOULD 级）
- §8.8/8.9/8.14 stale types.ts（不在 owner 分配集合，runtime 已修正）
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-20 12:38:43 +08:00
claude-code-best
f69c705166
Fix/bypass root confirm ( #1275 )
...
* fix(ink): 主屏幕模式周期性终端重绘, 防止长时间运行 TUI 显示腐蚀
- 添加 lastMainScreenHealTime 字段, 每 5 秒触发一次全量终端重绘
- 使用 wall-clock 时间替代帧计数, 避免 drain frames (250fps) 加速周期
- 添加 isTTY 守卫, 防止非 TTY 环境泄漏 ANSI 转义序列
- 扩展 needsEraseBeforePaint 到主屏幕模式, BSU/ESU 确保原子性无闪烁
- 修复 log-update cursor 漂移和 blit ghosting 导致的文字重叠/残留
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win >
* fix(messages): lookups 缓存感知 progress tick 替换, 修复 Bash 进度时间卡死
REPL.tsx 用原地替换处理 ephemeral progress (Bash/PowerShell/MCP) 以
限制 messages 数组增长, 但 computeMessageStructureKey 只把 parentToolUseID
计入 key, 替换前后 key 完全相同, Messages.tsx 的 lookups 缓存命中,
updateMessageLookupsIncremental 长度相同时又直接返回 existing, 导致
progressMessagesByToolUseID 永远停在首条 tick, ShellProgressMessage 的
elapsed time 卡在首次显示值不动.
- computeMessageStructureKey: 加入 progress.uuid, tick 替换后 key 必变
- updateMessageLookupsIncremental: 长度相同 + 末尾为 progress 时返回 null
触发 full rebuild, 让新 tick 进入 progressMessagesByToolUseID
补充 4 个测试覆盖 bug 行为与 fast path 保护.
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* fix: bypass 模式在 root/sudo 下改为警告 + y 确认而非直接退出
交互式 TTY 下打印风险警告并等待用户输入 y 才进入 bypass 模式；
非 TTY (pipe/ACP/CI) 维持原 exit(1) 行为，因为无法交互确认。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
---------
Co-authored-by: deepseek-v4-pro <deepseek-ai@claude-code-best.win >
Co-authored-by: glm-5.2 <zai-org@claude-code-best.win >
2026-06-19 10:17:47 +08:00
claude-code-best
bca27589c2
chore: 2.7.2
2026-06-18 15:19:26 +08:00
claude-code-best
99b9c6a400
fix: ExecuteExtraTool 加 schema 预校验防止 deferred 工具崩溃
...
模型通过 ExecuteExtraTool 调 CronCreate 时把字段名拼成 schedule（而非
cron），raw params 透传到 validateInput，input.cron 为 undefined，触
发 parseCronExpression 的 expr.trim() 抛 TypeError。所有参数组合同
样崩溃，与具体参数无关。
三层修复：
- ExecuteTool.call 在调 validateInput 前先跑 targetTool.inputSchema.
safeParse（鸭子类型跳过 MCP），失败时返回 formatZodValidationError
友好消息，成功时透传 parsed data 让 .default() 生效、strictObject
拦截多余字段。这是架构根治，覆盖所有 deferred 工具。
- CronCreateTool.validateInput 顶部加 typeof string 守卫，给模型精确
字段错误消息。
- parseCronExpression 顶部加 typeof string 守卫，覆盖 cronToHuman 等
所有调用者。
新增 4 个测试覆盖：cron undefined 输入返回 null、ExecuteTool schema
验证拒绝错字段名且 validateInput 不被触达、.default() 透传、MCP-like
工具跳过 schema 校验。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-18 13:59:27 +08:00
claude-code-best
b83395cdfe
fix: 登录后清理 OpenAI 客户端缓存和 ChatGPT auth 防止凭证泄漏
...
OpenAI Compatible / ChatGPT Subscription / 中国区登录成功后，清除
缓存的 OpenAI 客户端实例和 ChatGPT auth 文件，确保下次请求使用新凭证。
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win >
2026-06-16 19:40:25 +08:00
claude-code-best
ddf1acdaed
chore: 2.7.1
2026-06-15 19:09:19 +08:00
claude-code-best
6c633744f4
Fix/ripgrep fallback ( #1273 )
...
* fix: tmp 目录改用 os.tmpdir() + ripgrep 缺失时自动 fallback 系统 rg
1. Shell.ts / imagePaste.ts / filesystem.ts: Linux/macOS 默认 tmp 路径
从硬编码 '/tmp' 改为 os.tmpdir()，自动适配 Termux/Android 等无 /tmp
的环境；macOS 桌面零变化；CLAUDE_CODE_TMPDIR 仍优先级最高。
2. ripgrep.ts: builtin rg 二进制缺失时（Android/Termux、不完整安装）
自动 fallback 到 PATH 上的系统 rg，通过 note 字段携带人读提示；
/doctor 渲染 note；init 启动时写一行 stderr warning。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
* fix: review fix — ripgrep note 文案修正 + init catch 加调试日志
- ripgrep "no ripgrep available" note 去掉无意义的 USE_BUILTIN_RIPGREP=0 建议
- init.ts ripgrep status check 的空 catch 加 logForDebugging
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
---------
Co-authored-by: glm-5.2 <zai-org@claude-code-best.win >
2026-06-15 19:08:31 +08:00
claude-code-best
bb100b16b3
fix: ESC 关闭 local-jsx 面板后添加 grace-period 防止误触 cancel
...
/workflows 等面板通过 ESC 关闭时，React unmount 与 chat:cancel
keybinding 的 isActive 解除之间存在竞态窗口，导致同一按 ESC
会穿透到 onCancel 并中止正在执行的 Workflow 工具。
添加 500ms grace-period guard：面板关闭时打时间戳，onCancel 在窗口
内吞掉 ESC 并 reset，后续有意 ESC 仍正常取消。
Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win >
2026-06-15 16:51:37 +08:00
claude-code-best
0eabcccce9
fix: review — Brave API key + webFetchHttpTimeoutMs 联动 + Tavily URL 推导
...
- braveAdapter: 读取 settings.braveApiKey (优先于环境变量)
- webFetch utils: getFetchTimeoutMs() 统一读取 settings.webFetchHttpTimeoutMs，HTTP/Tavily 两条路径均生效
- tavilyAdapter: 自定义端点自动追加 /search 路径（与 fetchContentWithTavily 一致）
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win >
2026-06-15 16:51:37 +08:00
claude-code-best
9d845d77b9
feat: 重构 WebSearch/WebFetch，新增 Tavily 适配器及 /web-tools 面板
...
- WebSearch: 默认 Tavily，适配器优先级 WEB_SEARCH_ADAPTER > settings.webSearchAdapter > tavily
- WebFetch: 支持 Tavily /extract 返回 Markdown，移除 domain blacklist 远程检查
- 新增 /web-tools 命令面板（Search/Fetch 双 Tab + 二级配置菜单）
- 新增 settings 字段: webSearchAdapter, webFetchAdapter, tavilyEndpointUrl, braveApiKey, exaApiKey, exaEndpointUrl, webFetchHttpTimeoutMs
- 适配器联动: Tavily/Exa 从 settings 读取 endpoint 和 API key
Co-Authored-By: deepseek-v4-pro <deepseek-ai@claude-code-best.win >
2026-06-15 16:51:37 +08:00
claude-code-best
2714bbf812
docs: update contributors
2026-06-15 00:28:17 +00:00
claude-code-best
21e42e24b1
chore: 2.7.0
2026-06-14 18:14:42 +08:00
claude-code-best
58ee6419b1
feat: dynamic-workflow 来了 ( #1271 )
...
* 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 文本解析
上一轮 70a2f76zai-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 >
2026-06-14 18:13:49 +08:00
