@anson-no-bug/pi-pet-plus

A real-time pet companion for pi with progression, localization, and optional news delivery

Package details

← Back
extension

Install @anson-no-bug/pi-pet-plus from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@anson-no-bug/pi-pet-plus
Package
@anson-no-bug/pi-pet-plus
Version
0.2.1
Published
Apr 8, 2026
Downloads
89/mo · 9/wk
Author
anson-no-bug
License
MIT
Types
extension
Size
181.8 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/pet-core.ts",
    "./src/pet-news.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@anson-no-bug/pi-pet-plus

English README | 中文

这是一个给 pi 用的全局宠物插件，特点是：

  • 紧凑的 ASCII 宠物 widget
  • 长期成长系统
  • 中英文本地化
  • 可选的 pet-news 新闻播报模块
  • 跨项目、跨 session 的全局存档

安装

从 npm 安装

pi install npm:@anson-no-bug/pi-pet-plus

本地开发加载

pi -e ./src/index.ts

目前包含什么

模块

  • pet-core
    • 宠物 widget
    • 成长系统
    • speech 气泡层
    • 命令与设置
  • pet-news
    • 新闻抓取
    • 轮播
    • 以宠物发言为主的播报方式
    • 可选 footer 模式

当前物种

  • 猫
  • 狗
  • 牛
  • 马
  • 电气鼠
  • 种子兽
  • 火龙兽

成长阶段

分支前的可见阶段：

  1. 宝宝
  2. 学园期
  3. 高中
  4. 大学

大学毕业后可选两条职业线：

  • 学术线：硕士 → 博士 → 教授 → 院士
  • 工程线：实习生 → 工程师 → 高级工程师 → 领域专家

交互式使用方式

主宠物菜单

打开菜单：

/pet

你可以在菜单里：

  • 查看状态
  • 切换宠物
  • 新建宠物
  • 删除宠物
  • 打开 pet-news
  • 毕业后选择职业线
  • 打开设置
  • 显示 / 隐藏 widget

新闻菜单

可以直接打开：

/news

也可以从宠物里进入：

/pet news

在新闻详情面板里，点击 Open ↗ 可以打开完整文章链接。

命令列表

宠物命令

/pet
/pet status
/pet new
/pet rename <name>
/pet switch
/pet switch <name>
/pet delete <name>
/pet news
/pet branch
/pet preview <state>
/pet demo
/pet config
/pet toggle

新闻命令

/news
/news open
/news toggle
/news on
/news off
/news next
/news prev
/news refresh
/news config
/news add-rss <url> [label]
/news remove <sourceId>
/news status

默认设置

当前默认值：

  • 宠物动画速度：0.5 FPS
  • 新闻滚动速度：100ms
  • 语言：zh
  • 新闻展示方式：speech

设置入口：

/pet config
/news config

开发 / 调试命令

本地调试视觉时可以使用：

/pet dev xp <totalXp>
/pet dev stage <baby|kindergarten|elementary|middle-school|high-school|university>
/pet dev branch <none|academia|engineering> [rank]
/pet dev reset

例如：

/pet dev stage baby
/pet dev stage university
/pet dev branch academia 4
/pet dev branch engineering 4

存储位置

全局文件位于：

  • ~/.pi/agent/pet/config.json
  • ~/.pi/agent/pet/state.json
  • ~/.pi/agent/pet/news-cache.json

开发

npm run typecheck
npm test

相关文档

License

MIT