前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在使用 DSH 進行開發或管理時，若希望有更便捷的交互入口，或者需要在移動端（微信）和桌面端（Telegram）之間無縫切換會話，傳統的命令行或 Web 界面可能不夠直接。aitcmhk-web/dsh-bot 正是爲了解決這個問題而生，它將 Telegram 和微信轉化爲 DSH 的聊天終端，並內置了記憶接續能力。
插件介紹¶
名稱：aitcmhk-web/dsh-bot
定位：把 Telegram / 微信變成 DSH 的聊天入口的插件，支持語音轉文字、handoff 記憶接續等功能。
維護者：aitcmhk-web
許可證：MIT
核心能力：
* 雙端接入：Telegram 入口、微信入口。
* 記憶與狀態：handoff 記憶接續、自動記憶、遠程審批。
* 交互增強：語音轉文字、模型切換、重啓功能。
* 多端互通：TG 和微信共用同一個上下文，消息同步廣播。
* 指令支持：/whoami、/status、/model、/new（新會話）、/restart、/help。
安裝與啓用¶
安裝分爲兩步：先升級 DSH 本體（如果尚未安裝），再安裝並配置機器人插件。
- 安裝/升級 DSH 本體（包含 Git、Node、DSH 本體及已裝插件的升級）：
curl -fsSL https://raw.githubusercontent.com/aitcmhk-web/DSH-bot/main/setupdsh.sh | sh
- 安裝機器人插件（新建/選擇工作區、綁定賬號、生成配置文件）：
curl -fsSL https://raw.githubusercontent.com/aitcmhk-web/DSH-bot/main/setupbot.sh | sh
該腳本會引導你完成以下操作：
* 選擇或新建工作區（默認爲 `mybot`）。
* 輸入 Telegram Bot Token（在 Telegram 中找 @BotFather 發送 `/newbot` 獲取）。
* 配置微信掃碼登錄（可選）。
腳本執行完畢後，會自動將 `setupdsh` 和 `setupbot` 命令加入 PATH。後續升級本體或重新綁定賬號時，只需分別執行這兩個命令。
- 啓動服務：
進入對應的工作區目錄並執行啓動腳本：
~/DSH/<工作區名>/start.command
- 開發者本地調試（使用源碼）：
如果你在本地修改了源碼，可以通過file:路徑加載，無需重新安裝：
dsh plugin --profile mybot add file:/絕對路徑/dsh-botplugin
> 注意：`file:` 後面不能寫 `~`，必須使用絕對路徑（如 `$HOME/DSH/BOT/botplugin`）。
典型用法¶
- 開啓新會話：在 Telegram 或微信中發送指令
/new。 - 切換模型：在對話中發送指令
/model。 - 查看狀態：發送
/status或/whoami。 - 重啓進程：發送
/restart（會自動保存 handoff 記憶）。
適用場景與注意¶
適用場景：
* 需要在移動端通過微信接收和發送 DSH 消息。
* 需要在不同設備間通過 Telegram 繼續未完成的會話。
* 需要遠程審批功能（手機端點按鈕即可）。
注意事項：
1. Token 衝突：一個 token 只能被一個進程佔用。如果有兩個進程同時使用同一個 token，會觸發 409 衝突（通常表現爲先啓動的進程停止輪詢並報錯）。如果重啓後仍提示衝突，需檢查是否有其他進程在佔用該 token。
2. Telegram 游標機制：Telegram 的消息游標保存在內存中。重啓機器人後，它會從當前時刻開始拉取消息，不會補發離線期間的歷史消息。
3. 微信工具限制：Windows/Linux 機器上運行微信掃碼工具時，可能會退化爲只打印鏈接，無法渲染二維碼。
4. 進度與回答分離：進度佔位消息只顯示進度，不承載最終回答。回答由節點廣播到所有端點，進度消息頂掉舊消息後不會覆蓋最終回答。
5. LLM 流量預算：插件默認開啓限流（llmBudget），在滾動 60 秒窗口內限制請求數（默認 50 次）和 token 數（默認 90 萬）。如果遇到供應商 429 錯誤，可調整 tpm 和 rpm 配置或關閉限流（enabled: false）。
6. 關閉 Handoff 記憶：默認開啓 handoff 記憶接續。如需關閉，在配置中將 memoryDir 設爲空串即可。
短結尾¶
aitcmhk-web/dsh-bot 提供了標準 DSH 插件的接入方式，將常見的即時通訊工具轉化爲開發終端。它通過 handoff 機制解決了多端切換的記憶斷層問題，適合需要在移動端或跨設備環境下使用 DSH 的開發者。
