pinme-share

PinMe 分享

创建精美的静态分享内容，使用 pinme upload 上传，并返回最终 URL。

适用场景

当用户要求以下操作时，使用此技能：

• 使用 PinMe 分享或发布结果。
• 创建静态页面，用于展示已部署的项目链接、演示、报告或内容。
• 总结 Codex 对话／会话，并将其作为页面分享。
• 将项目交接内容制作成公开的着陆页或摘要页。
• 上传现有静态文件或文件夹，以便轻量分发。

如果用户需要后端、数据库、身份验证、电子邮件或大模型功能，请先使用主 pinme 技能和任何相关的 PinMe 集成技能。最后使用 pinme-share 打包并发布结果。

核心工作流

1. 确定要分享的内容：
   • PinMe／全栈项目：已部署的 URL、简短描述、主要功能、技术栈、使用说明。
   • Codex 对话：目标、决策、实现摘要、重要产出、后续步骤。
   • 静态文件／报告／演示：标题、用途、文件内容或预览，以及收件人所需的背景信息。
2. 创建静态分享内容：
   • 优先使用独立的 index.html。
   • 除非仓库已有输出／分享惯例，否则在当前工作区中使用 share/<slug>/index.html。
   • 将 CSS 内嵌，以便于移植。
   • 除非交互体验能带来价值，否则不要依赖 JavaScript。
3. 发布前进行清理：
   • 删除机密、令牌、API 密钥、.env 值、仅供内部使用的 URL、用户私密数据和无关日志。
   • 对话摘要应进行概括，而不是直接倾倒原始记录，除非用户明确要求逐字分享。
   • 明确展示链接，并确保链接可点击。
4. 使用 PinMe 上传：

   pinme upload share/<slug>
   

5. 返回 PinMe 输出的 URL。如果 PinMe 输出多个 URL，优先选择 DNS 域名，其次是 PinMe 子域名、短 URL，最后是完整预览 URL。绝不要截断哈希片段。

分享页面内容

项目分享页面应包含：

• 项目名称和一句话描述。
• 作为首个操作的主要启动／演示链接。
• 项目的功能、适用对象及其重要性。
• 聚焦于用户可见行为的功能列表。
• 仅在对收件人有用时，提供构建／部署详情。
• 日期和来源信息，例如仅在合适时注明“使用 Codex 创建”。

对话分享页面应包含：

• 对话标题。
• 初始目标或问题。
• 关键背景和限制条件。
• 做出的决策。
• 已完成的工作或答案摘要。
• 相关时的已修改文件、已运行命令、生成的链接或创建的内容。
• 后续事项。

文件／报告分享页面应包含：

• 清晰的标题和简短摘要。
• 如果有单独的文件，提供已上传内容的下载／打开链接。
• 重要摘录或生成的摘要。
• 来源／背景说明。

HTML 指南

• 创建真正的分享页面，而不是通用占位内容。
• 最重要的链接应在首屏清晰可见。
• 使用简洁、响应式的 HTML／CSS，使其可作为独立静态文件运行。
• 设计应克制且易读；技术交接内容应避免过度装饰的营销式布局。
• 使用语义化区块、满足无障碍要求的对比度、描述性链接文本，以及合理的移动端间距。
• 将用户提供的文本插入 HTML 前先进行转义。
• 如需展示代码或命令输出，请用 <pre><code> 包裹，并保持简短。

PinMe 上传检查清单

上传前：

pinme --version

如果缺少 PinMe 或其版本过旧，请按照主 pinme 技能安装或更新。上传需要身份验证：

pinme login
# or: 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、源代码目录、私有数据集、包含凭据的原始日志或无关的构建缓存。
• 可能包含机密或私密背景信息的原始对话记录，除非用户明确批准要分享的确切内容。

最终回复

告诉用户：

• 创建了什么分享内容。
• 上传后返回的 PinMe URL。
• 任何重要注意事项，例如因 PinMe 未通过身份验证或不可用而跳过上传。

回复应简短。URL 是主要交付内容。