weaver-e10-builder 1.5.11 → 1.5.13

package/skill-docs/references/coding/guide-page-code.md

@@ -217,6 +217,8 @@ if (editingId) {
 | **资源统一用 `${appRes}/相对路径`**（如 `${appRes}/logo.png`） | `${appRes}` 是平台模板变量，导入后自动替换成正式静态地址。**禁止**写 `./resources/...`、`../resources/...`、`/resources/...`，发布后必 404。 |
 | **禁止在线资源** | 不要 `loadjs('http(s)://...')`、CDN、外链脚本——平台不加载外网资源。确需第三方脚本：先下载进项目，再按上一条 `${appRes}` 引用。 |
 | **禁止在 JS 里 `import` CSS** | ecode 没有 CSS 模块解析，`import './x.css'` 不会生效，样式静默丢失。少量样式用内联 style；独立 CSS 文件的打包规则见 `ref-compile-rules.md`「E10 打包与平台加载规则」。 |
+| **HTML 原型：样式严格 100% 还原** | 用户提供 HTML 原型时，页面样式必须与原型严格一致（布局、间距、字号、颜色、圆角、边框、层级），不得用平台默认样式近似代替；交付前逐项对照原型自检。 |
+| **HTML 复刻：样式写进代码，不建独立 CSS 文件** | 用户提供 HTML/设计稿并要求完整复刻时，样式全部写在组件代码里（内联 `style` / 代码内样式对象），**不要生成独立 `.css` 文件**——拆出去不保证被加载，复刻会静默丢样式。 |
 | **全部用 ESM `import` / `export`，禁止 `module.exports`** | 平台按模块加载，CommonJS 导出解析不到。 |
 | **只用白名单组件及其文档化 props** | 拿不准的组件 / prop / 图标名，先查 `references/components/`，不要凭记忆从 `@weapp/ui` 编造。 |
 | **不碰平台组件内部** | 不读 `props.children[...]`（含可选链写法）、不依赖内部 class / `weId` 段、不做全局无条件 `regOvComponent` 复写——内部结构不是稳定 API，平台升级即坏。 |

package/skill-docs/references/coding/ref-compile-rules.md

@@ -112,6 +112,8 @@ e10-cli project import <projectId> .target/xxx.zip --main-url /sp/custom/...
 ### CSS 规则
 
 - **禁止在 JS 里 `import` CSS**：ecode 无 CSS 模块解析，写了必丢、发布后无样式。
+- **用户提供 HTML 原型时，页面样式严格 100% 还原**（布局、间距、字号、颜色、圆角、边框、层级），不用平台默认样式近似代替。
+- **完整复刻用户提供的 HTML 时，样式一律内联进代码**（内联 style / 代码内样式对象），不要拆成独立 `.css` 文件：拆出去既不保证加载，也容易与页面结构脱节，复刻效果走样。
 - 少量页面样式用内联 style；确需独立 `.css` 文件时，确认它在 `build.json` 的 codes 里（首次自动生成时 `.css` 会登记为 `y`；文件是后加的要自行补登记），否则平台不合并加载。
 - 业务 CSS 选择器挂在页面根容器下，避免裸 `.类名`、`body`、`:root` 或平台内部 class 污染全局。
 

package/skill-docs/references/common/capability-boundaries.md

@@ -0,0 +1,15 @@
+# 平台与 CLI 能力边界
+
+> 下列能力 **CLI 不支持、平台也不支持**。不要声称可以做，也不要输出操作步骤；直接告知用户「当前平台/CLI 不支持」。
+
+| 不支持的能力 | 说明 |
+|---|---|
+| H5 / 移动端菜单 | 移动端是独立体系（不同 URL + 不同 pageId），尚未整理，禁止编造 |
+
+## 判断「CLI 支不支持」的正确方式
+
+1. 先查 `references/common/ref-cli-commands.md` 的对应命令与参数；
+2. 再跑 `e10-cli <命令> --help` 确认当前版本有没有该选项；
+3. 仍无法确认时，问用户或如实说明「当前版本没有对应命令」。
+
+**禁止绕行**：不要为了完成配置临时编写 `.mjs` 脚本调用内部接口，也不要让用户直接操作浏览器或设计器代替命令；确认没有命令时，保留该项未完成状态并说明影响。

package/skill-docs/references/common/guide-install.md

@@ -0,0 +1,44 @@
+# 安装、升级与文档同步
+
+## 版本必须匹配
+
+skill 与 CLI 的版本要一致（见 SKILL.md frontmatter 的 `version`）。版本不一致时，命令、选项和文档可能对不上。
+
+```bash
+e10-cli --version          # 应与 SKILL.md 标注的版本一致
+npm install -g weaver-e10-builder
+```
+
+## CLI 升级
+
+- 一般工具：先 `npm rm -g weaver-e10-builder` 卸掉旧包，再重新安装，避免 bin 残留冲突。
+- WorkBuddy：先直接用 bash 删除旧包目录（不走 npm 删除），再用 npm 纯安装，并指定一个有权限的工作目录作为缓存地址。
+
+## skill 安装 / 升级
+
+先卸旧（旧名 `skill-e10-cli`），再装新：
+
+```bash
+npx -y skills remove skill-e10-cli
+npx -y skills add ./weaver-e10-builder.zip --skill -y
+```
+
+`skills remove` 无效时手动删除后再 add：
+
+- Claude Code：`rm -rf ~/.claude/skills/skill-e10-cli` → 新 skill 装到 `~/.claude/skills/weaver-e10-builder`
+- WorkBuddy：`rm -rf ~/.workbuddy/skills/skill-e10-cli` → 新 skill 装到 `~/.workbuddy/skills/weaver-e10-builder`
+
+## 文档树同步
+
+1.1.0 起发布的 skill 是**薄指令层**：只带 SKILL.md、`_catalog.md`、actionflows 指令层和 scripts，不含深目录文档树（适配 marketplace 两级目录限制）。完整文档随配套 CLI 的 `skill-docs` 分发。
+
+- 每次 `e10-cli auth status` 会自动探测本机已装 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills`）并同步文档；版本一致则跳过。
+- 手动刷新：`e10-cli skill sync`；可 `--target <安装根目录>` 指定其他工具目录。
+- 装完 skill 后看到 references 文档多出/更新、旧文档被清理，都是正常的同步现象，不是装错或重复安装。
+- 读 `references/...` 提示文件不存在 → 先 `e10-cli skill sync`，或确认 skill 已装后重跑 `e10-cli auth status`。
+
+## 文档读取与模板拷贝
+
+- 文档在 skill 目录内（如 `~/.claude/skills/weaver-e10-builder/`），`references/...`、`actionflows/...`、`assets/...` 均相对该目录。
+- 按决策树命中哪个读哪个，不要一次性全部读入。
+- 页面模板用 `e10-cli skill copy [目录]` 拷到工作区（默认当前目录，放出 `references/`、`actionflows/`、`assets/`）。

package/skill-docs/references/common/guide-plan-template.md

@@ -1,164 +1,167 @@
-# 搭建计划模板（按依赖与功能批次执行）
-
-使用本模板生成项目 `plan.md` 时，先读[规划能力地图](map.md)识别资源、配置和依赖；需要明确具体规则或能力边界时读对应专题指南，再填写实际涉及的条目。执行某项前仍须读取该项指南。
-
-规划阶段全部保持 `[ ]`。第一阶段先完成全部表单的字段、明细和布局，再以**功能项为外层、所有适用表单/视图为内层**组织配置：例如先完成所有表单的关联浏览数据范围，再处理所有表单的公式；视图也按显示列、搜索、排序等功能逐批覆盖。每进入一个功能项先读对应指南，确认方法、参数和边界；同一连续批次已读过的无需重复读取。每个对象及独立规则分别列项、核对、回填和销号；暂不能完成的保留 `[ ]` 并注明原因、已完成部分及所需条件，继续处理其他项目，不因步骤繁琐而省略。整个功能批次的覆盖对象处理完后进入下一批次，真实依赖优先于批次顺序。每段完成后停下让用户确认，确认后进入下一段。仅单步修改或查询不套用三段流程。
-
-## plan.md 参考骨架
-
-复制本节到项目工作区的 `plan.md`，只保留需求涉及的资源和功能；每条业务要求都有明确归属、来源、依赖和可观察结果。同类功能可连续执行，但不能把多条独立要求合成一个销号项。
-
-```md
-## 搭建计划
-
-> `[ ]` 为未完成；写入且按该项风险完成必要核验后，才改 `[x]` 并填写真实 ID 或结果。尚待后续资源的项保留 `[ ]` 并写明依赖。
-> 来源可用需求文档章节、表格或图片标题。已有资源先只读盘点，记明复用/修改/新建及实际 ID。
-
-### 0. 环境与范围
-- 目标环境/profile：<名称与地址>；所属机构：<名称/ID>；主应用：<名称/ID>
-- 跨应用资源与范围：<无/资源及归属>
-- 待业务确认：<歧义及其影响；无则“无”>
-- 待环境核查：<资源或环境行为；无则“无”>
-
-### 1. 资源清单与依赖
-
-| 资源 | 决策与归属 | 来源及用途 | 前置依赖 | 实际 ID/结果 |
-|---|---|---|---|---|
-| 应用 <名称> | 新建/复用；机构 <名称> | <来源> | 环境 | 待回填 appId |
-| 角色 <名称> | 新建/复用 | <来源、成员类型与范围> | 机构 | 待回填 roleId |
-| 矩阵 <名称> | 新建/复用 | <来源、条件列/值列/行数据> | 机构、人员/部门 | 待回填 matrixId |
-| 表单 <名称> | EB/虚拟/原生流程表单；新建/复用；应用 <名称> | <来源、用途> | 应用、数据源 | 待回填 objId/formId |
-| 视图 <名称> | 默认台账改名/复用/新增；PC/MOBILE | <来源、用途> | 所属表单 | 待回填 listId/viewId |
-| 流程 <名称> | EB/原生；普通/公文；固定/自由；新建/复用 | <来源、业务流转> | 表单、角色/矩阵 | 待回填 workflowId |
-| 权责表 <名称> | 随流程新建/独立复用 | <来源、分支场景> | 流程/变量 | 待回填 authRespId |
-| 报表/数据集 <名称> | 新建/复用 | <来源、统计目标> | 来源字段 | 待回填 ID |
-| 菜单/页面 <名称> | 新建/复用 | <来源、入口及目标> | 视图/流程/页面 | 待回填 ID |
-
-> 角色和矩阵先用 `role list`、`matrix list` 只读盘点同名资源及归属、成员或数据行，记录候选 ID，并与用户逐项确认复用还是新建。复用但需补成员或数据行的，在对应功能批次单独列项；没有矩阵需求则不创建。
-
-#### 1.1 表单字段与布局蓝图（每张表单各一份）
-
-##### 表单：<名称>；资源决策：<新建/复用>；objId/formId：<待回填>；来源：<章节>
-- 布局：FLOW/EXCEL；已有表单改造时记录现有布局及保留要求。
-- 字段清单：逐字段写主表/明细表、名称、componentKey、选项、默认值、长度/精度、关联目标、公式及明确的必填/只读/隐藏/独占一行/分组。字段名含中英文时分别记录。
-- 明细表：<名称、字段、层级>；二级明细逐条记录父明细→子明细、父子行标识及默认展开要求。
-- 虚拟表：<来源类别与资源ID、稳定主键、来源字段→展示类型映射>。
-- 关联依赖：<字段→目标表/流程及 ID 待回填位置>。
-- 布局样表来源：<章节/图片/表格；无则“未提供，使用约定布局”>。
-
-| 行 | 类型 | 左侧单元 | 右侧单元 | 跨列/占位 | 原文属性与说明 |
-|---|---|---|---|---|---|
-| 1 | 标题 | <标题> | — | 跨全部列 | <来源> |
-| 2 | 字段 | <标签>→[字段] | <标签>→[字段] | <同排/留空> | <必填/只读等> |
-| 3 | 分组 | <分组名> | — | 跨全部列 | <顺序> |
-
-> 样表有标题、分组、空白、字段同排或跨列时逐行保留，并与字段清单互相核对。缺少的合并范围标待确认。建新表时按蓝图准备 fields.json，按所选布局创建并初始化；公式、联动、校验等后续配置在功能批次单列。
-
-#### 1.2 视图与流程设计依据
-- 每张视图：所属表单、默认/新增、视图类型、终端、名称、数据范围及需要的显示列/交互要求。
-- 每个流程：表单来源、节点、操作者及签署方式、全部连线、默认出口、逐条条件、节点显示属性和动作流落点。普通流程和权责表流程分别按对应指南列出；权责表逐场景写说明、条件、经过节点及顺序，独立复用时写变量→主/明细字段映射。
-
-### 2. 第一阶段：应用、表单与视图
-
-#### 2.1 资源与字段布局批次
-- [ ] 应用 <名称> | 新建/复用 | appId：待回填 | 核验：<名称与归属>
-- [ ] 角色 <名称> | roleId：待回填 | 核验：<角色及成员；成员可另列项>
-- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
-- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
-
-> 先按跨表引用关系建立必要的表单骨架，再补关联目标；不为了凑齐所有表单而破坏实际依赖。新建 EB 表单尽量用 `form create --fields` 一次写入字段与布局属性。依赖流程 ID 的关联字段记录占位，流程建成后回填。
-
-#### 2.2 表单级功能批次（一个功能项覆盖全部相关表单）
-
-> 写实际 plan 时，按 `##### 功能批次：<功能名>｜覆盖表单：<A、B、...>` 分组；组内为每张表单的每条规则分别列 `[ ]`。例如“关联浏览数据范围”涉及客户表、合同表，就在同一批次下列两条，逐条配置并销号，再进入“字段公式”等下一批次。下列每行是应按需求展开的功能项示例，不代表只配置一张表单。
-
-##### 功能批次：关联浏览数据范围｜覆盖表单：<客户表、合同表>
-- [ ] 客户表 / 关联客户字段 | 条件：<规则> | 核验：可选记录
-- [ ] 合同表 / 关联项目字段 | 条件：<规则> | 核验：可选记录
-
-##### 功能批次：<从下列功能项选择一类>｜覆盖表单：<逐一列出>
-
-> 按需求复制此标题，每个标题只放同一功能的待办项，并把覆盖表单逐一展开；下列条目是可选的填写样式。
-- [ ] 关联字段及目标绑定 | 表单/字段：<名称> | 目标：<资源/ID> | 核验：选择范围
-- [ ] 关联浏览显示列 | 表单/字段：<名称> | 列：<字段及顺序> | 核验：弹窗显示
-- [ ] 二级明细关系 | 父表/子表：<名称> | 行标识：<字段> | 核验：逐父行归属
-- [ ] 字段多语言 | 表单/字段：<名称> | 中文/英文：<名称> | 核验：两种名称
-- [ ] 字段公式 | 表单/目标字段：<名称> | 表达式：<公式> | 核验：读回与样例值
-- [ ] 字段带出或函数联动 | 表单/规则：<名称> | 触发/来源/目标/表达式：<内容> | 核验：触发结果
-- [ ] 属性显隐联动 | 表单/规则：<名称> | 条件/目标/状态：<内容> | 核验：条件切换
-- [ ] 查重校验 | 表单/字段：<名称> | 行为：<提示/阻断> | 核验：重复样例
-- [ ] 编号规则 | 表单/字段：<名称> | 组成与位数：<内容> | 核验：生成值
-- [ ] 表单权限 | 表单/主体：<名称> | 新建/查看/编辑/删除范围：<内容> | 核验：授权结果
-- [ ] 表单页按钮 | 表单/页面/位置：<名称> | 目标与字段映射：<内容> | 核验：点击结果
-
-> 每个功能批次先核对覆盖表单清单，再逐表配置；同一表单有多条独立规则时继续拆行。建表时已配置并核验的分组、必填、只读、默认值等写在 2.1 的表单项结果中，不重复执行。
-
-#### 2.3 视图资源批次
-- [ ] 默认台账 <原名> 复用/改名为 <目标名> | 表单：<名称> | listId：待回填 | 核验：名称与类型
-- [ ] 新增视图 <名称> | 表单：<名称> | 类型/终端：<内容> | listId/viewId：待回填 | 核验：可打开且已填充
-
-#### 2.4 视图功能批次（一个功能项覆盖全部相关视图）
-
-> 沿用 2.2 的结构：`##### 功能批次：<功能名>｜覆盖视图：<视图A、视图B、...>`。例如“显示列”先列全部需配置的 PC/MOBILE 视图，每张视图及终端单独列项并完成；再处理搜索、排序等下一批次。以下为需要按需求展开的功能项示例。
-- [ ] 显示列 | 视图/终端：<名称/PC或MOBILE> | 字段/顺序/宽度：<内容> | 核验：列表显示
-- [ ] 列格式或单位 | 视图/字段：<名称> | 格式/单位：<内容> | 核验：展示值
-- [ ] 搜索与排序 | 视图：<名称> | 字段、入口与优先级：<内容> | 核验：查询及顺序
-- [ ] 筛选与顶部统计 | 视图：<名称> | 条件/函数：<内容> | 核验：记录及统计值
-- [ ] 普通分组或上下级 | 视图：<名称> | 分组/父级字段：<内容> | 核验：分组或层级
-- [ ] 视图权限 | 视图/主体：<名称> | 查看/操作范围：<内容> | 核验：权限读回
-- [ ] 行上或右上按钮 | 视图/位置：<名称> | 目标/当前行过滤/预填：<内容> | 核验：点击结果
-- [ ] 行点击或字段点击 | 视图/字段：<名称> | 打开目标和方式：<内容> | 核验：点击结果
-- [ ] 关联页签 | 表单/页签/目标视图：<名称> | 权限/布局/终端/筛选映射：<内容> | 核验：相关数据
-
-> 搜索、排序、筛选和统计若各有独立业务要求，分别建立功能批次和待办项。依赖第二阶段流程 ID 的按钮、流程关联字段等保留 `[ ]` 并注明依赖，在第二阶段回填后销号。第一阶段完成后请用户确认，再进入第二阶段。
-
-### 3. 第二阶段：流程与自动化
-
-#### 3.1 矩阵、权责表及流程资源
-- [ ] 矩阵 <名称> | 条件列/值列/行×列数据：<内容> | matrixId：待回填 | 核验：列、行和值
-- [ ] 流程 <名称> | EB/原生/公文，固定/自由，表单来源：<内容> | workflowId：待回填 | 核验：绑定表单
-- [ ] 本流程全部节点 | 节点名称、类型及顺序：<内容> | 核验：节点 ID 与清单一致
-- [ ] 本流程全部连线 | 源节点→目标节点、连线名称及默认出口：<内容> | 核验：完整拓扑
-- [ ] 本流程出口条件 <源节点→目标节点> | 字段来源、操作、值、AND/OR、明细量词：<内容> | 每条条件复制一项；核验：分支路由
-- [ ] 本流程节点操作者 <节点名> | 角色/矩阵/字段等来源及签署方式：<内容> | 每个节点复制一项；核验：人员范围
-- [ ] 本流程结构排版与核对 | 节点、连线、默认出口、条件及操作者：<内容> | 核验：流程图及配置读回
-- [ ] 权责表 <名称> | 随流程新建/独立复用 | authRespId：待回填 | 核验：场景与节点路径
-
-> 每个流程各复制一组“流程→节点→连线→条件→操作者→结构核对”，逐条流程完成核心流转；独立条件和操作者仍分别列项、分别销号。权责表流程的分支与经过节点按权责表指南在本流程下展开。实际配置按依赖进行，后续若有完整配置命令，可由同一组计划条目核对结果。
-
-#### 3.2 流程附加设置与功能批次
-- [ ] 节点字段权限或布局 | 流程/节点：<名称> | 字段/显示状态：<内容> | 核验：节点页面
-- [ ] 节点校验、退回、超时、菜单或其他行为 | 流程/节点：<名称> | 逐项写明：<内容> | 核验：配置读回
-- [ ] 流程编号、标题、提醒或流程级设置 | 流程：<名称> | 逐项写明：<内容> | 核验：配置读回
-- [ ] 公文专属设置 | 流程：<名称> | 按实际需求列出：<内容> | 核验：对应设置读回
-- [ ] 权责表场景/变量映射 | 权责表：<名称> | 场景条件、路径或变量→字段：<内容> | 核验：路径与映射
-- [ ] 动作流/节点字段赋值 | 触发流程/节点：<名称> | 目标、字段映射及定位：<内容> | 核验：绑定与结果
-- [ ] 回填第一阶段的流程依赖 | 表单字段/视图按钮：<名称> | workflowId/formId：<实际值> | 核验：选择或打开结果
-
-> 核心流转按 3.1 逐流程完成；本节的附加设置可按功能批次处理，但每条独立规则或动作流仍分别列项。第二阶段完成后请用户确认，再进入第三阶段。
-
-### 4. 第三阶段：报表、菜单与页面
-- [ ] 报表数据集 <名称> | 来源、字段、关联：<内容> | datasetId：待回填 | 核验：数据集字段
-- [ ] 报表 <名称> | 布局、查询及共享：<内容> | reportId：待回填 | 核验：展示与授权
-- [ ] 菜单 <名称> | 层级、目标资源及权限：<内容> | menuId：待回填 | 核验：入口与可见范围
-- [ ] 配置式或定制页面 <名称> | 终端、组件/交互、绑定资源：<内容> | pageId：待回填 | 核验：页面加载与业务结果
-
-### 5. 待确认、需补充及无法实现
-| 来源与原需求 | 状态 | 原因或缺失信息 | 影响与后续处理 |
-|---|---|---|---|
-| <章节及要求> | 待业务确认/待环境核查/需其他方式补充/已确认无法实现 | <内容> | <内容> |
-
-> 已确认无法实现的原需求项保持 `[ ]`，不得以替代配置冒充完成；在此说明原因和影响，交由用户决定。其他状态继续保留相应待办与依赖。
-
-### 6. 阶段验收与交付资源
-- 第一阶段：全部应建表单的字段、明细、布局和默认台账已核对；表单级与视图级需求逐项销号，后续流程依赖已标注。
-- 第二阶段：流程结构、关键条件、操作者及动作流已核对；第一阶段的流程依赖项已回填。
-- 第三阶段：报表、菜单和页面入口已核对；交付时列出应用→表单→视图、流程、矩阵、报表、页面的真实 ID 与未完成项。
-```
-
-## 使用边界
-
-- 资源清单负责保存“建什么、复用什么、谁依赖谁”，功能批次负责“具体配置什么”；两处用资源名称或实际 ID 对应，不重复创建同一资源。
-- 字段和布局蓝图仍逐表保存，防止按功能批次执行时遗失字段顺序、分组和表格空间结构。
-- 功能批次只规定同类操作的优先处理顺序。出现跨表循环、流程 ID、目标页面等依赖时，按真实依赖先建立资源，再回到相应条目完成配置。
-- 最小核验与业务风险相称；仅在用户要求时进行实际环境测试。计划销号仍以配置完成及必要的结果核对为准。
+# 搭建计划模板（按依赖与功能批次执行）
+
+使用本模板生成项目 `plan.md` 时，先读[规划能力地图](map.md)识别资源、配置和依赖；需要明确具体规则或能力边界时读对应专题指南，再填写实际涉及的条目。执行某项前仍须读取该项指南。
+
+规划阶段全部保持 `[ ]`。第一阶段先完成全部表单的字段、明细和布局，再以**功能项为外层、所有适用表单/视图为内层**组织配置：例如先完成所有表单的关联浏览数据范围，再处理所有表单的公式；视图也按显示列、搜索、排序等功能逐批覆盖。每进入一个功能项先读对应指南，确认方法、参数和边界；同一连续批次已读过的无需重复读取。每个对象及独立规则分别列项、核对、回填和销号；暂不能完成的保留 `[ ]` 并注明原因、已完成部分及所需条件，继续处理其他项目，不因步骤繁琐而省略。整个功能批次的覆盖对象处理完后进入下一批次，真实依赖优先于批次顺序。每段完成后停下让用户确认，确认后进入下一段。仅单步修改或查询不套用三段流程。
+
+## plan.md 参考骨架
+
+复制本节到项目工作区的 `plan.md`，只保留需求涉及的资源和功能；每条业务要求都有明确归属、来源、依赖和可观察结果。同类功能可连续执行，但不能把多条独立要求合成一个销号项。
+
+```md
+## 搭建计划
+
+> `[ ]` 为未完成；写入且按该项风险完成必要核验后，才改 `[x]` 并填写真实 ID 或结果。尚待后续资源的项保留 `[ ]` 并写明依赖。
+> 来源可用需求文档章节、表格或图片标题。已有资源先只读盘点，记明复用/修改/新建及实际 ID。
+
+### 0. 环境与范围
+- 目标环境/profile：<名称与地址>；所属机构：<名称/ID>；主应用：<名称/ID>
+- 跨应用资源与范围：<无/资源及归属>
+- 待业务确认：<歧义及其影响；无则“无”>
+- 待环境核查：<资源或环境行为；无则“无”>
+
+### 1. 资源清单与依赖
+
+| 资源 | 决策与归属 | 来源及用途 | 前置依赖 | 实际 ID/结果 |
+|---|---|---|---|---|
+| 应用 <名称> | 新建/复用；机构 <名称> | <来源> | 环境 | 待回填 appId |
+| 角色 <名称> | 新建/复用 | <来源、成员类型与范围> | 机构 | 待回填 roleId |
+| 矩阵 <名称> | 新建/复用 | <来源、条件列/值列/行数据> | 机构、人员/部门 | 待回填 matrixId |
+| 表单 <名称> | EB/虚拟/原生流程表单；新建/复用；应用 <名称> | <来源、用途> | 应用、数据源 | 待回填 objId/formId |
+| 视图 <名称> | 默认台账改名/复用/新增；PC/MOBILE | <来源、用途> | 所属表单 | 待回填 listId/viewId |
+| 流程 <名称> | EB/原生；普通/公文；固定/自由；新建/复用 | <来源、业务流转> | 表单、角色/矩阵 | 待回填 workflowId |
+| 权责表 <名称> | 随流程新建/独立复用 | <来源、分支场景> | 流程/变量 | 待回填 authRespId |
+| 报表/数据集 <名称> | 新建/复用 | <来源、统计目标> | 来源字段 | 待回填 ID |
+| 菜单/页面 <名称> | 新建/复用 | <来源、入口及目标> | 视图/流程/页面 | 待回填 ID |
+
+> 角色和矩阵先用 `role list`、`matrix list` 只读盘点同名资源及归属、成员或数据行，记录候选 ID，并与用户逐项确认复用还是新建。复用但需补成员或数据行的，在对应功能批次单独列项；没有矩阵需求则不创建。
+
+#### 1.1 表单字段与布局蓝图（每张表单各一份）
+
+##### 表单：<名称>；资源决策：<新建/复用>；objId/formId：<待回填>；来源：<章节>
+- 布局：FLOW/EXCEL；已有表单改造时记录现有布局及保留要求。
+- 字段清单：逐字段写主表/明细表、名称、componentKey、选项、默认值、长度/精度、关联目标、公式及明确的必填/只读/隐藏/独占一行/分组。字段名含中英文时分别记录。
+- 明细表：<名称、字段、层级>；二级明细逐条记录父明细→子明细、父子行标识及默认展开要求。
+- 虚拟表：<来源类别与资源ID、稳定主键、来源字段→展示类型映射>。
+- 关联依赖：<字段→目标表/流程及 ID 待回填位置>。
+- 布局样表来源：<章节/图片/表格；无则“未提供，使用约定布局”>。
+
+| 行 | 类型 | 左侧单元 | 右侧单元 | 跨列/占位 | 原文属性与说明 |
+|---|---|---|---|---|---|
+| 1 | 标题 | <标题> | — | 跨全部列 | <来源> |
+| 2 | 字段 | <标签>→[字段] | <标签>→[字段] | <同排/留空> | <必填/只读等> |
+| 3 | 分组 | <分组名> | — | 跨全部列 | <顺序> |
+
+> 样表有标题、分组、空白、字段同排或跨列时逐行保留，并与字段清单互相核对。缺少的合并范围标待确认。建新表时按蓝图准备 fields.json，按所选布局创建并初始化；公式、联动、校验等后续配置在功能批次单列。
+
+- 明确还原图片/XLSX源样式时，另记录源哈希、LayoutSpec、已有字段绑定、编译产物和独立回读结果。字段创建完成与布局还原通过分别勾选；未匹配、未支持项不能合并销号。相关指南为 `form/guide-form-layout-source.md`，精确保存晚于字段补写和归组重排。
+
+#### 1.2 视图与流程设计依据
+- 每张视图：所属表单、默认/新增、视图类型、终端、名称、数据范围及需要的显示列/交互要求。
+- 每个流程：表单来源、节点、操作者及签署方式、全部连线、默认出口、逐条条件、节点显示属性和动作流落点。普通流程和权责表流程分别按对应指南列出；权责表逐场景写说明、条件、经过节点及顺序，独立复用时写变量→主/明细字段映射。
+
+### 2. 第一阶段：应用、表单与视图
+
+#### 2.1 资源与字段布局批次
+- [ ] 应用 <名称> | 新建/复用 | appId：待回填 | 核验：<名称与归属>
+- [ ] 角色 <名称> | roleId：待回填 | 核验：<角色及成员；成员可另列项>
+- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
+- [ ] 表单 <名称> 的字段、明细及布局 | objId/formId：待回填 | 来源：1.1 <名称> | 核验：字段、布局及默认台账
+
+> 先按跨表引用关系建立必要的表单骨架，再补关联目标；不为了凑齐所有表单而破坏实际依赖。新建 EB 表单尽量用 `form create --fields` 一次写入字段与布局属性。依赖流程 ID 的关联字段记录占位，流程建成后回填。
+
+#### 2.2 表单级功能批次（一个功能项覆盖全部相关表单）
+
+> 写实际 plan 时，按 `##### 功能批次：<功能名>｜覆盖表单：<A、B、...>` 分组；组内为每张表单的每条规则分别列 `[ ]`。例如“关联浏览数据范围”涉及客户表、合同表，就在同一批次下列两条，逐条配置并销号，再进入“字段公式”等下一批次。下列每行是应按需求展开的功能项示例，不代表只配置一张表单。
+
+##### 功能批次：关联浏览数据范围｜覆盖表单：<客户表、合同表>
+- [ ] 客户表 / 关联客户字段 | 条件：<规则> | 核验：可选记录
+- [ ] 合同表 / 关联项目字段 | 条件：<规则> | 核验：可选记录
+
+##### 功能批次：<从下列功能项选择一类>｜覆盖表单：<逐一列出>
+
+> 按需求复制此标题，每个标题只放同一功能的待办项，并把覆盖表单逐一展开；下列条目是可选的填写样式。
+- [ ] 关联字段及目标绑定 | 表单/字段：<名称> | 目标：<资源/ID> | 核验：选择范围
+- [ ] 关联浏览显示列 | 表单/字段：<名称> | 列：<字段及顺序> | 核验：弹窗显示
+- [ ] 二级明细关系 | 父表/子表：<名称> | 行标识：<字段> | 核验：逐父行归属
+- [ ] 字段多语言 | 表单/字段：<名称> | 中文/英文：<名称> | 核验：两种名称
+- [ ] 字段公式 | 表单/目标字段：<名称> | 表达式：<公式> | 核验：读回与样例值
+- [ ] 字段带出或函数联动 | 表单/规则：<名称> | 触发/来源/目标/表达式：<内容> | 核验：触发结果
+- [ ] 属性显隐联动 | 表单/规则：<名称> | 条件/目标/状态：<内容> | 核验：条件切换
+- [ ] 查重校验 | 表单/字段：<名称> | 行为：<提示/阻断> | 核验：重复样例
+- [ ] 编号规则 | 表单/字段：<名称> | 组成与位数：<内容> | 核验：生成值
+- [ ] 表单权限 | 表单/主体：<名称> | 新建/查看/编辑/删除范围：<内容> | 核验：授权结果
+- [ ] 表单页按钮 | 表单/页面/位置：<名称> | 目标与字段映射：<内容> | 核验：点击结果
+
+> 每个功能批次先核对覆盖表单清单，再逐表配置；同一表单有多条独立规则时继续拆行。建表时已配置并核验的分组、必填、只读、默认值等写在 2.1 的表单项结果中，不重复执行。
+
+#### 2.3 视图资源批次
+- [ ] 默认台账 <原名> 复用/改名为 <目标名> | 表单：<名称> | listId：待回填 | 核验：名称与类型
+- [ ] 新增视图 <名称> | 表单：<名称> | 类型/终端：<内容> | listId/viewId：待回填 | 核验：可打开且已填充
+
+#### 2.4 视图功能批次（一个功能项覆盖全部相关视图）
+
+> 沿用 2.2 的结构：`##### 功能批次：<功能名>｜覆盖视图：<视图A、视图B、...>`。例如“显示列”先列全部需配置的 PC/MOBILE 视图，每张视图及终端单独列项并完成；再处理搜索、排序等下一批次。以下为需要按需求展开的功能项示例。
+- [ ] 显示列 | 视图/终端：<名称/PC或MOBILE> | 字段/顺序/宽度：<内容> | 核验：列表显示
+- [ ] 列格式或单位 | 视图/字段：<名称> | 格式/单位：<内容> | 核验：展示值
+- [ ] 搜索与排序 | 视图：<名称> | 字段、入口与优先级：<内容> | 核验：查询及顺序
+- [ ] 筛选与顶部统计 | 视图：<名称> | 条件/函数：<内容> | 核验：记录及统计值
+- [ ] 普通分组或上下级 | 视图：<名称> | 分组/父级字段：<内容> | 核验：分组或层级
+- [ ] 视图权限 | 视图/主体：<名称> | 查看/操作范围：<内容> | 核验：权限读回
+- [ ] 行上或右上按钮 | 视图/位置：<名称> | 目标/当前行过滤/预填：<内容> | 核验：点击结果
+- [ ] 行点击或字段点击 | 视图/字段：<名称> | 打开目标和方式：<内容> | 核验：点击结果
+- [ ] 关联页签 | 表单/页签/目标视图：<名称> | 权限/布局/终端/筛选映射：<内容> | 核验：相关数据
+
+> 搜索、排序、筛选和统计若各有独立业务要求，分别建立功能批次和待办项。依赖第二阶段流程 ID 的按钮、流程关联字段等保留 `[ ]` 并注明依赖，在第二阶段回填后销号。第一阶段完成后请用户确认，再进入第二阶段。
+
+### 3. 第二阶段：流程与自动化
+
+#### 3.1 矩阵、权责表及流程资源
+- [ ] 矩阵 <名称> | 条件列/值列/行×列数据：<内容> | matrixId：待回填 | 核验：列、行和值
+- [ ] 流程 <名称> | EB/原生/公文，固定/自由，表单来源：<内容> | workflowId：待回填 | 核验：绑定表单
+- [ ] 本流程全部节点 | 节点名称、类型及顺序：<内容> | 核验：节点 ID 与清单一致
+- [ ] 本流程全部连线 | 源节点→目标节点、连线名称及默认出口：<内容> | 核验：完整拓扑
+- [ ] 本流程出口条件 <源节点→目标节点> | 字段来源、操作、值、AND/OR、明细量词：<内容> | 每条条件复制一项；核验：分支路由
+- [ ] 本流程节点操作者 <节点名> | 角色/矩阵/字段等来源及签署方式：<内容> | 每个节点复制一项；核验：人员范围
+- [ ] 本流程结构排版与核对 | 节点、连线、默认出口、条件及操作者：<内容> | 核验：流程图及配置读回
+- [ ] 权责表 <名称> | 随流程新建/独立复用 | authRespId：待回填 | 核验：场景与节点路径
+
+> 每个流程各复制一组“流程→节点→连线→条件→操作者→结构核对”，逐条流程完成核心流转；独立条件和操作者仍分别列项、分别销号。权责表流程的分支与经过节点按权责表指南在本流程下展开。实际配置按依赖进行，后续若有完整配置命令，可由同一组计划条目核对结果。
+
+#### 3.2 流程附加设置与功能批次
+- [ ] 节点字段权限或布局 | 流程/节点：<名称> | 字段/显示状态：<内容> | 核验：节点页面
+- [ ] 节点校验、退回、超时、菜单或其他行为 | 流程/节点：<名称> | 逐项写明：<内容> | 核验：配置读回
+- [ ] 流程编号、标题、提醒或流程级设置 | 流程：<名称> | 逐项写明：<内容> | 核验：配置读回
+- [ ] 公文专属设置 | 流程：<名称> | 按实际需求列出：<内容> | 核验：对应设置读回
+- [ ] 权责表场景/变量映射 | 权责表：<名称> | 场景条件、路径或变量→字段：<内容> | 核验：路径与映射
+- [ ] 动作流/节点字段赋值 | 触发流程/节点：<名称> | 目标、字段映射及定位：<内容> | 核验：绑定与结果
+- [ ] 回填第一阶段的流程依赖 | 表单字段/视图按钮：<名称> | workflowId/formId：<实际值> | 核验：选择或打开结果
+
+> 核心流转按 3.1 逐流程完成；本节的附加设置可按功能批次处理，但每条独立规则或动作流仍分别列项。第二阶段完成后请用户确认，再进入第三阶段。
+
+### 4. 第三阶段：报表、菜单与页面
+- [ ] 报表数据集 <名称> | 来源、字段、关联：<内容> | datasetId：待回填 | 核验：数据集字段
+- [ ] 报表 <名称> | 布局、查询及共享：<内容> | reportId：待回填 | 核验：展示与授权
+- [ ] 菜单 <名称> | 层级、目标资源及权限：<内容> | menuId：待回填 | 核验：入口与可见范围
+- [ ] 配置式或定制页面 <名称> | 终端、组件/交互、绑定资源：<内容> | pageId：待回填 | 核验：页面加载与业务结果
+
+### 5. 待确认、需补充及无法实现
+| 来源与原需求 | 状态 | 原因或缺失信息 | 影响与后续处理 |
+|---|---|---|---|
+| <章节及要求> | 待业务确认/待环境核查/需其他方式补充/已确认无法实现 | <内容> | <内容> |
+
+> 当前 CLI 暂不支持的配置项保持 `[ ]`，在此说明能力缺口及影响；不得用临时脚本、内部接口或浏览器操作代做，也不得以替代配置冒充完成。其他状态继续保留相应待办与依赖。
+
+### 6. 阶段验收与交付资源
+- 第一阶段：全部应建表单的字段、明细、布局和默认台账已核对；表单级与视图级需求逐项销号，后续流程依赖已标注。
+- 第二阶段：流程结构、关键条件、操作者及动作流已核对；第一阶段的流程依赖项已回填。
+- 第三阶段：报表、菜单和页面入口已核对；交付时列出应用→表单→视图、流程、矩阵、报表、页面的真实 ID 与未完成项。
+
+```
+
+## 使用边界
+
+- 资源清单负责保存“建什么、复用什么、谁依赖谁”，功能批次负责“具体配置什么”；两处用资源名称或实际 ID 对应，不重复创建同一资源。
+- 字段和布局蓝图仍逐表保存，防止按功能批次执行时遗失字段顺序、分组和表格空间结构。
+- 功能批次只规定同类操作的优先处理顺序。出现跨表循环、流程 ID、目标页面等依赖时，按真实依赖先建立资源，再回到相应条目完成配置。
+- 最小核验与业务风险相称；仅在用户要求时进行实际环境测试。计划销号仍以配置完成及必要的结果核对为准。

package/skill-docs/references/common/map.md

@@ -9,6 +9,15 @@
 3. 规划状态区分：**待业务确认**（语义或取值有歧义）、**待环境核查**（资源、权限或环境行为未证实）、**需其他方式补充**（现有 CLI 只能完成一部分）、**已确认无法实现**（核实无可行路径）。只有最后一种写入 plan 的“无法实现的项”，原需求项保持未完成。
 4. 按资源依赖组织 plan；关键配置写明读回点和最小业务验收点。接口保存、配置读回与页面实际生效是不同层次，按风险选择必要的检查。
 
+## 平台概念
+
+- **Ecode** — 存放和运行代码的平台；自定义页面在这里编码、构建、运行。
+- **Ebuilder 应用** — 独立概念，包含表单、流程等资源（与 Ecode 项目不同）。
+- **默认台账与菜单入口是两件事** — 表单创建后会生成默认台账/列表视图，但 `form create` 默认不加应用菜单；需要入口时用 `--menu`，或建表后 `menu add-table`。默认台账已存在不等于菜单入口已存在。
+- 只有图表仪表盘、跨表单聚合视图、特殊交互流程、对外公开页面等场景才需要自定义页面。
+- 所有系统交互命令均通过 `e10-cli` 执行（已全局 link）。auth 文件自动查找，也可 `--auth <path>` 指定。
+- 当前登录用户的 userId 是固定变量 `TEAMS.currentUser.id`，前端代码里可以直接使用。
+
 ## 一、资源地图：创建、复用或修改什么
 
 | 资源 | 使用场景与解决的问题 | 依赖与 plan 要点 | 能力边界与简要验收 | 详见 |