本地开发服务器配置

工作流程

Step 0: 检查配置（优先）

node .cursor/skills/dev-server/scripts/setup-config.js

• CONFIG_VALID → 跳到 Step 5
• CONFIG_INVALID:* → 需配置，向用户索要 URL/Cookie/Token

Step 1-4: 环境配置

1. 环境检查：bash .cursor/skills/dev-server/scripts/check-env.sh
2. 安装依赖：pnpm i
3. 生成配置（详见 config-guide.md）
4. 配置 hosts

Step 5: 启动服务

• monitor-pc: make dev-pc
• trace (Vue3): make dev-vue3

Step 6: 验证

等待 Compiled successfully，访问 http://appdev.xxx.com:7001

---

常见问题速查

问题	可能原因	解决方案
端口被占用	其他进程占用 7001	服务会自动换端口
API 401/403	Cookie/Token 过期	重新获取 Cookie 和 X-CSRFToken
API 连接失败	代理配置错误	检查 devProxyUrl
页面空白	hosts 未配置	添加 hosts 映射
依赖安装失败	未使用 pnpm	使用 pnpm i

详细排查见 references/troubleshooting.md

---

📦 可用资源

• skill://bk-monitor-dev-server/references/config-guide.md
• skill://bk-monitor-dev-server/references/troubleshooting.md
• skill://bk-monitor-dev-server/scripts/check-env.sh
• skill://bk-monitor-dev-server/scripts/setup-config.js

---

📦 可用资源

• skill://bk-monitor-dev-server/scripts/check-env.sh
• skill://bk-monitor-dev-server/scripts/generate-config.js
• skill://bk-monitor-dev-server/scripts/setup-config.js
• skill://bk-monitor-dev-server/references/config-guide.md
• skill://bk-monitor-dev-server/references/troubleshooting.md

根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载