前言¶
在 DeepSeek Harness（DSH）里让助手落盘截图、下载物、转码中间文件或临时脚本时，文件很容易堆在当前项目根目录，和源码混在一起，也不利于按会话区分。手动建目录、每次在提示里约束路径，成本高，清理还要自己删文件夹。
dsh-cache-workspace 是社区维护的客户端插件，在输入框上方工具栏增加缓存目录选择器，并为助手注入「缓存工作区」使用规则；支持把工作区外的目录选为缓存并自动授予沙箱写权限，清理在独立进程里执行。下文按安装、用法和限制说明，事实以 GitHub 仓库 README 为准。
这是什么¶
- 名称与归属：
@local/dsh-cache-workspace（npm 包名），维护者 ll4514dvdvdb，版本 0.1.0，许可 MIT。 - 分类：客户端插件（
dsh.client.platform: web），只依赖 DSH 本体，不需要其他插件。 - 解决的问题：为每个工作区（会话所在目录）记住一个「可随意读写」的缓存文件夹，避免助手把中间产物写在项目根；用完可一键递归删除该目录。
插件目录页：SkillHub - dsh-cache-workspace。
核心功能¶
安装并重启后，输入框工具栏会出现缓存控件（README 描述为文件夹名 + 下拉 + 清理按钮）。能力可概括为四类：
看：控件显示当前缓存文件夹名；每个工作区各自记住选择。
选：
- 点文件夹名：打开 Windows 资源管理器选目录。
- 点右侧下拉：从工作区已有子目录中选，或新建文件夹。
- 未选择时默认使用
<当前工作区>/.dsh-cache，该路径在沙箱可写范围内。
清：点清理按钮并确认后，递归删除当前缓存目录；删除在独立进程中完成，对话归档或客户端关闭后仍可继续执行。目录不存在时清理控件为灰色。
教：每轮对话开始时，向助手系统提示注入「缓存工作区」规则，内容包括：可在该目录任意创建、读取、执行文件；勿在根目录堆文件，应按工作名建子文件夹；缓存非长期存储；用过之后提醒用户可点清理；工作区外路径仍受沙箱限制。
工作区外目录：可选工作区外路径（例如 D:\my-cache）。插件会创建目录并为该目录授予 DSH 沙箱所需写权限，仅作用于你主动选中的那一个目录。目录须属于当前登录的 Windows 账户，否则授权失败并在控件上显示原因。
配置与日志落在 %USERPROFILE%\.dsh\dsh-cache-workspace\：state.json（各工作区缓存路径与已授权外部目录）、log.txt（UTF-8 运行日志）、grant.ps1（外部目录授权时生成的临时脚本）。删除该配置目录会重置所有选择，不会删除已存在的缓存文件夹本身。
安装与启用¶
前提：Windows 上的 DeepSeek Harness 桌面版，且能执行插件相关命令。
- 将插件目录放到任意位置（建议留在工作区便于备份）。
- 在 DSH 中安装 bundle，或使用 CLI（路径换成本机绝对路径）：
plugin_manager action=install_bundle target=<本目录的绝对路径>
dsh plugin --profile desktop add "file:<本目录的绝对路径>"
- 重启 DeepSeek Harness，或在插件列表中禁用后再启用。
- 输入框工具栏出现缓存控件即表示安装成功。
卸载：
dsh plugin --profile desktop remove @local/dsh-cache-workspace
插件以当前 DSH 进程权限运行；安装前建议浏览源码与 MIT 许可证，确认清理与权限变更行为可接受。
典型用法¶
选择缓存目录
- 点控件上的文件夹名 → 资源管理器选文件夹。
- 点名字右侧下拉 → 从当前工作区子目录挑选，或选「＋ 新建文件夹…」输入名称。
- 选中后助手可见路径会立即更新。
使用默认位置
不操作时默认 <当前工作区>/.dsh-cache，助手的文件工具与命令工具可直接使用。
清理
点清理 → 确认 → 目录被递归删除（无回收站）。
助手侧约定
助手会被告知：缓存目录可随便用，但按工作名分子目录；用完后应提示你可点清理按钮。
适用场景与注意¶
适合谁：在 Windows 桌面 DSH 上频繁让助手写临时文件、希望与仓库根目录隔离、并需要按工作区记住路径的开发者。
平台：README 写明仅支持 Windows。
风险与限制：
- 清理为递归删除，不可恢复；勿将含重要数据的目录设为缓存。
- 工作区外目录若被其他账户或系统占用，授权可能失败。
- 控件不跨机器同步「工作区 → 缓存目录」映射。
- 选中工作区外目录时会修改该目录访问权限（仅该目录），用于沙箱内写入。
- 插件不联网、不上传数据；清理前会弹确认框。
安全摘要（来自 README）：不联网；仅对你选中的工作区外目录改权限；清理前必确认。
结尾¶
dsh-cache-workspace 把「选目录、记路径、教助手、清缓存」收进输入框工具栏一行，默认 .dsh-cache 即可用，外置目录则自动授权写权限。若你在 DSH 里被项目根目录里的临时文件打扰，可按上文命令本地安装 bundle 后试用。
- 目录页：https://www.skillhub.cn/plugins/ll4514dvdvdb/dsh-cache-workspace
- 源码与说明：https://github.com/ll4514dvdvdb/dsh-cache-workspace
社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态以「一切皆插件」为思路，本插件为独立社区作品。
