前言¶

在 DeepSeek Harness（DSH）里写长提示或任务说明时，常见做法是手动复制目录结构、再另开一轮对话让模型帮忙改稿；角色设定则往往散落在本地 Markdown 里，插入输入框还要自己切窗口。若希望这些动作留在当前会话、且尽量少注册额外模型工具，@jayyuen66/dsh-dir-prep-organize 把「润色」和「模板」做成输入框右侧的两个控件，由宿主已有的 LLM 与设置服务完成重写与插入。

下面介绍该插件的定位、能力边界，以及安装与典型用法。事实以 GitHub 仓库 与 npm 包 @jayyuen66/dsh-dir-prep-organize（当前版本 0.1.8）说明为准。

这是什么¶

dsh-dir-prep-organize 是维护者 JayYuen666 发布的 DSH 插件：在 Web 对话输入框右侧增加可拆分的「润色」按钮和「模板」下拉。润色会把草稿、会话工作目录顶层（文件名、大小及关键文本文件全文）与会话内真实的 user/assistant 轮次交给当前会话选定的模型（取不到时回落宿主默认模型）重写；模板则在光标处插入角色正文，不重建整份草稿。插件不注册模型工具，也不自建 HTTP 路由，数据面走宿主 Typert Remote 命名空间 dirPrepOrganize。

核心功能¶

润色¶

主键点击后直接润色；▾ 子菜单可选择「以某个角色的风格润色」（只借用术语与语气，不执行该角色任务）。成功时用重写结果替换输入框草稿；失败时不修改草稿，按钮约 4 秒错误态，原因在 tooltip。写回有条件：会话 id、草稿版本与输入阶段（plain）均与发起请求时一致，否则结果丢弃并提示「输入框内容已变化，润色结果未写回」。默认超时 organizeTimeoutMs 为 120000 ms，经宿主 llm.stream 调用；finish reason 非 stop 视为失败。

模板¶

下拉按条目 group 分组，空 group 归入「通用」。内置 85 条精选角色模板，由 scripts/gen-defaults.mjs 从包内 agents/ 角色库生成（上游为 agency-agents-zh，MIT）；列表在宿主侧，浏览器首次打开菜单或进入设置卡时懒加载 Remote 方法 defaults。插入经输入框版本校验的插入面，引用块与附件保持原样；提交过程中两个控件禁用。

设置卡「角色库」¶

同一份模板列表同时驱动「模板」下拉与「润色」▾ 角色菜单。支持增删改、两步恢复默认、一键导入整套内置库、按路径导入本地 .md 或目录，以及登记 importAllowRoots 额外允许导入根。改动在设置页先进入草稿，点保存后生效；持久化在 dsh 数据目录的 settings.yaml，命名空间条目 id 为 dir-prep-organize。

安装与启用¶

安装命令（Web profile）：

dsh plugin --profile web add @jayyuen66/dsh-dir-prep-organize

卸载：

dsh plugin --profile web remove @jayyuen66/dsh-dir-prep-organize

包发布在公共 npm，无需凭据。要求 Node.js >= 22.12（ESM 包，具名导出，无 default export）。宿主 dsh 兼容性由包内 engines.dsh（^0.2.1-rc.3）判定；README 记载发布时在 0.2.1-rc.3 至 0.2.2-alpha.2 窗口内逐版验证，窗口会随宿主发布滚动，被拒版本需按文档使用 allow-version 显式担责。

安装后通过 dsh.bundle.patch 注入层 dir-prep-organize；客户端半在 conversation.input.right 注册控件，并在 plugins.bundle.config 以包名 @jayyuen66/dsh-dir-prep-organize 挂载设置卡。

确认是否生效可按 README 建议：

1. 输入框右侧应出现「润色」与「模板」。若未出现，可用 dsh --profile web --dump-config 查看层栈是否含 dir-prep-organize（该命令会改写 profile 根装配文件，判读时需同时看 stdout 与 stderr）。
2. 打开「模板」，应经 defaults 加载内置列表；加载中显示 loading 行。
3. 按润色主键，成功则替换草稿，失败则草稿不变。
4. 设置页出现「角色库」小节，保存后改动生效。

典型用法¶

1. 在输入框写好草稿，确认会话 cwd 指向当前项目目录。
2. 需要直接改稿时点「润色」主键；需要特定行文风格时打开 ▾，选角色后再润色。
3. 需要插入角色设定时，光标定位到插入点，在「模板」下拉选条目，文本写入光标处。
4. 自定义模板或导入本地角色：打开插件设置卡「角色库」，编辑或填写路径导入；未登记 importAllowRoots 时，导入路径通常须在会话 cwd 或内置 agents/ 内（设置卡导入请求无会话上下文，sessionId 为空串）。

润色时，目录列表、对话与角色正文整份送入模型，插件不会替你截断；上下文溢出或 body 超限（413）需自行收窄输入。关键文件摘要仅覆盖 README 列出的扩展名白名单，且会跳过名称命中敏感词边界的文件；详见仓库「数据与隐私」一节。

高级部署项（设置卡无控件）包括 maxSnippetBytes（默认 262144）、readConcurrency（默认 8），需经 settings.yaml 或条目 config: 修改。

适用场景与注意¶

适合经常在 DSH Web 里写提示、并希望结合当前会话目录与同会话模型做一次性改稿，或快速插入 curated 角色模板的开发者。插件不提供 CLI、不读环境变量、不注册 organize_text 一类工具；润色与摘要读取仍依赖宿主会话、Agent、文件系统与 LLM 服务。

DSH 生态主张「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。安装前请自行审阅 源码与 MIT 许可证，并记住插件以当前 dsh 进程权限运行：润色会把草稿、目录条目、关键文件全文及真实对话轮次发往所选模型提供商。

结尾¶

dsh-dir-prep-organize 把目录上下文润色与角色模板插入收拢到输入框旁，Settings 与 Remote RPC 分工明确，且不扩展模型工具面。需要细节、FAQ 与 Remote 方法表时，见仓库 README.zh-CN.md。

• 目录页：https://www.skillhub.cn/plugins/JayYuen666/dsh-dir-prep-organize
• GitHub：https://github.com/JayYuen666/dsh-dir-prep-organize