前言¶
DeepSeek Harness (DSH) 在處理長對話時會依賴上下文壓縮來管理上下文窗口，這可能導致重要的約束條件、代碼片段或公式在壓縮過程中被丟棄。highlightpin 是爲此設計的一個插件，它允許用戶將選定的源文本進行固定，確保在上下文壓縮過程中這些內容不會被丟失，而是在需要時被重新插入。
插件簡介¶
highlightpin 是一個 DSH 插件，由維護者 sbearbug 開發。它提供三級源文固定機制，支持在上下文壓縮中存活，並通過命令行接口進行管理。
安裝¶
使用 npm 發佈版本安裝：
dsh plugin --profile desktop add dsh-highlightpin@0.1.2
或直接從 GitHub 源安裝：
dsh plugin --profile desktop add 'https://codeload.github.com/sbearbug/dsh-highlightpin/tar.gz/v0.1.2'
安裝或升級後，需要完全退出並重啓 DSH，然後刷新頁面以加載新版本。
功能¶
- 三級源文固定：提供
pin、resident、highlight三種固定級別。 - 存活於上下文壓縮：即使上下文被壓縮，固定的文本也會在需要時被重新插入。
- 命令行接口：支持通過 CLI 管理固定內容。
- 公式與代碼支持：存儲 TeX 源文本，保留代碼的縮進和換行。
- 可配置限制：可以爲每個級別配置字符數限制。
使用¶
在對話中選擇一段文本（必須位於同一條消息內），點擊頂部的 pin 圖標進行固定。可以通過詳情面板切換級別、檢查預算或取消固定。
主要 CLI 命令如下：
- /hlpin list：列出所有固定項及其使用情況。
- /hlpin last：固定最近一次助手回覆的全文。
- /hlpin show <n>：顯示特定固定項的完整文本。
- /hlpin drop <n>：取消固定。
- /hlpin level <n> pin|resident|highlight：更改固定項的級別。
配置¶
插件支持通過 JSON 配置文件調整參數，默認配置如下：
{ "maxPinChars": 16000, "maxResidentChars": 6000, "maxHighlightChars": 2000, "holdSubagents": false }
字符數以 UTF-16 單位計算。
限制¶
- 選擇必須在單條消息內。
- 不支持流式消息、推理內容和工具輸出。
- 固定項僅屬於當前會話，不會繼承到 forked sessions。
- HTTP API 僅接受來自本地頁面的 JSON。
- 超過預算時會被拒絕，而不是截斷。
