迭代 ONE-OS 多原型:原型导航与版本追踪上线;车辆氢费明细成本单价校验增强;多业务台账/财务/工作台页面迭代与标注目录同步。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-07-09 17:52:53 +08:00
parent 6d14c58744
commit 6ccbbef86a
79 changed files with 51230 additions and 2264 deletions

View File

@@ -0,0 +1,57 @@
---
description: 修改任意原型后自动同步版本与变更日志到「原型导航」页面
globs: src/prototypes/**/*
alwaysApply: false
---
# 原型导航自动同步
修改 `src/prototypes/` 下任意原型(不含 `oneos-prototype-nav` 自身)后,**必须**同步导航注册表,使「原型导航」页展示最新版本号与变更日志。
## 何时执行
完成以下任一类型的改动后执行同步:
- 页面逻辑、组件、样式(`.tsx` / `.jsx` / `.css`
- `annotation-source.json`、PRD、`.spec` 文档
- 新增或调整菜单相关原型
## 命令
**单个原型**(推荐,附变更说明):
```bash
npm run nav:sync -- --prototype <prototype-id> --note "一句话变更摘要"
```
**全量检查**(菜单结构调整、批量改动后):
```bash
npm run nav:sync
```
也可通过环境变量传说明:
```bash
CHANGELOG_NOTE="修复筛选联动" npm run nav:sync -- --prototype customer-management
```
## 行为说明
- 脚本路径:`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` 逻辑)
- 同步小羚羚小程序目录(`npm run nav:xll-sync`,读取 `make-project-20260629` 项目标注目录)
- 本地 `npm run dev` 时Vite 插件会在保存文件后自动触发同步(无需手动跑命令)
## Agent 收尾清单
1. 完成原型代码/文档修改
2. 运行 `npm run nav:sync -- --prototype <id> --note "<摘要>"`
3. 提醒用户刷新「原型导航」页查看版本与「最近更新」
## 不要
- 不要手改 `prototype-registry.json` 里的版本号或 changelog
- 不要把 `oneos-prototype-nav` 的变更记入主业务原型版本(导航页自身变更可忽略)