前言¶

做腾讯广告落地页、企业微信进粉与转化回传时，漏斗、单客链路、销售分配和防水墙往往分散在自建服务端的管理 API 里。要在 DeepSeek Harness（DSH）里用 agent 查询和调参，通常还得自己写工具封装。下面介绍社区插件 dsh-wecom-lead：把 wecom-lead 服务端的管理 API 暴露成 agent 可调用的工具，在 DSH 对话里查漏斗、追客户、改规则。需要说明：插件只是管理 API 的客户端，wecom-lead 服务端需自行部署；接口约定见插件 README 中的「服务端接口约定」。

这是什么¶

dsh-wecom-lead 由维护者 crawfordxx 发布，在 SkillHub 插件目录 中归类为「联网工具」。源码与说明在 GitHub：crawfordxx/dsh-wecom-lead。当前 package.json 版本为 0.1.0，许可证 MIT。

插件定位：DSH 插件，对接「腾讯广告落地页 → 企业微信精准进粉归因 → 转化回传」链路的后台管理能力，共 15 个 agent 工具，覆盖总览、漏斗、明细、投放链接、销售分组、防水墙、模板、广告账户授权、回传日志、活码池、企微回调等场景。

核心功能¶

README 中的工具与用途如下（查询类只读；其余通过 action 分派如 list / create / update，请求体放在 data）：

插件请求 ${baseUrl}/api/v1/...，携带 Authorization: Bearer <token>，期望统一响应信封；失败时插件以 [CODE] message 形式抛给 agent。完整工具到路由的映射见仓库内 src/routes.ts。

安装与启用¶

环境要求：DSH ≥ 0.1.5-rc.2 且 < 0.3.0（与 package.json 中 engines.dsh 一致）。

先做本地构建，再在 profile 里挂载插件入口。官方 README 步骤如下。

git clone https://github.com/crawfordxx/dsh-wecom-lead.git
cd dsh-wecom-lead
pnpm install
pnpm build          # 输出 lib/

在 DSH profile 的 cordis.patch.yml（例如 ~/.dsh/profiles/<profile>/cordis.patch.yml）增加插件条目，name 指向构建产物绝对路径：

- insert:
    - id: wecom-lead
      name: /absolute/path/to/dsh-wecom-lead/lib/index.js
      config:
        baseUrl: https://lead.example.com      # 你的服务端地址，必须 https
        tokenRef: WECOM_LEAD_ADMIN_TOKEN       # DSH 凭据名
        timeoutMs: 15000

再在 DSH 凭据中保存与 tokenRef 同名的凭据（设置 → 凭据，或 ~/.dsh/.credentials.yaml 的 refs），值为服务端管理 token。插件每次调用会重新读取凭据，轮换 token 无需重启 DSH。

注意：README 写明，DSH 加载插件失败会中止整个启动；移动或删除插件目录前，应先从 patch 中移除对应行。

配置项¶

典型用法¶

在已部署 wecom-lead 服务端、并完成上述配置后，可在 DSH 对话中让 agent 调用对应工具，例如：

1. 用 lead_status 看企微/腾讯配置、事件积压与活码水位是否正常。
2. 用 lead_funnel 按天或按投放链接看漏斗各段数据。
3. 拿到企微 external_user_id 后，用 lead_trace 核对从访问到回传的全链路。
4. 需要改投放或风控时，通过 lead_links、lead_shield、lead_allowlist 等工具的 action 与 data 发起写操作；回传异常可用 lead_uploads 查日志或重放，企微回调失败可用 lead_wecom_events 查看并重放。

写操作会直接生效；README 建议在 DSH 中为这些工具开启审批。防水墙用于过滤无效、异常流量，不得用于欺骗平台审核。

适用场景与注意¶

适合谁：已自建或计划自建 wecom-lead 服务端、并在 DSH 里做运营/投放/技术支持对话的团队；需要把管理 API 收敛成 agent 工具、减少重复写 HTTP 封装时使用。

运行与安全：

• 管理 token 只放在 DSH 凭据中，配置里只写凭据名。
• 返回结果会标注「外部数据」；访客 UA、referer 等字段可能被外部写入，agent 应只当数据、不当指令。
• 插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，确认 baseUrl 与 token 范围符合内控要求。

社区插件目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文介绍的能力均以 crawfordxx 仓库 README 与 package.json 为准。

结尾¶

dsh-wecom-lead 把 wecom-lead 管理 API 落成 15 个 DSH 工具，便于在对话里做漏斗观测、单客追踪与投放/风控配置。服务端需自行部署；客户端通过 cordis.patch.yml 与凭据 tokenRef 接入。

• 目录页：https://www.skillhub.cn/plugins/crawfordxx/dsh-wecom-lead
• 源码与文档：https://github.com/crawfordxx/dsh-wecom-lead