# @catwithoutear/dsh-prompt-assist 中文文档

规范地址：https://npmcn.com/package/%40catwithoutear/dsh-prompt-assist/

版本：1\.3\.8
npm 元数据更新时间：2026-11-02T11:13:13.167Z
中文译文更新时间：2026-11-09T13:51:58.667Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40catwithoutear/dsh-prompt-assist
原文对照：https://npmcn.com/package/%40catwithoutear/dsh-prompt-assist/?lang=original
项目主页：https://github.com/catwithoutear/dsh-prompt-assist#readme
源码仓库：https://github.com/catwithoutear/dsh-prompt-assist

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：237 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- peer 依赖：@deepseek-ai/schemastery ^3\.18\.0 \|\| ^3\.18\.6-alpha\.1
- 首次发布：2026-10-27T03:38:06.371Z
- 最新版本发布：2026-11-02T11:13:12.820Z
- 近 30 天下载量：2485（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

接下来的快速预览,草稿续作和一击指令用上下历史重写,可配置的辅助模型和可再应用的快捷键.

## 安装

```sh
npm install @catwithoutear/dsh-prompt-assist
```

也可以使用：`pnpm add @catwithoutear/dsh-prompt-assist`、`yarn add @catwithoutear/dsh-prompt-assist`、`bun add @catwithoutear/dsh-prompt-assist`

## README

# 快速预览历史( H)

一个 DSH 插件,在完成的回答后建议下一个用户提示,让您浏览并用 \\\\\\\\\\\\\\恢复最近的提示,继续您输入的草稿,并将一个选定的指令重写成一个明确的请求——全部在本地作曲家内部.

[中文文档](https://npmcn.com/package/%40catwithoutear/dsh-prompt-assist/README_ZH.md)

## 特征

-   **下一个即时预览 .** 在完成回答后,空作曲者会使用会话模型或已配置的辅助模型,从用户的角度显示所起草的下一条短消息.
-   **可配置辅助模型.** 选择在 DSH 下已经配置的任何提供者/ 模式 **设置 — 快速辅助**。留空以遵循会话模式。 插件没有额外存储 API 密钥, 并且永远不会默默地倒回 .
-   **快捷触发和自动模式.** `Trigger prompt prediction` 请求在草案为空时下个提示,在不为空时继续. `Toggle automatic prompt prediction` 切换回答后的自动建议.
-   **复可通捷径.** 两个命令都可以在下面编辑 **设置 – 一般 – 快捷键** 和本地录音机。 如果默认绑定相冲突,插件仍会加载并告诉你手动指定一个.
-   **续稿草案.** 以作曲中文字为主,触发器请求在护身符上继续. 作曲卡内部有一个预览面板显示; Tab 插入, Esc differences, 并且没有发送任何信息.
-   **一击优化.** 选择文本( 或离开护身符倒塌以优化整个草稿)并按 **优化** 在作曲工具行中。 选定指令被改写,因此其目标、范围和限制是明确的,没有增加用户未表达的要求。 结果先被预览,只在确认时应用,所以可以被撤销. 阻碍模糊性会产生问题,而不是替换。 全新的会话的初稿可以在第一个回合结束前被优化:会话路线通过部署默认模式,直到它记录了自己的选择. **设置 – 迅速协助 – 优化战略** 默认为 **忠诚的扩张** (改进措辞,使已经简化的细节明确);选择 **只澄清** 对于最小的模糊 修正.
-   **提议,不发送.** 每个结果都是预览. 只有标签或 **应用** 写入草稿;插件从不发送或提交.
-   **原生布局图.** 接下来的即时预览会继续使用作曲家现有的上覆座;继续并优化使用相同的卡-内部预览区域,在编辑器下方和工具行上方. 编辑器DOM从未注射.
-   **即时历史.** 回到最近的提示, 向前走, 通过最新的条目 恢复原稿。 输入的前缀过滤历史 .

## 兼容性

-   DSH 数字 `>=0.2.1-rc.3 <0.2.2-alpha.0 || >=0.2.2-alpha.2 <0.2.3-0` (核实: `0.2.1-rc.3`, (中文(简体) ), `0.2.1-rc.4`, (中文(简体) ), `0.2.2-alpha.2`),节点.js 22. Alpha验证在多克内部使用节点24.
-   经核实的精确DSH版本列于 [`verification/dsh-versions.json`](https://github.com/catwithoutear/dsh-prompt-assist/blob/main/verification/dsh-versions.json) 执行人 [`verification/`](https://github.com/catwithoutear/dsh-prompt-assist/blob/main/verification/README.md)。所接受的范围与该列表必须保持同步;在其矩阵运行为绿色之前不支持在范围内更新的发布.
-   禁用 `dsh-prompt-history` 在启用此插件之前 。 运行两者都会产生重复的键盘收听器和相重叠的预览.
-   默认情况下,插件使用会话模型并消耗其配额;一个已配置的辅助模型消耗了该模型的配额. 该插件没有添加自己的证书 .
-   快捷键重用本地的 DSH 注册和持久性 。 打开 **网络**,只允许 `Ctrl+/`, (中文(简体) ), `Ctrl+Shift+,`,以及 `Ctrl+Shift+.`· ; `Ctrl+/` 属于快捷键页面,并且 `Ctrl+Shift+.` 到可选检查员捆绑,所以手动触发默认为 `Ctrl+Shift+,` 和自动切换保持不绑定(将其分配到 **设置 – 一般 – 快捷键**) (中文(简体) ). 桌面不受限制,默认为 `Primary+Alt+J` 编号 : `Primary+Alt+K` (单位:千美元)`Cmd+Option` (原始内容存档于2018-09-28). on macOS.

## 安装

从 DSH 侧边栏安装 : **插件 — 添加插件 — 安装第三方插件**,然后输入:

```text
https://github.com/catwithoutear/dsh-prompt-assist.git
```

也可以通过插件管理器安装本地取出. 软件包名称是 `@catwithoutear/dsh-prompt-assist`; 显示名称为 **快速预览历史( H)**。 。 。 .

要更新已有的安装: 用 `npm run build`,重新安装或重新应用插件管理器中的源,重新启动用于主机更改的DSH,并刷新用于客户端更改的页面. 替换已经装入的 Host 模块需要重新启动; 仅刷新页面是不够的 。 当升级从旧 `@local/dsh-prompt-assist` 名称, 先删除插件项并安装 `@catwithoutear/dsh-prompt-assist`; 在新软件包安装之前不要重新启动 DSH .

## 使用量

1.  **下一个提示**:等待一个答案来完成. 当会话闲置而未排队输入时,在可见而空的作曲中会出现带有提示的灰色建议 `Tab to accept · Esc to dismiss`。 。 。 .
2.  **手动触发**:聚焦作曲家并按下触发快捷键. 空的草稿请求下个即时;有倒塌的护身符的非空的草稿请求在护身符上继续.
3.  **续设**:结果出现在作曲家卡片内. Tab在当前的caret上插入;移动caret或编辑草稿需要新的触发.
4.  **优化**: 选择要重写的案文( 或保存崩溃的护栏来优化整个草稿), 然后按 **优化** 在工具行中:
    -   `MODE: replace`编辑: **应用** 替换选择(或整个草案)或 **取消**· ;
    -   `MODE: questions`:仅显示阻断问题;编辑草稿并再次触发.
5.  **自动模式**: 按切换快捷键或使用设置页面。 关闭时自动请求停止; 手动触发仍然有效 .
6.  **历史**:按下QQ为更年长的快活,并按上更新的快活。 通过最新的条目 恢复你开始的草稿。 在作曲中带有文字,历史只显示从该前缀开始的条目.

当会话运行时,当文件或图像被附加时,或者当作曲者处于其平版编辑状态时,建议被隐藏. 无法进行整稿优化,而草案中包含参考芯片或引用段落;如果选择内容有重叠,则拒绝进行复选,并在修改草案之前保留在屏幕上的解释。 续作不受芯片影响. 历史只恢复文字.

## 设置

**设置 — 快速辅助** 使用本地设置布局 :

-   **自动化**:用于在每个完成的答案后生成下一个即时建议的一个开关(默认).
-   **辅助模型**:带有"遵循会话模式"或被配置的提供者/模型的卡;在选择提供者后,可以选择一个特定的模型或保持提供者默认. 修改无需重新装入插件即可立即应用 .
-   **优化战略**数字 : **忠诚的扩张** 是默认的;它改进了措辞,并明确了已经隐含的细节。 选择 **只澄清** 对于最小的模糊 修正。 两种模式都没有增加目标、接受标准或草案未表达的技术选择.
-   **主题**:设置页面遵循了DSH轻/暗主题;所选择的字段保留了自己的中风,因此在任一主题中它们都与卡片保持可分.
-   **快捷键**: 两个命令的密钥徽章, 未设置时为“ 未绑定 ” , 指向 **设置 – 一般 – 快捷键**。 。 。 .

## 行为和保证

-   **资格.** 下一个即时预览仅在一个 `completed` 打开其最终助理消息有文本, 不被中断, 并且没有工具调用; 会话必须闲置, 没有队列输入 。 继续只能手工操作。 优化是按键驱动的,不绑定转会资格,而需要平庸作曲状态.
-   **模特儿的选择.** 默认情况下, 插件会使用会话的直播 `modelSelection.next` 或者说 `lastUsed`;它永远不会回到会话请求头,所以一个会话开始时没有模型,并立刻选择一个以后的工作. 当插件中没有任何选择时,会话报告没有模型,而是指责辅助模型. 配置的辅助路由在每次呼叫之前都会被验证;无法使用的路由会产生可操作错误而不是静态倒置. 接下来的即时和续作使用最低支持的推理努力;优化后的工作由提供者负责.
-   **内容和限制.** 下个即时发送最后8个用户/助手的短信(用户为"≤"2,400和助手为"≤"3,200个字符). 继续发送最近的笔录外加前缀/后缀草稿(≤8000个字符总计)并封盖输出160个单行字符. 优化发送选择(≤6000个字符)和一个小上下文窗口(≤800个字符各一面);替换输出被封顶为6000个字符和2000个问题. 超限,超时,空输出,和错误的输出都会产生明显的出错.
-   **滤取.** 下个即时系统即时和200字符过滤器不变. 继续和优化有他们自己的验证器,拒绝助手聊天,UI指令,和空结果. 优化输出必须跟随 `MODE:` 协议.
-   **写作与种族.** 每篇作文都要对照修订稿检查:续作也要求护身符仍位于触发器所捕捉之处;整稿优化使用被修订后保护的 `insertText`从来没有没有保护过的人 `setDraft`。延迟结果、取消的请求和通过编辑无效的预览从不写入.
-   **历史.** 最后200个人类短信被考虑,连续的重复合并;历史从会话日志被重建并活过一页刷新.
-   **安全无虞.** 没有全球覆盖、固定定位、DOM注射、聊天DOM观看或投票。 预览是一个DSH槽中状态元素;主机重新验证会话,转会,模式路由,以及输入长度,客户端无法选择模型或更改固定优化合同.

## 发展

```sh
npm ci
npm run build       # regenerate lib/client.js from src/
npm test            # node:test suites, currently 43 tests
npm run check       # syntax-check src/index.js and lib/client.js
npm pack --dry-run  # inspect the distribution file list
npm run verify:docker  # Docker + Playwright checks for verified DSH versions
```

只编辑下面的模块 `src/`。 。 。 . `lib/client.js` 由 `build.mjs` 不得用手工编辑。 构件为一等元:用不变的源头,将捆绑字节同为一等元.

## 测试

套房包含4个文件的43个测试:

-   `test/core.test.js` - 会话折叠、资格、消毒、路由分辨率, `MODE:` 解析 历史行走 电线验证.
-   `test/preview-state.test.js` ——候选人缓存,能见度过渡,自动/人工触发,取消,结果迟发.
-   `test/draft-assist.test.js` ——继续/优化预览状态机,单机,后放,出错,取消.
-   `test/host.test.js` ——Host服务针对真实的Cordis语境,有被绊倒的特质,预测和LLM流.

测试涵盖了纯逻辑,控制器,以及主机的主要路径. 它们不覆盖插件 `apply()` 注册, React 客户端组件,本地浏览器事件,或实际布局几何,它们不能证明真实模型输出的质量. Docker的绳子 `verification/` 将核心网络流量(组合器,下个即时覆盖,续作和优化)自动化,以对抗定型模型起子;它不覆盖桌面外壳或真正的模型行为.

## 项目布局

```text
src/                 hand-written ESM modules
  index.js           Host entry: Config, projection registration, Typert service, model calls and the built-in optimization contract
  core.js            shared fold, prompt contracts, validators, route resolution
  remote.js          Typert wire codecs and descriptors
  preview-state.js   next-prompt controller (automatic/manual triggers)
  draft-assist.js    continuation/optimization preview state machine
  client-entry.js    React composer UI, settings page, shortcuts, slots, CSS
lib/client.js        browser bundle generated by build.mjs (committed)
test/                node:test suites and Harness resolution hook
verification/        Docker + Playwright deployment and UI checks; DSH support matrix
locale/              plugin title and description metadata
build.mjs            builds lib/client.js from src/
cordis.patch.yml     bundle insertion for the plugin
package.json         exports, distribution whitelist, DSH manifest
```

`AGENTS.md`, (中文(简体) ), `VERIFICATION.md`,以及 `.changes/` 是当地的工作记录。 它们不是 npm 包的一部分 .

## 限制

-   建议和优化质量取决于选定的模式。 该插件只过滤结构并明显无效输出.
-   在网络上,只有三个DSH-允许的快捷键组合可以使用,其中两个属于官方插件(`shortcuts.open` 和可选检查器);桌面可以记录任何组合。 相冲突的默认需要手动快捷键任务 .
-   续作/优化预览坐落在作曲家卡片内;其布局,滚动和焦点行为依赖于DSH作曲的叠加槽并需要在DSH升级后重新检查.
-   优化是自成一体的:它利用了插件内置的澄清合同,从环境看没有读出任何内容,因此功能不依赖于已安装的技能.
-   没有侧式聊天,剪贴板功能,没有第二历史商店,也没有自建的快捷键系统.

## 许可证

麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40catwithoutear/dsh-prompt-assist/LICENSE)。 。 。 .

## 贷项

即时历史交互和公共插件界面的灵感来自 [萧非非/dsh-即时-历史](https://github.com/Xiaofei-fei/dsh-prompt-history); 此插件是一个独立的执行. 将缓存建议与临时可见性区分开来,是因为 [openai/codex PR #23976 (中文(简体) )](https://github.com/openai/codex/pull/23976),它没有被合并而关闭,也没有描述Codex的主线行为.

## 常见问题

### @catwithoutear/dsh-prompt-assist 是什么？

接下来的快速预览,草稿续作和一击指令用上下历史重写,可配置的辅助模型和可再应用的快捷键\.

### 如何安装 @catwithoutear/dsh-prompt-assist？

在项目目录运行 npm install @catwithoutear/dsh-prompt-assist，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/schemastery（^3\.18\.0 \|\| ^3\.18\.6-alpha\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @catwithoutear/dsh-prompt-assist 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/catwithoutear\_\_dsh-prompt-assist 是否存在。

### @catwithoutear/dsh-prompt-assist 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @catwithoutear/dsh-prompt-assist 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @catwithoutear/dsh-prompt-assist 可以商用吗？

@catwithoutear/dsh-prompt-assist 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @catwithoutear/dsh-prompt-assist 的下载量有多少？

根据 npm 官方下载统计，@catwithoutear/dsh-prompt-assist 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,485 次，日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @catwithoutear/dsh-prompt-assist 还在维护吗？

最新版本 1\.3\.8 发布于 2026/11/02（7 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。