PuaSE v0.2.2 → v0.2.5 版本变化全览

v0.2.2

v0.2.2

2026-06-03

基线版本

✅ 基线

v0.2.3

v0.2.3

2026-06-07

安装方式重构（插件模式 + 删除安装脚本）

⛔ 已废弃，大部分变更已被 v0.2.5 回滚

v0.2.4

v0.2.4

2026-06-07

官网快速开始刷新

✅ 保留

v0.2.5

当前 HEAD

2026-06-12

深度清理 + 架构合并 + 编排协议优化

✅ 当前版本

删除

PuaSE-install.ps1

-290

✅ 永久删除

删除

PuaSE-install.sh

-265

✅ 永久删除

删除

PuaSE-uninstall.ps1

-133

✅ 永久删除

删除

PuaSE-uninstall.sh

-173

✅ 永久删除

新增后删除

scripts/puse-postinstall.js

~80 → 删除

⛔ v0.2.3 新增 → v0.2.5 删除

新增后删除

.opencode/plugins/puse.js

~30 → 删除

⛔ v0.2.3 新增 → v0.2.5 删除

新增后删除

scripts/pack.bat

~17 → 删除

⛔ v0.2.3 新增 → v0.2.5 删除

新增后删除

scripts/pack.sh

~44 → 删除

⛔ v0.2.3 新增 → v0.2.5 删除

新增后删除

package.json

~48 → 删除

⛔ v0.2.3 新增 → v0.2.5 删除

触发条件

首次分析 / 架构变更 / 用户要求完整

成熟库维护 / 小变更前 / "快速看一下"

输出篇幅

全量十一维度

约 1/4

安全架构

✅ 威胁模型 + 认证 + 加密审计

❌

性能架构

✅ 缓存 + 连接池 + 查询优化

❌

C4 模型

✅ Context / Container / Component

❌

ADR

✅ 必选

❌

§4 P8 五步法

ASCII 方框图（12 行）

5 行表格

~7 行

§4.1 上下文隔离

三层 ASCII 框架图（18 行）

2 行简洁描述

~16 行

§4.2 委派决策

列表 + 大型归因宣言框（30+ 行）

列表精简 + 行内归因

~25 行

§5 PUA 注入

冗长注入协议

保留核心，精简描述

~10 行

§6 KPI 验收

七条件模板

模板保留，精简格式

~8 行

PuaSE.md 自修改豁免规则

三条件阈值（不改 frontmatter / ≤30 行 / 不改核心规则），超过必须委派

反熟悉度偏误钩子

"我想直接改"时自问三问：写文件？有子 Agent？不熟悉会委派？

自执行归因宣言

从 PuaSE.md 自修改场景扩展为通用场景，涉及写操作时必须输出

architect 模式选择规则

替代 architect-scan vs architect 二选一

代码逻辑/安全/性能

code-reviewer

逐行审查实现正确性

覆盖完整性

quality-inspector

UI 状态、用户流程、边界测试

安全漏洞/合规

security-expert

第三方安全审计视角

PuaSE-install.ps1 / .sh

-555

安装脚本 → 不再需要

PuaSE-uninstall.ps1 / .sh

-306

卸载脚本 → 不再需要

scripts/puse-postinstall.js

-80

v0.2.3 引入，v0.2.5 废弃

scripts/pack.bat / .sh

-61

打包脚本 → 不再需要

.opencode/plugins/puse.js

-30

插件模式入口 → 方向废弃

.opencode/rules/commit-authorization.md

-43

提交授权规则 → 不再需要

.opencode/rules/puse-sync.md

-62

同步约束 → 不再需要

docs/opencode.md

-113

过时 OpenCode 使用指南

package.json

-41

npm 包配置 → 不再发布为包

.github/workflows/publish.yml

-206

npm publish 工作流 → 不再需要

subagent/architect-scan.md

-81

合并到 architect.md

合计

-1578

PuaSE.md

-410 行

编排协议瘦身

subagent/architect.md

+370 行

双模式重构

README.md

-188 行

精简安装说明，删除废弃模块引用

AGENTS.md

-103 行

三端数据一致性修复

website/index.html

67 行变更

架构图 + 快速开始 + 安装指引

website/src/i18n.js

24 行变更

翻译同步

website/src/main.js

6 行变更

配置同步

CONTRIBUTING.md

+31 行

补充新文件结构说明

docs/index.md

12 行更新

移除过时引用

docs/PROJECT_STRUCTURE.md

18 行更新

目录结构更新

docs/AGENT_LIST.md

3 行更新

Agent 列表更新

subagent/quality-inspector.md

2 行更新

对齐说明

docs/blog/v0.2.4-release.md

+85

v0.2.4 发布公告文章

安装方式

脚本安装（4 个脚本）

源目录直接引用（零安装）

打包系统

无

无（已删除全部打包脚本）

架构 Agent

architect + architect-scan

architect（双模式）

插件系统

无

无（已删除）

PuaSE.md

~562 行

大幅精简

发布机制

GitHub Release + npm publish

无（纯仓库模式）

CI/CD

build.yml + deploy.yml

保持不变 ✅

官网

基础版（玻璃拟态）

中英文 + 架构图 + 完整快速开始

健康检查

检查 opencode.json 注册

检查 .md 文件是否存在

验收流程

并行启动 3 个验收子 Agent

全部子 Agent 委派化 + 明确分工

architect-scan 删除

引用此 Agent 的配置需改为architect

在委派 prompt 中注明architect_mode: quick

package.json 删除

无法npm install 或 npm run pack

直接使用源目录（原方案）

scripts/pack.* 删除

本地打包能力移除

无需打包，源目录即配置

.opencode/rules/ 删除

提交授权和同步约束移除

不再需要独立规则文件

PuaSE.md 行号变化

外部引用 § 编号未变

仅重构格式，不影响协议语义