提示词装配器 Player-MINEPIG/dsh-prompt-assembler

DSH 提示词装配器

English · 安装 · 使用 · 来源接入合同 · 安全边界

dsh-prompt-assembler 0.2.0 是独立提示词装配插件，面向 DSH 0.2.0-rc.2，也提供可组合的装配库。插件自己管理策略存储、来源注册、请求钩子、安全 API 和界面；无需安装 Tavern 或 Memory Manager。来源继续拥有正文、资源、解析语法与读取权限，DSH durable history 继续作为会话历史的权威记录。

安装与使用

真实 DSH Host 需要 Node ^22.19.0 || >=24；纯装配库需要 Node >=20。

dsh plugin --profile web add github:Player-MINEPIG/dsh-prompt-assembler#main

仓库为 public；GitHub 源码、npm 与公开目录是独立分发途径。标准 bundle 使用已构建客户端，安装时不编译源码。

在侧栏打开「当前会话」的装配界面，包括第一条消息之前的空白会话；策略库也始终可从侧栏打开。选择已有会话并应用策略，或在策略库用该策略创建会话：创建操作先绑定策略，再打开新会话。没有全局默认策略，也不会因安装插件或注册来源而隐式应用策略。

标准策略通过公开接口在 stock rc.2 执行。进阶策略明确要求可选 addon 与准备后的协议 1 核心；缺任一返回 409。见两种后端与安装。

来源与第三方扩展

flowchart LR
Host[DSH Host] --> Plugin[Assembler 插件]
Plugin --> Store[策略存储与界面]
Plugin --> Registry[来源注册与装配]
Registry -.公开只读对象.-> Sources[DSH / Tavern / Manager / 第三方来源]

插件公开 Host 服务 dshPromptAssembler，提供 store、runtime、registry、attachTavern(options) 和 migrateLegacy(root)；共享来源服务为 dshPromptSources。Tavern adapter 接收来源拥有的公开只读对象，assembler 不依赖 Tavern/Manager 包或其内部文件。第三方用现有 registry API 注册动态模块或自定义文本解析器，无需修改装配核心；未选择的来源不会自动注入。

来源接入合同 和运行示例说明注册、取消、读取租约、预览和来源卸载的行为。进阶装配快照保留完整请求内容与 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 · 架构与交互图。