figmar/apes-sidebar
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
647 Commits 6 Branches 43 Tags
e567bf6924f1df7957e991ff23a319639fe055ee
Commit Graph
4 Commits
Author SHA1 Message Date
GeekRicardo 0504e3918b fix(terminal): 自定义字体解析失败时兜底到等宽，避免掉进比例字体毁掉网格 
在设置页「侧边卡片」→ 终端卡片填入自定义「终端字体」后，若该族名在浏览器里
解析不到，终端不是退化成"没有想要的字体"，而是整个网格崩掉：字符间距被撑开、
字形变成比例字形、Nerd Font 图标全部消失。

用户实测（macOS + Chrome，填 `Maple Mono NF CN`）：

| 「终端字体」的值 | DevTools Rendered Fonts | 结果 |
| --- | --- | --- |
| `Maple Mono NF CN` | **PingFang SC** | cell 12.09px @ 13px 字号（0.93em），网格崩坏 |
| `Maple Mono NF CN, monospace` | **Menlo** | 间距恢复正常 |

`resolveTerminalFont` 对用户值（以及主题 `--ds-font-family-code` token 值）
原样返回，只有内置的 `DEFAULT_TERMINAL_FONT_FAMILY` 末尾带 `monospace`。

字体栈若不以通用族收尾，浏览器解析不到任何具名字体时会落到**标准字体**
（standard font，macOS 中文环境是 PingFang SC）——它是**比例字体**。
xterm 用它的推进宽度量 cell（0.93em，等宽字体应为 0.6em），网格随即失真。

这条路径比想象中容易踩：终端里跑的 shell 在 host 上，字体却由**浏览器所在机器**
提供，两者不同机时（远程/容器化的 DSH）用户按 host 侧装的字体填名字必然解析失败。

新增 `withMonospaceFallback()`，在 `resolveTerminalFont` 出口保证字体栈以通用族收尾。

- **不做字体嗅探**：终端字体设计文档 §2 把"字体合法性嗅探"列为非目标；本改动
  不检测具名字体是否存在，只补一个通用族尾项。
- **已有通用族则原样保留**：包括用户主动写的非等宽通用族（`sans-serif` 等）
  ——那是用户的选择，不该被覆盖。
- **主题 token 值同样兜底**：它掉进比例字体的后果与用户值完全一样。
- **CSS 全局关键字单独处理**：`inherit` / `initial` / `unset` / `revert` /
  `revert-layer` 追加逗号后是非法 CSS，会被 CSSOM 整条丢弃，反而让 xterm
  一个字体都拿不到；这类值直接回落内置栈。
- 字体栈按**顶层逗号**切分并感知引号、转义与括号，避免拆坏 `"Foo, Bar"`
  与 `var(--x, y)`；通用族匹配大小写不敏感且只认未加引号的项。

- `tests/terminal-font.spec.ts` 4 → 13 例（兜底追加、已有通用族免动、大小写与
  引号边界、顶层逗号切分、幂等性、CSS 全局关键字、空值）
- `pnpm typecheck` 零错误
- 全量 `pnpm test`：941 passed（改动前基线 932 passed，+9 为本次新增）；
  另有 31 例失败在本分支基线（干净 main）上同样失败，与本改动无关

互补、不重叠。#190 解决"字体解析成功、但栈里没显式列 Nerd Font 导致补充平面
PUA 图标缺字"；本 PR 解决"字体压根没解析到、栈又没有通用族尾项导致落进比例
字体"。两者都落在 `terminal-font.ts` 的同一出口，合并时按先后 rebase 即可。
 2026-08-29 15:49:35 +08:00
HuanLinOTO 699ce448a1 fix: 处理 Copilot 二轮 review 的 10 条评论 
- BrowserView: 即使 host 在白名单，GUI 自身 origin 永不给 allow-same-origin（裸 host 条目覆盖所有端口时可提权）
- intercept: revealInExplorer 相对路径经 resolveSidebarPath 解析后再 revealPaths（交付物路径是相对的）
- intercept: ctx.betterSidebar 改为 ctx.get（#357 纤维链读取约定）
- FileTree/EditorHost/TreePanel/tabs: 把 revealed 贯通到树行渲染 + 高亮类 + scrollIntoView（此前高亮永不渲染）
- state.revealPaths: 重建祖先目录时保留前导分隔符（POSIX/UNC 此前目录永远折叠）
- state.schedulePersist: 仅活动会话写入全局宽度（targeted open 不再用非活动会话的过期宽度覆盖拖拽值）
- browser.probe: GET 回退显式取消 body（否则流式/大响应挂住 socket）
- terminal-font: leading generic 前只放 symbols-only 字体；fully-patched 放 generic 后（避免 hijack 度量字体）
- sidebar.module.css: 恢复拖拽反馈（#130 的 silent resize 与 PR 描述冲突，取 HEAD）
- Sidebar: 剩余 4 处 ctx.betterSidebar 改 ctx.get
- tests: 补 revealPaths/iframeSandboxFor/terminal-font 回归测试 + EditorHost/FileTree 测试补 revealed prop
 2026-08-24 18:40:04 +08:00
ShelbyTang dd5a3dda07 fix(terminal): 补全 Nerd Font 图标字体回退，修复提示符图标显示为豆腐块 
starship / powerlevel10k 等提示符的图标取自 Nerd Font 私有区。Chromium 的
隐式系统字体回退能覆盖 BMP PUA（U+E000–U+F8FF，如 U+E0B0 powerline 分隔符），
但覆盖不到补充平面 PUA-B（U+F0000+）——Nerd Fonts v3 把 Material Design 图标集
迁到了这里，于是这部分图标渲染为豆腐块。经排查用户字体本身含完整字形（format-12
cmap 覆盖上述码点），而 macOS 系统等宽字体（Menlo / SF Mono / Monaco）对这些
码点零覆盖，根因是插件的 fontFamily 栈未显式列出任何 Nerd Font。

修复：新增 withIconFontFallbacks()，在 resolveTerminalFont 出口为胜出的基础
字体追加 Nerd Font 图标族（显式命名可使浏览器逐字符查询，两个平面都能命中）。
基础字体优先级链（用户 pref > 主题 > 内置栈）保持不变。

三条约束：
- 只追加不前置：xterm 用字体栈首项测量单元格宽度，基础字体须留在最前；
- 插入到第一个通用族（monospace 等）之前：通用族是 catch-all，其后的字体
  永不被查询，仅判断尾项会让主题给出的 `ui-monospace, Menlo, monospace, …`
  这类栈静默失效；
- 按族名去重（引号/大小写/空白不敏感），用户自列的字体保持原有优先级。

另外：
- 过滤 CSS 全局关键字（inherit/initial/unset/revert/revert-layer）。主题字体
  取自原始 token 值，皮肤确实会设成这类值，追加后会得到非法 font-family 被
  CSSOM 静默丢弃，导致主题字体与图标字体一起失效，现改为回退到下一级；
- 字体栈按顶层逗号切分并感知引号与括号，避免拆坏 "Foo,Bar" 与 var(--x, y)；
- 不列彩色 emoji 字体：本问题的图标全为 PUA 且真 emoji 有独立回退路径，而
  彩色字体会捕获提示符依赖等宽的 BMP 符号（U+26A0、U+2714 等）破坏网格。

单测 12 → 19 例，补齐中间通用族回归守卫、CSS 全局关键字、多通用族、幂等性与
回退顺序契约；全量 594 例通过。
 2026-08-18 10:50:30 +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