══════════════════════════════════════════════════════════════
  电力通AI计价平台（桥接版）  v1.0.0.0
══════════════════════════════════════════════════════════════

【本版本与离线版的本质区别】
  · 定额库位置：本机【不保存数据库】。定额库 / 清单库 / 价格库
    全部放在服务端，由「桥接服务」通过 HTTP 统一提供；客户端
    只负责取数，不落盘任何定额数据。
  · 计算位置：组价、取费、汇总等全部计算仍然在【本机完成】。
    桥只回答「这条定额的消耗量是多少」「这条清单的组价方案是
    什么」，不会替你算价。
  · 使用前提：本机必须能访问服务端的桥接服务（内网 / VPN /
    互联网均可，按部署方式而定）。断网且无法访问桥服务时，
    软件会明确提示「无法连接定额库服务」。
  · 适合希望数据集中管理、不在客户机留存定额库的交付场景。

【快速开始】
  1. 确认网络可以访问服务端（部署方会告知桥地址与端口）。
  2. 双击「电力通AI计价平台桥接版.exe」启动。
  3. 首次使用请点击标题栏右侧【登录】，输入 APIKEY 激活
     （未登录时功能锁定）。
  4. 激活后首页可新建预算 / 概算 / 结算 / 审核工程，
     或打开 .PWT7 计价文件；所有定额检索经由服务端返回。

【服务端地址配置（bridge.json）】
  · 程序目录下的 bridge.json 决定软件连哪台桥接服务：
        {
          "mode": "remote",
          "url": "http://<服务器IP>:8790",
          "key": "<访问口令>",
          "timeout": 30
        }
  · url  ：桥接服务地址，部署方提供（默认端口 8790）。
  · key  ：访问口令；服务端设了口令则此处必须一致，否则
           提示「桥接服务拒绝访问：密钥不正确」。
  · 交付前请按客户实际服务器改写 url 与 key，改完即生效
    （无需重新打包）。

【部署方：如何启动桥接服务】
  桥接服务是独立的程序，与其它在线服务（如 ai-zaojia.cn）互不
  影响，可部署在任意一台能访问定额库的机器上：

      python bridge/server.py --host 0.0.0.0 --port 8790 --key <口令>

  · 数据来源：该机器上的 data\quota.pwtdb（AES-256-GCM 加密库）
    或 data\quota.db（明文库）；桥服务负责解密与查询。
  · 启动后可用浏览器访问 http://<服务器IP>:8790/health 验证，
    返回 JSON 含数据规模统计即正常。
  · 自检：python bridge/server.py --self-test

【常见问题】
  · 启动提示「无法连接定额库服务」：
      - 确认已连内网 / VPN；
      - 确认服务端桥接服务已启动、端口未被防火墙拦截；
      - 确认 bridge.json 的 url / key 与部署方提供的一致。
  · 提示「桥接服务拒绝访问：密钥不正确」：
      - bridge.json 的 key 与服务端启动参数 --key 不一致，改为一致。
  · 检索定额变慢：
      - 桥接取数依赖网络，弱网下比离线版慢；属正常现象。
      - 大量检索建议与服务端在同一内网，或就近部署。

【APIKEY 授权登录】
  · 授权后台：工料机官网 gongliaoji.cn（与本系列其他计价软件
    同一后台）。
  · 获取步骤：打开 gongliaoji.cn 注册登录 → 后台【软件授权】
    → 选择「电力通AI计价平台」→ 填写试用起止时间并生成
    SK- 开头的 APIKEY。
  · 在标题栏【登录】输入 APIKEY 即激活；验证通过后全部功能
    即时解锁。若需试用，可先输入试用密钥 PWT-TRIAL-8888
    （自首次登录起 7 天有效）。

【数据安全说明】
  · 桥接版客户端不含数据库，客户机上不会留存定额库明文，
    降低了被随手拷走的风险。
  · 定额数据在网络传输过程中经过服务端口令校验；请为正式
    部署设置强口令，并仅在受信任网络内开放端口。
  · 本版与离线版、联网版共用同一套 UI 与计价逻辑，计算结果
    完全一致（已通过 15 项一致性比对验证）。

══════════════════════════════════════════════════════════════
  技术咨询：请联系服务商
  Copyright © 2026 电力通软件 版权所有
══════════════════════════════════════════════════════════════
