dsh-session-prefix:用标题前缀标记 DSH 会话阶段

前言

在 DeepSeek Harness(DSH)里并行开多个会话时,侧边栏往往只剩一串相似标题:谁在写代码、谁在等确认、谁已经交付,很难一眼分清。手工改标题或靠记忆筛会话,成本会随会话数量线性上涨。

dsh-session-prefix 面向这类场景:在会话标题最前面挂上状态前缀(默认是 Emoji),并支持通过 Jev 决策模型或 Agent 工具自动推断阶段,减少反复点开才能判断进度的操作。

这是什么

dsh-session-prefix 是 DSH 社区插件,维护者为 john-walks-slow,在目录中归类为「工作流」。它只做一件事——更新当前会话的标题字符串,把任务阶段可视化;不改动会话数据结构,也不改变 Harness 运行时行为。

插件在 GitHub 开源(john-walks-slow/dsh-session-prefix),当前 package.json 中版本为 0.1.0,许可证为 MIT。

核心功能

下面介绍两条互补的自动分类通路,以及手动与设置侧的补充能力。资料中的机制均可单独开关或协同使用。

Jev 决策模型:免配置自动分类

引入轻量级 TypeSafe Jev 决策模型,专门做阶段分类研判,无需向主模型注入长提示词,也不占用主会话的上下文预算。

  • 回合中:用户提出新需求后,结合上一轮产出快速判断意图是否变化(例如从开发切到验收、排障或规划)。
  • 回合末:Agent 输出交付物后,依据最终成果把分类更新到对应状态(例如待验收或已完成)。

决策侧仅接收当前指令与产出摘要,不外发全量历史。未配置 API Key 时静默跳过,不阻塞会话。

Agent 工具:主动标记

向 Agent 暴露 session_prefix 工具。复杂任务推进时,模型可主动调用工具维护会话状态。工具描述内已包含各分类的定义与使用场景;也可在 Web 设置页补充专属规则(例如「未经用户确认不得标记完成」)。

状态自愈与默认行为

用户在已处于静止状态(阻塞、待验收、已完成)的会话中继续追问时,插件在回合开始时自动回落为「进行中」,以反映会话重新活跃。新会话初始化会赋予默认「进行中」分类,并与后台异步 LLM 标题生成共存,起名完成后前缀自动衔接。

默认分类体系

前缀 状态 Key 状态名称 适用阶段
🚧 wip 进行中 编码实施、方案执行(新会话默认)
⏸️ blocked 等待/阻塞 等待用户输入、审批或外部阻塞
👀 review 待验收 功能就绪,等待用户检视验证
✅ done 已完成 当前会话目标已交付
💡 plan 规划/调研 需求探讨、架构设计与技术调研
🐛 bug 排障/修复 问题定位、故障排查与缺陷修复

侧边栏搜索框可直接输入状态 Emoji(如 🚧 或 ✅)筛选同类会话。

安装与启用

DSH 采用插件化扩展;社区目录见 SkillHub 插件页,与 DeepSeek / 幻方无官方从属关系。安装前建议浏览仓库源码与 LICENSE,插件以当前 dsh 进程权限运行。

官方 README 给出的安装方式如下。

# 线上安装
dsh plugin --profile web add dsh-session-prefix

# 从 GitHub 源码安装
dsh plugin --profile web add github:john-walks-slow/dsh-session-prefix

# 本地开发直链
dsh plugin --profile web add link:/path/to/session-prefix

安装后无需额外繁琐配置即可挂载:自带 session_prefix 模型工具、/prefix 用户命令,以及 Web 端「会话前缀」设置页(Settings → 会话前缀)。

典型用法

斜杠命令 /prefix

在会话中随时查看、切换或清除前缀:

/prefix              # 查看当前会话状态及可用分类列表
/prefix review       # 切换为「👀 待验收」
/prefix done         # 切换为「✅ 已完成」
/prefix none         # 清除前缀,恢复纯净标题

Web 设置面板

在 Settings → 会话前缀 中可:

  1. 增删改状态预设(支持 Emoji 或短文本前缀,如 [DEV])。
  2. 开关 Jev 自动推断,配置 API Key、模型与端点,并做连通性测速。
  3. 配置过滤与跳过规则:内置正则默认 ^\S+ ·,用于跳过已带外部标签的标题(如 Telegram · xxx),避免前缀重复叠加。

自动分类与工具标记可并行:Jev 负责回合级推断,Agent 在需要时通过 session_prefix 显式打标;用户仍可用 /prefix 覆盖。

适用场景与注意

适合长期并行多条 Harness 会话、需要按阶段筛选或快速扫一眼侧边栏状态的开发者。若你更依赖外部渠道标题(带固定前缀标签),应检查跳过规则,避免双重前缀。

再次强调:插件仅修改标题字符串;Jev 路径需要自行配置 API Key 与端点,未配置时不影响主会话,只是不会自动推断。分类语义可在设置页自定义,与默认六类不一致时,以你的预设为准。

结尾

dsh-session-prefix 把会话阶段收拢到标题最前端,用 Jev 与 Agent 工具两条通路减轻手工维护分类的负担,并用 /prefix 与设置页保留最终控制权。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜