dsh-agentone 0.5.34 → 0.5.36

package/README.md

@@ -35,7 +35,12 @@ lark-cli / ccpg-cli 状态探测。
   未安装时「安装」一键自助安装（lark 走 `npm install -g @larksuite/cli@latest`，
   ccpg 走公司 `auto-install.sh`，口径与平台 cli-deployd 一致）；
   已装未授权时「去授权」发起官方 Device Flow（授权链接 + ASCII 二维码 +
-  验证码 + 自动轮询确认，设备码仅存插件进程内存）。
+  验证码 + 自动轮询确认，设备码仅存插件进程内存）；
+  lark-cli 首装未 `config init` 时探测为「未配置」，「初始化应用」一键驱动
+  官方 `config init --new`（长驻子进程 + 验证链接/二维码 + 终态轮询，成功后
+  自动衔接设备流授权；关闭弹窗即终止子进程）。平台托管实例不提供自助初始化
+  ——容器内 HERMES_HOME 上下文下 config init 会拒绝执行，应用配置由 Hub 经
+  cli-deployd 统一下发。
 - **全局中文回复默认**：插件启动时在 `$DSH_HOME/AGENTS.md` 注入受标记
   管理的「默认始终使用中文回复」指令块（dsh 官方 agent-instructions 机制，
   每个会话基线加载，project 级指令优先）；幂等不重复注入，用户已有语言

package/lib/index.js

@@ -32,10 +32,11 @@ import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
 import { applyPlatformSkillhub, removePlatformSkillhub } from './skillhub.js';
 import { ensureLanguageDefault } from './language.js';
+import { bootstrapInstanceCredentials, INSTANCE_SOURCE, isInstanceManaged, resolvePlatformUrl } from './instance.js';
 import { beginCliAuth, cliAuthQrcode, completeCliAuth, parseCliAuthBeginOutput } from './cliauth.mjs';
 import { platformFetch } from './http.js';
 import { donePageHtml, statusPageHtml } from './page.js';
-import { compareSemver, dshPluginCli, firstErrorLines, hasChineseText, installCliTool, isTerminalCliAuthFailure, isUnexpectedStoreError, probeCliDetail, probePythonEnv, pnpmViewLatest, runCliTool, unexpectedStoreGuidance, upgradeCliTool } from './proc.js';
+import { compareSemver, dshPluginCli, firstErrorLines, hasChineseText, installCliTool, isTerminalCliAuthFailure, isUnexpectedStoreError, larkCliInitActiveUrl, larkCliInitStatus, probeCliDetail, probePythonEnv, pnpmViewLatest, runCliTool, startLarkCliInit, stopLarkCliInit, unexpectedStoreGuidance, upgradeCliTool } from './proc.js';
 
 import { clearCredentials, loadCredentials, resolveDshHome, saveCredentials, updateCredentials } from './store.js';
 
@@ -735,6 +736,7 @@ button{font:inherit;padding:9px 22px;border-radius:10px;border:none;cursor:point
         const expiresIn = Number(result.expires_in) || 0;
         await saveCredentials(config, {
           schema_version: 2,
+          source: 'user',
           access_token: result.access_token,
           refresh_token: result.refresh_token || null,
           platform_url: config.platformUrl,
@@ -778,6 +780,13 @@ function isDesktopHost() {
 
 export function apply(ctx, config) {
   const log = ctx.logger || console;
+  // 托管实例：注入的平台地址优先。容器内只有这个地址可达（本地部署是
+  // host.docker.internal），插件配置里的默认公网地址在容器里打不通。
+  const injectedPlatformUrl = resolvePlatformUrl(config, null);
+  if (isInstanceManaged() && injectedPlatformUrl !== config.platformUrl) {
+    log.info(`[dsh-agentone] platform url from instance env: ${injectedPlatformUrl}`);
+    config.platformUrl = injectedPlatformUrl;
+  }
   // Desktop 环境探测（官方契约，见 harness-one DESKTOP.md）：desktopProfiles
   // 只在 DSH Desktop 存在。据此把插件管理切到当前 profile，并用受管
   // desktopPnpm 做装/卸/升级（desktop 里 dsh CLI 拒绝操作 desktop profile）。
@@ -835,10 +844,18 @@ export function apply(ctx, config) {
         let skills = null;
         let displayNames = {};
         if (credentials) {
-          const profile = await fetchPlatformProfile(config.platformUrl, credentials.access_token);
-          userEmail = profile?.email ?? null;
-          if (userEmail) {
+          // 身份来源分两种：设备登录走 /api/me（用户令牌）；托管实例的实例级
+          // 凭据按权限边界**不能**调 /api/me（它没有 sub，普通 API 一律 401），
+          // 身份改由插件能力面带回（capabilities.email）。两者都拿不到才算未登录。
+          if (isInstanceManaged()) {
             ({ capabilities, skills, displayNames } = await cachedPlatformStatus(config, credentials));
+            userEmail = capabilities?.email ?? null;
+          } else {
+            const profile = await fetchPlatformProfile(config.platformUrl, credentials.access_token);
+            userEmail = profile?.email ?? null;
+            if (userEmail) {
+              ({ capabilities, skills, displayNames } = await cachedPlatformStatus(config, credentials));
+            }
           }
           // 失败自愈：模型同步残留错误时由轮询驱动后台重试（成功即清，
           // 下次轮询状态页恢复）；错误已被登录/手动同步清除时取消待定
@@ -867,6 +884,10 @@ export function apply(ctx, config) {
           platform_url: config.platformUrl,
           logged_in: Boolean(userEmail),
           user_email: userEmail,
+          // 托管实例：凭据由平台注入，页面据此显示「平台托管」并隐藏登录/登出
+          managed: isInstanceManaged(),
+          source: credentials?.source ?? null,
+          instance_id: credentials?.instance_id ?? null,
           token_expires_at: credentials?.expires_at ?? null,
           plugin_version: PLUGIN_VERSION,
           capabilities,
@@ -1308,6 +1329,17 @@ export function apply(ctx, config) {
     // 与 pendingStates 同生命周期语义——插件重启后用户重新发起即可。
     const pendingCliAuth = new Map();
 
+    // 探测结果 state=missing 时的中文指引（授权与初始化两条链共用）。
+    const cliMissingMessage = (detail) => {
+      if (detail?.reason === 'broken_install') {
+        return 'CLI 安装不完整，请先点击「修复安装」后再授权';
+      }
+      if (detail?.reason === 'unavailable') {
+        return 'CLI 暂时无法访问（可能被安全软件占用或响应超时），请稍后重试；若持续失败请重新安装';
+      }
+      return 'CLI 未安装，请先安装或联系管理员';
+    };
+
     register('/agentone/api/cli/auth/begin', async (request, response) => {
       if (request.method !== 'POST') {
         response.writeHead(405, { allow: 'POST' });
@@ -1325,12 +1357,16 @@ export function apply(ctx, config) {
         const detail = await probeCliDetail(tool, { withLatest: false })
           .then(withCliUpgradeGuard).catch(() => null);
         if (detail?.state === 'missing') {
+          sendJson(response, 400, { error: cliMissingMessage(detail) });
+          return;
+        }
+        // lark-cli 首装未 config init 时 auth login 直接报 not_configured——
+        // 前置拦截给明确指引，而不是让 begin 抛技术错误
+        if (detail?.unconfigured) {
           sendJson(response, 400, {
-            error: detail.reason === 'broken_install'
-              ? 'CLI 安装不完整，请先点击「修复安装」后再授权'
-              : detail.reason === 'unavailable'
-                ? 'CLI 暂时无法访问（可能被安全软件占用或响应超时），请稍后重试；若持续失败请重新安装'
-                : 'CLI 未安装，请先安装或联系管理员',
+            error: isInstanceManaged()
+              ? 'lark-cli 应用配置由平台统一下发，当前实例缺少配置，请重启实例或联系管理员'
+              : 'lark-cli 尚未完成应用初始化，请先点击「初始化应用」完成飞书应用创建',
           });
           return;
         }
@@ -1430,7 +1466,7 @@ export function apply(ctx, config) {
       // CLI（lark-cli / ccpg-cli）的进行中授权会话均可——二维码由内置
       // 编码器生成（lib/qrcode.mjs），不依赖 lark-cli 本机存在。
       const queryUrl = new URL(request.url, 'http://localhost').searchParams.get('url') || '';
-      if (!queryUrl || pendingCliAuth.size === 0) {
+      if (!queryUrl || (pendingCliAuth.size === 0 && !larkCliInitActiveUrl())) {
         sendJson(response, 400, { error: '没有进行中的授权会话' });
         return;
       }
@@ -1444,6 +1480,100 @@ export function apply(ctx, config) {
       }
     });
 
+    // lark-cli 首次应用初始化（config init --new 长驻子进程）。仅独立版桌面
+    // 提供：托管容器内 HERMES_HOME 上下文会让 config init 拒绝执行，且应用
+    // 配置由 Hub 经 cli-deployd 统一下发（instance_service 的 CLI configure
+    // 链路），员工不应在容器里自建飞书应用。
+    register('/agentone/api/cli/auth/init', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const body = await readJsonBody(request);
+        const tool = String(body.tool || '');
+        if (tool !== 'lark-cli') {
+          sendJson(response, 400, { error: '仅 lark-cli 支持应用初始化' });
+          return;
+        }
+        if (isInstanceManaged()) {
+          sendJson(response, 400, {
+            error: '平台托管实例的 lark-cli 应用配置由平台统一下发，如缺失请重启实例或联系管理员',
+          });
+          return;
+        }
+        const detail = await probeCliDetail(tool, { withLatest: false })
+          .then(withCliUpgradeGuard).catch(() => null);
+        if (detail?.state === 'missing') {
+          sendJson(response, 400, { error: cliMissingMessage(detail) });
+          return;
+        }
+        if (detail?.state === 'authorized') {
+          sendJson(response, 400, { error: 'lark-cli 已授权，无需初始化' });
+          return;
+        }
+        if (detail && !detail.unconfigured) {
+          sendJson(response, 400, { error: 'lark-cli 已有应用配置，请直接点击「去授权」' });
+          return;
+        }
+        const parsed = await startLarkCliInit();
+        sendJson(response, 200, {
+          ok: true,
+          tool,
+          verification_url: parsed.url,
+          user_code: parsed.userCode,
+          reused: parsed.reused === true,
+        });
+      } catch (error) {
+        const message = String(error?.message || '');
+        sendJson(response, 502, {
+          error: hasChineseText(message) ? message : '发起初始化失败，请稍后重试',
+        });
+      }
+    });
+
+    register('/agentone/api/cli/auth/init/status', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const body = await readJsonBody(request);
+        const tool = String(body.tool || '');
+        if (tool !== 'lark-cli') {
+          sendJson(response, 400, { error: '仅 lark-cli 支持应用初始化' });
+          return;
+        }
+        const init = larkCliInitStatus();
+        // 子进程退出（成功）后 config.json 已落盘，此时才附带一次三态探测，
+        // 前端据此决定「已授权直接完成」还是「衔接设备流授权」；running
+        // 期间不探测（每 3s 轮询各起一个子进程没有意义）。
+        const detail = init.status === 'succeeded'
+          ? await probeCliDetail(tool, { withLatest: false })
+            .then(withCliUpgradeGuard).catch(() => null)
+          : null;
+        sendJson(response, 200, { ok: true, init, tool: detail });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '查询初始化状态失败' });
+      }
+    });
+
+    register('/agentone/api/cli/auth/init/cancel', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const stopped = await stopLarkCliInit();
+        sendJson(response, 200, { ok: true, stopped });
+      } catch (error) {
+        sendJson(response, 502, { error: error?.message || '取消初始化失败' });
+      }
+    });
+
     register('/agentone/api/plan', async (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });
@@ -1500,6 +1630,14 @@ export function apply(ctx, config) {
         response.end();
         return;
       }
+      // 托管实例的授权来自容器 env（Hub 每次启动重签）：在这里登出既清不掉
+      // 根因，重启后又会「自动登录」，只会让用户困惑——明确说明正确做法。
+      if (isInstanceManaged()) {
+        sendJson(response, 400, {
+          error: '当前实例由 AgentOne 平台托管，授权随实例生命周期自动维护；如需停止使用请删除该实例',
+        });
+        return;
+      }
       try {
         // 先吊销平台侧 refresh token（尽力而为），再清本地；凭据读取失败
         // （文件损坏等）也要走到清凭据，不能把用户卡在登录态。
@@ -1531,10 +1669,18 @@ export function apply(ctx, config) {
       log.warn(`[dsh-agentone] language default check failed: ${error?.message || error}`);
     });
     (async () => {
+      // 托管实例先把 Hub 注入的凭据落盘，再走既有的「已登录」启动流程。
+      await bootstrapInstanceCredentials(config, log).catch((error) => {
+        log.warn(`[dsh-agentone] instance credential bootstrap failed: ${error?.message || error}`);
+      });
       const credentials = await ensureFreshToken(config, log);
       if (!credentials) return;
       await syncPlatformModel(config, log).catch(() => {});
-      await syncPlatformSkillhub(config, log, credentials).catch(() => {});
+      // SkillHub 连接在托管容器里由 Hub 直接注入 env（CLAWHUB_* / SKILLHUB_*），
+      // 插件不再重复写 skillhub.env / clawhub login，避免两个写入方互相盖。
+      if (!isInstanceManaged()) {
+        await syncPlatformSkillhub(config, log, credentials).catch(() => {});
+      }
       await syncPlanSkills(config, log, credentials).catch(() => {});
     })();
 

package/lib/instance.js

@@ -0,0 +1,123 @@
+// 平台托管实例的自动授权（instance bootstrap）。
+//
+// 平台托管的 dsh 容器里没有人在浏览器里点飞书登录，所以 Hub 在容器启动时
+// 注入实例级凭据（app/services/plugin_instance_auth_service.py 签发）：
+//
+//   AGENTONE_PLATFORM_URL   容器内可达的平台地址（本地部署是 host.docker.internal）
+//   AGENTONE_PLUGIN_TOKEN   实例级凭据，只够调 /api/plugin/v1/*
+//   AGENTONE_INSTANCE_ID    实例 id（Hub 对全部镜像统一注入，用于展示与自检）
+//
+// 插件启动读到 token 就把它落成与设备登录同形状的 credentials.json
+// （source: "instance"），后续所有逻辑（模型同步、技能、套餐）无需区分来源。
+// 容器每次 start 都会重建，env 随之重签，因此这里每次都对账：
+//
+// - env token 与本地已存的不同（新容器 / 属主变更 / TTL 轮换）→ 覆盖；
+// - 相同 → 不写盘，避免无谓的原子写与 watcher 抖动；
+// - 没有 env token（独立版/桌面版 dsh）→ 完全不动本地凭据。
+//
+// 凭据对容器内智能体可见（同为 10000:10000），所以它必须是这条最小面凭据——
+// 绝不能是用户主账号令牌（那样 agent 就拿到了 portal 全权）。
+import { loadCredentials, saveCredentials, updateCredentials } from './store.js';
+
+export const PLATFORM_URL_ENV = 'AGENTONE_PLATFORM_URL';
+export const PLUGIN_TOKEN_ENV = 'AGENTONE_PLUGIN_TOKEN';
+export const INSTANCE_ID_ENV = 'AGENTONE_INSTANCE_ID';
+
+/** 托管凭据的来源标记：设备登录写 'user'，Hub 注入写 'instance'。 */
+export const INSTANCE_SOURCE = 'instance';
+export const USER_SOURCE = 'user';
+
+/** 读取注入的实例授权环境变量（未注入时 token 为空）。 */
+export function readInstanceEnv(env = process.env) {
+  return {
+    token: String(env[PLUGIN_TOKEN_ENV] || '').trim(),
+    platformUrl: String(env[PLATFORM_URL_ENV] || '').trim().replace(/\/+$/, ''),
+    instanceId: String(env[INSTANCE_ID_ENV] || '').trim(),
+  };
+}
+
+/** 是否运行在平台托管实例内（判据是注入了实例凭据，而非镜像特征）。 */
+export function isInstanceManaged(env = process.env) {
+  return Boolean(readInstanceEnv(env).token);
+}
+
+/**
+ * 解析 JWT 的 exp（秒）为 ISO 字符串；解不出来返回 null。
+ * 只是为了状态页能显示有效期，失败不影响功能（凭据有效性由平台判定）。
+ */
+export function tokenExpiresAt(token) {
+  const parts = String(token || '').split('.');
+  if (parts.length < 2) return null;
+  try {
+    const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf8'));
+    const exp = Number(payload?.exp);
+    if (!Number.isFinite(exp) || exp <= 0) return null;
+    return new Date(exp * 1000).toISOString();
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 把 Hub 注入的实例凭据写入本地凭据库（幂等）。
+ *
+ * @returns {Promise<{applied: boolean, instanceId: string, platformUrl: string}|null>}
+ *   null 表示当前不是托管实例（无 env token），未做任何改动。
+ */
+export async function bootstrapInstanceCredentials(config, log, env = process.env) {
+  const { token, platformUrl, instanceId } = readInstanceEnv(env);
+  if (!token) return null;
+
+  const platform = platformUrl || config.platformUrl;
+  const existing = await loadCredentials(config);
+  if (
+    existing
+    && existing.source === INSTANCE_SOURCE
+    && existing.access_token === token
+    && existing.platform_url === platform
+  ) {
+    // 容器重建后 env 变了才会走到覆盖分支；这里只补 instance_id/expires 缺失的旧记录
+    if (existing.instance_id === instanceId && existing.expires_at) {
+      return { applied: false, instanceId, platformUrl: platform };
+    }
+  }
+
+  const expiresAt = tokenExpiresAt(token);
+  await saveCredentials(config, {
+    schema_version: 2,
+    source: INSTANCE_SOURCE,
+    access_token: token,
+    // 实例凭据不带 refresh：容器每次 start 由 Hub 重签（重启即续期），
+    // 也让「登出即失效」这类语义留在平台侧。
+    refresh_token: null,
+    platform_url: platform,
+    instance_id: instanceId || null,
+    saved_at: new Date().toISOString(),
+    expires_at: expiresAt,
+  });
+  // 上一轮设备登录留下的同步结果/错误不再适用于新凭据
+  await updateCredentials(config, {
+    model_error: null,
+    model_error_code: null,
+    skillhub_error: null,
+  }).catch(() => {});
+  if (log) {
+    log.info(
+      `[dsh-agentone] instance credential applied (instance=${instanceId || 'unknown'}, platform=${platform})`,
+    );
+  }
+  return { applied: true, instanceId, platformUrl: platform };
+}
+
+/**
+ * 平台地址优先级：注入的实例地址 > 本地凭据里记录的平台 > 插件配置默认值。
+ * 托管实例里注入值必须胜出——那是容器内唯一可达的地址。
+ */
+export function resolvePlatformUrl(config, credentials, env = process.env) {
+  const injected = readInstanceEnv(env).platformUrl;
+  return (
+    injected
+    || credentials?.platform_url
+    || config.platformUrl
+  ).replace(/\/+$/, '');
+}

package/lib/page.js

@@ -536,23 +536,37 @@ const renderCliData = (s, tools, python) => {
   const rows = Object.entries(CLI_TOOL_META).map(([name, meta]) => {
     const info = allTools[name] || { state: 'missing' };
     const state = info.state || 'missing';
+    // lark-cli 首装未 config init：unauthorized + unconfigured 标志——独立版
+    // 给「初始化应用」按钮；托管实例配置由平台下发，只提示不给自助入口
+    //（容器内 HERMES_HOME 上下文下 config init 会拒绝执行）。
+    const unconfigured = state === 'unauthorized' && info.unconfigured;
     const status = state === 'authorized'
       ? '<span class="pill ok" style="font-size:11px">已授权</span>'
-      : state === 'unauthorized'
-        ? '<span class="pill warn" style="font-size:11px">未授权</span>'
-        : info.reason === 'broken_install'
-          ? '<span class="pill warn" style="font-size:11px">安装损坏</span>'
-          : '<span class="pill warn" style="font-size:11px">未安装</span>';
+      : unconfigured
+        ? '<span class="pill warn" style="font-size:11px">未配置</span>'
+        : state === 'unauthorized'
+          ? '<span class="pill warn" style="font-size:11px">未授权</span>'
+          : info.reason === 'broken_install'
+            ? '<span class="pill warn" style="font-size:11px">安装损坏</span>'
+            : '<span class="pill warn" style="font-size:11px">未安装</span>';
     const versionLine = meta.desc + ' · ' + meta.label
       + (info.reason === 'broken_install' ? ' · 检测到文件不完整，请修复安装' : '')
+      + (unconfigured
+        ? (s.managed ? ' · 应用配置由平台统一下发，当前缺失请联系管理员' : ' · 首次使用需先创建飞书应用')
+        : '')
       + (info.version ? ' · v' + esc(info.version) : '')
       + (info.latest && info.latest !== info.version
         ? ' → <b>v' + esc(info.latest) + '</b>'
         : '');
     const upgradable = info.latest && info.latest !== info.version;
-    // 已装未授权 → 「去授权」；残缺安装 → 「修复安装」
+    // 已装未配置 → 「初始化应用」；已装未授权 → 「去授权」；残缺安装 → 「修复安装」
     const actions = [
-      state === 'unauthorized'
+      unconfigured
+        ? (s.managed
+          ? ''
+          : '<button class="btn small primary" data-cli-init="' + esc(name) + '">初始化应用</button>')
+        : '',
+      state === 'unauthorized' && !unconfigured
         ? '<button class="btn small primary" data-cli-auth="' + esc(name) + '">去授权</button>'
         : '',
       state === 'missing'
@@ -590,7 +604,7 @@ const renderCliData = (s, tools, python) => {
     : '';
   body.innerHTML = rows.join('') + pythonRow
     + '<div class="hint">在对话中直接使用（如 /lark 帮助），由 dsh 自动调用。</div>'
-    + '<div class="hint">未安装时点「安装」自助安装（Python 同样支持）；已安装未授权时点「去授权」用飞书扫码完成即可。</div>';
+    + '<div class="hint">未安装时点「安装」自助安装（Python 同样支持）；lark-cli 首次使用需先「初始化应用」创建飞书应用，再扫码完成授权。</div>';
   body.querySelectorAll('[data-cli-upgrade]').forEach((btn) => {
     btn.onclick = () => cliUpgrade(btn.dataset.cliUpgrade, btn);
   });
@@ -600,6 +614,9 @@ const renderCliData = (s, tools, python) => {
   body.querySelectorAll('[data-cli-auth]').forEach((btn) => {
     btn.onclick = () => cliAuthDialog(btn.dataset.cliAuth);
   });
+  body.querySelectorAll('[data-cli-init]').forEach((btn) => {
+    btn.onclick = () => cliInitDialog(btn.dataset.cliInit);
+  });
 };
 
 /**
@@ -713,6 +730,134 @@ const cliAuthDialog = async (tool) => {
   }
 };
 
+// PAGE_JS 是模板字面量：内部注释与代码一律不用反引号（会提前终止模板）。
+/**
+ * lark-cli 应用初始化弹窗：后端以长驻子进程驱动官方 config init --new
+ *（阻塞式、无 --no-wait），前端轮询 init/status 直到子进程退出（用户在
+ * 浏览器/扫码完成应用创建）。成功后按三态衔接：已授权直接完成；未授权
+ * 自动打开「去授权」设备流弹窗。关闭弹窗会取消并终止后端初始化进程。
+ */
+const cliInitDialog = async (tool) => {
+  const overlay = document.createElement('div');
+  overlay.className = 'modal-backdrop';
+  overlay.innerHTML = '<div class="card" style="max-width:420px;margin:8% auto;text-align:left">'
+    + '<h3 style="margin:0 0 6px">初始化 ' + esc(tool) + '</h3>'
+    + '<div id="cli-init-status" class="skill-sub">正在发起应用初始化…</div>'
+    + '<img id="cli-init-qr" alt="配置二维码" style="display:none;width:100%;max-width:300px;'
+    + 'background:#fff;border-radius:10px;margin:10px 0">'
+    + '<div id="cli-init-link"></div>'
+    + '<div class="row" style="margin-top:12px;justify-content:flex-end">'
+    + '<button id="cli-init-open" class="btn small primary" hidden>打开配置页</button>'
+    + '<button id="cli-init-copy" class="btn small ghost" hidden>复制验证码</button>'
+    + '<button id="cli-init-close" class="btn small ghost">关闭</button></div></div>';
+  document.body.appendChild(overlay);
+  let pollTimer = null;
+  let closed = false;
+  const statusEl = overlay.querySelector('#cli-init-status');
+  const stopPolling = () => {
+    closed = true;
+    if (pollTimer) clearTimeout(pollTimer);
+  };
+  // 关闭即取消：终止后端初始化子进程（已终态时后端为 no-op，可安全直调）
+  const close = () => {
+    stopPolling();
+    fetch('api/cli/auth/init/cancel', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ tool }),
+    }).catch(() => {});
+    overlay.remove();
+  };
+  overlay.querySelector('#cli-init-close').onclick = close;
+  overlay.addEventListener('click', (event) => { if (event.target === overlay) close(); });
+  try {
+    const resp = await fetch('api/cli/auth/init', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ tool }),
+    });
+    const data = await resp.json().catch(() => ({}));
+    if (!resp.ok) throw new Error(data.error || '发起初始化失败');
+    statusEl.textContent = '用手机飞书 App 扫二维码，或打开链接完成应用创建。完成后此处会自动继续。';
+    fetch('api/cli/auth/qrcode?url=' + encodeURIComponent(data.verification_url))
+      .then((r) => (r.ok ? r.text() : ''))
+      .then((svg) => {
+        const qr = overlay.querySelector('#cli-init-qr');
+        if (svg && svg.startsWith('<svg')) {
+          qr.src = 'data:image/svg+xml;utf8,' + encodeURIComponent(svg);
+          qr.style.display = 'block';
+        }
+      })
+      .catch(() => {});
+    const openBtn = overlay.querySelector('#cli-init-open');
+    openBtn.hidden = false;
+    openBtn.onclick = () => window.open(data.verification_url, '_blank');
+    const copyBtn = overlay.querySelector('#cli-init-copy');
+    if (data.user_code) {
+      copyBtn.hidden = false;
+      copyBtn.onclick = async () => {
+        try {
+          await navigator.clipboard.writeText(data.user_code);
+          copyBtn.textContent = '已复制';
+        } catch {
+          copyBtn.textContent = data.user_code;
+        }
+      };
+      overlay.querySelector('#cli-init-link').innerHTML
+        = '<div class="skill-sub">验证码：<b>' + esc(data.user_code) + '</b></div>';
+    }
+    // 自调度串行轮询（与授权弹窗同口径）：running 继续等；succeeded 按三态
+    // 衔接；failed/cancelled 展示输出尾部诊断。
+    const poll = async () => {
+      if (closed) return;
+      try {
+        const r = await fetch('api/cli/auth/init/status', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ tool }),
+        });
+        const d = await r.json().catch(() => ({}));
+        const init = d.init || {};
+        if (init.status === 'running') {
+          statusEl.textContent = '正在等待你在配置页完成应用创建…';
+          pollTimer = setTimeout(poll, 3000);
+          return;
+        }
+        if (init.status === 'succeeded') {
+          stopPolling();
+          if (d.tool && d.tool.state === 'authorized') {
+            statusEl.textContent = '✓ 初始化并授权完成';
+            renderCliData(lastStatus, { [tool]: d.tool });
+            setTimeout(() => overlay.remove(), 800);
+            return;
+          }
+          // config init 只建应用，用户 token 未必随带：自动衔接设备流授权
+          statusEl.textContent = '✓ 应用创建完成，正在发起授权…';
+          overlay.remove();
+          cliAuthDialog(tool);
+          return;
+        }
+        stopPolling();
+        if (init.status === 'cancelled') {
+          statusEl.textContent = '已取消初始化。';
+          return;
+        }
+        // PAGE_JS 是模板字面量：换行符须写 \\n，写 \n 会被模板吃掉变成真实
+        // 换行、产出未闭合的字符串字面量炸掉整页脚本
+        const tail = String(init.output || '').split('\\n').filter(Boolean).slice(-3).join(' ');
+        statusEl.textContent = tail
+          ? '初始化失败：' + tail
+          : '初始化失败，请重试；持续失败请升级 lark-cli 后再试。';
+      } catch {
+        if (!closed) pollTimer = setTimeout(poll, 3000);
+      }
+    };
+    pollTimer = setTimeout(poll, 3000);
+  } catch (error) {
+    statusEl.textContent = error.message || '发起初始化失败';
+  }
+};
+
 /** CLI 一键安装：lark 走 npm 全局安装（机器无 Node.js 时先自动补装）、
  * ccpg/python 走官方安装器，耗时可达数分钟。响应自带安装后立即探测的
  * 详情，直接合进缓存刷新界面。 */
@@ -970,6 +1115,7 @@ const renderAbout = (s) => {
   const lines = [
     aboutVersionRow(),
     '<div class="kv"><span class="k">登录账号</span><span class="v">' + esc(s.user_email || '未登录') + '</span></div>',
+    '<div class="kv"><span class="k">授权方式</span><span class="v muted">' + (s.managed ? '平台托管（实例内自动授权，无需登录）' : '飞书登录') + '</span></div>',
     '<div class="kv"><span class="k">所属套餐</span><span class="v">' + esc(s.capabilities?.plan_name || '—') + '</span></div>',
     '<div class="kv"><span class="k">平台地址</span><span class="v muted">' + esc(s.platform_url || '—') + '</span></div>',
     '<div class="kv"><span class="k">开发者</span><span class="v"><a href="mailto:chumingjun@cc-pg.cn">chumingjun@cc-pg.cn</a></span></div>',
@@ -1053,12 +1199,15 @@ const refresh = async () => {
   // 瞬时失败）就触发一次同步；节流 + 单飞，装完列表变 installed 自然停
   if (s.logged_in && skillhubEnabled) maybeAutoSyncPlanSkills(false);
   statePill.className = 'pill ' + (s.logged_in ? 'ok' : 'warn');
-  statePill.textContent = s.logged_in ? '已登录' : '未登录';
+  // 托管实例（平台注入实例凭据）显示「平台托管」：用户没有做过登录动作，
+  // 写「已登录」会让人以为是自己登的，还会去找登出按钮。
+  statePill.textContent = s.logged_in ? (s.managed ? '平台托管' : '已登录') : '未登录';
   // 首个状态到达：骨架占位让位给登录卡/主内容
   bootCard.hidden = true;
   loginCard.hidden = s.logged_in;
   mainCards.hidden = !s.logged_in;
-  logoutBtn.hidden = !s.logged_in;
+  // 托管态不给登出按钮：授权来自容器 env，登出既清不掉根因、重启又会自动登录
+  logoutBtn.hidden = !s.logged_in || Boolean(s.managed);
   if (s.logged_in && s.model) {
     const m = s.model;
     const lines = [];

package/lib/proc.js

@@ -5,7 +5,7 @@
 // （execFile 参数数组，不经 shell 拼接；win32 的 .cmd/.bat shim 是唯一
 // 例外——按 CVE-2024-27980 后的 Node 约定经 cmd.exe /d /s /c 执行，
 // 参数仍是数组形态）与错误翻译；包名/版本白名单在 index.js 的调用侧执行。
-import { execFile } from 'node:child_process';
+import { execFile, spawn } from 'node:child_process';
 import { existsSync, mkdirSync, readdirSync, renameSync, rmSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
 import { join, dirname, isAbsolute, delimiter as pathDelimiter } from 'node:path';
@@ -296,13 +296,21 @@ export function decodeOutput(buf) {
  * cmd.exe /d /s /c 路由，cmd.exe 在第三个兑底目录（System32）。只前置
  * 解析到的那个目录会让 shim 内部找不到依赖，必须整组前置。输出按
  * encoding:buffer 收回后 decodeOutput（GBK 容错）。opts.env 只传增量变量。 */
-function execResolvedPath(resolved, args, { timeoutMs, cwd, env } = {}) {
-  const childEnv = { ...process.env, ...desktopShimEnvDefaults(), ...(env || {}) };
+/** 子进程 env 组装：进程 env + 桌面 shim 变量 + 调用方增量，PATH 前置
+ * 全部兑底目录。execResolvedPath 与 config init 长驻子进程共用，保证两
+ * 条路径的子进程看到同一个世界。 */
+function composeChildEnv(extraEnv) {
+  const childEnv = { ...process.env, ...desktopShimEnvDefaults(), ...(extraEnv || {}) };
   const key = pathEnvKey(childEnv, process.platform);
   const extras = extraBinDirs().filter((dir) => existsSync(dir));
   if (extras.length) {
     childEnv[key] = childPathWithExtras(childEnv[key], extras, desktopShimDirs());
   }
+  return childEnv;
+}
+
+function execResolvedPath(resolved, args, { timeoutMs, cwd, env } = {}) {
+  const childEnv = composeChildEnv(env);
   const shim = cmdShimInvocation(process.platform, resolved, args);
   return execFileAsync(shim ? shim.file : resolved, shim ? shim.args : args, {
     timeout: timeoutMs,
@@ -595,6 +603,202 @@ export function isTerminalCliAuthFailure(error) {
   return /expired|invalid|denied|拒绝|失效|过期/i.test(String(error?.message || ''));
 }
 
+// ── lark-cli 首次应用初始化（config init --new）───────────────────────
+//
+// lark-cli ≥1.0.9x 首次使用必须先 `config init` 创建应用（写
+// ~/.lark-cli/config.json），auth login 设备流才可用；未配置时 auth
+// status / auth login 均以退出码 3 返回 not_configured。config init 是
+// **阻塞式**命令：打印验证 URL 后原地轮询 /oauth/v1/app/registration
+// 直到浏览器完成，没有 --no-wait/--json（实测 1.0.96 参数面）——因此
+// 不能走 runCliTool（execFile 等退出才拿得到输出），必须长驻子进程 +
+// 流式捕获 stdout 解析 URL，终态由状态轮询接口读取。
+//
+// 两处硬约束：
+// - lark-cli 检测到 HERMES_HOME/OPENCLAW_HOME 即认为 Agent 上下文，
+//   config init 直接拒绝执行——初始化子进程必须剥离这两个变量。
+//   注意 auth login / auth status **不剥**：托管容器里它们正是 lark-cli
+//   读取作用域配置（/opt/data/.lark-cli/hermes）的依据。
+// - win32 下命令是 .cmd shim（cmd.exe → node → lark-cli.exe），只杀
+//   cmd.exe 会漏掉 lark-cli.exe 继续在后台轮询（实测复现），必须
+//   taskkill /T /F 杀整棵进程树。
+
+/** 判定输出是否为「应用未配置」（auth status/login 的 not_configured）。 */
+export function larkNotConfigured(raw) {
+  const data = parseJsonObject(String(raw || '').trim());
+  const error = data && typeof data.error === 'object' ? data.error : null;
+  return Boolean(error && String(error.subtype || '') === 'not_configured');
+}
+
+/** 从 config init --new 的流式输出解析验证链接与 user_code（纯函数）。
+ * 输出里的 ASCII 二维码块不含 http，首个 URL 即官方打印的配置链接。 */
+export function parseLarkCliInitOutput(text) {
+  const match = /https?:\/\/[^\s'"<>]+/.exec(String(text || ''));
+  if (!match) return null;
+  const url = match[0];
+  let userCode = '';
+  try {
+    userCode = new URL(url).searchParams.get('user_code') || '';
+  } catch {
+    userCode = '';
+  }
+  return { url, userCode };
+}
+
+/** 剥离 Agent 上下文变量（纯函数，不改动入参）：config init 在
+ * HERMES_HOME/OPENCLAW_HOME 下会拒绝执行。 */
+export function stripAgentHomeEnv(env) {
+  const next = { ...(env || {}) };
+  delete next.HERMES_HOME;
+  delete next.OPENCLAW_HOME;
+  return next;
+}
+
+const LARK_INIT_WATCHDOG_MS = 20 * 60_000;
+const LARK_INIT_URL_TIMEOUT_MS = 30_000;
+
+/** 当前（或上一次）初始化会话；终态结果保留到下一次 start，供状态轮询。 */
+let larkInitSession = null;
+
+/** 进行中初始化会话的 URL（二维码接口的门禁用；无进行中会话返回 null）。 */
+export function larkCliInitActiveUrl() {
+  return larkInitSession && larkInitSession.status === 'running' ? larkInitSession.url : null;
+}
+
+/** 初始化会话快照（无会话时 status: 'idle'）。output 为输出尾部（诊断用）。 */
+export function larkCliInitStatus() {
+  if (!larkInitSession) return { status: 'idle' };
+  const { url, userCode, startedAt, status, exitCode } = larkInitSession;
+  return {
+    status,
+    url,
+    userCode,
+    startedAt,
+    exitCode,
+    output: (larkInitSession.tail || []).slice(-8).join('\n'),
+  };
+}
+
+/** 杀整棵进程树（win32 的 .cmd shim 形态：cmd.exe → node → lark-cli.exe）。 */
+function killProcessTree(child) {
+  if (!child || child.exitCode !== null || child.killed || !child.pid) return;
+  if (process.platform === 'win32') {
+    const taskkill = resolveCommandOrNull('taskkill') || 'taskkill';
+    execFileAsync(taskkill, ['/PID', String(child.pid), '/T', '/F']).catch(() => {
+      child.kill('SIGKILL');
+    });
+  } else {
+    child.kill('SIGKILL');
+  }
+}
+
+/**
+ * 启动（或复用进行中的）lark-cli 应用初始化：spawn `config init --new`，
+ * 流式捕获输出、解析出验证 URL 即返回；子进程继续在后台等待浏览器完成，
+ * 终态（succeeded/failed/cancelled）由 larkCliInitStatus 轮询。URL 未在
+ * urlTimeoutMs 内出现视为启动失败（老版本无该子命令/输出形态变化）。
+ */
+export async function startLarkCliInit({ urlTimeoutMs = LARK_INIT_URL_TIMEOUT_MS } = {}) {
+  if (larkInitSession && larkInitSession.status === 'running') {
+    const existing = await Promise.race([
+      larkInitSession.ready,
+      new Promise((_, reject) => setTimeout(
+        () => reject(cliFailure('timeout', '初始化正在启动中，请稍后重试')),
+        urlTimeoutMs,
+      )),
+    ]);
+    return { url: existing.url, userCode: existing.userCode, reused: true };
+  }
+
+  const resolved = resolveCommandOrNull('lark-cli');
+  if (!resolved) {
+    throw cliFailure('missing_command', missingCommandGuidance('lark-cli'));
+  }
+  const args = ['config', 'init', '--new'];
+  const shim = cmdShimInvocation(process.platform, resolved, args);
+  const session = {
+    child: null,
+    url: null,
+    userCode: '',
+    startedAt: Date.now(),
+    status: 'running',
+    exitCode: null,
+    tail: [],
+    chunks: [],
+    ready: null,
+    watchdog: null,
+  };
+  let resolveReady;
+  session.ready = new Promise((resolve) => {
+    resolveReady = resolve;
+  });
+
+  const onChunk = (buf) => {
+    session.chunks.push(buf);
+    const text = decodeOutput(Buffer.concat(session.chunks));
+    session.tail = text.split('\n').map((line) => line.trim()).filter(Boolean);
+    if (!session.url) {
+      const parsed = parseLarkCliInitOutput(text);
+      if (parsed) {
+        session.url = parsed.url;
+        session.userCode = parsed.userCode;
+        resolveReady(parsed);
+      }
+    }
+  };
+
+  session.child = spawn(shim ? shim.file : resolved, shim ? shim.args : args, {
+    env: stripAgentHomeEnv(composeChildEnv()),
+    windowsVerbatimArguments: shim?.verbatim === true,
+    windowsHide: true,
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  session.child.stdout.on('data', onChunk);
+  session.child.stderr.on('data', onChunk);
+  session.child.on('error', (error) => {
+    session.tail.push(String(error?.message || error));
+    if (!session.url) resolveReady({ url: null, userCode: '' });
+    session.status = 'failed';
+  });
+  session.child.on('exit', (code) => {
+    clearTimeout(session.watchdog);
+    session.exitCode = code;
+    if (!session.url) resolveReady({ url: null, userCode: '' });
+    if (session.status !== 'cancelled') {
+      session.status = code === 0 ? 'succeeded' : 'failed';
+    }
+  });
+  session.watchdog = setTimeout(() => {
+    session.tail.push('[plugin] 初始化超时（20 分钟），已终止，请重试');
+    killProcessTree(session.child);
+    if (session.status === 'running') session.status = 'cancelled';
+  }, LARK_INIT_WATCHDOG_MS);
+
+  larkInitSession = session;
+  const parsed = await Promise.race([
+    session.ready,
+    new Promise((_, reject) => setTimeout(
+      () => reject(cliFailure('timeout', '初始化启动超时：未能从 lark-cli 输出中解析到配置链接，请重试；持续失败请升级 lark-cli 后再试')),
+      urlTimeoutMs,
+    )),
+  ]);
+  if (!parsed?.url) {
+    throw cliFailure(
+      'init_failed',
+      `初始化进程异常退出：${session.tail.slice(-3).join('；')}`.slice(0, 300),
+    );
+  }
+  return { url: parsed.url, userCode: parsed.userCode, reused: false };
+}
+
+/** 取消进行中的初始化（杀进程树）；无可取消会话返回 false。 */
+export async function stopLarkCliInit() {
+  if (!larkInitSession || larkInitSession.status !== 'running') return false;
+  larkInitSession.status = 'cancelled';
+  clearTimeout(larkInitSession.watchdog);
+  killProcessTree(larkInitSession.child);
+  return true;
+}
+
 /** 从 pnpm -g 前置校验报错里解析全局 bin 目录。pnpm 12 起输出会把
  * "is not in PATH" 折行并加竖线装饰（单行正则取不到），且 runCliTool
  * 的摘要只保留 ERR_ 行（路径被丢弃）——必须对 error.raw 完整输出跑。 */
@@ -659,10 +863,14 @@ export async function probeCliDetail(tool, { timeoutMs = 15000, withLatest = tru
   const state = larkStyleAuthorized(stdout) || ccpgStyleAuthorized(stdout)
     ? 'authorized'
     : 'unauthorized';
+  // lark-cli 首装机器上 auth status 退出码 3 + not_configured：仍归
+  // unauthorized（已装未授权大类不变），额外带 unconfigured 标志让前端
+  // 把「去授权」换成「初始化应用」。ccpg-cli 无此形态，恒为 false。
+  const unconfigured = tool === 'lark-cli' && state === 'unauthorized' && larkNotConfigured(stdout);
   const latest = withLatest
     ? await cliLatestVersion(tool, timeoutMs).catch(() => null)
     : null;
-  return { state, version: selected.version, latest };
+  return { state, unconfigured, version: selected.version, latest };
 }
 
 /** npm registry 的包 latest 版本（curl 直查 JSON，与机器上有无 node/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.34",
-  "description": "AgentOne 平台集成插件：飞书登录、平台模型（直连 Token Hub 不过境平台、同步失败自愈重试）、SkillHub 技能（升级检测一键升级、装后即时刷新、套餐技能自动同步）、套餐申请、插件管理与自助升级、lark-cli / ccpg-cli 探测与一键安装（请求超时与错误码透传、令牌轮换 single-flight、凭据损坏容错与并发安全写入、状态页 UX 增强、全局中文回复默认（AGENTS.md 受标记管理、永不覆盖用户设置）、桌面版设置页白屏修复（iframe 子框架导航无桌面令牌改走主框架 fetch + srcdoc 渲染）、「关于」页升级中态跨状态轮询保留（点升级不再像没反应、不再并发重复升级）与 toast 常驻定位修复、平台模型同步写进 dsh 活配置层（DSH ≥0.1.7 即时生效不再要重启）与测试污染真实 home 修复）",
+  "version": "0.5.36",
+  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；lark-cli 首装一键初始化飞书应用；平台托管实例免登录自动授权",
   "type": "module",
   "scripts": {
     "smoke": "node scripts/env-matrix-smoke.mjs"