Pi Pet — 0.8.0-trial.3 朋友试用

Pi 桌面宠物插件，提供预编译的 Windows x64 与 Apple Silicon Mac 桌面组件。通过 Pi 原生包管理安装，无需下载 ZIP、编译或手动运行 exe。

安装与首次使用

需要已经安装并能正常启动的 Pi，以及 Node.js 22+。本版原生验收使用 Pi 1.0.0、Windows 11 x64 和 macOS arm64。Pi 应先配置好你自己的模型服务；本包不附账号、额度或密钥。

在普通 PowerShell（Windows）或终端（Mac）执行：

pi install npm:pi-pet-companion@trial

trial 是试用渠道，本包版本为 0.8.0-trial.3。npm 会自动下载当前平台的载荷分块（Windows 约 124 MB，Mac 约 107 MB），校验合并后复用原桌面准备机制；首次准备需要磁盘空间和时间。完成后，等待自己当前的 Pi 任务安全结束，再重新打开 Pi，输入 /pet。扩展会自动校验、准备并启动对应桌面组件。无需开发目录或提供者的硬盘。

首次没有角色时会出现导入引导，这是预期行为。使用 /pet settings → 外观与动作 → 导入宠物，导入自己有权使用的完整角色目录，或 Petdex 官网提供的安装文本。包内不附角色素材；导入入口只解析、下载和校验文本，不执行粘贴的命令。素材来源可访问 Petdex，素材使用权限由其各自许可决定。

打开宠物输入框，选择 Pi 会话，输入文字并发送，在任务卡查看回复。/pet status 查看版本和连接，/pi-pet 是别名。Esc 收起输入框并保留草稿；收起任务卡不取消 Pi 任务。已有另一 Pi Pet 来源时，先用 pi list 核对并移除旧扩展登记，保留用户数据，不同时加载两套。

试用范围与限制

• 只开放首次安装和基础使用，更新与回退试用暂未开放。 现有内部更新机制仍保留，本包不附更新夹具。沿同一 npm 试用来源维护后续版本；后续升级需等待维护者验证和通知。
• 同一基础版本在 Windows 已通过普通用户本地 Pi 安装、/pet 启动、原生键盘受控中文收发、外点收起和系统明暗布局；Mac 已通过运行流程及必要原生交互。此处描述的是基础包已有证据，公开 npm 来源安装验收将另行记录，不用本地安装替代。
• Windows 本版本仍待验证：实体中文输入法候选点击、实体一次 Enter 补全、鼠标点击发送、输入打开时拖动、严格透明区点击穿透。Mac 实体中文输入法选词未验。Pi 1.0+ 使用公开接口支持一次 Enter 执行完整命令候选；旧 Pi 兼容路径需要再次 Enter。
• 中文收发测试使用受控本地模型，朋友自己的真实模型服务未验。模型服务的登录、网络与额度由 Pi 管理。
• Windows 未签名；Mac 仅 ad-hoc 签名、未公证，系统可能显示来源警告。Windows ARM、Windows 10、Intel Mac、WSL、完整多屏/DPI 和长时间待机/睡眠不在已验范围。
• npm 包是公开可下载的；GitHub 源码托管仍为私有。包没有个人配置、会话、草稿、密钥、私人角色或私人 Git 历史。公开下载不代表开源授权，Pi Pet 仍标为 UNLICENSED，第三方许可见 THIRD_PARTY_NOTICES.md 与 licenses/。

遇到问题请记录版本、操作和错误；截图前遮住模型密钥和私人会话。Pi 包目录收录与安装成功分别验证，npm 上架不自动代表已被 Pi 目录收录。

卸载

安全结束相关 Pi 任务并退出后执行：

pi remove npm:pi-pet-companion@trial

默认保留用户角色、设置、草稿及旧记录，不手动删除用户数据目录。若原安装来源不同，使用 pi list 显示的准确原来源。