dsh-pua

Brings PUA to DeepSeek Harness. Community-maintained; not an official DeepSeek AI or PUA product.

---

The problem it solves

Poor delivery is usually not a skill gap. It is the absence of any requirement to prove the work:

The core mechanism is pressure that escalates with failure count and drops after genuine acceptance passes. Pressure is not the goal; evidence is.

Features

• Change approach after failure: a failure counter drives L1→L4 escalation, each level mandating a different action (switch approach / search and read source / seven-item checklist / all-out mode).
• Evidence before completion: "done" only counts with command output attached; an independent verification command can be configured so a model's own report is not enough.
• Verification Loops: start a Loop to keep the agent correcting until verification passes, the iteration cap is hit, or you cancel.
• Narration and flavors: 15 company-inspired flavors (Alibaba, ByteDance, Huawei, Tencent, Baidu, Meituan, Jobs, Musk, …) across 10 persona modes (standard P8, P7, P9, P10, Pro, Yes, Mama, Shot, Chinese/English protocols). Narration opens with the active flavor, and wording and keywords follow it.
• Integrity guard (off by default): denies reads of hidden benchmark answers, including web searches for them, and warns before edits touch test, scoring, or CI assets, keeping action rights separate from self-grading rights.
• Progressive prompt loading: added fidelity: lean | balanced | full; default balanced, lean saves more context, and full restores the complete original prompt. pua_reference supports path=index and a section argument.
• Grouped settings panel: configuration is grouped into Basics / Prompt loading / Flavor & role / Reminders & verification, with the last group collapsed by default.
• Global defaults with per-session overrides: plugin settings store global defaults; the chat panel adjusts the current session only, restoring inheritance per item or all at once.

Results depend on the model and task. The plugin does not guarantee a solution every time.

Installation

Requires Node.js 22.19 or later and DSH 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, or 0.2.0-rc.2. Uses your existing DSH model configuration; no additional API key is needed.

Examples use the web profile. Replace it with the profile you use.

Ask an agent to install it

Send this to an agent that can run commands on your computer:

Install @panando/dsh-pua into my local DSH web profile by running dsh plugin --profile web add @panando/dsh-pua@latest --registry=https://registry.npmjs.org/. Check that the plugin loads, then explain how to open PUA settings.

Install manually

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

After the current task finishes, reload DSH or restart its Web service. Refreshing the browser alone is not enough. Enter /pua help to check that the plugin is available.

Usage

1. Open Plugins in the sidebar, open @panando/dsh-pua, and use the package page or the panando-pua row.
2. Enable PUA, choose a flavor and persona, and save.
3. Return to chat and submit tasks as usual.

A PUA entry is always visible in the composer. Clicking it opens a dropdown:

• Turn on / Turn off: toggles PUA for the current session directly, without opening the panel
• Options: opens the configuration panel for flavor, persona, reminders, and Loop

When PUA is off for the session, the label is dimmed with a line through it. The entry is always rendered — the key difference from upstream, see Fork changes.

Configuration

Change global defaults only in plugin settings. Chat controls and commands affect only the current conversation.

Unchanged options follow global defaults; editing one option overrides just that one. "Restore all" at the top of the panel returns to inheritance.

The panel is grouped into three sections:

Subagent enablement also depends on the parent conversation's PUA switch. fidelity can be lean (minimal), balanced (default, loads rule slices on demand), or full (full original prompt, higher context usage). Commands no longer change global settings.

Continue until verification passes

In the chat PUA panel, under "Start or cancel a Loop", enter a task, verification command, and iteration limit, then start it. For example, ask the agent to fix failing tests, verify with npm test, and stop after at most 10 iterations.

You can also enter:

/pua loop "Fix the failing tests and add regression coverage" --verify "npm test" --max-iterations 10

Enter /pua-cancel-loop or /pua cancel-loop to stop. Disabling PUA for the current session also cancels its Loop, but does not undo operations already performed.

Set a verification command and iteration limit when using a Loop. Without a verification command, completion relies on the model's report.

Common commands

Everyday switches, flavors, and personas are available in the UI; memorizing commands is optional.

Fork changes

This repository is derived from @michengai/dsh-pua v0.3.22 and published as the separate package @panando/dsh-pua on npm. It is a fork, not an official release. Original LICENSE and NOTICE are retained.

Removing the upstream global kill-switch

Upstream treats the global alwaysOn setting as a master gate: when off, the composer entry does not render, a session cannot be enabled, and /pua on is rejected. An always-visible entry and a default-off feature therefore cannot coexist.

This fork lifts that restriction: the entry always renders while the feature still defaults to off, and you enable it per session from the composer menu ("Turn on"). The entry is a dropdown (Turn on / Turn off / Options), where the first two take effect immediately and only "Options" opens the panel.

Unifying narration markers (v0.1.3)

The original markers mixed square brackets and icons, which hurt readability. They are now emoji『text』, keeping each marker's original emoji and dropping the trailing flavor word:

This covers 18 upstream asset files across the core protocol, persona modes, and methodology references. The English protocol (pua-en), markdown links, and machine-readable IDs are unchanged.

Shortening UI labels (v0.1.3)

Language "Auto (follow host)" and flavor "Auto-flavor" both become "Auto", so the dropdowns stay compact.

Grouping the settings panel (v0.1.3)

The flat field list becomes three sections — Basics / Flavor & role / Reminders & verification — with the last one collapsed by default. The field set and configuration contract are unchanged; only the presentation order differs.

See CUSTOM-CHANGES.md for the full change list and implementation pitfalls.

Uninstall

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

Reload DSH for the change to take effect. Project files and conversation history are preserved.

License and attribution

Adapted from tanweai/pua 3.5.1.

Original project code uses Apache License 2.0. Bundled PUA assets retain their upstream-declared MIT license and attribution; see NOTICE.