前言¶
DeepSeek Harness 負責「寫代碼」，AstrBot 負責「IM 通訊」。兩者之間需要一個 HTTP 入口。這個插件就是這個入口。它讓 AstrBot 保持 IM 網關的角色，把任務交給本機的 DeepSeek Harness 執行。
插件名稱爲 dsh-astrbot-ingress，由 CCYellowStar2 維護，採用 MIT 許可證。
安裝與啓用¶
1. DSH 側安裝¶
在 DSH Web 側執行以下命令：
dsh plugin --profile web add github:CCYellowStar2/dsh-astrbot-ingress
安裝完成後，重啓 dsh web，控制台應出現監聽端口的提示信息。
2. AstrBot 側安裝¶
需要在 AstrBot 側安裝對應的插件 astrbot_plugin_dsh。可以在 AstrBot 的 WebUI 插件頁通過倉庫地址安裝，或者將 astrbot_plugin_dsh 目錄拷貝到 AstrBot 的 data/plugins/ 目錄下並重載。
核心功能¶
- HTTP ingress for AstrBot：提供 HTTP 接口供 AstrBot 調用。
- Agent 驅動：允許 AstrBot 驅動本機的 DeepSeek Harness 智能體。
- 文件傳輸：入站文件通過 URL 傳輸，出站文件通過拉取獲取。
- 會話綁定：支持會話綁定與管理。
- 進度彙報：提供 digest（摘要）、full（全量）、minimal（極簡）三種進度彙報模式。
- 推理模式：支持關閉、僅展示首行或展示全文的推理模式。
- 協議支持：支持 OneBot 協議及官方 IM。
典型用法¶
喚醒詞默認爲 /dsh（可在 AstrBot 配置中修改）。以下是常用命令：
/dsh 你好：發送任務/dsh status：查看當前狀態/dsh ws [n|路徑]：切換或指定工作區/dsh ls：列出當前會話文件/dsh use <n|短id>：綁定會話/dsh new：新建任務/dsh end//dsh stop：結束或停止任務/dsh steer <話>：引導對話/dsh rename <標題>：重命名任務/dsh model [n|provider/model] [effort]：切換模型/dsh perm [n|名字]：設置權限/dsh compact：壓縮上下文/dsh last [N]：發送最近 N 條歷史回覆/dsh send <路徑>：發送文件
注意事項¶
- 雙插件依賴：需要同時安裝 DSH 側的
dsh-astrbot-ingress和 AstrBot 側的astrbot_plugin_dsh。 - Token 機制：配置中需要填寫 Token，除非 AstrBot 與 DSH 運行在同一臺機器上（此時插件會讀取信標文件自動獲取）。
- 文件大小限制：入站文件大於 12MB 時，會通過 URL 進行傳輸。
- 角色分工：AstrBot 扮演 IM 網關，DSH 負責執行具體的編碼任務。
- 部署靈活性：支持同機部署、Docker 部署以及不同工作區部署，配置根據實際環境調整。
