DESIGN.mdB

DESIGN.md from lizhiyao/oh-my-knowledge is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add lizhiyao/oh-my-knowledge/DESIGN.md@git:20261101.305b362

Pins git:20261101.305b362 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
DESIGN.md file
Repository
lizhiyao/oh-my-knowledge
Path
DESIGN.md
Versions recorded
22
Latest version
git:20261101.305b362, committed Nov 1, 2026
First version recorded
Sep 22, 2026
Size
58,965 bytes
Repository stars
24
License
MIT

Studio 当前实现的设计基线;品牌紫与专注阅读贯通外壳、观测列表、知识工作台和有明确证据边界的评测报告。.

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

# OMK Studio 设计基线

## Overview

**Creative North Star: "让知识与证据清楚可读、可核对"**

Studio 是知识工作的全屏操作界面,服务于真实工作观测、知识维护与受控测量。内容、来源和结论之间的关系优先于装饰;界面不能以视觉上的“成功”替代领域中尚未成立的判断。产品定位以 [PRODUCT.md](./PRODUCT.md) 为准。

本文件只覆盖 Studio,不定义官网、文档站或第三方插件的视觉。正文以中文维护;英文节名用于兼容 DESIGN.md 的工具格式。执行边界与验收要求以根 [AGENTS.md](./AGENTS.md) 和 [Studio 领域规则](./src/studio/AGENTS.md) 为准,本文件不扩大它们的授权。

**Key Characteristics:**

- 品牌紫标识行动与当前位置,墨色层级承载阅读与导航。
- 全屏外壳保留单一全局侧栏,长内容在内部滚动。
- 观测与核心知识页面采用限宽专注阅读;报告固定摘要与限制,证据按需切换。
- 来源、精确修订、维护选择与效果验证分别表达。

### 基线的使用方式

- **已确认约束与方向**:品牌、导航归属、全屏布局、表格可达性和证据语义,后续设计必须遵守。frontmatter 的品牌紫、文字、表面、选中底与状态 ink 已进入运行时;侧栏新增紫灰表面及悬停/按下档与一级导航白底行动紫按本轮实际实现登记。
- **当前可复用基础**:frontmatter 提取自现有主题与 CSS,作为本版相应角色的默认值;品牌与既有状态色由 `test/architecture/studio-color-tokens.test.ts` 与主题、样式钉成同源。新增侧栏 token 与宽度已登记,不能据此推定每个 token 都有独立门禁。
- **待收敛项**:以“待收敛”标注的差异仅用于识别现状,不作为新页面的默认模板。重设计提案先单独讨论、给出可评审的构图,验证后再更新本文件。

提取依据是 [StudioTheme](./src/studio/web/components/layout/theme.tsx)、[studio.css](./src/studio/web/app/studio.css) 与 [StudioShell](./src/studio/web/components/layout/shell.tsx)。本版以源码为基线,并记录对应真实页面的有限验收;不声称完成所有页面的计算样式、对比度或响应式验收。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lizhiyao/oh-my-knowledge/DESIGN.md@sha256:ae1d01a4346bb57c

The line at the top of this page pins the label git:20261101.305b362, 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 badge

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

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

Versions

The registry has recorded 22 versions of this file, between Sep 22, 2026 and Nov 1, 2026, about one every 2 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20261101.305b362 latest2026-11-01 305b362 58,965 BB view · diff
git:20261029.82530412026-10-29 8253041 58,428 BB view · diff
git:20261021.96979112026-10-21 9697911 57,819 BB view · diff
git:20261014.fed88aa2026-10-14 fed88aa 57,070 BB view · diff
git:20261014.00015772026-10-14 0001577 56,058 BB view · diff
git:20261013.f4fd76a2026-10-13 f4fd76a 55,690 BB view · diff
git:20261013.c1ba0042026-10-13 c1ba004 49,463 BB view · diff
git:20261012.f36735a2026-10-12 f36735a 42,583 BB view · diff
git:20261012.4064a2e2026-10-12 4064a2e 37,549 BB view · diff
git:20261009.77f65a02026-10-09 77f65a0 37,070 BB view · diff
git:20261009.5b18ec42026-10-09 5b18ec4 36,782 BB view · diff
git:20261009.539a3712026-10-09 539a371 36,533 BB view · diff
git:20261008.d6be92f2026-10-08 d6be92f 36,258 BB view · diff
git:20261008.1c931602026-10-08 1c93160 36,438 BB view · diff
git:20261008.a906d3f2026-10-08 a906d3f 35,715 BB view · diff
git:20260924.828f8632026-09-24 828f863 35,165 BB view · diff
git:20260924.8d24bd32026-09-24 8d24bd3 35,033 BB view · diff
git:20260924.1295c062026-09-24 1295c06 34,921 BB view · diff
git:20260924.2f58f122026-09-24 2f58f12 34,836 BB view · diff
git:20260924.ef6d6002026-09-24 ef6d600 34,713 BB view · diff
git:20260922.d654af02026-09-22 d654af0 13,845 BA view · diff
git:20260922.f8b3ea62026-09-22 f8b3ea6 13,425 BA view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:7799)
  • pass: Size between 200 bytes and 200 KB (58965 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 script tag

Starting a new one? Use a template for DESIGN.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

lizhiyao/oh-my-knowledge · 24 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uedmcj6rfqqqdd54
GET https://markdownregistry.com/api/v1/resolve?ref=lizhiyao/oh-my-knowledge/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/ae1d01a4346bb57c4cb3c15b811ab686d1a8e968d944a563e6ea8a0c07f351e1

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 lizhiyao/oh-my-knowledge

omk SKILL.md skill
lizhiyao/oh-my-knowledge · .agents/skills/omk/SKILL.md · OMK(Observe. Measure. Know.)让 AI 应用的知识改动有据可依。帮助用户从历史知识完成当前任务,保留适用条件、不同立场与来源;也支持观测真实表现、受控测量 prompt / RAG / skill / agent…
git:20261107.0dedca2 · audit A · 24 stars
AGENTS.md AGENTS.md file
lizhiyao/oh-my-knowledge · AGENTS.md
git:20261107.d65336f · audit A · 24 stars
CLAUDE.md CLAUDE.md file
lizhiyao/oh-my-knowledge · CLAUDE.md
git:20260516.8539e80 · audit A · 24 stars
repo-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/agent-runtime/skills/repo-answerer/SKILL.md · Minimal repository answerer used as the control variant.
git:20260902.c0ab3ed · audit A · 24 stars
repo-navigator SKILL.md skill
lizhiyao/oh-my-knowledge · examples/agent-runtime/skills/repo-navigator/SKILL.md · Repository navigation skill for project-level runtime context.
git:20260619.dd3bb69 · audit A · 24 stars
echo-assistant SKILL.md skill
lizhiyao/oh-my-knowledge · examples/custom-executor/skills/echo-assistant/SKILL.md · Minimal skill used to demonstrate the custom executor protocol.
git:20260619.dd3bb69 · audit B · 24 stars
context-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/rag-eval/skills/context-answerer/SKILL.md · Minimal context answerer used as the control variant.
git:20260902.c0ab3ed · audit B · 24 stars
rag-answerer SKILL.md skill
lizhiyao/oh-my-knowledge · examples/rag-eval/skills/rag-answerer/SKILL.md · RAG answerer that only answers from supplied context.
git:20260619.dd3bb69 · audit A · 24 stars
release-checklist SKILL.md skill
lizhiyao/oh-my-knowledge · examples/skill-map-showcase/skills/release-checklist/SKILL.md · Minimal release checklist used as the control variant.
git:20260902.c0ab3ed · audit A · 24 stars
release-readiness SKILL.md skill
lizhiyao/oh-my-knowledge · examples/skill-map-showcase/skills/release-readiness/SKILL.md · Release readiness reviewer that turns a skill folder into a visible Skill Map.
git:20260619.dd3bb69 · audit A · 24 stars
AGENTS.md@src/cli AGENTS.md file
lizhiyao/oh-my-knowledge · src/cli/AGENTS.md
git:20260903.08c59f3 · audit A · 24 stars
AGENTS.md@src/eval-core AGENTS.md file
lizhiyao/oh-my-knowledge · src/eval-core/AGENTS.md
git:20261107.d65336f · audit A · 24 stars

Every file in lizhiyao/oh-my-knowledge

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20261104.2ff2d3b · audit A · 140,694 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261105.56517dd · audit A · 111,624 stars
DESIGN.md DESIGN.md file
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
git:20260721.d7d1027 · audit A · 106,186 stars
DESIGN.md DESIGN.md file
tt-a1i/archify · DESIGN.md · A precise, vivid technical instrument for trustworthy interactive architecture maps.
git:20260817.a0bc059 · audit A · 94,561 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 80,701 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20261102.a500029 · audit A · 53,286 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,587 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261105.74b7c70 · audit A · 24,407 stars

Browse by kind, by grade B, or by owner.