---
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`，并清理各原型 `annotation-source.json` 中的 `oneos-project-nav` 节点（`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` 的变更记入主业务原型版本（导航页自身变更可忽略）
