← ClaudeAtlas

pi-setuplisted

This skill should be used when the user wants to install or configure Pi Agent (@earendil-works/pi-coding-agent) with DeepSeek (built-in), Ant-Ling Ring-2.6-1T (single-model custom provider), and ZenMux (multi-model OpenAI-compatible aggregator including Gemini 3.5 Flash, Claude, GPT), including auth, models.json, settings.json, a curated extension set, and known-pitfall fixes. Triggers on "配置 pi"、"setup pi agent"、"pi 装一下"、"配 ring/deepseek/gemini/zenmux 到 pi".
wquguru/skills · ★ 49 · AI & Automation · score 79
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