@hddz/plugin-harness 0.1.10 → 0.1.12

package/README.md

@@ -1,7 +1,7 @@
 # @hddz/plugin-harness
 
 > **Harness Engineering 插件** - 为 AI Agent 构建约束、反馈与控制系统  
-> **版本**: 0.1.10  
+> **版本**: 0.1.12  
 > **作者**: 蓝山  
 > **许可**: MIT
 
@@ -22,58 +22,26 @@
 
 ## 🚀 快速开始
 
-### 方式一：一键安装脚本（推荐）
-
-**systemd 服务（root 用户）**：
+### 方式一：使用 OpenClaw CLI（推荐）
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/hddz/plugin-harness/main/install.sh | sudo bash
-```
-
-**本地运行**：
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hddz/plugin-harness/main/install.sh | bash
-```
-
-脚本会自动：
-- 安装 npm 包
-- 重命名目录（`plugin-harness` → `harness`）
-- 清理旧版本
+# 安装插件
+openclaw plugins install @hddz/plugin-harness@0.1.12
 
-### 方式二：手动安装
-
-**普通用户（本地运行 OpenClaw）**：
-
-```bash
-npm install @hddz/plugin-harness@0.1.10
-```
-
-**systemd 服务（root 用户运行 OpenClaw）**：
+# 重启 Gateway
+openclaw gateway restart
 
-```bash
-sudo -i
-npm install @hddz/plugin-harness@0.1.10
-exit
+# 验证安装
+openclaw plugins list
 ```
 
-**注意**：`@hddz/harness` 依赖会自动安装，无需手动操作。
-
-### 2. 配置
-
-编辑 `~/.openclaw/openclaw.json`（systemd 服务编辑 `/root/.openclaw/openclaw.json`），添加以下配置：
+**配置**：编辑 `~/.openclaw/openclaw.json`，添加：
 
 ```json
 {
   "plugins": {
-    "installs": {
-      "plugin-harness": {
-        "source": "npm",
-        "spec": "@hddz/plugin-harness@0.1.9"
-      }
-    },
     "entries": {
-      "plugin-harness": {
+      "harness": {
         "enabled": true,
         "config": {
           "autoValidateConfig": true,
@@ -95,28 +63,14 @@ exit
 }
 ```
 
-**注意**：`plugins.installs` 和 `plugins.entries` 的 key 必须一致（都用 `plugin-harness`），且匹配 npm 包名。
-
-### 3. 重启
+### 方式二：从本地目录安装（开发用）
 
 ```bash
-openclaw gateway restart
-```
+# 链接本地插件目录
+openclaw plugins install -l /Users/hzl/.openclaw/workspace/harness-plugin
 
-### 4. 验证
-
-```bash
-openclaw gateway status
-```
-
-看到以下输出表示成功：
-
-```
-🛡️ [Harness] OpenClaw 插件已启动
-   - 配置验证：✅ 启用
-   - Skill 审核：✅ 启用
-   - 循环检测：✅ 启用
-   - 保护文件：6 个
+# 重启 Gateway
+openclaw gateway restart
 ```
 
 ---
@@ -125,78 +79,19 @@ openclaw gateway status
 
 | 选项 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `autoValidateConfig` | boolean | `true` | 配置修改前自动验证 |
-| `autoAuditSkill` | boolean | `true` | Skill 安装前自动审核 |
+| `autoValidateConfig` | boolean | `true` | 自动验证配置变更 |
+| `autoAuditSkill` | boolean | `true` | 自动审核 Skill 安装 |
 | `loopDetectionEnabled` | boolean | `true` | 启用循环检测 |
-| `protectedFiles` | string[] | 见上文 | 受保护的文件列表 |
-| `logsDir` | string | `"workspace/logs/harness"` | 日志目录（相对于 workspace） |
-
-**日志文件位置**：
-
-```bash
-# 配置变更日志
-cat ~/.openclaw/workspace/logs/harness/config-changes.md
-
-# 操作审计日志
-cat ~/.openclaw/workspace/logs/harness/operations.md
-
-# Trace 日志
-cat ~/.openclaw/workspace/logs/harness/traces.jsonl
-```
+| `protectedFiles` | string[] | `[SOUL.md, ...]` | 保护文件列表 |
+| `logsDir` | string | `workspace/logs/harness` | 日志目录 |
 
 ---
 
-## 🔍 使用示例
-
-### 配置验证（自动触发）
+## 🔧 命令行工具
 
-修改 `openclaw.json` 时自动验证：
+安装后，可使用以下命令：
 
 ```bash
-# 故意改错配置
-# 编辑 openclaw.json，把 gateway.port 改成 "wrong-type"
-
-# 重启 Gateway
-openclaw gateway restart
-
-# 输出：
-# ❌ Config invalid
-# - gateway.port: Invalid input: expected number, received string
-```
-
-### 文件保护
-
-尝试删除受保护文件：
-
-```bash
-rm ~/.openclaw/workspace/SOUL.md
-
-# 输出：
-# 🛡️ [Harness] 拦截删除操作：SOUL.md 是受保护文件
-```
-
-### 查看日志
-
-```bash
-# 配置变更日志
-cat ~/.openclaw/workspace/logs/harness/config-changes.md
-
-# 操作审计日志
-cat ~/.openclaw/workspace/logs/harness/operations.md
-
-# Trace 日志
-cat ~/.openclaw/workspace/logs/harness/traces.jsonl
-```
-
-### CLI 工具
-
-```bash
-# 查看版本
-harness --version
-
-# 查看循环检测统计
-harness loop-stats
-
 # 查看最近的配置变更
 harness get-config-changes -l 10
 
@@ -226,12 +121,9 @@ harness-plugin/
 │   └── index.ts          # 插件核心逻辑
 ├── dist/                 # 编译输出
 ├── docs/                 # 文档
-│   ├── Harness 插件开发完整教程.md
-│   ├── 发布与安装指南.md
-│   └── 集成完成报告.md
+├── openclaw.plugin.json  # OpenClaw 插件元数据
 ├── package.json          # NPM 配置
 ├── tsconfig.json         # TypeScript 配置
-├── openclaw.plugin.json  # OpenClaw 插件元数据
 └── README.md             # 本文件
 ```
 
@@ -242,11 +134,10 @@ harness-plugin/
 ### Q: 插件加载失败？
 
 **A**: 检查：
-1. 确认安装成功：`npm list @hddz/plugin-harness`
+1. 确认安装成功：`openclaw plugins list`
 2. 查看日志：`openclaw gateway status`
-3. systemd 服务需以 root 身份安装：`sudo -i && npm install @hddz/plugin-harness@0.1.7`
-4. 确认 `openclaw.json` 配置了 `plugins.installs` 和 `plugins.entries` 两部分
-5. 检查依赖是否安装：`npm list @hddz/harness`
+3. 确认 `openclaw.json` 配置了 `plugins.entries.harness`
+4. 检查 manifest：`cat ~/.openclaw/extensions/harness/openclaw.plugin.json`
 
 ### Q: 配置验证不工作？
 
@@ -258,7 +149,7 @@ harness-plugin/
       "harness": {
         "enabled": true,
         "config": {
-          "autoValidateConfig": true  // 确保此项为 true
+          "autoValidateConfig": true
         }
       }
     }
@@ -275,8 +166,8 @@ harness-plugin/
     "entries": {
       "harness": {
         "config": {
-          "autoValidateConfig": false,  // 禁用配置验证
-          "loopDetectionEnabled": false // 禁用循环检测
+          "autoValidateConfig": false,
+          "loopDetectionEnabled": false
         }
       }
     }
@@ -287,94 +178,31 @@ harness-plugin/
 ### Q: 如何卸载？
 
 **A**: 
-1. 编辑 `openclaw.json`，移除 `plugins.installs.harness` 和 `plugins.entries.harness`
-2. 运行 `npm uninstall @hddz/plugin-harness`
-3. 重启 Gateway：`openclaw gateway restart`
+```bash
+openclaw plugins uninstall harness
+openclaw gateway restart
+```
 
 ---
 
 ## 📚 更多文档
 
-- [Harness 插件开发完整教程](./docs/Harness 插件开发完整教程.md) - 从零开发插件的完整流程
-- [发布与安装指南](./docs/发布与安装指南.md) - 发布到 NPM/GitHub 的详细步骤
-- [集成完成报告](./docs/集成完成报告.md) - 功能测试报告
-
----
-
-## 🚧 未来计划
-
-### P0 - 关键安全（计划中）
-- [ ] 资源限制（token/磁盘/CPU）
-- [ ] 速率限制（API 调用频率）
-- [ ] 敏感信息保护（API Key 防泄露）
-- [ ] 自动备份/快照
-- [ ] 高风险操作确认
-
-### P1 - 重要防护（考虑中）
-- [ ] 网络访问控制（白名单）
-- [ ] 环境变量保护
-- [ ] 依赖锁定
-- [ ] 会话超时管理
-- [ ] 异常行为检测
-
----
-
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](./LICENSE)
+- [Harness 插件开发完整教程](./docs/Harness 插件开发完整教程.md)
+- [发布与安装指南](./docs/发布与安装指南.md)
 
 ---
 
-## 🙏 致谢
+## 📦 发布历史
 
-- OpenClaw 团队 - 提供插件系统
-- Harness Engineering 理念 - OpenAI, Anthropic, LangChain
-
----
-
-**最后更新**: 2026-03-24  
-**维护者**: 蓝山  
-**npm**: https://www.npmjs.com/package/@hddz/plugin-harness
-- [ ] 异常行为检测
-
----
-
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](./LICENSE)
-
----
-
-## 🙏 致谢
-
-- OpenClaw 团队 - 提供插件系统
-- Harness Engineering 理念 - OpenAI, Anthropic, LangChain
-
----
-
-**最后更新**: 2026-03-24  
-**维护者**: 蓝山  
-**npm**: https://www.npmjs.com/package/@hddz/plugin-harness
-
-
-### v0.1.6 (2026-03-24)
-- 修正 README 安装说明（恢复手动配置 `openclaw.json` 的步骤）
-- 统一日志路径为 `workspace/logs/harness`
-
-### v0.1.5 (2026-03-24)
-- 简化安装步骤（错误的"自动"说明）
-
-### v0.1.4 (2026-03-24)
-- 添加 `openclaw.extensions` 字段到 package.json
-
----
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 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 |
 
-**最后更新**: 2026-03-24  
-**维护者**: 蓝山  
-**npm**: https://www.npmjs.com/package/@hddz/plugin-harness
 ---
 
-**最后更新**: 2026-03-24  
-**维护者**: 蓝山  
+**许可证**: MIT  
+**仓库**: https://github.com/hddz/plugin-harness  
 **npm**: https://www.npmjs.com/package/@hddz/plugin-harness
-: https://www.npmjs.com/package/@hddz/plugin-harness

package/openclaw.plugin.json

@@ -0,0 +1,39 @@
+{
+  "id": "harness",
+  "name": "Harness Engineering",
+  "description": "Constraints, feedback loops, and control systems for AI agents",
+  "version": "0.1.12",
+  "kind": "engineering",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "autoValidateConfig": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically validate openclaw.json before writes"
+      },
+      "autoAuditSkill": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically audit skills before installation"
+      },
+      "loopDetectionEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Detect and prevent infinite edit loops"
+      },
+      "protectedFiles": {
+        "type": "array",
+        "items": { "type": "string" },
+        "default": ["SOUL.md", "USER.md", "AGENTS.md", "TOOLS.md", "MEMORY.md", "openclaw.json"],
+        "description": "Files protected from deletion/modification"
+      },
+      "logsDir": {
+        "type": "string",
+        "default": "workspace/logs/harness",
+        "description": "Directory for harness operation logs"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hddz/plugin-harness",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Harness Engineering plugin for OpenClaw - constraints, feedback loops, and control systems for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -34,9 +34,13 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "openclaw.plugin.json"
   ],
   "peerDependencies": {
     "openclaw": ">=2026.3.0"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
   }
 }