故障排查 + 进阶问题
本节列出企业客户在评估、部署、日常使用中常被问及的问题：故障定位、平台边界、合规边界、支持渠道与升级机制。详细问题请通过 support@tinqiao.com 提交。
01 · 快速查诊清单
发生异常时，按以下顺序定位：
| 现象 | 排查步骤 |
|---|---|
| 客户端起不来 / 启动卡死 | 查看 %USERPROFILE%\.clawtouch\webui.log；常见为 USB 端口被占用、依赖文件损坏 |
| HID 设备不识别 | Windows 设备管理器查看 USB HID 设备；换 USB 端口尝试；确认硬件序列号与软件 license 绑定一致 |
| 任务执行卡住 | 小程序管理端查看心跳；确认大语言模型 API 配额未耗尽；查任务日志中最后一步 |
| 配额异常告警 | 桌面客户端顶栏点开额度面板；若已超限请联系商务（support@tinqiao.com） |
| 飞书机器人连不上 | 确认桌面客户端在线 + 飞书机器人配置正确（设置 → 集成）；检查授权 open_id 是否在白名单 |
| 感知异常 / 误识别 | 查任务日志中感知层输出；UI 改版较大时由亭桥侧补特定平台适配 |
02 · 平台支持边界
| 问题 | 答案 |
|---|---|
| 是否支持 macOS / Linux 桌面？ | 当前仅支持 Windows 10 / 11 (x64)。其他桌面平台暂无明确路线图。 |
| 是否支持移动端操控？ | 不支持。ClawTouch 通过物理 HID 硬件操控桌面键鼠，移动端无对应输入路径。手机端通过小程序查看设备状态、订阅与工单；如需远程对话或启停托管，请使用飞书机器人对接桌面客户端。 |
| 是否支持云桌面 / 虚拟桌面？ | HID 硬件依赖物理 USB 接入；云桌面、远程桌面等虚拟化场景需个案评估。 |
| 是否需要管理员权限？ | 不需要。客户端运行在普通用户上下文；不注入进程，不要求关闭杀毒软件。 |
| 是否兼容企业域账户 / 组策略？ | 兼容。客户端不修改系统全局设置。 |
| 是否支持多语言界面？ | 当前为简体中文。其他语言按订制需求评估。 |
03 · 单设备桌面任务能力
ClawTouch 设计为单设备单授权主体——一台 HID 设备对应一台 Windows 终端上由本人持有并使用的桌面环境。在该终端下，可配置任务模板、节奏与风格筛选，并查看运行记录。具体能力包括：
- 任务模板可复用——同一套模板可应用到本人的不同桌面任务
- 跨浏览器兼容——Chrome / Edge / Firefox 等主流浏览器均可使用
- 节奏 / 长度 / 风格筛选可在管理端逐项配置
客户对本人账号的运营策略、对所用平台规则的遵守责任，由客户自身承担。详见下节合规边界声明。
04 · 平台合规边界声明
ClawTouch 是企业自有运营效率工具。亭桥主动声明以下边界，并将其写入主服务协议：
- 不提供伪造身份、虚假信息、虚假证件相关的功能
- 不提供规避平台账户验证、安全验证的功能
- 不用于平台规则禁止的群发、自动加好友、骚扰营销等场景
- 不用于违反《反不正当竞争法》《广告法》《消费者权益保护法》等法律的运营行为
- 客户使用过程中产生的内容、对账号的运营策略、对平台规则的遵守责任由客户自身承担
上述边界与客户的使用合规义务一并写入合同。亭桥保留对违反边界使用的客户终止服务的权利。
05 · 支持渠道
| 渠道 | 用途 | 响应预期 |
|---|---|---|
邮箱support@tinqiao.com |
商务咨询、技术支持、合同变更 | 工作日 4 小时内 |
| 小程序工单 | 日常使用问题、配置咨询 | 工作日 30 分钟内 |
| 企业微信客服 | 紧急问题（订制客户） | 实时 |
| 24 小时专属运维 （升级订制） |
7×24 监控 + 故障响应 + 升级伴随 | 按 SLA |
06 · 版本与升级
- 客户端 OTA：客户端启动时检测新版本；用户可选择升级或延后
- 小程序版本：服务端推送，无需用户操作
- 重大协议变更：用户协议、隐私政策的版本升级会触发管理端的重新同意流程
- 兼容矩阵：客户端发布新版时同步给出最低兼容服务端版本，不会强行下线老客户
- 离线部署升级：通过离线升级包 + 客户 IT 部署，由亭桥技术支持协助