前言¶
在 DSH 里用 Web 侧边栏浏览工作区文件时，目录树往往只显示符号链接本身，无法像普通文件夹一样展开、进入目标路径。 monorepo、工具链或跨盘布局里，常用 symlink 或 Windows junction 把外部目录挂进工作区；若侧边栏不能「穿透」这些节点，智能体和你本人在 UI 里都会少一条直观的文件导航路径。
下面介绍社区插件 dsh-symlink-passthrough（仓库 RicardoYan/dsh-symlink-passthrough）：在 DSH 侧边栏中打开符号链接与 junction，并对指向工作区外的目标施加与工作区信任（workspace trust）一致的约束。
这是什么¶
dsh-symlink-passthrough 由 RicardoYan 维护，在 SkillHub 等社区目录中归类为客户端插件。SkillHub 页面当前标注版本 v0.1.3（以目录页显示为准）。
一句话定位：让 DSH 侧边栏能展开、打开符号链接（含 Windows junction）；若链接目标落在当前工作区之外，需工作区处于已信任状态才会放行——与简介中 “targets outside the workspace gated by workspace trust” 的表述一致。
DSH 本身强调「一切皆插件」；SkillHub（skillhub.cn）是独立的社区插件目录，与 DeepSeek、幻方无官方从属关系，本文仅作技术介绍，不视为官方应用商店条目。
核心功能¶
依据目录页与注册表摘要，可核实的能力如下：
- 侧边栏穿透符号链接：在工作区文件树中，对 symlink 不再止于「看到一个链接项」，而是可以按目录方式展开、浏览其目标内容（具体交互以你安装的 DSH Web UI 为准）。
- 支持 Windows junction：除 Unix 风格符号链接外，涵盖 Windows 常用的目录 junction，便于在混合开发环境中保持同一套侧边栏行为。
- 工作区外目标受信任约束：链接指向工作区边界之外的路径时，需要工作区已被标记为信任（workspace trust），才会允许展开或访问，避免在不可信工作区里静默打开外部路径。
注册表 dsh.works 记录该包在 package.json 中声明了 dsh.bundle，并带有 ui 相关标签，说明其以 Web UI bundle 形式接入 DSH。GitHub 仓库 README 本次未能抓取，更细的 API、配置项请以仓库默认分支上的文档为准。
安装与启用¶
安装命令来自社区注册表 dsh.works 上已核对的 Install 段落（与 github:RicardoYan/dsh-symlink-passthrough 源一致）：
dsh plugin --profile web add "github:RicardoYan/dsh-symlink-passthrough"
说明：
--profile web表示将插件装入 Web UI 使用的 profile；若你使用其他 profile，需与本地 DSH 配置一致。- 该方式为 从 Git 安装源码，安装过程中可能执行依赖包的
prepare等脚本；注册表建议安装前阅读prepare脚本，并可用github:owner/repo#commit等形式固定 commit，避免远端默认分支后续变更。
安装后若侧边栏行为未变化，按你本地 DSH 插件管理习惯重启 Web 环境后再试（各版本 CLI 子命令以官方文档为准）。
典型用法¶
公开 README 未在本次资料抓取中取得，典型流程只能写到与简介直接对应的、可自检的步骤：
- 在工作区中保留或新建指向子目录、兄弟仓库或外部工具的符号链接或 junction（路径需在你本机真实存在）。
- 执行上文安装命令，确认 profile 为
web（或你实际使用的 UI profile）。 - 打开 DSH Web 侧边栏，定位到该链接节点，尝试展开并进入目标目录下的文件。
- 若链接目标位于工作区外，先在 DSH 中对当前工作区完成信任操作，再重复展开；未信任时应被拒绝，这与插件的安全设计一致。
无法在本文中给出仓库内的配置字段或代码示例；需要定制行为时，请直接查看 GitHub 仓库中的 package.json 与 bundle 入口。
适用场景与注意¶
适合谁
- 用 symlink / junction 组织代码、共享配置或挂载子项目，又希望在 DSH 侧边栏里一眼看到真实目录结构的开发者。
- 在 Windows 与 Linux/macOS 之间切换、junction 与 symlink 混用的团队。
使用前请注意
- 插件以当前 dsh 进程的权限运行，安装与加载 bundle 等同在本机执行第三方代码。安装前请阅读仓库源码、许可证与
prepare脚本，仅信任明确来源的 Git 地址。 - 从 Git 安装会在本机安装时运行构建脚本（注册表明确提醒：outside any sandbox）。生产或敏感环境建议 pin commit 并做 diff 审查。
- 工作区外路径依赖 workspace trust，不可在不可信仓库中指望插件绕过 DSH 的信任模型。
- 社区目录显示该仓库 0 星标（快照数据，会随时间变化），不代表质量结论，只说明关注度有限，更需自行审阅代码。
- dsh.works 记录曾对照 dsh
0.2.0-rc.2（2026-10-17）检查过安装路径；DSH 处于快速迭代期，manifest 与插件接口可能变化，升级 DSH 后请重新验证插件是否仍正常加载。
结尾¶
dsh-symlink-passthrough 解决的是侧边栏与符号链接之间的断层：在信任边界内展开链接与 junction，在工作区外则交给 workspace trust 把关。若你的布局大量依赖链接目录，值得一试。
- 社区目录页：https://www.skillhub.cn/plugins/RicardoYan/dsh-symlink-passthrough
- 源码仓库：https://github.com/RicardoYan/dsh-symlink-passthrough
- 安装路径参考（非官方注册表）：https://dsh.works/p/dsh-symlink-passthrough
