前言¶

DSH 的设置入口通常是一个表单；在插件化扩展场景里，开发者还需要浏览已注册设置命名空间、查看挂载插件的 composition 配置，并对部分配置文件做受控编辑。dsh-settings-plus 面向这个缺口：它给 DeepSeek Harness 提供表单级和文件级的设置管理能力，并提供一套供其他插件注册设置命名空间的 SDK。

这是什么¶

dsh-settings-plus 是一个 MIT 许可的 DSH 插件。资料中名称大小写存在不一致：GitHub/catalog 线索为 oneinitAI，package scope 为 @oneinitai。

它是一个独立插件包，安装方式是 file: bundle 安装到 DSH profile，不是宿主源码或构建输入。

核心能力¶

宿主扫描¶

插件会从 live cordis registry 中枚举已注册设置命名空间，以及已挂载插件的 composition 配置。

默认只读：crawler 不写，文件浏览只枚举和校验。

表单级编辑¶

插件通过 settings.section contributions 和 schema form renderer 提供表单级编辑。

secret 保留在 host seam；placeholder 不随数据传播，redaction 发生在 schema walk。

文件级编辑¶

插件可以编辑可写的 $DSH_HOME 根 YAML 文件和 per-profile cordis*.yml。

写入路径使用原子写，并受 expected-version guard、byte caps 和 realpath boundary 保护。

开放注册 SDK¶

其他插件可以注册自己的设置命名空间，入口包括：

registerUserSettings
defineSettingsSection
settingsNamespace

这些接口用于把插件设置挂到宿主设置面上；secret 不进入插件本地，仍由 host seam 处理。

安装与启用¶

先做安装。使用 file: 方式把仓库目录装入指定 DSH profile：

dsh plugin --profile <name> add file:/<repo-dir>/dsh-settings-plus

这条命令把当前仓库作为 file: bundle 安装，不是把源码纳入 DSH 构建。

再做启用。安装后启动该 profile。包清单声明 dsh.bundle.patch（cordis.patch.yml），用于把插件相关配置组合到当前 profile 运行时。

典型用法¶

下面是已核实资料中可确认的操作顺序：

1、安装插件：

dsh plugin --profile <name> add file:/<repo-dir>/dsh-settings-plus

2、启动 profile，让 dsh.bundle.patch 生效。

3、在设置面浏览已注册设置命名空间和挂载插件的 composition 配置。

4、需要修改时，按能力边界选择：
- 表单级编辑走 settings.section 与 schema form renderer；
- 文件级编辑走可写的 $DSH_HOME 根 YAML 文件和 cordis*.yml。

5、其他插件如果要暴露自己的设置，使用：

registerUserSettings
defineSettingsSection
settingsNamespace

适用场景与注意¶

适合已经在 DSH profile 中维护多个插件、需要统一查看和编辑设置与 composition 配置、或者希望第三方插件能注册设置命名空间的场景。

注意：

• 插件以当前 dsh 进程权限运行；安装前应检查源码、许可证和安装路径。
• 许可证为 MIT；package.json 声明 version 0.0.1 且 private true。
• 默认只读。crawler 不写；文件浏览只枚举和校验。
• plain cordis.yml composition rows 不能通过服务写；需要时用 file surface 或 cordis.patch.yml 处理。
• 插件不拥有 watcher；宿主会热加载 cordis.patch.yml 和 settings.yaml。
• 写入受 expected-version guard、byte caps 和 realpath boundary 保护。
• 资料中名称大小写不一致：GitHub/catalog 线索为 oneinitAI，package scope 为 @oneinitai。本文按已给出的安装命令和 GitHub 地址书写。

链接¶

• GitHub：https://github.com/oneinitAI/dsh-settings-plus
• 目录页线索：https://www.skillhub.cn/plugins/oneinitAI/dsh-settings-plus（该地址来自插件线索，未在已核实资料中确认）