前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」，开发者可以把工具链拆解成一个个可组合的模块。在智能体开发中，我们常需要让 Agent 拥有文件与目录的感知能力，但直接暴露文件操作接口会带来安全风险。盘查（Pancha）是 vlln 提供的 DSH 客户端插件，它把磁盘变成一张可视化盘面：Agent 负责分析每个目录，你负责决定，执行前一定先预览。
是什么¶
盘查是一个 DSH 客户端插件，把磁盘变成一张可审查、可批注、可执行的盘面。维护者 vlln。它不直接删除文件，而是让 Agent 为每个目录写一句语义（是什么、能不能清理、依据是什么），你在盘面上做决定，确认后再执行清理。
核心功能¶
- 语义扫描：扫描主目录的直接子项，返回体积最大的若干项，并让 Agent 为它们写一句语义。
- 可视化盘面：树图按体积占位，色条展示分类；列表视图把 1 像素以下的小项也列出来。
- 用户决策：用 K（保留）、D（待清理）、空格（循环三态）、Backspace（清除）做决定；你的决定优先于 Agent 的语义。
- 执行预览：点「执行清理」后逐项预览（源是否还在、目标是否冲突），确认后移到废纸篓。
- Agent 协作：扫描结束后自动补语义，扫描过程中也会先对已读到的部分动手；点「让 Agent 提方案」让它挑一批最有把握的；右上角「对话」打开抽屉，可以直接问它、看它这一轮做了什么。
安装与启用¶
在 dsh web 里：打开 Plugins → 添加插件，输入 github:vlln/dsh-pancha，点安装。
用 CLI：
dsh plugin --profile web add github:vlln/dsh-pancha
生效：装完刷新页面，无需重启宿主。前置：dsh 0.2.x（在 0.2.1-rc.1 上验证）。卸载：dsh plugin --profile web remove dsh-pancha。
装好后左侧栏会出现「盘查」，Plugins 页的「已安装插件」里也能看到它和图标。第一次打开会自动建一个一次性会话并扫描主目录，几秒后出现方块。
典型用法¶
看：点开方块，右侧显示语义、依据和历史体积曲线。定：K 保留、D 待清理、空格循环三态、Backspace 清除；多选时作用于全部。方块立刻变样：保留是绿框，待清理是红底，Agent 标的还会带一个小 A。执行：点「执行清理」→逐项预览（源是否还在、目标是否冲突）→确认后移到废纸篓。macOS 拒绝写废纸篓时退到 $DSH_HOME/trash/<时间戳>/，界面会写明去向。成功后记成一批，点「撤销这批」可以移回。让 Agent 参与：扫描结束后自动补语义，扫描过程中也会先对已读到的部分动手；点「让 Agent 提方案」让它挑一批最有把握的；右上角「对话」打开抽屉，可以直接问它、看它这一轮做了什么。
适用场景与注意¶
适合需要让 Agent 感知磁盘结构、但又不想让 Agent 直接删除文件的场景，比如磁盘清理、目录分析、批量预览与决策。注意：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证；已知只扫描当前层的直接子项，逐层下钻；执行只有「移动」一种动作，没有重命名/归档/压缩；废纸篓权限随宿主环境而异；Agent 语义是「一句结论 + 依据」，不保证正确，决定权在用户。
短结尾¶
盘查把 Agent 的分析能力与你的决策权结合起来，在执行前提供预览，降低了直接文件操作的风险。目录页：https://www.skillhub.cn/plugins/vlln/dsh-pancha；GitHub：https://github.com/vlln/dsh-pancha
