finch-remote-host 1.0.0 → 1.0.1

package/README.md

@@ -1,176 +1,93 @@
 # 远程主机
 
-在 Finch 里管理远程 Linux 主机，让 Agent 通过 SSH 执行命令，危险操作先经用户确认，全部动作留审计。
+在 Finch 里管理自己的远程 Linux 主机，让 Agent 通过 SSH 执行命令、查日志、看服务状态，危险操作先经确认，全部动作留审计。
 
-对话里永远不出现账号和密码：主机由你在面板里添加，密码存进系统安全存储，Agent 拿到的是主机 id。
+![](https://static.yicode.tech/images/202611/1793506026613.png)
 
-运行 Finch 的宿主系统不限：Windows 用系统自带的 OpenSSH，macOS 与 Linux 用 PATH 里的 `ssh`。目标机需要 POSIX shell。
+## 怎么用？
 
-## 动作
+![](./docs/demo.svg)
 
-| action  | 用途                                                   |
-| ------- | ------------------------------------------------------ |
-| `hosts` | 列已配置的主机、策略模式、最近一次执行结果，只读       |
-| `exec`  | 在指定主机上执行一条命令，按策略决定放行、确认还是拒绝 |
-| `audit` | 查最近的执行记录：命令、判定、退出码、耗时             |
+你说「看下这台机器磁盘还剩多少」，Agent 在远端跑一条 `df -h`，结果直接贴回来。
 
-`exec` 会先说清目标机和整条命令，需要确认时弹一张卡片，你点亮「我已看清命令与目标机」才算通过。
+你说「把 nginx 重启一下」，它不直接动手，先弹一张卡片，把目标机与完整命令写清楚，你点亮确认它才执行。
 
-执行期间卡片上的进度会每 1.2 秒刷新一次：已跑秒数、输出行数、最新一行。所以长命令能看出还在动，而不是干等。
+命令跑完、审计写完、退出码留着，事后能查。
 
-正文仍是跑完一次性返回——工具结果只支持整段落盘，没有逐行推送的通道。
+## 操作对比
 
-单条命令最长 10 分钟，到点本地中断；真要跑更久，用下面的后台任务。
+|                | 手动 SSH                  | 自己写脚本       | 远程主机               |
+| -------------- | ------------------------- | ---------------- | ---------------------- |
+| 记住主机与端口 | 靠 ssh config，换机器要翻 | 自己维护一份清单 | 配一次，所有会话共用   |
+| 危险命令       | 全靠自己把关              | 全靠自己把关     | 先确认，删根目录直接拒 |
+| 操作留痕       | 终端一滚就没了            | 自己打日志       | 自动写本机审计         |
+| 长任务         | 挂着终端不敢关            | 自己接 nohup     | 后台跑，能查退出码     |
 
-## 后台任务
+## 安全策略
 
-`start` / `status` / `stop` 三个动作专治跑不完的命令，进程有主，不会变成孤儿。
+![安全策略示意：一条命令要过三道关](docs/safety.svg)
 
-| action   | 干什么                                                          |
-| -------- | --------------------------------------------------------------- |
-| `start`  | 远端 `setsid` 脱离会话启动，立刻返回任务 id、pid 与日志路径     |
-| `status` | 探活、输出行数、日志尾巴、退出码；不带 taskId 就列最近任务      |
-| `stop`   | 先 TERM 整个进程组，1 秒后按 PGID 逐个 KILL；`clean` 顺手删日志 |
+有些命令不该有「点一下就好」的机会，删根目录、清空一级目录、格式化文件系统、写裸盘、关机重启，这些在任何模式下都直接拒绝，连确认按钮都不给。
 
-列表只做索引，不给存活结论；要存活就带 taskId 真探一次。
+系统目录与密钥目录整棵子树受保护，删除、清空、截断、重定向写入都拦得住。
 
-远端写三份伴生文件：`/tmp/finch-<id>.log` 存输出，`.exit` 存退出码，`.pid` 存真正干活的 worker 进程号。
+`/home`、`/opt`、`/srv`、`/var/lib` 只保护到直属子目录，给缓存和日志留了正常的清理路子。
 
-退出码让任务结束后仍能查到真实成败；`.pid` 是关键——`setsid` 会再分叉一层，`$!` 拿到的不是 worker，只有 worker 自己写的 pid 才能把整组收干净。
+其余命令按每台主机的策略走，四档从严到松。
 
-组长先退出时按负 pid kill 会报 ESRCH 而漏掉子进程，所以 `stop` 会再按 PGID 把剩下的成员逐个收一遍。
+| 模式              | 只读命令 | 写操作 | 读凭据文件 |
+| ----------------- | -------- | ------ | ---------- |
+| `query`           | 直接跑   | 拒绝   | 拒绝       |
+| `readonly`        | 直接跑   | 拒绝   | 确认       |
+| `confirm`（默认） | 直接跑   | 确认   | 确认       |
+| `trusted`         | 直接跑   | 直接跑 | 直接跑     |
 
-`start` 和 `exec` 走同一套策略与确认卡片：危险命令照样要你点头，硬拒清单照样不放行。
+密码与私钥只存在系统安全区，不进配置文件、不进审计，也不会回给 Agent。
 
-任务记录存在小程序本地，最多留 50 条，最早的自动挤掉。
+每次判定与执行都写一条本地审计，命令、目标机、判定理由、退出码、耗时都在里面，只有本机用户能看。
 
-## 面板
+## 常见场景
 
-右侧面板里的「远程主机」就是主机管理处，设置菜单里点「打开主机面板」也能进。
+**排查线上故障**
 
-面板提供三件事：主机列表与详情、新增与编辑弹框、每台主机的最近审计。
+线上 502，先说「看下 nginx 最近五十行错误日志」，Agent 把日志取回来贴着错往下查，不用切终端，也不用回忆日志路径。
 
-布局是手风琴：一行一台主机，点一下展开，详情与该机的审计就在同一条目里，再点收起。窄侧栏也放得下，不需要左右分栏。
+**部署与发版**
 
-展开后的三个按钮都带鼠标悬停提示：编辑改配置，测试连一次，删除会先问一句。
+拉代码、装依赖、重启服务、清缓存，一句话说清楚，要动服务器的那几步会先问你。
 
-新增时选择认证方式：密钥填绝对路径，密码填一次就好。
+**日常巡检**
 
-表单里的「测试连接」会当场直连一次，只看能不能回显，不装进主机列表。
+磁盘占用、内存余量、服务状态、证书到期，随口问一句就有答案。
 
-策略下拉每档都跟一句说明，选完就知道这档能干什么。
+**多机来回切**
 
-规则与策略下方有「试运行」框：粘一条命令点「判定」，用表单里还没保存的配置直接问分类器，结果分直接执行 / 需要确认 / 拒绝三色，并附逐段理由。
+开发机、测试机、生产机同时配好，会话里换个下拉就是另一台机器。
 
-弹框底部可展开「内置强制规则」，列出全部硬拒项、保护路径与会被检查目标的命令。内容由后端分类器下发，不是另写的一份文案，规则改了面板跟着变。
+## 安装与使用
 
-## 选主机
+![](https://static.yicode.tech/images/202611/1793507765432.png)
 
-输入框下方有「远程主机」这颗按钮，点开的菜单里选一台，它就是这台会话默认操作的机器。
+在 Finch 安装 「远程主机」小程序。
 
-选中后按钮直接显示主机名，再点可以换或清除。每个会话各记各的，互不影响。
+![](https://static.yicode.tech/images/202611/1793507808927.png)
 
-选定之后 Agent 执行命令不用再指定主机，模型每一轮都会被告知「这台机器」指的是谁。
+装完在 Finch 右侧面板的「远程主机」里添机器，密钥填绝对路径，密码填一次保存进系统安全区。
 
-按钮菜单最后一行是「打开主机面板」，没配主机时也会给你这个入口。
+密码认证要求 OpenSSH 8.4 以上，Windows 10 1809 之后自带的版本都满足。
 
-## 策略
+主机策略默认是 `confirm`，要放宽就在面板里改，改完当场生效。
 
-每台主机独立配一个模式，随时可改。四档从严到松，放宽只会让更多命令通过，不会反着来。
+![](https://static.yicode.tech/images/202611/1793507642579.png)
 
-| 模式       | 只读命令 | 写操作 | 读凭据文件   |
-| ---------- | -------- | ------ | ------------ |
-| `query`    | 直接跑   | 拒绝   | 拒绝         |
-| `readonly` | 直接跑   | 拒绝   | 确认         |
-| `confirm`  | 直接跑   | 确认   | 确认（默认） |
-| `trusted`  | 直接跑   | 直接跑 | 直接跑       |
+在会话中选择要操作的主机，然后触发 `当前主机` 关键词即可，比如：`查看当前主机信息`。
 
-硬拒不看模式、也不给确认按钮：删根目录、删任何一级目录（`/var`、`/wwwroot`、`/var/*` 这类清空也算）、不带路径的通配删除（`rm -rf *`）、`mkfs`、`dd` 写裸盘、重定向写块设备、fork 炸弹、关机重启、`chmod 777 /`。
+## 关于开发者
 
-判硬拒前先去掉引号再按段扫描，所以 `sudo rm -rf /var`、`sh -c "rm -rf /var"`、`/bin/rm -rf /var` 都拦得住。
-
-二级以下路径（`rm -rf /var/log/nginx`）不进一级硬拒，归模式管。
-
-### 保护路径
-
-下面这些位置，删除、清空、截断、重定向写入都直接拒绝，不看模式：
-
-| 范围               | 路径                                                       | 粒度           |
-| ------------------ | ---------------------------------------------------------- | -------------- |
-| 系统与启动         | `/etc`、`/boot`、`/bin`、`/sbin`、`/lib*`、`/usr`、`/root` | 整棵子树       |
-| 站点与定时任务     | `/var/www`、`/var/spool`                                   | 整棵子树       |
-| 服务数据与用户目录 | `/home`、`/opt`、`/srv`、`/var/lib`                        | 只到直属子目录 |
-| 密钥目录           | 任何位置下名为 `.ssh` 的目录                               | 整棵子树       |
-
-拦截的命令：`rm`、`rmdir`、`unlink`、`shred`、`truncate`、`dd of=`、`>`/`>>` 重定向、`find -delete`。
-
-不拦 `cp`、`mv`、`sed -i`、`tee`：这些是改配置与部署的正常手段，它们依旧走模式判定。
-
-只保护直属子目录的那档，是给缓存与日志留路：`rm -rf /var/lib/mysql` 拒绝，`rm -rf /var/lib/apt/lists/*` 只要求确认。
-
-名单只收 Linux 通用路径。业务目录（如 `/wwwroot`）的子树不进保护名单，删里面的东西只要求确认；但 `/wwwroot` 自身是一级目录，`rm -rf /wwwroot` 与 `rm -rf /wwwroot/*` 照样硬拒。
-
-### 规则
-
-规则是 glob，一行一条，匹配单位是命令拆开后的每一段（`;` `&&` `||` `|` `&` 换行都是分隔符）。
-
-整段匹配，不做子串：规则 `systemctl restart nginx` 不放过 `systemctl restart nginx-backup`。
-
-`*` 不跨 `/`，跨层级用 `**`，`?` 匹配单个字符。
-
-优先级：硬拒 > 拒绝规则 > 放行规则 > 模式。一段命中拒绝规则就整条拒绝；只有等所有段都过了才放行。
-
-规则会逐段判断，所以拼接骗不过去：「放行 `systemctl restart nginx`」不会让 `systemctl restart nginx && rm -rf /tmp/x` 免确认。
-
-### 只读判定
-
-只读看的是整条命令，任何一处可疑就按写操作处理：
-
-- 不在白名单里的命令一律不算只读
-- 命令替换 `$(…)`、反引号、`${…}`、重定向、heredoc 都不算只读
-- 白名单命令带上写参数也不算：`sort -o`、`uniq 输入 输出`、`date -s`、`hostname 新名`、`find -delete`/`-exec`、`ping -f`
-- 交互式程序（`less`/`vim`/`man`）不在白名单里，没有 tty 也用不上
-
-## 凭据
-
-两种认证都支持，按机器自选。
-
-- **密钥**：ed25519 私钥的绝对路径，口令版先 `ssh-add` 到 Windows 的 OpenSSH 认证代理
-- **密码**：存进系统安全存储（DPAPI），`permissions.secrets` 只声明 `host.*` 前缀
-
-密码不进配置文件、不进面板数据、不进审计，也不会回给模型。
-
-密码认证靠 `SSH_ASKPASS` 非交互地交给 ssh：助手脚本只回显环境变量，密码随进程结束消失。
-
-注意：`SSH_ASKPASS_REQUIRE` 需要 OpenSSH 8.4 以上，Windows 10 1809 之后自带版本都满足。
-
-## 审计
-
-每次判定与执行都写一条 JSONL，落在小程序的私有目录 `audit/<日期>.jsonl`。
-
-记录含时间、主机、会话 id、工具调用 id、完整命令、判定结果与逐段理由、退出码、耗时和输出前 4 KB。
-
-日志只追加，工具本身没有任何删除或改写记录的入口。
-
-## 安装与联调
-
-```bash
-bun run fafinch dev remote-host    # 构建 + 软链安装 + 监听
-bun run fafinch build remote-host  # 只构建
-bun run fafinch doctor remote-host # 构建 + 官方体检
-bun run synctpl finchapp           # 契约校验
-```
-
-`bun run fafinch install remote-host` 是复制安装，改代码后要重新执行。
-
-## 文件
-
-- `src/index.js` —— 注册工具与设置菜单，串起判定、确认、执行、审计，并接面板消息
-- `src/hosts.js` —— 主机清单、执行状态与密码的持久化与校验
-- `src/policy.js` —— 命令分级：拆段、glob 规则、只读判定、四档模式
-- `tests/policy.test.js` —— 命令分级的回归用例（vitest）
-- `src/ssh.js` —— 调系统 OpenSSH 客户端，密钥与密码两种认证，按主机串行，输出截断
-- `src/audit.js` —— 审计日志的追加与读取
-- `ui/panel.html` —— 面板页面：列表、表单弹框、审计视图
-- `dist/index.js` —— rolldown 产物（target node24），勿手改
-- `icon.png` —— 由 `bun run fafinch icon remote-host` 从图案源 `scripts/genLogo/output/remote-host/icon.svg` 生成
+- 农村程序员（`2020年回农村，至今未出村`）
+- 独立开发者（`致力于开发 1000 个小产品`）
+- 技术观察者（`分享编程技术，行业资讯等`）
+- 前端之虎陈随易（`自封的`）
+- 我的官网是：`https://yicode.tech`
+- 微信：`chensuiyime`（备注「finch」进交流群）
+- 公众号：陈随易

package/dist/index.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { appendFileSync, chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { isAbsolute, join, posix } from "node:path";
 import { spawn } from "node:child_process";
-// finchapp/remote-host/src/audit.js
+// finchapp/remoteHost/src/audit.js
 const OUTPUT_CHARS = 4e3;
 const FILE_SCAN = 7;
 /** 审计目录，按需创建。 */
@@ -58,7 +58,7 @@ function recent(ctx, { hostId, limit = 20 } = {}) {
 	}
 	return rows;
 }
-// finchapp/remote-host/src/policy.js
+// finchapp/remoteHost/src/policy.js
 const MODES = [
 	"query",
 	"readonly",
@@ -553,7 +553,7 @@ function classify(command, policy = {}) {
 		pending
 	};
 }
-// finchapp/remote-host/src/hosts.js
+// finchapp/remoteHost/src/hosts.js
 const HOSTS_KEY = "hosts";
 const RUNS_KEY = "runs";
 const AUTH_MODES = ["key", "password"];
@@ -661,7 +661,7 @@ async function listRuns(ctx) {
 	const runs = await ctx.storage.get(RUNS_KEY);
 	return runs && typeof runs === "object" && !Array.isArray(runs) ? runs : {};
 }
-// finchapp/remote-host/src/ssh.js
+// finchapp/remoteHost/src/ssh.js
 const queues = /* @__PURE__ */ new Map();
 const HEAD_CHARS = 6e3;
 const TAIL_CHARS = 3e3;
@@ -845,7 +845,7 @@ function clip(text) {
 	const cut = value.length - HEAD_CHARS - TAIL_CHARS;
 	return `${value.slice(0, HEAD_CHARS)}\n…（截断 ${cut} 字符）…\n${value.slice(-3e3)}`;
 }
-// finchapp/remote-host/src/tasks.js
+// finchapp/remoteHost/src/tasks.js
 const TASKS_KEY = "tasks";
 const MAX_TASKS = 50;
 /** 读全部任务，最新的在前。 */
@@ -878,7 +878,7 @@ async function updateTask(ctx, id, patch) {
 	await ctx.storage.set(TASKS_KEY, next);
 	return next.find((item) => item.id === id);
 }
-// finchapp/remote-host/src/index.js
+// finchapp/remoteHost/src/index.js
 const ACTIONS = [
 	"hosts",
 	"exec",
@@ -1478,8 +1478,8 @@ function activate(ctx) {
 			const run = runs[host.id];
 			items.push({
 				id: `open:${host.id}`,
-				label: `${host.name} · ${host.user}@${host.host}`,
-				description: run ? `${modeLabel(host.policy.mode)} · ${run.exitCode === 0 ? t("menu.ok") : t("menu.failed", { code: run.exitCode })}` : modeLabel(host.policy.mode),
+				label: host.name,
+				description: run ? run.exitCode === 0 ? t("menu.ok") : t("menu.failed", { code: run.exitCode }) : void 0,
 				iconName: "square-terminal"
 			});
 		}
@@ -1590,7 +1590,7 @@ function activate(ctx) {
 			const items = hosts.map((host) => ({
 				id: `host:${host.id}`,
 				label: host.name,
-				description: `${host.user}@${host.host} · ${modeLabel(host.policy.mode)}`,
+				description: modeLabel(host.policy.mode),
 				iconName: "square-terminal",
 				current: host.id === current
 			}));

package/docs/demo.svg

@@ -0,0 +1,89 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 760 476" width="760" height="476" role="img" aria-label="在 Finch 里让 Agent 操作远程主机的对话示例">
+  <title>远程主机：一句吩咐，危险命令先过审</title>
+  <style>
+    text {
+      font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;
+      fill: #1f2328;
+    }
+    .mono {
+      font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+      font-size: 12.5px;
+      fill: #3d444d;
+    }
+    .bubble-user { animation: pop 15s infinite both; }
+    .agent { animation: pop 15s infinite both; }
+    .confirm { animation: pop 15s infinite both; }
+    .result { animation: pop 15s infinite both; }
+    .d1 { animation-delay: 0.4s; }
+    .d2 { animation-delay: 2.0s; }
+    .d3 { animation-delay: 3.0s; }
+    .d4 { animation-delay: 5.2s; }
+    .d5 { animation-delay: 7.0s; }
+    .d6 { animation-delay: 10.4s; }
+    @keyframes pop {
+      0%   { opacity: 0; transform: translateY(6px); }
+      6%   { opacity: 1; transform: translateY(0); }
+      92%  { opacity: 1; transform: translateY(0); }
+      97%  { opacity: 1; transform: translateY(0); }
+      100% { opacity: 1; transform: translateY(0); }
+    }
+    .btn-pulse { animation: press 15s infinite both; animation-delay: 9.2s; }
+    @keyframes press {
+      0%   { opacity: 1; }
+      38%  { opacity: 1; }
+      46%  { opacity: 0.55; }
+      54%  { opacity: 1; }
+      100% { opacity: 1; }
+    }
+  </style>
+
+  <rect x="0" y="0" width="760" height="476" rx="14" fill="#f6f7f9"/>
+  <rect x="0.5" y="0.5" width="759" height="475" rx="14" fill="none" stroke="#e3e6ea"/>
+
+  <!-- 用户提问 -->
+  <g class="bubble-user d1">
+    <rect x="380" y="22" width="356" height="42" rx="12" fill="#e8f0fe"/>
+    <text x="400" y="48" font-size="14">看下这台机器磁盘还剩多少</text>
+  </g>
+
+  <!-- Agent 执行 -->
+  <g class="agent d2">
+    <rect x="24" y="80" width="470" height="58" rx="12" fill="#ffffff" stroke="#e3e6ea"/>
+    <text x="42" y="103" font-size="12.5" fill="#8a9199">remote_host · exec · localhost</text>
+    <text class="mono" x="42" y="124">df -h</text>
+  </g>
+
+  <!-- 输出 -->
+  <g class="agent d3">
+    <rect x="24" y="148" width="470" height="60" rx="12" fill="#fbfbfc" stroke="#e3e6ea"/>
+    <text class="mono" x="42" y="171" xml:space="preserve">Filesystem      Size  Used Avail Use% Mounted on</text>
+    <text class="mono" x="42" y="191" xml:space="preserve">/dev/vda1        99G   78G   21G  79% /</text>
+  </g>
+
+  <!-- 用户第二句 -->
+  <g class="bubble-user d4">
+    <rect x="428" y="222" width="308" height="42" rx="12" fill="#e8f0fe"/>
+    <text x="448" y="248" font-size="14">把 nginx 重启一下</text>
+  </g>
+
+  <!-- 确认卡片 -->
+  <g class="confirm d5">
+    <rect x="24" y="278" width="560" height="118" rx="12" fill="#fff8ec" stroke="#f0d9b0"/>
+    <text x="44" y="303" font-size="13" font-weight="600" fill="#8a5a00">需要你确认</text>
+    <text x="44" y="326" font-size="12.5" fill="#6b7076">目标机</text>
+    <text x="106" y="326" font-size="12.5">localhost　root@127.0.0.1:22</text>
+    <text x="44" y="348" font-size="12.5" fill="#6b7076">命令</text>
+    <text class="mono" x="106" y="348">systemctl restart nginx</text>
+    <g class="btn-pulse">
+      <rect x="44" y="360" width="192" height="26" rx="7" fill="#1f6feb"/>
+      <text x="60" y="378" font-size="12" fill="#ffffff">我已看清命令与目标机</text>
+    </g>
+  </g>
+
+  <!-- 结果 -->
+  <g class="result d6">
+    <rect x="24" y="410" width="470" height="44" rx="12" fill="#ffffff" stroke="#e3e6ea"/>
+    <circle cx="44" cy="432" r="5" fill="#2da44e"/>
+    <text x="60" y="437" font-size="13">nginx 已重启，active (running)</text>
+  </g>
+</svg>

package/docs/safety.svg

@@ -0,0 +1,89 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 760 250" width="760" height="250" role="img" aria-label="安全策略示意：危险命令红线、主机策略、人工确认三道关口">
+  <title>远程主机：一条命令要过三道关</title>
+  <defs>
+    <marker id="tip" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
+      <path d="M0 0 L10 5 L0 10 z" fill="#c2c8d0"/>
+    </marker>
+  </defs>
+  <style>
+    text {
+      font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;
+      fill: #1f2328;
+    }
+    .gate { animation: pop 12s infinite both; }
+    .out { animation: pop 12s infinite both; }
+    .d1 { animation-delay: 0.3s; }
+    .d2 { animation-delay: 1.1s; }
+    .d3 { animation-delay: 1.9s; }
+    .d4 { animation-delay: 2.7s; }
+    .d5 { animation-delay: 2.9s; }
+    .d6 { animation-delay: 3.1s; }
+    .arrow { animation: fade 12s infinite both; }
+    @keyframes pop {
+      0%   { opacity: 0; transform: translateY(6px); }
+      5%   { opacity: 1; transform: translateY(0); }
+      92%  { opacity: 1; transform: translateY(0); }
+      100% { opacity: 1; transform: translateY(0); }
+    }
+    @keyframes fade {
+      0%   { opacity: 0; }
+      6%   { opacity: 1; }
+      100% { opacity: 1; }
+    }
+  </style>
+
+  <rect x="0" y="0" width="760" height="250" rx="14" fill="#f6f7f9"/>
+  <rect x="0.5" y="0.5" width="759" height="249" rx="14" fill="none" stroke="#e3e6ea"/>
+
+  <text x="24" y="34" font-size="13" fill="#6b7076">一条命令要过三道关</text>
+
+  <!-- ① 危险命令红线 -->
+  <g class="gate d1">
+    <rect x="24" y="52" width="224" height="92" rx="12" fill="#ffffff" stroke="#e3e6ea"/>
+    <circle cx="46" cy="76" r="5" fill="#cf222e"/>
+    <text x="62" y="81" font-size="14" font-weight="600">危险命令红线</text>
+    <text x="44" y="106" font-size="12.5" fill="#6b7076">删根目录 / 格式化 / 写裸盘</text>
+    <text x="44" y="126" font-size="12.5" fill="#6b7076">任何设置都放不开</text>
+  </g>
+
+  <!-- ② 主机策略 -->
+  <g class="gate d2">
+    <rect x="268" y="52" width="224" height="92" rx="12" fill="#ffffff" stroke="#e3e6ea"/>
+    <circle cx="290" cy="76" r="5" fill="#1f6feb"/>
+    <text x="306" y="81" font-size="14" font-weight="600">每台主机各自定档</text>
+    <text x="288" y="106" font-size="12.5" fill="#6b7076">仅查询 · 只读 · 每次确认</text>
+    <text x="288" y="126" font-size="12.5" fill="#6b7076">生产机可以只看不改</text>
+  </g>
+
+  <!-- ③ 人工确认 -->
+  <g class="gate d3">
+    <rect x="512" y="52" width="224" height="92" rx="12" fill="#ffffff" stroke="#e3e6ea"/>
+    <circle cx="534" cy="76" r="5" fill="#bf8700"/>
+    <text x="550" y="81" font-size="14" font-weight="600">要动服务器先问你</text>
+    <text x="532" y="106" font-size="12.5" fill="#6b7076">卡片写清命令与目标机</text>
+    <text x="532" y="126" font-size="12.5" fill="#6b7076">你点了才执行</text>
+  </g>
+
+  <g class="arrow d1">
+    <path d="M248 98 H 264" stroke="#c2c8d0" stroke-width="1.5" marker-end="url(#tip)"/>
+  </g>
+  <g class="arrow d2">
+    <path d="M492 98 H 508" stroke="#c2c8d0" stroke-width="1.5" marker-end="url(#tip)"/>
+  </g>
+
+  <!-- 三个结果 -->
+  <g class="out d4">
+    <rect x="24" y="168" width="224" height="50" rx="12" fill="#ffebe9" stroke="#ffcecb"/>
+    <text x="136" y="198" font-size="12.5" font-weight="600" fill="#cf222e" text-anchor="middle">直接拒绝，不给确认入口</text>
+  </g>
+
+  <g class="out d5">
+    <rect x="268" y="168" width="224" height="50" rx="12" fill="#ffffff" stroke="#d8dee4" stroke-dasharray="5 5"/>
+    <text x="380" y="198" font-size="12.5" fill="#6b7076" text-anchor="middle">密码与密钥只存本机安全区</text>
+  </g>
+
+  <g class="out d6">
+    <rect x="512" y="168" width="224" height="50" rx="12" fill="#e9f7ee" stroke="#b7e0c4"/>
+    <text x="624" y="198" font-size="12.5" font-weight="600" fill="#1a7f37" text-anchor="middle">远端执行，本地写审计</text>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "finch-remote-host",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "在 Finch 里管理远程主机，让 Agent 通过 SSH 执行命令，危险操作先经用户确认，全部动作留审计。",
     "keywords": [
         "devops",
@@ -17,6 +17,7 @@
         "i18n/",
         "skills/",
         "ui/",
+        "docs/",
         "icon.png",
         "README.md"
     ],

package/skills/{remote-host → remoteHost}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: remote-host
+name: remoteHost
 description: 远程主机的操作手册。用 remote_host 在用户已配置的服务器上读文件、查状态、跑命令之前先读它，尤其是四种策略模式的差别、只读判定的边界、规则写 glob 时的匹配方式，以及命令被拒绝或需要确认时怎么处理。
 ---
 

package/ui/panel.html

@@ -213,16 +213,6 @@
                 text-overflow: ellipsis;
                 white-space: nowrap;
             }
-            .host-addr {
-                flex: 0 0 auto;
-                max-width: 42%;
-                font-family: var(--mono);
-                font-size: 12px;
-                color: var(--faint);
-                overflow: hidden;
-                text-overflow: ellipsis;
-                white-space: nowrap;
-            }
             .chevron {
                 display: flex;
                 flex: 0 0 auto;
@@ -914,8 +904,8 @@
                 toggleBtn.type = "button";
                 toggleBtn.title = open ? "收起" : "展开看详情与操作记录";
                 toggleBtn.append(hostIcon(), el("span", "host-name", host.name));
-                const addr = hideConfig ? null : el("span", "host-addr", `${host.user}@${host.host}:${host.port}`);
-                head.append(...[toggleBtn, addr, hostActions(host), chevronIcon()].filter(Boolean));
+                // 列表行只留主机名与动作，连接配置展开后才看（受隐私开关控制）。
+                head.append(toggleBtn, hostActions(host), chevronIcon());
                 // 整行都能展开；右侧动作按钮自己拦一下，别连带收起。
                 head.addEventListener("click", () => toggle(host.id));
                 section.append(head);