企业官网建设流程全解析

如何调整PI-Desktop的阅读字体大小：简单完整指南，优化长对话的沉浸式体验

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop

PI-Desktop是一款本地优先（Local-first）的 AI 编程智能体桌面应用，基于 Electron + Rust 构建。调整PI-Desktop 阅读字体大小只需 3 步：打开 设置 → 常规 → 外观，选择"杯型"预设或拖动比例滑杆，全部界面文字即时放大或缩小，且自动保存——这是优化长对话沉浸式阅读体验的最快方式。

为什么要调整字体大小？

使用 PI-Desktop 阅读 AI 长对话时，默认 14px 的基础字号在以下场景中可能不太合适：

• 👀 大屏远距观看或小屏近距离观看，小字容易疲劳
• 📄 长代码片段和 Markdown 内容需要更大字号才舒适
• 🌗 夜间模式下，稍大的文字更容易辨认

PI-Desktop 的字体缩放是全局类型比例（type scale）：它不会只改一处文字，而是让正文、标题、侧边栏、设置面板、图标保持比例一致地缩放，不会出现"只有正文变大、按钮没变"的割裂感。

字体大小设置在哪里：3 步完成调整

第 1 步：点击左下角设置入口，进入设置 → 常规（General）

第 2 步：找到外观（Appearance）卡片，其中的字体大小（Font size）行就位于"字体"行的下方

第 3 步：选择一个预设，或拖动滑杆自定义比例，立即生效

设置行 UI 的实现位于 FontSizeRow.tsx，它在 SettingsPage.tsx 的外观卡片中被挂载。

4 个"杯型"预设 + 80%~150% 无级滑杆

字体大小行提供了 4 个咖啡杯风格的快捷预设（中文界面为本地化杯名），上方一键选择，下方还有精细滑杆：

滑杆支持80% ~ 150%范围、以2.5%为步长的任意比例，右侧实时显示当前百分比。预设与滑杆的核心常量定义在 font-size.ts，中文杯名等文案来自 zh-CN/index.ts。

改完字体大小后，界面会发生什么？

这是该功能最值得称道的设计细节：

1. 全局等比缩放：渲染层把比例写入--font-scale根变量，所有--text-*字号令牌按calc(原始px × var(--font-scale))计算，正文、标题、侧边栏、设置页、工具栏图标一起等比变化，无需刷新窗口
2. 偏好自动持久化：比例保存在AppSettings.fontScale字段中，下次启动自动恢复，不用反复设置
3. 与窗口缩放互相独立：菜单里的 Zoom In / Zoom Out（Ctrl/Cmd +/-）缩放的是整个窗口（含布局与控件），而字体大小只调整"文字比例"，两者可以叠加组合使用——字体调大 + 窗口不放大，是三栏布局下最舒适的长对话阅读方式

字体大小不生效？常见问题排查

• 比例被限制在 80%~150% 之间：这是产品边界，防止固定高度的行布局被撑坏；若写入非法值，读取时会被normalizeFontScale自动钳制回合法档位（见 font-size.ts）
• 改了之后想一键还原：选择"大杯（100%）"即可回到产品默认比例
• 旧版本用户：历史遗留的fontSize（px 值）字段会按px ÷ 14自动迁移为比例值，无需手动处理

深入了解：相关文档与源码路径

• 设计决策：docs/adr/0180-custom-reading-font-size.md（记录了为何采用全局比例而非"只改正文"的方案）
• 设置入口：apps/desktop/src/features/settings/SettingsPage.tsx
• 比例常量与迁移逻辑：packages/shared/src/font-size.ts
• 字号令牌定义：apps/desktop/src/styles/tokens.css
• 国际化文案：packages/i18n/src/locales/zh-CN/index.ts

新手想快速上手 PI-Desktop，可克隆仓库到本地运行：

git clone https://gitcode.com/GitHub_Trending/pid/PI-Desktop

小结

调整PI-Desktop 阅读字体大小的路径是设置 → 常规 → 外观 → 字体大小：4 个杯型预设覆盖绝大多数场景，80%~150% 滑杆满足精细需求；缩放作用于全局类型比例，与窗口缩放互不干扰，偏好自动保存。把字号调到眼睛最舒服的比例，长对话的沉浸式阅读体验立竿见影 ☕

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop