# Ink 与 Terminal 实验，2026-10-05

> 真实主题输出中的显式实验预设、设计取舍、检查与后续工作。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

> [!IMPORTANT] 本地实验，不代表发布
> Ink 与 Terminal 现已编入真实主题样式表，使用现有外观控件，不是截图注入样式。
> 两者仍为需要显式开启的实验，等待视觉定稿。

## 输入与方法 {#inputs}

本实验基于 10 月 5 日工作树中的 [Paper/Slate 实现](/zh/docs/design/research/2026-10-05-visual-presets-acceptance/)。
工具为 macOS ARM64 上的 Hugo Extended 0.166.0、Go 1.27.1、Node 26.9.0、
Playwright 1.62.1。集成检查使用文档站与同级本地主题；站点公开 pin 仍为 v1.1.0。
这不是兼容下限、CI 固定工具链或线上验收。

首页、配置、提示块与标签页以相同内容比较四套预设、EN/ZH、390/1440 px 和浅深色。
检查真实字体、溢出、外观控件与本地字体请求。进一步的组件检查覆盖代码、参数字段、
Blog、Book、API、Mermaid、ECharts、搜索与打印。沿用站点既有边界，axe 不检查
API 供应商自有 DOM。

## 设计选择 {#design-choices}

| 选择 | 改善 | 代价 / 限制 |
| --- | --- | --- |
| Ink：黑白画布、Inter、红色标记、正文链接下划线与粗标题线 | 少量装饰即可形成清楚的层级与链接信号 | 高字重标题与重复分隔线仍需长页编辑式评审 |
| Terminal：等宽控件与标题，无衬线正文与表格，青色链接与琥珀强调 | 保留段落可读性，同时形成明确的技术界面 | 长英文导航会更早换行，中文使用平台回退字体 |
| Ink 直角、Terminal 2 px 圆角，组件无阴影 | 相同内容与布局也能呈现明显不同的表面 | 局部组件规则增加 CSS，尚非全局间距/圆角接口 |
| 只压紧 Terminal 桌面导航 | 展示更多有效导航行，不缩小正文 | 密度属于预设设计，不增加新的读者偏好 |
| 复用本地字体与状态管理 | 不新增字体文件、外部字体服务、框架或持久化机制 | 所有预设 CSS 仍在同一个样式表内 |
| 显式实验菜单选项 | 评审者可即时切换，普通菜单范围保持稳定 | 开启四张卡片后菜单更高 |

Ink 使用 `#ffffff` / `#0b0b0b` 画布、`#141414` / `#ededed` 正文与
`#c8102e` / `#ff5c4d` 强调。Terminal 使用 `#f4f5f2` / `#0c0f0e` 画布、
`#1d211f` / `#d3dbd6` 正文、`#0a6560` / `#4cc9bd` 链接与
`#935400` / `#f0a73a` 强调。站点与栏目强调色覆盖仍然优先。
Terminal 的标题标记使用空的无障碍替代文字，不支持的引擎省略标记。首页光标为
静态图形，不引入打字、闪烁、扫描线或发光效果。

## 试用 {#try-it}

```yaml
params:
  ui:
    preset: paper
    preset_menu: [paper, slate, ink, terminal]
    dark_mode: true
```

本地文档站已开启此列表。在外观菜单选择 Ink 或 Terminal，再独立选择亮色、暗色或
跟随系统。10 月 5 日菜单修订后，四个选项统一使用图标与名称按钮，不显示实验标记。
站点可以直接将任一实验设为 `preset`，不依赖读者菜单。`preset_menu: true` 仍提供
Paper/Slate 与站点默认值，不包含所有实验。选择站点默认预设会清除保存的预设。
字体覆盖、系统排版与 CSS 加载前初始化沿用
Paper/Slate 的契约。

## 验证 {#verification}

| 已执行检查 | 结果与范围 |
| --- | --- |
| `check-presets.py` | 三类背景的正文/链接/强调色 AA、浅深色 token 对称、建议性背景亮度、冻结的 Slate v1.1.0 色板；七次严格构建、28 个文档根元素 |
| 主题检查 | 参数、字体角色、32 个语言包的 205 个键、生成 schema、组件/输出契约、运行时隔离与命名空间通过；52 个既有输出 golden 未改动 |
| 运行时测试 | 49 项 Node 测试通过 |
| `make check` | 57 项非浏览器测试通过；EN/ZH 覆盖 142/142，Markdown、渲染内容与站内链接检查通过 |
| 标准浏览器套件 | 八套通过 170 项；修复下述默认 Terminal 构建问题后，外观套件 49 项全通过。九套合计 219 项，记录的是首次运行加专项重跑，不是单次连续成功的 `make browser` |
| 外观覆盖 | 四预设 × EN/ZH × 390/1440 px × 浅深色，检查首页、配置、提示块与标签页；本地字体请求、菜单 axe、状态、键盘、打印、Giscus 资源；四组实验/明暗检查覆盖 11 类页面与搜索，并检查共享 Mermaid 对比度 |
| 字体/配置构建 | 真实文档站以 Terminal 为默认值重建：系统字体、不带与带显式覆盖，以及 technical 显式字体覆盖，三组均通过 |
| 浏览器引擎 | Chromium、Firefox、WebKit 在 390/1440 px 下六项通过，覆盖 CSS 前状态、键盘依次选择 Ink/Terminal、持久化与焦点返回；桌面 Chromium 另用 4 倍 CPU 降速 |
| 视觉复核 | 96 张真实输出视口截图，查看了代表性首页、文档与手机菜单；本地对照页按内容、语言、尺寸与明暗选择截图，不注入样式 |

标准 sitemap axe 检查限定 15 个路径：EN/ZH 首页、配置、提示块、标签页、OpenAPI；
英文搜索、Mermaid、ECharts、Blog 与 `/book/04-design/`。既有响应式 axe 矩阵另行
运行，这不是全站穷举。标准浏览器检查使用既有 4173 样例服务器；引擎专项使用来源
已确认的同级主题 1313 开发服务器。外观矩阵未观察到外部字体请求。

首次默认 Terminal 字体构建发现建议性背景亮度表漏项，造成强调色对比度误报警。
现已登记两套实验背景，并由检查器断言与显式强调色样例覆盖。修正后仅重跑受影响的
外观套件。新增研究索引和更新的提案描述经逐项审阅后，刷新 LLMS golden 中对应的
两处变化。

实验暴露了两处新增样式问题：全局禁用下划线的规则覆盖了 Ink 链接，Terminal 搜索
选中行的摘要仍使用弱化文字色。两者均作了局部修正。另一个继承问题是 Mermaid 深色
标签（`#cccccc` 配 `#585858`，4.43:1），在 Paper 与 Slate 中同样复现。共享的
明暗色板默认标签背景现改为 `#404040`，作者显式配置仍优先；没有引入预设图表色板。

## 后续工作 {#remaining-work}

晋升稳定选项前仍需真实 Windows 与 Android 设备评审，包括中文回退字体、下划线、
等宽标题换行与长参数表。人工屏幕阅读器朗读和首屏逐帧截图仍未验证；CSS 初始化
顺序检查不保证每个绘制帧。

Mermaid/ECharts 保留明暗色板，API 组件保留供应商样式；Giscus 检查针对生成的
色板资源，而非远端 iframe。实验没有引入完整几何/密度 token 框架。是否晋升
Ink/Terminal、是否重做图表色板仍待决定。本记录不包含提交、推送、发布、消费站点
升级或部署。

---

反链：

- [品牌外观](/zh/docs/customize/brand/)
- [架构](/zh/docs/design/architecture/)
- [视觉预设](/zh/docs/design/decisions/visual-presets/)
- [视觉预设](/zh/docs/design/proposals/visual-presets/)
- [研究](/zh/docs/design/research/)
- [OINK 1.2 发布前审查](/zh/docs/design/research/2026-10-05-v1-2-release-review/)