@cowwo/dsh-lookout 0.1.1 → 0.2.0

package/README.md

@@ -20,7 +20,9 @@
 
 ### 3. 显示当前会话 ID
 
-在会话头部右侧显示当前会话的完整 ID；复制时会净化剪贴板内容，避免选区夹带多余换行。
+会话 ID 现在显示在**侧栏会话行的悬停卡片**里：鼠标停在侧栏某个会话上，弹出的卡片（标题 / 时间 / 空闲等状态）会多一行等宽字，就是这个会话的完整 ID（`session-…`），**点一下就复制**，成功后底部有提示。
+
+这一行挂的是宿主官方插槽 `sidebar.session.row.hover`，不是贴着界面画上去的，所以宿主升级移动卡片时它会跟着走。开启时顶部原先那串会话 ID 会隐藏（由插件自己的一条 CSS 规则隐藏，不改宿主代码），让 ID 只出现一处；到设置页「会话 ID」分区取消勾选，顶部恢复显示、卡片里那行也不再出现——即完全回到未装本插件时的样子。
 
 ### 4. 文件行 ⋯ 菜单
 
@@ -32,6 +34,12 @@
 
 设置页里有「文件行 ⋯ 菜单」开关，可以整体关掉。这个菜单是贴着宿主文件树画上去的：DSH 升级换了文件面板结构时，它可能不再出现，但**文件树本身不受影响**；连续 3 次注入失败会自动停止，并且只提示一次（可点「不再提示」）。
 
+### 5. 工作区标签 / 隐藏 / 置顶
+
+在设置页「工作区管理」的表格里，可以给每个工作区挂一个**标签**：灰色胶囊（灰底填充 + 彩色圆点 + 灰白文字），最多 6 个字，显示在侧栏工作区行右侧（悬停出现「⋯」时在它左边）；颜色 8 选 1（红 / 橙 / 黄 / 绿 / 青 / 蓝 / 紫 / 灰），颜色只作用于圆点。还可以**隐藏**整个工作区（连同它下面的会话），当前会话所在的工作区永远不会被隐藏，表格里取消勾选即可恢复。**置顶**的工作区排在侧栏最前；新建工作区默认插到最前，插件会自动把置顶项重新排上去，取消置顶则回到置顶前的位置——只支持根工作区，子工作区的「置顶」是灰的。表格下方的「清理失效项」用来清掉已不存在的工作区留下的偏好。
+
+标签和隐藏是贴着侧栏画上去的（工作区行没有官方插槽）：DSH 升级换了结构时可能不再显示，但**侧栏本身不受影响**；连续 3 次注入失败会自动停止，并且只提示一次。置顶走 DSH 官方开放接口（`insertBefore`），不改宿主代码。
+
 ## 怎么用
 
 打开 DSH 设置页（Web GUI 的设置 / Settings），找到 **瞭望哨（Lookout）** 这一项，里面有：
@@ -41,12 +49,14 @@
 - 邮件通知：SMTP 主机、端口、账号、密码、收件人，以及「发一封测试邮件」按钮
 - 会话 ID 显示开关
 - 文件行 ⋯ 菜单开关
+- 工作区管理（标签 / 颜色 / 置顶 / 隐藏，以及「清理失效项」）
 
 ## 数据存在哪
 
 | 内容 | 位置 |
 | --- | --- |
 | 图标、未读规则 | `$DSH_HOME/custom-favicon/` |
+| 工作区偏好 | `$DSH_HOME/custom-favicon/workspace-prefs.json` |
 | 邮件账本（投递记录） | `$DSH_HOME/dsh-notify-p/state.json` |
 | 邮件配置 | `$DSH_HOME/settings.yaml` 的 `dsh-notify-p` 段 |