QUICKSTART.md

快速启动指南

首次运行

1. 安装依赖

cd vnode
npm install

2. 启动开发模式

npm run dev

这将启动：

• React 开发服务器（http://localhost:3000）
• Electron 应用窗口
• 后端 API 服务器（http://localhost:3001）

使用流程

1. 配置 OSS

   • 在"OSS配置"面板填写 AccessKey ID、Secret、Endpoint、Bucket 名称
   • 点击"保存配置"

2. 选择文件

   • 点击"添加文件"选择 Markdown 文件（支持多选）
   • 选择输出目录

3. 处理文件

   • 点击"开始处理"按钮
   • 在"处理日志"面板查看进度
   • 处理完成后点击"打开输出目录"查看结果

常见问题

端口被占用

如果 3000 或 3001 端口被占用：

修改 React 端口：

# Windows
set PORT=3002 && npm run dev

# Linux/Mac
PORT=3002 npm run dev

修改后端端口： 编辑 server/index.js，修改 PORT 常量

依赖安装失败

# 清除缓存重新安装
rm -rf node_modules package-lock.json
npm cache clean --force
npm install

Electron 窗口空白

确保：

1. React 开发服务器已启动（http://localhost:3000）
2. 后端 API 服务器已启动（http://localhost:3001）
3. 检查控制台错误信息

构建生产版本

# 构建 React 应用
npm run build

# 打包 Electron 应用
npm run build:electron

打包文件在 dist-electron 目录。