# ThCardReader 打包文件使用说明

## 打包文件信息

**文件名**: `ThCardReader_x86_Release_20250730_093247.zip`  
**大小**: 29MB  
**创建时间**: 2025-07-30 09:32:47  
**包含文件数**: 109个文件

## 解压和使用

### 1. 解压文件
将 `ThCardReader_x86_Release_20250730_093247.zip` 解压到任意目录。

### 2. 主要文件说明

#### 核心程序文件
- `ThCardReader.exe` - 主程序（714KB）
- `ThCardReader.exe.config` - 程序配置文件
- `jiangsu_config.txt` - **外部配置文件**（用户可编辑）

#### 重要DLL文件
- `HeaSecReadInfo.dll` - 江苏医保社保卡读卡器核心DLL
- `FaceNationECCode.dll` - 江苏医保刷脸认证DLL
- `SSCardDriver.dll` - 社保卡驱动DLL
- `NationECCode.dll` - 国家医保电子凭证DLL
- 其他支持库文件...

## ⚠️ 重要配置变更说明

### 🔄 新的配置加载逻辑
**程序优先从外部配置文件读取配置，如果文件不存在或配置项缺失则使用默认配置**

#### 配置加载优先级（已更新）
1. **外部配置文件** (`jiangsu_config.txt`) - **优先使用**
2. **默认配置** - **回退方案**

#### 关键变化
- ✅ **优先外部文件**: 程序优先读取 `jiangsu_config.txt` 文件
- ✅ **默认配置回退**: 如果外部配置文件不存在，程序使用默认配置
- ✅ **配置项回退**: 如果配置项缺失，程序使用默认值
- ✅ **容错机制**: 程序在任何情况下都能正常运行

### 📋 外部配置文件格式

`jiangsu_config.txt` 文件格式：
```txt
# 江苏医保配置文件
# 程序优先从外部配置文件读取配置
# 如果文件不存在或配置项缺失，将使用默认配置
# 修改此文件中的参数值，程序会自动读取
# 格式：参数名=参数值
# 以#开头的行为注释，会被忽略
# 注意：如果配置项缺失，程序会使用默认值

# 网络配置
IP=10.61.165.3
PORT=8086
TIMEOUT=30

# 日志配置
LOG_PATH=E:\huaihaiProject\readCard\ThCardReader\logs\

# 电子凭证配置
EC_URL=http://10.58.33.207:10086/localcfc/api/hsecfc/localQrCodeQuery

# 社保卡验证配置
CARD_PASSTYPE=2

# CSB接口配置
API_NAME=hssServives
API_VERSION=1.0.0
ACCESS_KEY=090ea4c914324ee38b6978365df46a80
SECRETKEY=CMgTEMfftMP0EMMoliOs65wZmv8=

# 机构配置
ORG_ID=H32132200561
AREA_CODE=321322
EXT={}

# 刷脸配置
FACE_SERVICE_URL=http://10.58.33.207:10086/localcfc/api/hsecfc/localQrCodeQuery
FACE_ORG_ID=H32132200561
```

### 🔧 配置修改步骤

1. **找到配置文件**: 在解压目录中找到 `jiangsu_config.txt`
2. **编辑配置**: 使用任何文本编辑器打开文件
3. **修改参数**: 根据需要修改相应的参数值
4. **保存文件**: 保存修改后的文件
5. **重启程序**: 重新启动 `ThCardReader.exe`

### ⚠️ 重要注意事项

#### 配置文件要求
- ✅ **文件可选**: `jiangsu_config.txt` 不是必需的，程序会使用默认配置
- ✅ **格式必须正确**: 使用 `key=value` 格式，每行一个配置项
- ✅ **配置项可选**: 可以删除任何配置项，程序会使用默认值
- ✅ **注释支持**: 以 `#` 开头的行会被忽略

#### 错误处理
- ✅ **文件不存在**: 程序使用默认配置，正常运行
- ✅ **配置项缺失**: 程序使用默认值，正常运行
- ✅ **格式错误**: 程序使用默认配置，正常运行

### 🚀 部署和使用

#### 基本部署
1. 解压ZIP文件到目标目录
2. 根据需要修改 `jiangsu_config.txt` 中的参数（可选）
3. 运行 `ThCardReader.exe`

#### 环境配置
- **开发环境**: 修改为开发服务器的地址和参数
- **测试环境**: 修改为测试服务器的地址和参数  
- **生产环境**: 修改为生产服务器的地址和参数

#### 参数说明
| 参数名 | 说明 | 默认值 |
|--------|------|--------|
| `IP` | 江苏医保服务器IP | `10.61.165.3` |
| `PORT` | 服务器端口 | `8086` |
| `TIMEOUT` | 超时时间（秒） | `30` |
| `LOG_PATH` | 日志目录路径 | `E:\logs\` |
| `ORG_ID` | 机构编号 | `H32132200561` |
| `AREA_CODE` | 行政区划代码 | `321322` |
| `ACCESS_KEY` | 接口认证密钥 | `090ea4c914324ee38b6978365df46a80` |
| `SECRETKEY` | 接口密钥 | `CMgTEMfftMP0EMMoliOs65wZmv8=` |

### 🔍 故障排查

#### 常见问题
1. **程序无法启动**
   - 检查是否安装了.NET Framework 4.8
   - 尝试以管理员身份运行
   - 查看错误日志

2. **配置不生效**
   - 确保修改后保存了文件
   - 重启程序以加载新配置
   - 检查配置项名称是否正确

3. **网络连接失败**
   - 检查 `IP` 和 `PORT` 参数是否正确
   - 检查网络连接是否正常
   - 检查防火墙设置

#### 调试方法
1. **查看日志**: 检查 `LOG_PATH` 目录下的日志文件
2. **检查配置**: 确认 `jiangsu_config.txt` 内容正确
3. **测试连接**: 使用网络工具测试服务器连接

### 📞 技术支持

如果遇到问题，请提供以下信息：
- 错误信息截图
- `jiangsu_config.txt` 文件内容（隐藏敏感信息）
- 程序运行日志
- 系统环境信息

---

**版本**: v20250730_093247  
**更新日期**: 2025-07-30  
**配置方式**: 外部配置文件优先，默认配置回退  
**兼容性**: 向后兼容，支持容错机制