dsh-astrbot-ingress

dsh plugin --profile web add dsh-astrbot-ingress

dsh-astrbot-ingress

HTTP ingress that lets AstrBot drive a local

DeepSeek Harness agent:

AstrBot stays the IM gateway, DSH does the coding.

把 AstrBot 接到本机 DeepSeek Harness：AstrBot 继续当 IM（OneBot / 官方渠道），DSH 当写代码的脑。

QQ / NapCat ──OneBot──▶ AstrBot ──HTTP──▶ 本插件 :3188 ──▶ ctx.agents

不绑定某一台电脑的盘符：同机、Docker、换工作区都只改配置。

快速开始（只有一个必填项）

# ① DSH 侧
dsh plugin --profile web add github:CCYellowStar2/dsh-astrbot-ingress
# 重启 dsh web；控制台出现 "listening on http://127.0.0.1:3188" 即成功

② AstrBot 侧装 astrbot_plugin_dsh

（WebUI 插件页填仓库地址，或在插件市场搜「DSH 桥」），重载插件。

③ 唯一要填的配置是 token：抄 %DSH_HOME%/dsh-astrbot-ingress/config.json 里的那段，粘进

AstrBot 插件配置的 token。（AstrBot 与 DSH 同一台机器时连这个都能留空 —— 插件会读

%DSH_HOME%/astrbot-ingress.json 这个信标文件。）

④ 回聊天窗口发 /dsh 你好。

地址不用填：ingress_url 留空时会自己探 —— 同机信标文件 → host.docker.internal:3188 →

127.0.0.1:3188 → 你列的候选，/health 第一个通的才用。文件也不用挂盘：入站大附件走一次性

URL（/api/file/<token>，DSH 自己下载），出站文件这边看不到时插件向 ingress 要一次性凭证拉过来再发。

你的情况 · 除了 token 还要填什么

AstrBot 与 DSH 同一台机器 · 什么都不用（token 也留空）

AstrBot 在 Docker、DSH 在宿主机（官方 compose） · 只填 token

Linux 上的 Docker · 同上 + compose 加 extra_hosts: ["host.docker.internal:host-gateway"]

宿主机映射端口不是 6185（如 6185 → 10000） · inbound_url_candidates 填宿主端口（10000）—— 只影响走 URL 的那条入站通道

ingress 不在 3188 / 不在同一台机器 · ingress_url（或 ingress_url_candidates）

AstrBot 与协议端（NapCat/SnowLuma）分容器且挂载点不同名 · send_protocol_path（+ 需要时 send_outbox_dir）

# compose 里给 AstrBot 的那两行（Linux 才需要；Windows/macOS 的 Docker Desktop 自带）
services:
  astrbot:
    extra_hosts:
      - "host.docker.internal:host-gateway"

安装

1. DSH 侧插件

# npm（推荐：预构建产物，不用为构建脚本额外授权）
dsh plugin --profile web add dsh-astrbot-ingress

# 或从 GitHub 直接装（plugin add 转发给 pnpm，支持 github: / git+https: / 本地路径）
dsh plugin --profile web add github:CCYellowStar2/dsh-astrbot-ingress

# 或先 clone，再装本地目录
git clone https://github.com/CCYellowStar2/dsh-astrbot-ingress
dsh plugin --profile web add ./dsh-astrbot-ingress

重启 dsh web，控制台应出现：

dsh-astrbot-ingress: listening on http://127.0.0.1:3188

Token 写在 %DSH_HOME%/dsh-astrbot-ingress/config.json（Linux/macOS 通常是 ~/.dsh/dsh-astrbot-ingress/config.json）。

顺手还会把实际端口 + token写进 %DSH_HOME%/astrbot-ingress.json（0600，每 30 秒刷新），

同机的 AstrBot 插件自动读它——所以同机部署不用手填地址和 token。

2. AstrBot 侧插件

把 astrbot_plugin_dsh/ 拷进 AstrBot 的 data/plugins/（或在 AstrBot WebUI 的插件页用仓库地址

https://github.com/CCYellowStar2/astrbot_plugin_dsh 安装），再重载插件。同机：ingress_url 与

token 留空即可（自动读上面的信标文件）；AstrBot 在容器里：填 http://host.docker.internal:3188

与手抄的 token。插件自身的说明见 astrbot_plugin_dsh。

配置

DSH 侧（profile 的 cordis.patch.yml）

- id: dsh-astrbot-ingress
  config:
    host: 127.0.0.1
    port: 3188
    cwd: ''                   # 默认工作区；留空 = DSH 已登记的第一个工作区
    reasoningMode: first-line # off | first-line | full
    showToolCalls: true
    toolLineBatch: 5
    progressMode: digest      # digest | full | minimal
    progressIntervalSec: 60   # 10-300
    beacon: true              # 写 ~/.dsh/astrbot-ingress.json（端口+token）供同机 AstrBot 自动发现

项 · 默认 · 说明

host / port · 127.0.0.1 / 3188 · 默认只监听本机

cwd · 空 · 默认工作区；留空则用 DSH 已登记的第一个

maxMessageChars · 1500 · 单条消息上限（超出自动切块）

approvalTimeoutSec · 600 · 审批 / 提问等你回答的上限

progressMode · digest · 过程怎么发（见下）

progressIntervalSec · 60 · digest 的汇报间隔（10-300），必须小于 AstrBot 的 timeout_sec

reasoningMode · first-line · 思考内容：off / 只发第一行 / full 全文

showToolCalls · 开 · full 档是否发工具行；digest 档是否把工具次数写进汇报

toolLineBatch · 5 · full 档连续工具行并成一条（1 = 每条单发）

beacon · 开 · 把实际端口与 token 写进 %DSH_HOME%/astrbot-ingress.json（0600），供同机 AstrBot 自动发现；不想写就设 false

inboundUrlMaxMb · 200 · URL 入站的单文件上限（AstrBot 侧 inbound_url_max_mb 也要够）

inboundUrlTimeoutMs · 60000 · 单个 URL 的下载超时

outboundUrlMaxMb · 200 · 出站文件「拉取凭证」的单文件上限（AstrBot 侧 outbound_pull_max_mb 也要够）

endGraceMs · 1200 · 每条助手消息的最后一段只压这么久等 turn/end 来拼 —— 本回合结束；等不到就先发正文。别设太大（设成几千毫秒就会重新出现「正文慢一拍」的手感）

traceLog · 关 · 诊断追踪：把 adopt-turn / drop-stale / grace-flush / turn-end 写进 %DSH_HOME%/dsh-astrbot-ingress/trace.log（>1MB 自动归档 .old）。只在排查跨进程时序时开

过程档位通常由 AstrBot 侧的 progress_mode 逐次带过来，这里的值只是「请求没带」时的兜底：

值 · 群里看到

digest（默认） · 每 progressIntervalSec 秒一条 ⏳ 已跑 3 分钟 · 工具 7 次 · 最近：edit · bash

full · 实时发思考首行 + 工具行 + 心跳摘要

minimal · 过程不出声

三档都照发：最终结果、文件、报错、任务已停止、附件提示、权限确认，以及 —— 本回合结束。

AstrBot 侧

项 · 同机 · AstrBot 在 Docker、DSH 在宿主机

ingress_url · 留空（自动读 %DSH_HOME%/astrbot-ingress.json 里的实际端口） · 一般也留空（自动探 host.docker.internal:3188）；只有 ingress 不在默认端口 / 不在本机才手填

token · 留空（同上，从信标里读） · 与 DSH config.json 相同（唯一的必填项）

allow_users / allow_groups · 空 = 仅管理员 · 同左

send_file_mode · direct · auto（出站文件有拉取兜底；出站图片 / 视频要共享目录时才填 shared）

send_protocol_path · 留空 · 出站图片 / 视频要落盘给协议端时填，如 /app/napcat/data/dsh-outbox、/app/snowluma-data/dsh-outbox

send_outbox_dir · 留空 · 仅当两边挂载点不同名时填（AstrBot 侧那个名字）

inbound_share_dir · 留空 · 入站大文件（>12MB）暂存目录（AstrBot 侧）。同机留空即可 —— 自动用 DSH 当前工作区下的 .dsh-inbox；分容器才填，如 /mnt/d/proj/.dsh-inbox

inbound_dsh_prefix · 留空 · 仅分容器时填：同一目录在 DSH 侧的写法，如 D:\proj\.dsh-inbox（同机两边是同一个路径）

inbound_url_base · 留空 = 自动探测 · URL 入站：DSH 能访问到的 AstrBot 基址（宿主视角），如 http://127.0.0.1:10000。填了就固定用它

inbound_url_candidates · 空 · URL 入站的候选（裸端口或完整地址）。宿主机映射端口不是 6185 时写这里，如 10000；插件会让 DSH 侧先真取一次，第一个通的才用

ingress_url_candidates · 空 · ingress 地址的额外候选；留空时内置 host.docker.internal:3188 / 127.0.0.1:3188，自动探测

outbound_pull · 开 · 出站文件本地看不到时从 in

…(truncated)