Files
teamai-test/.teamai/skills/common/beautiful-article/theme-profiles/shannon.md
T

3.7 KiB
Raw Blame History

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 偏暗底图解 / 指标,文字更短,仍是文章形态。