社区论坛
交流工具使用、配置与问题一、功能名称
配置文件总览（支撑全部配置驱动工具）
二、实现逻辑
桌面端所有货代规则、API 映射、工具记忆均存放在程序目录 configs/，JSON 格式，可被菜单工具或直接编辑。
三、数据 / 字段 / 配置支撑
configs/invoice/— 各货代发票规则 + invoice_settings.jsonconfigs/api/— API 下单、箱唛下载、国家码configs/报关资料.json、商检单.jsonconfigs/preentry_layout/— 预录单 PDF 版式configs/tools_config.json— 各工具上次路径configs/window_positions.json— 窗口位置记忆
四、使用教程
- 升级程序时务必备份整个 configs 目录。
- 新货代：复制最接近的 invoice JSON 改名，用「发票配置编辑器」调整。
- API 密钥放在 api 配置中，勿泄露；生产环境用环境变量或加密存储。
- 修改 JSON 后建议重启对应工具窗口使配置生效。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 「读取/写入 tools_config 失败」 | 检查 configs/tools_config.json JSON 格式是否合法；恢复备份或删除损坏段落后重启。 |
| 货代 JSON 报 CONFIG_JSON_INVALID / CONFIG_SCHEMA_INVALID | 用「发票配置编辑器」打开检查；确保 version: 2、template 路径、sheet 名称正确。 |
| API 配置「读取配置失败」 | 检查 configs/api/*.json 语法；确认 *_api_config.json 中 endpoint 和密钥字段完整。 |
| 报关/商检 JSON「加载配置文件失败」 | 验证 configs/报关资料.json、configs/商检单.json 格式；恢复备份。 |
| 预录单「未找到预录单版式配置」 | 确认 configs/preentry_layout/{模板名}.json 存在且文件名与工具选择一致。 |
| 修改配置后工具仍用旧值 | 重启对应工具窗口；涉及数据库映射的改动需「重新加载数据库」。 |
| 升级程序后配置丢失 | 升级前备份 configs/ 整个目录；新版本解压后覆盖还原。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复