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 会话内生效）

1. write/edit 目标在 $HOME 之外 → 阻断
2. bash 含 sudo/su、rm -rf、chmod/chown 777 → 阻断
3. write/edit 落在 ~/.pi/agent/ 内 → 阻断（含 gate 自身保护）
4. 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 随时调整。