前言¶
在 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 → 会话前缀 中可:
- 增删改状态预设(支持 Emoji 或短文本前缀,如
[DEV])。 - 开关 Jev 自动推断,配置 API Key、模型与端点,并做连通性测速。
- 配置过滤与跳过规则:内置正则默认
^\S+ ·,用于跳过已带外部标签的标题(如Telegram · xxx),避免前缀重复叠加。
自动分类与工具标记可并行:Jev 负责回合级推断,Agent 在需要时通过 session_prefix 显式打标;用户仍可用 /prefix 覆盖。
适用场景与注意¶
适合长期并行多条 Harness 会话、需要按阶段筛选或快速扫一眼侧边栏状态的开发者。若你更依赖外部渠道标题(带固定前缀标签),应检查跳过规则,避免双重前缀。
再次强调:插件仅修改标题字符串;Jev 路径需要自行配置 API Key 与端点,未配置时不影响主会话,只是不会自动推断。分类语义可在设置页自定义,与默认六类不一致时,以你的预设为准。
结尾¶
dsh-session-prefix 把会话阶段收拢到标题最前端,用 Jev 与 Agent 工具两条通路减轻手工维护分类的负担,并用 /prefix 与设置页保留最终控制权。