openyida 2026.7.7 → 2026.7.9

package/yida-skills/skills/yida-canvas-upgrade/references/migration-examples.md

@@ -0,0 +1,69 @@
+# Canvas 升级：转换模式示例与报告模板
+
+本文件承载 `yida-canvas-upgrade` 的完整代码示例与升级报告模板，SKILL.md 只保留步骤与链接。
+
+## 转换模式示例
+
+普通页面（native `.oyd.jsx`，`_customState` + `forceUpdate` + `renderJsx`）：
+
+```jsx
+var _customState = { count: 0 };
+
+export function add() {
+  _customState.count += 1;
+  this.forceUpdate();
+}
+
+export function renderJsx() {
+  var self = this;
+  return <button onClick={(e) => { self.add(); }}>{_customState.count}</button>;
+}
+```
+
+Code Canvas（真 React18 hooks，导出 `YidaComp`）：
+
+```jsx
+import React, { useState } from 'react';
+
+function YidaComp(props) {
+  var state = useState(0);
+  var count = state[0];
+  var setCount = state[1];
+
+  return (
+    <button onClick={() => { setCount(count + 1); }}>
+      {count}
+    </button>
+  );
+}
+
+export default YidaComp;
+```
+
+转换要点：
+- `_customState` 字段 → `useState`；复杂派生数据 → `useMemo`。
+- `didMount` / `didUnmount` → `useEffect(() => { ...; return cleanup; }, [])`。
+- `this.forceUpdate()` / `setCustomState` 强刷 → 删除，靠 hooks 自然重渲染。
+- `this.utils.yida.*` / `this.dataSourceMap.*` 无法照搬，抽成 props 调用或明确 TODO，不要假装可用（Canvas 无平台数据桥）。
+
+## 升级报告模板
+
+迁移完成或受阻时，输出简短报告：
+
+```markdown
+## Canvas Upgrade Report
+
+- Source page: project/pages/src/xxx.oyd.jsx
+- Target page: APP_XXX / FORM-XXX
+- Upgrade status: ready | blocked | partially-ready
+- Generated canvas source: project/pages/src/xxx.canvas.jsx
+- Required dependencies: react, antd, ...
+- Schema write path: designer | verified-api | not-available
+- Blockers:
+  - ...
+- Verification:
+  - [ ] YidaCodeCanvas exists in schema
+  - [ ] importedModules contains required dependencies
+  - [ ] first screen renders
+  - [ ] core interactions work
+```

package/yida-skills/skills/yida-chart/SKILL.md

@@ -60,8 +60,8 @@ openyida login --check-only --json
 # Step 2: 准备原生报表数据源
 # 无原生报表时先使用 yida-report 创建；已有 URL 时解析 appType/formUuid
 
-# Step 3: 获取报表 Schema，输出到文件避免终端截断
-openyida get-schema <appType> <reportFormUuid> > .cache/report-schema-output.txt 2>&1
+# Step 3: 获取报表 Schema；需要文件时用 CLI 输出目录或结构化文件写入工具保存 stdout
+openyida get-schema <appType> --all --keyword <报表名称> --output-dir .cache/openyida/<项目名或任务名>/schemas
 
 # Step 4: 解析 cid / className / dataSetKey / filterKey / cname
 

package/yida-skills/skills/yida-chart/references/echarts-bindding-guide.md

@@ -25,7 +25,7 @@ Step 1: 从 URL 中解析 appType 和 formUuid
 Step 2: 执行 openyida env 检测环境和登录态
     ↓
 Step 3: 执行 openyida get-schema <appType> <formUuid> 获取现有报表 Schema
-    ↓  命令：openyida get-schema <appType> <formUuid> > .cache/report-schema-output.txt 2>&1
+    ↓  需要文件时，使用结构化文件写入工具保存 stdout，或用 --all --keyword --output-dir 输出到 project .cache
     ↓
 Step 4: 解析 Schema，提取每个图表组件的 5 个核心参数
     ↓  详见下方「Schema 解析规范」
@@ -58,15 +58,14 @@ Step 11: 输出 ECharts 自定义页面访问链接
 
 ## Schema 获取注意事项
 
-1. **必须将输出重定向到文件**：报表 Schema 通常非常大（数千行），终端输出会被截断
+1. **不要用 shell 重定向保存 Schema**：报表 Schema 通常非常大（数千行），需要文件时用 CLI 自带输出目录或 agent 结构化文件写入工具
    ```bash
-   openyida get-schema <appType> <formUuid> > .cache/report-schema-output.txt 2>&1
+   openyida get-schema <appType> --all --keyword <报表名称> --output-dir .cache/openyida/<项目名或任务名>/schemas
    ```
 
-2. **提取 JSON 部分**：输出文件包含前缀日志信息，需要从 `{` 开始的行提取纯 JSON
+2. **单表回读时保存 stdout**：如必须按 `formUuid` 回读，先执行命令，再用 create_file / Write / file edit tool 保存纯 JSON 到 `<projectRoot>/.cache/openyida/<项目名或任务名>/report-schema.json`
    ```bash
-   grep -n "^{" .cache/report-schema-output.txt
-   tail -n +<行号> .cache/report-schema-output.txt > .cache/report-schema.json
+   openyida get-schema <appType> <formUuid> --json
    ```
 
 ---

package/yida-skills/skills/yida-chart/references/examples.md

@@ -15,8 +15,8 @@ https://www.aliwork.com/APP_KNILKT41DC5XXR5D4QEC/admin/REPORT-QA666SC1J3U3TFO9GM
 # Step 1：检测环境和登录态
 openyida env
 
-# Step 2：获取报表 Schema（必须重定向到文件，避免截断）
-openyida get-schema APP_KNILKT41DC5XXR5D4QEC REPORT-QA666SC1J3U3TFO9GM9MJ5400RIW3W83SUYMM5 > .cache/report-schema-output.txt 2>&1
+# Step 2：获取报表 Schema；需要文件时用结构化文件写入工具保存 stdout
+openyida get-schema APP_KNILKT41DC5XXR5D4QEC REPORT-QA666SC1J3U3TFO9GM9MJ5400RIW3W83SUYMM5 --json
 
 # Step 3：创建自定义展示页面
 openyida create-page APP_KNILKT41DC5XXR5D4QEC "任务数据看板" --mode dashboard

package/yida-skills/skills/yida-connector/SKILL.md

@@ -10,11 +10,13 @@ description: 宜搭 HTTP 连接器创建与管理。打通钉钉/自建系统/
 - 不要在代码中硬编码 API Key、密码等凭证，通过连接器鉴权配置管理
 - 不要编造 connector-id 或 action-id，必须从命令返回中提取
 - 不要删除连接器前确认是否有表单/页面正在使用
+- 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成连接器 action/config JSON
 
 ## 严格要求 (MUST DO)
 
 - 优先使用 `smart-create` 从 curl 命令或接口文档智能创建
 - 创建连接器后，将 connector-id 记录到 `.cache/<项目名>-schema.json`
+- `--operations`、`--action` 等文件参数必须先用结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/connector/` 或该技能更具体的目录，再传给命令；不要写仓库根目录或系统临时目录
 - **本技能不读写 memory**：连接器配置通过 CLI 命令写入宜搭平台，不依赖跨会话的 memory 状态
 
 ## 适用场景
@@ -107,6 +109,8 @@ openyida connector delete-action <connector-id> <action-id>
 openyida connector test --connector-id <id> --action <action-file>
 ```
 
+> `<action-file>` 先用 create_file / Write / file edit tool 创建，例如 `.cache/openyida/<项目名或任务名>/connector/actions.json`；从 workspace 根执行命令时路径加 `project/` 前缀。
+
 ### 鉴权账号管理
 
 ```bash

package/yida-skills/skills/yida-connector-safe-actions/SKILL.md

@@ -26,6 +26,7 @@ description: 从前端 API 文件或后端 Controller 代码中提取接口定
 - Windows PowerShell 读取中文 JSON 时必须显式使用 UTF-8。
 - 修改后必须执行“添加动作 -> 列表验证 -> CLI 测试 -> 再次列表验证”的闭环。
 - 如果一次错误配置导致动作被清空，应重建完整动作列表，而不是只追加缺失动作。
+- 动作 JSON 必须使用当前 agent 的结构化文件写入工具创建；不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向写文件。
 
 ## 推荐流程
 
@@ -51,12 +52,14 @@ openyida connector list-actions <connector-id>
 
 ### 3. 生成动作 JSON 文件
 
-建议放在当前项目：
+建议放在 OpenYida project 工作目录的任务子目录：
 
 ```text
-.cache/openyida/connector-actions/<业务名>-actions.json
+<projectRoot>/.cache/openyida/<项目名或任务名>/connector-actions/<业务名>-actions.json
 ```
 
+从 workspace 根执行命令时传 `project/.cache/openyida/<项目名或任务名>/connector-actions/<业务名>-actions.json`；从 project 工作目录内执行时传 `.cache/openyida/<项目名或任务名>/connector-actions/<业务名>-actions.json`。
+
 动作 ID 建议使用顺序编号：
 
 ```json
@@ -74,7 +77,7 @@ openyida connector list-actions <connector-id>
 Windows PowerShell 必须加 `-Encoding UTF8`：
 
 ```powershell
-Get-Content -Raw -Encoding UTF8 .cache\openyida\connector-actions\<业务名>-actions.json | ConvertFrom-Json | Out-Null
+Get-Content -Raw -Encoding UTF8 .cache\openyida\<项目名或任务名>\connector-actions\<业务名>-actions.json | ConvertFrom-Json | Out-Null
 ```
 
 不要使用默认 `Get-Content` 校验中文 JSON，默认编码可能导致误判或乱码。
@@ -82,7 +85,7 @@ Get-Content -Raw -Encoding UTF8 .cache\openyida\connector-actions\<业务名>-ac
 ### 5. 添加动作
 
 ```bash
-openyida connector add-action --operations .cache/openyida/connector-actions/<业务名>-actions.json --connector-id <connector-id> --confirm
+openyida connector add-action --operations .cache/openyida/<项目名或任务名>/connector-actions/<业务名>-actions.json --connector-id <connector-id> --confirm
 ```
 
 ### 6. 验证动作存在

package/yida-skills/skills/yida-create-form-page/SKILL.md

@@ -10,12 +10,13 @@ description: 表单页面创建与更新，支持 19 种字段类型（文本、
 - 不要编造 formUuid，必须从命令返回的 JSON 中提取
 - 不要在 update 模式中使用猜测的 fieldId，必须先用 `yida-get-schema` 获取
 - 不要用此命令操作数据记录（增删改查），应使用 `yida-data-management`
+- 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成字段、变更、补丁、规则、数据源 JSON 文件
 
 ## 严格要求 (MUST DO)
 
 - create 成功后，将 formUuid 记录到 `.cache/<项目名>-schema.json`
 - update 模式修改字段前，必须先用 `openyida get-schema` 确认字段 ID
-- 字段定义或变更定义需要落盘时，必须写入 `.cache/openyida/<项目名>/`，例如 `.cache/openyida/pm/pm-fields-team.json`；不要在仓库根目录生成 `*-fields*.json` 或 `*-changes*.json`
+- 字段定义或变更定义需要落盘时，必须使用 agent 的结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/`，例如 `<projectRoot>/.cache/openyida/pm/pm-fields-team.json`；不要在仓库根目录、系统临时目录或 `.cache/` 顶层生成 `*-fields*.json`、`*-changes*.json`
 - **本技能不读写 memory**：formUuid 等信息输出到 stdout，通过 `.cache/<项目名>-schema.json` 持久化，不依赖跨会话的 memory 状态
 
 ## 官方表单示例范式
@@ -54,9 +55,11 @@ description: 表单页面创建与更新，支持 19 种字段类型（文本、
 
 ```bash
 openyida create-form create <appType> <formTitle> <fieldsJsonOrFile> [--layout double|card] [--theme compact|comfortable] [--label-align top|left]
-# 文件路径示例：.cache/openyida/<项目名>/<表单名>-fields.json
+# 文件路径示例：.cache/openyida/<项目名或任务名>/<表单名>-fields.json
 ```
 
+> 文件先用 create_file / Write / file edit tool 创建。上方路径默认从 OpenYida project 工作目录执行；如果从 workspace 根执行命令，传 `project/.cache/openyida/<项目名或任务名>/<表单名>-fields.json`。
+
 | 参数 | 必填 | 说明 |
 |------|------|------|
 | `appType` | 是 | 应用 ID |
@@ -73,7 +76,7 @@ openyida create-form create <appType> <formTitle> <fieldsJsonOrFile> [--layout d
 
 ```bash
 openyida create-form update <appType> <formUuid> <changesJsonOrFile>
-# 文件路径示例：.cache/openyida/<项目名>/<表单名>-changes.json
+# 文件路径示例：.cache/openyida/<项目名或任务名>/<表单名>-changes.json
 ```
 
 | 参数 | 必填 | 说明 |
@@ -94,7 +97,7 @@ openyida create-form update <appType> <formUuid> <changesJsonOrFile>
 
 ```bash
 openyida create-form patch <appType> <formUuid> <patchJsonOrFile>
-# 文件路径示例：.cache/openyida/<项目名>/<表单名>-patch.json
+# 文件路径示例：.cache/openyida/<项目名或任务名>/<表单名>-patch.json
 ```
 
 支持的操作：
@@ -121,7 +124,7 @@ openyida create-form patch <appType> <formUuid> <patchJsonOrFile>
 ]
 ```
 
-patch 模式是高级能力：执行前必须先 `openyida get-schema <appType> <formUuid> --json` 确认现有结构，补丁文件必须写在 `.cache/openyida/<项目名>/` 下。
+patch 模式是高级能力：执行前必须先 `openyida get-schema <appType> <formUuid> --json` 确认现有结构，补丁文件必须用结构化文件写入工具写在 `<projectRoot>/.cache/openyida/<项目名或任务名>/` 下。
 
 ### 自定义校验函数（customValidate）
 
@@ -197,7 +200,7 @@ patch 模式是高级能力：执行前必须先 `openyida get-schema <appType>
 
 ```bash
 openyida create-form rule <appType> <formUuid> <rulesJsonOrFile>
-# 文件路径示例：.cache/openyida/<项目名>/<表单名>-rules.json
+# 文件路径示例：.cache/openyida/<项目名或任务名>/<表单名>-rules.json
 ```
 
 支持的规则类型：
@@ -255,7 +258,7 @@ rule 模式会自动生成宜搭动作代码，绑定触发字段的 `onChange`
 
 ```bash
 openyida create-form bind-datasource <appType> <formUuid> <fieldLabelOrId> <dataSourceJsonOrFile>
-# 文件路径示例：.cache/openyida/<项目名>/<字段名>-datasource.json
+# 文件路径示例：.cache/openyida/<项目名或任务名>/<字段名>-datasource.json
 ```
 
 数据源配置示例：
@@ -380,7 +383,7 @@ openyida create-form bind-datasource <appType> <formUuid> <fieldLabelOrId> <data
 
 ## 注意事项
 
-- 临时文件写在 `.cache/openyida/` 目录中；不要写到仓库根目录
+- 临时 JSON 文件用结构化文件写入工具写在 `<projectRoot>/.cache/openyida/<项目名或任务名>/` 目录中；不要写到仓库根目录、系统临时目录或 `.cache/` 顶层
 - update 模式操作按顺序执行，注意依赖关系
 - 字段匹配基于中文标签（`label.zh_CN`）
 - 如需创建自定义展示页面（无字段），请使用 `yida-create-page`

package/yida-skills/skills/yida-create-process/SKILL.md

@@ -8,6 +8,7 @@ description: 流程表单一体化创建（创建表单 → 转流程 → 获取
 
 - 不要编造 processCode，必须从命令返回的 JSON 中提取
 - 不要在流程定义中使用猜测的 fieldId，必须先用 `yida-get-schema` 获取
+- 不要用 shell heredoc、`cat`/`echo`/`printf`/`tee` 或重定向生成字段定义、流程定义 JSON 文件
 
 ## 严格要求 (MUST DO)
 
@@ -15,7 +16,7 @@ description: 流程表单一体化创建（创建表单 → 转流程 → 获取
 - 优先使用用法 2（先创建表单获取字段 ID，再 `--formUuid` 转流程）
 - 创建成功后，将 formUuid 和 processCode 记录到 `.cache/<项目名>-schema.json`
 - 流程定义中字段 ≥ 3 且审批节点 ≥ 2 时，必须自动配置字段权限
-- 字段定义和流程定义文件必须写入 `.cache/openyida/<项目名>/`，不要在仓库根目录生成 `fields.json`、`process-definition.json` 等临时文件
+- 字段定义和流程定义文件必须用 agent 的结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/`；不要在仓库根目录、系统临时目录或 `.cache/` 顶层生成 `fields.json`、`process-definition.json` 等临时文件
 - **本技能不读写 memory**：formUuid 和 processCode 输出到 stdout，通过 `.cache/<项目名>-schema.json` 持久化，不依赖跨会话的 memory 状态
 
 ## 适用场景
@@ -66,11 +67,16 @@ openyida create-process <appType> --formUuid <formUuid> <processDefinitionFile>
 
 ## 推荐两步流程
 
+1. 使用 create_file / Write / file edit tool 创建字段定义：
+   `<projectRoot>/.cache/openyida/order/order-fields.json`
+2. 执行表单创建命令，获取真实 `formUuid` 和 `fieldId`。
+3. 使用结构化文件写入工具创建流程定义：
+   `<projectRoot>/.cache/openyida/order/process-definition.json`
+4. 执行流程转换命令。
+
 ```bash
-# Step 1: 创建表单获取字段 ID
+# 以下命令默认在 OpenYida project 工作目录内执行；从 workspace 根执行时路径加 project/ 前缀。
 openyida create-form create "APP_XXX" "订单处理表" .cache/openyida/order/order-fields.json
-
-# Step 2: 将已有表单转为流程表单
 openyida create-process "APP_XXX" --formUuid "FORM-YYY" .cache/openyida/order/process-definition.json
 ```
 

package/yida-skills/skills/yida-custom-page/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: yida-custom-page
-description: 宜搭自定义页面 JSX 开发规范。React 16 宜搭原生 export function 页面模式，宜搭 JS API 调用，状态管理与编码约束。适用于编写自定义页面代码时。
+description: 宜搭 native 自定义页面 JSX 开发规范（React 16 宜搭原生 export function renderJsx 模式、宜搭 JS API、状态管理与编码约束）。是**回退链路**：仅当页面强依赖原生实例数据桥（this.$(fieldId) 表单字段双向绑定、this.utils.yida.*、dataSourceMap、提交流程深度耦合）时才用；纯展示无刷新页也可用。其余自定义页面（含只需开放 API HTTP 读数据的页）默认走 yida-canvas-custom-page。
 ---
 
 # 自定义页面开发
 
+> **先确认链路**：自定义页面**默认走 Code Canvas** `yida-canvas-custom-page`（现代 React 交互 / hooks / 可视化 / AI / 需崩溃隔离，含只需开放 API HTTP 读数据的页）。本 native 技能是**回退链路**，只处理：① 强依赖原生实例数据桥——表单内字段双向绑定 `this.$(fieldId)`、`this.utils.yida.*`、`dataSourceMap`、提交流程深度耦合——的页面（Canvas 无 `this` 桥，重写代价过高时留 native）；② 纯展示、无运行态刷新页。把已有 native 页升级到 Canvas 走 `yida-canvas-upgrade`。
+
 ## 核心规则
 
 ### 致命规则（FATAL）
@@ -30,6 +32,7 @@ description: 宜搭自定义页面 JSX 开发规范。React 16 宜搭原生 expo
 
 影响代码质量和用户体验：
 
+0. **写 UI 前先定视觉方向**：面向用户的页面在动手写 JSX 前，先读 `skills/yida-page-uiux/SKILL.md` 完成「视觉方向决策」（页面类型判定 + 差异化 + 去 AI 味自检），拿到「视觉方向决策块」后再按本技能 `references/design-system.md` 的 token/组件实现；不要直接套用统一灰白底 + 8px 圆角卡片网格的默认模板（那正是 AI 味来源）。
 1. **代码生成前确认功能摘要**：详见 [编码指南 编注 0](references/coding-guide.md)
 2. **pageSize 推荐 50，最大 100**：列表/看板默认 `pageSize: 50`；分页接口 `searchFormDatas` 等的 `pageSize` 最大 100
 3. **didUnmount 清理定时器**：在 `didUnmount` 中清理所有 `setInterval`/`setTimeout`，防止内存泄漏
@@ -42,7 +45,8 @@ description: 宜搭自定义页面 JSX 开发规范。React 16 宜搭原生 expo
 10. **Tabs 显隐控制**：下拉值变更后自动回退到第一个可见 Tab，内容区用 `display: none` 保留 DOM
 11. **加载态必须可恢复**：列表/看板页默认保留空态或演示数据；接口失败、超时或返回异常时必须把 `loading` 置回 `false`，不要只渲染“正在加载...”挡住整页
 12. **禁止可见原生下拉**：筛选、预约、审批等用户可见下拉交互不要使用 `<select>`；使用 Tailwind className 组合 `button + menu + option` 的自定义下拉组件
-13. **发布前必须跑检查链路**：先执行 `openyida check-page <file>` 和 `openyida compile <file>`；若出现 warning/error，按规则修复后再发布
+13. **严禁 emoji**：页面渲染出来的任何位置（标题、按钮、标签、状态、空态文案、图表标题等）**一律禁止出现 emoji**（😀🚀✅⚠️📦📊 等一切彩色符号字符）。需要图标一律用功能性内联 SVG（见 `skills/yida-page-uiux` 图标策略）；需要状态标记用文字 + 语义色标签。emoji 是最明显的 AI 味来源之一，且跨端显示不一致。JS 注释里也不要留装饰性符号。
+14. **发布前必须跑检查链路**：先执行 `openyida check-page <file>` 和 `openyida compile <file>`；若出现 warning/error，按规则修复后再发布
 
 > 每条规则的代码示例、反模式和常见错误见 [编码指南](references/coding-guide.md)（编写代码前强制必读）。
 > 运行时易错点、`check-page` 规则和兼容层自动修复边界见 [运行时护栏](references/runtime-guardrails.md)。
@@ -69,10 +73,15 @@ description: 宜搭自定义页面 JSX 开发规范。React 16 宜搭原生 expo
 
 以创建「员工信息查询页」为例，完整流程如下：
 
+1. 获取表单 Schema，确认字段 ID：
+
 ```bash
-# Step 1：获取表单 Schema，确认字段 ID
-openyida get-schema APP_XXX FORM-EMPLOYEE > .cache/employee-schema.json 2>&1
+openyida get-schema APP_XXX FORM-EMPLOYEE
+```
 
+如需保存完整 Schema，使用 create_file / Write / file edit tool 创建 `<projectRoot>/.cache/openyida/employee-query/employee-schema.json`；ID 映射仍写 `<projectRoot>/.cache/employee-query-schema.json`。
+
+```bash
 # Step 2：创建自定义页面
 openyida create-page APP_XXX "员工信息查询"
 
@@ -92,7 +101,7 @@ openyida publish project/pages/src/employee-query.oyd.jsx APP_XXX FORM-QUERY001
 - **Step 1** 的 get-schema 输出包含所有字段的 fieldId，在代码中必须使用 `FIELDS` 常量映射这些 ID
 - **Step 3** 的页面代码必须遵循 [编码指南](references/coding-guide.md) 和 [运行时护栏](references/runtime-guardrails.md)
 - 优先通过 `openyida generate-page ... --compile` 生成高质量骨架；需要完整交互样板时使用 `todo-mvc`
-- 页面生成 spec、接口调试 JSON、一次性验证脚本等临时工件必须放在 `.cache/openyida/` 下；不要在仓库根目录生成 `page.json`、`data.json` 或脚本文件
+- 页面生成 spec、接口调试 JSON、一次性验证脚本等临时工件必须用结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/` 下；不要在仓库根目录、系统临时目录或 `.cache/` 顶层生成 `page.json`、`data.json` 或脚本文件
 - `check-page` 支持行级禁用：`// openyida-lint-disable-line <rule>` 或 `// openyida-lint-disable-next-line <rule>`。只在确认该行不会触发宜搭运行时问题时使用。
 
 ## 开发规范
@@ -111,12 +120,13 @@ openyida sample yida-custom-page custom-page-template   # 完整页面模板（d
 openyida sample yida-custom-page product-homepage       # 产品/项目首页轻量模板（支持 --var KEY=VALUE）
 openyida sample yida-custom-page todo-mvc               # TodoMVC 完整交互模板（事件/状态/循环/本地存储）
 openyida sample yida-custom-page design-tokens          # 设计 token 参考（颜色/间距/字体规范）
-openyida generate-page product-homepage --spec .cache/openyida/page-specs/home.json --output pages/src/home.oyd.jsx --compile  # 基于 spec/blocks 生成首页并本地编译
+openyida generate-page product-homepage --spec .cache/openyida/<项目名或任务名>/page-specs/home.json --output pages/src/home.oyd.jsx --compile  # 基于 spec/blocks 生成首页并本地编译
 openyida generate-page todo-mvc --output pages/src/todo-mvc.oyd.jsx --compile  # 生成官方 TodoMVC 风格交互样板
 openyida check-page pages/src/home.oyd.jsx --json      # 输出机器可读的规范检查结果；.oyd.jsx 会先兼容构建
 ```
 
 - 完整文件结构、状态管理、全局变量、19 条编码规则见 [编码指南](references/coding-guide.md)
+- `--spec` 文件先用 create_file / Write / file edit tool 创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/page-specs/`
 - 运行时高风险规则、`check-page` 规则和自动修复边界见 [运行时护栏](references/runtime-guardrails.md)
 - 输入控件、筛选栏、下拉、表格、附件等组件骨架见 [组件指南](references/component-jsx-guide.md)
 
@@ -166,6 +176,7 @@ openyida check-page pages/src/home.oyd.jsx --json      # 输出机器可读的
 | 文档 | 覆盖范围 | 何时阅读 |
 |------|---------|---------|
 | **本技能文档** | | |
+| [视觉方向决策（去 AI 味）](../yida-page-uiux/SKILL.md) | 页面类型 playbook、5 维差异化引擎、去 AI 味黑名单/8 问自检、图标策略 | 实现面向用户的 UI 且要求好看/去 AI 味时，**先于写代码**阅读并产出决策块 |
 | [编码指南](references/coding-guide.md) | 文件结构模板、状态管理、生命周期、19 条编码规范 | 编写任何页面代码前必读 |
 | [运行时护栏](references/runtime-guardrails.md) | pageSize、loading 恢复、ECharts DOM 时序、setState 约束、check-page 规则映射 | 编写列表、看板、图表或接口页面前必读 |
 | [设计规范](references/design-system.md) | 色彩/圆角/字体/间距系统、7 类组件样式模板、8 条反模式 | 实现 UI 样式时必读 |

package/yida-skills/skills/yida-custom-page/examples/attachment-upload.js

@@ -168,7 +168,7 @@ var styles = {
     height: '36px',
     padding: '0 12px',
     borderRadius: '8px',
-    background: '#1677FF',
+    background: 'var(--color-brand1-6, #1677FF)',
     color: '#fff',
     border: 'none',
     fontSize: '12px',

package/yida-skills/skills/yida-custom-page/references/coding-guide.md

@@ -83,7 +83,7 @@ export function injectTailwindSource() {
     '@import "tailwindcss/theme";',
     '@import "tailwindcss/preflight";',
     '@import "tailwindcss/utilities";',
-    '@theme { --color-brand: #2F6FED; }',
+    '@theme { --color-brand: var(--color-brand1-6, #2F6FED); }',  // 跟随 App 主题，缺失时兜底
   ].join('\n');
   document.head.appendChild(style);
 }
@@ -98,11 +98,11 @@ export function injectTailwindFallback() {
   style.innerHTML = [
     '.oyd-btn,.oyd-select-trigger,.oyd-select-option{appearance:none;-webkit-appearance:none;font-family:inherit;}',
     '.oyd-btn{height:36px;border-radius:6px;border:1px solid #D0D5DD;background:#fff;padding:0 12px;font-size:14px;cursor:pointer;}',
-    '.oyd-btn-primary{background:#2F6FED;border-color:#2F6FED;color:#fff;}',
+    '.oyd-btn-primary{background:var(--color-brand1-6,#2F6FED);border-color:var(--color-brand1-6,#2F6FED);color:#fff;}',
     '.oyd-select-trigger{height:38px;border-radius:6px;border:1px solid #D0D5DD;background:#fff;padding:0 12px;font-size:14px;text-align:left;box-shadow:0 6px 14px rgba(15,23,42,.06);}',
     '.oyd-select-menu{position:absolute;z-index:30;margin-top:6px;width:100%;padding:6px;border:1px solid #E4E7EC;border-radius:10px;background:#fff;box-shadow:0 16px 32px rgba(16,24,40,.14);}',
     '.oyd-select-option{width:100%;min-height:36px;border:0;border-radius:8px;background:#fff;padding:0 10px;text-align:left;font-size:14px;cursor:pointer;}',
-    '.oyd-select-option-active{background:#EFF6FF;color:#1D4ED8;font-weight:600;}',
+    '.oyd-select-option-active{background:var(--color-brand1-1,#EFF6FF);color:var(--color-brand1-6,#1D4ED8);font-weight:600;}',
   ].join('');
   document.head.appendChild(style);
 }

package/yida-skills/skills/yida-custom-page/references/component-jsx-guide.md

@@ -5,6 +5,7 @@
 ## 先说清楚边界
 
 - 不要假设自定义页面能直接 `import` 宜搭内部表单组件；当前规范下应使用原生 JSX 元素、Tailwind `className` 和必要的内联兜底样式组合。
+- Code Canvas 是自定义页面的默认链路（现代 React/hooks/可视化/AI）；本 native 指南只服务纯展示无刷新页和需数据桥的数据驱动页。用户要现代交互页，或提到代码画布、`YidaCodeCanvas`、`runtimeCode`、`importedModules` 时，切换到 `yida-canvas-custom-page`。
 - 不要把字段中文名当作 `fieldId`；字段 ID 必须来自 `openyida get-schema`。
 - 不要把原生表单页面的组件配置 JSON 直接复制到自定义页面 JSX；两者不是同一个运行面。
 - 如果确有平台内置选择器、上传器等 API，必须先由用户提供官方示例或在目标环境验证，再写入代码。
@@ -200,10 +201,10 @@ var styles = {
     minHeight: 36,
     padding: '8px 12px',
     textAlign: 'left',
-    background: '#EFF6FF',
+    background: 'var(--color-brand1-1, #EFF6FF)',
     border: 0,
     borderRadius: 8,
-    color: '#1D4ED8',
+    color: 'var(--color-brand1-6, #1D4ED8)',
     appearance: 'none',
     WebkitAppearance: 'none',
     fontFamily: 'inherit',
@@ -399,5 +400,7 @@ openyida compile pages/src/page.jsx
 如果页面使用字段 ID、提交数据或构造查询条件，发布前还必须重新确认 Schema：
 
 ```bash
-openyida get-schema APP_XXX FORM-XXX > .cache/form-schema.json
+openyida get-schema APP_XXX FORM-XXX
 ```
+
+如需保存完整 Schema，使用 create_file / Write / file edit tool 创建 `<projectRoot>/.cache/openyida/<项目名或任务名>/form-schema.json`；不要使用 shell 重定向。

package/yida-skills/skills/yida-custom-page/references/design-system.md

@@ -1,5 +1,7 @@
 # 宜搭自定义页面设计规范
 
+> **本文件是 token / 组件实现层（数值层）**：提供色彩/圆角/字体/间距的具体值与组件模板。视觉**方向与差异化**（选哪种气质、如何偏离默认脸、去 AI 味）由 `../../yida-page-uiux/SKILL.md` 决定——**先定方向、再用本文件落地**。直接套用本文件的默认组合（灰白底 + 统一圆角卡片）而不先做方向决策，正是页面「有 AI 味」的根因。
+
 > 宜搭自定义页面默认使用 Tailwind utility `className` 组织视觉层，并保留内联 `style` 兜底。不能使用 CSS 文件、CSS Modules、shadcn/ui 或构建期样式方案。
 
 > 原因：宜搭自定义页面运行在单文件环境中，不能像普通 React 项目一样 `import` CSS。Tailwind 通过 `@tailwindcss/browser` 运行时脚本加载，默认使用已验证的 `g.alicdn.com` 地址，并开启 preflight 重置原生控件外观；关键控件仍要有 JavaScript `style` 兜底。
@@ -22,27 +24,33 @@
 
 在 `renderJsx` 顶部定义语义色彩对象，全页复用：
 
-> **主色说明**：宜搭平台已内置品牌色 CSS 变量，主色相关 token 直接使用平台变量，无需硬编码色值，可随平台主题自动适配。
+> **主色说明**：宜搭平台已内置品牌色 CSS 变量（色阶 `--color-brand1-1` 最浅 → `--color-brand1-6` 主色 → `--color-brand1-10` 最深）。**所有主色/强调/链接/选中/info/标签系一律走平台变量，不要硬编码蓝色**，页面才能跟随 App 主题自动适配。只有语义色（成功/警告/错误）固定不随主题变，保证语义稳定。
+>
+> **前提是导航可见**：跟随品牌主色是为了跟应用框架融合。若页面隐藏了应用导航（`isRenderNav=false`，沉浸/独立/门户/大屏），主色相可自立、不必严格跟品牌（由 `yida-page-uiux` 的 Step 0 决策）——但**语义色仍固定、去 AI 味红线仍生效**。拿不准就按「跟随品牌」这个更安全的默认走。
+>
+> ⚠️ **常见错误**：把 `primaryHover` 设成 `brand1-1`（最浅档）会让填充主按钮 hover 时「泛白」；把 `hover` 设成 `brand1-9`（深档）当行 hover 底会让行「变暗」。填充按钮 hover 要比主色**亮一档**（`brand1-5`）、按下**深一档**（`brand1-7`）；通用浅色 hover 底用 `brand1-1`。
 
 ```javascript
 export function renderJsx() {
   var colors = {
-    primary:      'var(--color-brand1-6)',  // 主色（品牌蓝），用于主操作按钮、链接、选中态高亮
-    primaryHover: 'var(--color-brand1-1)',  // 主色悬停态，鼠标 hover 时的按钮/链接颜色
-    hover:        'var(--color-brand1-9)',  // 通用悬停背景色，用于列表行 hover、菜单项 hover
-    active:       'var(--color-brand1-9)',  // 通用激活/按下态，点击时的视觉反馈
-    disabled:     'var(--color-brand1-8)',  // 禁用态颜色，用于不可操作的按钮、控件
-    primaryLight: 'var(--color-brand1-2)',  // 主色浅背景，用于选中行底色、标签高亮背景
-
-    // 语义色
+    primary:       'var(--color-brand1-6)',  // 主色，用于主操作按钮、链接、选中态高亮
+    primaryHover:  'var(--color-brand1-5)',  // 主色 hover：填充按钮/链接 hover，比主色亮一档
+    primaryActive: 'var(--color-brand1-7)',  // 主色按下：填充按钮 active，比主色深一档
+    hover:         'var(--color-brand1-1)',  // 通用浅色 hover 底：列表行 hover、菜单项 hover
+    active:        'var(--color-brand1-2)',  // 通用浅色激活/按下底
+    disabled:      'var(--color-brand1-3)',  // 禁用态：浅、去饱和
+    primaryLight:  'var(--color-brand1-2)',  // 主色浅背景：选中行底色、标签高亮背景
+
+    // 语义色（固定，不随主题变）
     success:        '#52C41A',
     successLight:   '#F6FFED',
     warning:        '#FAAD14',
     warningLight:   '#FFFBE6',
     error:          '#FF4D4F',
     errorLight:     '#FFF2F0',
-    info:           '#1677FF',
-    infoLight:      '#E6F4FF',
+    // info = 品牌信息色，跟随主题（不再固定蓝）
+    info:           'var(--color-brand1-6)',
+    infoLight:      'var(--color-brand1-1)',
 
     // 中性色（从深到浅）
     text:           '#1D2129',  // 主文字
@@ -176,7 +184,7 @@ btnPrimary: {
   justifyContent: 'center',
   padding: '0 16px',
   height: '32px',
-  background: '#1677FF',
+  background: 'var(--color-brand1-6)',  // 主色跟随 App 主题，勿硬编码蓝
   color: '#FFFFFF',
   border: 'none',
   borderRadius: '6px',
@@ -238,7 +246,7 @@ tag: function(type) {
     success: { color: '#52C41A', bg: '#F6FFED', border: '#B7EB8F' },
     warning: { color: '#FAAD14', bg: '#FFFBE6', border: '#FFE58F' },
     error:   { color: '#FF4D4F', bg: '#FFF2F0', border: '#FFCCC7' },
-    info:    { color: '#1677FF', bg: '#E6F4FF', border: '#91CAFF' },
+    info:    { color: 'var(--color-brand1-6)', bg: 'var(--color-brand1-1)', border: 'var(--color-brand1-3)' },
     default: { color: '#4E5969', bg: '#F2F3F5', border: '#E5E6EB' },
   };
   var c = colorMap[type] || colorMap.default;
@@ -305,3 +313,12 @@ empty: {
 ❌ **禁止忽略空状态**，列表/数据为空时必须有友好提示
 ❌ **禁止忽略加载状态**，异步操作必须有 loading 反馈
 ❌ **禁止移动端不适配**，所有页面必须用 `isMobile` 做响应式处理
+
+### 去 AI 味反模式（与 `../../yida-page-uiux/` 对齐，实现前先定视觉方向）
+
+❌ **禁蓝紫 AI 万能渐变背景**：不要用 `#6366f1→#a855f7` 一类蓝紫渐变当区块/卡片底；主色走平台品牌变量，强调靠语义色/点缀色而非渐变。
+❌ **禁彩色发光阴影 / 半透明彩色 blob / 渐变文字**：阴影用中性色低透明度（如 `rgba(0,0,0,.06)`），不要彩色光晕；不要背景漂浮彩色模糊球，不要文字渐变。
+❌ **禁每个卡片/章节标题前配一枚装饰线性图标**：这是最典型的 AI 味。图标只用在功能处（按钮/状态/导航），标题纯文字；同页只用一套图标风格。
+❌ **严禁 emoji（FATAL）**：页面渲染的任何位置（标题/按钮/标签/状态/空态/图表标题）一律不得出现 emoji（😀🚀✅⚠️📦📊 等），JS 注释也不留装饰符号（←→✓）。需要图标用功能性内联 SVG，需要状态用文字 + 语义色标签。emoji 跨端不一致且是最明显的 AI 味来源。
+
+> 注：上文「统一 `borderRadius: 8px`」是数值兜底，不代表全页只能一个圆角性格。圆角**性格**（直角/微圆 vs 标准圆 vs 圆润）由 `yida-page-uiux` 按气质选定后，再在本文件圆角系统里取分层数值。