前言¶
在 DSH 裏開過很多會話之後，「今天做了什麼、歸屬哪個目標、還有哪些沒做完」往往要靠人翻歷史或憑記憶拼湊。人工寫日報、週報也費時，還容易漏掉待辦或交付物鏈接。dsh-ai-journal 面向在 DSH Web 裏日常工作的開發者：它只讀取本機 DSH 會話日誌，在左側欄提供「AI 日報」面板，按目標分塊彙總行動、結果與未完成事項，並附帶圖形化摘要；數據不聯網、不上傳。
這是什麼¶
dsh-ai-journal 是維護者 vc1235-ui 發佈的 DSH Web 客戶端插件（分類：客戶端）。npm 包名 dsh-ai-journal，當前資料中版本爲 0.1.2，許可證 MIT。它依賴 DSH >=0.2.1-rc.5，使用核心服務 sessionController / sessionQuery 等，不依賴其它第三方插件。
目錄頁：https://www.skillhub.cn/plugins/vc1235-ui/dsh-ai-journal
源碼：https://github.com/vc1235-ui/dsh-ai-journal
核心功能¶
下面介紹面板裏已文檔化的能力，數字與條目均由程序從會話事件統計，結果爲空時不編造內容。
概覽與圖表¶
- 概覽：KPI 包括會話、輪次、我的輸入、工具調用、交付物、完成待辦，並顯示範圍、時區、更新時間。
- 圖形化摘要：待辦完成率環、目標/項目分佈堆疊條；週報另有 7 天輪次柱狀圖（hover 顯示數值）。
- 日報 / 週報切換，日期前後翻頁，支持手動刷新。
按目標分塊¶
沒有目標的會話按項目（工作目錄）歸組。每塊包含：
- 行動：窗口內人類輸入摘要，按時間排序。
- 結果：完成項、交付物（可點擊，經宿主
POST /api/present.open在桌面打開原文件）、已完成的待辦。 - 待辦：該塊內
pending與in_progress的待辦，以及進行中/受阻的目標；每條可「新開對話」，預填針對性提示詞。
待跟進（啓發式，可選）¶
從窗口內人類輸入中，按固定措辭（如「後續再聊」「待回覆」「待確認」等）識別可能被口頭遺留的事項，單獨成區並標註可能不準確。每條可「新開對話」，或點「這不是待辦」忽略（可撤銷）；忽略記錄是唯一會落盤的數據。
統計口徑（摘錄）¶
- 窗口：日報 = 請求時區當天
00:00起；週報 = 當週週一00:00起，共 7 天。 - 歸屬目標：會話最新
goal/change的 objective；無目標則按項目歸組。 - 未完成：會話最新
todo/write裏的pending/in_progress，以及active/blocked的目標。 - 交付物：來自事件
deliverables/presented。 - 自動觸發會話（標題/輸入帶自動觸發標記，或 cwd 在
~/.dsh/migrated-cron/、~/.dsh/bot/）整體不計入，含「待跟進」。
安裝與啓用¶
需要 DSH Web（README 中驗證版本爲 0.2.1-rc.5）與可用的會話查詢服務。插件以當前 DSH 進程權限運行，安裝前建議通讀倉庫源碼與 MIT 許可證。
# 從 npm（推薦，發佈後可用）
dsh plugin --profile web add dsh-ai-journal
# 或直接從 GitHub 安裝
dsh plugin --profile web add https://github.com/vc1235-ui/dsh-ai-journal
# 或本地路徑
dsh plugin --profile web add /path/to/dsh-ai-journal
安裝後在 DSH 中啓用插件並重啓（或等待 HMR 生效），左側欄會出現「AI 日報」入口。缺會話服務時接口返回 503，面板顯示中文提示，不會崩潰。
典型用法¶
- 在 DSH Web 中啓用
dsh-ai-journal後，從左側欄打開「AI 日報」。 - 在面板頂部選擇 日報 或 週報，用日期控件前後翻頁，必要時點刷新。
- 在「按目標分塊」中查看行動與結果；對待辦或受阻目標使用「新開對話」繼續推進。
- 在「待跟進」中核對啓發式條目；誤報可點「這不是待辦」，記錄寫入
$DSH_HOME/ai-journal/followups-dismissed.json（最多 5000 條）。 - 點擊結果中的交付物鏈接，在桌面打開對應文件（依賴 DSH Web 內置的
/api/present.open）。
隱私、安全與適用場景¶
- 會話內容僅在內存聚合，不落盤、不聯網、不上傳；Host 接口經宿主認證（未登錄 401、跨站 403），會話查詢失敗時 fail closed。
- 適合需要本機閉環復盤日/周工作的 DSH 用戶；不適合需要把日誌上傳到雲端再彙總的場景。
- 待跟進爲啓發式識別，界面已說明可能不準確；定時任務 / 機器人會話按規則排除，避免污染統計。
經過上面的步驟，你可以在不上傳任何會話的前提下，用同一套 DSH 日誌驅動日報面板與桌面交付物打開。
延伸閱讀¶
- 插件目錄：https://www.skillhub.cn/plugins/vc1235-ui/dsh-ai-journal
- GitHub：https://github.com/vc1235-ui/dsh-ai-journal
- npm：https://www.npmjs.com/package/dsh-ai-journal
- 開放插件市場（dshopen.org）：https://dshopen.org/plugins/dsh-ai-journal
社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本文事實均來自上述倉庫 README 與 package.json。
