From 3d9ddfad00f4cacaa9e6e7cc58632021d1cc58e4 Mon Sep 17 00:00:00 2001
From: zhi <zhi@dev.hangman-lab.top>
Date: Sat, 21 Mar 2026 19:52:09 +0000
Subject: [PATCH] docs: sync harbor-forge plugin planning notes

---
 DEVELOPMENT_PLAN.md            | 16 +++++++++----
 HarborForge.Backend            |  2 +-
 plans/hf-cross-project-todo.md | 44 +++++++++++++++++-----------------
 3 files changed, 34 insertions(+), 28 deletions(-)

diff --git a/DEVELOPMENT_PLAN.md b/DEVELOPMENT_PLAN.md
index baa9b13..81ecff9 100644
--- a/DEVELOPMENT_PLAN.md
+++ b/DEVELOPMENT_PLAN.md
@@ -279,7 +279,7 @@ POST /monitor/server/heartbeat-v2
   Body:
     identifier: string
     openclaw_version: string        # 远程主机上的 OpenClaw 版本
-    plugin_version: string          # harborforge-monitor 插件版本
+    plugin_version: string          # harbor-forge 插件版本
     cpu_pct: float
     mem_pct: float
     disk_pct: float
@@ -602,16 +602,22 @@ services:
 ### 9.2 监控插件部署
 
 ```bash
-# 1. 在 Monitor 注册服务器，获取 challenge_uuid
+# 1. 在 Monitor 注册服务器并生成 API Key
 # 2. 在服务器安装插件
 node scripts/install.mjs
 
 # 3. 配置 ~/.openclaw/openclaw.json
 {
   "plugins": {
-    "harborforge-monitor": {
-      "enabled": true,
-      "challengeUuid": "YOUR_CHALLENGE_UUID"
+    "entries": {
+      "harbor-forge": {
+        "enabled": true,
+        "config": {
+          "enabled": true,
+          "apiKey": "YOUR_API_KEY",
+          "monitor_port": 9100
+        }
+      }
     }
   }
 }
diff --git a/HarborForge.Backend b/HarborForge.Backend
index 8691128..f45f595 160000
--- a/HarborForge.Backend
+++ b/HarborForge.Backend
@@ -1 +1 @@
-Subproject commit 86911286c08cc053ee5e52fa5520f16cf7fac481
+Subproject commit f45f5957f4291cb6ed2a6f015064a78e61157086
diff --git a/plans/hf-cross-project-todo.md b/plans/hf-cross-project-todo.md
index 3787d18..dda69c7 100644
--- a/plans/hf-cross-project-todo.md
+++ b/plans/hf-cross-project-todo.md
@@ -278,15 +278,15 @@
 ## 4. HarborForge.OpenclawPlugin
 
 ### 4.1 Plugin identity and packaging
-- [ ] Rename plugin registration name to `harbor-forge`
-- [ ] Audit all docs/config/install references to old plugin name
-- [ ] Ensure plugin config keys and examples reflect the new registration name
+- [x] Rename plugin registration name to `harbor-forge`
+- [x] Audit all docs/config/install references to old plugin name
+- [x] Ensure plugin config keys and examples reflect the new registration name
 
 ### 4.2 Remove sidecar architecture
-- [ ] Remove plugin-side `server/` telemetry sidecar
-- [ ] Remove sidecar startup/shutdown lifecycle logic
-- [ ] Remove sidecar-specific docs and examples
-- [ ] Replace old OpenClaw telemetry flow with direct plugin-exposed data path
+- [x] Remove plugin-side `server/` telemetry sidecar
+- [x] Remove sidecar startup/shutdown lifecycle logic
+- [x] Remove sidecar-specific docs and examples
+- [x] Replace old OpenClaw telemetry flow with direct plugin-exposed data path
 
 ### 4.3 Plugin config updates
 - [x] Add `monitor_port` to plugin config schema
@@ -294,23 +294,23 @@
 - [x] Ensure runtime reads and validates `monitor_port`
 
 ### 4.4 CLI install support
-- [ ] Add install script flag `--install-cli`
-- [ ] Resolve OpenClaw profile bin directory (default `~/.openclaw/bin`)
-- [ ] Build `HarborForge.Cli`
-- [ ] Install compiled `hf` binary to profile `bin/`
-- [ ] `chmod +x` installed binary
-- [ ] Handle failure cases cleanly if CLI build/install fails
+- [x] Add install script flag `--install-cli`
+- [x] Resolve OpenClaw profile bin directory (default `~/.openclaw/bin`)
+- [x] Build `HarborForge.Cli`
+- [x] Install compiled `hf` binary to profile `bin/`
+- [x] `chmod +x` installed binary
+- [x] Handle failure cases cleanly if CLI build/install fails
 
 ### 4.5 Skills deployment
-- [ ] Add plugin `skills/` directory
-- [ ] Add `skills/hf/`
-- [ ] Add `skills/hf/SKILL.md`
-- [ ] In `SKILL.md`, explain basic `hf` usage
-- [ ] In `SKILL.md`, encourage agents to use `hf --help-brief`
-- [ ] In `SKILL.md`, point to normal `--help` for full command tree
-- [ ] Installer should copy normal plugin skills into profile `skills/`
-- [ ] Installer should **not** copy `skills/hf/` unless `--install-cli` is present
-- [ ] Installer should copy `skills/hf/` when `--install-cli` is present
+- [x] Add plugin `skills/` directory
+- [x] Add `skills/hf/`
+- [x] Add `skills/hf/SKILL.md`
+- [x] In `SKILL.md`, explain basic `hf` usage
+- [x] In `SKILL.md`, encourage agents to use `hf --help-brief`
+- [x] In `SKILL.md`, point to normal `--help` for full command tree
+- [x] Installer should copy normal plugin skills into profile `skills/`
+- [x] Installer should **not** copy `skills/hf/` unless `--install-cli` is present
+- [x] Installer should copy `skills/hf/` when `--install-cli` is present
 
 ### 4.6 Monitor bridge endpoint
 - [ ] Define how plugin exposes OpenClaw metadata to Monitor over local port