配置

配置分两层，优先级从低到高：

层	位置	生效时机
部署默认值	本包的 `cordis.patch.yml`	改完需重启 DSH
用户覆盖	`%USERPROFILE%\.dsh\state\dsh-bundle-default-workspace\settings.json`	立即生效，无需重启

用户覆盖层是稀疏的：只存你在面板里真正改过的字段。点「恢复默认」是把那个键删掉（而不是把默认值再写一遍），于是自动回落到部署配置。

键	默认	说明
`enabled`	`true`	关闭后不创建目录、不登记工作区、不提供工具，面板只读。
`directoryName`	`default-workspace`	叶子目录名。与 DSH 内核首用工作区同名，默认配置下直接包装内核行为。只允许字母数字点下划线连字符。
`parentDirectory`	`""`	父目录。留空走下面的自动解析；填绝对路径则直接用它。
`documentsDirectory`	`""`	系统文档目录覆盖，仅在 `parentDirectory` 为空时生效。留空则自动探测。
`title`	`""`	展示标题。留空由目录名派生（`default-workspace` → 「默认工作区」）。改标题会调用 `workspaceRegistry.setTitle`。
`description`	`""`	用途说明，展示在面板与 `AGENTS.md`。留空用内置文案。
`autoCreate`	`true`	首次使用时自动创建目录并登记，不用手动点「确保」。
`seedAgentsMd`	`true`	创建时写入 `AGENTS.md`。
`instructions`	`""`	非空则整篇替换内置种子正文。
`overwriteSeed`	`false`	即使 `AGENTS.md` 已存在也重写。默认关闭以保留你自己的修改。
`pollSeconds`	`30`	面板刷新间隔，夹在 5–600 秒之间。
`trashKeep`	`5`	回收站保留份数，夹在 0–100 之间。超出份数的最旧批次才会被真正删除；`0` = 不自动清理。只影响插件自己创建的批次。
`allowedHosts`	`[]`	额外可信主机名（叠加到 `localhost` / `127.0.0.1` / `::1`，不替换）。

目录是怎么定下来的

1. parentDirectory 非空？      → 直接用它                      来源 = config
2. documentsDirectory 非空？   → /deepseek-harness          来源 = documents
3. 自动探测系统文档目录？       → /deepseek-harness        来源 = documents
4. 都失败                      → ~/.dsh/workspaces/deepseek-harness  来源 = fallback

最终目录 =  /

探测方式与 DSH 内核保持一致：Windows 走 [Environment]::GetFolderPath、 macOS 走 osascript、Linux 走 xdg-user-dir，带 10 秒超时。

当前用的是哪一种来源会显示在面板上 —— 「我的工作区到底建哪去了」是最常问的问题。

dsh-bundle-default-workspace

安装

说明文档

配置

目录是怎么定下来的