四、配置

配置落在插件 Loader 行的 config: 上。默认值写在插件自带的 cordis.patch.yml 里，也可以写在 profile 的 patch 层里。

字段	类型	默认	含义
`progressSources`	`string[]`	`[]`	进度源路径（绝对路径）。目录浅扫描一层
`pollIntervalMs`	`number`	`1500`	客户端拉取间隔，钳制在 500–60000

- id: download-progress
  name: dsh-download-progress
  config:
    progressSources:
      - 'D:\字体_进度.md'
      - 'D:\downloads\progress'
    pollIntervalMs: 1500

改了必须重启 DSH。 配置在插件装载时被读一次并收窄；改了 config 会让 Loader 重挂这一行，正在跑的 host 半边不会热更新。

关于「设置页里的表单」

ctx.settings.register(ns, schema) 在 DSH 0.1.7 起已经整体删除。替代品是宿主 SettingsForms：命名空间 = 插件 Loader 行的 entry id（这里是 download-progress），表单 schema = 插件模块导出的 Config。本插件照这条规则导出了 Config，Loader 的装载期校验认它。

代价说清楚：Config 用的是 Standard Schema 形状，不是宿主内建的 schemastery 形状。前者能被 Loader 正常校验（插件照常装载、config 照常生效），但宿主设置页不会为它生成自动表单——Inspect 的 Config 通道里本条目显示 unsupported。

不换 schemastery 的原因是硬约束：host 产物零 import / 零 require，而 @deepseek-ai/schemastery 在 link: 安装下从插件目录解析不到（Node 走软链 realpath，往上没有 node_modules/@deepseek-ai）。两者不可兼得，这里选了"插件一定能装上"。

dsh-download-progress

同名パッケージの別リポジトリ

インストール

ドキュメント

四、配置

关于「设置页里的表单」