---
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` 或误改发布仓历史。
