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 多會話場景下做輕量狀態可視化。

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

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

小夜