dsh-autoconfig
DSH Web UI 的网络设备自动配置终端：通过 SSH、Telnet、串行控制台或 SFTP 连接路由器、交换机和防火墙；每项代理操作都会显示在右侧终端中，并记录到按主机名、时间戳和 IP 命名的每台设备专属日志中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:liuxin4566-web/dsh-autoconfig#616740aaf526fede8d82e3f4135555b3f4313ff3Autoconfig 以 dsh-autoconfig 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH（DeepSeek Harness）用的网络设备自动配置终端插件。基于 dsh-ssh-ops 的「主对话驱动 + 右侧终端」架构重新实现，面向路由器、交换机、防火墙等设备的日常配置与排障。
安全提示（重要）：SSH 主机密钥校验默认关闭（
hostVerifier: () => true），存在中间人攻击风险。请仅在可信管理网络使用；需要校验时，修改src/transport-ssh.js中的hostVerifier，接入~/.ssh/known_hosts或设备指纹白名单。详见文末安全说明。原生依赖：串口功能依赖
serialport原生绑定。pnpm/DSH 安装器通常会写入allowBuilds并重试，但若本机没有预编译包且缺少编译工具链，安装可能失败。Windows 需要 Visual Studio Build Tools 的“使用 C++ 的桌面开发”和 Python 3；Linux 需要build-essential与python3。不使用串口时，SSH/Telnet/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 元数据。device_connect / device_list / device_send / device_read / device_close / device_sftp / device_logs。device_send 会在右侧终端留下 [agent ...] 标记并写入日志的 INPUT (agent) 记录。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。已发布到 npm：dsh-autoconfig
dsh plugin --profile desktop add dsh-autoconfig
# 或 dsh plugin --profile web add dsh-autoconfig
dsh plugin --profile desktop add github:liuxin4566-web/dsh-autoconfig
# Web profile：
dsh plugin --profile web add github:liuxin4566-web/dsh-autoconfig
等价写法：dsh plugin --profile desktop add git+https://github.com/liuxin4566-web/dsh-autoconfig.git。
# 在插件源码目录构建并打包
pnpm install
pnpm pack
# 安装到 desktop profile（DSH Desktop 使用的 profile 名）
dsh plugin --profile desktop add .\dsh-autoconfig-0.1.3.tgz
若 dsh 不在 PATH，请使用 DSH 安装目录中的 dsh/dsh.cmd，或通过官方 npm 包执行：
npx @deepseek-ai/dsh plugin --profile desktop add .\dsh-autoconfig-0.1.3.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
然后重新执行安装命令。若没有匹配的预编译包，需要本机编译：
sudo apt-get install -y build-essential python3。xcode-select --install。SSH/Telnet/SFTP 不依赖串口绑定；即使 serialport 不可用，这三类连接仍可正常使用。
连接 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
==============================================================================
device_send 的 sensitive=true 脱敏；Telnet/串口自动登录的凭据不会写入日志。colorful-network.ini，固定内置，暂不提供运行时编辑入口。hostVerifier: () => true）。网络设备的自签名/经常重置的主机密钥使 TOFU 很难维护；请仅在可信管理网络中使用，或按需在 src/transport-ssh.js 中接入 known_hosts。ctx.credentials，引用名形如 DSH_AUTOCONFIG_..._PASSWORD），不写入 ~/.dsh/autoconfig-profiles.json；删除会话时同时删除对应凭据。AI 工具发起的连接只记录地址，不保存密码。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）。sidebarRightTabs + sidebarRight）。