@jesonliu/lark-claudecode-bridge 1.0.5 → 1.2.0

package/assets/web/js/pages/larkcli-device.js

@@ -1,12 +1,14 @@
-// ============ 飞书扫码授权（设备流）：页面内二维码弹窗 ============
-// 与「拉终端」并列的第二条授权路径——把 lark-cli 的 device flow 搬到配置页里，用户直接
-// 扫码完成，不用切窗口。它不经过终端探测，因此无桌面 / SSH 环境同样可用（那条路上
-// 「去终端授权」原本是无出口的死路）。
+// ============ 飞书配置应用 / 扫码授权：页面内二维码弹窗 ============
+// 与「拉终端」并列的第二条路径——把 lark-cli 的 config init 与 device flow 都搬到配置页里，
+// 用户直接扫码完成，不用切窗口。它不经过终端探测，因此无桌面 / SSH 环境同样可用
+// （那条路上「去终端」原本是无出口的死路）。
 //
-// 三段式（后端编排，见 src/lark-cli-manager.ts 的设备流一节）：
-//   ① POST /device/start → 拿 verification_url + 二维码（base64 PNG）
-//   ② 用户用飞书扫码
-//   ③ 后端后台跑 `auth login --device-code` 收尾，前端只轮询零成本的内存态端点
+// 同一个弹窗里两个阶段（phase），因为它们是**一条连续的路**：
+//   config：应用还没配置时，先扫码创建/绑定飞书应用（后端 spawn `config init --new` 并
+//           从其输出里流式解析授权链接——官方 README 与内置 skill 规定的用法）
+//   auth  ：再扫码授权（设备流，三段式见 src/lark-cli-manager.ts 的设备流一节）
+// 配置完成后**自动接续**授权，用户不需要关掉弹窗再来一次（后端配置会话置 done 前
+// 已用 checkAuth() 复检过「确实配上了」，所以接续时设备流的前置守卫必然放行）。
 //
 // **device_code 全程只存后端内存，从不下发到浏览器。**
 //
@@ -23,7 +25,12 @@ export function fmtRemain(sec) {
   return `${String(Math.floor(s / 60)).padStart(2, '0')}:${String(s % 60).padStart(2, '0')}`;
 }
 
-/** 纯函数（可测）：终态 → 给用户看的一句话 */
+/** 纯函数（可测）：与后端 needsLarkCliConfig 同源——detail 含 not_configured 即「未配置应用」 */
+export function larkNotConfigured(r) {
+  return r?.auth?.state === 'unauthorized' && /not_configured/i.test(r?.auth?.detail || '');
+}
+
+/** 纯函数（可测）：授权阶段终态 → 给用户看的一句话 */
 export function deviceStateHint(state, error) {
   if (state === 'done') return '✅ 授权完成，可以关闭本弹窗了。';
   if (state === 'expired') return error || '二维码已过期，请重新生成。';
@@ -33,39 +40,60 @@ export function deviceStateHint(state, error) {
   return '';
 }
 
+/** 纯函数（可测）：配置阶段终态 → 给用户看的一句话 */
+export function configStateHint(state, error) {
+  if (state === 'done') return '✅ 飞书应用已配置，接着申请授权二维码。';
+  if (state === 'expired') return error || '配置链接已失效，请重新生成二维码。';
+  // 配置这条路每一步都在浏览器里，失败原因多半是「没走完」——把两个出口都点出来
+  if (state === 'failed') return error || '配置未完成，可重新生成二维码再试，或改用终端窗口。';
+  if (state === 'none') return error || '配置会话已失效（桥接器可能已重启），请重新生成二维码。';
+  return '';
+}
+
+const STATE_TAG = { done: 'ok', expired: 'warn', failed: 'warn', none: 'warn' };
+const STATE_LABEL = {
+  config: { done: '已配置', expired: '已过期', failed: '未完成', none: '未完成' },
+  auth: { done: '已授权', expired: '已过期', failed: '未完成', none: '未完成' },
+};
+
 /**
- * 打开扫码授权弹窗。
+ * 打开飞书配置 / 扫码授权弹窗。未配置应用时自动进入 config 阶段，配完接续 auth 阶段。
  * @param {object} opts
  * @param {(r:any)=>void} [opts.onChange]   收到最新 /api/lark-cli 结果时回调，用于同步刷新概览行
- * @param {()=>void}      [opts.onTerminal] 用户选「改用终端窗口」时回调，接回既有终端链路
+ * @param {()=>void}      [opts.onTerminal] 授权阶段选「改用终端窗口」时回调
+ * @param {()=>void}      [opts.onConfigTerminal] 配置阶段选「改用终端窗口」时回调
  * @param {boolean}       [opts.wasAuthorized] 打开时的授权态快照：区分「本来就好」与「本次扫码完成」
- * @param {boolean}       [opts.notConfigured] 应用未配置（not_configured）：不发码，直接给配置向导
- * @param {()=>void}      [opts.onConfig]   用户选「打开配置向导」时回调
+ * @param {boolean}       [opts.notConfigured] 应用未配置（not_configured）：先走 config 阶段
  */
 export function openLarkCliDeviceDialog({
-  onChange, onTerminal, wasAuthorized = false, notConfigured = false, onConfig,
+  onChange, onTerminal, onConfigTerminal, wasAuthorized = false, notConfigured = false,
 } = {}) {
   const { mask, unmount } = mountDialog(`
     <div class="modal dlg" role="dialog" aria-modal="true" style="width:min(520px,94vw)">
-      <h3 class="dlg-title">飞书授权（扫码完成）</h3>
-      <div class="dlg-msg" id="lqdLead">用飞书 App 扫描下方二维码，按提示确认授权。授权成功后本页会自动更新。</div>
-      <div id="lqdBody"><div class="hint">正在向飞书申请授权二维码…</div></div>
+      <h3 class="dlg-title" id="lqdTitle">飞书授权（扫码完成）</h3>
+      <div class="dlg-msg" id="lqdLead"></div>
+      <div id="lqdBody"><div class="hint">正在向飞书申请二维码…</div></div>
       <div class="dlg-foot">
         <button class="btn" data-lqd="terminal">改用终端窗口</button>
         <button class="btn" data-lqd="copy" hidden>复制链接</button>
         <button class="btn" data-lqd="regen" hidden>重新生成二维码</button>
-        <button class="btn primary" data-lqd="config" hidden>打开配置向导</button>
         <button class="btn primary" data-lqd="close">关闭</button>
       </div>
     </div>`);
 
+  const titleEl = mask.querySelector('#lqdTitle');
+  const leadEl = mask.querySelector('#lqdLead');
   const body = mask.querySelector('#lqdBody');
   const btnCopy = mask.querySelector('[data-lqd="copy"]');
   const btnRegen = mask.querySelector('[data-lqd="regen"]');
-  const btnConfig = mask.querySelector('[data-lqd="config"]');
   const btnTerminal = mask.querySelector('[data-lqd="terminal"]');
   const btnClose = mask.querySelector('[data-lqd="close"]');
+
+  // needConfig 必须是可变绑定：配置完成后就地翻掉，doStart 才能接着走授权
+  let needConfig = !!notConfigured;
+  let phase = needConfig ? 'config' : 'auth';
   let session = null;   // 最近一次 start 的响应（存链接与二维码）
+  let painted = {};     // 已画出去的内容：相同内容不重画，免得二维码每隔 2s 闪一下
   let baseLeft = 0;     // 服务端给的剩余秒数
   let baseAt = 0;       // 收到该秒数时的本地时刻
   let poll = null;
@@ -81,71 +109,90 @@ export function openLarkCliDeviceDialog({
   // 一个一打开就已过期的二维码
   const remainNow = () => Math.max(0, baseLeft - (Date.now() - baseAt) / 1000);
 
-  const paintReady = (s) => {
+  const setLead = (text) => { leadEl.textContent = text; };
+  const setTitle = (text) => { titleEl.textContent = text; };
+
+  const hideActions = () => { btnCopy.hidden = true; btnRegen.hidden = true; };
+
+  const paintQr = (s) => {
     const qr = s.qrDataUrl
-      ? `<div class="qr-box"><img src="${esc(s.qrDataUrl)}" alt="飞书授权二维码" width="220" height="220"></div>`
+      ? `<div class="qr-box"><img src="${esc(s.qrDataUrl)}" alt="飞书二维码" width="220" height="220"></div>`
       : '<div class="hint" style="margin-top:8px">二维码生成失败，请复制下方链接在飞书中打开。</div>';
+    // 倒计时只在服务端给了有效期时才显示：配置流拿不到有效期，编一个数字只会误导用户
+    const life = typeof s.expiresInSec === 'number'
+      ? `二维码 <b id="lqdLeft">${fmtRemain(remainNow())}</b> 后失效`
+      : '若二维码失效，点「重新生成二维码」即可';
     body.innerHTML = qr
-      + `<div class="hint" style="margin-top:8px">二维码 <b id="lqdLeft">${fmtRemain(remainNow())}</b> 后失效`
+      + `<div class="hint" style="margin-top:8px">${life}`
       + (s.userCode ? ` · 授权码 <span class="chip">${esc(s.userCode)}</span>` : '')
       + '</div>'
       + `<div class="hint qr-url">${esc(s.verificationUrl || '')}</div>`;
     btnCopy.hidden = false;
     btnRegen.hidden = false;
+    painted = { url: s.verificationUrl, qr: s.qrDataUrl };
   };
 
   const paintDone = (state, { identity, error } = {}) => {
-    const tag = state === 'done' ? 'ok' : 'warn';
-    const label = state === 'done' ? '已授权' : state === 'expired' ? '已过期' : '未完成';
-    body.innerHTML = `<div><span class="tag ${tag}">${label}</span>`
+    const label = (STATE_LABEL[phase] || STATE_LABEL.auth)[state] || '未完成';
+    const hint = phase === 'config' ? configStateHint(state, error) : deviceStateHint(state, error);
+    body.innerHTML = `<div><span class="tag ${STATE_TAG[state] || 'warn'}">${label}</span>`
       + (identity ? ` <span class="chip">${esc(identity)}</span>` : '')
       + '</div>'
-      + `<div class="hint" style="margin-top:8px">${esc(deviceStateHint(state, error))}</div>`;
+      + `<div class="hint" style="margin-top:8px">${esc(hint)}</div>`;
     btnCopy.hidden = true;
     btnRegen.hidden = state === 'done';
   };
 
-  /**
-   * 应用未配置的引导态：device flow 必然被后端挡下（startLarkCliDeviceAuth 的前置检查），
-   * 所以连请求都不发——直接把「为什么发不了码」和「下一步去哪」摆出来。
-   * 「改用终端窗口」一并收起：那条路同样会撞上未配置守卫。
-   */
-  const paintNeedConfig = () => {
+  /** 后端把前置问题写成了可照做的文案（未安装 / 探测不出 / 已配置），直接透出 */
+  const paintFail = (msg) => {
     body.innerHTML = '<div><span class="tag warn">无法发起</span></div>'
-      + '<div class="hint" style="margin-top:8px">飞书 CLI 还没配置过飞书应用，扫码授权无处可挂。</div>'
-      + '<div class="hint" style="margin-top:6px">点下方「打开配置向导」：向导会创建或绑定飞书应用，'
-      + '完成后<b>自动接着走授权登录</b>，不用回到本页重来。</div>';
-    mask.querySelector('#lqdLead').textContent = '首次使用需先配置飞书应用，之后才能扫码授权。';
-    btnTerminal.hidden = true;
+      + `<div class="hint" style="margin-top:8px">${esc(msg)}</div>`;
     btnCopy.hidden = true;
-    btnRegen.hidden = true;
-    btnConfig.hidden = false;
-    btnClose.classList.remove('primary'); // 主按钮让位给「打开配置向导」
+    btnRegen.hidden = false; // 给出路：失败也要能重来，不留死胡同
   };
 
   /** 拉一次概览数据同步行内状态（拿不到就算了，别让弹窗崩） */
   const syncRow = async () => {
-    if (!onChange) return;
+    if (!onChange) return null;
     const cur = await api('GET', '/api/lark-cli').catch(() => null);
     if (cur) onChange(cur);
     return cur;
   };
 
+  const startPolling = () => {
+    poll = setInterval(doPoll, POLL_MS);
+    tick = setInterval(() => {
+      const el = body.querySelector('#lqdLeft');
+      if (el) el.textContent = fmtRemain(remainNow());
+    }, TICK_MS);
+  };
+
   const doPoll = async () => {
     if (closed) return;
+    const endpoint = phase === 'config' ? '/api/lark-cli/config/status' : '/api/lark-cli/device/status';
     let r;
     try {
-      r = await api('GET', '/api/lark-cli/device/status');
+      r = await api('GET', endpoint);
     } catch {
       return; // 静默重试：桥接器重启时会短暂失联，弹错反而吓人
     }
     if (closed) return;
     if (r.state === 'pending') {
-      // 以服务端时间为准校正倒计时基准（每次轮询都对一次表）
-      baseLeft = r.expiresInSec ?? remainNow();
-      baseAt = Date.now();
+      if (phase === 'auth') {
+        // 以服务端时间为准校正倒计时基准（每次轮询都对一次表）
+        baseLeft = r.expiresInSec ?? remainNow();
+        baseAt = Date.now();
+        return;
+      }
+      // 配置流：链接与二维码要等子进程吐出来。start 若没等到就返回了，这里补画
+      // （内容没变就不重画——每 2s 重建一次 <img> 会让二维码闪）
+      if (r.verificationUrl && (painted.url !== r.verificationUrl || painted.qr !== r.qrDataUrl)) {
+        session = { ...(session || {}), ...r };
+        paintQr(session);
+      }
       return;
     }
+    if (phase === 'config') return finishConfigPhase(r);
     stopTimers();
     if (r.state === 'none') {
       // 内存态被冲（桥接器重启），但用户可能已经扫完了：回查授权态兜底，
@@ -159,32 +206,88 @@ export function openLarkCliDeviceDialog({
     paintDone(r.state, { identity: r.identity, error: r.error });
   };
 
-  const doStart = async (regenerate) => {
+  /**
+   * 配置完成 → 同一个弹窗里就地接续授权，兑现「完成后自动接着走授权登录」的承诺。
+   * 后端置 done 之前已用 checkAuth() 复检确认应用真的配上了，所以设备流的前置守卫必然放行。
+   */
+  const continueToAuth = async () => {
+    phase = 'auth';
+    needConfig = false;
+    await syncRow(); // 概览行先翻成「已配置」
+    if (closed) return;
+    toast('✅ 飞书应用已配置，接着申请授权二维码');
+    await startAuth(false);
+  };
+
+  const finishConfigPhase = async (r) => {
+    stopTimers();
+    if (r.state === 'done') return continueToAuth();
+    if (r.state === 'none') {
+      // 内存态被冲（桥接器重启），但用户可能已经在浏览器里配完了：回查兜底
+      const cur = await syncRow();
+      if (cur && !larkNotConfigured(cur)) return continueToAuth();
+    }
+    return paintDone(r.state, { error: r.error });
+  };
+
+  const startAuth = async (regenerate) => {
     stopTimers();
-    if (notConfigured) { paintNeedConfig(); return; } // 不发请求：后端必然以 not_configured 拒绝
+    setTitle('飞书授权（扫码完成）');
+    setLead('用飞书 App 扫描下方二维码，按提示确认授权。授权成功后本页会自动更新。');
     body.innerHTML = '<div class="hint">正在向飞书申请授权二维码…</div>';
-    btnCopy.hidden = true;
-    btnRegen.hidden = true;
+    hideActions();
     try {
       session = await api('POST', '/api/lark-cli/device/start', { regenerate: !!regenerate });
     } catch (e) {
       // 后端把「未安装」「应用未配置」等前置问题写成了可照做的文案，直接透出
-      body.innerHTML = `<div><span class="tag warn">无法发起</span></div>`
-        + `<div class="hint" style="margin-top:8px">${esc(e.message)}</div>`;
-      toast(e.message, true);
+      paintFail(e.message);
       return;
     }
     if (closed) return;
     baseLeft = session.expiresInSec ?? 0;
     baseAt = Date.now();
-    paintReady(session);
-    poll = setInterval(doPoll, POLL_MS);
-    tick = setInterval(() => {
-      const el = body.querySelector('#lqdLeft');
-      if (el) el.textContent = fmtRemain(remainNow());
-    }, TICK_MS);
+    painted = {};
+    paintQr(session);
+    startPolling();
+  };
+
+  const startConfig = async (regenerate) => {
+    stopTimers();
+    setTitle('飞书配置（扫码完成）');
+    setLead('用飞书 App 扫描下方二维码，按提示创建或绑定飞书应用。'
+      + '完成后会自动接着申请授权二维码，不用回到本页重来。');
+    body.innerHTML = '<div class="hint">正在向飞书申请配置二维码…</div>';
+    hideActions();
+    try {
+      session = await api('POST', '/api/lark-cli/config/start', { regenerate: !!regenerate });
+    } catch (e) {
+      // 打开弹窗时的 notConfigured 快照可能已经过期（用户刚在别处配好了，后端据此拒绝）。
+      // 回查一次，确实已配置就直接接续授权，而不是把一个已经过时的错误甩给用户。
+      const cur = await syncRow();
+      if (cur && !larkNotConfigured(cur)) return continueToAuth();
+      paintFail(e.message);
+      return;
+    }
+    if (closed) return;
+    painted = {};
+    if (session.state === 'pending') {
+      if (session.verificationUrl) paintQr(session);
+      else paintWait(); // 链接要等子进程输出，交给轮询补画
+      startPolling();
+      return;
+    }
+    return paintDone(session.state, { error: session.error });
   };
 
+  /** 配置链接还没吐出来时的过渡态（仍然给「重新生成」这条出路，不让人干等） */
+  const paintWait = () => {
+    body.innerHTML = '<div class="hint">正在向飞书申请配置二维码…（通常几秒内出现）</div>';
+    btnCopy.hidden = true;
+    btnRegen.hidden = false;
+  };
+
+  const doStart = (regenerate) => (phase === 'config' ? startConfig(regenerate) : startAuth(regenerate));
+
   const close = () => {
     closed = true;
     stopTimers();
@@ -194,17 +297,20 @@ export function openLarkCliDeviceDialog({
   const unbind = bindDialogKeys((k) => { if (k === 'Escape') close(); });
 
   btnClose.onclick = close;
-  mask.querySelector('[data-lqd="regen"]').onclick = () => void doStart(true);
+  btnRegen.onclick = () => void doStart(true);
   // 关弹窗**不动后端会话**（沿用终端弹窗「关弹窗不中断流程」的既有理念）：
-  // 重新打开时 start 不带 regenerate → 后端幂等复用同一个 device code，二维码原样回来
-  btnTerminal.onclick = () => { close(); onTerminal?.(); };
-  btnConfig.onclick = () => { close(); onConfig?.(); };
+  // 重新打开时 start 不带 regenerate → 后端幂等复用同一个会话，二维码原样回来
+  btnTerminal.onclick = () => {
+    const cb = phase === 'config' ? onConfigTerminal : onTerminal;
+    close();
+    cb?.();
+  };
   btnCopy.onclick = async () => {
     const url = session?.verificationUrl;
     if (!url) return;
     try {
       await navigator.clipboard.writeText(url);
-      toast('授权链接已复制');
+      toast('链接已复制');
     } catch {
       toast('复制失败，请手动选中链接复制', true);
     }

package/assets/web/js/pages/overview.js

@@ -2,7 +2,9 @@
 // 桥接器启停 / 版本更新（宿主进程管理：embedded 页面随进程生死，独立页面经 PID 跨进程操作）
 import { S, $, esc, toast, api, refresh } from '../core.js';
 import { bindDialogKeys, confirmDialog, mountDialog, progressDialog } from '../ui.js';
-import { openLarkCliDeviceDialog } from './larkcli-device.js';
+// larkNotConfigured 与后端 needsLarkCliConfig 同源（detail 含 not_configured 即「未配置应用」），
+// 判定只有一份、放在弹窗模块里，避免两处漂移
+import { larkNotConfigured, openLarkCliDeviceDialog } from './larkcli-device.js';
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 const UPD = { checkedAt: 0, data: null };
@@ -138,11 +140,6 @@ async function runUpdateFlow() {
   }
 }
 
-/** 纯函数（可测）：与后端 needsLarkCliConfig 同源——detail 含 not_configured 即「未配置应用」 */
-function larkCliNotConfigured(r) {
-  return r?.auth?.state === 'unauthorized' && /not_configured/i.test(r?.auth?.detail || '');
-}
-
 /** 纯函数（可测）：概览表格行里「飞书 CLI」的状态 HTML（不含操作按钮，按钮由 render 按需挂） */
 export function larkCliStatHtml(r) {
   if (!r) return '<span class="hint">未检查</span>';
@@ -163,18 +160,29 @@ export function larkCliStatHtml(r) {
 }
 
 /**
- * 扫码授权弹窗（授权主路径）。弹窗里的「改用终端窗口」接回既有终端链路——
- * 那条路一行没改，仍是拉不起无桌面环境时的兜底，也保留了在终端里补跑命令的能力。
+ * 纯函数（可测）：概览行主入口按钮的文案——按「点开后会先走哪一步」命名，
+ * 不出现「按钮写扫码授权、点开弹窗却是配置二维码」的错位。
+ * 未配置应用时弹窗从 config 阶段起步（见 openDeviceDialog 与 larkcli-device.js），故叫「配置应用」。
+ * 探测不出（unknown）**不**算未配置：误判会把已配好应用的用户反复推去重配，按「扫码授权」处理。
+ */
+export function larkCliPrimaryLabel(r) {
+  if (r?.auth?.state === 'authorized') return '重新授权';
+  return larkNotConfigured(r) ? '配置应用' : '扫码授权';
+}
+
+/**
+ * 扫码弹窗（配置 + 授权的主路径）。未配置应用时它从**配置阶段**起步：页面内直接出示
+ * 配置二维码，用户扫完在浏览器里建好应用，弹窗自动接续出示授权二维码——全程不切窗口，
+ * 无桌面 / SSH 环境下同样走得通（那条路上「去终端向导」原本是无出口的死路）。
+ * 两个阶段的「改用终端窗口」都接回既有终端链路：那条路一行没改，保留补跑命令的能力。
  */
 function openDeviceDialog() {
   openLarkCliDeviceDialog({
     wasAuthorized: LARKCLI.data?.auth?.state === 'authorized',
-    // 未配置应用时 device flow 必然被后端挡下（「请先点配置应用」）：把这个前置条件
-    // 交给弹窗直接讲明白，而不是让用户点一次、收一个红色的失败
-    notConfigured: larkCliNotConfigured(LARKCLI.data),
+    notConfigured: larkNotConfigured(LARKCLI.data),
     onChange: (r) => { LARKCLI.data = r; LARKCLI.checkedAt = Date.now(); renderLarkCliResult(); },
     onTerminal: () => void larkCliActionFlow('auth'),
-    onConfig: () => void larkCliActionFlow('config'),
+    onConfigTerminal: () => void larkCliActionFlow('config'),
   });
 }
 
@@ -195,13 +203,13 @@ function renderLarkCliResult() {
   };
   if (!r.installed) { add('安装', 'install'); return; }
   if (r.hasUpdate) add('更新', 'update');
-  // 授权入口常驻，且已授权也给（token 会过期，随时可重走一遍 device flow 刷新）。
-  // 授权走**页面内二维码**（主路径，无桌面环境同样可用）；终端窗口降级为弹窗里的备选。
-  // 应用未配置（not_configured）时**不在这里换按钮**——那会把唯一的授权入口顶掉，
-  // 用户看到「配置应用」只会更困惑「那我怎么授权」。改由弹窗先讲清「得先配应用」
-  // 并给出向导入口（见 openDeviceDialog 与 larkcli-device.js）。
-  if (r.auth?.state === 'authorized') add('重新授权', 'auth-device');
-  else add('扫码授权', 'auth-device');
+  // 入口常驻，且已授权也给（token 会过期，随时可重走一遍 device flow 刷新）。
+  // 走**页面内二维码**（主路径，无桌面环境同样可用）；终端窗口降级为弹窗里的备选。
+  // 文案跟着「弹窗会先走哪一步」走（见 larkCliPrimaryLabel）：未配置应用时弹窗从配置阶段
+  // 起步、先出配置二维码，按钮就叫「配置应用」；已配置才是「扫码授权」。
+  // **入口数量不变**——三种状态都是同一个弹窗（op 一律 auth-device），只是弹窗按前置条件
+  // 决定先出哪种二维码（见 openDeviceDialog 与 larkcli-device.js）。
+  add(larkCliPrimaryLabel(r), 'auth-device');
   if (r.skill && !r.skill.installed) add('装 SKILL', 'skill');
 }
 
@@ -337,6 +345,8 @@ async function larkCliActionFlow(op = 'install') {
     },
     config: {
       what: '配置应用',
+      // 这是**备选**路径：主路径已改成弹窗里的配置二维码（见 larkcli-device.js 的 config 阶段），
+      // 只有用户在弹窗里显式点「改用终端窗口」才会走到这里
       msg: '将打开一个终端窗口执行 <code>lark-cli config init --new</code>：按窗口打印的链接在浏览器完成飞书应用创建，'
         + '完成后会自动进入授权登录。'
         + '<br><br>若本机没有可用终端（无桌面 / SSH 会话），需在服务器上手动执行该命令。',
@@ -388,6 +398,45 @@ async function larkCliActionFlow(op = 'install') {
   }
 }
 
+// ============ 开机自启开关（GET/POST /api/autostart；注册状态以 OS 查询为权威） ============
+function paintAutostart(el, r) {
+  const tags = r.enabled
+    ? '<span class="tag ok">已开启</span>'
+    : '<span class="tag off">未开启</span>';
+  const stale = r.stale ? ' <span class="tag warn">启动命令已过期，关闭再开启可更新</span>' : '';
+  const hint = r.detail ? ` <span class="hint">${esc(r.detail)}</span>` : '';
+  el.innerHTML = `<span class="switch-row tight"><label class="switch"><input type="checkbox" id="asToggle" ${r.enabled ? 'checked' : ''}><span class="track"></span></label>${tags}${stale}${hint}</span>`;
+  $('#asToggle').onchange = async (e) => {
+    const on = e.target.checked;
+    try {
+      const res = await api('POST', '/api/autostart', { enabled: on });
+      toast(on ? '✅ 已注册开机自启（下次登录时自动启动）' : '已关闭开机自启');
+      paintAutostart(el, res);
+    } catch (err) {
+      toast(err.message, true);
+      e.target.checked = !on; // 失败回滚开关视觉态（注册失败不能显示为已开）
+    }
+  };
+}
+
+/** 概览页「开机自启」行：首次渲染拉状态；开关点击即生效（低风险，与权限页即时保存一致） */
+async function renderAutostart() {
+  const el = $('#asStat');
+  if (!el) return;
+  let r;
+  try {
+    r = await api('GET', '/api/autostart');
+  } catch (e) {
+    el.innerHTML = `<span class="hint">检测失败：${esc(e.message)}</span>`;
+    return;
+  }
+  if (!r.supported) {
+    el.innerHTML = `<span class="tag off">不支持</span><span class="hint">${esc(r.detail || '当前运行方式不支持开机自启，请手动运行 lcb start')}</span>`;
+    return;
+  }
+  paintAutostart(el, r);
+}
+
 export const page = {
   id: 'overview',
   title: '概览',
@@ -424,20 +473,29 @@ export const page = {
         <tr><td>配置文件</td><td><code>${esc(st.configPath)}</code></td></tr>
         <tr><td>配置页</td><td><code>${esc(location.host)}</code></td></tr>
         <tr><td>Claude 认证</td><td>${claudeTag}（模式：${esc(st.claude?.mode || 'inherit')}）</td></tr>
+        <tr><td>开机自启</td><td id="asStat"><span class="hint">检测中…</span></td></tr>
       </table>
       ${ctl}
       <div class="desc" style="margin-top:10px">${st.claude?.hasAuth === false ? '⚠️ 未检测到认证：到「Claude 认证」页填写，或在配置页所在机器执行 claude login。' : ''}</div>
     </div>
     <div class="card">
       <h3>版本与更新</h3>
-      <table>
-        <tr><td>当前版本</td><td><span class="chip">v${esc(st.version)}</span></td></tr>
-        <tr><td>最新版本</td><td id="updLatest"><span class="hint">未检查</span></td></tr>
-        <tr><td>飞书 CLI（lark-cli）</td><td id="larkCliStat"><span class="hint">检测中…</span></td></tr>
-      </table>
-      <div style="display:flex; gap:10px; margin-top:12px; align-items:center">
-        <button class="btn" id="btnUpdCheck">检查更新</button>
-        <span id="updArea"></span>
+      <div class="card-sub">
+        <h4 class="card-sub-title">▍LCB 桥接器</h4>
+        <table>
+          <tr><td>当前版本</td><td><span class="chip">v${esc(st.version)}</span></td></tr>
+          <tr><td>最新版本</td><td id="updLatest"><span class="hint">未检查</span></td></tr>
+        </table>
+        <div style="display:flex; gap:10px; margin-top:12px; align-items:center">
+          <button class="btn" id="btnUpdCheck">检查更新</button>
+          <span id="updArea"></span>
+        </div>
+      </div>
+      <div class="card-sub">
+        <h4 class="card-sub-title">▍飞书 CLI（lark-cli）</h4>
+        <table>
+          <tr><td>状态</td><td id="larkCliStat"><span class="hint">检测中…</span></td></tr>
+        </table>
       </div>
     </div>
     <div class="card">
@@ -467,5 +525,6 @@ export const page = {
     else doCheckUpdate();
     if (LARKCLI.data && Date.now() - LARKCLI.checkedAt < 30000) renderLarkCliResult();
     else doCheckLarkCli();
+    void renderAutostart();
   },
 };

package/assets/web/js/pages/permissions.js

@@ -23,19 +23,31 @@ function renderPermissions(el) {
 function renderAllowTab(panel, p) {
   const defaults = S.status?.permissionDefaults?.allowTools || [];
   const isDefault = defaults.length > 0 && JSON.stringify(p.allow_tools) === JSON.stringify(defaults);
+  // 缺省即开（与后端 DEFAULT_ALLOW_ALL_TOOLS 一致）：只有显式 false 才算用户主动关闭
+  const allOn = p.allow_all_tools !== false;
   panel.innerHTML = `
   <div class="card">
     <h3>免确认工具</h3>
-    <div class="desc">名单内工具直接放行不弹确认卡（配置即整体替换内置默认）。Bash 仍受危险命令黑名单约束。</div>
-    <div class="list-toolbar">
-      <input type="text" id="newTool" placeholder="工具名，如 Write" style="max-width:320px">
-      <button class="btn" id="addTool">添加</button>
-      <button class="btn" id="resetTools" ${defaults.length ? '' : 'disabled title="status 不可用，无法取默认值"'}>恢复默认</button>
+    <div class="switch-row">
+      <label class="switch">
+        <input type="checkbox" id="allowAll" ${allOn ? 'checked' : ''}>
+        <span class="track"></span>
+      </label>
+      <span class="switch-label">全部工具免确认（除危险命令黑名单外）</span>
     </div>
-    ${p.allow_tools.length === 0 ? '<div style="background:var(--warn-bg);color:var(--warn-tx);border-radius:7px;padding:7px 12px;margin:8px 0">⚠️ 名单为空：所有工具（含 Write/Edit）都会弹确认卡</div>' : ''}
-    ${isDefault ? '<div class="hint" style="margin:8px 0"><span class="tag off">与内置默认一致</span></div>' : ''}
-    <table><tbody id="toolBody"></tbody></table>
-    <div class="footer-note">权限改动即时保存并热生效（已有会话的下一个工具调用即用新名单）。plan 模式下写操作仍会经此判定：白名单命中直通，未命中弹确认卡。</div>
+    ${allOn ? '<div style="background:var(--warn-bg);color:var(--warn-tx);border-radius:7px;padding:7px 12px;margin:8px 0">⚠️ 已开启全部放行：除命中危险命令黑名单的 Bash 外，所有工具（含 Write/Edit）都不再弹确认卡，下方名单暂不生效</div>' : ''}
+    <div class="${allOn ? 'block-disabled' : ''}">
+      <div class="desc">名单内工具直接放行不弹确认卡（配置即整体替换内置默认）。Bash 仍受危险命令黑名单约束。</div>
+      <div class="list-toolbar">
+        <input type="text" id="newTool" placeholder="工具名，如 Write" style="max-width:320px">
+        <button class="btn" id="addTool">添加</button>
+        <button class="btn" id="resetTools" ${defaults.length ? '' : 'disabled title="status 不可用，无法取默认值"'}>恢复默认</button>
+      </div>
+      ${p.allow_tools.length === 0 ? '<div style="background:var(--warn-bg);color:var(--warn-tx);border-radius:7px;padding:7px 12px;margin:8px 0">⚠️ 名单为空：所有工具（含 Write/Edit）都会弹确认卡</div>' : ''}
+      ${isDefault ? '<div class="hint" style="margin:8px 0"><span class="tag off">与内置默认一致</span></div>' : ''}
+      <table><tbody id="toolBody"></tbody></table>
+    </div>
+    <div class="footer-note">权限改动即时保存并热生效（已有会话的下一个工具调用即用新名单）。plan 模式下写操作仍会经此判定：${allOn ? '全部免确认已开启，除危险命令外一律直通' : '白名单命中直通，未命中弹确认卡'}。</div>
   </div>`;
   $('#toolBody').innerHTML = p.allow_tools.map((t, i) =>
     `<tr><td><code>${esc(t)}</code></td><td style="width:80px"><button class="btn sm danger" data-i="${i}">删除</button></td></tr>`).join('')
@@ -71,6 +83,29 @@ function renderAllowTab(panel, p) {
     p.allow_tools = [...defaults];
     if (!await saveDoc()) p.allow_tools = old;
   };
+  // 开关即时落盘：关闭（收紧密）直接生效；开启（放宽到全放行）先过确认弹层，避免误点放行全部写操作
+  $('#allowAll').onchange = async (e) => {
+    const next = e.target.checked;
+    if (next && !(await confirmDialog({
+      title: '开启全部工具免确认',
+      message: '开启后除命中危险命令黑名单的 Bash 外，<b>所有工具（含 Write/Edit）</b>都不再弹确认卡。确定开启？',
+      danger: true,
+      confirmText: '开启',
+    }))) {
+      e.target.checked = false;
+      return;
+    }
+    const old = p.allow_all_tools;
+    p.allow_all_tools = next;
+    // 成功路径不手动重渲染：saveDoc 内部的 refresh() 已整页重渲染并重新绑定事件（用最新的
+    // S.doc.permissions）。此处若再调 renderAllowTab(panel, p)，panel 早已脱离文档，而
+    // $() 走 document 查询——那会把新 DOM 上的 handler 覆盖成闭包里旧 p（孤儿对象）的版本，
+    // 之后开关改动就落不到 S.doc 上（表现为「点了保存成功但配置没变」）。与增删条目同款模式。
+    if (!await saveDoc()) {
+      p.allow_all_tools = old;
+      e.target.checked = !next; // 失败不重渲染，DOM 仍是本次交互的元素，直接回滚勾选态
+    }
+  };
 }
 
 function renderDangerTab(panel, p) {
@@ -88,7 +123,7 @@ function renderDangerTab(panel, p) {
     ${p.dangerous_commands.length === 0 ? '<div style="background:var(--err-bg);color:var(--err-tx);border-radius:7px;padding:7px 12px;margin:8px 0">⚠️ 黑名单为空：所有 Bash 命令（含 rm -rf、sudo）将免确认直通，请确认有意为之</div>' : ''}
     ${isDefault ? '<div class="hint" style="margin:8px 0"><span class="tag off">与内置默认一致</span></div>' : ''}
     <table><tbody id="dcBody"></tbody></table>
-    <div class="footer-note">权限改动即时保存并热生效（已有会话的下一个工具调用即用新名单）。plan 模式下写操作仍会经此判定：白名单命中直通，未命中弹确认卡。</div>
+    <div class="footer-note">权限改动即时保存并热生效（已有会话的下一个工具调用即用新名单）。「全部工具免确认」开启时本黑名单是唯一的安全网——删除正则等于放行对应命令。</div>
   </div>`;
   $('#dcBody').innerHTML = p.dangerous_commands.map((s, i) =>
     `<tr><td style="width:90%"><code>${esc(s)}</code></td><td><button class="btn sm danger" data-i="${i}">删除</button></td></tr>`).join('')