dsh-zsxq：DeepSeek Harness 知識星球集成插件

前言¶

DeepSeek Harness 通過插件擴展其能力。本插件爲 DeepSeek Harness 提供了接入知識星球（zsxq）的功能。

由於知識星球沒有官方開放平臺 API，該插件基於其非官方 Web API（api.zsxq.com/v2）實現。它通過 Cookie 認證，將星球的內容獲取、搜索及發佈能力暴露爲 Agent 工具，並提供掃碼登錄與 Web 設置面板。

使用官方命令安裝插件：

dsh plugin --profile web add dsh-zsxq

安裝後重啓 DeepSeek Harness GUI 使其生效。

插件提供以下工具與面板：

zsxq_status: 查詢登錄狀態（Cookie 配置/有效期、登錄流程進度）。
zsxq_config: 配置或清除 Cookie。
zsxq_login: 掃碼登錄。通過彈出系統 Chrome 窗口進行微信掃碼，自動保存 Cookie。
zsxq_groups: 獲取用戶加入的星球列表。
zsxq_topics: 獲取星球的主題列表。
zsxq_topic: 獲取主題詳情及評論。
zsxq_search: 在星球內進行站內搜索。
寫操作（需謹慎）:
- zsxq_publish: 發佈主題。
- zsxq_comment: 發表評論。
- zsxq_like: 點贊。
Web 設置面板: 提供掃碼登錄、粘貼 Cookie、測試連接、清除登錄的圖形化操作入口。

基礎的數據獲取與發佈流程如下：

登錄：執行 zsxq_login。系統會彈出 Chrome 窗口，使用微信掃碼登錄。登錄成功後，Cookie 會自動保存。
讀取內容：
- 使用 zsxq_groups 獲取星球 ID。
- 使用 zsxq_topics 攜帶星球 ID 獲取主題列表。
- 使用 zsxq_topic 攜帶主題 ID 查看詳情及評論。
- 使用 zsxq_search 攜帶星球 ID 和關鍵詞進行搜索。
寫入內容：
- 使用 zsxq_publish 發佈新主題。
- 使用 zsxq_comment 回覆主題。
- 使用 zsxq_like 點贊。

依賴要求：DeepSeek Harness 版本需 >= 0.1.5-rc.1。
API 特性：使用非官方 Web API（api.zsxq.com/v2），請求頭需包含 Accept: application/json、瀏覽器 UA、Referer/Origin 以及 Cookie。Web 版接口無需簽名。
安全性：寫操作（發佈、評論、點贊）基於逆向接口實現，可能觸發知識星球的風控機制，請謹慎使用。
憑據存儲：登錄憑據保存在 ~/.dsh/dsh-zsxq.（權限 0600）。
有效期：Cookie 有效期約爲 1–3 個月，過期後需重新登錄。