01 引言与接受条款

1.1 协议主体

本协议由 FacadeAI 平台运营方（以下简称"平台方"）与使用本软件的材料供应商/业务人员（个人或其所在机构）共同缔结。

1.2 协议适用的软件与服务范围

• 本协议约束的"本软件"包括：FacadeAi.Desktop WPF 客户端及其通过 API 访问的项目数据浏览服务。
• 后端服务通过配置项提供项目检索与详情接口。

1.3 接受条款的方式

您通过以下任一方式使用本软件，即视为已阅读并同意本协议：

• 在 Windows 设备上安装、启动本软件；
• 使用平台方为您开通的账号登录本软件；
• 通过本软件访问、浏览任何项目列表或项目详情数据。

02 适用范围与角色定义

2.1 适用对象

本协议适用于通过平台方合法取得账号，并在客户端登录、浏览项目信息的材料供应商/业务人员。

2.2 角色与权限概述

• 普通账号：可登录系统并查看与其材料/行业匹配的项目列表，但可能无法打开部分项目详情页面。
• 付费权限账号：在列表基础上，另可访问项目详情中的全部字段与图片、联系人信息。

03 账号注册、登录与使用规范

3.1 账号的开通与注册

• 账号通常由平台管理员通过后台创建并分配给您，可能包含初始密码或激活流程。
• 本软件支持通过邮箱或手机号注册登录，注册时需填写：邮箱/手机号、密码、品牌、姓名、行业类别和材料类型等信息。

3.2 登录方式与凭据管理

• 您可使用邮箱或手机号 + 密码登录，本软件通过后端认证服务校验凭据，并返回 JWT 访问令牌。
• 登录成功后，令牌会被客户端保存并在后续访问 API 时附加到请求头中，实现身份识别。
• 当令牌过期或无效时，系统会提示"登录已过期，请重新登录"。

3.3 账号使用规范

• 您应妥善保管账号和密码，不得将账号转借、出租或泄露给未授权第三方。
• 如发现账号存在异常登录、密码泄露或其他安全风险，应立即通知平台方并配合处理。
• 在公共或共享设备上使用本软件后，应通过客户端"退出登录"并关闭软件。

04 授权方式、功能边界与禁止行为

4.1 授权方式

在本协议项下，平台方授予您一项非独占、不可转让、仅限内部业务使用的终端使用许可。

4.2 软件功能边界

• 本软件仅提供项目数据浏览功能，包括：项目筛选、列表查看、详情查看与图片浏览。
• 当前版本不支持：在线编辑项目数据、自助上传图片、在线签署合同、在线支付等功能。

4.3 明确禁止的行为

05 数据处理、缓存与隐私保护

5.1 项目数据流向概述

• 项目基础数据（文字字段）存储在平台方 MySQL 数据库中，通过 API 提供给客户端。
• 项目相关图片文件（效果图、立面图、节点图）存储在腾讯云 COS，对外以 URL 形式访问。

5.2 本地缓存机制

• 为提高访问速度，客户端会在本地路径 %LocalAppData%\FacadeAI\Cache 下缓存项目数据与图片。
• 缓存包含项目 JSON、加密后的图片文件以及版本索引文件。
• 缓存具有有效期和容量上限，到期或超限后会自动清理或替换。

5.3 图像加密、水印与防泄漏

• 本地缓存的项目图片会经过加密与（如配置）水印处理，以降低未经授权传播的风险。
• 您不应尝试绕过客户端逻辑直接访问原始加密文件或水印前内容。

06 付费权限与服务变更

6.1 付费权限控制

• 本软件通过用户角色与付费标记字段区分"普通账号"和"付费权限账号"。
• 部分项目详情仅向已开通付费权限的账号展示，例如详细联系人信息、部分图片资源等。

6.2 服务内容与功能变更

• 平台方可能基于产品规划和安全要求，对本软件的功能、界面和访问策略进行调整。
• 对于影响较大的变更，平台方将通过站内通知、运营邮件或线下沟通方式进行说明。

07 免责声明与责任限制

7.1 服务可用性

平台方将合理投入资源维持本软件与后端服务的正常运行，但不对因不可抗力、基础网络故障、云服务商故障等原因导致的暂时不可用承担责任。

7.2 数据准确性与完整性

本软件展示的项目信息主要来源于平台内部录入与整理，平台方会尽量保证数据的准确性与及时更新。但由于项目本身存在变更、第三方信息不对称等因素，平台方不对所有数据的绝对完整性、实时性作出保证。

7.3 间接损失的排除

在适用法律允许的最大范围内，对于因使用或无法使用本软件而导致的任何间接损失（如预期收益损失、商机损失等），平台方不承担赔偿责任。

08 违约、封禁与终止使用

如平台方发现或有合理理由认为您存在违规行为，有权视情节采取包括但不限于：警告、限制功能、暂时封禁账号、永久关闭账号等措施。

09 协议更新、通知与生效

平台方有权根据产品功能调整、法律法规变更或监管要求适时更新本协议。更新后的协议将在合理位置展示，或通过适当方式通知您。如您在协议更新后继续使用本软件，视为您接受更新后的全部条款。

10 法律适用与争议解决

本协议的订立、执行与解释，以及与本协议相关的争议解决，均适用平台方注册地的现行有效法律法规。因本协议或使用本软件产生的任何争议，双方应首先友好协商解决；协商不成的，可提交平台方注册地有管辖权的人民法院诉讼解决。

01 快速上手

1.1 我能用这个软件做什么

• 在电脑上集中浏览平台整理的建筑幕墙项目信息。
• 按地区、类别、阶段等筛选项目，快速聚焦与自己材料类型、行业匹配的项目列表。
• 对单个项目查看详细文字信息、项目图片（效果图、立面图、节点图）以及主要联系人信息（仅限有权限用户）。

1.2 使用前需要准备什么

• 账号：由平台管理员为贵司业务人员创建账号，并分配登录邮箱/手机号与初始密码。
• 网络：客户端需要能访问 API 服务器。
• 系统环境：Windows 10 或更高版本（64 位），建议分辨率 ≥ 1366 × 768，窗口最小尺寸：725 × 500。

02 安装与首次启动

2.1 获取与安装客户端

• 通过公司内部指定渠道获取安装包（对应 FacadeAi.Desktop 客户端）。
• 安装完成后，桌面会出现 "Facade Workplace" 或类似名称的快捷方式。

2.2 首次启动与基础设置

• 双击快捷方式启动客户端，首次启动会弹出带动画的欢迎窗口，提供"登录 / 注册"选择。
• 软件本身不要求额外代理配置，只需能访问 API 服务器。
• 若网络不可达，后续加载项目时会看到"请求超时"或"网络连接失败"等提示。

03 账号与登录

3.1 登录步骤

1. 启动客户端，在欢迎窗口点击"登录"，进入登录表单界面。
2. 输入管理员分配的邮箱/手机号和密码，点击"登录"。
3. 客户端调用后端认证接口验证成功后，获取 JWT 令牌，用于后续访问项目接口。

3.2 登录常见提示与处理

• "账号或密码错误 / 邮箱或密码错误"
  检查输入是否正确（注意大小写与中英文输入法），多次失败请联系管理员重置密码。
• "请求超时，请检查网络连接"
  检查本机能否访问 API 服务器；如在公司内网，请联系 IT 放行该地址。
• "用户未登录或登录已过期，请重新登录"
  表示本地登录状态已失效，按提示退出后重新登录即可。

3.3 账号类型与权限说明

• 普通账号（未开通付费权限）
  可登录、查看匹配后的项目列表；点击"查看详情"时按钮以黄色背景 + 💰 图标提示为升级入口，无法打开完整详情。
• 已开通付费权限账号
  可正常打开项目详情页，查看文字信息、图片与联系人信息。

04 主界面介绍

4.1 首页整体布局

• 顶部：菜单栏，包括 "主页、业务线索、幕墙计算、规范查询、建筑翻译、系统造价、更多" 等入口，右侧为通知铃铛、用户菜单及窗口控制按钮。
• 中部右侧：主要业务内容区，显示项目列表（ProjectDiscoveryView）或项目详情。

4.2 日常使用入口

• 日常使用主要集中在顶部"业务线索"相关入口，实际加载项目列表与详情视图。
• 右上角铃铛图标：查看新项目线索通知。
• 右上角头像：打开用户菜单（含"检查更新""帮助""退出登录"等）。

05 浏览项目与查看详情

5.1 查看项目列表

在项目列表页可以看到按时间排序的项目清单，每行展示：录入时间、项目名称、地点、类别、阶段、幕墙系统、系统面积等关键信息。

5.2 "新"标记与未读项目

• 未读项目行会使用淡黄色背景，项目名称右侧显示红色"新"标签，提示为新线索。
• 阅读后，系统会在后端记录查看行为，用于统计与个性化推荐。

5.3 打开项目详情

• 已开通付费权限账号：直接进入详情页面，查看基本信息、图片（效果图、立面图、系统标准节点图）、联系人等。
• 普通账号：按钮以黄色样式提示为升级入口，不会打开详情。

06 搜索、筛选与排序

6.1 按条件筛选项目

在列表顶部"项目筛选"区域，可以组合使用以下条件：

• 项目地点（下拉选择）
• 项目类别（下拉选择）
• 项目阶段（下拉选择）
• 录入时间（开始日期 / 结束日期）

点击"搜索"后，客户端会携带筛选条件请求后端，只返回同时满足条件且和你材料/行业匹配的项目。

6.2 重置与刷新

• 重置：清空所有筛选条件，回到第一页并重新拉取项目列表。
• 刷新：保留当前筛选和页码，从服务器重新获取数据，同时配合本地缓存检查和更新。

6.3 分页与排序

底部分页控件支持"上一页 / 下一页"，可查看更多项目。排序原则由服务器统一控制（例如按录入时间倒序），当前版本不开放自定义排序字段。

07 通知与信息提示

7.1 新项目线索提示

• 右上角铃铛图标旁的红点数字表示新匹配项目线索的数量。
• 点击后会弹出通知卡片，例如"系统为您匹配 X 个新项目线索，请查看"。

7.2 操作结果与错误提示

在列表或详情顶部，系统会提示当前操作状态，如"正在搜索项目…"、"加载项目详情中…" 等。网络异常或请求失败时，会给出具体文案便于排查。

08 个人设置

8.1 查看当前登录信息

点击右上角头像，用户面板会显示当前登录用户的名称，通常来自你的姓名 / 邮箱 / 手机号。

8.2 检查更新与帮助

用户菜单中提供"检查更新"和"帮助"按钮，用于检查版本或打开帮助入口。

09 常见问题（FAQ）

9.1 登录后列表为空或只有少量项目

可能原因：

• 账号尚未配置材料类型或行业类别；
• 在当前筛选条件下，没有匹配项目。

建议操作：

• 先点击"重置"清空筛选，再点"搜索"；
• 如仍为空，请联系管理员确认你账号的材料和行业设置。

9.2 项目详情与列表信息不一致，或图片似乎未更新

客户端会在本地缓存项目数据与图片，并通过项目版本与更新时间与服务器比对。如短时间内仍看到旧图片，可尝试：

• 在列表页点击"刷新"；
• 关闭并重新启动客户端，再重新打开该项目详情。
• 如需彻底清理本地缓存，可删除目录：%LocalAppData%\FacadeAI\Cache

9.3 打开项目图片很慢或加载失败

• 首次打开某项目时，需要从云端下载图片，加载速度取决于网络质量。
• 再次打开同一项目时，会优先使用本地缓存，通常会明显加快。
• 若持续出现"网络连接失败"提示，请检查网络或联系 IT。

9.4 频繁提示"登录已过期，请重新登录"

说明本地保存的登录状态已过期或服务器端会话已清理，属于正常安全策略。退出后重新登录即可。如频繁出现，请记录大致时间和操作步骤，反馈给技术支持用于排查。

10 使用规范与数据安全

10.1 账号使用规范

• 账号仅限本人使用，请勿与无关人员共享，也不要在不受控环境（如网吧）长时间保持登录。
• 在公共电脑上使用后，务必通过用户菜单"退出登录"，再关闭客户端。

10.2 项目信息的合规使用

10.3 操作行为的记录

为保障系统安全与优化体验，服务器会记录登录日志、项目查看记录、异常行为等信息。这类记录主要用于内部风控和服务优化，不会对外公开具体个人行为明细。

11 获取帮助与反馈渠道

11.1 反馈使用问题

建议在出现以下情况时及时反馈：

• 无法登录或频繁掉线；
• 明显的数据不一致（例如列表与详情严重不符）；
• 某些项目或图片长期无法加载。

反馈时尽量提供：

• 问题发生的大致时间；
• 主要操作步骤（例："登录 → 业务线索 → 搜索广州 → 点击某项目详情"）；
• 包含错误提示文案的截图。

11.2 业务与账号相关支持

如需新开账号、修改材料/行业配置、调整访问权限或升级为付费账号，请联系平台管理员或公司内指定对接人。所有账号与角色的变更均通过后台管理与 API 服务完成，保证审核与追踪。