Claude Code Haha v0.4.6 版本技术解析：技能市场、会话活动面板与发布链路加固

Claude Code Haha v0.4.6 版本技术解析技能市场、会话活动面板与发布链路加固【免费下载链接】cc-hahaLocal-first cross-platform desktop workspace for Claude Code / agents: multi-agent, Git worktrees, code diffs, skill marketplace, multi-model, Computer Use, task-aware desktop pets, with WeChat, Feishu, DingTalk, Telegram, WhatsApp and H5 access.项目地址: https://gitcode.com/gh_mirrors/cl/cc-haha本文基于仓库内 release-notes/v0.4.6.md 展开结合桌面端与 server 侧源码系统拆解 v0.4.6 的三条主线桌面端技能市场聚合 ClawHub / SkillHub、会话活动面板tasks / background tasks / SubAgent / team activity / sources 的统一视图以及公开 Release 发布与自动更新链路的加固。读者读完后可以掌握该版本技能安装的保守化校验逻辑、活动面板的数据组织方式、TeamoRouter 供应商预设与 provider 流式 watchdog 诊断以及全平台发布资产校验与签名公证的完整要求。版本定位v0.4.5 之后的桌面功能与稳定性版本v0.4.6 是紧随v0.4.5的桌面功能增强与稳定性收敛版本。按 release-notes/v0.4.6.md 的描述本版本重点完成了四类工作技能市场上线让用户直接在桌面端发现、预览、安装和管理第三方技能会话活动面板把会话中的任务、后台任务、SubAgent 和团队活动集中到右侧面板减少主聊天区噪音提升多 Agent 工作流可见性更新与正式发布链路加固公开 release 先保持 draft等全平台安装包、blockmap 与latest*.yml更新元数据上传并校验完成后再发布Provider 与平台补齐新增 TeamoRouter provider 预设、provider 流式响应卡住时的 watchdog 诊断、浏览器 zoom / 高 DPI 坐标、Windows/macOS/Linux 发布资产收敛。下文依次展开每条主线的实现细节与仓库源码证据。技能市场ClawHub / SkillHub 聚合与保守安装市场页面与安装/卸载流程v0.4.6 新增了桌面端技能市场页面Market对应的实现位于 desktop/src/pages/Market.tsx。该页面支持搜索、筛选、分页聚合 ClawHub 与 SkillHub 两个来源的技能列表详情与文件预览远程加载技能详情并预览文件内容MarketSkillDetail组件安装确认弹窗点击安装后弹出InstallConfirmDialog确认后才真正执行安装卸载确认通过ConfirmDialog确认卸载卸载目标路径为~/.claude/skills/slug/见 Market.tsx已安装状态识别安装成功后同步刷新本地技能列表useSkillStore.getState().fetchSkills()保持「设置 → 技能」页与市场页状态一致。从状态管理看市场数据统一由useMarketStoredesktop/src/stores/marketStore.ts 中的useMarketStore维护包括选中技能selectedId、安装中的技能集合installingIds、远程详情detail与详情缓存detailCache。安装失败的错误被区分成generic与具体类型两类文案见 Market.tsx保证用户能看到可读的错误提示。保守安装风险标签、扫描摘要与阻断相比直接把上游结果展示为可安全安装v0.4.6 刻意把技能安装链路做得更保守。市场安装链路补齐了风险标签技能卡片上呈现风险等级扫描摘要安装前展示对技能内容的扫描结果摘要来源状态展示技能来源ClawHub / SkillHub的健康状态免责声明第三方技能安装前必须知悉免责声明不可确认风险阻断当风险无法确认时直接阻断安装避免把上游不完整或高风险结果误展示成安全可装。这套逻辑的 server 侧实现与测试集中在 src/server/tests/market-service.test.ts、src/server/tests/market-install.test.ts 与 src/server/tests/market-api.test.ts可作为安装校验行为的行为化契约参考。多语言与主题适配技能市场还补齐了第三方技能免责声明、安全徽章、确定性技能头像、多语言文案和暗色主题适配。多语言文案的痕迹可以在 desktop/src/i18n/locales/en.ts、desktop/src/i18n/locales/zh.ts、jp.ts、kr.ts、zh-TW.ts等语言文件中找到相关组件测试见 desktop/src/components/market/InstallConfirmDialog.test.tsx、desktop/src/components/market/SkillDetailView.test.tsx 与 desktop/src/pages/ExtensionMarket.test.tsx。会话活动面板让多 Agent 工作流可扫描活动模型与分区v0.4.6 新增右侧活动面板把主聊天区之外的运行信息统一整理成可扫描的侧边信息。核心数据模型位于 desktop/src/components/activity/sessionActivityModel.ts定义了 7 个活动分区分区内容output输出tasksTodo / task summaryCLITaskteam团队活动TeamMemberworkflowWorkflow 运行按 phase 分组扇出阶段可读backgroundTasks后台任务subagentsSubAgent 运行sources来源分区顺序按当前回合在做什么的直观程度排列先计划tasks、再做事的 Agentsubagents / team / workflow、再后台残留backgroundTasks见 sessionActivityModel.ts 的注释说明。每一行ActivityRow携带id、section、label、status、description、summary、toolUseId、outputFile、usage、updatedAt等字段并且为 workflow 场景提供group/groupProgress组头行显示done/total避免 12 个扁平行无法表达它们属于哪个阶段的问题见 sessionActivityModel.ts。Agent Teams 场景下活动行还会携带teamName/teamMemberName/teamStartedAt用于路由到 incarnation 级成员运行页。面板 UI 位于 desktop/src/components/activity/SessionActivityPanel.tsx入口按钮为SessionActivityButton测试见 desktop/src/components/activity/SessionActivityPanel.test.tsx 与 desktop/src/components/activity/sessionActivityModel.test.ts。SubAgent 详情页与活动 API活动面板中的 SubAgent 行可以打开独立详情页desktop/src/pages/SubagentRunPage.tsx展示 SubAgent 的输出、状态、token 与 duration 信息。对应 API 客户端在 desktop/src/api/subagents.tsSubagentRunResponse结构包含sessionId、toolUseId、agentId、statusrunning | completed | failed | stopped | unknown、description、prompt、summary、result、outputFile、usageinput/output/total tokens、messages、truncated、sourcesubagent-jsonl | session-history | live-task | none等字段subagents.ts对于 workflow 运行时创建的 Agent没有Agent工具调用使用agent:前缀的引用形式寻址isAgentIdRef/toAgentIdRef/readAgentIdRef三个工具函数保证 tab id、页面与返回路径一致仅 fetch 方式不同subagents.tsAPI 端点包括/api/sessions/:sessionId/subagents/by-agent/:agentId等subagents.ts。canSendMessage字段表示该 SubAgent 是否仍有 inbox只有具名队友与进行中的后台 Agent 可以继续被跟进一次性 SubAgent 回答完即结束因此详情页不显示 composer见 subagents.ts 的注释。活动行交互头像、折叠与手动状态保留SubAgent 活动行加入本地头像和状态工具调用组默认折叠并且在流式更新中保留用户手动展开/折叠的状态。这保证了主聊天区在任务进行时保持干净同时多 Agent 并行的工作进度始终可见。Provider 与平台补齐TeamoRouter provider 预设v0.4.6 新增 TeamoRouter provider 预设默认模型映射到claude-opus-4-8claude-sonnet-5claude-haiku-4-5并在 README 赞助商区域加入 TeamoRouter 入口对应 issue #994。注意从当前仓库的 server 侧测试 src/server/tests/provider-presets.test.ts 可以看到该测试断言PROVIDER_PRESETS中已不存在teamorouter预设说明该预设仅在 v0.4.6 发布周期内引入、后续版本中已从服务端目录移除——如果你使用的正是 v0.4.6 版本则以该版本发布说明为准。Provider 流式响应 watchdog 诊断针对 provider 流式响应中途停住时缺少明确诊断的问题v0.4.6 新增分阶段 watchdog流式响应卡住时会给出明确的阶段诊断同时桌面端 WebSocket 错误码变得更稳定。这让用户/开发者能区分网络中断provider 静默连接被重置等不同故障阶段而不是只看到一个无响应的空白流。浏览器 zoom 与高 DPI 预览修复内置浏览器 zoom/scale 在高 DPI 下坐标和交互区域不稳定的问题缩放控件改为浮在预览区右下角避免被 native WebContentsView 覆盖对应 issue #952。对使用内置浏览器预览页面尤其是高 DPI 缩放显示器的场景这一修复直接消除了鼠标点击偏移交互区域错位的体验问题。更新与正式发布链路加固发布顺序先 draft校验通过再公开v0.4.6 修复了正式 GitHub Release 可能在 updater 资产未完整上传前公开的问题。现在Release Desktopworkflow 的流程是创建 draft release上传并校验全平台安装包、blockmap 与标准 updater metadata全部校验通过后再取消 draft正式发布。这显著降低了自动更新拿到不完整 release 资产例如安装包未传完、blockmap 缺失、latest*.yml未就绪的风险。校验矩阵与签名公证要求发布 workflow 会校验 macOS ARM64/x64、Windows x64/ARM64、Linux x64/ARM64 的安装包、blockmap 和 updater metadata。自动更新依赖的元数据文件包括latest-mac.ymllatest.ymllatest-linux.ymllatest-linux-arm64.yml签名要求当前仓库实际规则见 release-notes/v0.4.6.mdWindows签名仍为非阻塞 warning未签名 Windows 安装包仍可更新但用户可能看到 SmartScreen 提示「更多信息 → 仍要运行」macOS非 draft 的公开 release 现在要求签名和公证 secrets缺失时会阻止发布避免自动更新和 Gatekeeper 拿到不合格正式产物。本地调试产物若出现已损坏或无法验证开发者可执行xattr -cr /Applications/Claude\ Code\ Haha.app清理 quarantine。检查更新与重启安装修复了检查更新流程中重复检查可能清空待安装更新的问题#797如果重启安装没有让桌面端退出UI 会恢复到可操作状态。如果下载更新后桌面端没有自动退出重启可以手动重启应用完成安装。修复要点与 Issue 对照Issue修复内容#797检查更新与发布资产公开顺序降低自动更新拿到不完整 release 的风险#949更换数据存储位置后 best-effort 写入失败不再导致权限错误持续弹出写入失败被捕获并反馈到设置状态#952内置浏览器 zoom/scale 高 DPI 坐标与控件覆盖问题#964 / #967Terminal 设置页重复触发 runtime 启动导致命令行出现两行补齐 stale async start 销毁保护#966General → 输出风格内置选项名称与说明未按当前语言本地化#994TeamoRouter provider 预设与赞助商入口其他值得注意的修复还包括Telegram adapter 命令处理和桌面导航 guard 加固减少异常输入或外部跳转风险、技能市场搜索/详情预览/fallback 缓存/主题色/loading 状态/卡片风险文案的边界问题收敛。版本对齐与发布前检查按 release-notes/v0.4.6.md 的 Notes 部分发布流程有严格的版本一致性约束GitHub Release 正文以release-notes/v0.4.6.md为来源桌面端发布版本号来源是desktop/package.jsonrootpackage.json仍保留本地开发用的999.0.0-local发布时需确保desktop/package.json、Git tagv0.4.6与release-notes/v0.4.6.md三者严格对齐Release Desktopworkflow 会校验 tag 与desktop/package.json版本一致并加载release-notes/v0.4.6.md。发布前建议至少执行bun run scripts/release.ts 0.4.6 --dry bun run verify如果 GitHub Actions hosted runner 恢复可先手动触发 draft 状态的Release Desktop验证全平台资产确认后再公开。安装方式v0.4.6按平台与 CPU 架构在 Release 页面 Assets 中下载对应文件平台文件macOS Apple SiliconM 系列Claude-Code-Haha-0.4.6-mac-arm64.dmgmacOS IntelClaude-Code-Haha-0.4.6-mac-x64.dmgWindows x64Claude-Code-Haha-0.4.6-win-x64.exeWindows ARM64Claude-Code-Haha-0.4.6-win-arm64.exeLinux x64Claude-Code-Haha-0.4.6-linux-x86_64.AppImage或Claude-Code-Haha-0.4.6-linux-amd64.debLinux ARM64Claude-Code-Haha-0.4.6-linux-arm64.AppImage或Claude-Code-Haha-0.4.6-linux-arm64.debmacOS双击 DMG 拖入「应用程序」。若签名和公证验证通过首次打开走正常 Gatekeeper 流程若提示已损坏或无法验证开发者执行xattr -cr /Applications/Claude\ Code\ Haha.app或在「系统设置 → 隐私与安全性」里点仍要打开。Windows双击.exe安装SmartScreen 提示时点「更多信息 → 仍要运行」。LinuxAppImagechmod x Claude-Code-Haha-0.4.6-linux-x86_64.AppImage ./Claude-Code-Haha-0.4.6-linux-x86_64.AppImageLinuxdebsudo apt install ./Claude-Code-Haha-0.4.6-linux-amd64.debARM64 机器把文件名换成...-linux-arm64.AppImage/...-linux-arm64.deb。小结v0.4.6 的核心价值在于把发现技能 → 安装技能 → 观察多 Agent 运行这条桌面工作流补完整技能市场解决了第三方技能的可发现性与安装安全性活动面板让多 Agent 并发工作不再淹没在主聊天区发布链路的 draft 校验机制则从源头上避免自动更新拿到不完整产物。对于希望深度定制技能体验或接入多 Agent 工作流的开发者desktop/src/pages/Market.tsx、desktop/src/components/activity/sessionActivityModel.ts 与 desktop/src/api/subagents.ts 是最直接的三个切入文件。【免费下载链接】cc-hahaLocal-first cross-platform desktop workspace for Claude Code / agents: multi-agent, Git worktrees, code diffs, skill marketplace, multi-model, Computer Use, task-aware desktop pets, with WeChat, Feishu, DingTalk, Telegram, WhatsApp and H5 access.项目地址: https://gitcode.com/gh_mirrors/cl/cc-haha创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考