DESIGN.mdA

DESIGN.md from nyasers/dshana is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add nyasers/dshana/DESIGN.md@git:20261022.7e65bed

Pins git:20261022.7e65bed in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
nyasers/dshana
Path
DESIGN.md
Versions recorded
33
Latest version
git:20261022.7e65bed, committed Oct 22, 2026
First version recorded
Oct 1, 2026
Size
76,676 bytes
Repository stars
57
License
MPL-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

# DSHana 设计

插件 id:`dshana`。把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)接进 Hana。

## 文档与注释约定

**注释写现状与原因,不写演变史。** 代码注释回答“现在是什么、为什么这样”;“以前是什么、怎么变成
今天这样”属于 commit 与 CHANGELOG(仓库用 conventional-changelog:`pnpm run changelog` +
`scripts/release/version.mts`,历史自动成文)。

- 不写日期栈记(“2026-xx-xx 定调”)、不写迁移步骤编号(“步骤 3 接线”)、不写“已退役/已删除”的注记。
- 保留现状事实(依赖怎样装、路径在哪、失败向哪侧回落)、保留设计取舍的**理由**。
- 指向本地未入库文档(`specs/`、`SPECS.md`)的引用不入注释与公开文档:规划件带隐私信息、不入库,
  引用只会指向克隆者拿不到的路径。

**覆盖层是别人的文件。** `integrations/*/files/**` 是官方 DSH 文件的整体覆盖,里面只允许两类
内容:上游原有注释,以及我们**无注释的代码改动**。我们自己的说明(为什么改、改了什么、与样例的
差异)一律写在同包的 `integration.json` 的 notes 里——那里是我们的文件,且漂移闸也读它。

理由:覆盖层越像上游,与上游重新对齐越容易,漂移闸的 diff 也越可读;注释里的“我们/样例/当时”
会把一份官方文件变成半自述文件,下次对齐时全是噪音。

## 工具链前提

Node 版本下界是 `^22.23.4 || ^24.22.1 || ^26.12.1`,五件事各管一职:

- `.nvmrc`(26.12.1)是实际使用的版本,也是宿主(Hana 宿主进程)的 Node 版本,26 线的下界即取它;
- `package.json` 的 `engines.node` 是唯一真源(机器可读声明);
- `scripts/shared/root.mts` 加载时**从 `engines.node` 读范围**并断言版本,不满足即抛出可读错误,
  退出码 1(环境前提不满足,与“用户输入错误”的 2 分开);主要入口都 import 它,这是真正拦得住的
  那一处(pnpm 对**根项目**的 engines 不做强制,实测即便 `--engine-strict` 也照常安装);
- `scripts/check/engines.cjs`(`pnpm run check:engines`)扫依赖树报出各包的 `engines.node` 约束与
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nyasers/dshana/DESIGN.md@sha256:4cd626f72436259b

The line at the top of this page pins the label git:20261022.7e65bed, 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_zbkes7vilzriyo4t.svg)](https://markdownregistry.com/a/art_zbkes7vilzriyo4t)

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

Versions

The registry has recorded 33 versions of this file, between Oct 1, 2026 and Oct 22, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261022.7e65bed latest2026-10-22 7e65bed 76,676 BA view · diff
git:20261018.5930c772026-10-18 5930c77 75,944 BA view · diff
git:20261018.69e35e52026-10-18 69e35e5 74,421 BA view · diff
git:20261017.fd2c2e52026-10-17 fd2c2e5 73,149 BA view · diff
git:20261014.514b0c42026-10-14 514b0c4 71,830 BA view · diff
git:20261014.c1943542026-10-14 c194354 71,828 BA view · diff
git:20261014.ec2828a2026-10-14 ec2828a 70,974 BA view · diff
git:20261013.93037232026-10-13 9303723 70,738 BA view · diff
git:20261013.e1680ca2026-10-13 e1680ca 70,083 BA view · diff
git:20261013.59750e42026-10-13 59750e4 69,224 BA view · diff
git:20261012.3df661f2026-10-12 3df661f 68,191 BA view · diff
git:20261011.01b61ab2026-10-11 01b61ab 66,738 BA view · diff
git:20261011.30750632026-10-11 3075063 66,867 BA view · diff
git:20261011.4a412ab2026-10-11 4a412ab 66,563 BA view · diff
git:20261010.41f90d82026-10-10 41f90d8 72,684 BA view · diff
git:20261010.5fbc6d92026-10-10 5fbc6d9 72,520 BA view · diff
git:20261010.6611af52026-10-10 6611af5 71,072 BA view · diff
git:20261010.f97134a2026-10-10 f97134a 70,706 BA view · diff
git:20261008.1f10fd42026-10-08 1f10fd4 69,861 BA view · diff
git:20261008.23bd9812026-10-08 23bd981 69,071 BA view · diff
git:20261008.10faa8e2026-10-08 10faa8e 67,964 BA view · diff
git:20261008.58a5ffa2026-10-08 58a5ffa 66,891 BA view · diff
git:20261007.0fb7ee12026-10-07 0fb7ee1 65,443 BA view · diff
git:20261002.23a8efb2026-10-02 23a8efb 65,193 BA view · diff
git:20261002.6fc00132026-10-02 6fc0013 65,178 BA view · diff
git:20261002.8d8ddc92026-10-02 8d8ddc9 65,107 BA view · diff
git:20261001.a0f8dd82026-10-01 a0f8dd8 65,175 BA view · diff
git:20261001.c5852042026-10-01 c585204 64,986 BA view · diff
git:20261001.02948ef2026-10-01 02948ef 64,033 BA view · diff
git:20261001.bccbc152026-10-01 bccbc15 63,865 BA view · diff
git:20261001.79a4f9b2026-10-01 79a4f9b 63,646 BA view · diff
git:20261001.2b7fc4e2026-10-01 2b7fc4e 63,610 BA view · diff
git:20261001.61cce472026-10-01 61cce47 63,489 BA 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 (76676 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

nyasers/dshana · 57 stars · license MPL-2.0 · pushed 2026-10-22 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_zbkes7vilzriyo4t
GET https://markdownregistry.com/api/v1/resolve?ref=nyasers/dshana/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/4cd626f72436259b5cb5af0829143cf3005b09bd50a2b86e5b3845fb92f67b27

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 nyasers/dshana

dshana-dev-loop SKILL.md skill
nyasers/dshana · .agents/skills/dshana-dev-loop/SKILL.md · How to change the DSHana App's own source and verify it: the repo's build/test/package/install commands, and which…
git:20261013.3e0dbec · audit A · 57 stars
dshana-install-skill SKILL.md skill
nyasers/dshana · dshana-install-skill/SKILL.md · Install or upgrade the DSHana App from a GitHub Release, not this manual.
git:20261011.01b61ab · audit A · 57 stars
dshana SKILL.md skill
nyasers/dshana · skills/dshana/SKILL.md · DSHana: the dshana tool manual. Read before calling dshana, or for DSH troubleshooting.
git:20261018.6a7d442 · audit A · 57 stars

Every file in nyasers/dshana

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20260909.c8f0c4e · audit A · 136,966 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261009.417db14 · audit A · 105,684 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 · 85,866 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 · 83,565 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 67,662 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20260819.300ab2e · audit A · 52,815 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,074 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261013.6d48e23 · audit A · 24,200 stars

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