主题
排查本地助手连接
先根据页面现象选择对应处理，不要通过反复重装或修改本机状态来试错。
提示“无法连接 ZenWei 本地助手”
- 检查 Windows 托盘是否有 ZenWei 图标。
- 没有图标时，重新运行
ZenWeiLocalAgent.exe。 - 双击托盘图标，确认管理页可以打开。
- 返回“数据同步”，确认“本地助手地址”没有被误改，再点击“测试连接”。
- 仍失败时，退出重复运行的本地助手实例，检查安全软件是否阻止程序启动，然后重新运行一次。
数据源已连接，但不能进入下一步
页面还需要当前用户的本机授权。点击“请求本机授权”，在本机窗口核对用户名并允许。若窗口未出现，使用托盘菜单中的“批准当前登录用户”。
提示登录或授权失效
- 重新登录 ZenWei。
- 回到数据同步页面重新测试连接。
- 重新发起本机授权。
- 如果刚切换用户或租户，不要复用上一身份的授权。
KIS 测试连接失败
- 确认目录包含同一账套的导出说明和科目、币别、凭证、余额文件。
- 确认导出说明中有非空账套名称。
- 一个目录不要混放多个 KIS 账套。
- 多年度目录应只包含同一账套，并保证同一年度文件来自一致的导出批次。
- 整理目录后回到管理页重新保存并测试。
K3 或 U8 测试连接失败
- 确认数据源类型选择正确。
- 确认当前电脑能够访问传统系统所在网络。
- 使用只读数据库账号，并由系统管理员检查账号权限和账套数据库是否正确。
- 不要把连接信息粘贴到 AI 对话、截图或支持工单正文中。
提示能力未启用或文件路径不允许
这表示本地助手的能力开关或安全目录不允许当前请求。不要改用路径跳转、系统目录或其他命令绕过。联系管理员核对是否确有业务需要，并在批准范围内重新选择文件。
提示数据正在读取
本地助手同一时间只处理一个数据读取任务。等待当前读取结束后再重试，不要连续点击多个同步入口。
联系支持前准备
- 本地助手版本和问题发生时间。
- 页面显示的完整中文错误，不含敏感数据。
- 数据源类型和是否能打开管理页。
- 当前是连接、授权、预览还是导入阶段。
- 可脱敏的页面截图。