前言¶
DeepSeek Harness (DSH) 在运行智能体任务时，常需要在后台会话或浏览器标签页中等待权限审批。当审批请求堆积时，开发者需要频繁切换上下文窗口来处理这些弹窗。wxjgit/permission-popup 插件将当前会话和后台会话的待审批请求聚合在页面角落的卡片堆栈中，让你无需跳转页面即可快速处理审批。
插件介绍¶
这是一个社区维护的插件，当前版本为 MIT 许可证。插件通过 DeepSeek Harness 的 Web UI 插件机制，拦截并展示待处理的权限请求。
核心定位：在页面角落显示审批卡片，提供“允许一次”或“拒绝”的快捷操作。
已核实事实：
* 作者：wxjgit
* 分类：客户端
* 许可证：MIT
核心功能¶
插件具备以下功能：
- 多会话聚合：在页面角落显示当前和后台会话的待审批卡片堆栈。
- 信息展示：当可用时，显示会话标题、工具名称、审批理由以及 Shell 命令。
- 快捷操作：通过现有的 DSH 审批通道，对卡片进行“允许一次”或“拒绝”操作。
- 触发策略：支持
background（后台）、always（总是）和hidden-only（仅隐藏时）三种触发策略。 - 本地持久化：自动保存角位置、堆栈大小、可见性、通知设置和标题提醒偏好。
- 后台通知：当浏览器标签页隐藏时，可发送桌面通知。
- 纯净无干扰：插件不向页面添加提示文本、模型请求、Token 使用量或 KV 缓存内容。
安装与启用¶
通过 DSH 的命令行工具安装到 Web 配置文件中。
dsh plugin --profile web add github:wxjgit/permission-popup
安装后需要重启 Web UI 以加载插件层：
dsh web
使用方式¶
插件在 Web 配置文件下自动激活。当满足配置的触发策略时，卡片会出现在指定角落。
- Allow once：仅批准当前显示的请求。
- Reject：拒绝当前显示的请求。
- 打开会话：点击卡片上的琥珀色条带，可跳转到发起请求的会话窗口。
- 配置管理：点击卡片堆栈上的齿轮按钮，可配置触发策略、卡片位置、最大堆栈数量、桌面通知开关以及标签页标题提醒。
浏览器标签页隐藏场景¶
当浏览器标签页最小化或隐藏时，页面角落的卡片可能无法直接被看到。此时需要启用插件设置中的“Desktop notify while hidden”（隐藏时发送桌面通知）并授予网站通知权限。收到系统通知后，点击通知可聚焦浏览器并打开相关会话。
适用场景与注意¶
- 环境要求：DeepSeek Harness 目前处于预发布阶段，插件 API 和兼容性要求在首次打标签前可能发生变化。建议在兼容
0.1.1-rc.2客户端包的 DSH 环境中使用。 - 权限安全：插件不绕过 DSH 的权限检查，决策通过现有的
PendingWait响应通道执行。卡片仅在宿主广播approval/resolved后消失。 - 通知内容：桌面通知仅包含会话标题和审批理由或工具名称，出于隐私考虑，不会包含完整的命令参数。
- 数据存储：用户偏好存储在浏览器的
localStorage中，键名为dsh-permission-popup.prefs。 - 源码审查：由于这是社区项目，在敏感环境中使用前，请务必审查第三方插件源码，并锁定可信的 commit 版本。
结语¶
该插件通过聚合审批流程，简化了多会话环境下的交互步骤。更多细节和源码可参考项目目录页或 GitHub 仓库。
