# vc_debug_tool_exe

**Repository Path**: rico6/vc_debug_tool_exe

## Basic Information

- **Project Name**: vc_debug_tool_exe
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-13
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VC Debug Tool

一个基于 Electron、React、TypeScript、Vite 和 Tailwind CSS 的桌面软件基础框架。

## 已实现基础能力

- 现代化主界面骨架，主业务页面暂时留空
- 设置页：服务器 IP、端口、协议、启动方式、开机自启、自动更新、主题
- 登录页：已预留主进程认证服务，当前为模拟登录，后续可接真实服务器 API
- 日志服务：主进程统一记录日志，前端日志页展示最近日志
- SQLite 数据库：使用 `sql.js`，数据库文件保存到设置里的默认存储目录
- 安全 IPC：通过 preload 暴露受控 API，渲染进程不直接启用 Node
- 打包配置：支持 NSIS 安装包和 zip

## 常用命令

```bash
npm run dev
npm run typecheck
npm run build
npm run dist
npm run dist:dir
```

## Windows 批处理脚本

开发调试：

```bat
dev.bat
```

完整打包，输出安装包和 zip 到 `release`：

```bat
build.bat
```

只构建绿色目录，输出到 `release\win-unpacked`：

```bat
build_dir.bat
```

如果只是日常开发，优先运行 `dev.bat`。如果只是想快速看最终 exe 目录，运行 `build_dir.bat`。

## 目录结构

```text
electron/
  main.ts       Electron 主进程入口
  preload.ts    安全 API 桥接
  ipc.ts        IPC 注册
  settings.ts   设置持久化和系统启动项
  database.ts   SQLite 文件数据库
  logger.ts     日志服务
  auth.ts       登录服务
src/
  App.tsx       应用界面和页面
  components/   可复用 UI 组件
  lib/          前端工具函数
```

## 后续接真实登录

真实服务器登录逻辑集中在：

```text
electron/auth.ts
```

后续只需要把当前模拟登录替换为 HTTP 请求即可，前端和 IPC 层不需要大改。