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

它能做什么
安装与使用
让 AI 检查环境,再帮你装好
AI 先检查电脑上的 Hub:已有兼容版本就复用;没有时,需先具备 Hub 源码访问权限,再按当前系统构建。Hub 尚未正式发布,不需要每个应用装一遍。
按系统构建 · Hub Runtime API v1 · 配套固件
使用与 NOTE4 固件配套的设备 SDK。现有参考环境为 Apple Silicon Mac;其他系统需按源码适配并验证,不能只更改编译目标就认定可用。
Hub 尚未正式发布,仓库及其中的设备 SDK 暂不公开。已有兼容 Hub 可复用;首次安装需有相应源码访问权限。
检查系统与连接助手
让 AI 识别操作系统和处理器架构,复用已有兼容 Hub;没有时,先确认 Hub 与配套 SDK 的源码访问权限,再按当前系统编译准备;无权限则暂缓设备安装。核对 SDK 与 NOTE4 固件版本,保留已有应用和数据。
从源码构建宠物应用
从公开仓库获取源码,让 AI 根据当前系统编译应用、核对 Runtime API v1 并接入 Hub。检查本机 Codex 路径、进程与状态读取方式,其他系统需完成相应适配。
检查本机 Codex 跟随
新安装默认开启本机 Codex 跟随;升级保留已有设置。确认跟随开关后,用一条测试任务检查工作、等待和完成状态。按需设置动画和音量;需要处理任务时回到对应 Agent 窗口。
粘贴到电脑上的 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 上报或本机跟随得到的任务状态。

