dsh-notify 0.1.2 → 0.1.4

package/README.md

@@ -1,8 +1,26 @@
 # dsh-notify
 
-> ⚠️ **AI 生成项目**：代码与文档由 AI 辅助生成，仅供学习参考，使用前请自行审查。
+![npm version](https://img.shields.io/npm/v/dsh-notify)
+![License](https://img.shields.io/github/license/Pasumao/dsh-plugin-notify)
+![AI Assisted](https://img.shields.io/badge/AI-Assisted-8A2BE2)
 
-dsh 的 Windows 通知插件：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）弹原生 Toast 提醒，正文标注「工作区 · 会话」，托盘常驻鲸鱼图标。
+**唯一带系统托盘的 Windows 原生通知插件**：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）自动弹原生 Toast，正文标注「工作区 · 会话」，任务栏托盘常驻鲸鱼图标——跑长任务时切走窗口，瞄一眼托盘就知道跑完了没。
+
+零运行时依赖、零构建，`dsh plugin add` 一条命令装完即用。
+
+## 功能
+
+- **Windows 原生 Toast 通知**：agent 不再运行时（完成 / 停止 / 出错 / 达到输出上限 / 等你选择 / 会话关闭）自动弹系统通知，正文标注「工作区 · 会话」，一眼知道哪个会话跑完了；
+- **系统托盘常驻图标**：任务栏托盘鲸鱼图标常驻，右键菜单可唤起 dsh web 页面 / 退出后台（竞品均明确不做托盘，本插件是 dsh 生态唯一）；
+- **防刷屏**：`rootsOnly` 默认仅根会话通知，子代理不刷屏；`cooldownMs` 同会话同类型两次通知最小间隔；
+- **零运行时依赖、零构建**，`dsh plugin add` 一条命令装完即用。
+
+## 使用场景
+
+- **跑长任务时切走窗口**：LLM 长生成 / 批处理跑着，切到别的应用，任务结束托盘弹通知，瞄一眼就知道结果；
+- **挂机批量任务**：一晚上跑多轮任务，全部结束后收到 Toast，不用守着页面；
+- **会话多开**：同时跑多个工作区会话，通知正文带「工作区 · 会话」标注，不会搞混；
+- **子代理观察**：希望只关注根会话结果时保持 `rootsOnly: true` 默认值，需要观察子代理时再关掉。
 
 ## 安装
 
@@ -12,6 +30,15 @@ dsh plugin --profile web add dsh-notify
 
 GitHub 安装：`dsh plugin --profile web add github:Pasumao/dsh-plugin-notify`
 
+源码安装（本地开发 / 调试）：
+
+```bash
+git clone https://github.com/Pasumao/dsh-plugin-notify.git
+cd dsh-plugin-notify
+npm install
+# 以 link: 方式挂载进 profile（包名 dsh-notify）
+```
+
 装完重启 `dsh web`，任务栏出现鲸鱼图标即生效。
 
 ## 触发时机
@@ -35,6 +62,37 @@ GitHub 安装：`dsh plugin --profile web add github:Pasumao/dsh-plugin-notify`
 node scripts/test-harness.mjs   # 弹三条真实 Toast 自测
 ```
 
+## 常见问题
+
+- **收不到通知？** 检查 Windows「设置 → 系统 → 通知」是否允许 PowerShell 显示通知，
+  以及是否处于专注助手 / 勿扰时段；
+- **只想根会话通知？** 保持默认 `rootsOnly: true`；需要观察子代理时再改为 `false`；
+- **通知太频繁？** 调大 `cooldownMs`（默认 10000ms）即可；
+- **托盘图标不见了？** 重启 dsh web；仍无则检查 `tray: true` 配置项是否被覆盖。
+
 ## 排障
 
 Toast 不出现：检查 Windows「通知与操作」是否允许 PowerShell 显示通知。
+
+## 相关插件
+
+本插件属于 **Pasumao 的 dsh 插件生态**，同系列已发布插件可搭配使用：
+
+| 插件（npm） | GitHub | 说明 |
+|---|---|---|
+| [dsh-plugin-choice-refresh](https://www.npmjs.com/package/dsh-plugin-choice-refresh) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-choice-refresh) | 选择增强：重新生成选项 / 更多选项 |
+| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-dev-kb) | 插件开发知识库（官方文档完整镜像 + 技能） |
+| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-image-tools) | 图片选择卡 + 回复内嵌图片 + 盲模型收图 |
+| [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-table-zoom) | 聊天长表格浮窗查看 + 一键复制 Markdown |
+| [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code 风格文件浏览器 + 可编辑预览 |
+
+> 本系列其余插件见 [Pasumao · dsh 插件](https://github.com/Pasumao)；觉得好用欢迎到 GitHub 点 ⭐。
+
+## AI 生成声明
+
+代码与文档由 AI 辅助生成（DeepSeek Harness），均经人工审查与实机验证
+（`scripts/test-harness.mjs` 弹真实 Toast 自测）。
+
+## License
+
+[MIT](./LICENSE)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-notify",
   "description": "DeepSeek Harness (dsh) Windows notification plugin: a native toast when the agent stops running (finished / aborted / error / waiting for your choice / session closed), plus a system-tray icon. Pure host-side, zero dependencies, zero build.",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -14,7 +14,8 @@
     "scripts",
     "cordis.patch.yml",
     "README.md",
-    "设计文稿.md"
+    "设计文稿.md",
+    "LICENSE"
   ],
   "scripts": {
     "smoke": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/smoke-notice.ps1",

package/scripts/selfcheck.mjs

@@ -0,0 +1,30 @@
+// 最小自检：发布前验证结构完整（离线、零依赖）。node scripts/selfcheck.mjs
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const failures = [];
+
+const pkgPath = join(root, "package.json");
+if (!existsSync(pkgPath)) failures.push("缺 package.json");
+else {
+  let pkg;
+  try { pkg = JSON.parse(readFileSync(pkgPath, "utf8")); }
+  catch { failures.push("package.json 解析失败"); pkg = {}; }
+  if (pkg.name && pkg.main && !existsSync(join(root, pkg.main)))
+    failures.push(`入口不存在: ${pkg.main}`);
+  if (pkg.dsh?.bundle?.patch && !existsSync(join(root, pkg.dsh.bundle.patch)))
+    failures.push(`bundle patch 不存在: ${pkg.dsh.bundle.patch}`);
+}
+
+for (const f of ["README.md", "LICENSE"]) {
+  if (!existsSync(join(root, f))) failures.push(`缺 ${f}`);
+}
+
+if (failures.length) {
+  for (const f of failures) console.error(`[FAIL] ${f}`);
+  console.error(`${failures.length} 项失败`);
+  process.exit(1);
+}
+console.log("[PASS] 结构完整，可发布");

package/scripts/test-harness.mjs

@@ -24,7 +24,7 @@ const ctx = {
     list: () => [
       {
         id: 'ws-1',
-        path: 'C:\\Users\\18303\\Desktop\\dsh-plugin-notify',
+        path: 'D:\\dsh\\plugins\\dsh-plugin-notify',
         title: 'dsh-plugin-notify',
         sessionIds: ['test-session'],
       },
@@ -55,7 +55,7 @@ const emit = (name, ...args) => {
 
 const session = {
   id: 'test-session',
-  header: { cwd: 'C:\\Users\\18303\\Desktop\\dsh-plugin-notify' }, // 无 delegationDepth = 根会话
+  header: { cwd: 'D:\\dsh\\plugins\\dsh-plugin-notify' }, // 无 delegationDepth = 根会话
   // 会话日志（与真实 dsh Session.events 同形）：含 session/title 事件。
   events: [{ type: 'session/title', data: { title: '画一只赛博朋克猫' } }],
 }

package//350/256/276/350/256/241/346/226/207/347/250/277.md

@@ -25,7 +25,7 @@
 ## 3. 架构
 
 ```
-C:\Users\18303\Desktop\dsh-plugin-notify\
+D:\dsh\plugins\dsh-plugin-notify\
 ├── package.json            # dsh-notify；main: lib/index.js；dsh.bundle.patch: ./cordis.patch.yml
 ├── cordis.patch.yml        # bundle 补丁：- insert 注册 dsh-plugin-notify 行
 ├── lib/index.js            # host 半区：事件订阅 + 状态机 + Toast 派发 + 托盘图标
@@ -94,8 +94,8 @@ patch 条目 `config`（全部有默认值，见 `README.md` 表格）。核心
 
 1. **npm**（推荐）：`dsh plugin --profile web add dsh-notify`。
 2. **GitHub**：`dsh plugin --profile web add github:Pasumao/dsh-plugin-notify`（零构建，一般无需 allowBuilds）。
-3. **本地路径**：`dsh plugin --profile web add C:/Users/18303/Desktop/dsh-plugin-notify`。
-4. **手动 link**（旧版流程）：dependencies 加 `"dsh-notify": "link:C:/Users/18303/Desktop/dsh-plugin-notify"` 后 `pnpm install`。
+3. **本地路径**：`dsh plugin --profile web add D:/dsh/plugins/dsh-plugin-notify`。
+4. **手动 link**（旧版流程）：dependencies 加 `"dsh-notify": "link:D:/dsh/plugins/dsh-plugin-notify"` 后 `pnpm install`。
 
 装完重启 `dsh web`（托盘图标出现即加载成功）。调整行为时在用户层 `cordis.patch.yml` 按 id 覆盖 config。