pi-bridge
通过SSH实现远程机器透明访问本地文件系统
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-bridge。 它的用途是：通过SSH实现远程机器透明访问本地文件系统 完整的 Skill 内容见：https://321skill.com/skills/pi-bridge/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我需要在本机写代码，但用远程GPU服务器运行模型训练，怎么无缝衔接？’ 它会建议你使用 pi-bridge，先在本机启动服务，然后SSH到服务器，这样服务器上的Python脚本就能直接读取并处理你本地笔记本中的数据集和代码了。
介绍
pi-bridge 解决了开发者在远程服务器上工作时，无法像在本地一样便捷地使用本地文件系统中的代码、配置和数据的问题。它通过在本地和远程机器之间建立一个透明的文件系统桥接，使得远程机器上的进程（如编辑器、构建工具）可以直接读写本地文件，而无需手动同步或传输文件。
使用方式非常直接：通过npm全局安装后，在本地运行一条命令即可启动桥接服务。随后，通过SSH连接到配置好的远程机器，远程环境就能像访问本地磁盘一样访问你本机的指定目录，所有文件操作都是实时且透明的。
这个工具非常适合需要在远程高性能服务器、云实例或容器中进行开发，但又希望编辑和调试本地代码库的开发者。例如，使用本地IDE进行代码编写，而构建、测试或运行则放在远程的强大硬件上执行。
使用建议是，确保本地与远程之间的网络连接稳定且延迟较低，以获得最佳体验。注意事项包括，对于涉及大量小文件频繁读写的操作，可能会受网络影响；同时，需妥善管理SSH密钥和权限，仅桥接必要的目录以保证安全。
核心特点
与传统的文件同步工具（如rsync）或远程挂载方案（如sshfs）不同，pi-bridge 提供的是应用层的透明代理，无需在远程端预先安装或配置复杂的文件系统客户端，实现了更低侵入性的原生集成体验。
注意事项
不适合对文件I/O延迟极其敏感或本地与远程网络连接不稳定的场景。
常见问题
pi-bridge 和 sshfs 有什么区别？
pi-bridge 在应用层工作，无需内核模块，配置更简单；sshfs 是文件系统级别的挂载。
支持Windows系统吗？
主要面向类Unix环境（如macOS, Linux），Windows支持可能有限。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-bridge/raw/index.md 读取 pi-bridge 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-bridge/raw/index.md（查看排版版本）