bk-monitor-dev-server

Local development server configuration

Workflow

Step 0: Check configuration (preferred)

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

• CONFIG_VALID → Skip to Step 5
• CONFIG_INVALID:* → Configuration required, ask the user for URL/Cookie/Token

Step 1-4: Environment configuration

1. Environment check:bash .cursor/skills/dev-server/scripts/check-env.sh
2. Install dependencies:pnpm i
3. Generate configuration (see config-guide.md for details)
4. Configure hosts

Step 5: Start the service

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

Step 6: Verify

Wait for Compiled successfully, visit http://appdev.xxx.com:7001

---

Common issues quick reference

Issue	Possible cause	Solution
Port already in use	Another process is using 7001	The service will automatically switch ports
API 401/403	Cookie/Token expired	Obtain Cookie and X-CSRFToken again
API connection failed	Proxy configuration error	Check devProxyUrl
Blank page	hosts not configured	Add hosts mapping
Dependency installation failed	pnpm not used	Use pnpm i

For detailed troubleshooting, see references/troubleshooting.md

---

📦 Available resources

• 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

---

📦 Available resources

• 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

Determine whether loading is needed based on the IF-THEN rules in SKILL.md