3.7 KiB
3.7 KiB
Theme Profile · shannon(暗色工程证据)
这是给 AI 写作时读 的 authoring profile,不是 CSS。CSS token 由组件库 运行时主题持有(
data-theme="shannon")。本文件是"如何选择和使用这个主题"。 详尽版本见组件库 canonical md:src/theme/themes/shannon/shannon.md(写代码 / 公式 / 媒体 / Raw 前请读它)。
- runtime theme id:
shannon(<ThemeProvider theme="shannon">) - 气质:
tufte的"夜间工程版"。温暖石墨暗底、暖白墨、唯一一束琥珀信号色。 完整继承 data-ink 纪律(以线代框、内联注、去垃圾表格、色彩承载含义),只是把 场景搬到暗底的工程现场。非纯黑、非 #0D1117 赛博暗、无霓虹、无发光。
适合 / 不适合的文章类型
- 适合:
postmortem/ 故障复盘、system-design/ 架构决策、benchmark/ 性能分析、 技术 / AI / 算法explainer、review、tutorial。CodeBlockDiffReviewIncidentRiskListDecision密集的内容尤其契合。 - 不适合:需打印的正式文档(暗底费墨,打印会被强制白底);温暖叙事 / 出版随笔
(
press/knuth);10 米外观看的幻灯片。
排版气质
- 正文与标题用技术人文 sans(IBM Plex Sans → Söhne → system-ui),字重 400,靠字号取分量。
- 等宽体被刻意抬升(IBM Plex Mono / Berkeley Mono):章节号、时间戳、指标、键值 一律 mono,营造工程日志感。
- 正文 ~16px,行距 1.6;强调靠字重 / 颜色 / 间距,不用斜体(协议级禁用),不用厚黑体。
Raw 风格
像作者在暗底为当前段落手绘的一张仪表小图。
- 约束的是气质(暗底、线条化、信号克制、工程证据),不是媒介。
- 典型:暗底内联 SVG、细线折线 / 散点 / 火焰图 / 时序图、可拖动阈值线、mono 标注、 微型 sparkline、终端式状态条。
- 构图:少填充、多线条;每条线都有含义。颜色只用
--ra-*,强调用琥珀 accent 或警示红。 - 动效:默认无;必须交互只用即时响应或极轻过渡(≤120ms),不用循环装饰。
媒体(图片 / 视频 / 音频)风格
- 适合:真实监控图 / 火焰图 / trace、终端截图、架构 / 时序 / 拓扑细线图、暗底数据可视化、 低饱和产品界面局部。
- 构图暗底留白充足、主体清楚;必须配清晰 caption / source / alt;截图裁掉无关 chrome。
- 色彩贴近暗纸,强调只用琥珀或警示红承载信息。
代码 / 公式风格
CodeBlock是暗底第一公民但仍是工程证据:暗纸轻 surface + 暗发丝线,不用发光边框 / 彩色标题栏 / 玻璃拟态。行号可见但退后。- Prism token 从主题派生:结构 / 标签 / 函数用琥珀 accent,关键字 / 风险用 risk 红橙, 字符串 / 成功路径用低饱和绿。
Formula像仪表标注,块级只用发丝线与留白承载。
禁止项
- 卡片、面板、填色块、投影、圆角、发光边框;比
#45423A更亮的网格线。 - 纯黑 /
#0D1117赛博暗、霓虹高亮、彩虹语法、过饱和科技蓝紫。 - 把琥珀信号色当装饰;第二个红色用于"警示"以外;emoji / 图标当装饰。
- 媒体 / Raw 变成赛博朋克氛围视觉而非工程证据(仪表盘大屏拟物、粒子背景、玻璃拟态)。
不同信息密度下的表现建议(建议,非限制)
100% longform / postmortem:克制长文 + 工程证据,Raw 点亮关键信号 / 时序。60-80% system-design / explainer:保留核心架构图 + 代码证据,正文仍是主体。40% briefing:Raw 偏暗底图解 / 指标,文字更短,仍是文章形态。