openyida 2026.8.12 → 2026.8.14

package/README.md

@@ -641,7 +641,9 @@ Latest contributors: [DDlixin1](https://github.com/DDlixin1), [fcloud](https://g
 <p>
   <a href="https://github.com/yize"><img src="https://github.com/yize.png?size=48" width="48" height="48" alt="九神" title="九神" /></a>
   <a href="https://github.com/alex-mm"><img src="https://github.com/alex-mm.png?size=48" width="48" height="48" alt="天晟" title="天晟" /></a>
+  <a href="https://github.com/fryaninc"><img src="https://github.com/fryaninc.png?size=48" width="48" height="48" alt="New Core architecture, Core development, user issue support, skill maintenance and Help & Show Case Center 构建者" title="New Core architecture, Core development, user issue support, skill maintenance and Help & Show Case Center 构建者" /></a>
   <a href="https://github.com/DDlixin1"><img src="https://github.com/DDlixin1.png?size=48" width="48" height="48" alt="DDlixin1" title="DDlixin1" /></a>
+  <a href="https://github.com/xhy-ali"><img src="https://github.com/xhy-ali.png?size=48" width="48" height="48" alt="登录态开发者" title="登录态开发者" /></a>
   <a href="https://github.com/fcloud"><img src="https://github.com/fcloud.png?size=48" width="48" height="48" alt="Aiden Wu (fcloud)" title="Aiden Wu (fcloud)" /></a>
   <a href="https://github.com/nicky1108"><img src="https://github.com/nicky1108.png?size=48" width="48" height="48" alt="nicky1108" title="nicky1108" /></a>
   <a href="https://github.com/angelinheys"><img src="https://github.com/angelinheys.png?size=48" width="48" height="48" alt="angelinheys" title="angelinheys" /></a>
@@ -658,6 +660,8 @@ Latest contributors: [DDlixin1](https://github.com/DDlixin1), [fcloud](https://g
   <a href="https://github.com/key-668"><img src="https://github.com/key-668.png?size=48" width="48" height="48" alt="再不喝汽水" title="再不喝汽水" /></a>
   <a href="https://github.com/dongbeixiaohuo"><img src="https://github.com/dongbeixiaohuo.png?size=48" width="48" height="48" alt="dongbeixiaohuo" title="dongbeixiaohuo" /></a>
   <a href="https://github.com/nandanadileep"><img src="https://github.com/nandanadileep.png?size=48" width="48" height="48" alt="nandanadileep" title="nandanadileep" /></a>
+  <a href="https://github.com/hj837990198"><img src="https://github.com/hj837990198.png?size=48" width="48" height="48" alt="skill 测试" title="skill 测试" /></a>
+  <a href="https://github.com/chengminchao-create"><img src="https://github.com/chengminchao-create.png?size=48" width="48" height="48" alt="skill共建" title="skill共建" /></a>
 </p>
 
 <!-- openyida-contributors:end -->

package/docs/capabilities.md

@@ -1,6 +1,10 @@
 # OpenYida 功能完整列表
 
-这份清单面向宜搭使用者，说明 OpenYida 支持的功能，以及对应可以执行的 `openyida` 命令。参数细节可以继续查看 `openyida --help`、`openyida <command> --help` 或 `openyida commands --json`。
+这份清单面向宜搭使用者和 AI Agent，按本地 OpenYida `2026.8.12-1` 的 101 条命令和技能路由整理。参数细节可以继续查看 `openyida --help`、`openyida <command> --help` 或 `openyida commands --json`。
+
+<Note>
+日常使用建议先运行 `openyida agent-capabilities --summary-json`，它会轻量返回版本、登录态、组织、工作目录和命令清单摘要。只有排查命令契约、权限元数据或登录异常时，再使用完整的 `openyida agent-capabilities --json`。
+</Note>
 
 ## 基础操作
 
@@ -27,6 +31,8 @@
 | 查询我的应用 | `openyida app-list [--size N]` |
 | 创建应用 | `openyida create-app "<应用名称>"` |
 | 更新应用名称、布局、主题 | `openyida update-app <appType> [--name "..."] [--layout slide\|ver] [--theme deepBlue]` |
+| 启用应用 / 上线应用 | `openyida app-online <appType> [--to-ding-app-center] [--show-app-center]` |
+| 停用应用 / 下线应用 | `openyida app-offline <appType> [--to-ding-app-center] [--show-app-center]` |
 | 导出应用迁移包 | `openyida export <appType> [output]` |
 | 导入应用迁移包 | `openyida import <file> [name]` |
 | 管理左侧导航分组 | `openyida nav-group <list\|create\|rename\|delete\|move\|order\|hide\|show> <appType> ...` |
@@ -43,6 +49,7 @@
 | 功能 | 执行操作 |
 |---|---|
 | 创建表单 | `openyida create-form create <appType> ...` |
+| 校验表单字段配置 | `openyida create-form validate-fields <fieldsJsonOrFile>` |
 | 更新表单字段 | `openyida create-form update <appType> ...` |
 | 用 patch 更新表单 | `openyida create-form patch <appType> <formUuid> <patchJsonOrFile>` |
 | 配置表单联动规则 | `openyida create-form rule <appType> <formUuid> <rulesJsonOrFile>` |
@@ -54,6 +61,7 @@
 | 获取表单 Schema | `openyida get-schema <appType> <formUuid>` |
 | 获取应用全部 Schema | `openyida get-schema <appType> --all` |
 | 导出 ER 关系图 | `openyida er <appType> [--format mermaid\|json] [--output file]` |
+| 注入、移除或检查表单详情页样式 | `openyida form-detail-style <apply\|remove\|check> <appType> <formUuid> ...` |
 | 管理聚合表 virtualView | `openyida aggregate-table <list\|create-empty\|inspect\|preview\|save\|publish\|status> <appType> ...` |
 
 ## 自定义页面与发布
@@ -62,6 +70,7 @@
 |---|---|
 | 创建自定义页面 | `openyida create-page <appType> "<页面名称>"` |
 | 创建看板页 | `openyida create-page <appType> "<页面名称>" --mode dashboard` |
+| 查看或输出自定义页面示例 | `openyida sample yida-canvas-custom-page <sample> --output project/pages/src/<name>.canvas.jsx` / `openyida sample yida-custom-page <sample> --output project/pages/src/<name>.oyd.jsx` |
 | 构建宜搭兼容页面源码 | `openyida build-page <sourceFile> [--output file\|--write]` |
 | 检查普通自定义页面 JSX 规范 | `openyida check-page <src> [--compat]` |
 | 本地编译普通自定义页面 JSX | `openyida compile <src>` |
@@ -72,8 +81,8 @@
 | 更新页面/表单配置 | `openyida update-form-config <appType> ...` |
 | 查询页面/表单配置 | `openyida get-form-config <appType> <formUuid> [--json]` |
 | 开发高级自定义页面、看板、图表或幻灯片 | 默认优先使用 Code Canvas 链路；明确要求普通自定义页面 JSX/Jsx，或强依赖普通自定义页实例桥时使用 `.oyd.jsx` + `check-page` / `compile` / `publish` |
-| Code Canvas 页面使用成员/部门/上传等宜搭运行态组件 | 使用 `yida-canvas-custom-page`，参考 `yida-canvas-custom-page/references/native-components-bridge.md` 做运行态组件探测、fallback 和值归一化 |
-| Code Canvas 门户 + 成员/部门/上传组件 | 使用 `yida-canvas-custom-page`，按业务页面结构接入运行态组件桥 |
+| Code Canvas 页面使用成员/部门/上传等宜搭运行态组件 | `openyida sample yida-canvas-custom-page native-components-smoke --output pages/src/native-components-smoke.canvas.jsx`；再参考 `yida-canvas-custom-page/references/native-components-bridge.md` |
+| Code Canvas 门户 + 成员/部门/上传组件示例 | `openyida sample yida-canvas-custom-page portal-native-components --output pages/src/portal-native-components.canvas.jsx` |
 | 普通自定义页面 JSX/Jsx 使用成员/部门组件 | 使用 `.oyd.jsx`，参考 `yida-custom-page/references/component-jsx-guide.md` |
 | 普通自定义页面 JSX/Jsx 使用附件/图片上传 | 使用 `.oyd.jsx`，参考 `yida-custom-page/references/attachment-upload-guide.md` |
 
@@ -81,12 +90,16 @@
 
 | 需求 | 推荐链路 |
 |---|---|
-| 现代 React、hooks、官网、工作台、看板、列表、详情、可视化、AI 首次生成页面 | Code Canvas：`.canvas.jsx` / `YidaCodeCanvas` |
+| 现代 React、Hooks、官网、工作台、看板、列表、详情、可视化、AI 首次生成页面 | Code Canvas：`.canvas.jsx` / `.canvas.tsx` / `YidaCodeCanvas` |
 | 需要成员、部门、附件上传、图片上传等宜搭运行态组件，且希望页面保持现代 React 体验 | Code Canvas + 原生组件桥；先跑 smoke 示例验证运行态组件，再做 fallback 和值归一化 |
 | 用户明确要求普通自定义页面 JSX/Jsx 组件链路 | 普通自定义页面：`.oyd.jsx` / `Jsx` |
 | 强依赖 `this.$(fieldId)`、`this.utils.yida.*`、`this.dataSourceMap`、表单提交或字段双向绑定 | 普通自定义页面：`.oyd.jsx` / `Jsx` |
 | 已有普通 `.oyd.jsx` 页面要迁移到 Code Canvas | 参考 `yida-canvas-upgrade` 技能 |
 
+<Tip>
+新版自定义页面默认走 Code Canvas。`check-page` 和 `compile` 主要用于普通自定义页面 JSX；`.canvas.jsx` / `.canvas.tsx` 由 `openyida publish` 的 Canvas 编译阶段校验。
+</Tip>
+
 ## 流程、审批与任务
 
 | 功能 | 执行操作 |
@@ -123,7 +136,8 @@
 |---|---|
 | 创建宜搭原生报表 | `openyida create-report <appType> "<报表名称>" ...` |
 | 向已有报表追加图表 | `openyida append-chart <appType> <reportId> ...` |
-| 创建 ECharts 高级报表 | 使用自定义页面开发链路，并执行 `openyida publish ...` |
+| 创建 Recharts 高级看板 | 使用 Code Canvas + Recharts 示例，并执行 `openyida publish ...` |
+| 维护 ECharts 复杂图表页面 | 使用普通自定义页面或 ECharts 兼容链路，并执行 `openyida publish ...` |
 | 创建经营看板/管理驾驶舱/数据大屏 | 使用 `create-page`、数据源配置、报表命令和 `publish` 组合完成 |
 
 ## 连接器、集成与钉钉
@@ -164,6 +178,8 @@
 | 解析并回填页面素材 | `openyida asset resolve [options]` |
 | 生成 AI 图片素材 | `openyida asset generate [options]` |
 | 检查宜搭公式 | `openyida formula evaluate <formula\|file> [--schema file]` |
+| 读取钉钉文档并转为 Markdown | `openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]` |
+| 按 taskUuid 读取钉钉听记 | `openyida read-dingtalk-tingji <taskUuid> [--json]` |
 | 闪记/会议纪要转 PRD | `openyida flash-to-prd --file <path> --name "<project>"` |
 | 导出 AI 对话记录 | `openyida export-conversation [options]` |
 | 整理 VOC 反馈材料 | 按故障、需求或性能问题整理成可提交材料 |

package/lib/app/canvas-compile.js

@@ -46,10 +46,6 @@ const {
   findFormDetailLinkIssues,
   formatFormDetailLinkMessage,
 } = require('./form-detail-link-guard');
-const {
-  findPageRichnessIssues,
-  formatPageRichnessMessage,
-} = require('./page-richness-guard');
 
 /**
  * 依赖 → window 别名白名单，用于把 import 改写到运行时全局对象。
@@ -621,21 +617,6 @@ function compileCanvasLocal(source, options = {}) {
       },
     });
   }
-  const richnessIssues = findPageRichnessIssues(source);
-  if (richnessIssues.length > 0) {
-    const firstIssue = richnessIssues[0];
-    throw new CliError(formatPageRichnessMessage(firstIssue), {
-      code: 'OPENYIDA_CANVAS_CONTENT_BLOCKS_TOO_FEW',
-      details: {
-        stage: 'canvas_compile',
-        sourcePath: options.sourcePath || '',
-        line: firstIssue.line,
-        scene: firstIssue.scene,
-        count: firstIssue.count,
-        min: firstIssue.min,
-      },
-    });
-  }
   assertNoBareDependencyGlobals(source, options);
   assertNoManualDependencyGlobals(source, options);
 

package/lib/app/create-app.js

@@ -269,6 +269,8 @@ function buildCreateAppPayload(params, auth, contentLocale, openExclusive, openP
     openIsolationDatabase: 'n',
     openExclusiveUnit: 'n',
     group: 'ALL',
+    fromBuilderAi: 'y',
+    builderAiSource: 'local',
   };
   if (navTheme) {
     payload.navTheme = navTheme;

package/lib/app/import-app.js

@@ -40,6 +40,8 @@ async function createApp(appName, authRef) {
       openIsolationDatabase: 'n',
       openExclusiveUnit: 'n',
       group: 'ALL',
+      fromBuilderAi: 'y',
+      builderAiSource: 'local',
     });
     return httpPost(auth.baseUrl, '/query/app/registerApp.json', postData, auth.cookies);
   }, authRef);

package/lib/app/page-linter.js

@@ -9,7 +9,6 @@ const {
 const { findBareCjkJsxTextIdentifiers } = require('./jsx-text-guard');
 const { findDirectFormOpenIssues } = require('./form-open-guard');
 const { findFormDetailLinkIssues } = require('./form-detail-link-guard');
-const { findPageRichnessIssues } = require('./page-richness-guard');
 const Babel = require('@babel/standalone');
 
 const THEN_CALLBACK_LINE_LIMIT = 50;
@@ -866,10 +865,6 @@ function lintYidaSource(sourceCode, filePath) {
   findFormDetailLinkIssues(sourceCode, { parserOptions: PARSER_OPTIONS }).forEach((issue) => {
     pushIssue(errors, issue.line, 'form-detail-link', t('publish.lint_form_detail_link'), disableMap);
   });
-  findPageRichnessIssues(sourceCode).forEach((issue) => {
-    pushIssue(errors, issue.line, 'content-blocks-too-few', t('publish.lint_content_blocks_too_few', issue.count, issue.min), disableMap);
-  });
-
   return { errors, warnings };
 }
 

package/lib/core/agent-capabilities.js

@@ -1,12 +1,13 @@
 'use strict';
 
 const crypto = require('crypto');
+const fs = require('fs');
 const path = require('path');
 const { version } = require('../../package.json');
 const { t } = require('./i18n');
 const { buildCommandManifest } = require('./command-manifest');
 const { buildEnvironmentSnapshot } = require('./env');
-const { getAuthStatus } = require('./utils');
+const { findProjectRoot, getAuthStatus } = require('./utils');
 
 function redactLogin(login) {
   const redacted = { ...login };
@@ -35,6 +36,21 @@ function hasEnvTokenCredential(env = process.env) {
   );
 }
 
+function hasRuntimeProvisionedAccessToken(env = process.env) {
+  return isTruthyEnv(env.YIDA_AUTH_ENABLED) &&
+    !!String(env.OPENYIDA_ACCESS_TOKEN || '').trim();
+}
+
+function buildRuntimeProvisionedLoginStatus() {
+  return {
+    ok: true,
+    auth_mode: 'token',
+    auth_source: 'env',
+    status: 'ok',
+    can_auto_use: true,
+  };
+}
+
 const BUILDER_CORE_COMMAND_IDS = Object.freeze([
   'agent-capabilities',
   'commands',
@@ -84,8 +100,10 @@ function buildAuthPath(login, env = process.env) {
   const envTokenPresent = hasEnvTokenCredential(env);
   const authSource = login.auth_source || (hostInjectedTokenMode || envTokenPresent ? 'env' : 'token_session');
   const hostTokenEnvDetected = hostInjectedTokenMode || envTokenPresent || authSource === 'env';
-
-  return {
+  const runtimeAuthProvisioned = hasRuntimeProvisionedAccessToken(env) &&
+    authSource === 'env' &&
+    login.status === 'ok';
+  const authPath = {
     mode: login.auth_mode || 'token',
     source: authSource,
     can_auto_use: login.can_auto_use === true,
@@ -109,6 +127,10 @@ function buildAuthPath(login, env = process.env) {
       ? 'STOP_AND_REQUEST_HOST_TOKEN'
       : 'RUN_OPENYIDA_LOGIN_IF_USER_APPROVES',
   };
+  if (runtimeAuthProvisioned) {
+    authPath.runtime_auth_provisioned = true;
+  }
+  return authPath;
 }
 
 function buildBuilderPath(login, projectRoot, manifest, env = process.env) {
@@ -218,26 +240,30 @@ function compactBuilderPath(builderPath) {
   const commandContract = builderPath.command_contract;
   const resourceContext = builderPath.resource_context_resolution;
   const paths = builderPath.paths;
+  const auth = {
+    mode: builderPath.auth.mode,
+    source: builderPath.auth.source,
+    can_auto_use: builderPath.auth.can_auto_use,
+    host_injected_token_mode: builderPath.auth.host_injected_token_mode,
+    host_token_env_detected: builderPath.auth.host_token_env_detected,
+    env_token_present: builderPath.auth.env_token_present,
+    interactive_login_allowed: builderPath.auth.interactive_login_allowed,
+    browser_session_auth_allowed: builderPath.auth.browser_session_auth_allowed,
+    auth_runtime: builderPath.auth.auth_runtime,
+    cookie_auth_supported: builderPath.auth.cookie_auth_supported,
+    cookie_check_required: builderPath.auth.cookie_check_required,
+    playwright_cookie_check_required: builderPath.auth.playwright_cookie_check_required,
+    qr_login_required: builderPath.auth.qr_login_required,
+    missing_token_action: builderPath.auth.missing_token_action,
+  };
+  if (builderPath.auth.runtime_auth_provisioned === true) {
+    auth.runtime_auth_provisioned = true;
+  }
 
   return {
     schema_version: builderPath.schema_version,
     preflight: builderPath.preflight,
-    auth: {
-      mode: builderPath.auth.mode,
-      source: builderPath.auth.source,
-      can_auto_use: builderPath.auth.can_auto_use,
-      host_injected_token_mode: builderPath.auth.host_injected_token_mode,
-      host_token_env_detected: builderPath.auth.host_token_env_detected,
-      env_token_present: builderPath.auth.env_token_present,
-      interactive_login_allowed: builderPath.auth.interactive_login_allowed,
-      browser_session_auth_allowed: builderPath.auth.browser_session_auth_allowed,
-      auth_runtime: builderPath.auth.auth_runtime,
-      cookie_auth_supported: builderPath.auth.cookie_auth_supported,
-      cookie_check_required: builderPath.auth.cookie_check_required,
-      playwright_cookie_check_required: builderPath.auth.playwright_cookie_check_required,
-      qr_login_required: builderPath.auth.qr_login_required,
-      missing_token_action: builderPath.auth.missing_token_action,
-    },
+    auth,
     environment_check_simplification: {
       minimal_probe_commands: environment.minimal_probe_commands,
       can_skip_default_exploration_when_summary_ok: environment.can_skip_default_exploration_when_summary_ok,
@@ -319,8 +345,37 @@ function buildCommandManifestDigest(manifest) {
 }
 
 function buildAgentCapabilitiesSummary() {
-  const envSnapshot = buildEnvironmentSnapshot();
   const manifest = buildCommandManifest({ t, version });
+
+  if (hasRuntimeProvisionedAccessToken(process.env)) {
+    const projectRoot = findProjectRoot();
+    const loginStatus = buildRuntimeProvisionedLoginStatus();
+    const builderPath = compactBuilderPath(
+      buildBuilderPath(loginStatus, projectRoot, manifest)
+    );
+
+    return {
+      schema_version: 1,
+      name: 'openyida-agent-capabilities-summary',
+      version,
+      login: compactLogin(loginStatus),
+      precheck: {
+        skipped: true,
+        reason: 'runtime_auth_provisioned',
+      },
+      workdir: projectRoot,
+      workdir_exists: fs.existsSync(projectRoot),
+      cache_dir: path.join(projectRoot, '.cache'),
+      openyida_task_cache_dir: path.join(projectRoot, '.cache', 'openyida'),
+      command_manifest_digest: buildCommandManifestDigest(manifest),
+      command_manifest_digest_algorithm: 'sha256',
+      command_count: manifest.summary.command_count,
+      full_capabilities_command: 'openyida agent-capabilities --json',
+      builder_path: builderPath,
+    };
+  }
+
+  const envSnapshot = buildEnvironmentSnapshot();
   const projectRoot = envSnapshot.active.projectRoot;
   const loginStatus = getAuthStatus({ projectRoot, includeSecrets: false });
   const builderPath = compactBuilderPath(

package/lib/core/locales/en.js

@@ -1149,7 +1149,6 @@ Examples:
     lint_iframe_self_navigation: 'Yida custom pages run in an iframe. Use target="_top"/target="_blank" or window.top.location for Yida page navigation to avoid nested pages.',
     lint_form_open_container: 'Opening Yida form submission/detail pages from a custom page must use FormOpenContainer: a 50vw drawer iframe on desktop, and full/new page only on mobile. Button handlers should call openForm({ type: "submission" | "detail", ... }).',
     lint_form_detail_link: 'Yida form detail pages must use a real formInstId: read row.formInstId first, and disable or warn when the instance id is missing instead of opening a formDetail link with an empty formInstId.',
-    lint_content_blocks_too_few: 'Display pages must declare @openyida-content-blocks and include at least {1} business-purpose content blocks; KPI groups, quick-entry groups, and list groups each count as one block. Current count: {0}.',
     lint_page_size_limit: 'pageSize={0} exceeds the Yida API limit of 100; use 100 or less',
     lint_page_size_recommend: 'pageSize={0} is large; the recommended value is 50 (best performance, max 100). Prefer 10/20/50',
     lint_searchformdata_http_path: 'A direct searchFormDatas.json call must use /dingtalk/web/<appType>/v1/form/searchFormDatas.json; /query/form/searchFormDatas.json is not a valid form data endpoint',

package/lib/core/locales/zh.js

@@ -1143,7 +1143,6 @@ openyida - 宜搭命令行工具
     lint_iframe_self_navigation: '宜搭自定义页面运行在 iframe 中，跳转宜搭页面时请使用 target="_top"/target="_blank" 或 window.top.location，避免页面套娃',
     lint_form_open_container: '自定义页内打开表单提交/详情只能使用 FormOpenContainer：PC 端用 50vw 抽屉 iframe，移动端才整页或新页打开。按钮事件请调用 openForm({ type: "submission" | "detail", ... })。',
     lint_form_detail_link: '表单详情页必须使用真实 formInstId：优先读取 row.formInstId，缺少实例 ID 时禁用详情入口或提示，不能打开空 formInstId 的 formDetail 链接。',
-    lint_content_blocks_too_few: '展示型页面必须声明 @openyida-content-blocks，且至少包含 {1} 个有业务目的的内容区块；KPI 组、快捷入口组、列表组各只算 1 个区块，当前只有 {0} 个。',
     lint_page_size_limit: 'pageSize={0} 超过宜搭接口上限 100，请改为 100 或更小',
     lint_page_size_recommend: 'pageSize={0} 偏大，推荐使用 50（性能最佳，最大 100），优先选择 10/20/50',
     lint_searchformdata_http_path: '直连 searchFormDatas.json 必须使用 /dingtalk/web/<appType>/v1/form/searchFormDatas.json；/query/form/searchFormDatas.json 不是有效表单数据端点',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.8.12",
+  "version": "2026.8.14",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",