@moejay/pi-state-sync
Git驱动的Pi配置同步，dotenvx加密密钥保护
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@moejay/pi-state-sync。 它的用途是：Git驱动的Pi配置同步，dotenvx加密密钥保护 完整的 Skill 内容见：https://321skill.com/skills/moejay-pi-state-sync/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用@moejay/pi-state-sync同步当前Pi的环境配置，并加密存储密钥'，它会自动扫描当前目录下的.env文件，生成加密后的.env.encrypted文件，然后推送到Git远程仓库，之后在其他Pi上拉取即可自动解密恢复配置。
介绍
这个Skill解决的是树莓派（Pi）设备上环境配置同步的痛点。当你在多台Pi或同一台Pi的不同环境下需要保持配置一致，同时又要防止密钥、API Token等敏感信息泄露时，@moejay/pi-state-sync提供了基于Git的版本化同步方案，并通过dotenvx加密机制确保敏感数据安全存储。
使用方式非常简单：首先通过npm安装该包，然后在项目根目录下创建.env.encrypted文件（dotenvx加密格式），运行提供的CLI命令即可将配置推送到Git仓库或从仓库拉取。它自动处理加密和解密，你只需管理好加密密钥（比如通过环境变量传递）。同步过程保持Git历史，方便回滚和审计。
这个工具最适合运维工程师、后端开发者和全栈开发者，尤其是那些管理多个树莓派设备（如IoT集群、家庭服务器、开发板）的用户。如果你需要批量同步Nginx、Docker、系统服务等配置文件，或者想安全地在团队间共享Pi设备的环境变量，它就是理想选择。
建议在使用前确保目标Pi已安装Git和Node.js，并提前设置好dotenvx的加密密钥（如通过环境变量DOTENV_KEY）。注意不要将加密密钥本身提交到Git仓库，建议通过密钥管理服务或安全信道分发。另外，该工具侧重于配置同步，不适合用作实时文件同步或大规模集群配置管理。
核心特点
与常规的dotenv同步工具相比，它专门针对Pi设备优化，使用Git作为后端支持版本管理和回滚，并通过dotenvx加密（而非明文存储）保护敏感配置，特别适合树莓派场景下的安全配置分发。
注意事项
不适合需要实时/双向同步的场景，也不适用于非Pi的通用Linux环境（虽然理论可用，但未针对性优化）。
常见问题
如何安装@moejay/pi-state-sync？
在树莓派终端执行 npm install @moejay/pi-state-sync 即可。
加密密钥如何设置？
通过环境变量 DOTENV_KEY 传入，dotenvx会自动使用该密钥加解密.env.encrypted文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/moejay-pi-state-sync/raw/index.md 读取 @moejay/pi-state-sync 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/moejay-pi-state-sync/raw/index.md（查看排版版本）