65 lines
3.7 KiB
Markdown
65 lines
3.7 KiB
Markdown
# 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`。`CodeBlock` `DiffReview`
|
||
`Incident` `RiskList` `Decision` 密集的内容尤其契合。
|
||
- **不适合**：需打印的正式文档（暗底费墨，打印会被强制白底）；温暖叙事 / 出版随笔
|
||
（`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 偏暗底图解 / 指标，文字更短，仍是文章形态。
|