DSH Prompt Assembler
English · 安装 · 使用 · 来源接入合同 · 安全边界
新版仅支持标准版公开接口。进阶扩展冻结在 Assembler 1.1.0 / DSH 0.2.0-rc.2，不承诺后续 DSH 适配，不随新版发布核心改动。
dsh-prompt-assembler 1.1.3 是面向 DSH 0.2.1-rc.2 / 0.2.1-rc.3 的独立提示词装配插件，也提供可组合的装配库。插件自己管理策略存储、来源注册、请求钩子、安全 API 和界面；无需安装 Tavern 或 Memory Manager。来源继续拥有正文、资源、解析语法与读取权限，DSH durable history 继续作为会话历史的权威记录。
兼容范围：>=0.2.1-rc.2 <0.2.2-0。已验证 DSH rc.2 与 rc.3；范围内后续 RC 和正式版按策略允许加载，不表示已经逐版验收。0.2.2 及其预发布需重新评估。
快速开始 / Quick start
准备已可运行的 DSH 0.2.1-rc.2 / 0.2.1-rc.3 Host，使用 Node ^22.19.0 || >=24。以下流程使用标准版，无需 Tavern、Memory Manager 或 core addon。
- 在 DSH 的 插件 → 添加插件 中输入以下 Release 附件直链，安装并启用独立 Assembler。
https://github.com/Player-MINEPIG/dsh-prompt-assembler/releases/download/v1.1.3/dsh-prompt-assembler-1.1.3.tgz
- 重新启动 Host，打开一个会话，再进入 插件 → 已安装插件 → dsh-prompt-assembler → 配置当前会话。尚未发送第一条消息的空白会话也可使用。
- 在策略库点击 创建，填写名称，接入方式选择 标准版 · 官方接口。保留“官方基础指令、原生历史、本步输入”；展开 来源、文本与投递设置，选择“DSH 自定义文本”解析器并点击 添加自定义文本，例如填写“请用简洁中文回答。”，角色保持
user。 - 点击 装配结果 检查正文、角色和排列。预览不会发送请求，也不包含输入框中的待发送内容。
- 点击 保存并应用到当前会话，确认“当前应用”显示该策略，再回到聊天发送消息。若要从新会话开始，改用 使用此策略新建会话 并选择工作区；策略会先绑定再打开会话。
保存规则 只更新策略库；修改后须重新应用才影响后续请求。安装本身不应用策略，没有全局默认策略。完整操作见使用说明；标准历史清理的轨迹显示限制见已知缺陷。
v1.1.3 Release 提供预构建 .tgz，通过 GitHub 安装不需要先发布 npm 包。GUI 接受附件直链，不接受 Release 网页地址，也不会从仓库地址自动寻找附件。源码安装可使用 github:Player-MINEPIG/dsh-prompt-assembler#v1.1.3；#main 仅用于跟随开发。标准安装、升级与旧进阶版边界见安装说明。进阶策略要求可选 addon 与准备后的协议 1 核心，缺任一返回 409，见两种后端。纯装配库需要 Node >=20。
来源与第三方扩展
flowchart LR
Host[DSH Host] --> Plugin[Assembler 插件]
Plugin --> Store[策略存储与界面]
Plugin --> Registry[来源注册与装配]
Registry -.公开只读对象.-> Sources[DSH / Tavern / Manager / 第三方来源]
插件公开 Host 服务 dshPromptAssembler，提供 version、store、runtime、registry、strategies、registerPresets(definition)、attachTavern(options) 和 migrateLegacy(root)；共享来源服务为 dshPromptSources，排序服务为 dshPromptStrategies。Tavern adapter 接收来源拥有的公开只读对象，assembler 不依赖 Tavern/Manager 包或其内部文件。第三方用现有 registry API 注册动态模块或自定义文本解析器，无需修改装配核心；未选择的来源不会自动注入。
Tavern 3.1.5 与其他共享消费者在同一 profile 使用这一个独立实例。Tavern 的 Assembler peer 范围为 ~1.1.3，不再内嵌或启动另一份运行时。移除 Tavern 保留 Assembler；停用 Assembler 会使要求该服务的消费者等待服务恢复。首次安装先安装并启用 Assembler，再安装业务插件。
来源接入合同 和运行示例说明注册、取消、读取租约、预览和来源卸载的行为。进阶装配快照保留完整请求内容与 provenance；标准版使用原生事件与正文引用。来源卸载后不会改写 DSH 原生历史。迁移旧 assembly-presets.json 保留原文件与旧 mode scope，由 assembler 自己的存储接管后续修改。卸载插件保留 DSH durable history 和策略存储。
作为库组合
import { createDshRegistry, assembleRequestAsync, BUILTINS } from 'dsh-prompt-assembler'
const registry = createDshRegistry()
const result = await assembleRequestAsync({ registry, preset: BUILTINS[0], nativeMessages, inputIds })
根导出保持可组合库 API，同时导出 Host 插件的 name、inject 和 apply，供 DSH loader 按 package exports 加载；package main 为 src/plugin.js，dsh-prompt-assembler/plugin 是显式 Host 插件入口，dsh-prompt-assembler/client 是浏览器入口。dsh-prompt-assembler/panel 仍提供可嵌入视图；自行组合 HTTP factory 的调用方须负责认证和安全 fetch。
开发与验证
npm ci
npm run check
check 覆盖本地测试、客户端构建与包内容检查。CI 在库支持的 Node 版本执行上述命令。Host 测试显式区分 stock 与准备后的 rc.2 核心；默认测试的跳过项不代表 Host 或浏览器验收通过，详见验证说明。当前版本见变更记录。
第三方接入指南 · HTTP API · 架构与交互图。
第三方排序算法、插槽来源和可撤销预设目录见开发者指南；内置与扩展算法使用同一 registry。
