AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

展示了一套结构清晰、可复用的 pi Agent 配置方案，包含行为准则、MCP 集成和工作流自动化，适合作为自定义编码助手的参考。

适合谁使用

pi Agent 用户
希望统一 AI 编码助手行为的开发者
需要配置 MCP 与终端 UI 的开发者
关注 AI 编码工作流规范的团队

典型使用场景

跨机器复制一致的 pi 配置
在 AI 辅助开发中强制简体中文与编码规范
为编码助手接入网络搜索、代码搜索和 Chrome DevTools
配置终端 UI 与扩展包提升交互体验

项目优势

目录结构清晰，配置项有表格说明
内置 chrome-devtools、searchcode、tavily 等 MCP 服务
AGENTS.md 明确了语言、编码原则、工作流和命令策略
支持通过包管理安装扩展与主题

使用前须知

列出的 packages 需要手动在终端安装
配置主要面向 pi 生态，迁移到其他 Agent 需适配
未深入解释 extensions 目录中自定义扩展的实现细节

README 快速开始

🧠 my-pi

个人 pi 编码智能体 Agent 配置仓库。

📦 概述

本仓库集中管理 pi Agent 的个性化配置、扩展、MCP 服务以及开发规范，旨在为 AI 编码助手提供一致的行为准则、工具链和工作流。

🗂️ 目录结构

.
├── AGENTS.md          # 全局开发配置（语言、编码原则、工作流、命令策略）
├── settings.json      # pi 核心设置（主题、包、提供商、代理等）
├── mcp.json           # MCP 服务器配置（chrome-devtools、searchcode、tavily）
├── open-tui.json      # Open TUI 终端 UI 配置
├── extensions/        # 自定义扩展
│   ├── custom-provider.ts
│   ├── permission-gate.ts
│   ├── qna.ts
│   ├── question.ts
│   ├── questionnaire.ts
│   ├── structured-output.ts
│   └── tools.ts
├── LICENSE
└── README.md

⚙️ 配置说明

settings.json

配置项	说明
`theme`	界面主题（one-dark）
`defaultProvider` / `defaultModel`	默认 AI 提供商与模型
`httpProxy`	HTTP 代理地址
`packages`	需要额外安装的 pi 包（见下方安装说明）
`retry`	自动重试策略（最多 8 次，基础延迟 5s）
`hideThinkingBlock`	隐藏思考过程
`quietStartup`	静默启动

packages 安装

settings.json 中配置的 packages 需要单独安装，在终端执行：

pi install pi-mcp-adapter
pi install pi-open-tui
pi install @tintinweb/pi-subagents
pi install @pi-lab/notify
pi install @juicesharp/rpiv-todo
pi install @firstpick/pi-themes-bundle
pi install pi-rounded-tools

各包功能：

包名	说明
`pi-mcp-adapter`	MCP 协议适配器
`pi-open-tui`	终端 UI 增强
`@tintinweb/pi-subagents`	子代理支持
`@pi-lab/notify`	通知功能
`@juicesharp/rpiv-todo`	任务管理
`@firstpick/pi-themes-bundle`	主题包合集
`pi-rounded-tools`	圆角工具样式

MCP 服务

mcp.json 配置了以下 MCP 服务器：

chrome-devtools — Chrome DevTools 协议集成（通过 npx chrome-devtools-mcp）
searchcode — 公共代码搜索与分析
tavily-remote-mcp — 网络搜索（实时信息、新闻、事实）

Open TUI

open-tui.json 配置了终端 UI 的显示语言、图标、底部状态栏段落和遥测选项。

📜 开发规范（AGENTS.md）

AGENTS.md 是 AI 编码助手的行为准则，核心要点：

语言：所有输出使用简体中文
编码原则：先思考再编码、简洁优先、外科手术式修改、目标驱动执行
工作流：普通功能 → 编码 → 审查 → 提交；复杂功能先规划
命令策略：文件操作用专用工具，Git 只读操作自动执行，管理员/交互命令交用户执行
自动代理：代码审查 /code-review-expert、复杂规划 /planning-with-files 自动触发

🚀 快速开始

克隆本仓库
安装依赖包（见上方 packages 安装 章节）
将 settings.json、mcp.json、open-tui.json 放置在 pi 配置目录中
将 AGENTS.md 放置在项目根目录作为 AI 行为准则

感谢

感谢 LinuxDo 社区对本项目的支持

项目描述

个人的pi Agent 配置仓库

my-pi