前言¶
在 DSH 里发一条消息之前，Host 会把系统指令、历史消息和当前输入拼成一次 LLM 请求。若只靠 Host 默认行为，很难在同一工作区里为不同会话选用不同的指令组合、来源片段和排列方式；把逻辑写进独立脚本又容易和 DSH 的 durable history 脱节。
dsh-prompt-assembler 是 Player-MINEPIG 维护的独立 DSH 插件（分类：工作流），在 Host 内提供策略库、来源注册与请求装配，并支持按会话绑定策略。来源仍各自持有正文与读取权限，DSH durable history 仍是会话历史的权威记录；无需安装 Tavern 或 Memory Manager 即可走标准版流程。
这是什么¶
插件全名 dsh-prompt-assembler，当前资料中的版本为 1.1.1，面向 DSH 0.2.1-rc.2。README 说明新版仅支持标准版公开接口；进阶扩展冻结在 Assembler 1.1.0 / DSH 0.2.0-rc.2，不承诺后续 DSH 适配。
除 Host 插件外，同一 npm 包也导出可组合的装配库 API，供在 Node 环境中自行注册来源并调用 assembleRequestAsync。
核心功能¶
策略与按会话应用¶
插件自行管理策略存储、界面与「保存并应用到当前会话」。保存规则只更新策略库；修改后须重新应用才会影响后续请求。安装本身不应用策略，也没有全局默认策略。
来源注册与装配¶
插件通过 Host 服务 dshPromptAssembler 暴露 store、runtime、registry、strategies 等能力；共享来源服务为 dshPromptSources，排序服务为 dshPromptStrategies。第三方可用 registry API 注册动态模块或自定义文本解析器，未选择的来源不会自动注入。
标准版使用原生事件与正文引用；来源卸载后不会改写 DSH 原生历史。卸载插件会保留 DSH durable history 和策略存储。
标准版与可选进阶¶
快速开始文档面向标准版，无需 Tavern、Memory Manager 或 core addon。进阶装配快照等能力要求可选 addon 与准备后的协议 1 核心，缺任一会返回 409，详见仓库内 docs/BACKENDS.md。
作为库组合¶
纯装配库场景需要 Node >=20。根导出示例：
import { createDshRegistry, assembleRequestAsync, BUILTINS } from 'dsh-prompt-assembler'
const registry = createDshRegistry()
const result = await assembleRequestAsync({ registry, preset: BUILTINS[0], nativeMessages, inputIds })
安装与启用¶
准备已可运行的 DSH 0.2.1-rc.2 Host，Node 版本为 ^22.19.0 || >=24。以下命令中的 web 需替换为实际使用的 profile。
- 停止目标 Host，安装插件：
dsh plugin --profile web add dsh-prompt-assembler@1.1.1
- 重新启动 Host。
源码安装可使用 github:Player-MINEPIG/dsh-prompt-assembler#v1.1.1；跟随开发主线可改用 #main。标准 bundle 使用已构建客户端，安装时不编译源码。详细边界见仓库 docs/INSTALLATION.md。
典型用法（标准版）¶
- 打开一个会话（空白会话亦可），进入 插件 → 已安装插件 → dsh-prompt-assembler → 配置当前会话。
- 在策略库点击 创建，填写名称，接入方式选择 标准版 · 官方接口。保留「官方基础指令、原生历史、本步输入」。
- 展开 来源、文本与投递设置，选择「DSH 自定义文本」解析器并 添加自定义文本，例如填写「请用简洁中文回答。」，角色保持
user。 - 打开 装配结果 检查正文、角色和排列。预览不会发送请求，也不包含输入框中的待发送内容。
- 点击 保存并应用到当前会话，确认「当前应用」显示该策略，回到聊天发送消息。若要从新会话开始，可使用 使用此策略新建会话 并选择工作区。
完整操作见仓库 docs/USAGE.md；标准历史清理的轨迹显示限制见 docs/HISTORY_POLICY.md。
适用场景与注意¶
适合谁： 需要在 DSH 内用可视化策略库管理提示词片段、按会话切换装配方案，或希望在同一 Host 上扩展来源而不改装配核心的开发者。
运行与安全： 插件以当前 DSH 进程的权限运行；安装前应阅读仓库源码与 SECURITY.md，并确认许可证（package.json 为 MIT）。自行组合 HTTP factory 的调用方须负责认证和安全 fetch。
生态说明： DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；GitHub、npm 与公开目录为独立分发途径。
