菜单
Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT_ environment variables.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Implements marchat terminal client TUI, commands, keystore, and WebSocket client behavior. Use when editing client/, Bubble Tea models, :commands, themes, notifications, or client configuration paths.
Implements marchat server hub, WebSocket handlers, admin web, health, and startup validation. Use when editing server/, cmd/server/, hub routing, admin panel, or server configuration.
Writes and runs marchat tests with race detection, coverage, and dialect smoke patterns. Use when adding tests, fixing test failures, measuring coverage, or when the user mentions go test, -race, TESTING.md, or CI database smoke.
Changes marchat SQL schema and queries across SQLite, PostgreSQL, and MySQL using dialect helpers. Use when editing server/db.go, db_dialect.go, schema migrations, MARCHAT_DB_PATH, or multi-database behavior.
Implements and refactors marchat Go code with project toolchain and quality gates. Use when adding features, fixing bugs, touching client/server/plugin code, or when the user asks to develop, build, or validate marchat changes.
Develops and maintains marchat plugins: SDK, host IPC, manager install path, store downloads, and Ed25519 licenses. Use when editing plugin/, plugin commands, or plugin_state.json behavior.
| name | debugging-marchat |
| description | Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT_ environment variables. |
| Binary | Command |
|---|---|
| Client | go run ./client -doctor or marchat-client -doctor |
| Server | go run ./cmd/server -doctor or marchat-server -doctor |
| JSON | Add -doctor-json (plain JSON; no TTY colors) |
Server doctor lists MARCHAT_* after config/.env load (godotenv.Overload: file wins on same key).
Skip GitHub release compare in tests or offline:
export MARCHAT_DOCTOR_NO_NETWORK=1
Implementation: internal/doctor/. DB dialect and DSN shape checks live there and in server/db_dialect.go.
| Symptom | Check |
|---|---|
| Handshake rejected / username taken | Reserved names; duplicate connection; server hub lock |
| WSS behind proxy | deploy/, docker-compose.proxy.yml, README proxy section; client WSS URL |
| E2E decrypt fails | Same global key on all clients (MARCHAT_GLOBAL_E2E_KEY or shared keystore.dat); not X25519 per-user |
| Postgres boolean errors | Dialect boolean helpers in server/db_dialect.go (:search, pin toggle) |
| MySQL time parsing | mysql.Config with parseTime=true in InitDB |
| SQLite path vs remote DSN | MARCHAT_DB_PATH; mysql: / postgres: prefixes for driver detection |
| Plugin disable race | StopPlugin waits for stdout/stderr readers (plugin/host) |
| Rate limit | server/loadverify_ratelimit_test.go constants match client.go read pump |
server/client.go).MARCHAT_ALLOWED_ORIGINS.MARCHAT_TRUSTED_PROXIES for X-Forwarded-For / X-Real-IP.Never log passphrases, admin keys, session secrets, or raw E2E keys.
-doctor on client and server.testing-marchat).