本地应用 · NOTE4

Codex 宠物

让桌面的像素工作搭子跟随 Codex 任务:工作、等待处理、完成和出错,一眼就能看见。

它能做什么

跟随本机 Codex 任务状态
多任务列表与手动翻页
像素宠物动画和状态提示音
支持其他 Agent 主动上报状态

安装与使用

让 AI 检查环境,再帮你装好

AI 先检查电脑上的 Hub:已有兼容版本就复用;没有时,需先具备 Hub 源码访问权限,再按当前系统构建。Hub 尚未正式发布,不需要每个应用装一遍。

源码构建 · 按系统适配

按系统构建 · Hub Runtime API v1 · 配套固件

使用与 NOTE4 固件配套的设备 SDK。现有参考环境为 Apple Silicon Mac;其他系统需按源码适配并验证,不能只更改编译目标就认定可用。

Hub 尚未正式发布,仓库及其中的设备 SDK 暂不公开。已有兼容 Hub 可复用;首次安装需有相应源码访问权限。

  1. 检查系统与连接助手

    让 AI 识别操作系统和处理器架构,复用已有兼容 Hub;没有时,先确认 Hub 与配套 SDK 的源码访问权限,再按当前系统编译准备;无权限则暂缓设备安装。核对 SDK 与 NOTE4 固件版本,保留已有应用和数据。

  2. 从源码构建宠物应用

    从公开仓库获取源码,让 AI 根据当前系统编译应用、核对 Runtime API v1 并接入 Hub。检查本机 Codex 路径、进程与状态读取方式,其他系统需完成相应适配。

  3. 检查本机 Codex 跟随

    新安装默认开启本机 Codex 跟随;升级保留已有设置。确认跟随开关后,用一条测试任务检查工作、等待和完成状态。按需设置动画和音量;需要处理任务时回到对应 Agent 窗口。

SDK 源码(需权限)↗

粘贴到电脑上的 Codex 或其他本地 AI。AI 会检查系统、复用或编译连接助手,再从源码准备应用。Hub 与 SDK 源码暂不公开,首次安装需访问权限。

看看交给 AI 的内容
请在我的电脑上帮助安装并验证「Codex 宠物」。
项目仓库:https://github.com/itopinion/zectrix-agent-pet
安装说明:https://github.com/itopinion/zectrix-agent-pet/blob/main/README.md
本站核查日期:2026-10-17;参考提交:2c9213dda1063f6f8a19a4470eed0b367d14b6ef。执行前重新核对当前版本。
项目要求:按系统构建 · Hub Runtime API v1 · 配套固件
分发状态:源码构建 · 按系统适配
应用源码公开;Hub 尚未正式发布,仓库及其中的设备 SDK 暂不公开。
通用设备 SDK 源码:https://github.com/itopinion/zectrix-hub/tree/main/crates/zectrix-cards/vendor/sdk(当前位于私有仓库,需访问权限)。
跨平台适配指南:https://github.com/itopinion/zectrix-hub/blob/main/docs/PORTING.md。核对当前 SDK 与设备固件配套关系,不直接套用旧文档中的版本。
先识别当前操作系统、处理器架构和编译工具链。采用项目源码与配套 SDK 按当前系统编译,不下载或分发预编译 Mac 应用包。Python 项目按目标系统建立独立运行环境。

先准备公共连接助手,再安装应用:
1. 检查本机是否已有 ZECTRIX Hub(https://github.com/itopinion/zectrix-hub)及其运行状态、版本和应用接口。已有兼容版本就复用,不重复安装,不覆盖已有应用、设置和数据,不另开连接抢占设备。
2. 没有 Hub 时,先确认是否有 Hub 与配套 SDK 的源码访问权限。Hub 尚未正式发布,仓库暂不公开;无权限时说明依赖暂不可获取,暂停设备安装,不要求聊天中提供令牌,也不改变仓库可见性。
3. 已有 Hub 但版本不兼容时,先说明差异和升级方案,保留已有数据;核对 Hub 内置 SDK 与设备固件的具体配套版本。不要只凭旧 README 的最低版本推断兼容,不自动刷写或更换固件。NOTE4C 不在本应用范围。
4. 让 NOTE4 与电脑处于同一局域网并进入本地推送模式,由 Hub 发现、选择设备并持有连接。本流程不需要极趣云 API Key 或先手填 MAC。

本项目的安装与使用步骤:
1. 检查系统与连接助手:让 AI 识别操作系统和处理器架构,复用已有兼容 Hub;没有时,先确认 Hub 与配套 SDK 的源码访问权限,再按当前系统编译准备;无权限则暂缓设备安装。核对 SDK 与 NOTE4 固件版本,保留已有应用和数据。
2. 从源码构建宠物应用:从公开仓库获取源码,让 AI 根据当前系统编译应用、核对 Runtime API v1 并接入 Hub。检查本机 Codex 路径、进程与状态读取方式,其他系统需完成相应适配。
3. 检查本机 Codex 跟随:新安装默认开启本机 Codex 跟随;升级保留已有设置。确认跟随开关后,用一条测试任务检查工作、等待和完成状态。按需设置动画和音量;需要处理任务时回到对应 Agent 窗口。
应用通过 Hub Runtime API 工作;设备 SDK 由连接层使用;不要误以为单独下载 SDK 就能替代 Hub。核对平台相关的路径、进程管理、编译依赖和语音后端,按需适配;编译通过不等于跨平台功能已验证。

首次验证:用明确标注的测试任务验证工作、等待和完成状态,检查翻页和提示音;不把演示状态当作真实任务进度。
请分别汇报程序启动、图片生成、设备接收与实屏验证,不把模拟成功当作真机验证。说明安装位置、怎样再次启动和停止,以及电脑或网络断开后的限制。
密钥、Hub 凭据、账号和个人数据只在本机配置,不放入共享任务或日志。若当前 AI 没有本地执行环境,先交付可检查的本地安装步骤,不声称已经安装。

装好以后,确认这一点

用明确标注的测试任务验证工作、等待和完成状态,检查翻页和提示音;不把演示状态当作真实任务进度。

仓库说明已核对 · 本次未做安装与实机推送验证。复制任务不会自动执行安装。

常见问题

能在设备上批准 Codex 操作吗?

不能。设备用于显示和提醒,确认键恢复自动跟随;审批或回答仍在对应 Agent 窗口完成。

源码和后续更新在哪里?

源码已公开,后续完善会持续更新到此 GitHub 仓库。安装前让 AI 阅读当前 README、核对版本与变更,再按你的系统构建;升级时保留已有设置和数据。

需要推理 API Key 吗?

宠物本身不需要推理 API Key,也不安装语音识别模型。它显示 Agent 上报或本机跟随得到的任务状态。

项目与更新

公开仓库。 项目已于 2026-10-17 核对资料,支持范围以实际版本为准。

后续完善会持续更新到 GitHub 仓库。安装或升级前,请让 AI 阅读当前 README 与版本变更,保留已有设置和数据。

查看源码与说明 ↗
本地应用 · NOTE4开始使用 →

投稿草稿仅保存在此浏览器,尚未提交审核。你可以导出文件;网页不会发送到服务器。