DESIGN.md@docsB
DESIGN.md@docs from jin-bo/guanlan is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add jin-bo/guanlan/docs/DESIGN.md@git:20261106.c82c9ecPins git:20261106.c82c9ec in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 13 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- jin-bo/guanlan
- Path
docs/DESIGN.md- Versions recorded
- 5
- Latest version
- git:20261106.c82c9ec, committed Nov 6, 2026
- First version recorded
- Oct 31, 2026
- Size
- 71,235 bytes
- Repository stars
- 14
- License
- Apache-2.0
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
# 观澜 (GuānLán) — 设计文档 > 《孟子·尽心上》"观水有术，必观其澜" > > 在信息的汪洋中洞察脉络与趋势。 --- ## 1. 项目目标 观澜是 [Karpathy LLM Wiki 模式](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 的一个实现：让 LLM Agent **增量地构建并持续维护一个结构化、互相链接的知识 wiki**，而不是每次提问都从原始文档里临时检索（传统 RAG）。知识被"编译"一次后持续保鲜，随每一篇新资料、每一次提问而复利增长。 **演进路线** 1. **个人版（先做）** —— 以 **Skills** 的形式接入 Agent，纯文件（Markdown），通过 **Agentao CLI + 极薄的 `guanlan` 包装器** 跑 ingest/query。这是 MVP，也是验证理念的最小闭环，**不依赖任何后端服务**。 - **MVP 只承诺 Agentao + `guanlan` wrapper。** 设计落点是 Agentao 专有机制（`AGENTAO.md`、skill discovery、agent shell 调用脚本）与观澜自己的确定性门禁。其他 Agent CLI（Claude Code / Codex 等）因 wiki 是纯 markdown 而**可能适配**，但不进入 MVP 设计承诺。 - Web UI 是 MVP 之后（P4）叠加的**可选宿主层**，不改变"纯文件"的本质——它只是 `ingest` 与问答的另一个入口。无 Web UI 时，整套东西用 CLI 一样跑通。 2. **企业版（后续）** —— 在个人版之上演进，支持**大数据量**、**多租户权限**、**7×24 自动富化**（技术栈不预先绑定，见 §6）。 **技术底座** - **Powered by Agentao** —— 受治理的 Agent 运行时（Python，可嵌入 / CLI / ACP server）。观澜不自己造 Agent 内核，而是把"知识 wiki 的维护逻辑"做成 Agentao 的 **Skill + Python 脚本**（MVP，CLI 即可跑）；自定义 Tool 注入则留作 P4 之后的按需项。进程内嵌入在 P4 首次落地：**写** `ingest` 仍走 `agentao run` 子进程，**Web 问答**（含单轮与多轮）走只读进程内嵌入（见 [`P4-Web宿主.md`](P4-Web宿主.md)）。 …
Read the whole file at its exact version.
How to install
mdr add jin-bo/guanlan/docs/DESIGN.md@sha256:bc95813e48988fc1The line at the top of this page pins the label git:20261106.c82c9ec, 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.
[](https://markdownregistry.com/a/art_x5goupy7vwcorsrx)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Oct 31, 2026 and Nov 6, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261106.c82c9ec latest | 2026-11-06 | c82c9ec | 71,235 B | B | view · diff |
| git:20261105.8b6b99a | 2026-11-05 | 8b6b99a | 70,906 B | B | view · diff |
| git:20261105.fad5f70 | 2026-11-05 | fad5f70 | 70,444 B | B | view · diff |
| git:20261101.41ab48b | 2026-11-01 | 41ab48b | 70,026 B | B | view · diff |
| git:20261031.a2c8fce | 2026-10-31 | a2c8fce | 69,421 B | B | view |
Audit of the latest version
- fail: No script tag (matched: <script)
- pass: Size between 200 bytes and 200 KB (71235 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
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
jin-bo/guanlan · 14 stars · license Apache-2.0 · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_x5goupy7vwcorsrx GET https://markdownregistry.com/api/v1/resolve?ref=jin-bo/guanlan/docs/DESIGN.md GET https://markdownregistry.com/api/v1/blob/bc95813e48988fc15701a6e4288f4bc7346c03264503c675b4635e8b7c157337
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.