前言¶

做騰訊廣告落地頁、企業微信進粉與轉化回傳時，漏斗、單客鏈路、銷售分配和防水牆往往分散在自建服務端的管理 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