dsh-agentone 1.0.0 → 1.0.3

package/lib/client.js

@@ -281,6 +281,382 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // ==drive-tab-begin==
+    // 飞书云盘侧边栏 tab：iframe 直嵌飞书网页版（飞书不设 frame-ancestors，
+    // 2026-10-13 spike 实测）。寻址走 /agentone/api/drive/home——host 侧用
+    // lark-cli 找到/创建用户的「我的空间/AgentOne」文件夹（folder token 每
+    // 用户独立，不能平台级写死，见 lib/drive.js）。页面交互（上传/下载/
+    // 整理）全部是飞书官方 Web UI，本组件只管「落到正确层级」+ 引导三态
+    // + 内容自动刷新（轮询 /api/drive/rev 清单指纹，变了重挂载 iframe）
+    // + 右下角手动刷新按钮（跨域 iframe 收不到事件，也调不了 reload）。
+    // better-sidebar 未装（独立 dsh 用户）时 ctx.get 取不到服务，静默不注册。
+    const DRIVE_TAB_ID = 'agentone:feishu-drive';
+    const DRIVE_HOME_API = '/agentone/api/drive/home';
+
+    // better-sidebar 服务引用：页签注册（ctx.inject 回调）与 footer 入口按钮
+    // （组件渲染时）两个消费方。组件运行在 React 渲染期，inject 回调早已把
+    // 服务存进这里；未装 better-sidebar 时为 null，footer 按钮退化为开设置页。
+    let driveSidebarService = null;
+    function setDriveSidebarService(value) { driveSidebarService = value || null; }
+
+    // 寻址响应 → 组件相位（纯函数，测试直接覆盖）。
+    const DRIVE_GATE_STATES = [
+      'cli_missing', 'cli_unconfigured', 'cli_unauthorized',
+      'drive_scope_missing', 'drive_app_forbidden',
+    ];
+
+    function driveHomePhase(ok, body) {
+      const data = body && typeof body === 'object' ? body : {};
+      if (ok && data.state === 'ready' && data.url) {
+        return { kind: 'ready', url: data.url, name: data.name || 'AgentOne' };
+      }
+      if (ok && DRIVE_GATE_STATES.includes(data.state)) {
+        return {
+          kind: 'gate',
+          state: data.state,
+          missingScopes: Array.isArray(data.missing_scopes) ? data.missing_scopes : [],
+          appMissingScopes: Array.isArray(data.app_missing_scopes) ? data.app_missing_scopes : [],
+        };
+      }
+      return { kind: 'error', message: data.error || '云盘文件夹加载失败，请重试' };
+    }
+
+    const DRIVE_GATE_TEXT = {
+      // 首次使用要走一次飞书设备流授权（弹窗里扫码/确认），这层提示必须写明
+      cli_unauthorized: '云盘页签需要 lark-cli 的飞书授权才能定位你的「AgentOne」文件夹。首次使用请到 AgentOne 设置页点「去授权」，用手机飞书扫码确认后回来点「重试」。',
+      cli_missing: '本机还没有安装 lark-cli，无法定位云盘文件夹。请先在 AgentOne 设置页的「CLI」页签安装，再回来点「重试」。',
+      cli_unconfigured: 'lark-cli 还没有完成飞书应用初始化。请先在 AgentOne 设置页的「CLI」页签完成初始化（需要扫码/确认一次），再回来点「重试」。',
+    };
+
+    const scopeList = (scopes) => (scopes.length ? `（缺少：${scopes.join('、')}）` : '');
+
+    /** 三态之外的权限缺口文案：分清「用户重新授权能修」与「只能找管理员」。 */
+    function driveGateText(phase) {
+      if (phase.state === 'drive_scope_missing') {
+        return '你的飞书授权里还没有云盘权限' + scopeList(phase.missingScopes)
+          + '。请到 AgentOne 设置页 →「云盘」点「重新授权」，扫码确认后回来点「重试」。';
+      }
+      if (phase.state === 'drive_app_forbidden') {
+        return '飞书应用本身还没有开通云空间权限' + scopeList(phase.appMissingScopes.length ? phase.appMissingScopes : phase.missingScopes)
+          + '，重新授权解决不了。请联系管理员在飞书开放平台为应用开通云空间权限并发布版本，然后回来点「重试」。';
+      }
+      return DRIVE_GATE_TEXT[phase.state] || '云盘暂时不可用，请稍后点「重试」。';
+    }
+
+    const DRIVE_REV_API = '/agentone/api/drive/rev';
+    const DRIVE_REV_POLL_MS = 8000;
+    const DRIVE_REFRESH_TITLE = '刷新云盘内容';
+    const DRIVE_STALE_TITLE = '云盘内容有更新，点击刷新';
+
+    function FeishuDriveTab() {
+      const [phase, setPhase] = React.useState({ kind: 'loading' });
+      const [retryTick, setRetryTick] = React.useState(0);
+      const [reloadTick, setReloadTick] = React.useState(0);
+      const [stale, setStale] = React.useState(false);
+      React.useEffect(() => {
+        let cancelled = false;
+        setPhase({ kind: 'loading' });
+        fetch(DRIVE_HOME_API)
+          .then(async (resp) => driveHomePhase(resp.ok, await resp.json().catch(() => null)))
+          .then((next) => { if (!cancelled) setPhase(next); })
+          .catch(() => { if (!cancelled) setPhase({ kind: 'error', message: '网络异常，请重试' }); });
+        return () => { cancelled = true; };
+      }, [retryTick]);
+
+      // 自动刷新：iframe 跨域收不到飞书内部事件，只能宿主侧轮询根清单指纹
+      // （/drive/rev，服务端 10s 节流）——子文件夹里增删文档会 bump 它在根
+      // 清单中的 modified_time（真机实测），指纹一变就重挂载 iframe。首拍只
+      // 做基线不重载；rev 为 null（CLI 不可用/资料夹未初始化）按「未知」不动；
+      // 页面隐藏时跳过这一拍，省无谓的请求。
+      // 重挂载会回到根视图（跨域读不到也恢复不了用户在飞书里点开的层级），
+      // 所以检测到用户正浏览云盘（焦点在 iframe 内，activeElement 跨域可读）
+      // 时不硬拽——只点亮刷新按钮提示「有更新」，基线不前移；焦点离开后
+      // 下一拍自动应用。
+      React.useEffect(() => {
+        if (phase.kind !== 'ready') return undefined;
+        let baseline = null;
+        let stopped = false;
+        const timer = setInterval(() => {
+          if (typeof document !== 'undefined' && document.hidden) return;
+          fetch(DRIVE_REV_API)
+            .then(async (resp) => (resp.ok ? await resp.json().catch(() => null) : null))
+            .then((body) => {
+              if (stopped || !body || typeof body.rev !== 'string' || !body.rev) return;
+              if (baseline === null) {
+                baseline = body.rev;
+                return;
+              }
+              if (body.rev === baseline) return;
+              const browsing = typeof document !== 'undefined' && document.activeElement
+                && document.activeElement.tagName === 'IFRAME';
+              if (browsing) {
+                setStale(true);
+                return;
+              }
+              baseline = body.rev;
+              setStale(false);
+              setReloadTick((t) => t + 1);
+            })
+            .catch(() => {});
+        }, DRIVE_REV_POLL_MS);
+        return () => { stopped = true; clearInterval(timer); };
+      }, [phase.kind === 'ready' ? phase.url : '']);
+
+      // 手动刷新：立即重载 iframe 并重新寻址（资料夹被重新定位/收养过也能跟上）；
+      // 寻址失败保留当前画面不打断
+      const refreshDrive = () => {
+        setStale(false);
+        setReloadTick((t) => t + 1);
+        fetch(DRIVE_HOME_API)
+          .then(async (resp) => driveHomePhase(resp.ok, await resp.json().catch(() => null)))
+          .then((next) => { if (next.kind === 'ready') setPhase(next); })
+          .catch(() => {});
+      };
+
+      if (phase.kind === 'loading') {
+        return React.createElement('div', {
+          style: { padding: '24px', textAlign: 'center', color: 'var(--dsw-alias-label-secondary, #57606a)', fontSize: '13px' },
+        }, '正在定位你的飞书云盘文件夹…');
+      }
+      if (phase.kind === 'ready') {
+        // 不设 sandbox：飞书登录态依赖真实第三方 cookie 上下文（spike 实测
+        // 无 sandbox 时登录页可渲染、登录后云盘可用）。key 随 reloadTick 变化
+        // 即重挂载 = 重载（跨域 iframe 不能调 contentWindow.location.reload）。
+        // 用户浏览中时刷新被推迟：顶部横幅 + 胶囊按钮变色双提示（见上面轮询注释）。
+        const refreshTitle = stale ? DRIVE_STALE_TITLE : DRIVE_REFRESH_TITLE;
+        const banner = React.createElement('div', {
+          key: 'stale-banner',
+          style: {
+            position: 'absolute', top: '0', left: '0', right: '0', zIndex: '1',
+            display: 'flex', alignItems: 'center', justifyContent: 'center', gap: '8px',
+            padding: '6px 10px', fontSize: '12px',
+            background: 'rgba(47, 111, 235, 0.92)', color: '#fff',
+            boxShadow: '0 1px 4px rgba(0,0,0,0.12)',
+          },
+        }, '云盘内容有更新',
+          React.createElement('button', {
+            type: 'button',
+            onClick: refreshDrive,
+            style: {
+              border: '1px solid rgba(255,255,255,.7)', borderRadius: '6px', padding: '1px 10px',
+              fontSize: '12px', cursor: 'pointer',
+              background: 'rgba(255,255,255,.16)', color: '#fff',
+            },
+          }, '立即刷新'));
+        const frame = React.createElement('iframe', {
+          key: `drive-frame-${reloadTick}`,
+          src: phase.url,
+          title: '飞书云盘',
+          style: {
+            border: 'none', width: '100%', height: '100%', minHeight: '320px',
+            background: '#fff', display: 'block',
+          },
+        });
+        const pill = React.createElement('button', {
+          type: 'button',
+          title: refreshTitle,
+          'aria-label': refreshTitle,
+          onClick: refreshDrive,
+          style: {
+            position: 'absolute', right: '12px', bottom: '12px', zIndex: '1',
+            display: 'inline-flex', alignItems: 'center', gap: '5px',
+            height: '28px', padding: '0 12px',
+            border: stale ? 'none' : '1px solid rgba(47, 111, 235, 0.28)',
+            borderRadius: '14px', cursor: 'pointer', fontSize: '12px',
+            background: stale ? '#2f6feb' : '#eaf1fe',
+            color: stale ? '#fff' : '#2f6feb',
+            boxShadow: '0 1px 5px rgba(0,0,0,.18)',
+          },
+        }, React.createElement('svg', {
+          viewBox: '0 0 24 24', width: '14', height: '14', 'aria-hidden': 'true', focusable: 'false',
+        }, React.createElement('path', {
+          d: 'M17.65 6.35A7.95 7.95 0 0 0 12 4a8 8 0 1 0 7.73 10h-2.08A6 6 0 1 1 12 6c1.66 0 3.14.69 4.22 1.78L13 11h7V4l-2.35 2.35z',
+          fill: 'currentColor',
+        })),
+          React.createElement('span', null, stale ? '有更新，刷新' : '刷新'));
+        return React.createElement('div', {
+          style: { position: 'relative', width: '100%', height: '100%', minHeight: '320px' },
+        }, ...(stale ? [banner] : []), frame, pill);
+      }
+      const text = phase.kind === 'gate' ? driveGateText(phase) : phase.message;
+      const center = {
+        padding: '28px 20px', textAlign: 'center', color: 'var(--dsw-alias-label-secondary, #57606a)',
+        fontSize: '13px', lineHeight: '1.7',
+      };
+      const btnPrimary = {
+        padding: '7px 18px', fontSize: '13px', borderRadius: '9px', border: 'none', cursor: 'pointer',
+        background: '#2f6feb', color: '#fff', marginRight: '8px',
+      };
+      const btnGhost = { ...btnPrimary, background: 'var(--dsw-alias-fill-secondary, #f2f3f5)', color: 'var(--dsw-alias-label-primary, #3c434d)' };
+      return React.createElement('div', { style: center },
+        React.createElement('p', { style: { margin: '0 0 16px' } }, text),
+        React.createElement('button', { style: btnPrimary, onClick: () => setRetryTick((t) => t + 1) }, '重试'),
+        phase.kind === 'gate'
+          ? React.createElement('button', {
+              style: btnGhost,
+              onClick: () => window.open('/agentone/', '_blank', 'noopener'),
+            }, '打开设置页')
+          : null);
+    }
+
+    function feishuDriveTabDescriptor() {
+      return {
+        id: DRIVE_TAB_ID,
+        title: () => '飞书云盘',
+        description: () => '进入你的飞书云盘「AgentOne」文件夹，资料的上传与管理都在飞书界面内完成',
+        order: 80,
+        single: true,
+        // 飞书风格云盘实心图标（用户提供的 云盘.svg，viewBox 1024）
+        icon: driveCloudIcon,
+        component: () => React.createElement(FeishuDriveTab),
+      };
+    }
+
+    // 飞书风格云盘实心图标（用户提供的 云盘.svg，viewBox 1024）：侧边栏页签与
+    // footer 入口按钮共用。
+    function driveCloudIcon(size) {
+      return React.createElement('svg', {
+        viewBox: '0 0 1024 1024', width: size, height: size,
+        'aria-hidden': 'true', focusable: 'false',
+      }, React.createElement('path', {
+        d: 'M778.581333 374.101333C766.976 237.226667 651.946667 129.706667 512 129.706667s-254.976 107.52-266.581333 244.394666c-93.184 27.989333-160.768 114.005333-160.768 216.064 0 124.586667 101.034667 225.621333 225.621333 225.621334h404.138667c124.586667 0 225.621333-101.034667 225.621333-225.621334-0.341333-102.058667-68.266667-188.074667-161.450667-216.064z m-128.341333 209.237334c-22.869333 21.845333-62.122667 49.834667-117.418667 58.709333-11.264 1.706667-22.186667 2.730667-32.768 2.730667-72.704 0-126.293333-37.888-142.336-50.858667-18.090667-14.677333-21.162667-41.301333-6.485333-59.392 14.677333-18.090667 41.301333-21.162667 59.392-6.485333 11.605333 9.557333 53.930667 39.253333 108.885333 30.72 35.498667-5.802667 60.416-25.258667 72.021334-36.181334 17.066667-16.042667 43.690667-15.36 59.733333 1.365334 16.725333 16.384 16.042667 43.349333-1.024 59.392z',
+        fill: '#635DF7',
+        opacity: '.7',
+      }));
+    }
+
+    // ── sidebar.footer.action 云盘入口 ─────────────────────────────────────
+    // 主界面左栏底部、设置按钮上方的常驻按钮（参照 dsh-ccpg-larkauth 的
+    // 「飞书账号」入口，同 slot 同几何口径）。点击打开 better-sidebar 的云盘
+    // 页签；未装 better-sidebar 时退化为新窗口开设置页（与页签注册的静默
+    // 策略一致，不放死按钮）。宽态带「飞书云盘」文字、收起态只留图标，两态
+    // 几何（42px 满行 / 36px 圆钮）逐项对齐官方设置触发器；多个 footer 入口
+    // 的纵向堆叠由本插件的 :has() 规则自己兜（不依赖 harness-one 装没装）。
+    const FOOTER_STYLE_ID = 'agentone-footer-entry-style';
+    function ensureFooterStyle() {
+      // 非 DOM 宿主（测试 vm 沙箱/单测加载）直接跳过
+      if (typeof document === 'undefined' || !document.getElementById) return;
+      if (document.getElementById(FOOTER_STYLE_ID)) return;
+      const style = document.createElement('style');
+      style.id = FOOTER_STYLE_ID;
+      style.textContent = [
+        '.aone-drive-entry{box-sizing:border-box;cursor:pointer;width:calc(100% + 4px);height:42px;',
+        'color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;',
+        'flex:none;align-items:center;justify-content:flex-start;gap:8px;margin:4px -2px;',
+        'padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;',
+        'display:flex;overflow:hidden;white-space:nowrap}',
+        '.aone-drive-entry:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+        '.aone-drive-entry.aone-drive-rail{border-radius:50%;justify-content:center;gap:0;width:36px;height:36px;margin:8px 0 10px;padding:0}',
+        ':has(> [data-slot="sidebar.footer.action"] .aone-drive-entry){display:flex;flex-direction:column}',
+      ].join('');
+      document.head.appendChild(style);
+    }
+
+    function DriveFooterEntry(props) {
+      const wide = Boolean(props && props.wide);
+      ensureFooterStyle();
+      const openDrive = () => {
+        const sidebar = driveSidebarService;
+        if (sidebar && typeof sidebar.openTab === 'function') {
+          const sessionId = currentDshSessionId();
+          try {
+            sidebar.openTab({ type: DRIVE_TAB_ID, title: '飞书云盘' },
+              sessionId ? { sessionId } : undefined);
+            return;
+          } catch {
+            /* 页签打不开（旧版本服务/无会话）→ 落到设置页兜底 */
+          }
+        }
+        window.open('/agentone/', '_blank', 'noopener');
+      };
+      const children = [driveCloudIcon(18)];
+      if (wide) children.push(React.createElement('span', null, '飞书云盘'));
+      return React.createElement('button', {
+        onClick: openDrive,
+        title: '飞书云盘（AgentOne 文件夹）',
+        className: wide ? 'aone-drive-entry' : 'aone-drive-entry aone-drive-rail',
+      }, ...children);
+    }
+
+    // 设置页（/agentone/ 子框架，web 走 iframe、桌面壳走 srcdoc）里点「打开云盘」
+    // 时，经 postMessage 让宿主页这边的我们把页签开出来；开不了就回 ok:false，
+    // 页面自己退回「新窗口打开飞书链接」。srcdoc 子框架 origin 为 'null'。
+    const DRIVE_OPEN_MESSAGE = 'agentone:open-feishu-drive';
+    const DRIVE_OPEN_RESULT = 'agentone:open-feishu-drive:result';
+
+    function isDriveOpenRequest(data) {
+      return Boolean(data && typeof data === 'object' && data.type === DRIVE_OPEN_MESSAGE);
+    }
+
+    function driveMessageTrusted(origin) {
+      return !origin || origin === 'null' || origin === window.location.origin;
+    }
+
+    /** 当前 dsh 会话 id（openTab 的 scope 用；取不到就让服务自己决定）。 */
+    function currentDshSessionId() {
+      try {
+        const raw = window.localStorage.getItem('dsh.sessions.current');
+        const current = raw ? JSON.parse(raw) : null;
+        return (current && current.sessionId) || null;
+      } catch {
+        return null;
+      }
+    }
+
+    // 注册并返回 disposer。走 cordis 软依赖 inject（与同宿主 dsh-ccpg-canvasui
+    // 注册侧边栏 tab 同口径）：better-sidebar 未装时回调不执行——独立 dsh
+    // 用户静默无页签；装了则等 betterSidebar 真正 provide 后再注册。
+    // 不能用同步 ctx.get：client fiber 的激活顺序不保证 better-sidebar 先就绪，
+    // 那个窗口里取到 null 会静默跳过且永不重试（真机事故：侧边栏找不到云盘入口）。
+    function registerFeishuDriveTab(ctx) {
+      if (typeof ctx.inject !== 'function') return () => {};
+      return ctx.inject(['betterSidebar'], (scope) => {
+        const sidebar = scope.betterSidebar;
+        setDriveSidebarService(sidebar);
+        if (!sidebar || typeof sidebar.registerTab !== 'function') return;
+        const openDriveTab = () => {
+          const sessionId = currentDshSessionId();
+          // better-sidebar 0.25 openTab 契约：{type,…} + ({sessionId}) scope
+          sidebar.openTab({ type: DRIVE_TAB_ID, title: '飞书云盘' }, sessionId ? { sessionId } : undefined);
+          return true;
+        };
+        const onMessage = (event) => {
+          if (!isDriveOpenRequest(event.data) || !driveMessageTrusted(event.origin)) return;
+          let ok = false;
+          try {
+            ok = openDriveTab();
+          } catch {
+            ok = false;
+          }
+          const target = event.origin && event.origin !== 'null' ? event.origin : '*';
+          try {
+            event.source?.postMessage({ type: DRIVE_OPEN_RESULT, ok }, target);
+          } catch {
+            /* 回执失败不影响已打开/未打开的事实 */
+          }
+        };
+        // 老宿主/测试沙箱可能没有 addEventListener：消息桥是增强，缺了就只注册页签
+        const canListen = typeof window.addEventListener === 'function';
+        if (canListen) window.addEventListener('message', onMessage);
+        const register = () => sidebar.registerTab(feishuDriveTabDescriptor());
+        if (typeof scope.effect !== 'function') {
+          register();
+          return;
+        }
+        scope.effect(register, 'dsh-agentone: feishu-drive tab');
+        if (canListen) {
+          scope.effect(() => () => window.removeEventListener('message', onMessage),
+            'dsh-agentone: feishu-drive open bridge');
+        }
+        // 插件卸载时清掉共享引用：footer 按钮随后点击走设置页兜底，不持有悬空服务
+        if (typeof scope.effect === 'function') {
+          scope.effect(() => () => setDriveSidebarService(null),
+            'dsh-agentone: feishu-drive service ref');
+        }
+      });
+    }
+    // ==drive-tab-end==
+
     // ── 设置导航图标（workbench_fill）─────────────────────────────────────
     // dsh 设置弹窗的导航图标由 shell（ui-settings-general）按 section id 硬编码，
     // 注册项没有 icon 选项（仅 models/agent-presets/plugins 有专用图标，其余一律
@@ -333,6 +709,20 @@ window.__ModuleLoader__.load({
 
     function apply(ctx) {
       setupNavIcon();
+      // 飞书云盘侧边栏 tab（better-sidebar 缺失时内部静默跳过）
+      registerFeishuDriveTab(ctx);
+      // 主界面左栏底部云盘入口（order 10 < 飞书账号 20 → 排在它上方、设置按钮之下）。
+      // 不依赖 better-sidebar：点击时服务在就开页签，不在退化为新窗口开设置页。
+      ctx.slots.inject('sidebar.footer.action', () =>
+        ctx.slots.register(
+          {
+            name: 'sidebar.footer.action',
+            id: 'agentone-drive-entry',
+            order: 10,
+          },
+          DriveFooterEntry,
+        ),
+      );
       ctx.slots.inject('settings.section', () =>
         ctx.slots.register(
           {