Clawd on Desk

v1.2.0

Clawd v1.2.0 新增实验性 MiniMax Code 支持、OpenCode 2.x 权限、DeepSeek Harness 会话详情、更安全的可选审批自动化以及新的主题行为。内置 Clawd 主题中的空闲气泡现在会在屏幕右半边镜像显示，宠物默认位于该处。本次发布还改进了会话恢复、钩子健康状态、通知和远程 Codex 监控。

智能体与会话

• MiniMax Code（#1038、#1049）——通过 Clawd 管理的本地插件 ~/.minimax/plugins/clawd-state 添加实验性的、仅报告状态的集成。MiniMax 的钩子超时不支持阻塞式审批，因此 Clawd 不会为其显示权限气泡。请在 MiniMax 中使用 mcode plugin enable clawd-state@local 或通过其插件面板启用插件。感谢 @xiaoshidefeng。
• OpenCode 2.x（#1045、#1053、#1067、#1079）——在更改 plugin 和 plugins 注册之前，会检测主机是 v1、v2 还是未知版本。v2 插件使用新的事件 API 和阻塞式权限钩子。若主机检测失败，可通过 CLAWD_OPENCODE_HOST 固定主机版本。Windows 检测现在能够处理包含非 ASCII 字符的安装路径。感谢 @xiaoshidefeng 和 @gzx19990101。
• OpenCode 审批（#1075、#1079；问题 #1065）——可通过环回地址访问绑定通配地址的 opencode web 和 serve --hostname 0.0.0.0；会话中断时会撤回待处理气泡；并会扫描复合 shell 命令（如 a && b），以显示破坏性操作提醒和警告徽标。
• DeepSeek Harness（#1046）——支持 0.1.5-rc.1 和 rc.3，并转发会话标题和上下文用量。感谢 @ypjn。
• Claude 恢复与完成状态（#1061、#1063；问题 #1060）——Clawd 重启后，空闲会话不再恢复为工作中状态。正常结束的会话（包括在后台工作仍继续时已结束的轮次）在重启后仍保持结束状态。末尾的 SubagentStop 不再取消完成动画或通知。感谢 @KaiC5504。
• Codex 会话卡片（#1032、#1074、#1079；问题 #1073）——按线程归并远程 Desktop 部署，不显示 memories 整理工作进程，并防止远程监控重启时凭空创建空闲会话或恢复已结束的轮次。
• 会话身份与进程修复（#1031、#1051、#1052、#1055、#1056；问题 #908）——通过原始会话 ID 探测 Claude 转录记录；在元数据查找较慢时保留 Cursor 投递时间；识别名为 MainThread 的 Linux Node 进程及已重命名的 Kimi Code 进程；并避免在 Windows 主机上探测 WSL 会话 PID。感谢 @hanzhe-one。

仪表板、主题与桌面端

• Claude 钩子健康状态（#1059、#1064；问题 #898）——智能体卡片会反映被 CC Switch 等工具替换的钩子、已暂停的自动修复、反复修复失败以及缺失脚本，并在需要处理时说明原因。Windows 上自动修复暂停时会显示一条托盘通知。感谢 @hanzhe-one。
• 桌面端与设置修复（#724、#1071）——Clawd 在 macOS 后台运行时，首次点击即可打开设置或仪表板。自定义应用是否可启动现在使用统一规则，保存权限 URL 时会等待同步完成。感谢 @200780381 和 @52mzd。
• 主题动画（#1050、#1076）——选择启用的空闲动画会在屏幕右半边镜像显示；内置 Clawd 空闲气泡默认启用此功能。迷你模式新增可选的探头停留和睡眠探头视觉效果，以及仅在选中时显示的空闲视觉效果。感谢 @KaiC5504。
• Whale-chan（#1077）——新增可选的官方主题，可从设置下载；其媒体文件不包含在安装程序中。原始角色设计、设定及上游素材的权利仍归创作者所有；该主题按 Neko3000/deepseek-whalechan 标注 ZipZipPipe 和上善无形为来源。鹿鹿（@rullerzhou-afk）创作的新动画和效果采用 CC BY-NC-SA 4.0 许可；完整条款请参见主题包。这是非官方、非商业的粉丝作品，与 DeepSeek 无关联，也未获其认可，并且不受本项目 AGPL-3.0 源代码许可证覆盖。
• Codex Pet 姿势（#1022、#1079）——杂耍动作新增专属姿势；升级后，已导入的宠物会重新生成一次。感谢 @chrono-meta。

远程工作流与可靠性

• 可选的破坏性操作提醒（#1021）——默认关闭。启用后，识别出的破坏性命令会暂停自动工具或无人值守审批，等待人工审核；此功能只会让自动化更加保守。包含奇数个引号或 (#N) 的 heredoc 正文可能会被视为无法分析，并暂停以供审核。感谢 @chrono-meta。
• 通知（#1066）——保留排队中的 Slack 通知，权限提醒则使用独立通道。
• WinGet 发布工具（#1034）——提交前验证生成的清单；默认仍禁用自动提交。
• 文档（#1054、#1079）——同步多语言 README 和指南，包括韩语 README 更新。感谢 @jin-codes。

升级说明

• 升级后启动一次 Clawd，让已安装且已启用的集成同步其打包的钩子、插件和扩展（#1038、#1045）。
• 安装 MiniMax 集成后，请在 MiniMax 内启用该插件；此集成仅报告状态（#1038）。
• 对于 OpenCode 2.x，安装或更新其插件后运行 opencode service restart；仅打开新会话并不能保证共享服务重新加载。对于 OpenCode 1.x，请重启 opencode 以加载更新后的插件（#1045、#1079）。
• 内置 Clawd 空闲气泡现在会在屏幕右半边镜像显示，这会影响默认的右下角宠物位置。导入的 Codex Pets 会刷新一次，以应用新的杂耍姿势（#1050、#1079）。
• Whale-chan 会按需从单独的官方主题仓库下载；不会随 Clawd 一起打包（#1077）。

贡献者

感谢在 v1.1.0 至 v1.2.0 期间贡献代码的贡献者：@chrono-meta、@hanzhe-one、@200780381、@xiaoshidefeng、@KaiC5504、@jin-codes、@gzx19990101、@ypjn 和 @52mzd。现有贡献者鸣谢和原始作者信息仍可在设置的“关于”页面及各版本 README 中查看。

验证状态

打标签前，对 v1.1.0..main 进行的两次独立完整发布审查均未报告 P0/P1 级问题；修复已合入 #1079。发布提交通过了 macOS 上的完整测试套件（11 项测试、523 项、0 个失败）、Windows、macOS 和 Linux 上的 CI，以及全部五个目标平台的打包产物审核。

使用 v1.2.0 草稿构建的安装包在真实硬件上完成检查：

• Windows 11 x64（中文区域设置，代码页 936）：草稿安装程序无提示地升级了现有的全机 v1.1.0 安装。clawd-prefs.json 未更改（266 个键），应用启动后宠物可见，且未出现错误对话框。手动检查项目：设置的“关于”页面显示包含新贡献者的 v1.2.0；全屏自动隐藏和全屏覆盖层；两次冷启动后位置保持不变；锁定、睡眠和恢复后眼动追踪正常；将文件夹拖到宠物上会打开终端；右键“新建会话”；以及真实智能体会话的完成动画，且没有 PowerShell 闪现。真实的 OpenCode 1.18.31 会话成功将状态事件和权限气泡传至 Clawd，其中包括从中文名称目录启动的会话。
• macOS arm64（草稿 DMG，安装至 Applications）：打包应用通过了 codesign --verify --deep --strict、spctl（已接受，已公证的 Developer ID）和 stapler validate 检查；其内容包含一个 darwin-arm64 Koffi 插件，不含已停用的 Telegram sidecar，也不含官方主题媒体。设置的“关于”页面显示了包含所有贡献者的 v1.2.0；Clawd 在后台运行时，首次点击即可打开设置和仪表板；菜单栏和 Dock 的可见性在重启后保持不变；使用权限快捷键批准操作不会将焦点切回终端；真实 Claude Code 会话可驱动宠物直至完成动画。无论 Dock 位于左侧还是右侧、是否启用自动隐藏，固定 Dock 都能让宠物留在屏幕上；Dock 位于底部且不自动隐藏时也如此。
• 应用内更新，macOS arm64（发布后）：已签名的 v1.1.0 构建可自行更新至 v1.2.0，无论选择“立即重启”，还是选择“稍后”后退出并重新打开。更新后的应用通过了 codesign 和 Gatekeeper 检查（已公证的 Developer ID），其代码签名与 v1.2.0 DMG 构建一致。
• #1079 的先前真实设备检查：在中文 Windows 路径下检测 OpenCode 主机；中断后撤回 OpenCode v2.0.18 气泡；将 Codex Pet 从 v1.1.0 升级；以及使用真实 Codex Desktop 部署记录回放远程监控。

未测试：

• 在打包的 Windows 构建上：OpenCode 2.x；在 OpenCode 气泡中手动选择允许、拒绝和始终允许；钩子被替换后的 Claude 钩子健康徽标和托盘通知；以及 WSL 会话 PID 处理。
• 在打包的 macOS 构建上：气泡中的 IME 候选窗口、Ghostty 跨 Space 焦点，以及启用自动隐藏时 Dock 位于底部的情况。本次发布未更改相关代码。
• 在真实硬件上测试 macOS x64 构建；该构建仅通过 CI 验证。
• Windows 和 macOS x64 上的应用内更新。
• 在真实 Linux 硬件上测试 Linux 软件包。
• 完整的 Remote SSH 流程。
• 上方未列出的其他长期检查清单项目，本次发布未重新测试。

官方来源：https://github.com/rullerzhou-afk/clawd-on-desk/releases/tag/v1.2.0

v1.1.0

Clawd v1.1.0 新增 OMP 和 Grok Build 集成、可下载的官方主题、Dashboard 快速选择、持久会话恢复以及更丰富的远程工作流。同时，它增强了本地 HTTP 接入、用户所有的配置、OpenCode 插件交付、Remote SSH 元数据和跨平台发布检查的安全性。

代理与会话

• OMP (oh-my-pi) (#1013) — 新增一流的、仅管理状态的 OMP 扩展，具有独立的会话标题和两阶段完成协议。完成操作会等待 OMP 的最终 agent_end 决策；切换或分支会话时，旧的 Dashboard 行会被移除。如果社区桥接已存在，Clawd 会跳过安装。感谢 @TalexDreamSoul。
• Grok Build (#1004) — 新增由标记所有的状态和通知命令钩子，所有权限决策仍由 Grok 负责。生命周期映射、轮次顺序、Windows 命令处理和卸载均会保留无关钩子。感谢 @pu-1205。
• 更安全的 OpenCode 交付 (#1026) — 将受管理的 OpenCode 插件部署到用户主目录下经过验证、内容寻址的代际目录中，而不是从应用程序包注册文件。所有权、锁定、元组选项、中断后的清理、符号链接主目录和卸载都采用失败关闭方式，不会接管外部条目；即使 Windows 报告现有文件祖先目录下缺少子项，也一样如此。
• 持久会话恢复 (#1010) — 存储有界且识别配置文件的 Claude 会话历史，使符合条件的对话在重启后也能恢复。无法验证配置文件来源的旧记录仍会显示，但无法恢复。感谢 @TalexDreamSoul。
• 更好的会话上下文 (#945、#999、#1002、#1006) — Dashboard 卡片会显示当前模型，Qoder 标题保持稳定，OpenCode 会恢复延迟加载的上下文用量，Windows 会话聚焦和深层链接也更加可靠。感谢 @easyhak、@brantshin、@Tsdsj 和 @Free-LZJ。

Dashboard、主题与桌面

• Dashboard 快速选择 (#972) — 在设置中为 macOS/Windows 分配快捷键后，即可打开完整 Dashboard，并显示固定的 1–9 会话槽位。此功能会保留草稿和输入法组合状态，处理滚动与焦点交接，并支持不同键盘布局下的物理数字行按键；不会将 NumLock 关闭时的导航键误当作会话跳转。
• 可下载的官方主题 (#1020) — 设置可从独立的 rullerzhou-afk/clawd-themes 发布目录下载、验证、安装、修复和卸载可选官方主题。Hash Sage 仍位于 Clawd 源代码和程序包树之外；安装所有权和 ZIP 解压范围均受到限制，卸载时会说明自定义内容和受管理的声音覆盖项也会被移除。
• 设置与桌面优化 (#924、#965、#966、#998) — 提高缩放时主题菜单的稳定性，统一按钮和开关，恢复失败的配额切换，保留无障碍节日标签，并清理未完成的拖动操作。
• Windows 修复 (#779、#805、#978、#1002、#1008、#1023) — 改进交互式 Remote SSH 控制台启动、Cursor 钩子路径和聊天标题、不会激活窗口的命中区域点击、Codex 深层链接、编辑器焦点，以及 Windows 11 shell island 周围的全屏检测。感谢 @VonSdite、@mantertius、@Free-LZJ 和 @KaiC5504。

远程工作流与可靠性

• 通过 Telegram 回复 Codex (#970) — 完成通知可将有界回复发送回权威 Codex 会话。排队的回复会绑定到发起它的会话，不会误入其他对话。感谢 @FuZoe。
• 通过 Remote SSH 使用 Hermes (#975、#1003) — Remote SSH 可将 Hermes 插件部署到多个目标，保留安全传输的所有权，并在不削弱原生回退机制的情况下路由受支持的权限回调。感谢 @xfurqan0。
• Remote SSH 可见性 (#996) — 设置会显示下一次重新连接时间，并在重试开始时清除已过期的期限。远程钩子元数据无法再注入本地 Windows Terminal HWND。感谢 @undefined-moe。
• 钩子与会话可靠性 (#902、#981、#993) — 如果依赖闭包损坏，安装程序会拒绝注册钩子；WSL 配对会复制完整钩子树；不可用的远程会话操作会保持隐藏；不会仅因源包装器退出就移除仍在运行的代理。感谢 @sunnyswag、@undefined-moe 和 @PeterShanxin。
• AppImage 上持久化的 Claude 钩子 (#1029) — Linux AppImage 安装使用稳定、归用户所有的钩子代际目录，而不再使用临时挂载中的路径。
• 本地接入与所有权加固 (#1000) — /state 和 /permission 现在共用相同的环回地址、Host、Origin 和唯一 JSON Content-Type 防护。Cursor 钩子、Claude 状态行、主题标记、会话清理、配置文件恢复和安装程序依赖检查都会保留外部数据，并拒绝所有权不明确的情况。感谢 @PeterShanxin。

升级说明

• 升级后请启动一次 Clawd，以便已安装且已启用的集成同步其打包的钩子、插件和扩展。已禁用或已卸载的集成不会被静默安装。
• 现有 OpenCode 用户可能会看到插件注册迁移到 ~/.clawd/integrations/ 下的受管理代际目录。外部、已修改、含糊不清或冲突的条目会保持原样，并提示进行人工检查。
• 可选官方主题可按需从“设置 → 主题”下载。它们不会捆绑在 Clawd 安装程序中。
• Telegram 会话回复功能与审批功能相互独立。只有在完成操作能够关联到唯一权威 Codex 会话时，才会将回复加入队列。
• 自定义 HTTP Agent 发送方必须使用通过 ~/.clawd/runtime.json 查得的字面环回端点，省略 Origin，并且只发送一个 Host 标头和一个 application/json Content-Type。读取 JSON 正文之前就会拒绝不安全或含糊不清的请求；请参阅 集成指南。
• Linux Homebrew 安装仍支持 x86_64；打包的 Linux 更新仍需手动安装新程序包。

贡献者

感谢在 v1.0.0 至 v1.1.0 期间贡献代码并合入的贡献者： @TalexDreamSoul、@FuZoe、@undefined-moe、@pu-1205、@Tsdsj、@mantertius、 @Free-LZJ、@PeterShanxin、@easyhak、@jlimcode、@xfurqan0、@brantshin、 @VonSdite、@sunnyswag、@eugenewang5425、@KaiC5504 和 @YOIMIYA66。 设置中的“关于”页面和所有 README 版本均保留既有贡献者致谢和原始作者信息。

验证状态

完成上述发布候选版本审核、生产环境加固和跨平台测试修复后，本地 Gate D 已在当前发布候选版本上通过：发布版本和 17 位贡献者的契约检查均已通过；源代码测试套件报告 10,769 项测试 （10,723 项通过，0 项失败，46 项仅限平台的跳过项）；Electron 41.10.4 已验证；仓库资源审计报告 0 个错误，并出现既有的受跟踪树警告预算警告（受跟踪文件为 56.46 MiB，程序包输入为 23.35 MiB）。针对精确提交的 Windows/macOS/Linux CI、打包应用检查、Windows/WSL 设备检查、下载草稿资源冒烟测试，以及签名的 v1.0.0 → v1.1.0 更新程序演练均属于独立门禁；除非另有记录，否则状态仍为 未测试。本地源代码测试不能替代这些测试层级。 请遵循发布检查清单。

官方来源：https://github.com/rullerzhou-afk/clawd-on-desk/releases/tag/v1.1.0