figmar/apes-sidebar
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
169 Commits 6 Branches 43 Tags
29f162dac024981d4af593dcdc957976ef0a5ad7
Commit Graph
17 Commits
Author SHA1 Message Date
Menghuan1918 29f162dac0 feat: 服务化 API 新增 urlTarget 外链认领 + 浏览器 HTTP/HTTPS 二级设置开关 
基于 PR #74 的颗粒度讨论向前兼容拓展服务化 API：
- TabDescriptor 新增可选 urlTarget(url) 谓词：聊天/界面外链被拦截时按注册
  顺序路由到第一个命中的插件 tab 类型（openTab({ type, url, title })），
  内置 browser 退居隐式兜底；SIDEBAR_FEATURES 追加 'urlTarget'
- 浏览器链接设置改为二级菜单（齿轮弹窗）：新增 browserInterceptHttp
  （默认开）+ browserInterceptHttps（默认关）；browserInterceptLinks
  保留为总闸（默认开，旧文档零迁移）
- 拦截管线：registerLinkInterception 的 takeoverEnabled 改收解析后的
  URL，协议/同源纯判定（shouldInterceptLink）签名不变
- 测试：matchUrlTarget（注册顺序/抛错吞掉/browser 永不命中）、jsdom
  点击接管门控、parsePrefs 新字段默认值；全默认字面量同步
- 文档：设计文档 + AGENTS.md（字段/示例/设置键）+ README（外链分流）
 2026-08-15 15:05:06 +08:00
Menghuan1918 4e275aa321 chore: v0.12.1（0.12.0 被 npm 判定已发布过无法复用，正式版改用 0.12.1；README 版本号同步） 2026-08-15 00:36:09 +08:00
Menghuan1918 ef8a707da8 chore: v0.12.0（正式版） 2026-08-15 00:33:26 +08:00
Menghuan1918 83a658efd4 chore: v0.12.0-beta.1（版本三处同步，api-surface 测试放行预发布版本号） 2026-08-15 00:28:59 +08:00
Menghuan1918 0995a58454 fix: 回应独立 CR 的 P2/P3 意见（0×P1） 
- P2-1 onOpen 收到真正落地的 tab：url 新建场景从 landed 态按 id 反查
  （补丁后对象），回调不再拿到未打 url 的 tab
- P2-2 插件设置行显式取值源：FeatureSettingsRows 新增 valueSource prop，
  插件行读自己的 pluginSettings blob——插件键与宿主 pref 同名时不再
  静默读宿主值（原投影合并有读宿主写插件的读写不对称）；prop 命名避开
  Object.prototype.valueOf 冲突
- P2-3 consumer 类型检查接入工程：package.json 新增 check:consumer-types
  脚本 + CI 在 build 后执行；脚本补 lib/types 存在性前置检查（防假绿）
- P3-1 url seed 只在新建时应用：dedupe 聚焦的 tab 不再被覆写 path
- P3-2 closeTab/activateTab 未知 id 严格 no-op：store.reduce 对同引用
  结果短路（不 notify、不重写 localStorage），根因修复 + 回归测试
- P3-3 closeTab/activateTab 增加可选 scope（cwd 随回调传递），Sidebar
  双树激活/关闭路径传入 { sessionId, cwd }
- P3-4 定向打开不再自动展开不可见 session 的面板
- P3-5 Sidebar 终端 pty 释放查找覆盖双树（底部面板终端不再漏掉 HTTP
  兜底）
- P3-6/P3-7 与 Nits：AGENTS.md/指南文档化（dedupeKey 纯函数、meta 用
  null 清除、回调 scope 的 cwd 语义）；consumer fixture 补常量导出覆盖

测试 +6（url 落地保真 / url 不覆写聚焦 / 未知 id 无 notify / 定向打开
不展开 / scope 随回调 / valueSource 键隔离），464 全绿；typecheck、
build、consumer 校验全部通过。
 2026-08-14 21:28:41 +08:00
Menghuan1918 319d34ed09 fix: 回应 Codex 审查的 4 条意见（2×P1 + 2×P2） 
- P1 state.ts reduceFor：恢复共享 uid 计数器到调用前水平（目标 session 的
  max 可能低于激活 session 已用 id，否则下次 mint 撞 id 损坏布局）；
  回归测试实证：无修复时 split 产生重复 pane id
- P1 service.ts 生命周期分类：dedupe 聚焦判定改为基于输入态的存在性
  （dedupeKey 匹配或 id 匹配都算聚焦）——按 path 去重 + 新 id 打开时
  不再对从未插入的幽灵 tab 触发 onOpen（资源泄漏源）
- P2 SideCardSection：乐观 prefs ref（optimisticRef）驱动嵌套 map 合并
  （tabsEnabled/viewersEnabled/pluginSettings），同 tick 多次写入不再
  互相丢弃；mergePluginSetting 抽纯函数 + 单测
- P2 state.ts schedulePersist：每 session 独立防抖定时器（persistTimers
  Map），定向打开不再取消其他 session 的待写；单测验证双写都落盘
 2026-08-14 21:13:53 +08:00
Menghuan1918 82a69546d2 feat: 公共 API 基座化（v0.12.0，纯增量）— 类型/能力/设置 seam 全面补齐 
- 类型生态：service 模块 re-export SidebarTab/SidebarState/SidebarStore/
  SidebarSnapshot/SidebarDiffRef/TabType/SessionScope/SidebarPrefs 等公共
  状态词汇（此前 TS2459 无法命名）；context-types 去 Node 依赖（结构镜像
  SidebarHttpRequest/Response/UpgradeSocket/Head），client 可达声明图零
  node:* 引用，外部消费者无 @types/node + skipLibCheck:false 可编译
  （scripts/check-consumer-types.sh 守护）
- 服务能力：version/features 版本与能力探测（单调只增）、getSnapshot/
  subscribeState 状态订阅、updateTab（title/path/meta）、activateTab、
  openFile（路径派生 id 与内置拦截一致）、openTab(seed, scope?) 定向到
  指定 session（store.reduceFor 不扰动 UI）
- TabDescriptor：badge 角标（99+ 封顶，抛错吞掉）、onOpen/onActivate/
  onClose 生命周期回调（service 路径派发，dedupe 聚焦触发 onActivate
  而非 onOpen，抛错不打断流程）；SidebarTab.meta JSON 可序列化跨刷新
  持久化（sanitize 宽松保留）
- 设置 seam 开放：PrefsSchema 增 pluginSettings 开放嵌套 map（z.dict），
  settings.pluginToggles（插件自有行，同 switch/text/number 控件）与
  settings.render（自定义面板，含 store/service/prefs/updatePluginSetting/
  close props）；viewer 卡片 v0.12.0 起也有齿轮设置弹窗
- FileViewerDescriptor.load 增第三参 AbortSignal（EditorHost 生命周期中止）
- UI 接线：tab 激活/关闭改走 service（跨树激活修复 + 回调触发）、+ 菜单
  传 scope、TabBar badge pill 渲染；active-session scope 走原 reduce 路径
  保证 notify
- 测试 +23：生命周期/定向打开/updateTab/activateTab/openFile/meta 持久化/
  reduceFor/能力常量（与 package.json 锁步）、consumer-types.ts 编译门、
  api-surface.spec.ts（client 图零 node 依赖守护）；既有 430 测试全绿
- 文档：AGENTS.md 修 available 三参示例并补全部新 API；external-plugin-
  guide.md 刷新至 v0.12.0（7 tab + 9 viewer、设置 seam 开放、类型导入
  路径建议）；README×2 服务化小节同步

未发版 npm（用户决定）；分支 feat/plugin-api-v012。
 2026-08-14 20:44:43 +08:00
Menghuan1918 d83490c93e feat: 终端二级设置支持自定义字体（字体族 + 9–32px 字号，实时生效） 
- SidebarPrefs 新增 terminalFontFamily（空 = 跟随主题等宽字体）/ terminalFontSize（9–32，默认 13），PrefsSchema 与 parsePrefs 同步校验
- 声明式设置 API 扩展：SidebarSettingToggle 支持 type: 'switch' | 'text' | 'number'（缺省 switch，向后兼容）+ min/max/placeholder/unit
- 终端卡片齿轮弹窗新增「终端字体」「终端字号」两行：blur/Enter 提交、number 钳制、提交失败回滚草稿
- TerminalView 经 store 订阅实时应用字体（options + re-fit + resize），懒加载 chunk 无新增依赖
- 新增 resolveTerminalFont 纯函数（回退链：用户字体 → 主题 token → 内置等宽栈）并单测
- 版本 0.11.0，README/AGENTS.md/设计文档同步
 2026-08-14 14:36:49 +08:00
Menghuan1918 cb9a7cf751 feat: 内容型打开自动展开承载面板（宽视口） 
宽视口下 openTab 带 path/url seed 时，承载落点 pane 的面板折叠则自动展开：
落点在底部树展开底部面板，否则展开右侧面板；去重聚焦既有 tab 同样展开
（打开必须落在视野内）。窄视口抽屉逻辑不变；类型型打开（+ 菜单、agent
终端自动补 tab）不展开。同步 AGENTS.md / README 文档与测试。
 2026-08-12 18:39:17 +08:00
Menghuan1918 b391ebffed feat: 移动端侧边栏体验 — 窄视口（<1024px）双工作台合并为单面板抽屉（可拖分隔条、高度与底部面板互通）、不提供底部面板按钮、文件/外链打开自动展开、新会话默认收起 2026-08-12 18:20:34 +08:00
Menghuan1918 c7af7dccdb feat: 侧边栏双面板 — 右上角按钮簇、底部面板（首展自动终端/关闭按钮）、跨面板拖 Tab、拖动性能优化 
- 右上角持久按钮簇：横向排列、独立 glyph（底栏/侧拉）、始终钉在视口右上角（侧边栏展开时位于其标签条右端，真实挤占 Tab 空间）
- 底部面板：独立工作台，只挤占中间 Agent 输出区（不覆盖左右侧边栏），右缘分割线、关闭 x、首展自动开终端（二级设置开关，默认开）
- 两面板拐角双向拖动调节尺寸；拖动改为 rAF 节流直写 DOM，消除卡顿；面板尺寸互钳制防丢失
- 跨面板拖 Tab（合并/拆分落点），moveTab/moveTabToEdge 支持跨树移动
- 欢迎卡片改响应式网格；布局/几何全部按会话持久化，旧状态平滑迁移
 2026-08-12 16:43:24 +08:00
Menghuan1918 302c20109f feat: 内置 HTML 预览器 + 沙箱浏览器 tab（v0.5.0） 
- html viewer：.html/.htm 沙箱 iframe 预览（相对资源经 /sidebar/html 路径编码路由加载，CSP sandbox + 信任围栏 + cwd 边界），预览/编辑切换
- browser tab：+ 菜单多开（browser:<n>），地址栏后退/前进/刷新/在浏览器中打开（15px 图标），URL 与标题按会话持久化（patchTab + nextBrowser）
- 安全：iframe 一律不透明源沙箱（无 allow-same-origin/top-navigation、no-referrer、权限策略全禁、禁 srcdoc）；地址栏仅 http(s)、拒绝 localhost 等本机地址；界面实时沙箱状态（关闭红色警示）+ 临时解锁/恢复
- 设置：htmlViewerNoSandbox / htmlViewerDefaultUnsafe / browserNoSandbox / browserInterceptLinks 四个声明式二级设置（默认安全）
- 外链拦截：聊天/界面 http(s) 外链默认在侧边栏打开（openTab seed.url），Ctrl/Cmd 点击放行
- 嵌入拒绝面板：browser.probe 路由探测 X-Frame-Options/frame-ancestors，被拒站点显示原因 + 在浏览器中打开/仍然加载
- 设置页可滚动；内置 7 tab + 9 viewer；新增设计文档；268 个测试全绿
 2026-08-11 19:28:48 +08:00
Menghuan1918 89ddf8a9e7 feat(settings): 侧边栏设置声明式化 — 注册表驱动的开关清单 + 内置支持插头化 
- SidebarPrefs 新增 tabsEnabled / viewersEnabled 开放 map（缺省 = 启用），
  PrefsSchema 用 z.dict 校验，旧文档零迁移
- TabDescriptor/FileViewerDescriptor 新增声明式设置面：viewer 补 title/icon，
  两者补 settings.toggles（子代理声明 autoOpenSubagent、终端声明 agentTerminalTools）
- 服务新增 isTabEnabled/isViewerEnabled；openTab 拒绝禁用类型、matchFileViewer
  跳过禁用 viewer
- SideCardSection 重写为注册表驱动清单：侧边栏内容（图标+类型id+开关+嵌套开关）
  + 文件预览（图标+标题+扩展名+开关），开关持久化 + 乐观提交回滚
- 消费点 gating：+ 菜单过滤、子代理自动展开、agent 终端 reconcile、
  产出文件拦截（editor 关闭时回落默认行）、新会话 explorer 预置
- 内置 viewer 补 6 个手绘 outline 图标；store 快照携带 prefs 使开关变更即时生效
- 测试：service gating / builtins 声明 / parsePrefs map 校验 / schema 断言 /
  新增 SideCardSection renderToString 规格
- 文档：README 设置小节、AGENTS.md 描述符与服务方法、新增设计文档；版本 0.5.0
 2026-08-11 14:08:55 +08:00
Menghuan1918 39455ff18e docs+fix: exports 加 ./client/api 别名；catch-all+detect 纯嗅探规则；设计文档偏差记录 
- package.json exports 新增 './client/api' 别名指向 service.d.ts（设计文档
  §7 的公共导入路径，api.ts 已被 fetch 助手占用故不换文件名）
- matchFileViewer 补充 sniff-only 规则：exts: [] + detect 的 descriptor 在
  无 head 时不得盲认领（AGENTS.md 的 magic-sniffer 示例原实现会吞掉
  图片/PDF 等真实 viewer 的文件）；有 head 时只认领 detect 命中的。
  新增测试断言三种情形（无 head / magic 命中 / magic miss）
- docs/plans/2026-08-11-service-registry-design.md 追加 §17 实施偏差记录：
  dedupeKey+single 语法糖、available 三参、单趟匹配+嗅探规则、EditorHost/
  TextEditor 拆分、fs.read head 字段、导出别名、+ 菜单 disabled 行、
  保留的 store 级操作、内置清单、测试
- AGENTS.md：available 三参、single 语法糖、viewerId、单趟匹配+head 语义、
  8 viewer 内置清单、openTab seed.title 可选、参考实现指向 builtins/ 目录
- README 服务化章节：6 viewer → 8 viewer，标注全注册表驱动
 2026-08-11 11:25:37 +08:00
Menghuan1918 db0ba36610 fix(service): 注册表核心修正 — seed.title 优先、single 语法糖、available 三参、单趟匹配、dedupe 委托 
- service.openTab 的 seed.title 优先于 descriptor.title（修复编辑器 tab 标题
  从文件名变成 t('editor') 的回归）；title 变为可选，descriptor.title 兜底
- TabDescriptor 新增 single?: boolean 语法糖（展开为 dedupeKey: () => id），
  dedupeKey 显式给出时优先
- available 签名升级为 (ctx, scope, state) 三参（设计文档 §5.2 的超集），
  Sidebar.buildNewTabOptions 与 terminal 配额检查适配
- matchFileViewer 从三趟全局遍历改为设计文档 §8.2 的单趟 per-descriptor 算法：
  priority 降序，每个 descriptor 先 detect（head 可用时）再 exts，[] 为 catch-all
- applyDedupe 的落位逻辑委托给 state.openTabInActivePane（消除重复实现），
  同时 id 安全网现在也覆盖 service.openTab 路径（同 id 打开聚焦既有 tab）
- state.ts：删除零引用的 SIDEBAR_BUILTIN_TAB_TYPES；TERMINAL_LIMIT 移入
  builtins.tsx（state 不再关心 terminal）；openTab reducer 改名 openTabInActivePane
- Sidebar.tsx 删除 TERMINAL_LIMIT/allLeaves 死 import；openDiffTab 补充
  dedupeKey 一致性注释（其按 id 去重与 diff descriptor 的 dedupeKey 同规则）
- tests/service.spec.ts 重写匹配/去重断言并新增 title/single/available 用例
 2026-08-11 11:12:29 +08:00
HuanLinOTO e40039ceec refactor: 完全解耦内置 tab — dedupe 归 service，图标归 descriptor 
- state.openTab 简化为 '添加到 pane + id dedupe'，移除 isSingle/editor-path/diff-id 三分支
  （dedupe 策略归 service.openTab 通过 descriptor.dedupeKey 统一）
- intercept.tsx openSidebarFile 改走 service.openTab（editor descriptor 的 dedupeKey 接管 per-path 去重）
- Sidebar.tsx 两处 subagent 触发（auto-activation + jump-back）改走 service.openTab
- service.openTab seed 加可选 id 字段（editor 需要 path-derived id）
- TabBar.tsx 加 getTabIcon 回调，tab 标签图标查 descriptor.icon 替代 tabTypeIcon
- split-pane.tsx 移除 tabTypeIcon 兜底（buildNewTabOptions 已从 descriptor 填 icon）
- Workbench/NodeView/LeafView 透传 getTabIcon
- tests/unit.spec.ts 更新 openTab 测试（id dedupe 替代 type dedupe）
 2026-08-11 01:39:20 +08:00
HuanLinOTO 291158a3ba feat: 服务化改造 — ctx.betterSidebar 注册表（registerTab/registerFileViewer），内置 6 tab + 6 viewer 迁移到 registry，v0.4.0 
- 新增 src/client/service.ts: BetterSidebarService 接口 + createBetterSidebarService 工厂
  - registerTab/registerFileViewer 返回 disposer（HMR-safe，挂到 cordis fiber）
  - matchFileViewer 三段匹配: priority desc → detect(内容嗅探) → exts
  - openTab 走 descriptor.dedupeKey 统一去重（替代 isSingle/editor-path/diff-id 三分支）
  - createTab 回调支持自定义 tab 创建（terminal 的 nextTerminal 递增）
- 新增 src/client/builtins.tsx: 6 内置 tab + 6 内置 viewer 自我注册（吃狗粮）
  - tab: editor(hidden) / explorer / git / subagent / terminal / diff(hidden)
  - viewer: image / pdf / docx / xlsx / pptx / binary-download
  - code/markdown 保持 EditorView 内联兜底（matchFileViewer 返回 undefined 时走 fsRead+CodeMirror）
- 新增 src/client/OrphanedTab.tsx: 未注册 type 的占位组件（插件未加载时降级）
- 改造 src/client/index.tsx: ctx.provide('betterSidebar') + registerBuiltins
- 改造 src/client/Sidebar.tsx: TabContent/buildNewTabOptions/onNewTab 查表替代 switch
- 改造 src/client/EditorView.tsx: 预览路由查 matchFileViewer 替代 if/else 链
- 改造 src/client/state.ts: TabType 联合字面量→string，sanitizeNode 接受所有 string type
- 改造 src/context-types.ts: declare module 'cordis' 加 betterSidebar 字段
- 改造 src/index.ts: re-export Context + 服务类型（consumer import type 触发 augmentation）
- package.json: 加 ./client/service exports 子路径，version 0.4.0
- tests/service.spec.ts: 12 个新测试覆盖 register/dispose/matchFileViewer/dedupe/createTab
- tests/unit.spec.ts: sanitizeState 测试更新（未知 type 不再被拒绝，渲染 OrphanedTab）
 2026-08-11 00:31:23 +08:00