前言¶
在 DeepSeek Harness（dsh）裏做聯網或即時通訊類智能體時，常見做法是自建橋接服務或手動在多個界面之間切換。WhatsApp 沒有面向個人開發者的通用 HTTP API，要在對話裏「查未讀、歸納羣聊、代發一條消息」，往往需要額外中間層，並把賬號綁定、鑑權與發送確認單獨維護。
Wapliss 提供託管的 WhatsApp 網關，以 Model Context Protocol（MCP）對外暴露工具；倉庫 proteuscrypto/wapliss-for-deepseek 是 Wapliss 面向 DeepSeek Harness 的官方配置包，只把 dsh 指向 https://wapliss.com/mcp/v1，不在本地存放消息或憑據。下面介紹其定位、能力、安裝步驟與使用注意。
這是什麼¶
Wapliss 由 NetDigitalTech LLC 運營，用戶用手機號掃碼綁定 WhatsApp 後，經 MCP 服務器讓助手讀取會話與羣組、在確認後發送消息及附件。本插件（npm 包名 dsh-plugin-wapliss，版本 1.0.1，MIT 許可證）是「僅含配置的 dsh 捆綁包」：通過 cordis.patch.yml 注入一行 @deepseek-ai/dsh-mcp-client，連接託管 MCP；GitHub 維護組織爲 proteuscrypto，與 SkillHub 目錄「聯網工具」分類一致。
DeepSeek 網頁聊天與移動端應用不支持 MCP 連接器；本插件適用於 dsh web、TUI 與 headless 模式下的 DeepSeek V4 智能體。自建的 DeepSeek API 智能體也可按 Wapliss MCP 集成說明 使用同一服務。
核心功能¶
插件側通過 MCP 暴露 16 個工具，在對話中以 mcp__wapliss__* 名稱出現，按 README 劃分如下：
- 會話與歷史：
get_chats、get_chat_history、get_message— 列出與搜索會話，按序讀取聊天或羣組，獲取單條消息。 - 最近動態：
get_last_incoming_messages、get_last_outgoing_messages— 跨會話查看近期收、發消息。 - 羣組信息：
get_group— 名稱、描述、管理員與成員。 - 發送：
send_text_message、send_image、send_document、send_audio、send_video、send_location、send_contact、send_poll、forward_messages— 文本、通過公開 URL 傳文件、位置、名片、投票與轉發。 - 賬號：
get_account_status— 套餐、綁定號碼、當日用量與配額。
發送類工具在 MCP 上標註爲 destructive，智能體在收件人或正文不明確時會先確認；發送成功表示消息已入隊（返回 queue_id），未必已送達。各工具還帶有 readOnlyHint 等註解，便於客戶端區分只讀與寫操作。
工作原理簡述¶
DeepSeek Harness (dsh web / tui / headless, DeepSeek V4)
| @deepseek-ai/dsh-mcp-client, Streamable HTTP
| Authorization: Bearer $WAPLISS_API_KEY
v
https://wapliss.com/mcp/v1 (MCP 2026-07-28 和 2025-11-25)
|
Wapliss WhatsApp engine ---> WhatsApp
未設置環境變量 WAPLISS_API_KEY 時，補丁中的 Wapliss 行保持 disabled，dsh 照常啓動且不會向 Wapliss 發起請求。
安裝與啓用¶
前置條件：DeepSeek Harness 版本滿足 >=0.2.2-rc.1（README 標註在 dsh 0.2.2-rc.1 上測試通過）；在 Wapliss 註冊免費賬號並完成 WhatsApp 綁定。
- 在 wapliss.com 註冊，並在 wapliss.com/app/connect 綁定手機。
- 在 Settings → API keys（wapliss.com/app/settings#api-keys）創建個人 API key；密鑰僅顯示一次，請妥善保存。
- 寫入本地環境並安裝插件、啓動 Web UI：
echo 'WAPLISS_API_KEY=wp_live_your_key' >> ~/.dsh/.env && chmod 600 ~/.dsh/.env
npx -y @deepseek-ai/dsh plugin --profile web add "github:proteuscrypto/wapliss-for-deepseek#main"
npx -y @deepseek-ai/dsh web
也可在 dsh Web UI 的 Settings → Plugins → Add 中填寫 github:proteuscrypto/wapliss-for-deepseek#main。
安裝後可用自然語言請求 “Check my Wapliss account” 驗證工具是否加載。README 還提供可選技能目錄複製：
mkdir -p ~/.agents/skills && cp -r skills/wapliss-whatsapp ~/.agents/skills/
（skills/wapliss-whatsapp 爲插件包內路徑，執行前需先 cd 到該目錄所在根路徑。）
典型用法¶
README 中的示例提示可按目標直接複用（會話名與 WhatsApp 中一致，或使用帶國家碼的號碼）：
| 目標 | 可向智能體這樣說 |
|---|---|
| 查看近況 | Show me my latest WhatsApp messages |
| 歸納羣聊 | Summarize what was said today in my family group |
| 讀指定對話 | Read my last 20 messages with Ana and tell me what she needs |
| 羣管理員 | Who are the admins of the work group? |
| 發消息 | Send ‘On my way, 10 minutes’ to +1 555 010 2030 |
| 發文件 | Send this PDF to Laura: https://example.com/quote.pdf |
| 發位置 | Send the office location to the project group |
| 投票 | Create a poll in the team group: Friday or Monday? |
| 查賬號 | Check my Wapliss account and today’s usage |
中文指令在具備 MCP 工具的會話中同樣可行，關鍵是明確羣組名、聯繫人或號碼。
適用場景與注意¶
適合誰：已在 dsh 中使用 DeepSeek V4、希望用同一套 Harness 讀 WhatsApp、做摘要或在確認後代發消息與附件的開發者或個人用戶。Wapliss 提供免費套餐起步，無需信用卡（以 Wapliss 當前政策爲準）。
環境與權限：插件以當前 dsh 進程的用戶權限運行；API key 存放在 ~/.dsh/.env，請勿在對話中粘貼密鑰、二維碼或會話數據。安裝前應閱讀 GitHub 倉庫 源碼、cordis.patch.yml 與 MIT 許可證，確認補丁內容符合你的安全策略。
產品邊界：Wapliss 通過「關聯設備」方式連接號碼，類似 WhatsApp Web，並非 Meta WhatsApp Business Platform；智能體僅在用戶請求時操作，拒絕批量或未請求的騷擾式發送。消息存放在你的 Wapliss 私有賬號中，助手讀取的內容會經其 AI 提供方處理，詳見 隱私政策。可在 Wapliss 控制台隨時撤銷授權；服務側還有每日套餐配額與每分鐘每用戶 60 次 MCP 調用等限制。
生態說明：DeepSeek Harness 奉行「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek 或幻方無官方從屬關係。
結尾¶
proteuscrypto/wapliss-for-deepseek 把 WhatsApp 能力收斂爲 dsh 裏一組可確認的 MCP 工具，配置量小、憑據不進對話。若要查閱目錄說明或提交 issue，可分別打開 SkillHub 目錄頁 與 GitHub 倉庫；更完整的 DeepSeek 集成步驟見 wapliss.com/integrations#deepseek。
