@cowwo/dsh-lookout 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 cowwo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# dsh-lookout（瞭望哨）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+一个 DSH（DeepSeek Harness）插件。它把原来三个独立插件合并成一份：
+
+- **dsh-icon-custom**：换浏览器标签页图标 / 系统应用图标角标
+- **dsh-notify-p**：会话有动静时发邮件通知
+- **dsh-session-info**：显示当前会话 ID
+
+一句话：**瞭望哨：盯着你的每个会话——谁跑完了、谁出错了、谁卡住了、谁在等你审批，用浏览器图标角标、红点/黄点和邮件通知你；顺带显示当前会话 ID。**
+
+## 功能
+
+### 1. 换图标与角标
+
+在设置页上传 SVG / PNG / ICO 作为标签页图标，立即生效并持久保存；自动适配安卓 / iOS / 平板的 PWA 图标。未读会话显示**红点**、正在进行的会话显示**黄点**，工作区数字、会话行、左上角、标签页图标都会显示；点数字可打开清单，点条目可定位到侧栏对应会话。还可以把未读数投到系统应用图标角标上（Windows 任务栏 / macOS Dock，需要授予通知权限）。
+
+### 2. 邮件通知
+
+会话**跑完 / 出错 / 卡住 / 等你审批**时发一封邮件。正文写清是哪个会话，并附一条可点击直达该会话的链接。SMTP 配置、收件人等都在设置页填写。短时间内的多次事件会按队列合并发送，避免轰炸邮箱。
+
+### 3. 显示当前会话 ID
+
+在会话头部右侧显示当前会话的完整 ID；复制时会净化剪贴板内容，避免选区夹带多余换行。
+
+### 4. 文件行 ⋯ 菜单
+
+文件面板里每个文件 / 文件夹行的右侧多出一个「⋯」按钮，点开可以：
+
+- **复制路径**：把这一行的**绝对路径**原样放进剪贴板（不是屏幕上显示的短名）。
+- **下载**：下载单个文件，上限 20 MB；超过会提示「文件超过 20MB，暂不支持下载」。
+- **文件夹**：菜单仍可打开，但「下载」是灰的，并标注「文件夹暂不支持」。
+
+设置页里有「文件行 ⋯ 菜单」开关，可以整体关掉。这个菜单是贴着宿主文件树画上去的：DSH 升级换了文件面板结构时，它可能不再出现，但**文件树本身不受影响**；连续 3 次注入失败会自动停止，并且只提示一次（可点「不再提示」）。
+
+## 怎么用
+
+打开 DSH 设置页（Web GUI 的设置 / Settings），找到 **瞭望哨（Lookout）** 这一项，里面有：
+
+- 图标上传与 PWA / 角标开关
+- 未读规则、进行中规则的阈值
+- 邮件通知：SMTP 主机、端口、账号、密码、收件人，以及「发一封测试邮件」按钮
+- 会话 ID 显示开关
+- 文件行 ⋯ 菜单开关
+
+## 数据存在哪
+
+| 内容 | 位置 |
+| --- | --- |
+| 图标、未读规则 | `$DSH_HOME/custom-favicon/` |
+| 邮件账本（投递记录） | `$DSH_HOME/dsh-notify-p/state.json` |
+| 邮件配置 | `$DSH_HOME/settings.yaml` 的 `dsh-notify-p` 段 |
+
+（`$DSH_HOME` 未设置时回退到 `~/.dsh`。）
+
+## 开发提示
+
+包内 `lib/icon/**`、`lib/notify/**`、`lib/session/**` 是三份原插件代码的**逐字节副本**，用于保证合并前后行为一致。
+
+**要改功能逻辑，请改这三个目录**；根部的 `lib/index.js` 只是把三者组装起来的胶水层。`test/fixtures/*.client.js` 同样是原插件浏览器半边的逐字节副本，只供测试做包含断言，不要改。
+
+## 测试
+
+```bash
+node --test "test/*.test.mjs"
+```