前言¶
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 的开发者。
