openyida 2026.5.12 → 2026.5.13-beta.0

package/README.md

@@ -316,6 +316,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida integration enable <appType> <formUuid> <processCode>` | Enable an automation flow |
 | `openyida integration disable <appType> <formUuid> <processCode>` | Disable an automation flow |
 | `openyida dws <command> [args]` | Access DingTalk CLI capabilities such as contacts, calendar, todo, and approval |
+| `openyida dingtalk-link <url> [--target fullScreen] [--legacy-scheme] [--json]` | Generate DingTalk AppLink URLs for opening pages in DingTalk; use `--legacy-scheme` only when old `dingtalk://` links are required |
 
 ### Utilities
 

package/bin/yida.js

@@ -262,6 +262,15 @@ function shouldUseAgentLogin(cliArgs) {
   return isAgentConversationEnvironment();
 }
 
+function shouldUsePlaywrightFallbackInAgentLogin() {
+  const { detectActiveTool } = require('../lib/core/utils');
+  const activeTool = detectActiveTool();
+  if (activeTool && activeTool.tool === 'wukong') {
+    return true;
+  }
+  return process.env.OPENYIDA_AGENT_PLAYWRIGHT_FALLBACK === '1';
+}
+
 function shouldUseCodexQrLogin(cliArgs) {
   if (cliArgs.includes('--codex-qr') || cliArgs.includes('--agent-qr')) {return true;}
   return false;
@@ -392,7 +401,9 @@ async function main() {
           printLoginResult(cachedResult);
         } else {
           const { interactiveLogin } = require('../lib/auth/login');
-          const browserResult = interactiveLogin({ playwrightFallback: false });
+          const browserResult = interactiveLogin({
+            playwrightFallback: shouldUsePlaywrightFallbackInAgentLogin(),
+          });
           if (browserResult) {
             printLoginResult(browserResult);
           } else {
@@ -879,6 +890,13 @@ async function main() {
       await runDws(args);
       break;
     }
+
+    case 'dingtalk-link': {
+      const { run: runDingTalkLink } = require('../lib/dingtalk/dingtalk-link');
+      await runDingTalkLink(args);
+      break;
+    }
+
     case 'export-conversation': {
       const { exportConversation } = require('../lib/conversation/export-conversation');
       // 解析选项

package/lib/auth/cdp-browser-login.js

@@ -13,6 +13,7 @@ const path = require('path');
 const net = require('net');
 const crypto = require('crypto');
 const { execFileSync, spawn } = require('child_process');
+const { deriveBaseUrlFromCookies, deriveBaseUrlFromUrl } = require('../core/env-manager');
 
 function findBrowserExecutable() {
   if (process.env.OPENYIDA_CHROME_PATH && fs.existsSync(process.env.OPENYIDA_CHROME_PATH)) {
@@ -267,23 +268,19 @@ function createCdpClient(wsUrl) {
 }
 
 function deriveBaseUrl(cookies, fallbackUrl) {
-  const yidaCookie = cookies.find((cookie) =>
-    cookie.name === 'yida_user_cookie' &&
-    cookie.domain &&
-    cookie.domain.includes('aliwork.com'));
-  if (yidaCookie) {
-    return `https://${String(yidaCookie.domain).replace(/^\./, '')}`;
-  }
-
-  const csrfCookie = cookies.find((cookie) => cookie.name === 'tianshu_csrf_token' && cookie.domain);
-  if (csrfCookie && csrfCookie.domain !== '.aliwork.com') {
-    return `https://${String(csrfCookie.domain).replace(/^\./, '')}`;
-  }
+  return deriveBaseUrlFromCookies(cookies, fallbackUrl);
+}
 
+async function getCurrentPageUrl(client, fallbackUrl) {
   try {
-    return new URL(fallbackUrl).origin;
+    const result = await client.send('Runtime.evaluate', {
+      expression: 'window.location.href',
+      returnByValue: true,
+    });
+    const value = result && result.result && result.result.value;
+    return typeof value === 'string' && value ? value : fallbackUrl;
   } catch {
-    return 'https://www.aliwork.com';
+    return fallbackUrl;
   }
 }
 
@@ -334,9 +331,11 @@ async function runCdpBrowserLogin(options = {}) {
         .catch(() => client.send('Storage.getCookies'));
       const cookies = Array.isArray(result.cookies) ? result.cookies : [];
       if (cookies.some((cookie) => cookie.name === 'tianshu_csrf_token' && cookie.value)) {
+        const currentPageUrl = await getCurrentPageUrl(client, target.url || loginUrl);
+        const fallbackBaseUrl = deriveBaseUrlFromUrl(loginUrl, currentPageUrl);
         return {
           cookies,
-          base_url: deriveBaseUrl(cookies, loginUrl),
+          base_url: deriveBaseUrl(cookies, fallbackBaseUrl),
         };
       }
       await new Promise((resolve) => setTimeout(resolve, 2000));

package/lib/auth/login.js

@@ -281,6 +281,10 @@ function interactiveLogin(options = {}) {
     return null;
   }
 
+  if (process.env.OPENYIDA_DISABLE_PLAYWRIGHT_LOGIN === '1') {
+    return null;
+  }
+
   const playwrightPath = getPlaywrightPath();
   if (!playwrightPath) {
     const { error: chalkError3 } = require('../core/chalk');
@@ -295,13 +299,14 @@ function playwrightInteractiveLogin(loginUrl, playwrightPath) {
   const { info: chalkInfo, label: chalkLabel2 } = require('../core/chalk');
   chalkInfo(t('login.browser_opening'));
   chalkLabel2('URL', loginUrl);
+  const envManagerPath = path.join(__dirname, '..', 'core', 'env-manager.js');
 
   // 通过子进程运行异步 playwright 逻辑，避免顶层 await 兼容性问题
   // 使用 require.resolve 获取的绝对路径，确保临时脚本能找到 playwright
   const scriptContent = `
 const playwright = require(${JSON.stringify(playwrightPath)});
 const { chromium } = playwright;
-const { URL } = require('url');
+const { deriveBaseUrlFromCookies, deriveBaseUrlFromUrl } = require(${JSON.stringify(envManagerPath)});
 
 (async () => {
   // 优先使用本地已安装的 Chrome，避免下载 Playwright 内置 Chromium
@@ -339,19 +344,8 @@ const { URL } = require('url');
 
   const currentUrl = page.url();
   const cookies = await context.cookies();
-  // 优先从 yida_user_cookie 的 domain 提取 base_url，兼容专属域名
-  const csrfCookie = cookies.find(c => c.name === 'tianshu_csrf_token');
-  let baseUrl;
-  if (csrfCookie && csrfCookie.domain && csrfCookie.domain !== '.aliwork.com') {
-    baseUrl = 'https://' + csrfCookie.domain.replace(/^\\./, '');
-  } else {
-    try { baseUrl = new URL(currentUrl).origin; } catch { baseUrl = 'https://www.aliwork.com'; }
-  }
-  // 再用 yida_user_cookie 的 domain 覆盖，它是最可靠的来源
-  const yidaCookie = cookies.find(c => c.name === 'yida_user_cookie');
-  if (yidaCookie && yidaCookie.domain && yidaCookie.domain.includes('aliwork.com')) {
-    baseUrl = 'https://' + yidaCookie.domain.replace(/^\\./, '');
-  }
+  const fallbackBaseUrl = deriveBaseUrlFromUrl(${JSON.stringify(loginUrl)}, currentUrl);
+  const baseUrl = deriveBaseUrlFromCookies(cookies, fallbackBaseUrl);
   await browser.close();
 
   console.log(JSON.stringify({ cookies, base_url: baseUrl }));

package/lib/auth/org.js

@@ -23,13 +23,11 @@
 
 const https = require('https');
 const http = require('http');
-const { extractInfoFromCookies } = require('../core/utils');
+const { extractInfoFromCookies, resolveBaseUrl } = require('../core/utils');
 const { saveCookieCache } = require('./login');
 const { saveAuthConfig, loadAuthConfig } = require('./auth');
 const { t } = require('../core/i18n');
 
-const DEFAULT_BASE_URL = 'https://www.aliwork.com';
-
 // ── HTTP 请求工具 ─────────────────────────────────────
 
 /**
@@ -208,19 +206,21 @@ async function switchOrganization(targetCorpId, cookieData) {
   }
 
   try {
+    const baseUrl = resolveBaseUrl(cookieData);
+
     // Step 1: 发起切换请求
     step(1, t('org.step1'), false);
-    const step1Url = `${DEFAULT_BASE_URL}/start.html?corpid=${targetCorpId}&switchCorp=true`;
+    const step1Url = `${baseUrl}/start.html?corpid=${targetCorpId}&switchCorp=true`;
     const step1Result = await httpGetWithCookies(step1Url, cookies, false);
 
     // Step 2: 确认切换
     step(2, t('org.step2'), false);
-    const step2Url = `${DEFAULT_BASE_URL}/start.html?corpid=${targetCorpId}&`;
+    const step2Url = `${baseUrl}/start.html?corpid=${targetCorpId}&`;
     const step2Result = await httpGetWithCookies(step2Url, step1Result.cookies, false);
 
     // Step 3-4: 获取新 Cookie（跟随重定向）
     step(3, t('org.step3'), false);
-    const step3Url = `https://www.aliwork.com/start.html?corpid=${targetCorpId}&`;
+    const step3Url = `${baseUrl}/start.html?corpid=${targetCorpId}&`;
     const step3Result = await httpGetWithCookies(step3Url, step2Result.cookies, false);
 
     // 处理重定向
@@ -235,7 +235,7 @@ async function switchOrganization(targetCorpId, cookieData) {
 
       // 构建完整 URL
       if (!currentUrl.startsWith('http')) {
-        currentUrl = `https://www.aliwork.com${currentUrl}`;
+        currentUrl = new URL(currentUrl, baseUrl).toString();
       }
 
       const redirectResult = await httpGetWithCookies(currentUrl, finalCookies, false);
@@ -261,7 +261,7 @@ async function switchOrganization(targetCorpId, cookieData) {
     }
 
     // 保存新的 Cookie
-    const newBaseUrl = 'https://www.aliwork.com';
+    const newBaseUrl = baseUrl;
     saveCookieCache(finalCookies, newBaseUrl);
 
     // 更新 auth 配置

package/lib/auth/qr-login.js

@@ -24,7 +24,7 @@ const { saveCookieCache } = require('./login');
 const { t } = require('../core/i18n');
 const { warn } = require('../core/chalk');
 
-const { resolveLoginUrl, resolveEndpoint } = require('../core/env-manager');
+const { resolveLoginUrl, resolveEndpoint, deriveBaseUrlFromUrl } = require('../core/env-manager');
 
 function shellQuote(value) {
   return `'${String(value).replace(/'/g, "'\\''")}'`;
@@ -511,16 +511,7 @@ async function resolveCorpSelection(corpList, options = {}) {
 }
 
 function deriveAliworkBaseUrl(fallbackBaseUrl, finalUrl) {
-  try {
-    const parsedUrl = new URL(finalUrl);
-    if (parsedUrl.hostname.endsWith('aliwork.com')) {
-      return parsedUrl.origin;
-    }
-  } catch {
-    // ignore
-  }
-
-  return fallbackBaseUrl;
+  return deriveBaseUrlFromUrl(fallbackBaseUrl, finalUrl);
 }
 
 /**
@@ -530,7 +521,8 @@ function deriveAliworkBaseUrl(fallbackBaseUrl, finalUrl) {
  * @returns {Promise<{ cookieHeader: string, loginPageUrl: string }>}
  */
 async function fetchInitialSession(baseUrl, options = {}) {
-  const loginPageUrl = options.loginUrl || resolveLoginUrl() || `${baseUrl}/workPlatform`;
+  const loginPageUrl = options.loginUrl ||
+    (options.baseUrl ? `${baseUrl}/workPlatform` : (resolveLoginUrl() || `${baseUrl}/workPlatform`));
   const response = await fetchGetFollowRedirects(loginPageUrl, {
     cookieHeader: options.cookieHeader || '',
   });
@@ -1443,5 +1435,6 @@ module.exports = {
     buildAgentQrResponseMarkdown,
     buildNeedQrScanResult,
     getTargetCorpId,
+    deriveAliworkBaseUrl,
   },
 };

package/lib/core/command-manifest.js

@@ -126,6 +126,10 @@ const COMMAND_GROUPS = [
     commands: [
       command('integration.create', ['integration', 'create'], 'integration create <appType> ...', 'help.cmd_integration'),
       command('dws', ['dws'], 'dws <command> [args]', 'help.cmd_dws'),
+      command('dingtalk-link', ['dingtalk-link'], 'dingtalk-link <url> [--target fullScreen] [--legacy-scheme] [--json]', 'help.cmd_dingtalk_link', {
+        requiresLogin: false,
+        output: 'text|json',
+      }),
     ],
   },
   {

package/lib/core/doctor.js

@@ -286,8 +286,15 @@ class EnvironmentChecker {
   async checkNetwork() {
     try {
       const https = require('https');
+      const http = require('http');
+      const { loadCookieData } = require('./utils');
+      const { resolveEndpoint } = require('./env-manager');
+      const cookieData = loadCookieData(this.projectRoot);
+      const baseUrl = resolveEndpoint(cookieData, this.projectRoot);
+      const parsedUrl = new URL(baseUrl);
+      const requestModule = parsedUrl.protocol === 'https:' ? https : http;
       await new Promise((resolve, reject) => {
-        const request = https.get('https://www.aliwork.com', { timeout: 5000 }, (response) => {
+        const request = requestModule.get(baseUrl, { timeout: 5000 }, (response) => {
           resolve(response.statusCode);
         });
         request.on('error', reject);
@@ -298,18 +305,18 @@ class EnvironmentChecker {
       });
       return {
         id: 'env-network',
-        label: '网络连通性（aliwork.com）',
+        label: `网络连通性（${parsedUrl.hostname}）`,
         passed: true,
         severity: Severity.INFO,
         fixType: null,
       };
-    } catch {
+    } catch (err) {
       return {
         id: 'env-network',
         label: '网络连通性检测',
         passed: false,
         severity: Severity.WARNING,
-        message: '无法连接 aliwork.com，请检查网络',
+        message: `无法连接当前宜搭地址，请检查网络或环境配置：${err.message}`,
         fixType: null,
       };
     }

package/lib/core/env-manager.js

@@ -31,6 +31,8 @@ const { findProjectRoot } = require('./utils');
 
 const DEFAULT_BASE_URL = 'https://www.aliwork.com';
 const DEFAULT_LOGIN_URL = 'https://www.aliwork.com/workPlatform';
+const ALIBABA_INTERNAL_BASE_URL = 'https://yida-group.alibaba-inc.com';
+const ALIBABA_INTERNAL_LOGIN_URL = `${ALIBABA_INTERNAL_BASE_URL}/workPlatform`;
 const ENVS_CONFIG_FILE = 'openyida-envs.json';
 
 /** 默认公有云环境配置 */
@@ -41,6 +43,142 @@ const DEFAULT_PUBLIC_ENV = {
   cookieFile: 'cookies-public.json',
 };
 
+/** 阿里内网宜搭环境配置 */
+const DEFAULT_ALIBABA_INTERNAL_ENV = {
+  baseUrl: ALIBABA_INTERNAL_BASE_URL,
+  loginUrl: ALIBABA_INTERNAL_LOGIN_URL,
+  description: '阿里内网宜搭',
+  cookieFile: 'cookies-alibaba.json',
+};
+
+const BUILTIN_ENVIRONMENTS = {
+  public: DEFAULT_PUBLIC_ENV,
+  alibaba: DEFAULT_ALIBABA_INTERNAL_ENV,
+};
+
+const SHARED_COOKIE_DOMAINS = new Set([
+  'aliwork.com',
+  'alibaba-inc.com',
+]);
+
+const KNOWN_YIDA_HOSTS = new Set([
+  'www.aliwork.com',
+  'yida-group.alibaba-inc.com',
+]);
+
+function cloneBuiltinEnvironments() {
+  return Object.fromEntries(
+    Object.entries(BUILTIN_ENVIRONMENTS).map(([name, envConfig]) => [name, { ...envConfig }])
+  );
+}
+
+function buildDefaultEnvsConfig() {
+  return {
+    current: 'public',
+    environments: cloneBuiltinEnvironments(),
+  };
+}
+
+function ensureBuiltinEnvironments(config) {
+  if (!config.environments) { config.environments = {}; }
+  for (const [envName, envConfig] of Object.entries(BUILTIN_ENVIRONMENTS)) {
+    if (!config.environments[envName]) {
+      config.environments[envName] = { ...envConfig };
+    }
+  }
+  return config;
+}
+
+function normalizeBaseUrl(value, fallback = null) {
+  if (!value) { return fallback; }
+  const trimmed = String(value).trim();
+  if (!trimmed) { return fallback; }
+  const withProtocol = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)
+    ? trimmed
+    : `https://${trimmed}`;
+  try {
+    return new URL(withProtocol).origin.replace(/\/+$/, '');
+  } catch {
+    return fallback;
+  }
+}
+
+function normalizeHostname(value) {
+  if (!value) { return ''; }
+  const trimmed = String(value).trim().replace(/^\./, '').toLowerCase();
+  if (!trimmed) { return ''; }
+  try {
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)) {
+      return new URL(trimmed).hostname.toLowerCase();
+    }
+    if (trimmed.includes('/')) {
+      return new URL(`https://${trimmed}`).hostname.toLowerCase();
+    }
+  } catch {
+    return '';
+  }
+  return trimmed;
+}
+
+function isSharedCookieDomain(hostname) {
+  return SHARED_COOKIE_DOMAINS.has(normalizeHostname(hostname));
+}
+
+function isYidaServiceHost(hostname) {
+  const host = normalizeHostname(hostname);
+  if (!host) { return false; }
+  if (KNOWN_YIDA_HOSTS.has(host)) { return true; }
+  if (host.endsWith('.aliwork.com') && host !== 'aliwork.com') { return true; }
+  if (host.endsWith('.alibaba-inc.com') && host !== 'alibaba-inc.com') {
+    return host.startsWith('yida-') || host.includes('.yida-') || host.includes('.yida.');
+  }
+  return false;
+}
+
+function cookieDomainToBaseUrl(domain, fallbackUrl) {
+  const host = normalizeHostname(domain);
+  if (!host || isSharedCookieDomain(host)) {
+    return null;
+  }
+
+  const fallbackOrigin = normalizeBaseUrl(fallbackUrl, null);
+  if (fallbackOrigin) {
+    const fallbackHost = normalizeHostname(fallbackOrigin);
+    if (host === fallbackHost) {
+      return fallbackOrigin;
+    }
+  }
+
+  if (isYidaServiceHost(host)) {
+    return `https://${host}`;
+  }
+
+  return null;
+}
+
+function deriveBaseUrlFromCookies(cookies = [], fallbackUrl = DEFAULT_BASE_URL) {
+  const fallbackOrigin = normalizeBaseUrl(fallbackUrl, DEFAULT_BASE_URL);
+  const cookieList = Array.isArray(cookies) ? cookies : [];
+  const preferredCookieNames = ['yida_user_cookie', 'tianshu_csrf_token'];
+
+  for (const cookieName of preferredCookieNames) {
+    const cookie = cookieList.find((item) => item && item.name === cookieName && item.domain);
+    const baseUrl = cookie ? cookieDomainToBaseUrl(cookie.domain, fallbackOrigin) : null;
+    if (baseUrl) { return baseUrl; }
+  }
+
+  return fallbackOrigin;
+}
+
+function deriveBaseUrlFromUrl(fallbackBaseUrl, candidateUrl) {
+  const fallbackOrigin = normalizeBaseUrl(fallbackBaseUrl, DEFAULT_BASE_URL);
+  const candidateOrigin = normalizeBaseUrl(candidateUrl, null);
+  if (!candidateOrigin) { return fallbackOrigin; }
+
+  const candidateHost = normalizeHostname(candidateOrigin);
+  return isYidaServiceHost(candidateHost) ? candidateOrigin : fallbackOrigin;
+}
+
 // ── 配置文件读写 ──────────────────────────────────────
 
 /**
@@ -54,26 +192,16 @@ function loadEnvsConfig(projectRoot) {
   const configPath = path.join(root, '.cache', ENVS_CONFIG_FILE);
 
   if (!fs.existsSync(configPath)) {
-    return {
-      current: 'public',
-      environments: { public: { ...DEFAULT_PUBLIC_ENV } },
-    };
+    return buildDefaultEnvsConfig();
   }
 
   try {
     const raw = fs.readFileSync(configPath, 'utf-8').trim();
     const parsed = JSON.parse(raw);
-    // 确保 public 环境始终存在
-    if (!parsed.environments) { parsed.environments = {}; }
-    if (!parsed.environments.public) {
-      parsed.environments.public = { ...DEFAULT_PUBLIC_ENV };
-    }
-    return parsed;
+    // 确保内置环境始终存在，已有同名环境不覆盖，保证用户配置优先
+    return ensureBuiltinEnvironments(parsed);
   } catch {
-    return {
-      current: 'public',
-      environments: { public: { ...DEFAULT_PUBLIC_ENV } },
-    };
+    return buildDefaultEnvsConfig();
   }
 }
 
@@ -162,7 +290,7 @@ function migrateOldCookieFile(projectRoot) {
 function resolveEndpoint(cookieData, projectRoot) {
   // 优先级 1：环境变量强制指定
   if (process.env.OPENYIDA_ENDPOINT) {
-    return process.env.OPENYIDA_ENDPOINT.replace(/\/+$/, '');
+    return normalizeBaseUrl(process.env.OPENYIDA_ENDPOINT, DEFAULT_BASE_URL);
   }
 
   // 优先级 2：当前激活环境配置
@@ -171,17 +299,17 @@ function resolveEndpoint(cookieData, projectRoot) {
   // 这样可以兼容：用户没有配置多环境时，仍从 Cookie 中提取专属域名
   const isDefaultPublic = envConfig.baseUrl === DEFAULT_BASE_URL;
   if (!isDefaultPublic && envConfig.baseUrl) {
-    return envConfig.baseUrl.replace(/\/+$/, '');
+    return normalizeBaseUrl(envConfig.baseUrl, DEFAULT_BASE_URL);
   }
 
   // 优先级 3：从 Cookie 历史提取（兼容专属域名）
   if (cookieData && cookieData.base_url) {
-    return cookieData.base_url.replace(/\/+$/, '');
+    return normalizeBaseUrl(cookieData.base_url, DEFAULT_BASE_URL);
   }
 
   // 优先级 4：环境配置（公有云默认）
   if (envConfig.baseUrl) {
-    return envConfig.baseUrl.replace(/\/+$/, '');
+    return normalizeBaseUrl(envConfig.baseUrl, DEFAULT_BASE_URL);
   }
 
   return DEFAULT_BASE_URL;
@@ -207,7 +335,10 @@ function resolveLoginUrl(projectRoot) {
 module.exports = {
   DEFAULT_BASE_URL,
   DEFAULT_LOGIN_URL,
+  ALIBABA_INTERNAL_BASE_URL,
+  ALIBABA_INTERNAL_LOGIN_URL,
   DEFAULT_PUBLIC_ENV,
+  DEFAULT_ALIBABA_INTERNAL_ENV,
   loadEnvsConfig,
   saveEnvsConfig,
   getCurrentEnvConfig,
@@ -215,4 +346,9 @@ module.exports = {
   migrateOldCookieFile,
   resolveEndpoint,
   resolveLoginUrl,
+  normalizeBaseUrl,
+  normalizeHostname,
+  isYidaServiceHost,
+  deriveBaseUrlFromCookies,
+  deriveBaseUrlFromUrl,
 };

package/lib/core/locales/ar.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'التكامل & DingTalk',
     cmd_integration: 'إنشاء تدفق أتمتة التكامل',
     cmd_dws: 'DingTalk CLI (جهات الاتصال/التقويم/المهام/الموافقة إلخ)',
+    cmd_dingtalk_link: 'إنشاء روابط DingTalk AppLink / dingtalk:// القديمة',
     group_utility: 'الأدوات',
     cmd_commands: 'Output machine-readable command manifest',
     cmd_a2a: 'Start local read-only A2A adapter or print Agent Card',

package/lib/core/locales/de.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'Integration & DingTalk',
     cmd_integration: 'Integrations-Automatisierungsflow erstellen',
     cmd_dws: 'DingTalk CLI (Kontakte/Kalender/Aufgaben/Genehmigung etc.)',
+    cmd_dingtalk_link: 'DingTalk AppLink / alte dingtalk:// Seitenlinks erzeugen',
     group_utility: 'Werkzeuge',
     cmd_commands: 'Maschinenlesbares Command Manifest ausgeben',
     cmd_a2a: 'Lokalen schreibgeschützten A2A-Adapter starten oder Agent Card ausgeben',

package/lib/core/locales/en.js

@@ -71,6 +71,7 @@ module.exports = {
     group_integration: 'Integration & DingTalk',
     cmd_integration: 'Create integration automation flow',
     cmd_dws: 'DingTalk CLI (contacts/calendar/todo/approval etc.)',
+    cmd_dingtalk_link: 'Generate DingTalk AppLink / legacy dingtalk:// page links',
     group_utility: 'Utility',
     cmd_commands: 'Output machine-readable command manifest',
     cmd_a2a: 'Start local read-only A2A adapter or print Agent Card',

package/lib/core/locales/es.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'Integración & DingTalk',
     cmd_integration: 'Crear flujo de automatización',
     cmd_dws: 'DingTalk CLI (contactos/calendario/tareas/aprobación etc.)',
+    cmd_dingtalk_link: 'Generar enlaces DingTalk AppLink / dingtalk:// heredados',
     group_utility: 'Utilidades',
     cmd_commands: 'Emitir manifiesto de comandos legible por máquina',
     cmd_a2a: 'Iniciar adaptador A2A local de solo lectura o imprimir Agent Card',

package/lib/core/locales/fr.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'Intégration & DingTalk',
     cmd_integration: 'Créer un flux d\'automatisation',
     cmd_dws: 'DingTalk CLI (contacts/calendrier/tâches/approbation etc.)',
+    cmd_dingtalk_link: 'Générer des liens DingTalk AppLink / dingtalk:// historiques',
     group_utility: 'Utilitaires',
     cmd_commands: 'Afficher le manifeste des commandes lisible par machine',
     cmd_a2a: 'Démarrer l’adaptateur A2A local en lecture seule ou afficher l’Agent Card',

package/lib/core/locales/hi.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'एकीकरण & DingTalk',
     cmd_integration: 'एकीकरण स्वचालन फ्लो बनाएं',
     cmd_dws: 'DingTalk CLI (संपर्क/कैलेंडर/कार्य/अनुमोदन आदि)',
+    cmd_dingtalk_link: 'DingTalk AppLink / legacy dingtalk:// पेज लिंक बनाएं',
     group_utility: 'उपकरण',
     cmd_commands: 'Output machine-readable command manifest',
     cmd_a2a: 'Start local read-only A2A adapter or print Agent Card',

package/lib/core/locales/ja.js

@@ -70,6 +70,7 @@ module.exports = {
     group_integration: '統合 & DingTalk',
     cmd_integration: '統合自動化フローを作成',
     cmd_dws: 'DingTalk CLI（連絡先/カレンダー/ToDo/承認等）',
+    cmd_dingtalk_link: 'DingTalk AppLink / 旧 dingtalk:// ページリンクを生成',
     group_utility: 'ユーティリティ',
     cmd_commands: '機械可読コマンド manifest を出力',
     cmd_a2a: 'ローカル読み取り専用 A2A Adapter を起動、または Agent Card を出力',

package/lib/core/locales/ko.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: '통합 & DingTalk',
     cmd_integration: '통합 자동화 플로우 생성',
     cmd_dws: 'DingTalk CLI (연락처/캘린더/할일/승인 등)',
+    cmd_dingtalk_link: 'DingTalk AppLink / 기존 dingtalk:// 페이지 링크 생성',
     group_utility: '유틸리티',
     cmd_commands: 'Output machine-readable command manifest',
     cmd_a2a: 'Start local read-only A2A adapter or print Agent Card',

package/lib/core/locales/pt.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'Integração & DingTalk',
     cmd_integration: 'Criar fluxo de automação',
     cmd_dws: 'DingTalk CLI (contatos/calendário/tarefas/aprovação etc.)',
+    cmd_dingtalk_link: 'Gerar links DingTalk AppLink / dingtalk:// legados',
     group_utility: 'Utilitários',
     cmd_commands: 'Emitir manifesto de comandos legível por máquina',
     cmd_a2a: 'Iniciar adaptador A2A local somente leitura ou imprimir Agent Card',

package/lib/core/locales/vi.js

@@ -68,6 +68,7 @@ module.exports = {
     group_integration: 'Tích hợp & DingTalk',
     cmd_integration: 'Tạo luồng tự động hóa tích hợp',
     cmd_dws: 'DingTalk CLI (danh bạ/lịch/việc cần làm/phê duyệt v.v.)',
+    cmd_dingtalk_link: 'Tạo liên kết DingTalk AppLink / dingtalk:// cũ',
     group_utility: 'Tiện ích',
     cmd_commands: 'Output machine-readable command manifest',
     cmd_a2a: 'Start local read-only A2A adapter or print Agent Card',

package/lib/core/locales/zh-HK.js

@@ -70,6 +70,7 @@ module.exports = {
     group_integration: '整合 & 釘釘',
     cmd_integration: '建立整合自動化邏輯流',
     cmd_dws: '釘釘 CLI（通訊錄/日曆/待辦/審批等）',
+    cmd_dingtalk_link: '生成釘釘 AppLink / 相容 dingtalk:// 跳轉連結',
     group_utility: '工具',
     cmd_commands: '輸出機器可讀命令清單',
     cmd_a2a: '啟動本機唯讀 A2A Adapter 或輸出 Agent Card',

package/lib/core/locales/zh.js

@@ -71,6 +71,7 @@ module.exports = {
     group_integration: '集成 & 钉钉',
     cmd_integration: '创建集成自动化逻辑流',
     cmd_dws: '钉钉 CLI（通讯录/日历/待办/审批等）',
+    cmd_dingtalk_link: '生成钉钉 AppLink / 兼容 dingtalk:// 跳转链接',
     group_utility: '工具',
     cmd_commands: '输出机器可读命令清单',
     cmd_a2a: '启动本地只读 A2A Adapter 或输出 Agent Card',

package/lib/dingtalk/dingtalk-link.js

@@ -0,0 +1,141 @@
+'use strict';
+
+const { warn } = require('../core/chalk');
+
+const APPLINK_PAGE_LINK = 'https://applink.dingtalk.com/page/link';
+const LEGACY_PAGE_LINK = 'dingtalk://dingtalkclient/page/link';
+const DEFAULT_TARGET = 'fullScreen';
+
+function parseArgs(args) {
+  const options = {
+    url: null,
+    target: DEFAULT_TARGET,
+    legacyScheme: false,
+    json: false,
+    help: false,
+  };
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--url') {
+      options.url = args[++i];
+    } else if (arg === '--target') {
+      options.target = args[++i];
+    } else if (arg === '--legacy-scheme') {
+      options.legacyScheme = true;
+    } else if (arg === '--json') {
+      options.json = true;
+    } else if (!arg.startsWith('--') && !options.url) {
+      options.url = arg;
+    }
+  }
+
+  return options;
+}
+
+function isDingTalkPageLink(value) {
+  try {
+    const parsed = new URL(value);
+    if (parsed.protocol === 'dingtalk:' && parsed.hostname === 'dingtalkclient') {
+      return parsed.pathname === '/page/link';
+    }
+    return parsed.protocol === 'https:' && parsed.hostname === 'applink.dingtalk.com' && parsed.pathname === '/page/link';
+  } catch {
+    return false;
+  }
+}
+
+function extractPageUrl(value) {
+  if (!isDingTalkPageLink(value)) {
+    return { pageUrl: value, target: null };
+  }
+
+  const parsed = new URL(value);
+  return {
+    pageUrl: parsed.searchParams.get('url') || '',
+    target: parsed.searchParams.get('target'),
+  };
+}
+
+function assertHttpUrl(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    throw new Error('DingTalk page links require an absolute http(s) URL.');
+  }
+  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+    throw new Error('DingTalk page links require an absolute http(s) URL.');
+  }
+  return parsed.toString();
+}
+
+function buildDingTalkPageLink(input) {
+  const options = {
+    url: input && input.url,
+    target: input && input.target,
+    legacyScheme: !!(input && input.legacyScheme),
+  };
+  const hasTargetOption = !!(input && Object.prototype.hasOwnProperty.call(input, 'target'));
+
+  if (!options.url) {
+    throw new Error('Missing URL. Usage: openyida dingtalk-link <url>');
+  }
+
+  const extracted = extractPageUrl(options.url);
+  const pageUrl = assertHttpUrl(extracted.pageUrl);
+  const target = hasTargetOption ? options.target : (extracted.target || DEFAULT_TARGET);
+  const base = options.legacyScheme ? LEGACY_PAGE_LINK : APPLINK_PAGE_LINK;
+  const link = new URL(base);
+  link.searchParams.set('url', pageUrl);
+  if (target) {
+    link.searchParams.set('target', target);
+  }
+  return link.toString();
+}
+
+function printHelp() {
+  console.log('Usage: openyida dingtalk-link <url> [--target fullScreen] [--legacy-scheme] [--json]');
+  console.log('');
+  console.log('Generate DingTalk AppLink URLs for opening web pages in DingTalk.');
+  console.log('AppLink is the default because dingtalk:// may be claimed by DingTalk variants such as dedicated DingTalk clients.');
+  console.log('');
+  console.log('Examples:');
+  console.log('  openyida dingtalk-link https://attend.dingtalk.com/attend/index.html');
+  console.log('  openyida dingtalk-link "dingtalk://dingtalkclient/page/link?url=https%3A%2F%2Fexample.com"');
+  console.log('  openyida dingtalk-link https://example.com --legacy-scheme');
+}
+
+async function run(args) {
+  const options = parseArgs(args);
+  if (options.help) {
+    printHelp();
+    return;
+  }
+
+  try {
+    const link = buildDingTalkPageLink(options);
+    if (options.json) {
+      console.log(JSON.stringify({
+        url: link,
+        kind: options.legacyScheme ? 'legacy-scheme' : 'applink',
+        target: options.target || null,
+      }, null, 2));
+      return;
+    }
+    console.log(link);
+  } catch (error) {
+    warn(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  APPLINK_PAGE_LINK,
+  LEGACY_PAGE_LINK,
+  buildDingTalkPageLink,
+  extractPageUrl,
+  run,
+};

package/package.json

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