前言¶
DeepSeek Harness (DSH) 提供了插件扩展能力。当 Agent 需要将生成的文档、网页或纯文本分享给外部用户时，直接对接一个分享服务是常见需求。dsh-shareone-plugin 插件提供了这一能力，让 Agent 可以把内容发布到 ShareOne 平台，获得可直接访问的链接。
这是什么¶
dsh-shareone-plugin 是给 DeepSeek Harness 使用的 ShareOne 分享插件。它让 Agent 能够将本地文件或生成的内容发布为 ShareOne 分享链接，支持后续的评论互动和链接管理。
- 作者：sudoprivacy
- 许可：MIT
- 目标平台：ShareOne (默认
shareone.vip)
核心功能¶
插件主要覆盖以下能力：
- 发布内容：支持文本、Markdown、网页 (HTML)、PPT、PDF、Word 文件。
- 链接管理：设置访问密码、添加水印、自定义短链接。
- 内容更新：更新已有 TXT / Markdown / HTML 链接的内容。
- 评论协作：读取 TXT / Markdown / HTML 页面的评论，并支持回复评论。
- 平台管理：发布后在 ShareOne 平台统一管理所有链接。
安装与配置¶
安装¶
使用 DSH 命令行安装：
dsh plugin --profile web add dsh-shareone-plugin
dsh --profile web
配置 API Key¶
发布内容需要 ShareOne 的权限。有两种配置方式：
- 临时 Guest Key：如果还没有账号，Agent 可以调用
shareone_create_guest_key生成临时 Key 并保存到 DSH 密钥管理中。 - 已有账号：直接从 ShareOne 设置页获取 API Key，并在 DSH 密钥管理中配置，键名为
SHAREONE_API_KEY。
典型用法¶
插件提供以下工具命令，Agent 可直接调用：
1. 发布文本或网页内容¶
使用 shareone_publish_text 发布生成的 HTML、Markdown 或纯文本。
- 参数：支持
filename、content、password、watermark、custom_slug、allow_comments、title。 - 更新：如果传入
ref或share_id，则会更新已有 TXT / Markdown / HTML 链接内容，而不是创建新链接。
2. 发布本地文件¶
使用 shareone_publish_file 发布本地文件。
- 参数：支持
file_path、filename等设置项。 - 限制：插件只会读取明确传入
shareone_publish_file的本地文件。 - 更新：TXT、MD、HTML 文件可更新已有链接；PPT、PDF、Word 会发布为新的文档链接。
3. 管理链接设置¶
使用 shareone_update_settings 修改已有分享链接的属性（如密码、水印、短链接、评论开关等）。
4. 处理评论¶
- 读取：
shareone_get_comments：读取 TXT / Markdown / HTML 页面的评论和统计摘要，返回评论详情和定位数据。 - 回复：
shareone_reply_comment：回复评论，可指定状态（如resolved-agree、open-disagree）。 - 状态修改：
shareone_update_comment_status：修改评论状态。
注意事项¶
- 保留规则：普通分享链接按“最后活跃时间”保留。连续 90 天未访问可能被清理；Free 版本适用此规则。
- 访问权限：发布内容默认发送到
shareone.vip。 - 安全：插件运行在 DSH 进程中，只会读取你明确传入
shareone_publish_file的本地文件。请勿发布敏感信息。
总结¶
dsh-shareone-plugin 是一个实用的协作工具，让 DSH Agent 能够无缝对接 ShareOne 的分享与评论能力。通过配置 API Key 和调用相应的工具命令，可以实现从内容生成到分享发布的全流程自动化。
