release: prepare v0.4.11

desktop/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-desktop",
   "private": true,
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "Desktop coding agent workbench for Claude Code Haha.",
   "homepage": "https://github.com/NanmiCoder/cc-haha",
   "author": {

docs/desktop/10-release-auto-update.md

@@ -48,16 +48,16 @@ WINDOWS_CERTIFICATE_PASSWORD
 4. 确认只出现标准下载来源确认，不出现无法验证开发者、文件损坏或 unidentified developer。
 5. 再把后续 `v0.4.4` 作为自动更新验证目标。
 
-## v0.4.10 自动更新验证
+## v0.4.11 自动更新验证
 
-发布 `v0.4.10` 时至少验证一条真实更新链路：
+发布 `v0.4.11` 时至少验证一条真实更新链路：
 
-1. 安装 GitHub Release 中的 `v0.4.9` 正式包。
+1. 安装 GitHub Release 中的 `v0.4.10` 正式包。
-2. 发布 `v0.4.10` tag，让 `Release Desktop` workflow 完整通过。
+2. 发布 `v0.4.11` tag，让 `Release Desktop` workflow 完整通过。
-3. 打开 `v0.4.9` 应用，等待启动后自动检查，或进入 Settings 手动检查更新。
+3. 打开 `v0.4.10` 应用，等待启动后自动检查，或进入 Settings 手动检查更新。
-4. 确认应用提示 `v0.4.10`，下载完成后点击安装并重启。
+4. 确认应用提示 `v0.4.11`，下载完成后点击安装并重启。
-5. 重启后确认 About/Settings 中版本为 `0.4.10`，并检查原有服务商、会话、Skills、记忆和自定义数据目录仍然可用。
+5. 重启后确认 About/Settings 中版本为 `0.4.11`，并检查原有服务商、会话、Skills、Agents、记忆、自定义宠物和自定义数据目录仍然可用。
-6. 确认历史会话、对话内搜索、后台任务终态和全局搜索均可正常恢复；在「设置 → 诊断」查看本地索引状态，并验证重建索引不会删除源会话文件。
+6. 确认历史附件上下文、SubAgent 详情、Task 状态和 Agent 配置均可正常恢复；打开桌面宠物，验证悬浮窗口、任务面板和当前会话导航。
 
 平台重点：
 
@@ -70,9 +70,9 @@ WINDOWS_CERTIFICATE_PASSWORD
 发版前至少运行：
 
 ```bash
-bun run scripts/release.ts 0.4.10 --dry
+bun run scripts/release.ts 0.4.11 --dry
 bun test scripts/pr/release-workflow.test.ts scripts/release-update-metadata.test.ts scripts/quality-gate/package-smoke/index.test.ts
 bun run check:policy
 ```
 
-正式调用 `bun run scripts/release.ts 0.4.10` 前，先确认对应 `release-notes/v0.4.10.md` 已经存在。
+正式调用 `bun run scripts/release.ts 0.4.11` 前，先确认对应 `release-notes/v0.4.11.md` 已经存在。

docs/desktop/index.md

@@ -42,7 +42,7 @@
 
 ### [Electron 发布与自动更新](./10-release-auto-update.md)
 
-维护者发版 runbook：Developer ID 签名、GitHub Release metadata、`v0.4.9 -> v0.4.10` 自动更新验证路径。
+维护者发版 runbook：Developer ID 签名、GitHub Release metadata、`v0.4.10 -> v0.4.11` 自动更新验证路径。
 
 ### [Electron 迁移交互式验收清单](/desktop/electron-migration-qa-checklist.html)
 

release-notes/v0.4.11.md

@@ -0,0 +1,107 @@
+# Claude Code Haha v0.4.11
+
+这是 `v0.4.10` 之后的桌面体验与 Agent 工作流版本，重点新增互动桌面宠物、完整的桌面 Agent 管理、逐 Agent 模型与思考强度配置，并更新 Claude 官方模型阵容。同时继续修复任务状态、SubAgent 实时详情、附件恢复、Provider 创建、上下文估算和 Windows 桌面恢复等问题。
+
+相比 `v0.4.10`，本版本让后台任务和 Agent 配置更容易观察、调整和复用：宠物可以在独立悬浮窗口中反映当前任务状态，Agent 可以按用户或项目范围管理，并为不同职责分别选择模型、effort 和工具。会话恢复后会继续保留附件内容，任务与子代理的运行状态也会更及时地同步到桌面端。
+
+## Highlights
+
+- **互动桌面宠物**：新增 Electron 原生透明悬浮窗口，内置搭搭、弧弧、补补、回回 4 个角色；宠物会根据工作中、等待处理、失败和空闲状态切换动作，并可展开活跃任务、点击返回对应会话。
+- **本地自定义宠物**：支持导入透明 PNG / WebP 制作轻动画宠物，也支持导入 `1536×2288` 的 v2 逐帧动画图集；可调整尺寸、动画开关和任务面板显示，整个导入过程在本地完成，不调用当前聊天模型。
+- **完整的桌面 Agent 管理**：设置页可以浏览内置、用户、项目、插件和策略等来源的 Agent 及覆盖关系，并创建、编辑或删除用户级与项目级 Agent。
+- **逐 Agent 模型与 effort**：每个自定义 Agent 可以独立继承或指定 Fable、Opus、Sonnet、Haiku、自定义模型 ID，以及 `low` 到 `max` 的思考强度和可用工具；配置已接入 Agent 定义、运行、恢复和团队执行链路 (#1062)。
+- **Claude 官方模型阵容更新**：桌面端与 CLI 新增并识别 Fable 5、Opus 4.8、Sonnet 5 和 Haiku 4.5，补齐显示名称、1M 上下文、推理强度和 Provider 环境映射。实际可用性仍取决于账号权限与 Provider 支持。
+- **任务与 SubAgent 更可观察**：运行中的 SubAgent 可以立即打开详情并持续看到新记录；Task V2 的完成状态、并发更新和临时轮询失败也会更稳定地反映在桌面端 (#1075, #1077)。
+
+## Fixes
+
+- 修复部分 Provider 返回空或全零 usage 时，上下文占用估算消失的问题；现在会保留运行模型锚点并回退到本地 transcript 估算，不把估算值误作费用统计 (#1063)。
+- 修复首轮消息携带图片或文件时，服务端回放可能让用户消息重复显示的问题；兼容 Windows 路径、UUID 前缀上传文件和内联图片 (#1069)。
+- 修复拒绝工具权限后，正常中断被误报为执行失败的问题；当前轮会正确结束并回到可继续输入的状态 (#1070)。
+- 修复任务已经完成但状态没有及时更新、旧请求覆盖新状态，以及临时轮询失败时任务列表闪空的问题 (#1075)。
+- 修复运行中的 SubAgent 详情长期停留在“开始中”、必须等结束后才能查看执行过程的问题；运行记录和工具调用现在会持续刷新 (#1077)。
+- 修复 Provider 预设接口暂不可用时“添加服务商”按钮失效的问题；常用预设改为随桌面端内置，并保留可编辑的 Custom 入口 (#1078)。
+- 加强 Windows 白屏、Renderer 异常退出、代理连接重置、终端和 IM WebSocket 生命周期的恢复与错误隔离；主窗口会尝试有限恢复，并为无法恢复的启动故障保留可见错误信息 (#1064, #1065, #1071)。
+- 修复桌面端完全退出或恢复会话后，文件、目录和 PDF 附件只剩路径、丢失原始上下文的问题；外部反馈分享仍会过滤附件记录和内容。
+- 修复宠物任务卡在 Windows 上被原生窗口 shape 裁切、关闭按钮被透明命中区遮挡，以及重启后宠物未保持置顶的问题。
+- 修复 Agent 文件已经保存后仍被可选热重载阻塞、运行中新增嵌套 Git 仓库时项目 Agent 可能写到外层仓库，以及旧刷新结果覆盖新项目状态的问题。
+- 修复本地 HTTP 连接在 Windows 长时间空闲后被复用时，Session、Task、Scheduled 等接口可能同时超时的问题；同时补齐请求取消和任务轮询的资源清理。
+- Kimi Code 预设升级为 K3：使用 Coding API、`k3` 模型、262K 上下文和 API Key 鉴权，并补齐 required thinking、effort 与 max effort 能力。
+
+## Features and Improvements
+
+- 桌面宠物支持位置拖动、点击互动、视线跟随、右键关闭和窗口位置恢复；任务面板默认收起，可用数量徽标展开最近的活跃会话。
+- 自定义宠物导入增加本地化文件选择框，以及针对格式、尺寸、文件大小、重复 ID、损坏图片和存储失败的明确错误提示。
+- Agent 列表展示来源、生效/覆盖状态、模型、思考强度、工具范围和系统提示词；内置、插件与策略来源保持只读。
+- Agent 编辑器支持选择项目目录，并从当前运行环境读取真实可用工具，按类别搜索和勾选，同时保留 MCP、自定义工具和 `Bash(git:*)` 等规则输入。
+- Agent 配置保存后会刷新当前会话组件；刷新失败不会回滚已经保存的定义，并提供可重试提示。
+- 模型选择器会合并官方目录、当前 Provider 配置和运行时角色模型，保留第三方 Provider 的自定义模型映射。
+- 会话状态和任务投影增加取消、乱序和临时失败保护，降低快速切换会话或多请求并发时的状态回退。
+- Electron 构建补充 sidecar 启动、Renderer 恢复、宠物 IPC、打包输出空闲和跨平台产物契约检查。
+
+## Issue 对照
+
+- #1062：为每个 Agent 单独配置模型、思考强度和工具范围。
+- #1063：Provider usage 为空或全零时保留上下文估算。
+- #1064 / #1065 / #1071：加强 Windows 白屏、JavaScript error 和异常重启后的恢复与隔离。
+- #1069：避免首轮附件消息在服务端回放后重复显示。
+- #1070：正确处理中断工具权限后的正常结束流程。
+- #1075：稳定任务完成状态、并发读写和桌面轮询。
+- #1077：在 SubAgent 运行期间持续展示详情和工具记录。
+- #1078：让 Provider 创建入口不再依赖运行时 presets 请求。
+
+## Verification
+
+- 当前合并候选已通过 desktop、server、provider-contract、chat-contract、adapters、native、persistence-upgrade 和 coverage 门禁：Desktop 2450 项通过、1 项跳过；Server 2281 项通过；Adapters 406 项通过；Coverage 5/5 groups、0 failed。
+- Electron native 验证包含 312 项测试、sidecar 编译 smoke、production build、macOS arm64 目录打包和 current package smoke；该证据只证明本机候选构建与产物结构，不等同于正式签名、公证或跨平台安装 E2E。
+- 已有隔离 Windows 11 人工记录覆盖真实 DeepSeek / MiniMax 对话、附件恢复、多模态、SubAgent 实时详情、Task V2、Renderer 恢复、长空闲本地连接、自定义宠物导入和宠物任务面板；部分宠物拖动/多显示器、Agent 热重载后的真实模型与 effort、IM/H5 故障注入仍未完整执行。
+- 尚未执行正式 `v0.4.10 -> v0.4.11` 自动更新、由 `v0.4.11` Tag 生成的 Windows/Linux 安装包实机验证，也未运行 live-provider 全组合测试。未执行项不计为通过。
+- 已识别两个仍需后续加固的极端连接边界：永不完成的 CONNECTING WebSocket 握手，以及持续少量输出的 sidecar 健康检查响应。因此本版本不宣称彻底消除所有连接泄漏或启动挂起。
+
+## Notes
+
+- GitHub Release 正文以 `release-notes/v0.4.11.md` 作为唯一来源。
+- 桌面端发布版本号来源是 `desktop/package.json`；root `package.json` 继续保留本地开发用的 `999.0.0-local`。发布时必须确保版本号、Git tag `v0.4.11` 和本文件严格一致。
+- `Release Desktop` workflow 会构建 macOS、Windows 和 Linux 的 x64 / ARM64 安装包，并在完整资产和 updater metadata 校验通过后公开 Release。
+- 自动更新验证路径是正式 `v0.4.10 -> v0.4.11`。发布完成后需核对 `latest-mac.yml`、`latest.yml`、`latest-linux.yml` 和 `latest-linux-arm64.yml`。
+- macOS 正式公开发布依赖签名和公证 secrets；Windows 未配置签名时仍可安装和自动更新，但可能显示 SmartScreen 提示。
+- 桌面宠物是 Electron 桌面功能，不在 H5 中运行；单图导入提供本地轻动画，不是 AI 逐帧动画生成。
+- Agent 的 effort 是否完整生效取决于所选模型和 Provider；不支持的组合可能被降低或忽略。
+
+## 安装
+
+在本页面底部 Assets 中按系统和 CPU 架构下载：
+
+| 平台 | 文件 |
+|------|------|
+| macOS Apple Silicon（M 系列） | `Claude-Code-Haha-0.4.11-mac-arm64.dmg` |
+| macOS Intel | `Claude-Code-Haha-0.4.11-mac-x64.dmg` |
+| Windows x64 | `Claude-Code-Haha-0.4.11-win-x64.exe` |
+| Windows ARM64 | `Claude-Code-Haha-0.4.11-win-arm64.exe` |
+| Linux x64 | `Claude-Code-Haha-0.4.11-linux-x86_64.AppImage` 或 `Claude-Code-Haha-0.4.11-linux-amd64.deb` |
+| Linux ARM64 | `Claude-Code-Haha-0.4.11-linux-arm64.AppImage` 或 `Claude-Code-Haha-0.4.11-linux-arm64.deb` |
+
+### macOS
+
+双击 DMG，把应用拖入“应用程序”。正式签名和公证产物应直接通过正常 Gatekeeper 流程。
+
+### Windows
+
+双击 `.exe` 安装。建议直接以当前用户运行，不要使用“以管理员身份运行”。覆盖升级前先完全退出应用；如果安装器报告相关进程仍在运行，请根据提示关闭对应进程后重试。未签名构建出现 SmartScreen 时可选择“更多信息”→“仍要运行”。
+
+### Linux
+
+AppImage：
+
+```bash
+chmod +x Claude-Code-Haha-0.4.11-linux-x86_64.AppImage
+./Claude-Code-Haha-0.4.11-linux-x86_64.AppImage
+```
+
+deb：
+
+```bash
+sudo apt install ./Claude-Code-Haha-0.4.11-linux-amd64.deb
+```
+
+ARM64 机器请换用对应的 `linux-arm64` 文件。