figmar/apes-sidebar
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
765 Commits 6 Branches 43 Tags
73dead127f79b032e7ff29b6eb8eae1f8ec03cd2
Commit Graph
5 Commits
Author SHA1 Message Date
Menghuan1918 52be73e176 test(zip): 让两条断言平台正确，修 ci-windows 红 
ci-windows（首次在本分支跑）报 tests/zip.spec.ts 两条失败，均为**测试可移植性**问题，不是产品缺陷：

1. 「keeps a backslash as part of the file name (POSIX names are literal)」：
   Windows 上反斜杠就是路径分隔符，join(root, 'a\b.txt') 得到 root\a\b.txt，父目录不存在 →
   writeFileSync 报 ENOENT。该语义在 Windows 上根本不存在 → 按仓库既有约定
   it.skipIf(isWin32) 跳过，并在注释里写明理由。
2. 「passes unzip -t when the binary exists」：断言 outMode === inMode & 0o644 在 Windows 上
   无意义（两边 statSync().mode 都是 0o666 → expected 420, received 438）。CRC 与解压断言保留，
   只把 mode 一致性放进 !isWin32 分支。

本地：tests/zip.spec.ts 37/37 通过；全量 typecheck / lint / test 绿（137 文件 / 1491 通过）。
 2026-09-28 23:21:06 +08:00
Menghuan1918 5c95002641 perf(sidebar): fs.tree 22.8ms→3.8ms + 删除工作区路径检测（放开权限）+ 树展开状态按会话 
用户实测反馈：

1) `/sidebar/api/fs.tree` 性能极差 —— 先测后改（10k 条目目录、热缓存、中位数）：
   - 冷调用 cap=1000：22.76ms → **3.77ms**；TTL 内重复：≈23ms → **0.000ms**
   - 改法：opendir for-await → readdir(withFileTypes) 一次取回；只为 cap 条建行
     （slice + 定长数组）；路径用字符串拼接而非 path.join；排序弃 localeCompare
     （14.6ms/10k → 0.35ms）改小写比较 + 原名码点兜底；新增 1.5s 目录级缓存
     （键 绝对路径\0cap，上限 512），由 fs.write/rename/remove/mkdir/upload 与
     fs-watch 的变更通知显式失效
   - 契约逐字不变；新增 tests/fs-tree.spec.ts 6 例 + fs-watch 失效用例（判别性验证）

2) 删除工作区路径检测（默认不检测、放开权限）：
   - path-security 变纯词法解析（realpath/包含性判定删除）、fs-operations 去 fence
     分支、所有 fs 路由不再读 fence、403 分支消失、config 删 workspaceFence 字段
     （schemastery 容忍未知键，旧 profile 不会加载失败）、settings 开关删除
   - ⚠️ 安全影响：插件 fs 路由（tree/read/write/rename/remove/mkdir/媒体/HTML/
     upload/archive）现在可读写宿主用户可访问的任意路径，只受 OS 权限约束；
     指南 §8.1 已加醒目声明
   - 死代码清理：FenceErrorNotice 组件 + EditorHost 分支 + 4 个词条（settingsFence*、
     fenceErrorReason、fenceDisableAction）+ isOutsideWorkspace* 助手 + TreePanel 的
     store prop + 相关 CSS 块

3) 批量列举路由 `fs.trees`（单层失败只在该层带 error）+ 客户端批量加载：
   挂载/刷新时的 N+1 请求变为 1 个（8 个展开目录：9 → 1，探针断言）
   refreshTick 不再先清缓存（旧行保留到新答案；失败保留旧行 + warn 提示）

4) 修复「关闭文件后返回文件树，展开状态被重置」：
   原生承载面的展开集合原来存在每个 tab 的记录里（drop 即丢），改为**每会话状态**
   的投影（ensure 从会话态读、toggleExpanded 写回会话态、registerNativeSurface 用
   attachStore 订阅）；同一会话多 tab 共享、不同会话隔离；revealed 保持 per-tab

验证：typecheck / lint / test（136 文件 / 1484 通过 / 9 跳过）/ build 全绿；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.1.7-rc.1 dsh' pnpm test:mount 7/7 通过；
版本镜像同步（dsh.plugin.json + SIDEBAR_SERVICE_VERSION）
 2026-09-28 20:37:56 +08:00
Menghuan1918 ee1fe05067 feat(sidebar): 菜单层级/性能 + 选中条吸底 + 打包进度 + 修复「在侧边打开」 
用户实测反馈 5 条：

1) 文件列表性能 / 右键菜单不再刷屏（先测量后改，探针 tests/file-tree-menu-perf.spec.tsx）
   - 宿主应用列表按路径缓存：N 次打开菜单只请求 1 次（原每次 1 次 + Loading 帧）
   - 行上的 git 数据改为原始值（tone/letter）：共享 store 每次轮询重建对象不再触达行
     （探针：开窗 folderIcons 4 → 0；root 行也 memo 化）
   - 菜单开关不触发目录重列（fsTree=0）；实测「菜单打开期间暂停轮询」会让变更行瞬时
     掉色并多两次重渲染，故按测量结果放弃该做法（数字与理由写进探针注释）

2) 「已选择 N 项」条移到底部：滚动容器最后一个内容子节点 + sticky bottom（不遮最后
   一行），窄栏 flex-wrap 换行不出横向滚动条

3) 菜单层级重构：一级只留默认动作（宿主默认应用 / 打开方式 ▸ / 在文件管理器中显示 /
   新 Tab / 在侧边打开 / 下载 / 压缩并下载 / 复制路径 / 重命名 / 删除；目录行另有
   新建文件夹、上传到此处），应用列表整体收进「打开方式」子菜单；宿主探测到本机关联
   应用时默认不显示插件自研 open-with 项目，新增设置开关 openWithPluginTargets
   （editor descriptor 的 pluginToggles）可强制并存；宿主不可用时插件项目照旧

4) 压缩并下载显示进度：宿主改为可观测任务（archive.build / archive.status /
   /sidebar/archive?id=，4 并发 + 5 分钟 TTL + sessionId 绑定，buildZip 逐条目
   onProgress），客户端轮询 250ms 显示「正在打包 done/total · N%」，ready 后 blob 下载，
   失败进 zipFailed

5) 修复「在侧边打开没有效果」：根因是它只写插件底部工作台（原生右侧栏的 tab 不在
   bottomSplits 里），现按承载面分流 —— 原生 tab 走 service.openTab(target:'side') →
   宿主 openResource(preferNewPane, revealIfOpened:false) 真正分栏；底部工作台行为不变
   （接入 API 变更已同步 docs/external-plugin-guide.md）

验证：typecheck / lint / test（135 文件 1461 通过）/ build 全绿；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.1.7-rc.1 dsh' pnpm test:mount 7/7 通过；
新增/更新测试：menu-perf(3)、archive(10)、open-in-app(18)、open-with(10)、multiselect(9)、
zip(37)、service(64)、editor-host(11)、builtins(23)、locales(20)
 2026-09-28 20:11:46 +08:00
Menghuan1918 13d4bae321 fix(sidebar): 二轮独立验证的 9 项缺陷 + 目录级暂存 
verifier 二轮报告（F1–F9）全部修复，每条都有「临时回退即变红」的判别性验证：

- F1【高】中文等非 latin1 下载名 → 真实宿主 500：content-disposition 改用
  RFC 5987（ASCII 回退 + filename*=UTF-8''）；补真 node:http 用例与根因对照断言
- F2【中】多选同名文件归档重名（解压互相覆盖）：冲突项逐级上溯父目录消歧
- F3【中低】maxBytes 在读完之后才判定；budget<=0 的 0 字节 FIFO 会永久阻塞：
  改为先 stat、读取前拒绝（FIFO 探针验证）
- F4【中低】SSH 模式 + 宿主不可用时 reveal 整条消失：保留 kind==='reveal' 目标
- F5【低】图钉嵌套交互语义非法且键盘不可达：改为诚实的鼠标热区，键盘入口归设置面板
- F6【低】变更树空闲 tick 全量重渲染：行 memo + 恒定 props + 内容键派生 +
  共享 store 的 sameStatus 保住快照身份
- F7【低】排序随运行时 locale 漂移：显式 'en' collation + 码点兜底
- F8【低】POSIX 文件名的反斜杠被当成层级：不再替换
- F9【低】打包中重复点击静默、无反馈：busy 行（role=status）+ in-flight 守卫
- 新增：目录行「暂存/取消暂存该目录」（git pathspec 语义，不触发折叠）

验证：typecheck / lint / test（134 文件 1441 通过）/ build 全绿；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.1.7-rc.1 dsh' pnpm test:mount 7/7 通过
 2026-09-28 18:20:08 +08:00
Menghuan1918 b011be1e98 feat(sidebar): 打开方式双源并存 + 多选压缩下载 + 文件变动层级树 
用户追加三条需求，全部落地：

1) 打开方式 = 宿主探测应用 + 插件自研 open-with（并存）
- 逐字恢复 src/client/open-with.ts / open-with-settings.tsx / plugin-settings.ts /
  src/open-external.ts / open.external 路由 / api.openExternal / editor descriptor
  的 settings.render，以及 20 个 openWith* 词条（19 份词典从 main 取回原文）
- 恢复 menu-flip.ts + layout.css 子菜单翻转规则（子菜单回来了）
- FileTree 菜单段（无标题行）：宿主行 → 分隔线 → 插件 pinned + 「在应用中打开 >」
  子菜单（图钉 / SSH 后缀原样）→ 分隔线 → 宿主 reveal；宿主可用时过滤插件
  explorer 目标，宿主不可用时插件行照旧（SSH 远端场景保持可用）
- 死键清理：菜单去掉标题行后 openInApp 词条无引用，已从 21 份词典删除

2) 文件页多选右键「压缩并打包下载」
- 新增 src/zip.ts（自研 ZIP：方法 0/8 按收益二选一、UTF-8 bit 11、目录条目、
  自实现 CRC32、无第三方依赖）+ src/archive-route.ts（名净化 + 递归收集）+
  GET /sidebar/archive（同一道 workspace fence、目录递归跳过符号链接、
  10000 条目 / 256 MiB 上限）+ api.archiveUrl
- FileTree：多选 ≥2 项或单选目录时出现；fetch → blob → objectURL 下载，
  路由错误（超限 / fence / 非 GET）以 zipFailed 显示在错误条
- 修掉真实缺陷：central directory 只写 MS-DOS 位而 version-made-by 声称 Unix，
  Info-ZIP 会把每个文件解成 mode 000；改为 Unix 语义（0o100644 * 0x10000，
  << 16 会溢出 int32）。系统 unzip 复验：mode 644/755、unzip -t 无错

3) 文件变动页层级树 + 视觉打磨
- 新增 src/client/changes/change-tree.ts：单子目录链压缩成一行、目录先于文件、
  大小写不敏感排序、文件带 GitFileStatus、目录带下级变更数
- GitLens 两组各自渲染树：折叠状态按「组+路径」独立、默认展开；分组头吸顶 +
  计数胶囊；Stage all/Unstage all 改为带 aria-label 的 IconButton；选中 =
  interactive-bg-active + 2px 内嵌强调条；12px/级缩进 + l1 参考线；
  历史行 hash 徽标 / ref 胶囊 / 作者·时间右对齐

验证：typecheck / lint / test（134 文件 1422 通过）/ build 全绿；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.1.7-rc.1 dsh' pnpm test:mount 7/7 通过；
真实宿主截图确认三条需求（多选+双源菜单+zip 项、变动页树形层级）
 2026-09-28 18:08:21 +08:00