apes-sidebar

739 Commits 6 Branches 43 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
Menghuan1918	b07c7116c8	fix(desktop): 补齐 mermaid 放大视图的拖拽区退出 + 把 #772 的守卫换成真实级联探针 #773 修掉了面板宿主层继承宿主 `body > :not(#root) { no-drag }` 导致的 macOS 拖拽失效，但只覆盖了 `.mermaidModal` 之外的层——而放大视图是插件第二个铺满视口的 body 直挂层（`position:fixed; inset:0`，portal 到 body），打开期间会同样清空整窗拖拽与 macOS 双击标题栏缩放。 - src/client/sidebar.module.css：`.mermaidModal` 加 `-webkit-app-region: initial !important`（与面板宿主同一条契约），并在面板宿主那段注释里写明「哪些交互层绝对不能加 initial」（`.selectionPopup` 是 `<button>`、FloatingWindow / AnchoredPopover 自带指针拖拽，宿主 `:is(button, …)` 已给它们 no-drag；反过来声明 `initial !important` 会让按下变成拖窗，重演 #103/#111）。 - tests/panel-host-css.spec.ts：新用例把形状钉在 Linux 的 `pnpm test` 里（宿主层与面板层必须是 `initial !important`、`> ` 必须是 `no-drag`、`.mermaidModal` 同样退出、`.selectionPopup` 不得出现 `initial`）——没有 macOS runner，丢掉 `!important` 只能靠这里才不会静默复发。 - tests/e2e/mount.e2e.ts：把 #773 的文本正则断言换成真实级联探针——逐字注入宿主两条 darwin 规则、翻转 `data-platform=darwin`，读取计算值并断言 `[data-window-drag]` 仍 `drag`、宿主层与面板层为 `none`、`[data-dsh-panel-host] > ` 为 `no-drag`，随后还原。探针把 `[data-window-drag]` 放在 `#root` 内：直挂 body 的元素会被宿主那条 id 级规则本身命中（这正是问题机制）。 - docs/external-plugin-guide.md §12.1：按仓库规则同步这条皮肤契约（含交互弹层的反例判据与守卫位置）。实测（scratch profile + 真实 dsh web + Chromium）： - npm dsh-better-sidebar@0.22.0：探针红，`host` 计算值 `no-drag`（正是线上症状） - 本分支打包版：探针绿（`strip=drag` / `host=none` / `layer=none` / `child=no-drag`） - 本地挂载 lane：7 passed（mount + perf，含新探针）验证：typecheck / lint 通过；panel-host-css + theme 用例通过；新产物 `app-region:initial!important` 2 处（面板宿主 + mermaid 模态）、`app-region:no-drag` 2 处。	2026-09-28 11:04:52 +08:00
Menghuan1918	5a1e75e46b	fix(lint): 清零存量 lint 告警并接入 CI / Makefile 门禁存量清理（首跑 141 errors / 21 warnings → 0 / 0）： - 删除孤儿 disable：SideChatView / Sidebar / selection-popup 三处 exhaustive-deps 豁免与 chunk-artifact 的 no-new-func 豁免（多行理由注释把 disable-next-line 顶离了实报行；selection-popup 改为提取 popupOpen 标志真修复） - 死代码：未用导入（Sidebar×7、TextEditor、SideCardSection、config、fs-operations 及 6 个 spec）、sidechat-core 死累加器 total、chunk-loader.spec 死助手 registry、sidechat-seed-validation 死助手 toolResultMessage - 真实小修：agent-opens 三处 throw 补 cause；lazy-chunk any → ComponentType<P>（P extends object）；service.ts claimed 初值改定值赋值；chunk-loader task / spec 内 etag / pendingLoad / snapshot 改 const；terminal-links 去掉字符类内多余转义；SubagentView catalogs 空兜底 useMemo 稳定标识；editor-host.spec 组件提出大写 FakeViewer（rules-of-hooks）；pty-helpers.spec 内联 require 提升为静态导入；panel-host-css 注释里的零宽空格改为可见写法 - 依赖数组豁免（均带理由）：granular scope 字段（EditorHost / PdfView / ChangesTab / GitLens×2）、job.status 粒度（SubagentView×2）、清理期读 ref、mount-only 注册等；ctx（挂载期恒定）直接入 deps（Sidebar×3）、TextEditor previewScroll 补 scope（幂等） - 刻意控制字符正则（conversation-draft / markdown-images）与宿主槽位 any 签名（context-types）以带理由豁免保留接入： - Makefile：lint 目标（typecheck 旁），check 聚合补 lint 保持「对齐 CI」语义 - ci.yml ci / ci-windows 两 job 与 release.yml 在 Typecheck 后加 Lint 步骤（release 注释同步顺序）	2026-09-03 20:00:08 +08:00
chendefine	96650fa189	fix(shell): keep an overflow:hidden fallback beneath clip + guard the cascade shift fix) — but as a BARE declaration. Engines without clip support (Safari < 16, older Chromium) drop an unsupported declaration at parse time, which leaves the host `overflow: visible`: no clipping at all, and the historical "collapsed panels extend the document's scrollable area, whole page draggable" regression returns on those engines. Declare `overflow: hidden` BEFORE `overflow: clip`: clip-aware engines apply the later clip (identical behavior to #453), while old engines fall back to hidden and keep clipping (with its pre-clip scrollability — the same state they had before #453, strictly better than visible). The cascade order is the contract. Also extends the rule comment (the fix guards the whole scroll-into-view class — focus moving into off-viewport regions, nested iframes/workbenches claiming focus while loading — not just the reveal case) and adds tests/panel-host-css.spec.ts guarding the cascade (hidden first, clip last), the fixed viewport layer, and that the degraded rule never reintroduces overflow. Contract documented in the integration guide §12 (root anchor bullet).	2026-09-02 23:51:13 +08:00

Author

SHA1

Message

Date

Menghuan1918

b07c7116c8

fix(desktop): 补齐 mermaid 放大视图的拖拽区退出 + 把 #772 的守卫换成真实级联探针

#773 修掉了面板宿主层继承宿主 `body > :not(#root) { no-drag }` 导致的 macOS 拖拽
失效，但只覆盖了 `.mermaidModal` 之外的层——而放大视图是插件**第二个铺满视口的
body 直挂层**（`position:fixed; inset:0`，portal 到 body），打开期间会同样清空整窗
拖拽与 macOS 双击标题栏缩放。

- src/client/sidebar.module.css：`.mermaidModal` 加 `-webkit-app-region: initial
  !important`（与面板宿主同一条契约），并在面板宿主那段注释里写明「哪些交互层
  绝对不能加 initial」（`.selectionPopup` 是 `<button>`、FloatingWindow /
  AnchoredPopover 自带指针拖拽，宿主 `:is(button, …)` 已给它们 no-drag；反过来
  声明 `initial !important` 会让按下变成拖窗，重演 #103/#111）。
- tests/panel-host-css.spec.ts：新用例把形状钉在 Linux 的 `pnpm test` 里（宿主层
  与面板层必须是 `initial !important`、`> *` 必须是 `no-drag`、`.mermaidModal`
  同样退出、`.selectionPopup` 不得出现 `initial`）——没有 macOS runner，丢掉
  `!important` 只能靠这里才不会静默复发。
- tests/e2e/mount.e2e.ts：把 #773 的**文本正则**断言换成**真实级联探针**——逐字
  注入宿主两条 darwin 规则、翻转 `data-platform=darwin`，读取计算值并断言
  `[data-window-drag]` 仍 `drag`、宿主层与面板层为 `none`、`[data-dsh-panel-host]
  > *` 为 `no-drag`，随后还原。探针把 `[data-window-drag]` 放在 `#root` 内：直挂
  body 的元素会被宿主那条 id 级规则本身命中（这正是问题机制）。
- docs/external-plugin-guide.md §12.1：按仓库规则同步这条皮肤契约（含交互弹层
  的反例判据与守卫位置）。

实测（scratch profile + 真实 dsh web + Chromium）：
- npm dsh-better-sidebar@0.22.0：探针红，`host` 计算值 `no-drag`（正是线上症状）
- 本分支打包版：探针绿（`strip=drag` / `host=none` / `layer=none` / `child=no-drag`）
- 本地挂载 lane：7 passed（mount + perf，含新探针）

验证：typecheck / lint 通过；panel-host-css + theme 用例通过；新产物
`app-region:initial!important` 2 处（面板宿主 + mermaid 模态）、`app-region:no-drag` 2 处。

2026-09-28 11:04:52 +08:00

Menghuan1918

5a1e75e46b

fix(lint): 清零存量 lint 告警并接入 CI / Makefile 门禁

存量清理（首跑 141 errors / 21 warnings → 0 / 0）：
- 删除孤儿 disable：SideChatView / Sidebar / selection-popup 三处 exhaustive-deps 豁免与 chunk-artifact 的 no-new-func 豁免（多行理由注释把 disable-next-line 顶离了实报行；selection-popup 改为提取 popupOpen 标志真修复）
- 死代码：未用导入（Sidebar×7、TextEditor、SideCardSection、config、fs-operations 及 6 个 spec）、sidechat-core 死累加器 total、chunk-loader.spec 死助手 registry、sidechat-seed-validation 死助手 toolResultMessage
- 真实小修：agent-opens 三处 throw 补 cause；lazy-chunk any → ComponentType<P>（P extends object）；service.ts claimed 初值改定值赋值；chunk-loader task / spec 内 etag / pendingLoad / snapshot 改 const；terminal-links 去掉字符类内多余转义；SubagentView catalogs 空兜底 useMemo 稳定标识；editor-host.spec 组件提出大写 FakeViewer（rules-of-hooks）；pty-helpers.spec 内联 require 提升为静态导入；panel-host-css 注释里的零宽空格改为可见写法
- 依赖数组豁免（均带理由）：granular scope 字段（EditorHost / PdfView / ChangesTab / GitLens×2）、job.status 粒度（SubagentView×2）、清理期读 ref、mount-only 注册等；ctx（挂载期恒定）直接入 deps（Sidebar×3）、TextEditor previewScroll 补 scope（幂等）
- 刻意控制字符正则（conversation-draft / markdown-images）与宿主槽位 any 签名（context-types）以带理由豁免保留

接入：
- Makefile：lint 目标（typecheck 旁），check 聚合补 lint 保持「对齐 CI」语义
- ci.yml ci / ci-windows 两 job 与 release.yml 在 Typecheck 后加 Lint 步骤（release 注释同步顺序）

2026-09-03 20:00:08 +08:00

chendefine

96650fa189

fix(shell): keep an overflow:hidden fallback beneath clip + guard the cascade

shift fix) — but as a BARE declaration. Engines without clip support
(Safari < 16, older Chromium) drop an unsupported declaration at parse
time, which leaves the host `overflow: visible`: no clipping at all,
and the historical "collapsed panels extend the document's scrollable
area, whole page draggable" regression returns on those engines.

Declare `overflow: hidden` BEFORE `overflow: clip`: clip-aware engines
apply the later clip (identical behavior to #453), while old engines
fall back to hidden and keep clipping (with its pre-clip
scrollability — the same state they had before #453, strictly better
than visible). The cascade order is the contract.

Also extends the rule comment (the fix guards the whole
scroll-into-view class — focus moving into off-viewport regions,
nested iframes/workbenches claiming focus while loading — not just the
reveal case) and adds tests/panel-host-css.spec.ts guarding the
cascade (hidden first, clip last), the fixed viewport layer, and that
the degraded rule never reintroduces overflow. Contract documented in
the integration guide §12 (root anchor bullet).

2026-09-02 23:51:13 +08:00