Files
dacli/docs/web-patches
ssw 06aed3830c chore(v0.11+): 合并 dacli/.claude/skills/dacli-ts 到父 .claude/skills/ + Phase 3 Batch F 审计
用户拍板 (2026-06-25): 为避免重复, 把 dacli 子项目的 dacli-ts skill 移到父 .claude/skills/ 下作为实体目录 (而非原 symlink), 同时删 dacli/CLAUDE.md 和 dacli/.claude/ 目录.

变更:
1. 删除整个 dacli/.claude/ 目录 (30 个文件, 包含 settings.local.json + dacli-ts skill 全部内容)
2. 删除 dacli/CLAUDE.md (内容已并入父 CLAUDE.md)
3. 父 .claude/skills/dacli-ts 替换 symlink 为实体目录 (从 dacli/.claude/skills/dacli-ts 复制)
4. 更新 4 处文档引用 (dacli/.claude/skills/dacli-ts → .claude/skills/dacli-ts, dacli/CLAUDE.md 标注合并)
5. Phase 3 Batch F 5 个主流程 skill 审计报告 (新增 docs/skill-audit/):
   - dacli-ts.md — P0 必修 3 项 (补 30+ NEW-CMD + webapi 18 模块 + form validate deprecation)
   - ssw-h5dev-flow.md — P0 必修 5 项 (doc toc/search + form update + selector + log exception)
   - design-jnpf-execute.md — P0 必修 6 项 (删 _blindspots.ts 引用 + 补 webapi + 4 NEW-CMD)
   - form-development.md — P0 必修 3 项 (删 form msrelation 误用 + 补 form update + webapi 段)
   - form-fix.md — P0 必修 3 项 (删 dacli form fix 误用 10+ 处 + 补 form clone/update 流程)

Batch G-J 子代理审计待下一轮执行 (见 plan §12.3).

下一步: 执行 Phase 3 P0 必修 (按 audit 报告) → Phase 4 历史残留清理 → Phase 5 baseline 验证
2026-06-25 15:53:06 +08:00
..

web-patches — dacli 对 web 端的改造记录

目的

dacli v0.11+ 镜像架构阶段, 当 dacli 需要复用 web 端 Vue 组件 setup() 中的业务逻辑, 我们会修改 web/ 端源码. 但 web/ 端是平台源码 (JNPF 升级时会覆盖), 所以 每个 web 端改动必须在这里单独存档一份 patch, 升级后能 re-apply.

规则

  1. 改 web 前先在本目录写 <component>.md (含"待改动清单")
  2. 改 web 后完善该文档, 含:
    • 实际 diff (改前 vs 改后)
    • 改动原因 (为什么 dacli 需要这个改动)
    • 验收方法 (怎么验证 patch 还在)
  3. web 升级后 重新读本目录所有 patch, 逐个对照, 缺失的重新应用

不写文档 = 改动 100% 会被升级覆盖丢失.

当前 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 镜像

Phase 3 候选 (未来可做)

按 docs/dacli/v0.11-mirror-refactor.md §3 Phase 3, 候选改造:

  1. web/.../views/onlineDev/formDesign/Form.vue 抽 buildFormSubmitPayload(state)
  2. web/.../views/onlineDev/formDesign/components/CreateMenuModal.vue 抽 buildMenuMountPayload(formId, type)
  3. web/.../views/onlineDev/sysForm/Form.vue 系统表单 submit 逻辑

当前状态 (2026-06-25): 这 3 个候选都通过 Phase 1 webapi 间接覆盖 (web 端组件 仍调原端点 /visualdev/Base/{id}/Actions/Module 等, dacli 用 webapi/visualDev 调用 同样的端点). 直接抽纯函数的额外价值有限, 暂不执行.

如果未来 BS-48/49/50 等盲点反复修, 再考虑 Phase 3 真正执行.

验收 / 升级流程

每次 web 升级 (JNPF 平台 release) 后:

# 1. 看 patch 清单
ls dacli/docs/web-patches/*.md

# 2. 对每个 patch:
#    - 读 patch 文档的"实际 diff"
#    - 对照当前 web/ 端文件: 改动还在吗?
#    - 不在 → 重新应用, 跑 baseline 验证
#    - 在 → 文档标 ✅

# 3. 跑 baseline 验证
SKIP_PLAYWRIGHT=1 bash /home/ubuntu/ccWorkDir/.claude/skills/dacli-ts/examples/baseline/all.sh

不在本目录的事

  • 删 web 端文件: 大概率不行 (其他模块依赖), 不在 patch 范围
  • 改 web 端 bug: 不属于 dacli 范围, 应报给 JNPF 平台组
  • dacli 自有模块改动: 走 git log, 不在本目录