Pi代理使用方法

发表于 阅读次数：

Workbuddy、Trae、Pi等 AI 代理的能力日新月异，不拥抱 AI 迟早会被淘汰，所以研究一下开源的 Pi 代理的使用方法。

安装部署

Pi代理具体安装部署请参考：

扩展安装

记录在不同领域需要安装的扩展。

安装方法

打开命令提示符，输入如下命令：

1
pi install npm:extension_name

大模型接入扩展

  • pi-cn-free-model-providers

让 pi（AI 编码助手 CLI）面向中国大陆用户，通过原生通道接入多个免费/低成本模型供应商，包括 OpenCode Zen、SenseNova、SiliconFlow、ModelScope、NVIDIA NIM、AMD Radeon Cloud、Cloudflare 和 Agnes AI。各平台政策可能变化，模型会自动进行实时目录校验。

1
pi install npm:pi-cn-free-model-providers

办公领域

  • pi-subagents

办公多任务拆分核心。把「汇总多份文档 + 写 PPT 大纲 + 整理待办」拆成多个子 Agent 并行处理，适合批量材料、报告撰写。

1
pi install npm:pi-subagents
  • rpiv-todo（@juicesharp/rpiv-todo）

持久化待办清单，会话压缩、重启后任务不丢失。周报、项目跟进、多阶段公文任务必备，支持 /todos 查看任务面板Pi

1
pi install npm:@juicesharp/rpiv-todo
  • pi-web-access

网页检索、URL 抓取、PDF 解析一体。阅读合同、政策文件、参考资料；自带 OCR，支持扫描版文档提取文字。办公文档处理头号扩展。

1
pi install npm:pi-web-access
  • @gotgenes/pi-permission-system（bash-guard）

权限防护扩展。对删除、覆盖文件、批量修改文档等高风险操作弹窗确认，防止误删合同、报表，办公环境安全底线。

1
pi install npm:@gotgenes/pi-permission-system

开发领域

  • pi-lens

核心开发扩展，接入 LSP、linters、类型检查、代码静态扫描；每次修改代码自动做语法 / 类型校验，让 Agent 写完代码立刻自检，减少低级 bug，C++/TS/Python 都适用Pi

1
pi install npm:pi-lens
  • pi-hashline-edit-pro

增强文件编辑工具，基于行哈希定位修改，避免模糊匹配改错代码；支持跨会话撤销，多文件批量修改稳定性大幅提升Pi

1
pi install npm:pi-hashline-edit-pro
  • pi-code

一站式代码增强包，兼容 Claude Code 配置，内置任务清单、检查点、会话记忆、网页检索、子代理能力，开箱即用的完整编码工作流

1
pi install npm:@chankov/agent-skills

技能安装

安装方法

全局用户目录安装（推荐，所有项目生效，Windows）

  • 定位 Pi 全局 skill 目录
1
%USERPROFILE%\.agents\skills\

完整示例：C:\Users\你的用户名\.agents\skills\pdf-reader\

  • 创建文件夹 pdf-reader，在里面新建 SKILL.md，把下面内容复制进去:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
name: pdf-reader
description: PDF专业处理技能，区分纯文本PDF/扫描件/带公式图表PDF，自动选择文本提取或OCR页面渲染，提取表格、批注，适合合同、标书、公文阅读。
---
# PDF阅读处理规范
## 适用场景
当任务包含读取PDF、提取PDF文字、表格、批注、总结PDF、解析扫描版PDF时自动启用本技能。
## 处理流程
1. 判断PDF类型：
    - 纯文本PDF：直接提取全文，保留表格结构；
    - 扫描图片PDF：调用OCR识别；
    - 含公式/图表PDF：提取文本+描述图表内容。
2. 输出规则：
    - 长文档：先输出文档大纲，再按章节提炼要点；
    - 表格：尽量还原markdown表格；
    - 合同/公文：重点提取条款、日期、关键数据；
3. 约束：遇到文字模糊OCR识别不全时，主动告知识别缺陷，不编造原文。
  • 重启 Pi，输入 /reload 重载技能列表。
  • 验证：/skill:pdf-reader，能正常唤起代表安装成功。

项目本地安装（仅当前项目生效）

在你的项目根目录新建文件夹：.agents/skills/pdf-reader/，放入上面的 SKILL.md。

参考链接

  1. 离线部署AI_Agent的方法,by huangwang.