在 Web、桌面端和 TUI 中使用 Harness AI 或原生 Codex 澄清并优化提示词,预览可编辑,确认后仅填入草稿。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/ALIve114514awa/dsh-prompt-optimizer/releases/download/v0.1.3/dsh-prompt-optimizer-0.1.3.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ALIve114514awa/dsh-prompt-optimizer
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
版本 0.1.3。将模糊需求改写为清晰的提示词,支持 Harness 当前模型与 Codex,可先提问澄清,再预览和编辑结果。
Web UI 和桌面端的入口位于左侧边栏底部、“上下文洞察”上方;TUI 使用 /prompt-optimize。结果由用户确认后填入当前对话的草稿,聊天消息始终由用户自行发送。
实际验收范围与未验证事项见 验收记录。
使用
- 选择一个聊天会话,打开“优化提示词”。在独立页面填写需求,或点击“带入输入框草稿”。
- 选择 Harness AI / Codex,以及智能优化、扩写或精简。
- 点击“澄清需求”,回答或跳过最多三个问题,再明确点击生成;也可以直接生成。
- 在预览中编辑或复制结果,点击“应用到输入框”填回当前对话,再自行发送。
上下文默认关闭。手动开启后,只附带最近一轮已结束的用户输入和 AI 回复,不使用正在生成的回合,也不自动附带工作区文件或附件。
生成期间可以取消。同一会话的问答和预览可保留;点击返回会取消当前请求。草稿、草稿版本、会话或引用附件变化后,旧结果不能覆盖新草稿,需要重新确认。
TUI 快捷键
| 按键 | 操作 |
|---|---|
Ctrl+G |
澄清需求,或根据已填答案生成;空答案视为跳过 |
Ctrl+R |
直接生成 |
Ctrl+N/P |
切换输入栏 |
Tab |
切换优化方式 |
Ctrl+B |
切换 AI 提供方 |
Ctrl+X |
开关上一轮上下文 |
两次 Ctrl+S |
确认将编辑后的预览追加到当前草稿 |
Esc |
生成时取消,其余时候关闭面板并保留预览 |
在同一会话运行空参数 /prompt-optimize 可以重新打开面板。TUI 的公开追加接口没有接收回执,成功提示表示请求已写出,请检查主输入框后自行发送。追加失败时保留预览,不自动重试。已有原稿保留尚未完成实际验收,见已知限制。
兼容版本
| 部分 | 目标版本 |
|---|---|
| Web UI / 桌面端 | DeepSeek Harness 0.2.0-rc.2 |
| Host API | 0.1.7-rc.2 或 0.2.0-rc.2 |
| TUI | @deepseek-harness-tui/dsh-tui@0.11.1 |
| Cordis / Web React | 4.0.4 / 18.3.1 |
| Node.js | 22 或更新版本 |
Web/桌面端安装 dsh-prompt-optimizer,TUI 安装 dsh-prompt-optimizer-tui。同一个 Profile 选择一个发行包,避免重复注册服务。TUI 包移除了浏览器依赖,以兼容旧版 CLI 的 peer 检查,并使用宿主提供的 React。
Profile 应由版本匹配的 CLI 管理。桌面应用的内置 runtime 可能与全局 dsh 不同,请先检查版本和实际依赖。
构建和打包
在仓库根目录执行:
npm ci
npm run check
npm run pack:artifact
npm run pack:tui
安装包输出到:
artifacts/dsh-prompt-optimizer-0.1.3.tgzartifacts/dsh-prompt-optimizer-tui-0.1.3.tgz
npm run check 包含 Host/Client TypeScript 检查、测试、三个 bundle 构建、包结构检查、真实 Cordis/Connection 注册检查,以及客户端行为验证。单项命令可在 package.json 中查看。
安装
可自行构建,或从项目 GitHub Releases 下载对应版本的 .tgz 安装包并放入 artifacts/。以下命令在仓库根目录运行,使用相对安装包路径;Profile 名称按你的环境调整。
桌面端
PowerShell 示例;$desktopApp 可改为实际桌面安装目录中的 resources/app:
$desktopApp = Join-Path $env:ProgramFiles 'DSH Desktop\resources\app'
$desktopCli = Join-Path $desktopApp 'lib\desktop-cli.js'
node $desktopCli --version
npm run check:runtime -- $desktopApp --surface desktop
node $desktopCli plugin --profile desktop add './artifacts/dsh-prompt-optimizer-0.1.3.tgz'
内置 CLI 应为匹配的 0.2.0-rc.2 runtime。安装后重启对应 Harness 窗口,加载 Host 和浏览器插件。
Web UI
确认管理该 Profile 的 dsh --version 为 0.2.0-rc.2:
dsh plugin --profile web add './artifacts/dsh-prompt-optimizer-0.1.3.tgz'
重启 Web Host 并刷新页面。插件 bundle 自动应用 cordis.patch.yml,无需复制源码或修改 Harness 内置包。
TUI
目标 Profile 需已安装 @deepseek-harness-tui/dsh-tui@0.11.1。使用管理该 Profile 的 CLI:
$tuiProfile = 'dsh-tui'
$tuiProfileDir = Join-Path $env:USERPROFILE ".dsh\profiles\$tuiProfile"
npm run check:runtime -- $tuiProfileDir --surface tui
dsh plugin --profile $tuiProfile add './artifacts/dsh-prompt-optimizer-tui-0.1.3.tgz'
dsh $tuiProfile
TUI 包自动加载 Host 服务和 /tui 入口。启动后输入 /prompt-optimize 需要优化的需求,或用空参数命令打开面板填写。
AI 提供方
Harness AI 复用当前聊天选中的模型及登录配置,请先选择可用模型。请求显式使用空工具列表。
Codex 使用 Host 上版本匹配的官方 dsh-subagent-codex provider,需要 Host 具有有效的 Codex 原生登录状态。远程网页使用的是 Host 的 Codex 环境。官方 provider bundle 提供配套原生 CLI。
原始需求作为待改写内容传入;优化指令要求保留目标、事实与限制,缺失信息使用待补充标记,仅返回优化文本。Codex 继承官方 provider 的权限和沙箱配置;公开接口没有逐次禁用工具的参数,插件不能保证 Codex 全程只读。
配置专用 Codex 模型
官方 provider 的原生 model 固定在实例配置中。本插件通过 codexProviderName 选择一个专用实例,可与已有 codex provider 共存。
在目标 Profile 的 overlay 中加入以下 patch。将模型名改为该 Host 原生运行时和账号可用的模型;示例使用 gpt-5.6-luna:
- insert:
- id: prompt-optimizer-codex
name: '@deepseek-ai/dsh-subagent-codex'
config:
providerName: prompt-optimizer-codex
model: gpt-5.6-luna
permissionMode: never
- id: prompt-optimizer
config:
codexProviderName: prompt-optimizer-codex
服务行的 id 应与目标 Profile 一致。insert 用于新增 provider;后面的条目用于更新已有优化服务。Desktop 的 Electron Host 还需在专用 provider 的 config 中加入:
env:
ELECTRON_RUN_AS_NODE: '1'
这使官方 Node wrapper 正常运行。permissionMode: never 控制审批方式,并继承原生沙箱配置。模型应从配套原生运行时的 model/list 选择,再通过真实生成检查账号可用性;Codex App 展示的别名不一定与该运行时相同。
目标 provider 未注册时会显示不可用,不回退到其他实例。原生模型或请求被拒绝时,界面显示固定的配置提示,保留预览,不复制原生错误正文。
插件配置
Host 导出 Config schema,可在 Harness 插件配置界面调整:
| 字段 | 默认值 | 用途 |
|---|---|---|
timeoutMs |
120000 |
每次优化最多等待 120 秒 |
maxInputChars |
20000 |
原始需求字符上限 |
maxContextChars |
16000 |
上一完整回合的上下文字符上限 |
maxOutputTokens |
4096 |
Harness AI 最大输出 token 数 |
harnessProvider |
未设置 | 固定使用某个已注册提供方 |
harnessModel |
未设置 | 固定使用该提供方的模型 |
codexProviderName |
codex |
目标 Profile 中注册的官方 Codex 实例 |
默认使用当前聊天模型。固定 Harness 模型时,harnessProvider 与 harnessModel 必须同时填写。
项目目录
src/
server/ Host 服务、模型调用、请求取消与结果校验
client/ Web/桌面端页面、左栏入口与草稿保护
tui/ TUI 面板、快捷键与草稿追加
shared/ 请求和结果类型
locale/ 中文、英文文案
scripts/ 构建、打包与 runtime 检查
tests/ 行为与集成测试
docs/validation.md 验收范围与已知限制
cordis.patch.yml Web/桌面端 bundle patch
tui.patch.yml TUI bundle patch
lib/ 构建产物(生成)
artifacts/ 安装包(生成)
浏览器 bundle 使用 Harness 的共享 React/Cordis 模块;Host、Client、TUI 分开构建,不依赖 Harness monorepo 目录结构。
连接与聊天数据
Web/桌面端通过官方 Connection 的精确 /api route 发送优化请求,复用宿主认证与取消机制;浏览器不直接读取模型凭据。
优化请求、澄清问答和结果不作为一轮用户消息写入聊天。插件不会自动发送聊天,也不会把私有优化事件追加到持久化聊天日志,避免影响官方冷恢复。
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10172
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10172
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7101
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 6959
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 4959
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
Devin-AXIS/deepseek-design#deepseek-idesign★ 1744
可视化设计工作室,支持网站、App 原型、海报、信息卡、报告和杂志的模板创建、元素编辑、选区级 AI 草稿衔接与导出。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。