dsh-you-should-know：DeepSeek Harness 任務運行中的提醒插件

在 DeepSeek Harness (DSH) 中開發任務時，隨着對話的推進，關鍵約束或背景信息容易被淹沒。dsh-you-should-know 是一個任務提醒插件，它會在任務運行期間觀察對話上下文，並提示你注意那些可能被遺漏的重要事實、權衡和背景知識。

核心功能¶

該插件通過一個懸浮面板提供交互，不推擠對話內容。

1. 懸浮面板：位於輸入框上方，包含最小化控制，不會改變對話內容的滾動位置。
2. 解釋按需：可以查看爲什麼一條筆記很重要，或者將已熟悉的主題標記爲“已理解”，以減少重複提醒。
3. 繼續討論：將筆記和解釋帶入選定的主會話中，便於繼續深入探討，且不會覆蓋現有的草稿或附件。
4. 配置項：
   • 語言：跟隨系統或指定中文/英文。
   • 觀察者模型：獨立選擇模型，不改變主會話模型。
   • 檢查頻率：默認每 6 個模型步長檢查一次。
   • 單輪限制：控制單輪對話顯示筆記的最大數量。
   • 主題歷史：管理“已見”和“已知”列表，避免重複提醒。
5. 自動觀察：默認啓用，觀察者會跟隨主會話的模型運行。

安裝與啓用¶

安裝前請確保環境滿足要求：
* DeepSeek Harness: >=0.2.0-rc.2 <0.3.0-0
* Node.js: >=22.19.0

從源碼構建並安裝¶

1. 克隆倉庫並構建安裝包：

    git clone https://github.com/lolipop-1x1/dsh-you-should-know.git
    cd dsh-you-should-know
    npm ci
    npm run check
    npm pack

這將生成 `dsh-you-should-know-0.1.0.tgz` 文件。

2. 將生成的包添加到 Harness 配置文件：

    dsh plugin --profile web add -w /absolute/path/dsh-you-should-know-0.1.0.tgz

將 `web` 替換爲你的配置文件名稱，並將路徑替換爲實際的絕對路徑。

3. 重啓 Harness 後，進入 Settings → You Should Know 確認插件已加載。

典型用法¶

啓動任務後，插件會自動運行觀察。請注意，短任務通常不會觸發檢查，且並非每個回合都會顯示筆記。

在懸浮面板中，你可以執行以下操作：

• Learn more：查看筆記的理由和影響。如果存在相同語言的解釋，會複用現有解釋。
• Knew this already / Understood：將當前話題標記爲已知，減少後續重複提醒。
• Chat in main session：將筆記和解釋插入主會話。僅噹噹前沒有草稿或附件時纔會執行，發送動作由用戶手動觸發。
• Dismiss：關閉筆記並提供反饋選項。
• Minimize / Open note：僅切換面板顯示狀態，不提交反饋或標記已理解。

注意事項與限制¶

1. 性質定位：筆記並非事實覈查或執行審查，它們可能遺漏重要細節或包含不準確信息。僅在需要進一步討論時將其帶入主會話。
2. 檢查邏輯：
   • 檢查次數按“用戶-任務”回合單獨計數。插件重新加載不會重置當前回合的計數。
   • 檢查頻率基於模型步長（非單個工具調用）。
3. 跳過場景：以下情況會跳過檢查：子代理會話、無在線顯示的會話、已存在筆記、檢查正在進行中、該回合已顯示過筆記、或處於主動忽略退避中。
4. 退避機制：
   • 未展開的筆記在收到兩個有效用戶輸入後會關閉。
   • 如果連續三次忽略筆記，退避序列將從 1、2、4、8 開始，最多跳過 16 次檢查。用戶的主動交互會重置退避。
5. 去重與清理：
   • 主題去重取決於模型對相同話題不同表述的識別能力，無法保證完全去重。
   • 清理主題歷史需要確認，且僅影響選中的列表。清除一個列表不會保證該主題在另一個列表中出現。
   • 清理後，該話題在當前會話中仍可能以不同形式再次出現。

總結¶

dsh-you-should-know 通過後臺獨立的觀察模型，在任務運行時保持對上下文的敏感度，幫助開發者保持對關鍵信息的關注。對於需要處理複雜邏輯或多輪對話的 DSH 任務，這是一個輔助保持上下文連貫性的工具。

更多詳情與源碼，請訪問：GitHub 倉庫