Home / rockbenben / ai-job-search-cn · GitHub

DESIGN.md@webA

DESIGN.md@web from rockbenben/ai-job-search-cn is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned

mdr add rockbenben/ai-job-search-cn/web/DESIGN.md@alpha

Pins alpha in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: DESIGN.md file
Repository: rockbenben/ai-job-search-cn
Path: web/DESIGN.md
Versions recorded: 2
Latest version: alpha, committed Oct 2, 2026
First version recorded: Sep 30, 2026
Size: 22,416 bytes
Repository stars: 42
License: MIT

web/src 总览页（React 19 + antd 6 + cockpit.css）的设计系统正本。令牌取自 theme/tokens.ts 与 cockpit.css 的 :root，与代码一一对应；本文只登记已经存在或已裁定的规则，未决事项进 Open Decisions，不悄悄发明。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 仪表舱 · 总览页设计契约

## Overview

这一页是**本机跑的求职流水线总览**（`tools/serve.py` 端上 `web/dist`，端口 29029），
不是公开站点。它的气质是「舱内仪表盘」：深色底、硬边、方章、数字对齐可比。
使用者是一个人独用、盯着自己的数据做决定，所以密度优先于留白，
判定结果优先于装饰。核心动作是「盖章 / 判定」，四条取向（零圆角、等宽数字、
中文优先的字号下限、靠线不靠影）都从这里派生。

## Colors

`{colors.bay}` 是舱内底，`{colors.panel}` 是面板，`{colors.panel-raised}` 是抬起的面板
（hover / 选中）。`{colors.edge}` 只作分隔线，`{colors.edge-strong}` 标可交互边界。
文字三档 `{colors.lit}` / `{colors.dim}` / `{colors.faint}`，对最亮那层底
`{colors.panel-raised}` 实测 13.58 / 7.35 / 4.98:1。
语义色四个：`{colors.data}` 青＝读数与「满足」，`{colors.caution}` 琥珀＝待确认，
`{colors.lock}` 红＝不满足与越界表述，`{colors.faint}` 兼作「跳过」。
`{colors.data-deep}` 只用作青色边框的暗调；`{colors.lock-deep}` 是红色侧的对称位——
斜纹方章的印面底色，掺黑比例照 `data-deep` 那一档，不是新色相。

对比度一律按**最亮的那层底**算——在最不利的一层成立，在 bay / panel 上自然更高。
`tests/test_contrast.py` 把这些数当断言验，注释和色值对不上就红。

frontmatter 里另有一组 `antd-color*` 键，值全是上面语义色的锚点，**不是第十三种颜色**：
它们记的是 `tokens.ts` 把哪个语义色交给了 antd 的哪个角色，顺带让预览画布的对比度配对
有名字可匹配。写代码时只用 `var(--bay)` 那一组；`antd-` 前缀就是为了让它一眼不像 CSS 变量。

## Typography

正文走 `body-md`（15px / 1.7），次要说明走 `label-md`、`body-sm`、`meta-md`、`meta-sm`。

frontmatter 里 `fontFamily` 只写三个短名，不写字面量——它们是**指向正本的引用**，
正本各只有一份，抄进本文就会和代码飘：

```
sans   antd fontFamily 令牌 = tokens.ts 的 FONT_SANS
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add rockbenben/ai-job-search-cn/web/DESIGN.md@sha256:34d4fafcd4c6b437

The line at the top of this page pins the label alpha, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_g2prpvf7tdk5r6lc.svg)](https://markdownregistry.com/a/art_g2prpvf7tdk5r6lc)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 30, 2026 and Oct 2, 2026, about one every 2 days.

version	committed	commit	size	audit
alpha latest	2026-10-02	171b5ef	22,416 B	A	view · diff
alpha	2026-09-30	1cb904c	19,910 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (22416 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

rockbenben/ai-job-search-cn · 42 stars · license MIT · pushed 2026-10-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g2prpvf7tdk5r6lc
GET https://markdownregistry.com/api/v1/resolve?ref=rockbenben/ai-job-search-cn/web/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/34d4fafcd4c6b4371265a979b0c7865ad515bcf79ebf413165ba6b6a3ecfd2ed

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from rockbenben/ai-job-search-cn

job-add-portal SKILL.md skill

rockbenben/ai-job-search-cn · .agents/skills/job-add-portal/SKILL.md · 教它去一个新的招聘网站搜岗不给参数时：问你要接哪个招聘网站触发词：接一个新招聘网站、加一个渠道、新平台怎么接、add portal