dsh-tool-gzh-publisher

在 dsh 里把关并推送公众号草稿 —— 装完这个插件，你的 Agent 就能先过质量门、 再把稿件推进公众号草稿箱，全程不用离开对话。

公众号（WeChat Official Account）管线工具集，以 dsh 插件形式暴露给 Agent。

Compatibility: built and tested against dsh 0.2.0-rc.2 (preview). The apply(ctx) plugin spec is stable; verify against your own dsh version if newer.

一行安装

dsh plugin --profile desktop add github:yuehancn/dsh-tool-gzh-publisher

支持的 profile：desktop（桌面版）/ web（Web 版）。 ⚠️ 需要本机已有 gzh_auto.py 管线脚本，见下方「前置条件」。

它不重新实现微信 API —— 微信的 access_token 握手、草稿创建、发布前质量门 都在已经跑通的 gzh_auto.py（来自 gzh-auto-publisher 技能）里。本插件是一层 类型化桥接，把这套能力变成模型能安全调用的工具。

为什么不做成「直接 exec 一个脚本」？因为那样模型要自己拼 flag、自己解析中文 输出、自己判断成功失败。凭据类、限频的 API 一旦有第二份实现，就必然出现两个 source of truth。这里只做：类型化参数 + 结构化输出 + 稳定的路径配置。

安装

dsh plugin --profile desktop add github:yuehancn/dsh-tool-gzh-publisher

Replace desktop with your own profile name. This plugin needs external setup (a publisher script + an account registry) — see below.

⚠️ 本插件不是开箱即用。它桥接的 gzh_auto.py 与 accounts.json 是另一个 仓库/技能的内容。装完插件后必须自己配好这三个路径，否则工具会明确报 gzh: publisher script not found at "…"。

🔐 权限与隐私

这一节很重要 —— 本插件会接触微信发布凭据。

⚠️ 发布是不可逆的对外动作。gzh_push_draft 只推草稿箱、不发布， 最终「发布」仍需人工点击 —— 这是有意设计。

工具一览

工具描述里显式标了联网与否，因为模型不该在只想体检配置时误触发一次鉴权。

前置条件

本插件需要三样外部东西：

accounts.json 的每个条目形如：

{
  "我的公众号": {
    "name": "我的公众号",
    "positioning": "账号定位一句话",
    "keywords": ["关键词1", "关键词2"],
    "workdir": "C:/path/to/drafts",
    "env_file": "C:/path/to/.env",
    "min_cjk": 1500,
    "max_cjk": 2600,
    "min_gold": 2,
    "ending": "…我的公众号",
    "author": "作者名"
  }
}

env_file 指向一个含 WECHAT_APPID / WECHAT_APPSECRET 的文件。 ⚠️ 该文件不要提交到任何仓库。

安装（手工，本机开发用）

package.json
cordis.patch.yml
lib/index.js

{
  "dependencies": {
    "dsh-tool-gzh-publisher": "link:C:/Users/<你>/.dsh/plugins/dsh-tool-gzh-publisher"
  },
  "dsh": {
    "profile": {
      "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-tool-gzh-publisher"]
    }
  }
}

mklink /J "%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-tool-gzh-publisher" ^
          "%USERPROFILE%\.dsh\plugins\dsh-tool-gzh-publisher"

- id: tool-gzh-publisher
  config:
    scriptPath: <你的 gzh_auto.py 绝对路径>
    pythonPath: <你的 python 解释器绝对路径>
    accountsPath: <你的 accounts.json 绝对路径>
    timeoutMs: 300000

配置项

验证

三个探针（.probe/，为开发期产物，正式交付可删）：

node .probe/verify-load.mjs    # 模块能否被 dsh 加载、5 个工具是否注册、开关是否生效
node .probe/behaviour.mjs      # classify 映射全覆盖 + 真实脚本端到端
node .probe/live.mjs           # 真实稿件跑门 + 真实微信 API
node .probe/live2.mjs          # 从「已安装路径」加载，跑真凭据握手

本机实测结论：

• verify-load PASS — 5 工具注册，空配置默认值正确，push:false, verify:false 时正确降为 3 个工具
• behaviour 全 PASS — exit0+✅→ok、exit1+❌→fail、exit0但含❌→fail、 详情原文保留；真实脚本对 4 字草稿给出真实判词 （CJK=4（要求 1500-2600） | 金句=0（≥2） | 结尾错误）
• live — 三篇历史稿件全部 ok=false（这是脚本的真实意见，不是插件 bug）
• live2 — 从安装路径加载成功；gzh_check 报配置完整；gzh_verify 真实取到 token（✅ 授权 OK（token 前缀 108_vH…））

dsh 自身加载验证：

# 需要 ELECTRON_RUN_AS_NODE=1；--dump-config 是顶层 flag，不是 plugin 子命令
ELECTRON_RUN_AS_NODE=1 "<DeepSeek Harness.exe>" \
  "resources/app.asar/dsh/node_modules/@deepseek-ai/dsh/lib/bin.js" \
  --profile web --dump-config | grep -A2 "== dsh-tool-gzh-publisher"

输出：

# == dsh-tool-gzh-publisher
- id: tool-gzh-publisher
  name: dsh-tool-gzh-publisher

坑位备忘

1. --dump-config 是顶层 flag。dsh plugin --profile web dump-config 会把 dump-config 当成 pnpm 参数透传，然后报 'pnpm' 不是内部或外部命令。 正确写法：dsh --profile web --dump-config。
2. 必须 ELECTRON_RUN_AS_NODE=1，且用桌面版的 exe 跑 asar 里的 bin.js。 裸 node 读不了 asar 路径（MODULE_NOT_FOUND）；不带该变量则 exe 会试图开窗口 并吞掉 stdout（表现为「rc=0 但输出 2 字节」）。
3. gzh_check 不是「列草稿箱」。它检查的是账号配置。真正的草稿列表要走 微信后台。最初我把工具起名叫 gzh_drafts 并写成「列出草稿箱」，读脚本源码 （cmd_check 在 gzh_auto.py:310）后改正为 gzh_check。
4. 中文输出必须设 PYTHONIOENCODING=utf-8 + PYTHONUTF8=1，否则 Windows 默认 OEM 代码页会把账号名、标题打成乱码。插件在 runScript() 里已设。
5. classify() 不能只看退出码。脚本存在「exit 0 但输出里带 ❌」的情况 （部分判词先打 ✅ 再打 ❌）。判据是 code===0 && !/❌/。
6. accounts.json 的中文键（账号名常为中文）在 JSON 里是 UTF-8，读取时要显式 encoding: "utf8"，否则在 GBK 默认环境下会抛解码错。