@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

相关文档

• English README

License

MIT