openyida 2026.10.29 → 2026.10.30-beta.1

package/README.md

@@ -143,6 +143,31 @@ openyida login --check-only --json
 openyida auth status
 ```
 
+In QwenWork web, `openyida login --qwenwork --json` (or ordinary `login`) sends the sandbox Agent Token and gateway origin directly to the selected YiDA authentication endpoint. YiDA validates the identity through the trusted gateway’s fixed `/api/agent-gw/yida/user_info` endpoint, then issues its own short-lived session. This login flow no longer calls the legacy exchange or `/user/info` endpoints. Login preparation stays silent; failures stop without browser OAuth. Desktop and other hosts retain their existing authentication paths.
+
+QwenWork login supports DingTalk organizations, QwenWork organizations and personal ODS identities. Local ODS tenant IDs retain their `yida` prefix. When the server supplies a refresh token, the CLI stores it for the standard refresh flow. Optional server fields `identity_type` (`PERSONAL` / `ORGANIZATION`) and `organization_type` (`DINGTALK` / `QWENWORK` / `OTHER`, organizations only) are preserved in the session and `auth status`; historical sessions with both fields absent, null or empty default to `ORGANIZATION` / `DINGTALK`. Authentication failures expose bounded `status`, `stage`, `exchange_id`, HTTP `status_code` and local validation `reason` in JSON diagnostics, without response bodies or credentials.
+
+For QwenWork cloud identity diagnostics, run inside the actual cloud execution environment:
+
+```bash
+openyida auth qwenwork user-info --json
+```
+
+This diagnostic command uses the legacy user-token protocol; it does not validate the current web Agent Token login flow. Use `openyida login --check-only --json` to check the YiDA session.
+
+This command exchanges the injected `QWENWORK_AGENT_TOKEN` (legacy: `MULE_AGENT_TOKEN` / `AGENT_TOKEN`) at `QWENWORK_GATEWAY_URL` (legacy: `MULE_GATEWAY_URL`), then queries `/user/info` on the same origin. It reports identity and scope metadata without printing or persisting either credential. It does not create an OpenYida login session, and QwenWork organization IDs are not YiDA `corpId` values. Existing OAuth/profile behavior is unchanged.
+
+Programmatic callers can use `exchangeQwenWorkAgentToken`, `getQwenWorkUserInfo` and `getQwenWorkIdentity` from `lib/auth/qwenwork-client.js`. The exchange function returns an in-memory `access_token` credential for the identity query or a future server-side login exchange; callers must not log or persist it.
+
+```js
+const { exchangeQwenWorkAgentToken, getQwenWorkUserInfo } = require('openyida/lib/auth/qwenwork-client');
+async function readCloudUser() {
+  const credential = await exchangeQwenWorkAgentToken();
+  // The result contains QwenWork identifiers, not YiDA IDs.
+  return getQwenWorkUserInfo(credential);
+}
+```
+
 To reuse an existing shared login profile for the current project, switch first instead of starting a new OAuth login:
 
 ```bash
@@ -457,9 +482,9 @@ When preparing a PR that needs a personal Fork, or when you ask how to support t
 
 | Command | Description |
 |---------|-------------|
-| `openyida login [target-url] [--env <name>\|--intl\|--overseas\|--global\|--yidaapps\|--alibaba] [--client-id <clientId>] [--endpoint <url>] [--no-browser]` | Login with OAuth token mode |
+| `openyida login [--qwenwork] [target-url] [--env <name>\|--intl\|--overseas\|--global\|--yidaapps\|--alibaba] [--client-id <clientId>] [--endpoint <url>] [--no-browser]` | Login with OAuth token mode |
 | `openyida logout` | Logout / unbind current project auth |
-| `openyida auth <status\|login\|refresh\|logout\|profiles\|profile switch>` | Token login state and profile management |
+| `openyida auth <status\|login\|refresh\|logout\|profiles\|profile switch\|qwenwork user-info> [--json]` | Token login state and profile management |
 | `openyida org <list\|switch> [--json] [--corp-id <corpId>]` | Organization management (list / switch existing profiles first) |
 | `openyida env [--json\|setup\|list\|show\|switch\|add\|remove] [options]` | Detect AI tool environment & token login state |
 

package/bin/yida-beta.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+'use strict';
+// beta 保持当前安装版本；环境、域名和登录态沿用标准 CLI 的解析规则。
+process.env.OPENYIDA_SKIP_UPDATE_CHECK = '1';
+require('./yida.js');

package/bin/yida.js

@@ -598,7 +598,23 @@ async function main() {
   });
   assertManagedInvocation(command, rawArgs);
   applyQuietFlag();
+  // 一次性票据只在当前进程消费，不能先自更新并重启命令。
+  switch (command) {
+    case 'login-qwenwork':
+      await require('../lib/auth/qwenwork-desktop').run(args);
+      return;
+  }
   applyGlobalEnvironmentFlags();
+  // 网页态由 CLI 消费宿主凭据；桌面态继续消费宿主准备的登录态。
+  const webLogin = (command === 'login' || (command === 'auth' && args[0] === 'login')) &&
+    require('../lib/core/qwenwork-login-guidance').isQwenWorkWebRuntime(require('../lib/core/utils').detectRuntimeCapabilities());
+  if ((command === 'login' && args.includes('--qwenwork')) || webLogin) {
+    const loginArgs = applyLoginEnvironmentFlags(command === 'auth' ? args.slice(1) : args, { inferTargetUrl: true });
+    if (hasHelpFlag(loginArgs)) { printLoginHelp(); return; }
+    assertNoUnsupportedLegacyLoginFlags(rawArgs, loginArgs);
+    await require('../lib/auth/qwenwork-login').run(loginArgs, buildTokenLoginOptions(loginArgs));
+    return;
+  }
 
   const { maybeAutoUpdate } = require('../lib/core/update');
   const updateResult = await maybeAutoUpdate({
@@ -718,6 +734,10 @@ async function main() {
 
     case 'auth': {
       const subCommand = args[0];
+      if (subCommand === 'qwenwork') {
+        await require('../lib/auth/qwenwork').run(args.slice(1));
+        break;
+      }
       const authArgs = applyLoginEnvironmentFlags(args.slice(1), { inferTargetUrl: true });
       const { getAuthStatus } = require('../lib/core/utils');
       const { tokenLogin, tokenLogout, tokenRefresh } = require('../lib/auth/token-auth');

package/lib/agent/provider-preflight.js

@@ -139,13 +139,15 @@ function probe(executable, args, rpc, options = {}) {
       child = (options.probeSpawn || spawn)(command.executable, command.args, {
         env, cwd: os.tmpdir(), shell: false, windowsHide: true,
         windowsVerbatimArguments: command.windowsVerbatimArguments,
-        detached: platform !== 'win32', stdio: ['pipe', 'pipe', 'pipe'],
+        // Finite Windows probes do not consume input. Avoid an unused redirected
+        // stdin pipe during PowerShell startup; ACP still needs its live pipe.
+        detached: platform !== 'win32', stdio: [platform === 'win32' && !rpc ? 'ignore' : 'pipe', 'pipe', 'pipe'],
       });
       signals.once('SIGINT', interrupted);
       signals.once('SIGTERM', interrupted);
       timer = setTimeout(() => { stop(); finish({ status: 'probe_timeout' }); }, options.timeoutMs || 15000);
       child.on('error', () => finish({ status: 'launch_failed' }));
-      child.stdin.on('error', () => {});
+      if (child.stdin) { child.stdin.on('error', () => {}); }
       child.stderr.on('data', chunk => { output = (output + chunk.toString()).slice(-65536); });
       child.stdout.on('data', chunk => {
         output = (output + chunk.toString()).slice(-65536);
@@ -171,7 +173,7 @@ function probe(executable, args, rpc, options = {}) {
           ? { protocolVersion: 1, clientCapabilities: {}, clientInfo: { name: 'openyida-preflight', version: '1' } }
           : { clientInfo: { name: 'openyida-preflight', version: '1' }, capabilities: {} };
         child.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'initialize', params }) + '\n');
-      } else { child.stdin.end(); }
+      } else if (child.stdin) { child.stdin.end(); }
     } catch { finish({ status: 'launch_failed' }); }
   });
 }

package/lib/auth/org.js

@@ -19,6 +19,10 @@ const {
   saveTokenSession,
 } = require('./token-store');
 const { tokenLogin } = require('./token-auth');
+const { sessionIdentity } = require('./session-identity');
+const { detectRuntimeCapabilities } = require('../core/utils');
+const { isQwenWorkWebRuntime } = require('../core/qwenwork-login-guidance');
+const { t } = require('../core/i18n');
 
 const LIST_CORP_INFOS_PATH = '/query/userservice/listCorpInfos.json';
 
@@ -146,6 +150,7 @@ function buildSwitchResult(status, currentSession, nextSession, message, extra =
     auth_mode: 'token',
     status,
     can_auto_use: true,
+    ...sessionIdentity(nextSession),
     previous_corp_id: currentSession && currentSession.corp_id,
     corp_id: nextSession.corp_id,
     corp_name: nextSession.corp_name,
@@ -191,6 +196,7 @@ async function switchOrganization(targetCorpId, options = {}) {
       ok: true,
       auth_mode: 'token',
       status: 'already_in_org',
+      ...sessionIdentity(currentSession),
       can_auto_use: true,
       corp_id: currentSession.corp_id,
       corp_name: currentSession.corp_name,
@@ -231,7 +237,12 @@ async function switchOrganization(targetCorpId, options = {}) {
     corpId: targetCorpId,
   };
 
-  const login = options.tokenLogin || tokenLogin;
+  const cloud = isQwenWorkWebRuntime(options.runtime || detectRuntimeCapabilities({ env: options.env || process.env }));
+  const login = options.tokenLogin || (cloud ? async opts => {
+    const { ensureQwenWorkLogin } = require('./qwenwork-login');
+    await ensureQwenWorkLogin(opts);
+    return loadTokenSession(opts);
+  } : tokenLogin);
   const temporaryLogin = createTemporaryLoginOptions(loginOptions);
   let loginResult;
   try {
@@ -266,8 +277,8 @@ async function switchOrganization(targetCorpId, options = {}) {
     'switched',
     currentSession,
     savedSession,
-    'switched organization by OAuth login',
-    { switch_source: 'oauth_login' }
+    cloud ? t('qwenwork.organization_switch_success') : 'switched organization by OAuth login',
+    { switch_source: cloud ? 'qwenwork_cloud' : 'oauth_login' }
   );
 }
 

package/lib/auth/qwenwork-client.js

@@ -0,0 +1,190 @@
+'use strict';
+
+const { CliError } = require('../core/cli-error');
+const { t } = require('../core/i18n');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+const MAX_RESPONSE_BYTES = 1024 * 1024;
+
+function failure(code, message, stage, details = {}) {
+  return new CliError(t(`qwenwork.${message}`), {
+    code: `QWENWORK_${code}`,
+    details: { stage, ...details },
+  });
+}
+
+function pick(env, names) {
+  for (const name of names) {
+    const value = String(env[name] || '').trim();
+    if (value) {
+      return { name, value };
+    }
+  }
+  return null;
+}
+
+function normalizeBaseUrl(value) {
+  try {
+    const url = new URL(value);
+    const loopback = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) ||
+      url.username || url.password || url.search || url.hash) {
+      throw new Error('invalid_url');
+    }
+    return url.href.replace(/\/+$/, '');
+  } catch {
+    throw failure('INVALID_GATEWAY', 'invalid_url', 'resolve_credentials');
+  }
+}
+
+function isObject(value) {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+// Do not include upstream bodies, headers or exception messages in diagnostics:
+// an authentication endpoint may echo credentials even in an error response.
+async function requestJson(method, url, accessToken, options, stage) {
+  const timeoutMs = options.timeoutMs === undefined ? DEFAULT_TIMEOUT_MS : options.timeoutMs;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw failure('INVALID_TIMEOUT', 'request_failed', stage);
+  }
+  const controller = new globalThis.AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await globalThis.fetch(url, {
+      method,
+      headers: { accept: 'application/json', authorization: `Bearer ${accessToken}` },
+      redirect: 'manual',
+      signal: controller.signal,
+    });
+    if (!response.ok) {
+      if (response.body) {
+        await response.body.cancel();
+      }
+      throw failure('HTTP_ERROR', 'request_failed', stage, { status_code: response.status });
+    }
+    const chunks = [];
+    let size = 0;
+    if (response.body) {
+      const reader = response.body.getReader();
+      let next = await reader.read();
+      while (!next.done) {
+        const { value } = next;
+        size += value.byteLength;
+        if (size > MAX_RESPONSE_BYTES) {
+          await reader.cancel();
+          throw failure('RESPONSE_TOO_LARGE', 'invalid_response', stage);
+        }
+        chunks.push(Buffer.from(value));
+        next = await reader.read();
+      }
+    }
+    let payload;
+    try {
+      payload = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    } catch {
+      throw failure('INVALID_RESPONSE', 'invalid_response', stage);
+    }
+    if (!isObject(payload) || (payload.code !== undefined && payload.code !== 'ok')) {
+      throw failure('INVALID_RESPONSE', 'invalid_response', stage);
+    }
+    return payload;
+  } catch (error) {
+    if (error && error.isCliError) {
+      throw error;
+    }
+    throw controller.signal.aborted
+      ? failure('TIMEOUT', 'request_timeout', stage)
+      : failure('NETWORK_ERROR', 'request_failed', stage);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function decodeClaims(token) {
+  try {
+    const value = JSON.parse(Buffer.from(token.split('.')[1], 'base64url').toString('utf8'));
+    return isObject(value) ? value : {};
+  } catch {
+    return {};
+  }
+}
+
+/** Exchange a cloud Agent credential for an in-memory scoped user credential.
+ * This does not issue or persist an OpenYida session.
+ */
+async function exchangeQwenWorkAgentToken(options = {}) {
+  const env = options.env || process.env;
+  const agent = pick(env, ['QWENWORK_AGENT_TOKEN', 'MULE_AGENT_TOKEN', 'AGENT_TOKEN']);
+  if (!agent || /[\r\n]/.test(agent.value)) {
+    throw failure('CREDENTIAL_MISSING', 'credential_missing', 'resolve_credentials');
+  }
+  const gateway = pick(env, ['QWENWORK_GATEWAY_URL', 'MULE_GATEWAY_URL']);
+  if (!gateway) {
+    throw failure('GATEWAY_MISSING', 'gateway_missing', 'resolve_credentials');
+  }
+  const baseUrl = normalizeBaseUrl(gateway.value);
+  const response = await requestJson('POST', `${baseUrl}/api/agent-gw/token/exchange`, agent.value, options, 'exchange');
+  // The current cloud endpoint returns {token, scope, ttl} without an envelope.
+  const payload = isObject(response.data) ? response.data : response;
+  if (typeof payload.token !== 'string' || !payload.token.trim() || /\s/.test(payload.token) ||
+    typeof payload.scope !== 'string' || !Number.isFinite(payload.ttl) || payload.ttl <= 0) {
+    throw failure('INVALID_RESPONSE', 'invalid_response', 'exchange');
+  }
+  const decoded = decodeClaims(payload.token);
+  if (typeof decoded.exp === 'number' && decoded.exp * 1000 <= Date.now()) {
+    throw failure('TOKEN_EXPIRED', 'expired_token', 'exchange');
+  }
+  return {
+    access_token: payload.token,
+    base_url: baseUrl,
+    credential_source: agent.name,
+    scope: payload.scope,
+    expires_in: payload.ttl,
+    expires_at: typeof decoded.exp === 'number' ? decoded.exp * 1000 : Date.now() + payload.ttl * 1000,
+  };
+}
+
+/** Query the credential's own origin; never infer a YiDA endpoint or organization. */
+async function getQwenWorkUserInfo(credential, options = {}) {
+  const accessToken = credential && credential.access_token;
+  if (typeof accessToken !== 'string' || !accessToken || /[\r\n]/.test(accessToken)) {
+    throw failure('CREDENTIAL_MISSING', 'credential_missing', 'user_info');
+  }
+  const baseUrl = normalizeBaseUrl(credential.base_url);
+  const response = await requestJson('GET', `${baseUrl}/user/info`, accessToken, options, 'user_info');
+  if (response.code !== 'ok' || !isObject(response.data) ||
+    typeof response.data.user_id !== 'string' || !response.data.user_id.trim()) {
+    throw failure('INVALID_RESPONSE', 'invalid_response', 'user_info');
+  }
+  const env = options.env || process.env;
+  const decoded = decodeClaims(accessToken);
+  // Decoding is not local signature verification. The authenticated /user/info
+  // response establishes identity; these comparisons catch context drift.
+  for (const expected of [env.QWENWORK_USER_ID, env.MULE_USER_ID, decoded.user_id, decoded.sub]) {
+    if (expected && String(expected) !== response.data.user_id) {
+      throw failure('IDENTITY_MISMATCH', 'identity_mismatch', 'user_info');
+    }
+  }
+  const orgId = response.data.biz && response.data.biz.org_id;
+  if (orgId && decoded.biz_org_id && orgId !== decoded.biz_org_id) {
+    throw failure('IDENTITY_MISMATCH', 'identity_mismatch', 'user_info');
+  }
+  return response.data;
+}
+
+/** Safe composition for identity consumers: the returned object has no credential. */
+async function getQwenWorkIdentity(options = {}) {
+  const credential = await exchangeQwenWorkAgentToken(options);
+  const profile = await getQwenWorkUserInfo(credential, options);
+  return {
+    base_url: credential.base_url,
+    credential_source: credential.credential_source,
+    scope: credential.scope,
+    expires_in: credential.expires_in,
+    expires_at: credential.expires_at,
+    profile,
+  };
+}
+
+module.exports = { exchangeQwenWorkAgentToken, getQwenWorkUserInfo, getQwenWorkIdentity };

package/lib/auth/qwenwork-cloud.js

@@ -0,0 +1,128 @@
+'use strict';
+
+const { sessionIdentity } = require('./session-identity');
+
+const { CliError } = require('../core/cli-error');
+const { t } = require('../core/i18n');
+const { DINGTALK_OAUTH_CLIENT_ID } = require('../core/env-manager');
+const { resolveTokenBaseUrl } = require('./token-auth');
+
+function failure(code, details = {}) {
+  return new CliError(t('qwenwork.login_check_failed'), { code: `QWENWORK_CLOUD_${code}`, details });
+}
+
+const CORP_ID = /^(?:(?:ding|yida|ps)[0-9a-f]{32}|dingd8e1123006514592)$/;
+
+// Only bounded protocol identifiers are diagnostic data; never forward the response body or message.
+function diagnostics(value, statusCode, credential = {}) {
+  const details = { stage: 'yida_exchange', status_code: statusCode };
+  if (!value || typeof value !== 'object' || Array.isArray(value)) { return details; }
+  const secrets = [credential.access_token, value.access_token, value.refresh_token, value.refreshToken].filter(token => typeof token === 'string' && token);
+  const publicValue = text => typeof text === 'string' && !secrets.some(token => text.includes(token));
+  if (publicValue(value.status) && value.status.length <= 64 && /^(?:ok|error|failure|[a-z][a-z0-9]*_[a-z0-9_]+)$/.test(value.status)
+    && !/^(?:qwex|dws)_/.test(value.status)) { details.status = value.status; }
+  if (publicValue(value.stage) && ['request', 'qwen_verify', 'token_issue'].includes(value.stage)) { details.stage = value.stage; }
+  if (publicValue(value.exchange_id) && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value.exchange_id)) {
+    details.exchange_id = value.exchange_id;
+  }
+  return details;
+}
+
+function origin(value, details = {}) {
+  try {
+    const url = new URL(value);
+    if (typeof value !== 'string' || value.length > 2048 || /\s/.test(value) || url.protocol !== 'https:' || url.username || url.password || url.pathname !== '/' || url.search || url.hash) { throw new Error(); }
+    return url.origin;
+  } catch { throw failure('ENDPOINT_INVALID', details); }
+}
+
+async function exchangeSession(credential, baseUrl, options) {
+  const controller = new AbortController();
+  const timeoutMs = options.timeoutMs === undefined ? 15000 : options.timeoutMs;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) { throw failure('INVALID_TIMEOUT'); }
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await (options.fetch || globalThis.fetch)(`${baseUrl}/openapi/cli/v1/auth/qwenwork/token`, {
+      method: 'POST', redirect: 'error', signal: controller.signal,
+      headers: { authorization: `Bearer ${credential.access_token}`, accept: 'application/json', 'content-type': 'application/json' },
+      // corp_id constrains the resulting YiDA organization or personal space for every identity type.
+      body: JSON.stringify({ gateway_url: credential.base_url, ...(options.corpId ? { corp_id: options.corpId } : {}) }),
+    });
+    const reader = response.body?.getReader();
+    if (!reader) { throw failure(response.ok ? 'RESPONSE_INVALID' : 'HTTP_ERROR', diagnostics(null, response.status)); }
+    const chunks = []; let bytes = 0;
+    try {
+      for (let part = await reader.read(); !part.done; part = await reader.read()) {
+        bytes += part.value.byteLength;
+        if (bytes > 65536) { await reader.cancel(); throw failure(response.ok ? 'RESPONSE_INVALID' : 'HTTP_ERROR', { ...diagnostics(null, response.status), reason: 'response_too_large' }); }
+        chunks.push(part.value);
+      }
+    } finally { reader.releaseLock(); }
+    let value;
+    try { value = JSON.parse(Buffer.concat(chunks).toString('utf8')); }
+    catch { throw failure(response.ok ? 'RESPONSE_INVALID' : 'HTTP_ERROR', { ...diagnostics(null, response.status), reason: 'invalid_json' }); }
+    const details = diagnostics(value, response.status, credential);
+    if (!response.ok) { throw failure('HTTP_ERROR', details); }
+    return { value, details };
+  } catch (error) {
+    // 上游正文和异常可能回显凭据，仅保留本模块生成的固定错误码。
+    if (error instanceof CliError && /^QWENWORK_CLOUD_/.test(error.code)) { throw error; }
+    throw failure(controller.signal.aborted ? 'REQUEST_TIMED_OUT' : 'REQUEST_FAILED', { stage: 'yida_exchange' });
+  } finally { clearTimeout(timer); }
+}
+
+/** 只读取本次沙箱凭据，由宜搭服务端向受信任网关验证身份。 */
+function sandboxCredential(options) {
+  const env = options.env || process.env;
+  const token = ['QWENWORK_AGENT_TOKEN', 'MULE_AGENT_TOKEN', 'AGENT_TOKEN'].map(name => env[name]).find(value => typeof value === 'string' && value);
+  if (!token) { throw new CliError(t('qwenwork.login_check_failed'), { code: 'QWENWORK_CREDENTIAL_MISSING' }); }
+  if (token.length > 4096 || /\s/.test(token)) { throw failure('CREDENTIAL_INVALID'); }
+  const gateway = env.QWENWORK_GATEWAY_URL || env.MULE_GATEWAY_URL;
+  if (!gateway) { throw new CliError(t('qwenwork.login_check_failed'), { code: 'QWENWORK_GATEWAY_MISSING' }); }
+  return { access_token: token, base_url: origin(gateway) };
+}
+
+/** 只向宜搭提交 Agent Token 和网关地址；返回会话供调用方校验后保存。 */
+async function exchangeQwenWorkCloudSession(options = {}) {
+  const baseUrl = origin(options.endpoint || (options.env || process.env).OPENYIDA_ENDPOINT || resolveTokenBaseUrl(options));
+  const credential = sandboxCredential(options);
+  try {
+    const startedAt = Date.now();
+    const { value, details } = await exchangeSession(credential, baseUrl, options);
+    if (!value || typeof value !== 'object' || Array.isArray(value)) { throw failure('RESPONSE_INVALID', { ...details, reason: 'response_shape' }); }
+    if (value.status !== 'ok') { throw failure('EXCHANGE_REJECTED', details); }
+    const env = options.env || process.env;
+    const hostTokens = ['QWENWORK_AGENT_TOKEN', 'MULE_AGENT_TOKEN', 'AGENT_TOKEN'].map(name => env[name]).filter(Boolean);
+    const validToken = token => typeof token === 'string' && !!token && !/\s/.test(token) && token.length <= 32768 && !hostTokens.includes(token);
+    // Older cloud deployments may return access-only sessions. Preserve a refresh token when supplied.
+    const refreshToken = value.refresh_token === undefined ? value.refreshToken : value.refresh_token;
+    const invalid = [
+      [value.auth_mode !== 'token', 'auth_mode'],
+      [value.can_auto_use !== true, 'can_auto_use'],
+      [value.token_type !== 'Bearer', 'token_type'],
+      [value.credential_source !== 'qwenwork_cloud', 'credential_source'],
+      [!validToken(value.access_token), 'access_token'],
+      [!Number.isInteger(value.expires_in) || value.expires_in <= 0 || value.expires_in > 1800, 'expires_in'],
+      [typeof value.corp_id !== 'string' || !CORP_ID.test(value.corp_id), 'corp_id'],
+      [typeof value.user_id !== 'string' || !value.user_id || value.user_id.trim() !== value.user_id || value.user_id.length > 256, 'user_id'],
+      [options.corpId && value.corp_id !== options.corpId, 'corp_id_mismatch'],
+      [options.userId && value.user_id !== options.userId, 'user_id_mismatch'],
+      ['exchange_ticket' in value, 'exchange_ticket'],
+      [refreshToken !== undefined && !validToken(refreshToken), 'refresh_token'],
+      [value.client_id !== undefined && value.client_id !== (options.clientId || DINGTALK_OAUTH_CLIENT_ID), 'client_id'],
+    ].find(([rejected]) => rejected);
+    if (invalid) { throw failure('RESPONSE_INVALID', { ...details, reason: invalid[1] }); }
+    return {
+      ...sessionIdentity(value),
+      auth_mode: 'token', credential_source: 'qwenwork_cloud', token_type: 'Bearer',
+      // 可信宜搭签发服务决定业务域名；认证请求仍只发往最初选择的 origin。
+      access_token: value.access_token, refresh_token: refreshToken, base_url: value.base_url === undefined ? baseUrl : origin(value.base_url, { ...details, reason: 'base_url' }),
+      client_id: options.clientId || DINGTALK_OAUTH_CLIENT_ID,
+      corp_id: value.corp_id, user_id: value.user_id,
+      user_name: typeof value.user_name === 'string' ? value.user_name : undefined,
+      expires_at: startedAt + value.expires_in * 1000,
+    };
+  } finally { credential.access_token = undefined; }
+}
+
+module.exports = { exchangeQwenWorkCloudSession };

package/lib/auth/qwenwork-desktop.js

@@ -0,0 +1,157 @@
+'use strict';
+
+const { sessionIdentity } = require('./session-identity');
+
+const { CliError } = require('../core/cli-error');
+const { buildQwenWorkLoginInvocation } = require('../core/qwenwork-login-guidance');
+const { t } = require('../core/i18n');
+const { DINGTALK_OAUTH_CLIENT_ID } = require('../core/env-manager');
+const { saveTokenSession, loadTokenSession, isEnvTokenAuthMode } = require('./token-store');
+const { readManagedContext } = require('../agent/managed-context');
+
+const TICKET_ENV = 'OPENYIDA_QWENWORK_EXCHANGE_TICKET';
+const TICKET_CONTEXT_ENV = 'OPENYIDA_QWENWORK_EXCHANGE_TICKET_CONTEXT';
+const CONSUME_PATH = '/openapi/cli/v1/auth/qwenwork/desktop/consume';
+const MAX_RESPONSE_BYTES = 65536;
+
+function fail(code) {
+  return new CliError(t('qwenwork.desktop_login_failed'), {
+    code: `QWENWORK_DESKTOP_${code}`,
+    details: { invocation: buildQwenWorkLoginInvocation() },
+  });
+}
+
+function parseTicket(raw, context) {
+  try {
+    if (typeof raw !== 'string' || !raw || /\s/.test(raw) || raw.length > 32768 || typeof context !== 'string' || context.length > 8192) { throw new Error(); }
+    const value = JSON.parse(context);
+    if (!value || typeof value !== 'object' || Array.isArray(value) ||
+      !Number.isSafeInteger(value.expires_at) || value.expires_at <= Date.now() || value.expires_at > Date.now() + 300000 ||
+      typeof value.corp_id !== 'string' || !value.corp_id || typeof value.user_id !== 'string' || !value.user_id ||
+      typeof value.exchange_id !== 'string' || !value.exchange_id ||
+      'access_token' in value || 'refresh_token' in value || 'accessToken' in value || 'refreshToken' in value) { throw new Error(); }
+    return { ...value, exchange_ticket: raw };
+  } catch {
+    throw fail('TICKET_MISSING_OR_INVALID');
+  }
+}
+
+function origin(value) {
+  try {
+    const url = new URL(value);
+    if (typeof value !== 'string' || value.length > 2048 || /\s/.test(value) || url.protocol !== 'https:' || url.username || url.password || url.search || url.hash || url.pathname !== '/') { throw new Error(); }
+    return url.origin;
+  } catch {
+    throw fail('ENDPOINT_INVALID');
+  }
+}
+
+async function requestJson(url, init, options) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), options.timeoutMs || 15000);
+  try {
+    const response = await (options.fetch || globalThis.fetch)(url, { ...init, redirect: 'error', signal: controller.signal });
+    if (!response.ok) {
+      if (response.body) { await response.body.cancel(); }
+      throw fail('REQUEST_REJECTED');
+    }
+    const reader = response.body && response.body.getReader();
+    if (!reader) { throw fail('RESPONSE_INVALID'); }
+    const chunks = [];
+    let bytes = 0;
+    try {
+      for (let next = await reader.read(); !next.done; next = await reader.read()) {
+        bytes += next.value.byteLength;
+        if (bytes > MAX_RESPONSE_BYTES) { await reader.cancel(); throw fail('RESPONSE_INVALID'); }
+        chunks.push(next.value);
+      }
+    } finally {
+      reader.releaseLock();
+    }
+    const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    if (!value || typeof value !== 'object' || Array.isArray(value)) { throw fail('RESPONSE_INVALID'); }
+    return value;
+  } catch (error) {
+    // 服务端和网络异常可能回显凭据，只透传本模块生成的固定错误。
+    if (error instanceof CliError && /^QWENWORK_DESKTOP_/.test(error.code)) { throw error; }
+    throw fail(controller.signal.aborted ? 'REQUEST_TIMED_OUT' : 'REQUEST_FAILED');
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/** 客户端内部入口：消费一次性兑换票并持久化双 Token，不调用或重启普通 login。 */
+async function loginQwenWork(options = {}) {
+  const env = options.env || process.env;
+  const raw = options.exchangeTicket || env[TICKET_ENV];
+  const context = options.ticketContext || env[TICKET_CONTEXT_ENV];
+  delete env[TICKET_ENV];
+  delete env[TICKET_CONTEXT_ENV];
+  if (isEnvTokenAuthMode(env) || readManagedContext(env)) { throw fail('MANAGED_AUTH_CONFLICT'); }
+  const ticket = parseTicket(raw, context);
+  const baseUrl = origin(ticket.base_url);
+  const expectedEndpoint = options.endpoint || env.OPENYIDA_ENDPOINT;
+  if (expectedEndpoint && origin(expectedEndpoint) !== baseUrl) { throw fail('ENDPOINT_MISMATCH'); }
+  if (options.corpId && options.corpId !== ticket.corp_id) { throw fail('IDENTITY_MISMATCH'); }
+  const startedAt = Date.now();
+  const value = await requestJson(`${baseUrl}${CONSUME_PATH}`, {
+    method: 'POST', headers: { accept: 'application/json', 'content-type': 'application/json', authorization: `Bearer ${ticket.exchange_ticket}` },
+    body: '{}',
+  }, options);
+  const expiresAt = startedAt + Number(value.expires_in) * 1000;
+  if (value.status !== 'ok' || value.auth_mode !== 'token' || value.can_auto_use !== true ||
+    value.token_type !== 'Bearer' || value.credential_source !== 'qwenwork_desktop' ||
+    'refreshToken' in value || 'exchange_ticket' in value ||
+    typeof value.access_token !== 'string' || !value.access_token || /\s/.test(value.access_token) || value.access_token.length > 32768 ||
+    !Number.isInteger(value.expires_in) || value.expires_in < 1 || value.expires_in > 1800 ||
+    typeof value.refresh_token !== 'string' || !value.refresh_token || /\s/.test(value.refresh_token) || value.refresh_token.length > 32768 ||
+    !Number.isInteger(value.refresh_token_expires_in) || value.refresh_token_expires_in < 1 ||
+    (value.client_id && value.client_id !== DINGTALK_OAUTH_CLIENT_ID) ||
+    value.corp_id !== ticket.corp_id || value.user_id !== ticket.user_id || value.exchange_id !== ticket.exchange_id) { throw fail('CREDENTIAL_INVALID'); }
+  // 票据仍在原签票 origin 消费，业务域名仅来自受信的消费响应。
+  const businessBaseUrl = value.base_url === undefined ? baseUrl : origin(value.base_url);
+  const verified = await requestJson(`${businessBaseUrl}/openapi/cli/v1/auth/status`, {
+    method: 'GET', headers: { authorization: `Bearer ${value.access_token}`, accept: 'application/json' },
+  }, options);
+  if (verified.status !== 'ok' || verified.auth_mode !== 'token' || verified.can_auto_use !== true ||
+    verified.corp_id !== value.corp_id || verified.user_id !== value.user_id || expiresAt <= Date.now()) { throw fail('IDENTITY_MISMATCH'); }
+  const session = saveTokenSession({
+    ...sessionIdentity(value),
+    auth_mode: 'token', token_type: 'Bearer', access_token: value.access_token, refresh_token: value.refresh_token,
+    expires_at: expiresAt, base_url: businessBaseUrl, client_id: DINGTALK_OAUTH_CLIENT_ID,
+    corp_id: value.corp_id, user_id: value.user_id, credential_source: 'qwenwork_desktop',
+  }, options);
+  const restored = loadTokenSession(options);
+  if (!['user', 'project'].includes(session.persistence_scope) || !restored ||
+    restored.access_token !== value.access_token || restored.refresh_token !== value.refresh_token || restored.base_url !== businessBaseUrl ||
+    restored.corp_id !== value.corp_id || restored.user_id !== value.user_id) { throw fail('PERSISTENCE_FAILED'); }
+  // 只返回分类和登录结果；组织/用户标识、环境和存储细节不进入模型可见结果。
+  return { ok: true, status: 'ok', can_auto_use: true, ...sessionIdentity(session) };
+}
+
+async function run(args, options = {}) {
+  if (args.includes('--help') || args.includes('-h')) {
+    const invocation = buildQwenWorkLoginInvocation();
+    if (args.includes('--json')) { console.log(JSON.stringify({ usage: t('qwenwork.desktop_login_usage'), invocation })); }
+    else { console.log(`${t('qwenwork.desktop_login_usage')}\n${t('qwenwork.desktop_login_standalone', invocation.command)}`); }
+    return;
+  }
+  const parsed = {};
+  const seen = new Set();
+  for (let index = 0; index < args.length; index++) {
+    const flag = args[index];
+    if (seen.has(flag)) { throw new CliError(t('qwenwork.desktop_login_usage'), { code: 'CLI_USAGE_ERROR', exitCode: 2, details: { invocation: buildQwenWorkLoginInvocation() } }); }
+    seen.add(flag);
+    if (['--json', '--quiet'].includes(flag)) { continue; }
+    const key = flag === '--corp-id' ? 'corpId' : flag === '--endpoint' ? 'endpoint'
+      : flag === '--exchange-ticket' ? 'exchangeTicket' : flag === '--ticket-context' ? 'ticketContext' : null;
+    const value = args[++index];
+    if (!key || !value || value.startsWith('--')) { throw new CliError(t('qwenwork.desktop_login_usage'), { code: 'CLI_USAGE_ERROR', exitCode: 2, details: { invocation: buildQwenWorkLoginInvocation() } }); }
+    parsed[key] = value;
+  }
+  const result = await loginQwenWork({ ...options, ...parsed });
+  if (args.includes('--json') && !args.includes('--quiet') && (options.env || process.env).YIDA_QUIET !== '1') { console.log(JSON.stringify({ ...result, next_action: 'continue_business_operation_silently', user_visible: false })); }
+  return result;
+}
+
+module.exports = { TICKET_ENV, TICKET_CONTEXT_ENV, loginQwenWork, run };