dsh-knj-prompts
DSH 提示词场景插件：输入框右侧「✦ 提示词」下拉选场景 →（含 {变量} 时先填变量并实时预览）→
空白会话直接填充草稿、非空白会话自动切到同工作区新会话再填充，微调即可发送。
功能
- 输入框工具行右侧 ✦ 提示词 按钮，下拉列出全部场景（内置场景带「内置」标记，变量以 chip 展示）
- 场景提示词含
{变量} 时先弹填充面板：逐变量输入 + 实时预览，确认后填充
- 当前会话为空白会话 → 原地填充草稿；已有对话 → 自动开新会话（官方 New Session 通道）后填充
- 「管理场景…」弹窗：新增 / 编辑 / 删除场景（内置场景可编辑、不可删除），「保存全部」落盘
- 场景存储：
<DSH_HOME>/knj-prompts/scenes.json（原子写、损坏自动备份重建、内置 seed 合并）
- 场景编辑器提供默认折叠的「场景包操作说明」Markdown；旧数据缺该字段时自动视为空字符串
- 内置「导出场景包」与「安装场景包」场景：分别引导 AI 使用随插件提供的 exporter / installer skill
场景包 MVP
场景包是一个普通场景的可迁移 ZIP。包内只允许携带该场景、其 Markdown 操作说明、嵌入 skill 和可选素材；不包含普通 DSH 插件代码，也不复制源机器的运行配置值。
<scene-id>.dshscene.zip
├─ manifest.json
├─ scene.json
├─ README.md
├─ skills/ # 可选：<skill-id>/SKILL.md 及其文件
└─ materials/ # 可选：操作说明中列出的素材
- 操作说明是依赖、素材、配置模板与验证步骤的唯一真源，不依赖额外结构化依赖字段。
- 插件首启时从本包
skills/ 复制 scene-package-exporter 和 scene-package-installer 到 <DSH_HOME>/skills/；已有同名目录一律保留，绝不覆盖或合并。
- 选择「安装场景包」会打开文件选择器，仅接受 ZIP。插件将其上传暂存到
<DSH_HOME>/knj-prompts/imports/ 并在安装会话草稿中写入服务器返回的真实路径。
- 插件不会解压 ZIP、安装 skill、写运行配置或执行包内内容。这些动作由 AI 通过 installer skill 完成：先预检、展示计划并询问当前环境配置；任一嵌入 skill 在目标根目录同名时整体阻断，确认前和发生冲突时均不得部分写入。
- V1 不支持多场景包、覆盖/合并、远程仓库、签名、依赖图、更新同步或自动配置发现。
安装（web profile）
# 在插件目录
npm.cmd run typecheck && npm.cmd run check:client && npm.cmd run build && npm.cmd run build:client && npm pack
# 在 web profile 的 package.json 里把依赖指向新 tgz 后重装
开发
- 纯函数与决策表：
src/client/engine.ts（node --test engine.test.mjs）
- 服务端（场景/变量存储、ZIP 暂存）：
src/{store,varstore,routes,scene-package}.ts
- 客户端（ScenePicker 下拉 / ZIP 选择上传 / 变量面板 / 管理弹窗）：
src/client/ScenePicker.tsx
- Bootstrap skill：
skills/{scene-package-exporter,scene-package-installer}/SKILL.md
- 关键验证：
node --test engine.test.mjs bootstrap-skills.test.mjs scene-package.test.mjs store.test.mjs
- 宿主 API 事实清单：PROBE.md（改 inject 或 props 前必读）
