@zicolasjac-ai/remote-readonly-ssh 1.4.2 → 1.4.4

package/README.md

@@ -25,7 +25,7 @@ npx 会自动拉取最新版本、进入初始化向导，依次询问：
 1. 是否覆盖已有 `~/.rrs/config.json`（首次安装跳过此步）
 2. **认证组**：堡垒机主机 / 端口 / 用户名 / 认证模式（SSH 密钥或密码）/ 凭据；可配置多个认证组
 3. 目标主机白名单（每行 `ip=堡垒机搜索关键字`），并为每台主机指定归属的认证组（多台主机可共用同一组）
-4. 是否把 SKILL.md 安装到 opencode / Claude Code / Cursor 等 AI 助手
+4. 是否把 SKILL.md 安装到 opencode / Claude Code / Cursor 等 AI 助手（安装命令的 postinstall 已自动分发，此步幂等可确认）
 
 向导结束后 `~/.rrs/config.json` 已就位、`~/.rrs/audit.log` 已建好、AI skill 已分发。直接试跑：
 
@@ -38,7 +38,7 @@ npx -y @zicolasjac-ai/remote-readonly-ssh@latest sys-info --json
 每次调用都 `npx` 较慢（需下载/缓存）。如果要把 `rrs` 作为日常命令长期使用：
 
 ```bash
-npm install -g @zicolasjac-ai/remote-readonly-ssh
+npm install -g @zicolasjac-ai/remote-readonly-ssh   # postinstall 自动分发 AI skill
 rrs init                # TTY 下仍是交互向导；非交互环境只生成配置模板
 rrs sys-info --json     # 直接用 rrs 前缀
 ```
@@ -145,7 +145,7 @@ rrs upload "E:\deploy\nginx.conf" /opt/upload/nginx.conf --host 10.0.0.2 --json
 
 ## Agent Skills
 
-本工具附带一份 `SKILL.md`，教 AI 助手何时用、怎么用 `rrs`。安装后用 `rrs setup skills` 一键分发到各 agent 的 skills 目录：
+本工具附带一份 `SKILL.md`，教 AI 助手何时用、怎么用 `rrs`。**`npm install` 时 postinstall 会自动分发**（agents 实体 + opencode/claude/qoder 软链接），无需手工执行；`rrs setup skills` 保留为手工重装 / 只装部分 agent 的方式：
 
 | `--agent` | 写入方式 | 路径 |
 |-----------|----------|------|
@@ -155,17 +155,16 @@ rrs upload "E:\deploy\nginx.conf" /opt/upload/nginx.conf --host 10.0.0.2 --json
 | `qoder` | 软链接 → agents | `~/.qoder/skills/remote-readonly-ssh/SKILL.md` |
 | `all`（默认） | 实体 + 上述 3 个软链接 | 一行命令装齐 |
 
-`rrs setup skills` 默认 `agent=all`（不询问，直接装），输出一行简明提示：
+`rrs setup skills` 默认 `agent=all`（不询问，直接装；postinstall 自动分发亦采用此默认），输出一行简明提示：
 
 ```
 rrs skill 已安装: agents (实体), opencode/claude/qoder (软链接)
 ```
 
-> **Windows 注意**：普通用户缺少 `SeCreateSymbolicLinkPrivilege`，软链接创建会被 OS 拒绝；rrs 会自动 fallback 为复制，并提示"Windows 已 fallback 为复制（请开启开发者模式以启用真软链接）"。开启开发者模式后重新跑 `rrs setup skills` 即可使用真软链接。
+> **Windows 注意**：普通用户缺少 `SeCreateSymbolicLinkPrivilege`，软链接创建会被 OS 拒绝；rrs 会自动 fallback 为复制，并提示"Windows 已 fallback 为复制（请开启开发者模式以启用真软链接）"。开启开发者模式后重新跑 `rrs setup skills`（或重装包）即可使用真软链接。
 
 ```bash
-rrs setup skills                            # 一行命令装齐（实体 + 3 个软链接）
-npx -y @zicolasjac-ai/remote-readonly-ssh@latest setup skills   # 全局未装时用 npx
+rrs setup skills                            # 手工重装（正常情况 npm install 已自动分发）
 rrs setup skills --agent opencode           # 只装 opencode 链接（agents 实体也自动建）
 rrs setup skills --agent qoder              # 只装 qoder 链接
 rrs setup skills --dry-run                  # 仅预览将要创建的目标

package/bin/postinstall.js

@@ -7,7 +7,28 @@ const path = require("path");
 
 const PACKAGE_ROOT = path.join(__dirname, "..");
 
+/**
+ * npm 安装完成后自动把 SKILL.md 分发到各 AI 助手的 skills 目录（agents 实体 + 软链接），
+ * 使 "npm install -g @latest" 一步完成 CLI 与 AI skill 的同步升级；失败不阻塞安装。
+ * 幂等：重复安装/升级会重建实体与软链（Windows 无符号链接权限时自动退化为复制）。
+ */
+function autoInstallSkills() {
+  try {
+    const results = setupSkill.install(PACKAGE_ROOT, { agent: "all" });
+    const canonical = results.find((r) => r.agent === "agents");
+    const links = results.filter((r) => r.agent !== "agents");
+    const anyFallback = links.some((r) => r.fallback);
+    const names = links.map((r) => r.agent).join("/");
+    const done = canonical && links.length ? `agents (实体), ${names} (软链接)` : canonical ? "agents (实体)" : names;
+    console.log(`rrs AI skill 已同步: ${done}${anyFallback ? " — Windows 已自动 fallback 为复制（开启开发者模式可获得真软链接）" : ""}`);
+  } catch (e) {
+    console.error(`[rrs postinstall] AI skill 自动分发失败（不影响 CLI 使用）: ${e.message}`);
+    console.error("可稍后手动执行: rrs setup skills");
+  }
+}
+
 (async () => {
+  autoInstallSkills();
   const tty = process.stdin.isTTY && process.stdout.isTTY;
   if (tty) {
     try {
@@ -19,9 +40,9 @@ const PACKAGE_ROOT = path.join(__dirname, "..");
   } else {
     console.log("");
     console.log("rrs 安装完成。下一步:");
-    console.log("  rrs init                # 交互式初始化 + 安装 AI skill（推荐）");
-    console.log("  rrs setup skills        # 仅安装 AI skill 到 opencode / claude 等");
+    console.log("  rrs init                # 交互式初始化配置（首次安装必跑；向导不再询问 skill 安装，见上）");
+    console.log("  rrs setup skills --agent opencode   # 如需只分发部分 AI 助手（默认已全量分发）");
     console.log("  rrs list-tools          # 查看白名单与配置");
     console.log("");
   }
-})();
+})();

package/bin/rrs.js

@@ -182,7 +182,7 @@ function buildCmds(tool, arg, conf) {
 }
 
 function listTools(conf) {
-  console.log("可用只读工具:");
+  console.log("可用工具:");
   const tools = {
     "sys-info": "主机名/OS/内核/uptime",
     "proc <pattern>": "进程查询",
@@ -191,6 +191,8 @@ function listTools(conf) {
     "dir <path>": "列目录",
     "bin-version <bin>": "查版本（二进制白名单）",
     "exec-only <cmd>": "通用只读命令（白名单校验）",
+    "download <远程> <本地>": "下载单文件（SFTP：direct 直连或 koko 网关）",
+    "upload <本地> <远程>": "上传单文件（写操作，opt-in + 写路径白名单）",
   };
   for (const [k, v] of Object.entries(tools)) console.log(`  ${k.padEnd(20)} ${v}`);
   const profiles = conf.auth_profiles || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zicolasjac-ai/remote-readonly-ssh",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "只读 SSH 运维 CLI 与 Agent Skill：通过 JumpServer 堡垒机白名单强制执行只读查询；认证组支持 SSH 私钥/密码两种模式与按 IP 分组；附 SKILL.md 让 opencode / Claude Code / Cursor 等 AI 助手自动发现并正确调用。",
   "license": "MIT",
   "bin": {

package/skills/remote-readonly-ssh/SKILL.md

@@ -34,11 +34,10 @@ metadata:
 ## Setup（用户一次性）
 
 ```bash
-npm install -g @zicolasjac-ai/remote-readonly-ssh
-rrs init          # 生成配置模板 ~/.rrs/config.json
+npm install -g @zicolasjac-ai/remote-readonly-ssh   # postinstall 自动把 SKILL.md 分发到 opencode / claude / agents 等目录
+rrs init          # 生成配置模板 ~/.rrs/config.json（TTY 下为交互向导）
 # 编辑配置: auth_profiles（认证组，key/password 两种模式，可多个；direct:true 表示跳过堡垒机菜单直连裸机）
-#           target_hosts（IP → 认证组+搜索关键字，多 IP 可共用一组）
-rrs setup skills  # 把本 skill 安装到 opencode / claude / agents 等目录
+#           target_hosts（IP → 认证组+搜索关键字，多 IP 可共用一组；可选 sftp_root 声明 koko 资产树目录）
 ```
 
 ## Usage