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
其他支持库文件...

⚠️ 重要配置变更说明

🔄 新的配置加载逻辑

程序优先从外部配置文件读取配置，如果文件不存在或配置项缺失则使用默认配置

配置加载优先级（已更新）

外部配置文件 (jiangsu_config.txt) - 优先使用
默认配置 - 回退方案

关键变化

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

📋 外部配置文件格式

jiangsu_config.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

🔧 配置修改步骤

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

⚠️ 重要注意事项

配置文件要求

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

错误处理

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

🚀 部署和使用

基本部署

解压ZIP文件到目标目录
根据需要修改 jiangsu_config.txt 中的参数（可选）
运行 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=`

🔍 故障排查

常见问题

程序无法启动
- 检查是否安装了.NET Framework 4.8
- 尝试以管理员身份运行
- 查看错误日志
配置不生效
- 确保修改后保存了文件
- 重启程序以加载新配置
- 检查配置项名称是否正确
网络连接失败
- 检查 IP 和 PORT 参数是否正确
- 检查网络连接是否正常
- 检查防火墙设置

调试方法

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

📞 技术支持

如果遇到问题，请提供以下信息：

错误信息截图
jiangsu_config.txt 文件内容（隐藏敏感信息）
程序运行日志
系统环境信息

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

打包文件使用说明.md 5.2 KB Link permanente Histórico Em bruto