Home / gzx2211 / dsh-visual-workflow · GitHub

AGENTS.md@src/host/apiA

AGENTS.md@src/host/api from gzx2211/dsh-visual-workflow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned

mdr add gzx2211/dsh-visual-workflow/src/host/api/AGENTS.md@git:20260928.0bc633c

Pins git:20260928.0bc633c in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: AGENTS.md file
Repository: gzx2211/dsh-visual-workflow
Path: src/host/api/AGENTS.md
Versions recorded: 3
Latest version: git:20260928.0bc633c, committed Sep 28, 2026
First version recorded: Sep 22, 2026
Size: 1,763 bytes
Repository stars: 65
License: MIT

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

# API Boundary Module Rules

## 范围与职责

适用于 `src/host/api/`。

把 GUI 的 HTTP 请求翻译成对 Host 领域能力的调用，并把结果与失败翻译回稳定的对外响应契约（端点名、响应包形状、错误码、HTTP 状态）。

判断归属：该改动是否改变「请求如何被翻译成领域调用」或「对外响应契约」？只改变领域语义判断（合法性、状态机推进、冲突策略、持久化形状）应放到对应领域模块。

## 契约

- 端点名以共享协议常量为唯一来源；新增端点必须同时进入共享常量与白名单，两者零漂移；
- 未知端点 404、参数缺失 400；调用方错误不得被响应成 500；
- 领域模块只抛稳定错误码，HTTP 状态映射只发生在边界；领域模块不得引用传输层错误类型；
- 响应包形状、错误码语义与端点名属对外契约，变更必须同步客户端、协议常量与测试。

## 状态与副作用

- 本层不持有业务状态：不缓存领域数据、不自建持久化、不保存跨请求可变的实例字段；
- 领域能力只经宿主能力缝注入；能力缺失必须给出明确错误或降级响应，不得静默失效；
- 流式端点必须绑定请求中止信号，在请求结束或断连时释放上游资源；
- 副作用（落盘、子进程、网络调用）必须经对应领域模块的入口，不得在端点或辅助函数中直接实施。

## 依赖边界

- 端点组之间不得互相依赖——新增端点组只登记到汇聚清单；
- 跨模块协作只经能力缝、命令、事件或服务；不得直接修改其他模块的内部状态。

## 核心原则

薄边界、单向依赖、契约稳定、无状态、错误可翻译。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add gzx2211/dsh-visual-workflow/src/host/api/AGENTS.md@sha256:4315338b6d284be0

The line at the top of this page pins the label git:20260928.0bc633c, 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_6nmg7mfxybhpcl6b.svg)](https://markdownregistry.com/a/art_6nmg7mfxybhpcl6b)

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

Versions

The registry has recorded 3 versions of this file, between Sep 22, 2026 and Sep 28, 2026, about one every 3 days.

version	committed	commit	size	audit
git:20260928.0bc633c latest	2026-09-28	0bc633c	1,763 B	A	view · diff
git:20260923.4575b13	2026-09-23	4575b13	1,808 B	A	view · diff
git:20260922.cf8e5a9	2026-09-22	cf8e5a9	2,600 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 (1763 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

gzx2211/dsh-visual-workflow · 65 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6nmg7mfxybhpcl6b
GET https://markdownregistry.com/api/v1/resolve?ref=gzx2211/dsh-visual-workflow/src/host/api/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4315338b6d284be033f7904df29e58a9850cdeae80f432cfba348b0aa82e7c6c

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.