DESIGN.md@docs/dev/acrA

DESIGN.md@docs/dev/acr from helixnow/deep-student is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add helixnow/deep-student/docs/dev/acr/DESIGN.md@git:20260808.f473a6d

Pins git:20260808.f473a6d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
helixnow/deep-student
Path
docs/dev/acr/DESIGN.md
Versions recorded
1
Latest version
git:20260808.f473a6d, committed Aug 8, 2026
Size
27,629 bytes
Repository stars
303
License
AGPL-3.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

# ACR — Agent Collaborator Runtime 总体设计(v1.0 冻结)

> ACR 2.0 的 capability manifest、observe-act-verify、风险分层、持久撤销与
> 产品发现入口见 [`ACR-2.0.md`](./ACR-2.0.md)。本文继续作为 1.x driver、演出和
> 用户接管协议的冻结真相源。

> 目标:让 chat agent 完整操控 OS 模式(workbench)下所有子应用,操作在目标窗口**实时视觉演出**,与用户编辑**不冲突**,达到 SOTA 标准。
> 本文是三轮改造(R1×20 / R2×10 / R3×5)的唯一架构真相源。接口标注【冻结】的部分未经协调者批准不得更改。
> 配套文档:`STANDARDS.md`(工程规范)、`ROUND1/2/3.md`(任务卡)、`SCENARIOS.md`(验收场景,R1-20 产出)。

---

## 0. 核心决策(来自三轮调研的裁决)

1. **不引入 CRDT/Yjs**。用户与 agent 在同一进程写同一内存文档,只需要"串行化写入 + 来源标记 + 位置重映射"。(协作编辑调研裁决)
2. **agent 写入不进用户 undo 栈**。用户 Ctrl+Z 只撤自己的编辑;agent 修改记入独立 Run Ledger,整体可回滚。(ProseMirror/Yjs/BlockNote 共识)
3. **不做假鼠标**。用语义聚光灯:窗口光环 + 实体 flash + AI 光标 decoration + 侧边叙事(chat 工具卡)。(computer-use 产品调研裁决)
4. **传输用"批量委托 + 前端本地节奏"**,不做高频 IPC 流。ops 随一次桥请求整批到达前端,演出节奏由前端 pacing engine 本地控制;进度回报 ≤5Hz。Tauri Channel 保留为 R2 性能区的升级选项。
5. **复用而非新造**:桥复刻 mcp-bridge 模式(emit 请求 + emit 带 correlationId 响应 + oneshot + RAII 卸载监听);工具卡复用 tool_call 事件 + 前端 remap(sleep/ask_user 先例);破坏性笔记编辑复活既有 `canvas:ai-edit-request`→`AIDiffPanel` 路径。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add helixnow/deep-student/docs/dev/acr/DESIGN.md@sha256:b8fc0511b8b675b1

The line at the top of this page pins the label git:20260808.f473a6d, 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_kht4o5ocm7mv76hm.svg)](https://markdownregistry.com/a/art_kht4o5ocm7mv76hm)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 8, 2026.

versioncommittedcommitsizeaudit
git:20260808.f473a6d latest2026-08-08 f473a6d 27,629 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 (27629 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

helixnow/deep-student · 303 stars · license AGPL-3.0 · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kht4o5ocm7mv76hm
GET https://markdownregistry.com/api/v1/resolve?ref=helixnow/deep-student/docs/dev/acr/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/b8fc0511b8b675b10c66da2942a4d7166d0384af4f9c9959fd33b7ed66758919

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 helixnow/deep-student

SPSS 论文分析 SKILL.md skill
helixnow/deep-student · .skills/spss-paper-analysis/SKILL.md · 面向论文与课题写作的 SPSS 统计分析工作流。适用于 `.sav`、`csv/xlsx`、SPSS 导出结果表或截图解读场景,帮助用户先确认研究问题、变量角色、分组方式与前提条件,再组织统计执行、结果解释和论文写作输出。重点覆盖描述统计、…
v1.0.0 · audit A · 303 stars
statistics-tools SKILL.md skill
helixnow/deep-student · .skills/statistics-tools/SKILL.md · SPSS 论文分析的统计执行工具组。为 `.sav`、`csv/xlsx` 等数据分析场景声明 MCP 统计后端接口,包括数据集检查、统计分析执行、结果解释与论文表格导出。适用于需要把统计执行能力按需注入到 DeepStudent…
v1.0.0 · audit A · 303 stars
DESIGN.md@docs/dev/sota-conversation-core DESIGN.md file
helixnow/deep-student · docs/dev/sota-conversation-core/DESIGN.md
git:20260910.3b6b6f5 · audit A · 303 stars
card-coordinator SKILL.md skill
helixnow/deep-student · docs/research/anki-ai-native/agents/skills/card-coordinator/SKILL.md · 制卡编排协调者:固化「content-curator 策展 → chatanki_run 生成 → card-qa 质检 → batch_update 修正」多代理闭环,质检交接 documentId(qa…
v0.2.0 · audit A · 303 stars
card-outline SKILL.md skill
helixnow/deep-student · docs/research/anki-ai-native/agents/skills/card-outline/SKILL.md · 制卡大纲方法论:从学习材料抽取最小知识单元、决策卡型、切分粒度并排优先级,产出可直接喂给 chatanki_run 的结构化大纲
v0.1.0 · audit A · 303 stars
card-qa-checklist SKILL.md skill
helixnow/deep-student · docs/research/anki-ai-native/agents/skills/card-qa-checklist/SKILL.md · 卡片质检清单:重复(D1-D3)、粒度(G1-G4)、Cloze 规范(C1-C6)三类规则的判定标准、严重级别与补丁输出格式
v0.1.0 · audit A · 303 stars
deep-student-cloud-sync-e2e SKILL.md skill
helixnow/deep-student · dstu-test/skills/deep-student-cloud-sync-e2e/SKILL.md · Run real, UI-driven Deep Student cloud sync E2E tests. Use when Codex needs to validate WebDAV/cloud sync, backup…
git:20260630.3599d6c · audit A · 303 stars
deep-student-tauri-lab SKILL.md skill
helixnow/deep-student · dstu-test/skills/deep-student-tauri-lab/SKILL.md · Manage Deep Student Tauri desktop test instances through the repo-local tauri-lab CLI. Use when Codex needs to create…
git:20260711.4cc0dad · audit A · 303 stars

Every file in helixnow/deep-student

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