@alexgorbatchev/pi-env
从项目配置注入环境变量到Pi进程
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@alexgorbatchev/pi-env。 它的用途是:从项目配置注入环境变量到Pi进程 完整的 Skill 内容见:https://321skill.com/skills/alexgorbatchev-pi-env/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我设置当前项目的API_URL为http://localhost:3000,以及APP_ENV为development',AI会告知你需要在Pi的settings.json中配置@alexgorbatchev/pi-env键下的对应值,然后重启会话即可生效,后续所有子进程都会自动继承这些变量。
介绍
这个Skill解决了在Pi智能体开发中手动管理环境变量繁琐、易丢失的问题。在实际开发中,开发者经常需要为不同项目设置不同的环境变量(如API地址、应用模式),但每次切换项目都要手动export或修改脚本,既低效又容易出错。
使用方式很简单,你只需要在Pi的全局设置(.pi/settings.json)或项目设置中,添加一个JSON配置块,键名固定为”@alexgorbatchev/pi-env”,里面填写你需要的环境变量键值对。之后每次启动Pi会话,这些变量会自动注入到当前进程的process.env中,所有子进程(如bash命令、process服务)都能直接继承使用。你还可以随时通过Pi命令/env查看当前生效的变量。
它非常适合需要频繁切换多个项目环境的后端开发、运维工程师或全栈开发者。尤其是那些已经使用Pi作为智能体平台来管理多个项目的团队,这个扩展能统一环境配置,减少重复劳动。
建议在项目初始化时就统一使用此工具来管理非敏感配置,所有团队成员遵循相同的配置结构。需要注意的是,它目前不支持嵌套对象,键和值都必须是字符串,并且不能存储API密钥、密码等敏感信息,因为配置内容会在Pi UI中明文显示。
常见问题
环境变量在哪里配置?
在Pi的全局设置或项目设置的settings.json文件中,添加键名"@alexgorbatchev/pi-env",值为一个对象,键值对即为环境变量。
安装后如何查看当前生效的环境变量?
在Pi会话中直接输入命令/env,即可打印出所有通过此扩展注入的环境变量。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/alexgorbatchev-pi-env/raw/index.md 读取 @alexgorbatchev/pi-env 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/alexgorbatchev-pi-env/raw/index.md(查看排版版本)