# 数据与外部服务

> 更新：2026-10-19。实际数据位置、保留周期和可用渠道以部署配置及服务约定为准。

## 1. 数据存放位置

云端使用时，业务数据保存在运营方配置的服务器；私有化部署时，保存在部署方配置的环境。浏览器是访问入口，不代表数据库位于当前电脑。

系统数据目录可通过 MZ_DATA_DIR 指定；未指定时使用默认目录。数据包含系统库、账套库、归档文件及必要密钥等，迁移完整性须按数据、文件及密钥清单核验。

## 2. 本地能力和外部能力

部分问答、文字解析、凭证推荐、检查和分析使用本地规则或正式业务接口取数，不要求模型网关。模型辅助与自由规划需要对应权限、服务状态、档位和已配置网关。本地功能不代表所有接口功能均可离线使用。

模型、OCR、发票取票、电子申报、电子开票、业务通知与 BI 推送等配置统一在「终端管理 → 外部接口」。部分配置为全局配置，部分按账套保存，以页面标注为准。不同单位的税务凭据应分别管理，禁止混用。

## 3. 接口启用前检查

1. 选定服务商，确认地址、模型名或渠道标识及授权范围。
2. 在对应设置页保存密钥，不在对话中发送密钥。
3. 阅读页面说明，确认会发送的业务问题、资料或文件。
4. 使用专用测试资料核验连接及处理结果，验证通过后开展正式业务。

启用模型后，任务问题、相关业务资料及工具结果可能发送给配置的模型服务。OCR 会发送待识别文件；取票、申报、开票等渠道会发送相应身份或业务资料。第三方的计费、数据处理与可用性由其实际服务决定。

## 4. 连接故障处理

应核对服务地址、模型名称、渠道权限及密钥保存状态。401 通常需要检查认证；403 需要检查授权或服务范围；429 需要根据服务商反馈检查额度或限流；网络超时需要检查服务器到服务商的连通性。涉及数据写入的操作，应核实业务结果后决定是否重新提交。

密钥留空是否保留已有值，以当前设置页提示为准。重置或清除接口后，相关外部功能可能不可用。本地业务数据不会因为更换模型服务而自动删除。

## 5. 备份与恢复

在管理员安排下确认备份是否启用、保存位置、保留周期及恢复演练情况。云端备份到本地电脑需要运维部署相应工具、连接和执行计划；浏览器登录不会自动建立此类备份任务。

迁移或恢复应覆盖必要数据库、文件和加密密钥。运行中的 SQLite 数据目录不得通过多端同步盘进行并发写入。具体操作见部署及维护文档，由具备权限的实施人员执行。

账套移入回收站后，可在保留期内由有权限人员恢复；当前默认保留 30 天。彻底删除或过期清理后不能通过回收站恢复。会话删除与账套删除是不同操作。

## 6. 服务范围

协作人数、账套额度、模型调用量、升级支持、实施培训、备份责任与恢复目标按实际服务约定执行。额度、升级费用及外部服务数据处理范围应在服务约定中明确。

- [快速上手](使用须知与首次使用指南.md)
- [审批与任务](审批与任务指南.md)
- [部署指南](部署指南.md)
- [维护手册](维护手册.md)