4.5 KiB
4.5 KiB
方法地图
维护者查找入口时先看这里，再进入具体文件。
应用启动
| 文件 | 方法 / 内容 | 说明 |
|---|---|---|
main.go |
main() |
创建 Wails app、注册服务、嵌入资源、启动应用 |
internal/services/appservice.go |
ConfigureAppService |
配置窗口、托盘、语言资源和生命周期 |
存储
| 文件 | 方法 / 内容 | 说明 |
|---|---|---|
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/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，不写死账号密码 |
目标模板模块
| 模块 | 目标服务 | 说明 |
|---|---|---|
| 登录 | AuthService |
已实现本地固定账号 provider，真实后端 provider 保留边界 |
| 审计日志 | AuditLogService |
记录登录、设置变更、任务操作、导出等用户动作 |
| 运行日志 | AppLogService |
记录 AI 调用、数据库、文件、热键等错误 |
| 商品图片 AI 优化 | ImageOptimizationService |
创建任务、查询状态、查看结果和失败原因 |
| 数据统计 | MetricsService |
聚合今日处理量、成功率、耗时、失败数和 7 天趋势 |
热键
| 文件 | 方法 / 内容 | 说明 |
|---|---|---|
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 |
设置页骨架 | 复用存量主题、语言和快捷键设置 |
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/ |
常用组件示例 |