AgentHalo 1.0.5

AgentHalo 1.0.5

减少桌宠在任务状态更新时的阻塞和空闲时的后台查询，改进升级安装，并加强本地接口与浏览器桥接的输入检查。

修复与改进

• Codex 进程查询改为异步执行并复用缓存，避免查询阻塞桌宠主界面。
• WorkBuddy 没有活跃任务时停止轮询，兼容新版数据目录，并允许恢复的归档任务重新接收状态更新。
• 缓存 macOS 静音状态和 Node 路径检测结果，减少重复启动系统进程。
• VS Code／Cursor 终端定位扩展改为“设置 → 通用”中的可选开关；已有安装保留启用状态，升级时替换旧扩展副本。
• 首次迁移 Clawd on Desk 配置时改为复制，保留旧应用的设置和主题。
• npm 安装器增加下载停滞超时、失败与中断清理；确认新版复制完整且旧应用退出后再替换，替换失败时恢复旧版。
• 本地接口拒绝不受信任的网页请求；浏览器桥接校验消息来源和字段，应用窗口限制外部导航，“打开文件夹”拒绝可执行应用包。
• 启用 Electron 安全开关，移除安装包内已停用功能的代码与无用依赖，并补齐主题处理依赖。
• 补回 macOS 签名辅助脚本，修复依赖下载地址与测试兼容性，补充仓库自动检查。

安装或升级

npx agenthalo@latest

需要 macOS 和 Node.js 18 或更新版本。已有用户无需先卸载；安装器替换应用并保留用户设置和导入角色。

如果终端仍提示旧版本，可刷新官方源后安装：

npx --prefer-online --registry=https://registry.npmjs.org agenthalo@latest

手动下载：Apple Silicon · Intel。同名 ZIP 包提供相同应用，校验和见附件 SHA256SUMS.txt。

使用浏览器桥接的用户，请在应用的“设置 → 连接应用”中更新扩展文件，再到浏览器扩展管理页重新加载扩展，并刷新聊天页面。已启用终端定位扩展的用户，重启 VS Code／Cursor 后加载新版扩展。

应用采用 ad-hoc 签名，尚未做 Apple 公证；手动下载后如被 macOS 阻止，请在“系统设置 → 隐私与安全性”选择“仍要打开”。

许可证

AGPL-3.0-only。基于 Clawd on Desk 开发，保留上游版权和许可证。

AgentHalo 1.0.4

AgentHalo 1.0.4

修复 Cursor 空会话以项目文件夹名出现在任务列表、一直显示“等待中”的问题。

修复内容

• 仅创建或打开 Cursor 会话时，不再创建任务条目；收到实际提问、思考或工具活动后才显示。
• 保留空会话的来源识别，避免稍后的正常活动被误判为其他任务的子 agent。
• 延迟到达的会话开始通知不再把正在执行的任务重置为等待。
• 保留现有 Cursor 子 agent 过滤，其他应用的会话显示规则不变。

安装或升级

npx agenthalo@latest

需要 macOS 和 Node.js 18 或更新版本。已有用户无需先卸载；安装器替换应用并保留用户设置和导入角色。

如果终端仍提示旧版本，可刷新官方源后安装：

npx --prefer-online --registry=https://registry.npmjs.org agenthalo@latest

手动下载：Apple Silicon · Intel。同名 ZIP 包提供相同应用，校验和见附件 SHA256SUMS.txt。

浏览器扩展仍为 v0.3.3，无需重新安装。应用目前采用 ad-hoc 签名，尚未做 Apple 公证；手动下载后如被 macOS 阻止，请在“系统设置 → 隐私与安全性”选择“仍要打开”。

许可证

AGPL-3.0-only。基于 Clawd on Desk 开发，保留上游版权和许可证。

AgentHalo 1.0.3

AgentHalo 1.0.3

修复 Codex 后台记忆维护任务以 memories 出现在任务列表的问题。

修复内容

• 从第一条活动通知开始过滤已确认的后台记忆任务，不再等任务结束后才隐藏。
• 已出现的后台任务在后续活动到达时清理，不触发完成提醒。
• 结合 Codex 会话记录和实际记忆目录识别，保留用户创建的正常会话及同名项目。
• 会话数据库不可读取时保留原有显示行为，远程会话不使用本机目录判定。

安装或升级

npx agenthalo@latest

需要 macOS 和 Node.js 18 或更新版本。已有用户无需先卸载；安装器替换应用并保留用户设置和导入角色。

如果终端仍提示旧版本，可刷新官方源后安装：

npx --prefer-online --registry=https://registry.npmjs.org agenthalo@latest

手动下载：Apple Silicon · Intel。同名 ZIP 包提供相同应用，校验和见附件 SHA256SUMS.txt。

浏览器扩展仍为 v0.3.3，无需重新安装。应用目前采用 ad-hoc 签名，尚未做 Apple 公证；手动下载后如被 macOS 阻止，请在“系统设置 → 隐私与安全性”选择“仍要打开”。

许可证

AGPL-3.0-only。基于 Clawd on Desk 开发，保留上游版权和许可证。

AgentHalo 1.0.2

AgentHalo 1.0.2

修复 Codex 任务列表中多出一个以工作文件夹命名的重复任务。

修复内容

• Codex 生成带分段后缀的新日志文件时，继续识别为原来的会话。
• 优先读取日志元数据中的真实会话编号，避免丢失任务标题、误显示工作文件夹名。
• 同步修正重启恢复和归档时的会话编号识别。
• 补齐仓库缺失的开发检查脚本，修复全量测试的两个启动失败。

安装或升级

npx agenthalo@latest

需要 macOS 和 Node.js 18 或更新版本。已有用户无需先卸载；安装器替换应用并保留用户设置和导入角色。

如果终端仍提示旧版本，可刷新官方源后安装：

npx --prefer-online --registry=https://registry.npmjs.org agenthalo@latest

手动下载：Apple Silicon · Intel。同名 ZIP 包提供相同应用，校验和见附件 SHA256SUMS.txt。

浏览器扩展仍为 v0.3.3，无需重新安装。应用目前采用 ad-hoc 签名，尚未做 Apple 公证；手动下载后如被 macOS 阻止，请在“系统设置 → 隐私与安全性”选择“仍要打开”。

许可证

AGPL-3.0-only。基于 Clawd on Desk 开发，保留上游版权和许可证。

AgentHalo 1.0.1

AgentHalo 1.0.1

这次更新让设置入口、角色导入和浏览器扩展安装更清楚。

更新内容

• 新安装默认显示 Dock 图标，点击即可打开设置主界面；已有用户的显示偏好保持不变。
• 桌面伙伴统一为“导入角色包”，自动识别 AgentHalo 和 Codex Pet 格式，入口移至角色列表下方。
• 统一设置页与弹窗的文字层级：正文、标签和按钮使用常规字重，标题适度强调。
• 连接检查改为简洁列表，减少正常状态的重复装饰，突出主要操作。
• “下载扩展包”改为醒目的主按钮，“安装指引”提供浏览器选择和分步说明。
• 未收到网页状态时显示“扩展已安装，请在 AI 网页中发起一次对话”；详情中的安装状态不再混用等待提示。
• 同步全部七种界面语言。

安装或更新

npx agenthalo@latest

需要 macOS 和 Node.js 18 或更新版本。安装器会识别芯片、校验下载文件，并替换已有应用；用户偏好和导入角色保留。

也可以手动下载：

Mac 芯片	安装包
Apple Silicon（M 系列）	AgentHalo-1.0.1-arm64.dmg
Intel	AgentHalo-1.0.1-x64.dmg

同名 .zip 提供相同的应用，和 .dmg 二选一即可。浏览器扩展继续使用 v0.3.3，无需重新安装扩展。

首次打开与已知限制

• 本版只提供 macOS 安装包，仍未做 Apple 公证。手动下载后如被系统阻止，请到“系统设置 → 隐私与安全性”选择“仍要打开”。
• 暂无自动更新，可重新运行上面的一键安装命令。
• 浏览器扩展目前通过“安装指引”手动加载；网页开始生成回答后，桌宠才会收到对话状态。

校验和

fb4ab2e9d2bac714035baaba4437df73dfdabfcfe356bed91f21e9c7ad98814c  AgentHalo-1.0.1-arm64.dmg
39ab0d87898085388c7df535eff1653d0924501206101dd2d69d972e88765d38  AgentHalo-1.0.1-arm64.zip
c5f8d903680657bc395bce064f56df03b53cd8e5c27c9c6df28087d22bbf0059  AgentHalo-1.0.1-x64.dmg
319d18908da9a068e99e14419b9c135fe362a070e810a5a6a8f25bf7b6353bfe  AgentHalo-1.0.1-x64.zip

许可证

AGPL-3.0-only。基于 Clawd on Desk 开发，保留上游版权和许可证。

AgentHalo 1.0.0

AgentHalo 桌面版的第一个公开发布。桌宠会跟着你本机 AI 工具的状态动起来：在思考、在调工具、需要你回话、干完了，各有对应的动作和提示音，20 套角色可选。

支持 Claude Code、Codex、Cursor、Gemini CLI、Qwen Code 等命令行工具，以及网页版的 ChatGPT / Claude / Gemini。

安装

npx agenthalo

会自动识别芯片、下载对应的包、核对校验和、装进 /Applications 并打开。需要 Node 18 以上。

装到别处用 npx agenthalo --dir ~/Applications。/Applications 不可写时会自动退到 ~/Applications，全程不需要 sudo。

也可以手动下载

先看「苹果菜单 → 关于本机」里的芯片一栏：

芯片显示	下载
Apple M1 / M2 / M3 / M4	AgentHalo-1.0.0-arm64.dmg
Intel	AgentHalo-1.0.0-x64.dmg

.zip 是同一个应用的压缩包形式，和 .dmg 二选一。

手动下载的话，第一次打开会被系统拦下。 这一版还没有做 Apple 公证，浏览器下载的文件会被打上隔离属性，macOS 会提示无法验证开发者。应用本身的签名结构是完整的（codesign --verify --deep --strict 通过），手动允许一次即可：

• macOS 15 及以上：拖进「应用程序」双击，出现提示后点「完成」，再打开「系统设置 → 隐私与安全性」，滑到底部点「仍要打开」。
• macOS 14 及以下：在「应用程序」里右键点它，选「打开」，弹窗里再点一次「打开」。

用 npx agenthalo 不会遇到这一步。隔离属性是下载文件的那个程序打上去的，浏览器打，curl 和 Node 不打，两种方式拿到的是同一个应用。

打开之后

AgentHalo 没有 Dock 图标，它常驻在菜单栏。在「设置 → 连接应用」里给你实际用的 AI 工具装上 hook，桌宠才能收到它们的状态。网页版 AI 需要额外装一个浏览器扩展，在同一页里可以加载。

校验和

fb24710be73d34f3abc4cb6376b062c2f0408efcfbaa130a1a383562ac548ab0  AgentHalo-1.0.0-arm64.zip
5e245d092bc65744e660bf89acbe4dd7a9cbe25b5f85510950641e1c7dde74b1  AgentHalo-1.0.0-x64.zip
5d27b740aa888fc41f4ff8f12e54d6d6cc1681cb69a2f20dc9a36fee5ed7b7e7  AgentHalo-1.0.0-arm64.dmg
f8dfe8eca8465a79f2c846dc0b9bcdb214de8655b9b03bafc8d26adb9d5f16b3  AgentHalo-1.0.0-x64.dmg

已知限制

• 未做 Apple 公证，手动下载时首次打开需要按上面的步骤允许一次。
• 没有自动更新，新版本需要重新跑一次 npx agenthalo。
• 浏览器扩展正在 Chrome 应用商店审核中，上架前需要手动加载已解压扩展。
• 本次只提供 macOS 包。

许可证

AGPL-3.0-only。AgentHalo 基于 Clawd on Desk 开发，上游版权与许可证均已保留。

AgentHalo Web Bridge 0.3.3

浏览器扩展 0.3.3。在 Chrome 或 Edge 的扩展管理页开启开发者模式，加载解压后的目录即可。每台机器的 agent ID 由桌面端在运行时下发，不需要手动填写。