soul/开发文档/8、部署/本地运行.md

本地运行（Mycontent-book）

1. 只写书，不跑站点（推荐常态）

• 打开目录：external/Mycontent-book/book/
• 启动自动同步：./scripts/autosync.sh

2. 要跑 Next.js 站点（临时）

前提：你本地当前是 sparse checkout，可能没有 app/ 等目录。

A. 把站点代码检出到本地

在 external/Mycontent-book 目录下执行（示例）：

• git sparse-checkout add app components lib hooks public

如果远端真实目录不同，以远端实际为准。

B. 安装依赖

• pnpm install

C. 启动开发

• pnpm dev

D. 基础自检

• pnpm lint
• pnpm build

3. 常见坑

• 缺目录：多半是 sparse checkout 没把目录拉下来
• 依赖慢：先停掉当前安装，再换镜像或网络后重试