收纳间 dsh-closet
DSH（DeepSeek Harness）的临时脚本与日志管理器：按工作区登记脚本、只读扫描遗留物、一键清运进可还原回收站。
中文 | English
DSH 干活时会留下大量临时脚本和日志 —— fix-xxx.ps1、upgrade-xxx.ps1、restart-dsh.log、*.bak…… 事后没人记得哪个还能用、哪个已经过期、哪个可以删。
收纳间就是给这些产物准备的一个抽屉：放进去的都记在册上，没放的会被扫出来问你，清掉的先进回收站，随时能捞回来。
三条铁律
- 跟着工作区走：数据存在
<工作区>/.dsh-fix/，换工作区就是换一个抽屉，绝不往用户目录乱写。
- 扫描永不删除：
closet_scan 只列清单、给理由，一个字节都不动。
- 清理只做移动：
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
