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