【插件开发】有关web插件配置的问题

[Smalldy]

官方提供了三个配置卡片 可以方便的对官方插件进行各种配置
请问我们自己开发的插件能够接入这个机制呀 对于用户来说 能不去直接改配置文件是最好的体验了
目前我没发现官方提供的机制 可以接入可这卡片设置插件的一些属性的任何方法

[ciceroyang]

能接,机制是开放的,只是官方教程还没写透。设置卡片的底层是 settings 域的 slot 体系(dsh-client-ui-settings):

• 注册面:ctx.settingsScope.bind(spec) 绑定你插件的命名空间,slot 类型里有 settings.section(每个功能一页)和 settings.plugins.tab(插件区里功能自有的页)——第三方插件注册的入口就是这两个
• 渲染面:dsh-client-schema-form 负责把 host 侧的 Config schema(schemastery)变成表单;写入走 Host transport,持久化到 settings.yaml(dsh-settings host 侧)
• 第三方完整接入 = 两半:host 插件定义 Config schema + client 插件(package.json 里 dsh.client 声明,web 平台,注入 connection/settingsScope)注册 section/tab 并用 SchemaForm 渲染

可抄的实现:

1. 官方 dsh-client-ui-plan-execute(设置页里给 plan/execute 加设置行的最小结构)
2. 社区 dsh-custom-css(粘贴 CSS 即时生效、持久化 settings.yaml 的完整链路)

两个坑提前说:

• settings RPC 是 loopback-only(README 明文):远程浏览器里这些设置页直接不可用,别指望局域网配置
• host Config 记得用 schemastery Schema 而不是手写校验,否则表单生成不出来

如果社区需要,我可以把这个"设置卡片"模板加进 dsh-plugin-starter 脚手架(host Config + client section + SchemaForm 三件套),让新插件开箱带设置页。

[ciceroyang]

兑现上一条的承诺:dsh-plugin-starter 已随 030fb16 发布源码级设置卡片指南。

• 指南:https://github.com/ciceroyang/dsh-plugin-starter/blob/main/docs/settings-guide.md(机制总览 / host 半免构建 / client 半 tsdown / 四个坑)
• host 示例:https://github.com/ciceroyang/dsh-plugin-starter/blob/main/examples/settings-host-config.js(schemastery Config 骨架)

关键结论供你直接判断:

1. host 半现在就能做(纯 JS + Schema)
2. client 半要 tsdown + React(slot 注册形态照官方 ui-settings-models 抄,我已把最小结构提炼进指南)
3. settings RPC 是 loopback-only——远程浏览器的设置页不可用(和 [Bug] 通过局域网 IP 访问 dsh web 时，/api/host.listDirectory 返回 HTTP 403 #1733 是同一个护栏)

等 rc 期 settings 注册面稳定后,我会把 client 侧做成 --with-settings 模板内建进脚手架。

[ciceroyang]

dsh-plugin-starter 3ba820d 已发布 --with-settings 变体:设置卡片 client 模板内建。

• 生成内容:client/index.tsx(settings.section 注册 + 最小表单,描 settings.describe → 写 settings.update 的数据通路)+ dsh.client manifest + tsdown 构建脚本/依赖
• 用法:node generator.mjs my-plugin --with-settings,之后 pnpm install && pnpm build
• 边界照旧:render thunk 的注入面按官方 ui-settings-models 抄结构,适配 rc 版差异;settings RPC loopback-only,远程浏览器无设置页
• 7/7 测试,CI 四版本

加上此前的 host 示例(examples/settings-host-config.js)和源码级指南(docs/settings-guide.md),host/client/构建三件套齐了。有需要调整的点欢迎直接提 issue。

[leon7786]

有个可能不算bug的bug，这里简单反馈下吧

npm安装命令 ，ubuntu 提示bug ，cc审查：
问题确认了：系统的 node-gyp（apt 包）缺失核心的 Python 库（gyp 模块），这是 Ubuntu 24.04 上这个包的已知 bug。修复方法是用 npm 装一个完整的 node-gyp 并让 npm 使用它

[ciceroyang]

这个不是 DSH 的 bug,是 Ubuntu 24.04 的 apt 版 node-gyp 缺 Python gyp 模块的已知问题(DSH 依赖的原生模块需要 node-gyp 参与安装)。

修复两步:

# 1. 补齐编译与 Python 依赖(最常缺的就是这个)
sudo apt install -y python3 make g++
# 2. 用 npm 的完整版 node-gyp 替代系统包
npm install -g node-gyp

然后重新执行你的安装命令即可。若还报同样的错,加 --foreground-scripts 看完整编译日志,把 gyp 的具体报错贴出来可以继续定位。

顺带:装完可以跑一下社区体检工具 dsh-doctor(https://github.com/ciceroyang/dsh-doctor),node/pnpm/编译环境类问题它会直接给出可执行的修复建议。

[leenkcool]

我是插件库，我感觉你的插件很好，我想收录，可以提ISSUE。 具体提的方法如下。
#4456