前言¶
使用 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 进程权限运行。安装前建议先检查源码与许可证；如果你只信任特定权限范围，应在受控环境中安装和验证。
