迭代 ONE-OS 多原型:统一标注壳与操作规范,租赁明细/合同/提车应收款增强,新增任务工单,同步导航与合包页面。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
36
.cursor/rules/prototype-annotation-layout.mdc
Normal file
36
.cursor/rules/prototype-annotation-layout.mdc
Normal file
@@ -0,0 +1,36 @@
|
||||
---
|
||||
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
|
||||
```
|
||||
@@ -41,7 +41,7 @@ CHANGELOG_NOTE="修复筛选联动" npm run nav:sync -- --prototype customer-man
|
||||
- 脚本路径:`scripts/sync-prototype-nav-registry.mjs`
|
||||
- 检测原型目录内容哈希;有变化则版本递增(`v1.0` → `v1.1` → …)
|
||||
- 写入 `src/prototypes/oneos-prototype-nav/prototype-registry.json`
|
||||
- 同步 `nav-menu.json` 与各原型标注目录(`npm run project-nav:sync` 逻辑)
|
||||
- 同步 `nav-menu.json`,并清理各原型 `annotation-source.json` 中的 `oneos-project-nav` 节点(`npm run project-nav:sync`)
|
||||
- 同步小羚羚小程序目录(`npm run nav:xll-sync`,读取 `make-project-20260629` 项目标注目录)
|
||||
- 本地 `npm run dev` 时,Vite 插件会在保存文件后自动触发同步(无需手动跑命令)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user