openyida 2026.10.23 → 2026.10.25

package/README.md

@@ -473,6 +473,7 @@ When preparing a PR that needs a personal Fork, or when you ask how to support t
 | `openyida app-entry get <appType> [--json]` | Read frontend and management runtime entries |
 | `openyida app-entry set <appType> [--frontend <url>\|--frontend-page <formUuid>] [--management <url>\|--management-page <formUuid>] [--clear-frontend] [--clear-management] [--json]` | Register application entries with partial update and readback |
 | `openyida app-list [--type managed\|created] [--page N] [--size N]` | Page through apps I manage or created |
+| `openyida solution-template <search\|detail\|prepare\|ai-build\|enable\|status> [templateId\|requestId] [options] [--json]` | Solution templates for independent local agents: discovery, cloud AI handoff and direct enable |
 | `openyida corp-efficiency [overview\|details\|detail\|groups\|notify] [options] [--open\|--no-open]` | Query enterprise efficiency overview and detail reports |
 | `openyida create-app "<name>"\|--name <name> [options] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a Yida app |
 | `openyida design-plan catalog [--json]` | List available planning themes and page patterns |
@@ -534,7 +535,7 @@ When preparing a PR that needs a personal Fork, or when you ask how to support t
 | Command | Description |
 |---------|-------------|
 | `openyida data <query\|get\|create\|update\|transfer> <resource> ... \| delete form <appType> <formUuid> --inst-id <id> --expect-form-name <name> --expect-form-type receipt --confirm [--json]` | Unified data management (form/process/task/subform) |
-| `openyida task-center <todo\|created\|done\|cc\|proxy\|capabilities\|scaffold\|options\|inspect\|count> [--spec <file.json> --output <file.canvas.jsx>] [options]` | Global task center (todo/processed/cc etc.) |
+| `openyida task-center <todo\|created\|done\|cc\|proxy\|capabilities\|link\|scaffold\|options\|inspect\|count> [--spec <file.json> --output <file.canvas.jsx>] [options]` | Global task center (todo/processed/cc etc.) |
 | `openyida basic-info <overview\|commodity\|grant\|capacity\|quota\|abs-path\|dataflow\|i18n\|domain>` | Query organization basic info, capacity, quotas, and domain settings |
 | `openyida read-dingtalk-doc <docUrl> [--output <file>] [--json]` | Fetch Markdown content from a DingTalk document |
 | `openyida read-dingtalk-tingji <taskUuid> [--json]` | Fetch DingTalk Tingji details by task UUID |

package/bin/yida.js

@@ -588,6 +588,10 @@ async function main() {
     }
     return;
   }
+  // Template-only preflight; managed runs retain their existing guard contract.
+  if (command === 'solution-template' && !hasHelpFlag(rawArgs) && !readManagedContext()) {
+    require('../lib/solution-template/solution-template').assertIndependentLocalAgent();
+  }
   commandReceipt = beginCommandReceipt({ command, args: rawArgs });
   process.once('exit', code => {
     try {commandReceipt.finish(code);} catch {process.exitCode = 1;}
@@ -790,6 +794,12 @@ async function main() {
       break;
     }
 
+    case 'solution-template': {
+      const { run } = require('../lib/solution-template/solution-template');
+      await run(args);
+      break;
+    }
+
     case 'corp-efficiency': {
       const { run } = require('../lib/corp-efficiency/corp-efficiency');
       await run(args);

package/lib/app/services/canvas-page-schema-builder.js

@@ -10,7 +10,16 @@ const {
   findEmojiInValue,
 } = require('../../core/no-emoji-detector');
 
-const CANVAS_YIDA_API_BRIDGE_SOURCE = `var OPENYIDA_YIDA_FORM_API_METHODS = [
+const { createPageNavigation } = require('../../navigation/page-navigation');
+const { createTaskCenterContract } = require('../../task-center/contract');
+const { createTaskCenterLoader } = require('../../task-center/loader');
+const { createTaskCenterNavigation } = require('../../task-center/navigation');
+
+const CANVAS_YIDA_API_BRIDGE_SOURCE = `${createPageNavigation.toString()}
+${createTaskCenterNavigation.toString()}
+${createTaskCenterContract.toString()}
+${createTaskCenterLoader.toString()}
+var OPENYIDA_YIDA_FORM_API_METHODS = [
   'saveFormData',
   'updateFormData',
   'searchFormDataIds',
@@ -239,8 +248,15 @@ function openyidaCreateRouterBridge(utils) {
 
 function openyidaCreateUtilsBridge(context, yidaBridge) {
   var utils = context && context.utils;
+  var navigation = createPageNavigation(window);
+  var taskNavigation = createTaskCenterNavigation();
+  var taskCounts = createTaskCenterLoader(createTaskCenterContract(), function() { return yidaBridge; });
   var methodNames = openyidaCollectUtilsMethodNames(utils);
   function invoke(methodName) {
+    if (methodName === 'openPage') { return navigation.open.apply(null, Array.prototype.slice.call(arguments, 1)); }
+    if (['taskCenterCount', 'taskCenterLink', 'openTaskCenter'].indexOf(methodName) !== -1) {
+      return bridge[methodName].apply(null, Array.prototype.slice.call(arguments, 1));
+    }
     if (!utils || typeof utils[methodName] !== 'function') {
       throw new Error('this.utils.' + methodName + ' is not available');
     }
@@ -251,6 +267,8 @@ function openyidaCreateUtilsBridge(context, yidaBridge) {
     apiGroups: {
       utility: OPENYIDA_UTIL_API_METHODS.slice(),
       router: ['push'],
+      navigation: ['openPage', 'taskCenterLink', 'openTaskCenter'],
+      tasks: ['taskCenterCount'],
       yida: OPENYIDA_KNOWN_YIDA_API_METHODS.slice()
     },
     knownMethods: OPENYIDA_UTIL_API_METHODS.slice(),
@@ -259,9 +277,33 @@ function openyidaCreateUtilsBridge(context, yidaBridge) {
       return !utils || typeof utils[methodName] !== 'function';
     }),
     invoke: invoke,
+    openPage: navigation.open,
+    taskCenterLink: function(options) {
+      return taskNavigation.target(Object.assign({ baseUrl: window.location.origin }, options));
+    },
+    taskCenterCount: async function(options) {
+      if (!options || typeof options !== 'object' || Array.isArray(options)
+        || Object.keys(options).some(function(key) { return ['scope', 'appType', 'kind', 'filters'].indexOf(key) === -1; })) {
+        var error = new Error('TASK_FILTER_INVALID: options');
+        error.code = 'TASK_FILTER_INVALID';
+        throw error;
+      }
+      var target = taskNavigation.target({ scope: options.scope, appType: options.appType, kind: options.kind, baseUrl: window.location.origin });
+      var filters = createTaskCenterContract().normalizeFilters(target.kind, options.filters === undefined ? {} : options.filters, 'app-query');
+      return taskCounts.count(target.kind, Object.assign({}, filters, { transport: 'app-query' },
+        target.scope === 'corp' ? { scope: 'corp' } : { appType: target.appType }));
+    },
+    openTaskCenter: function(options) {
+      var target = taskNavigation.target(Object.assign({ baseUrl: window.location.origin }, options));
+      return navigation.open(target.pageUrl, { mode: target.mode });
+    },
     router: openyidaCreateRouterBridge(utils),
     yida: yidaBridge
   };
+  ['openPage', 'taskCenterLink', 'openTaskCenter', 'taskCenterCount'].forEach(function(methodName) {
+    if (bridge.availableMethods.indexOf(methodName) === -1) { bridge.availableMethods.push(methodName); }
+  });
+  bridge.missingKnownMethods = bridge.missingKnownMethods.filter(function(name) { return name !== 'openPage'; });
   methodNames.forEach(function(methodName) {
     if (!bridge[methodName]) {
       bridge[methodName] = function() {

package/lib/core/command-manifest.js

@@ -556,6 +556,13 @@ const COMMAND_SIDE_EFFECTS = new Map([
     mutating_actions: ['create', 'update', 'delete'],
   })],
   ['cool-card', sideEffect('mixed', { mutates_yida: true, mutates_local: true, read_actions: ['list', 'templates', 'get'], mutating_actions: ['create'] })],
+  ['solution-template', sideEffect('mixed', {
+    mutates_yida: true,
+    mutates_local: true,
+    read_actions: ['search', 'detail', 'prepare', 'ai-build', 'status'],
+    mutating_actions: ['enable'],
+    note: 'Direct enable writes a durable local request receipt before the one-shot platform copy. AI build only validates the template and returns the native builder handoff.',
+  })],
   ['data-card', sideEffect('mixed', { mutates_yida: true, mutates_local: true, read_actions: ['list', 'get', 'probe', 'release-check', 'refs'], mutating_actions: ['create', 'save', 'publish', 'release-get', 'release-save', 'release-test'], note: 'release-get reads broadcast settings but the native backend may initialize the application cool app; classify it conservatively as a possible mutation.' })],
   ['print-template', sideEffect('mixed', printTemplateEffects)],
   ['form-view', sideEffect('mixed', {
@@ -683,7 +690,7 @@ const COMMAND_SIDE_EFFECTS = new Map([
   ['task-center', sideEffect('mixed', {
     mutates_yida: false,
     mutates_local: true,
-    read_actions: ['todo', 'created', 'done', 'cc', 'proxy', 'capabilities', 'options', 'inspect', 'count'],
+    read_actions: ['todo', 'created', 'done', 'cc', 'proxy', 'capabilities', 'link', 'options', 'inspect', 'count'],
     mutating_actions: ['scaffold'],
   })],
 ]);
@@ -855,6 +862,7 @@ const COMMAND_PERMISSIONS = new Map([
 
   ...permissionEntries(['print-template'], actionDependentPermission(printTemplatePermission)),
   ...permissionEntries(['cool-card'], actionDependentPermission({ preauthorized_actions: ['create'] })),
+  ...permissionEntries(['solution-template'], actionDependentPermission({ ask_actions: ['enable'] })),
   ...permissionEntries(['data-card'], actionDependentPermission({ preauthorized_actions: ['create', 'save', 'publish', 'release-get'], ask_actions: ['release-save', 'release-test'] })),
   ...permissionEntries([
     'form-view',
@@ -1249,6 +1257,34 @@ const COMMAND_GROUPS = [
       command('app-list', ['app-list'], 'app-list [--type managed|created] [--page N] [--size N]', 'help.cmd_app_list', { managedRun: {'scope':'denied','reason':'scope_not_audited'},
         notes: ['Successful results include appUrl/workbenchUrl for the business workspace and adminUrl for developer administration. Complete application delivery retains adminUrl regardless of auth runtime; route construction does not verify recipient access. Preserve the frontend URL from its own page result.'],
       }),
+      command('solution-template', ['solution-template'], 'solution-template <search|detail|prepare|ai-build|enable|status> [templateId|requestId] [options] [--json]', 'solution_template.description', {
+        managedRun: { scope: 'denied', reason: 'creates_new_application_or_requires_native_builder_handoff' },
+        output: 'json',
+        args: [
+          { name: 'action', type: 'string', source: 'positional', position: 0, required: true, choices: ['search', 'detail', 'prepare', 'ai-build', 'enable', 'status'] },
+          { name: 'identity', type: 'string', source: 'positional', position: 1, description: 'TPL_ template ID for detail/prepare/ai-build/enable; durable request ID for status.' },
+          { name: 'query', type: 'string', source: 'option', builder_options: ['--query'] },
+          { name: 'scene', type: 'string', source: 'option', builder_options: ['--scene'] },
+          { name: 'industry', type: 'string', source: 'option', builder_options: ['--industry'] },
+          { name: 'name', type: 'string', source: 'option', builder_options: ['--name'] },
+          { name: 'withData', type: 'string', source: 'option', builder_options: ['--with-data'], choices: ['y', 'n'] },
+          { name: 'requestId', type: 'string', source: 'option', builder_options: ['--request-id'] },
+          { name: 'retry', type: 'boolean', source: 'option', builder_options: ['--retry'], description: 'Explicitly retry a platform-rejected enable attempt; never replay an uncertain request.' },
+          { name: 'wait', type: 'string', source: 'option', builder_options: ['--wait'], description: 'Readback wait budget, 0-60 seconds. Default: enable 10, status 0.' },
+          { name: 'page', type: 'string', source: 'option', builder_options: ['--page'] },
+          { name: 'size', type: 'string', source: 'option', builder_options: ['--size'] },
+          { name: 'json', type: 'boolean', source: 'option', builder_options: ['--json'] },
+        ],
+        examples: [
+          'openyida solution-template search --query "合同" --json',
+          'openyida solution-template detail TPL_XXX --json',
+          'openyida solution-template prepare TPL_XXX --name "合同管理" --with-data n --json',
+          'openyida solution-template ai-build TPL_XXX --json',
+          'openyida solution-template enable TPL_XXX --name "合同管理" --with-data y --json',
+          'openyida solution-template status st-xxxxxxxx --json',
+        ],
+        notes: ['Independent local agents only: reject cloud/bound contexts, managed local runs and unknown environments before auth, HTTP or receipt writes. Help and command discovery remain available. Cloud native templateReference/PRD building continues inside the bound app and must not use this command. ai-build only hands the user a cloud builder URL; it does not run template AI generation locally. Search currently excludes SaaS templates.', 'Use only for an explicit user request to operate on Solution Center templates or to continue an already confirmed template task within its authorized scope. Ordinary app creation stays with yida-app; do not automatically search, recommend, enable or fall back to a template. A query, reference link, generic creation permission or AI handoff is not consent to enable. Enable, retry after rejection and an additional copy each require explicit user authorization. search/detail/prepare are read-only. prepare summarizes the organization/environment, template version, name, sample data and existing apps/requests; source availability is not permission to enable. Permissions and entitlements are decided exclusively by the platform on submit. ai-build only returns the native builder handoff. enable writes a durable receipt before a one-shot copy and waits up to 10 seconds for app-list readback; --wait 0-60 controls this budget. Rejected attempts retain the platform error, never claim later same-name apps, and require explicit --retry to submit again. Unknown outcomes only allow readback, including with --retry. Repeating a completed request returns its app without re-copying; use a distinct request ID only for an explicitly requested additional copy. applicationVerified reports current readback, while previouslyVerified/lastVerifiedAt retain historical creation evidence. No percentage progress or background polling.'],
+      }),
       command('corp-efficiency', ['corp-efficiency'], 'corp-efficiency [overview|details|detail|groups|notify] [options] [--open|--no-open]', 'help.cmd_corp_efficiency', { managedRun: { scope: 'denied', reason: 'scope_not_audited' },
         output: 'json',
       }),
@@ -1821,10 +1857,11 @@ const COMMAND_GROUPS = [
           'openyida data transfer task APP_XXX --process-inst-id PINST_XXX --form-uuid FORM_XXX --to-user-id USER_ID --expect-form-name "Approval form" --expect-form-type process --json',
         ],
       }),
-      command('task-center', ['task-center'], 'task-center <todo|created|done|cc|proxy|capabilities|scaffold|options|inspect|count> [--spec <file.json> --output <file.canvas.jsx>] [options]', 'help.cmd_task_center', {
+      command('task-center', ['task-center'], 'task-center <todo|created|done|cc|proxy|capabilities|link|scaffold|options|inspect|count> [--spec <file.json> --output <file.canvas.jsx>] [options]', 'help.cmd_task_center', {
         requiresLogin: false,
         managedRun: { scope: 'actions', actions: {
           capabilities: { scope: 'local', allowedFlags: ['--json'] },
+          link: { scope: 'local', allowedFlags: ['--scope', '--type', '--base-url', '--mode', '--json'] },
           scaffold: { scope: 'local' },
           options: { scope: 'app', appPosition: 1 },
           inspect: { scope: 'app', appPosition: 1 },
@@ -1833,13 +1870,16 @@ const COMMAND_GROUPS = [
         output: 'json',
         examples: [
           'openyida task-center capabilities --json',
+          'openyida task-center link APP_XXX --scope app --type todo --base-url https://tenant.aliwork.com --json',
+          'openyida task-center link --scope corp --type cc --base-url https://tenant.aliwork.com --json',
+          'openyida task-center count --scope corp --type created --json',
           'openyida task-center options APP_XXX --type originators --keyword 张 --json',
           'openyida task-center inspect APP_XXX --process-inst-id INSTANCE_REPLACE --form-uuid FORM_REPLACE --json',
           'openyida task-center inspect APP_XXX --process-inst-id INSTANCE_REPLACE --history --task-id TASK_REPLACE --json',
           'openyida task-center count APP_XXX --type todo --transport app-query --filters-json \'{"keyword":"采购"}\' --json',
           'openyida task-center scaffold --spec workflow-spec.json --output project/pages/src/progress.canvas.jsx',
         ],
-        notes: ['capabilities describes application task kinds, filters, lookup options, workflow read models and scaffold specs. inspect <appType> --process-inst-id ID [--history] [--task-id ID] reads authorized process progress and optional history; taskResult matches a task, without asserting visitor ownership. count <appType> --type KIND [--transport app-query] [--filters-json JSON] reads one list record and its server total; unknown totals stay null. Neither read command requires a custom-page choice. The tasks scaffold selects fields, filterFields and optional expandProcess; the progress view exports ProcessProgressSection for a real linked instance. options <appType> --type originators|processes|forms --keyword TEXT --size N --json reads current-visitor lookup candidates. scaffold creates a new local Canvas page only after an explicit custom-page request or affirmative ask_human choice, recorded as customPage.source and confirmed=true. A generic task-center request or Fast mode does not provide that choice. Pages use the current visitor and existing application theme; CLI credentials are never embedded. Global queries remain unavailable in application-bound managed runs.'],
+        notes: ['link generates a native app or corporation task-center pageUrl and DingTalk AppLink without opening a browser or writing platform resources. --scope app|corp is required; app requires appType, corp rejects appType. --base-url allows offline URL generation; otherwise the active auth environment supplies the origin. --mode defaults to auto: browser pages stay in the browser and DingTalk pages use native openLink with ddtab=true; generating a link cannot detect a future page visitor environment. Explicit dingtalk mode adds ddtab=true. count --scope corp uses app-query with appKeys=[]; explicit --scope app defaults to app-query, while legacy count without --scope retains app-v1 compatibility. Scope must be clarified with the user when ambiguous. Published utilities expose openPage(url, {mode: auto|dingtalk|browser}), taskCenterLink and openTaskCenter. DingTalk mode never silently falls back to a browser. capabilities describes application task kinds, filters, lookup options, workflow read models and scaffold specs. inspect <appType> --process-inst-id ID [--history] [--task-id ID] reads authorized process progress and optional history; taskResult matches a task, without asserting visitor ownership. count <appType> --type KIND [--transport app-query] [--filters-json JSON] reads one list record and its server total; unknown totals stay null. Neither read command requires a custom-page choice. The tasks scaffold selects fields, filterFields and optional expandProcess; the progress view exports ProcessProgressSection for a real linked instance. options <appType> --type originators|processes|forms --keyword TEXT --size N --json reads current-visitor lookup candidates. scaffold creates a new local Canvas page only after an explicit custom-page request or affirmative ask_human choice, recorded as customPage.source and confirmed=true. A generic task-center request or Fast mode does not provide that choice. Pages use the current visitor and existing application theme; CLI credentials are never embedded. Global queries remain unavailable in application-bound managed runs.'],
       }),
       command('basic-info', ['basic-info'], 'basic-info <overview|commodity|grant|capacity|quota|abs-path|dataflow|i18n|domain>', 'help.cmd_basic_info', { managedRun: { scope: 'denied', reason: 'scope_not_audited' },
         output: 'json',

package/lib/core/locales/en.js

@@ -32,6 +32,21 @@ module.exports = {
   },
   dws_external: {'note': 'dws is an independent external tool. OpenYida only shows installation instructions; it does not download or install it.', 'install_guide': 'Show official DingTalk CLI installation instructions'},
   cool_card: {'unsupported_environment': 'The Alibaba Group edition does not support building cool cards.', 'description': 'Create and read native YiDA cool cards (interactive and pinned)', 'usage': 'Usage: openyida cool-card <list|templates|create|get> <appType> [cardPageCode] [--type im|onebox] [--name <title>] [--page <n>] [--size <n>] [--search <text>] [--out <file>] [--json]', 'failed': 'Native cool card operation stopped: {0}'},
+  solution_template: {
+    description: 'Solution templates for independent local agents: discovery, cloud AI handoff and direct enable',
+    local_agent_only: 'Template commands require a recognized independent local agent. Cloud template AI keeps its native workflow.',
+    usage: 'Usage: openyida solution-template search [--query <text>] [--scene <scene>] [--industry <industry>] [--page <n>] [--size <n>] [--json]\n       openyida solution-template detail <TPL_...> [--json]\n       openyida solution-template prepare <TPL_...> --name <appName> [--with-data y|n] [--request-id <id>] [--json]\n       openyida solution-template ai-build <TPL_...> [--json]\n       openyida solution-template enable <TPL_...> --name <appName> [--with-data y|n] [--request-id <id>] [--retry] [--wait <0-60>] [--json]\n       openyida solution-template status <requestId> [--wait <0-60>] [--json]',
+    failed: 'Solution Center template operation stopped: {0}',
+    ai_build_handoff: 'The template supports native AI build. Add customization requirements and submit them in the native builder. This receipt does not mean an app exists.',
+    no_progress_api: 'The platform currently exposes no pollable percentage progress. The request receipt and app-list readback are preserved, but resubmission is still unsafe.',
+    platform_decides: 'Permissions and entitlements are decided by the platform when enabling. Template source availability does not confirm authorization.',
+    rejected: 'The platform rejected this attempt. The platform reason is preserved. A new submission requires an explicit retry; OpenYida does not change permissions or entitlements.',
+    pending: 'The application is not visible yet. The request is preserved; check its status to continue without submitting again.',
+    accepted: 'The platform accepted the request. Checking for the application entry.',
+    waiting: 'Waiting for the application to appear. Only checking status; no new copy request is sent.',
+    no_longer_visible: 'This application was verified previously but is not visible in the current query. Creation history is preserved; current access is not confirmed.',
+    readback_failed: 'The application query failed. The request and platform reason are preserved; check status again without resubmitting.',
+  },
   data_card: {'description':'Create, configure, publish and distribute native YiDA data cards','usage':'Usage: openyida data-card <list|create|get|save|publish|probe|release-get|release-save|release-check|release-test|refs> <appType> [cardCode] [--name <title>] [--description <text>] [--schema <file>|--config <file>] [--expected-hash <hash>] [--backup <file>] [--out <file>] [--published|--version <version>] [--page <n>] [--size <n>] [--search <text>] [--allow-send] [--json]','failed':'Native data card operation stopped: {0}','conflict':'The draft changed. Read it again before saving or publishing.','mismatch':'Readback does not match the expected schema or published state. Keep the backup and inspect the card before retrying.'},
   app_settings: {'description':'Read theme, frontend/backend, native data card and cool card management links','usage':'Usage: openyida app-settings <appType> [--section theme|basic|data-card|cool-card] [--json]','failed':'Application settings could not be read: {0}'},
   form_view: {

package/lib/core/locales/zh.js

@@ -32,6 +32,21 @@ module.exports = {
   },
   dws_external: {'note': 'dws 是独立的外部工具；OpenYida 仅提供安装指引，不下载或安装它。', 'install_guide': '显示钉钉 CLI 官方安装指引'},
   cool_card: {'unsupported_environment': '集团版不支持酷卡片搭建。', 'description': '创建和读取宜搭原生酷卡片（交互卡片与置顶卡片）', 'usage': '用法： openyida cool-card <list|templates|create|get> <appType> [cardPageCode] [--type im|onebox] [--name <title>] [--page <n>] [--size <n>] [--search <text>] [--out <file>] [--json]', 'failed': '原生酷卡片操作已停止：{0}'},
+  solution_template: {
+    description: '独立本地 Agent 的方案模板查询、云端 AI 搭建入口与直接启用',
+    local_agent_only: '请在已识别的独立本地 Agent 中使用模板命令；云端继续平台原生模板 AI 搭。',
+    usage: '用法： openyida solution-template search [--query <文本>] [--scene <场景>] [--industry <行业>] [--page <n>] [--size <n>] [--json]\n       openyida solution-template detail <TPL_...> [--json]\n       openyida solution-template prepare <TPL_...> --name <应用名> [--with-data y|n] [--request-id <id>] [--json]\n       openyida solution-template ai-build <TPL_...> [--json]\n       openyida solution-template enable <TPL_...> --name <应用名> [--with-data y|n] [--request-id <id>] [--retry] [--wait <0-60>] [--json]\n       openyida solution-template status <requestId> [--wait <0-60>] [--json]',
+    failed: '方案中心模板操作已停止：{0}',
+    ai_build_handoff: '已验证模板支持 AI 搭建；请在原生搭建页补充定制需求并提交。此回执不表示应用已创建。',
+    no_progress_api: '平台当前未提供可轮询的百分比进度；已保留请求记录并完成应用列表回读，仍不能安全重提。',
+    platform_decides: '权限和权益由平台在启用时判断；模板有可复制版本不代表当前账号已获授权。',
+    rejected: '平台已拒绝本次启用，已保留平台原因。再次提交需要显式重试；OpenYida 不修改权限或权益。',
+    pending: '应用暂未出现在列表，已保留请求记录；可继续查询状态，无需重复提交。',
+    accepted: '平台已受理启用请求，正在确认应用入口。',
+    waiting: '正在等待应用出现在列表，仅查询状态，不重复创建。',
+    no_longer_visible: '此应用曾确认创建，但本次查询暂不可见；保留创建记录，当前访问状态尚未确认。',
+    readback_failed: '应用查询失败，已保留请求记录和平台原因；请继续查询状态，勿重复提交。',
+  },
   data_card: {'description':'创建、配置、发布原生数据卡片并管理投放播报','usage':'用法： openyida data-card <list|create|get|save|publish|probe|release-get|release-save|release-check|release-test|refs> <appType> [cardCode] [--name <title>] [--description <text>] [--schema <file>|--config <file>] [--expected-hash <hash>] [--backup <file>] [--out <file>] [--published|--version <version>] [--page <n>] [--size <n>] [--search <text>] [--allow-send] [--json]','failed':'原生数据卡片操作已停止：{0}','conflict':'卡片草稿已发生变化，请重新读取后再保存或发布。','mismatch':'回读配置或发布状态与预期不一致，请保留备份并检查卡片后再重试。'},
   app_settings: {'description':'获取主题、业务前后台、原生数据卡片和酷卡片管理入口','usage':'用法： openyida app-settings <appType> [--section theme|basic|data-card|cool-card] [--json]','failed':'无法读取应用设置：{0}'},
   form_view: {

package/lib/core/task-center.js

@@ -50,11 +50,13 @@ Usage:
   --keyword TEXT 搜索关键词
   --no-detail    不返回详情（仅 created 类型支持）
 
+  openyida task-center link [appType] --scope app|corp --type todo|created|done|cc [--base-url URL] [--mode dingtalk|auto|browser] --json
+  openyida task-center count --scope corp --type todo|created|done|cc [--filters-json JSON] --json
   openyida task-center capabilities --json
   openyida task-center scaffold --spec <file.json> --output <file.canvas.jsx>
   openyida task-center options <appType> --type <originators|processes|forms> [--keyword TEXT] [--size N] --json
   openyida task-center inspect <appType> --process-inst-id <id> [--form-uuid <id>] [--history] [--task-id <id>] --json
-  openyida task-center count <appType> --type <todo|created|done|cc> [--transport app-v1|app-query] [--filters-json <json>] --json
+  openyida task-center count <appType> [--scope app] --type <todo|created|done|cc> [--transport app-v1|app-query] [--filters-json <json>] --json
 `;
 
 // ── 工具函数 ──────────────────────────────────────────
@@ -217,6 +219,26 @@ async function run(args) {
     return result;
   }
 
+  if (type === 'link') {
+    const allowed = ['scope', 'type', 'base_url', 'mode', 'json'];
+    const invalid = Object.keys(options).find(key => !allowed.includes(key));
+    if (invalid || positionals.length > 2 || options.json !== undefined && options.json !== true) {
+      fail(t('task_center.invalid_spec', invalid || 'arguments'));
+    }
+    if (!['app', 'corp'].includes(options.scope)) { fail(t('task_center.invalid_spec', 'scope')); }
+    const baseUrl = options.base_url === undefined ? (await ensureSession()).baseUrl : options.base_url;
+    const target = require('../task-center/navigation').target({
+      scope: options.scope, kind: options.type, baseUrl, mode: options.mode,
+      ...(positionals[1] !== undefined ? { appType: positionals[1] } : {}),
+    });
+    const nativeTarget = require('../task-center/navigation').target({ scope: options.scope, kind: options.type, baseUrl, mode: 'dingtalk',
+      ...(positionals[1] !== undefined ? { appType: positionals[1] } : {}) });
+    const dingtalkUrl = require('../dingtalk/dingtalk-link').buildDingTalkPageLink({ url: nativeTarget.pageUrl });
+    const result = { ...target, dingtalkUrl, opened: false };
+    console.log(JSON.stringify(result, null, 2));
+    return result;
+  }
+
   if (type === 'options') {
     const invalid = Object.keys(options).find(key => !['type', 'keyword', 'size', 'json'].includes(key));
     if (invalid || positionals.length !== 2) { fail(t('task_center.invalid_spec', invalid || 'arguments')); }
@@ -234,9 +256,9 @@ async function run(args) {
   }
 
   if (type === 'inspect' || type === 'count') {
-    const allowed = type === 'inspect' ? ['process_inst_id', 'form_uuid', 'task_id', 'history', 'json'] : ['type', 'transport', 'filters_json', 'json'];
+    const allowed = type === 'inspect' ? ['process_inst_id', 'form_uuid', 'task_id', 'history', 'json'] : ['type', 'transport', 'filters_json', 'scope', 'json'];
     const invalid = Object.keys(options).find(key => !allowed.includes(key));
-    if (invalid || positionals.length !== 2 || options.json !== undefined && options.json !== true || options.history !== undefined && options.history !== true) {
+    if (invalid || (positionals.length !== 2 && !(type === 'count' && options.scope === 'corp' && positionals.length === 1)) || options.json !== undefined && options.json !== true || options.history !== undefined && options.history !== true) {
       fail(t('task_center.invalid_spec', invalid || 'arguments'));
     }
     const tasks = require('../task-center/contract');
@@ -251,7 +273,13 @@ async function run(args) {
       if (options.filters_json !== undefined) {
         try { filters = JSON.parse(options.filters_json); } catch { fail(t('task_center.invalid_spec', 'filters-json')); }
       }
-      input = { ...tasks.normalizeFilters(options.type, filters, options.transport), appType: tasks.appOf(positionals[1]), transport: tasks.transportOf(options.transport) };
+      if (options.scope !== undefined && !['app', 'corp'].includes(options.scope)) { fail(t('task_center.invalid_spec', 'scope')); }
+      if (options.scope === 'corp' && positionals[1] !== undefined) { fail(t('task_center.invalid_spec', 'appType')); }
+      const transport = options.transport || (options.scope !== undefined ? 'app-query' : undefined);
+      input = { ...tasks.normalizeFilters(options.type, filters, transport),
+        ...(options.scope === 'corp' ? { scope: 'corp' } : { appType: tasks.appOf(positionals[1]) }),
+        transport: tasks.transportOf(transport) };
+      if (input.scope === 'corp' && input.transport !== 'app-query') { fail(t('task_center.invalid_spec', 'transport')); }
     }
     const client = createYidaClient({ authRef: await ensureSession() });
     const request = descriptor => client.get(descriptor.path, { _api: 'nattyFetch', _mock: 'false', ...descriptor.params });

package/lib/navigation/page-navigation.js

@@ -0,0 +1,62 @@
+'use strict';
+
+// Portable: publish injects this exact implementation into the page utility bridge.
+function createPageNavigation(win) {
+  function fail(code) {
+    const error = new Error(code);
+    error.code = code;
+    throw error;
+  }
+  function normalize(input, options) {
+    const value = input && typeof input === 'object' && !Array.isArray(input) ? input.url : input;
+    if (typeof value !== 'string' || !value.trim()) { fail('PAGE_URL_INVALID'); }
+    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) { fail('PAGE_OPEN_OPTIONS_INVALID'); }
+    const mode = (options && options.mode) || 'auto';
+    if (!['auto', 'dingtalk', 'browser'].includes(mode)) { fail('PAGE_OPEN_MODE_INVALID'); }
+    let url;
+    try { url = new URL(value, win.location.href || win.location.origin); } catch { fail('PAGE_URL_INVALID'); }
+    if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password) { fail('PAGE_URL_INVALID'); }
+    const inDingTalk = /dingtalk/i.test((win.navigator && win.navigator.userAgent) || '');
+    const useDingTalk = mode === 'dingtalk' || (mode === 'auto' && inDingTalk);
+    if (useDingTalk) { url.searchParams.set('ddtab', 'true'); }
+    return { url: url.href, mode, inDingTalk, useDingTalk };
+  }
+  function invokeNative(invoke, url) {
+    return new Promise((resolve, reject) => {
+      function success(value) { clearTimeout(timer); resolve(value); }
+      function rejectOpen(reason) {
+        clearTimeout(timer);
+        const error = new Error('DINGTALK_OPEN_FAILED');
+        error.code = 'DINGTALK_OPEN_FAILED';
+        error.cause = reason;
+        reject(error);
+      }
+      const timer = setTimeout(() => rejectOpen('timeout'), 15000);
+      try {
+        const result = invoke({ url, onSuccess: success, onFail: rejectOpen });
+        if (result && typeof result.then === 'function') { result.then(success, rejectOpen); }
+      } catch (error) { rejectOpen(error); }
+    });
+  }
+  async function open(input, options) {
+    const target = normalize(input, options);
+    if (!target.useDingTalk) {
+      win.open(target.url, '_blank', 'noopener,noreferrer');
+      return;
+    }
+    if (!target.inDingTalk) { fail('DINGTALK_ENV_REQUIRED'); }
+    // Use the publishing host's bridge. Do not scan parent DOM or cross-origin windows.
+    const dd = win.dd;
+    if (dd && dd.env && dd.env.platform === 'notInDingTalk') { fail('DINGTALK_API_UNAVAILABLE'); }
+    if (dd && dd.biz && dd.biz.util && typeof dd.biz.util.openLink === 'function') {
+      return invokeNative(options => dd.biz.util.openLink(options), target.url);
+    }
+    if (win.Ali && typeof win.Ali.pushWindow === 'function') {
+      return invokeNative(options => win.Ali.pushWindow(options), target.url);
+    }
+    fail('DINGTALK_API_UNAVAILABLE');
+  }
+  return { normalize, open };
+}
+
+module.exports = { createPageNavigation };

package/lib/samples/openyida-scaffold/canvas-navigation.jsx

@@ -46,8 +46,12 @@ function navigateCanvasPage(entry, context = {}) {
   }
   const href = buildCanvasPageUrl(entry, context);
   const utils = context.utils || window.__OPENYIDA_UTILS__;
-  if (entry.openMode === 'new-tab' || entry.targetType === 'url') {
-    if (typeof utils?.openPage === 'function') return utils.openPage({ url: href });
+  if (entry.openMode === 'dingtalk' || entry.openMode === 'new-tab' || entry.targetType === 'url') {
+    if (typeof utils?.openPage === 'function') return entry.openMode === 'dingtalk'
+      ? utils.openPage(href, { mode: 'dingtalk' }) : utils.openPage(href);
+    if (entry.openMode === 'dingtalk' || /dingtalk/i.test(window.navigator?.userAgent || '')) {
+      throw new Error('DINGTALK_API_UNAVAILABLE');
+    }
     window.open(href, '_blank', 'noopener,noreferrer');
     return;
   }