dsh-wx-archive：微信公衆號文章存檔與全文讀取

在 DeepSeek Harness (DSH) 環境中開發 Agent 時，直接訪問 mp.weixin.qq.com 往往面臨動態渲染、反爬蟲或內容截斷的問題。dsh-wx-archive 插件由 opencamel 維護，旨在爲 Agent 提供一個穩定的微信公衆號文章存檔與全文讀取能力。該插件對接 2100laike 微信存檔服務，能夠將文章內容轉換爲 Markdown 格式返回。

核心功能¶

該插件主要提供以下能力：

存檔與讀取：支持微信公衆號文章的存檔與全文讀取。
自動去重：當文章已在服務端存檔時，直接返回最新版全文，不消耗額度。
自動存檔：遇到未存檔文章時，自動提交存檔任務，等待抓取完成後返回全文 Markdown。
版本控制：支持通過 refresh: true 參數強制刷新被修改過的文章。
圖片處理：圖片轉存到 CDN，防止裂鏈，且原文刪除不影響已存檔內容。

安裝¶

安裝插件必須通過 --profile 指定目標環境。插件按 profile 安裝，Web GUI 和 Headless CLI 分別需要各安裝一次。

# Web GUI 用戶
dsh plugin --profile web add github:opencamel/dsh-wx-archive#v0.1.3

# 純 CLI 用戶
dsh plugin --profile headless add github:opencamel/dsh-wx-archive#v0.1.3

安裝後必須重啓 dsh 進程才生效。如果在 GUI 正在運行時裝完插件，工具不會出現在當前會話中，需退出並重新啓動。

配置¶

插件通過 cordis.patch.yml 進行配置。文件路徑位於 ~/.dsh/profiles/<name>/cordis.patch.yml（例如 web profile 對應 ~/.dsh/profiles/web/cordis.patch.yml）。

修改配置後熱生效，但插件安裝/卸載仍需重啓。

- insert:
  - id: dsh-wx-archive
    name: dsh-wx-archive
    config:
      apiBaseUrl: 'https://api.2100laike.com'
      token: ''                                # 可選 PAT，提升額度
      waitTimeoutSec: 60                       # 新文章等待抓取完成的輪詢上限（秒）
      pollIntervalSec: 2                       # 輪詢間隔（秒）
      maxContentChars: 30000                   # 返回正文最大字符數，超出截斷

額度管理¶

匿名使用：每個插件實例 8 次/天，重啓後重新計數。
註冊 PAT 後：額度提升至 100 次/天。註冊地址爲 app.2100laike.com/register。
權限：註冊後登錄網頁端即提升額度；使用 PAT 需在開發者設置中創建，scope 至少需要 api:write。

使用方法¶

Agent 在遇到 mp.weixin.qq.com 鏈接時，應調用 wx_archive 工具。

基礎調用：

    # 調用工具 wx_archive(url)
    wx_archive(url="https://mp.weixin.qq.com/s/...")

強制刷新：

    # 使用 refresh: true 強制重抓被修改過的文章
    wx_archive(url="https://mp.weixin.qq.com/s/...", refresh=True)

注意事項¶

鏈接要求：不支持微信臨時分享鏈接（帶簽名鏈接），必須使用永久鏈接 https://mp.weixin.qq.com/s/...。
運行時依賴：僅依賴 @deepseek-ai/* 官方包，不使用 eval 或 child_process，不讀取本地憑據、環境變量或敏感路徑，無任何遙測行爲。
配置項：maxContentChars 有下限 1000，低於 1000 時按 1000 生效。

生態背景¶

DeepSeek Harness (DSH) 採用“一切皆插件”的理念。本插件爲社區維護項目，與 DeepSeek 或幻方官方無直接從屬關係。