dsh-session-prefix:用标题前缀标记 DeepSeek Harness 会话状态

前言

在 DeepSeek Harness(DSH)里并行开多个会话时,侧边栏往往是一串相似标题:谁在写代码、谁在等确认、谁已经交付,很难一眼扫出来。给每个会话手工改标题可以区分,但任务阶段一变就要再改,和 Agent 的实际进度也容易脱节。

下面介绍的 dsh-session-prefix(社区目录条目 john-walks-slow/session-prefix)只做一件事:在会话标题最前面加上可配置的状态前缀(默认是 Emoji),并通过 Jev 决策模型、Agent 工具或斜杠命令保持前缀与阶段一致。插件由维护者 john-walks-slow 发布,归类为社区目录中的「趣味换装」;当前 GitHub 星标为 0。DSH 生态强调「一切皆插件」,SkillHub 等目录站与 DeepSeek / 幻方无官方从属关系,安装前请自行查看源码与许可证(本插件为 MIT)。

这是什么

dsh-session-prefix 是面向 Web 配置文件的 DSH 插件(npm 包名 dsh-session-prefix,版本 0.1.0)。它不改动会话数据结构或运行时行为,仅更新当前会话的标题字符串,把任务阶段直观显示在侧边栏标题前端。

核心功能

默认分类体系

开箱自带六类状态(Key 与默认 Emoji 如下,可在设置页增删改,也支持短文本前缀如 [DEV]):

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

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

两条自动分类通路

  1. 基于 Jev 决策模型(TypeSafe Jev)
    轻量决策模型承担阶段研判,无需向主模型注入长提示词。回合中结合用户新指令与上一轮产出快速判断意图变化;回合末依据 Agent 最终产出更新分类(例如待验收 👀 或已完成 ✅)。仅向决策模型提供当前指令与产出摘要;未配置 API Key 时静默跳过,不阻塞会话。

  2. 基于 Agent 工具 session_prefix
    向 Agent 暴露 session_prefix 模型工具,工具描述内嵌各分类定义与使用场景;Agent 可在复杂任务推进中主动打标。设置页可补充专属规则(例如「未经用户确认不得标记完成」)。

自愈与起名兼容

  • 用户在已处于静止状态(⏸️ / 👀 / ✅)的会话中继续追问时,回合开始会自动回落为进行中(🚧)。
  • 新会话初始化赋予默认分类(🚧),与后台异步 LLM 标题生成共存;标题生成完成后前缀自动衔接。

手动控制与 Web 设置

  • 用户斜杠命令 /prefix(安装说明中的用户命令;非 /state)。
  • Web:Settings → 会话前缀,可管理分类体系、Jev 自动分类(开关、API Key、模型与端点、连通性测速)、过滤与跳过规则(内置正则默认 ^\S+ ·,用于跳过已有外部标签的标题,避免前缀重复叠加)。

安装与启用

安装后无需繁琐配置即可挂载:自带 session_prefix 模型工具、/prefix 用户命令与「会话前缀」设置页。官方 README 给出的安装方式如下(须使用 --profile web):

# 线上安装
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

典型用法

斜杠命令 /prefix

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

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

Agent 与 Jev

  • 启用 Jev 并在设置页配置 API Key 与模型后,分类可在回合中/回合末自动更新。
  • 主 Agent 在合适阶段调用 session_prefix 工具维护状态;复杂流程可在设置页写补充规则约束打标时机。

适用场景与注意

适合谁: 同时维护多条 DSH 会话、希望侧边栏一眼区分「进行中 / 阻塞 / 待验收 / 已完成」等阶段的开发者;需要 Emoji 或短文本前缀、且愿意可选配置 Jev 端点的团队。

务必注意:

  • 插件以当前 dsh 进程权限运行,安装前请阅读 GitHub 仓库 源码与 MIT 许可证。
  • 自动分类依赖 Jev 时需自行提供 API Key;未配置时仅跳过 Jev 通路,不影响手动 /prefix 与 Agent 工具。
  • 唯一副作用是标题字符串变化;若标题已含外部标签,可依赖或调整跳过正则,避免双重前缀。

结尾

dsh-session-prefix 把会话阶段收束到标题最前端:默认六类 Emoji、Jev 与 session_prefix 双通路、静止态追问回落,以及 /prefix 与 Web 设置页,适合在 DSH 多会话场景下做轻量状态可视化。

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

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

小夜