openyida 2026.10.27 → 2026.10.28-beta.1

package/README.md

@@ -143,6 +143,27 @@ 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.
+
+For QwenWork cloud identity diagnostics, run inside the actual cloud execution environment:
+
+```bash
+openyida auth qwenwork user-info --json
+```
+
+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 +478,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-pre-beta.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+'use strict';
+const os = require('node:os');
+const path = require('node:path');
+const config = require('../package.json').openyidaLocalBeta;
+// PRE beta 消费包内测试默认值，真实凭据仍由原认证模块管理。
+process.env.OPENYIDA_ENDPOINT ||= config.baseUrl;
+process.env.OPENYIDA_ENV ||= config.environment;
+process.env.OPENYIDA_AUTH_DIR ||= path.join(os.homedir(), '.openyida', config.authDirectory);
+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/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,93 @@
+'use strict';
+
+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 });
+}
+
+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.pathname !== '/' || url.search || url.hash) { throw new Error(); }
+    return url.origin;
+  } catch { throw failure('ENDPOINT_INVALID'); }
+}
+
+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' },
+      body: JSON.stringify({ gateway_url: credential.base_url, ...(options.corpId ? { corp_id: options.corpId } : {}) }),
+    });
+    if (!response.ok) {
+      await response.body?.cancel();
+      throw failure('HTTP_ERROR', { stage: 'yida_exchange', status_code: response.status });
+    }
+    const reader = response.body?.getReader();
+    if (!reader) { throw failure('RESPONSE_INVALID'); }
+    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_INVALID'); }
+        chunks.push(part.value);
+      }
+    } finally { reader.releaseLock(); }
+    return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+  } catch (error) {
+    // 上游正文和异常可能回显凭据，仅保留本模块生成的固定错误码。
+    if (error instanceof CliError && /^QWENWORK_CLOUD_/.test(error.code)) { throw error; }
+    throw failure(controller.signal.aborted ? 'REQUEST_TIMED_OUT' : 'REQUEST_FAILED');
+  } 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 = await exchangeSession(credential, baseUrl, options);
+    if (!value || value.status !== 'ok' || value.auth_mode !== 'token' || value.can_auto_use !== true ||
+      value.token_type !== 'Bearer' || value.credential_source !== 'qwenwork_cloud' ||
+      typeof value.access_token !== 'string' || !value.access_token || /\s/.test(value.access_token) || value.access_token.length > 32768 ||
+      value.access_token === credential.access_token ||
+      ['QWENWORK_AGENT_TOKEN', 'MULE_AGENT_TOKEN', 'AGENT_TOKEN'].some(name => value.access_token === (options.env || process.env)[name]) ||
+      !Number.isInteger(value.expires_in) || value.expires_in <= 0 || value.expires_in > 1800 ||
+      typeof value.corp_id !== 'string' || !/^(?:ding[0-9a-f]{32}|dingd8e1123006514592)$/.test(value.corp_id) ||
+      typeof value.user_id !== 'string' || !value.user_id || value.user_id.trim() !== value.user_id || value.user_id.length > 256 ||
+      (options.corpId && value.corp_id !== options.corpId) ||
+      (options.userId && value.user_id !== options.userId) ||
+      'exchange_ticket' in value) { throw failure('RESPONSE_INVALID'); }
+    return {
+      auth_mode: 'token', credential_source: 'qwenwork_cloud', token_type: 'Bearer',
+      // 可信宜搭签发服务决定业务域名；认证请求仍只发往最初选择的 origin。
+      access_token: value.access_token, base_url: value.base_url === undefined ? baseUrl : origin(value.base_url),
+      client_id: options.clientId || DINGTALK_OAUTH_CLIENT_ID,
+      corp_id: value.corp_id, user_id: value.user_id,
+      expires_at: startedAt + value.expires_in * 1000,
+    };
+  } finally { credential.access_token = undefined; }
+}
+
+module.exports = { exchangeQwenWorkCloudSession };

package/lib/auth/qwenwork-desktop.js

@@ -0,0 +1,154 @@
+'use strict';
+
+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({
+    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 };
+}
+
+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 };

package/lib/auth/qwenwork-login.js

@@ -0,0 +1,108 @@
+'use strict';
+const { t } = require('../core/i18n');
+const { CliError } = require('../core/cli-error');
+const { loadTokenSession, resolveTokenSession, isEnvTokenAuthMode, hasEnvTokenCredential, saveTokenSession } = require('./token-store');
+const { detectRuntimeCapabilities } = require('../core/utils');
+const { isQwenWorkWebRuntime } = require('../core/qwenwork-login-guidance');
+const { exchangeQwenWorkCloudSession } = require('./qwenwork-cloud');
+const { tokenLogin, tokenRefresh, isRefreshAuthRequired } = require('./token-auth');
+
+function failure(code) {
+  return new CliError(t('qwenwork.login_check_failed'), { code });
+}
+function summary(ok) { return { ok, status: ok ? 'ok' : 'not_logged_in', can_auto_use: ok }; }
+
+/** 以服务端状态为准；网络异常不能触发浏览器登录。 */
+async function verify(session, options = {}) {
+  if (!session || !session.access_token) { return false; }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), options.timeoutMs || 15000);
+  try {
+    const response = await (options.fetch || globalThis.fetch)(`${session.base_url.replace(/\/$/, '')}/openapi/cli/v1/auth/status`, {
+      headers: { authorization: `Bearer ${session.access_token}`, accept: 'application/json' },
+      redirect: 'error', signal: controller.signal,
+    });
+    if ([401, 403].includes(response.status)) { await response.body?.cancel(); return false; }
+    if (!response.ok) { await response.body?.cancel(); throw failure('QWENWORK_LOGIN_CHECK_FAILED'); }
+    const reader = response.body?.getReader();
+    if (!reader) { throw failure('QWENWORK_LOGIN_CHECK_FAILED'); }
+    const chunks = []; let size = 0;
+    try {
+      for (let part = await reader.read(); !part.done; part = await reader.read()) {
+        size += part.value.byteLength;
+        if (size > 65536) { await reader.cancel(); throw failure('QWENWORK_LOGIN_CHECK_FAILED'); }
+        chunks.push(part.value);
+      }
+    } finally { reader.releaseLock(); }
+    const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    if (value.status !== 'ok' || value.can_auto_use !== true || value.auth_mode !== 'token') {
+      if (['not_logged_in', 'invalid_access_token', 'token_expired', 'auth_required'].includes(value.status)) { return false; }
+      throw failure('QWENWORK_LOGIN_CHECK_FAILED');
+    }
+    if (value.corp_id !== session.corp_id || value.user_id !== session.user_id ||
+      (options.corpId && value.corp_id !== options.corpId)) { throw failure('QWENWORK_LOGIN_IDENTITY_MISMATCH'); }
+    return true;
+  } catch (error) {
+    if (error instanceof CliError) { throw error; }
+    throw failure('QWENWORK_LOGIN_CHECK_FAILED');
+  } finally { clearTimeout(timer); }
+}
+
+/** 网页态消费宿主凭据；其他宿主保留已有登录态与前台 OAuth 流程。 */
+async function ensureQwenWorkLogin(options = {}, dependencies = {}) {
+  const env = options.env || process.env;
+  const runtime = options.runtime || detectRuntimeCapabilities({ env });
+  if (isQwenWorkWebRuntime(runtime) && !isEnvTokenAuthMode(env) && !hasEnvTokenCredential(env)) {
+    if (options.checkOnly) { return summary(await verify(loadTokenSession(options), options)); }
+    const selectedProfile = options.authProfile || options.profile || env.OPENYIDA_AUTH_PROFILE;
+    const selectedSession = selectedProfile ? loadTokenSession(options) : null;
+    if (selectedProfile && !selectedSession) { throw failure('AUTH_PROFILE_REQUIRED'); }
+    const cloudOptions = {
+      ...options,
+      endpoint: options.endpoint || env.OPENYIDA_ENDPOINT || selectedSession?.base_url,
+      corpId: options.corpId || env.OPENYIDA_AUTH_CORP_ID || selectedSession?.corp_id,
+      userId: options.userId || env.OPENYIDA_AUTH_USER_ID || selectedSession?.user_id,
+    };
+    const session = await exchangeQwenWorkCloudSession(cloudOptions);
+    if (!await verify(session, options)) { throw failure('QWENWORK_LOGIN_CHECK_FAILED'); }
+    saveTokenSession(session, options);
+    return summary(true);
+  }
+  const resolution = resolveTokenSession(options);
+  if (resolution.status === 'profile_required') { throw failure('AUTH_PROFILE_REQUIRED'); }
+  let session = loadTokenSession(options);
+  if (session && options.endpoint && new URL(session.base_url).origin !== new URL(options.endpoint).origin) {
+    session = null;
+  }
+  if (await verify(session, options)) { return summary(true); }
+  if (session?.refresh_token) {
+    try {
+      const refreshed = await (dependencies.refresh || tokenRefresh)(options);
+      if (refreshed && refreshed.ok !== false && refreshed.access_token) {
+        if (await verify(refreshed, options)) { return summary(true); }
+      } else if (!isRefreshAuthRequired(refreshed)) { throw failure('QWENWORK_LOGIN_REFRESH_FAILED'); }
+    } catch (error) {
+      if (!isRefreshAuthRequired(error) && ![401, 403].includes(error.statusCode)) {
+        if (error instanceof CliError) { throw error; }
+        throw failure('QWENWORK_LOGIN_REFRESH_FAILED');
+      }
+    }
+  }
+  if (options.checkOnly) { return summary(false); }
+  if (isEnvTokenAuthMode(env) || isQwenWorkWebRuntime(runtime)) { throw failure('QWENWORK_LOGIN_FAILED'); }
+  const result = await (dependencies.login || tokenLogin)(options);
+  if (!result || result.ok === false || !result.access_token || !await verify(result, options)) {
+    throw failure('QWENWORK_LOGIN_FAILED');
+  }
+  return summary(true);
+}
+
+async function run(args, options = {}) {
+  const result = await ensureQwenWorkLogin({ ...options, checkOnly: args.includes('--check-only') });
+  if (args.includes('--json') && !args.includes('--quiet') && process.env.YIDA_QUIET !== '1') {
+    console.log(JSON.stringify(result));
+  }
+  if (!result.ok) { process.exitCode = 1; }
+  return result;
+}
+module.exports = { ensureQwenWorkLogin, run };