初始化项目

README.md

@@ -1,3 +1,22 @@
-# Xu_BrowserBookmark
+# BrowserBookmark
 
-个人书签项目
+内部私域书签管理：Web + 浏览器扩展（MV3）。
+
+## 环境要求
+- Node.js 22+
+- 包管理器：npm
+- Postgres（仅后端直连）
+- OpenSpec（全局安装）：`npm install -g @fission-ai/openspec@latest`
+
+## 开发
+- 启动后端：`npm run dev:server`
+- 启动 Web：`npm run dev:web`
+- 启动扩展：`npm run dev:extension`
+- 同时启动（server+web）：`npm run dev`
+
+## 规范（Spec-first）
+- 规范在 `spec/openapi.yaml`
+- 校验：`npm run spec:lint` / `npm run spec:validate`
+
+## 配置
+- 复制 `.env.example` 为 `.env` 并填写数据库与密钥。