@xiaoqiong0v0/opencode-ssh-tool 0.2.4

package/README.md

@@ -0,0 +1,159 @@
+# opencode-ssh-tool
+
+opencode 插件：让 opencode 像人一样操作**长驻交互式 SSH 会话**。连接一次，后续在一个会话里连续执行命令，保留当前目录、环境变量、交互状态；远程命令执行同样受 opencode 权限系统管控（类似内置 Bash 工具的审批）。
+
+## 特性
+
+- **长驻会话**：`ssh_connect` 建立连接后，`ssh_exec` 在同一会话执行命令，保留 cwd/环境/后台进程/sudo 缓存
+- **PTY 交互**：分配伪终端，可处理 sudo 密码、vi、top 等交互程序
+- **权限管控**：只读白名单直接放行、危险命令黑名单硬拒、其余走 `context.ask()` 用户审批
+- **命令完成判定**：哨兵标记 + 静默窗口 + 超时三重兜底，动画输出（进度条等）自动识别
+- **历史消息对**：命令+输出 全部存文件（`~/.opencode/plugins-cache/opencode-ssh-tool/<会话>/`），按对数保留（默认 100 对），重启不丢、会话关闭清理
+- **HTTP 终端查看**：默认开启本地服务，浏览器打开可滚动、自动刷新的终端记录页面
+- **多语言**：工具描述默认英文，`SSH_TOOL_LANG=zh` 切中文
+
+## 安装
+
+```jsonc
+// opencode.json
+{
+  "plugin": ["opencode-ssh-tool"]
+}
+```
+
+发布到 npm 后通过 `plugin` 数组引用；或本地调试时挂载到项目 `.opencode/` 文件夹。
+
+## 工具
+
+| 工具 | 入参 | 行为 |
+|---|---|---|
+| `ssh_connect` | `host`, `user`, `port?`, `name?` | 建立长驻 SSH 连接 + 打开 PTY shell；`name` 指定终端名（默认 `default`），同名先关旧终端 |
+| `ssh_exec` | `command`, `waitResult?`, `name?` | 在指定终端执行命令；默认异步提交立即返回，`waitResult=true` 同步等结果 |
+| `ssh_read` | `source?`, `lines?`, `direction?`, `limit?`, `includeCommand?`, `name?` | 读指定终端输出：`buffer` 实时未消费 / `history` 已完成对（前/后 N 条） |
+| `ssh_status` | `name?` | 指定终端状态（busy/pending/连接）；省略则列出全部终端 + HTTP 服务状态 |
+| `ssh_disconnect` | `name?` | 断开指定终端（默认 `default`）；省略则断开全部终端 |
+
+> 一个 opencode 会话可创建**多个命名终端**（如 `db`、`web`、`prod`），用不同 `name` 并行维护；同名重复创建会先关闭旧的。
+
+## 配置
+
+配置文件 `~/.config/opencode/ssh-tool.jsonc`（首次运行自动生成）：
+
+```jsonc
+{
+  // HTTP 终端记录服务开关（默认 true）
+  "server": {
+    "enabled": true,
+    // 端口：不设默认值。0 = 自动分配随机端口（推荐，避免冲突）；可显式指定，如 8137
+    "port": 0
+  },
+  // 会话记录（命令+输出 消息对）管理：全部存文件（~/.opencode/plugins-cache/opencode-ssh-tool/<会话>/），随会话清理
+  "history": {
+    // 保留的消息对数上限（默认 100，最小 1）。超出时移除最旧的一对
+    "maxMessages": 100
+  },
+  // 工具描述语言："en" | "zh"（默认 "en"，可用环境变量 SSH_TOOL_LANG 覆盖）
+  "toolLang": "en",
+  // 权限自定义正则（追加到内置默认，控制"拒绝"与"需审批"命令）
+  "permission": {
+    // 内置默认危险命令黑名单（命中直接拒绝）：
+    //   rm 危险目标(/ ~ . /etc /var /usr 等) | shutdown/reboot/halt/poweroff | mkfs/mkswap/fdisk/parted/dd
+    //   iptables/ufw/firewall-cmd | systemctl | service stop/restart/kill | kill/killall/pkill
+    //   passwd/useradd/userdel/groupadd/groupdel | chown -R | chmod -R 777 / | apt remove | npm uninstall
+    //   DROP TABLE/TRUNCATE/DROP DATABASE | fork炸弹 | > /etc/{passwd,shadow,sudoers,fstab}
+    //   curl|sh / wget|sh / base64 -d |
+    // 自定义补充示例：["^mkfs\\s", "^dd\\s"]（空数组 = 仅使用内置默认）
+    "deny": [],
+    // 内置默认只读白名单（命中且无 shell 元字符则直接放行）：
+    //   ls | cd | cat | grep | tail | head | ps | df | free | pwd | env | echo | curl | wget | git status | whoami | hostname | date | uname | uptime
+    // 自定义补充示例：["^df\\s.*-h$"]（空数组 = 仅使用内置默认）
+    "allow": []
+  }
+}
+```
+
+多语言优先级：环境变量 `SSH_TOOL_LANG` > 配置文件 `toolLang` > 默认 `en`。
+
+权限自定义正则**追加**到内置默认（`DENY` 黑名单 + `ALLOW_READONLY` 白名单），`deny`/`allow` 为空数组时仅用内置默认规则，可自行补充扩展。
+
+## 认证
+
+按优先级自动选择，认证信息**不硬编码**、不落日志：
+
+1. **SSH key**（推荐）：用户默认私钥（`id_ed25519` / `id_rsa`）
+2. **SSH agent**：agent socket / Windows OpenSSH agent
+3. **环境变量密码**：`SSH_PASS_<HOST大写>` 优先，回退 `SSH_PASSWORD`
+
+## 权限管控
+
+```text
+ssh_exec(command)
+  ├─ 命中 DENY 黑名单（rm -rf / shutdown reboot mkfs 等） → 直接拒绝
+  ├─ 命中只读白名单 且 无 shell 元字符 → 直接放行
+  └─ 其他 → context.ask() 用户审批（:allow / :deny / :always）
+```
+
+- 只读白名单：`ls|cd|cat|grep|tail|head|ps|df|free|pwd|env|echo|curl|wget|git status|whoami|hostname|date|uname|uptime`
+- 命令含 `;` `&&` `|` `$()` 等 shell 元字符 → 降级走 ask（防拼接绕过）
+- 高危命令不进 ask 直接拒，`ssh_connect` 也走审批
+
+## HTTP 终端查看
+
+服务默认开启（配置 `server.enabled`）。`ssh_status` / `ssh_read`（history 模式）会返回实际地址（端口 0 时自动分配，避免冲突）：
+
+```
+浏览器访问 http://127.0.0.1:<port> 查看可滚动、每 2s 自动刷新的终端记录
+```
+
+页面按会话切换，展示「命令 + 输出」历史对。
+
+## 架构
+
+```
+opencode（插件进程）
+  ├─ ssh2 客户端：长驻连接 + PTY shell（每个 opencode 会话一个）
+  │    └─ 哨兵法执行命令（combo; echo __SSH_DONE_<rand>__）
+  ├─ SessionHistory：命令+输出 消息对（按对数限制，超大落盘）
+  └─ HTTP 服务：127.0.0.1 随机端口，浏览器查看终端记录
+```
+
+## 开发
+
+```bash
+npm install      # 安装依赖（dependencies + devDependencies）
+npm run build    # tsc：src → dist
+```
+
+- TS 源码在 `src/`，编译产物 `dist/`
+- 本地测试：编译产物挂载到测试项目 `.opencode/` 文件夹，在该项目启动 opencode 验证
+- 日志：`@xiaoqiong0v0/opencode-plugin-logger` 按天滚动落盘
+
+## 发布
+
+```bash
+npm run build
+npm publish      # 只发布 dist/
+```
+
+本项目提交 GitHub 发布 npm；使用方 `opencode.json` 的 `plugin` 数组引用。
+
+## 测试清单
+
+需真实 SSH 主机（可用 Docker 测试环境，见 `.tmp/ssh-test-docker.ps1`）：
+
+- [ ] `ssh_connect` → 登录成功，cwd 为登录目录
+- [ ] `ssh_exec("ls")` 连续多次，确认永不重连（同一会话）
+- [ ] `ssh_exec("cd /var/log && pwd")` 后 `ssh_exec("pwd")` = `/var/log`（目录保持）
+- [ ] 交互场景：`ssh_exec("sudo ...")` 触发密码提示 → `ssh_read` 配合
+- [ ] 白名单命令不弹审批直接执行；`rm -rf` 被拒绝
+- [ ] 白名单外命令弹 `context.ask()`，`:deny` 拒绝 / `:allow` 放行
+- [ ] 长命令超时：`ssh_exec("sleep 60")` 30s 超时返回，不挂死会话
+- [ ] `ssh_read` 取前/后 N 条历史输出（含 `includeCommand`、`source=buffer`）
+- [ ] `ssh_status` / HTTP 页面浏览器可访问
+- [ ] `ssh_disconnect` 后连接释放
+
+## 文档
+
+- `docs/requirements/需求说明.md` — 原始需求
+- `docs/design/方案分析.md` — 技术分析、决策、风险
+- `docs/design/结构设计.md` — 编码依据

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+import type { Lang } from "./i18n.js";
+/** HTTP 服务配置 */
+export interface ServerConfig {
+    enabled: boolean;
+    port: number;
+}
+/** 会话记录（命令+输出 消息对）配置 */
+export interface HistoryConfig {
+    maxMessages: number;
+}
+/** 权限自定义正则配置（追加到内置默认，控制"拒绝"与"需审批"命令） */
+export interface PermissionConfig {
+    /** 危险命令正则（命中直接拒绝），如 ["^mkfs\\s", "^dd\\s"] */
+    deny: string[];
+    /** 只读白名单正则（命中且无 shell 元字符则直接放行），如 ["^df\\s.*-h$"] */
+    allow: string[];
+}
+/** 工具整体配置 */
+export interface ToolConfig {
+    server: ServerConfig;
+    history: HistoryConfig;
+    /** 工具描述语言（默认 en，可用环境变量 SSH_TOOL_LANG 覆盖） */
+    toolLang: Lang;
+    permission: PermissionConfig;
+}
+/**
+ * 加载工具配置：读 jsonc，缺失项用默认值；文件不存在则自动生成模板
+ * @returns 工具配置
+ */
+export declare function loadConfig(): ToolConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAwB;AACxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,aAAa,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,IAAI,CAAA;IACd,UAAU,EAAE,gBAAgB,CAAA;CAC7B;AAuED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,UAAU,CA+BvC"}

package/dist/config.js

@@ -0,0 +1,107 @@
+// 配置文件读取：~/.config/opencode/ssh-tool.jsonc（服务/记录/语言），首次运行自动生成模板
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** 配置默认值 */
+const DEFAULT_CONFIG = {
+    server: {
+        enabled: true,
+        // 端口不设默认值：0 = 自动分配随机端口（避免冲突）
+        port: 0,
+    },
+    history: {
+        // 保留的消息对数（最小 1，保留最新）
+        maxMessages: 100,
+    },
+    toolLang: "en",
+    permission: {
+        deny: [],
+        allow: [],
+    },
+};
+/** 配置文件路径：~/.config/opencode/ssh-tool.jsonc */
+function configPath() {
+    const dir = process.env.USERPROFILE || process.env.HOME || homedir();
+    return join(dir, ".config", "opencode", "ssh-tool.jsonc");
+}
+/** 配置模板（首次运行生成） */
+const CONFIG_TEMPLATE = `{
+  // HTTP 终端记录服务开关（默认 true）
+  "server": {
+    "enabled": true,
+    // 端口：不设默认值。0 = 自动分配随机端口（推荐，避免冲突）；可显式指定，如 8137
+    "port": 0
+  },
+  // 会话记录（命令+输出 消息对）管理：全部存文件（~/.opencode/plugins-cache/opencode-ssh-tool/<会话>/），随会话清理
+  "history": {
+    // 保留的消息对数上限（默认 100，最小 1）。超出时移除最旧的一对
+    "maxMessages": 100
+  },
+  // 工具描述语言："en" | "zh"（默认 "en"，可用环境变量 SSH_TOOL_LANG 覆盖）
+  "toolLang": "en",
+  // 权限自定义正则（追加到内置默认，控制"拒绝"与"需审批"命令）
+  "permission": {
+    // 内置默认危险命令黑名单（命中直接拒绝，不需要重复添加）：
+    //   rm 危险目标(/ ~ . /etc /var /usr 等) | shutdown/reboot/halt/poweroff | mkfs/mkswap/fdisk/parted/dd
+    //   iptables/ufw/firewall-cmd | systemctl | service stop/restart/kill | kill/killall/pkill
+    //   passwd/useradd/userdel/groupadd/groupdel | chown -R | chmod -R 777 / | apt remove | npm uninstall
+    //   DROP TABLE/TRUNCATE/DROP DATABASE | fork炸弹 | > /etc/{passwd,shadow,sudoers,fstab}
+    //   curl|sh / wget|sh / base64 -d |
+    // 自定义补充示例：["^mkfs\\s", "^dd\\s"]（此数组为空 = 仅使用内置默认）
+    "deny": [],
+    // 内置默认只读白名单（命中且无 shell 元字符则直接放行）：
+    //   ls | cd | cat | grep | tail | head | ps | df | free | pwd | env | echo | curl | wget | git status | whoami | hostname | date | uname | uptime
+    // 自定义补充示例：["^df\\s.*-h$"]（此数组为空 = 仅使用内置默认）
+    "allow": []
+  }
+}
+`;
+/**
+ * 去除 jsonc 注释后解析为对象（支持 // 与 /* *\/）
+ * @param text jsonc 文本
+ * @returns 解析结果对象
+ */
+function parseJsonc(text) {
+    const stripped = text
+        .replace(/\/\*[\s\S]*?\*\//g, "")
+        .replace(/(^|[^:])\/\/.*$/gm, "$1");
+    return JSON.parse(stripped);
+}
+/**
+ * 加载工具配置：读 jsonc，缺失项用默认值；文件不存在则自动生成模板
+ * @returns 工具配置
+ */
+export function loadConfig() {
+    try {
+        const path = configPath();
+        if (!existsSync(path)) {
+            mkdirSync(join(path, ".."), { recursive: true });
+            writeFileSync(path, CONFIG_TEMPLATE, "utf8");
+            return DEFAULT_CONFIG;
+        }
+        const raw = parseJsonc(readFileSync(path, "utf8"));
+        const server = (raw.server ?? {});
+        const history = (raw.history ?? {});
+        const permission = (raw.permission ?? {});
+        const toolLang = raw.toolLang === "zh" ? "zh" : "en";
+        return {
+            server: {
+                enabled: server.enabled ?? DEFAULT_CONFIG.server.enabled,
+                port: typeof server.port === "number" && Number.isFinite(server.port) ? server.port : DEFAULT_CONFIG.server.port,
+            },
+            history: {
+                maxMessages: Math.max(1, history.maxMessages ?? DEFAULT_CONFIG.history.maxMessages),
+            },
+            toolLang,
+            permission: {
+                deny: Array.isArray(permission.deny) ? permission.deny : [],
+                allow: Array.isArray(permission.allow) ? permission.allow : [],
+            },
+        };
+    }
+    catch (e) {
+        // 配置解析失败回退默认
+        return DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,24 @@
+/** 只读命令白名单（整串匹配，含元字符的命令不适用白名单） */
+export declare const ALLOW_READONLY: RegExp;
+/** 高危命令黑名单（命中直接拒绝，不进 ask） */
+export declare const DENY: RegExp;
+/** shell 元字符（出现即降级走 ask，防白名单拼接绕过） */
+export declare const SHELL_META: RegExp;
+/** 单次 ssh_exec 默认超时（毫秒） */
+export declare const EXEC_TIMEOUT_MS = 30000;
+/** 静默窗口阈值：输出停止增长超过此时长视为命令完成 */
+export declare const QUIET_WINDOW_MS = 500;
+/** 动画检测阈值：连续输出超过此时长仍无哨兵/静默 → 判定仍在运行 */
+export declare const ANIMATION_WINDOW_MS = 5000;
+/** ssh2 认证超时（毫秒） */
+export declare const READY_TIMEOUT_MS = 10000;
+/** PTY 窗口尺寸（大窗口减少分页） */
+export declare const PTY_ROWS = 200;
+export declare const PTY_COLS = 500;
+/** 单次工具返回输出上限（字节） */
+export declare const MAX_OUTPUT_LEN = 50000;
+/** 工具描述语言环境变量（en | zh，默认 en） */
+export declare const LANG_ENV = "SSH_TOOL_LANG";
+/** 插件缓存根目录（历史消息对存文件，随会话清理） */
+export declare const CACHE_DIR = ".opencode/plugins-cache/opencode-ssh-tool";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,eAAO,MAAM,cAAc,QAC0F,CAAA;AAErH,6BAA6B;AAC7B,eAAO,MAAM,IAAI,QAC0kB,CAAA;AAE3lB,qCAAqC;AACrC,eAAO,MAAM,UAAU,QAAgB,CAAA;AAEvC,2BAA2B;AAC3B,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,OAAQ,CAAA;AAExC,oBAAoB;AACpB,eAAO,MAAM,gBAAgB,QAAS,CAAA;AAEtC,wBAAwB;AACxB,eAAO,MAAM,QAAQ,MAAM,CAAA;AAC3B,eAAO,MAAM,QAAQ,MAAM,CAAA;AAE3B,qBAAqB;AACrB,eAAO,MAAM,cAAc,QAAS,CAAA;AAEpC,gCAAgC;AAChC,eAAO,MAAM,QAAQ,kBAAkB,CAAA;AAEvC,8BAA8B;AAC9B,eAAO,MAAM,SAAS,8CAA8C,CAAA"}

package/dist/constants.js

@@ -0,0 +1,25 @@
+// 全局常量：权限正则、超时、PTY 尺寸、输出限制、语言配置
+/** 只读命令白名单（整串匹配，含元字符的命令不适用白名单） */
+export const ALLOW_READONLY = /^(?:ls|cd|cat|grep|tail|head|ps|df|free|pwd|env|echo|curl|wget|git status|whoami|hostname|date|uname|uptime)\b.*$/;
+/** 高危命令黑名单（命中直接拒绝，不进 ask） */
+export const DENY = /(?:rm\s+(?:-[a-z]*[fr][a-z]*(?:\s+-[a-z]*[fr][a-z]*)?\s+)?(?:\/(?:\s|$)|~|\.(?:\.)?|\/(?:etc|var|usr|boot|bin|sbin|lib|lib64|opt|root)(?:\s|$))|shutdown|reboot|halt|poweroff|mkfs|mkswap|fdisk|parted|dd\s|iptables|ufw|firewall-cmd|systemctl|service\s+\w+\s+(?:stop|restart|kill)|kill(?:all)?\s|pkill\s|passwd\s|useradd|userdel|groupadd|groupdel|chown\s+-R|chmod\s+-R\s+777\s+\/|apt\s+remove|apt-get\s+remove|npm\s+(?:uninstall|rm)\b|DROP\s+TABLE|TRUNCATE\s+TABLE|DROP\s+DATABASE|:\(\)\s*\{|>\s*\/etc\/(?:passwd|shadow|sudoers|fstab)|curl\s+.*\|\s*(?:ba)?sh|wget\s+.*\|\s*(?:ba)?sh|base64\s+-d\s*[|>])/;
+/** shell 元字符（出现即降级走 ask，防白名单拼接绕过） */
+export const SHELL_META = /[;|&`$()<>]/;
+/** 单次 ssh_exec 默认超时（毫秒） */
+export const EXEC_TIMEOUT_MS = 30_000;
+/** 静默窗口阈值：输出停止增长超过此时长视为命令完成 */
+export const QUIET_WINDOW_MS = 500;
+/** 动画检测阈值：连续输出超过此时长仍无哨兵/静默 → 判定仍在运行 */
+export const ANIMATION_WINDOW_MS = 5_000;
+/** ssh2 认证超时（毫秒） */
+export const READY_TIMEOUT_MS = 10_000;
+/** PTY 窗口尺寸（大窗口减少分页） */
+export const PTY_ROWS = 200;
+export const PTY_COLS = 500;
+/** 单次工具返回输出上限（字节） */
+export const MAX_OUTPUT_LEN = 50_000;
+/** 工具描述语言环境变量（en | zh，默认 en） */
+export const LANG_ENV = "SSH_TOOL_LANG";
+/** 插件缓存根目录（历史消息对存文件，随会话清理） */
+export const CACHE_DIR = ".opencode/plugins-cache/opencode-ssh-tool";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,kCAAkC;AAClC,MAAM,CAAC,MAAM,cAAc,GACzB,mHAAmH,CAAA;AAErH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,IAAI,GACf,ylBAAylB,CAAA;AAE3lB,qCAAqC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAA;AAEvC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAA;AAErC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC,uCAAuC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAA;AAExC,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAEtC,wBAAwB;AACxB,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAA;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAA;AAE3B,qBAAqB;AACrB,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AAEpC,gCAAgC;AAChC,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAA;AAEvC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,SAAS,GAAG,2CAA2C,CAAA"}

package/dist/history.d.ts

@@ -0,0 +1,54 @@
+/** 消息对元数据（输出存文件，内存只存引用） */
+export interface HistoryPair {
+    command: string;
+    /** 输出文件路径（持久化） */
+    file: string;
+    size: number;
+    ts: number;
+    /** 序号（文件顺序） */
+    seq: number;
+}
+/** 消息对存储：目录 <cacheRoot>/<sessionID>/，每对一文件，超对数删最旧 */
+export declare class SessionHistory {
+    private readonly maxMessages;
+    private pairs;
+    private readonly dir;
+    private nextSeq;
+    /**
+     * @param cacheRoot 插件缓存根目录（如 ~/.opencode/plugins-cache/opencode-ssh-tool）
+     * @param sessionID opencode 会话 ID（用作子目录名）
+     * @param maxMessages 保留消息对数（最小 1，保留最新）
+     */
+    constructor(cacheRoot: string, sessionID: string, maxMessages: number);
+    /** 从已有文件恢复索引（重启同 sessionID 可恢复历史） */
+    private _restore;
+    /**
+     * 追加一条命令+输出对（写文件），超对数移除最旧
+     * @param command 命令
+     * @param output 输出
+     */
+    append(command: string, output: string): void;
+    /** 超对数：删除最旧文件并移除索引 */
+    private _trim;
+    /**
+     * 当前保留的所有消息对（旧→新）
+     * @returns 消息对数组
+     */
+    getPairs(): HistoryPair[];
+    /**
+     * 读取某对输出（从文件）
+     * @param pair 消息对
+     * @returns 输出文本
+     */
+    readOutput(pair: HistoryPair): string;
+    /**
+     * 当前消息对数
+     * @returns 对数
+     */
+    totalPairs(): number;
+    /**
+     * 会话关闭：删除整个会话目录（含所有消息文件）
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAKA,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,qDAAqD;AACrD,qBAAa,cAAc;IAavB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAZ9B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAI;IAEnB;;;;OAIG;IACH,YACE,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACA,WAAW,EAAE,MAAM,EAKrC;IAED,qCAAqC;IACrC,OAAO,CAAC,QAAQ;IA2BhB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO5C;IAED,sBAAsB;IACtB,OAAO,CAAC,KAAK;IAab;;;OAGG;IACH,QAAQ,IAAI,WAAW,EAAE,CAExB;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAOpC;IAED;;;OAGG;IACH,UAAU,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAMd;CACF"}

package/dist/history.js

@@ -0,0 +1,114 @@
+// 会话记录存储：命令+输出 消息对，全部存文件（持久化，重启不丢），按对数限制
+import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/** 消息对存储：目录 <cacheRoot>/<sessionID>/，每对一文件，超对数删最旧 */
+export class SessionHistory {
+    maxMessages;
+    pairs = [];
+    dir;
+    nextSeq = 1;
+    /**
+     * @param cacheRoot 插件缓存根目录（如 ~/.opencode/plugins-cache/opencode-ssh-tool）
+     * @param sessionID opencode 会话 ID（用作子目录名）
+     * @param maxMessages 保留消息对数（最小 1，保留最新）
+     */
+    constructor(cacheRoot, sessionID, maxMessages) {
+        this.maxMessages = maxMessages;
+        this.dir = join(cacheRoot, sessionID);
+        mkdirSync(this.dir, { recursive: true });
+        this._restore();
+    }
+    /** 从已有文件恢复索引（重启同 sessionID 可恢复历史） */
+    _restore() {
+        let files;
+        try {
+            files = readdirSync(this.dir).filter((f) => f.endsWith(".json"));
+        }
+        catch {
+            files = [];
+        }
+        files.sort();
+        for (const f of files) {
+            try {
+                const data = JSON.parse(readFileSync(join(this.dir, f), "utf8"));
+                const seq = parseInt(f.split("-")[0] ?? "0", 10) || this.nextSeq;
+                const size = data.output?.length ?? 0;
+                this.pairs.push({ command: data.command, file: join(this.dir, f), size, ts: data.ts, seq });
+                if (seq >= this.nextSeq)
+                    this.nextSeq = seq + 1;
+            }
+            catch {
+                /* 跳过损坏文件 */
+            }
+        }
+        this.pairs.sort((a, b) => a.seq - b.seq);
+        this._trim();
+    }
+    /**
+     * 追加一条命令+输出对（写文件），超对数移除最旧
+     * @param command 命令
+     * @param output 输出
+     */
+    append(command, output) {
+        const ts = Date.now();
+        const seq = this.nextSeq++;
+        const file = join(this.dir, `${String(seq).padStart(6, "0")}-${ts}.json`);
+        writeFileSync(file, JSON.stringify({ command, output, ts }), "utf8");
+        this.pairs.push({ command, file, size: output.length, ts, seq });
+        this._trim();
+    }
+    /** 超对数：删除最旧文件并移除索引 */
+    _trim() {
+        while (this.pairs.length > Math.max(1, this.maxMessages)) {
+            const oldest = this.pairs.shift();
+            if (oldest) {
+                try {
+                    rmSync(oldest.file, { force: true });
+                }
+                catch {
+                    /* 忽略 */
+                }
+            }
+        }
+    }
+    /**
+     * 当前保留的所有消息对（旧→新）
+     * @returns 消息对数组
+     */
+    getPairs() {
+        return [...this.pairs];
+    }
+    /**
+     * 读取某对输出（从文件）
+     * @param pair 消息对
+     * @returns 输出文本
+     */
+    readOutput(pair) {
+        try {
+            const data = JSON.parse(readFileSync(pair.file, "utf8"));
+            return data.output ?? "";
+        }
+        catch {
+            return `[cannot read history file: ${pair.file}]`;
+        }
+    }
+    /**
+     * 当前消息对数
+     * @returns 对数
+     */
+    totalPairs() {
+        return this.pairs.length;
+    }
+    /**
+     * 会话关闭：删除整个会话目录（含所有消息文件）
+     */
+    dispose() {
+        try {
+            rmSync(this.dir, { recursive: true, force: true });
+        }
+        catch {
+            /* 忽略 */
+        }
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"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"}