挂载清单 fuguangbeta/dsh-mounts

dsh-mounts

关于本工具 · About This Tool

dsh-mounts 是 DeepSeek Harness 的只读侧栏面板，把当前配置档的挂载内容归为五类，同页呈现。
面板不注册工具，不注入上下文，不写文件，不发起网络请求。安装不改变模型所见的提示词。

面板的用途限于确认配置内容，不判定其是否生效：补丁中存在 MCP 行，不代表对应进程正在运行；技能出现在列表中，不代表本轮已加载。

记忆库一栏只从各工作区内的 memory 目录发现（<工作区>/memory、.dsh/memory、.agents/memory）；都没有时该栏显示一行说明，不会隐藏。
DSH 不读取该目录；DSH 自动注入的内容为各工作区的 AGENTS.md 与 AGENTS.local.md，归入「预规定」一栏。

面板不读取文件内容。记忆库仅取 stat 元数据，技能仅取 frontmatter 中的 description。
查看正文使用每行的「打开」，交由系统默认程序处理；该操作使用 DSH 内置的 Session Remote，不可用时降级为「复制路径」。面板不修改任何文件，也不提供任何设置项。

如果你只是偶尔想确认一次配置，直接读配置档的 cordis.patch.yml 与各工作区的 AGENTS.md 也能得到同样的答案。这个面板的价值在于它常驻侧栏、随时可见，不必每次重新查一遍；配置频繁变动时，这一点有些用处。

这是 DeepSeek Harness 的只读侧栏面板。它把当前配置档的挂载内容分五组呈现在同一页上。
它不注册工具，不向上下文添加任何内容，不写文件，也不使用网络；安装它不会改变模型收到的提示词。
它的用途是报告配置了什么，而不是报告这些配置是否生效：补丁里有一行 MCP，并不意味着有进程正在运行；列出的技能也未必在本轮加载过。记忆库分组会在每个工作区内发现名为 memory 的目录（<ws>/memory、.dsh/memory、.agents/memory）；一个都找不到时会显示一行说明； DSH 不读取它，DSH 注入的是各工作区的 AGENTS.md 与 AGENTS.local.md 文件，在第一组中报告。文件内容从不读取：记忆库只做 stat，技能只贡献 frontmatter 里的 description 行。
读取文件通过 DSH 的 Session Remote 交给系统默认应用，并带有复制路径的降级方案。
面板不修改任何文件，也不提供任何设置项。

如果你只想偶尔检查一次配置，读配置档的 cordis.patch.yml 和各工作区的 AGENTS.md 也能得到同样的答案。这个面板的价值在于它常驻侧栏、保持最新，不必每次重新查一遍；配置经常变动时，这一点值得。

1. 界面 · Interface

1.1 初始状态 · Initial State

面板在打开时的状态：

挂载清单 [只读] [刷新]
这个 profile 实际挂载了什么：预规定 · 记忆库 · 技能 · MCP · 智能体预设

▸ 预规定 (1) ▸ 记忆库 (2 个工作区 · 15 个文件) ▸ 技能 (9) ▸ MCP 服务器 (3) ▸ 智能体预设 (5) 面板打开时的状态。五个栏目常显，无内容时展开可见一行说明。

1.2 记忆库展开至文件级

▾ 记忆库 (2 个工作区 · 15 个文件) ▾ my-app
AGENTS.md [自动注入] · 6 节 · [打开]
MEMORY.md · 6.7 KB · 2026-10-16 · [打开] overview.md · 12.9 KB · 2026-10-17 · [打开] …
▸ another-project

两图均为示意，数据非实测。未发现记忆库时，该栏显示一行说明，不隐藏。

1.3 栏目与数据来源

| 栏 | 来源 | 展开后 |
| 预规定 | 全局 ~/.dsh/AGENTS.md（每个会话都注入的那份） | 该文件的 ## 章节标题 |
| 记忆库 | 每个已注册工作区的 AGENTS.md / AGENTS.local.md（注入），以及 memory、.dsh/memory、.agents/memory 下的 .md（不自动读）；按工作区分组 | 规则文件章节数；记忆文件名、大小、日期 |
| 技能 | 全局：~/.dsh/skills、~/.agents/skills；工作区：每个已注册工作区的 <ws>/.dsh/skills、<ws>/.agents/skills | 描述全文、文件路径、来源 |
| MCP 服务器 | profile 补丁 + 全局补丁层中的 dsh-mcp-client 行 | 补丁行 id、env 变量名、目标、所属预设 |
| 智能体预设 | profile 补丁 + 全局补丁层中的预设行，以及内置的 standard、ptc、minimal、cordis | 补丁行、标题 |

2. 层级与展开

| 层级 | 触发 | 内容 |
| L1 | 打开面板 | 五个栏目标题及计数 |
| L2 | 点击栏目标题 | 该栏条目 |
| L3 | 点击条目 | 该条目自身的字段 |
| L3+ | 点击记忆库的工作区标题 | 该工作区的规则文件与记忆文件 |
| L4 | 点技能的工作区分组 | 该工作区的技能条目 |

初始状态停留在 L1。展开内容仅涉及被展开条目自身的字段。

3. 安装

3.1 安装步骤

需要 Creator 模式（cordis preset），该预设提供 plugin_manager。
1. 把本仓库放进任意工作区。可以 clone，也可以用 GitHub 的 Download ZIP；不需要 npm。
2. 调用 plugin_manager 的 install_bundle，target 指向本包目录的绝对路径。
3. 检查返回的 application 与 warnings。

profile 的 package.json 与 cordis.patch.yml 由 install_bundle 维护。手工修改，或在 profile 目录里执行 pnpm，都不符合官方流程。

需要开启 Creator mode（cordis 预设），因为它提供 plugin_manager。把仓库放进任意工作区，可以 clone，也可以用 GitHub 的 Download ZIP；全程不涉及 npm。调用 install_bundle，把 target 设为本包的绝对路径，然后检查返回的 application 与 warnings。profile 的 package.json 与 cordis.patch.yml 由 install_bundle 维护；手工修改它们，或在 profile 目录里执行 pnpm，都不符合官方流程。

3.2 代码改动生效方式 · Applying Code Changes

客户端依赖（client.js）改动后，硬刷新（Ctrl+Shift+R）即可生效。Host 侧依赖（index.js）改动后，需用 plugin_manager 把 include:mounts-panel 关→开，触发模块重新 import。

客户端改动（client.js）硬刷新（Ctrl+Shift+R）后生效。Host 侧改动（index.js）需通过 plugin_manager 把 include:mounts-panel 关→开，让模块重新 import。

4. 安全模型 · Security Model

- 不写文件，不启动子进程，不发起出站请求。（面板的配置写入见下一条，走 DSH 的配置服务，不直接写文件。）
- 只暴露一个 HTTP 端点 GET /dsh-mounts/api。
- 该端点只接受 loopback 的 Host 头（127.0.0.1、localhost、[::1]），其余返回 403，用来阻断 DNS rebinding。
- 只接受 GET 与 HEAD，其余返回 405。响应带 Cache-Control: no-store。
- 不接受 cwd 参数。
- 不返回文件内容：记忆库只做 stat，技能只取 frontmatter 的 description。

「打开」不新建端点，使用 DSH 现有的 Session Remote，路径由 Host 侧复核。

- 不写文件，不启动子进程，不发起出站请求。
- 只暴露一个 HTTP 端点：GET /dsh-mounts/api。
- 它只接受 loopback 的 Host 头（127.0.0.1、localhost、[::1]），其余返回 403，用来阻断 DNS rebinding。
- 它只接受 GET 与 HEAD，其余返回 405；响应带 Cache-Control: no-store。
- 它不接受 cwd 参数。
- 它不返回文件内容：记忆库只做 stat，技能只贡献 frontmatter 的 description。

「打开」不新建端点；它使用 DSH 现有的 Session Remote，路径由 Host 侧复核。

5. 已知限制 · Known Limitations

| 限制 | 说明 |
| 面板只读 | 不提供编辑、启停与删除 |
| 内置预设只能看到名称 | 其定义不在 profile 补丁里，面板读不到，因此不能展开 |
| 只识别名为 memory 的目录 | 不做模糊匹配 |
| 记忆库默认不包含任何目录 | 只从工作区内的 memory/ 发现 |
| 技能描述最多 1000 字 | 超出部分以省略号结尾 |
| 工作区取最近更新的一个 | 可能不是当前会话所在的工作区 |
| 不标示当前会话使用的预设 | 只列出已定义的预设，不判断哪一个正在生效 |
| 不列 bundle 内置技能 | 内置技能分散在各 bundle 内，无法统一枚举；只显示文件系统上的技能 |
| 工作区技能会列出所有工作区的 | 扫描范围是工作区注册表，不是当前会话；别的工作区的技能当前会话可能用不到 |
| 不自动读取 customSkillDirs | 该配置属于另一个插件 |
| 没有设置界面 | DSH 配置无法写入 include 插入的行；记忆库只从工作区 memory/ 目录发现 |
| 记忆库块同时列规则文件 | 二者都按工作区归属，但只有规则文件会被注入 |
| 「打开」在部分环境下降级为「复制路径」 | 属预期行为，点击后完整路径进入剪贴板 |

| 限制 | 说明 |
| 只读 | 不提供编辑、启停与删除 |
| 内置预设只显示名称 | 它们的定义不在配置档补丁里，面板读不到也展不开 |
| 只识别名为 memory 的目录 | 不做模糊匹配 |
| 记忆库默认为空 | 只从工作区的 memory/ 目录发现 |
| 技能描述上限 1000 字符 | 超长部分以省略号结尾 |
| 工作区取最近更新的那个 | 它未必是当前会话的工作区 |
| 会话正在使用的预设不做标记 | 只列出已定义的预设，不判断哪个在用 |
| bundle 内嵌技能不列出 | 它们分散在各个 bundle 里，无法统一枚举；只显示文件系统上的技能 |
| 工作区技能覆盖所有工作区 | 范围是工作区注册表，不是当前会话；别的工作区的技能在这里可能用不了 |
| 不自动读取 customSkillDirs | 该设置属于另一个插件 |
| 没有设置界面 | DSH 设置写不了 include 插入的行；记忆库只来自工作区 memory/ 目录 |
| 记忆分组里也列出指令文件 | 两者都按工作区分组，但只有指令文件会被注入 |
| 部分环境下「打开」退化为「复制路径」 | 预期行为；点击后完整路径进入剪贴板 |

6. 开发 · Development

文件结构见 §7。

读盘文本先做 \r\n? 到 \n 的规范化。CRLF 的 SKILL.md 会使 frontmatter 解析静默失败， description 退化为空字符串。

Text read from disk is normalised from \r\n? to \n first. A CRLF SKILL.md makes
frontmatter parsing fail silently and the description degrade to an empty string.

如需注入配置，可直接改本 bundle 的 cordis.patch.yml 的 config（仅对本机安装有效，不建议提交）。

To inject configuration, edit the config of this bundle's own cordis.patch.yml
(local installs only; not recommended for commits).

7. 文件结构 · File Structure

dsh-mounts/
├── package.json # 包清单、dsh.bundle 与 dsh.client · Package manifest ├── cordis.patch.yml # 单条 insert：mounts-panel · Bundle patch ├── index.js # Host 半：只读扫描与 GET /dsh-mounts/api · Host half ├── client.js # Web 半：侧栏一级面板与 main keyed 槽 · Client half ├── locale/ # 面板标题与描述的中英文案 · Panel title and description │ ├── zh.json │ └── en.json ├── icon.svg # 插件图标 · Plugin icon ├── README.md # 本文件 · This file ├── CHANGELOG.md # 更新日志 · Changelog └── LICENSE # MIT · MIT

系统要求 · System Requirements

| 项 | 要求 |
| DSH | >= 0.2.1-rc.2 |
| 安装 | Creator 模式（cordis preset） |
| 日常使用 | 不要求 Creator 模式 |
| 客户端服务 | remote、remote.session、connection、locale |
| 平台 | Windows 已验证，其余未测试 |
| 第三方依赖 | 无 |

| Item | Requirement |
| DSH | >= 0.2.1-rc.2 |
| Installation | Creator mode (the cordis preset) |
| Everyday use | Creator mode not required |
| Client services | remote, remote.session, connection, locale |
| 平台 | Windows 已验证；其他平台未测试 |
| 第三方依赖 | 无 |

常见问题 · Frequently Asked Questions

安装后侧栏没有「挂载清单」。 确认 install_bundle 返回的 application 为 applied。若已应用仍不可见，先硬刷新（Ctrl+Shift+R）；无效则重启 DSH。

改动代码后界面无变化。 参见 §3.2。

显示的工作区与当前会话不符。 面板取注册表中最近更新的工作区，没有会话级绑定，见 §5。

「打开」显示为「复制路径」。 该页面无法取得 Session Remote，属预期降级。点击后完整路径进入剪贴板。

为何不提供正文预览。 正文预览需要在端点中开放文件读取，而该端点仅以 Host 头作准入控制，不做会话鉴权。故仅提供「打开」。

安装后侧栏没有「挂载清单」。确认 install_bundle 返回 application: applied。若已应用仍不可见，先硬刷新（Ctrl+Shift+R）；无效则重启 DSH。

改动代码后界面无变化。参见 §3.2。

显示的工作区与当前会话不符。面板取注册表中最近更新的工作区，没有会话级绑定。见 §5。

「打开」显示为「复制路径」。该页面无法取得 Session Remote，属预期降级。点击后完整路径进入剪贴板。

为何不提供正文预览？正文预览需要在端点中开放文件读取，而该端点仅以 Host 头作准入控制，不做会话鉴权。故仅提供「打开」。

许可 · License

MIT，见 LICENSE。MIT, see LICENSE.

反馈 · Feedback

问题请提交 issue，附 DSH 版本与复现步骤。
请提交 issue，附 DSH 版本与复现步骤。