dsh-agentone 0.5.44 → 1.0.2

package/lib/index.js

@@ -34,6 +34,10 @@ import { applyPlatformModel, removePlatformModel } from './model.js';
 import { installPlatformSkill, listPlatformSkills, removePlatformSkill } from './skill.js';
 import { applyPlatformSkillhub, removePlatformSkillhub } from './skillhub.js';
 import { createProfilePlugins, validatePackage, PROTECTED_PACKAGES } from './profile-plugins.js';
+import {
+  createDriveService, withChineseLocale, describeDrivePermission, parseLarkJson, loadDriveCache,
+} from './drive.js';
+import { loadArchivePref, setArchiveEnabled, syncArchiveFeature } from './archive.js';
 import { isDesktopHost } from './desktop.js';
 import { createDefaultsSync } from './defaults-sync.js';
 import { canonicalSkillSlug, localSkillState } from './skill-state.js';
@@ -691,6 +695,42 @@ export function apply(ctx, config) {
       `dsh-agentone: route ${path}`,
     );
 
+    // 飞书云盘寻址（/agentone/api/drive/*）共享的 lark-cli 门与服务实例。
+    // 门返回非 null 表示不可用（state 给前端渲染引导），为 null 才继续寻址。
+    // withLatest=false：门是热路径（tab 每次打开都过），不查 npm latest。
+    const driveGate = async () => {
+      const detail = await probeCliDetail('lark-cli', { withLatest: false })
+        .then(withCliUpgradeGuard).catch(() => null);
+      if (!detail || detail.state === 'missing') return { state: 'cli_missing' };
+      if (detail.unconfigured) return { state: 'cli_unconfigured' };
+      if (detail.state !== 'authorized') return { state: 'cli_unauthorized' };
+      return null;
+    };
+    const driveService = createDriveService({
+      run: (args, options) => runCliTool('lark-cli', args, options),
+    });
+
+    /**
+     * 「云盘没权限」的第四态：前三态只管装/配/授权，已授权但缺云盘 scope 时
+     * 寻址会抛 LarkError。这里把它映射成独立 state + 责任方（用户可自助重新
+     * 授权 / 只能管理员开通），而不是把 lark-cli 的英文原文当 502 丢给用户。
+     * 返回 null 表示不是权限问题（按普通失败处理）。
+     */
+    const drivePermissionState = async (error) => {
+      const mapped = await describeDrivePermission(error, {
+        // auth scopes：应用侧已开通的 scope 清单（输出无 ok 壳，parseLarkJson
+        // 会原样返回对象）；失败时 describeDrivePermission 按可自助处理。
+        runAppScopes: async () => {
+          const { stdout } = await runCliTool('lark-cli', ['auth', 'scopes', '--json']);
+          return parseLarkJson(stdout)?.userScopes || null;
+        },
+      });
+      if (mapped) {
+        log?.info?.(`[dsh-agentone] drive permission gap: ${mapped.state} (${mapped.missing_scopes.join(',') || 'unspecified'})`);
+      }
+      return mapped;
+    };
+
     register('/agentone/', (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });
@@ -1057,7 +1097,7 @@ export function apply(ctx, config) {
         invalidateStatusCache();
         sendJson(response, 200, { ok: true, installed: result?.installed ?? 0, failed: result?.failed ?? 0 });
       } catch (error) {
-        sendJson(response, 502, { error: error?.message || '同步套餐技能失败' });
+        sendJson(response, 502, { error: error?.message || '同步技能失败' });
       }
     });
 
@@ -1548,6 +1588,121 @@ export function apply(ctx, config) {
       }
     });
 
+    register('/agentone/api/drive/home', async (request, response) => {
+      if (request.method !== 'GET') {
+        response.writeHead(405, { allow: 'GET' });
+        response.end();
+        return;
+      }
+      try {
+        // lark-cli 三态门与 CLI 页同口径（missing / unconfigured / unauthorized），
+        // 前端按 state 渲染引导；寻址细节见 lib/drive.js 头注释。
+        const gate = await driveGate();
+        if (gate) {
+          sendJson(response, 200, gate);
+          return;
+        }
+        const folder = await driveService.resolveAgentOneFolder({ config });
+        // 带上中文界面参数：缓存里可能是修复前存的裸链接，统一在出口补
+        sendJson(response, 200, { state: 'ready', ...folder, url: withChineseLocale(folder.url) });
+      } catch (error) {
+        const permission = await drivePermissionState(error);
+        if (permission) {
+          sendJson(response, 200, permission);
+          return;
+        }
+        log?.warn?.(`[dsh-agentone] drive home failed: ${error?.message || error}`);
+        sendJson(response, 502, { error: '获取云盘文件夹失败，请稍后重试' });
+      }
+    });
+
+    register('/agentone/api/drive/home/resolve', async (request, response) => {
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'POST' });
+        response.end();
+        return;
+      }
+      try {
+        const gate = await driveGate();
+        if (gate) {
+          sendJson(response, 200, gate);
+          return;
+        }
+        const body = await readJsonBody(request);
+        const adoptUrl = String(body.adopt_url || '').trim().slice(0, 1000);
+        const folder = await driveService.resolveAgentOneFolder({ config, force: true, adoptUrl });
+        sendJson(response, 200, { state: 'ready', ...folder, url: withChineseLocale(folder.url) });
+      } catch (error) {
+        const permission = await drivePermissionState(error);
+        if (permission) {
+          sendJson(response, 200, permission);
+          return;
+        }
+        log?.warn?.(`[dsh-agentone] drive resolve failed: ${error?.message || error}`);
+        sendJson(response, 502, { error: '定位云盘文件夹失败，请稍后重试' });
+      }
+    });
+
+    // 归档开关：AI 产出的飞书云文档是否自动归入云盘文件夹。
+    // 开 = 注入 AGENTS.md 指令块 + 安装归档技能；关 = 撤销两者。
+    register('/agentone/api/drive/archive', async (request, response) => {
+      if (request.method === 'GET') {
+        try {
+          const pref = await loadArchivePref(config);
+          sendJson(response, 200, { enabled: pref.enabled });
+        } catch (error) {
+          log?.warn?.(`[dsh-agentone] read archive pref failed: ${error?.message || error}`);
+          sendJson(response, 502, { error: '读取归档开关失败，请稍后重试' });
+        }
+        return;
+      }
+      if (request.method !== 'POST') {
+        response.writeHead(405, { allow: 'GET, POST' });
+        response.end();
+        return;
+      }
+      try {
+        const body = await readJsonBody(request);
+        const result = await setArchiveEnabled(config, body.enabled === true, log);
+        if (!result.ok) {
+          // 同名技能目录被用户占用：不改开关，明确告知处理方式
+          sendJson(response, 409, { error: result.error });
+          return;
+        }
+        sendJson(response, 200, { enabled: result.enabled });
+      } catch (error) {
+        log?.warn?.(`[dsh-agentone] set archive failed: ${error?.message || error}`);
+        sendJson(response, 502, { error: '设置归档开关失败，请稍后重试' });
+      }
+    });
+
+    // 云盘页签自动刷新：轮询根清单指纹（10s 节流缓存，多个客户端共享）。
+    // 指纹直接用 drive.json 缓存的 token，不做可用性探测（省一次 API 调用）；
+    // 缓存缺失 / lark-cli 不可用 / 任何失败都返回 rev:null，前端按「未知，不动」。
+    let driveRevCheckedAt = 0;
+    let driveRevValue = null;
+    register('/agentone/api/drive/rev', async (request, response) => {
+      if (request.method !== 'GET') {
+        response.writeHead(405, { allow: 'GET' });
+        response.end();
+        return;
+      }
+      try {
+        if (Date.now() - driveRevCheckedAt >= 10_000) {
+          driveRevCheckedAt = Date.now();
+          const cache = await loadDriveCache(config);
+          const token = cache?.agentone_folder?.token;
+          driveRevValue = token ? await driveService.fingerprintFolder(token) : null;
+        }
+        sendJson(response, 200, { rev: driveRevValue });
+      } catch (error) {
+        // 失败同样走 10s 节流（时间戳已前移），rev 归 null 让前端静默不动
+        driveRevValue = null;
+        log?.warn?.(`[dsh-agentone] drive rev failed: ${error?.message || error}`);
+        sendJson(response, 200, { rev: null });
+      }
+    });
+
     register('/agentone/api/plan', async (request, response) => {
       if (request.method !== 'GET') {
         response.writeHead(405, { allow: 'GET' });
@@ -1643,6 +1798,10 @@ export function apply(ctx, config) {
     ensureLanguageDefault(config, log).catch((error) => {
       log.warn(`[dsh-agentone] language default check failed: ${error?.message || error}`);
     });
+    // 云盘归档开关落盘在 storeDir：启动按开关收敛（用户改过 AGENTS.md / 技能目录也对齐）
+    syncArchiveFeature(config, log).catch((error) => {
+      log.warn(`[dsh-agentone] drive archive sync failed: ${error?.message || error}`);
+    });
     (async () => {
       // 托管实例先把 Hub 注入的凭据落盘，再走既有的「已登录」启动流程。
       await bootstrapInstanceCredentials(config, log).catch((error) => {