dsh-agentone 1.0.0 → 1.0.3

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.3",
+  "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,100 @@
+---
+name: agentone-drive
+description: 使用飞书云盘的 AgentOne 文件夹：查看和读取里面的资料，或把飞书云文档（文档 / 表格 / 多维表格 / 幻灯片）保存进去并按「项目或应用」建子文件夹。当需要查共享资料、按关键词搜云盘里的文档、看最近有哪些新放进的文件、读取云盘文件夹内容，或把新做的/已有的飞书文档统一存进云盘时使用。
+version: 1.3.0
+---
+
+# AgentOne 云盘文件夹 / agentone-drive
+
+飞书云盘的 AgentOne 文件夹是本机用户与 AI 共享的工作目录：既能**查资料、取材料**，
+也能**把文档存进去**。文件夹由 dsh-agentone 插件维护（设置 → 云盘），本技能只按约定
+调用脚本，不自己拼 lark-cli 命令。
+
+## 说法（对用户）
+
+用「云盘里的资料」「存进云盘」「已经存好了」这类日常说法，不要用「归档」「归位」
+「落库」等用户可能看不懂的词。
+
+## 文件夹规则
+
+- 根文件夹：`{{DRIVE_CACHE}}` 里 `agentone_folder` 的 token（脚本自己读，不要手抄 token）。
+- 子文件夹：`<项目或应用>`（只有这一层，不按日期切分），保存/上传时自动创建，查看时不创建。
+- 云文档（docx / sheet / base / slides）走 archive/创建流程；普通附件（图片/压缩包/
+  xlsx 等本地文件）用本技能的 `upload`，不要自己拼 `drive +upload`（拿不到项目
+  文件夹 token，会传错地方）。
+
+## 一：查看/读取云盘里的资料
+
+```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>`
+
+## 一·五：按关键词搜文档 / 看最近更新（不用逐个翻文件夹）
+
+```bash
+node "{{DRIVE_SCRIPT}}" search "关键词"           # 在全部项目文件夹里按文件名找（不区分大小写）
+node "{{DRIVE_SCRIPT}}" changed                   # 上次查看之后新放进/有更新的文档
+```
+
+- `search` 输出 `{ok:true, matches:[{name,type,token,url,project}...], total}`，
+  `project` 字段标明文档在哪个项目文件夹；找不到时 `total:0`，可以换关键词再试一次，
+  也不要自创层级。
+- `changed` 用于「用户说看看新放的文件 / 我手机上存了几篇」这类诉求：输出
+  `{ok:true, changes:[{name,type,token,url,project,modified_time}...], since, total}`，
+  按更新时间新在前。**首次运行没有基准，返回空列表（first_run:true）属正常**；
+  每次运行会自动把基准推进到当前时刻（看过即已读），不用额外操作。
+- 用户提到「云盘里的资料」但不确定在哪时，先 `search` 再读取；拿到 token/url 后
+  按上一节的方式按类型读取。
+
+## 二：新建文档时直接存进项目文件夹
+
+先取子文件夹 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}}" upload --file /path/报告.xlsx --project "项目或应用"
+```
+
+输出 `{ok:true, file_token, url, path,...}`（链接已带 `?lang=zh-CN`）。用于 AI 生成的
+xlsx / zip / 截图等**普通文件**；在线云文档（docx/sheet/base/slides）不要用它——
+它们走第二、三节的创建/存入流程，上传会多出一份重复副本。`--name` 可指定云盘里
+的文件名（默认用本地文件名）。
+
+## 三：把已经存在的文档存进去
+
+```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 设置 → 云盘 初始化文件夹」时，先请用户完成
+  初始化再继续。