pi-p2p-sync

基于SSH跨机器同步Pi Agent配置的独立CLI工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-p2p-sync。
它的用途是:基于SSH跨机器同步Pi Agent配置的独立CLI工具
完整的 Skill 内容见:https://321skill.com/skills/pi-p2p-sync/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我用pi-p2p-sync把192.168.1.100上的Pi Agent配置同步到本地',它会生成对应CLI命令,提示你确认SSH连接参数后执行同步。

对AI说:'我要把云服务器上的Pi配置拉到本地办公机,怎么操作',它会给出完整命令示例,同时提醒你备份本地配置、检查SSH连通性。

介绍

在多台设备上部署或使用Pi Agent时,手动同步配置不仅操作繁琐,还容易出现参数遗漏、版本不一致的问题,跨机器拷贝配置文件也常遇到权限不足、路径不匹配等阻碍,大幅降低多机使用效率。 它是一款轻量化独立命令行工具,基于SSH协议实现点对点配置拉取,无需额外部署服务端组件。用户通过npm安装完成后,只需指定目标可达机器的SSH地址、访问凭证等参数,即可一键将远端的Pi Agent配置拉取到本地机器。 适合需要在多台设备(本地主机、云服务器、办公/家用设备等)上使用Pi Agent的开发者、运维人员,以及需要批量统一多节点Pi Agent配置的技术团队。 使用前请确保两台机器网络连通,且本地拥有目标机器的SSH访问权限;建议同步前备份本地原有Pi Agent配置,避免拉取操作覆盖自定义配置导致使用异常。

核心特点

不同于通用文件同步工具,它专门针对Pi Agent配置设计,无需依赖第三方服务或云存储,直接基于SSH实现点对点轻量化拉取。

注意事项

仅支持同步Pi Agent的相关配置,无法用于其他类型应用的配置同步,且要求两台机器网络可达并具备SSH访问权限。

常见问题

pi-p2p-sync同步时会覆盖本地已有配置吗?

默认会覆盖本地对应路径的Pi Agent配置,建议同步前提前备份本地原有配置。

使用pi-p2p-sync需要在目标机器安装额外服务吗?

不需要,仅需目标机器开启SSH服务且存放有可访问的Pi Agent配置文件即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-p2p-sync/raw/index.md 读取 pi-p2p-sync 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。