> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magic-resume.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 命令速查

> 值得记住的每一条 pnpm 与 turbo 命令。

值得记住的所有命令。路径都相对仓库根目录。

## 全仓（Turbo）

```bash theme={null}
pnpm install      # 装全部依赖，解析 workspace link
pnpm run dev      # turbo dev —— 每个 workspace 的 dev 脚本
pnpm run build    # turbo build —— 尊重任务依赖
pnpm run lint     # turbo lint
pnpm run test     # turbo test
```

## 单 workspace（pnpm filter）

```bash theme={null}
pnpm --filter @magic-resume/web dev
pnpm --filter @magic-resume/web dev:turbo       # Turbopack 变体
pnpm --filter @magic-resume/web build
pnpm --filter @magic-resume/web lint
pnpm --filter @magic-resume/web i18n:check

cd apps/docs/content && npx mint dev            # 文档站点（Mintlify 本地预览）

pnpm --filter @magic-resume/resume-schema build
pnpm --filter @magic-resume/resume-schema test  # node --test

pnpm --filter @magic-resume/resume-templates build

pnpm --filter @magic-resume/mcp build
pnpm --filter @magic-resume/mcp test
pnpm --filter @magic-resume/mcp lint            # tsc --noEmit
```

## MCP CLI（装好之后）

```bash theme={null}
npx -y @magic-resume/mcp config set --api-url <url> --pat <token>
npx -y @magic-resume/mcp config print
npx -y @magic-resume/mcp config clear
npx -y @magic-resume/mcp mcp                    # 启动 stdio 服务器
```

## 偶尔会用的

```bash theme={null}
# 只重新生成 JSON Schema 产物
pnpm --filter @magic-resume/resume-schema build

# Web 应用的 bundle 分析
pnpm --filter @magic-resume/web analyze

# Web 应用的生产构建
pnpm --filter @magic-resume/web build:prod
```

## Husky 与 lint-staged

这些在 `git commit` 时自动跑：

* 对暂存的 `*.{js,jsx,ts,tsx}` 跑 ESLint `--fix`
* 对暂存的 `apps/web` 文件跑 `i18n:check`
* 对暂存的 JSON / Markdown / YAML 跑 Prettier

真正的紧急情况下要跳过：`git commit --no-verify`。但是请不要。