NelsonLongxiang/dsh-prompt-templates

@nelsonlongxiang/dsh-prompt-templates

npm

为 DeepSeek Harness 提供的快捷提示词模板：支持全局和按会话的模板、右侧浏览器面板，以及通过 node:sqlite 实现的纯 TS SQLite 持久化——一个自包含插件，可用 dsh plugin 安装。

模板面板

安装

dsh plugin --profile web add @nelsonlongxiang/dsh-prompt-templates

重启 dsh web，然后在输入框工具栏中寻找模板按钮。

无需 Python 工具链——自 0.3.0 起，宿主端通过 node:sqlite（Node ≥ 24）直接在宿主进程内持久化模板，读写与原先 Python 子进程相同的 $DSH_HOME/ext/prompt-templates/db.sqlite3（零数据迁移）。

功能特性

- 全局 + 按会话模板——全局模板适用于所有场景；会话模板仅对单个对话私有，并可一键提升为全局
- 插入或发送——一键将模板追加到草稿中；立即发送会马上派发；编辑、删除和设为全局都位于该行中
- 搜索与滚动——输入时筛选列表，长列表也能可靠滚动
- 拖动重新定位，双击重置——面板会记住你放置的位置
- 持久化设计——模板通过宿主插件拥有的纯 TS 存储（node:sqlite）持久化到 SQLite，并随其生命周期关闭

工作原理

src/                  TypeScript 插件（宿主端 + 浏览器端）
index.ts            宿主：拥有 TS 存储，暴露 HTTP 路由
store.ts            基于 node:sqlite 的纯 TS 模板存储
client/             浏览器：注册到 shell.overlay 和
conversation.input.right 的面板 UI
cordis.patch.yml      捆绑补丁：挂载插件行

存储是宿主端内部的纯 TS；不会生成子进程。

安全性

- 模板内容仅作为用户选择插入的普通用户文本到达模型请求——不会自动注入任何提示词
- 面板仅通过宿主的插件路由与宿主存储通信；没有额外的监听器，也没有出站网络

数据库同步 CLI

该包附带一个确定性的、仅限本地的 CLI，用于跨 DSH home 比较和合并提示词模板数据库。它从不直接写入远程数据库。

导出 schema-v2 快照（规范顺序 + data_sha256）
dsh-prompt-templates export --db /path/to/db.sqlite3 --out snapshot.json --output=json

比较两个快照（使用 --fail-on-diff 时退出码为 1）
dsh-prompt-templates diff left.json right.json --output=json --fail-on-diff

仅合并到 JSON 产物中；时间相同或名称冲突默认会阻止
dsh-prompt-templates merge base.json incoming.json --strategy newer --out merged.json --output=json

试运行导入（默认）：查看 summary_sha256 和数据库哈希
dsh-prompt-templates import --db /path/to/db.sqlite3 --in merged.json --output=json

仅在绑定两个已审核的值后才应用；会创建备份，然后执行一个事务
dsh-prompt-templates import --db /path/to/db.sqlite3 --in merged.json --apply \
--expect-db-sha256  --confirm-summary-hash  --output=json

import 按模板 id 插入/更新，且从不删除行。它会拒绝未知的快照字段、不受支持的 schema、不匹配的哈希、同名/不同 id 冲突，以及超过 --max-changes（默认 100）的更改。

开发
sh
pnpm install
pnpm verify            # typecheck
pnpm build             # tsc host + tsc client + tsdown browser bundle

已知限制

- 插入会感知光标位置 — 点击模板会替换当前选区，或在光标处插入
- 会话模板需要当前会话 — 在没有打开会话时，只能访问全局模板

许可证

MIT