dsh-agentone 1.0.0 → 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' });
@@ -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) => {

package/lib/page.js

@@ -123,6 +123,24 @@ button:disabled { opacity: .55; cursor: default; }
   border: 1px solid var(--line); background: var(--card); color: var(--text); outline: none;
 }
 .search input:focus { border-color: var(--brand); }
+/* 归档开关：原生 checkbox 外观改写，不引入组件依赖 */
+.switch {
+  display: inline-flex; align-items: center; gap: 8px;
+  cursor: pointer; user-select: none; font-size: 13px;
+}
+.switch input {
+  appearance: none; -webkit-appearance: none; margin: 0; cursor: pointer;
+  width: 36px; height: 20px; border-radius: 999px; background: var(--line);
+  position: relative; transition: background .15s;
+}
+.switch input::after {
+  content: ''; position: absolute; top: 2px; left: 2px; width: 16px; height: 16px;
+  border-radius: 50%; background: #fff; transition: transform .15s;
+}
+.switch input:checked { background: var(--brand); }
+.switch input:checked::after { transform: translateX(16px); }
+.switch input:disabled { opacity: .55; cursor: default; }
+.switch input:focus-visible { outline: 2px solid var(--brand); outline-offset: 2px; }
 .footer { display: flex; justify-content: space-between; align-items: center; margin-top: 4px; }
 .spin {
   width: 13px; height: 13px; border: 2px solid currentColor; border-top-color: transparent;
@@ -242,12 +260,129 @@ const activateTab = (name) => {
       renderCli(lastStatus);
     }
   }
+  // 云盘文件夹状态按需探测（寻址要走 lark-cli 调飞书 API，同样 1 分钟节流；
+  // resolve 操作后由 renderDrive._probedAt=0 立即重探）
+  if (name === 'drive') {
+    const now = Date.now();
+    if (!renderDrive._probedAt || now - renderDrive._probedAt > 60000) {
+      renderDrive._probedAt = now;
+      renderDrive();
+    }
+    // 归档开关是本机状态（不走 lark-cli），无需节流
+    if (typeof renderDriveArchive === 'function') renderDriveArchive();
+  }
 };
 // CLI 页手动重新检测：清掉节流时间戳立即重探
 $('cli-recheck-btn').onclick = () => {
   renderCli._probedAt = 0;
   renderCli(lastStatus);
 };
+// 云盘文件夹：打开云盘（宿主页监听 postMessage 后开侧边栏页签；无宿主时退回新窗口）
+const DRIVE_OPEN_MESSAGE = 'agentone:open-feishu-drive';
+const DRIVE_OPEN_RESULT = 'agentone:open-feishu-drive:result';
+
+function openDriveSurface() {
+  const url = (renderDrive._data && renderDrive._data.url) || '';
+  const openExternal = () => {
+    if (!url) return false;
+    window.open(url, '_blank', 'noopener');
+    return true;
+  };
+  // 单独打开本页（无宿主框架）时没有侧边栏可开，直接新窗口
+  if (window.parent === window) {
+    if (!openExternal()) notify('还没有定位到文件夹，请先点「初始化 / 重新定位」', 'err');
+    return;
+  }
+  let settled = false;
+  const onReply = (event) => {
+    if (!event.data || event.data.type !== DRIVE_OPEN_RESULT) return;
+    settled = true;
+    window.removeEventListener('message', onReply);
+    if (!event.data.ok && !openExternal()) {
+      notify('侧边栏云盘页签不可用，请在 dsh 设置里确认 better-sidebar 已启用', 'err');
+    }
+  };
+  window.addEventListener('message', onReply);
+  // 目标 origin 用 '*'：载荷只是「打开我的页签」这条指令，接收侧已校验来源
+  window.parent.postMessage({ type: DRIVE_OPEN_MESSAGE }, '*');
+  setTimeout(() => {
+    if (settled) return;
+    window.removeEventListener('message', onReply);
+    openExternal();
+  }, 800);
+}
+
+$('drive-open-btn').onclick = () => openDriveSurface();
+// 云盘文件夹：初始化/重新定位（force 重新寻址：按名找，找不到建）
+$('drive-resolve-btn').onclick = () => {
+  // readJsonBody 只认 application/json（跨站表单防线），POST 必须带该头
+  withLoading($('drive-resolve-btn'), async () => fetch('api/drive/home/resolve', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({}),
+  }),
+    '云盘文件夹已就绪', null)
+    .then(() => { renderDrive._probedAt = 0; renderDrive(); });
+};
+// 云盘文件夹：收养用户粘贴的文件夹链接
+$('drive-adopt-btn').onclick = () => {
+  const input = $('drive-adopt-input');
+  const url = input.value.trim();
+  if (!/feishu\\.cn\\/drive\\/folder\\//.test(url) && !/larksuite\\.com\\/drive\\/folder\\//.test(url)) {
+    notify('请粘贴飞书云盘文件夹链接（…/drive/folder/…）', 'err');
+    return;
+  }
+  withLoading($('drive-adopt-btn'), async () => fetch('api/drive/home/resolve', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ adopt_url: url }),
+  }), '已切换到指定文件夹', null)
+    .then(() => { input.value = ''; renderDrive._probedAt = 0; renderDrive(); });
+};
+// 云盘归档开关：读取当前状态（开 = AGENTS.md 指令块 + 归档技能都已就位）
+const renderDriveArchive = async () => {
+  const toggle = $('drive-archive-toggle');
+  const stateEl = $('drive-archive-state');
+  try {
+    const resp = await fetch('api/drive/archive');
+    const data = await resp.json().catch(() => ({}));
+    if (!resp.ok) throw new Error(data.error || '读取失败，请稍后重试');
+    toggle.checked = data.enabled === true;
+    stateEl.textContent = data.enabled ? '已启用' : '未启用';
+  } catch (error) {
+    stateEl.textContent = error.message || '读取失败，请稍后重试';
+  }
+};
+$('drive-archive-toggle').onchange = async (event) => {
+  const toggle = event.target;
+  const stateEl = $('drive-archive-state');
+  const msgEl = $('drive-archive-msg');
+  const enabled = toggle.checked;
+  toggle.disabled = true;
+  stateEl.textContent = enabled ? '启用中…' : '停用中…';
+  msgEl.hidden = true;
+  try {
+    // readJsonBody 只认 application/json，POST 必须带该头
+    const resp = await fetch('api/drive/archive', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ enabled }),
+    });
+    const data = await resp.json().catch(() => ({}));
+    if (!resp.ok) throw new Error(data.error || '设置失败，请稍后重试');
+    toggle.checked = data.enabled === true;
+    stateEl.textContent = data.enabled ? '已启用' : '未启用';
+    notify(data.enabled ? '已启用云盘，新开一个对话后生效' : '已停用云盘', 'ok');
+  } catch (error) {
+    // 失败回滚到操作前的状态，避免开关显示与实际不一致
+    toggle.checked = !enabled;
+    stateEl.textContent = toggle.checked ? '已启用' : '未启用';
+    msgEl.textContent = error.message || '设置失败，请稍后重试';
+    msgEl.hidden = false;
+  } finally {
+    toggle.disabled = false;
+  }
+};
 document.querySelectorAll('.tab').forEach((tab) => {
   tab.onclick = () => activateTab(tab.dataset.tab);
 });
@@ -851,6 +986,12 @@ const cliAuthDialog = async (tool) => {
           setTimeout(close, 800);
           if (d.tool) renderCliData(lastStatus, { [tool]: d.tool });
           else renderCli(lastStatus);
+          // 云盘文件夹探测结果可能随授权态变化（cli_unauthorized → ready）：
+          // 清节流立即重探，正在看云盘页的用户不用等 60s
+          if (typeof renderDrive === 'function') {
+            renderDrive._probedAt = 0;
+            if ($('pane-drive') && !$('pane-drive').hidden) renderDrive();
+          }
           return;
         }
         if (r.status === 202 && d.pending !== false) {
@@ -1037,9 +1178,77 @@ const cliInstall = async (tool, btn) => {
   }
 };
 
+/**
+ * 云盘文件夹状态探测：/api/drive/home 带回 state（ready / cli_missing /
+ * cli_unconfigured / cli_unauthorized）与文件夹信息。非 ready 态给出对应
+ * 引导动作（跳 CLI 页安装 / 初始化应用 / 打开授权弹窗——复用 CLI 页同套
+ * 设备流，授权成功会自动重探本页）。
+ */
+const renderDrive = async () => {
+  const statusEl = $('drive-status');
+  const kvEl = $('drive-folder-kv');
+  const linkEl = $('drive-folder-link');
+  const seq = (renderDrive._seq = (renderDrive._seq || 0) + 1);
+  statusEl.textContent = '检测中…';
+  kvEl.hidden = true;
+  let data;
+  try {
+    const resp = await fetch('api/drive/home');
+    data = await resp.json().catch(() => ({}));
+    if (!resp.ok) throw new Error(data.error || '检测失败，请稍后重试');
+  } catch (error) {
+    if (seq === renderDrive._seq) statusEl.textContent = error.message || '检测失败，请稍后重试';
+    return;
+  }
+  if (seq !== renderDrive._seq) return;
+  renderDrive._data = data;
+  if (data.state === 'ready') {
+    statusEl.textContent = '已就绪：侧边栏「飞书云盘」页签会直接进入这个文件夹。';
+    if (data.url) {
+      linkEl.textContent = data.name || 'AgentOne';
+      linkEl.href = data.url;
+      kvEl.hidden = false;
+    }
+    return;
+  }
+  kvEl.hidden = true;
+  if (data.state === 'cli_missing') {
+    statusEl.innerHTML = '本机还没有安装 lark-cli（飞书命令行工具），无法定位云盘文件夹。'
+      + '请到「CLI」页签安装后回来点「初始化 / 重新定位」。';
+  } else if (data.state === 'cli_unconfigured') {
+    statusEl.innerHTML = 'lark-cli 还没有完成飞书应用初始化。请到「CLI」页签点「初始化应用」，'
+      + '完成后再回来点「初始化 / 重新定位」。';
+  } else if (data.state === 'cli_unauthorized') {
+    statusEl.innerHTML = 'lark-cli 还没有获得你的飞书授权。首次使用需要扫码一次：'
+      + '<div class="row" style="margin-top:8px">'
+      + '<button class="btn small primary" id="drive-auth-btn">去授权</button></div>';
+    statusEl.querySelector('#drive-auth-btn').onclick = () => cliAuthDialog('lark-cli');
+  } else if (data.state === 'drive_scope_missing') {
+    // 授权在、但令牌里没有云盘权限：应用已开通，用户重新授权即可自助解决
+    const list = Array.isArray(data.missing_scopes) ? data.missing_scopes : [];
+    statusEl.innerHTML = '你的飞书授权里还没有云盘权限'
+      + (list.length ? '（缺少：' + esc(list.join('、')) + '）' : '')
+      + '。点「重新授权」用手机飞书扫码确认一次即可，授权成功后会自动重新检测。'
+      + '<div class="row" style="margin-top:8px">'
+      + '<button class="btn small primary" id="drive-auth-btn">重新授权</button></div>';
+    statusEl.querySelector('#drive-auth-btn').onclick = () => cliAuthDialog('lark-cli');
+  } else if (data.state === 'drive_app_forbidden') {
+    // 应用本身没开通：重新授权也拿不到，只能管理员在开放平台开通并发布版本
+    const list = (Array.isArray(data.app_missing_scopes) && data.app_missing_scopes.length)
+      ? data.app_missing_scopes
+      : (Array.isArray(data.missing_scopes) ? data.missing_scopes : []);
+    statusEl.innerHTML = '飞书应用本身还没有开通云空间权限'
+      + (list.length ? '（缺少：' + esc(list.join('、')) + '）' : '')
+      + '，重新授权也拿不到。请联系管理员在飞书开放平台为应用开通云空间权限并发布版本，'
+      + '然后回来点「初始化 / 重新定位」。';
+  } else {
+    statusEl.textContent = data.error || '检测失败，请稍后重试';
+  }
+};
+// 授权成功后的云盘页重探挂在 cliAuthDialog 的轮询成功分支（见上）。
+
 /** CLI 一键升级：官方 tool update（ccpg 下载二进制可达分钟级）。 */
-const cliUpgrade = async (tool, btn) => {
-  btn.disabled = true;
+const cliUpgrade = async (tool, btn) => {  btn.disabled = true;
   btn.textContent = '升级中，可能需要 1–2 分钟…';
   try {
     const resp = await fetch('api/cli/upgrade', {
@@ -1574,6 +1783,7 @@ export function statusPageHtml() {
       <button class="tab" role="tab" aria-selected="false" data-tab="skills">技能</button>
       <button class="tab" role="tab" aria-selected="false" data-tab="plugins">插件</button>
       <button class="tab" role="tab" aria-selected="false" data-tab="cli">CLI</button>
+      <button class="tab" role="tab" aria-selected="false" data-tab="drive">云盘</button>
       <button class="tab" role="tab" aria-selected="false" data-tab="about">关于</button>
     </nav>
 
@@ -1643,6 +1853,42 @@ export function statusPageHtml() {
       </div>
     </div>
 
+    <div class="tabpane" id="pane-drive" hidden>
+      <div class="card">
+        <h3>飞书云盘文件夹 <span class="muted">侧边栏「飞书云盘」页签的落点</span></h3>
+        <div id="drive-status" class="skill-sub">检测中…</div>
+        <div class="kv" id="drive-folder-kv" hidden>
+          <span class="k">当前文件夹</span>
+          <span class="v"><a id="drive-folder-link" target="_blank" rel="noopener"></a></span>
+        </div>
+        <div class="row" style="margin-top:12px">
+          <button id="drive-open-btn" class="btn small">打开云盘</button>
+          <button id="drive-resolve-btn" class="btn small primary" data-loading="定位中…">初始化 / 重新定位</button>
+        </div>
+        <div class="hint" id="drive-firstuse-hint">首次使用：云盘需要飞书授权。点「打开云盘」后在侧边栏页签里按提示点「去授权」，用手机飞书扫描弹窗里的二维码确认一次即可（之后不再需要）。</div>
+        <div class="hint" id="drive-hint">初始化会在你的飞书「我的空间」根目录找到（没有则创建）名为「AgentOne」的文件夹；之后侧边栏云盘页签直接进入这个文件夹，你看到的飞书云盘界面里做的上传、整理都发生在这里。</div>
+      </div>
+      <div class="card">
+        <h3>启用云盘 <span class="muted">启用后，AI 可以使用这个文件夹：读得到资料，也存得进文档</span></h3>
+        <label class="switch">
+          <input type="checkbox" id="drive-archive-toggle" aria-label="启用云盘" />
+          <span id="drive-archive-state">读取中…</span>
+        </label>
+        <div class="hint">启用后：AI 干活时可以查看、使用这个文件夹里的资料；做好的飞书文档
+          （文档、表格、多维表格、幻灯片）也可以存进这个文件夹，按项目名分好类。</div>
+        <div class="hint">新开一个对话后开始生效。停用后 AI 不能再读写这个文件夹，已经存进去的文件不受影响。</div>
+        <div class="hint" id="drive-archive-msg" hidden></div>
+      </div>
+      <div class="card">
+        <h3>更换文件夹</h3>
+        <div class="skill-sub">已有想用的文件夹？粘贴它的飞书链接（…/drive/folder/…），云盘页签将改为进入该文件夹。</div>
+        <div class="search" style="margin-top:8px">
+          <input id="drive-adopt-input" placeholder="https://xxx.feishu.cn/drive/folder/…" aria-label="文件夹链接" />
+          <button id="drive-adopt-btn" class="btn ghost small" data-loading="校验中…">使用此文件夹</button>
+        </div>
+      </div>
+    </div>
+
     <div class="tabpane" id="pane-about" hidden>
       <div class="card">
         <h3>关于</h3>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "1.0.0",
-  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；平台清单融入技能/插件双 Tab，无 Node 机器用桌面壳自带工具链装 lark-cli",
+  "version": "1.0.2",
+  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐、CLI、飞书云盘共享文件夹（侧栏页签；「启用云盘」后 AI 可读取使用资料、把文档存进文件夹）",
   "type": "module",
   "scripts": {
     "smoke": "node scripts/env-matrix-smoke.mjs"
@@ -15,6 +15,7 @@
   "license": "MIT",
   "files": [
     "lib/",
+    "skills/",
     "cordis.patch.yml",
     "README.md"
   ],

package/skills/agentone-drive/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: agentone-drive
+description: 使用飞书云盘的 AgentOne 文件夹：查看和读取里面的资料，或把飞书云文档（文档 / 表格 / 多维表格 / 幻灯片）保存进去并按「项目或应用」建子文件夹。当需要查共享资料、读取云盘文件夹内容，或把新做的/已有的飞书文档统一存进云盘时使用。
+version: 1.2.0
+---
+
+# AgentOne 云盘文件夹 / agentone-drive
+
+飞书云盘的 AgentOne 文件夹是本机用户与 AI 共享的工作目录：既能**查资料、取材料**，
+也能**把文档存进去**。文件夹由 dsh-agentone 插件维护（设置 → 云盘），本技能只按约定
+调用脚本，不自己拼 lark-cli 命令。
+
+## 说法（对用户）
+
+用「云盘里的资料」「存进云盘」「已经存好了」这类日常说法，不要用「归档」「归位」
+「落库」等用户可能看不懂的词。
+
+## 文件夹规则
+
+- 根文件夹：`{{DRIVE_CACHE}}` 里 `agentone_folder` 的 token（脚本自己读，不要手抄 token）。
+- 子文件夹：`<项目或应用>`（只有这一层，不按日期切分），保存时自动创建，查看时不创建。
+- 只管理云文档（docx / sheet / base / slides）；普通附件上传用 lark-cli 的
+  `drive +upload`，不要用本技能。
+
+## 一：查看/读取云盘里的资料
+
+```bash
+node "{{DRIVE_SCRIPT}}" list                      # 看根文件夹里有什么（各项目文件夹）
+node "{{DRIVE_SCRIPT}}" list --project "项目或应用" # 看某个项目文件夹里的文档
+```
+
+输出 `{ok:true, files:[{name,type,token,url}...], has_more}`。`has_more:true` 表示还有
+更多（一页 200 条），需要翻页时直接用 lark-cli 的 `api GET /open-apis/drive/v1/files`。
+拿到 token/url 后按类型读取：
+
+- 在线文档：`lark-cli docs +fetch --url <url>`
+- 表格 / 多维表格：`lark-cli` 的 sheets / base 命令
+- 普通文件：`lark-cli drive +download --file-token <token>`
+
+## 二：新建文档时直接存进项目文件夹
+
+先取子文件夹 token，再在创建时指定父文件夹，文档一步到位、无需二次移动：
+
+```bash
+FOLDER=$(node "{{DRIVE_SCRIPT}}" resolve-folder --project "项目或应用" --token-only)
+lark-cli docs +create --title "标题" --content @body.xml --parent-token "$FOLDER"
+```
+
+表格 / 多维表格 / 幻灯片：先用 `lark-cli drive +import --file x.xlsx --type sheet`
+生成云文档，再按下节存进去。
+
+## 三：把已经存在的文档存进去
+
+```bash
+node "{{DRIVE_SCRIPT}}" archive --token <文档 token 或链接> --type docx --project "项目或应用"
+```
+
+输出 JSON：`{ok:true, archived:true|false, folder_token, folder_url, path}`。
+`archived:false` 表示该文档已经在目标文件夹里（重复调用安全，不会重复移动）。
+
+## 约定
+
+- **把飞书链接给用户时，一律在链接后追加 `?lang=zh-CN`**（脚本输出的链接已自动带）。
+  原因：宿主的内嵌浏览器是独立登录会话，界面语言可能默认英文；`?lang=zh-CN` 会被
+  飞书改写成该会话的语言偏好。`docs +create` 等 lark-cli 命令返回的链接不带参数，要自己补。
+- `--project` 取当前任务所属的项目名或应用名；**同一个项目/应用固定用同一个名字**，
+  文档才会聚在同一个文件夹里。保存时拿不准就省略，脚本会放进「未分类」，不要自创层级。
+- 已经存进去的文档不要重复移动；同一次任务里只存一次。
+- 脚本返回 `{ok:false, error}` 时，把 `error` 原文（已是中文）告诉用户，不要重试
+  超过一次；提示里出现「请先在 dsh 设置 → 云盘 初始化文件夹」时，先请用户完成
+  初始化再继续。