0763a2623b
- 添加验证码登录支持（图形验证码显示和输入） - 修复订单同步，正确解析收件人信息（从logisticses合并） - 修复API端点配置（user.api.it120.cc） - 添加Costura.Fody实现单文件EXE打包 - 添加应用图标（app.ico） - 添加Inno Setup安装脚本（支持Win7+） - 暂时禁用导入发货功能 - 添加.gitignore文件 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.7 KiB
2.7 KiB
包装商城发货助手
轻量级订单发货客户端，专为子账号管理员设计
功能特性
- ✅ 手机号登录（API工厂认证）
- ✅ 订单列表查看（本地SQLite缓存）
- ✅ 订单同步（增量/全量）
- ✅ 单个订单发货
- ✅ 批量发货（并发控制）
- ✅ 导出待发货订单Excel
- ✅ 导入快递单号批量发货
- ✅ 离线查看缓存订单
技术栈
| 组件 | 技术 | 版本 |
|---|---|---|
| 桌面框架 | WPF | .NET Framework 4.8 |
| 架构模式 | MVVM | CommunityToolkit.Mvvm 8.2 |
| 本地数据库 | SQLite | System.Data.SQLite 1.0.118 |
| Excel处理 | ClosedXML | 0.102.2 |
| JSON处理 | Newtonsoft.Json | 13.0.3 |
系统要求
- 操作系统: Windows 7 SP1 或更高版本
- 运行时: .NET Framework 4.8（Win7已内置，无需额外安装）
- 磁盘空间: ~10MB
开发环境
- Visual Studio 2019+ 或 .NET SDK 8.0+
- .NET Framework 4.8 开发工具
编译步骤
方式一：命令行编译（推荐）
# 还原依赖并编译
dotnet build PackagingMallShipper.sln -c Release
# 输出文件位于
bin/Release/net48/PackagingMallShipper.exe
方式二：Visual Studio
- 使用 Visual Studio 2019+ 打开
PackagingMallShipper.sln - 还原 NuGet 包
- 选择
Release配置 - 生成解决方案
- 输出文件位于
bin/Release/net48/目录
配置说明
编辑 App.config 配置API参数：
<appSettings>
<!-- API工厂配置 -->
<add key="ApiBaseUrl" value="https://api.it120.cc" />
<add key="SubDomain" value="let5see" />
<!-- 同步配置 -->
<add key="SyncPageSize" value="50" />
<add key="ShipConcurrency" value="3" />
</appSettings>
数据存储
本地数据库位置：%LOCALAPPDATA%\PackagingMallShipper\data.db
使用流程
- 登录 - 使用API工厂子账号登录
- 输入用户名或手机号
- 输入密码
- 输入图形验证码（点击图片可刷新）
- 首次登录建议勾选"记住用户名"
- 同步订单 - 点击"同步订单"获取最新订单
- 查看订单 - 切换状态筛选，搜索订单
- 发货方式一 - 导出Excel → 填写快递信息 → 导入发货
- 发货方式二 - 选择订单 → 填写快递信息 → 单个发货
项目结构
PackagingMallShipper/
├── Models/ # 数据模型
├── ViewModels/ # 视图模型（MVVM）
├── Views/ # XAML视图
├── Services/ # 业务服务
├── Data/ # 数据访问层
├── Helpers/ # 工具类
├── Converters/ # 值转换器
└── Resources/ # 资源文件