@xsj/dsh-favourite
DSH 收藏插件：为工作区管理侧栏（sidebar.workspaces）增加会话/工作区收藏、收藏筛选、置顶展示与 fork 收藏继承，另提供可配置的收藏星标颜色。
> A DeepSeek Harness plugin that adds favorites (star) for sessions and workspaces, a favorites-only filter, a "hide unfavorites" display mode, top-pinning with hover metadata, star-color settings, and fork-time favorite inheritance.
界面预览
| 全部显示 | 只看收藏 | 隐藏未收藏 |
|---|---|---|
| 视图选项 · 星标颜色 | 置顶行悬浮元信息 |
|---|---|
功能
- 收藏：工作区行与会话行悬停出现星标按钮（收藏后常亮）；行菜单里也有 收藏/取消收藏。收藏工作区不会自动收藏其内部会话。
- 只看收藏（筛选收藏结果）：一级只显示 收藏的会话（散行，不带工作区归属）+ 收藏的工作区；收藏的工作区可展开，展开显示其下全部会话；未收藏的工作区与未收藏的会话不出现。散行排序跟随视图选项的 排序方式（最近更新=按活跃度，手动=跟随单列表手动顺序）。
- 置顶：对收藏的会话/工作区执行 置顶（行菜单），置顶项显示在工作区管理最上方。置顶会话以单行形式直接展示，不显示工作区名；鼠标悬浮展示工作区名、路径、会话标题、时间与状态等元信息。置顶为额外快捷行，会话本身仍保留在其工作区内，不改拓扑。
- fork 继承：会话 fork 时（
session/created，普通 fork 而非子代理），子会话默认继承原会话当时的收藏与置顶状态。 - 隐藏未收藏：官方结构上只做减法 —— 不显示"未收藏工作区的未收藏会话"：收藏的工作区展开显示其全部会话；未收藏但含收藏会话的工作区显示且会话嵌在其中；收藏会话数为 0 的未收藏工作区隐藏。
- 全部显示：官方原样列表（显式回落入口，取消任一筛选也可回落）。
- 在文件资源管理器中打开工作区：置顶行与散行的菜单项 —— 打开会话所属工作区目录的资源管理器窗口并聚焦（Windows 经 Shell.Application COM + AppActivate，规避分离式启动不抢前台的问题）。
- 散行拖动排序：只看收藏的散行支持长按拖动，与官方单列表共用同一份手动顺序。
- 星标颜色：视图选项菜单可选 金黄/橙/红/蓝/紫/跟随主题，持久化保存。
两个筛选/隐藏模式激活期间跳过 5 行折叠限制（普通浏览时超过 5 个会话折叠为"展开其余 N 个"，筛选模式下匹配项永不折叠隐藏）。收藏文档 2 秒轮询 + 窗口聚焦即时刷新，多窗口/宿主侧 fork 继承最迟 2 秒可见。
置顶行菜单同时提供 重命名 / 分叉会话 / 归档会话，行为与组内会话行一致。
安装
# 从 GitHub 安装
dsh plugin --profile web add github:XSJUSTC/dsh-favourite
# 或从本地目录
dsh plugin --profile web add <本插件目录或 file:/link: 路径>
# 重启 DSH，刷新页面
安装后插件以 priority: -1 影子接管 sidebar.workspaces 槽位（官方浏览器保持注册，卸载本插件即回落）。
数据与接口
- 持久化：
/storages/dsh-favourite.json（原子写） - 路由：
GET /api/dsh-favourite、POST /api/dsh-favourite/toggle、POST /api/dsh-favourite/pin（64KB body 上限） - 宿主服务：
ctx.dshFavourite（snapshot / toggle / setPinned / isFavorited） - fork 继承：监听
session/created，header.parentSession且isSeeded且非subagent时继承
结构
lib/index.js 宿主半：路由、存储、fork 继承
lib/client.js 客户端半：影子注册的收藏版 WorkspaceBrowser
cordis.patch.yml 挂载行
License
MIT
