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）。