前言¶
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 部署以及不同工作区部署，配置根据实际环境调整。
