Show feedback only on plugin failures

README.md

@@ -1,23 +1,27 @@
 # Oh My DSH Plugin Lab
 
-Plugin Lab 0.4 是面向 DeepSeek Harness rc.6 的隐私优先插件反馈闭环。普通用户只看到一个“让 Agent 帮我反馈”入口，不需要模型 API，也不需要记住命令；后端只把达到阈值的聚合信号提交到 GitHub。
+Plugin Lab 0.4 是面向 DeepSeek Harness rc.6 的隐私优先插件反馈闭环。反馈入口不再常驻：只有 Host 能把当前试用插件明确判定为 `error` 或 `unavailable` 时，输入框上方才出现“让 Agent 帮我反馈”。不需要模型 API，也不需要记住命令；后端只把达到阈值的聚合信号提交到 GitHub。
 
 ## 现在的体验
 
 1. 从插件市场开始一次试用；在当前 rc.6 开发接入中也可用 `/omdsh-start <plugin>#<version>` 关联目标。
-2. 点击输入框旁唯一的“让 Agent 帮我反馈”，面板自动显示 `ok / unavailable / error / unknown`，不调用模型读取会话。
+2. 试用开始后，客户端只查询 Host 的 `ok / unavailable / error / unknown` 有限状态。`ok` 和 `unknown` 时界面保持安静；`error` 或 `unavailable` 时，输入框上方出现一条故障反馈提示。
 3. 用户选择“好用 / 一般 / 不好用”和一个有限大类；Agent 只负责把这些有限字段整理成固定模板。
 4. 面板弹出发送前预览；此时只保存到本机，没有网络请求，也没有本地消息引用可被附带。
 5. 用户再次点击“确认发送这条反馈”后，有限枚举包才会发送；Session 历史只新增一条独立的“插件反馈”卡片。
 6. 探活、选择和预览等中间操作不进入历史；“查看进展”收在同一面板内。后端聚合到阈值后创建 GitHub Issue，并通过回执邀请复测。
 
+普通 Agent/模型调用错误、网络错误或“缺少 API Key”不会触发这个入口，因为它们不能证明插件本身故障。Plugin Lab 不搜索对话或日志来猜测归因。
+
 Agent 分析是可选能力，只能建议有限大类，不能读取或提交任务摘要。没有模型 API Key 时，上述完整主流程照常可用。
 
 ```mermaid
 flowchart LR
   A["插件试用"] --> B["Host 无日志探活"]
-  B --> C["Agent 建议有限大类"]
-  C --> D["用户选择体验和大类"]
+  B -->|"error / unavailable"| C["故障时出现反馈提示"]
+  B -->|"ok / unknown"| J["保持安静"]
+  C --> K["Agent 建议有限大类"]
+  K --> D["用户选择体验和大类"]
   D --> E["本地固定模板预览"]
   E -->|"用户再次确认"| F["发送有限枚举"]
   F --> G["后端聚合"]
@@ -32,13 +36,13 @@ Agent 可能已经拥有当前任务的正常会话上下文，但 Plugin Lab 
 ```sh
 pnpm install
 pnpm pack:release
-dsh plugin --profile web add ./oh-my-dsh-plugin-lab-0.4.4.tgz
+dsh plugin --profile web add ./oh-my-dsh-plugin-lab-0.4.5.tgz
 dsh --profile web
 ```
 
-Plugin Lab 是标准 DSH Bundle：`package.json` 通过 `dsh.bundle.patch` 声明 Host 插件，通过 `dsh.client` 提供唯一的 Web“让 Agent 帮我反馈”入口。探活、体验选择、脱敏预览、确认提交和进展都在这个入口中完成。
+Plugin Lab 是标准 DSH Bundle：`package.json` 通过 `dsh.bundle.patch` 声明 Host 插件，通过 `dsh.client` 在结构化插件故障时提供 Web“让 Agent 帮我反馈”入口。探活、体验选择、脱敏预览、确认提交和进展都在这个入口中完成。
 
-版本 `0.4.4` 的 Peer 契约从 DSH `0.1.0-rc.6` 起。完整测试会执行真实的 rc.6 打包、安装、Host/Web 启动、Client Loader 注册和卸载。
+版本 `0.4.5` 的 Peer 契约从 DSH `0.1.0-rc.6` 起。完整测试会执行真实的 rc.6 打包、安装、Host/Web 启动、Client Loader 注册和卸载。
 
 ## 兼容命令与 Agent 工具