前言¶
DeepSeek Harness (DSH) Desktop 插件 Lume（微光）旨在爲智能體開發提供結構化的約束與記憶支持。它不替代模型的思考過程，而是通過協議確保模型手邊的“事實到位”。
在長對話或複雜任務中，模型容易產生需求漂移、引用未打開的代碼行、或在非執行輪次錯誤地修改狀態。Lume 通過紀律層和方法層解決這些問題，同時提供人設層以控制對話風格。插件以 MIT 協議開源，由開發者 cayan0x 維護。
核心能力¶
Lume 將能力劃分爲四個層級，每層承擔特定的職責：
紀律層：邊界與覈查¶
紀律層負責判定請求類型並劃定操作邊界。它會在對話中注入檢查項，確保模型在回答、查找、討論、診斷或執行等不同模式下不越權行事。
- 請求類型判定：基於請求內容和最近幾輪軌跡，區分問答、查找、討論、診斷與執行輪次。問答輪不改文件，診斷輪不越權修復，只有執行輪才改變狀態。
- 事實覈查：檢查引用的代碼行是否在本次會話中打開、對未見過的符號是否下過否定斷言、需求與交付物是否對齊。
- 上下文管理：當上下文佔用達到 75% 或 90% 時發出預警，並導出結構化會話記憶（目標、已拍板、未決、關鍵定位）。
- 度量自校：對路由判定被反覆糾正的情況進行檢測。
方法層：可檢查的產出¶
方法層將任務轉化爲可驗證的產物，確保每一步都有據可查。
- 任務契約 (
lume_contract)：定義目標、範圍、預估數量（先估後回填）、完成判據、非目標與待確認項。 - 改動臺賬 (
lume_change)：記錄每次改動的位置、原因、驗證方式及狀態（自動入賬）。 - 假設臺賬 (
lume_hypothesis)：記錄假設的驗證過程。下結論（confirmed/excluded）必須附帶證據、裁決方式與反例檢查。 - 設計決策 (
lume_design)：記錄決策點、選擇方案、放棄理由及影響面。 - 項目知識 (
lume_project_note)：按工作目錄跨會話累積穩定事實，支持按編號刪除（lume_project_forget）。
人設層：風格與記憶¶
人設層從聊天記錄、小說、劇本或設定文檔中蒸餾具名角色。
- 角色蒸餾：提取語氣、口頭禪、回覆篇幅等特徵。
- 長期記憶：以人設爲鍵存儲記憶，隨對話演進。
- 風格糾偏：糾正自動生成的回覆風格，但不介入代碼執行和工具調用的結果。
儀表盤與觸發器¶
- 行爲觸發器：通過軌跡而非措辭進行糾偏。包括
converge（撒網不收斂）、verify-as-you-go（連寫不驗）、contract-missing（契約缺失）等。 - 運行時度量：通過
lume_metrics查詢路由判定、觸發器命中、塊裝配及外部結果信號。
安裝與啓用¶
Lume 通過 npm 包管理器安裝。
# 安裝插件
dsh plugin add lume-dsh-plugin
安裝後必須完全重啓 DSH（包括托盤進程），插件在宿主啓動時加載，不支持熱重載。
典型用法¶
1. 定義任務契約
在開始執行前，使用 lume_contract 錨定目標、範圍和判據。
lume_contract({
goal: '跑步記錄新增配速列：列表展示 + 歷史記錄補算 + 導出可用',
scope: 'run_record 表與遷移腳本、列表頁組件、CSV 導出',
expectCount: 6, // 先估：6 個改動點，探索後回填實際值
criteria: ["新記錄能自動算出配速", "歷史記錄已補算", "導出的 CSV 裏含配速列"],
nonGoals: ["不改 CSV 既有的列順序", "不動手機端的同步邏輯"],
open: [] // 默認 0 個待確認
})
2. 查看運行時度量
在對話中隨時查詢觸發器效能或系統健康狀態。
lume_metrics
3. 管理項目知識
當需要刪除特定的項目知識條目時使用。
lume_project_forget
注意事項¶
- 開銷控制：閒聊輪不會背上整份工作協議的成本，協議與臺賬按需注入。
- 權限範圍：人設隻影響自然語言表達，不介入代碼、命令與工具調用的結果。問答輪不改文件，診斷輪不越權修復。
- 網絡請求：不主動發起網絡請求，僅允許調用配置的模型檔進行記憶提取、反思與人設蒸餾。
- 結論歸屬：插件不替用戶下結論，機械判據只保證“有沒有證據”，判斷對錯仍在模型。
生態位置¶
Lume 是 DSH 生態中的一個插件，用於增強 DSH Desktop 的任務執行能力。更多信息請訪問 SkillHub 插件目錄 或 GitHub 倉庫。
