前言¶
在 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(例如 🚧 或 ✅)筛选同类会话。
两条自动分类通路¶
-
基于 Jev 决策模型(TypeSafe Jev)
轻量决策模型承担阶段研判,无需向主模型注入长提示词。回合中结合用户新指令与上一轮产出快速判断意图变化;回合末依据 Agent 最终产出更新分类(例如待验收👀或已完成✅)。仅向决策模型提供当前指令与产出摘要;未配置 API Key 时静默跳过,不阻塞会话。 -
基于 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 多会话场景下做轻量状态可视化。