revert: 恢复误删文件（回退 81f500160）

2026-06-12 16:00:06 +08:00
parent cec2f47a1f
commit a45b6e7955
925 changed files with 44427 additions and 455 deletions
--- a/.harness/PROGRESS.md
+++ b/.harness/PROGRESS.md
@@ -0,0 +1,39 @@
+# 进度日志
+
+## 当前已验证状态
+
+- 仓库根目录：`/root/.openclaw/workspace/his-repo`
+- 分支：`develop`
+- 标准启动路径：`cd healthlink-his-server && mvn compile -pl healthlink-his-application -am`
+- 标准验证路径：`bash .harness/check.sh`（一键全部门禁）
+- 标准初始化：`bash .harness/init.sh`
+- 标准作业流程：`.harness/STANDARD_OPERATING_PROCEDURE.md`
+- 当前最高优先级未完成功能：`harness-003` — 持续完善 check.sh
+- 当前 blocker：无
+
+## 会话记录
+
+### Session 001 (2026-05-28) — 基础设施 v1
+- 已完成：AGENTS.md 重构、5 技能创建、通用模板、插件安装
+
+### Session 002 (2026-05-28) — WalkingLabs 整合
+- 已完成：walkinglabs-harness 技能、.harness/ 模板、AGENTS.md v2、check.sh
+
+### Session 003 (2026-05-28) ← 当前
+- 目标：用 Harness 方法论验证 Bug #597 + 定义标准化开发流程
+- 已完成：
+  - Bug #597 全链路 6 环验证通过（所有环节 ✅）
+  - 创建 .harness/STANDARD_OPERATING_PROCEDURE.md（196 行）
+  - 格式化的 Harness 工作循环：Init→Plan→Implement→Verify→Cleanup→Review
+- 运行过的验证：mvn compile ✅ | check.sh 7/7 ✅ | 全链路 6/6 ✅
+- 提交记录：
+- 已知风险或未解决问题：
+- 下一步最佳动作：无 — 所有基础设施已完成
+
+## 当前功能状态
+
+| ID | 功能 | 状态 |
+|---|---|---|
+| harness-001 | 基础设施 v1（24 篇博客） | done ✅ |
+| harness-002 | WalkingLabs 实战模式整合 | done ✅ |
+| harness-003 | 质量门禁自动化检查脚本 | in_progress 🔄 |
--- a/.harness/STANDARD_OPERATING_PROCEDURE.md
+++ b/.harness/STANDARD_OPERATING_PROCEDURE.md
@@ -0,0 +1,196 @@
+# Harness 标准作业程序 (SOP)
+
+> 所有开发任务、Bug 修复、重构，必须遵循此流程。
+
+## 流程全景
+
+```
+Init → Plan → Implement → Verify → Cleanup → Review
+ │        │        │           │         │         │
+ └─ 环境  └─ 全链路 └─ 约束内   └─ 门禁    └─ 状态   └─ 评分
+    就绪    分析     修改        检查       更新     评审
+```
+
+---
+
+## 步骤详解
+
+### Step 1: Init — 环境就绪
+
+```bash
+# 1. 确认在正确的目录
+pwd
+
+# 2. 运行初始化
+bash .harness/init.sh
+
+# 3. 读取当前进度
+cat .harness/PROGRESS.md
+cat .harness/feature_list.json
+
+# 4. 查看最近变更
+git log --oneline -5
+git status --short
+```
+
+**检查项：**
+- [ ] 编译通过 (`mvn compile`)
+- [ ] 了解当前进行中的功能
+- [ ] 了解最近提交
+
+---
+
+### Step 2: Plan — 全链路分析
+
+**对于每个字段/功能的新增或修改，先画出完整数据流：**
+
+```
+录入 → 保存 → 查询 → 修改 → 删除 → 关联
+ │       │      │      │      │      │
+ └前端    └API   └Mapper └回显   └软删除 └上下游
+          └Ctrl  └DTO    └再保存         └计费
+          └Svc   └前端                     └打印
+          └Entity                          └报表
+          └DB
+```
+
+**检查清单（6 环）：**
+1. **录入** — 前端有输入入口？（弹窗、行编辑、表单）
+2. **保存** — 前端→API→Controller→Service→Entity→DB，每个入口都传了吗？（注意多个 Service 实现类）
+3. **查询** — DB→Mapper XML（UNION ALL 子查询统一加）→DTO→前端展示
+4. **修改** — 编辑回显→修改保存→正确更新？
+5. **删除/停止** — 状态变更会丢失该字段吗？
+6. **关联** — 上下游（护士站、药房、计费、打印、报表）需要同步改吗？
+
+**输出：** `update_plan` 分解步骤 + 风险评估
+
+---
+
+### Step 3: Implement — 约束内修改
+
+**约束铁律：**
+- 一次只做一个功能（`single_active_feature = true`）
+- 只动必要文件，禁止"顺便改进"无关代码
+- 遵循 AGENTS.md 中的代码风格规范
+- 涉及 Mapper XML 时，UNION ALL 所有子查询统一修改
+
+**修改原则：**
+- 安全 > 架构 > 质量 > 性能
+- 增量修改，每步可回滚
+- 每个检查点保存进度（`update_plan`）
+
+---
+
+### Step 4: Verify — 门禁检查
+
+```bash
+# L1: 编译检查
+cd healthlink-his-server && mvn compile -pl healthlink-his-application -am
+
+# L2: 全链路门禁
+bash .harness/check.sh
+
+# L3: 人工审查（输出变更摘要）
+```
+
+**输出变更摘要：**
+```
+修改文件: N 个
+新增行数: N
+删除行数: N
+影响模块: [模块列表]
+风险等级: 低/中/高
+变更摘要: [一句话描述做了什么]
+```
+
+---
+
+### Step 5: Cleanup — 状态更新
+
+```bash
+# 1. 更新进度
+vim .harness/PROGRESS.md
+# 添加新会话记录，更新完成状态
+
+# 2. 更新功能清单
+vim .harness/feature_list.json
+# 标记完成/更新状态
+
+# 3. 运行干净状态检查
+cat .harness/clean-state-checklist.md
+# 逐项确认
+
+# 4. 提交
+git add -A
+git commit -m "type(scope): description"
+git push origin develop
+```
+
+**提交信息格式：**
+```
+<type>(<scope>): <description>
+
+type: feat | fix | refactor | docs | test | chore
+scope: 模块名（如 mapper, service, harness）
+```
+
+---
+
+### Step 6: Review — 评审评分
+
+对照 `.harness/evaluator-rubric.md` 逐项评分：
+
+| 维度 | 满分 | 自评 |
+|---|---|---|
+| 正确性 | 2 | 行为是否符合目标 |
+| 验证 | 2 | 门禁是否全部通过 |
+| 范围纪律 | 2 | 是否超出任务边界 |
+| 可靠性 | 2 | 能否重复执行 |
+| 可维护性 | 2 | 代码是否规范 |
+| 交接准备度 | 2 | 下一轮能否继续 |
+
+**结论：** Accept / Revise / Block
+
+---
+
+## 异常处理
+
+### 编译失败
+```
+失败 → 分析错误 → git restore 撤销 → 从检查点重试
+持续失败（3次） → 上报人类
+```
+
+### 全链路不完整
+```
+发现缺环 → 记录到 PROGRESS.md blocker → 补充修复
+```
+
+### 范围蔓延
+```
+发现超出任务 → 创建新 feature → 当前任务先完成
+```
+
+---
+
+## 速查命令
+
+```bash
+# 诊断
+pwd                           # 确认目录
+git status --short            # 查看变更
+git log --oneline -5          # 查看历史
+git diff --stat HEAD          # 变更统计
+
+# 回滚
+git checkout -- <file>        # 撤销单个文件
+git reset HEAD~1              # 撤销上次提交（保留修改）
+
+# 验证
+bash .harness/init.sh         # 初始化
+bash .harness/check.sh        # 全部门禁
+
+# 状态
+cat .harness/PROGRESS.md      # 进度
+cat .harness/feature_list.json # 功能清单
+```
--- a/.harness/check.sh
+++ b/.harness/check.sh
@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# =============================================
+# Harness Quality Gates — 一键运行所有门禁
+# 源自 $closed-loop-testing skill
+# =============================================
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+PASS=0
+FAIL=0
+RESULTS=()
+
+check() {
+    local level="$1" name="$2" cmd="$3"
+    cd "$ROOT_DIR"
+    echo ""
+    echo "━━━ [${level}] ${name} ━━━"
+    if eval "$cmd" 2>&1; then
+        echo "  ✅ ${name} 通过"
+        PASS=$((PASS + 1))
+        RESULTS+=("✅|${level}|${name}")
+    else
+        echo "  ❌ ${name} 失败"
+        FAIL=$((FAIL + 1))
+        RESULTS+=("❌|${level}|${name}")
+    fi
+}
+
+echo ""
+echo "╔══════════════════════════════════════╗"
+echo "║   Harness Quality Gates              ║"
+echo "║   $(date '+%Y-%m-%d %H:%M')              ║"
+echo "╚══════════════════════════════════════╝"
+
+# ── L1: 编译检查 ──
+echo ""
+echo "╔══ L1 编译检查 ══════════════════════╗"
+check "L1" "后端编译" "cd '$ROOT_DIR/healthlink-his-server' && mvn compile -pl healthlink-his-application -am -q"
+
+# ── L2: 全链路检查 ──
+echo ""
+echo "╔══ L2 全链路数据流验证 ══════════════╗"
+
+# L2-1: 文件存在性检查
+check "L2" "AGENTS.md 存在" "test -f '$ROOT_DIR/AGENTS.md'"
+check "L2" "init.sh 可执行" "test -x '$ROOT_DIR/.harness/init.sh'"
+check "L2" "PROGRESS.md 存在" "test -f '$ROOT_DIR/.harness/PROGRESS.md'"
+check "L2" "feature_list.json 有效" "python3 -c 'import json; json.load(open(\"$ROOT_DIR/.harness/feature_list.json\"))'"
+
+# L2-2: Mapper XML 结构检查
+check "L2" "Mapper XML 行数一致性" "find '$ROOT_DIR/healthlink-his-server' -path '*/mapper/*.xml' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print \$1}' | xargs test 0 -lt"
+
+# ── L3: 约束合规检查 ──
+echo ""
+echo "╔══ L3 约束合规检查 ══════════════════╗"
+
+# L3-1: 无硬编码密钥
+check "L3" "无硬编码密钥" "! grep -r 'password=.*[a-zA-Z0-9]\{8,\}' --include='*.java' --include='*.yml' --include='*.xml' --include='*.py' '$ROOT_DIR' 2>/dev/null | grep -v 'test\|example\|sample\|template\|localhost\|jchl' | head -5 | grep . && false || true"
+
+# ── 汇总 ──
+echo ""
+echo "╔══════════════════════════════════════╗"
+echo "║   质量门禁结果汇总                    ║"
+echo "╚══════════════════════════════════════╝"
+echo ""
+for r in "${RESULTS[@]}"; do
+    IFS='|' read -r status level name <<< "$r"
+    echo "  $status [$level] $name"
+done
+echo ""
+echo "  总计: $((PASS + FAIL)) | ✅ $PASS 通过 | ❌ $FAIL 失败"
+echo ""
+
+if [ "$FAIL" -gt 0 ]; then
+    echo "  ⚠️  有 $FAIL 项未通过"
+    echo "  提示：新增/修改文件后记得 git add 后再检查"
+    exit 1
+else
+    echo "  🎉 所有门禁通过！"
+fi
--- a/.harness/clean-state-checklist.md
+++ b/.harness/clean-state-checklist.md
@@ -0,0 +1,13 @@
+# 干净状态检查清单
+
+会话结束前逐项检查：
+
+- [ ] 标准启动路径仍然可用（mvn compile 通过）
+- [ ] 标准验证路径仍然可运行
+- [ ] 当前进度已记录到 PROGRESS.md
+- [ ] 功能状态真实反映 passing 和未验证的边界
+- [ ] feature_list.json 已更新
+- [ ] 没有任何半成品步骤处于未记录状态
+- [ ] 临时文件和调试代码已清理
+- [ ] 提交信息清晰描述了变更内容
+- [ ] 下一轮会话无需人工修复即可继续
--- a/.harness/evaluator-rubric.md
+++ b/.harness/evaluator-rubric.md
@@ -0,0 +1,22 @@
+# 评审评分表
+
+| 维度 | 问题 | 0-2分 | 备注 |
+|---|---|---|---|
+| 正确性 | 实现的行为是否符合目标功能？ | | |
+| 验证 | 编译检查是否通过？数据流是否完整？ | | |
+| 范围纪律 | 是否保持在选定功能范围内？ | | |
+| 可靠性 | 结果能否在重启后继续工作？ | | |
+| 可维护性 | 代码是否遵循项目规范？ | | |
+| 交接准备度 | 下一轮能否只靠仓库内文件继续推进？ | | |
+
+## 结论
+
+- [ ] Accept
+- [ ] Revise
+- [ ] Block
+
+## 后续动作
+
+- 缺失的证据：
+- 必须补的修复：
+- 下次复审触发条件：
--- a/.harness/feature_list.json
+++ b/.harness/feature_list.json
@@ -0,0 +1,72 @@
+{
+  "project": "HealthLink-HIS",
+  "last_updated": "2026-05-28",
+  "rules": {
+    "single_active_feature": true,
+    "passing_requires_evidence": true,
+    "do_not_skip_verification": true
+  },
+  "status_legend": {
+    "not_started": "功能还没开始做",
+    "in_progress": "当前唯一正在进行的任务",
+    "blocked": "有已记录的阻塞问题",
+    "passing": "验证已通过，证据已记录",
+    "done": "已完成并合入主干"
+  },
+  "features": [
+    {
+      "id": "harness-001",
+      "priority": 1,
+      "area": "infrastructure",
+      "title": "Harness Engineering 基础设施搭建",
+      "user_visible_behavior": "Codex 具备完整的约束/反馈/控制/持久执行能力",
+      "status": "done",
+      "verification": [
+        "AGENTS.md 包含四大核心组件",
+        "5 个技能安装到 Codex 环境",
+        "harness-engineering 插件注册到 marketplace",
+        "通用 AGENTS.md 模板可用"
+      ],
+      "evidence": ["AGENTS.md restructured", "skills created", "plugin validated"],
+      "notes": "v1: 24 篇博客方法整合完成"
+    },
+    {
+      "id": "harness-002",
+      "priority": 2,
+      "area": "infrastructure",
+      "title": "WalkingLabs 实战模式整合",
+      "user_visible_behavior": "项目具备完整的 5 子系统 Harness（指令/工具/环境/状态/反馈）",
+      "status": "done",
+      "verification": [
+        ".harness/ 目录包含所有模板文件",
+        "init.sh 可正常运行",
+        "PROGRESS.md 记录当前状态",
+        "feature_list.json 跟踪所有功能",
+        "walkinglabs-harness 技能已安装"
+      ],
+      "evidence": [
+        "init.sh verified (compile OK)",
+        "6 templates installed in .harness/",
+        "AGENTS.md updated with 5-subsystem model",
+        "walkinglabs-harness skill created (142 lines)"
+      ],
+      "notes": "v2: walkinglabs 5 子系统整合完成"
+    },
+    {
+      "id": "harness-003",
+      "priority": 3,
+      "area": "infrastructure",
+      "title": "建立质量门禁自动化检查脚本",
+      "user_visible_behavior": "运行一条命令即可完成 L1-L3 质量门禁检查",
+      "status": "not_started",
+      "verification": [
+        "创建 .harness/check.sh — 一键运行所有门禁",
+        "L1: mvn compile 编译检查",
+        "L2: Mapper XML 全链路字段一致性检查",
+        "L3: 生成变更摘要供人工审查"
+      ],
+      "evidence": [],
+      "notes": ""
+    }
+  ]
+}
--- a/.harness/init.sh
+++ b/.harness/init.sh
@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Harness Init — 统一启动与验证入口
+# 每次新会话开始前运行
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+echo "==> 当前目录: $PWD"
+echo "==> Git 状态"
+git status --short 2>/dev/null || true
+git log --oneline -3 2>/dev/null || true
+
+echo ""
+echo "==> 编译检查"
+cd healthlink-his-server
+mvn compile -pl healthlink-his-application -am -q 2>/dev/null && echo "    ✅ 编译通过" || echo "    ❌ 编译失败"
+
+echo ""
+echo "==> 读取进度"
+if [ -f .harness/PROGRESS.md ]; then
+    head -20 .harness/PROGRESS.md
+else
+    echo "    (无进度文件)"
+fi
+
+echo ""
+echo "==> 读取功能清单"
+if [ -f .harness/feature_list.json ]; then
+    python3 -c "
+import json
+with open('.harness/feature_list.json') as f:
+    data = json.load(f)
+features = [f for f in data.get('features', []) if f.get('status') == 'in_progress']
+if features:
+    print(f\"    当前进行中: {features[0].get('title', 'unknown')}\")
+else:
+    print('    当前无进行中的功能')
+" 2>/dev/null || echo "    (无法解析)"
+fi
+
+echo ""
+echo "==> 环境就绪 ✅"
--- a/.harness/session-handoff.md
+++ b/.harness/session-handoff.md
@@ -0,0 +1,29 @@
+# 会话交接
+
+## 当前已验证
+
+- 现在明确可用的部分：
+- 本轮实际跑过的验证：
+
+## 本轮改动
+
+- 新增了哪些代码或行为：
+- Harness 发生了哪些变化：
+
+## 仍损坏或未验证
+
+- 已知缺陷：
+- 未验证路径：
+- 下一轮需要注意的风险：
+
+## 下一步最佳动作
+
+- 最高优先级未完成功能：
+- 为什么它是下一步：
+- 什么结果才算 passing：
+
+## 命令速查
+
+- 编译：`cd healthlink-his-server && mvn compile -pl healthlink-his-application -am`
+- 打包：`mvn clean package -DskipTests`
+- 启动：`mvn spring-boot:run`