前言¶
使用 DSH 時，本地會積累對話、數據文件、技能、記憶庫、日誌、瀏覽器存儲等數據。這些數據通常落在 ~/.dsh 內，來源分散，體積不清，刪除時也容易誤傷用戶項目文件。
在 DSH「一切皆插件」的生態裏，dsh-data-ledger 把本地數據管理做成一個可安裝、可卸載的插件：給人看右側數據面板，也給智能體裝上 ledger_* 工具，用於查看數據、提議清理和恢復。
這是什麼¶
dsh-data-ledger 是 Niuniu-Sir 維護的 DSH 插件，許可證爲 MIT。它主要解決兩個問題：
1、讓使用者集中查看 DSH 產生的本地數據，而不是逐個翻目錄。
2、讓智能體能夠理解這些數據，並在用戶點名後執行清理動作。
核心功能¶
數據看板¶
右側「數據管理」面板分組展示以下內容：
對話
數據文件
技能
記憶庫
日誌
回收站
瀏覽器存儲
只讀參考
每個分組顯示數量與體積。每個條目會展示：
來源（哪個插件/官方）
名稱
大小
時間
一句話摘要
面板支持分組摺疊，也支持在主對話行上收起其子代理。主對話/分支與 AI 子代理以樹狀嵌套展示。
刪除動作先進回收站，可恢復，不會自動清空。刪除主對話時，其子代理會一併移入回收站。
面板還支持：
複製路徑
資源管理器定位
瀏覽器存儲鍵查看與清除（鍵名打碼）
AI 管家¶
插件提供以下管家工具：
ledger_scan
ledger_delete_paths
ledger_restore_path
ledger_purge_paths
ledger_report_done
這些工具用於掃描數據、將指定路徑移入回收站、恢復路徑、徹底清除用戶點名的回收站條目，以及報告巡檢完成。
配套技能是 ledger-steward：
ledger-steward
它的設定是每週主動巡檢、只問不動：智能體列清單、提建議，清除動作需要用戶點名。
安裝與啓用¶
安裝命令：
dsh plugin --profile web add github:Niuniu-Sir/dsh-data-ledger
安裝後重啓：
dsh web
如需卸載：
dsh plugin --profile web remove dsh-data-ledger
卸載後數據文件保留，可按需清理。
典型用法¶
1、打開右側中部偏下的方塊按鈕，滑出「數據管理」面板；點擊面板外任意處收回。
2、點擊分組標題展開或收起；點擊主對話行展開或收起其子代理。
3、對智能體說「看看有多少垃圾」。智能體列出清單並提出建議，只有你點名後才執行清理。
安全邊界¶
插件只管理 ~/.dsh 內的 DSH 數據，不觸碰用戶項目文件，例如報告、事實庫等。
路徑處理使用白名單，並通過 realpath 複覈，防止符號鏈接逃逸；越界請求會被拒絕。
刪除永遠先進回收站；徹底刪除需要雙重確認。
憑據類文件只顯示位置與大小，不顯示內容。
插件聲明零第三方依賴、無網絡請求。
配置¶
配置位於 cordis.patch.yml 的 data-ledger 行：
enabled=true
trashDays=30
refreshSeconds=20
其中：
enabled：啓用開關
trashDays：回收站保留天數
refreshSeconds：面板自動刷新間隔（秒）
適用場景與注意¶
適合使用 DSH Web 環境、希望集中查看本地數據、並讓智能體協助盤點與清理的人。
插件以當前 dsh 進程權限運行。安裝前建議先檢查源碼與許可證；如果你只信任特定權限範圍，應在受控環境中安裝和驗證。
