dsh-agentone 0.5.44 → 1.0.2

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);
 });
@@ -395,52 +530,87 @@ const renderPlan = async () => {
     ).then(() => renderPlan());
   });
 };
+// 平台清单同步态与插件列表的同名合并：renderDefaults 记录待处理插件并排除
+// 已列名条目，renderPlugins 把同步状态/原因/重试合并进同名行——同一个包只
+// 出现一行（真实用户机 dsh-im：清单同步失败 + 本机未启用曾显示成两条）
+let defaultsPendingPlugins = [];
+let listedPluginNames = new Set();
+let mergedPendingSig = '';
+const DEFAULTS_STATE_LABELS = { current: '已符合', missing: '待安装', pending: '待应用', running: '同步中',
+  failed: '失败', conflict: '本机冲突', report_pending: '已安装，待回报', restart_required: '已安装，重启后生效' };
+/** 同步动作按钮的统一绑定（待处理块与合并进插件行的按钮同一契约）。 */
+const bindDefaultsActions = (el) => {
+  el.querySelectorAll('[data-default-action]').forEach((btn) => {
+    const request = () => fetch('api/defaults/' + btn.dataset.defaultAction, { method: 'POST',
+      headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ kind: btn.dataset.kind,
+        name: btn.dataset.name, confirm: btn.dataset.defaultAction === 'apply' }) });
+    btn.onclick = () => btn.dataset.defaultAction === 'apply'
+      ? confirmThen(btn, '替换当前版本？', request, '已开始应用，请查看同步状态')
+      : withLoading(btn, request, '已开始重试，请查看同步状态');
+  });
+};
+const defaultsPendingSig = () => defaultsPendingPlugins.map((item) => [item.name, item.state,
+  item.target_version || '', item.error || ''].join('~')).join('|');
+
 const renderDefaults = (s) => {
-  const body = $('defaults-body');
   const config = s.defaults;
-  const labels = { current: '已符合', missing: '待安装', pending: '待应用', running: '同步中',
-    failed: '失败', conflict: '本机冲突', report_pending: '已安装，待回报', restart_required: '已安装，重启后生效' };
+  const syncBtn = $('defaults-sync-btn');
+  const labels = DEFAULTS_STATE_LABELS;
   const sources = { platform: '平台清单', compatibility: '旧平台兼容默认', cache: '本机缓存' };
-  if (!config || !s.logged_in) { body.innerHTML = '<div class="muted">登录后检查平台默认能力</div>'; return; }
+  const clearBlock = (el) => { el.innerHTML = ''; delete el.dataset.fingerprint; };
+  if (!config || !s.logged_in) {
+    syncBtn.hidden = true;
+    for (const id of ['defaults-meta', 'defaults-plugins', 'defaults-skills']) clearBlock($(id));
+    return;
+  }
+  syncBtn.hidden = false;
+  syncBtn.disabled = Boolean(config.running);
   const entries = [...(config.skills || []), ...(config.plugins || [])];
   // legacy：0.5.39 之前装的技能只有平台台账、没有本机记录（见 defaults-sync）。
   // 这类条目单独给一个批量入口，不然升级后每台机器都要点 N 次「确认应用」。
   const legacyCount = entries.filter((item) => item.legacy).length;
-  const summary = '<div class="skill-sub">' + esc(sources[config.source] || '尚未检查')
-    + (config.revision !== null ? ' · 版本 ' + esc(config.revision) : '')
+  const pendingCount = entries.filter((item) => item.state !== 'current').length;
+  // 待处理插件交给 renderPlugins 合并进同名行（见顶部说明）
+  defaultsPendingPlugins = (config.plugins || []).filter((item) => item.state !== 'current');
+  // 清单状态收成插件卡头一行 meta（来源/版本/时间/符合统计/错误）：健康项不
+  // 铺开——技能与插件分别在各自 Tab 的列表里以「平台默认/受管」标签呈现，
+  // 这里只按类型冒泡待处理项，长描述彻底退出列表。
+  const metaHtml = '<div class="skill-sub">' + esc(sources[config.source] || '尚未检查')
+    + (config.revision !== null ? ' · 清单版本 ' + esc(config.revision) : '')
     + (config.checked_at ? ' · ' + esc(new Date(config.checked_at).toLocaleString()) : '')
+    + ' · <span style="color:var(--ok)">' + (entries.length - pendingCount) + ' 项已符合</span>'
+    + (pendingCount ? ' · <span style="color:var(--warn)">' + pendingCount + ' 项待处理（见下）</span>' : '')
+    + (!entries.length ? ' · 当前清单为空' : '')
     + (config.running ? ' · 正在检查' : '') + '</div>'
-    + (config.error || config.profile_error ? '<div class="skill-sub" style="color:var(--err)">' + esc(config.error || config.profile_error) + '</div>' : '')
-    + (legacyCount ? '<div class="skill-sub"><button id="defaults-repair" class="btn small ghost"'
-      + (config.running ? ' disabled' : '') + '>重新应用旧版安装的技能（' + legacyCount + '）</button>'
-      + ' 技能目录会按平台当前版本覆盖</div>' : '');
-  const html = summary + entries.map((item) => {
+    + (config.error || config.profile_error
+      ? '<div class="skill-sub" style="color:var(--err)">' + esc(config.error || config.profile_error) + '</div>' : '');
+  const meta = $('defaults-meta');
+  if (meta.dataset.fingerprint !== metaHtml) { meta.dataset.fingerprint = metaHtml; meta.innerHTML = metaHtml; }
+  const statePill = (state) => state === 'failed' || state === 'conflict'
+    ? '<span class="pill" style="font-size:11px;background:var(--err-weak);color:var(--err)">'
+      + esc(labels[state] || state) + '</span>'
+    : '<span class="pill warn" style="font-size:11px">' + esc(labels[state] || state) + '</span>';
+  // 单行紧凑条目：名称 · 类型徽标 · 状态徽标 · 版本（→ 目标版本）+ 行内操作
+  const rowHtml = (item) => {
     const action = ['failed', 'report_pending', 'missing'].includes(item.state) ? 'retry'
       : ['conflict', 'pending'].includes(item.state) ? 'apply' : null;
     const button = action ? '<button class="btn small ghost" data-default-action="' + action
       + '" data-kind="' + item.kind + '" data-name="' + esc(item.name) + '"'
       + (config.running ? ' disabled' : '') + '>' + (action === 'retry' ? '重试' : '确认应用') + '</button>' : '';
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
-      + esc(item.description || item.name) + ' <span class="tag">' + (item.kind === 'skill' ? '技能' : '插件')
-      + '</span></div><div class="skill-sub">' + esc(item.name) + ' · ' + esc(labels[item.state] || item.state)
-      + (item.legacy ? '（旧版安装）' : '')
-      + (item.version ? ' · ' + esc(item.version) : '')
+      + esc(item.name) + ' <span class="tag">' + (item.kind === 'skill' ? '技能' : '插件') + '</span>'
+      + statePill(item.state)
+      + (item.legacy ? ' <span class="tag">旧版安装</span>' : '')
+      + '</div><div class="skill-sub">'
+      + (item.version ? esc(item.version) : '')
       + (item.target_version && item.target_version !== item.version ? ' → ' + esc(item.target_version) : '')
       + (item.error ? '<br><span style="color:var(--err)">' + esc(item.error) + '</span>' : '')
       + '</div></div>' + button + '</div>';
-  }).join('') + (!entries.length ? '<div class="skill-sub">当前清单为空</div>' : '');
-  if (body.dataset.fingerprint !== html) {
-    body.dataset.fingerprint = html; body.innerHTML = html;
-    body.querySelectorAll('[data-default-action]').forEach((btn) => {
-      const request = () => fetch('api/defaults/' + btn.dataset.defaultAction, { method: 'POST',
-        headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ kind: btn.dataset.kind,
-          name: btn.dataset.name, confirm: btn.dataset.defaultAction === 'apply' }) });
-      btn.onclick = () => btn.dataset.defaultAction === 'apply'
-        ? confirmThen(btn, '替换当前版本？', request, '已开始应用，请查看同步状态')
-        : withLoading(btn, request, '已开始重试，请查看同步状态');
-    });
-    const repair = body.querySelector('#defaults-repair');
-    if (repair) repair.onclick = async () => {
+  };
+  const bindRepair = (el) => {
+    const repair = el.querySelector('#defaults-repair');
+    if (!repair) return;
+    repair.onclick = async () => {
       if (repair.dataset.confirming !== '1') {
         repair.dataset.confirming = '1';
         repair.dataset.originalLabel = repair.textContent;
@@ -470,8 +640,31 @@ const renderDefaults = (s) => {
         await refresh();
       }
     };
-  }
-  $('defaults-sync-btn').disabled = config.running;
+  };
+  // 按类型各归其位：待处理插件进插件 Tab、待处理技能进技能 Tab，只列非已符合
+  // 项；5s 轮询高频调用，块内容没变时靠指纹跳过重绘（不打断进行中的点击）
+  const renderBlock = (id, list) => {
+    const el = $(id);
+    // 插件待处理项：已进插件列表的同名条目不在这里重复出现（合并进那一行）
+    const pending = (list || []).filter((item) => item.state !== 'current'
+      && !(id === 'defaults-plugins' && listedPluginNames.has(item.name)));
+    const legacy = id === 'defaults-skills' && legacyCount
+      ? '<div class="skill-sub"><button id="defaults-repair" class="btn small ghost"'
+        + (config.running ? ' disabled' : '') + '>重新应用旧版安装的技能（' + legacyCount + '）</button>'
+        + ' 技能目录会按平台当前版本覆盖</div>'
+      : '';
+    const html = (pending.length || legacy)
+      ? '<div class="skill-sub" style="margin-top:10px">平台同步待处理</div>'
+        + pending.map(rowHtml).join('') + legacy
+      : '';
+    if (el.dataset.fingerprint !== html) { el.dataset.fingerprint = html; el.innerHTML = html; bindDefaultsActions(el); bindRepair(el); }
+  };
+  renderBlock('defaults-plugins', config.plugins);
+  renderBlock('defaults-skills', config.skills);
+  // 待处理集合变化（新失败/恢复）→ 让已加载的插件列表行重新合并；
+  // renderPlugins 侧会先对齐 mergedPendingSig，不会互相触发死循环
+  const pendingSig = defaultsPendingSig();
+  if (renderPlugins._loaded && pendingSig !== mergedPendingSig) void renderPlugins();
 };
 const renderSkills = (s) => {
   const skillhubEnabled = s.capabilities?.channels?.skillhub?.enabled !== false;
@@ -793,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) {
@@ -979,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', {
@@ -1044,8 +1311,14 @@ const renderPlugins = async () => {
   }
   // 渲染成功即标记已加载：避免切 tab 重复拉取（outdated 查询有网络开销）
   renderPlugins._loaded = true;
+  // 同名合并登记（见 renderDefaults 顶部说明）：已列名的插件，其清单同步
+  // 状态合并进本行；待处理块不再单列一条
+  listedPluginNames = new Set(data.plugins.map((plugin) => plugin.name));
+  const pendingByN = new Map(defaultsPendingPlugins.map((item) => [item.name, item]));
   if (!data.plugins?.length) {
     list.innerHTML = '<div class="skill-sub">暂无已安装插件；内置插件缺失时会在 dsh 启动时自动恢复。</div>';
+    mergedPendingSig = defaultsPendingSig();
+    if (lastStatus) renderDefaults(lastStatus);
     return;
   }
   const rows = data.plugins.map((plugin) => {
@@ -1065,6 +1338,15 @@ const renderPlugins = async () => {
     const builtinTag = plugin.builtin
       ? '<span class="tag">受管</span>'
       : '';
+    // 清单同步态合并：同名待处理插件在本行直接给出状态/原因/动作
+    const pending = pendingByN.get(plugin.name);
+    const syncPill = pending
+      ? (['failed', 'conflict'].includes(pending.state)
+        ? '<span class="pill" style="font-size:11px;background:var(--err-weak);color:var(--err)">同步'
+          + esc(DEFAULTS_STATE_LABELS[pending.state] || pending.state) + '</span>'
+        : '<span class="pill warn" style="font-size:11px">同步'
+          + esc(DEFAULTS_STATE_LABELS[pending.state] || pending.state) + '</span>')
+      : '';
     const version = plugin.latest
       ? esc(plugin.version) + ' → <b>' + esc(plugin.latest) + '</b>'
       : esc(plugin.version || '—');
@@ -1084,17 +1366,25 @@ const renderPlugins = async () => {
         actions.push('<button class="btn small danger" data-remove="' + esc(plugin.name) + '">卸载</button>');
       }
     }
+    if (pending && ['failed', 'report_pending', 'missing'].includes(pending.state)) {
+      actions.push('<button class="btn small ghost" data-default-action="retry" data-kind="plugin" data-name="' + esc(plugin.name) + '">重试</button>');
+    } else if (pending && ['conflict', 'pending'].includes(pending.state)) {
+      actions.push('<button class="btn small ghost" data-default-action="apply" data-kind="plugin" data-name="' + esc(plugin.name) + '">确认应用</button>');
+    }
     const actionHtml = actions.length
       ? '<div style="display:flex;gap:6px">' + actions.join('') + '</div>'
       : '';
     return '<div class="skill-item"><div class="skill-info"><div class="skill-name">'
-      + esc(plugin.name) + builtinTag + statePill
+      + esc(plugin.name) + builtinTag + statePill + syncPill
       + '</div><div class="skill-sub">' + desc + esc(plugin.source) + ' · ' + version
       + (plugin.registered ? ' · 已启用，重启后生效' : plugin.bundled ? ' · 已安装，未启用当前 profile（「升级」或重装可启用）' : '')
+      + (pending ? ' · 平台同步 ' + esc(pending.version || '') + (pending.target_version && pending.target_version !== pending.version ? ' → ' + esc(pending.target_version) : '') : '')
+      + (pending?.error ? '<br><span style="color:var(--err)">' + esc(pending.error) + '</span>' : '')
       + '</div></div>' + actionHtml + '</div>';
   });
   // 指纹保护（与 renderSkills 同思路）：内容没变不碰 innerHTML——升级后
-  // 的定向刷新、切 tab 重入都不会重建按钮节点（打断卸载二次确认）或闪动
+  // 的定向刷新、切 tab 重入都不会重建按钮节点（打断卸载二次确认）或闪动。
+  // 清单同步态参与指纹：失败/恢复会让行内容变化
   const fingerprint = data.plugins.map((plugin) => [
     plugin.name,
     plugin.version || '',
@@ -1102,6 +1392,10 @@ const renderPlugins = async () => {
     plugin.registered ? 1 : 0,
     plugin.bundled ? 1 : 0,
     plugin.self_managed ? 1 : 0,
+    pendingByN.get(plugin.name)
+      ? [pendingByN.get(plugin.name).state, pendingByN.get(plugin.name).target_version || '',
+        pendingByN.get(plugin.name).error || ''].join('~')
+      : '',
   ].join(':')).join('|');
   if (list.dataset.fingerprint !== fingerprint) {
     list.dataset.fingerprint = fingerprint;
@@ -1125,6 +1419,12 @@ const renderPlugins = async () => {
         body: JSON.stringify({ name: btn.dataset.remove }),
       }).then(() => renderPlugins()), '插件已卸载');
   });
+  // 合并进插件行的同步动作按钮（与待处理块同一契约）
+  bindDefaultsActions(list);
+  // 对齐「已合并的待处理集合」：renderDefaults 的变化触发到此为止（不会回环）；
+  // 列名登记可能让待处理块的排除集变化，定向重绘一次
+  mergedPendingSig = defaultsPendingSig();
+  if (lastStatus) renderDefaults(lastStatus);
 };
 // ==about-upgrade-begin==
 // 关于页版本行：aboutSelf（GET api/plugin/self）有值时展示升级入口或
@@ -1403,7 +1703,7 @@ $('skillhub-sync-btn').onclick = () => withLoading(
   () => fetch('api/skillhub/sync', { method: 'POST' }),
   'SkillHub 配置已同步',
 );
-// 手动同步套餐技能：文案按结果给（装了几个），失败由 withLoading 展示
+// 手动同步技能：文案按结果给（装了几个），失败由 withLoading 展示
 $('skill-sync-btn').onclick = () => withLoading(
   $('skill-sync-btn'),
   async () => {
@@ -1483,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>
 
@@ -1514,9 +1815,10 @@ export function statusPageHtml() {
       <div class="card" id="skills-card">
         <h3>平台技能 <span class="muted">套餐自动同步</span></h3>
         <div id="skills-list"></div>
+        <div id="defaults-skills"></div>
         <div class="hint" id="skills-meta"></div>
         <div class="row" style="margin-top:8px">
-          <button id="skill-sync-btn" class="btn ghost small" data-loading="同步中…">同步套餐技能</button>
+          <button id="skill-sync-btn" class="btn ghost small" data-loading="同步中…">同步技能</button>
         </div>
         <div class="search" style="margin-top:12px">
           <input id="search-input" placeholder="搜索技能市场，如：数据 / 报告 / lark" />
@@ -1532,11 +1834,11 @@ export function statusPageHtml() {
 
     <div class="tabpane" id="pane-plugins" hidden>
       <div class="card">
-        <h3>平台默认能力 <button id="defaults-sync-btn" class="btn ghost small" style="margin-left:auto">检查并更新</button></h3>
-        <div id="defaults-body" aria-live="polite"><div class="skill-sub">检查中…</div></div>
-      </div>
-      <div class="card">
-        <h3>dsh 插件 <span class="muted">当前 profile 已安装的插件</span></h3>
+        <h3>dsh 插件 <span class="muted">当前 profile 已安装的插件</span>
+          <button id="defaults-sync-btn" class="btn ghost small" style="margin-left:auto" hidden>检查并更新</button>
+        </h3>
+        <div id="defaults-meta" aria-live="polite"></div>
+        <div id="defaults-plugins"></div>
         <div id="plugins-list"></div>
         <div class="hint" id="plugins-hint">受管技能和插件始终更新到最新发布版本；仅管理员停用后可卸载受管插件。</div>
       </div>
@@ -1551,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/lib/proc.js

@@ -288,7 +288,13 @@ export function scriptInvocation(resolved, args, {
   execPath = process.execPath,
 } = {}) {
   if (!/\.(?:mjs|cjs)$/i.test(String(resolved || ''))) return null;
-  if (runtime?.node) return { file: runtime.node, args: [resolved, ...args], env: {} };
+  if (runtime?.node) {
+    // Windows 的 node 启动器可能是 .cmd shim（runtime/bin/node.cmd 要求
+    // DSH_DESKTOP_NODE_EXECUTABLE 指向真实可执行文件，与
+    // desktopShimEnvDefaults 同一约定）；真实 node.exe 则无需任何变量
+    const env = /\.cmd$/i.test(runtime.node) ? { DSH_DESKTOP_NODE_EXECUTABLE: execPath } : {};
+    return { file: runtime.node, args: [resolved, ...args], env };
+  }
   if (electron) {
     return { file: execPath, args: [resolved, ...args], env: { ELECTRON_RUN_AS_NODE: '1' } };
   }
@@ -590,10 +596,14 @@ export async function runCliTool(tool, args, { timeoutMs = 300000, cwd, env, sig
 function missingCommandGuidance(tool) {
   if (tool === 'npm' || tool === 'npx') {
     // 触达这里的机器连桌面壳自带工具链都没有（scriptInvocation/兜底映射
-    // 均未命中）——重启通常能恢复探测，再给手动安装出路
+    // 均未命中）——重启通常能恢复探测，再给手动安装出路。社区桌面端
+    // （DSH Desktop/NEXT）与官方壳分开点名，避免指错重启对象
+    const brand = /DSH (?:Desktop|NEXT)\.(?:app|exe)/i.test(process.execPath)
+      ? 'DSH Desktop'
+      : 'DeepSeek Harness';
     return process.platform === 'win32'
-      ? '未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，请先从 https://nodejs.org 下载安装 Node.js（LTS 版，安装时保持默认选项），安装完成后重启 DeepSeek Harness 再点「安装」'
-      : '未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，且未探测到 DeepSeek Harness 自带的 Node 运行时。请重启 DeepSeek Harness 后重试；仍失败时安装 Node.js（推荐 nvm：nvm install --lts）后再点「安装」';
+      ? `未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，请先从 https://nodejs.org 下载安装 Node.js（LTS 版，安装时保持默认选项），安装完成后重启 ${brand} 再点「安装」`
+      : `未找到 npm/npx 命令：lark-cli 依赖 Node.js 环境，且未探测到 ${brand} 自带的 Node 运行时。请重启 ${brand} 后重试；仍失败时安装 Node.js（推荐 nvm：nvm install --lts）后再点「安装」`;
   }
   if (tool === 'pnpm') {
     return '未找到 pnpm 命令，无法查询插件最新版本。可安装 pnpm（npm install -g pnpm）后重启 DSH Desktop；不影响插件正常使用，仅影响升级提示。';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-agentone",
-  "version": "0.5.44",
-  "description": "AgentOne 平台集成：平台模型、SkillHub 技能、套餐与 CLI；无 Node 的 macOS 用桌面壳自带工具链装 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"
   ],