dsh-better-tag
Manifest validGive DeepSeek Harness sessions flat tags and a persistent done stamp · DSH session tags and done stamp
dsh-better-tag
给 DeepSeek Harness 的会话贴扁平标签,并落一枚持久的「完成」章。
DSH 原生的状态点回答的是「AI 交回了没有」:待你、交回未读、进行中、空闲。它不回答这件事做完了没有——因为只有你知道。
dsh-better-tag 补上这一层:标签说明这件事属于什么,「完成」章说明它已经收尾。两者都跟着会话走,重启后还在,发新消息时完成章自动解除。
一眼看懂
| 位置 | 你会看到 |
|---|---|
| 侧栏行尾 | 最多 2 枚标签 + +N,排在时间之前;只读,不抢原生按钮 |
| 行悬停 | 原生 hover 卡片里显示该会话的全部标签与完成章 |
行悬停 / … 菜单 | ✓ 落章、取消章;「标签…」打开选择器(触屏兜底) |
| 会话标题旁 | 最多 3 枚标签 + +N;点芯片或「+ 标签」直接增删 |
| 侧栏「会话总览」 | 跨全部 workspace 平铺:状态计数、标签筛选、归档开关、点行进入会话 |
| 标签选择器 | 勾选/取消、新建标签、管理标签、临时标签(不入标签库,随会话持久化) |
| 管理标签 | 改名、改色、删除(级联移除所有引用) |
| 标签包 | 导出 JSON 分享;导入按名字合并,冲突保留本地并报告 |
不做:AI 打标、存量批量回填、维度/单选规则、自动归档、多窗口实时推送。
截图
标「实机」的图来自真实 DSH 窗口;其余为示例数据渲染,使用与插件相同的样式和组件结构,方便一次看全功能。
侧栏与标题旁(实机)
侧栏行尾:标签排在时间之前,最多 2 枚,多出来的收成 +N。
标题旁:打开会话后,标签在标题右侧;点芯片或「+ 标签」即可增删。
悬停、完成章与行菜单(示例数据)
行悬停时显示全部标签(含临时标签)与完成章;行尾 ✓ 落章/取消,「…」菜单里还有「标签…」「取消完成章」「清除临时标签」。
会话总览(示例数据)
跨全部 workspace 平铺:状态计数(待你 / AI 已交回 / 进行中 / 已完成 / 共)、按标签筛选、显示归档开关,点行直接进入会话;右上角是导出标签包、导入标签包和管理标签。
标签选择器与临时标签(示例数据)
勾选/取消库里的标签、直接新建标签;临时标签只挂当前会话,可「固定」进标签库或移除;底部入口进入管理标签。
管理标签(示例数据)
改名、12 色改色、删除;删除会级联移除所有会话上的引用。
标签包(示例数据)
粘贴 JSON 或选择文件导入;导入按名字合并,并报告新增 / 跳过 / 冲突。导出是总览右上角的「导出标签包」,直接下载 JSON。
安装
DSH Desktop:打开 Settings → Plugins,搜索 dsh-better-tag 安装,然后刷新页面。
dsh web / 其他 profile:
dsh plugin --profile web add dsh-better-tag
# 装完重启 dsh web
直接从 GitHub 安装(还没发版时):
dsh plugin --profile web add github:Diomchen/dsh-better-tag
把 web 换成你实际的 profile 名。安装后不需要构建:包内是纯 ESM,零运行时依赖。
用法
- 贴标签:悬停会话行,点「…」→「标签…」;或打开会话,点标题旁的「+ 标签」。
- 落完成章:悬停会话行点 ✓,或「…」菜单里选「落完成章」。它会一直留着,直到你发下一条消息或手动取消。
- 找回来:点侧栏的「会话总览」,按「待你 / AI 已交回 / 进行中 / 已完成」计数看全局;点标签筛选,勾「显示归档」把归档会话也拉出来。
- 分享一套标签:总览 →「导出标签包」;别人「导入标签包」后按名字合并,同名不同色会保留本地颜色并报告冲突。
- 随手记:选择器里可以打临时标签——不入标签库、跟着这条会话存;常用的话点「固定」收进标签库。
它怎么工作
- Host 半边把标签与会话记录写成
~/.dsh/storages/better-tag/state.json(尊重DSH_HOME),原子写、串行化,不写会话日志、不注册模型工具。 - Client 半边通过同源回环接口
/dsh-better-tag/v1/*读写;写入走乐观状态替换,窗口重新可见时重拉。 - 完成章监听
api-session/activity:会话出现新用户消息时自动解除。 - fork:子会话继承父会话的标签(含临时标签),不继承完成章。优先包
sessionController.fork,并以session/created事件兜底。
数据与隐私
- 数据只在本机:
~/.dsh/storages/better-tag/state.json(或$DSH_HOME/storages/better-tag/state.json)。 - 回环接口只接受本机请求;所有写请求必须带自定义请求头
x-better-tag: 1,跨站页面无法在不触发预检的情况下伪造。 - 不发网络请求、不调用模型、不读会话正文,也不改会话日志。
- 删掉插件不会自动删数据;要清空就删上面那个目录。
兼容性
- DSH Web / Desktop 0.2.x;在 0.2.2-rc.3(desktop profile)上开发和验证。
- Node.js >= 22;零运行时依赖、无构建步骤。
- 支持中英文界面(跟随 DSH 语言设置)。
开发
npm test # 17 个宿主测试(store / HTTP / activation)
npm run check # node --check 全部源文件
npm pack --dry-run # 看会发出去的包内容
发布走 tag:v* tag 会触发 GitHub Actions —— 跑测试、建 GitHub Release(附 tarball)、npm publish。流程和 Trusted Publishing 迁移见 docs/RELEASING.md。
已知边界
- 侧栏行尾是原生的「悬停即隐藏」装饰位:鼠标停在行上时,标签会让位给操作按钮,这是原生行为。
- 标题旁插槽在窄窗口会被裁切,3 +
+N的上限可能需要按你的窗口宽度微调。 - 多窗口不做实时同步,靠窗口重新聚焦时重拉。
- 数据只在本机,不含跨设备 / 多人同步。
English
dsh-better-tag puts flat tags on DeepSeek Harness sessions and adds a persistent done stamp that only you can set.
- Tags in the sidebar row (before the timestamp), in the native hover card, and beside the session title.
- A done stamp that survives restarts and clears itself when you send the next message.
- A cross-workspace session overview with status counts (needs you / handed back / running / done), tag filters and an archive toggle.
- Temporary per-session tags, named tag packs (JSON export/import), and tag management with cascade delete.
Install with dsh plugin --profile web add dsh-better-tag (or from Settings → Plugins in DSH Desktop), then restart dsh web. Data stays on this machine in ~/.dsh/storages/better-tag/state.json; the plugin makes no network requests and never writes session logs. Tested on DSH 0.2.2-rc.3, Node.js >= 22, MIT licensed.
License
MIT © 2026 Diomchen
Comments
Loading…