cmbone/docs/method-map.md

方法地图

维护者查找入口时先看这里，再进入具体文件。

应用启动

文件	方法 / 内容	说明
main.go	main()	创建 Wails app、注册服务、嵌入资源、启动应用
internal/services/appservice.go	ConfigureAppService	配置窗口、托盘、语言资源和生命周期
internal/services/window_state.go	main window state helpers	读取和保存主窗口尺寸、最大化状态；第二窗口不参与

存储

文件	方法 / 内容	说明
internal/services/store.go	NewSuiStore	打开 SQLite 并执行初始化
internal/services/store.go	migration / CRUD 方法	初始化 hotkeys、appconfig 并提供基础读写
internal/services/store_test.go	store 测试	覆盖存储初始化和关键读写

配置

文件	方法 / 内容	说明
internal/services/appconfig_service.go	GetAppConfig / SetAppConfig	前端配置读写入口
internal/services/appconfig_service.go	GetLanguage / SetLanguage	语言配置读写入口
internal/services/appconfig_service.go	GetSettingsSchema	返回设置分组、默认值和当前值
internal/services/settings_schema.go	settings schema	集中定义主题、语言、窗口、快捷键、数据目录、日志策略和登录配置
internal/models/settings.go	AppSettingGroup / AppSettingDefinition	设置 schema 前端绑定模型

登录

文件	方法 / 内容	说明
internal/services/auth_service.go	AuthService	登录、退出、当前会话和 auth mode
internal/services/auth_service.go	LocalAuthProvider	校验后端初始化的本地固定账号
internal/services/auth_service.go	RemoteAuthProvider	真实后端登录 provider 预留边界
internal/models/auth.go	AuthSession / AuthProviderOption	前端绑定模型
frontend/src/modules/auth/LoginPage.vue	登录页	调用后端 AuthService，不写死账号密码

图片优化任务

文件	方法 / 内容	说明
internal/services/image_optimization_service.go	ImageOptimizationService	创建本地模拟图片优化任务、查询任务和结果
internal/models/image_task.go	ImageTask / ImageTaskResult / ImageTaskDetail	图片优化任务绑定模型
frontend/bindings/cmbone/internal/services/imageoptimizationservice.js	Wails binding	前端调用图片优化任务服务的生成绑定

日志

文件	方法 / 内容	说明
internal/services/log_service.go	AuditLogService	记录和查询用户动作审计日志
internal/services/log_service.go	AppLogService	记录和查询运行排错日志
internal/models/log.go	AuditLogFilter / AppLog / AppLogFilter	日志查询绑定模型
frontend/bindings/cmbone/internal/services/auditlogservice.js	Wails binding	前端调用审计日志服务的生成绑定
frontend/bindings/cmbone/internal/services/applogservice.js	Wails binding	前端调用运行日志服务的生成绑定

数据统计

文件	方法 / 内容	说明
internal/services/metrics_service.go	MetricsService	查询 P0 统计卡片和最近 N 天处理趋势
internal/models/metrics.go	DashboardMetrics / DailyMetric	统计服务绑定模型
frontend/bindings/cmbone/internal/services/metricsservice.js	Wails binding	前端调用统计服务的生成绑定

目标模板模块

模块	目标服务	说明
登录	AuthService	已实现本地固定账号 provider，真实后端 provider 保留边界
审计日志	AuditLogService	已实现记录和查询；登录、设置变更、图片任务创建已接入
运行日志	AppLogService	已实现记录和查询；图片任务失败和服务错误已接入
商品图片 AI 优化	ImageOptimizationService	已实现本地模拟任务模型和页面闭环
数据统计	MetricsService	已实现后端聚合；统计页面展示待后续扩展

热键

文件	方法 / 内容	说明
internal/services/hotkey_service.go	GetHotkeys	返回当前热键配置
internal/services/hotkey_service.go	UpHotkey	更新热键并重新注册
platform/hotkey_windows.go	Windows 热键实现	Windows 平台注册逻辑
platform/hotkey_darwin.go	macOS 热键实现	macOS 平台注册逻辑

前端

文件	方法 / 内容	说明
frontend/src/main.ts	Vue 入口	注册应用、路由和国际化
frontend/src/router/index.ts	routes	登录、主应用模块和第二窗口路由
frontend/src/layouts/MainLayout.vue	主窗口布局	侧边导航、顶部窗口区和 RouterView 内容区
frontend/src/components/template/ModulePageShell.vue	模块页共享壳	模块标题、状态和摘要卡片
frontend/src/modules/auth/LoginPage.vue	登录页	调用 AuthService 登录并处理错误
frontend/src/modules/dashboard/DashboardPage.vue	工作台骨架	P0 指标和近期任务入口
frontend/src/modules/image-optimizer/ImageOptimizerPage.vue	主业务页面	商品图片 AI 优化任务创建、列表、状态和结果预览
frontend/src/modules/logs/LogsPage.vue	日志页骨架	审计日志和运行日志入口
frontend/src/modules/statistics/StatisticsPage.vue	统计页骨架	P0 指标和 7 天趋势入口
frontend/src/modules/settings/SettingsPage.vue	设置页	复用存量设置组件，并展示后端统一设置 schema
frontend/src/modules/components-demo/ComponentsDemoPage.vue	组件示例页	输入框、多选框、下拉框、多行文本、表格、筛选、分页和状态标签
frontend/src/pages/Home/Index.vue	第二窗口入口	OCR 示例页面
frontend/src/utils/ThemeManager.ts	主题工具	主题切换和持久化协作
frontend/src/utils/i18n.ts	国际化工具	语言资源和切换

目标前端目录

目录	说明
frontend/src/layouts/	登录布局和主应用布局
frontend/src/modules/auth/	登录和会话
frontend/src/modules/settings/	设置中心
frontend/src/modules/image-optimizer/	商品图片 AI 优化业务样例
frontend/src/modules/logs/	审计日志和运行日志
frontend/src/modules/statistics/	数据统计
frontend/src/modules/components-demo/	常用组件示例