前言¶
在 DSH 環境中，從微信公衆號收集文章、分析創作者並導出源卡片通常涉及多個工具和繁瑣的流程。dsh-wechat-collector 是一個 DSH 原生插件，提供右側面板、工具集、首次運行設置、二維碼登錄流、收集控制、反饋回寫以及 ContentStudio 導入。它是一個 DSH 層，負責處理與 Python 運行時（pika-weixin-collection 的精簡子集）的交互。
安裝與啓用¶
插件目前未收錄在目錄市場，需直接從 GitHub 安裝。安裝命令如下：
dsh plugin --profile web add github:bescriptkiddie/dsh-wechat-collector
安裝完成後，重啓 DSH Web 進程（如果當前環境不支持熱加載）以使右側面板出現 公衆號 入口。
首次運行（macOS）¶
在 macOS 上首次使用，需在面板中選擇 安裝本地運行時。系統會下載 uv 0.12.6 並驗證其 SHA-256 校驗和，隨後將其部署至 ~/.local/share/dsh-wechat-collector，並創建綁定到 127.0.0.1:8000 的當前用戶 launchd 服務。
核心功能¶
插件提供以下 DSH 工具與面板功能：
- Runtime 管理：通過
wechat_collector_runtime工具安裝、啓動、停止或卸載本地運行時。 - 賬戶登錄：使用
wechat_collector_login啓動二維碼登錄流程，憑證以命名配置文件形式存儲，不進入 DSH 主進程。 - 賬戶管理：通過
wechat_collector_account搜索、添加、列出或移除已追蹤賬戶。 - 爬取控制：通過
wechat_collector_crawl啓動收集，管理每日計劃，並調整請求間隔策略（默認賬戶間 20 秒，頁間 8 秒）。 - 外部源管理：通過
wechat_collector_sources管理 RSS 源等外部水源，緩解官方 API 限流。 - 內容預覽：使用
wechat_collector_items讀取候選文章。 - 反饋回寫：使用
wechat_collector_feedback將人工決策寫入源項。 - 分析配置：通過
wechat_collector_analysis_config檢查分析配置或測試端點。 - 作者分析：使用
wechat_collector_author_analysis生成並查看本地證據受限的創作者分析報告。 - ContentStudio 導入：使用
wechat_collector_import_to_studio冪等地創建源卡片。
憑證管理與頻率限制¶
每次二維碼登錄會存儲憑證爲命名配置文件，可在面板或工具中隨時切換。憑證值永不進入 DSH，僅作爲命名配置文件存儲。爬取遇到 HTTP 429（頻率限制）時會自動停止並進入冷卻期，防止重複請求加劇懲罰窗口。
DeepSeek 創作者分析¶
分析密鑰通過 DSH 憑證提供（DEEPSEEK_API_KEY），插件報告和設置中絕不包含密鑰。分析限制爲：單篇文章最多 6000 字符，總計 60000 字符。生成的報告保存在本地，可在面板查看。少於五篇實質性文章的樣本會被標記。
ContentStudio 交接¶
插件本身不發佈內容到微信，僅負責收集和導入 ContentStudio。使用 wechat_collector_import_to_studio 工具可創建源卡片。格式化、草稿上傳和最終發佈仍需在獨立的 ContentStudio 工作流中完成。
適用場景與注意¶
- 系統要求：依賴 Node.js 22.19.0 或更高版本。
- 數據保留：卸載插件時會保留數據、憑證和運行時文件。
- 平臺差異：首次運行設置目前針對 macOS 描述，Windows/Linux 需手動確保運行時可用或通過
collectorBaseUrl連接。
短結尾¶
dsh-wechat-collector 將微信公衆號的收集、分析與 ContentStudio 交接流程整合進 DSH 生態。通過本地運行時、憑證隔離和頻率控制，它爲創作者分析提供了標準化的基礎設施。更多詳情可參考GitHub 倉庫。
