Pi-Agent 终极极简配置文档（Java+Vue+Python爬虫 4-5千文件项目）

核心说明

适配习惯：全程只打字提问，不使用任何 /xxx 斜杠命令
全部安装包均为后台自动生效，无需手动触发、无需记忆指令
已剔除所有需要手动操作、冗余鸡肋插件，只保留大项目刚需能力
适配项目技术栈：Java后端 + Vue前端 + Python爬虫（4000-5000文件量级）
一、最终必装极简包清单（直接复制安装）

核心代码检索与语法校验（大项目刚需）

powershell 复制代码

pi install npm:opencode-codebase-index
pi install npm:pi-code-nav
pi install npm:pi-lens

安全多文件编辑（杜绝代码改错、改崩、半改状态）

powershell 复制代码

pi install npm:pi-mono-multi-edit
pi install npm:pi-hashline-edit-pro

爬虫开发 + 文档查询 + 数据库预留能力

powershell 复制代码

pi install npm:pi-web-access
pi install npm:pi-mcp-adapter

长会话稳定 + 项目安全防护

powershell 复制代码

pi install npm:context-mode
pi install npm:@gotgenes/pi‑permission‑system

汇总为

powershell 复制代码

# 核心代码检索与语法校验（大项目刚需）
pi install npm:opencode-codebase-index
pi install npm:pi-code-nav
pi install npm:pi-lens

# 安全多文件编辑（杜绝代码改错、改崩、半改状态）
pi install npm:pi-mono-multi-edit
pi install npm:pi-hashline-edit-pro

# 爬虫开发 + 文档查询 + 数据库预留能力
pi install npm:pi-web-access
pi install npm:pi-mcp-adapter

# 长会话稳定 + 项目安全防护
pi install npm:context-mode
pi install npm:@gotgenes/pi‑permission‑system

二、每个包作用（通俗版，对应你的项目）

代码检索核心（解决几千文件找不到代码）

opencode-codebase-index：全自动全局代码语义索引，不用上传全部项目文件。你直接提问就能精准找到：爬虫解析代码、Java业务Service、Vue对应页面组件，彻底解决大项目找不到代码、上下文溢出问题。
pi-lens：改完代码自动检测错误，覆盖Java编译报错、Vue语法错误、Python爬虫代码报错，无需你手动编译排查。

安全编辑核心（防止改崩项目）

pi-mono-multi-edit：多文件事务式修改，批量改代码时，任意一个文件修改失败，全部自动回滚，不会出现部分文件改完、部分出错的烂代码状态。
pi-hashline-edit-pro：专门适配大文件（超长Java Service、大Vue页面、长篇爬虫py文件），精准按行定位修改，杜绝代码错位、替换错误、丢失代码问题。

爬虫 & 开发辅助

pi-web-access：自动抓取网页、分析页面结构、查询Spring/Vue官方文档、解析爬虫目标站点，写爬虫、查技术文档全程无需手动复制粘贴。
pi-mcp-adapter：预留数据库对接能力，默认不生效、无副作用。后续需要让AI查MySQL、看数据表、校验爬虫入库数据时，简单配置即可使用。

稳定 & 安全兜底

context-mode：长会话自动压缩上下文，连续开发、迭代需求时，不会遗忘之前的项目约定和代码逻辑，解决大会话失忆问题。
@gotgenes/pi‑permission‑system：全自动高危操作拦截，禁止AI执行删文件、删数据、清空目录等危险操作，保护整个项目安全。
三、专属使用规则（零命令、纯对话）

小改动（1-2个文件）------ 直接提问
示例：

帮我优化一下这个python爬虫的解析逻辑
修改这个Vue组件的样式和请求逻辑
修复Java接口的参数校验问题

大改动（≥3个文件）------ 固定前缀必加
无需 /plan 命令，粘贴以下固定话术即可安全预览修改：
固定模板：先列出所有将要修改的文件和每个文件要改什么内容，不要修改磁盘文件，等我确认之后再执行修改。
完整示例：
先列出所有将要修改的文件和每个文件要改什么内容，不要修改磁盘文件，等我确认之后再执行修改。统一修改用户信息字段，同步更新Java后端实体、Vue前端展示页面、Python爬虫解析规则。
确认修改：回复「可以执行」
取消修改：回复「取消本次修改」
四、日常排查命令（几乎不用，备用）
pi list # 查看所有已安装插件
pi disable 包名 # 临时禁用某个插件（不删除）
pi enable 包名 # 重新启用插件
五、最终优势总结

✅ 零学习成本、零手动命令，全程自然语言对话
✅ 适配四五千文件大项目，不上下文溢出、不找不到代码
✅ 多语言全覆盖：Java / Vue / Python 完美适配
✅ 兼顾爬虫开发、前后端迭代、代码重构所有场景
✅ 无冗余功能、不混乱、不占用多余token

其他场景修改控制cmd下面增加剩余金额和当前会话使用金额小技巧直接把下面这段话粘贴给他我是用的deepseek其他模型你自己修改一下

powershell 复制代码

pi需要修改一下启动以后底部显示的内容
\.pi\agent\extensions\balance-footer.ts


 改动内容：
 - 新增 DeepSeek V4 官方价目表（DEEPSEEK_PRICES：flash / pro / flash-vision-exp 三档价格）
 - 新增
 - 新增 priceForModel() 模型名匹配、isPeakHours() 高峰时段判断、costCnyForMessage() 人民币计价函数
 - updateStatus() 中的费用
 - updateStatus() 中的费用计算从「美元 × 汇率」改为按价目表直接以人民币计算；非 DeepSeek 模型保留美元兜底折算                                                             ⠋ Working...
 - 配置里 usdToCny 降级为可选兜底项，其余配置（refreshMinutes、providerId）不变

 pi 本体和 balance-footer.json 配置均未改动。





修改成下面这样差不多
↑13k ↓5.5k R136k CH99.2% $0.004 2.1%/1.0M (auto)                                                                                                  deepseek-v4-flash • high
本次金额:¥0.02 余额:¥973.25



本次金额不需要按照什么美元计算了 按照下面这样
模型    deepseek-v4-flash    deepseek-v4-pro    deepseek-v4-flash-vision-exp
BASE URL (OpenAI 格式)    https://api.deepseek.com
BASE URL (Anthropic 格式)    https://api.deepseek.com/anthropic
模型版本    DeepSeek-V4-Flash-0731    DeepSeek-V4-Pro-0813    DeepSeek-V4-Flash-Vision-Exp
思考模式    支持非思考与思考模式（默认）
切换方式详见思考模式
上下文长度    1M
输出长度    最大 384K
功能    Json Output    支持    支持    支持
Tool Calls    支持    支持    支持
Responses API    支持    支持    支持
Anthropic API    支持    支持    支持
对话前缀续写（Beta）    支持    支持    支持
FIM 补全（Beta）    仅非思考模式支持    仅非思考模式支持    不支持
价格(1)(2)    百万tokens输入
（缓存命中）    空闲时段    0.05元    0.15元    0.05元
高峰时段    0.10元    0.30元    0.10元
百万tokens输入
（缓存未命中）    空闲时段    1.5元    4.5元    1.5元
高峰时段    3.0元    9.0元    3.0元
百万tokens输出    空闲时段    4.5元    13.5元    4.5元
高峰时段    9.0元    27.0元    9.0元
并发限制(3)    2500    500    2500
(1) 空闲时段价格为高峰时段价格的一半。高峰时段为北京时间周一至周五 9:00 - 12:00、14:00 - 18:00（其余为空闲时段）。

可以在你的项目里面创建 AGENTS.md 文件写入以下内容他就会记录所有改过的文件

powershell 复制代码

# 项目强制工作规则
## 目录约定
1. `.pi/memory.md`：保存项目总体概要、架构说明、重要业务决策、关键技术点、特殊业务规则；发生架构变更、重大业务改动必须更新此文件。
2. `.pi/date/YYYY‑MM‑DD.md`：**每日变更日志**，文件名使用系统当天日期，不存在则自动创建。
3. `.pi/doc/`目录：所有AI生成的文档、SQL脚本、设计方案、接口文档、分析报告，**全部输出到此目录，禁止散落根目录 并且规范好升成时间 按文件顺序排列好 方便我点击进行查看**。

## 注意 当文件夹或者文件不存在的时候可以直接创建

## 修改完成后强制行为
1. **每一轮代码修改（edit/write）执行完毕，必须追加写入当日日志文件 `.pi/date/YYYY‑MM‑DD.md`，只追加，绝不覆盖清空原有内容。**
2. 每日日志固定格式：
```markdown
## HH:mm 本次变更
- 修改文件：[文件1, 文件2, 文件3]
- 解决问题：简明描述本次改动需求、修复BUG、实现功能
- 关键点：重要逻辑变更、风险点、后续待处理事项

或者如果之前有zcode或者 codebuddy之类的可以继承过去

# 项目强制工作规则
## 目录约定
1. `.codebuddy/memory/MEMORY.md`：保存项目总体概要、架构说明、重要业务决策、关键技术点、特殊业务规则；发生架构变更、重大业务改动必须更新此文件。
2. `.codebuddy/YYYY‑MM‑DD.md`：**每日变更日志**，文件名使用系统当天日期，不存在则自动创建。
3. `doc/`目录：所有AI生成的文档、SQL脚本、设计方案、接口文档、分析报告，**全部输出到此目录，禁止散落根目录 并且规范好升成时间 按文件顺序排列好 方便我点击进行查看**。

## 注意 当文件夹或者文件不存在的时候可以直接创建

## 修改完成后强制行为
1. **每一轮代码修改（edit/write）执行完毕，必须追加写入当日日志文件 `.codebuddy/YYYY‑MM‑DD.md`，只追加，绝不覆盖清空原有内容。**
2. 每日日志固定格式：
```markdown
## HH:mm 本次变更
- 修改文件：[文件1, 文件2, 文件3]
- 解决问题：简明描述本次改动需求、修复BUG、实现功能
- 关键点：重要逻辑变更、风险点、后续待处理事项