用途
PinMe Share 用于把静态成果打包成一个精致的分享页面,并通过 PinMe 上传,最终返回可访问的 URL。当用户提出以下需求时适用:
- 使用 PinMe 分享或发布结果。
- 创建一个静态页面,用于包装已部署的项目链接、演示、报告或成果。
- 总结一段 Codex 对话/会话并分享为页面。
- 将项目交接整理成公开的落地页或摘要页。
- 上传已有的静态文件或文件夹,用于轻量分发。
如果用户需要后端、数据库、认证、邮件或 LLM 功能,应先用主 pinme 技能及相关的 PinMe 集成技能,最后再用 pinme-share 打包并发布结果。
主要能力
- 生成静态分享产物,优先使用单个自包含的 index.html。
- 默认在当前工作区使用 share/<slug>/index.html,除非仓库已有既定的输出/分享约定。
- CSS 内联以保持可移植性;除非交互确有价值,否则不依赖 JavaScript。
- 发布前进行清理:移除密钥、令牌、API key、.env 值、仅内部使用的 URL、私有用户数据及无关日志。
- 对于对话摘要,默认进行概括而非直接倾倒原始记录,除非用户明确要求逐字分享。
- 确保链接明确且可点击。
- 使用 PinMe 上传并返回 URL。
使用方式
核心工作流:
-
识别分享对象:
- PinMe/全栈项目:已部署 URL、简短描述、关键功能、技术栈、使用说明。
- Codex 对话:目标、决策、实现摘要、重要输出、后续步骤。
- 静态文件/报告/演示:标题、目的、文件内容或预览、给接收者的背景信息。
-
创建静态分享产物:
- 优先单个自包含的 index.html。
- 使用 share/<slug>/index.html,除非仓库已有约定。
- CSS 内联,保持可移植。
- 除非交互有价值,否则不要求 JavaScript。
-
发布前清理:
- 移除密钥、令牌、API key、.env 值、仅内部 URL、私有用户数据、无关日志。
- 对话摘要默认概括,不倾倒原始记录,除非用户明确要求逐字分享。
- 链接明确且可点击。
-
使用 PinMe 上传:
pinme upload share/<slug>返回 PinMe 打印的 URL。如果 PinMe 输出多个 URL,优先顺序为:DNS 域名、PinMe 子域名、短 URL、完整预览 URL。绝不截断 hash 片段。
上传前检查:
pinme --version
如果 PinMe 缺失或版本过旧,按主 pinme 技能安装或更新。上传需要认证:
pinme login
# 或:pinme set-appkey <AppKey>
上传示例:
pinme upload share/my-project
pinme upload share/conversation-summary
pinme upload ./report.html
pinme upload ./dist
不要上传:
- .env、.git、node_modules、源码树、私有数据集、含凭据的原始日志、无关构建缓存。
- 可能包含密钥或私有上下文的原始对话记录,除非用户明确批准确切内容。
分享页内容
项目分享页应包含:
- 项目名称和一句话描述。
- 主要启动/演示链接作为第一个操作。
- 它做什么、面向谁、为什么重要。
- 聚焦用户可见行为的功能列表。
- 仅在对接接收者有用时提供构建/部署细节。
- 日期和来源信息,如“Created with Codex”,仅在合适时添加。
对话分享页应包含:
- 对话标题。
- 初始目标或问题。
- 关键上下文和约束。
- 做出的决策。
- 已完成的工作或答案摘要。
- 相关时列出更改的文件、运行的命令、产生的链接或创建的产物。
- 后续事项。
文件/报告分享页应包含:
- 清晰的标题和简短摘要。
- 如果存在单独文件,提供下载/打开链接。
- 重要摘录或生成的摘要。
- 来源/背景说明。
HTML 指南
- 构建真实的分享页,而非通用占位符。
- 让最重要的链接在首屏可见。
- 使用干净、响应式的 HTML/CSS,可作为独立静态文件运行。
- 设计克制、可读;技术交接避免过度装饰的营销布局。
- 使用语义化区块、可访问的对比度、描述性链接文本、合理的移动端间距。
- 将用户提供的文本插入 HTML 前进行转义。
- 展示代码或命令输出时,用 <pre><code> 包裹并保持简短。
适用场景
- 分享或发布 PinMe 项目、演示、报告或成果。
- 将 Codex 对话/会话总结为可分享页面。
- 将项目交接整理为公开落地页或摘要页。
- 上传已有静态文件或文件夹进行轻量分发。
限制
- 仅处理静态分享产物;若需要后端、数据库、认证、邮件或 LLM 功能,需先使用主 pinme 技能及相关集成技能。
- 上传需要 PinMe 已安装并完成认证(pinme login 或 pinme set-appkey <AppKey>)。
- 不得上传 .env、.git、node_modules、源码树、私有数据集、含凭据的原始日志、无关构建缓存,以及未经用户明确批准的原始对话记录。
- 发布前必须清理密钥、令牌、API key、.env 值、仅内部 URL、私有用户数据及无关日志。
- 关于具体收费、价格、平台支持范围等信息,资料中暂未提供。
最终响应
告知用户:
- 创建了什么分享产物。
- 上传返回的 PinMe URL。
- 任何重要注意事项,例如因 PinMe 未认证或不可用而跳过上传。
保持响应简短,URL 是主要交付物。