技能介绍

要解决什么问题

工程师和 Agent 经常需要把当前会话、本地 HTML/Markdown/TXT，或 PDF/PPT/Word 交给同事或客户查看，但又不想搭静态站、发邮件附件或反复传网盘。ShareOne 提供公网短链托管；本技能让 Agent 在对话里直接完成发布、更新、下载和评论闭环，而不是误用本机 PATH 里的 shareone CLI。

技能如何工作

发布：按文件类型走统一入口 publish.js——文本页（含对话与大段文本）与二进制直传自动分流；可绑定远程 URL（如 GitHub raw）做 auto-follow。
已有链接：用 share_id、自定义 slug 或完整 https://s.shareone.vip/... 识别目标；只改密码、水印、短链、评论/数据开关时走元数据更新，不重新上传正文。
remote 刷新：对绑定了远程源的分享，用 refresh_share.js 强制拉取最新源；非 remote 绑定会返回 NOT_REMOTE_BOUND。
评论：查看可走公开接口；根据评论改页需 owner 凭据，改完后必须用 comment_reply.js --state 表态（resolved-agree / open-disagree / open-need-input），不能单方面 dismiss 分歧。
凭据：需 API 的操作会先跑 ensure_credentials.js；若创建临时 Guest Key，必须先向用户展示 Key 与绑定提醒再继续上传。

边界与注意点

脚本路径以本 skill 安装目录为基准，不要默认在项目根执行相对路径。
/s/ 是访客链接，不是上传 API；成功后的 share_url 以脚本返回为准，不要自行拼接。
二进制文件更新不能用文本页的 --share-id 误传（会 ERROR:BINARY_NO_SHARE_ID）。
首次创建新分享前需做轻量内容安全自检；评论、下载、删 Key 等不发布操作无需自检。
普通链接在最后活跃超过约 90 天可能被清理；Explore、知识库引用或设了 remote_url 的除外。
默认不开启评论（--allow-comments）与页面持久化数据（--allow-data）；开启数据存储时，敏感内容用 putPrivate，公开可读用 putShared。