@xicode/pi-songyan

Chinese ink-style TUI companion, theme, dashboard, and footer for Pi

Packages

Package details

extensiontheme

Install @xicode/pi-songyan from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@xicode/pi-songyan
Package
@xicode/pi-songyan
Version
0.2.0
Published
Aug 11, 2026
Downloads
286/mo · 286/wk
Author
xicode
License
MIT
Types
extension, theme
Size
82.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/extension.js"
  ],
  "themes": [
    "./themes/songyan.json"
  ]
}

Security note

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

README

@xicode/pi-songyan

面向 Pi coding agent 的中国风 TUI 套件：松烟主题、墨灵桌宠、会话仪表盘、渐变 Footer 与涟漪工作指示器。

主要能力

  • 桌宠锚定在输入编辑器上方，不覆盖历史消息或流式输出。
  • 墨灵与滚滚两种宠物，支持成长阶段、情绪、喂食、玩耍、散步、踱步和追蝶。
  • 根据 Agent、Turn 和工具执行状态自动切换动作并积累经验。
  • 多仓位保存、切换和领养，状态保存在项目的 .pi/songyan-pets.json。
  • 附带 songyan TUI 主题、渐变 Footer、上下文用量和缓存命中信息。
  • 提供会话仪表盘、色板预览、启动横幅和命令参数补全。

安装

pi install npm:@xicode/pi-songyan

安装后重启 Pi 或执行 /reload。要启用随包提供的完整配色，可在 /settings 中选择 songyan，或在 settings.json 中设置：

{
  "theme": "songyan"
}

扩展本身也能与其他主题一起使用；宠物和松烟界面默认启用。

命令

命令 用途
/pet 打开宠物动作与管理菜单
/pet touch|feed|play 摸摸、喂食或玩耍
/pet chase|pace|rest|walk|home 触发动作或回家
/pet card 查看宠物状态卡
/pet name <名字> 修改当前宠物名字
/pet save <仓位> 复制当前宠物到全新仓位，不覆盖已有仓位
/pet load <仓位> 切换到已有宠物仓位
/pet new moling|gungun 在新仓位领养墨灵或滚滚
/pet slots 列出所有仓位
/dash 打开模型、上下文、成本和活动仪表盘
/palette 预览当前主题色板
/songyan on|off 开启或关闭 Footer、工作指示器和宠物舞台

/pet、/pet load、/pet new 与 /songyan 支持 Pi 原生命令参数补全。

数据与行为

宠物数据按项目保存到：

<project>/.pi/songyan-pets.json

扩展不会把宠物状态写入会话上下文，也不会发送给模型。每个已完成的 Turn 会增加经验； 喂食、玩耍和触摸带有冷却时间。关闭或切换会话时会立即持久化当前状态。

松烟使用真彩 ANSI 颜色，建议在 Windows Terminal、WezTerm、Kitty、iTerm2、Ghostty 或 VS Code 终端中使用。非 TUI 模式不会挂载桌宠和覆盖层。

开发

pnpm package:check pi-songyan
pnpm package:run pi-songyan          # 隔离安装与运行
pnpm package:run pi-songyan --host   # 与当前已安装插件一起运行

源码位于 src/，主题位于 themes/songyan.json。该包为自主维护包，不依赖 vendor/。