前言¶
在 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 仓库。
