迭代 ONE-OS 多原型:原型导航与版本追踪上线;车辆氢费明细成本单价校验增强;多业务台账/财务/工作台页面迭代与标注目录同步。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
57
.cursor/rules/prototype-nav-sync.mdc
Normal file
57
.cursor/rules/prototype-nav-sync.mdc
Normal 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` 的变更记入主业务原型版本(导航页自身变更可忽略)
|
||||
Reference in New Issue
Block a user