前言¶
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 和調用相應的工具命令，可以實現從內容生成到分享發佈的全流程自動化。
