Skip to content

dsh-pua

Verified

@michengai/dsh-pua · v0.3.13 · Apache-2.0 · Web UI

PUA 的 DSH 实现:完整协议、全局与会话配置、角色风味、子代理策略与独立验收 Loop

Install

dsh plugin add @michengai/dsh-pua

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Readme

DSH PUA

DSH PUA

让 Agent 少一点敷衍,多一点尝试和验证

English · 功能概览 · 界面预览 · 安装 · 使用 · 配置 · 常用命令 · 更新日志

npm version npm downloads CI 许可证:Apache-2.0 DSH Web Plugin Node.js 22.19+

DSH PUA 将 原版 PUA 带到 DeepSeek Harness,在 Agent 反复失败、过早放弃或草率宣告完成时,引导它换方法、查原因、拿证据。社区维护,非 DeepSeek AI 或 PUA 官方产品。

功能概览

  • 遇到困难换方法:提醒 Agent 重新检查思路,避免重复无效尝试。
  • 完成前检查证据:要求核对结果,减少“说完成了,却没有验证”的情况。
  • 选择你喜欢的风格:支持 15 种大厂风味,以及 P7、P9、P10、夸夸、妈妈等角色模式。
  • 在界面中调整:插件设置保存全局默认,聊天入口可以单独调整当前会话。
  • 按验收结果继续任务:可启动 Loop,让 Agent 继续修正,直到验收通过、达到轮次上限或被取消。

实际效果取决于所用模型和任务,插件不保证每次都能解决问题。

界面预览

全局配置

在「设置 → 插件 → PUA 配置」设置默认开关、风味、角色和子代理选项,保存后供会话使用。

PUA 全局配置:开关、风味、角色模式和子代理选项

当前会话配置

点击专家入口右侧的 PUA,单独调整当前会话。修改项可以恢复默认,也可以在面板中启动或取消 Loop。

聊天中的 PUA 入口与当前会话配置面板

DSH 产品生态

想使用桌面工作台,可下载 DSH Codex Desktop;已有 DeepSeek Harness 环境,可按各项目 README 按需安装。以下列出 11 个自研插件;桌面端实际随附范围以对应版本的发行说明和内置清单为准。

插件 你可以用它做什么
Codex UI 整理项目与会话、搜索任务、跳转对话轮次
Agency Agents 按任务选择并召唤专业角色
Skills Manager 统一查找、启停、创建和导入本机技能
Archive Manager 搜索、恢复或清理已归档会话
IM Connect 从消息平台下任务、收回复
Automation 按计划执行任务,查看每次运行的结果
BTW 在当前上下文中临时旁问,不打断主任务
Simplify /simplify 整理 Git 改动范围内的代码
PUA 引导 Agent 在失败时换方法、查原因,并在完成前验证结果
Code Review /review 发起独立 Agent 代码审查,在当前会话接收报告
Codex Pet 通过桌面宠物查看会话提醒、处理工具审批和问题回答

安装

需要 Node.js 22.19 或更新版本,以及 DSH 0.1.2-rc.10.1.5-rc.10.1.5-rc.20.1.6-alpha.1。使用 DSH 已有的模型配置,无需额外密钥。

以下示例使用 web profile,请替换为实际使用的 profile。

让 Agent 帮你安装

把下面这段话发给能够操作本机终端的 Agent:

请将 @michengai/dsh-pua 安装到本机 web profile,执行 dsh plugin --profile web add @michengai/dsh-pua@latest --registry=https://registry.npmjs.org/。完成后检查插件是否加载,并告诉我如何打开 PUA 配置。

手动安装

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-pua@latest --registry=https://registry.npmjs.org/

等待当前任务结束后,重新加载 DSH 或重启 Web 服务;仅刷新浏览器不够。输入 /pua help 可检查插件是否可用。

使用

  1. 打开「设置 → 插件」,在第一个「插件配置」页签中展开「PUA 配置」。
  2. 开启 PUA,选择喜欢的风味和角色,保存设置。
  3. 回到聊天,像平时一样提交任务。

聊天输入栏专家入口右侧会显示 PUA,点击即可查看或调整当前会话。当前会话关闭时,PUA 文字显示斜线;全局关闭时,聊天入口隐藏。

配置

全局默认只在插件配置页修改。聊天面板和命令只影响当前会话。

不修改就使用全局默认;修改某一项,只覆盖这一项。点击「恢复默认」即可重新跟随全局,也可以一次恢复全部。

可以调整什么 说明
PUA 开关 默认开启,可单独关闭当前会话
风味与角色 自动选味或指定风味,选择不同角色模式
对子代理启用 默认关闭;需要让专家等子代理也使用 PUA 时再开启
纠偏提醒 调整终端核验、失败升级与质量提醒
反馈提醒 调整提醒频率,或关闭提醒;插件不上传反馈
Loop 默认值 设置验收命令、超时时间和轮次上限

0.3.0 起,命令不再修改全局设置。子代理是否使用 PUA 还受父会话开关控制。

让任务按验收结果继续

在聊天 PUA 面板中填写 Loop 任务、验收命令和轮次上限,再点击启动。例如,让 Agent 修复测试,使用 npm test 检查结果,最多执行 10 轮。

也可以直接输入:

/pua loop "修复当前测试失败并补齐回归" --verify "npm test" --max-iterations 10

需要停止时输入 /cancel-pua-loop。关闭当前会话 PUA 也会取消 Loop,但不会撤回已经执行的操作。

建议设置验收命令和轮次上限:未设置验收命令时,只依据模型报告判断完成;轮次上限为 0 表示不限轮次。

常用命令

日常开关、风味和角色都可以在界面操作,无需记住命令。

目标 命令示例
开启或关闭当前会话 PUA /pua on/pua off
指定风味 /pua flavor huawei
让 Agent 换个方法 /pua again
检查是否真的完成 /pua done-check
检查交付证据 /pua evidence
只读审查当前改动 /pua review
恢复当前会话的全局默认 /pua reset
取消验收循环 /cancel-pua-loop
查看状态或完整用法 /pua status/pua help

卸载

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web remove @michengai/dsh-pua

重新加载 DSH 后生效,业务文件和会话记录会保留。

来源与许可

基于 tanweai/pua 3.5.1 适配。角色和协作能力以 DSH 实际支持为准。

本项目原创代码采用 Apache License 2.0。随包提供的 PUA 素材保留上游声明的 MIT 许可及署名,详见 NOTICE