前言¶
在 DeepSeek Harness (DSH) 中，切换不同工作区时，开发者通常需要为每个新会话手动重新选择 Agent 预设和权限预设。这导致大量重复操作，降低了开发效率。@ahiosuz/dsh-workspace-tools 插件通过配置工作区级别的默认规则，解决了这一问题：新会话会自动应用对应工作区的预设，无需每次手动选择。
插件定位¶
这是一个 DeepSeek Harness 工作区工具插件，由开发者 AHIOSUZ 维护。它允许用户为每个工作区配置默认的 Agent 和权限预设。当创建新的根会话时，插件会根据会话的工作目录自动匹配对应的工作区规则，并应用预设，从而停止重复选择操作。
核心功能¶
- 新增设置页面：在设置中新增了「Workspace defaults」页面，用于管理预设规则。
- 规则配置：每条规则包含一个已注册的工作区、Agent 预设和权限预设。
- 实时工作区列表：工作区下拉列表实时显示已注册的工作区名称。
- 健壮的匹配逻辑：规则以工作区 ID 为键存储（路径和标题仅用于显示），因此工作区重命名或路径大小写变更不会导致规则失效。
- 自动应用流程：当新会话的工作目录（cwd）匹配到规则的工作区目录或其子目录时，插件会自动通过
agentPresets.select切换 Agent 预设，并通过permissionPresets.set提交权限预设。 - 会话范围限制：该功能仅影响新创建的根会话，已存在、恢复、分叉或子代理会话保持不变。
安装与使用¶
安装插件：
dsh plugin --profile web add @ahiosuz/dsh-workspace-tools
配置与使用步骤：
- 重启或重新加载 DSH Web。
- 打开设置，进入「Workspace defaults」页面，点击「Add rule」。
- 从下拉列表中选择一个工作区，设定 Agent 预设和权限预设（两者可选，不选则继承全局默认），点击保存。
- 在该工作区创建新对话，在第一次对话前验证预设是否已自动应用。
适用场景与注意¶
- 兼容性：支持官方 DSH 0.1.5-rc.1 及以上版本，无需任何补丁。
- 规则管理：如果规则指向的工作区已被移除，规则会被标记而非静默失败。
- 手动优先：会话建立后的手动选择优先级高于自动应用，会覆盖预设。
- 安全机制：插件仅读取会话的工作目录并调用官方预设服务，不包含遥测、凭证访问、命令执行或网络访问。规则保存在用户设置文档中，可随时编辑或清除。
