dsh-prompt-optimizer
Agent & WorkflowWestFox-AwA/dsh-prompt-optimizer
DSH web plugin that clarifies the intent of each user turn before sending, producing a per-turn goal with verbatim evidence and passing it to the working AI. Includes a control panel (level, permissions, model, context, read-only tools), an interception overlay with thinking and output layers, and real token usage reporting.
- agent-workflow
- ai-agent
- cordis
- deepseek
- dsh
- dsh-plugin
- llm
- prompt-engineering
- prompt-optimizer
- web-plugin
Verification and compatibility
This section shows evidence collected by the catalog. Undeclared information is labeled as unknown.
- Current-version compatibility
- Verified on the catalog Harness version
- Declared Harness range
- Not declared
- Declared platforms
- Not declared
- Profiles
- web
- Build approval
- Unknown
- Permissions
- Not declared
- External services
- Not declared
- Telemetry
- Unknown
This is not a security endorsement. Review source, permissions, and configuration before installing.
View evidence and scope
Verification covers only the named source, version, and Harness environment. It does not guarantee future compatibility.
github:WestFox-AwA/dsh-prompt-optimizer#6f9b9724c24bc40fb146b7294641b718a9c0412b- The manifest and static structure passed checks; a runtime load check has not completed.
README
dsh-arbiter-wf v0.8.2-stable · 独立裁判层(DSH Web 插件)
中文 | English
效果展示:皆为Windows+DSH+PTC环境,OneShoot
(其中插件档位为"重度")
模型DeepSeek-V4.1-Flash
提示词:不要预览文件夹内的其他文件,制作一个单html程序,要求是极其精细的现代主战坦克模型,可以预览,操控,真实,帅气,炫技写真.
它不改写你的话。 你照常说话,它在你按下发送之前,把"这一轮到底要什么"理清楚,再把这份理解交给工作 AI—— 你的原话一个字不动,理解随行;条条带逐字依据;每一轮重新想一遍(不继承上一轮)。 完整说明与自检见
po06/README.md,人工验收见po06/HUMAN-TEST.md。
⚠️ 安装来源只有一个:本仓库的 Release
渠道 是什么 该不该用 GitHub Release 附件 当前版本( @dsh-external/dsh-arbiter-wf)✅ 唯一正确来源,就是下面这段命令 npm 本插件不发 npm( private: true),只在 Release 分发;registry 上搜到的同名或相似包都不是本项目 ❌ 不要从 npm 装 仓库根直接 clone 与本 Release 同源,适合开发者 ⚠️ 需要自己构建,普通使用走 Release 更省事 想找 0.1 ~ 0.6 的旧版本?见
old/(含各代简介与下载方法)。 想自己发一版?见RELEASING.md(9 步发布规程 + 检查清单)。30 秒装上 0.8.2-stable
$v = '0.8.2-stable'; $d = "$env:USERPROFILE\Downloads" Invoke-WebRequest "https://github.com/WestFox-AwA/dsh-prompt-optimizer/releases/download/v$v/dsh-external-dsh-arbiter-wf-$v.tgz" -OutFile "$d\dsh-external-dsh-arbiter-wf-$v.tgz" Get-Content "$d\SHA256SUMS-$v.txt" # 与上一行下载到的 tgz 对 sha256(Release 页也有同一份) dsh --profile po061 --from-default-profile web --dump-config # 建一个干净 profile dsh plugin --profile po061 add "$d\dsh-external-dsh-arbiter-wf-$v.tgz" # 装 dsh --profile po061 # 起服务(会打印带 token 的地址)装完在面板上把档位拨到
标准或重度(关闭档不拦截、不注入)。 详细版(含 4 步自检、常见装不上的原因)见po06/README.md。 不要装进 0.5.x 所在的那个 profile:同装配会被DOUBLE_INTERCEPT守卫拒绝启用(这是刻意的), 两者也不共用配置(0.6 的启用意图在<home>/po06.json,不会碰 0.5 的prompt-optimizer.json)。
它解决的是哪个问题
这类模型(v4.1-flash 一类)不主动、不猜、一次做完:你没写、它又推不出来的,就是必然缺失; 你写了,它一定会照做。所以缺的从来不是"更漂亮的提示词",而是你自己也忘了说、而它无法自知的那点信息。
本插件只做一件事:在你发送前,把这点信息补齐,并让每一条都能指回依据。它不写下游的本行 (通用写法、常规 API、最佳实践、教学),也不写没有具体指向的验证套话——对这类模型,提示词不是建议而是指令集。
它怎么工作(四步)
- 拦在发送前:你的原话还没进工作 AI,先停一下(面板上写着"优化中…已用 N 秒",随时可「跳过并直接发送」)。
- 另起一次调用做释义(解释层):输入只有两样——你这轮原话的逐字文本 + 本轮真读进来的会话上下文/项目文件。 产出不是改写稿,而是一组条目:你说过的(带逐字引文)、你的质量词怎么理解、你没说且没人能自知的(未知项)、从材料里看出的事实。
- 宿主逐条校验:每条都要能指回逐字来源;指不回去就只丢那一条并记账,绝不冒充"你说过"。
- 随行注入:你的原话原样发出,释义作为"随行包"贴在这一轮;下一轮开始,上一轮的条目整体退场(留档不删)。
三条不变量(也是它与别的工具的分界):
| 不变量 | 含义 | 分界 |
|---|---|---|
| 不改写 | 派发给工作 AI 的原话=你写的字节 | 不是提示词改写器 |
| 条条有据 | 每条都能定位到一段逐字来源,定不到就丢 | 不是自由发挥的补全 |
| 每轮归零 | 本轮的理解不依赖上一轮的条目 | 不是记忆/画像,也不是 RAG |
代价(如实说):长期约束("只交单个文件""别动别的文件夹")不会自动跨轮,要靠上下文每轮重新看出来 ⇒ 别把「上下文」调得太小。换来的是:不会再出现"上一轮早就解决的事又被要求一次"。
界面上有什么
面板只有一行:优化选项(图标 + 当前档位摘要)、状态灯、? 用户手册。点开是一块克制的卡片:
| 控件 | 取值 | 作用 |
|---|---|---|
| 档位 | 关闭 / 轻度 / 标准 / 重度 | 档位=依据预算。关闭=完全不拦、不注入(等于没装) |
| 权限 | 审查 / 自动 | 审查=它完成后先给你看要注入的内容,你可以直接改,再决定提交;自动=它完成即发出 |
| 模型 | 跟随会话模型(默认)或指定 | 解释层用哪个模型 |
| 上下文 | 回合 0–10 / 全文 | 解释时参考多少历史;读得越多越懂你,也越慢 |
| 只读工具 | 开 / 关(默认关) | 允许它在你的工作目录内读文件核对事实(只读、不写、不执行命令) |
| 详情 | — | 改解释层用的提示词(可撤销、可恢复内置) |
拦截浮层(发送前那一下)分两块:思维层(固定显示范围、无滚动条、正文不截断,可往回滚)与
产出层(要注入的内容;审查档可直接编辑)。token 用 provider 真实上报的 入 / 出 / 缓存 三分量
(过千记 k/M,拿不到就显示 —,从不按字数估算)。
界面语言跟随 DSH:在 DSH 里把语言设成中文就全中文、设成英文就全英文(? 用户手册也跟着切),
插件内没有自己的语言开关;浅色/深色也跟随 DSH 主题,切换即时生效。
常见问题
要等多久? 一般 20–60 秒(取决于档位、上下文、模型)。这段等待就是它"替你想清楚"的时间;不想等随时点「跳过并直接发送」。
会改我的话吗? 不会。被补的是给工作 AI 的那份理解;你发出去的字还是你写的。
会不会把我的消息弄丢? 不会。解释失败时:自动 档按你的原话发出并在说明原因;审查 档停在错误态等你决定(消息一直躺在输入框里)。
它这一轮什么都没提取到怎么办? 它会先重试一次;仍然没有,就如实补一条"这一轮没提取到新要求"的待确认条目—— 每一轮一定有一份包(不再出现"思考完却什么都没有")。
它会记住上一轮的目标吗? 不会。每轮从「你这轮的原话 + 本轮读入的上下文」重新推;代价见上面"三条不变量"那段。
它会替我编要求吗? 不会。你明说的才算"你的要求",且必须附逐字引文;对不上就丢弃并记账,界面上"无出处"的条目会红字标出。
读项目文件会不会动我的东西? 不会:只读、限定在你的工作目录内、越界一律拒绝。
关掉/卸载? 临时关:档位拨到 关闭(不拦不注入,等于没装)。彻底卸载:从 profile 的 dsh.profile.bundles 与
dependencies 里移除 @dsh-external/dsh-arbiter-wf,重启 DSH;配置在 <home>/po06.json,可自行删除。
隐私与边界
- 不外发:没有遥测、没有回传。所有状态都在本机
<home>/po06-*.json*与po06-state/下。 - 只读工具是唯一的文件访问:默认关闭;打开后也只读、限定工作目录、不执行命令。
- 不注入无关内容:包只由你这一轮的原话与本轮读入的上下文得出;来源不可核的条目直接丢弃。
- 默认不启用(保守):装配期启用闸门默认
off;要启用就在<home>/po06.json写{"settingsVersion":1,"enabled":true,"rollout":{"mode":"all"}}(只想给某些会话用就写{"mode":"allowlist","sessions":["<会话 id>"]})。 只要旧版插件仍在装配,会以DOUBLE_INTERCEPT拒绝启用——一条消息被两个拦截器处理两次的代价更大。
诚实声明(请按这个预期使用)
- ✅ 内部自洽有证据:92 套测试全绿(
node po06/scripts/run-suites.mjs;各套件自报用例合计 987 项;含打包自足性、文档漂移门禁)。两种 shell 下均已复验(bash 与 pwsh)。 - 📊 作者实测观察(不是专业跑分):测试主要在 DeepSeek-V4.1-Flash + PTC + PowerShell 环境下进行。 目前没有做过专业的跑分测试;但在常见的各类 one-shot 任务与长任务迭代中, 实际效果明显强于同环境、同提示词下的 DeepSeek-V4.1-Flash;另据少量项目的统计, 疑似会降低 token 消耗量、节省开销。
- ⚠️ 能力仍是实验性的,请当成可以装、可以试、随时可关的东西,不是"升级"。
- 📌 本版(0.8.2-stable)改了什么:
⓪ 英文模式(新,默认关闭) —— 面板里与「权限」同款两档滑档:把用户任务、优化策略与辅助文转成英文再送给模型,
界面与状态仍保持中文(状态里的要求正文回到原话语言)。逐字保护代码块、路径、URL、JSON 字面量与精确回话;
翻译与辅助解耦,过期或已取消的输入不会发出去,翻译失败只回落一次并如实归因。斜杠命令不参与翻译,
vmake等允许列表命令照旧走拦截审查。 ① 推理增强(新,实验性) —— 位于选项面板最底部、单独分界,含多候选择优 / 循环改进 / 混合三种模式与 快速-均衡-跟随三档强度;「推理过程」面板只在开关打开时出现。面板里写明了:目前无法确定它能否稳定提升能力, 但会大幅增加模型工作时间,请谨慎开启。 ② 发布门真正可用了(本版新增 CI) —— 新增.github/workflows/ci.yml与po06/scripts/run-suites.mjs, 套件与发版门从此在每次推送时自动运行,而不是只靠人手跑;变异守卫的锚点失效与「测试变弱」也在门禁里分开报。 ③ 越界读取修复(安全) —— POSIX 层此前只做词法校验,工作区内的 junction 可以把读取带到工作区之外 (已实测复现);现在补上 realpath 复核,与只读工具的既有纪律对齐。 ④ 引文信息量下限 —— 「引一个词就写成一段要求」的条目降级为机器理解,不再充当用户要求; 同时修掉了预算审计里一条永远不会触发的判据。 ⑤ 其余能力(独立顾问consult_task、内置 Bash 可靠性、斜杠命令允许列表、拦截面板流式显示、浮层收进会话窗)自 0.8.1 起提供。 详见CHANGELOG.md。
版本与证据
- 更新日志:
CHANGELOG.md| 人工验收:po06/HUMAN-TEST.md| 发版登记(含每次真跑过的装机演练):po06/RELEASE-CHECKLIST.md - 安装与自检:
po06/README.md| 当前 Release:v0.8.2-stable - 兼容:
dsh-0.1.7-rc.2(本机实测运行)|dsh-0.2.0-rc.2(逐成员静态契约核对通过,实机待验,见docs/DSH-0.2-COMPAT.md)| 作者:啃轮胎的西狐 - 上一代(0.5 线,仍可用,但已不再更新):装在另一个包
@dsh-external/dsh-prompt-optimizer, 最后发布v0.5.0-beta.1;设计与用法见SPEC.md,历史文档(含 0.5 的实测数据)见README-0.5.md—— 那里的数字只属于 0.5,不是 0.6 的效果证据。
许可
BSD-3-Clause · 完全开源,欢迎任何人以任何形式使用、修改、提建议。