补提交上一轮 (commit64fbb4acmd-review/drift 归档 +76c2937broken ref reroute +b4dce30auto-gen 撤回) 期间未落库的 4 个文件: 1. docs/cmd-review/README.md (30 行) - 上轮归档逻辑产出物, 指向 archive/cmd-review-2026-07/, 给新会话 AI 引路 - 本应在 commit64fbb4a(cmd-review 全归档) 一并提交, 但当时遗漏 - 含归档原因 / 当前权威 (dacli <cmd> --help) / 历史快照定位指引 2. docs/audit-2026-07-22.md (192 → 196 行, 顶部加 deprecate 头) - macOS 上做的中立审计, 已知 3 条核心结论 (本机崩溃 / 硬编码路径 / B 关卡退化) 全部是环境错位误判 - 顶部加 ⚠️ 头, 指向 audit-2026-07-23-deep §更正声明 + §12 容器内实跑复核 - 仍成立部分: 硬编码 /home/ubuntu/...ccWorkDir (脆弱性), 双包管理器, wrapCommand 迁移不完整 3. docs/audit-2026-07-23-deep.md (292 行, 完整) - 深度审计 (架构层), 容器内 'docker exec jnpf-all-in-one' 复跑后更正前一版 3 条误判 - 实测: tsc --noEmit 48 错 (src 内, 违反 README §232 铁律), vitest unit 20 失败 (集中在 blindspot_guards 漂移) - 主结论修订: ssw-loop 在 intended 环境里 '能驱动开发' (int 撤回初版 '仪式化' 措辞) - 但真正结构性盲点: 整套质量体系不跑 tsc/vitest → 48 类型错 + 20 失败与全绿关卡并存 - 修订后 5 件优先事: (1) 补 tsc+vitest 进回路 (2) 修 48 src 类型错 (3) 修 blindspot 漂移 (4) 抽 getCcWorkDir() (5) 统一包管理器 4. docs/web-patches/jxcj-m2-field-fix.py (227 行) - jxcj M2 form schema 字段修正脚本 (webapi PUT fallback) - 背景: dacli form create --ai 重命名字段 + 丢失 dictType + 误判 userSelect, form update --fields 间歇报 'System abnormality' - 走 Python PUT 直接调 JNPF webapi 兜底修复 (跟 DACLI 数据建模路径平行) - 配套 web-patches/README.md 当前 Patches 状态表 (只列 .md, py 脚本独立) - 注: 该脚本不属于 jnpf/boot 基线改动, 是 dacli 之外的应用级修复脚本, 按 web-patches 规则不入归档 触发: 用户要求 '提交' untracked 3 文件, 顺手补 cmd-review/README.md 上轮遗漏. Co-Authored-By: Claude <[email protected]>
web-patches — jnpf / boot 基线改动存档
目的
jnpf / boot 基线 (jnpf/, boot/) 是平台源码 (JNPF 升级时会覆盖)。项目对基线的任何改动
必须在这里单独存档一份 patch, 升级后能 re-apply。
作用范围: 仅 jnpf / boot 基线定制 (boot/resources 模板 + boot/jnpf-admin 主入口)。
web 端前端源码 (web/.../src/** Vue/TS) 改动走 .claude/skills/dacli/ 流程, 不在本目录。
历史说明: 本目录最初也跟踪 web 端 Vue/TS 改造 (v0.11+ 之前), 当时 dacli 直接修改 web 端源码。 v0.11+ 镜像架构落地后, dacli 用 dynamic import 镜像 web 端函数 (零 web 改动), 该类 patch 已退役 — 镜像机制自有文档在
dacli/src/webapi/_loader.ts+dacli/src/commands/form/_buildformdata.ts+dacli/data/buildformdata-contract.md+dacli/docs/cmd-review/v0.13,v0.14*。
规则
- 改基线前先在本目录写
<file>.md(含"待改动清单") - 改基线后完善该文档, 含:
- 实际 diff (改前 vs 改后)
- 改动原因 (为什么项目需要这个改动)
- 验收方法 (怎么验证 patch 还在)
- 基线升级后重新读本目录所有 patch, 逐个对照, 缺失的重新应用
不写文档 = 改动 100% 会被升级覆盖丢失。
当前 Patches 状态
| Patch 文件 | 对应文件 | 状态 | 备注 |
|---|---|---|---|
_codegen-ServiceImpMarco-virtual-field.md |
boot/resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm |
✅ 已应用 (2026-06-23) | 虚拟字段 null 守卫 (searchList 不在主表时跳过) |
_jnpf-admin-scanBasePackages-ssw.md |
boot/jnpf-admin/src/main/java/jnpf/JnpfAdminApplication.java |
✅ 已应用 (2026-04-07) | scanBasePackages 加 "ssw", ssw-common bean 才能注册 |
_jnpf-bpmn-autoLayout-on-open.md |
web/packages/jnpf/plugins/jnpf-bpmn/src/components/bpmn/src/index.vue:210 |
✅ 已应用 (2026-07-02) | BPMN 编辑器打开时 autoLayout, 修复 Flowable normalize 后节点挤一起 (dacli workflow --ai P0-8 配套) |
验收 / 升级流程
每次基线升级 (JNPF 平台 release) 后:
# 1. 看 patch 清单
ls dacli/docs/web-patches/*.md
# 2. 对每个 patch:
# - 读 patch 文档的"实际 diff"
# - 对照当前基线文件: 改动还在吗?
# - 不在 → 重新应用, 跑 baseline 验证
# - 在 → 文档标 ✅
# 3. 跑 baseline 验证
SKIP_PLAYWRIGHT=1 bash /home/ubuntu/ccWorkDir/.claude/skills/dacli/examples/baseline/all.sh
不在本目录的事
- 删 web 端文件: 大概率不行 (其他模块依赖), 不在 patch 范围
- 改 web 端 bug: 不属于 dacli 范围, 应报给 JNPF 平台组
- dacli 自有模块改动: 走 git log + 源码头注释, 不在本目录 (含 v0.11+ 镜像机制)
- web/.../src/ Vue/TS 改造**: 走 .claude/skills/dacli/ 流程
排除规则 (严格执行)
| 路径模式 | 类别 | 是否写入 web-patches | 走什么流程 |
|---|---|---|---|
jnpf/.../TemplateCodeVue3/.../*.vm |
基线 Velocity 模板 | ✅ 是 (写 patch) | 本目录 + diff 验证 |
boot/jnpf-admin/.../JnpfAdminApplication.java |
基线主入口 | ✅ 是 (写 patch) | 本目录 + diff 验证 |
web/packages/jnpf/plugins/jnpf-bpmn/src/**/*.vue |
jnpf 平台 monorepo 包 (bpmn 组件) | ✅ 是 (写 patch) | 本目录 + 用户本地 build 验证 |
boot/resources/.../*.vm (非基线) |
项目自有模板 | ❌ 否 | 走 git log |
web/.../src/**/*.vue (非 jnpf-monorepo) |
前端源码 | ❌ 否 | 走 .claude/skills/dacli/ |
web/.../src/**/*.ts |
前端源码 | ❌ 否 | 走 .claude/skills/dacli/ |
web/.../public/ssw/** |
静态扩展产物 | ❌ 否 | 走 git log |
web/.../dist/ssw/** |
构建产物 | ❌ 否 | 走 git log |
boot/**/ssw*/**/*.java |
后端 Java 业务包 | ❌ 否 | 走 backend-dev 流程 |
uniapp/pages/ssw/** |
移动端 ssw 页面 | ❌ 否 | 走 uniapp 流程 |
判断原则:
- ✅ 触发: 改
jnpf/或boot/下与 JNPF 基线同路径的文件, 或改 jnpf-monorepo 包 (web/packages/jnpf/plugins/*/src/**) - ❌ 不触发: 改
boot/ssw*/**(项目自有) + 业务前端 (含 public/ssw/) + uniapp + dacli 自身 - 注:
web/packages/jnpf/plugins/*/src/**在 web 仓库是 gitignored (jnpf 团队自己 publish npm 包), 改动不能直接 commit 到 web/, 但需文档化到 web-patches 记录 baseline 改动
清理日志
- 2026-07-02 第二轮 删除 2 个镜像契约 patch (本就是 dacli 自有模块文档, 不在 web-patches 范畴):
_buildformdata-formUtils.md— 镜像机制已在dacli/src/commands/form/_buildformdata.ts头注释 +dacli/data/buildformdata-contract.md详述_visualDev-api-shim.md— 镜像机制已在dacli/src/webapi/_loader.ts头注释 +dacli/docs/cmd-review/v0.13,v0.14*详述
- 2026-07-02 第一轮 删除 2 个误归类 patch (跟踪目标 web/public/ssw/ 违规):
jxcj-dashboard-portal-report.mdjxcj-official-site.md
- 2026-07-02 移除 README 表格中 stale 引用
_ai_prompts-GEN_MODEL_QUESTION.md(文件已不存在) - 触发原因: 用户审查 web-patches 目录与 CLAUDE.md §代码修改权限 / memory
feedback-web-patch-docs规则的对齐情况, 指出镜像契约 patch 重复 dacli 源文档