chore: 保存工作副本——客户端授权新契约(双端点/验签/令牌/周检)与桌面会话可靠性改进

docs/ai-agent.md

@@ -9,6 +9,8 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
 
 产品目标是：用户在已连接的 SSH 终端中输入自然语言任务，Agent 通过少量、边界清晰的工具获取真实证据，按用户选择的安全模式决定确认阈值，失败后根据输出换方法，最后给出有证据的结论。无论选择哪种模式，目标主机始终可见，critical 命令始终硬拒绝。
 
+设计边界声明：OpsXShell Agent 只服务桌面端当前 SSH 会话。任务开始时锁定当前 connectionId，后续执行和取消始终作用于该连接；标签切换不得让任务迁移到另一台主机。Agent 专用 SSH 结果在 Rust 原生层脱敏后才返回界面和模型上下文。OpsXShell 不复用 OpsXCLI 的本机执行器，也不承担 AIOps 的资产授权、审批和永久审计职责。
+
 ## 参考来源
 
 本设计已逐篇评估同级 `aiops/docs/ai-agent/00-08` 及它们引用的工程基线：
@@ -43,9 +45,9 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
   -> 失败换方法 / 继续验证 / FINAL
 ```
 
-- 单次任务最多 8 步。aiops 默认 16 轮适合后端异步任务；OpsXShell 是前台桌面工具，8 步更符合注意力、时延和成本边界。
+- 单次任务最多 12 步。aiops 默认 16 轮适合后端异步任务；OpsXShell 是前台桌面工具，12 步兼顾排查+修复与注意力、时延、成本。
 - 相同命令最多出现 2 次，第 3 次在执行前停止。
-- 第 4 轮检查是否已有足够证据，第 8 轮强制优先收敛；连续失败时 Prompt 要求更换排查路径。
+- 第 6 轮检查是否已有足够证据，第 12 轮强制优先收敛；连续失败时 Prompt 要求更换排查路径。
 - 单步输出进入 Agent 前有 12,000 字符上限，任务观察上下文有 48,000 字符上限。
 - `analyze_output` 是本地确定性工具：统计行数、提取错误关键行、保留首尾，不为压缩输出额外调用模型。
 
@@ -74,7 +76,7 @@ OpsXShell 适合吸收 aiops Agent CLI 的执行 Harness，不适合照搬它的
 | OpenAI / Anthropic LLM 适配 | 已吸收         | 保留 OpenAI Chat、Responses、Anthropic Compatible 及自定义 Provider           |
 | `ssh_execute`               | 已吸收         | 固定使用当前活跃 `connectionId`，不重新管理一套凭据                           |
 | `analyze_output`            | 已适配         | 本地确定性摘要，降低 token 和幻觉                                             |
-| ReAct 16 轮                 | 适配为 8 步    | GUI 前台执行，优先快速收敛                                                    |
+| ReAct 16 轮                 | 适配为 12 步   | GUI 前台执行；12 步够排查+验证，仍低于后台异步 16 轮                          |
 | 失败反馈和循环检测          | 已吸收         | 退出码和真实输出回传，连续失败换路，相同命令限次                              |
 | 五级风险                    | 已吸收         | critical 硬拒绝，其他等级按安全模式阈值确认                                   |
 | 两级安全模式                | 已适配         | 严格从 medium、宽松从 high 确认；critical 前后端均硬拒绝                      |
@@ -131,7 +133,7 @@ src-tauri/src/services/ai/
 
 ### P1：运维效率
 
-1. 任务中断和“停止”，不等待全部 8 步。
+1. 任务中断和“停止”，不等待全部 12 步。
 2. 只读组合命令的参数级评估，减少误判。
 3. 用户显式保存的 Runbook 模板，支持变量预览和逐步确认。
 4. 把已选终端文本、主机标签和系统信息组成最小上下文包，并显示实际发送范围。