chore: Cursor 规则说明双仓库与本地构建发布流程,并忽略本地 PROJECT_BRIEF

Made-with: Cursor
This commit is contained in:
祀梦
2026-03-28 23:48:12 +08:00
parent 9e9e82c1dd
commit 05349b2628
2 changed files with 20 additions and 0 deletions

View File

@@ -0,0 +1,17 @@
---
description: 双仓库结构、本地构建与发布流程;启动时加载项目上下文
alwaysApply: true
---
# SiMengWebSite_Notes — 仓库与部署上下文
在开始涉及 **构建、发布、静态资源路径、`_publish`** 或 **多仓库** 的任务前,请先阅读仓库根目录的 **`PROJECT_BRIEF.local.md`**(若存在)。该文件为本地说明,不进入 Git含完整背景与命令示例。
## 速记(无本地文件时的兜底)
- **源码仓**:仓库根目录 → 远程示例 `SiMengWebSite_Notes.git`;日常开发与提交 Markdown / VuePress 配置。
- **构建仓****`_publish/`** 内为 **独立 Git 仓库** → 远程示例 `build_notes_simengweb.git`**只提交** `npm run docs:build` 产出(`docs/.vuepress/dist` 的内容同步至此)。
- **原因**:业务服务器性能不足,**不在线上构建**;本地构建后推送构建仓,**服务器拉取更新**即可换页。
- **`_publish/`** 与 **`PROJECT_BRIEF.local.md`** 已被根目录 `.gitignore` 忽略,勿把构建产物或该简介误提交进源码仓。
若缺少 `PROJECT_BRIEF.local.md`,可向维护者索取模板或根据上述速记操作,避免在源码仓中提交 `dist` 或误改发布仓历史。

3
.gitignore vendored
View File

@@ -8,6 +8,9 @@ docs/.vuepress/dist
.DS_Store
*.log
# Local project brief for agents (do not commit)
PROJECT_BRIEF.local.md
# Build and Publish output
_publish/