dsh-console-hub
DSH 插件：网络设备 console 映射端口（Telnet / Raw TCP）会话管理 —— 配置增删改查（敏感信息存 credentials）、连接/关闭/发送/读取、分页自动处理，模型侧 console_* 工具，高危指令 approval 拦截。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:RBkreb/dsh-console-hub#572d0e669292838235e754a6509efe1c5fc04c9eConsole Hub 以 dsh-console-hub 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
面向网络设备 console 映射端口（串口服务器 / 终端服务器）的 DSH 插件：经 Telnet 或 Raw TCP 连接设备控制台，提供会话管理、命令交互。
^22.19.0 || >=24.0.0@deepseek-ai/dsh^0.1.5-rc.1、@deepseek-ai/cordis ^4.0.2dsh-better-sidebar ≥ 0.19dsh plugin --profile web add github:RBkreb/dsh-console-hub
安装后重启 dsh
| 工具 | 作用 | 关键参数 | 返回要点 |
|---|---|---|---|
console_list | 已连接控制台（全宿主共享池） | — | consoles[]：handle、label、地址、state、openedBy、dormant |
console_list_views | 已配置设备清单 | — | views[]：viewId、地址、凭据是否已配置 |
console_upsert_view | 新建 / 更新设备配置 | viewId?、name、host、port、kind、encoding、user、promptPattern、pagerPattern、pagingMode、tags、notes、password | viewId、created、secretConfigured |
console_remove_view | 删除配置及其凭据 | viewId | removed、secretRemoved |
console_connect | 连接设备 | viewId 或 host+port、kind、encoding、label、password | handle、state、banner、prompt、reused |
console_send | 发送 | consoleId、text、submit、submitKey、encoding | state、written、pagingActive、dormant |
console_wake | 回车唤醒控制台 | consoleId | answered、dormant |
console_read | 游标增量读 | consoleId、after、encoding、stripEcho、maxBytes | text、cursor、truncated、prompt、dormant |
console_wait_for | 等提示符 / 模式 / 静默 | consoleId、for（prompt/pattern/idle）、pattern、timeoutMs、after、idleMs | matched、reason、matchedText、cursor、dormantBlocked |
console_close | 关闭并释放端口 | consoleId、force | closed |
console_describe | 控制台详情与发送审计 | consoleId | 字节数、prompt、分页状态、audit[] |
console_clear | 丢弃本进程已读回显 | consoleId | cursor、droppedBytes |
本插件的监听与注册全部挂在 fiber 的 effect 上（端口管理器、策略 watcher、模型闸门、HTTP 路由），fiber 释放后回收。
inject: ['settings']——唯一硬依赖；tools、systemPrompt、webServer；credentials、approval、connection、sessions；| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
requestBodyLimitBytes | number | 1048576 | 插件 API 单次请求体上限 |
sessionIdleSweepMs | number | 15000 | 空闲控制台回收的扫描间隔 |
trustedHosts | string[] | [] | 非回环部署被访问的 host:port（或仅 host）；未声明拒绝所有请求 |
连接与读取：
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
defaultKind | 'telnet' | 'raw' | telnet | telnet 剥离协商字节 |
defaultEncoding | encoding 枚举 | utf-8 | utf-8 / gbk / gb18030 / big5 / shift_jis / euc-kr / latin1 |
connectTimeoutMs | number | 8000 | socket 连接预算 |
readTimeoutMs | number | 15000 | 单次 read 等待新字节的时长 |
idleTimeoutMs | number | 600000 | 空闲控制台回收时长（不记保活） |
maxConsoles | number | 16 | 并发控制台上限 |
outputLimitBytes | number | 65536 | 单次 read/wait 携带的字节上限 |
scrollbackLimitBytes | number | 262144 | 会话为游标保留的原字节数 |
idleQuietMs | number | 1500 | for: "idle" 的静默窗口 |
views | 对象 | {} | 设备清单，字段同 console_upsert_view |
分页、提示与休眠：
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
pagingMode | pagingMode 枚举 | auto-more | 缺省分页反应：auto-more 发空格 / auto-quit 发 q / auto-interrupt 发 Ctrl+C / manual 无处理 |
pagingMaxPages | number | 50 | 自动分页上限 |
pagingQuietMs | number | 120 | 分页命中后等待静默窗口 |
promptPattern | string（正则） | 同时接受 <...> / [...] | 缺省提示符模式，大小写不敏感 |
pagerPattern | string（正则） | --More-- / more: / 按任意键等 | 缺省分页正则 |
dormantPattern | string（正则） | Vty connection is timed out. … Please press ENTER. | 设备半关闭标记 |
dormantAutoWake | boolean | true | 检测到半关闭标记时自动唤醒 |
dormantProbeMs | number | 120000 | 无输入保活间隔 |
wakeOnConnect | boolean | true | 连接自动输入回车 |
拦截与模型：
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
approvalMode | 'always' | 'high-risk' | high-risk | always 每条提问；high-risk 未命中规则放行 |
fenceRules | 规则数组 | 回滚 + 重启两条 ask | 有序规则表，第一条命中即定；每条 { id, action, tokens, pattern, note }，tokens 与 pattern 二选一 |
highRiskPatterns | string[] | [] | 遗留字段，仅保留旧式已声明的拦截 |
agentConsoleTools | boolean | true | 是否注册 console_* 工具与 systemPrompt 段落 |
agentInstructions | string | '' | 进模型提示段落的约定 |
动作：deny直接拒绝| ask人工确认| allow放行。
# cordis.yml
- id: dsh-console-hub
name: dsh-console-hub
config:
trustedHosts: [console.example.com:43120]
# 设置文档
dsh-console-hub:
fenceRules:
- id: config-rollback
action: ask
tokens: configuration rollback
note: 用保存的配置覆盖运行配置
- id: no-erase
action: deny
pattern: erase\s+startup-config
note: 抹掉已保存的配置
- id: show-config
action: allow
tokens: show configuration
approvalMode: high-risk
dsh-console-hub/<recordId>DSH_CONSOLE_<RECORDID>（user:pass 或裸密码）优先于存储记录/api 共享 Host/Origin