01 / 感知
先确认环境
当前工作区、连接的主机、发行版家族、终端最近的输出与命令块，在每轮对话前进入上下文。
Terminal · SSH · AI Agent
终端里的事，
交给 AI 也不失手
命令逐字写进真实 shell，在提示符处回显；写操作按风险分级拦截，人工确认后才执行； 退出码与 stderr 如实上报。本地 / WSL / SSH 三种工作区，一个窗口。
- 25
- 内置运维工具
- 8
- Linux 运维技能
- 15
- 终端主题
- 3
- 独立进程
左侧远程文件树 · 中间真实终端 · 右侧 AI 运维助手Windows x64 · Tauri 2 + Rust · Strands Agent
Execution Loop
从一句话到一条真实命令，中间没有黑盒
Agent 不是"生成命令让你复制"。它把命令写进当前会话的 PTY / SSH 通道，由远端 shell 自行回显，再把真实结果关联回对应的工具卡。
02 / 思考
规划可见
多步任务先建任务清单并实时同步到对话顶部；循环期间显示"第 N 轮 · 已用工具 M"。
03 / 行动
写进真实 shell
可视模式下命令逐字符写入终端，在提示符处回显；也可选择后台 SSH 通道执行。
04 / 验证
写后必核
写操作后要求只读复核；输出、退出码与耗时进入证据链，非零退出码一律按失败上报。
05 / 记忆
沉淀到工作区
同一工作区内的对话共享长期记忆：会话摘要与排障案例写回知识库，同类问题自动召回。
Capabilities
运维要用的部分，都在同一个窗口里
终端、远程主机、AI 助手、知识库与教学流程共享同一份环境上下文，不需要在工具之间搬运信息。
01
Agent 运行时
- Strands Agents 驱动的唯一 main Agent；工具注册表是实现、Schema 与策略的单一真源
- 25 个内置工具：SSH 执行、远程文件读写、日志分析、进程检查、网络诊断、服务 / 软件包 / 防火墙管理、安全审计、性能分析、知识检索、配置比对、备份恢复、Python 执行等
- 单轮工具调用上限 50 次 + 连续失败 3 次熔断
- LLM 不可用时降级为只读提示；10 分钟无输出自动中止本轮，会话可继续
02
SSH 服务器管理
- 纯 Rust SSH 客户端（russh）；密码 / 公钥认证，凭据存入系统密钥库
- TOFU 主机密钥校验：未知主机弹审批，密钥变更告警
- SFTP 浏览与编辑、拖拽上传、跟随
cwd的远程文件树 - 本地 / 远程 / 动态（SOCKS5）端口转发；服务器实时监控（CPU、内存、磁盘、网络、进程）
03
安全边界
- 当前使用 L0 / L2 / L3 / L4 影响分级（L1 保留兼容）；未识别命令按高危险处理
- 灾难性操作硬底线黑名单：直接拦截，不提供审批选项
- 同会话审批 FIFO：上一条命令未返回前不展示下一条审批卡
- 输出脱敏后才进入界面、模型上下文与日志；SSH 退出码作为结果硬边界
04
本地知识检索
- 索引本机已有或用户导入的文档与笔记，内容量以设备上的实际数据为准
- 会话摘要与成功排障案例可按工作区标签保存，并供后续检索
- SQLite FTS5 关键词 + sqlite-vec 向量语义混合检索，RRF 融合排序
- 检索在本地运行；Agent 推理仍依赖配置的模型服务，本地模型除外
05
工作区与会话
- 工作区是隔离单元：每个工作区保存自己的窗口、标签页与环境（本地 / WSL / SSH）
- Agent 按工作区隔离：对话只看到所属工作区的环境与主机
- 本地记忆按工作区标签隔离，后续对话可检索已保存的摘要与成功案例
- 未绑定工作区时 Agent 不运行，先建工作区再开对话
06
终端与编辑器
- 本地 PTY / WSL / SSH 终端共用 xterm.js 渲染池，支持分屏与多标签
- 命令预测：内置 spec 索引 + carapace 参数补全 + 中文 tldr 描述 + 远端命令集
- CodeMirror 6 编辑器 + LSP、远程文件编辑
- 离线选词翻译、命令片段（Snippets）、15 套内置主题
Trust Modes
一个开关，决定 Agent 能动手到什么程度
模式不只是提示词约束：观察模式在 schema 层移除写类工具，模型无法调用它从未拿到的工具。
| 模式 | Agent 能做什么 | 适用场景 |
|---|---|---|
| 观察 | 只读分析；写类工具从工具集中移除 | 生产巡检 |
| 确认默认 | 全量工具；已识别的只读查询直接执行，未知与状态变更类逐条弹出审批卡 | 日常运维，人在回路 |
| 自动 | 低危（L0–L2）直接执行；L3/L4 高危仍需审批，硬底线不可绕过 | 可信沙箱 |
| 教学 | 观察模式权限 + 教学界面；单步命令卡，一次一条，真实结果返回后继续 | 课堂与自学 |
Safety Model
"AI 说它成功了"不作为事实
拦截、审批、熔断与脱敏是四条独立防线，任何一条都不依赖模型的自觉。
- 硬底线优先：黑名单命中即拦截，无法通过换写法绕过。
- 确认模式默认开：写操作逐条审批，审批卡展示真实命令、用途与影响分级。
- 退出码即事实：非零或缺失退出码按失败上报，不谎报成功。
- 证据可核验：工具调用按"收集 → 执行 → 验证"分组展示，证据来自真实工具事件。
风险识别与审批不是操作系统沙箱：本地 Python 工具在子进程中运行，工作目录设置不限制其全部文件与网络权限。
In Action
完整链路演示
连接服务器 → Agent 逐字写入命令 → 审批放行 → 真实输出回流工具卡 → 教学模式单步执行。
演示视频暂时加载失败，请刷新重试。
- 新建 SSH 工作区并连接服务器
- 对 Agent 提出排障需求，命令逐字写入真实终端
- 审批卡出现 → 确认执行
- 远端输出回流到工具卡
- 资源树跟随
cwd、拖拽上传文件 - 切换教学模式，单步命令卡执行
Architecture
三进程分离，各管一层
系统级能力留在 Rust，交互留在前端，AI 推理与知识检索放在可独立重启的 Python 进程。
React 19Agent 面板 · 终端 · 工作区 · 编辑器（TypeScript · Vite · Tailwind v4 · zustand）交互与可视化
│ Tauri invoke / events
Rust（Tauri 2）PTY · SSH / SFTP · 端口转发 · 打字机引擎 · sidecar 监管唯一系统执行面
│ JSON-RPC over stdio
Python sidecarStrands Agent · 工具注册表 · 审批 · 知识库 · 证据链可独立重启
Verification
自动化门禁与原生验收分开
测试数量会随实现变化，不把某一次运行的固定数字当成功能指标。
| 门禁 | 范围 | 发布要求 |
|---|---|---|
| pytest | Python sidecar（Agent、工具、审批、知识库） | 完整套件通过 |
| vitest | 前端状态、交互与渲染契约 | 完整套件通过 |
| cargo test | Rust 壳（PTY、SSH、打字机、隧道） | 完整套件通过 |
| tsc / eslint | 类型与静态检查 | 零错误、零警告 |
待原生桌面验收（需要真实 SSH 服务器与已保存的连接配置）：连接与历史恢复、同会话审批 FIFO、教学命令的成功 / 非零退出 / 超时 / 并发卡片闭环、发行版感知补全。
Get Started
从源码运行
环境要求：Node.js ≥ 20、pnpm ≥ 9、Rust stable、Python ≥ 3.12。
# 1. 安装前端依赖 pnpm install # 2. 启动桌面应用（首次编译 2–5 分钟） pnpm tauri:dev # Windows 用户可直接双击 启动.bat
- 配置模型：设置 → 模型，填入 API Key（DeepSeek / 智谱 / 通义 / Kimi / 豆包 / Ollama / 自定义 OpenAI 兼容端点）。
- 新建工作区：本地、WSL 或 SSH 服务器；SSH 凭据保存在系统密钥库。
- 在工作区内新建对话：Agent 只看到该工作区的环境；同工作区的对话共享记忆。
当前提供源码运行方式与 Windows 安装包；安装包尚未做 Authenticode 签名，首次运行可能提示"未知发布者"，请先核对 SHA-256。关注 Releases 获取最新版本。
Documentation