前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。zhm20001 提供的 dsh-diary 插件針對需要長期記錄與 AI 輔助總結的場景。它提供了一個紙感信紙風格的 Web 頁面，核心邏輯是先保存用戶輸入的原文到本地磁盤，再調用 LLM 生成評註。這種設計確保了即使 AI 總結失敗，用戶的原始內容也不會丟失。
核心功能¶
- 原文落盤與 AI 評註分離：原文提交後立即落盤；AI 評註（關鍵詞、總結、Emoji、評註文本）在後臺生成，失敗不影響保存。
- 30 小時制日期處理：插件讀取系統時間。在
nightCutoff（默認 6 點）之前寫入的內容會被歸類爲前一天，時間戳顯示爲 25:xx 至 29:xx，避免深夜補記將同一天的記錄劈成兩個文件。 - 模板化建檔與追加：支持按模板建檔，同日多次提交會追加條目並重新生成當天的總結（舊評註塊會被摘除重寫）。
- LLM 直調：通過
ctx.llm調用，產出今日關鍵詞、一句話總結、當日 emoji 和評註。 - 長期記憶（用戶畫像）：每次保存日記時，系統會並行維護一份用戶畫像，存放在日記目錄的
.diary-meta/profile.md中。畫像會參考近一週的概要進行更新。 - 熱力圖與草稿：生成基於時間的熱力圖（半年一幀），草稿自動存入瀏覽器 localStorage。
安裝與啓用¶
安裝步驟如下：
git clone https://github.com/zhm20001/dsh-diary.git
cd dsh-diary
pnpm install
dsh plugin --profile web add <本目錄路徑>
安裝後重啓 dsh web，瀏覽器訪問 /diary。
典型用法¶
- 首次使用：打開頁面會顯示設置卡，需填寫日記目錄（如
~/Documents/日記），保存後配置寫入config.json，立即生效。 - 日常寫作：在頁面輸入內容並提交，原文即刻落盤。若總結生成失敗，可點擊“僅重試總結”補生成，原文不會丟失。
- 草稿保存：未提交的內容會自動存入瀏覽器 localStorage，按日期分鍵。
配置與進階¶
- 配置優先級：三層優先級（高到低）：cordis patch / profile config > 插件根
config.json> 內置默認。 - 自定義 Prompt：在頁面“AI 評註模型”選擇器旁打開 prompt 卡，可編輯系統提示詞（
summaryPrompt），保存後即時生效。 - 長期記憶邏輯：生成總結前，畫像全文與近一週概要作爲上下文注入。評註落盤後，系統會基於舊畫像和當天全文生成新畫像。畫像更新失敗僅顯示提示，不影響保存。
- 熱力圖規則：半年一幀，已寫顯示當日 emoji，未寫顯示淡底，未來顯示灰色。極少數年份（如 7月1日逢週日）下半年的 12 月 31 日格可能不顯示。
隱私與數據管理¶
- 隱私保護：日記全文僅落本地盤。唯一的外發數據是總結請求（當日全文 + 用戶畫像 + 近一週概要）。熱力圖、meta 和草稿均不出本機。
- 數據備份：數據自包含在日記目錄。備份時需包含
.diary-meta/文件夾，否則 emoji 會靜默降級爲綠塊，畫像無法讀取。 - 語義細節：同日再提交會追加條目並重寫總結，不要手動編輯“## AI評註”區域。文件格式爲
<diaryDir>/YYYY-MM-DD.md。
結尾¶
該插件爲 DSH 用戶提供了落地的日記記錄方案，結合 LLM 實現了本地化存儲與智能輔助的平衡。使用時需注意備份包含 meta 目錄，且總結模型配置需符合插件要求。
