메뉴
构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Wails Binding 签名一致性。对比 Go 端导出函数 vs 前端 wailsjs。
问题排查记录搜索。按关键词查找 bug-chronicle.md 中的相关 bug。
注释质量检查。检测 AI 废话注释、空 JSDoc、TODO 无编号、调试日志等。
项目结构扫描与 AGENTS.md 更新。扫描 Go 包和前端组件结构，输出文档地图更新建议。
项目健康诊断。一键检查 Go 编译、前端构建、文件完整性、治理红线、配置一致性。
事件注册审计。扫描 EventsOn/bus.on 注册位置是否合规。
| name | build |
| description | 构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。 |
go build ./go/... 2>&1
(cd frontend && npx vite build 2>&1)
wails build -ldflags "-X ysm-model-manager/go/version.Version=vX.X.X"
wails dev
# Go 全部测试
go test ./go/... -count=1
# 指定包测试
go test ./go/paths/... -count=1 -v
pwsh ./build-release.ps1 vX.X.X
前置条件：
docs/release-notes/vX.X.X.md必须已存在。
| 错误 | 原因 | 解决 |
|---|---|---|
undefined: xxx | Go 新增文件未编译 | go build ./go/... 确认语法 |
Module not found | JS import 路径错误 | 检查路径大小写 |
wails: command not found | Wails CLI 未安装 | go install github.com/wailsapp/wails/v2/cmd/wails@latest |
| 构建后功能无变化 | 前端缓存 | Ctrl+Shift+R 硬刷新 |
| Go 改后前端调用无反应 | 未重启 | wails build + 重启应用 |
| 文件 | 职责 |
|---|---|
app.go | Wails Binding 入口 |
main.go | Go 入口 + 窗口参数 |
wails.json | Wails 配置 |
frontend/index.html | 前端入口 |
build-release.ps1 | 完整发版脚本 |