Pi Coding Agent 接入指南

🧮 Pi Coding Agent + CLI-Anything

Pi Coding Agent 是一款强大的 AI 编程助手，支持通过扩展（Extension）机制来增强功能。CLI-Anything 可以作为 Pi 的扩展安装，从而让 Pi 能够操控各种桌面软件。

📋 前提条件

Pi Coding Agent 已安装
Python 3.10+
Git（用于克隆扩展仓库）
目标软件已安装

🚀 安装步骤

Step 1：克隆扩展仓库

git clone https://github.com/HKUDS/CLI-Anything.git ~/.pi/agent/extensions/cli-anything

或者如果您想使用特定的分支或版本：

git clone -b develop https://github.com/HKUDS/CLI-Anything.git ~/.pi/agent/extensions/cli-anything

Step 2：运行安装脚本

bash ~/.pi/agent/extensions/cli-anything/install.sh

该脚本会：

将扩展文件复制到全局目录 ~/.pi/agent/extensions/cli-anything/
注册 CLI 命令到 Pi 的路径中
安装必要的 Python 依赖

Step 3：刷新 Pi

安装完成后，需要刷新 Pi 以加载新扩展：

/reload

或者重启 Pi Coding Agent。

💬 使用方法

生成 CLI

/cli-anything gimp

Pi 会自动执行完整的 7 阶段 CLI 生成流程：

Analyze - 分析 GIMP 软件结构
Design - 设计 CLI 命令架构
Implement - 实现核心代码
Plan Tests - 规划测试用例
Write Tests - 编写测试脚本
Document - 生成使用文档
Publish - 发布可用的 CLI

生成其他软件 CLI

/cli-anything blender
/cli-anything libreoffice
/cli-anything shotcut
/cli-anything obs

精修与迭代

当生成的 CLI 需要调整时，使用 refine 命令：

/cli-anything:refine ./gimp [focus]

可选的 focus 参数：

[filters] - 只精修滤镜相关命令
[layers] - 只精修图层相关命令
[export] - 只精修导出相关命令

📝 使用示例

图像处理

User: 用 GIMP 创建一张 1920x1080 的红色背景图片

Pi: [自动执行]
→ cli-anything-gimp image new --width 1920 --height 1080 --color "#FF0000"
✅ 已创建红色背景图片

3D 渲染

User: 用 Blender 渲染当前目录下的 scene.blend 文件，分辨率 1920x1080

Pi: [自动执行]
→ cli-anything-blender scene render --input ./scene.blend --output ./render.png --resolution 1920x1080
✅ 渲染完成

文档转换

User: 把 data.xlsx 转为 PDF，并添加页眉 "季度报告"

Pi: [自动执行]
→ cli-anything-libreoffice calc convert --input ./data.xlsx --output ./report.pdf --header "季度报告"
✅ 转换完成

批量处理

User: 把 /photos 目录下所有 JPG 图片缩放到 800x600

Pi: [自动执行]
→ for f in /photos/*.jpg; do
    cli-anything-gimp image scale --input "$f" --width 800 --height 600
  done
✅ 处理完成

🔧 卸载步骤

如果需要卸载 CLI-Anything 扩展：

bash ~/.pi/agent/extensions/cli-anything/install.sh --uninstall

或者手动删除：

rm -rf ~/.pi/agent/extensions/cli-anything

然后在 Pi 中使用 /reload 刷新。

🐛 常见问题

Q: 扩展不生效

解决：

# 确保扩展目录正确
ls ~/.pi/agent/extensions/

# 刷新 Pi
/reload

Q: Python 依赖缺失

解决：

pip install -r ~/.pi/agent/extensions/cli-anything/requirements.txt

Q: 权限问题

解决：

chmod +x ~/.pi/agent/extensions/cli-anything/install.sh