用途
bk-monitor-dev-server 用于帮助开发者在本地配置并启动开发服务器，适用于监控前端相关项目（如 monitor-pc、trace 等）的本地调试。当用户提到启动开发服务器、dev server 或 pnpm dev 时，应使用该技能。
工作流程
该技能定义了一套从环境检查到服务验证的步骤：
- Step 0：检查配置（优先执行）。运行
node .cursor/skills/dev-server/scripts/setup-config.js。若返回 CONFIG_VALID，则直接跳到 Step 5；若返回 CONFIG_INVALID:*，则需要配置，并向用户索要 URL、Cookie、Token 等信息。 - Step 1-4：环境配置。包括环境检查
bash .cursor/skills/dev-server/scripts/check-env.sh、安装依赖pnpm i、生成配置（详见 config-guide.md）、配置 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/generate-config.js 这些资源根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载。
适用场景与限制
适用于 bk-bcs 相关的监控前端项目本地开发服务器配置与启动。具体支持的框架、平台版本、收费情况等资料暂未提供。