上下文与定位¶
定位解决“这次操作作用于谁、在哪里、哪一版”。资源名称用于检索,资源引用用于执行;不能用列表中的第一项替代消歧。
范围化引用¶
结果的 context 至少包含服务端验证的 scope_id,可包含 resource_id 和 revision。多个对象由业务 data 表达,不把多个资源标识拼成一个字符串。
AXI-CTX-001:调用者必须从用户明确提供的引用、当前获权读取或同一任务的可信返回值中定位对象;多重匹配不得自动选择首项。必要上下文缺失时必须报告缺项,不得退回默认账号或工作区。
AXI-CTX-002:服务端必须验证身份与请求范围、对象归属和修订的关系;客户端必须在身份或范围切换时清除旧的敏感内容、临时编辑和不适用的控件引用,并拒绝迟到响应覆盖新范围。
同名对象¶
查询“采购合同”返回两条时,应提供可区分的业务信息,例如所属部门、创建日期与当前状态。若这些信息仍不能确定意图,应请求用户决定。标识可以复制,但不能把截短的哈希当作业务名称。
对象已唯一且合同明确时,不必额外让用户重复确认它的存在。写入时仍要核对当前修订与授权范围。
深链与浏览器引用¶
深链只负责导航;打开后仍要验证当前对象和权限。缺少必需路径参数时不生成指向默认对象的链接。短期控件引用应绑定页面/对话框及当前渲染版本,页面切换后重新定位。
flowchart TD
R[读取范围化对象] --> M{唯一且归属一致?}
M -->|否| D[返回缺项或候选]
M -->|是| V[读取修订及前置]
V --> C{有冲突或需要决定的差异?}
C -->|是| U[展示差异并保留原任务]
C -->|否| E[进入执行]
不能仅凭页面标题证明当前项目正确。浏览器至少应暴露对象引用、可访问区域、状态和必要修订,详见浏览器指南。