Skip to content

Wenext-Pi 轻量化方案 ​

状态:方案已确认,2026-11-13 落实本轮实现,尚未发布。独立评审保留,每个任务累计最多三轮。

目标与边界 ​

面向普通开发者和不同技术栈,让 Pi 帮用户完成工作,而不是要求用户维护一套流程系统。无仓库规则、无测试框架、无 Git 都是正常使用场景。已有业务仓库可以声明自身规范,但不能把某个前端团队的要求变成开源工具的全局前置条件。

默认流程沿用现有 quick、small、standard、infra 分类,不新增“轻量模式”开关、权限配置中心或第二套状态机。quick/small 做必要验证;standard/infra 保留研究、方案、实施、验证的完整过程,但完整过程不等于必须有多份文档、多个代理和多轮批准。

判断一个检查是否应阻断下一步,只问三件事:它保护什么具体结果?现在不检查会造成什么已知问题?是否已有另一处检查同一件事?不能给出具体答案的检查默认改成提示或删除。

默认行为与取舍 ​

范围保留的必要能力停用、收缩或改为可选的机制
扩展工具工具自身认证、真实错误、显式输出路径处理已停用“未登记可信只读能力就要求任务批准”;不增加替代注册流程
任务路由根据用户意图和实际范围选择流程,信息不足时先定向研究简单问题不强制研究报告、独立评审、E2E 或完整文档模板;执行中不因关键词重复升级
方案与批准standard/infra 明确目标、改动边界、验收方法;用户需要审方案时暂停用户已明确要求按具体方案执行时,记录一次授权;不再要求语义相同的第二次弹窗确认。同范围修复、补测试和澄清不重新批准
独立方案评审保留现有风险驱动、仓库强制和用户指定评审;简单低风险仍可自查每个任务累计最多三轮,超时重试、方案修订和重启不重置次数。仍有分歧时汇总交给用户,不自动放行或启动第四轮
写入范围原生写入保留范围约束,提交前核对实际文件;维护规则/技能本身属于合法任务声明目录用于定位工作边界,不因为目录里已有其他文件就要求逐个批准;新增测试、同模块修复自动归入已有范围,真正跨出任务目标再确认
需求文档一个主要方案来源,记录已确认需求、设计状态、验收条件;已有仓库模板继续适用基座不强制复制到 PRD、实施方案、UI 规范、验收文档等多份材料;不做文字一致性“测试”。非业务变化不使整份方案授权失效
图片与上下文保留当前轮主动读图能力;历史内容按需裁剪,原始记录可恢复不能把刚读出的图片立即换成路径后又要求重读;不把 OCR 当成视觉完成证据,不让用户反复重传已有图片
工具并发状态写入原子性、跨进程任务所有权、可取消操作同进程短暂锁冲突内部排队,不默认暴露为模型需重试的错误;纯读取避免获取写锁,不把整个工具网络请求锁成串行
测试运行任务相关的原生命令,保留仓库明确要求;命令退出码、断言和覆盖率分别记录Pi 不统一要求 100% 覆盖率、不默认新建测试框架、不把“框架缺失”作为所有任务的阻断;不为小改动扩大全仓测试或设备矩阵
检查结果保存真实命令、结果和输入范围;实际实现变化使相关证据失效不为了“正式收据”重复运行已有可验证的相同检查;历史失败保留,但新的有效结果可以关闭该失败;纯方案排版不使代码检查过期
人工/外部验收设计对照、真实接口、设备测试分别标明已验证或待验证仅用户或仓库明确要求的项目成为交付条件;一般缺设备或账号不阻止其他开发验证,不把全部外部验收一律变成基座归档门禁
提交精确选择当前任务文件、检查整个暂存区、摘要确认、长内容滚动查看不因“轻量化”恢复 git add . 或自动夹带其他任务文件;不重新引入整屏 diff 审批
归档用户决定归档,代码完成与验证结论真实记录;正常开发任务核对提交状态归档不重新执行所有测试、不新增一次独立评审。明确放弃/移交/已由外部提交上线时,记录实际结论与缺口后允许收纳;不得伪装成验证通过
会话恢复原始会话为历史来源,结合交接后的增量恢复不要求用户手动维护实时交接;交接落后时不退回旧阶段、重建任务或重复执行已完成步骤
指标与附件真实状态、幂等上传、失败可重试、必要诊断信息网络或指标故障不阻断开发和归档;复用内容寻址缓存,减少重复预览和大附件,不把全文反复复制进交接

保留的约束不代表 Pi 是安全沙箱。它负责工作流和结果真实性,执行器负责实际工具权限;不要用工具名猜测和不断增长的命令正则拼出一个不完整的安全边界。

关键场景的具体行为 ​

1. 读取 Figma 或使用其它扩展 ​

安装并完成工具自身认证后即可使用,不要求先批准业务实施方案。当前实现保留了已声明 mutating 的行为,以及显式项目输出的范围处理;未登记工具在没有这些明确写入目标时归为 extension,交给执行器。输出当前任务 research 只需启动任务;输出项目源码按实际写入处理。没有 Figma 专用白名单。

2. 用户补充一个设计状态 ​

“新增 B/C 状态”默认保留原 A 状态;只有用户明确替换才删除 A。更新主方案里的状态映射,并展示此次差异。无需同步五份文档或重新研究全部接口。原型等用户可见交付物若受影响,应同步更新或明确列出待更新项,不能只改方案文字。

3. README、小样式和复杂跨包需求 ​

  • README:quick,完成修改并检查链接/示例等相关内容;不启动业务测试环境。
  • 局部样式:small,检查受影响页面及必要布局;不自动补全项目测试框架。
  • 两应用接口与状态改造:standard,先澄清必要契约,形成一份可执行方案,完成相关单测和集成验证;仅在契约或范围实际变化时重新讨论。
  • 工具链或数据库迁移:infra,保留完整研究和验证,具体破坏性操作单独确认;不以增加文档数量代替迁移与回滚验证。

4. 测试全部断言通过,但覆盖率失败 ​

显示“断言通过,覆盖率失败,命令失败”,不宣称整体成功。覆盖率要求来自仓库,而不是 Pi 的统一默认值。若是配置错误,修复后重新跑受影响检查;不靠删测试、改指标口径掩盖失败。

5. 任务在其它环境完成,需要归档 ​

普通开发完成仍检查当前任务改动是否提交。用户明确说明已经外部提交/上线、放弃或移交时,提供实际结论、可得证据与未验证项即可收纳;不要求复现旧机器、补齐所有历史报告。归档事实与质量通过分开上报,保留原任务身份以免产生重复指标。

实施顺序 ​

  1. 本轮已改:停用扩展可信只读登记作为默认执行前置,更新宿主提示与文档,回归项目输出和状态路径边界。
  2. 先修直接故障:当前轮读图可达、同会话状态锁排队、恢复时合并交接后增量。这些是基座可靠性问题,不交给用户配置解决。
  3. 再减流程成本:保留独立评审并限制三轮,复用明确执行授权,使用单一主要方案来源,按实际行为与范围判断是否重新确认。
  4. 收敛验证和归档:测试按影响面执行,修正原生配置示例;复用可验证结果,区分开发完成、待外部验收与归档收纳。
  5. 清理历史负担:减少重复预览和附件,沿用内容寻址缓存与现有清理策略,不引入新的归档数据库或审核服务。

旧任务保持原始记录和身份;不批量重写历史报告、不自动把失败改成成功。新默认可通过运行策略应用,但仍尊重用户和仓库明确声明的要求。将尚需重复验证的旧记录标为历史或未验证,而不是强制补齐一套新格式后才能继续工作。

验收标准 ​

  • 未登记的 Figma、浏览器和普通扩展工具在规划阶段可调用;工具的认证失败正常呈现。
  • 图像模型最新工具结果在 8 MiB 图片预算内进入本次请求;超限提示裁剪或缩放,不重复要求读取同一超限原图。
  • 同宿主原生写入及相关状态操作等待已有写入完成;读取和普通扩展保持可用,跨进程租约不放宽,等待可取消。
  • 同范围实施修复不重复批准;需求跟进留在原任务并保留已确认状态。正式正文变更仍重新审阅,换行格式和文件末尾空行不使新任务授权失效。
  • README 改动不跑业务 E2E;复杂业务改动仍执行仓库要求的相关检查,不能以轻量化掩盖真实失败。
  • 模型显示“检查通过”时命令必须成功;断言、覆盖率、Mock、真实接口、设备验证能分别识别。
  • 恢复能看到最新进度和未完成项;交接滞后不导致重复实现。
  • 归档不自动提交无关文件、不重跑有效检查;外部完成按真实验证状态上报,不伪造成功或重复任务。

评估收益使用实际重复审批次数、内部锁错误数、工具结果可达性、重复测试次数和完成前交互轮数;不把等待用户的时间全部算成模型执行耗时,也不预估没有测量依据的效率百分比。

本轮实现边界 ​

  • 对话授权要求先展示绑定当前方案和范围的预览链接,再收到原生用户明确的“按这个方案执行”。含糊回复、附带修改要求、已有改动认领和不完整评审接管仍使用具体确认。
  • 新任务只要求一份包含设计与验收的 PRD;仓库额外模板和旧任务契约保留。摘要只忽略 CRLF/LF 和末尾空行差异,正文变更仍须重新审阅。
  • 图像模型最新工具结果在 8 MiB 图片总预算内保留像素;更大图片提示裁剪或缩放,文本模型提示切换能力。相同字节复用附件,后续请求可裁剪历史图片。
  • 同宿主原生写入及相关状态操作等待已有写入完成;读取、无显式写入的扩展继续运行。跨进程租约仍保留,等待可取消。
  • 归档不执行新的检查命令。有效证据可复用;无检查声明时如实记为未验证。外部完成、放弃、移交经用户实际确认后按未验证收纳,保留失败历史。
  • 恢复提示提供当前分支交接之后最多 12 条消息索引;完整会话和真实检查记录仍为依据。