技能使用指南

ShareOneSkill 用法详解

ShareOneSkillshareone
18 个章节 约 19 分钟阅读 AI 智能生成

ShareOneSkill:把 AI 生成的页面与文档,一键变成可分享的公网短链接

  • 技能定位:这是一个让 AI Agent 直接把会话中生成的 HTML 页面、Markdown、TXT、PDF、PPT、Word 文件发布到 ShareOne 线上托管服务,并返回一个持久化公网分享链接的技能。
  • 不只是"发个链接":除发布外,还覆盖访问密码、水印、协同评论、允许下载、内容更新、自定义短链接等一整套分享治理能力。
  • 反向操作也支持:可以下载已有链路文件、拉取并处理评论、按评论修改后重新发布,形成闭环。
  • 有明确的安全与合规约束:创建新分享链接前必须获得用户"同意",内容免费托管保留 90 天,评论默认关闭。
  • 上手门槛低:不需要自己找服务器、配对象存储、写上传脚本,只要一句话表达意图,Agent 按技能内置的路由规则自动选择正确流程。

1. 该技能叫什么?如何一键安装 AI 技能提升开发效率?

技能基本信息

项目 内容
技能中文名 ShareOneSkill
技能英文名 shareone
技能 ID 14273
版本 1.2.5
许可协议 MIT
一句话概括 托管 HTML 页面,并以短链接分享 PDF、Word、PowerPoint 文档

它解决什么问题?

在没有这类技能之前,AI 帮你写好的落地页、报告、方案、演示文稿,通常只躺在会话记录或本地文件夹里。要发给同事或客户,你得自己:找一台服务器或静态托管平台、注册账号、上传文件、配置访问权限、再复制一个超长 URL 贴到群里。整个过程与"让 AI 帮我提效"的初衷背道而驰。

ShareOneSkill 把这套流程压缩成一句话:你说"把这个页面发布出去,给团队看",Agent 就会完成凭据确认、内容上传、短链生成,并把最终链接直接返回给你。

一键安装的思路与步骤

  1. 确认安装前提:本技能通过 node scripts/*.js 脚本与 ShareOne 服务交互,因此运行环境需要具备 Node.js,并且 AI Agent 具备在本地执行命令、读写文件的能力。同时要确保技能目录已完整落盘(包含 SKILL.md、scripts/、workflows/)。
  2. 完成技能安装:将 shareone 技能安装或放置到你所使用的 AI 客户端的技能安装目录中(不同客户端的具体安装入口与命令以官方说明为准)。安装完成后,技能会被识别为一个可被自然语言触发的 Skill。
  3. 注意脚本路径基准:这是最容易踩坑的一点——文档中所有 node scripts/xxx.js 命令都以本 skill 的安装目录为基准,而当前工作目录通常是你的项目目录。因此执行时要使用绝对路径,或先 cd 到技能目录,例如 node /path/to/shareone-skill/scripts/ensure_credentials.js。
  4. 验证是否生效:运行凭据检查脚本 node scripts/ensure_credentials.js。脚本会输出 token 状态,其含义与后续处理流程由技能内的 workflows/environment-and-credentials.md 说明。若没有凭据,可使用 --create-guest 参数创建访客凭据。
  5. 做一次最小验证:对一个 .html 或 .md 文件说出"发布到 ShareOne,给我一个链接",观察 Agent 是否正确走完凭据检查、安全确认、发布、返回 share_url 四步。

一个重要的入口隔离规则:如果你的电脑上还装过独立的 shareone 命令行工具,请注意这两者是互相独立的入口。除非你明确要求"使用 CLI"或指定 shareone ... 命令,否则所有发布、下载、评论处理任务都应走技能目录内 scripts/ 下的脚本,而不是系统 PATH 里的 CLI。

2. 该技能的主要功能和特点

核心能力

  • 页面发布:把 .html、.md、.txt 文件,甚至是上一轮对话内容、大段文本、代码块,发布成公网可访问的页面,得到形如 https://s.shareone.vip/s/xxx 的分享链接。
  • 二进制文档分享:支持 .pdf、.ppt、.pptx、.doc、.docx 直传,走独立的二进制通道,不经过文本页面通道。
  • 访问密码保护:为分享链接设置访问密码,适合内部资料、客户方案等敏感内容。
  • 水印:给页面或文档加上水印文字(如"内部绝密"),降低截图外传的风险。
  • 协同评论:按需开启评论模式,让接收方直接在分享页上留意见。
  • 下载控制:控制链接是否允许被下载,非 owner 下载要求链接已开启允许下载,否则脚本会返回 ERROR:DOWNLOAD_NOT_ALLOWED。
  • 内容更新:已有链接可以复用原 share_id 直接更新内容,链接地址不变,避免"发了新版又要重新发一遍链接"。
  • 元数据修改:只改密码、水印、自定义短链接、评论开关时,走元数据更新通道,不下载源文件、不重新上传内容——对二进制文件链接同样适用。
  • 下载与评论处理闭环:下载他人分享的文件、拉取评论、按评论修改页面、重新发布、回复或关闭评论。

和普通工具比,强在哪?

  • 意图驱动,而非命令驱动:技能内置了严格的"路由判定顺序",从"删除 API Key"“元数据更新”“下载文件”“查看评论”“处理评论”"发布内容"六类意图自上而下判断,命中即停。用户不需要知道该调用哪个脚本,Agent 自己会选。
  • 自动分发通道:内容发布统一走 publish.js,脚本按文件类型自动分发到文本通道或二进制直传通道(stderr 输出 INFO:CHANNEL:text|binary),不需要也不应该手动选择底层上传脚本。
  • 智能短链:服务端会根据文件名自动生成可读 slug(如 quarterly-report),无需额外操作;只有你明确要求"链接叫 xxx"时才用 --slug 覆盖。slug 冲突时会把服务端提示如实反馈,不会静默改名。
  • 内置合规与阻塞式提醒:首次创建分享链接前必须展示安全提示并等待"同意";创建临时 API Key 时必须立即把 Key、绑定账号链接和保存提醒发给用户,不能省略。

3. 如何使用该技能?

第一步:表达意图,让技能被触发

下面这些说法都会命中该技能:

  • “帮我把 index.html 发布到 ShareOne”
  • “把我刚才生成的网页发布,给我个链接”
  • “发布这个 PDF 到 ShareOne,并加上密码 1234”
  • “把这个网页发布到 ShareOne,加上水印 ‘内部绝密’”
  • “把这个网页发布到 ShareOne,链接叫 product-demo”
  • “发布这份设计稿并开启协同评论模式”
  • “用 shareone 分享上一轮对话”
  • “帮我下载这个 ShareOne 链接的文件:https://s.shareone.vip/s/xxx”
  • “拉取一下这个链接的评论:https://s.shareone.vip/s/xxx”

第二步:凭据检查

所有需要调用 ShareOne API 的操作(元数据更新、下载、评论处理、发布),都会先运行:

node scripts/ensure_credentials.js

若当前没有可用凭据,可用 --create-guest 创建访客凭据。此时若输出 GUEST_KEY_CREATED:<api_key>,Agent 必须立即把临时 API Key、绑定账号链接和保存提醒发给你——这是一步阻塞性通知,不会跳过。

第三步:发布前的安全确认

每次创建新分享链接前,你会看到如下提示,需要回复"同意"或 agree 才会继续:

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

注意:对已确认过的同一链接做内容更新、评论闭环中的重新发布、水印/密码/短链/评论开关等修改时,不会重复弹提示。下载、查看评论、删除 API Key 等不发布内容的操作也不需要确认。

第四步:执行发布

文本类内容(.html、.md、.txt、对话内容、大段文本、代码块)与二进制文件(.pdf、.ppt、.pptx、.doc、.docx)都统一通过 publish.js 发布,脚本自动选通道。常用附加参数示例:

  • 自定义短链接:node scripts/publish.js <文件路径> --slug product-demo
  • 开启评论:node scripts/publish.js <文件路径> --allow-comments true
  • 更新已有文本页面:复用之前的 share_id 执行 PUT 更新

关于密码、水印等参数的具体写法,以及 update_share_settings.js 的完整参数列表,请以技能目录内 workflows/publish-text-page.md、workflows/publish-binary-file.md、workflows/update-share-settings.md 的说明为准。

有个细节值得记住:.md / .txt 一律按原格式发布,不会因为内容里有图表就擅自转成 HTML;只有目标本来就是 HTML 页面时,才会参考 Mermaid.js 相关内容。

第五步:读取结果

发布成功后,直接使用脚本返回的 share_url 即可,不要自行拼接分享链接,也不要展示备用链接。如果返回中包含 custom_slug_warning 或 custom_slug_suggestions,Agent 会一并展示给你。

另外,本会话首次展示生成的 share_url 时,会提示你三项尚未使用的高级功能:自定义短链接名称、访问密码、水印;三项都已使用则不再提示。

第六步:后续维护

  • 只改密码/水印/短链/评论开关:走元数据更新,不重新上传内容。
  • 改内容:复用 share_id 更新。
  • 处理评论:认领 → 修改 → 重新发布 → 回复 → 关闭或 dismiss,形成完整闭环。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
ShareOneSkill(本技能) AI Agent 原生的页面托管与文档分享技能 HTML/Markdown/TXT 页面发布、PDF/PPT/Word 短链分享、密码、水印、评论、下载控制、内容更新 安装技能 + Node.js 环境;用自然语言触发,无需记命令 AI 会话产物快速外发、内部评审、客户交付 优势:零部署、意图驱动、发布与治理一体化、支持反向下载与评论闭环;不足:依赖 ShareOne 服务,免费托管保留 90 天,需 API 凭据
手动部署静态托管平台(如各类静态站点托管服务) 面向开发者的静态网站部署 托管 HTML/JS/CSS,绑定自定义域名 需要注册账号、连接代码仓库或执行部署命令、配置构建设置 长期维护的正式站点、产品官网 优势:可绑域名、生态成熟;不足:流程重、不适合一次性分享,PDF/PPT/Word 文档不是其强项,无水印/评论等分享治理能力
通用网盘 / 文件中转服务 文件存储与传输 上传任意文件、生成下载链接、设置提取码 需注册、手动上传、部分限速 大文件传输、归档 优势:通用性强、容量大;不足:网页不能直接在线渲染成页面,分享体验偏"下载"而非"浏览",评论与内容更新能力弱
在线文档协作平台 文档创作与协作 富文本编辑、多人协作、评论、权限 需登录客户端或网页,文档需在平台内重新录入 团队长期协作的文档 优势:协作体验成熟;不足:AI 生成的 HTML 页面无法直接托管,需先转换格式;发布二进制原件的还原度有限
本机 shareone CLI 命令行入口 与技能能力相近,但以命令行方式调用 需自行安装并记忆参数 脚本化、批处理场景 优势:适合自动化流水线;不足:与自然语言工作流割裂,技能文档明确要求默认不走 CLI 入口,以免混淆

选择建议:如果目标是"把 AI 刚生成的东西在 30 秒内发出去给具体的人看",ShareOneSkill 的路径最短;如果是需要长期运营的正式站点,仍建议使用专业静态托管;如果是超大文件归档,网盘更合适。

5. 该技能的典型应用场景与实际体验情况

场景一:前端/产品经理的交互稿快速外发

  • 角色与痛点:产品经理让 AI 生成了一版活动落地页 HTML,需要立刻发给市场同事和外部合作方看效果;用邮件发 HTML 附件对方打不开,自己部署又来不及。
  • 使用方式:直接说"把这个网页发布到 ShareOne,加上水印 ‘内部预览’,链接叫 campaign-demo",Agent 完成凭据检查、安全确认、发布,返回 https://s.shareone.vip/s/xxx。
  • 实际体验:链路在对话内闭环,不用切换工具。水印与自定义 slug 让对外链接看起来更正式。需要注意的是首次发布必须回复"同意",以及 slug 若已被占用会收到服务端提示,需要换个名字。

场景二:咨询/售前交付方案文档

  • 角色与痛点:顾问需要把一份 PDF 方案发给客户,既要防止二次转发扩散,又希望客户能在页面上留意见。
  • 使用方式:“发布这个 PDF 到 ShareOne,并加上密码,同时开启协同评论”。PDF 走二进制通道直传,密码限制访问范围,评论开启后客户可直接在页面上反馈。
  • 实际体验:评论默认是关闭的,只有明确要求才加 --allow-comments true,这一点对"不想被乱评论"的场景很友好。之后根据评论修改内容时,可以复用同一个 share_id 更新,链接不变,客户收藏的地址不会失效。

场景三:开发者的代码与对话片段分享

  • 角色与痛点:调试时 AI 给出了一大段可运行的 HTML 或一段长配置,贴进聊天软件会被截断、格式全乱。
  • 使用方式:“把我刚才写的代码分享出去"或"用 shareone 分享上一轮对话”。技能会把对话内容或代码块包装成页面发布。
  • 实际体验:对 .md / .txt 会按原格式发布,不会画蛇添足转成 HTML,保留了原始可读性。缺点是内容一旦公开发布就脱离本地控制,涉及密钥、内网地址的片段必须先自行清理。

场景四:设计评审的评论闭环

  • 角色与痛点:设计师把设计稿页面分享给团队后,收到一堆散落在各处的意见,需要逐条对照修改。
  • 使用方式:“拉取一下这个链接的评论”,Agent 走公开接口读取评论;再"根据这个链接的评论修改页面",完成认领、修改、重新发布、回复、关闭的闭环。
  • 实际体验:查看评论走公开接口,无需凭据,非常轻量;但处理评论需要凭据和 owner 权限,且必须完成完整闭环,不能只改不回复。如果链接未开启允许下载,非 owner 下载会返回 ERROR:DOWNLOAD_NOT_ALLOWED,此时需要提示 owner 先打开下载开关。

整体上手难度:低。用户侧只需要用自然语言表达意图,复杂的分支判断由技能内置的路由规则承担。真正的注意点集中在三处——脚本路径基准、首次发布的安全确认、以及不要绕过技能去调用本机 CLI。

6. 该技能能为用户带来的价值

  • 把"发布"从十分钟压缩到一句话:传统路径需要注册平台、上传文件、配权限、复制链接,多个工具来回切换;现在是一句自然语言 + 一次"同意",中间环节由 Agent 承接。
  • 降低非技术用户的门槛:产品、运营、咨询顾问不需要懂静态托管、对象存储、CDN,也能获得一个可对外访问的短链接;同时不必记住任何上传命令。
  • 分享治理一次到位:密码、水印、评论开关、下载控制、自定义短链,这些原本要在多个后台页面里分别配置的能力,被收敛到同一套发布流程里,避免"先发出去再补权限"的安全事故。
  • 链接稳定,减少重复沟通:复用 share_id 更新内容,地址不变,历史群聊里发过的链接永远指向最新版本,省掉"以最新版为准"的反复澄清。
  • 合规与安全前置:创建新链接前的强制安全确认、临时 Key 的必须通知、评论默认关闭,把容易出事的环节做成了不可跳过的阻塞步骤,降低团队协作中的合规风险。
  • 长期价值:一旦形成"生成即分享"的习惯,AI 产出的中间稿、评审稿、交付稿都能快速流转到真实的人面前,AI 提效的收益才真正兑现,而不是停留在会话窗口里。

7. 常见问题 FAQ

Q1:怎么安装这个技能?需要自己配服务器吗?

不需要服务器。把 shareone 技能安装到你所使用的 AI 客户端的技能目录即可,具体安装入口与命令以官方说明为准。安装后需要保证运行环境具备 Node.js,并注意所有脚本命令都以技能安装目录为基准执行,建议用绝对路径或先 cd 到技能目录。

Q2:这个技能收费吗?内容会保存多久?

技能本身以 MIT 协议开源分发。发布到 ShareOne 的内容按技能内安全提示的说明,是免费托管保留 90 天。如果涉及账号、额度或商业方案等具体政策,以 ShareOne 官方说明为准。

Q3:为什么我电脑上装了 shareone 命令,Agent 却不用它?

因为技能与本机 CLI 是两个独立入口。除非你明确说"使用 CLI"或指定 shareone ... 命令,否则技能会一律调用自身目录 scripts/ 下的脚本,即使 which shareone 能找到 CLI 也不会改走命令行。这是为了避免两套入口行为不一致导致的意外。

Q4:发布时为什么必须回复"同意"?每次都弹吗?

安全提示只在本会话内每次创建新分享链接时出现,用于确认内容符合法律法规、不包含违规或恶意代码。对已经确认过的同一链接做内容更新、改密码/水印/短链/评论开关,或者处理评论后的重新发布,都不会重复弹出。下载、查看评论、删除 API Key 这类不发布内容的操作也不需要确认。

Q5:它和网盘、静态托管平台怎么选?

看你分享的是"要在线浏览的页面"还是"要下载的文件",以及是否一个人快速完成。ShareOneSkill 的优势是 AI 原生、意图驱动、发布与权限治理一体,适合会话产物即时外发与评审;静态托管适合需要绑域名、长期运营的正式站点;网盘适合大文件归档传输。三者并不冲突,可以按场景组合使用。