diff --git a/docs/web-patches/README.md b/docs/web-patches/README.md index ebc0653..335d70e 100644 --- a/docs/web-patches/README.md +++ b/docs/web-patches/README.md @@ -29,14 +29,26 @@ dacli v0.11+ 镜像架构阶段, 当 dacli 需要复用 web 端 Vue 组件 setup ## 当前 Patches 状态 -| Patch 文件 | 对应 web 端文件 | 状态 | 备注 | -|-----------|----------------|------|------| -| `_buildformdata-formUtils.md` | `web/.../helper/formUtils.ts` | ✅ 已应用 (v0.11+ Task 4-10) | 已是纯函数, 无需 patch | -| `_ai_prompts-GEN_MODEL_QUESTION.md` | `web/.../views/onlineDev/.../AiCreateModal.vue` | ✅ 已应用 (v0.11+ Task 7-10) | prompt 抽到 `_ai_prompts.ts` | -| `_visualDev-api-shim.md` | `web/.../api/onlineDev/visualDev.ts` | ✅ 已应用 (v0.11+ Phase 1) | 通过 `webapi/visualDev.ts` 镜像 | +| Patch 文件 | 对应文件 | 状态 | 备注 | +|-----------|---------|------|------| +| `_buildformdata-formUtils.md` | `web/.../helper/formUtils.ts` | ✅ 已应用 (v0.11+ Task 4-10) | web 端零改动, dacli 用 `_loader.ts` 动态 import 镜像 | +| `_visualDev-api-shim.md` | `web/.../api/onlineDev/visualDev.ts` | ✅ 已应用 (v0.11+ Phase 1) | web 端零改动, dacli 用 `webapi/visualDev.ts` 镜像 | | `_codegen-ServiceImpMarco-virtual-field.md` | `boot/resources/.../ServiceImpMarco.vm` | ✅ 已应用 (2026-06-23) | ⚠ 特例: 后端 vm 模板, 非 web 前端源码; 虚拟字段 null 守卫 | | `_jnpf-admin-scanBasePackages-ssw.md` | `boot/jnpf-admin/.../JnpfAdminApplication.java` | ✅ 已应用 (2026-04-07) | ⚠ 特例: 主入口对 JNPF 基线定制; scanBasePackages 加 "ssw" | +> **零改动镜像 patch 的合法性**: 上面前 2 项 patch 文档记录 "web 端保持原样, dacli 通过 dynamic import 镜像"。 +> 这是 v0.11+ 镜像架构的合法使用场景 — patch 文档的"价值"在于记录 dacli 镜像哪些 web 端函数、 +> 镜像机制 (import 替换规则) + 验收方法, 让 web 升级后能验证镜像链路仍然成立。 +> 它**不**违反"web 端零改动则无需 patch"的直觉 — 它是镜像架构的**契约文档**, 不是 diff 记录。 + +## 清理日志 + +- **2026-07-02** 删除 2 个误归类 patch: + - `jxcj-dashboard-portal-report.md` — 跟踪目标 `web/.../public/ssw/jxcj/{dashboard,portal,report}/`, 命中"排除规则"第 102 行 `❌ 否` (静态扩展产物, 走 git log) + - `jxcj-official-site.md` — 跟踪目标 `web/.../public/ssw/jxcj/{index,directions,awards}.html + api.js`, 同上 +- **2026-07-02** 移除 README 表格中 stale 引用 `_ai_prompts-GEN_MODEL_QUESTION.md` (文件不存在, 早已删除未同步 README) +- 触发原因: 用户审查 web-patches 目录与 CLAUDE.md §代码修改权限 / memory `feedback-web-patch-docs` 规则的对齐情况 + ## Phase 3 候选 (未来可做) 按 docs/dacli/v0.11-mirror-refactor.md §3 Phase 3, 候选改造: