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 或幻方官方无直接从属关系。