✨ feat(client): 设置挪到插件页，弹窗改标题加描述并持久化开关
This commit is contained in:
@@ -19,32 +19,47 @@ Windows / macOS / Linux 三个平台走的是同一条通知通道（渲染进
|
||||
| 状态 | 行为 |
|
||||
| --- | --- |
|
||||
| DSH 窗口**不在前台** | **系统通知**（这是插件唯一能拿到的系统通知通道，三个平台一致）。点通知：窗口回到前台并跳到该会话 |
|
||||
| DSH 窗口在前台，且**不是**你正在看的那个会话 | **应用内轻弹窗**：右上角悬浮，点「查看」跳过去，6 秒自动消失，鼠标悬停时不消失，Esc 关掉最上面一条 |
|
||||
| DSH 窗口在前台，且**不是**你正在看的那个会话 | **应用内轻弹窗**：右上角悬浮，标题是提醒类型、下面一行是会话题目与细节；点「查看」跳过去，6 秒自动消失，鼠标悬停时不消失，Esc 或者 ✕ 关掉 |
|
||||
| DSH 窗口在前台，且就是你**正在看的**那个会话 | 不打扰（你在看，不需要弹） |
|
||||
|
||||
## 设置
|
||||
|
||||
**设置 → 通用 → 会话通知**：
|
||||
**插件 → 会话通知**（插件自己的介绍页里）：
|
||||
|
||||
- 显示系统通知权限状态；
|
||||
- 未授权时点「允许通知」请求权限（浏览器要求必须由你手动点击才能弹权限框），授权后自动发一条测试通知；
|
||||
- 已授权时点「测试通知」随时验证；
|
||||
- 权限被系统层关闭时，按平台给出开启路径（Windows / macOS 的通知设置、Linux 桌面环境的通知设置）；
|
||||
- 三个开关分别控制**完成 / 授权 / 提问**三类提醒（默认全开；开关状态存在当前页面内存里，刷新回到默认——本插件不写配置文件）。
|
||||
- 三个开关分别控制**完成 / 授权 / 提问**三类提醒（默认全开），状态存在浏览器本地，重装插件不丢；
|
||||
- 最后一段显示观察器自身的健康状态（收不到会话状态时直接标红）。
|
||||
|
||||
设置放在插件自己的页面里，而不是「设置 → 通用」：它是这个插件的配置，不是 DSH 的通用偏好。
|
||||
|
||||
## 安装
|
||||
|
||||
在 DSH 的 **插件 → 添加插件** 里填本目录的绝对路径即可（`plugin_manager` 也会做同样的安装）：
|
||||
### 1. 从 Git 仓库安装（推荐）
|
||||
|
||||
在 DSH 的 **插件 → 添加插件** 的上方输入框里填：
|
||||
|
||||
```text
|
||||
https://gitea.iwake.top/dsh-plugin/session-notify.git#v1.0.3
|
||||
```
|
||||
|
||||
`#` 后面跟标签或提交，用来锁定版本；不写则取默认分支。跟随 1.x 最新版可以写 `#semver:^1.0.3`。仓库是公开的，不需要凭据，也不用改「安装源」。
|
||||
|
||||
### 2. 本地路径安装
|
||||
|
||||
把仓库克隆或下载到本机，在同一个输入框里填包目录的绝对路径，例如：
|
||||
|
||||
```text
|
||||
D:\DeepSeek Harness Plugins\dsh-session-notify
|
||||
```
|
||||
|
||||
安装后：
|
||||
### 装完之后
|
||||
|
||||
- **浏览器半**随页面加载，刷新页面即生效；
|
||||
- **宿主半**为空壳（不改任何 DSH 状态），如需重启才生效，完全退出 DSH 再打开即可；
|
||||
- 本插件没有第三方依赖，不需要 pnpm 下载，也不需要构建步骤。
|
||||
- **浏览器半**随页面加载，**刷新页面**即生效；
|
||||
- **宿主半**是空壳（不改任何 DSH 状态、不注册服务与路由），只有它变化时才需要完全退出 DSH 再打开；
|
||||
- 本插件没有第三方依赖，不需要 pnpm 下载，也没有构建步骤。
|
||||
|
||||
卸载：插件页里移除 `@dsh-plugin/session-notify`（它同时是 profile 的一个 bundle）。
|
||||
|
||||
@@ -52,7 +67,7 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
|
||||
|
||||
- **通道是跨平台统一的**：插件的提醒都通过页面（Electron 渲染进程）的 `Notification` 构造器发出，Windows 通知中心 / macOS 通知中心 / Linux 通知守护（libnotify、GNOME、KDE）都由系统把它转成原生通知；应用内轻弹窗是纯 DOM，与平台无关。
|
||||
- **宿主半拿不到系统通知**：DSH Desktop 的宿主进程是纯 Node 进程（不是 Electron 主进程），没有 Electron 的 `Notification` 可用，所以插件的所有提醒都在浏览器半产生——这也正是"三个平台一套代码"的原因。
|
||||
- **已验证**：Windows 上的安装、三个 slot 条目注册、以及 22 条投递规则（见下）的离线验证；设置行与轻弹窗的文案/交互按 DSH 自带的 toast 与 switch 组件对齐。
|
||||
- **已验证**：Windows 上的安装、三个 slot 条目注册、以及 52 项离线断言（接线 / 国际化 / 轻弹窗结构 / 开关持久化 / 全部投递规则）。
|
||||
- **未验证**：macOS 与 Linux 上的实际弹窗效果本机无法测试。结构上它们与 Windows 共用同一条通道、同一份代码，只有"权限被系统关闭时显示的开启路径"是分平台的。
|
||||
- 提醒只在 DSH 进程运行、页面打开时产生：**DSH 完全退出期间结束的会话不会再补发通知**。
|
||||
|
||||
@@ -72,12 +87,13 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
|
||||
依赖的都是稳定契约：
|
||||
|
||||
- 浏览器半只依赖 **slot 的标准 props**（`useSessions`、`useSessionStatus`）读取会话状态，这是 DSH 官方给插件读会话数据的方式；不轮询、不自己订阅会话事件、不读别的插件的 DOM；
|
||||
- 只往两个官方 slot 注册：`settings.general.item`（设置行）与 `shell.overlay`（两个条目：轻弹窗层 + 无渲染的观察器，内容永远是 `null`）；
|
||||
- 只往两个官方 slot 注册：`plugins.bundle.config`（本插件在插件页里的配置，key 就是包名）与 `shell.overlay`（两个条目：轻弹窗层 + 无渲染的观察器，内容永远是 `null`）；
|
||||
- **配置放在插件页**：`plugins.bundle.config` 的 key 取包名（`@dsh-plugin/session-notify`），插件页就会渲染这块配置；官方 `dsh-experimental-voice-input-bundle` 用的就是这个口子。行级口子是 `plugins.row.config`，key 形如 `<包名>#<行 id>`，会在该行上多出一个「配置」入口；
|
||||
- **不要**把"无渲染"条目放进 `sidebar.panellist`：该 slot 的宿主会把**每个条目的 id 当成一个左侧面板按钮**（`entriesOfSlot('sidebar.panellist')` → 面板列表，按钮文字取 `options.label ?? options.id`，条目本身作为图标内联渲染），放进去会在左侧多出一行空面板并挤坏侧边栏。本插件第一版踩过这个坑，现已改挂到通用浮层；
|
||||
- **文案必须注册字典**：`ctx.locale.register('session-notify', { zh, en })`，否则 `locale.bind(ns)` 在查不到该命名空间时会把 key 原样返回——界面上就会显示成 `settings.title` 这样的原始键（本插件第二版踩过这个坑）。注册会在 locale 修订号上打点，已经渲染出来的条目会自动换上文案，不需要刷新；
|
||||
- **文案必须注册字典**：`ctx.locale.register('session-notify', { zh, en })`，否则 `locale.bind(ns)` 在查不到该命名空间时会把 key 原样返回——界面上就会显示成 `settings.title` 这样的原始键（本插件第二版踩过这个坑）。注册会在 locale 修订号上打点，已经渲染出来的部件会自动换上文案，不需要刷新；
|
||||
- 另外自带一份本地字典兜底：即使拿不到框架的 `t`、或 locale 服务没有保存注册，也会渲染中文/英文文案而不是原始键；
|
||||
- 样式只用主题 token，不 import 任何 `@deepseek-ai/dsh-client-*` 包（规范要求，也是渲染不被上游改动打断的前提）；
|
||||
- 宿主半不声明 `inject`、不注册服务、不注册路由。
|
||||
- 宿主半不声明 `inject`、不注册服务、不注册路由；三个开关存浏览器本地，不改 DSH 的配置文件。
|
||||
|
||||
上游若改动 slot 名或 hook 名：注册会静默跳过而不是把页面弄坏，插件会退化成"不提醒"；这类情况请按上面的契约名核对。
|
||||
|
||||
@@ -85,12 +101,14 @@ D:\DeepSeek Harness Plugins\dsh-session-notify
|
||||
|
||||
`client.js` 是纯 JavaScript、浏览器端运行，可以在 Node 里用桩模块加载器评估并驱动：
|
||||
|
||||
- 模块接线：加载后返回的插件、`inject` 声明、注册集合（含"观察器绝不在 `sidebar.*` 里"这一条）；
|
||||
- 国际化：字典已注册且中英键集合一致、设置行与弹窗渲染出的每个字符串都不是原始键、拿不到框架 `t` 时本地字典兜底、locale 服务不保存注册时仍然有文案；
|
||||
- 模块接线：插件返回值、`inject` 声明、注册集合（含"配置挂在插件页""观察器绝不在 `sidebar.*` 里"这两条）；
|
||||
- 国际化：字典已注册且中英键集合一致、插件页与弹窗渲染出的每个字符串都不是原始键、拿不到框架 `t` 时本地字典兜底、locale 服务不保存注册时仍然有文案；
|
||||
- 轻弹窗结构：标题是触发类型、描述含会话名与细节；
|
||||
- 开关：切换即写入浏览器本地，重开页面能读回；
|
||||
- 渲染健壮性：各组件在空状态 / 权限被拒 / 无 Notification API 下渲染都不报错；
|
||||
- 投递规则：完成提醒一次、当前会话不打扰、后台走系统通知、授权/提问各提醒一次、运行中延后、子会话跳过、空白会话跳过、历史不补发、开关生效、弹窗自动消失等。
|
||||
|
||||
合计 44 项断言。
|
||||
合计 52 项断言。
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Reference in New Issue
Block a user