查找业务记录
客户关注一次巡检的设备、任务、影像和异常从哪里查？
明确项目、对象和时间范围，按当前能力查询列表、详情及关联上下文。
可交接成果带筛选范围和对象身份的记录清单、统计及可访问的证据入口。
Work & handoff
从查找记录，
到接着结果继续工作
当资料分散在设备、任务、影像和事件记录中，人员往往需要先找入口，再判断记录是否属于同一对象、同一时间范围。智能助手可以按问题组织已授权的查询和操作，让后续人员接着原始对象与记录核对，而不只收到一段脱离来源的回答。
维护业务资料
客户关注已确认的信息怎样回到对应业务记录？
识别准确对象，按该能力接受的字段创建或更新记录，再回读保存结果。
可交接成果新建或更新后的记录身份、实际字段及回读结果。
跟踪长任务
客户关注导出或数据处理提交后，怎样知道结果在哪里？
保存作业身份，跟踪运行、失败或取消情况，完成后检查实际产物。
可交接成果作业身份、最终状态、失败原因或获得授权的产物入口。
准备需确认操作
客户关注怎样先看清操作对象和影响，再决定是否执行？
对要求确认的删除、实体设备等操作先生成具体计划，展示范围、参数、影响与有效期。
可交接成果可审阅的计划；确认执行后继续核对执行记录与实际结果。
上述为工作方式与交接材料说明，不是一次真实查询或已完成操作的演示。某项能力是否能使用，应在所选环境、项目与当前用户权限下核对。环境与服务检查使用独立的 Operator 连接；维护完成后仍须核对对应服务或业务表现。
Workflow
先明确范围，
再查询、确认与跟踪
助手根据本次问题查找当前可用能力，在调用前核对输入、权限与执行方式；结果回到对应业务对象，供后续人员继续查看和核查。
流程示意，可左右滑动或用方向键浏览。
- 01
确认用户指向的环境和项目。
- 02
读取当前上下文，搜索所需业务能力并取得输入、输出与权限要求。
- 03
对只读查询直接取证；对写入提供准确对象和必要字段。
- 04
对需要确认的破坏性或实体设备操作生成具体计划。
- 05
确认后执行对应计划，继续查询最终状态和实际结果。
Results
看清当前阶段，
知道还要核对什么
一次回答应说明查询或执行覆盖了什么，并把无法获得的部分保留下来。不同阶段对应不同材料，便于接手人员判断下一步。
01查询返回记录
在本次身份、项目、筛选及分页范围内取得这些记录。
继续核对是否有截断、缺失时段或权限限制；空结果的实际范围。
02写入返回成功
对应接口接受并完成本次写入。
继续核对回读目标对象的持久化字段和关联关系。
03计划已准备
已形成供审阅的具体操作范围。
继续核对用户是否确认原计划、计划是否仍有效；尚未执行。
04作业已提交或运行中
可以按作业身份继续跟踪。
继续核对最终状态、失败信息及产物是否实际存在且可访问。
05执行或作业结束
对应流程到达返回的终态。
继续核对预期文件、服务或现场业务结果是否满足本次要求。
没有权限、连接失败、目标不明确或能力未开放时，应明确说明缺少什么。查询范围不完整时保留范围说明；不能把无法查询写成没有记录，也不能自行改走其他入口扩大访问。
Business & operations
项目业务与环境运维，
分别选择授权入口
LingMind 业务助手
项目业务人员与获授权操作人员
- 工作范围
- 项目记录、统计、媒体、任务及已开放业务操作。
- 调用前明确
- 当前连接的业务环境、可访问项目和本次对象。
LingMind Operator
平台管理员与获授权交付运维人员
- 工作范围
- 环境服务观察、故障证据及受控维护、部署和备份恢复。
- 调用前明确
- 独立运维身份及每次调用的目标环境。
业务连接对应具体 Phoenix 环境，用于项目记录、统计、时空上下文、媒体、任务及已开放的业务操作。多个业务环境可以分别连接，使用前确认连接返回的环境身份与可访问项目。
Operator 连接对应全局 Apex 运维入口，在每次调用中明确目标环境，用于环境与服务观察及受控维护。业务项目权限与运维环境权限分别核对，不能互相替代。
First connection
从一个已知对象，
验证首次连接
不同宿主的插件安装、连接器注册、授权保存和交互方式不同。当前分发实现提供 Codex/ChatGPT App 更新包，以及 DSH、WorkBuddy、豆包的接入适配；各宿主的真实安装、登录、刷新、撤销与升级仍需分别验收，不能统一写成均已验证可用。豆包适配当前仍需宿主界面注册 HTTP 连接器，安装本地技能不等于连接完成。
- 01
选择入口
业务操作选 LingMind，环境运维选 LingMind Operator；先确认所用宿主提供相应安装与连接方式。
核对材料插件与宿主身份、业务或运维用途。
- 02
核对环境
业务连接绑定一个环境；运维连接在调用时明确目标环境。
核对材料返回的环境身份、可访问项目或运维目标。
- 03
独立授权
在受信任的授权页面完成登录与同意授权，凭证由宿主或对应运行时安全保存。
核对材料实际授予的身份与范围，不在正文、提示词或插件包保存密码和令牌。
- 04
先做只读验证
查询一个已知对象，核对项目、字段和来源；再分别验证写入、长任务和需确认操作。
核对材料实际请求与结果、错误范围和后续核查方式。
Conditions
能力范围与使用条件
能力与业务范围
- 围绕业务问题查找记录、维护资料、跟踪长任务并准备需确认操作，让接手人员沿对象与实际结果继续核对；业务与运维分别授权。
- 通过 Phoenix 和 Annex 查询客户端及事件接收组件连接外部系统，明确数据范围、条件验签、事件契约和交付核对方法。
应用前提与结果判读
智能助手接入与受控操作
计划与长任务
计划绑定动作、对象、参数和身份，并具有有效期及一次性确认机制。执行时应使用原计划，不能把确认当作更换目标或扩大范围的授权。
异步作业保留任务身份，用于查询进度、失败原因、取消情况和产物。提交成功、界面出现进度或连接显示已授权，分别只说明对应阶段，不能替代业务完成证明。
可提供的价值与限制
助手可连接分散的记录，按业务问题查找证据，协助准备与执行明确操作，减少手工切换入口。结果仍受数据完整性、权限、环境连接和实际设备能力限制。
插件安装、OAuth 授权、工具可见和真实调用成功需要分别验证。某个宿主或分发渠道有配置文件，不代表已经在所有桌面、云端或移动宿主完成接入验收。
开放接口与第三方系统集成
认证与项目范围
客户端以目标环境的 Phoenix 根地址配置连接，使用该环境认可的身份取得访问凭证，并按有效期刷新。项目上下文使用项目 documentId；访问范围最终由服务端授权决定。
Annex 当前客户端调用真实的认证及代理路径，不能把不存在的独立 Annex API 前缀作为地址。SDK 中提供的凭证字段也不能替代目标环境对该认证方式的实际支持检查。
凭证由集成服务安全保管，文档与业务正文不存密码或令牌。环境切换后应重新核对身份、项目和权限，避免将一个环境的数据或凭证误用于另一个环境。
集成交付应验证
交付前固定需求版本、接口契约和目标环境，将查询、主动推送、业务回写及设备控制分别列入范围。外部平台本地修改一条记录，与向 LingMind 回写业务结果是两件需要分别约定和验收的事。
需求中的性能指标、数据分级建议和表结构设计应分别保留依据；不能以文档存在、模板勾选或本地组件测试替代项目验收。长时间任务还需要核对最终状态及产物。设备控制与破坏性操作遵守各自操作流程及确认要求。
- 身份与范围：有效凭证、续期、项目映射、最小权限、跨项目访问拒绝。
- 数据查询：真实对象、分页筛选、详情标识、字段含义、空结果和错误响应。
- 事件链路：实际来源事件、接收端配置密钥后的验签、事件字段、响应约定、存储和业务处理结果。
- 一致性：重复、乱序、失败重试、补偿重报，以及中断后重新对账的方法。
- 媒体与数据范围：文件访问授权、地址有效期、敏感字段裁剪和撤销后的表现。
- 非功能指标：约定数据量、并发、网络和测试窗口，再记录响应时间、恢复结果及适用版本。