前言¶

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（該地址來自插件線索，未在已覈實資料中確認）