Ink 与 Terminal 实验，2026-10-05
Ink 与 Terminal 现已编入真实主题样式表，使用现有外观控件，不是截图注入样式。 两者仍为需要显式开启的实验，等待视觉定稿。
输入与方法
本实验基于 10 月 5 日工作树中的 Paper/Slate 实现。 工具为 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。
设计选择
| 选择 | 改善 | 代价 / 限制 |
|---|---|---|
| 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 的标题标记使用空的无障碍替代文字，不支持的引擎省略标记。首页光标为
静态图形，不引入打字、闪烁、扫描线或发光效果。
试用
本地文档站已开启此列表。在外观菜单选择 Ink 或 Terminal，再独立选择亮色、暗色或
跟随系统。10 月 5 日菜单修订后，四个选项统一使用图标与名称按钮，不显示实验标记。
站点可以直接将任一实验设为 preset，不依赖读者菜单。preset_menu: true 仍提供
Paper/Slate 与站点默认值，不包含所有实验。选择站点默认预设会清除保存的预设。
字体覆盖、系统排版与 CSS 加载前初始化沿用
Paper/Slate 的契约。
验证
| 已执行检查 | 结果与范围 |
|---|---|
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，作者显式配置仍优先；没有引入预设图表色板。
后续工作
晋升稳定选项前仍需真实 Windows 与 Android 设备评审，包括中文回退字体、下划线、 等宽标题换行与长参数表。人工屏幕阅读器朗读和首屏逐帧截图仍未验证；CSS 初始化 顺序检查不保证每个绘制帧。
Mermaid/ECharts 保留明暗色板，API 组件保留供应商样式；Giscus 检查针对生成的 色板资源，而非远端 iframe。实验没有引入完整几何/密度 token 框架。是否晋升 Ink/Terminal、是否重做图表色板仍待决定。本记录不包含提交、推送、发布、消费站点 升级或部署。