2026-06-13/2026-06-13
AI相关
浏览 27

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

时间跨度：2026-06-03 ~ 2026-06-12
标签基线：v0.2.2 → 当前 HEAD（v0.2.3、v0.2.4 均为中间过渡版本）
总计提交：27 个 commits（跨 9 个 Merge PR），24 个文件变更，+626 行 / -2260 行净变化

版本时间线

版本标签日期核心主题当前状态
v0.2.2v0.2.22026-06-03基线版本✅ 基线
v0.2.3v0.2.32026-06-07安装方式重构（插件模式 + 删除安装脚本）⛔ 已废弃，大部分变更已被 v0.2.5 回滚
v0.2.4v0.2.42026-06-07官网快速开始刷新✅ 保留
v0.2.5当前 HEAD2026-06-12深度清理 + 架构合并 + 编排协议优化✅ 当前版本

关于 v0.2.3：该版本引入了 npm 插件系统（postinstall、pack 脚本、package.json），但此方向在 v0.2.5 被判定为不符合项目轻量化目标，相关文件已全部删除。仅"删除安装脚本"这一变更被保留。

按主题维度看变化

一、安装方式：脚本安装 → 直接使用源目录

净效果： 仓库不再提供任何安装脚本或 npm 包，用户直接 git clone 后配置 opencode.json 引用源目录即可。

变更历程

v0.2.2: [install.sh, install.ps1, uninstall.sh, uninstall.ps1]  ← 4 个脚本
   ↓
v0.2.3: 脚本全部删除，改为 puse-postinstall.js + package.json  ← 插件模式（已废弃）
   ↓
v0.2.5: postinstall + pack + package.json 全部删除              ← 回归源目录模式
操作文件行数状态
删除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 删除

当前安装方式

git clone https://github.com/zeekling/PuaSE.git
# 在 opencode.json 中将 PuaSE.md 配置为默认 Agent

二、架构 Agent：architect-scan 合并为 architect 双模式

这是 v0.2.2 → v0.2.5 最重要的架构决策。

之前： 两个独立 Agent —— architect（完整设计）和 architect-scan（轻量扫描）

问题：

  • 场景选择困难——PuaSE 需要判断用哪个
  • 两份 frontmatter + prompt，配置冗余
  • 功能边界模糊（轻量扫描到底需要多少维度？）

之后： 一个 Agent 两种模式

architect
├── full 模式  — 十一个维度完整分析（用于首次分析、架构变更评审）
│   ├── §1 目录结构扫描
│   ├── §2 模块依赖分析
│   ├── §3 数据流与关键路径
│   ├── §4 架构模式标注
│   ├── §5 C4 模型建模 (Context/Container/Component)
│   ├── §6 ADR 架构决策记录
│   ├── §7 风险评估
│   ├── §8 技术栈评估
│   ├── §9 适应度函数
│   ├── §10 安全架构设计
│   └── §11 性能架构设计
│
└── quick 模式 — 3 步快速摸底（用于成熟库常规维护、小变更前摸底）
    ├── §1–3 基础扫描
    └── 架构坏味道清单 + 升级建议
维度full 模式quick 模式
触发条件首次分析 / 架构变更 / 用户要求完整成熟库维护 / 小变更前 / "快速看一下"
输出篇幅全量十一维度约 1/4
安全架构✅ 威胁模型 + 认证 + 加密审计❌
性能架构✅ 缓存 + 连接池 + 查询优化❌
C4 模型✅ Context / Container / Component❌
ADR✅ 必选❌

影响文件： subagent/architect-scan.md 删除（-81 行），subagent/architect.md 重构（+370 行）

三、PuaSE.md 编排协议瘦身

净减约 410 行（从 ~562 行大幅缩减），核心手段：用表格/列表替换冗长的 ASCII 流程图。

逐节对照

节之前之后节省
§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 二选一

其他协议优化

  • 健康检查：从检查 opencode.json 注册 → 改为检查 .md 文件是否存在（仓库侧只管文件完整性）
  • 验收流程：从"开发者返回后并行启动" → 改为全部通过子 Agent 委派完成，PuaSE 只管 KPI 卡输出
  • 验收分工明确化：
验收维度主检 Agent说明
代码逻辑/安全/性能code-reviewer逐行审查实现正确性
覆盖完整性quality-inspectorUI 状态、用户流程、边界测试
安全漏洞/合规security-expert第三方安全审计视角

四、文件清理大盘点

永久删除的文件（12 个）

文件行数删除原因
PuaSE-install.ps1 / .sh-555安装脚本 → 不再需要
PuaSE-uninstall.ps1 / .sh-306卸载脚本 → 不再需要
scripts/puse-postinstall.js-80v0.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-41npm 包配置 → 不再发布为包
.github/workflows/publish.yml-206npm publish 工作流 → 不再需要
subagent/architect-scan.md-81合并到 architect.md
合计-1578

重构的文件（11 个）

文件幅度说明
PuaSE.md-410 行编排协议瘦身
subagent/architect.md+370 行双模式重构
README.md-188 行精简安装说明，删除废弃模块引用
AGENTS.md-103 行三端数据一致性修复
website/index.html67 行变更架构图 + 快速开始 + 安装指引
website/src/i18n.js24 行变更翻译同步
website/src/main.js6 行变更配置同步
CONTRIBUTING.md+31 行补充新文件结构说明
docs/index.md12 行更新移除过时引用
docs/PROJECT_STRUCTURE.md18 行更新目录结构更新
docs/AGENT_LIST.md3 行更新Agent 列表更新
subagent/quality-inspector.md2 行更新对齐说明

新增的文件（1 个）

文件行数说明
docs/blog/v0.2.4-release.md+85v0.2.4 发布公告文章

五、设计理念演进

v0.2.2: "能跑就行"
        基础架构搭建、npm 发布流水线就绪、安装脚本就位

v0.2.3: "试一下插件模式"  ← 已废弃
        从脚本安装转向 npm 插件模式，但增加了复杂度
        └── 教训：插件模式带来额外维护成本，不符合项目轻量化目标

v0.2.4: "文档要说清楚"
        官网快速开始重写，前置条件和验证步骤明确化

v0.2.5: "减法：回到本质"
        删除所有安装/打包/插件系统，回归"源目录即配置"的简洁设计
        合并冗余 Agent，协议瘦身，保持核心编排逻辑

最后的架构对照

维度v0.2.2（基线）v0.2.5（当前）
安装方式脚本安装（4 个脚本）源目录直接引用（零安装）
打包系统无无（已删除全部打包脚本）
架构 Agentarchitect + architect-scanarchitect（双模式）
插件系统无无（已删除）
PuaSE.md~562 行大幅精简
发布机制GitHub Release + npm publish无（纯仓库模式）
CI/CDbuild.yml + deploy.yml保持不变 ✅
官网基础版（玻璃拟态）中英文 + 架构图 + 完整快速开始
健康检查检查 opencode.json 注册检查 .md 文件是否存在
验收流程并行启动 3 个验收子 Agent全部子 Agent 委派化 + 明确分工

升级指南（v0.2.2 → v0.2.5）

安装方式变更

v0.2.2: git clone + 运行安装脚本
v0.2.5: git clone + 在 opencode.json 中引用 PuaSE.md

需要关注的变更

变更影响应对
architect-scan 删除引用此 Agent 的配置需改为architect在委派 prompt 中注明architect_mode: quick
package.json 删除无法npm install 或 npm run pack直接使用源目录（原方案）
scripts/pack.* 删除本地打包能力移除无需打包，源目录即配置
.opencode/rules/ 删除提交授权和同步约束移除不再需要独立规则文件
PuaSE.md 行号变化外部引用 § 编号未变仅重构格式，不影响协议语义

本文档由 PuaSE 全局编排 Agent 基于 git log 分析自动生成。

# opencode  多agent 

标 题：《PuaSE v0.2.2 → v0.2.5 版本变化全览》
作 者：zeekling
提 示：转载请注明文章转载自个人博客：浪浪山旁那个村

评论

取消