DESIGN.md@backend_safety/docsA

DESIGN.md@backend_safety/docs from phuhao00/bony-agent is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add phuhao00/bony-agent/backend_safety/docs/DESIGN.md@git:20260617.47f66a5

Pins git:20260617.47f66a5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
phuhao00/bony-agent
Path
backend_safety/docs/DESIGN.md
Versions recorded
1
Latest version
git:20260617.47f66a5, committed Jun 17, 2026
Size
13,964 bytes
Repository stars
16
License
none declared

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

# 架构设计文档

> backend_safety — 高性能安全底层引擎(Rust)

---

## 一、项目目标与性能指标

| 模块       | 目标                   | 指标                                |
| ---------- | ---------------------- | ----------------------------------- |
| 二进制解析 | 流式解析 GB 级文件     | 峰值内存 < 128 MB(与文件大小无关) |
| 二进制解析 | MP4/MKV 解析吞吐       | ≥ 500 MB/s(NVMe 本地磁盘)         |
| 加密       | ChaCha20-Poly1305 吞吐 | ≥ 1 GB/s(单线程)                  |
| 加密       | Argon2id 密钥派生      | 300–500 ms(可调,防暴力破解)      |
| 私钥操作   | secp256k1 签名         | ≥ 10,000 签名/s                     |
| 私钥存储   | 密钥写入/读取          | 无明文落盘,OS Keychain 隔离        |

---

## 二、模块设计

### 2.1 大文件二进制解析 (`src/parser/`)

**核心问题**:Python/Go 解析 GB 级二进制文件时,通常需要将全文件载入内存,导致 OOM;且 GC 语言的字节操作性能远低于 Rust。

**方案:零拷贝流式解析 + Rayon 并行**

```
磁盘文件
   │
   ▼
BufReader(mmap 或 O_DIRECT,chunk_size = 64KB)
   │
   ▼
FormatDetector(魔数识别:MP4/MKV/ZIP/PDF/ELF...)
   │
   ▼
FormatParser(nom 解析器组合子,零拷贝引用原始 buffer)
   │  解析 atom/box/chunk
   ▼
SchemaBuilder(结构化元数据 + 感兴趣数据段偏移量)
   │
   ├──▶ 流式 gRPC 响应(ParseChunk stream)
   └──▶ 元数据摘要(FileMetadata)
```

**关键设计决策**:

- 使用 `nom` 解析器组合子框架——声明式描述二进制格式,无需手写状态机
- 解析器操作 `&[u8]` 切片引用,不复制数据(零拷贝)
- 大文件通过 `memmap2` 做内存映射,OS 负责分页,用户态永远只持有窗口引用
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add phuhao00/bony-agent/backend_safety/docs/DESIGN.md@sha256:e801c77be98ef483

The line at the top of this page pins the label git:20260617.47f66a5, 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_lpsfa6l2ujo27jda.svg)](https://markdownregistry.com/a/art_lpsfa6l2ujo27jda)

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

Versions

The registry has recorded 1 version of this file, committed on Jun 17, 2026.

versioncommittedcommitsizeaudit
git:20260617.47f66a5 latest2026-06-17 47f66a5 13,964 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 (13964 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

phuhao00/bony-agent · 16 stars · license none declared · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lpsfa6l2ujo27jda
GET https://markdownregistry.com/api/v1/resolve?ref=phuhao00/bony-agent/backend_safety/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/e801c77be98ef483904f3492f4cfb9dbb50c01b99d79c053b683e92f07b61c4b

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 phuhao00/bony-agent

ad-campaign-agent SKILL.md skill
phuhao00/bony-agent · .agent/skills/ad-campaign-agent/SKILL.md · 完成数字广告投放全链路规划与优化:投放策略、创意文案、受众定向、预算分配、效果复盘。
v1.0.0 · audit A · 16 stars
algorithmic-art SKILL.md skill
phuhao00/bony-agent · .agent/skills/algorithmic-art/SKILL.md · Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users…
git:20260617.47f66a5 · audit B · 16 stars
bilibili-operator SKILL.md skill
phuhao00/bony-agent · .agent/skills/bilibili-operator/SKILL.md · Bilibili 平台深度运营专家,擅长 B 站风格文案、视频投稿与动态发布管理。
git:20260617.47f66a5 · audit A · 16 stars
brand-guidelines SKILL.md skill
phuhao00/bony-agent · .agent/skills/brand-guidelines/SKILL.md · Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having…
git:20260617.47f66a5 · audit A · 16 stars
brandkit SKILL.md skill
phuhao00/bony-agent · .agent/skills/brandkit/SKILL.md · Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks…
git:20260617.47f66a5 · audit A · 16 stars
business-partnership-agent SKILL.md skill
phuhao00/bony-agent · .agent/skills/business-partnership-agent/SKILL.md · 完成商务拓展与战略合作关键工作:Outreach 文案、合作方案、条款要点、伙伴评估、BD Pipeline 规划。
v1.0.0 · audit A · 16 stars
canvas-design SKILL.md skill
phuhao00/bony-agent · .agent/skills/canvas-design/SKILL.md · Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user…
git:20260617.47f66a5 · audit A · 16 stars
claude-api SKILL.md skill
phuhao00/bony-agent · .agent/skills/claude-api/SKILL.md · Build, debug, and optimize Claude API / Anthropic SDK apps. Apps built with this skill should include prompt caching…
git:20260617.47f66a5 · audit A · 16 stars
code-analyst-agent SKILL.md skill
phuhao00/bony-agent · .agent/skills/code-analyst-agent/SKILL.md · 帮助开发者理解代码库、定位符号与调用关系、审查代码质量、给出架构/目录规范建议。
v1.0.0 · audit A · 16 stars
code-reviewer SKILL.md skill
phuhao00/bony-agent · .agent/skills/code-reviewer/SKILL.md · Reviews Python code for bugs, style, and project conventions. Invoke when user asks for a review or advice on code.
git:20260617.47f66a5 · audit A · 16 stars
content-moderator SKILL.md skill
phuhao00/bony-agent · .agent/skills/content-moderator/SKILL.md · moderation Skill 的兼容别名。新任务请优先使用 .agent/skills/moderation/SKILL.md。
v1.1.0 · audit A · 16 stars
copywriter SKILL.md skill
phuhao00/bony-agent · .agent/skills/copywriter/SKILL.md · copywriting Skill 的兼容别名。新任务请优先使用 .agent/skills/copywriting/SKILL.md。
v1.1.0 · audit A · 16 stars

Every file in phuhao00/bony-agent

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