前言¶
如果你已經在用 DeepSeek Harness（DSH）做智能體流程，下面這個插件適合用來接入企業微信：它把企業微信 AI Bot 作爲一個通道接到 DSH，讓單聊或羣聊消息進入一個持久 Harness 代理。
先做 X，再做 Y 的路徑也比較直接：先安裝 dsh-wecom，再準備 WECOM_BOT_ID 和 WECOM_BOT_SECRET，最後啓動 dsh web。經過上面的步驟後，聊天消息就可以進入帶預設、工具和會話狀態的代理鏈路。
這是什麼¶
dsh-wecom 是 TtTRz 維護的 DSH 插件，許可證爲 MIT。
它的定位是一句話：WeCom AI Bot channel for DeepSeek Harness — each chat runs a persistent, preset-backed agent over the official long connection。
也就是說，它不是簡單地在企業微信和模型之間轉發消息，而是讓每個單聊或羣聊對應一個持久 Harness 代理，並掛載預設（默認 standard）以提供工具和 persona。
核心功能¶
下面按已覈實能力介紹。
會話代理¶
每個單聊或羣聊對應一個持久 Harness 代理。代理會掛載預設，默認是 standard，以此提供工具和 persona。
消息處理¶
插件支持以下消息鏈路控制：
msgid去重- 單會話隊列
- 全局併發上限
- 單輪超時取消
長連接斷開後，通道會按 restartIntervalMs（默認 10s）自動重啓。
媒體與輸出¶
媒體方面，圖片可以下載、解密，並在模型可看圖時附帶；文件和視頻會進入代理工作區。
輸出方面，插件支持：
token級流式回覆- 原生
think推理卡片 - 緊湊工具調用列表
訪問策略¶
單聊和羣聊的訪問策略支持：
openallowlistdisabled
羣聊按 chatid 限制。
狀態與命令¶
插件提供 wecomChannelStatus 服務、GET /api/wecom/status 狀態接口、側邊欄狀態點和浮動狀態面板。
聊天側支持以下命令：
/ping
/help
/status
/stop
/compact
/new
安裝與啓用¶
資料給出的安裝命令是：
dsh plugin --profile web add dsh-wecom
安裝後，先準備憑據，再啓動 web：
export WECOM_BOT_ID='your-bot-id'
export WECOM_BOT_SECRET='your-bot-secret' # dev only — 生產環境使用 credential service
dsh web
如果希望跨重啓保留配置，資料建議：
- 將
WECOM_BOT_ID寫入~/.dsh/.env - 將
WECOM_BOT_SECRET寫入~/.dsh/.credentials.yaml
如果希望覆蓋代理工作目錄，可以設置：
DSH_WECOM_CWD
源碼安裝示例如下，需要固定提交：
dsh plugin --profile web add github:TtTRz/dsh-wecom#<sha>
注意：Git 安裝會運行構建腳本；pnpm >=10 會拒絕 git 依賴構建腳本，建議優先使用預構建包。
典型用法¶
啓用插件後，可在：
~/.dsh/profiles/web/cordis.patch.yml
中配置 wecom-channel 行。
下面只列已覈實資料中明確提到的配置要點：
- 預設默認值爲
standard - 單聊和羣聊訪問策略可爲
open、allowlist或disabled - 羣聊按
chatid限制 DSH_WECOM_CWD可覆蓋代理工作目錄
安裝完成並啓動後，可以發送 /ping 檢查連通性，再用 /status 查看會話狀態，或用 /stop 取消當前生成。
適用場景與注意¶
適合這些場景：
- 已經使用 DSH，希望把企業微信單聊或羣聊作爲智能體入口
- 希望每個會話擁有持久代理、預設工具和
persona - 需要訪問策略、併發控制、超時取消、流式回覆和狀態觀察
使用前注意：
WECOM_BOT_SECRET環境變量被文檔標註爲dev only；生產環境使用 credential service- 插件以當前
dsh進程權限運行，安裝前應檢查源碼和許可證 engines.node要求>=22.19- 已覈實資料中
package.json版本爲0.3.0，README 示例中也出現過0.1.17和0.1.5；如果需要固定版本，安裝前先覈對目標版本
鏈接¶
GitHub 倉庫：
https://github.com/TtTRz/dsh-wecom
已覈實資料未提供可覈實的社區目錄頁 URL，本文不列出。
