adspecs 0.1.39 → 0.1.41

package/references/vue3-front-standard/page-template-index.md

@@ -0,0 +1,374 @@
+# 页面模板索引
+
+本文件是页面生成的唯一模板入口。模板均从丰富参考工程中提炼为“模式”，只描述可迁移结构、组件组合和生成要点；不要在生成代码或规则中引用参考工程的绝对路径。
+
+## 使用原则
+
+- 生成页面前先在本文件选择模板模式，再按 `page-development-rules.md` 落到目标工程路径。
+- 目标工程页面通常放在 `src/views/<menuUrl>/index.vue`，由后台菜单动态加载。
+- API 放在 `src/api/<module>/<page>/index.ts`，语言包放在 `src/lang/modules/<module>/`。
+- 不直接复制旧页面，不迁移参考工程的接口前缀、业务编码、绝对路径和专属本地组件。
+- 目标工程没有的依赖或组件必须替换为已有组件，或先明确补依赖。
+
+## 1. 查询栏 + 高级表格 + 弹窗表单
+
+适用场景：普通 CRUD 列表、配置列表、调度任务、消息模板、基础资料维护。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+├── searchConfig.ts
+├── gridConfig.ts
+└── components/
+    ├── AddForm.vue
+    ├── EditForm.vue
+    └── DetailDrawer.vue
+```
+
+生成要点：
+
+- 顶部使用 `GsSearchBar`，查询项放在 `searchConfig`。
+- 主表使用 `GsCustomizeTable`，列配置放在 `gridConfig`。
+- 外部查询更新 `queryParams.params.params` 后调用 `tableRef.value?.outSearch(false)`。
+- 新增、编辑、调试、详情等动作放入独立弹窗/抽屉组件。
+- 操作列使用 `slotArr: ['action']`，批量按钮放在 `#btn`。
+
+## 2. 单表 CRUD + 导入导出
+
+适用场景：字典类型、消息模板、系统参数、基础资料维护、带批量导入导出的业务列表。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+├── gridConfig.ts
+└── components/
+    ├── AddDialog.vue
+    ├── EditDialog.vue
+    └── BatchUpload.vue
+```
+
+生成要点：
+
+- 表格开启 `selectable`、`rowKey`、唯一 `localstorageName`。
+- 工具栏包含新增、导入、导出；导出以选中行 ID 组装请求。
+- 导入成功后刷新表格。
+- 复杂字段用字段插槽渲染，普通字典字段优先使用 `dictCode`。
+- 保存、删除、导入、导出都要有 loading 或禁用态防重复点击。
+
+## 3. 左树右详情 Tab
+
+适用场景：菜单管理、组织机构、分类目录、资源配置、主从层级维护。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── TreePanel.vue
+    ├── BasicInfoTab.vue
+    ├── ResourceTab.vue
+    └── PermissionTab.vue
+```
+
+生成要点：
+
+- 左侧固定宽度树，包含系统筛选、关键字过滤、新增按钮。
+- 右侧根据当前节点显示 `el-tabs`，每个 Tab 独立组件。
+- 当前节点通过 props 下发，子组件通过事件通知父组件刷新树。
+- Tab 是否显示由按钮权限、节点类型和租户/所有者条件共同决定。
+- 保留 `currentNode`、`defaultExpandedKeys`、`filterText`、`loading` 等状态。
+
+## 4. 左列表右内联编辑
+
+适用场景：模板中心、导入导出模板、打印模板、文档模板、需要边选边编辑的配置中心。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── TemplateListPanel.vue
+    ├── TemplateSearchBar.vue
+    ├── InlineEditor.vue
+    └── UseHistoryDialog.vue
+```
+
+生成要点：
+
+- 左侧为可分页模板列表，右侧为详情/编辑区。
+- `selectedItem` 控制右侧显示，`isEditing` 控制只读/编辑态。
+- 顶部工具栏在查看态显示编辑/删除，在编辑态显示保存/取消。
+- 右侧编辑区可用 `el-scrollbar` 包裹，避免页面整体滚动。
+- 新增时构造临时选中项，保存成功后刷新左侧列表并选中最新项。
+
+## 5. 权限控制多 Tab 中心
+
+适用场景：权限中心、配置中心、模板中心、模块化后台页面。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── tabs/
+    ├── FirstTab.vue
+    ├── SecondTab.vue
+    └── ThirdTab.vue
+```
+
+生成要点：
+
+- 父组件只负责 Tab 容器、权限判断和公共数据加载。
+- `authTabs` 由 `isHaveBtnAuth(code)` 过滤生成，默认激活第一个可见 Tab。
+- 公共数据通过 `provide` 下发给 Tab 子组件。
+- 每个 Tab 自己负责列表、表单、弹窗和 API。
+- 对首次切换才需要初始化的 Tab，在 `tab-change` 中调用子组件方法。
+
+## 6. 动态组件配置中心
+
+适用场景：系统配置中心、按权限展示多个配置模块、每个配置模块相互独立的页面。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── ConfigA.vue
+    ├── ConfigB.vue
+    └── ConfigC.vue
+```
+
+生成要点：
+
+- `tabList` 由权限和运行配置计算得到。
+- 使用 `<component :is="item.key" />` 渲染配置组件。
+- 无可见 Tab 时展示 `el-empty`。
+- 适合每个配置模块彼此独立、只共享少量全局配置的场景。
+
+## 7. 分段抽屉表单
+
+适用场景：任务配置、消息渠道、第三方接入、复杂基础资料。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/components/
+└── FormDrawer.vue
+```
+
+生成要点：
+
+- 使用抽屉或弹窗承载大表单，表单内用分段标题分组。
+- 每段用 `el-divider` 或统一分段标题组件。
+- 字段按 12/24 栅格组织，复杂字段条件显示。
+- 保存按钮带 `saveLoading`，保存成功后关闭并 emit `refresh`。
+- 复杂子选择器、Cron、代码编辑器等放入二级弹窗组件。
+
+## 8. 调度任务与 Cron 配置
+
+适用场景：定时任务、计划任务、推送任务、需要启动/停止/执行一次的任务管理。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+├── gridConfig.ts
+├── searchConfig.ts
+└── components/
+    ├── TaskForm.vue
+    ├── TriggerDialog.vue
+    └── CodeEditorDialog.vue
+```
+
+生成要点：
+
+- 列表操作列包含编辑、复制、删除、执行一次、查看日志、启动/停止。
+- 表单按“基础配置 / 调度配置 / 执行配置 / 高级配置”分段。
+- Cron 字段使用只读输入框触发 Cron 弹窗。
+- `scheduleType` 改变时联动清空或校验 `scheduleConf`。
+- 启停、执行一次等动作需要二次确认或 loading。
+
+## 9. 日志列表 + 详情抽屉 + 分析面板
+
+适用场景：接口日志、登录日志、审计日志、用户行为日志、调用统计。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+├── config/
+│   └── gridConfig.ts
+└── components/
+    ├── ParamsDrawer.vue
+    ├── LinkDrawer.vue
+    └── DataViewDrawer.vue
+```
+
+生成要点：
+
+- 列表 Tab 使用 `GsCustomizeTable`，可自定义 `#pager` 加首页/末页按钮。
+- 查询条件可放在 `#btn-r` 或独立筛选栏。
+- 大字段如 request/response/exception 只显示“详情”按钮，点击打开抽屉。
+- 分析 Tab 展示统计卡片、趋势图、Top 列表。
+- 图表依赖不存在时，先降级为统计卡片 + 表格，不要强行引入新依赖。
+
+## 10. 开放 API 列表 + 编辑页切换
+
+适用场景：接口管理、API 编排、服务接口定义、请求/响应参数维护。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── ParamTable.vue
+    ├── DebugDialog.vue
+    └── ApiImportDialog.vue
+```
+
+生成要点：
+
+- 页面用 `isEditing` / `mode` 在列表区和编辑区之间切换。
+- 列表区使用表格，支持增量/全量导入、导出、调试。
+- 编辑区包含基础表单 + 请求参数表 + 响应参数表。
+- 返回列表时刷新数据并重置表单。
+- 参数表作为子组件维护增删改，父组件保存时统一组装 payload。
+
+## 11. 权限矩阵 / 授权选择器
+
+适用场景：字段权限、数据权限、接口权限、人员授权、组织授权。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── OrgTreePanel.vue
+    ├── PermissionListPanel.vue
+    ├── GrantDialog.vue
+    └── ConditionTable.vue
+```
+
+生成要点：
+
+- 左侧组织/角色/用户树，右侧权限列表或矩阵。
+- 权限数据通常需要系统、菜单、角色、组织等固定参数。
+- 授权弹窗要支持已选回显和确认后局部刷新。
+- 条件配置可用表格维护，复杂表达式再引入编辑器。
+
+## 12. 规则设计 / 多模式编辑器
+
+适用场景：规则引擎、表达式配置、低代码规则编排、条件动作设计。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    ├── VisualDesigner.vue
+    ├── ExpressionEditor.vue
+    ├── CodeEditor.vue
+    └── ExecutionDrawer.vue
+```
+
+生成要点：
+
+- 根据路由 query 或页面状态选择设计模式。
+- 父组件统一加载规则对象、保存、执行。
+- 视觉设计、表达式、代码编辑拆成互斥子组件。
+- 执行前先保存或校验当前编辑内容。
+- 若目标工程缺少编辑器依赖，先生成普通文本域或只读 JSON 预览，不直接引用外部编辑器组件。
+
+## 13. 基础资料表单
+
+适用场景：个人信息、密码修改、简单基础资料、只读/编辑切换的小表单。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    └── BasicForm.vue
+```
+
+生成要点：
+
+- 使用 `el-form` + `el-row` + `el-col`。
+- 简单页面可以直接在 `index.vue` 放表单；字段超过一屏时拆 `BasicForm.vue`。
+- 头像、附件、图片类字段优先使用目标工程已有上传组件。
+- 保存前校验表单，保存成功后提示并按需刷新用户信息或返回列表。
+- 密码类表单必须包含确认字段校验和 loading 防重复提交。
+
+## 14. 流程表单包装页
+
+适用场景：流程引擎嵌入业务表单、审批页内保存草稿、发起流程。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/
+├── index.vue
+└── components/
+    └── BusinessForm.vue
+```
+
+生成要点：
+
+- 包装页接收 `isSubmit`、`editStatus`、`bpm_businessKey`、`taskServiceParams`、`curTaskName`。
+- 业务表单实现 `get_process_variables()` 和 `ap_save()`。
+- `editStatus` 和路由参数共同决定字段是否可编辑。
+- 保存草稿返回 Promise，供流程引擎调用。
+- 流程标识、系统类型、租户字段不要硬编码，优先从配置或 props 传入。
+
+## 15. 动态表单入口
+
+适用场景：后台表单设计器配置出的动态表单页面。
+
+推荐结构：
+
+```text
+src/views/<module>/<page>/index.vue
+```
+
+生成要点：
+
+- 使用 `FormRender` 前确认 `@gushen/gushen-form-render` 插件是否已注册。
+- 动态表单页面通常不写业务字段，只负责挂载渲染器和同步路由标题。
+- 如果菜单参数已经声明动态表单，优先走 `permission.ts` 的动态表单路由处理，不新建手写 CRUD。
+
+## API 模板模式
+
+新增 API 时按业务复杂度选择：
+
+- 标准 CRUD：`findPagination`、`save`、`update`、`getById`、`delete`。
+- 导入导出：列表查询、模板下载、导入上传、导出下载、历史记录。
+- 树结构：树查询、节点新增、节点更新、节点删除、拖拽排序。
+- 授权类：主体查询、权限查询、授权保存、授权删除、回显详情。
+- 日志类：分页查询、详情查询、统计总数、趋势、TopN。
+
+API 生成约束：
+
+- 不复用参考工程接口前缀；先参考目标工程同模块 API 风格。
+- POST 保存/更新通常使用 `{ params }` 包装。
+- 文件下载使用 Blob 时要释放 URL。
+- 用户可见错误和成功提示走 i18n。
+
+## 不建议直接迁移的模式
+
+- 依赖专有设计器、Monaco、打印设计器、复杂工作流 SDK 的页面：目标工程未必具备依赖，应先确认包和注册方式。
+- 深度绑定平台权限模型、租户模型、接口导入协议的页面：只迁移结构，不迁移字段和接口。
+- 大量 Options API mixin 的旧页面：新页面优先用 `script setup` 重写结构。
+- 使用参考工程专属本地组件的页面：必须替换为目标工程已有组件或先补组件。

package/references/vue3-front-standard/project-overview.md

@@ -0,0 +1,48 @@
+# 项目结构与入口规则
+
+## 技术栈
+
+- Vue 3 + TypeScript + Vite。
+- Element Plus 全量注册，Element Plus 图标在 `src/core/initMain.ts` 中全局注册。
+- `@gushen/gushen-common-components` 通过 `instance.use(GsComponents)` 全局注册，并引入组件库 CSS。
+- `@gushen/gushen-form-render` 依赖存在，但当前 `src/core/initMain.ts` 中插件注册被注释；使用 `FormRender` 前先确认是否需要启用插件注册。
+- 当前 `package.json` 未安装 `@gushen/gushen-work-flow`；流程相关页面主要作为壳层/包装层存在，若要直接使用工作流组件，先补依赖并确认注册方式。
+
+## 关键入口
+
+- 应用入口：`src/main.ts`
+- 插件、全局属性、全局组件：`src/core/initMain.ts`
+- 本地全局组件：`src/components/global-register.ts`
+- 路由：`src/router/index.ts`
+- 动态菜单与路由守卫：`src/permission.ts`
+- 页面：`src/views`
+- API：`src/api`
+- 语言包：`src/lang`、`src/lang/modules`
+
+## 代码风格
+
+- 新增 Vue 页面优先使用 Vue 3 `script setup lang="ts"`；维护旧页面时可沿用 Options API。
+- 新增业务代码不要使用 `// @ts-nocheck`。
+- `ref([])`、`reactive({})`、回调参数要显式类型，避免 `vue-tsc` 隐式 `any`。
+- 类型导入使用 `import type`。
+- 不要把 `isc-web-ui` 中依赖本地组件的规则照搬到本工程，除非本工程已有同名组件或先补齐组件。
+
+## 路由规则
+
+- 静态路由集中在 `src/router/index.ts` 的 `routes`。
+- 主布局子页面放在根路由 `/` 的 `children` 中，常用 meta：`title`、`enTitle`、`icon`、`noCache`、`hideInMenu`、`isBootstrap`。
+- 普通业务页优先走后台菜单动态路由：`src/permission.ts` 的 `formatRoutes` 会按 `menuUrl` / `originalAddr` 动态加载 `@/views${componentPath}/index.vue`。
+- 新建业务页通常放在 `src/views/{菜单路径}/index.vue`，菜单平台配置 `menuUrl` 后即可加载；不要默认修改 `src/router/index.ts`。
+- 只有登录页、首页、消息中心、个人中心等壳内固定页才补 `src/router/index.ts`。
+- HTTP 菜单会走 `src/views/third-view.vue` iframe；动态表单菜单通过 `handleDynamicFormRoute` 映射到固定动态表单入口。
+
+## 全局属性
+
+`src/core/initMain.ts` 中注入：
+
+- `this.$http` / `window.$request`：请求工具。
+- `this.reqIsSucceed`：统一成功判断。
+- `this.$bus`：事件总线。
+- `window._config`：运行配置。
+
+新增 Composition API 页面需要使用这些能力时，优先直接 import 对应工具函数；只有维护旧 Options API 页面时才使用 `this.xxx`。

package/skills/project-init/SKILL.md

@@ -407,7 +407,7 @@ questions: [
 
    - **补充检查（模式升级检测）**：当 `docs/` 已存在且 `docs` 决策为 `skip` 时，如果当前模式为**经典模式**、**完整模式**或**轻量模式**，需额外检查 `docs/40-project_conventions/` 的内容状态：
      - 检查 `docs/40-project_conventions/` 下是否存在实际文件（非空目录）
-     - 如果 `40-project_conventions/` 仅包含空子目录（简易模式的产物：`end-integration/` + `frontend-integration/`，或仅 `frontend-standard/` 为空目录）→ 根据前端技术栈选择自动从 references 补充复制 `frontend-standard/` 的文件内容（Vue → `ecp-front-standard/`，Ant Design React → `ant6-front-standard/`），并输出：`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按前端技术栈补充 frontend-standard/`
+     - 如果 `40-project_conventions/` 仅包含空子目录（简易模式的产物：`end-integration/` + `frontend-integration/`，或仅 `frontend-standard/` 为空目录）→ 根据前端技术栈选择自动从 references 补充复制 `frontend-standard/` 的文件内容（Vue → `vue3-front-standard/`，Ant Design React → `ant6-front-standard/`），同时补充复制后端规范 `ecp-end-standard/` 到 `end-standard/`，并输出：`📦 补充：检测到 40-project_conventions/ 为空目录（简易模式产物），已按技术栈补充 frontend-standard/ 和 end-standard/`
      - 如果 `40-project_conventions/` 已包含文件 → 不做额外处理
 
    - **子目录更新检查（40-project_conventions/）**：当 `docs/` 已存在且 `docs` 决策为 `skip`，且 `docs/40-project_conventions/` 下已包含实际文件时，需额外询问用户是否更新此子目录：
@@ -513,13 +513,13 @@ questions: [
 根据区域决策执行：
 
 - `docs` 决策为 `skip` → 输出 `⏭ 阶段 1 跳过：docs/ 已存在，保留现有内容`，但需检查 `conventions_decision` 子决策：
-  - 如果 `conventions_decision` = `"update"` → 根据前端技术栈选择从 `references/ecp-front-standard/`（Vue）或 `references/ant6-front-standard/`（Ant Design React）复制到 `$TARGET/docs/40-project_conventions/frontend-standard/`，覆盖更新前端规范文件，输出：`🔄 阶段 1 补充更新：docs/40-project_conventions/frontend-standard/ 已按前端技术栈更新`
+  - 如果 `conventions_decision` = `"update"` → 根据前端技术栈选择从 `references/vue3-front-standard/`（Vue）或 `references/ant6-front-standard/`（Ant Design React）复制到 `$TARGET/docs/40-project_conventions/frontend-standard/`，覆盖更新前端规范文件；经典/完整模式下同时从 `references/ecp-end-standard/` 复制到 `$TARGET/docs/40-project_conventions/end-standard/` 更新后端规范文件，输出：`🔄 阶段 1 补充更新：docs/40-project_conventions/ 已按技术栈更新前后端规范`
   - 如果 `conventions_decision` = `"skip"` → 不做额外处理
   - 处理完子决策后进入阶段 2
 - `docs` 决策为 `recreate` → 执行 `rm -rf "$TARGET/docs"`，然后按下方步骤完整重建
 - `docs` 决策为 `create` → 直接按下方步骤创建
 
-创建以下完整目录树。大部分目录使用 `mkdir -p` 创建并写入 `README.md`；其中 `40-project_conventions/` 在经典/完整模式下根据前端技术栈选择复制 `ecp-front-standard/`（Vue）或 `ant6-front-standard/`（Ant Design React）到 `frontend-standard/` 子目录，轻量模式下同时复制 `python-end-standard/` 到 `end-standard/` 和 `ant6-front-standard/` 到 `frontend-standard/`，在简易模式下仅创建空子目录结构。模板文件（原 `50-templates/`）已迁移至 `.adspecs/templates/`，随阶段 6 的 `.adspecs/` 复制一并完成。
+创建以下完整目录树。大部分目录使用 `mkdir -p` 创建并写入 `README.md`；其中 `40-project_conventions/` 在经典/完整模式下根据前端技术栈选择复制 `vue3-front-standard/`（Vue）或 `ant6-front-standard/`（Ant Design React）到 `frontend-standard/` 子目录，并复制 `ecp-end-standard/` 到 `end-standard/` 子目录（后端 Java 规范）；轻量模式下复制 `ant6-front-standard/` 到 `frontend-standard/` 和 `python-end-standard/` 到 `end-standard/`；在简易模式下仅创建空子目录结构。模板文件（原 `50-templates/`）已迁移至 `.adspecs/templates/`，随阶段 6 的 `.adspecs/` 复制一并完成。
 
 #### 目录结构
 
@@ -531,8 +531,8 @@ docs/
 ├── 20-prd/
 ├── 30-system-design/
 ├── 40-project_conventions/
-│   ├── frontend-standard/      # 经典/完整模式按前端技术栈复制（Vue→ecp-front-standard，AntD→ant6-front-standard）；轻量模式固定 ant6-front-standard；简易模式为空
-│   └── end-standard/           # 轻量模式固定 python-end-standard；其他模式为空
+│   ├── frontend-standard/      # 经典/完整模式按前端技术栈复制（Vue→vue3-front-standard，AntD→ant6-front-standard）；轻量模式固定 ant6-front-standard；简易模式为空
+│   └── end-standard/           # 经典/完整模式复制 ecp-end-standard（Java）；轻量模式固定 python-end-standard；简易模式为空
 ├── 70-scripts/
 │   └── depoly/
 ├── 80-development/
@@ -603,14 +603,15 @@ docs/
 - 用途: 项目约定，前后端集成开发规范和接口约定
 - 子目录:
   - `frontend-standard/` — 前端约定（按技术栈来源不同）
-  - `end-standard/` — 后端约定（仅轻量模式复制 Python 后端规范）
+  - `end-standard/` — 后端约定（按模式来源不同）
 - 来源规则（经典/完整模式）:
-  - 前端演示技术栈选择 **Vue（默认）** → 复制 `$PLUGIN_DIR/references/ecp-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
+  - 前端演示技术栈选择 **Vue（默认）** → 复制 `$PLUGIN_DIR/references/vue3-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
   - 前端演示技术栈选择 **Ant Design React** → 复制 `$PLUGIN_DIR/references/ant6-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
+  - 后端规范（所有经典/完整模式）→ 复制 `$PLUGIN_DIR/references/ecp-end-standard/` 到 `$TARGET/docs/40-project_conventions/end-standard/`
 - 来源规则（轻量模式）:
   - 前端规范：复制 `$PLUGIN_DIR/references/ant6-front-standard/` 到 `$TARGET/docs/40-project_conventions/frontend-standard/`
   - 后端规范：复制 `$PLUGIN_DIR/references/python-end-standard/` 到 `$TARGET/docs/40-project_conventions/end-standard/`
-- 来源规则（简易模式）: 仅创建空目录结构 `frontend-standard/`，不复制文件
+- 来源规则（简易模式）: 仅创建空目录结构 `frontend-standard/` + `end-standard/`，不复制文件
 
 **70-scripts/**:
 
@@ -665,6 +666,7 @@ mkdir -p "$TARGET/docs/300-specs"
 if [ "{mode}" = "simple" ]; then
   # 简易模式：仅创建空子目录结构，不复制 references 文件
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
+  mkdir -p "$TARGET/docs/40-project_conventions/end-standard"
 elif [ "{mode}" = "demo" ]; then
   # 轻量模式：固定技术栈 Python + SQLite + React + AntD6，前后端规范都复制
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
@@ -672,16 +674,18 @@ elif [ "{mode}" = "demo" ]; then
   cp -r "$PLUGIN_DIR/references/ant6-front-standard/." "$TARGET/docs/40-project_conventions/frontend-standard/"
   cp -r "$PLUGIN_DIR/references/python-end-standard/." "$TARGET/docs/40-project_conventions/end-standard/"
 else
-  # 经典/完整模式：按前端技术栈选择复制前端规范到 frontend-standard/
+  # 经典/完整模式：按前端技术栈选择复制前端规范到 frontend-standard/，后端统一复制 ecp-end-standard
   if [ "$FRONT_DEMO_SOURCE" = "antd-front-demo" ]; then
     # Ant Design React 技术栈
     FRONTEND_STANDARD_SOURCE="ant6-front-standard"
   else
     # Vue 技术栈（默认）
-    FRONTEND_STANDARD_SOURCE="ecp-front-standard"
+    FRONTEND_STANDARD_SOURCE="vue3-front-standard"
   fi
   mkdir -p "$TARGET/docs/40-project_conventions/frontend-standard"
+  mkdir -p "$TARGET/docs/40-project_conventions/end-standard"
   cp -r "$PLUGIN_DIR/references/$FRONTEND_STANDARD_SOURCE/." "$TARGET/docs/40-project_conventions/frontend-standard/"
+  cp -r "$PLUGIN_DIR/references/ecp-end-standard/." "$TARGET/docs/40-project_conventions/end-standard/"
 fi
 
 # 注意：模板文件已迁移至 .adspecs/templates/，随阶段 6 的 .adspecs/ 复制一并完成，无需单独复制
@@ -694,7 +698,7 @@ fi
 完成后输出：
 
 - 新建时（简易模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，40 仅创建空目录；模板在 .adspecs/templates/ 随阶段 6 复制）`
-- 新建时（经典/完整模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，其中 40 从 references 复制；模板在 .adspecs/templates/ 随阶段 6 复制）`
+- 新建时（经典/完整模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，其中 40 从 references 复制前后端规范；模板在 .adspecs/templates/ 随阶段 6 复制）`
 - 新建时（轻量模式）：`✅ 阶段 1 完成：docs/ 目录结构已创建（11 个一级子目录，40 按 Python+React 技术栈复制前后端规范；模板在 .adspecs/templates/ 随阶段 6 复制）`
 - 重建时：`🔄 阶段 1 完成：docs/ 目录结构已重新创建（删除旧目录后重建）`
 - 跳过时：`⏭ 阶段 1 跳过：docs/ 已存在，保留现有内容`
@@ -1128,7 +1132,7 @@ echo "更新了 ${#REPLACE_FILES[@]} 个模板文件，保留了 ${#KEEP_FILES[@
 hooks/
 ├── hooks.json            # 跨平台 Hook 配置（SessionStart/PreCompact/PostToolUse/Stop）
 ├── platform.js           # 平台检测工具模块（Claude Code / Qoder / WorkBuddy 兼容）
-├── session-start.js      # SessionStart — 注入 using-adspecs 技能引导
+├── session-start.js      # SessionStart — 会话启动占位（会话引导由 session-logger.js init 承担）
 ├── wiki-queue.js         # PostToolUse/Stop — wiki 同步队列管理
 ├── commit-queue.js       # PostToolUse/Stop — commit 候选队列管理
 └── session-logger.js     # SessionStart/PreCompact/Stop — AI 会话日志管理
@@ -1151,9 +1155,9 @@ find "$TARGET/hooks" -type f | wc -l
 ```
 
 **注意**：
-- hooks.json 中的 `${CLAUDE_PLUGIN_ROOT}` 由平台在加载插件时注入，指向插件根目录或项目目录
-- 复制 hooks/ 到项目目录确保脚本在任何平台环境下都能正确解析
-- 不要修改 hooks.json 内容，保持 `${CLAUDE_PLUGIN_ROOT}` 变量引用不变
+- hooks.json 中的脚本命令使用项目根目录相对路径（`hooks/xxx.js`），运行时由平台 CWD 解析到目标项目的 `hooks/` 目录
+- 复制 hooks/ 到目标项目根目录是脚本可执行的前提，不可省略
+- 不要修改 hooks.json 内容，保持 `hooks/xxx.js` 路径格式不变
 
 完成后输出：
 
@@ -1245,7 +1249,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录，40 仅创建空目录                                             |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录，40 仅创建空目录（含 frontend-standard/ + end-standard/）    |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | hooks/                    | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | Hook 脚本（hooks.json + platform.js + 4 个事件脚本）                       |
@@ -1259,7 +1263,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制前后端规范                            |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | front-demo/               | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | {技术栈名}，{N} 个文件                                                     |
@@ -1274,7 +1278,7 @@ mkdir -p "$TARGET/.adspecs"
 | .adspecs/                 | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 插件配置、脚本、模板（extensions.yml、feature.json、templates/、scripts/） |
 | └ templates/              | 🔄 部分更新 / ⏭ 全部跳过         | .adspecs/ 跳过时，逐文件确认结果（{N} 个替换，{M} 个保留）                 |
 | └ feature.json            | 🔧 已补全 / ✅ 已完整 / ✅ 已创建 | 属性补全检查（已有属性保留，缺失属性补充）                                 |
-| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制                                      |
+| docs/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 11 个骨架目录 + 40 从 references 复制前后端规范                            |
 | └ 40-project_conventions/ | 🔄 已更新 / ⏭ 已跳过             | docs/ 跳过时，40 子目录的更新决策                                          |
 | wiki/                     | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | 基线文件目录 + README.md                                                   |
 | web-ui/                   | ✅ 已创建 / 🔄 已重建 / ⏭ 已跳过 | {N} 个文件                                                                 |
@@ -1321,7 +1325,7 @@ mkdir -p "$TARGET/.adspecs"
 **经典模式：**
 {pwd}/{PROJECT_DIR}/（或直接 {pwd}/）
 ├── .adspecs/ (插件配置、脚本、模板 + project.json)
-├── docs/ (11 个子目录)
+├── docs/ (11 个子目录 + 40-project_conventions/ 含前端规范 + Java 后端规范)
 ├── hooks/ (Hook 脚本：SessionStart/Stop/PostToolUse 等)
 ├── wiki/ (基线文件目录)
 └── front-demo/ ({技术栈名}前端演示项目)
@@ -1329,7 +1333,7 @@ mkdir -p "$TARGET/.adspecs"
 **完整模式：**
 {pwd}/{PROJECT_DIR}/（或直接 {pwd}/）
 ├── .adspecs/ (插件配置、脚本、模板 + project.json)
-├── docs/ (11 个子目录)
+├── docs/ (11 个子目录 + 40-project_conventions/ 含前端规范 + Java 后端规范)
 ├── hooks/ (Hook 脚本：SessionStart/Stop/PostToolUse 等)
 ├── wiki/ (基线文件目录)
 ├── web-ui/ (Vue3 壳工程)
@@ -1420,7 +1424,7 @@ mkdir -p "$TARGET/.adspecs"
 - [ ] 已选择前端演示技术栈（经典/完整模式：Vue / Ant Design React；轻量模式固定 Ant Design React）
 - [ ] 已按模式检查目标路径下对应区域的存在情况
 - [ ] 对已存在的区域已通过 AskUserQuestion 获取用户选择（重新创建 / 跳过）
-- [ ] docs/ 目录结构已创建/重建/跳过（按用户决策执行；简易模式下 40-project_conventions/ 仅创建空目录，经典/完整模式从 references 复制前端规范，轻量模式复制前后端规范）
+- [ ] docs/ 目录结构已创建/重建/跳过（按用户决策执行；简易模式下 40-project_conventions/ 仅创建空目录，经典/完整模式从 references 复制前后端规范（前端按技术栈 + ecp-end-standard），轻量模式复制 ant6-front-standard + python-end-standard）
 - [ ] 模式升级补充检查已完成（docs/ 跳过时，经典/完整/轻量模式自动检测并补充空的 40-project_conventions/）
 - [ ] 40-project_conventions/ 子目录更新检查已完成（docs/ 跳过且目录已包含文件时，已通过 AskUserQuestion 获取更新/跳过决策并按决策执行）
 - [ ] wiki/ 基线文件目录已创建/重建/跳过