Skip to content

Commit f70fa01

Browse files
NanmiCoderNanmiCoder
committed
release: prepare v0.4.11
1 parent 2240a07 commit f70fa01

4 files changed

Lines changed: 119 additions & 12 deletions

File tree

‎desktop/package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "claude-code-desktop",
33
"private": true,
4-
"version": "0.4.10",
4+
"version": "0.4.11",
55
"description": "Desktop coding agent workbench for Claude Code Haha.",
66
"homepage": "https://github.com/NanmiCoder/cc-haha",
77
"author": {

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -48,16 +48,16 @@ WINDOWS_CERTIFICATE_PASSWORD
4848
4. 确认只出现标准下载来源确认，不出现无法验证开发者、文件损坏或 unidentified developer。
4949
5. 再把后续 `v0.4.4` 作为自动更新验证目标。
5050

51-
## v0.4.10 自动更新验证
51+
## v0.4.11 自动更新验证
5252

53-
发布 `v0.4.10` 时至少验证一条真实更新链路：
53+
发布 `v0.4.11` 时至少验证一条真实更新链路：
5454

55-
1. 安装 GitHub Release 中的 `v0.4.9` 正式包。
56-
2. 发布 `v0.4.10` tag，让 `Release Desktop` workflow 完整通过。
57-
3. 打开 `v0.4.9` 应用，等待启动后自动检查，或进入 Settings 手动检查更新。
58-
4. 确认应用提示 `v0.4.10`，下载完成后点击安装并重启。
59-
5. 重启后确认 About/Settings 中版本为 `0.4.10`，并检查原有服务商、会话、Skills、记忆和自定义数据目录仍然可用。
60-
6. 确认历史会话、对话内搜索、后台任务终态和全局搜索均可正常恢复；在「设置 → 诊断」查看本地索引状态，并验证重建索引不会删除源会话文件。
55+
1. 安装 GitHub Release 中的 `v0.4.10` 正式包。
56+
2. 发布 `v0.4.11` tag，让 `Release Desktop` workflow 完整通过。
57+
3. 打开 `v0.4.10` 应用，等待启动后自动检查，或进入 Settings 手动检查更新。
58+
4. 确认应用提示 `v0.4.11`，下载完成后点击安装并重启。
59+
5. 重启后确认 About/Settings 中版本为 `0.4.11`，并检查原有服务商、会话、Skills、Agents、记忆、自定义宠物和自定义数据目录仍然可用。
60+
6. 确认历史附件上下文、SubAgent 详情、Task 状态和 Agent 配置均可正常恢复；打开桌面宠物，验证悬浮窗口、任务面板和当前会话导航。
6161

6262
平台重点：
6363

@@ -70,9 +70,9 @@ WINDOWS_CERTIFICATE_PASSWORD
7070
发版前至少运行：
7171

7272
```bash
73-
bun run scripts/release.ts 0.4.10 --dry
73+
bun run scripts/release.ts 0.4.11 --dry
7474
bun test scripts/pr/release-workflow.test.ts scripts/release-update-metadata.test.ts scripts/quality-gate/package-smoke/index.test.ts
7575
bun run check:policy
7676
```
7777

78-
正式调用 `bun run scripts/release.ts 0.4.10` 前，先确认对应 `release-notes/v0.4.10.md` 已经存在。
78+
正式调用 `bun run scripts/release.ts 0.4.11` 前，先确认对应 `release-notes/v0.4.11.md` 已经存在。

‎docs/desktop/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@
4242

4343
### [Electron 发布与自动更新](./10-release-auto-update.md)
4444

45-
维护者发版 runbook：Developer ID 签名、GitHub Release metadata、`v0.4.9 -> v0.4.10` 自动更新验证路径。
45+
维护者发版 runbook：Developer ID 签名、GitHub Release metadata、`v0.4.10 -> v0.4.11` 自动更新验证路径。
4646

4747
### [Electron 迁移交互式验收清单](/desktop/electron-migration-qa-checklist.html)
4848

‎release-notes/v0.4.11.md‎

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

0 commit comments

Comments
 (0)