@aiwayds/pi-fun-agent

pi 自定义 sub agent 套件：workhorse(牛马狗) / oldfox(老法师) / rubber-duck(小黄鸭) + workhorse-gate 安全门 + /fun-agent-cfg 配置命令

Packages

Package details

extension

Install @aiwayds/pi-fun-agent from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@aiwayds/pi-fun-agent

Package: @aiwayds/pi-fun-agent
Version: 0.1.2
Published: Aug 17, 2026
Downloads: 444/mo · 177/wk
Author: aiwayds
License: MIT
Types: extension
Size: 38.8 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./workhorse-gate.ts",
    "./index.ts"
  ]
}

Security note

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

README

fun-agent

pi 自定义 sub agent 套件：workhorse（牛马狗，干活主力）+ oldfox（老法师，顾问审核）+ rubber-duck（小黄鸭，多模态视觉）。

内容

路径	说明
`agents/workhorse.md`	workhorse 权威定义（部署到 `~/.pi/agent/agents/`）
`agents/oldfox.md`	oldfox 权威定义（部署到 `~/.pi/agent/agents/`）
`agents/rubber-duck.md`	rubber-duck 小黄鸭权威定义（多模态视觉 agent，部署到 `~/.pi/agent/agents/`）
`workhorse-gate.ts`	workhorse 安全门扩展
`index.ts`	`/fun-agent-cfg` 命令扩展

部署

将 agents/*.md 复制到 ~/.pi/agent/agents/（包注册见 package.json 与 ~/.pi/agent/settings.json 的 packages）：

cp agents/workhorse.md ~/.pi/agent/agents/workhorse.md
cp agents/oldfox.md ~/.pi/agent/agents/oldfox.md
cp agents/rubber-duck.md ~/.pi/agent/agents/rubber-duck.md

命令

/fun-agent-cfg — 级联式交互配置（仿 rpiv-models 的二段选择，↑↓ 导航，Enter 选择，Esc 返回上一层）：

顶层菜单（选择 agent，Esc 退出）
  └─ <agent> → 选模型 → 选思考强度 → 保存 → 回顶层菜单

顶层菜单：选择要配置的 agent（显示 display_name 中文名），保存后回到这里可继续配置下一个
Model：选择模型（按收藏筛选 + inherit），支持键入过滤，✓ 标记已保存值
Think Level：选择思考强度（inherit / off / 模型支持的档位），Esc 回到模型选择

模型列表按收藏自动筛选：读 ~/.pi/agent/model-favorites.json（与 /m 命令共享）的 favorites，非空时仅显示收藏模型，为空时显示全部。用 /m 管理收藏列表（本命令不提供编辑界面）。

inherit = 删除 frontmatter 对应行，回退继承会话默认。可带参数预选 agent：/fun-agent-cfg workhorse（跳过顶层菜单，直接进级联）。

改完 frontmatter 后下一次 spawn 生效，无需 /reload。

⚠️ 注意：对 rpiv 管理的 agent（codebase-analyzer 等）使用 set/reset 后，下次 /rpiv-update-agents 会覆盖你的设置。

workhorse-gate 规则（workhorse 会话内生效）

write/edit 目标在 $HOME 之外 → 阻断
bash 含 sudo/su、rm -rf、chmod/chown 777 → 阻断
write/edit 落在 ~/.pi/agent/ 内 → 阻断（含 gate 自身保护）
bash 重定向目标（>/>>/tee/dd of=）在 $HOME 外或 ~/.pi/agent/ 内 → 阻断

限制：workhorse-gate 是事故拦截器（tool_call 代码级检查），非 OS 级权限隔离——read/grep 等只读工具面不拦截；MCP 及其他未列入 write/edit/ctx_edit/ctx_patch/bash 的工具面不受检查。

配置

默认模型与思考强度直接在 agent frontmatter 中定义（workhorse: deepseek-v4-flash/high；oldfox: GLM-5.3/max；rubber-duck: Kimi K2.7 Code/max），可用 /fun-agent-cfg 随时调整。