dsh-quick-translate

使用

页面左侧是历史记录，右侧是「原文 | 译文」双栏工作台。翻译、复制、重译等常用操作都在工作台内完成；提示词、历史目录这类低频管理收在右上角「设置」里。

1. 在原文栏底部的模型标签中选择 DSH 已配置的模型。刚在 DSH 设置里修改过模型时，展开菜单点击「刷新模型列表」。
2. 输入或粘贴原文，点击「翻译」或按 Ctrl + Enter。翻译期间按钮变为「停止」，停止后保留已输出的部分。
3. 译文栏依次显示「正在连接模型 → 模型思考中 → 正在翻译」，文字随光标逐段出现，完成后显示耗时。点击「复制」得到保留原文格式的译文。
   • 译文栏底部显示本次的输入 / 输出 token（输入包含缓存命中部分）。点击它打开「翻译详情」：缓存命中、总耗时与首字时间、「等待响应 → 思考 → 输出译文」的耗时分布、输出速度、模型标识、结果与错误代码、当次提示词快照；「复制诊断信息」得到一段纯文本，便于排查或反馈。
   • 用量来自模型在流式结束时返回的数据。手动停止、连接中断或旧版本的记录通常没有用量，会显示「无用量数据」。
4. 修改原文后，上一次的译文会变淡并提示「原文已修改」，避免误复制旧结果。点击原文栏右上角的「×」清空，开始新的翻译。
5. 切换到 DSH 的其他页面时，翻译在后台继续；返回后恢复进度。
6. 历史记录按「今天 / 昨天 / 近 7 天 / 月份」分组，每条显示原文和译文的首行，滚动到底部自动加载更多。
   • 点击一条记录进入只读查看。顶部显示「返回」，也可按 Esc 回到当前翻译；「用此原文重译」把原文放回工作台。
   • 右键一条记录，可以复制译文、用原文重译、查看翻译详情或删除。
   • 顶部「…」可打开这条记录的「翻译详情」，或删除这条记录。
   • 历史记录栏收起时，顶部左侧显示带记录数的「历史记录」按钮，新记录产生时数字会轻微跳动；译文栏底部的「已保存到历史」也可以直接打开历史记录。
7. 窗口较窄时，历史记录变为从左侧滑出的抽屉，点空白处滑回；宽屏下收起和展开历史栏时栏宽平滑过渡。更窄时，原文和译文上下排列。菜单、设置面板和对话框关闭时也有退场动画。

默认提示词随插件保存在 prompts/default.md。提示词为普通文本，不插入语言参数或模板变量。模型请求只包含当次提示词和待翻译原文，不带其他翻译历史或 DSH 对话。文档中的多语言规则交由模型理解；其中针对上一条译文的连续反馈规则仍保留原文，但本版本不提供多轮上下文。

在「设置 → 提示词」中切换「默认 / 自定义」：默认提示词只读显示；选择「自定义」后编辑并点击「保存」，会自动生成或更新独立的 Markdown 文件：

%USERPROFILE%\.dsh\plugin-data\dsh-quick-translate\prompts\custom.md

切回「默认」立即生效，不改写也不删除 custom.md；再次选择「自定义」即恢复已保存的版本。未保存的修改在关闭设置面板后仍会保留，直到你保存或放弃。修改只用于之后发起的翻译，正在运行的任务和历史记录继续使用各自的提示词快照。改变模型不会改写提示词文件。

设置页显示默认文件、自定义文件的完整路径，并可打开自定义提示词目录。默认文件位于插件安装目录中的 prompts/default.md，以设置页显示的实际路径为准。自定义文件只有首次保存时才创建。请通过自定义文件修改规则，不要编辑包内默认文件。

设置文件只保存当前使用默认还是自定义，不存储提示词正文；历史记录保留当次提示词正文用于回看。当前仍在开发阶段，本版本不读取或迁移旧的 .dsh-quick-translate 和 Documents/DSH Translations 数据，已移除旧版提示词兼容逻辑。

原文和译文以文本显示，保留换行及 Markdown 源码，便于准确复制。本插件不包含笔记插件的图表或 Markdown 预览引擎。