SuperAPI AI 工具集

pinme-share

通用与其它

查看项目

更新于 10-15 16:04

技能介绍

用途

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。

使用方式

核心工作流:

  1. 识别分享对象:

    • PinMe/全栈项目:已部署 URL、简短描述、关键功能、技术栈、使用说明。
    • Codex 对话:目标、决策、实现摘要、重要输出、后续步骤。
    • 静态文件/报告/演示:标题、目的、文件内容或预览、给接收者的背景信息。
  2. 创建静态分享产物:

    • 优先单个自包含的 index.html。
    • 使用 share/<slug>/index.html,除非仓库已有约定。
    • CSS 内联,保持可移植。
    • 除非交互有价值,否则不要求 JavaScript。
  3. 发布前清理:

    • 移除密钥、令牌、API key、.env 值、仅内部 URL、私有用户数据、无关日志。
    • 对话摘要默认概括,不倾倒原始记录,除非用户明确要求逐字分享。
    • 链接明确且可点击。
  4. 使用 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 是主要交付物。