zhu1090093659/dsh-presets

@linxin666/dsh-client-ui-preset-center

DSH Web GUI 的社区 agent 预设管理器：创意工坊的预设面板，以及负责安装、声明、停用、卸载从 dsh-market.com 下载的预设的 host 侧库。预设只有被本插件声明进 agent-preset 注册表后才会出现在设置 → Agent 预设；其余都留在创意工坊。

本仓同时拥有插件与 presets/ 下的社区预设目录。预设以 PR 形式投稿，投稿清单与评审规则见 CONTRIBUTING.md。

能力

- 在创意工坊商店卡新增预设标签页（通过卡片声明的 dsh-workshop.panel 子槽位注入），列出社区目录，带安装状态、版本更新提示与安装计数。
- 把预设安装到惰性库 $DSH_HOME/agent-presets//。没有任何东西扫描该目录：harness 不再从磁盘发现预设，因此下载下来的组合不会自行加载。
- 把已安装预设声明给 ctx.agentPresets（@deepseek-ai/dsh-agent-preset-registry）。host 半区从 preset.yml 读显示文案、从 agent.cordis.yml 读子插件行，然后调用 register，因此已声明的预设无需重启 dsh web 就能立即组合新会话。停用会撤回声明，卸载会撤回声明并删除库目录。
- 显示由已安装字节算出的组合画像——组合挂载的插件名、是否携带本地代码文件或 !!js 表达式——并在声明任何可执行内容前要求显式确认；声明前可用只读查看器阅读 agent.cordis.yml。
- 拒绝 id 已被其它声明占用的预设（注册表会拒绝重复 id，声明看起来成功却毫无效果），也拒绝停用或卸载注册表当前默认值指向的预设（默认值指向不存在的预设会让每个新会话创建失败）。
- 每次读取状态都校验市场 provenance：逐文件 sha256 锚定 https://dsh-market.com，因此本地改动过的预设会被标为「本地已修改」，更新也绝不静默覆盖它。

人气预设

dsh-market.com 创意工坊预设目录里人气最高的三个预设，按网站默认的「按人气」排序——三者都由本仓的 presets/ 发布：

| 预设 | 作者 | 剧情 |
|---|---|---|
| 角色扮演 · 乔柚柚（roleplay-qiaoyouyou） | dongshuyan | 与民办幼儿园老师乔柚柚对话：活泼开朗，带班哄孩子一把好手。全年龄向沉浸式角色扮演 |
| 角色扮演 · 谢晚舟（roleplay-xiewanzhou） | dongshuyan | 与互联网公司后端工程师谢晚舟对话：上班理性话少，下班宅家看番。全年龄向沉浸式角色扮演 |
| 角色扮演 · 苏绵绵（roleplay-sumianmian） | dongshuyan | 与重点大学经管系大一学生苏绵绵对话：呆萌的富家千金，从小被保护得很好。全年龄向沉浸式角色扮演 |

安装

dsh plugin --profile web add @linxin666/dsh-client-ui-preset-center

创意工坊卡片（@linxin666/dsh-client-ui-market）声明面板槽位并负责下载；没有它时 host 路由仍可用，但没有面板驱动。两者都在 @linxin666/dsh-web-all 聚合包内。

配置

无。面板是唯一界面，所有行为都由目录清单、库目录与实时声明推导。插件不注册设置命名空间，也不向 agent 系统提示注入任何内容。

安全模型

预设是代码，不是资源：它的组合可以引用 npm 插件、加载随预设目录分发的文件，并在 DSH 主进程内求值 !!js 表达式——全部发生在它被声明之后。harness 对此的表述很直白：预设拥有与 shell 访问同等的信任。因此本插件从不把「下载」当作「运行」：

- 下载是惰性的。 市场安装器写入 $DSH_HOME/agent-presets//，没有任何发现根扫描它。插件加载时也不声明任何预设。
- 声明才是授权边界。 声明会把组合注册进注册表，注册表随即在主进程内急切挂载它的行。只要组合携带本地代码、相对路径行或内联表达式，面板就要求显式确认，并展示这些内容是什么。
- 声明前校验、失败回滚。 id 会与实时 roster 比对；roster 报告为 broken 的预设会被注销并显示原因，而不是留在半声明状态。
- provenance 是完整性锚。 每次读取都重新校验市场记录的逐文件 sha256；不匹配会被报告，绝不静默修复。
- 路由仅限 loopback。 /api/preset-center/* 只应答 loopback 请求，与市场网关同一道栅栏，远程浏览器无法驱动该库。
- 未托管目录不可触碰。 没有市场 provenance 的预设（自建或由其它工具安装）会被标注，并被卸载拒绝。

已知限制

- 声明不是沙箱。 确认与组合画像降低的是误操作风险，并不能让不可信预设变安全。发布环节的人工审查才是真正的控制点。
- 声明随 host 进程存续。 插件加载时不声明任何预设，因此 dsh web 重启后每个已安装预设都回到惰性状态，需要在创意工坊里逐个点击启用。若把启用状态持久化，重启就会成为下载内容自动生效的时刻，而那正是本面板要收集的授权。
- 官方设置分区可能滞后。 它只在自身动作、settings/document-updated 与 connection/reset 时重读，因此在创意工坊声明的预设可能需要刷新页面才出现在设置 → Agent 预设；新建会话会立即看到它。
- 运行中的会话保留原预设。 会话的组合在创建时固定，停用或卸载不会改变正在使用它的会话。
- 组合子集刻意收窄。 组合由只读懂预设所用 YAML 的读取器解析（块映射与块序列、引号与普通标量、字面块与折叠块、!!js），遇到其它构造——锚点、别名、流式集合、额外标签——一律拒绝而不是猜测。被拒绝的组合会被如实报告，并保持未声明。
- 目录内容取决于被钉扎的那份 catalog。 本仓的 presets/catalog.json 是发布源；dsh-web 的市场构建按 submodule 钉扎的提交读取它，因此合并的预设要等该钉扎前移才到达用户。贡献格式与投稿必须附带的证据见 CONTRIBUTING.md 与 presets/README.md。

架构

- src/index.ts —— host 半区：持有实时声明，每进程挂载一次 loopback 网关。
- src/routes.ts —— GET /api/preset-center/state、GET /api/preset-center/composition?id=、POST /api/preset-center/{install,disable,uninstall}；唯一读取 roster 的层，因此保留 id 与默认预设两条策略在这里。
- src/host/declarations.ts —— 注册表声明：安装时注册，停用/卸载与插件卸载时注销。
- src/core/paths.ts —— 库路径契约与预设 id 规则。
- src/core/library.ts —— 库状态：扫描、由声明推导的 enabled 标志、卸载。
- src/core/yaml.ts —— 组合读取器（fail-closed 的 YAML 子集，!!js 保留为数据）。
- src/core/definition.ts —— 由已安装字节读出的注册表定义。
- src/core/provenance.ts —— 市场 provenance 读取与逐文件校验。
- src/core/profile.ts —— 组合画像。
- src/client/PresetPanel.tsx —— 创意工坊卡片渲染的面板。
- presets/ —— 创意工坊「预设」类目的发布源（catalog 加每个预设一个目录），由 dsh-web 的市场构建按 submodule 钉扎的提交读取。

库路径是跨包契约：市场安装器把 preset 资产写进 $DSH_HOME/agent-presets//，两个包互不 import；路径名与 dsh-market.provenance.json 格式是镜像常量，与皮肤中心镜像市场 provenance 的方式一致。