Telegram 私聊桥接 yoggu/dsh-telegram-bridge

dsh-telegram-bridge

仅限宿主的 Cordis 捆绑包，用于单个预先授权的私有 Telegram 聊天。它使用 DSH 的无头 Agent/Session 服务（没有 Web 服务器、SessionController 或上传端点），持久化偏移量/会话/调度状态，并拒绝基于 Telegram 的审批。仅支持文本以及 /start、/help、/status、/new、/compact、/stop；不支持配对、附件、回调审批或流式传输。已授权的交互式提示会显示尽力而为的 Telegram 输入中指示器，直到完成、取消或超时。凭据和运行时状态必须保留在此仓库之外。

安装

将带标签的 GitHub 发布版安装到拥有该 Telegram 机器人的 DSH 配置文件中：

dsh plugin --profile telegram add 'https://github.com/yoggu/dsh-telegram-bridge.git#v0.1.1'

或者下载并链接本地检出：

git clone --branch v0.1.1 --depth 1 https://github.com/yoggu/dsh-telegram-bridge.git
cd dsh-telegram-bridge
pnpm install
dsh plugin --profile telegram add "link:$(pwd)"

安装期间请保持链接的检出处于原位。请使用你实际运行的配置文件；该桥接应拥有自己专用的 DSH 进程/配置文件。

在消费方 DSH 配置文件中配置

安装该捆绑包后，提供一个配置文件覆盖层，例如：

- id: telegram-bridge
config:
cwd: /absolute/agent/workspace
dataDir: /absolute/private/telegram/data
agentPreset: existing-agent-preset
permissionPreset: workspace-write
provider: existing-local-provider
model: exact-model-id
reasoningEffort: low
timeZone: Europe/Zurich
enableSchedules: false
jobs: []

消费方配置文件拥有 agentPreset 定义（包括用于 /compact 的压缩服务）、可用工具、模型适配器、沙箱/审批策略以及可选的技能特定作业。/new 会立即持久地创建一个全新会话；/compact 仅在当前空闲会话上运行，并且绝不会盲目重试部分提交的操作。credentials.json 必须已存在于 dataDir 内，具有私有的 0600 权限模式和私有的 0700 目录：{ "botToken": "", "allowedUserId": }。宿主绝不会自动配对。启动时，它会通过 Telegram setMyCommands 为已授权的私有聊天注册当前的斜杠命令菜单；此菜单与响应键入命令的处理程序是分开的。/status 仅报告当前会话是就绪还是工作中及其配置的模型；它不会暴露聊天/会话标识符。该机器人及其 DSH 配置文件必须是轮询该令牌的唯一实例。不要在 YAML 中配置令牌或用户 ID。DSH 状态、调度发件箱和独占轮询器套接字也位于该数据目录中。该捆绑包不包含任何应用程序特定的角色设定或工作区路径。
此 DSH 进程中的所有 agent 在创建时都被固定为 cwd 和 workspace-write；所有 LLM 流（包括辅助调用和恢复的会话）都被限制为完全配置的 provider/model。为此插件提供一个专用的 DSH profile/进程，不要与无关 agent 共享。将部署的沙箱和权限预设配置为禁止提权；仅靠 bridge 无法阻止其他 Host 集成中的直接模式切换。DSH 的 workspace-write 还允许临时写入 /tmp、全局读取和网络访问。受信任的 Host 将其自身状态写入 agent 工作区之外。以 read-only 配置的定时任务会在提示前显式切换权限预设。

要选择启用定时 DSH 技能提示，请设置 enableSchedules: true、有效的 IANA timeZone 以及 jobs 条目，其中包含唯一 id 和 label、hour（0–23）、minute（0–59）、可选的 weekday（Mon…Sun）、prompt 和 permissionPreset（read-only 或 workspace-write）。例如：

enableSchedules: true
timeZone: Europe/Zurich
jobs:
- id: daily-report
label: Daily report
hour: 7
minute: 0
prompt: /daily-report
permissionPreset: read-only

该适配器在内部进行调度，而非通过 DSH 的 reminder 插件。它会跳过延迟超过两分钟的运行，并且不会补跑停机期间的任务。在模型工作之前会先固定一个时间槽：生成最多运行一次。完成的文本或失败通知会存储在持久化 outbox 中；Telegram 发送会按分块进度重试，但 Telegram 接受某个分块后发生的传输错误仍可能导致该分块重复。交互式入站更新会在执行前被确认；崩溃可能丢失一次更新。这并非精确一次投递。请监控初始的定时运行。

对于共享同一会话存储的 Web GUI，请仅从 Web Host 使用可选的 workspace-reconciliation.js 插件（配置 workspacePath 和 agentPreset）对外部 Telegram 会话进行分组；切勿在同一 JSON 存储上挂载两个工作区注册表。它会扫描持久化的会话头，将匹配的会话附加到现有工作区，并且绝不会启动另一个 Telegram 轮询器。

卸载方法：dsh plugin --profile telegram remove dsh-telegram-bridge。

测试与许可证

在安装 DSH 对等依赖后运行 npm test。需要与 DSH 0.1.7-rc.2 或 0.2.0-rc.1 兼容的安装，并包含基础 Agent、Session、SessionQuery、preset registry 和 Cordis 服务。自动压缩由使用方 profile 的 agent preset 提供，而非此 bridge。MIT；参见 LICENSE。