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 就会完成凭据确认、内容上传、短链生成,并把最终链接直接返回给你。
一键安装的思路与步骤
- 确认安装前提:本技能通过
node scripts/*.js脚本与 ShareOne 服务交互,因此运行环境需要具备 Node.js,并且 AI Agent 具备在本地执行命令、读写文件的能力。同时要确保技能目录已完整落盘(包含SKILL.md、scripts/、workflows/)。 - 完成技能安装:将 shareone 技能安装或放置到你所使用的 AI 客户端的技能安装目录中(不同客户端的具体安装入口与命令以官方说明为准)。安装完成后,技能会被识别为一个可被自然语言触发的 Skill。
- 注意脚本路径基准:这是最容易踩坑的一点——文档中所有
node scripts/xxx.js命令都以本 skill 的安装目录为基准,而当前工作目录通常是你的项目目录。因此执行时要使用绝对路径,或先cd到技能目录,例如node /path/to/shareone-skill/scripts/ensure_credentials.js。 - 验证是否生效:运行凭据检查脚本
node scripts/ensure_credentials.js。脚本会输出 token 状态,其含义与后续处理流程由技能内的workflows/environment-and-credentials.md说明。若没有凭据,可使用--create-guest参数创建访客凭据。 - 做一次最小验证:对一个
.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 原生、意图驱动、发布与权限治理一体,适合会话产物即时外发与评审;静态托管适合需要绑域名、长期运营的正式站点;网盘适合大文件归档传输。三者并不冲突,可以按场景组合使用。