菜单
Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations. Use when a system-bridge build fails, the web-client embed is stale, ports conflict, token auth fails, cross-compilation breaks, or you need the on-disk data/log paths.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/timmo001/system-bridge --skill troubleshooting命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | troubleshooting |
| description | Known System Bridge build and runtime failures and their fixes, plus per-OS token/log/settings/data file locations. Use when a system-bridge build fails, the web-client embed is stale, ports conflict, token auth fails, cross-compilation breaks, or you need the on-disk data/log paths. |
Missing web-client/dist/index.html:
mise run clean:web-client
mise run build:web-client
Go embed stale after web-client changes: the //go:embed directive bundles files at compile time, so rebuild the binary:
mise run build:all # rebuilds web client AND Go binary
Module / dependency issues:
go clean -modcache
go mod download
go mod verify
go mod tidy
TypeScript errors after a dependency update:
cd web-client
rm -rf node_modules bun.lock
bun install
bun run build
Port in use (default 9170):
lsof -i :9170 # Linux/macOS
netstat -ano | findstr :9170 # Windows
export SYSTEM_BRIDGE_PORT=9171
Token / auth failures: regenerate with system-bridge client token. Token path is under the per-OS data dir (see below).
Cross-compilation:
GOOS=linux GOARCH=amd64 go build -o system-bridge-linux
GOOS=windows GOARCH=amd64 go build -o system-bridge.exe
Some modules may not cross-build due to OS-specific dependencies.
libayatana-appindicator; some modules need root.mise run processes:list / mise run processes:stop, and mise run build:console / mise run run:console for terminal logs.App data (settings, token):
Linux: ~/.local/share/system-bridge/v5/
Windows: %LOCALAPPDATA%\system-bridge\v5\
macOS: ~/Library/Application Support/system-bridge/v5/
Token: <app data>/token
Logs:
Linux: ~/.local/state/system-bridge/YYYY-MM-DD.log
Windows: %LOCALAPPDATA%\system-bridge\logs\YYYY-MM-DD.log
macOS: ~/Library/Logs/system-bridge/YYYY-MM-DD.log
Legacy system-bridge.log files in the v5 app-data dir are migrated on next startup; daily logs older than 7 days are removed on startup.