openyida 2026.8.13 → 2026.8.16-beta.0

package/README.md

@@ -68,9 +68,9 @@ OpenYida returns a compact machine-readable summary with the version, login stat
 openyida login
 ```
 
-OpenYida login defaults to OAuth token mode. It opens the DingTalk OAuth authorization page, receives the local loopback callback, exchanges `code` / `authCode` with the Yida server, and stores `access_token` / `refresh_token` in the current project cache.
+OpenYida login defaults to OAuth token mode. It opens the DingTalk OAuth authorization page, receives the local loopback callback, exchanges `code` / `authCode` with the Yida server, and stores `access_token` / `refresh_token` in the user auth store when available. If the user auth store is not writable, OpenYida explicitly falls back to the current project cache and reports that narrower persistence scope.
 
-When the user names a target Yida entry URL, pass it to the login command so OpenYida can select the matching environment and token session file. For example, Alibaba intranet Yida uses `auth-token-alibaba.json`:
+When the user names a target Yida entry URL, pass it to the login command so OpenYida can select the matching environment and auth profile. For example:
 
 ```bash
 openyida login https://yida-group.alibaba-inc.com/
@@ -357,7 +357,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 
 | Command | Description |
 |---------|-------------|
-| `openyida login [target-url] [--env <name>\|--intl\|--overseas\|--global\|--yidaapps\|--alibaba] [--client-id <clientId>] [--endpoint <url>]` | Login with OAuth token mode |
+| `openyida login [target-url] [--env <name>\|--intl\|--overseas\|--global\|--yidaapps\|--alibaba] [--client-id <clientId>] [--endpoint <url>] [--no-browser]` | Login with OAuth token mode |
 | `openyida logout` | Logout / clear token |
 | `openyida auth <status\|login\|refresh\|logout>` | Token login state management |
 | `openyida org <list\|switch> [--json] [--corp-id <corpId>]` | Organization management (list / switch by OAuth re-login) |
@@ -395,6 +395,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida list-forms <appType> [--keyword <text>]` | List forms/pages in an app |
 | `openyida aggregate-table <list\|create-empty\|inspect\|preview\|save\|publish\|status> <appType> ...` | Manage aggregate tables (virtualView) |
 | `openyida get-schema <appType> <formUuid\|--all> [--summary-json\|--field-map-json]` | Get one form Schema or all form Schemas |
+| `openyida check-prd-completeness <prd.md> --app-type <appType> [--build-manifest <file>] [--json]` | Check PRD page/resource count risk |
 | `openyida er <appType> [--format mermaid\|json] [--output file] [--include-system] [--include-pages]` | Export app entity relationship diagram |
 | `openyida create-page <appType> "<name>" [--mode dashboard] [--hide-nav] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a custom display page |
 | `openyida build-page <sourceFile> [--output file\|--write]` | Build Yida-compatible page source |

package/bin/yida.js

@@ -30,13 +30,22 @@ function isAgentEnvironment(env) {
     env.CLAUDE_CODE_ENTRYPOINT ||
     env.MULERUN_CHAT_ID ||
     env.MULE_DATA_DIR ||
+    env.MULE_WORKSPACE_DIR ||
     env.OPENCODE ||
     env.OPENCODE_CLIENT ||
     env.QODER_IDE ||
     env.QODER_AGENT ||
     env.QODERCLI_INTEGRATION_MODE ||
+    env.QODER_WORK_INTEGRATION_PRODUCT ||
     env.QWENWORK_INTEGRATION_MODE ||
     env.QWENWORKCN_INTEGRATION_MODE ||
+    env.QWENWORK ||
+    env.QWENWORK_CLIENT ||
+    env.QWENWORK_WORKSPACE_DIR ||
+    env.QWENWORK_SANDBOX_ID ||
+    env.QWENWORK_PREVIEW_URL ||
+    env.QWENWORK_VNC_URL ||
+    (env.AGENT_PLATFORM || '').toLowerCase().includes('qwenwork') ||
     env.CURSOR_TRACE_ID ||
     env.AGENT_WORK_ROOT ||
     env.OPENYIDA_AGENT_MODE ||
@@ -266,6 +275,12 @@ function printLoginResult(result) {
     status: result.status || (tokenUsable ? 'ok' : 'token_not_issued'),
     auth_mode: 'token',
     auth_source: result.auth_source || result.authSource,
+    auth_store: result.auth_store || result.authStore,
+    auth_profile: result.auth_profile || result.authProfile,
+    persistence_scope: result.persistence_scope || result.persistenceScope,
+    user_auth_store_writable: result.user_auth_store_writable !== undefined
+      ? result.user_auth_store_writable
+      : result.userAuthStoreWritable,
     can_auto_use: result.can_auto_use !== undefined ? !!result.can_auto_use : tokenUsable,
     token_type: result.token_type || 'Bearer',
     access_token: maskSensitiveAuthOutput({ access_token: result.access_token }).access_token,
@@ -276,6 +291,7 @@ function printLoginResult(result) {
     user_name: result.user_name,
     failure_reason: result.failure_reason,
     message: result.message,
+    warning: result.warning,
     raw: tokenUsable ? undefined : result.raw,
   };
   console.log(JSON.stringify(summary));
@@ -412,6 +428,7 @@ function applyLoginEnvironmentFlags(cliArgs, options = {}) {
   const valuePassthroughFlags = new Set([
     '--corp-id',
     '--client-id',
+    '--profile',
     '--user-id',
   ]);
   const targetUrlFlags = new Set([
@@ -520,6 +537,17 @@ function printLoginHelp() {
   printCommandUsage(t('cli.login_usage'), t('cli.login_example'));
 }
 
+function buildTokenLoginOptions(loginArgs) {
+  return {
+    clientId: getArgValue(loginArgs, '--client-id'),
+    corpId: getArgValue(loginArgs, '--corp-id'),
+    userId: getArgValue(loginArgs, '--user-id'),
+    authProfile: getArgValue(loginArgs, '--profile'),
+    quiet: process.env.YIDA_QUIET === '1' || loginArgs.includes('--quiet'),
+    noBrowser: loginArgs.includes('--no-browser'),
+  };
+}
+
 function printAuthHelp() {
   printCommandUsage(t('cli.auth_usage'), t('cli.auth_example'));
 }
@@ -618,15 +646,12 @@ async function main() {
       } else {
         assertNoUnsupportedLegacyLoginFlags(rawArgs, loginArgs);
         if (loginArgs.includes('--check-only')) {
-          console.log(JSON.stringify(getAuthStatus(), null, 2));
+          console.log(JSON.stringify(getAuthStatus(buildTokenLoginOptions(loginArgs)), null, 2));
         } else if (isEnvAuthMode()) {
-          printLoginResult(getAuthStatus());
+          printLoginResult(getAuthStatus(buildTokenLoginOptions(loginArgs)));
         } else {
           const { tokenLogin } = require('../lib/auth/token-auth');
-          const result = await tokenLogin({
-            clientId: getArgValue(loginArgs, '--client-id'),
-            quiet: loginArgs.includes('--quiet'),
-          });
+          const result = await tokenLogin(buildTokenLoginOptions(loginArgs));
           printLoginResult(result);
         }
       }
@@ -647,18 +672,15 @@ async function main() {
       if (!subCommand || subCommand === '--help' || subCommand === '-h') {
         printAuthHelp();
       } else if (subCommand === 'status') {
-        console.log(JSON.stringify(getAuthStatus(), null, 2));
+        console.log(JSON.stringify(getAuthStatus(buildTokenLoginOptions(authArgs)), null, 2));
       } else if (subCommand === 'login') {
         if (hasHelpFlag(authArgs)) {
           printLoginHelp();
         } else {
           assertNoUnsupportedLegacyLoginFlags(rawArgs.slice(1), authArgs);
           const result = isEnvAuthMode()
-            ? getAuthStatus()
-            : await tokenLogin({
-              clientId: getArgValue(authArgs, '--client-id'),
-              quiet: authArgs.includes('--quiet'),
-            });
+            ? getAuthStatus(buildTokenLoginOptions(authArgs))
+            : await tokenLogin(buildTokenLoginOptions(authArgs));
           printLoginResult(result);
         }
       } else if (subCommand === 'refresh') {
@@ -732,6 +754,12 @@ async function main() {
       break;
     }
 
+    case 'check-prd-completeness': {
+      const { run } = require('../lib/app/check-prd-completeness');
+      await run(args);
+      break;
+    }
+
     case 'er': {
       const { run } = require('../lib/app/er');
       await run(args);

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 反馈材料 | 按故障、需求或性能问题整理成可提交材料 |