dsh-session-prefix

中文 | English

基于 Jev 决策模型或 Agent 工具为会话自动分类，直接在标题前显示对应 Emoji。

当会话越积越多，侧边栏一长串标题很难一眼分辨谁在写代码、谁在等确认、谁已交付。dsh-session-prefix 支持基于 Jev 决策模型或 Agent 工具自动分类，把任务状态直观呈现在标题最前端：

侧边栏前缀效果	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

安装后无需繁琐配置，插件自动挂载生效：自带 session_prefix 模型工具、/prefix 用户命令与「会话前缀」设置页。

---

自动分类机制

dsh-session-prefix 支持两条互补的自动分类通路，开箱即用，可单独开启或协同工作：

1. 基于 Jev 决策模型的免配置全自动分类

• 零 Prompt 调教，不占上下文：引入轻量级快速决策模型（TypeSafe Jev），专门承担阶段分类研判，无需向主模型注入冗长提示词，也不消耗会话主模型的上下文预算。
• 全生命周期自适应感知：
  • 回合中快速响应：用户发出新需求后，结合上一轮产出即刻研判意图变化（如从开发切换至验收、排障或规划）；
  • 回合末精准分类：Agent 输出交付物后，依据最终成果自动将分类更新至对应状态（如标记为待验收 👀 或已完成 ✅）。
• 极简且隐私安全：仅向决策模型提供当前指令与产出摘要（不外发全量历史上下文），未配置 API Key 时静默跳过，绝不阻塞会话。

2. 基于 Agent 工具的智能体主动标记

• 模型自主驱动：向 Agent 暴露 session_prefix 工具，Agent 在推进复杂任务阶段时，主动调用工具维护会话状态。
• 内置引导：工具描述已自包含各分类的定义与使用场景，Agent 天然理解何时打标；支持在设置页补充专属规则（如“未经用户确认不得标记完成”）。

3. 会话状态自愈与协同兜底

• 唤醒即回落：当用户在已处于静止状态（⏸️ 阻塞 / 👀 待验收 / ✅ 已完成）的会话中继续追问时，插件在回合开始时自动将其回落至进行中（🚧），真实反映活跃度。
• 平滑兼容起名：新会话初始化自动赋予默认分类（🚧），与后台异步 LLM 标题生成机制无缝共存，起名完成后前缀自动衔接，绝不冲突。

---

默认分类体系

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

提示：在侧边栏搜索框直接输入状态 Emoji（如 🚧 或 ✅），即可即时筛选出同类别会话。

---

灵活控制与设置

用户斜杠命令 /prefix

随时在会话中手动查看、切换或重置分类：

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

Web 设置面板（Settings → 会话前缀）

• 分类体系管理：自由增、删、改状态预设（支持 Emoji 或短文本前缀，如 [DEV]）。
• Jev 自动分类配置：切换自动推断开关，配置 API Key、模型与端点，支持一键连通性测速。
• 过滤与跳过规则：内置正则规则（默认 ^\S+ · ），自动跳过带有外部标签的标题（如 Telegram · xxx），避免前缀重复叠加。
• 纯视觉、零副作用：插件唯一操作是更新当前会话的标题字符串，不修改数据结构，不影响运行时行为。

---

开发与构建

npm run check       # 类型检查
npm run build       # 构建产物（dist/ 与 lib/client.js）
npm test            # 单元测试

致谢

• 感谢 LINUX DO 社区提供的交流与支持。