hanfuit
645b64fe21
服务端（Go）： - GM 塞背包/带属性装备发放：在线角色推送 op14 增量物品行，背包实时刷新，无需回角色选择界面 - GM 改金币/改等级：去掉在线拒绝，落库后推送 op14 钱包/op37 等级状态，在线实时刷新 - 等级端点统一切换到新版 GMSetCharacterLevel（自带在线刷新） - 无限/锁死疲劳模式 + 燃烧疲劳：每房间消耗 2 点、打怪与通关经验双倍 - 燃烧疲劳开关时给所有在线角色推送系统提示（op12 mode 0） - 深渊史诗掉率：GM 全局倍率 + 城镇增益药剂窗口倍率，真实接入掉落结算 启动器（Python/JS）： - 标题栏自绘、窗口 1204x717、禁止拖拽改大小、仅最小化/关闭 - GM 工具：疲劳与燃烧、深渊史诗掉率、拍卖行上架（单一定价对齐） - 拍卖行上架前端对齐服务端单一价格语义，修复 400 报错
2.6 KiB
2.6 KiB
Repository Guidelines
项目结构与模块组织
main.go是 Wails 入口，负责窗口配置和服务注册。internal/pvf/是独立可测试的 Go 解析与打包内核，包含加密、zlib 分块、字符串池和编解码逻辑；测试与实现同目录放置。services/提供ArchiveService、EditorService及共享并发状态；服务测试位于services/services_test.go。frontend/src/是 Vue 3 + TypeScript 界面，按components/和stores/组织；frontend/bindings/是 Wails 生成的绑定，不要手工修改。build/保存 Wails 各平台构建配置，docs/保存格式说明。不要提交新的构建产物或临时归档文件。
构建、测试与开发命令
wails3 task dev：启动 Wails 热重载开发环境。go test ./...：运行全部 Go 单元测试。PVF_TESTFILE=/path/to/Script.pvf go test ./...：启用真实 PVF 归档的集成、编辑和字节级回归测试；未设置时相关测试会跳过。cd frontend && npm ci：按锁文件安装前端依赖。cd frontend && npm run build：执行vue-tsc类型检查并生成生产前端资源。wails3 task build：构建完整桌面应用；go build ./...仅验证 Go 编译。
编码风格与命名约定
Go 代码使用 gofmt（可运行 go fmt ./...），包名使用小写，导出标识符使用 PascalCase。Vue 单文件组件使用 <script setup lang="ts">，组件采用 PascalCase，Pinia store 使用 useXxxStore。保持现有 2 空格前端缩进和严格 TypeScript 配置；生成的 bindings 通过 Wails 命令更新。
测试约定
测试文件命名为 *_test.go，测试函数使用 TestXxx。解析内核优先覆盖合成归档往返、编辑保存和编码边界；涉及真实数据时使用 PVF_TESTFILE，不要把个人路径硬编码。新增行为应同时补充针对性测试，并在改动范围允许时运行 go test ./... 和前端构建。
提交与 Pull Request
现有提交使用简短、动词开头的中文说明（如 优化解析、按 section 名称配置格式规则），初始化提交使用 chore: 前缀。提交应聚焦单一变更。PR 描述需说明用户可见影响、主要实现、验证命令及是否需要 PVF_TESTFILE；涉及界面时附截图或录屏，并说明兼容性影响。不要提交 frontend/dist、bin、依赖目录或 secrets。
安全与配置
不要读取、打印或提交 .env、密钥、token、凭据或密码。真实 Script.pvf 仅用于本地验证；分享日志和 PR 前检查路径、归档内容及构建输出中没有敏感信息。