nx-kv 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -2,9 +2,44 @@
 
 本文件记录对外可见的变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。
 
+## [0.12.1] - 2026-10-30 key 归一化修复 + remote 对齐反馈
+
+### Fixed
+
+- **keyFromRemote 在 Linux 上多一个前导斜杠**：同一地址在「派生」（keyFromRemote）与
+  「归一」（normalizeKey）两条路上算出的 key 必须一致。Linux 的 `file:///tmp/x` 剥协议后
+  带前导斜杠，于是「派生」得 `/tmp/x`、「归一」得 `tmp/x` —— 同一份数据算出两个 key，
+  导入时参考关系直接连不上（「参考仓库不存在」）。Windows 上是盘符所以走不到这个分支，
+  只有 CI 红。keyFromRemote 的结果现在就规范化（它是「key 的来源」，不该产出非规范形态）。
+- **remote 对齐弹窗的「检查」点了像没反应**：git ls-remote 要几秒，期间界面毫无变化；
+  出错又被 toast 吞掉（一闪而过）。改成点击即显示「检查中…」，错误原因直接写进弹窗
+  （错误信息不该只活 3 秒）。
+
+### Changed
+
+- 并入三个工作树的成果：md-desc（关系改 key + 导入占位 + remote 对齐）、
+  sidebar-repo-boards（侧边栏改用仓库登记 + 看板）、fix-checkbox-width
+  （勾选框被 width:100% 撑满 → 选项列表看着一片空白）。
+
 ## [0.12.0] - 2026-10-30 仓库身份改用全局唯一 key + 导入导出重做
 
-### Added
+### Changed
+
+- **侧边栏不再自建一套「目录 + 分组」，改为直接用仓库登记与看板**。
+  以前侧边栏的「目录」是本地任务队列按 cwd 自动生成的主题，「分组」存在浏览器
+  localStorage 里（`prefs.groups` / `prefs.dirGroups`）——后者与仓库页的看板是
+  **两套互不相干的数据**：换浏览器分组就没了，改看板侧边栏也不知道。
+  现在：
+  - 目录行 = **仓库登记**里的开发仓库（带全局唯一 key、描述、路径）；
+  - 分组行 = **看板**（展开看成员），归属关系就是看板的成员表；
+  - 侧边栏只保留纯 UI 偏好：排序、隐藏、展开态、收起态（`prefs` 里的
+    `groups` / `dirGroups` 已废弃并在读取时从 localStorage 抹掉）；
+  - 行菜单改操作真实数据：「归入/移出看板」走 `board assign`，
+    「＋」菜单变成「登记仓库 / 新建看板」（原来建的是任务队列主题，不是仓库登记）；
+  - 拖拽只改顺序（显示态），归属一律走行菜单——拖拽不再写本地分组。
+- 仓库模块：看板成员从随机 id（`repoIds`）迁到 **key**（`repoKeys`），读时自动
+  迁移并落盘；绑定目标同样记 key；`keyFromRemote` 剥 `file://` URL 的盘符冒号
+  （否则 `normalizeKey` 会把 `:` 压成 `-`，导致「登记的是 A、成员表里是 B」）。
 
 - **内部关系全面改用 key（不再是随机 id）+ 导入分组的「本地未拥有」占位**：
   - **关系一律用 key**：看板成员存 `repoKeys`（不是 `repoIds`）、组内描述按 key、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-kv",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "nx-kv — KV 清单管理中枢（远程）+ 本机本地任务队列（localtask）：serve 驱动 CLI 与 Web 面板，同源同构，附带可安装 skill 供 agent 提交 / 领取 / 阻塞接收任务",
   "type": "module",
   "bin": {

package/src/modules/repos/service.js

@@ -57,11 +57,17 @@ export async function loadStore() {
     const raw = await fsp.readFile(storePath(), 'utf8');
     const data = JSON.parse(raw);
     if (!data || typeof data !== 'object') return emptyStore();
-    return {
+    const store = {
       version: 1,
       repos: Array.isArray(data.repos) ? data.repos : [],
       boards: Array.isArray(data.boards) ? data.boards : [],
     };
+    // 老结构（看板成员存随机 id）→ 新结构（存 key）：读时改写并落盘。
+    // 放这里 = 唯一入口，任何读路径都自动看到迁移后的数据。
+    if (migrateStoreKeys(store)) {
+      await saveStore(store).catch(() => {});
+    }
+    return store;
   } catch {
     /* 缺失或损坏 → 空 store */
     return emptyStore();
@@ -178,6 +184,9 @@ export function keyFromRemote(url) {
     s = s.replace(/^[a-z][a-z0-9+.-]*:\/\//i, '');
     s = s.replace(/^[^/]*@/, '');        // 丢 user@
     s = s.replace(/^([^/]+?):\d+(\/|$)/, '$1$2'); // 丢 :port（只认紧跟 host 的那个冒号）
+    // file:///D:/path 这类本地 URL：盘符冒号也要丢（key 里不允许 `:`——
+    // normalizeKey 会把它压成 -，两边不一致就会「登记的是 A、成员表里是 B」）
+    s = s.replace(/^([a-z]):/i, '$1');
   }
   s = s.replace(/\.git$/i, '');
   s = s.replace(/\/{2,}/g, '/');
@@ -187,6 +196,10 @@ export function keyFromRemote(url) {
     const host = s.slice(0, slash).toLowerCase();
     s = (hostAlias[host] || host) + s.slice(slash);
   }
+  // 去首尾斜杠：file:///tmp/x 剥协议后是 "/tmp/x"，带前导斜杠的话同一份数据在
+  // 「派生」与「归一」两条路上会算出不同的 key（/tmp/x vs tmp/x）——
+  // 表现为「登记的是 A、成员表里是 B」，关系连不上。
+  s = s.replace(/^\/+|\/+$/g, '');
   return s.toLowerCase();
 }
 
@@ -264,6 +277,26 @@ export function boardRepoKeys(board, store) {
   return out;
 }
 
+/**
+ * 老结构（board.repoIds）→ 新结构（board.repoKeys）的一次性**落盘**迁移。
+ *
+ * boardRepoKeys 的兼容读解决「迁移前也能看清单」，但盘上还是老结构：
+ * 每次读都现算，而且仓库登记一变（改名/换 remote），key 就跟着变，
+ * 与别处按 key 存的关系对不上。所以读的时候顺手把新结构写回去（幂等）。
+ */
+export function migrateStoreKeys(store) {
+  if (!store || !Array.isArray(store.boards)) return false;
+  let changed = false;
+  for (const b of store.boards) {
+    if (Array.isArray(b.repoKeys)) continue; // 已是新结构
+    const ids = Array.isArray(b.repoIds) ? b.repoIds : [];
+    b.repoKeys = ids.length ? boardRepoKeys(b, store) : [];
+    delete b.repoIds;
+    changed = true;
+  }
+  return changed;
+}
+
 /**
  * **中心清单**：一份扁平的仓库列表（按名称排序），每条带它所属的看板。
  *

package/src/modules/repos/view.jsx

@@ -310,11 +310,27 @@ export default function ReposView() {
     toast('已对齐 remote');
     await Promise.all([loadRepos(), loadRefCheck()]);
   });
-  const checkRemote = (url) => guard(async () => {
-    const d = await api('/api/repos/remote/check?id=' + encodeURIComponent(remoteInfo.key)
-      + (url ? '&url=' + encodeURIComponent(url) : ''));
-    setRemoteCheck(d);
-  });
+  // 存在性检查：git ls-remote 要几秒，期间不给任何反馈会像「点了没反应」。
+  // 错误直接写进弹窗（remoteCheck.detail），不靠 toast —— toast 会一闪而过。
+  const checkRemote = async (url) => {
+    const key = remoteInfo ? remoteInfo.key : '';
+    if (!key) {
+      setRemoteCheck({ url: '', status: 'unreachable', detail: '没有仓库标识' });
+      return;
+    }
+    setRemoteCheck({ url: url || remoteInfo.current || '', status: 'checking', detail: '检查中…' });
+    try {
+      const d = await api('/api/repos/remote/check?id=' + encodeURIComponent(key)
+        + (url ? '&url=' + encodeURIComponent(url) : ''));
+      setRemoteCheck(d);
+    } catch (e) {
+      setRemoteCheck({
+        url: url || remoteInfo.current || '',
+        status: 'unreachable',
+        detail: String((e && e.message) || e),
+      });
+    }
+  };
 
 
   // 组内描述保存：note 为空 = 清除
@@ -1291,8 +1307,11 @@ export default function ReposView() {
               <div className="form-field">
                 <label>存在性检查</label>
                 <div className="rp-remote-check">
-                  <span className={'rp-status ' + (remoteCheck.status === 'exists' ? 'same' : remoteCheck.status === 'missing' ? 'new' : 'missing')}>
-                    {remoteCheck.status === 'exists' ? '存在' : remoteCheck.status === 'missing' ? '不存在' : '不可达'}
+                  <span className={'rp-status ' + (remoteCheck.status === 'exists' ? 'same' : remoteCheck.status === 'missing' ? 'new' : remoteCheck.status === 'checking' ? 'checking' : 'missing')}>
+                    {remoteCheck.status === 'exists' ? '存在'
+                      : remoteCheck.status === 'missing' ? '不存在'
+                      : remoteCheck.status === 'checking' ? '检查中'
+                      : '不可达'}
                   </span>
                   <span className="mono rp-remote-url">{remoteCheck.url}</span>
                   <span className="muted">{remoteCheck.detail}</span>

package/src/web/frontend/App.jsx

@@ -100,6 +100,27 @@ export default function App() {
     return () => clearInterval(t);
   }, [refreshLocal]);
 
+  // ─── 仓库与看板：侧边栏的**唯一数据源** ───
+  // 侧边栏的「目录」= 仓库登记，「分组」= 看板。以前侧边栏自己维护一套
+  // localStorage 分组，与仓库页的看板互不相干——那才是两套数据。
+  const [repoData, setRepoData] = useState({ repos: [], boards: [] });
+  const refreshRepos = useCallback(async () => {
+    try {
+      const [repos, boards] = await Promise.all([api('/api/repos'), api('/api/boards')]);
+      setRepoData({
+        repos: (repos || []).filter((r) => (r.type || 'dev') !== 'ref'), // 参考仓库不进侧边栏
+        boards: (boards && boards.boards) || [],
+      });
+    } catch {
+      /* 读失败：保留旧数据，侧边栏仍可用 */
+    }
+  }, []);
+  useEffect(() => {
+    refreshRepos();
+    const t = setInterval(refreshRepos, 30_000);
+    return () => clearInterval(t);
+  }, [refreshRepos]);
+
   // ─── 等待回填提醒（沿用 v1：presence 轮询，用户停在任意页都要知道）───
   useEffect(() => {
     let stopped = false;
@@ -139,16 +160,18 @@ export default function App() {
       {prefs.folded ? (
         <Rail
           route={route} onNavigate={onNavigate} prefs={prefs} patchPrefs={patchPrefs}
-          rows={rows} waitingCount={waitingCount} boot={boot}
+          repos={repoData.repos} rows={rows} waitingCount={waitingCount} boot={boot}
         />
       ) : (
         <>
           {/* 窄屏（≤900px）侧栏浮层化后的点外收起遮罩；宽屏 display:none 不参与 */}
           <div className="side-scrim" onClick={() => patchPrefs({ folded: true })} aria-hidden="true" />
           <Sidebar
-            topics={rows} route={route} onNavigate={onNavigate}
+            repos={repoData.repos} boards={repoData.boards} topics={rows}
+            route={route} onNavigate={onNavigate}
             boot={boot} waitingCount={waitingCount}
-            prefs={prefs} patchPrefs={patchPrefs} refreshLocal={refreshLocal}
+            prefs={prefs} patchPrefs={patchPrefs}
+            refreshRepos={refreshRepos}
           />
         </>
       )}
@@ -196,8 +219,21 @@ function GlobalEntry({ rows, refreshLocal, boot, onNavigate }) {
 }
 
 // 收起态 rail：52px 图标条，悬停气泡显示名称，徽标仍在（原型 §2/§3）
-function Rail({ route, onNavigate, patchPrefs, rows, waitingCount, boot }) {
-  const dirs = rows.filter((r) => !r.isGlobal).slice(0, 9);
+function Rail({ route, onNavigate, patchPrefs, repos, rows, waitingCount, boot }) {
+  // 目录 = 仓库登记（与展开态同一份数据）；待领取数从队列按仓库汇总
+  const pendingOf = new Map();
+  const topicKeyOf = new Map();
+  for (const t of rows) {
+    if (t.isGlobal || !t.repo) continue;
+    pendingOf.set(t.repo.id, (pendingOf.get(t.repo.id) || 0) + (t.pending || 0));
+    if (!topicKeyOf.has(t.repo.id)) topicKeyOf.set(t.repo.id, t.key);
+  }
+  const dirs = (repos || []).slice(0, 9).map((r) => ({
+    key: topicKeyOf.get(r.id) || r.key || r.id,
+    name: r.name,
+    pending: pendingOf.get(r.id) || 0,
+    waiting: (rows || []).some((t) => t.repo && t.repo.id === r.id && t.waiting),
+  }));
   const globalRow = rows.find((r) => r.isGlobal);
   const btn = (active, tip, onClick, icon, badge, dot, key) => (
     <button

package/src/web/frontend/components/sidebar/drag.js

@@ -1,11 +1,13 @@
 // 侧边栏拖拽落点判定（纯函数）——三段式落点，吸收自 nx-ft：
 //   行上缘 30% = before（排到它前面，指示线）
 //   行下缘 30% = after （排到它后面，指示线）
-//   中段      = into （移入该分组，仅分组行接受，描边；目录行中段不作落点——
-//                      没有「目录套目录」，不给假提示）
+//   中段      = into （移入该看板，仅看板行接受，描边；仓库行中段不作落点——
+//                      没有「仓库套仓库」，不给假提示）
 //   树空白处  = tail （拖到末尾）
-// canDropInto 守卫：不能把分组放进自己的子树（这里没有子树，守卫退化为
-// 「不能放进自己」+ 目标类型检查）。
+//
+// **拖拽只改顺序，不改归属**：归属是数据（看板成员表），由行菜单里的
+// 「归入/移出看板」改；拖拽是显示态（prefs.order）。以前拖进「分组」会写
+// prefs.dirGroups —— 那套本地分组已经废弃，看板才是唯一归属。
 
 export function zoneOf(e, rowEl) {
   const r = rowEl.getBoundingClientRect();
@@ -18,21 +20,21 @@ export function zoneOf(e, rowEl) {
 
 export function canDrop(drag, target, zone) {
   if (!drag) return false;
-  if (drag.type === 'dir') {
-    if (target.type === 'group') return zone === 'into'; // 目录→分组：仅入组
-    if (target.type === 'dir') return zone === 'before' || zone === 'after'; // 排序
+  if (drag.type === 'repo') {
+    if (target.type === 'board') return zone === 'into'; // 仓库→看板：仅入组（拖拽仅排序，不改归属，见文件头）
+    if (target.type === 'repo') return zone === 'before' || zone === 'after'; // 排序
     return false;
   }
-  if (drag.type === 'group') {
-    if (target.type === 'group') return target.id !== drag.id && (zone === 'before' || zone === 'after');
-    return false; // 分组不进目录、不进树尾之外的位置
+  if (drag.type === 'board') {
+    if (target.type === 'board') return target.id !== drag.id && (zone === 'before' || zone === 'after');
+    return false; // 看板不进仓库行
   }
   return false;
 }
 
 // 拖拽文案（跟随提示）
 export function dropLabel(drag, target, zone) {
-  if (target.type === 'group' && zone === 'into') return `移入分组「${target.name}」`;
+  if (target.type === 'board' && zone === 'into') return `归入看板「${target.name}」`;
   const name = target.name || '';
   if (zone === 'before') return `排到「${name}」之前`;
   if (zone === 'after') return `排到「${name}」之后`;
@@ -42,40 +44,27 @@ export function dropLabel(drag, target, zone) {
 
 /**
  * 把落点应用到偏好（纯函数，返回 patch 片段）。
- * @returns {{order?, groups?, dirGroups?}} 需要合并进 prefs 的字段
+ * 只回 {order} —— 排序是显示态；归属不动（那是数据，走行菜单）。
  */
 export function applyDrop(prefs, drag, target, zone) {
-  const dirGroupOf = (key) => (prefs.dirGroups || {})[key] || '';
+  const order = [...(prefs.order || [])];
+  const keyOf = (r) => (r.type === 'board' ? 'board:' + r.id : r.key);
 
-  if (drag.type === 'dir') {
-    const dirGroups = { ...(prefs.dirGroups || {}) };
-    if (target.type === 'group' && zone === 'into') {
-      dirGroups[drag.key] = target.id;
-      return { dirGroups };
-    }
-    // 排序：重建顶层 order（组内序由 order 里的相对位置决定，分组归属不变）
-    if (target.type === 'dir') {
-      dirGroups[drag.key] = target.groupId ?? dirGroupOf(target.key);
-      const others = collectDirKeys(prefs).filter((k) => k !== drag.key);
-      const at = others.indexOf(target.key);
-      const order = others.slice();
-      order.splice(zone === 'before' ? Math.max(0, at) : at + 1, 0, drag.key);
-      return { order, dirGroups };
-    }
+  if (drag.type === 'repo' && target.type === 'repo') {
+    const others = order.filter((k) => k !== keyOf(drag));
+    const at = others.indexOf(keyOf(target));
+    if (at < 0) return { order };
+    others.splice(zone === 'before' ? at : at + 1, 0, keyOf(drag));
+    return { order: others };
   }
 
-  if (drag.type === 'group' && target.type === 'group') {
-    const ids = (prefs.groups || []).map((g) => g.id).filter((id) => id !== drag.id);
-    const at = ids.indexOf(target.key || target.id);
-    ids.splice(zone === 'before' ? Math.max(0, at) : at + 1, 0, drag.id);
-    const byId = new Map((prefs.groups || []).map((g) => [g.id, g]));
-    return { groups: ids.map((id) => byId.get(id)).filter(Boolean) };
+  if (drag.type === 'board' && target.type === 'board') {
+    const others = order.filter((k) => k !== keyOf(drag));
+    const at = others.indexOf(keyOf(target));
+    if (at < 0) return { order };
+    others.splice(zone === 'before' ? at : at + 1, 0, keyOf(drag));
+    return { order: others };
   }
-  return {};
-}
 
-// 顶层编排序里的全部目录 key（按当前分组展开序）
-function collectDirKeys(prefs) {
-  // order 只存目录 key（applyOrder 用）；分组归属不影响相对顺序的重建
-  return [...(prefs.order || [])];
+  return {};
 }

package/src/web/frontend/components/sidebar/index.jsx

@@ -1,6 +1,9 @@
-// 侧边栏（应用壳的左栏）：品牌区 + 搜索 + 树（全局池恒顶 → 分组 → 目录）+ 底部入口。
+// 侧边栏（应用壳的左栏）：品牌区 + 搜索 + 树（全局池恒顶 → 看板 → 仓库）+ 底部入口。
 // 收起态渲染为 52px 图标 rail（悬停气泡、徽标仍在）。
 // 拖拽编排 = 三段式落点（drag.js）；可见序 = 渲染序，键盘导航走同一份扁平序。
+//
+// **数据源**：仓库登记 + 看板（真实数据，见 model.js）。侧边栏不持有自己的分组体系，
+// 也不持有自己的目录清单——「目录」就是仓库登记里的开发仓库。
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Icon } from '../icons.jsx';
 import { PopMenu } from '../overlay.jsx';
@@ -11,37 +14,39 @@ import { rowMenuItems, addMenuItems, cfgMenuItems } from './row-menu.jsx';
 import TaskChildren from './task-children.jsx';
 
 export default function Sidebar({
-  topics,          // mergeDirectoryRows+withGlobalRow 产物（含 isGlobal 行）
+  repos,           // 开发仓库（type != ref）
+  boards,          // 看板
+  topics,          // 本机任务队列（按 cwd 匹配仓库）
   route,           // {view, key}
   onNavigate,      // (hash) => void
   boot,
   waitingCount,
   prefs,
   patchPrefs,      // (patch) => void（已持久化）
-  refreshLocal,    // 添加目录后刷新数据
+  refreshRepos,    // 仓库/看板刷新（登记、归属变更后）
 }) {
   const toast = useToast();
   const { dialog, node: dialogNode } = useDialog();
   const [kw, setKw] = useState('');
   const [menu, setMenu] = useState(null);      // {x,y,items}
   const [kbIndex, setKbIndex] = useState(-1);  // 键盘焦点行
-  const [expanded, setExpanded] = useState(() => new Set()); // 展开子行的目录 key
+  const [expanded, setExpanded] = useState(() => new Set()); // 展开子行的仓库 key
   const dragRef = useRef(null);                // {type,key|id,name}
   const [dropHint, setDropHint] = useState(null); // {key|id, zone}
   const treeRef = useRef(null);
 
   const { rows, matchCount } = useMemo(
-    () => buildTree(topics, prefs, kw),
-    [topics, prefs, kw]
+    () => buildTree(repos, boards, topics, prefs, kw),
+    [repos, boards, topics, prefs, kw]
   );
 
   const isActive = (row) => {
     if (row.type === 'global') return route.view === 'global';
-    if (row.type === 'dir') return route.view === 'dir' && route.key === row.key;
+    if (row.type === 'repo') return route.view === 'dir' && route.key === row.topicKey;
     return false;
   };
 
-  // 当前路由所在目录自动展开子行（深链 / 总览跳转进来也能看到层级）
+  // 当前路由所在仓库自动展开子行（深链 / 总览跳转进来也能看到层级）
   useEffect(() => {
     if (route.view !== 'dir' || !route.key) return;
     setExpanded((prev) => {
@@ -61,15 +66,16 @@ export default function Sidebar({
     });
   }, []);
 
-  // 点击目录 = 展开/收起子行（不再跳工作台）；打开页面走子行，工作台全屏编辑只在具体页面上
+  // 点击：看板 = 展开/收起成员；仓库 = 展开/收起子行（任务）；全局 = 进全局池。
+  // 仓库行没有任务队列时（topicKey 为空）点击不导航——没有可打开的工作台。
   const openRow = useCallback(
     (row) => {
-      if (row.type === 'group') {
+      if (row.type === 'board') {
         patchPrefs((p) => ({ groupOpen: { ...(p.groupOpen || {}), [row.id]: !row.open } }));
       } else if (row.type === 'global') {
         onNavigate('#/global');
       } else {
-        toggleExpanded(row.key);
+        toggleExpanded(row.topicKey || row.key);
       }
     },
     [onNavigate, patchPrefs, toggleExpanded]
@@ -135,10 +141,11 @@ export default function Sidebar({
     const drag = dragRef.current;
     dragRef.current = null;
     setDropHint(null);
-    if (!drag || drag.type !== 'dir') return;
+    if (!drag || drag.type !== 'repo') return;
     e.preventDefault();
-    const order = (prefs.order || []).filter((k) => k !== drag.key);
-    order.push(drag.key);
+    const key = drag.key;
+    const order = (prefs.order || []).filter((k) => k !== key);
+    order.push(key);
     patchPrefs({ order });
   };
 
@@ -146,22 +153,16 @@ export default function Sidebar({
   const openRowMenu = (e, row) => {
     e.preventDefault();
     e.stopPropagation();
-    setMenu({ x: e.clientX, y: e.clientY, items: rowMenuItems({ row, prefs, patchPrefs, onNavigate, dialog, newGroup }) });
+    setMenu({
+      x: e.clientX,
+      y: e.clientY,
+      items: rowMenuItems({ row, prefs, patchPrefs, onNavigate, boards, onDataChanged: refreshRepos }),
+    });
   };
 
-  // ─── 添加目录 / 新建分组 ───
+  // ─── 登记仓库 / 新建看板 ───
   const addMenu = (e) => {
-    setMenu({ x: e.clientX, y: e.clientY, items: addMenuItems({ dialog, toast, refreshLocal, newGroup }) });
-  };
-  const newGroup = async (moveKey) => {
-    const name = await dialog({ title: '新建分组', input: true, placeholder: '分组名' });
-    if (!name) return;
-    const id = 'g' + Date.now().toString(36);
-    patchPrefs((p) => {
-      const patch = { groups: [...(p.groups || []), { id, name }] };
-      if (moveKey) patch.dirGroups = { ...(p.dirGroups || {}), [moveKey]: id };
-      return patch;
-    });
+    setMenu({ x: e.clientX, y: e.clientY, items: addMenuItems({ dialog, toast, onDataChanged: refreshRepos }) });
   };
 
   // ─── 设置气泡 ───
@@ -204,7 +205,7 @@ export default function Sidebar({
             <Icon name="search" />
             <input
               value={kw}
-              placeholder="搜索目录（命中自动展开）"
+              placeholder="搜索仓库（命中自动展开）"
               onChange={(e) => setKw(e.target.value)}
               onKeyDown={(e) => { if (e.key === 'Escape') setKw(''); }}
             />
@@ -221,13 +222,13 @@ export default function Sidebar({
         ref={treeRef}
         tabIndex={0}
         onKeyDown={onTreeKey}
-        onDragOver={(e) => { if (dragRef.current?.type === 'dir') e.preventDefault(); }}
+        onDragOver={(e) => { if (dragRef.current?.type === 'repo') e.preventDefault(); }}
         onDrop={onTreeDropTail}
       >
         {rows.map((row, i) => (
-          row.type === 'group' ? (
+          row.type === 'board' ? (
             <button
-              key={'g:' + row.id}
+              key={'b:' + row.id}
               className={'trow group' + (row.open ? ' open' : '') + (kbIndex === i ? ' kb-focus' : '')}
               onClick={() => openRow(row)}
               onContextMenu={(e) => openRowMenu(e, row)}
@@ -238,13 +239,14 @@ export default function Sidebar({
               onDragLeave={onDragLeave}
               onDrop={(e) => onDrop(e, row)}
               data-drop={dropHint?.id === row.id ? dropHint.zone : undefined}
+              title={row.desc || row.name}
             >
               <span className="tw"><Icon name="chevron" size={10} /></span>
               <span className="gico"><Icon name="folder" /></span>
               <span className="nm">{row.name}</span>
               <span className="cnt">{row.count}</span>
               <span
-                className="more" role="button" tabIndex={-1} aria-label="分组菜单"
+                className="more" role="button" tabIndex={-1} aria-label="看板菜单"
                 onClick={(e) => openRowMenu(e, { ...row, open: row.open })}
               >
                 <Icon name="dots" size={13} />
@@ -254,15 +256,15 @@ export default function Sidebar({
             <div key={row.type + ':' + row.key} className="tblock">
               <button
                 className={
-                  'trow' + (row.type === 'dir' && row.groupId ? ' child' : '') +
-                  (row.type === 'dir' && expanded.has(row.key) ? ' open' : '') +
+                  'trow' + (row.type === 'repo' && row.groupId ? ' child' : '') +
+                  (row.type === 'repo' && expanded.has(row.topicKey) ? ' open' : '') +
                   (isActive(row) ? ' active' : '') +
                   (row.pending > 0 ? ' pinned' : '') +
                   (kbIndex === i ? ' kb-focus' : '')
                 }
                 onClick={() => openRow(row)}
                 onContextMenu={(e) => openRowMenu(e, row)}
-                title={row.cwd ? `${row.cwd}\n${row.summary || ''}` : row.name}
+                title={row.cwd ? `${row.name}\n${row.cwd}\n${row.desc || row.summary || ''}` : row.name}
                 draggable
                 onDragStart={(e) => onDragStart(e, row)}
                 onDragEnd={onDragEnd}
@@ -278,7 +280,7 @@ export default function Sidebar({
                   {row.type === 'global' && row.waiting ? <span className="wdot" title="有等待中的主题" /> : null}
                 </span>
                 {row.pending > 0 && <span className="cnt">{row.pending}</span>}
-                {row.type === 'dir' && row.waiting && <span className="wdot" title="agent 等待回填中" />}
+                {row.type === 'repo' && row.waiting && <span className="wdot" title="agent 等待回填中" />}
                 <span
                   className="more" role="button" tabIndex={-1} aria-label="行菜单"
                   onClick={(e) => openRowMenu(e, row)}
@@ -286,13 +288,13 @@ export default function Sidebar({
                   <Icon name="dots" size={13} />
                 </span>
               </button>
-              {(row.type === 'global' ? isActive(row) : expanded.has(row.key)) && (
+              {(row.type === 'global' ? isActive(row) : expanded.has(row.topicKey)) && (
                 <TaskChildren row={row} onNavigate={onNavigate} />
               )}
             </div>
           )
         ))}
-        {!rows.length && <div className="tree-empty">{kw ? '没有匹配的目录' : '暂无目录：点右上 ＋ 添加'}</div>}
+        {!rows.length && <div className="tree-empty">{kw ? '没有匹配的仓库' : '还没有登记仓库：点右上 ＋ 登记，或去「仓库管理」'}</div>}
         <div className="droptail" aria-hidden="true" />
       </div>