迭代 ONE-OS 多原型:统一标注壳与操作规范,租赁明细/合同/提车应收款增强,新增任务工单,同步导航与合包页面。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-12 22:44:21 +08:00
parent 824512a224
commit 131b963e4a
317 changed files with 38569 additions and 12009 deletions

View 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
```

View File

@@ -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 插件会在保存文件后自动触发同步(无需手动跑命令)