@michengai/dsh-pua 0.3.8

package/CHANGELOG.md

@@ -0,0 +1,152 @@
+# 更新记录
+
+## 0.3.8
+
+### 中文
+
+- 首次公开发布：将 PUA 3.5.1 的任务推进、角色风味和证据检查带到 DSH，支持显式验收 Loop。
+- 在插件设置中保存全局默认，通过专家右侧的 PUA 入口调整当前会话；修复全局保存错误、会话输入校验和审批拒绝误计失败。全局默认开启，聊天操作只覆盖当前会话，子代理默认关闭。
+- 支持 DSH 0.1.2-rc.1、0.1.5-rc.1 和 0.1.5-rc.2。原创代码采用 Apache-2.0，上游 PUA 素材保留 MIT 声明与署名。真实模型效果因任务和模型而异。
+
+### English
+
+- First public release: bring PUA 3.5.1 task persistence, personas, styles, and evidence checks to DSH, with explicit verification loops.
+- Save global defaults in plugin settings and adjust individual sessions through the PUA entry to the right of Experts. Fix global saves, session input validation, and approval denials being counted as failures. PUA is enabled globally by default; chat changes affect only the current session, and subagents are disabled by default.
+- Support DSH 0.1.2-rc.1, 0.1.5-rc.1, and 0.1.5-rc.2. Original code uses Apache-2.0; upstream PUA assets retain their declared MIT license and attribution. Actual results vary by task and model.
+
+## 0.3.7（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 修复未完成工具调用长期阻塞 PUA 状态同步，以及无 settings 宿主的会话配置降级问题。
+- 修复 Loop 表单长度限制冲突、同值命令误报配置冲突、子会话保存反馈和输入校验；保留 Oracle 的真实非零退出码。
+- 终端成功会清除连续失败观察，每轮候选提示最多四次，权限边界不计入升级；全局开关和会话覆盖规则不变。
+
+### English
+
+- Fix unfinished tool calls blocking PUA state persistence and restore session-only fallback on hosts without settings.
+- Fix Loop form limits, false configuration conflicts from unchanged commands, child-session save feedback, and input validation; preserve native Oracle exit codes.
+- Successful terminal results reset consecutive failure observations; candidate prompts are capped at four per turn and permission errors are excluded. Global and session override rules remain unchanged.
+
+
+## 0.3.6（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 加快新会话 PUA 入口显示：全局开启后先显示入口，会话配置就绪后即可操作；初始化失败时快速重试。
+
+### English
+
+- Show the PUA entry as soon as global enablement is confirmed, enable it when session configuration is ready, and retry initialization failures sooner.
+
+## 0.3.5（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 修复配置下拉菜单向右溢出：菜单右边缘对齐按钮，向左展开。
+
+### English
+
+- Fix configuration dropdowns overflowing to the right by aligning menus with the right edge of their triggers.
+
+## 0.3.4（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 下拉触发及表单操作改用宿主 Button，标签与下拉控件同排，不再使用另起一行的矩形按钮。
+- CHAT 入口仅显示 PUA，当前会话关闭时加斜线；全局关闭仍隐藏入口。
+
+### English
+
+- Dropdown triggers and form actions now use the host Button component, with labels and dropdowns on the same row.
+- The chat entry displays only PUA, crossed diagonally when the session is disabled; global disablement still hides the entry.
+
+## 0.3.3（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 全局关闭 PUA 时隐藏聊天入口，重新开启后恢复；仅关闭当前会话时仍保留入口。
+
+### English
+
+- Hide the chat entry when PUA is globally disabled and restore it when re-enabled. Disabling only the current session keeps the entry available.
+
+## 0.3.2（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 设置中的菜单、开关和图标改用宿主公共控件，卡片对齐官方插件配置的布局与主题样式。
+- 聊天 PUA 入口仅显示开启或关闭，风味与自定义状态仍可在面板查看。
+
+### English
+
+- Settings now use shared host menus, switches, and icons; the card follows the official plugin configuration layout and theme tokens.
+- The chat PUA entry shows only enabled or disabled status; flavor and overrides remain available in the panel.
+
+## 0.3.1（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- PUA 全局配置移入官方“插件配置”首个 TAB 的可展开卡片，不再新增独立 TAB。
+- 会话参数可直接修改，自动形成覆盖；移除配置来源下拉框和重复生效值，仅自定义项提供恢复默认。
+
+### English
+
+- Moved global PUA settings into an expandable card in the official first Plugin configuration tab, removing the separate tab.
+- Session fields can be edited directly to create overrides. Removed source selectors and duplicate effective values; customized fields offer a reset action.
+
+## 0.3.0（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 新增「设置 → 插件 → PUA 配置」和聊天栏 PUA 入口，支持全局默认、逐项会话覆盖与恢复继承；Loop 表单可单独指定本次验收参数。
+- **行为变化：** 命令仅修改当前会话，不再写全局；未覆盖项动态跟随全局，旧 profile 设置保留。Loop 省略参数时使用会话生效默认值，启动后保持快照。
+- 新增对子代理启用开关，默认关闭；开启后继承父会话生效配置，父会话关闭时不能强制开启，不继承父 Loop 或失败计数。
+
+### English
+
+- Added PUA configuration under Settings → Plugins and a chat toolbar entry, with global defaults, per-field session overrides, inheritance reset, and per-run Loop verification parameters.
+- **Behavior change:** commands now update only the current session, never global defaults. Unmodified fields follow global changes, existing profile settings are retained, and omitted Loop arguments use effective session defaults frozen at startup.
+- Added an opt-in subagent switch, disabled by default. Enabled subagents inherit effective parent configuration, cannot override a disabled parent, and do not inherit its Loop or failure count.
+
+## 0.2.1（本地版本，未公开发布 / Local build, not publicly released）
+
+### 中文
+
+- 新增 DSH `0.1.5-rc.1`、`0.1.5-rc.2` 支持，保留 `0.1.2-rc.1`，适配 V3 会话上下文与旧历史修复。旧插件包不支持新版宿主；已迁移的 V3 日志不能直接交给旧宿主回退读取。
+- 新版持久终端的疑似退出或超时文本触发一次待核验提示，不累计为确认失败或自动升级压力；显式 Loop 仍使用独立验收。
+- 修复工具调用与结果被 PUA 消息打断的问题，兼容结果齐全的受影响历史；运行状态 JSON 在模型上下文中显示为简短说明，并修正 Windows 验收命令的引号传递。
+
+### English
+
+- Added support for DSH `0.1.5-rc.1` and `0.1.5-rc.2`, retaining `0.1.2-rc.1`, with V3 session context support and legacy history repair. Older plugin packages do not support the newer hosts; migrated V3 logs cannot be read directly by an older host after a downgrade.
+- Suspected exit or timeout text from persistent terminals now prompts verification once, without counting confirmed failures or automatically escalating pressure. Explicit Loops continue to use independent verification.
+- Fixed PUA messages interrupting tool calls and results, with compatibility repair for affected history containing all results. Runtime JSON appears as a brief note in model context, and Windows verification commands preserve quotation marks.
+
+## 0.2.0
+
+**升级行为变化：** 相比 0.1.1 默认关闭，宿主提供 settings 时默认开启并使用 auto 选味；已有显式会话配置仍优先。没有 settings 时仍默认关闭。
+
+- 用 PUA 3.5.1 完整核心替换自写摘要，恢复人格、旁白、Banner、诊断、认知换框及 Owner 协议。
+- 收录 85 个固定 Git 提交的原始文件，提供完整资料工具；新增角色模式和自动选味。
+- 接入标准 DSH 设置页，支持默认开启、锁定风味、离线与反馈频率，保留会话显式配置优先。
+- 移植终端失败候选和用户质量纠偏，保留条件门控，排除取消、拒绝和文本伪退出码。
+- 实现显式 Loop、独立 PowerShell 验收、拒绝重试、上限、暂停、取消和卸载回收。
+- 保留原版本地问卷和 Pro 协议，明确团队资源、权限策略及恢复方式的平台差异。
+
+## 0.1.1
+
+- 修复 `/pua in` 等疑似拼错和未实现子命令被当作任务，兼容单层重复命令前缀。
+- 引入原版 Again、Done Check、Evidence 输出模板，补齐开工与交付旁白、纯分析诊断及证据门槛。
+- 新增 `/pua review [范围]` 和精确中文审查入口，利用可选宿主 subprocess 采集只读 Git 索引事实。
+- 区分已确认发现和待验证疑点，防止把本地目录误判为提交记录；预检取消、卸载及并发关闭保持正确状态。
+- 保留 0.1.0 成功命令的历史含义；素材增加固定 Git 提交对象指纹。
+
+## 0.1.0
+
+- 初始化 DSH 原生 PUA 插件，提供 `/pua` 及当前任务控制、换方法和验收命令。
+- 加入 15 种风味、按风味注入方法论和固定来源素材校验。
+- 根据当前会话成功命令恢复配置，隔离分叉、失败命令和未完成命令。
+- 提供严格 TypeScript 构建、宿主测试、本地打包和开发文档。
+
+当前为本地开发版本，尚未公开发布。

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 MichengAI
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,38 @@
+DSH PUA 是 MichengAI 开发的社区 DSH 插件，不是 DeepSeek 或 PUA 上游发布的官方产品。
+
+第三方内容：assets/pua 下的 flavors.md、methodology-*.md、command-*.md，
+以及 assets/pua/upstream 下收录的 skills、commands、agents、hooks 文件。
+来源：https://github.com/tanweai/pua
+作者：探微安全实验室（依据上游 plugin.json 的 author 字段）。
+来源版本：3.5.1。
+来源提交：e6e6cd237ad17750d179674bff52f8184abea8fd。
+许可声明：MIT（上游 plugin.json、.claude-plugin/plugin.json、skills/pua/SKILL.md）。
+
+旧版扁平 Markdown 保留本机检出的 CRLF 字节，与固定 Git 对象仅换行不同。
+upstream 目录的新文件保留固定提交 Git 对象的原始字节。
+文件清单、本地字节 SHA-256 和 Git 对象字节 gitBlobSha256 见 assets/pua/upstream.json。
+本插件完整注入核心及选定模式并追加 DSH 接口映射。hooks 用作参考及模板来源，
+运行机制由 TypeScript 对接 DSH，不执行原版安装器或 shell hooks。
+当前来源快照没有独立 LICENSE 文件，GitHub license API 也未提供该文件；这里记录元数据声明，
+不声称取得了上游独立版权文件。原作者权利不因本项目 LICENSE 中的 MichengAI 署名而改变。
+本项目原创代码、构建脚本与文档采用 Apache-2.0，见 LICENSE。上述第三方素材仍按上游声明的 MIT 许可提供，不因本项目协议变更而改变。公开发布前应复核上游许可及署名要求。
+
+MIT License（第三方素材许可标准文本；作者与来源见上文）
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+<div align="center">
+
+# DSH PUA
+
+**让 Agent 少一点敷衍，多一点尝试和验证**
+
+[功能概览](#功能概览) · [界面预览](#界面预览) · [安装](#安装) · [使用](#使用) · [配置](#配置) · [常用命令](#常用命令) · [更新日志](CHANGELOG.md) · [Apache-2.0](LICENSE)
+
+[![许可证：Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+[![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/deepseek-ai/deepseek-harness)
+[![Node.js 22.19+](https://img.shields.io/badge/Node.js-22.19%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
+
+</div>
+
+> DSH PUA 将 [原版 PUA](https://github.com/tanweai/pua) 带到 DeepSeek Harness，在 Agent 反复失败、过早放弃或草率宣告完成时，引导它换方法、查原因、拿证据。社区维护，非 DeepSeek AI 或 PUA 官方产品。
+
+## 功能概览
+
+- **遇到困难换方法**：提醒 Agent 重新检查思路，避免重复无效尝试。
+- **完成前检查证据**：要求核对结果，减少“说完成了，却没有验证”的情况。
+- **选择你喜欢的风格**：支持 15 种大厂风味，以及 P7、P9、P10、夸夸、妈妈等角色模式。
+- **在界面中调整**：插件设置保存全局默认，聊天入口可以单独调整当前会话。
+- **按验收结果继续任务**：可启动 Loop，让 Agent 继续修正，直到验收通过、达到轮次上限或被取消。
+
+实际效果取决于所用模型和任务，插件不保证每次都能解决问题。
+
+## 界面预览
+
+### 全局配置
+
+在「设置 → 插件 → PUA 配置」设置默认开关、风味、角色和子代理选项，保存后供会话使用。
+
+![PUA 全局配置：开关、风味、角色模式和子代理选项](assets/screenshots/pua-global-settings.png)
+
+### 当前会话配置
+
+点击专家入口右侧的 **PUA**，单独调整当前会话。修改项可以恢复默认，也可以在面板中启动或取消 Loop。
+
+![聊天中的 PUA 入口与当前会话配置面板](assets/screenshots/pua-session-settings.png)
+
+## DSH 产品生态
+
+以下是可配合使用的同系列项目，按实际需要选择：
+
+| 项目 | 你可以用它做什么 |
+| --- | --- |
+| [Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop) | 使用集成 DSH Web 的桌面工作台 |
+| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
+| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从消息平台下任务、收回复 |
+| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看每次运行的结果 |
+| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 查找、启停、创建和导入本机技能 |
+| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
+| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
+| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问，不打断主任务 |
+| [Simplify](https://github.com/MichengAI/dsh-simplify) | 整理 Git 改动范围内的代码 |
+
+## 安装
+
+需要 Node.js 22.19 或更新版本，以及 DSH `0.1.2-rc.1`、`0.1.5-rc.1` 或 `0.1.5-rc.2`。使用 DSH 已有的模型配置，无需额外密钥。
+
+以下示例使用 `web` profile，请替换为实际使用的 profile。
+
+### 让 Agent 帮你安装
+
+把下面这段话发给能够操作本机终端的 Agent：
+
+```text
+请将 @michengai/dsh-pua 安装到本机 web profile，执行 dsh plugin --profile web add @michengai/dsh-pua@latest --registry=https://registry.npmjs.org/。完成后检查插件是否加载，并告诉我如何打开 PUA 配置。
+```
+
+### 手动安装
+
+```powershell
+[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 轮。
+
+也可以直接输入：
+
+```text
+/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` |
+
+## 卸载
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web remove @michengai/dsh-pua
+```
+
+重新加载 DSH 后生效，业务文件和会话记录会保留。
+
+## 来源与许可
+
+基于 [tanweai/pua](https://github.com/tanweai/pua) 3.5.1 适配。角色和协作能力以 DSH 实际支持为准。
+
+本项目原创代码采用 [Apache License 2.0](LICENSE)。随包提供的 PUA 素材保留上游声明的 MIT 许可及署名，详见 [NOTICE](NOTICE)。

package/assets/pua/command-again.md

@@ -0,0 +1,23 @@
+---
+description: "PUA Again — 用于再试试、换个方法、别放弃、为什么还不行、同一路径失败多次；要求停止微调同一思路，改用本质不同方案。"
+argument-hint: "[problem-or-failure-context]"
+---
+
+启用 **PUA Again / 换方法模式**。这是轻量快速入口，默认不要读取额外文件，除非用户明确要求完整 PUA 方法论。
+
+输出结构：
+
+```text
+失败模式：<原地打转/证据不足/质量不够/空口完成/需求不清>
+停止动作：不要继续做什么
+路径 A：<本质不同方案>；验证：<如何知道它有效>
+路径 B：<本质不同方案>；验证：<如何知道它有效>
+下一步：<先跑哪一步>
+```
+
+规则：
+
+- 不要继续微调同一方案；
+- 至少给 2 个本质不同路径，不是换参数；
+- 每个路径必须有验证标准；
+- 可以带一句当前味道提醒，但不要长篇大作文。

package/assets/pua/command-done-check.md

@@ -0,0 +1,21 @@
+---
+description: "PUA Done Check — 用于没跑测试别说完成、已完成但没证据、done without proof、需要验收/回归/交付质量检查的场景。"
+argument-hint: "[claim-or-task]"
+---
+
+启用 **PUA Done Check / 完成质量检查**。
+
+先读取：
+
+1. `skills/pua/references/methodology-ding.md`（如果用户提到钉味/置身钉外/老板体感/周报）
+
+不要默认读取完整 `skills/pua/SKILL.md`；本命令是轻量完成检查入口。
+
+输出必须区分：
+
+- `claim`：用户或 agent 口头声称完成了什么；
+- `evidence`：已经有的命令输出、日志、截图、测试、文件、可观察结果；
+- `missing`：还缺哪个验收动作；
+- `status`：`candidate` / `needs_check` / `done_with_evidence`。
+
+如果没有证据，不要说完成；输出下一条最小验证动作。

package/assets/pua/command-evidence.md

@@ -0,0 +1,18 @@
+---
+description: "PUA Evidence — 用于证据呢、数据在哪、验收标准是什么、怎么证明完成、需要证据链/交付物核对的场景。"
+argument-hint: "[task-or-claim]"
+---
+
+启用 **PUA Evidence / 证据链模式**。这是轻量快速入口，默认不要读取额外文件。
+
+输出结构：
+
+```text
+目标：真实要证明的结果
+证据：已有证据；没有就写“暂无”
+缺口：还缺什么验证
+动作：下一步最小可执行验证动作
+状态：candidate / needs_check / done_with_evidence
+```
+
+原则：不要用口头自信替代证据；不要用周报、体感、口径替代真实验收。若用户提到无招/老板体感/周报/置身钉外，可以加一条 markdown blockquote（`> `）提醒。