收纳间 yuezhiye/dsh-closet

收纳间 dsh-closet

DSH（DeepSeek Harness）的临时脚本与日志管理器：按工作区登记脚本、只读扫描遗留物、一键清运进可还原回收站。

DSH 干活时会留下大量临时脚本和日志 —— fix-xxx.ps1、upgrade-xxx.ps1、restart-dsh.log、.bak…… 事后没人记得哪个还能用、哪个已经过期、哪个可以删。

收纳间就是给这些产物准备的一个抽屉：放进去的都记在册上，没放的会被扫出来问你，清掉的先进回收站，随时能捞回来。

三条铁律

1. 跟着工作区走：数据存在 <工作区>/.dsh-fix/，换工作区就是换一个抽屉，绝不往用户目录乱写。
2. 扫描永不删除：closet_scan 只列清单、给理由，一个字节都不动。
3. 清理只做移动：closet_clean 把文件移进 .dsh-fix/trash/<批次>/，附带 manifest.json 记录原路径，随时可还原；真正的删除只有「过期清理」一处入口，默认 30 天后才允许，且默认只做预演。

目录结构

<工作区>/ └── .dsh-fix/ # 收纳间（dataDir 可配置） ├── registry.json # 登记册：路径/语言/用途/状态/运行次数 ├── logs/<脚本名>/ # 每次执行的完整输出，按时间戳分文件 │ └── 20261018-165530.log └── trash/<批次>/ # 回收站 ├── manifest.json # 每个文件的原路径与体积 └── <搬进来的文件>

工具

装上插件后，AI 可以直接调用 7 个工具：

| 工具 | 作用 | 会改文件吗 |
| closet_register | 登记一个脚本：路径、用途、语言、状态（active/done/obsolete） | 只写登记册 |
| closet_list | 列出登记册，并标注「文件还在不在」 | 否 |
| closet_scan | 扫描工作区，列出疑似遗留物及判定理由；skipTracked: true 可完全不显示已被 git 跟踪的文件 | 否 |
| closet_run | 按语言执行登记过的脚本，输出写进日志 | 只写日志 |
| closet_clean | 把指定文件移进回收站（可还原）；已被 git 跟踪的文件会被拒收，确需清运要带 force: true | 移动 |
| closet_trash | 查看回收站批次；expire: true 才做过期清理（默认预演） | 只在过期清理时删除 |
| closet_logs | 列出某个脚本的执行日志，或读取某份日志的末尾 | 否 |

也可以在 GUI 的 设置 → 脚本与日志 面板里点点点。

一个典型回合

用户：这次排查完了，把临时脚本收拾一下 AI ：closet_register { path: ".dsh-fix/upgrade-wbc.ps1", purpose: "升级 workbuddy 连接器", status: "done" } AI ：closet_scan → 发现 8 个遗留物（3 个 .bak、2 个日志、3 个临时脚本），附判定理由用户：前 5 个可以清 AI ：closet_clean { paths: [...] } → 已移入回收站批次 20261018-165530

支持的语言

按扩展名自动识别，多语言通用：

| 语言 | 扩展名 | 缺省解释器 |
| PowerShell | .ps1 .psm1 .psd1 | pwsh，缺失时退到 powershell.exe |
| Node | .js .mjs .cjs .ts | node |
| Python | .py | python，缺失时退到 py -3 |
| 批处理 | .bat .cmd | cmd.exe /d /c |
| Shell | .sh .bash .zsh | bash |

解释器路径可在配置里覆盖，见下。

配置

写在插件条目的 config 下（cordis.yml，或安装后由 cordis.patch.yml 注入的默认值）：

dsh-closet:
enabled: true
dataDir: .dsh-fix # 收纳间目录名，相对工作区 trashRetentionDays: 30 # 回收站保留天数
ignore: [] # 额外忽略的目录名或 glob，如 ['.bak', 'build']
maxScanFiles: 5000 # 扫描上限，防止在大仓库里扫穿 maxScanDepth: 64 # 扫描最大深度 runTimeoutMs: 120000 # 单次执行超时（毫秒） maxLogBytes: 2097152 # 单个日志文件上限（字节） maxCleanBatch: 200 # 单次最多清运多少项 maxCleanBytes: 209715200 # 单次最多清运多少字节（200 MB）
interpreters: {} # 覆盖解释器，键为语言名，值为 argv 数组

ignore 里写错的值会被丢弃而不是「忽略一切」——配置写坏只会让扫描结果变多，不会让它变空。

面板

安装后在 设置 → 脚本与日志 里：

- 已登记脚本：状态、路径、运行次数；文件已被删掉的会标红提示。
- 扫描遗留物：勾选后点「移进回收站」，一次一批。表头第一个复选框可一键全选（被 git 跟踪的文件不参与），部分勾选时显示半选状态。
- 回收站：按批次列出体积与条目，可一键还原。
- 执行日志：按脚本分组，点开看最近 200 行。

面板接口走 /dsh-closet/api/，只接受同源请求（拒 cross-site 与 origin: null）。

安全设计

- 不会误删：closet_clean 只移动；真正删除只有 closet_trash { expire: true } 一条路，默认 dryRun。
- 不动版本库里的东西：扫描会照常列出已被 git 跟踪的文件（标 tracked + 「⚠ 已被 git 跟踪」），但判定固定为「待确认」，closet_clean 默认整批拒收；确需处理要显式带 force: true。工作区不是 git 仓库或本机没装 git 时，保护自动降级并在结果里明说。
- 不会越界：只能处理工作区内的文件；.. 穿越、大小写变体、软链接/目录联接绕过都被拦截（字面路径与真实路径双重校验）。
- 不会扫穿：node_modules、.git 等默认跳过，软链接不跟随，深度与文件数有上限。
- 不会写坏：registry.json 走「写临时文件 → rename」的原子写；文件损坏时先改名留存现场再重建。
- 不会拖死：脚本执行有超时保护，超时用 taskkill /T 连同子进程整棵树杀掉（POSIX 走进程组）。

开发

npm test # 单测 108 + 端到端冒烟 18 + 文档一致性；零依赖，全用 Node 内置 test runner
npm run test:unit # 只跑单测
npm run lint:syntax

项目结构：

lib/
├── store.js 登记册读写（原子写、路径规范化、语言识别） ├── scan.js 遗留物扫描（只读） ├── run.js 多语言执行（spawn + 日志 + 超时 + 进程树强杀） ├── trash.js 回收站（移动/还原/过期清理） ├── config.js 配置归一化 + 原生 Schemastery schema（拿不到内核依赖时用自带的兼容 schema） ├── routes.js HTTP 面板接口 ├── client.js 设置面板（CJS factory 单文件，无需构建） └── index.js 插件入口，7 个工具的定义与装配

test/
├── .test.js 单测（store / scan / run / trash / contract） ├── smoke.mjs 端到端冒烟：真 ctx + 真文件系统，工具与路由都跑一遍 ├── docs-check.mjs 文档与实现一致性（工具名 / 模块 / 版本号） └── host-stubs.js 把 @deepseek-ai/dsh-llm 等宿主包替换成桩，让纯 Node 也能 import 入口

store / scan / run / trash 四层不依赖 DSH，可以单独用、单独测、换宿主也能跑。

lib/client.js 是手写的 window.__ModuleLoader__ CJS factory，改完不需要重启，HMR 会自己刷新（React 组件状态会丢）。改 lib/index.js、package.json 或 cordis.patch.yml 需要重启 DSH。

许可

MIT