手机远程控制台 dexwebcode/dsh-plugin-telegram-bot

DeepSeek Telegram Bot

Telegram 机器人，基于 aiogram 3，对接 DeepSeek 和 DeepSeek Harness。收到消息后发给「大脑」，再把回复返回聊天，并保留上下文。回复以 MarkdownV2 格式发送。

Telegram ──long polling──▶ bot.py ──▶ DeepSeek API / DSH-агент ──▶ ответ в чат

能做什么

- 两种模式：
- agent（默认）—— 启动 DSH 智能体（dsh headless --json）：工具、文件、工作目录、会话，和 DSH 网页界面里一样；
- fast —— 直接请求 api.deepseek.com，不带工具和文件。
- 每个聊天单独设置模型和推理强度： Flash/Pro、Low/High/Max —— 记在 state.json 里。
- 每个聊天单独设置权限： read-only、workspace-write、danger-full-access；需要确认的模式下，机器人会发「允许」/「取消」按钮。
- 实时回复： 操作卡片（最近 5 步操作）、计时器、「停止」按钮。
- 自启动和守护： 守护进程在崩溃后拉起机器人，计划任务每 5 分钟检查一次 /health。

环境要求

| 要求 | 用途 |
| Python 3.12 | 机器人 |
| aiogram 3 及 requirements.txt 里的依赖 | 机器人 |
| DeepSeek Harness（dsh 在 PATH 中） | agent 模式 |
| DeepSeek 密钥（platform.deepseek.com） | fast 模式和智能体 |

安装

$bot = 'C:\Users\<Имя>\...\dsh-plugin-telegram-bot\Telegram Bot'

uv venv "$bot\.venv" --python 3.12
uv pip install --python "$bot\.venv\Scripts\python.exe" -r "$bot\requirements.txt"

Copy-Item "$bot\config.example.json" "$bot\config.json"
впишите botToken (из @BotFather) и deepseekApiKey
python "$bot\bot.py" --check

启动

Start-Process wscript.exe -ArgumentList ""$bot\bot.vbs""

机器人在隐藏窗口中运行。状态面板：<http://127.0.0.1:8099/>（/health 返回 JSON）。

自启动和守护

| 环节 | 做什么 |
| bot.vbs + start.ps1 | 守护进程：启动 bot.py，崩溃后 10 秒重新拉起 |
| ensure-bot.vbs + ensure-bot.ps1 | 看门狗：检查 /health；机器人超过 10 分钟没响应就杀掉进程 |
| 计划任务 DshTelegramBot | 登录时启动看门狗，之后每 5 分钟一次 |
| 启动项里的 telegram-bot.vbs | 登录时拉起守护进程 |

$a = New-ScheduledTaskAction -Execute 'wscript.exe'
-Argument ""$bot\ensure-bot.vbs""
$t1 = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME
$t2 = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(2)
-RepetitionInterval (New-TimeSpan -Minutes 5)
Register-ScheduledTask -TaskName 'DshTelegramBot' -Action $a -Trigger @($t1, $t2) -Force

按钮和命令

聊天底部：模型、权限、新会话、状态、刷新。
不用手动输入 /…，但命令照样能用。

| 命令 | 做什么 |
| /flash、/pro | 模型 deepseek-flash / deepseek-v4-pro |
| /low、/high、/max | 推理强度 |
| /full、/write、/read | 智能体权限 |
| /new | 新建智能体会话 |
| /status | 机器人状态、模型、推理强度、权限 |
| /cancel | 停止当前回合 |
| /update | 重启机器人 |

智能体权限

| 预设 | 允许的操作 |
| read-only | 只读，修改需申请 |
| workspace-write | 可写工作目录；超出范围需申请 |
| danger-full-access | 整台机器，无需确认（默认） |

切换权限会开启新的智能体会话：预设在该会话创建时绑定到会话。

文件

| 文件 | 用途 |
| bot.py | 入口：aiogram 3、命令、流式编辑消息、面板 |
| backends.py | DSH 智能体与直连 DeepSeek API |
| formatting.py | Markdown → MarkdownV2 |
| approval_bridge.mjs | 把 DSH 的审批请求桥接到 Telegram |
| config.json | 机器人 token、DeepSeek 密钥、模型/推理强度/权限、面板 |
| state.json | 所有者、聊天会话、已选设置（自动创建） |
| start.ps1、bot.vbs | 隐藏窗口中的守护进程 |
| ensure-bot.ps1、ensure-bot.vbs | 基于 /health 的看门狗 |
| logs/ | bot.log、stdout.log、stderr.log、supervisor.log、watchdog.log |

诊断

| 症状 | 原因 / 处理 |
| 409 Conflict | 还有别的进程在轮询这个机器人——停掉多余进程 |
| 机器人无响应，/health 不回应 | 进程崩溃：看门狗会在 5 分钟内拉起，日志见 logs/watchdog.log |
| EPERM … cordis.yml | 机器人由 venv 执行器启动，而非基础 python——见 start.ps1 |
| can't parse entities | MarkdownV2 未被接受；消息将以纯文本发出 |
| 机器人无响应，/status 有回应 | 请求仍在执行：等待回复或发送 /cancel |

安全

- config.json 含机器人 token 和 DeepSeek 密钥——不要提交它 （已在 .gitignore 中）；仓库里放的是脱敏的 config.example.json。
- danger-full-access 让机器人能访问整台电脑：对别人的聊天请设 workspace-write 或 read-only。

许可证

MIT © 2026 DEXWEBCODE