pi-setuplisted
Install: claude install-skill wquguru/skills
# Pi Setup
帮用户从零配置 Pi Agent,搭配 DeepSeek V4(内置)+ Ant-Ling Ring-2.6-1T(单模型自定义 provider)+ ZenMux(多模型聚合 provider,含 Gemini 3.5 Flash、Claude、GPT 等),装一套精选扩展,并自动规避 8 个已知坑。
用户输入的参数:$ARGUMENTS
## 核��原则
1. **检测优先**:每一步先探测现状(pi 是否已装、配置是否已存在、密钥在哪个 shell 文件),再决定动作。绝不盲目覆盖用户已有配置——发现已存在就 diff 给用户看,问是否覆盖。
2. **密钥不落明文**:pi 配置里只放 `!shell命令` 惰性读取,密钥留在用户原文件(`~/.deepseek`、shell rc 等)。
3. **交互确认关键选择**:用 AskUserQuestion 收集"启用哪些模型"等决策,不替用户拍板。
4. **环境变量靠检测提醒**:不假设是 `~/.zshrc`,扫所有候选文件 + 当前进程环境,按实际情况给针对性提示。
## 工作流程
### 1. 检测现状
并行跑这些探测,汇总成一张"现状表":
```bash
which pi && pi --version # pi 是否已装、版本
ls -la ~/.pi/agent/ 2>/dev/null # 现有配置文件
cat ~/.pi/agent/settings.json 2>/dev/null # 现有 settings(packages/默认模型)
cat ~/.pi/agent/models.json 2>/dev/null # 现有自定义 provider
echo $SHELL # 用户默认 shell
ls -la ~/.gemini-zenmux* ~/.zenmux 2>/dev/null # ZenMux 密钥文件候选
```
把"已装/未装、哪些配置已存在、默认 shell、ZenMux 密钥文件是否存在"整理给用户,再继续。
### 2. 环境变量检测(不限 ~/.zshrc)
**这是本 skill 的重点。** 不要假设密钥在 `~/.zshrc`。按以下顺序探测每个所需变量(`DEEPSEEK_API_KEY`、`LING_API_KEY`、`ZENMUX_API_KEY`,以及用户额外要的):
```bash
# a) 当前进程环境(最权威——说明已 export 且生效)
printenv DEEPSEEK_API_KEY >/dev/null && echo "DEEPSEEK_API_KEY: in live env"
printenv LING_API_KEY >/dev/null && echo "LING_API_KEY: in live env"
printenv ZENMUX_API_KEY >/dev/null && echo "ZENMUX_API_KEY: in live env"
# b) 独立密钥文件
[ -f ~/.deepseek ] && grep -l DEEPSEEK_API_KEY ~/.deepseek 2>/dev/null
for f in ~/.zenmux ~/.gemini-z