ThinkLink APP 软件使用说明书
ThinkLink APP Software User Manual
Document Version 1.0 · 2026
1. 软件概述
ThinkLink APP 是面向工业物联网设备现场运维与实时监控的移动客户端，基于 uni-app 与 Vue 3 构建。目前正式提供 Android APK 版本，客户端通过独立的 ThinkLink Mobile Server 接入业务数据。
1. Overview
ThinkLink APP is a mobile client for industrial IoT field operations and real-time monitoring. Built with uni-app and Vue 3, it is currently distributed as an Android APK and accesses business data through ThinkLink Mobile Server.
2. 主要功能
- 首页：网关、设备、资产、子设备及最新告警总览。
- 场景：场景创建、设备绑定与仪表板管理。
- 设备：详情、实时数据、历史曲线、关联、物模型及 RPC。
- 告警：列表、详情、已读、解除和处理备注。
- 网络与网关：AS、NS、IP 数据及网关详情。
- 我的：租户、语言、服务器、版本和退出登录。
2. Key Features
- Home: gateway, device, asset, sub-device, and recent alarm overview.
- Scenes: scene creation, device binding, and dashboard management.
- Devices: details, live data, history, relations, thing models, and RPC.
- Alarms: list, details, read status, dismissal, and notes.
- Network & gateways: AS, NS, IP data, and gateway details.
- Profile: tenant, language, server, version, and sign-out.
3. 首次配置与登录
- 在登录页进入“服务器设置”。
- 选择 HTTP；主机填写 192.168.1.216；端口填写 80；路径填写 tkl-mobile-server。
- 点击“测试连接”，成功后点击“保存并应用”。
- 返回登录页，输入管理员提供的账号密码并登录。
- 如设备由多人共用，请勿勾选“记住密码”。
3. First-time Setup & Sign-in
- Open “Server Settings” from the login screen.
- Select HTTP; enter host 192.168.1.216, port 80, and path tkl-mobile-server.
- Tap “Test Connection”, then “Save & Apply” after success.
- Return to login and enter credentials supplied by your administrator.
- Do not enable “Remember password” on a shared device.
4. 日常操作
登录后在底部导航切换“首页、场景、设备、我的”。下拉页面可刷新数据。打开设备详情可查看实时数据和历史曲线；具有权限的用户可下发 RPC 指令。告警详情页支持处理状态更新和备注。租户切换位于“我的”页面。
4. Daily Operation
Use the bottom navigation to switch between Home, Scenes, Devices, and Profile. Pull down to refresh. Open a device for live data and history; authorized users may send RPC commands. Alarm details support status updates and notes. Tenant switching is available under Profile.
5. 权限与数据安全
用户只能访问其账号和当前租户授权范围内的数据。RPC 属于远程控制操作，应在确认目标设备、指令参数及业务影响后执行。密码与令牌由客户端本地保存机制管理；共享设备应退出登录并避免保存密码。
5. Authorization & Security
Users may access only data authorized for their account and active tenant. RPC is a remote-control action; verify the target, parameters, and operational impact before execution. Passwords and tokens are managed in local client storage. Sign out and avoid saving passwords on shared devices.
6. 运行与网络要求
- 测试环境需能访问 192.168.1.216 所在内网。
- 服务器 API 基址：
http://192.168.1.216/tkl-mobile-server。 - 正式环境建议使用受信任证书的 HTTPS。
- 微信小程序需配置合法域名、AppID 及相应网络白名单。
6. Runtime & Network Requirements
- The test device must reach the LAN containing 192.168.1.216.
- Server API base:
http://192.168.1.216/tkl-mobile-server. - Use HTTPS with a trusted certificate in production.
- WeChat Mini Program requires a valid AppID, approved domains, and network allowlisting.
7. 常见问题
- 无法连接：确认手机与服务器网络可达、协议/主机/端口/路径无误。
- 登录失败：确认已保存正确服务器，并检查账号密码与租户权限。
- 数据不更新：下拉刷新，检查网络及服务器状态。
- RPC 无法执行：确认账号权限、设备在线状态和参数格式。
7. Troubleshooting
- Cannot connect: verify network reachability and protocol, host, port, and path.
- Sign-in fails: confirm the saved server, credentials, and tenant authorization.
- Data is stale: pull to refresh and check network/server status.
- RPC fails: verify permission, device status, and parameter format.
版本与支持：在“我的 → 关于”查看 APP、后端与数据库版本。Version & support: View app, backend, and database versions under Profile → About. Before public launch, add the legal entity, registration details, privacy policy, terms, support email, and official download QR code.
完整页面操作手册
Complete Page-by-Page Manual
以下 20 个页面覆盖 ThinkLink APP 当前全部业务路由。截图取自实际手机端界面，说明按推荐操作顺序编排。
These 20 pages cover every current ThinkLink APP route. Screenshots come from the live mobile interface and follow the recommended workflow.
PAGE 01登录
Sign in
入口：启动 APP。输入账号和密码后点击“登录”；个人设备可选择记住密码，也可切换中英文。
Entry: launch the app. Enter account and password, then sign in. Remember credentials only on a private device.
首次使用应先进入“服务器设置”。微信入口为后续授权登录预留。
Configure the server first. The WeChat entry is reserved for authorized sign-in.
PAGE 02服务器设置
Server settings
入口：登录页“服务器设置”或“我的 → 服务器配置”。选择协议，填写主机、端口、路径和 MQTT 地址；先测试连接，再保存应用。
Entry: Login → Server Settings or Profile → Server Config. Set protocol, host, port, path, and MQTT; test before saving.
- 本次配置：HTTP / 192.168.1.216 / 80
- 路径：tkl-mobile-server
- Current: HTTP / 192.168.1.216 / 80
- Path: tkl-mobile-server
PAGE 03首页总览
Home overview
查看网关、设备、资产、子设备的总量及在线/离线状态。功能入口包含设备、RPC 日志、网络、场景总览和施工；点击告警或“查看全部”进入告警处理。
Review totals and status. Open Devices, RPC Log, Network, Scene Overview, Construction, or recent alarms.
PAGE 04场景列表
Scenes
入口：底部“场景”。按名称搜索场景，查看场景内网关、设备、资产、子设备及在线统计，点击“进入”打开场景详情。
Entry: bottom tab Scenes. Search by name, review asset/status counts, and tap Enter for details.
PAGE 05场景详情
Scene details
查看场景统计、仪表板和已绑定设备。设备行支持查看详情、发送 RPC、历史数据和移除；“添加”用于绑定更多设备。
View statistics, dashboards, and bound devices. Each device supports details, RPC, history, and removal.
移除设备会改变场景绑定关系，操作前确认目标。
PAGE 06场景添加设备
Add devices to scene
入口：场景详情“添加”。在设备、资产、子设备和网关分类间切换，勾选目标后点击底部“添加”。
Entry: Scene Details → Add. Switch categories, select targets, and confirm Add.
PAGE 07场景总览
Scene overview
入口：首页“场景总览”。集中展示各场景拥有的仪表板数量和仪表板入口，点击卡片打开对应看板。
Entry: Home → Scene Overview. Review dashboards by scene and open the selected board.
PAGE 08仪表板
Dashboard
仪表板以嵌入网页方式展示场景可视化。页面顶部可返回场景，也可在外部浏览器打开。
Dashboards are embedded web views. Return to the scene or open the board in an external browser.
需确保手机网络可以访问仪表板地址。
PAGE 09设备列表
Devices
入口：底部“设备”。可按 EUI 或设备名称搜索，并在设备、资产、子设备、网关四类间切换；点击列表项进入详情。
Entry: bottom tab Devices. Search by EUI/name, switch categories, and tap an item for details.
PAGE 10设备详情
Device details
使用“概览、数据、RPC、告警、关联、照片”标签查看设备全量信息。支持重命名、编辑标签和设置项目/位置。
Use Overview, Data, RPC, Alarms, Relations, and Photos. Rename devices, edit tags, and set project/location.
PAGE 11历史曲线
History
从设备详情的数据字段或场景设备操作进入。选择物模型、字段和时间范围（今天、24 小时、7 天或自定义）查询趋势。
Open from a device data field or scene device action. Select model, field, and time range.
PAGE 12网关详情
Gateway details
从设备页切换到“网关”分类后进入。查看心跳、类型、版本、LoRa 标准、在线时间和位置；具备权限时可执行网络、Ping、参数、透传和升级。
Open from Devices → Gateways. Review status/version data and perform authorized diagnostics or upgrades.
升级、透传和参数修改属于高风险操作，应先确认权限和维护窗口。
PAGE 13网络数据
Network data
入口：首页“网络”或网关详情“网络”。在 AS、NS、IP 数据间切换，按 DevEui 搜索，并使用全部、今天、近 7 天、近 30 天筛选。
Entry: Home → Network or Gateway → Network. Switch AS/NS/IP, search DevEui, and filter by time.
PAGE 14告警列表
Alarms
从首页铃铛、最新告警或“查看全部”进入。按 EUI 搜索及等级筛选；每条告警支持详情、备注和解除，批量模式用于集中处理。
Open from the bell or recent alarms. Search/filter, then view details, add notes, dismiss, or use batch mode.
PAGE 15告警详情
Alarm details
查看等级、状态、告警名称、设备 EUI、触发来源、时间和类型。可进入关联设备、添加处理备注或解除告警。
Review severity, status, source, time, and device. Open the related device, add notes, or clear the alarm.
解除前确认现场异常已处理，并记录必要的处理说明。
PAGE 16发送 RPC
Send RPC
从场景设备“发送 RPC”或设备详情“RPC”进入。选择命令，按定义填写参数，复核目标设备后执行。
Open from a scene device or Device → RPC. Select a command, enter parameters, verify the target, and execute.
RPC 会远程改变设备状态，禁止对不明确的目标或参数试发。
PAGE 17RPC 日志
RPC log
入口：首页“RPC 日志”或设备 RPC 标签中的日志入口。按时间查看级别、设备、来源、命令及执行结果，用于审计和故障排查。
Entry: Home → RPC Log or Device → RPC. Review timestamp, level, device, source, command, and result.
PAGE 18施工
Construction
入口：首页“施工”。从允许用于施工的 RPC 列表中选择任务，按页面提示填写参数并执行；安装照片等资料用于现场留档。
Entry: Home → Construction. Select an approved construction RPC, provide parameters, and retain site records.
PAGE 19我的
Profile
入口：底部“我的”。查看账号和当前租户，切换组织，进入安全、服务器、语言与关于页面；底部显示 APP 和服务器版本。
Entry: bottom tab Profile. Review account/tenant, switch organization, open settings, and check versions.
PAGE 20安全与第三方账号绑定
Security & account binding
入口：“我的 → 安全”。查看微信与 Google 的绑定状态；微信登录正式开放后，可在此完成账号绑定或解绑。
Entry: Profile → Security. Review WeChat/Google binding and bind or unbind supported sign-in methods.
绑定和解绑会影响第三方登录方式，须验证当前账号身份。
