@alexanderfortin/pi-share-opengist
将Pi会话导出为HTML并分享到Opengist
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alexanderfortin/pi-share-opengist。 它的用途是：将Pi会话导出为HTML并分享到Opengist 完整的 Skill 内容见：https://321skill.com/skills/alexanderfortin-pi-share-opengist/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'分享当前会话'，它会自动将Pi当前交互式会话导出为自包含HTML，上传到配置好的Opengist实例，并返回一个链接（如https://gistviewer.l3x.in/#https://opengist.my.domain/gist/abc123），链接默认通过gistviewer渲染为全屏视图，方便直接分享给团队成员查看。
介绍
这个Skill解决了Pi用户无法便捷地分享开发会话给团队的问题。在实际开发中，开发者经常需要将Pi中的交互式开发环境、代码运行结果或数据可视化导出为可独立查看的HTML文件，但依赖GitHub Gist或外部服务会带来隐私和可控性风险。
使用方式很简单，你只需要在Pi环境中安装本扩展，并配置PI_OPENGIST_HOST和PI_OPENGIST_TOKEN两个环境变量指向自托管的Opengist实例。之后在Pi会话中运行/share-og命令，它就会自动将当前会话导出为HTML，上传到Opengist，并返回一个可分享的链接，同时自动复制到剪贴板。
它非常适合需要自托管代码片段分享服务的团队或个人。尤其是那些已经部署了Opengist实例、注重数据隐私、不希望依赖GitHub等第三方服务的开发者，以及需要频繁分享交互式分析结果的数据科学家和AI工程师。
建议在配置时将PI_OPENGIST_USE_INPROCESS设为1以启用内部导出加速。需要注意的是，该扩展完全依赖环境变量无状态运行，token务必妥善保管；同时默认的查看器为gistviewer.l3x.in，如需自建查看器可设置PI_SHARE_VIEWER_URL环境变量。
常见问题
如何获取Opengist的API token？
在Opengist实例中登录后，进入用户设置页面，找到'API tokens'或'Tokens'选项，创建一个新的token并复制。
分享链接打不开怎么办？
首先检查PI_OPENGIST_HOST是否正确配置且Opengist服务可访问，其次确认token具有创建gist的权限，最后检查PI_SHARE_VIEWER_URL是否被错误设置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alexanderfortin-pi-share-opengist/raw/index.md 读取 @alexanderfortin/pi-share-opengist 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alexanderfortin-pi-share-opengist/raw/index.md（查看排版版本）