设计契约
49 篇-
为大表格腾出阅读空间
历史研究;当前行为见 1.4.0 决策 研究日期:2026-10-26。本研究为 OINK 1.4.0 的表格阅读设计提供了依据。接受的决策 与 表格指南 描述已发布行为,并替代下文的入口与范围建议。 通过显式“阅读表格”操作打开大型原生对话框,是最值得继续评估的候选方案。 它给桌面表格增加空间,同时保留文字大小、原表语义和简短的返回路径。许多表格只需在正文内拓宽;实测扩展包样本在桌面端采用这种模式就已能容纳全部列。在 390px 视口下,对话框仅增加 16px 宽度,窄屏下仍保持横向滚动。五 …
历史研究;当前行为见 1.4.0 决策 研究日期:2026-10-26。本研究为 OINK 1.4.0 的表格阅读设计提供了依据。接受的决策 与 表格指南 描述已发布行为,并替代下文的入口与范围建议。 通过显式“阅读表格”操作打开大型原生对话框,是最值得继续评估的候选方案。 它给桌面表格增加空间,同时保留文字大小、原表语义和简短的返回路径。许多表格只需在正文内拓宽;实测扩展包样本在桌面端采用这种模式就已能容纳全部列。在 390px 视口下,对话框仅增加 16px 宽度,窄屏下仍保持横向滚动。五 …
-
统一图表阅读体验
OINK 1.4.0 已接受 统一图表查看、源码导出与按需加载随 1.4.0 发布,行为归属组件、架构与浏览器打印契约。 背景 此前 Mermaid 已有平移和缩放弹窗,但页面打开时就加载引擎,并为弹窗再次渲染 SVG。 此前本地 PlantUML 在页面打开时加载两份引擎,仅支持横向滚动。两者都保留作者源码。 范围 共用现有弹窗与样式,提供查看、复制源码和下载独立 SVG。图表距离视口不超过 320px 时才加载大型引擎并渲染。不改变库版本、PlantUML 服务端模式、其他图表 家族 …
OINK 1.4.0 已接受 统一图表查看、源码导出与按需加载随 1.4.0 发布,行为归属组件、架构与浏览器打印契约。 背景 此前 Mermaid 已有平移和缩放弹窗,但页面打开时就加载引擎,并为弹窗再次渲染 SVG。 此前本地 PlantUML 在页面打开时加载两份引擎,仅支持横向滚动。两者都保留作者源码。 范围 共用现有弹窗与样式,提供查看、复制源码和下载独立 SVG。图表距离视口不超过 320px 时才加载大型引擎并渲染。不改变库版本、PlantUML 服务端模式、其他图表 家族 …
-
OINK 1.3.2 与 Hugo 0.168 消费站点盘点
本记录盘点 ~/pgsty 与 ~/www 下的本地站点。 当前构建规则由架构契约与 诊断决策维护。 基线 OINK v1.3.2 于 2026-10-18 13:37 UTC 发布,对应提交 bd2e856e6e2f7027a9189af009701f5b8cf562cf。 维护中的站点统一使用该版本及 Hugo Extended 0.168.0。CI、本地检查、预览与部署 命令均移除遇警告中断的开关,HUGO_PANICONWARNING 也必须保持未设置。 告警保持可见并接受审阅,上游 …
本记录盘点 ~/pgsty 与 ~/www 下的本地站点。 当前构建规则由架构契约与 诊断决策维护。 基线 OINK v1.3.2 于 2026-10-18 13:37 UTC 发布,对应提交 bd2e856e6e2f7027a9189af009701f5b8cf562cf。 维护中的站点统一使用该版本及 Hugo Extended 0.168.0。CI、本地检查、预览与部署 命令均移除遇警告中断的开关,HUGO_PANICONWARNING 也必须保持未设置。 告警保持可见并接受审阅,上游 …
-
本地搜索改进
OINK 1.4.0 已接受 负责人:OINK 维护者。受影响契约:Shell。 本文描述的搜索行为随 OINK 1.4.0 发布。 证据与范围 此前 CJK 路径要求整条查询连续出现在同一字段中。英文使用 Lunr,两者都只返回页面链接, 没有小节上下文。保留每语言一个本地索引、现有命令、输入法组字、排除规则、关键词权重和 正数页面加权。不引入词典、服务、账号、外部可执行程序、配置键或额外构建步骤。 已接受的行为 按空白及拉丁文字与 CJK 边界拆分查询,保留 …
OINK 1.4.0 已接受 负责人:OINK 维护者。受影响契约:Shell。 本文描述的搜索行为随 OINK 1.4.0 发布。 证据与范围 此前 CJK 路径要求整条查询连续出现在同一字段中。英文使用 Lunr,两者都只返回页面链接, 没有小节上下文。保留每语言一个本地索引、现有命令、输入法组字、排除规则、关键词权重和 正数页面加权。不引入词典、服务、账号、外部可执行程序、配置键或额外构建步骤。 已接受的行为 按空白及拉丁文字与 CJK 边界拆分查询,保留 …
-
设计提案与 PRD
非规范性材料 提案描述的行为可能尚不存在。当前行为由契约、已接受决策、实现与归属检查器定义。不能把提案 当作配置参考。 本栏目是 OINK 产品需求文档、RFC 风格设计与未决维护者提案的唯一正本位置。不要在主题仓库或 文档仓库中另建本地 plan/、plans/、proposal/ 或其它并行设计树。 当前提案 提案 当前边界 反向链接与知识图谱 G1(静态反向链接)已接受,已在主题 main 分支实现,随 OINK 0.8.0 发布;局部与全站图谱(G2/G3)保持草案 媒体收敛 部分已实 …
非规范性材料 提案描述的行为可能尚不存在。当前行为由契约、已接受决策、实现与归属检查器定义。不能把提案 当作配置参考。 本栏目是 OINK 产品需求文档、RFC 风格设计与未决维护者提案的唯一正本位置。不要在主题仓库或 文档仓库中另建本地 plan/、plans/、proposal/ 或其它并行设计树。 当前提案 提案 当前边界 反向链接与知识图谱 G1(静态反向链接)已接受,已在主题 main 分支实现,随 OINK 0.8.0 发布;局部与全站图谱(G2/G3)保持草案 媒体收敛 部分已实 …
-
2026-10-13 主题审查
本地审查快照 本记录描述基于 v1.2.0 下游版本基线的本地源码修改与测试结果。 范围 审查开始时主题位于 f8f476e,共享工作树中已有下游站点维护、紧凑侧栏修改,以及进行中的英文文档修订。这些工作均被保留。审查期间,原有侧栏修复被单独提交为 8f1f08d,对应文件内容未发生变化。 本次覆盖主题自有检查器、运行时单元测试、合成输出夹具、真实双语文档站,以及两类下游站点:DDIA 图书和 SILO 大型文档树。源码检查重点包括 URL 处理、图片输出、消息边界、焦点切换、运行时隔离与导航 …
本地审查快照 本记录描述基于 v1.2.0 下游版本基线的本地源码修改与测试结果。 范围 审查开始时主题位于 f8f476e,共享工作树中已有下游站点维护、紧凑侧栏修改,以及进行中的英文文档修订。这些工作均被保留。审查期间,原有侧栏修复被单独提交为 8f1f08d,对应文件内容未发生变化。 本次覆盖主题自有检查器、运行时单元测试、合成输出夹具、真实双语文档站,以及两类下游站点:DDIA 图书和 SILO 大型文档树。源码检查重点包括 URL 处理、图片输出、消息边界、焦点切换、运行时隔离与导航 …
-
OINK 1.5.1 发布就绪审查,2026-11-06
本地修复验收完成 下述三个已复现的回归已在工作树中修复,针对性检查、主题、站点和浏览器检查全部通过。这份带日期的审查不代表版本发布、消费者升级或部署。 输入与方法 审查范围为主题 v1.5.0(84b93e4)至 c55849e:标签后的全部六个提交、186 个变更文件。文档站版本为 43990ac。主题 main 比 origin/main(d9ad654)领先三个已提交的变更。初始审查前,两棵工作树均干净。下文保留初始证据,并单独记录后续修复。本轮未打标签、推送、升级消费者或部署。 正式本 …
本地修复验收完成 下述三个已复现的回归已在工作树中修复,针对性检查、主题、站点和浏览器检查全部通过。这份带日期的审查不代表版本发布、消费者升级或部署。 输入与方法 审查范围为主题 v1.5.0(84b93e4)至 c55849e:标签后的全部六个提交、186 个变更文件。文档站版本为 43990ac。主题 main 比 origin/main(d9ad654)领先三个已提交的变更。初始审查前,两棵工作树均干净。下文保留初始证据,并单独记录后续修复。本轮未打标签、推送、升级消费者或部署。 正式本 …
-
译文对照
已随 OINK 1.5.0 发布 本决策记录正式发布的 params.ui.compare 译文对照阅读器。 外壳契约定义阅读器及其控件,架构契约定义浏览器边界。多语言指南说明站点设置,日期研究保留此前的源码调研。 背景 翻译文档常常需要并排阅读和审校。缺少原生支持时,读者只能同时打开两个浏览器标签页并分别手动滚动。如果为此设计专门的布局或在构建期预生成语言配对页面,会导致页面数量成倍膨胀、内容重复。由于 OINK 站点原本就将每篇译文发布为独立的标准 HTML 页面并共享标题 ID,浏览器端 …
已随 OINK 1.5.0 发布 本决策记录正式发布的 params.ui.compare 译文对照阅读器。 外壳契约定义阅读器及其控件,架构契约定义浏览器边界。多语言指南说明站点设置,日期研究保留此前的源码调研。 背景 翻译文档常常需要并排阅读和审校。缺少原生支持时,读者只能同时打开两个浏览器标签页并分别手动滚动。如果为此设计专门的布局或在构建期预生成语言配对页面,会导致页面数量成倍膨胀、内容重复。由于 OINK 站点原本就将每篇译文发布为独立的标准 HTML 页面并共享标题 ID,浏览器端 …
-
设计研究
带日期的研究记录 研究记录保存特定实验的测量结果、输入与工具版本。当前行为以 Design 契约为准,并按工具链契约在 Hugo Extended 0.168.0 上验证。 只有其他维护者能够检查方法、理解范围并复现相关检查时,研究才适合进入公开 Design 内容树。 请勿将原始 Agent 对话、临时构建日志和本机绝对路径写入研究记录。 研究地图 记录 证据 Goldmark 块属性 该研究记录的历史 Hugo 版本上,渲染钩子能看到什么,以及 CommonMark 容器的边界 消费站与迁 …
带日期的研究记录 研究记录保存特定实验的测量结果、输入与工具版本。当前行为以 Design 契约为准,并按工具链契约在 Hugo Extended 0.168.0 上验证。 只有其他维护者能够检查方法、理解范围并复现相关检查时,研究才适合进入公开 Design 内容树。 请勿将原始 Agent 对话、临时构建日志和本机绝对路径写入研究记录。 研究地图 记录 证据 Goldmark 块属性 该研究记录的历史 Hugo 版本上,渲染钩子能看到什么,以及 CommonMark 容器的边界 消费站与迁 …
-
设计与开发
OINK 1.5.1 契约 本专栏各契约描述 OINK v1.5.1。主题开发使用同级 checkout;发布验收在关闭替换与工作区后验证公开模块。 本专栏是 OINK 可长期维护的设计记录。站内其它专栏按任务讲解如何搭建站点; 这里集中说明现行不变量、这些选择背后的理由、用于比较方案的证据,以及仍处于 候选阶段的工作。 如何阅读本专栏 层次 含义 契约 兼容实现必须保留的规范性行为 决策 用于解释现行行为的已接受理由与边界 研究 带日期且不具规范性的证据,必要时应重新验证 提案 PRD 与 …
OINK 1.5.1 契约 本专栏各契约描述 OINK v1.5.1。主题开发使用同级 checkout;发布验收在关闭替换与工作区后验证公开模块。 本专栏是 OINK 可长期维护的设计记录。站内其它专栏按任务讲解如何搭建站点; 这里集中说明现行不变量、这些选择背后的理由、用于比较方案的证据,以及仍处于 候选阶段的工作。 如何阅读本专栏 层次 含义 契约 兼容实现必须保留的规范性行为 决策 用于解释现行行为的已接受理由与边界 研究 带日期且不具规范性的证据,必要时应重新验证 提案 PRD 与 …
-
Ink 与 Terminal 仍需阅读验收
发布前研究快照(2026-10-26) 本文保留 OINK 1.4.0 发布准备前的输入与测量。在 320px 视口、32px 根字号/默认字号下,页脚链接使全部四个预设出现整页溢出。Ink 与 Terminal 仍为实验预设;稳定化提案规定目标行为与晋升门禁。 Ink 应保持中性无衬线编辑风格,Terminal 应成为易读的工程手册。 两者可以通过既有字体角色和共用外壳形成连贯的官方风格。新增衬线身份会削弱 Ink 与未来 Folio 的区别,模拟终端则会削弱工程长文阅读。近期工作应聚焦共用 …
发布前研究快照(2026-10-26) 本文保留 OINK 1.4.0 发布准备前的输入与测量。在 320px 视口、32px 根字号/默认字号下,页脚链接使全部四个预设出现整页溢出。Ink 与 Terminal 仍为实验预设;稳定化提案规定目标行为与晋升门禁。 Ink 应保持中性无衬线编辑风格,Terminal 应成为易读的工程手册。 两者可以通过既有字体角色和共用外壳形成连贯的官方风格。新增衬线身份会削弱 Ink 与未来 Folio 的区别,模拟终端则会削弱工程长文阅读。近期工作应聚焦共用 …
-
审查修复,2026-11-06
开发验证记录 本文记录 v1.5.0 之后的本地修改,不代表新版本已发布、消费者已升级或站点已部署。原报告约 170 项意见并未全部确认或修复。 输入与方法 本次审查以主题 84b93e4 与文档站 a8eeb92 为起点。候选修改保留 Hugo Extended 0.168.0 与内置 LibSass;本机环境为 macOS ARM64、Go 1.27.3、Node 26.12.0、npm 11.20.0、Python 3.14.8。普通系统路径上的 Hugo 0.169.0 不属于 本轮验 …
开发验证记录 本文记录 v1.5.0 之后的本地修改,不代表新版本已发布、消费者已升级或站点已部署。原报告约 170 项意见并未全部确认或修复。 输入与方法 本次审查以主题 84b93e4 与文档站 a8eeb92 为起点。候选修改保留 Hugo Extended 0.168.0 与内置 LibSass;本机环境为 macOS ARM64、Go 1.27.3、Node 26.12.0、npm 11.20.0、Python 3.14.8。普通系统路径上的 Hugo 0.169.0 不属于 本轮验 …
-
显式开启表格阅读
已随 OINK 1.4.0 发布 本决策记录正式发布的 .expand 表格阅读行为。 组件契约定义行为,表格指南说明作者语法,日期研究保留此前的方案比较。 背景 大多数文档表格适合直接阅读,只有少数扩展包、参数或兼容性表格需要更大的空间。在每个表格上方添加工具栏,会为偶尔使用的功能增加视觉负担。此前原型比较了角落直接展开按钮和悬停显示的省略号菜单。 决策 作者通过 .expand 为单个 Markdown 表格启用原生阅读对话框。.wide 独立控制表格的自然宽度,{.wide …
已随 OINK 1.4.0 发布 本决策记录正式发布的 .expand 表格阅读行为。 组件契约定义行为,表格指南说明作者语法,日期研究保留此前的方案比较。 背景 大多数文档表格适合直接阅读,只有少数扩展包、参数或兼容性表格需要更大的空间。在每个表格上方添加工具栏,会为偶尔使用的功能增加视觉负担。此前原型比较了角落直接展开按钮和悬停显示的省略号菜单。 决策 作者通过 .expand 为单个 Markdown 表格启用原生阅读对话框。.wide 独立控制表格的自然宽度,{.wide …
-
组件精修验证,2026-10-25
本地验收记录 本轮组件修改的 第 0–3 阶段与第 5 阶段最终验收 已完成。滑动选中背景试验继续暂缓。 输入与方法 最终评审使用隔离的同级 checkout,基于主题 7f9589f 和文档 855d890,只叠加本任务的源码修改。并行进行的 PlantUML、工具链和工作流修改未混入验收候选,并保留在共享工作区。已验收的实现对应主题提交 15c39ef;指南、契约、示例和浏览器覆盖对应文档提交 81e2be9。 验证环境为 macOS ARM64、Hugo Extended 0.168.0 …
本地验收记录 本轮组件修改的 第 0–3 阶段与第 5 阶段最终验收 已完成。滑动选中背景试验继续暂缓。 输入与方法 最终评审使用隔离的同级 checkout,基于主题 7f9589f 和文档 855d890,只叠加本任务的源码修改。并行进行的 PlantUML、工具链和工作流修改未混入验收候选,并保留在共享工作区。已验收的实现对应主题提交 15c39ef;指南、契约、示例和浏览器覆盖对应文档提交 81e2be9。 验证环境为 macOS ARM64、Hugo Extended 0.168.0 …
-
将博客文章呈现为画廊
已随 OINK 1.4.0 发布 本决策记录正式发布的博客画廊视图及其兼容边界。 外壳契约定义行为; 设计博客介绍阅读体验; 创作指南提供配置方法。 背景 有些博客栏目更适合通过封面浏览。现有的水平条目、卡片和表格都优先呈现文章 信息。Expo 已有展墙几何算法,但其相册资源模型与图片查看器面向另一种内容 和点击目的地。 决策 画廊作为第四种 blog_index 形态,沿用其他博客视图的分页结果和特色图片 解析器。文章保留 URL 与元数据,作者无需在相册清单里重复登记。 共享 Expo 的 …
已随 OINK 1.4.0 发布 本决策记录正式发布的博客画廊视图及其兼容边界。 外壳契约定义行为; 设计博客介绍阅读体验; 创作指南提供配置方法。 背景 有些博客栏目更适合通过封面浏览。现有的水平条目、卡片和表格都优先呈现文章 信息。Expo 已有展墙几何算法,但其相册资源模型与图片查看器面向另一种内容 和点击目的地。 决策 画廊作为第四种 blog_index 形态,沿用其他博客视图的分页结果和特色图片 解析器。文章保留 URL 与元数据,作者无需在相册清单里重复登记。 共享 Expo 的 …
-
设计决策
已接受的理由 决策记录解释 OINK 为什么在多个兼容方案中选择了当前设计。上方五份契约仍是 现行行为的规范描述;实现与归属检查器仍是可执行事实。 OINK 过去把评审、PRD 与执行记录放在本地 plan/ 目录中。这样既不便发现有价值的 推理,也容易让已经放弃的设计看起来仍有权威。已经接受的理由现在统一进入这座双语、 版本化的文档站,与它所支撑的契约放在一起。 决策地图 决策 解决的问题 警告与安全回退 为什么普通预览能容忍错误输入,而发布仍保持严格 配置模型 配置放在哪里、页面如何覆盖, …
已接受的理由 决策记录解释 OINK 为什么在多个兼容方案中选择了当前设计。上方五份契约仍是 现行行为的规范描述;实现与归属检查器仍是可执行事实。 OINK 过去把评审、PRD 与执行记录放在本地 plan/ 目录中。这样既不便发现有价值的 推理,也容易让已经放弃的设计看起来仍有权威。已经接受的理由现在统一进入这座双语、 版本化的文档站,与它所支撑的契约放在一起。 决策地图 决策 解决的问题 警告与安全回退 为什么普通预览能容忍错误输入,而发布仍保持严格 配置模型 配置放在哪里、页面如何覆盖, …
-
让 Ink 与 Terminal 成为稳定的阅读风格
草案——稳定化升级受阻 放大字体会使共用页脚溢出。 在 320px 视口、32px 根字号/默认字号下,英文 Ink 的文档宽度达到 424px,Terminal 达到 408px。对比覆盖样式没有修复这一共用缺陷。两份原型均未稳定,也未获准升级为稳定预设。 状态、归属与范围 状态与日期:草案,2026-10-26;提出设计方向,不是实现契约 最终负责人:OINK 维护者;分别记录每个预设的验收决定 交付归属:主题维护者负责 CSS、解析器与专项检查器;文档维护者负责双语契约、真实站点夹具与浏 …
草案——稳定化升级受阻 放大字体会使共用页脚溢出。 在 320px 视口、32px 根字号/默认字号下,英文 Ink 的文档宽度达到 424px,Terminal 达到 408px。对比覆盖样式没有修复这一共用缺陷。两份原型均未稳定,也未获准升级为稳定预设。 状态、归属与范围 状态与日期:草案,2026-10-26;提出设计方向,不是实现契约 最终负责人:OINK 维护者;分别记录每个预设的验收决定 交付归属:主题维护者负责 CSS、解析器与专项检查器;文档维护者负责双语契约、真实站点夹具与浏 …
-
Expo 图片收藏布局
OINK 1.3.0 新增 Expo 随 OINK v1.3.0 提供。 Expo 契约规定实现行为, 创作指南说明如何创建相册。 背景 Docs 组织说明,Blog 组织文章,Book 组织章节。Expo 按主题和相册组织图片收藏。 读者需要浏览相册、选择图片,并查看细节。 Graph 实验使用已有收藏的独立副本,包含 149 个相册、7,658 张原图。 其中有不同尺寸的图片、长图、GIF、说明和已有引用锚点。 这份收藏提供了最初的内容与规模需求。 选择 每个相册对应一个页面包 一个相册对 …
OINK 1.3.0 新增 Expo 随 OINK v1.3.0 提供。 Expo 契约规定实现行为, 创作指南说明如何创建相册。 背景 Docs 组织说明,Blog 组织文章,Book 组织章节。Expo 按主题和相册组织图片收藏。 读者需要浏览相册、选择图片,并查看细节。 Graph 实验使用已有收藏的独立副本,包含 149 个相册、7,658 张原图。 其中有不同尺寸的图片、长图、GIF、说明和已有引用锚点。 这份收藏提供了最初的内容与规模需求。 选择 每个相册对应一个页面包 一个相册对 …
-
2026-09-29 CLI 验收快照
历史 CLI 验收快照(2026-09-29) 本文记录 2026-09-29 对本地 0.1.0-dev CLI 候选(提交 e623d93)的验收检查。当前 CLI 行为以 CLI 与结果契约为准。 输入与方法 CLI 位于独立的 oink-cli Go 仓库。已接受的边界见 CLI 与结果契约,可复现的用户步骤见 CLI 简介。Hugo 继续作为外部渲染器,生成站点保留普通 Hugo 输入。 输入 观察到的基线 主机 macOS,darwin/arm64 Go go1.27.1 Hugo …
历史 CLI 验收快照(2026-09-29) 本文记录 2026-09-29 对本地 0.1.0-dev CLI 候选(提交 e623d93)的验收检查。当前 CLI 行为以 CLI 与结果契约为准。 输入与方法 CLI 位于独立的 oink-cli Go 仓库。已接受的边界见 CLI 与结果契约,可复现的用户步骤见 CLI 简介。Hugo 继续作为外部渲染器,生成站点保留普通 Hugo 输入。 输入 观察到的基线 主机 macOS,darwin/arm64 Go go1.27.1 Hugo …
-
文档对照研究,2026-10-29
历史研究;请参阅 1.5.0 决策 研究日期:2026-10-29。本记录是针对 OINK v1.4.0 的有界源码审查,为 OINK 1.5.0 的译文阅读器提供依据。 已接受决策与外壳契约描述已发布行为,并取代下文建议。 范围与证据 本次问题是:OINK 如何为约 30–40 个本地站点提供通用对照阅读模式,覆盖译文、八语言集合、校对书籍、任意语言,以及同一语言的新旧版本。研究检查了 Docusaurus、VitePress、Material for MkDocs 与 mike、Read …
历史研究;请参阅 1.5.0 决策 研究日期:2026-10-29。本记录是针对 OINK v1.4.0 的有界源码审查,为 OINK 1.5.0 的译文阅读器提供依据。 已接受决策与外壳契约描述已发布行为,并取代下文建议。 范围与证据 本次问题是:OINK 如何为约 30–40 个本地站点提供通用对照阅读模式,覆盖译文、八语言集合、校对书籍、任意语言,以及同一语言的新旧版本。研究检查了 Docusaurus、VitePress、Material for MkDocs 与 mike、Read …
-
2026-10-03 CLI 维护验收:R6–R8 与 A18
属于CLI 维护验收记录 带日期记录中的 R6–R8 与 A18 小节于 2026-11-06 原样迁移至此,使每个页面都能被完整读取。 范围、证据规则、验收案例台账与交付状态仍保留在主页面。 R6 工作区与适配器验收证据 R6 受支持范围在冻结归属/运行时、精确二进制消费者一致性/保护及受保护规范 源码/渲染门禁后已本地接受。受支持登记/工具字段归属 契约与 命令契约。 A07 适配器与 A15 工作区/直接/context 受支持范围通过下列门禁。 登记独立版本为 …
属于CLI 维护验收记录 带日期记录中的 R6–R8 与 A18 小节于 2026-11-06 原样迁移至此,使每个页面都能被完整读取。 范围、证据规则、验收案例台账与交付状态仍保留在主页面。 R6 工作区与适配器验收证据 R6 受支持范围在冻结归属/运行时、精确二进制消费者一致性/保护及受保护规范 源码/渲染门禁后已本地接受。受支持登记/工具字段归属 契约与 命令契约。 A07 适配器与 A15 工作区/直接/context 受支持范围通过下列门禁。 登记独立版本为 …
-
2026-10-03 CLI 维护验收:R1–R5
属于CLI 维护验收记录 带日期记录中的 R1–R5 小节于 2026-11-06 原样迁移至此,使每个页面都能被完整读取。 范围、证据规则、验收案例台账与交付状态仍保留在主页面。 R1 本地验证 R1 现已提供共享 Hugo 页面/翻译/来源事实、产物引用与锚点证据、严格 oink.policy/v1 输入、check links、--format json、可见的经审阅排除/外部范围, 以及必需工作优先级。翻译和风格选择明确报告必需但不支持的覆盖。 默认 build/dev 继续直接调用 …
属于CLI 维护验收记录 带日期记录中的 R1–R5 小节于 2026-11-06 原样迁移至此,使每个页面都能被完整读取。 范围、证据规则、验收案例台账与交付状态仍保留在主页面。 R1 本地验证 R1 现已提供共享 Hugo 页面/翻译/来源事实、产物引用与锚点证据、严格 oink.policy/v1 输入、check links、--format json、可见的经审阅排除/外部范围, 以及必需工作优先级。翻译和风格选择明确报告必需但不支持的覆盖。 默认 build/dev 继续直接调用 …
-
2026-10-03 CLI 维护验收
历史源码与二进制证据 本记录保留 2026-10-03 至 2026-10-04 的 R1–R8/A18 本地验收证据,含初始审计、 中间试验及三个支持目标的运行时与归档验证。2026-10-04 的 CLI 精简与 Cobra/文本/JSON/YAML 界面以当前契约和CLI 简介为准。这些结果仅对应当时记录的源码与二进制,后续精简 CLI 的改动需独立验证。 范围与证据规则 维护路线图 定义已授权的 R1–R8 范围,当前 CLI 契约 定义兼容基线。原路线图 中的 Docsy 迁移、版本 …
历史源码与二进制证据 本记录保留 2026-10-03 至 2026-10-04 的 R1–R8/A18 本地验收证据,含初始审计、 中间试验及三个支持目标的运行时与归档验证。2026-10-04 的 CLI 精简与 Cobra/文本/JSON/YAML 界面以当前契约和CLI 简介为准。这些结果仅对应当时记录的源码与二进制,后续精简 CLI 的改动需独立验证。 范围与证据规则 维护路线图 定义已授权的 R1–R8 范围,当前 CLI 契约 定义兼容基线。原路线图 中的 Docsy 迁移、版本 …
-
四种视觉预设的组件精修
OINK 1.4.0 已接受 共用组件样式与三个可选呈现变体随 1.4.0 发布。 行为归属组件契约, 对照指南集中展示这些变体。 背景 Cards、折叠区、Tabs 和代码控件逐渐积累了不同的间距、边框与反馈方式。 这次精修保留熟悉的创作语法,让相关组件的呈现更加一致。 带日期的评审记录了 实现与验收证据,包括最初的分阶段计划。 已接受的样式规则 沿用现有的页面、内容与浮动表面 token。独立卡片拥有自己的边界,分组列表共用 外框和内部分隔线。嵌套代码块与表格避免叠加多余边框。 按下反馈保 …
OINK 1.4.0 已接受 共用组件样式与三个可选呈现变体随 1.4.0 发布。 行为归属组件契约, 对照指南集中展示这些变体。 背景 Cards、折叠区、Tabs 和代码控件逐渐积累了不同的间距、边框与反馈方式。 这次精修保留熟悉的创作语法,让相关组件的呈现更加一致。 带日期的评审记录了 实现与验收证据,包括最初的分阶段计划。 已接受的样式规则 沿用现有的页面、内容与浮动表面 token。独立卡片拥有自己的边界,分组列表共用 外框和内部分隔线。嵌套代码块与表格避免叠加多余边框。 按下反馈保 …
-
Paper 与 Slate 视觉预设
OINK 1.2.0 Paper 与 Slate 已随 1.2.0 发布。Ink 与 Terminal 作为显式启用的风格一同提供, 后续设计工作见下文记录。 决策 Paper 成为默认,使用暖纸色与墨色、蓝色链接、IBM Plex Sans、标题细线和外框 表格。Slate 保留 v1.1.0 色板、Inter/Chakra/Plex Mono 字体角色与 Landing 网格、 光晕。这样为阅读站点提供更安静的默认外观,同时保留明确的兼容选项。代价是默认 外观发生可见变化:原站点可设置 …
OINK 1.2.0 Paper 与 Slate 已随 1.2.0 发布。Ink 与 Terminal 作为显式启用的风格一同提供, 后续设计工作见下文记录。 决策 Paper 成为默认,使用暖纸色与墨色、蓝色链接、IBM Plex Sans、标题细线和外框 表格。Slate 保留 v1.1.0 色板、Inter/Chakra/Plex Mono 字体角色与 Landing 网格、 光晕。这样为阅读站点提供更安静的默认外观,同时保留明确的兼容选项。代价是默认 外观发生可见变化:原站点可设置 …
-
OINK 迁移边界
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 本页定义维护者迁移工具与配置边界;面向读者的升级步骤见 版本升级。 工具范围 bin/migrations/oink06.py 只扫描和自动改写站点内容目录下的 Markdown 文件, 包括受支持的 YAML front matter。它不改写 Hugo 配置、数据文件、布局、资源、 模块或生成输出。TOML/JSON front matter 与有歧义的 Markdown 会连同位置一起报告, 留给人工检查。 默认执行 …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 本页定义维护者迁移工具与配置边界;面向读者的升级步骤见 版本升级。 工具范围 bin/migrations/oink06.py 只扫描和自动改写站点内容目录下的 Markdown 文件, 包括受支持的 YAML front matter。它不改写 Hugo 配置、数据文件、布局、资源、 模块或生成输出。TOML/JSON front matter 与有歧义的 Markdown 会连同位置一起报告, 留给人工检查。 默认执行 …
-
可选 CLI 与结果契约
当前范围;本地候选 本契约描述 2026-10-04 收缩后的本地 0.1.0-dev 命令界面。保留站点诊断、 真实 Hugo 检查、初始化、构建、升级及有保护的维护计划;使用 Cobra、默认彩色 英文文本与 JSON/YAML 结果。Studio、通用编辑、context、snippets、editor 与 CI 生成已撤下。历史 R1–R8 验收只对记录中的源码和二进制成立,不能替代当前验证。 CLI 目前为本地候选版本,尚未作为独立版本或 Homebrew 软件包发布。 背景与归属 …
当前范围;本地候选 本契约描述 2026-10-04 收缩后的本地 0.1.0-dev 命令界面。保留站点诊断、 真实 Hugo 检查、初始化、构建、升级及有保护的维护计划;使用 Cobra、默认彩色 英文文本与 JSON/YAML 结果。Studio、通用编辑、context、snippets、editor 与 CI 生成已撤下。历史 R1–R8 验收只对记录中的源码和二进制成立,不能替代当前验证。 CLI 目前为本地候选版本,尚未作为独立版本或 Homebrew 软件包发布。 背景与归属 …
-
OINK 1.1 发布审查,2026-09-20
历史发布审查(2026-09-20) 本文记录 OINK 1.1 发布前的验证快照与五项运行时修复,文末附有 v1.1.0 发布后续记录。 范围与基线 审查从主题提交 75052f8a3106d13ef313644836a5ad545135f484 开始,此时社区反馈与图片复制修复已经进入 main。范围包括 v1.0.0..main 差异、 #40、 #41、 #42、 #44 与已合并 PR #43 所要求的行为,以及双语文档和发布边界。 前一轮调研 记录了原始反馈及其实施过程。 方法是检 …
历史发布审查(2026-09-20) 本文记录 OINK 1.1 发布前的验证快照与五项运行时修复,文末附有 v1.1.0 发布后续记录。 范围与基线 审查从主题提交 75052f8a3106d13ef313644836a5ad545135f484 开始,此时社区反馈与图片复制修复已经进入 main。范围包括 v1.0.0..main 差异、 #40、 #41、 #42、 #44 与已合并 PR #43 所要求的行为,以及双语文档和发布边界。 前一轮调研 记录了原始反馈及其实施过程。 方法是检 …
-
Expo 布局契约
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 本页规定实现必须遵循的行为。创建内容请阅读 Expo 相册, 设计理由见设计决策。 内容与导航 type: expo 选择相册布局,分区可通过 cascade 将其应用到下级页面。 一个相册对应一个 Hugo 叶子页面包,包含 index.md 和 images/ 目录。 图片元数据放在相册 front matter 的 resources 中,无需为每张图片单独创建内容文件。 分区页面列出下级主题和相册。共享导航树支持嵌套分区 …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 本页规定实现必须遵循的行为。创建内容请阅读 Expo 相册, 设计理由见设计决策。 内容与导航 type: expo 选择相册布局,分区可通过 cascade 将其应用到下级页面。 一个相册对应一个 Hugo 叶子页面包,包含 index.md 和 images/ 目录。 图片元数据放在相册 front matter 的 resources 中,无需为每张图片单独创建内容文件。 分区页面列出下级主题和相册。共享导航树支持嵌套分区 …
-
视觉预设与外观切换
第一阶段随 1.2.0 发布,Ink/Terminal 可显式启用 Paper、Slate 与外观菜单已随 OINK 1.2.0 发布。当前行为与证据由 架构契约、 已接受决策和 验收记录管理。 随后的 Ink/Terminal 实验提供真实可切换输出;本提案继续承载两者的设计定稿。10 月 4 日注入样式生成的截图仍是研究原型, 与 10 月 5 日真实主题输出截图分开看待。 状态与影响面 字段 值 状态 第一阶段随 1.2.0 发布;Ink/Terminal 显式启用 负责人 OINK 维 …
第一阶段随 1.2.0 发布,Ink/Terminal 可显式启用 Paper、Slate 与外观菜单已随 OINK 1.2.0 发布。当前行为与证据由 架构契约、 已接受决策和 验收记录管理。 随后的 Ink/Terminal 实验提供真实可切换输出;本提案继续承载两者的设计定稿。10 月 4 日注入样式生成的截图仍是研究原型, 与 10 月 5 日真实主题输出截图分开看待。 状态与影响面 字段 值 状态 第一阶段随 1.2.0 发布;Ink/Terminal 显式启用 负责人 OINK 维 …
-
生成式配置 Schema
决策 schema/ 下的两份 JSON Schema 由 bin/generate-config-schema.py 从主题的 hugo.yaml 与模板读取点投影生成,手工编辑无法通过 CI。Schema 是既有权威的 只读投影,不是第三个配置权威。 背景 主题已有两个配置权威:hugo.yaml 在注释旁声明每个默认值;check-params.py 的读取点扫描知道模板实际消费的每一个键。编辑器对两者一无所知,作者只能凭记忆 敲 params.ui.* 和 front matter。 …
决策 schema/ 下的两份 JSON Schema 由 bin/generate-config-schema.py 从主题的 hugo.yaml 与模板读取点投影生成,手工编辑无法通过 CI。Schema 是既有权威的 只读投影,不是第三个配置权威。 背景 主题已有两个配置权威:hugo.yaml 在注释旁声明每个默认值;check-params.py 的读取点扫描知道模板实际消费的每一个键。编辑器对两者一无所知,作者只能凭记忆 敲 params.ui.* 和 front matter。 …
-
落地页契约
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 共享规则见架构契约与 组件契约;迁移行为属于 迁移边界。 外壳与数据 任何普通页面都可以声明 layout: landing。它渲染顶部导航栏、全宽画布与页脚, 不显示 docs 侧栏或 TOC 导轨。首页继续把 data/home/<lang>.yaml 作为兼容的创作 路径,并通过同一个渲染器处理。 非首页依次从内联 front matter、data/landing/<key>/<lang>.yaml、单个 …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 共享规则见架构契约与 组件契约;迁移行为属于 迁移边界。 外壳与数据 任何普通页面都可以声明 layout: landing。它渲染顶部导航栏、全宽画布与页脚, 不显示 docs 侧栏或 TOC 导轨。首页继续把 data/home/<lang>.yaml 作为兼容的创作 路径,并通过同一个渲染器处理。 非首页依次从内联 front matter、data/landing/<key>/<lang>.yaml、单个 …
-
社区 Issue 与 PR 调研,2026-09-19
历史调研快照(2026-09-19) 本文记录 2026-09-19 的源码审查、GitHub 状态、本地构建与定向浏览器观察,文末附有同日实施与验收补记。 以下保留最初的调研快照。随后维护者决定先合并 PR #43,再直接在 main 实施其余修复; 最新进展见同日实施与验收补记。 判断结论 这些反馈都有值得处理的内容,但不能全部归为同一种缺陷。应优先修复隐藏导航仍能获得焦点的问题。 PR #43 的小修复方向正确,明确边界并补齐测试后可以接收。搜索尾部扩展与侧栏状态公开接口则属于 新增 …
历史调研快照(2026-09-19) 本文记录 2026-09-19 的源码审查、GitHub 状态、本地构建与定向浏览器观察,文末附有同日实施与验收补记。 以下保留最初的调研快照。随后维护者决定先合并 PR #43,再直接在 main 实施其余修复; 最新进展见同日实施与验收补记。 判断结论 这些反馈都有值得处理的内容,但不能全部归为同一种缺陷。应优先修复隐藏导航仍能获得焦点的问题。 PR #43 的小修复方向正确,明确边界并补齐测试后可以接收。搜索尾部扩展与侧栏状态公开接口则属于 新增 …
-
OINK CLI 文档维护路线图
已实现需求记录 本记录保留 R1–R8 的原始需求排期与锚点。当前 CLI 行为归属 CLI 契约与CLI 简介,历史验收证据归属 2026-10-04 增补。 条件性扩展 E1–E4 尚未启动。 先完成文档维护,再建立本地可视化工作台。产品应当帮助维护者检查修改、理解影响、 审阅安全变更,并发布刚才通过检查的同一份产物。Studio 使用这些相同能力。 记录 内容 状态 R1–R8 与 A18 已在本地实现并完成验收 负责人 OINK 维护者 日期 2026-10-03 已有基线 本地 …
已实现需求记录 本记录保留 R1–R8 的原始需求排期与锚点。当前 CLI 行为归属 CLI 契约与CLI 简介,历史验收证据归属 2026-10-04 增补。 条件性扩展 E1–E4 尚未启动。 先完成文档维护,再建立本地可视化工作台。产品应当帮助维护者检查修改、理解影响、 审阅安全变更,并发布刚才通过检查的同一份产物。Studio 使用这些相同能力。 记录 内容 状态 R1–R8 与 A18 已在本地实现并完成验收 负责人 OINK 维护者 日期 2026-10-03 已有基线 本地 …
-
外壳与导航契约
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 权威来源与导航 关注点 权威来源 全局导航 Hugo menus.main Docs / Book 侧栏与翻页 内容树或 data/docs_nav.json 根栏目切换器 解析后的顶层内容根 内容发现 各语言的本地搜索索引 页面与命令面板操作 共享操作注册表 任何功能都不能引入另一套菜单或页面树。菜单只允许一层子项交互;更深层级会警告, 并平铺到带链接的分组标题下。外部链接使用 target="_blank" …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 权威来源与导航 关注点 权威来源 全局导航 Hugo menus.main Docs / Book 侧栏与翻页 内容树或 data/docs_nav.json 根栏目切换器 解析后的顶层内容根 内容发现 各语言的本地搜索索引 页面与命令面板操作 共享操作注册表 任何功能都不能引入另一套菜单或页面树。菜单只允许一层子项交互;更深层级会警告, 并平铺到带链接的分组标题下。外部链接使用 target="_blank" …
-
Markdown 优先创作
决策 Goldmark 能保留目标语义时,优先提供原生 Markdown 形态。只有原生形态无法表达真实能力时, 才保留 shortcode。新增内容场景时延长既有外壳和数据模型,不另建一套并行渲染系统。 背景 OINK 同时服务短手册、大型参考文档、发布归档、落地页和书籍。对十一个消费站点、五千多篇 Markdown 的盘点呈现了两个极端:有些页面几乎不用主题语法,有些页面则由大量嵌套 shortcode 与站点自有 layout 拼成。 只为后一类优化的组件 API 会变成私有 DSL;只 …
决策 Goldmark 能保留目标语义时,优先提供原生 Markdown 形态。只有原生形态无法表达真实能力时, 才保留 shortcode。新增内容场景时延长既有外壳和数据模型,不另建一套并行渲染系统。 背景 OINK 同时服务短手册、大型参考文档、发布归档、落地页和书籍。对十一个消费站点、五千多篇 Markdown 的盘点呈现了两个极端:有些页面几乎不用主题语法,有些页面则由大量嵌套 shortcode 与站点自有 layout 拼成。 只为后一类优化的组件 API 会变成私有 DSL;只 …
-
OINK CLI 与下一阶段产品路线
首期为本地候选,后续路线仍是草案 用户于 2026-09-29 授权独立 Go 仓库 pgsty/oink-cli 及首期开发。六个命令已有本地 0.1.0-dev 实现,最终本地验收单独记录。当前行为归属 CLI 决策与结果契约及CLI 简介。主题 1.2、工具能力描述、Docsy 迁移、版本生命周期、OpenAPI、MCP 与 Studio 保持提案状态。 记录 内容 状态 仓库选择与首期范围已接受;本地候选已实现并验证;后续路线保持草案 负责人 OINK 维护者 日期 …
首期为本地候选,后续路线仍是草案 用户于 2026-09-29 授权独立 Go 仓库 pgsty/oink-cli 及首期开发。六个命令已有本地 0.1.0-dev 实现,最终本地验收单独记录。当前行为归属 CLI 决策与结果契约及CLI 简介。主题 1.2、工具能力描述、Docsy 迁移、版本生命周期、OpenAPI、MCP 与 Studio 保持提案状态。 记录 内容 状态 仓库选择与首期范围已接受;本地候选已实现并验证;后续路线保持草案 负责人 OINK 维护者 日期 …
-
OINK 全面审查(2026-08-26)
历史审查快照(2026-08-26) 本文记录 2026-08-26 对 github.com/pgsty/oink 主线与本站集成面的审查证据。 OINK 0.7.1 随后修复了代码发现 F01–F06(见 0.7.1 发布说明)。当前行为以 Design 契约为准。 审查结论 OINK 的主干质量明显高于一般 Hugo 主题:默认路径可构建、双语完整、组件测试广、输出与安全意识强, 真实站点在桌面、移动端、深浅色和无障碍主路径上没有发现普遍性崩坏。当前 main 与远端一致, 主题 CI …
历史审查快照(2026-08-26) 本文记录 2026-08-26 对 github.com/pgsty/oink 主线与本站集成面的审查证据。 OINK 0.7.1 随后修复了代码发现 F01–F06(见 0.7.1 发布说明)。当前行为以 Design 契约为准。 审查结论 OINK 的主干质量明显高于一般 Hugo 主题:默认路径可构建、双语完整、组件测试广、输出与安全意识强, 真实站点在桌面、移动端、深浅色和无障碍主路径上没有发现普遍性崩坏。当前 main 与远端一致, 主题 CI …
-
组件契约
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 教程与完整示例位于面向读者的组件专栏。本页定义这些 指南所依赖的 API 与行为。 创作模型 一个区块加属性便能表达组件时,使用普通 Markdown;需要复合正文或 Markdown 无法携带的事实时,使用 shortcode。OINK 没有并行的组件注册表。原生形态要求: markup: goldmark: renderer: { unsafe: true } parser: …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 教程与完整示例位于面向读者的组件专栏。本页定义这些 指南所依赖的 API 与行为。 创作模型 一个区块加属性便能表达组件时,使用普通 Markdown;需要复合正文或 Markdown 无法携带的事实时,使用 shortcode。OINK 没有并行的组件注册表。原生形态要求: markup: goldmark: renderer: { unsafe: true } parser: …
-
消费站与迁移证据
带日期的语料快照 这些计数记录 2026 年 8 月检查过的仓库样本,用于指导 OINK 外壳、组件与 Book 迁移设计。 语料 创作语料盘点扫描了十一个 OINK 下游站点的 content/ 树:共 5,325 个 Markdown 文件,其中 5,293 个带 YAML front matter。样本同时包含单语言英文与中文参考站、双语产品站、发布归档、 自定义落地页,以及独立的 Book 下游站点。 盘点直接统计源码 Markdown 中的 shortcode 调用、代码围栏属性、 …
带日期的语料快照 这些计数记录 2026 年 8 月检查过的仓库样本,用于指导 OINK 外壳、组件与 Book 迁移设计。 语料 创作语料盘点扫描了十一个 OINK 下游站点的 content/ 树:共 5,325 个 Markdown 文件,其中 5,293 个带 YAML front matter。样本同时包含单语言英文与中文参考站、双语产品站、发布归档、 自定义落地页,以及独立的 Book 下游站点。 盘点直接统计源码 Markdown 中的 shortcode 调用、代码围栏属性、 …
-
配置模型
决策 OINK 保留 Hugo 原生键与仍有价值的 Docsy 兼容键,把主题呈现和行为放在 params.ui.* 下,并用同名的顶层 front matter 键提供页面覆盖。它不增加 params.oink.* 配置树,也不建立一套遮蔽 Hugo 配置模型的注册表。 背景 OINK 继承了成熟的配置面,又增加了阅读外壳、内容输出和本地交互。早期设计曾尝试把所有 主题自有键迁入一个新命名空间,并在每页一次性解析完整配置字典。这样会在 Hugo 原生键旁边 再造一种语言,使 section …
决策 OINK 保留 Hugo 原生键与仍有价值的 Docsy 兼容键,把主题呈现和行为放在 params.ui.* 下,并用同名的顶层 front matter 键提供页面覆盖。它不增加 params.oink.* 配置树,也不建立一套遮蔽 Hugo 配置模型的注册表。 背景 OINK 继承了成熟的配置面,又增加了阅读外壳、内容输出和本地交互。早期设计曾尝试把所有 主题自有键迁入一个新命名空间,并在每页一次性解析完整配置字典。这样会在 Hugo 原生键旁边 再造一种语言,使 section …
-
媒体收敛
部分已实现 M1(共享 media-result 契约)与 M2(Landing 资源元数据)已在主题 main 分支实现; M3 已决议为方案 2:图片处理只属于原生 Markdown 图片形态,完整 fig 源形态保持 容器语义,其参数表刻意不含 command/options。M4(兼容退役)在完成消费方盘点 之前保持开放。以下各节为原始设计记录。 当前基线 正文图片钩子、编号 fig、卡片与 gallery 统一通过 content/image-resolve.html 解析页面资源、 …
部分已实现 M1(共享 media-result 契约)与 M2(Landing 资源元数据)已在主题 main 分支实现; M3 已决议为方案 2:图片处理只属于原生 Markdown 图片形态,完整 fig 源形态保持 容器语义,其参数表刻意不含 command/options。M4(兼容退役)在完成消费方盘点 之前保持开放。以下各节为原始设计记录。 当前基线 正文图片钩子、编号 fig、卡片与 gallery 统一通过 content/image-resolve.html 解析页面资源、 …
-
视觉预设验收,2026-10-05
本地验证记录 本记录覆盖 v1.2.0 打标签前同级主题 checkout 中 Paper 与 Slate 预设的真实输出验证。 输入 2026-10-05 的主题与文档站工作树;macOS ARM64,Hugo Extended 0.166.0、 Go 1.27.1、Node 26.9.0、Playwright 1.62.1。常规浏览器套件使用 Chromium; 另有 Chromium、Firefox 与 WebKit 专项检查。执行时站点固定 v1.1.0, make …
本地验证记录 本记录覆盖 v1.2.0 打标签前同级主题 checkout 中 Paper 与 Slate 预设的真实输出验证。 输入 2026-10-05 的主题与文档站工作树;macOS ARM64,Hugo Extended 0.166.0、 Go 1.27.1、Node 26.9.0、Playwright 1.62.1。常规浏览器套件使用 Chromium; 另有 Chromium、Firefox 与 WebKit 专项检查。执行时站点固定 v1.1.0, make …
-
OINK 1.2 发布前审查,2026-10-05
本地候选版本审查 本次审查覆盖 v1.2.0 打标签前的 10 月 5 日工作树。审查时公开主题标签与文档站固定版本仍为 v1.1.0。 范围与输入 主题起点为 a1979a4,文档站起点为 ed2d0e3。受检工作树还包括 CJK 关键词 摘要、字面百分号大纲与仓库源文件路径修复,站点既有的英文编辑修改,以及下列 清理。独立可选 CLI 不属于本次主题发布范围。 多数检查使用 macOS ARM64 上的 Hugo Extended 0.166.0、Go 1.27.1、 Node …
本地候选版本审查 本次审查覆盖 v1.2.0 打标签前的 10 月 5 日工作树。审查时公开主题标签与文档站固定版本仍为 v1.1.0。 范围与输入 主题起点为 a1979a4,文档站起点为 ed2d0e3。受检工作树还包括 CJK 关键词 摘要、字面百分号大纲与仓库源文件路径修复,站点既有的英文编辑修改,以及下列 清理。独立可选 CLI 不属于本次主题发布范围。 多数检查使用 macOS ARM64 上的 Hugo Extended 0.166.0、Go 1.27.1、 Node …
-
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。 首页、配置、提示块与标签页以相同内容比较四套预设 …
本地实验记录 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。 首页、配置、提示块与标签页以相同内容比较四套预设 …
-
反向链接与知识图谱
G1 已实现,G2/G3 仍是草案 2026-08-27 决议 G1 的全部待决问题并接受 G1(静态反向链接)。它已在主题 main 分支实现,随 OINK 0.8.0 发布。局部与全站图谱(G2/G3)保持草案状态,等待 G1 的 真实使用证据;它们的名称和配置在被接受之前不是公开 API。 前提 反向导航与页面连接视图是链接图的属性,不是 [[wikilink]] 拼写的属性。Hugo 已经接受普通 Markdown 链接和 ref / relref。OINK 可以从作者已经在写的内容中 …
G1 已实现,G2/G3 仍是草案 2026-08-27 决议 G1 的全部待决问题并接受 G1(静态反向链接)。它已在主题 main 分支实现,随 OINK 0.8.0 发布。局部与全站图谱(G2/G3)保持草案状态,等待 G1 的 真实使用证据;它们的名称和配置在被接受之前不是公开 API。 前提 反向导航与页面连接视图是链接图的属性,不是 [[wikilink]] 拼写的属性。Hugo 已经接受普通 Markdown 链接和 ref / relref。OINK 可以从作者已经在写的内容中 …
-
警告与安全回退
决策 OINK 不调用 Hugo 的 errorf。作者或站点输入无效时,主题发出警告,并使用文档中 明确的安全回退,或者省略无效片段。开发、CI、发布与部署统一使用 Hugo Extended 0.168.0,禁止启用 --panicOnWarning 或 HUGO_PANICONWARNING。告警保持可见, 检查器验证具体诊断与回退后的产物。 背景 Hugo 把整座站点作为一次事务构建。编辑一页时触发的 errorf 会让该次重建中的所有 URL 都返回错误,包括无关页面和首页。服务器进 …
决策 OINK 不调用 Hugo 的 errorf。作者或站点输入无效时,主题发出警告,并使用文档中 明确的安全回退,或者省略无效片段。开发、CI、发布与部署统一使用 Hugo Extended 0.168.0,禁止启用 --panicOnWarning 或 HUGO_PANICONWARNING。告警保持可见, 检查器验证具体诊断与回退后的产物。 背景 Hugo 把整座站点作为一次事务构建。编辑一页时触发的 errorf 会让该次重建中的所有 URL 都返回错误,包括无关页面和首页。服务器进 …
-
架构契约
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 Hugo 工具链 维护中的站点、开发、CI 与发布验收统一使用 OINK v1.5.1 和 Hugo Extended 0.168.0,固定这套工具链。 禁止启用 --panicOnWarning 或 HUGO_PANICONWARNING。告警保持可见并接受审阅; 上游 LibSass 弃用告警允许出现,不会让成功的构建失败。无效输入测试直接检查对应 告警和安全降级产物。 主样式与 ReDoc 样式使用 Hugo 内置 …
OINK 1.5.1 契约 本契约描述 OINK v1.5.1。 Hugo 工具链 维护中的站点、开发、CI 与发布验收统一使用 OINK v1.5.1 和 Hugo Extended 0.168.0,固定这套工具链。 禁止启用 --panicOnWarning 或 HUGO_PANICONWARNING。告警保持可见并接受审阅; 上游 LibSass 弃用告警允许出现,不会让成功的构建失败。无效输入测试直接检查对应 告警和安全降级产物。 主样式与 ReDoc 样式使用 Hugo 内置 …
-
Goldmark 块属性实测
已验证快照 这些探针在 Hugo Extended 0.160.1 与 0.164.0 上得到字节一致的相关输出。它们解释 OINK 的原生组件形态;当前 组件契约 定义现行规范。 方法 探针使用一个不带 OINK 模板的最小 Hugo 站点。渲染钩子把上下文字段与 .Attributes 输出为 可见标记。站点开启 Goldmark 块属性、行内与块级数学 passthrough 分隔符,以及为检查原始 HTML 启用的 unsafe 渲染,并设置 …
已验证快照 这些探针在 Hugo Extended 0.160.1 与 0.164.0 上得到字节一致的相关输出。它们解释 OINK 的原生组件形态;当前 组件契约 定义现行规范。 方法 探针使用一个不带 OINK 模板的最小 Hugo 站点。渲染钩子把上下文字段与 .Attributes 输出为 可见标记。站点开启 Goldmark 块属性、行内与块级数学 passthrough 分隔符,以及为检查原始 HTML 启用的 unsafe 渲染,并设置 …