DSH 生态遵循“一切皆插件”的理念。在构建智能体或进行复杂推理时,提示词的清晰度与结构化程度直接影响输出质量。prompt-polish 旨在解决输入草稿模糊、结构缺失的问题,在发送前调用专门的提示词工程 agent 对文本进行润色、补全和扩写。
功能特性¶
- 一键润色与补全:根据提示词工程最佳实践,补充目标、对象、范围、约束等要素,消除歧义,组织结构。
- 多轮改写与版本回溯:支持单次重写、多轮迭代(自动 3 轮)以及逐步撤回,通过版本标签快速跳转历史状态。
- 自动写入输入框:润色完成后结果直接填入输入框,可直接发送。
- 内置日志系统:展示 Host 与 Client 双侧诊断日志,包含接口状态、模型路由及健康检查,便于排查问题。
- 自定义 API 配置:支持配置 OpenAI 兼容 API(OpenAI / DeepSeek / Azure / Ollama 等),不依赖 dsh 内置模型路由。
- 零构建:Client 端采用手写
window.__ModuleLoader__bundle,无需构建工具链。
安装与启用¶
依赖环境:DeepSeek Harness web 模式(dsh --profile web)≥ 0.1.1-rc.2。
插件自带 dsh.bundle 声明,通过 dsh plugin add 可自动安装并注册到 profile 组合中:
dsh plugin --profile web add github:JOJO666888888/prompt-polish
安装后重启 dsh 并刷新浏览器。侧边栏底部将出现「✨ 润色」和「📋 日志」两个按钮。
使用方法¶
- 在输入框输入草稿(例如「优化一下我的代码」)。
- 点击侧边栏底部的 「✨ 润色」 按钮。
- 等待约 20~30 秒,优化面板会显示处理状态。
- 完成后,润色后的文本会自动填入输入框。
- 在优化面板中,可通过 ↩ 撤回、🔄 重写 或 ⏩ 多轮改写 继续调整。
- 点击版本标签(原文 / v1 / v2…)可跳回任意历史版本进行对比或手动微调。
自定义 API 配置¶
配置文件保存在 ~/.dsh/plugins/prompt-polish.json。支持两种配置方式:
- dsh 设置面板:打开侧边栏「⚙️ 设置」 → 左侧「✨ 提示词优化」分区。
- 润色面板内快捷设置:点击优化面板头部的 「⚙️ 设置」 按钮。
配置字段包括:
* 启用:开关自定义 API 或回退到 dsh 内置路由。
* API 地址:OpenAI 兼容接口的 Base URL。
* API Key:认证密钥。
* 模型名称:模型 ID。
* 最大 Tokens:输出上限。
常见服务配置示例:
* DeepSeek:https://api.deepseek.com/v1,模型 deepseek-chat 或 deepseek-reasoner
* OpenAI:https://api.openai.com/v1,模型 gpt-4o
* Ollama (本地):http://localhost:11434/v1,模型 llama3.1
卸载¶
dsh plugin --profile web remove prompt-polish
此命令会从 profile 依赖和 bundle 层栈中移除插件,需重启 dsh 生效。自定义 API 配置文件需手动删除。
技术实现¶
- Host 端:普通 Cordis 插件,通过
webServer.register暴露/pp-api/polish、/pp-api/config、/pp-api/logs等同源接口,调用llm.stream执行 agent 逻辑。 - Client 端:通过
dsh.client声明被dsh-client-modules扫描,加载手写的window.__ModuleLoader__bundle,实现零构建。
注:本项目与 DeepSeek 官方无关联。