AI Agent 技能：发布到 ShareOne (shareone)

这个 Skill 允许 AI Agent（如 Openclaw 等）将当前生成的历史会话以及 HTML/Markdown/TXT/PDF/PPT 等文件发布到 ShareOne 线上托管服务，并为用户生成一个持久化的公网分享链接。

入口隔离规则

本 skill 和用户本机可能安装的 shareone CLI 是两个独立入口。除非用户明确要求“使用 CLI”或指定执行 shareone ... 命令，否则不要调用系统 PATH 中的 shareone 命令。

使用本 skill 时，所有 ShareOne 操作都必须调用本 skill 目录内的脚本，例如：

node scripts/check_api_key.js
node scripts/upload_page.js <file>
node scripts/shareone_upload.js <file>
node scripts/update_share_settings.js <share_link_or_id>
node scripts/shareone_api_request.js <api_path>

即使 which shareone 能找到 CLI，也不要把自然语言的发布、下载、评论处理任务改走 CLI。

使用说明与触发条件

当用户表达出以下意图时，应主动使用此技能：

• "帮我把 index.html 发布到 ShareOne"
• "把我刚才生成的网页发布，给我个链接"
• "生成一个可分享的链接给我的团队看"
• "Upload this presentation to ShareOne and protect it with password 'secret'"
• "发布这个 PDF 到 ShareOne，并加上密码 1234"
• "把这个网页发布到 ShareOne，加上水印 '内部绝密'"
• "把这个网页发布到 ShareOne，链接叫 product-demo"
• "发布这份设计稿并开启协同评论模式"
• "用 shareone 分享上一轮对话"
• "把我刚才写的代码/大段文字分享出去"
• "Share your last response as a note"
• "帮我下载这个 ShareOne 链接的文件：https://shareone.app/s/xxx"
• "拉取一下这个链接的评论：https://shareone.app/s/xxx"
• "给这个 ShareOne 链接加水印：https://shareone.app/s/xxx"
• "根据这个链接的评论修改页面：https://shareone.app/s/xxx"
• "修改这个 ShareOne 链接的内容：https://shareone.app/s/xxx"

总规则：先路由，再读取子流程

入口文件只负责判断用户意图、判断环境、选择需要阅读的 workflow。不要一次性读取所有 workflows/*.md 文件；只读取当前任务需要的子文件。

所有需要 ShareOne API 的操作，都先运行：

node scripts/check_api_key.js

用输出判断环境与凭据状态：

• SUDOWORK_ENV_OK_KEY_FOUND：当前在 Sudowork 中，Auth Proxy/secrets 环境可用，且 Sudowork 已配置 ShareOne API Key。
• SUDOWORK_ENV_OK_KEY_NOT_FOUND：当前在 Sudowork 中，Auth Proxy/secrets 环境可用，但还没有设置 ShareOne API Key。
• SUDOWORK_ENV_UNAVAILABLE_KEY_FOUND:<api_key>：当前在 Sudowork 中，但 Auth Proxy/secrets 环境不可用；skill 已回退到普通 AI Agent 凭据流程并找到了 API Key。
• SUDOWORK_ENV_UNAVAILABLE_KEY_NOT_FOUND：当前在 Sudowork 中，但 Auth Proxy/secrets 环境不可用；skill 已回退到普通 AI Agent 凭据流程但没有找到 API Key。
• KEY_FOUND:<api_key>：当前是普通 AI Agent 环境，且已找到 API Key。
• KEY_NOT_FOUND：当前是普通 AI Agent 环境，且没有找到 API Key。

术语固定：

• Sudowork：发布、评论、通用请求命令不要传 --api-key，凭证由 Auth Proxy secrets 注入。
• Sudowork fallback：如果检测到 Sudowork 但 Auth Proxy/secrets 接口不可用，后续按普通 AI Agent 方式直连 ShareOne；此时可以使用环境变量 SHAREONE_API_KEY 或 ShareOne skill 安装目录下的本地凭证文件。
• 普通 AI Agent：可以使用 --api-key、环境变量 SHAREONE_API_KEY 或 ShareOne skill 安装目录下的本地凭证文件。
• 本地凭据路径：所有非 Sudowork secrets 的本地凭据都只读写 ShareOne skill 安装目录下的 .shareone_credentials，不读写用户 home。读取、保存和删除使用同一路径，确保不同 Agent/龙虾产品中路径一致。该本地 fallback 不是 Sudowork Secret Store。

操作路由表

根据用户意图读取对应 workflow：

如果用户提供已有 ShareOne 链接、share_id 或自定义短链 slug，并且只要求修改水印、访问密码、自定义短链接或评论开关，必须优先读取 workflows/update-share-settings.md。这是元数据更新，不要按文件类型路由，不要下载源文件，不要使用 upload_page.js，不要重新上传内容。

其他发布任务先按目标文件类型路由，再按用户动作路由。文件类型优先级最高。

| 目标文件/内容类型 | 必须读取的 workflow | | --- | --- | | .ppt、.pptx、.pdf、.doc、.docx、.png、.jpg、.jpeg、.gif、.zip 或其他二进制文件 | workflows/publish-binary-file.md | | .html、.md、.txt、对话内容、大段文本、代码块，或已经包装成 HTML 的内容 | workflows/publish-text-page.md | | 包含图表、流程图、思维导图、时序图、甘特图等可视化内容的 HTML 页面 | workflows/publish-text-page.md（参考其中的 Mermaid.js 章节） |

| 用户意图 | 需要读取的 workflow | | --- | --- | | 已有 ShareOne 链接只修改水印、访问密码、自定义短链接或评论开关 | 先读 workflows/environment-and-credentials.md，再读 workflows/update-share-settings.md，最后读 workflows/result-and-errors.md | | 发布、分享、生成链接、上线、分享上一轮对话、大段文本或代码 | 先读 workflows/environment-and-credentials.md，再按文件类型读 workflows/publish-text-page.md 或 workflows/publish-binary-file.md，最后读 workflows/result-and-errors.md | | 删除、清除、移除、重置 ShareOne API Key | 读 workflows/delete-api-key.md | | 下载 ShareOne 链接的文件或源内容 | 先读 workflows/environment-and-credentials.md，再读 workflows/download-file.md | | 查看、拉取、总结 ShareOne 链接评论，但用户没有要求修改 | 先读 workflows/environment-and-credentials.md，再读 workflows/comments-view.md | | 处理评论、根据评论修改页面、修复 ShareOne 链接内容 | 先读 workflows/environment-and-credentials.md，再读 workflows/comments-process.md，必要时读 workflows/publish-text-page.md，最后读 workflows/result-and-errors.md | | 发布二进制文件，或更新已上传二进制文件的密码/水印 | 先读 workflows/environment-and-credentials.md，再读 workflows/publish-binary-file.md，最后读 workflows/result-and-errors.md |

ShareOne 链接与 share_id

当用户提供 ShareOne 链接时，可以从完整链接、/s/<share_id> 路径、share_id 或自定义短链 slug 中解析目标。下载任意用户允许下载的链接时，优先使用公开下载接口并把原始输入作为 ref。

/s/<share_id> 是最终给用户访问的分享链接，不是上传 API endpoint。不要把 /s/<share_id> 当作发布地址，也不要直接向 /s/<share_id> PUT/POST 文件。

share_id 可用于查看评论、处理评论、owner 下载源文件、文本页面内容 PUT 更新，以及已有链接的密码/水印/短链/评论开关元数据更新。非 owner 下载必须要求链接已开启允许下载；若接口返回 DOWNLOAD_NOT_ALLOWED，直接提示用户让链接 owner 先开启允许下载。

对已有链接只改水印、密码、自定义短链接或评论开关时，使用 update_share_settings.js。/s/<share_id> 和 /md/<share_id> 走页面设置更新；/pdf/<share_id>、/ppt/<share_id> 和 /word/<share_id> 走文件设置更新。裸 share_id 或 slug 由脚本先尝试页面 endpoint，必要时回退文件 endpoint。整个过程不要下载源文件。

如果目标是 .pptx、.ppt、.pdf、Word、图片、zip 等二进制文件，“发布这个文件”默认必须走文件上传 workflow 和 shareone_upload.js。不要因为会话里存在旧的 /s/<share_id> 就改走文本页面 PUT；二进制文件内容上传不能使用 upload_page.js。

如果你在当前会话中已经为同一个文本/HTML 文件生成过 ShareOne 链接，可复用之前的 share_id 执行文本页面 PUT 更新；否则执行首次创建。

不可跳过的阻塞步骤

以下步骤是阻塞性用户通知，不是可选说明。触发后必须先发给用户，再继续后续发布、下载、评论处理或最终回复。

• 如果 create_guest_key.js 输出 GUEST_KEY_CREATED:<api_key>，必须立即向用户发送临时 API Key、绑定账号链接和保存提醒。即使 key 已经自动保存到 Sudowork/Auth Proxy 或本地凭证文件，也不能省略该通知。
• 发送临时 API Key 通知前，不得继续执行原任务的上传、下载、评论处理命令。
• 本会话首次向用户展示生成的 share_url 时，必须按 workflows/result-and-errors.md 提示所有未使用的高级功能：自定义短链接名称、访问密码、水印。
• 如果用户已经使用了自定义短链接、访问密码、水印中的某些能力，只提示剩余未使用的能力；如果三项都已使用，则不提示。

不要遗漏的全局约束

• 发布前必须完成凭据检查和必要的凭据配置。
• 每次发布前都必须展示以下安全提示，并等待用户明确回复“同意”或 agree 后才能继续：

  发布前安全提示：在将页面发布到公网前，请您确认该页面内容符合相关法律法规要求。禁止发布反动、涉政、暴力、色情、侵权或恶意代码。上传的内容将免费托管保留 90 天。 如果您的内容符合要求，请回复“同意”，我将为您发布。

• 发布成功后必须直接使用接口或脚本返回的 share_url，不要自行拼接分享链接；如果返回中包含 backend_url，必须同时作为“备用链接”展示给用户。
• 如果用户要求开启评论、允许讨论或协同模式，才添加 --allow-comments true。默认不开启评论。
• 自定义短链接（slug）：服务端会根据文件名自动生成可读的 slug（如 quarterly-report），客户端无需额外操作。如果用户明确要求”链接叫 xxx”、”自定义短链接 xxx”、”URL 后缀 xxx”，发布命令添加 --slug xxx 覆盖自动生成；slug 冲突时把服务端提示反馈给用户，不要静默改名。
• 评论处理必须形成闭环：认领、修改、重新发布、回复、关闭或 dismiss。

最终回复前检查清单

在回复用户前，逐项检查：

• 如果本轮创建了临时 API Key，是否已经把 API Key、绑定账号链接和保存提醒发给用户。
• 如果本轮发布内容，是否已经完成凭据检查，并在执行发布命令前获得用户明确回复“同意”或 agree。
• 如果发布成功，是否直接展示返回的 share_url，没有自行拼接链接。
• 如果返回中包含 backend_url，是否作为备用链接展示给用户。
• 如果返回中包含 custom_slug_warning 或 custom_slug_suggestions，是否展示给用户。
• 如果这是本会话首次展示生成的 share_url，是否提示所有未使用的高级功能。