openyida 2026.7.19 → 2026.7.21

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

@@ -7,6 +7,16 @@ description: 宜搭普通自定义页面 JSX / Jsx 组件开发规范（React 16
 
 > **先确认链路**：普通自定义页面 JSX/Jsx 组件链路走本技能，发布后落到平台 `Jsx` 组件；Code Canvas 链路走 `yida-canvas-custom-page`，发布后落到 `YidaCodeCanvas` 组件。两者是并列页面实现链路，不要把本技能描述成 Code Canvas 的备用链路。已有普通自定义页面升级到 Code Canvas 时才走 `yida-canvas-upgrade`。
 
+## Resource-First 页面开发
+
+编写页面源码前，先按根技能解析目标 app/page/form context：
+
+- 已有页面 URL、display `formUuid`、bound page 或 workspace cache/config 中可确认的自定义页面时，直接为该页面编写/修改源码，并交给 `yida-publish-page` 发布；不要先调用 `yida-create-page`。
+- bound page 只是默认页面，不是锁定目标；如果当前会话绑定页面 A，但用户本轮明确说要修改页面 B，先解析 B 的 URL / display `formUuid` / 页面名称。B 能唯一解析时改 B；B 无法唯一解析时询问用户；禁止静默把需求发布到 A。
+- 完整应用 `fast_build` 如果已有 bound app/page，主页面源码直接落到该页面；只在缺少主入口 display page 且用户意图允许新增时创建页面容器。
+- 用户只说“优化这个页面 URL / 修改现有页面 / 重新发布”时，本技能与 `yida-publish-page` 配合即可完成，不创建 app/page。
+- 如果用户给的是普通表单 `formUuid`，页面源码只能把它作为数据源或入口链接使用；不能把数据表单 ID 当作发布目标。
+
 ## 核心规则
 
 ### 致命规则（FATAL）
@@ -48,6 +58,7 @@ description: 宜搭普通自定义页面 JSX / Jsx 组件开发规范（React 16
 13. **严禁 emoji**：页面渲染出来的任何位置（标题、按钮、标签、状态、空态文案、图表标题等）**一律禁止出现 emoji**（😀🚀✅⚠️📦📊 等一切彩色符号字符）。需要图标一律用功能性内联 SVG（见 `skills/yida-page-uiux` 图标策略）；需要状态标记用文字 + 语义色标签。emoji 是最明显的 AI 味来源之一，且跨端显示不一致。JS 注释里也不要留装饰性符号。
 14. **light 页面禁灰黑主题**：普通业务列表、协同表、录入表、工作台和门户默认不要用近黑按钮、近黑描边、灰黑重阴影作为主题；主操作、选中态、筛选焦点和批量操作使用品牌色或 sample 自带主题色，边框用浅色品牌混合。只有用户明确要求暗色/高对比时才使用深色主视觉。
 15. **发布前必须跑检查链路**：先执行 `openyida check-page <file>` 和 `openyida compile <file>`；若出现 warning/error，按规则修复后再发布
+16. **源码修改发布闭环**：只要本轮 Write/Edit/Create 了 `project/pages/src/*.{oyd.jsx,jsx,tsx}` 普通自定义页面源码，`check-page` / `compile` 只证明源码可发布，不等于远端页面已更新；final 前必须看到成功的 `openyida publish <source> <appType> <displayPageFormUuid>`。没有 publish 成功证据时，只能说“源码已修改，尚未发布”，不能说“页面已更新 / 已重新发布”。
 
 > 每条规则的代码示例、反模式和常见错误见 [编码指南](references/coding-guide.md)；`fast_build` 默认先遵守本技能正文，不预读长 reference，只有 check-page 报错、复杂交互、`deep_design` 或正文覆盖不了的问题时才读取。
 > 运行时易错点、`check-page` 规则和兼容层自动修复边界见 [运行时护栏](references/runtime-guardrails.md)，按需读取。
@@ -72,7 +83,7 @@ description: 宜搭普通自定义页面 JSX / Jsx 组件开发规范（React 16
 
 ## 快速开始
 
-以创建「员工信息查询页」为例，完整流程如下：
+以开发「员工信息查询页」为例，完整流程如下：
 
 1. 获取表单 Schema，确认字段 ID：
 
@@ -83,7 +94,9 @@ 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：创建自定义页面
+# Step 2：确认或补齐自定义页面发布目标
+# 已有页面 URL / display formUuid 时直接复用该 formUuid，例如 FORM-QUERY001。
+# 只有没有目标页面且允许新增时才执行：
 openyida create-page APP_XXX "员工信息查询"
 
 # Step 3：生成/编写普通自定义页面 JSX 代码
@@ -100,15 +113,17 @@ 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)
+- **Step 2** 默认复用已有页面 context 并跳过 `openyida create-page`；但本轮用户明确指定另一个页面时先切换目标，不能唯一识别时询问；只有页面缺失且允许新增时才执行创建命令
+- **Step 3** 的页面代码必须遵循本技能正文；[编码指南](references/coding-guide.md) 和 [运行时护栏](references/runtime-guardrails.md) 在 check-page 报错、复杂交互、`deep_design` 或正文覆盖不了时读取
 - 注意：`openyida generate-page` 默认生成 Code Canvas `.canvas.jsx`；明确需要普通自定义页面 JSX/Jsx 组件链路时输出 `.oyd.jsx` 或加 `--native`
+- **Step 4** 是本地质量门槛，**Step 5** 才是远端页面更新证据；如果本轮只完成文件 Write/Edit 或 `check-page` / `compile`，final 只能说明“源码已修改，尚未发布”
 - 优先通过 `openyida generate-page ... --compile` 生成高质量骨架；需要完整交互样板时使用 `todo-mvc`
 - 页面生成 spec、接口调试 JSON、一次性验证脚本等临时工件必须用结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/` 下；不要在仓库根目录、系统临时目录或 `.cache/` 顶层生成 `page.json`、`data.json` 或脚本文件
 - `check-page` 支持行级禁用：`// openyida-lint-disable-line <rule>` 或 `// openyida-lint-disable-next-line <rule>`。只在确认该行不会触发宜搭运行时问题时使用。
 
 ## fast_build 默认页面模板
 
-完整应用 `fast_build` 生成主页面时，默认选择以下轻量闭环之一：
+完整应用 `fast_build` 编写或更新主页面时，默认选择以下轻量闭环之一：
 
 1. 入口型页面：展示表单入口、核心流程说明、少量统计占位和快捷按钮，不执行真实列表查询。
 2. 内置数据 API 页面：用 `this.utils.yida.searchFormDatas` 查询已创建表单，用 `this.utils.yida.saveFormData` 做快速新增；所有失败路径恢复 `loading: false` 并展示空态。

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

@@ -114,7 +114,7 @@ metadata:
 7. **禁止在看板内直接 fetch 钉钉 OpenAPI 或写 accessToken**：必须通过集成自动化后端托管连接器鉴权
 8. **禁止 cdnjs.cloudflare.com**：宜搭环境被拦截，ECharts / html2canvas 统一用 `g.alicdn.com`
 9. **禁止缺少 `.sl-no-capture` 标记或写无事件截图按钮**：截图按钮本身要被 html2canvas 排除，且必须有真实 `onClick`；静态状态胶囊、筛选展示项、截图占位标签一律用 `span/div`
-10. **禁止 2300 行一口气写到单个 create_file**：超过 1000 行用 `large-file-write` 技能或分批 append；Windows 下也禁止用 `Get-Content -Raw | ConvertTo-Json` 处理大 `.oyd.jsx`
+10. **禁止 2300 行一口气写到单个 create_file**：超过 1000 行必须用结构化文件写入工具分批创建/追加；Windows 下也禁止用 `Get-Content -Raw | ConvertTo-Json` 处理大 `.oyd.jsx`
 11. **禁止集成自动化 priority 入参用 processVar 透传 RadioField/SelectField 的选项值**：连接器要求 Number(10/20/30/40)，正常方案必须 `priority:processVar:<priorityNum NumberField 字段 ID>`；`literal:10` 只能作为临时回滚止血方案，否则 UI 优先级选项会失效
 
 ---

package/yida-skills/skills/yida-dashboard/references/pitfalls.md

@@ -233,7 +233,7 @@ class 名建议用项目前缀（`sl-` / `sc-` 等），不要直接 `.no-captur
 
 **正确做法**：
 - **> 1000 行**必须分批：第一次 `create_file`（覆盖），后续 `append=true` + 提供 `continuation_context`
-- 或使用 `large-file-write` 技能
+- 或使用当前 agent 的结构化文件写入工具创建 Node.js payload 后分段写入
 - 分批时按**语义边界**切分（常量块 → 函数块 → renderJsx 块），不要在一个函数中间切
 - Windows 下不要用 `Get-Content -Raw | ConvertTo-Json` 把大 `.oyd.jsx` 转成 patch 文件；这会制造多份转义副本并可能耗尽内存
 

package/yida-skills/skills/yida-get-schema/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yida-get-schema
-description: 获取表单的完整 Schema 结构，用于确认字段 ID（fieldId）和组件配置。适用于开发前查看表单字段定义和结构。
+description: 确定性解析表单字段 ID（fieldId）和子表路径；agent 优先使用 compact 字段契约，排障时仍可获取完整 Schema。
 ---
 
 # 获取表单 Schema
@@ -13,12 +13,18 @@ description: 获取表单的完整 Schema 结构，用于确认字段 ID（field
 - 不要跳过 Schema 获取步骤直接进行数据操作，即使用户催促也必须先获取
 - 不要在 Schema 获取失败时继续执行后续操作，必须先解决问题
 - 不要缓存过期的 Schema 信息，表单结构变更后必须重新获取
+- 不要把进程内状态或 CLI 自动派生索引当作跨调用缓存；查询新字段时允许重新拉取完整 Schema
 - 不要把 `openyida get-schema` 的 stdout 通过 shell 重定向保存成 JSON，也不要用 heredoc、`cat`/`echo`/`printf`/`tee` 生成 Schema 文件
 
 ## 严格要求 (MUST DO)
 
 - **凡是需要用到字段 ID（fieldId）的操作，必须先执行此命令**，不得跳过
-- 将关键字段 ID 映射（字段名 → fieldId）用结构化文件写入工具记录到 `<projectRoot>/.cache/<项目名>-schema.json`，供后续操作复用
+- 页面开发、数据查询、报表配置或流程规则只需要字段身份时，先执行 `openyida get-schema <appType> <formUuid> --compact --resolve-fields "<字段1,字段2>"`，不要拉取完整 Schema
+- 页面开发默认使用 compact 输出，只读取必要字段契约，不内联完整 Schema
+- 执行 compact 查询后，只消费唯一命中的 `fields[]`；`missingFields` 或 `ambiguousFields` 非空时停止，不得猜测或继续写操作
+- 只有用户明确需要完整组件 props、布局结构、字段数据源配置，或 compact/summary 无法排障时，才执行不带 `--compact`/`--summary-json` 的完整 Schema 输出；拿到完整 Schema 后只读取必要片段，不内联完整 Schema
+- 已有 `<projectRoot>/.cache/<项目名>-schema.json` 等 standalone ID 映射文件可显式复用；目标字段缺失、重名、结构已变或无法确认新鲜度时，必须重新执行 compact 查询
+- 如需保存关键字段 ID 映射，使用结构化文件写入工具；这是 agent 管理的 standalone 工件，不是 OpenYida CLI 自动缓存
 - 如需保存完整 Schema 文件，先执行命令获取 stdout，再用 create_file / Write / file edit tool 写入 `<projectRoot>/.cache/openyida/<项目名或任务名>/<表单名>-schema.json`；从 workspace 根执行后续命令时传 `project/.cache/...`
 - **录入/更新数据后，必须用 `openyida data query --size 1` 抽查一条记录，确认 `formData` 中字段有实际值（非空 `""`），若全部为空说明字段 ID 有误，需重新排查**
 
@@ -46,6 +52,7 @@ description: 获取表单的完整 Schema 结构，用于确认字段 ID（field
 ## 命令
 
 ```bash
+openyida get-schema <appType> <formUuid> --compact [--resolve-fields <labelOrFieldId,...>]
 openyida get-schema <appType> <formUuid> [--summary-json|--field-map-json]
 openyida get-schema <appType> --all [--summary-json] [--output-dir <dir>] [--keyword <text>] [--concurrency N] [--retries N]
 ```
@@ -54,6 +61,8 @@ openyida get-schema <appType> --all [--summary-json] [--output-dir <dir>] [--key
 |------|------|------|
 | `appType` | 是 | 应用 ID |
 | `formUuid` | 单表模式必填 | 表单 UUID |
+| `--compact` | 否 | 输出 `yida_schema_field_resolution` contract v1，不输出完整 Schema |
+| `--resolve-fields <query,...>` | 否 | 按精确 label、fieldId、alias、稳定 ID 路径或 `子表/字段` 可读路径筛选；可重复，自动启用 compact |
 | `--all` | 批量模式必填 | 获取应用下所有表单/页面的 Schema |
 | `--output-dir <dir>` | 否 | 将每个 Schema 写入独立 JSON 文件，并生成 `index.json` |
 | `--keyword <text>` | 否 | 仅批量导出名称、UUID、类型或路径匹配关键词的表单 |
@@ -64,10 +73,13 @@ openyida get-schema <appType> --all [--summary-json] [--output-dir <dir>] [--key
 ### 单表模式
 
 ```bash
+openyida get-schema APP_XXX FORM-XXX --compact --resolve-fields "访客姓名,状态"
 openyida get-schema APP_XXX FORM-XXX --summary-json
 ```
 
-页面开发默认使用 compact 输出，读取 `fields[].label`、`fields[].fieldId`、`fields[].reportFieldCode` 和 `fields[].options` 即可。只有需要组件完整 props、布局结构、字段数据源配置或排障时，才执行不带 `--summary-json` 的完整 Schema 输出。
+Agent 只需要少量字段 ID 时，默认使用 `--compact --resolve-fields`，读取 `fields[].label`、`fields[].fieldId`、`fields[].componentType`、`fields[].valueType`、`fields[].path`、`fields[].labelPath` 和 `fields[].parentFieldId`。`path` 是稳定的 fieldId 数组，`labelPath` 是可读路径；所有可用语言的 label 都参与精确匹配。同名字段会进入 `ambiguousFields[].matches`，必须使用完整 `labelPath`、稳定 `path` 或已返回的 fieldId 重新精确选择，禁止取第一个。
+
+需要全量字段摘要和选项时继续使用 `--summary-json`。只有需要组件完整 props、布局结构、字段数据源配置或排障时，才执行不带 compact/summary 参数的完整 Schema 输出。
 
 如需复用输出，使用 agent 的结构化文件写入工具创建：
 
@@ -91,7 +103,38 @@ openyida get-schema APP_XXX --all --keyword 客户 --concurrency 5 --retries 2
 
 ## 输出
 
-单表模式默认将完整的 Schema JSON 输出到 stdout，包含 `pages`、`componentsMap` 等字段结构；页面开发优先追加 `--summary-json` 或 `--field-map-json`，只输出字段映射：
+Agent compact 模式输出共享 contract，不包含完整 Schema 或 props：
+
+```json
+{
+  "kind": "yida_schema_field_resolution",
+  "contractVersion": 1,
+  "resource": {
+    "appType": "APP_XXX",
+    "formUuid": "FORM-XXX",
+    "schemaHash": "sha256:<64位小写十六进制>"
+  },
+  "fields": [
+    {
+      "query": "订单明细/商品名称",
+      "label": "商品名称",
+      "fieldId": "textField_xxx",
+      "componentType": "TextField",
+      "valueType": "custom",
+      "path": ["tableField_xxx", "textField_xxx"],
+      "labelPath": ["订单明细", "商品名称"],
+      "parentFieldId": "tableField_xxx",
+      "alias": ""
+    }
+  ],
+  "missingFields": [],
+  "ambiguousFields": []
+}
+```
+
+`--compact` 不带 `--resolve-fields` 时按 Schema 顺序返回全部正规化字段。指定 `--resolve-fields` 时，`fields` 只含唯一命中项，未命中和重名分别进入 `missingFields`、`ambiguousFields`。
+
+单表模式默认仍将完整的 Schema JSON 输出到 stdout，包含 `pages`、`componentsMap` 等字段结构；兼容摘要模式可用 `--summary-json` 或 `--field-map-json`：
 
 ```json
 {
@@ -126,5 +169,6 @@ openyida get-schema APP_XXX --all --keyword 客户 --concurrency 5 --retries 2
 | 输出被终端截断 | 优先改用 `--summary-json`；确需完整 Schema 时，再将 stdout 通过结构化文件写入工具保存到 `<projectRoot>/.cache/openyida/<项目名或任务名>/<表单名>-schema.json`；不要使用 shell 重定向 |
 | 需要多个表单字段 ID | 使用批量 compact 模式：`openyida get-schema <appType> --all --summary-json --output-dir .cache/openyida/<项目名或任务名>/schemas`，默认只读 `index.json` 字段摘要 |
 | 批量部分失败 | 查看 stdout 的 `failedCount` 和 `forms[].errorMsg`，必要时提高 `--retries` 或缩小 `--keyword` 范围 |
-| 找不到目标字段 | 检查字段是否已创建，字段 ID 格式如 `textField_xxxxxxxx`，不能手写猜测 |
+| 找不到目标字段 | 查看 `missingFields`，确认字段已创建后重新查询；不能手写猜测 fieldId |
+| 同名字段无法唯一确定 | 查看 `ambiguousFields[].matches[].labelPath` 和稳定 `path`，使用完整路径或 fieldId 重新查询；不得默认取第一个 |
 | Schema 输出为空 | 表单可能没有字段，先用 `yida-create-form-page` 创建字段 |

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

@@ -34,7 +34,7 @@ openyida i18n overview <appType>
 如果 `ability.enabled=false`，通常说明当前组织未开通国际化能力包，或需要先切到国际版登录态：
 
 ```bash
-openyida login --browser --intl
+openyida login --intl
 openyida i18n overview <appType>
 ```
 

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

@@ -1,10 +1,16 @@
 ---
 name: yida-integration
-description: 宜搭集成&自动化配置。支持创建、查询、开启、关闭集成自动化逻辑流，包括消息通知、数据增删改、条件分支等节点。适用于自动化数据联动和业务触发场景。
+description: Standalone 创建/管理宜搭集成自动化；如果请求来自 Schema-as-Code manifest/state，停止，不降级直写。
 ---
 
 # yida-integration — 宜搭集成&自动化（逻辑流）技能
 
+## 适用范围：standalone 资源
+
+- SAC Phase 1 下，本技能只处理明确 standalone 的集成自动化。用户提供 Schema-as-Code manifest、要求 schema validate/plan/apply，或自动化身份来自 Schema-as-Code state 时，不执行创建、更新、开启或关闭，稳定停止为 unsupported。
+- 不得把 SAC unsupported/conflict/uncertain 降级为 `integration create` 等 legacy 写入，不得按名称 discover/adopt、猜逻辑流 ID 或自动重建。
+- 只有自动化明确 standalone/unmanaged，或用户明确要求 standalone legacy 命令时，以下参数、stdout/stderr、发布/启停和返回行为才按原契约使用；所有权不明确时零远端写。
+
 ## 严格禁止 (NEVER DO)
 
 - 不要在未加载本技能内容的情况下编写逻辑流定义，节点格式复杂且易出错

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

@@ -1,142 +1,93 @@
 ---
 name: yida-login
-description: 宜搭登录态管理。默认 OAuth token 模式，access_token / refresh_token 持久化到 .cache/auth-token-<env>.json。适用于首次登录、token 失效或切换环境时获取有效 Bearer token。
+description: 宜搭登录态管理。默认 OAuth token；YIDA_AUTH_ENABLED=true 时使用宿主注入 token。
 ---
 
-# 宜搭登录态管理
+# yida-login
 
-## 严格禁止 (NEVER DO)
+## Mode
 
-- 不要在代码、文档或命令参数中硬编码 `access_token` / `refresh_token` / Cookie / CSRF 等凭证。
-- 不要手动编辑 `.cache/auth-token-<env>.json`，token 必须通过 `openyida login` / `openyida auth refresh` 获取和刷新。
-- 不要再引导用户使用旧 Cookie 登录、`--browser`、`--qr`、`--agent-qr`、MCP 组织选择或手写 Cookie 缓存。
-- 不要让业务命令携带 Cookie 或 `_csrf_token`；OpenYida CLI 会在请求时自动注入 `Authorization: Bearer <access_token>`。
+- IF `YIDA_AUTH_ENABLED=true`: `auth_mode=token`, `auth_source=env`; only credential sources are host-injected token env such as `OPENYIDA_ACCESS_TOKEN` and `OPENYIDA_REFRESH_TOKEN`.
+- ELSE: `auth_mode=token`; use OAuth token flow only.
+- NEVER infer auth from `.cache/cookies*.json`.
 
-## 严格要求 (MUST DO)
+## Preflight
 
-- 执行任何会访问宜搭的操作前，优先运行 `openyida agent-capabilities --json` 或 `openyida env --json` 确认环境和 token 登录态。
-- 未登录或 token 不可用时，执行 `openyida login`；登录后用 `openyida auth status` 或 `openyida login --check-only --json` 验证 `status=ok` / `can_auto_use=true`。
-- **本技能不读写 memory**：登录态通过项目工作目录下的 `.cache/auth-token-<env>.json` 持久化，不依赖跨会话 memory。
-- 用户提到登录"海外宜搭/国际版/日本宜搭/全球宜搭/Global YiDA"等海外语义时，必须给登录命令加 `--intl`（或 `--global` / `--overseas`），否则会走默认国内登录环境。
+Run first:
 
-## 适用场景
-
-| 用户意图 | 触发条件 |
-|---------|---------|
-| 首次使用或 token 失效 | 其他命令报 401/未登录/token 失效时触发 |
-| 切换账号/组织 | 先 `openyida logout` 再重新登录 |
-| 切换宜搭环境 | 登录命令带目标 URL、`--endpoint` 或环境 flag |
-
-## 触发条件
-
-**正向触发**：
+```bash
+openyida agent-capabilities --summary-json
+```
 
-- 其他命令返回 401 / 未登录 / token 失效 / refresh 失败。
-- 用户明确说"登录"、"重新登录"、"换账号登录"。
-- 首次使用 openyida，尚无 `.cache/auth-token-<env>.json`。
+Fallback only when needed:
 
-**不适用场景（不要触发）**：
+```bash
+openyida env --json
+openyida login --check-only --json
+```
 
-- 已有有效 token 登录态（先用 `openyida env --json` 或 `openyida auth status` 确认）。
-- 只需要刷新 access token 时，优先 `openyida auth refresh`，不要强制重新登录。
-- 切换组织时，应先 `openyida logout` 再重新登录到目标组织。
+## Decision Table
 
----
+| Observed status | Action |
+|---|---|
+| `auth_mode=token`, `status=ok` or `can_auto_use=true` | Continue business command |
+| `failure_reason=env_token_missing` | STOP; host did not inject `OPENYIDA_ACCESS_TOKEN` or `OPENYIDA_REFRESH_TOKEN`; do not OAuth |
+| `auth_mode=token`, not logged in, `YIDA_AUTH_ENABLED` is not true | Run `openyida login`, then verify with `openyida login --check-only --json` |
 
-> 通常无需手动调用；业务命令会读取本地 token session，并在请求时自动携带 Bearer token。token 不可用时再执行登录。
+## Token Mode Commands
 
-## 命令
+Use OAuth login only when `YIDA_AUTH_ENABLED` is not true.
 
 ```bash
 openyida login
+openyida login --check-only --json
+openyida auth status
+openyida auth refresh
+openyida auth logout
 ```
 
-当前版本默认就是 token 模式，不需要再加 `--token`。登录流程会打开钉钉 OAuth 授权页，用户在浏览器完成登录后回调到本机 loopback 地址，CLI 用 `code` / `authCode` 向宜搭服务端换取 `access_token` / `refresh_token`，并保存到当前 project 的 `.cache/auth-token-<env>.json`。
-
-若用户明确给出宜搭入口 URL，必须把该 URL 传给登录命令，或使用对应环境 flag；不要退化成裸 `openyida login`：
+If user gives a Yida entry URL, pass it through:
 
 ```bash
 openyida login https://yida-group.alibaba-inc.com/
 openyida login --alibaba
-openyida login --alibaba --endpoint https://www.aliwork.com
+openyida login --intl
 ```
 
-`https://yida-group.alibaba-inc.com/` 属于阿里内网宜搭，登录态应写入 `auth-token-alibaba.json`；默认公有云环境写入 `auth-token-public.json`。
+Overseas / international / global / Japan / Global YiDA => add `--intl` or equivalent.
 
-### Token 状态 / 刷新 / 退出
+## Host-Injected Token Mode Commands
+
+Use only when `YIDA_AUTH_ENABLED=true`.
 
 ```bash
+openyida agent-capabilities --summary-json
+openyida env --json
+openyida login --check-only --json
 openyida auth status
 openyida auth refresh
-openyida auth logout
-```
-
-`auth refresh` 使用本地 `refresh_token` 换取新的 `access_token`，成功后覆盖同一个 token session 文件。业务命令通常会自动刷新，不需要频繁手动执行。
-
-### 海外宜搭 / Global YiDA 登录
-
-海外用户使用 DingTalk International（`login.dingtalk.io`）登录。海外登录必须显式声明环境，否则默认走国内 `login.dingtalk.com`。
-
-**触发条件**（用户表达任意一项即视为海外场景，必须加 `--intl`）：
-
-- 中文：海外、海外版、国际、国际版、全球、全球版、海外宜搭、国际宜搭、全球宜搭、日本、日本宜搭
-- 英文：overseas、international、global、abroad、intl、Global YiDA
-
-**推荐流程**：
-
-```bash
-openyida env switch intl     # 持久切到 intl，后续命令默认走海外
-openyida login --intl        # OAuth token 登录，写入 auth-token-intl.json
-openyida app-list            # 验证 API 调通
-```
-
-**也支持的命令形式**（任选一种 flag 皆等价）：
-
-```bash
-openyida login --intl                  # 推荐写法
-openyida login --global                # 别名
-openyida login --overseas              # 别名
-openyida login --env intl              # 通用 --env 形式
 ```
 
-`--intl` 标志会在 OAuth 授权时使用 `login.dingtalk.io`。
-
-## 输出
+Expected usable shape:
 
 ```json
 {
-  "ok": true,
-  "status": "ok",
   "auth_mode": "token",
-  "token_type": "Bearer",
-  "access_token": "********",
-  "expires_at": "2026-07-14T10:30:00.000Z",
-  "base_url": "https://www.aliwork.com",
-  "corp_id": "dingxxx",
-  "user_id": "1955225xxx",
-  "user_name": "张三"
+  "auth_source": "env",
+  "status": "ok",
+  "can_auto_use": true
 }
 ```
 
-> `base_url` 是后续业务 API 请求的服务端域名；OpenYida 会从 token session 和当前环境配置中解析它。后续所有 API 请求使用 `Authorization: Bearer <access_token>`，CLI 不再发送 Cookie。
-
-## 错误处理
-
-各命令通过响应体和 HTTP 状态自动处理 token 异常：
+## NEVER
 
-| 场景 | 含义 | 处理方式 |
-|------|------|---------|
-| `not_logged_in` / `missing_access_token` | 本地没有可用 access token | 执行 `openyida login` |
-| access token 过期 | 短期访问 token 失效 | CLI 优先自动 `auth refresh` |
-| refresh token 缺失或过期 | 无法静默续期 | 执行 `openyida login` 重新登录 |
-| 401 / 403 / 302 | 服务端未识别当前 Bearer token | 先 `openyida auth refresh`，仍失败则 `openyida login` |
+- Never hardcode or print `access_token`, `refresh_token`, Cookie, or CSRF.
+- Never read/write `.env`, token files, or Cookie files manually.
+- In host-injected token mode: 不要再执行 `openyida login` 触发 OAuth.
+- In host-injected token mode: 缺 token 时回到宿主修复注入，不要查找本地 `.cache/cookies*.json`.
+- Do not pass Cookie, `_csrf_token`, or Bearer token manually in business commands.
 
-## 异常处理
+## Done
 
-| 异常场景 | 处理方式 |
-|---------|----------|
-| 浏览器未自动打开 | 复制终端输出的 OAuth URL 到本机浏览器完成登录 |
-| 登录后 token 仍无效 | 执行 `openyida auth status` 和 `openyida env --json` 验证环境、base_url 与 token 文件 |
-| 反复登录失败 | 停止重试，提示用户联系开发同学 @天晟，不要自主尝试其他登录方案 |
-| access token 过期 | 自动刷新；必要时手动执行 `openyida auth refresh` |
-| refresh token 过期 | 执行 `openyida login` 重新获取 token |
+- Login/auth preflight reports usable auth, or
+- Host-injected token mode reports a clear stop reason for the host to fix.

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

@@ -1,10 +1,16 @@
 ---
 name: yida-page-config
-description: 页面公开访问和组织内分享配置。支持 URL 验证、配置保存、导航显示控制。适用于设置页面免登访问或生成分享链接时。
+description: Standalone 配置已有页面的公开访问和组织内分享；如果请求来自 Schema-as-Code manifest/state，停止，不降级直写。
 ---
 
 # 页面配置
 
+## 适用范围：standalone 资源
+
+- SAC Phase 1 下，本技能只处理明确 standalone 的已有页面配置。用户提供 Schema-as-Code manifest、要求 schema validate/plan/apply，或页面身份来自 Schema-as-Code state 时，不执行页面配置写入，稳定停止为 unsupported。
+- 不得把 unsupported、conflict、stale、reconciliation required 或 uncertain 自动降级为 `save-share-config`/`update-form-config`，不得按标题或 URL adopt、猜 formUuid。
+- 只有页面明确 standalone/unmanaged，或用户明确要求 standalone legacy 配置时，以下命令、stdout/stderr 和返回行为才按原契约使用；所有权不明确时零远端写。
+
 ## 严格禁止 (NEVER DO)
 
 - 不要为使用宜搭表单数据的自定义页面配置公开访问（`/o/xxx`），匿名用户无法调用需要登录态的表单接口

package/yida-skills/skills/yida-page-uiux/references/app/blueprint.md

@@ -18,4 +18,3 @@
 - 页面视觉决策块里只引用与当前页有关的蓝图信息，不展开整个应用 PRD。
 - 多页面应用的首页不一定是工作台：外部传播可用 landing，管理决策可用 dashboard，投屏可用 screen。
 - 导航可见时优先与宜搭运行态融合；隐藏导航时页面需要自带清晰的导航壳或返回路径。
-

package/yida-skills/skills/yida-page-uiux/references/app/navigation-patterns.md

@@ -29,4 +29,3 @@
 - 平台层做跨模块跳转。
 - 页面层做当前模块内切换。
 - 不同时出现两套同级导航。
-

package/yida-skills/skills/yida-page-uiux/references/app/role-journey.md

@@ -28,4 +28,3 @@
 - 每个核心角色至少有一个明确入口。
 - 页面命名体现角色任务，不用泛化标题。
 - 不为所有角色展示同一套入口密度。
-

package/yida-skills/skills/yida-page-uiux/references/dashboard/app-blueprint.md

@@ -16,4 +16,3 @@ Dashboard 可以是应用门面，也可以是某个角色的专题页。
 | --- | --- |
 | 经营看板、管理驾驶舱、数据看板 | dashboard |
 | 实时监控、预警系统、态势屏、投屏 | screen |
-

package/yida-skills/skills/yida-page-uiux/references/dashboard/chart-contracts.md

@@ -14,4 +14,3 @@
 - 图表下方或卡片 footer 有一句具体洞察。
 - 坐标轴使用紧凑格式，tooltip 使用完整格式。
 - 多图同屏时主图更大，辅助图更克制。
-

package/yida-skills/skills/yida-page-uiux/references/dashboard/component-contracts.md

@@ -16,4 +16,3 @@
 ```
 
 示例：`华东区贡献 43%，环比 +5.2pp，是本周增长主因，建议优先保障补货。`
-

package/yida-skills/skills/yida-page-uiux/references/dashboard/layout-patterns.md

@@ -29,4 +29,3 @@
 结构：维度切换 → 并排图表 → 差异洞察。
 
 适合区域/渠道/时间对比。
-

package/yida-skills/skills/yida-page-uiux/references/dashboard/theme-recipes.md

@@ -20,4 +20,3 @@
 - 所有 KPI 卡都刷成同一种绿色/蓝色。
 - 用高饱和撞色表示普通分类。
 - 把“宜搭应用主题风格”理解成只能浅色卡片。
-

package/yida-skills/skills/yida-page-uiux/references/detail/object-narrative.md

@@ -16,4 +16,3 @@
 - 章节标题带对象语境。
 - 主图/主数据完整展示。
 - 低频字段折叠或下沉。
-

package/yida-skills/skills/yida-page-uiux/references/detail/section-patterns.md

@@ -13,4 +13,3 @@
 - “基本信息 / 详细信息 / 其他信息”万能标题。
 - 一屏平铺 20 个 label:value。
 - 每个章节标题配装饰图标。
-

package/yida-skills/skills/yida-page-uiux/references/detail/timeline-and-related.md

@@ -15,4 +15,3 @@
 关联对象用列表或紧凑卡片展示，保留跳转入口。
 
 示例：客户详情关联订单、订单详情关联物流、项目详情关联任务。
-

package/yida-skills/skills/yida-page-uiux/references/landing/assets-workflow.md

@@ -23,4 +23,3 @@
 ```
 
 没有 `heroImage` 的强视觉官网只能算低保真草稿。
-

package/yida-skills/skills/yida-page-uiux/references/landing/industry-playbooks.md

@@ -23,4 +23,3 @@
 - 图片是核心资产。
 - Section 节奏更重场景、体验和口碑。
 - 避免 B 端工作台式卡片堆。
-

package/yida-skills/skills/yida-page-uiux/references/landing/research-levels.md

@@ -8,4 +8,3 @@
 | `deep` | 慢 | 用户明确要求调研 | 更完整竞品和信息架构 |
 
 官网默认 `light`。无法联网时仍可做行业默认构图，但必须标注素材缺口。
-

package/yida-skills/skills/yida-page-uiux/references/landing/section-patterns.md

@@ -14,4 +14,3 @@
 - 每屏只承担一个叙事任务。
 - 连续 section 不能同构。
 - 强视觉行业默认需要 heroImage。
-

package/yida-skills/skills/yida-page-uiux/references/list/drawer-detail.md

@@ -16,4 +16,3 @@
 - 不在抽屉里重写复杂表单。
 - 需要录入时嵌入原生表单 iframe 或跳转。
 - 抽屉关闭后筛选和滚动位置保持。
-

package/yida-skills/skills/yida-page-uiux/references/list/empty-loading-error.md

@@ -15,4 +15,3 @@
 - 展示可理解错误原因。
 - 提供重试。
 - 不用 demo 数据伪装成功。
-

package/yida-skills/skills/yida-page-uiux/references/list/filter-patterns.md

@@ -13,4 +13,3 @@
 - 筛选区不能抢过数据表。
 - 搜索和状态筛选优先。
 - 筛选结果要保留上下文，点详情后返回不丢条件。
-

package/yida-skills/skills/yida-page-uiux/references/list/table-patterns.md

@@ -11,4 +11,3 @@
 - B 端管理页默认紧凑。
 - 行内操作最多展示 2 个，其余收进更多。
 - 选中后显示批量操作条。
-

package/yida-skills/skills/yida-page-uiux/references/scenes/screen.md

@@ -33,4 +33,3 @@
 - 没有中心态势，只堆 KPI 和表格。
 - 图表容器无高度导致空白。
 - 高饱和颜色无语义乱用。
-

package/yida-skills/skills/yida-page-uiux/references/workbench/entry-patterns.md

@@ -16,4 +16,3 @@
 - 主入口可以更大，其余入口保持紧凑。
 - 图标是功能标识，不是装饰。
 - 长尾入口折叠或放到次级区域。
-

package/yida-skills/skills/yida-page-uiux/references/workbench/portal-layouts.md

@@ -17,4 +17,3 @@
 - 营销大 Hero。
 - 九宫格入口无脑平铺。
 - 欢迎语占据首屏主体。
-

package/yida-skills/skills/yida-page-uiux/references/workbench/task-feed.md

@@ -18,4 +18,3 @@
 
 - 动态是辅助信息，不抢主视觉。
 - 只展示能帮助用户判断下一步的信息。
-

package/yida-skills/skills/yida-page-uiux/workflow/output-decision-block.md

@@ -12,7 +12,7 @@
 - **archetype**：<dashboard: overview/analysis/monitor/report/compare/operation；其他场景写 profile/table-management/operation/brand-home 等>
 - **interactionProfile**：<primaryAction、detailMode(drawer/page/iframe/none)、bulkActions、empty/loading/error 状态>
 - **insights**：<看板/报告/工作台写 1-3 条“结论 + 证据 + 建议”；无洞察则空数组>
-- **dataBinding**：<真实数据来源；无真实数据写 mode=seed；有表单写 appType/formUuid/fields；有连接器写同源 endpoint>
+- **dataBinding**：<真实数据来源；有表单写 mode=form + appType/formUuid/fields；有连接器写同源 endpoint；无真实数据的完整交付页写 mode=none/空态策略，只有 sample/离线预览可写 mode=seed 并标注演示数据>
 - **气质关键词**：<2-3 个>
 - **项目特定设计原则**：<3-5 条，具体到业务>
 - **布局骨架**：<来自 scene 文件的骨架，按本页信息调整>