@hddz/plugin-harness 0.1.19 → 0.2.0

package/README.md

@@ -1,45 +1,46 @@
 # @hddz/plugin-harness
 
-> **Harness Engineering 插件** - 为 AI Agent 构建约束、反馈与控制系统  
-> **版本**: 0.1.17  
-> **作者**: 蓝山  
-> **许可**: MIT
+> OpenClaw Harness Engineering 插件 - 为 AI Agent 构建约束、反馈与控制系统
+
+**最新版本**: v0.2.0 (2026-03-24)
 
 ---
 
-## 🎯 功能特性
+## 🎯 功能
 
-| 功能 | 说明 | 状态 |
-|------|------|------|
-| **配置验证** | 修改 `openclaw.json` 前自动验证，防止无效配置导致系统崩溃 | ✅ |
-| **Skill 审核** | 安装 Skill 前自动扫描安全风险 | ✅ |
-| **循环检测** | 检测 AI 对同一文件反复修改，防止死循环 | ✅ |
-| **文件保护** | 保护关键文件（SOUL.md 等）不被误删 | ✅ |
-| **操作审计** | 记录所有关键操作（编辑/删除/命令） | ✅ |
-| **Trace 追踪** | 完整的工具调用链路追踪 | ✅ |
+- ✅ **配置验证**：修改 `openclaw.json` 前自动验证
+- ✅ **Skill 审核**：安装 Skill 前自动安全扫描
+- ✅ **循环检测**：防止 AI 反复修改同一文件
+- ✅ **文件保护**：保护关键文件（SOUL.md 等）不被误删
+- ✅ **操作审计**：记录所有关键操作
+- ✅ **Trace 追踪**：完整的工具调用链路
+- ✅ **文件监听器** (v0.2.0 新增)：实时监听配置文件变化，用户手动编辑也能触发验证
 
 ---
 
 ## 🚀 快速开始
 
-### 方式一：使用 OpenClaw CLI（推荐）
+### 安装
 
 ```bash
-# 安装插件
-openclaw plugins install @hddz/plugin-harness@0.1.13
-
-# 重启 Gateway
-openclaw gateway restart
+# 从 npm 安装（推荐）
+npm install @hddz/plugin-harness@0.2.0
 
-# 验证安装
-openclaw plugins list
+# 本地开发版
+cd /Users/hzl/.openclaw/extensions/harness
+npm link
 ```
 
-**配置**：编辑 `~/.openclaw/openclaw.json`，添加：
+### 配置
+
+编辑 `~/.openclaw/openclaw.json`：
 
 ```json
 {
   "plugins": {
+    "installs": [
+      "@hddz/plugin-harness@0.2.0"
+    ],
     "entries": {
       "harness": {
         "enabled": true,
@@ -55,7 +56,7 @@ openclaw plugins list
             "MEMORY.md",
             "openclaw.json"
           ],
-          "logsDir": "workspace/logs/harness"
+          "logsDir": "logs/harness"
         }
       }
     }
@@ -63,13 +64,9 @@ openclaw plugins list
 }
 ```
 
-### 方式二：从本地目录安装（开发用）
+然后重启 gateway：
 
 ```bash
-# 链接本地插件目录
-openclaw plugins install -l /Users/hzl/.openclaw/workspace/harness-plugin
-
-# 重启 Gateway
 openclaw gateway restart
 ```
 
@@ -79,17 +76,35 @@ openclaw gateway restart
 
 | 选项 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `autoValidateConfig` | boolean | `true` | 自动验证配置变更 |
-| `autoAuditSkill` | boolean | `true` | 自动审核 Skill 安装 |
-| `loopDetectionEnabled` | boolean | `true` | 启用循环检测 |
-| `protectedFiles` | string[] | `[SOUL.md, ...]` | 保护文件列表 |
-| `logsDir` | string | `workspace/logs/harness` | 日志目录 |
+| `autoValidateConfig` | boolean | true | 配置修改前自动验证 |
+| `autoAuditSkill` | boolean | true | Skill 安装前自动审核 |
+| `loopDetectionEnabled` | boolean | true | 启用循环检测 |
+| `protectedFiles` | string[] | 见上文 | 受保护的文件列表 |
+| `logsDir` | string | logs/harness | 日志目录 |
 
 ---
 
-## 🔧 命令行工具
+## 🔍 使用示例
+
+### 配置验证（自动）
+
+```typescript
+// 修改 openclaw.json 时自动触发
+const result = await plugin.onConfigChange(newConfig);
+// 如果验证失败，会抛出异常阻止修改
+```
+
+### Skill 审核（自动）
+
+```typescript
+// 安装 Skill 时自动触发
+const auditResult = await plugin.onSkillInstall('/path/to/skill');
+if (!auditResult.passed) {
+  throw new Error(`Skill 审核未通过：${auditResult.riskLevel}`);
+}
+```
 
-安装后，可使用以下命令：
+### 手动查询
 
 ```bash
 # 查看最近的配置变更
@@ -97,112 +112,80 @@ harness get-config-changes -l 10
 
 # 查看操作日志
 harness get-operations -l 20
+
+# 查看循环检测统计
+harness loop-stats
 ```
 
 ---
 
-## 🏗️ 架构设计
+## 🛡️ 安全机制
 
-### Hook 系统
+### 保护文件
 
-| Hook | 触发时机 | 功能 |
-|------|----------|------|
-| `onConfigChange` | 修改 `openclaw.json` 前 | 验证配置有效性 |
-| `onSkillInstall` | 安装 Skill 前 | 扫描安全风险 |
-| `onFileEdit` | 编辑文件时 | 循环检测 + 保护文件监控 |
-| `onFileDelete` | 删除文件前 | 拦截保护文件删除 |
-| `onExecCommand` | 执行命令前 | 记录审计日志 |
+以下文件默认受保护，修改/删除前会告警：
 
-### 目录结构
+- `SOUL.md` - 身份定义
+- `USER.md` - 用户信息
+- `AGENTS.md` - Agent 指南
+- `TOOLS.md` - 工具配置
+- `MEMORY.md` - 长期记忆
+- `openclaw.json` - 核心配置
 
-```
-harness-plugin/
-├── src/
-│   └── index.ts          # 插件核心逻辑
-├── dist/                 # 编译输出
-├── docs/                 # 文档
-├── openclaw.plugin.json  # OpenClaw 插件元数据
-├── package.json          # NPM 配置
-├── tsconfig.json         # TypeScript 配置
-└── README.md             # 本文件
-```
+### 风险等级
 
----
+| 等级 | 标识 | 处理 |
+|------|------|------|
+| LOW | 🟢 | 允许 |
+| MEDIUM | 🟡 | 警告，但允许 |
+| HIGH | 🟠 | 阻止，需人工确认 |
+| CRITICAL | 🔴 | 阻止，禁止操作 |
 
-## 🐛 常见问题
+---
 
-### Q: 插件加载失败？
+## 📚 文档
 
-**A**: 检查：
-1. 确认安装成功：`openclaw plugins list`
-2. 查看日志：`openclaw gateway status`
-3. 确认 `openclaw.json` 配置了 `plugins.entries.harness`
-4. 检查 manifest：`cat ~/.openclaw/extensions/harness/openclaw.plugin.json`
+- [使用指南](./docs/使用指南.md)
+- [开发文档](./docs/开发文档.md)
+- [API 参考](./docs/API.md)
 
-### Q: 配置验证不工作？
+---
 
-**A**: 检查 `openclaw.json` 中：
-```json
-{
-  "plugins": {
-    "entries": {
-      "harness": {
-        "enabled": true,
-        "config": {
-          "autoValidateConfig": true
-        }
-      }
-    }
-  }
-}
-```
+## 🔧 开发
 
-### Q: 如何禁用某个功能？
+```bash
+# 安装依赖
+npm install
 
-**A**: 修改 `openclaw.json` 配置：
-```json
-{
-  "plugins": {
-    "entries": {
-      "harness": {
-        "config": {
-          "autoValidateConfig": false,
-          "loopDetectionEnabled": false
-        }
-      }
-    }
-  }
-}
-```
+# 构建
+npm run build
 
-### Q: 如何卸载？
+# 测试
+npm test
 
-**A**: 
-```bash
-openclaw plugins uninstall harness
-openclaw gateway restart
+# 链接到 OpenClaw
+npm link
 ```
 
 ---
 
-## 📚 更多文档
+## 📝 变更日志
+
+### v0.1.0 (2026-03-19)
 
-- [Harness 插件开发完整教程](./docs/Harness 插件开发完整教程.md)
-- [发布与安装指南](./docs/发布与安装指南.md)
+- ✅ 初始版本
+- ✅ 配置验证
+- ✅ Skill 审核
+- ✅ 循环检测
+- ✅ 操作日志
+- ✅ Trace 追踪
 
 ---
 
-## 📦 发布历史
+## 📄 许可证
 
-| 版本 | 日期 | 变更 |
-|------|------|------|
-| 0.1.10 | 2026-03-24 | 添加 `openclaw.plugin.json` manifest，支持 `openclaw plugins install` |
-| 0.1.9 | 2026-03-24 | 提供 `install.sh` 一键安装脚本 |
-| 0.1.8 | 2026-03-24 | 修复 Skill 审核路径问题 |
-| 0.1.7 | 2026-03-23 | 初始发布到 npm |
+MIT
 
 ---
 
-**许可证**: MIT  
-**仓库**: https://github.com/hddz/plugin-harness  
-**npm**: https://www.npmjs.com/package/@hddz/plugin-harness
+_@openclaw/plugin-harness | 蓝山 | 2026-03-19_

package/dist/file-watcher.d.ts

@@ -0,0 +1,37 @@
+import type { HarnessPlugin } from './index.js';
+export interface FileWatcherConfig {
+    watchFiles: string[];
+    debounceMs: number;
+    onFileChange: (filePath: string, newContent: any) => Promise<void>;
+}
+export declare class FileWatcher {
+    private watchPaths;
+    private debounceTimers;
+    private config;
+    private plugin;
+    constructor(plugin: HarnessPlugin, config: FileWatcherConfig);
+    /**
+     * 开始监听文件
+     */
+    start(): void;
+    /**
+     * 监听单个文件
+     */
+    private watchFile;
+    /**
+     * 停止监听单个文件
+     */
+    private unwatchFile;
+    /**
+     * 文件变化处理（带防抖）
+     */
+    private onFileChange;
+    /**
+     * 处理文件变化
+     */
+    private handleFileChange;
+    /**
+     * 停止所有监听
+     */
+    stop(): void;
+}

package/dist/file-watcher.js

@@ -0,0 +1,151 @@
+"use strict";
+// src/file-watcher.ts - 配置文件监听器
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWatcher = void 0;
+const fs = __importStar(require("fs"));
+class FileWatcher {
+    watchPaths = new Map();
+    debounceTimers = new Map();
+    config;
+    plugin;
+    constructor(plugin, config) {
+        this.plugin = plugin;
+        this.config = config;
+    }
+    /**
+     * 开始监听文件
+     */
+    start() {
+        console.log('👁️ [FileWatcher] 开始监听配置文件...');
+        for (const file of this.config.watchFiles) {
+            this.watchFile(file);
+        }
+        console.log(`👁️ [FileWatcher] 正在监听 ${this.config.watchFiles.length} 个文件`);
+    }
+    /**
+     * 监听单个文件
+     */
+    watchFile(filePath) {
+        // 如果已经在监听，先停止
+        if (this.watchPaths.has(filePath)) {
+            this.unwatchFile(filePath);
+        }
+        try {
+            const watcher = fs.watch(filePath, { persistent: false }, (eventType, filename) => {
+                if (eventType === 'change' || eventType === 'rename') {
+                    console.log(`📝 [FileWatcher] 检测到文件变化：${filePath} (${eventType})`);
+                    this.onFileChange(filePath);
+                }
+            });
+            watcher.on('error', (error) => {
+                console.error(`❌ [FileWatcher] 监听错误 ${filePath}:`, error.message);
+            });
+            this.watchPaths.set(filePath, watcher);
+            console.log(`✅ [FileWatcher] 开始监听：${filePath}`);
+        }
+        catch (error) {
+            console.warn(`⚠️ [FileWatcher] 无法监听文件 ${filePath}: ${error.message}`);
+        }
+    }
+    /**
+     * 停止监听单个文件
+     */
+    unwatchFile(filePath) {
+        const watcher = this.watchPaths.get(filePath);
+        if (watcher) {
+            watcher.close();
+            this.watchPaths.delete(filePath);
+            console.log(`🛑 [FileWatcher] 停止监听：${filePath}`);
+        }
+    }
+    /**
+     * 文件变化处理（带防抖）
+     */
+    async onFileChange(filePath) {
+        // 清除之前的定时器
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // 设置新的防抖定时器
+        const timer = setTimeout(async () => {
+            try {
+                await this.handleFileChange(filePath);
+            }
+            catch (error) {
+                console.error(`❌ [FileWatcher] 处理文件变化失败 ${filePath}:`, error.message);
+            }
+            this.debounceTimers.delete(filePath);
+        }, this.config.debounceMs);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * 处理文件变化
+     */
+    async handleFileChange(filePath) {
+        console.log(`🔍 [FileWatcher] 处理文件变化：${filePath}`);
+        // 读取新配置
+        let newConfig;
+        try {
+            const content = fs.readFileSync(filePath, 'utf8');
+            newConfig = JSON.parse(content);
+        }
+        catch (error) {
+            console.error(`❌ [FileWatcher] 读取配置失败：${error.message}`);
+            return;
+        }
+        // 调用插件的配置变更处理
+        await this.config.onFileChange(filePath, newConfig);
+    }
+    /**
+     * 停止所有监听
+     */
+    stop() {
+        console.log('🛑 [FileWatcher] 停止所有文件监听...');
+        for (const [filePath, watcher] of this.watchPaths.entries()) {
+            watcher.close();
+        }
+        this.watchPaths.clear();
+        // 清除所有定时器
+        for (const [filePath, timer] of this.debounceTimers.entries()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        console.log('🛑 [FileWatcher] 已停止所有监听');
+    }
+}
+exports.FileWatcher = FileWatcher;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsZS13YXRjaGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZpbGUtd2F0Y2hlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsZ0NBQWdDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFaEMsdUNBQXlCO0FBVXpCLE1BQWEsV0FBVztJQUNkLFVBQVUsR0FBOEIsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUNsRCxjQUFjLEdBQWdDLElBQUksR0FBRyxFQUFFLENBQUM7SUFDeEQsTUFBTSxDQUFvQjtJQUMxQixNQUFNLENBQWdCO0lBRTlCLFlBQVksTUFBcUIsRUFBRSxNQUF5QjtRQUMxRCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBRUQ7O09BRUc7SUFDSCxLQUFLO1FBQ0gsT0FBTyxDQUFDLEdBQUcsQ0FBQywrQkFBK0IsQ0FBQyxDQUFDO1FBRTdDLEtBQUssTUFBTSxJQUFJLElBQUksSUFBSSxDQUFDLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUMxQyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3ZCLENBQUM7UUFFRCxPQUFPLENBQUMsR0FBRyxDQUFDLDBCQUEwQixJQUFJLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLE1BQU0sQ0FBQyxDQUFDO0lBQzdFLENBQUM7SUFFRDs7T0FFRztJQUNLLFNBQVMsQ0FBQyxRQUFnQjtRQUNoQyxjQUFjO1FBQ2QsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQ2xDLElBQUksQ0FBQyxXQUFXLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDN0IsQ0FBQztRQUVELElBQUksQ0FBQztZQUNILE1BQU0sT0FBTyxHQUFHLEVBQUUsQ0FBQyxLQUFLLENBQUMsUUFBUSxFQUFFLEVB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T0FBTyxLQUFVLEVBQUUsQ0FBQztZQUNwQixPQUFPLENBQUMsS0FBSyxDQUFDLDBCQUEwQixLQUFLLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQztZQUN6RCxPQUFPO1FBQ1QsQ0FBQztRQUVELGNBQWM7UUFDZCxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsWUFBWSxDQUFDLFFBQVEsRUFBRSxTQUFTLENBQUMsQ0FBQztJQUN0RCxDQUFDO0lBRUQ7O09BRUc7SUFDSCxJQUFJO1FBQ0YsT0FBTyxDQUFDLEdBQUcsQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRTVDLEtBQUssTUFBTSxDQUFDLFFBQVEsRUFBRSxPQUFPLENBQUMsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUM7WUFDNUQsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ2xCLENBQUM7UUFFRCxJQUFJLENBQUMsVUFBVSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBRXhCLFVBQVU7UUFDVixLQUFLLE1BQU0sQ0FBQyxRQUFRLEVBQUUsS0FBSyxDQUFDLElBQUksSUFBSSxDQUFDLGNBQWMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDO1lBQzlELFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN0QixDQUFDO1FBRUQsSUFBSSxDQUFDLGNBQWMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUM1QixPQUFPLENBQUMsR0FBRyxDQUFDLDBCQUEwQixDQUFDLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBL0hELGtDQStIQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIHNyYy9maWxlLXdhdGNoZXIudHMgLSDphY3nva7mlofku7bnm5HlkKzlmahcblxuaW1wb3J0ICogYXMgZnMgZnJvbSAnZnMnO1xuaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCB0eXBlIHsgSGFybmVzc1BsdWdpbiB9IGZyb20gJy4vaW5kZXguanMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIEZpbGVXYXRjaGVyQ29uZmlnIHtcbiAgd2F0Y2hGaWxlczogc3RyaW5nW107XG4gIGRlYm91bmNlTXM6IG51bWJlcjtcbiAgb25GaWxlQ2hhbmdlOiAoZmlsZVBhdGg6IHN0cmluZywgbmV3Q29udGVudDogYW55KSA9PiBQcm9taXNlPHZvaWQ+O1xufVxuXG5leHBvcnQgY2xhc3MgRmlsZVdhdGNoZXIge1xuICBwcml2YXRlIHdhdGNoUGF0aHM6IE1hcDxzdHJpbmcsIGZzLkZTV2F0Y2hlcj4gPSBuZXcgTWFwKCk7XG4gIHByaXZhdGUgZGVib3VuY2VUaW1lcnM6IE1hcDxzdHJpbmcsIE5vZGVKUy5UaW1lb3V0PiA9IG5ldyBNYXAoKTtcbiAgcHJpdmF0ZSBjb25maWc6IEZpbGVXYXRjaGVyQ29uZmlnO1xuICBwcml2YXRlIHBsdWdpbjogSGFybmVzc1BsdWdpbjtcblxuICBjb25zdHJ1Y3RvcihwbHVnaW46IEhhcm5lc3NQbHVnaW4sIGNvbmZpZzogRmlsZVdhdGNoZXJDb25maWcpIHtcbiAgICB0aGlzLnBsdWdpbiA9IHBsdWdpbjtcbiAgICB0aGlzLmNvbmZpZyA9IGNvbmZpZztcbiAgfVxuXG4gIC8qKlxuICAgKiDlvIDlp4vnm5HlkKzmlofku7ZcbiAgICovXG4gIHN0YXJ0KCk6IHZvaWQge1xuICAgIGNvbnNvbGUubG9nKCfwn5GB77iPIFtGaWxlV2F0Y2hlcl0g5byA5aeL55uR5ZCs6YWN572u5paH5Lu2Li4uJyk7XG4gICAgXG4gICAgZm9yIChjb25zdCBmaWxlIG9mIHRoaXMuY29uZmlnLndhdGNoRmlsZXMpIHtcbiAgICAgIHRoaXMud2F0Y2hGaWxlKGZpbGUpO1xuICAgIH1cbiAgICBcbiAgICBjb25zb2xlLmxvZyhg8J+Rge+4jyBbRmlsZVdhdGNoZXJdIOato+WcqOebkeWQrCAke3RoaXMuY29uZmlnLndhdGNoRmlsZXMubGVuZ3RofSDkuKrmlofku7ZgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiDnm5HlkKzljZXkuKrmlofku7ZcbiAgICovXG4gIHByaXZhdGUgd2F0Y2hGaWxlKGZpbGVQYXRoOiBzdHJpbmcpOiB2b2lkIHtcbiAgICAvLyDlpoLmnpzlt7Lnu4/lnKjnm5HlkKzvvIzlhYjlgZzmraJcbiAgICBpZiAodGhpcy53YXRjaFBhdGhzLmhhcyhmaWxlUGF0aCkpIHtcbiAgICAgIHRoaXMudW53YXRjaEZpbGUoZmlsZVBhdGgpO1xuICAgIH1cblxuICAgIHRyeSB7XG4gICAgICBjb25zdCB3YXRjaGVyID0gZnMud2F0Y2goZmlsZVBhdGgsIHsgcGVyc2lzdGVudDogZmFsc2UgfSwgKGV2ZW50VHlwZSwgZmlsZW5hbWUpID0+IHtcbiAgICAgICAgaWYgKGV2ZW50VHlwZSA9PT0gJ2NoYW5nZScgfHwgZXZlbnRUeXBlID09PSAncmVuYW1lJykge1xuICAgICAgICAgIGNvbnNvbGUubG9nKGDwn5OdIFtGaWxlV2F0Y2hlcl0g5qOA5rWL5Yiw5paH5Lu25Y+Y5YyW77yaJHtmaWxlUGF0aH0gKCR7ZXZlbnRUeXBlfSlgKTtcbiAgICAgICAgICB0aGlzLm9uRmlsZUNoYW5nZShmaWxlUGF0aCk7XG4gICAgICAgIH1cbiAgICAgIH0pO1xuXG4gICAgICB3YXRjaGVyLm9uKCdlcnJvcicsIChlcnJvcikgPT4ge1xuICAgICAgICBjb25zb2xlLmVycm9yKGDinYwgW0ZpbGVXYXRjaGVyXSDnm5HlkKzplJnor68gJHtmaWxlUGF0aH06YCwgZXJyb3IubWVzc2FnZSk7XG4gICAgICB9KTtcblxuICAgICAgdGhpcy53YXRjaFBhdGhzLnNldChmaWxlUGF0aCwgd2F0Y2hlcik7XG4gICAgICBjb25zb2xlLmxvZyhg4pyFIFtGaWxlV2F0Y2hlcl0g5byA5aeL55uR5ZCs77yaJHtmaWxlUGF0aH1gKTtcbiAgICB9IGNhdGNoIChlcnJvcjogYW55KSB7XG4gICAgICBjb25zb2xlLndhcm4oYOKaoO+4jyBbRmlsZVdhdGNoZXJdIOaXoOazleebkeWQrOaWh+S7tiAke2ZpbGVQYXRofTogJHtlcnJvci5tZXNzYWdlfWApO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiDlgZzmraLnm5HlkKzljZXkuKrmlofku7ZcbiAgICovXG4gIHByaXZhdGUgdW53YXRjaEZpbGUoZmlsZVBhdGg6IHN0cmluZyk6IHZvaWQge1xuICAgIGNvbnN0IHdhdGNoZXIgPSB0aGlzLndhdGNoUGF0aHMuZ2V0KGZpbGVQYXRoKTtcbiAgICBpZiAod2F0Y2hlcikge1xuICAgICAgd2F0Y2hlci5jbG9zZSgpO1xuICAgICAgdGhpcy53YXRjaFBhdGhzLmRlbGV0ZShmaWxlUGF0aCk7XG4gICAgICBjb25zb2xlLmxvZyhg8J+bkSBbRmlsZVdhdGNoZXJdIOWBnOatouebkeWQrO+8miR7ZmlsZVBhdGh9YCk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIOaWh+S7tuWPmOWMluWkhOeQhu+8iOW4pumYsuaKlu+8iVxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBvbkZpbGVDaGFuZ2UoZmlsZVBhdGg6IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICAgIC8vIOa4hemZpOS5i+WJjeeahOWumuaXtuWZqFxuICAgIGNvbnN0IGV4aXN0aW5nVGltZXIgPSB0aGlzLmRlYm91bmNlVGltZXJzLmdldChmaWxlUGF0aCk7XG4gICAgaWYgKGV4aXN0aW5nVGltZXIpIHtcbiAgICAgIGNsZWFyVGltZW91dChleGlzdGluZ1RpbWVyKTtcbiAgICB9XG5cbiAgICAvLyDorr7nva7mlrDnmoTpmLLmipblrprml7blmahcbiAgICBjb25zdCB0aW1lciA9IHNldFRpbWVvdXQoYXN5bmMgKCkgPT4ge1xuICAgICAgdHJ5IHtcbiAgICAgICAgYXdhaXQgdGhpcy5oYW5kbGVGaWxlQ2hhbmdlKGZpbGVQYXRoKTtcbiAgICAgIH0gY2F0Y2ggKGVycm9yOiBhbnkpIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihg4p2MIFtGaWxlV2F0Y2hlcl0g5aSE55CG5paH5Lu25Y+Y5YyW5aSx6LSlICR7ZmlsZVBhdGh9OmAsIGVycm9yLm1lc3NhZ2UpO1xuICAgICAgfVxuICAgICAgdGhpcy5kZWJvdW5jZVRpbWVycy5kZWxldGUoZmlsZVBhdGgpO1xuICAgIH0sIHRoaXMuY29uZmlnLmRlYm91bmNlTXMpO1xuXG4gICAgdGhpcy5kZWJvdW5jZVRpbWVycy5zZXQoZmlsZVBhdGgsIHRpbWVyKTtcbiAgfVxuXG4gIC8qKlxuICAgKiDlpITnkIbmlofku7blj5jljJZcbiAgICovXG4gIHByaXZhdGUgYXN5bmMgaGFuZGxlRmlsZUNoYW5nZShmaWxlUGF0aDogc3RyaW5nKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgY29uc29sZS5sb2coYPCflI0gW0ZpbGVXYXRjaGVyXSDlpITnkIbmlofku7blj5jljJbvvJoke2ZpbGVQYXRofWApO1xuXG4gICAgLy8g6K+75Y+W5paw6YWN572uXG4gICAgbGV0IG5ld0NvbmZpZzogYW55O1xuICAgIHRyeSB7XG4gICAgICBjb25zdCBjb250ZW50ID0gZnMucmVhZEZpbGVTeW5jKGZpbGVQYXRoLCAndXRmOCcpO1xuICAgICAgbmV3Q29uZmlnID0gSlNPTi5wYXJzZShjb250ZW50KTtcbiAgICB9IGNhdGNoIChlcnJvcjogYW55KSB7XG4gICAgICBjb25zb2xlLmVycm9yKGDinYwgW0ZpbGVXYXRjaGVyXSDor7vlj5bphY3nva7lpLHotKXvvJoke2Vycm9yLm1lc3NhZ2V9YCk7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgLy8g6LCD55So5o+S5Lu255qE6YWN572u5Y+Y5pu05aSE55CGXG4gICAgYXdhaXQgdGhpcy5jb25maWcub25GaWxlQ2hhbmdlKGZpbGVQYXRoLCBuZXdDb25maWcpO1xuICB9XG5cbiAgLyoqXG4gICAqIOWBnOatouaJgOacieebkeWQrFxuICAgKi9cbiAgc3RvcCgpOiB2b2lkIHtcbiAgICBjb25zb2xlLmxvZygn8J+bkSBbRmlsZVdhdGNoZXJdIOWBnOatouaJgOacieaWh+S7tuebkeWQrC4uLicpO1xuICAgIFxuICAgIGZvciAoY29uc3QgW2ZpbGVQYXRoLCB3YXRjaGVyXSBvZiB0aGlzLndhdGNoUGF0aHMuZW50cmllcygpKSB7XG4gICAgICB3YXRjaGVyLmNsb3NlKCk7XG4gICAgfVxuICAgIFxuICAgIHRoaXMud2F0Y2hQYXRocy5jbGVhcigpO1xuICAgIFxuICAgIC8vIOa4hemZpOaJgOacieWumuaXtuWZqFxuICAgIGZvciAoY29uc3QgW2ZpbGVQYXRoLCB0aW1lcl0gb2YgdGhpcy5kZWJvdW5jZVRpbWVycy5lbnRyaWVzKCkpIHtcbiAgICAgIGNsZWFyVGltZW91dCh0aW1lcik7XG4gICAgfVxuICAgIFxuICAgIHRoaXMuZGVib3VuY2VUaW1lcnMuY2xlYXIoKTtcbiAgICBjb25zb2xlLmxvZygn8J+bkSBbRmlsZVdhdGNoZXJdIOW3suWBnOatouaJgOacieebkeWQrCcpO1xuICB9XG59XG4iXX0=

package/dist/index.d.ts

@@ -5,3 +5,66 @@ export interface HarnessPluginConfig {
     protectedFiles: string[];
     logsDir: string;
 }
+export declare class HarnessPlugin {
+    name: string;
+    version: string;
+    private config;
+    private workspacePath;
+    private configValidator;
+    private skillAuditor;
+    private loopDetector;
+    private configLogger;
+    private operationLogger;
+    private traceLogger;
+    constructor(workspacePath: string, config?: Partial<HarnessPluginConfig>);
+    /**
+     * Hook: 配置修改前验证
+     */
+    onConfigChange(newConfig: any, sessionId?: string): Promise<{
+        valid: boolean;
+        errors?: string[];
+    }>;
+    /**
+     * 公开方法：记录配置变更
+     */
+    logConfigChange(entry: {
+        sessionId: string;
+        modifier: string;
+        file: string;
+        reason: string;
+        verified: boolean;
+        gatewayRestarted: boolean;
+        changes: any[];
+    }): void;
+    /**
+     * Hook: Skill 安装前审核
+     */
+    onSkillInstall(skillPath: string, source?: string, sessionId?: string): Promise<{
+        passed: boolean;
+        warnings?: any[];
+    }>;
+    /**
+     * Hook: 文件编辑时循环检测
+     */
+    onFileEdit(filePath: string, sessionId?: string): {
+        allowed: boolean;
+        warning?: string;
+    };
+    /**
+     * Hook: 文件删除前检查
+     */
+    onFileDelete(filePath: string, sessionId?: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Hook: 系统命令执行前
+     */
+    onExecCommand(command: string, sessionId?: string): void;
+    /**
+     * 获取插件状态
+     */
+    getStatus(): any;
+}
+export declare function createPlugin(workspacePath: string, config: any): HarnessPlugin;
+export default HarnessPlugin;