一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
· 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
· 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
横向流程图每步写清页面/功能/操作/完成判据。
· 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
· 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。
二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
507 lines
20 KiB
HTML
507 lines
20 KiB
HTML
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
<title>ClickHouse — reference components</title>
|
||
<meta
|
||
name="description"
|
||
content="Reference fixture for design-systems/clickhouse. Pure black canvas,
|
||
neon volt accent (#faff69), Inter Black (900) display at 96px,
|
||
charcoal-bordered cards, terminal-grade database aesthetic."
|
||
/>
|
||
|
||
<style>
|
||
:root {
|
||
--bg: #000000;
|
||
--surface: #141414;
|
||
--surface-warm: var(--surface);
|
||
|
||
--fg: #ffffff;
|
||
--fg-2: #a0a0a0;
|
||
--muted: #a0a0a0;
|
||
--meta: #585858;
|
||
|
||
--border: rgba(65, 65, 65, 0.8);
|
||
--border-soft: #343434;
|
||
|
||
--accent: #faff69;
|
||
--accent-on: #151515;
|
||
--accent-hover: #1d1d1d;
|
||
--accent-active: #f4f692;
|
||
|
||
--success: #166534;
|
||
--warn: #eab308;
|
||
--danger: #dc2626;
|
||
|
||
--font-display: "Inter", "Basier", Arial, Helvetica, ui-sans-serif, system-ui, sans-serif;
|
||
--font-body: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Arial, sans-serif;
|
||
--font-mono: "Inconsolata", ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Monaco, Consolas, monospace;
|
||
|
||
--text-xs: 12px;
|
||
--text-sm: 14px;
|
||
--text-base: 16px;
|
||
--text-lg: 20px;
|
||
--text-xl: 24px;
|
||
--text-2xl: 36px;
|
||
--text-3xl: 72px;
|
||
--text-4xl: 96px;
|
||
|
||
--leading-body: 1.5;
|
||
--leading-tight: 1.0;
|
||
--tracking-display: normal;
|
||
|
||
--space-1: 4px;
|
||
--space-2: 8px;
|
||
--space-3: 12px;
|
||
--space-4: 16px;
|
||
--space-5: 20px;
|
||
--space-6: 24px;
|
||
--space-8: 32px;
|
||
--space-12: 48px;
|
||
|
||
--section-y-desktop: 64px;
|
||
--section-y-tablet: 48px;
|
||
--section-y-phone: 32px;
|
||
|
||
--radius-sm: 4px;
|
||
--radius-md: 8px;
|
||
--radius-lg: 8px;
|
||
--radius-pill: 9999px;
|
||
|
||
--elev-flat: none;
|
||
--elev-ring: 0 0 0 1px var(--border);
|
||
--elev-raised: 0 1px 3px rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1);
|
||
|
||
--focus-ring: 0 0 0 3px color-mix(in oklab, var(--accent), transparent 70%);
|
||
|
||
--motion-fast: 150ms;
|
||
--motion-base: 200ms;
|
||
--ease-standard: cubic-bezier(0.2, 0, 0, 1);
|
||
|
||
--container-max: 1280px;
|
||
--container-gutter-desktop: 24px;
|
||
--container-gutter-tablet: 16px;
|
||
--container-gutter-phone: 12px;
|
||
}
|
||
|
||
/* ─── Reset ─────────────────────────────────────────────── */
|
||
*, *::before, *::after { box-sizing: border-box; }
|
||
html, body { margin: 0; padding: 0; }
|
||
body {
|
||
background: var(--bg);
|
||
color: var(--fg);
|
||
font-family: var(--font-body);
|
||
font-size: var(--text-base);
|
||
line-height: var(--leading-body);
|
||
-webkit-font-smoothing: antialiased;
|
||
}
|
||
|
||
/* ─── Layout ─────────────────────────────────────────────── */
|
||
.container {
|
||
max-width: var(--container-max);
|
||
margin-inline: auto;
|
||
padding-inline: var(--container-gutter-desktop);
|
||
}
|
||
section { padding-block: var(--section-y-desktop); }
|
||
section + section { border-top: 1px solid var(--border); }
|
||
@media (max-width: 1023px) {
|
||
.container { padding-inline: var(--container-gutter-tablet); }
|
||
section { padding-block: var(--section-y-tablet); }
|
||
}
|
||
@media (max-width: 639px) {
|
||
.container { padding-inline: var(--container-gutter-phone); }
|
||
section { padding-block: var(--section-y-phone); }
|
||
}
|
||
|
||
/* ─── Typography — weight IS hierarchy ──────────────────── */
|
||
h1, h2, h3 {
|
||
font-family: var(--font-display);
|
||
line-height: var(--leading-tight);
|
||
margin: 0;
|
||
color: var(--fg);
|
||
}
|
||
h1 {
|
||
font-size: var(--text-4xl);
|
||
font-weight: 900; /* Inter Black — the weapon */
|
||
letter-spacing: var(--tracking-display);
|
||
}
|
||
h2 {
|
||
font-size: var(--text-2xl);
|
||
font-weight: 600; /* Basier-style feature heading */
|
||
line-height: 1.30;
|
||
}
|
||
h3 {
|
||
font-size: var(--text-xl);
|
||
font-weight: 700;
|
||
line-height: 1.17;
|
||
}
|
||
p { margin: 0; }
|
||
.lead {
|
||
font-size: var(--text-lg);
|
||
color: var(--muted);
|
||
line-height: 1.56;
|
||
font-weight: 400;
|
||
}
|
||
.body-muted { color: var(--muted); }
|
||
.body-sm { font-size: var(--text-sm); }
|
||
.body-mono { font-family: var(--font-mono); font-weight: 600; }
|
||
/* Uppercase overline — DESIGN.md: 14px / weight 600 / 1.4px tracking */
|
||
.eyebrow {
|
||
font-size: var(--text-sm);
|
||
color: var(--muted);
|
||
text-transform: uppercase;
|
||
letter-spacing: 1.4px;
|
||
font-weight: 600;
|
||
line-height: 1.43;
|
||
}
|
||
.stack-3 > * + * { margin-block-start: var(--space-3); }
|
||
.stack-4 > * + * { margin-block-start: var(--space-4); }
|
||
.stack-5 > * + * { margin-block-start: var(--space-5); }
|
||
.stack-6 > * + * { margin-block-start: var(--space-6); }
|
||
|
||
/* ─── Buttons — sharp 4px radius, terminal-grade ────────── */
|
||
.btn {
|
||
display: inline-flex;
|
||
align-items: center;
|
||
gap: var(--space-2);
|
||
padding: 12px 16px;
|
||
border-radius: var(--radius-sm);
|
||
font-family: var(--font-body);
|
||
font-size: var(--text-base);
|
||
font-weight: 600;
|
||
line-height: 1;
|
||
cursor: pointer;
|
||
border: 1px solid var(--surface);
|
||
background: var(--surface);
|
||
color: var(--fg);
|
||
text-decoration: none;
|
||
transition: background-color var(--motion-fast) var(--ease-standard),
|
||
color var(--motion-fast) var(--ease-standard),
|
||
border-color var(--motion-fast) var(--ease-standard);
|
||
}
|
||
.btn:focus-visible { outline: none; box-shadow: var(--focus-ring); }
|
||
/* Neon Primary — the eye-catching CTA: neon-on-black, hover inverts to dark */
|
||
.btn-primary {
|
||
background: var(--accent);
|
||
color: var(--accent-on);
|
||
border-color: var(--accent);
|
||
padding: 0 16px;
|
||
height: 40px;
|
||
}
|
||
.btn-primary:hover {
|
||
background: var(--accent-hover);
|
||
color: var(--accent);
|
||
}
|
||
.btn-primary:active { color: var(--accent-active); }
|
||
/* Forest Green — the "Get Started" conversion button */
|
||
.btn-success {
|
||
background: var(--success);
|
||
color: var(--fg);
|
||
border-color: var(--surface);
|
||
}
|
||
.btn-success:hover { background: #3a3a3a; color: rgba(255, 255, 255, 0.8); }
|
||
.btn-success:active { color: var(--accent-active); }
|
||
/* Ghost / Outlined — olive-tinted border, transparent bg */
|
||
.btn-ghost {
|
||
background: transparent;
|
||
color: var(--fg);
|
||
border-color: #4f5100;
|
||
padding: 0 var(--space-8);
|
||
height: 40px;
|
||
}
|
||
.btn-ghost:hover { background: var(--surface); }
|
||
.btn-ghost:active { color: var(--accent-active); }
|
||
/* Dark solid — standard action button */
|
||
.btn-dark {
|
||
background: var(--surface);
|
||
color: var(--fg);
|
||
border-color: var(--surface);
|
||
}
|
||
.btn-dark:hover { background: #3a3a3a; color: rgba(255, 255, 255, 0.8); }
|
||
.btn-dark:active { color: var(--accent-active); }
|
||
|
||
/* ─── Inputs — dark fill, charcoal border ───────────────── */
|
||
.field { display: flex; flex-direction: column; gap: var(--space-2); }
|
||
.field label { font-size: var(--text-sm); font-weight: 600; color: var(--fg); }
|
||
.field input {
|
||
padding: 12px 14px;
|
||
border-radius: var(--radius-sm);
|
||
border: 1px solid var(--border);
|
||
background: var(--surface);
|
||
color: var(--fg);
|
||
font-family: var(--font-body);
|
||
font-size: var(--text-sm);
|
||
outline: none;
|
||
transition: border-color var(--motion-fast) var(--ease-standard),
|
||
box-shadow var(--motion-fast) var(--ease-standard);
|
||
}
|
||
.field input:focus-visible {
|
||
border-color: var(--accent);
|
||
box-shadow: var(--focus-ring);
|
||
}
|
||
.field input::placeholder { color: var(--meta); }
|
||
.field-help { font-size: var(--text-xs); color: var(--muted); }
|
||
|
||
/* ─── Cards — charcoal-bordered containment ─────────────── */
|
||
.card {
|
||
background: transparent;
|
||
border: 1px solid var(--border);
|
||
border-radius: var(--radius-md);
|
||
padding: var(--space-6);
|
||
display: flex;
|
||
flex-direction: column;
|
||
gap: var(--space-3);
|
||
}
|
||
.card-neon {
|
||
border-color: var(--accent);
|
||
}
|
||
.card-stat {
|
||
background: transparent;
|
||
border: 1px solid var(--border-soft);
|
||
border-radius: var(--radius-md);
|
||
padding: var(--space-6);
|
||
}
|
||
.stat-number {
|
||
font-family: var(--font-display);
|
||
font-size: var(--text-3xl);
|
||
font-weight: 700;
|
||
line-height: 1.0;
|
||
color: var(--fg);
|
||
letter-spacing: -0.02em;
|
||
}
|
||
.stat-number-accent { color: var(--accent); }
|
||
.stat-label {
|
||
margin-block-start: var(--space-3);
|
||
font-size: var(--text-sm);
|
||
color: var(--muted);
|
||
}
|
||
|
||
/* ─── Badges ────────────────────────────────────────────── */
|
||
.badge {
|
||
display: inline-flex; align-items: center; gap: var(--space-2);
|
||
padding: 4px var(--space-3);
|
||
border-radius: var(--radius-pill);
|
||
font-size: var(--text-xs); font-weight: 600; line-height: 1.6;
|
||
border: 1px solid var(--border);
|
||
}
|
||
.badge-success {
|
||
color: var(--accent);
|
||
background: color-mix(in oklab, var(--accent), transparent 92%);
|
||
border-color: color-mix(in oklab, var(--accent), transparent 70%);
|
||
}
|
||
.badge-muted {
|
||
color: var(--muted);
|
||
background: var(--surface);
|
||
border-color: var(--border-soft);
|
||
}
|
||
.badge-dot { width: 6px; height: 6px; border-radius: 50%; background: currentColor; }
|
||
|
||
/* ─── Links — always hover to neon ──────────────────────── */
|
||
a { color: var(--fg); text-decoration: none; transition: color var(--motion-fast) var(--ease-standard); }
|
||
a:hover { color: var(--accent); }
|
||
.link-accent { color: var(--accent); }
|
||
kbd {
|
||
font-family: var(--font-mono); font-size: var(--text-xs); font-weight: 600;
|
||
padding: 2px 6px; border-radius: var(--radius-sm);
|
||
border: 1px solid var(--border); background: var(--surface); color: var(--fg-2);
|
||
}
|
||
|
||
/* ─── Code block — Inconsolata, terminal aesthetic ──────── */
|
||
.code-block {
|
||
font-family: var(--font-mono);
|
||
font-size: var(--text-base);
|
||
font-weight: 600;
|
||
line-height: var(--leading-body);
|
||
background: var(--surface);
|
||
border: 1px solid var(--border);
|
||
border-radius: var(--radius-sm);
|
||
padding: var(--space-4) var(--space-5);
|
||
color: var(--fg);
|
||
overflow-x: auto;
|
||
white-space: pre;
|
||
}
|
||
.code-block .tok-kw { color: var(--accent); }
|
||
.code-block .tok-com { color: var(--meta); }
|
||
.code-block .tok-str { color: var(--fg-2); }
|
||
|
||
/* ─── Layout helpers ────────────────────────────────────── */
|
||
.hero-grid {
|
||
display: grid;
|
||
grid-template-columns: 1.5fr 1fr;
|
||
gap: var(--space-12);
|
||
align-items: end;
|
||
}
|
||
@media (max-width: 1023px) {
|
||
.hero-grid { grid-template-columns: 1fr; gap: var(--space-8); align-items: stretch; }
|
||
}
|
||
.hero-actions {
|
||
display: flex; gap: var(--space-3);
|
||
margin-block-start: var(--space-6);
|
||
flex-wrap: wrap;
|
||
}
|
||
.hero-meta {
|
||
display: flex; flex-direction: column; gap: var(--space-4);
|
||
padding: var(--space-5);
|
||
border: 1px solid var(--border);
|
||
border-radius: var(--radius-md);
|
||
background: var(--surface);
|
||
}
|
||
.stats-bar {
|
||
display: grid;
|
||
grid-template-columns: repeat(3, 1fr);
|
||
gap: var(--space-5);
|
||
margin-block-start: var(--space-8);
|
||
}
|
||
@media (max-width: 639px) {
|
||
.stats-bar { grid-template-columns: 1fr; }
|
||
}
|
||
.features-grid {
|
||
display: grid;
|
||
grid-template-columns: repeat(3, 1fr);
|
||
gap: var(--space-5);
|
||
}
|
||
@media (max-width: 1023px) { .features-grid { grid-template-columns: 1fr 1fr; } }
|
||
@media (max-width: 639px) { .features-grid { grid-template-columns: 1fr; } }
|
||
.form-row {
|
||
display: grid;
|
||
grid-template-columns: 1.2fr 1fr;
|
||
gap: var(--space-12);
|
||
align-items: start;
|
||
}
|
||
@media (max-width: 1023px) { .form-row { grid-template-columns: 1fr; } }
|
||
.form { display: flex; flex-direction: column; gap: var(--space-4); max-width: 440px; }
|
||
.form-actions { display: flex; gap: var(--space-3); margin-block-start: var(--space-2); }
|
||
.icon { width: 16px; height: 16px; flex-shrink: 0; }
|
||
.row-between { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); }
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<main class="container">
|
||
<section data-od-id="hero">
|
||
<div class="hero-grid">
|
||
<div class="stack-5">
|
||
<p class="eyebrow">Reference fixture · clickhouse</p>
|
||
<h1>The fastest open-source OLAP database.</h1>
|
||
<p class="lead" style="max-width: 56ch">
|
||
Sub-second analytical queries over petabytes. A columnar engine built
|
||
for real-time analytics, observability, and the agentic workloads of
|
||
the next decade — running on commodity hardware.
|
||
</p>
|
||
<div class="hero-actions">
|
||
<a href="./tokens.css" class="btn btn-primary">
|
||
Run a query
|
||
<svg class="icon" viewBox="0 0 24 24" fill="none"
|
||
stroke="currentColor" stroke-width="2"
|
||
stroke-linecap="round" stroke-linejoin="round"
|
||
aria-hidden="true"><path d="M5 12h14M13 6l6 6-6 6"/></svg>
|
||
</a>
|
||
<a href="./DESIGN.md" class="btn btn-success">Get started</a>
|
||
<a href="./tokens.css" class="btn btn-ghost">Read the docs</a>
|
||
</div>
|
||
</div>
|
||
<aside class="hero-meta" aria-label="Cluster status">
|
||
<div class="row-between">
|
||
<span class="body-sm body-muted">Cluster</span>
|
||
<span class="badge badge-success">
|
||
<span class="badge-dot" aria-hidden="true"></span>
|
||
Operational
|
||
</span>
|
||
</div>
|
||
<pre class="code-block" aria-label="Sample query"><span class="tok-com">-- 1.2B rows · 38ms</span>
|
||
<span class="tok-kw">SELECT</span> country,
|
||
<span class="tok-kw">count</span>(*) <span class="tok-kw">AS</span> hits
|
||
<span class="tok-kw">FROM</span> events
|
||
<span class="tok-kw">WHERE</span> ts > <span class="tok-str">'2026-05-01'</span>
|
||
<span class="tok-kw">GROUP BY</span> country
|
||
<span class="tok-kw">ORDER BY</span> hits <span class="tok-kw">DESC</span>
|
||
<span class="tok-kw">LIMIT</span> 10;</pre>
|
||
<p class="body-sm body-muted">Press <kbd>⌘</kbd> <kbd>K</kbd> to open the query palette.</p>
|
||
</aside>
|
||
</div>
|
||
|
||
<div class="stats-bar" role="list">
|
||
<article class="card-stat" role="listitem">
|
||
<div class="stat-number stat-number-accent">100×</div>
|
||
<p class="stat-label">Faster than row-oriented stores on analytical workloads.</p>
|
||
</article>
|
||
<article class="card-stat" role="listitem">
|
||
<div class="stat-number">38<span style="font-size: var(--text-2xl); color: var(--muted)">ms</span></div>
|
||
<p class="stat-label">P95 latency on 1.2B-row aggregations, single replica.</p>
|
||
</article>
|
||
<article class="card-stat" role="listitem">
|
||
<div class="stat-number">2.2PB</div>
|
||
<p class="stat-label">Largest production cluster — and growing every quarter.</p>
|
||
</article>
|
||
</div>
|
||
</section>
|
||
|
||
<section data-od-id="features">
|
||
<div class="stack-3">
|
||
<p class="eyebrow">What this fixture exercises</p>
|
||
<h2 style="max-width: 26ch">Engineered for the workloads other databases can't keep up with.</h2>
|
||
</div>
|
||
<div class="features-grid" style="margin-block-start: var(--space-8)">
|
||
<article class="card card-neon">
|
||
<p class="eyebrow" style="color: var(--accent)">Featured</p>
|
||
<h3>Columnar at the core</h3>
|
||
<p class="body-muted body-sm">
|
||
A vectorized execution engine reads only the columns a query touches.
|
||
Compression ratios of 10–100× shrink storage and accelerate scans.
|
||
</p>
|
||
<a href="./tokens.css" class="body-sm link-accent">Inspect tokens →</a>
|
||
</article>
|
||
<article class="card">
|
||
<h3>Real-time ingestion</h3>
|
||
<p class="body-muted body-sm">
|
||
Millions of rows per second per node. Kafka, S3, JDBC, HTTP —
|
||
ingest from anywhere, query while writes are still in flight.
|
||
</p>
|
||
<a href="./DESIGN.md" class="body-sm">Read the spec →</a>
|
||
</article>
|
||
<article class="card">
|
||
<h3>SQL you already know</h3>
|
||
<p class="body-muted body-sm">
|
||
ANSI SQL plus a powerful expression library. Window functions,
|
||
JSON, geospatial, arrays — every analytical primitive, native.
|
||
</p>
|
||
<a href="./tokens.css" class="body-sm">Browse functions →</a>
|
||
</article>
|
||
</div>
|
||
</section>
|
||
|
||
<section data-od-id="form">
|
||
<div class="form-row">
|
||
<div class="stack-4">
|
||
<p class="eyebrow">Form components</p>
|
||
<h2>Spin up a cluster in 30 seconds.</h2>
|
||
<p class="body-muted" style="max-width: 48ch">
|
||
Inputs use the same charcoal-bordered geometry as the cards. Focus
|
||
ring is neon volt — unified interactive feedback across the system.
|
||
</p>
|
||
<p class="body-sm body-muted">
|
||
Already running ClickHouse? <a href="#" class="link-accent">Connect an existing cluster</a>.
|
||
</p>
|
||
</div>
|
||
<form class="form" onsubmit="event.preventDefault();">
|
||
<div class="field">
|
||
<label for="email">Work email</label>
|
||
<input id="email" type="email" placeholder="[email protected]" autocomplete="email" required />
|
||
<p class="field-help">We'll send your free-tier credentials and nothing else.</p>
|
||
</div>
|
||
<div class="field">
|
||
<label for="region">Region</label>
|
||
<input id="region" type="text" placeholder="us-east-1" value="us-east-1" />
|
||
<p class="field-help">Pick a region close to your data sources for lowest latency.</p>
|
||
</div>
|
||
<div class="form-actions">
|
||
<button type="submit" class="btn btn-success">Create cluster</button>
|
||
<button type="button" class="btn btn-ghost">View pricing</button>
|
||
</div>
|
||
</form>
|
||
</div>
|
||
</section>
|
||
</main>
|
||
</body>
|
||
</html>
|