---
description: 原型标注布局——PRD 在右侧目录分章展示，禁止侧边原型导航与目录内跳转
globs: src/prototypes/**/*
alwaysApply: false
---

# 原型标注布局（全局）

开发或改造 `src/prototypes/` 下任意带 `@axhub/annotation` 的原型时，**必须**遵循 `rules/prototype-annotation-layout-guide.md`。

## 硬性要求

1. 使用 `PrototypeAnnotationHost`，禁止直接挂载裸 `AnnotationViewer`
2. 禁止在 `annotation-source.json` 写入 `id: oneos-project-nav` 导航目录
3. 跨原型跳转只通过 `/prototypes/oneos-prototype-nav`（原型导航页）
4. PRD / 模块说明放在 `directory` 的 `markdown` 节点，由右侧「原型标注」目录分章节展示
5. 不在页面正文下方内联展示 PRD；目录内不展示 `link` / `route` 跳转节点

## 标准模板

```tsx
import { PrototypeAnnotationHost } from '../../common/prototype-annotation-host';

<PrototypeAnnotationHost
  source={annotationSourceDocument as AnnotationSourceDocument}
  options={annotationOptions}
/>
```

## 同步命令

菜单或标注目录调整后：

```bash
npm run project-nav:sync
```
