dsh-autoconfig
Manifest valid★ 3DSH network device terminal plugin: SSH/Telnet/serial console/SFTP with a right-side xterm, session bar, keyword highlighting and per-device logs.
dsh-autoconfig
给 DSH(DeepSeek Harness)用的网络设备自动配置终端插件。基于 dsh-ssh-ops 的「主对话驱动 + 右侧终端」架构重新实现,面向路由器、交换机、防火墙等设备的日常配置与排障。
安全提示(重要):SSH 主机密钥校验默认关闭(
hostVerifier: () => true),存在中间人攻击风险。请仅在可信管理网络使用;需要校验时,修改src/transport-ssh.js中的hostVerifier,接入~/.ssh/known_hosts或设备指纹白名单。详见文末安全说明。批准模型与写权限边界(重要):本插件的配置计划审批属于流程性防护,不构成强制访问控制。默认流程为:
plan_create展示计划 → 操作者在对话中明确同意 → Agent 调用plan_approve记录批准哈希 →plan_execute校验后分步执行。由于plan_approve仍由 Agent 发起,在提示词注入、模型策略偏差或工具编排错误的情况下,存在 Agent 未经操作者真实批准即写入配置 的可能。若需将写权限收紧为更强的门禁,可在~/.dsh/autoconfig-rag.json中设置"requirePanelApproval": true:此时宿主会拒绝plan_approve,只有右侧「计划」抽屉中由操作者点击才能写入批准哈希。更严格的做法是移除或禁用 Agent 的plan_execute工具,由前端完成执行;最终仍应以设备侧 AAA / 命令授权作为安全边界。详见安全说明。原生依赖:串口功能依赖
serialport原生绑定。pnpm/DSH 安装器通常会写入allowBuilds并重试,但若本机没有预编译包且缺少编译工具链,安装可能失败。Windows 需要 Visual Studio Build Tools 的“使用 C++ 的桌面开发”和 Python 3;Linux 需要build-essential与python3。不使用串口时,SSH/Telnet/SFTP 不受影响。
1.0.0 能做什么
一句话:把「查手册 → 认设备 → 出计划 → 人批准 → 逐步下发 → 出错自愈 → 留痕」串成一个可审计的闭环。
典型工作流
- 建库:在右侧「知识库」上传 PDF / CHM / MD 手册,填写厂家、系列、型号、适用版本;后台建立 TGM + BM25 + 本地向量索引。
- 接设备:通过 SSH / Telnet / Console 连接交换机、路由器或防火墙;插件自动采集
display version、序列号、hostname 等只读信息。 - 核验:把设备厂家/型号/版本与手册匹配;有精确匹配时只用精确手册,否则明确提示风险。
- 提需求:在对话里说“给 Vlan-interface1000 配 11.1.1.1/24,并加一条 121.1.1.0/24 指向 11.1.1.2 的静态路由”。
- 审计划:
plan_create返回完整计划——每条命令的中文解释、验证命令、回滚命令、风险等级、手册页码;视图检测会自动去掉/补充system-view。 - 批准:默认在对话中确认后由
plan_approve记录批准;严格模式只允许右侧「计划」抽屉的按钮批准。 - 分步执行:命令逐条写入右侧终端,终端留下
[plan] 命令 — 解释与[plan verify]标记;任一步失败立即暂停。 - 验证与回滚:执行后自动跑验证命令;不通过或需要撤销时,按计划里的回滚命令恢复。
- 出错自愈:识别
^错误位置,用?逐词探测(不回车、不执行),修订计划后重新批准;失败样本进入本地案例库,后续计划自动提示相似坑。 - 审计:会话日志、设备档案、计划 JSON、错误案例全部落盘,可导出、可复核。
具体能干什么
| 场景 | 能力 |
|---|---|
| 手册问答 | 问“怎么配日志服务器/Telnet/VLAN/静态路由”,返回手册章节、页码/行号与原文片段 |
| 设备识别 | 自动识别 H3C/Huawei/Maipu/Ruijie/Cisco 的提示符、型号、版本、序列号 |
| 配置生成 | 基于检索到的命令生成带解释、验证、回滚的计划,不再靠模型凭空猜命令 |
| 计划审批 | 一次批准整份计划;计划改动一个字即失效,需重新确认 |
| 终端执行 | 按步骤写入右侧终端,命令与解释同步显示,失败即停 |
| 错误修复 | 解析 % ... at '^' position,? 探测候选关键字,修订后重批重跑 |
| 多厂商 | Comware / VRP / Maipu / IOS 的视图切换、保存、错误提示差异 |
| 知识库管理 | CHM/PDF/MD 上传、重建索引、预览、删除;CHM 构建中断可恢复 |
| 设备档案 | 按序列号保存档案,导出/导入,供后续配置复用 |
| 审计留痕 | 会话 .log + .json、计划 JSON、错误案例 JSONL |
一个完整例子
你:给 192.168.0.200 的 Vlan-interface1000 配 11.1.1.1/24,
再加一条 121.1.1.0/24 指向 11.1.1.2 的静态路由。
插件:device_profile → H3C S5820V2-54QS-GE / 7.1.075 / SN DPPMWWB76
kb_search → H3C 手册 70-BGP… 3.4.1 / 43-Portal… 4.5.1
plan_create → 计划(含解释、验证、回滚、风险)
你:批准
插件:plan_approve → plan_execute → 终端逐条执行 → display 验证
边界(它不做什么)
- 不替代设备侧 AAA、命令授权、ACL 和变更审计;插件批准不是密码学安全边界。
- 不保证扫描版 PDF、纯图片 CHM 的识别效果;这类文档需要先 OCR 或提供文字版。
- 不做自动配置备份、合规扫描、拓扑发现;这些需要额外工具或脚本。
- 不自动执行高风险命令;
save、reboot、undo管理面等仍逐条展示并由操作者批准。 - 不替用户保存设备密码到日志或模型上下文;密码只进入 DSH 凭据库/连接表单。
功能
- 右侧终端面板:在官方右侧边栏注册「自动配置终端」标签页。AI 的每一次连接、输入、读取和 SFTP 操作都会显示在同一个终端里,操作者可以全程审计。
- 四种接入方式
ssh:ssh2 交互式 shell(PTY),支持密码 / 私钥 / keyboard-interactive,支持旧设备 SHA-1 group14 KEX 回退。telnet:原始 TCP + RFC 854 选项协商(ECHO/SGA/TTYPE/NAWS),可自动回答login:/Password:。console:串口(COMx //dev/ttyUSBx),默认 9600 8N1,可自动登录。sftp:SSH 认证后只打开 SFTP 子系统;SSH 连接也可以随时切到「文件」页做 SFTP 操作。
- 自动会话日志:连接建立即开始记录,文件名形如
SW-Core_10.1.1.1_20261027-231530.log(<hostname>_<ip>_<YYYYMMDD-HHmmss>.log)。设备提示符中识别到真实 hostname 后会自动重命名日志;未填写设备名时先用device占位(如device_10.1.1.1_...log),识别后再重命名。同目录下有同名.json元数据。 - AI 工具:
device_connect/device_list/device_send/device_read/device_close/device_sftp/device_logs,以及 1.0.0 的kb_search/kb_docs/device_profile/plan_*。device_send会在右侧终端留下[agent ...]标记并写入日志的INPUT (agent)记录。 - 左侧会话栏:像 MobaXterm / SecureCRT 一样保存连接过的设备。双击有锁标记(已保存密码)的会话直接重连;没有密码的会话会预填地址,只补密码即可。密码写入 DSH 凭据库,
autoconfig-profiles.json只保存地址、用户名和端口。 - 关键字高亮:内置
colorful-network.ini的 22 条规则(no/down/error红、up/connected绿、协议/端口蓝、路由/ACL 品红、接口/IP/百分比橙),大小写不敏感,按最长匹配避免重叠,且只在整词边界命中(不会把Usage里的ge、Canonical里的no染色)。工具栏「高亮」可随时关闭;已带 ANSI 颜色的设备输出原样保留。 - 终端外观:终端页面默认纯黑背景;工具栏可一键切黑/深蓝黑/浅色,或用取色器选任意颜色。背景与高亮开关保存在浏览器
localStorage(dsh-autoconfig.terminal-background/dsh-autoconfig.keyword-highlight)。 - 日志查看:面板「日志」按钮可预览、下载、删除日志;日志目录默认
~/.dsh/autoconfig-logs。 - 手册知识库(1.0.0):右侧「知识库」抽屉上传 PDF / CHM / MD 技术手册,填写厂家/系列/型号/适用版本;后台建立 TGM(章节树 + 实体图 + 映射)+ BM25 + 本地向量(bge-m3)混合索引,可选 bge-reranker 重排。
- 配置计划与审批(1.0.0):AI 先
device_profile采集厂商/型号/版本/序列号并与手册核验,再kb_search取手册依据;plan_create生成的计划包含每条命令的中文解释、验证命令和回滚命令,并完整展示在对话中。默认由操作者在对话里确认后,AI 调用plan_approve记录“对话批准”,再plan_execute分步写入终端;右侧「计划」抽屉保留手动批准入口。设置requirePanelApproval: true后,对话批准被宿主拒绝,只有面板按钮能完成批准。批准与命令哈希绑定,改一个字即失效,执行中失败立即暂停。 - 错误识别与
?自愈(0.2.0):识别 Comware / VRP / IOS 的^错误位置与% ... found at '^' position提示,用?逐词探测(不回车、不执行),修正后计划回到 draft 由操作者重新批准;失败样本写入本地案例库并注入后续计划。 - 视图自适应(0.2.1):
plan_create读取终端当前提示符(<H3C>用户视图 /[H3C]系统视图 /[H3C-xxx]子视图),已在系统视图时自动移除重复的system-view,在用户视图时自动补充system-view,子视图会给出警告;执行时再次检测,重复的视图切换命令直接跳过并留下[plan skip]标记。
手册知识库与配置计划(1.0.0)
这一版把 BookRAG 的检索能力内置为本地 sidecar(Python),插件只通过 127.0.0.1 的随机端口和一次性 token 访问它;浏览器不直连 sidecar。
- 数据目录:默认
~/.dsh/autoconfig-kb,可用~/.dsh/autoconfig-rag.json覆盖:
{
"dataDir": "E:\\dsh-autoconfig-data",
"python": "E:\\dsh-autoconfig-data\\.venv\\Scripts\\python.exe",
"modelPath": "E:\\dsh-autoconfig-data\\models\\bge-m3",
"device": "cuda",
"autoStart": true
}
- Python 环境(首次使用,手动准备一次):
E:\Python312\python.exe -m venv E:\dsh-autoconfig-data\.venv
E:\dsh-autoconfig-data\.venv\Scripts\python.exe -m pip install -r sidecar\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
E:\dsh-autoconfig-data\.venv\Scripts\python.exe -m pip install torch==2.5.1+cu121 --index-url https://download.pytorch.org/whl/cu121
E:\dsh-autoconfig-data\.venv\Scripts\modelscope.exe download --model BAAI/bge-m3 --local_dir E:\dsh-autoconfig-data\models\bge-m3
# 可选重排模型:
E:\dsh-autoconfig-data\.venv\Scripts\modelscope.exe download --model BAAI/bge-reranker-v2-m3 --local_dir E:\dsh-autoconfig-data\models\bge-reranker-v2-m3
- 无 GPU:把
device改成"cpu"即可;没有向量模型时仍可用 BM25 + TGM 词法检索。 - 文档元数据:上传表单记录厂家、系列、型号、适用版本;检索先按厂家硬过滤,再按型号/版本匹配排序,避免把华为的命令发给 H3C 设备。
- 新增工具:
kb_search/kb_docs/device_profile/plan_create/plan_approve/plan_execute/plan_status/plan_diagnose/plan_revise/plan_abort。 - 行为约束:
plan_execute在 host 侧校验批准哈希;AI 必须先把完整计划展示在对话中,取得用户明确同意后才能调用plan_approve,不能跳过对话直接批准。?探测只输入、不回车;save/reboot/undo管理面等高风险命令在计划里单列风险,执行前由操作者对整份计划一次确认。
安装
方式一:GitHub(推荐,1.0.0)
# desktop profile
dsh plugin --profile desktop add github:liuxin4566-web/dsh-autoconfig#v1.0.0
# web profile
dsh plugin --profile web add github:liuxin4566-web/dsh-autoconfig#v1.0.0
等价写法:dsh plugin --profile desktop add git+https://github.com/liuxin4566-web/dsh-autoconfig.git#v1.0.0。
方式二:npm
npm 包名:dsh-autoconfig。若 npm 上的最新版本仍低于 1.0.0,请使用上面的 GitHub 方式或本地 tgz。
dsh plugin --profile desktop add dsh-autoconfig@1.0.0
# 或 dsh plugin --profile web add dsh-autoconfig@1.0.0
1.0.0 升级提示:本版本合并了本地手册 RAG、设备档案核验、配置计划、视图自适应、对话批准、
requirePanelApproval严格模式、错误自愈与 CHM 构建加固。升级后请完全退出并重启 DSH Desktop(含托盘),再刷新页面;仅热重载不会刷新工具清单、宿主路由和客户端 bundle。完整变更见 CHANGELOG.md。
方式三:本地 tgz
# 在插件源码目录构建并打包
pnpm install
pnpm pack
# 安装到 desktop profile(DSH Desktop 使用的 profile 名)
dsh plugin --profile desktop add .\dsh-autoconfig-1.0.0.tgz
若 dsh 不在 PATH,请使用 DSH 安装目录中的 dsh/dsh.cmd,或通过官方 npm 包执行:
npx @deepseek-ai/dsh plugin --profile desktop add .\dsh-autoconfig-0.2.1.tgz
dsh plugin add 会把包加入 profile 依赖,并自动把声明了 dsh.bundle 的包加入 dsh.profile.bundles。当前 DSH 桌面版是 live profile,通常会热加载;若没有出现标签页,完全退出并重启 DSH Desktop。
SSH/SFTP 使用的
ssh2已内联进宿主产物(MIT),因此不依赖 profile 对ssh2的模块解析;只有串口需要的serialport是运行时依赖。若 profile 暂时无法访问 npm,可先复制lib、locale、package.json、cordis.patch.yml到%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-autoconfig,并把dsh-autoconfig加入 profile 的dependencies与dsh.profile.bundles(串口功能仍需serialport及其预编译绑定)。
串口依赖
serialport 带原生绑定,常见平台会优先使用预编译包。若 profile 的 pnpm 拦截了构建脚本,需要允许:
# ~/.dsh/profiles/desktop/pnpm-workspace.yaml
allowBuilds:
'@serialport/bindings-cpp@13.0.0': true
然后重新执行安装命令。若没有匹配的预编译包,需要本机编译:
- Windows:安装 Visual Studio Build Tools,勾选“使用 C++ 的桌面开发”,并安装 Python 3。
- Linux:
sudo apt-get install -y build-essential python3。 - macOS:安装 Xcode Command Line Tools:
xcode-select --install。
SSH/Telnet/SFTP 不依赖串口绑定;即使 serialport 不可用,这三类连接仍可正常使用。
使用
- 打开右侧边栏,选择「自动配置终端」标签页(或点「+ 连接」)。
- 选择 SSH / Telnet / 串口 / SFTP,填写地址和凭据。
- 在终端里直接操作;也可以回到对话让 AI 操作:
连接 10.1.1.1 的 SSH,用户名 admin,密码 ...,设备名 core-sw-1
AI 会调用 device_connect,随后用 device_send / device_read 执行和读取命令。右侧终端会同步显示 AI 的每条输入与设备输出,日志自动落盘。
日志格式
==============================================================================
dsh-autoconfig session
protocol : ssh
hostname : SW-Core
host : 10.1.1.1:22
ip : 10.1.1.1
username : admin
started : 2026-10-27T15:15:30.000Z
log : SW-Core_10.1.1.1_20261027-231530.log
==============================================================================
<设备原始输出>
### [2026-10-27T15:15:35.123Z] INPUT (agent): display version
<设备输出>
### [2026-10-27T15:16:02.000Z] [sftp] LIST /cfg -> 8 entries
==============================================================================
session closed 2026-10-27T15:20:00.000Z exit=0 bytes=12345
==============================================================================
- 日志默认单会话上限 32 MB,目录上限 512 MB(超出按最旧优先清理)。
- 密码类输入可通过
device_send的sensitive=true脱敏;Telnet/串口自动登录的凭据不会写入日志。 - hostname 在识别到之前使用「设备名称」或 IP/串口名占位,识别后原地重命名(保留连接时间)。
已知限制
- 高亮只装饰完整且不含 ANSI 转义的行:提示符和进度行会立即原样显示(避免为等高亮而延迟输入),设备自带颜色的输出保持原色。
- 串口 Console 的传输层已按 9600 8N1 默认实现并完成端口枚举验证;实际数据收发仍建议在目标 COM 设备上做一次联调。
- 高亮规则来自
colorful-network.ini,固定内置,暂不提供运行时编辑入口。
安全说明
- SSH 主机密钥校验默认关闭(
hostVerifier: () => true)。网络设备的自签名/经常重置的主机密钥使 TOFU 很难维护;请仅在可信管理网络中使用,或按需在src/transport-ssh.js中接入 known_hosts。 - 配置计划批准模型:默认的“对话批准”由 Agent 调用
plan_approve完成,属于流程性防护,不是强制访问控制。plan_execute虽然会校验批准哈希,但批准动作本身仍由 Agent 发起;在提示词注入、模型策略偏差或工具编排错误时,存在未经操作者真实批准即写入配置的可能。 - 更严格的写权限门禁:在
~/.dsh/autoconfig-rag.json中设置"requirePanelApproval": true,宿主会拒绝plan_approve,只有右侧「计划」抽屉中由操作者点击的批准才能写入哈希。更严格的做法是移除或禁用 Agent 的plan_execute工具,仅保留前端执行。即使如此,若 Agent 能直接访问宿主 HTTP 接口,仍不能视为密码学意义上的安全边界。 - 最终边界:生产环境应通过网络设备侧的 AAA、命令授权/分级、ACL 和变更审计限制实际写权限;插件侧的批准机制只用于降低误操作与误编排风险。
- 凭据只在连接时从面板/工具传入,不写入日志、不返回给模型;但会存在于 DSH 进程内存和浏览器的连接表单中。
- 会话栏密码保存在 DSH 凭据库(
ctx.credentials,引用名形如DSH_AUTOCONFIG_..._PASSWORD),不写入~/.dsh/autoconfig-profiles.json;删除会话时同时删除对应凭据。AI 工具发起的连接只记录地址,不保存密码。 - 所有设备命令由操作者或 AI 发起,插件本身不做命令白名单;请通过 DSH 权限与设备侧 AAA 控制风险。
社区与反馈
- 社区插件市场与提交入口:dsh-plugin.org/zh/submit
- 问题反馈:GitHub Issues
- GitHub 仓库:liuxin4566-web/dsh-autoconfig
开发
pnpm install
pnpm run build
node --test test/*.test.mjs
src/index.js:host 服务(连接、终端流、日志、SFTP、RPC)。src/transport-ssh.js/transport-telnet.js/transport-serial.js:传输层。src/log-store.js:日志命名、写入、重命名、轮转。src/client/:右侧面板、xterm、连接对话框、SFTP 文件浏览、日志对话框。scripts/build-host.mjs/build-client.mjs:esbuild 打包(host ESM + client CJS wrapper)。
兼容性
- DSH Desktop 0.2.x / Web profile(
sidebarRightTabs+sidebarRight)。 - 右侧面板复用官方 Sidebar 的宽度、分屏、全屏、折叠,不提供旧的浮动抽屉回退。
Comments
Loading…
Similar plugins
by hoshinoick811
MobaXterm-style SSH/SFTP tool plugin for DeepSeek Harness (DSH): saved connection profiles, persistent multiplexed sessions, remote command execution, SFTP file transfer, and a web GUI console with fi
★ 4
MIT
JavaScript
Sep 6, 2026
dsh plugin --profile web add dsh-tool-sshby JUNQINGV587
Multi-server SSH terminal panel for the DSH Web GUI: floating terminal window with tabs, side-by-side groups, broadcast, host-owned persistent sessions, and password/private-key/SSH-agent auth.
★ 0
MIT
JavaScript
Aug 19, 2026
dsh plugin --profile web add dsh-ssh-hubby jmcc-guo
SSH terminal panel & AI connection manager for DeepSeek Harness — model-driven connect/exec/list/status/disconnect tools plus an XShell-style multi-tab terminal in the Web GUI.
★ 4
↓ 56/wk
MIT
JavaScript
Sep 10, 2026
dsh plugin --profile web add @jmcc-guo/dsh-sshDSH plugin: password SSH into a remote host — a natural-language tool (connect/exec/close/status) over a persistent ControlMaster session, plus a browser terminal panel (right-side floating) with a real PTY over WebSocket.
★ 0
dsh plugin --profile web add dsh-ssh-shellby techflag
SSH terminals, SFTP file transfer and text editing inside DeepSeek Harness, with server troubleshooting through host models.
★ 1
↓ 178/wk
MIT
TypeScript
Sep 9, 2026
dsh plugin --profile web add dsh-plugin-sshby cccodder
Right-sidebar SSH remote console for DeepSeek Harness: host menu, PTY capture, unified human+agent log, and agent tools that write into the same terminal.
★ 1
MIT
JavaScript
Oct 25, 2026
dsh plugin --profile web add dsh-remote-console