diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index 5d2035d..a66caa3 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -140,7 +140,19 @@ $installed = "C:\Users\qyh15\.dsh\profiles\desktop\node_modules\@dsh-xhl\workspa 挂路由 → 客户端照 `tab-persist.ts` 的 `fetch` 封装去调,注意 `Cache-Control: no-store`。 - **加标签条行为**:状态变换进 `tabs.ts`(纯),store 绑定在 `tab-store.ts`, 渲染在 `SessionTabs.tsx`,落盘走 `tab-persist.ts`;位置模型是「首次入列时定序」, - 改动前先读 `tabs.ts` 顶部的 position model 注释。 + 改动前先读 `tabs.ts` 顶部的 position model 注释。两条不变量:**固定标签恒在未固定 + 之前**(`moveTab` 在固定区边界夹紧、`togglePinTab` 插到固定区尾/未固定区头), + **标签名与会话标题互不影响**(`renameTab` 只动 `title`)。除 `order` 之外的标签状态 + (固定、自定义名)也必须由 `restoreTabsImpl` 原样复原,否则每次重启都丢配置。 +- **加一个分组展示元数据(颜色 / 图标 / 置顶等)**:字段进 `types.ts` + (`CategoryAppearance` + `GROUP_COLORS`/`GROUP_ICON_IDS` 白名单)→ 校验进 + `host-manual.ts` 的 `parseAppearance`(**严格写、宽容读**:不校验键对应的分类是否 + 还存在,否则删掉一条 YAML 分类就会让之后每次保存都 400)→ 派生进 `matcher.ts` + (要影响排序就必须放 `effectiveCategories`,只在渲染层排会让拖拽落点与看到的顺序 + 不一致)→ `tree.ts` 节点带 `appearance` → `rows.tsx` 渲染 → `styles.css` 配色/ + 动画 → `locales.ts` 双语文案。写路径统一走 + `GroupsBrowser.tsx` 的 `updateCategoryAppearance`;**改名要重映射 `appearance` 的键、 + 删除要清掉**(键空间是 display name,与 `categoryOrder` 一致)。 - **新增平台依赖**:先确认 DSH shell 的 module table 真有那一行,再往 `CLIENT_EXTERNALS` 里加,否则运行时 `require` 会拿不到模块。 @@ -149,7 +161,11 @@ $installed = "C:\Users\qyh15\.dsh\profiles\desktop\node_modules\@dsh-xhl\workspa - **沙箱内跑不了 vitest**:`spawn` 被 DSH 沙箱拦(EPERM),在普通 PowerShell 终端里跑。 - **`node_modules/.bin/*.CMD` 直调会挂**:pnpm 里嵌套的 pnpm 脚本在 DSH 沙箱下会 `Could not determine executable`,统一用 `node