dsh-agent-bridge：飞书机器人与 DSH 会话的桥接

DSH（DeepSeek Harness）以插件化著称，但在将外部流程（如飞书机器人）直接接入本地 DSH 会话时，往往需要额外的桥接层。dsh-agent-bridge 旨在解决这一痛点，它允许飞书机器人将任务发送到 DSH，让 DSH 在指定工作区处理这些任务，并将结果回传回飞书。

这是一个由 CAI-MH 维护的 DSH bundle，主要功能是“飞书机器人 → DSH 会话桥”。它作为独立守护进程运行，接收来自飞书机器人的任务，在用户指定的工作区开启“真会话”，注入对应的人设、技能或知识库，调用 DSH 现有的模型和插件执行任务，最后将结论回传至飞书。

核心功能¶

真会话桥接：在指定工作区开真会话。
任务执行：用 DSH 现有模型+插件执行任务并回传结论。
协议转换：提供飞书机器人 → DSH 会话的连接能力。

安装与启用¶

目前未找到官方提供的安装命令。该插件通常作为 DSH bundle 注册在 web profile 的 dsh.profile.bundles 中，node_modules 为副本。若需修改代码，需修改本目录后重新拷贝进 node_modules，并重启 DSH Desktop 生效。

配置与接口¶

接口仅监听 127.0.0.1，需共享密钥。默认监听端口为 127.0.0.1:49990。共享密钥文件路径为 ~/.dsh/agent-group-bridge.token（缺失时自动生成）。

修改端口或密钥路径需要在 web profile 的补丁配置中修改。路径通常位于：

~/Library/Application Support/dsh-desktop/harness/profiles/web/cordis.patch.yml

示例如下：

- id: agent-bridge
  config:
    port: 49990
    tokenFile: /Users/xxx/.dsh/agent-group-bridge.token

典型用法¶

工作区匹配规则¶

任务文本中若包含某个 DSH 工作区的标题或路径（忽略空格），任务将投递到该工作区；未识别到则报错，要求用户写明工作区。每个新任务在目标工作区下开一个新会话，续作（回复完成消息）复用同一会话继续。

接口调用¶

接口仅允许 127.0.0.1 访问，需共享密钥。

提交任务

    POST /run

Body:

    {
      "agent": "default",
      "system": "You are a helpful assistant.",
      "knowledge": "path/to/knowledge",
      "task": "Analyze this file",
      "chatId": "12345",
      "sessionId": "optional_session_id"
    }

Response:

    {
      "taskId": "abc123"
    }

查询状态

    GET /status?taskId=abc123

Response:

    {
      "status": "completed",
      "result": "Final text conclusion",
      "error": null,
      "workspace": "My Workspace",
      "sessionId": "sess_123"
    }

健康检查

    GET /health

适用场景与注意¶

该插件适用于需要将飞书机器人流程与 DSH 本地工作流打通的场景。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。