第 9 篇 · 个性化设置

这一篇教你：怎么改 Pi 的外观、设置默认模型、以及用"项目说明文件"让 Pi 更懂你。 都是可选操作，不做也能正常用。

9.1 打开设置面板（最简单）

在 Pi 里输入：

/settings

会打开一个设置面板，可以改：

• 思考级别（Thinking level）

• 主题（Theme）：dark 深色 / light 浅色

• 消息投递方式（一般不用动）

• 其他选项

设置完一般立即生效，有些需要重启 Pi。

9.2 配置文件（进阶，了解即可）

Pi 的设置保存在 JSON 文件里（JSON 就是一种"给程序看的记事本"）：

💡 如果从来没建过这些文件，Pi 用默认设置运行。 用 /settings 面板改动后，Pi 会自动写这些文件。

一个设置示例（改默认模型和思考级别）

用记事本打开全局设置文件（没有就新建），写入：

{
  "defaultModel": "claude-sonnet-4-5",
  "defaultThinkingLevel": "medium",
  "theme": "dark"
}

保存后，重启 Pi 生效。

⚠️ 文件内容必须是严格的 JSON 格式（引号、逗号都要对）。 小白建议：先用 /settings 面板改，别手写文件。

9.3 项目说明文件（AGENTS.md）—— 让 Pi 更懂你的项目

你可以在项目文件夹里放一个说明文件，告诉 Pi"在这个项目里要怎么干活"。

文件名字：AGENTS.md（记事本就能建，但注意后缀是 .md 不是 .txt）

文件内容示例：

# 项目说明

- 这是一个个人网站项目
- 修改代码后要运行检查命令：npm run check
- 回复请用中文
- 不要动 images 文件夹里的文件

效果：每次在这个文件夹里启动 Pi，它会自动读取这份"说明书"， 按你的要求干活。

💡 Pi 会从当前文件夹和所有上级文件夹读取 AGENTS.md， 也可以把通用的要求放在全局：C:\Users\你的用户名\.pi\agent\AGENTS.md

改完后：在 Pi 里输入 /reload 重新加载，不用重启。

9.4 主题（换皮肤）

内置两种主题：dark（深色，默认）、light（浅色）。 在 /settings 里切换即可。

想用别人做的主题？属于进阶玩法（Pi Packages）， 把主题文件放进 C:\Users\你的用户名\.pi\agent\themes\ 文件夹就能用。

9.5 技能（Skills）—— 给 Pi 装"插件"

技能 = 一组预先写好的"操作说明书"，让 Pi 学会做特定的事。 比如装一个"翻译技能"，Pi 就特别擅长翻译。

技能文件长这样（放在 ~/.pi/agent/skills/我的技能/SKILL.md）：

# 翻译技能
当用户要求翻译时使用本技能。

## 步骤
1. 先判断源语言
2. 翻译成目标语言
3. 给出两种译文：直译和润色

使用方式：

• 输入 /skill:技能名字 直接调用

• 或者当你的请求符合技能描述时，Pi 会自动使用

技能是进阶内容，感兴趣的话可以参考官方文档 C:\Users\Administrator\AppData\Roaming\npm\node_modules\@earendil-works\pi-coding-agent\docs\skills.md

9.6 扩展（Extensions）—— 终极改造

扩展 = 用代码写的 Pi 插件，可以给 Pi 加新工具、新命令、新界面。 这需要会编程，小白先不用碰，知道有这个功能就行。

官方扩展文档： C:\Users\Administrator\AppData\Roaming\npm\node_modules\@earendil-works\pi-coding-agent\docs\extensions.md

9.7 网络代理设置（需要"梯子"时用）

如果你访问 AI 服务需要代理，可以在全局设置里加：

{
  "httpProxy": "http://127.0.0.1:7890"
}

（7890 换成你代理软件的端口号）

9.8 隐私相关

Pi 默认会在启动时检查更新、发送一次匿名版本信息。 想完全关闭联网行为，可以设置环境变量（不推荐小白折腾）：

• PI_OFFLINE=1：完全离线模式

• 在设置里把 enableInstallTelemetry 设为 false：关闭遥测

💡 不设置也没关系，这些是正常的软件行为，不泄露你的对话内容。

📌 本篇小结

下一步 → 第 10 篇 · 常见问题解答