前言¶
在 DeepSeek Harness（DSH）里做智能体开发，工作区往往落在本机磁盘。若代码和资料放在 NAS 或 SMB/NFS 等网络共享路径上，DSH 默认对工作区路径、打开方式的处理未必贴合这类环境：路径在不同机器上不一致、共享挂载点各异，会话里「打开工作区」的行为也容易和本地目录混在一起。
社区插件 dsh-nas-workspace-support（维护者 vb2250158，分类：工作流）面向上述场景，为 NAS 工作区提供可配置的路径映射与打开行为。DSH 生态采用「一切皆插件」的扩展方式；插件目录页托管于 SkillHub 等社区站点，与 DeepSeek / 幻方无官方从属关系，安装前仍以仓库 README 与源码为准。
这是什么¶
dsh-nas-workspace-support 是开源 DSH 插件（MIT 许可证，当前包版本 0.3.5）。界面语言为中文时，插件列表显示 NAS 工作区；英文为 NAS workspaces。简介与 locale 描述一致：支持 NAS 和网络共享路径上的工作区。
本插件要求 DSH 0.2.1-alpha.1 或兼容的 0.2 系列发行版；上游兼容性说明中记录的已验证修订为 5badb15009ae1756c3afe0ae0cef1faafc290ccc，详见仓库内 docs/dsh-0.2-compatibility.md。
核心功能¶
下面介绍 README 与仓库文档中可核对的能力，不展开未在资料中出现的配置字段名。
-
路径映射与打开行为
插件为 NAS 工作区提供可配置的路径映射，并调整与工作区相关的打开行为，使 DSH 在识别、打开网络共享路径上的工作区时更可控。 -
与 DSH 0.2 配置体系对接
兼容性文档说明：宿主侧设置使用 volatile 的 Config 值，客户端通过 ConfigForms 读取。插件面向 web 平台客户端，并在package.json的dsh.client中声明对 Cordis、settings、session 等 UI/API 模块的注入依赖。 -
配置层随 profile 安装
包内声明dsh.bundle，指向cordis.patch.yml；安装后会把插件对应的 Cordis 配置层合并进当前 profile（patch 中会插入 id 为nas-workspace-support、名称为dsh-nas-workspace-support的条目）。
安装与启用¶
安装前请先锁定公开仓库的固定提交（<commit> 换为完整 commit id）。多机共用的环境应保存完整 commit，而不是本机 checkout 路径。
通过 DSH 官方入口、对 web profile 执行：
pnpm dsh plugin --profile web add github:vb2250158/dsh-nas-workspace-support#<commit>
经过上面的步骤，插件包会按 dsh.bundle 把 patch 写入 profile，无需在本机保留插件源码目录即可完成 pin。
配置与多机同步¶
插件相关配置保存在 DSH profile 下的 cordis.patch.yml（与安装时合并的配置层一致，具体业务项在 DSH 设置界面中通过 ConfigForms 维护，资料未列出独立 YAML 键名表）。
若你使用多电脑同步仓库管理 DSH 环境，README 建议该仓库只保存：
- 插件仓库地址
- 固定提交
- 启停状态
- 插件配置
不要把本插件的源码目录放进同步仓库，以免路径不可移植、与 dsh plugin 的 commit pin 方式冲突。
典型用法（可复现步骤）¶
资料中的用法以「安装 → 在 profile 中保留配置 → 在 DSH 中启用 NAS 工作区相关设置」为主，未提供独立 CLI 示例子命令。可按下面顺序操作：
- 确认本机 DSH 版本满足 0.2.1-alpha.1 或兼容 0.2 要求。
- 在 GitHub 上选定要安装的 commit，执行上一节的
pnpm dsh plugin --profile web add ...命令。 - 在 DSH web 客户端打开插件/设置，配置 NAS 或网络共享路径上的工作区映射与打开行为（界面文案见 NAS 工作区 插件项）。
- 在新会话中选择或打开位于 NAS/共享路径的工作区，验证路径解析与打开行为是否符合预期。
仓库维护者本地校验插件包可用：
npm test
npm pack --dry-run
适用场景与注意¶
适合谁
- 工作区代码或数据主要在 NAS、网络共享盘上的 DSH 用户。
- 需要在多台机器上用同一套 profile / 同步仓库 pin 插件 commit，并统一 NAS 工作区行为的团队。
注意事项
- 版本：仅支持 DSH 0.2 线；与 0.1 或未声明兼容的版本混用可能无法加载客户端注入模块。
- 权限：插件随当前 dsh 进程运行，对工作区路径、远程挂载的访问能力取决于该进程的用户权限；安装前应阅读源码与 MIT 许可证，确认路径映射逻辑可接受。
- 平台：
dsh.client.platform为 web；安装命令中的--profile web须与使用 profile 一致。 - 社区属性：目录页与 GitHub 由社区维护，星标数等元数据以站点为准（SkillHub 当前为 0），不代表官方背书。
结尾¶
dsh-nas-workspace-support 把 NAS 与网络共享路径上的工作区纳入 DSH 0.2 的可配置路径映射与打开流程，并通过 bundle patch 与 profile 中的 cordis.patch.yml 接入多机同步工作流。需要安装命令、兼容性说明与许可证时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/vb2250158/dsh-nas-workspace-support
- GitHub：https://github.com/vb2250158/dsh-nas-workspace-support
