Repository navigation
稳定版:内网能装能用、在 Paseo 网页端审查原型、不靠看图检查界面、看得见 token 花在哪。内容包括 1.13.0-beta.1 至 beta.5(详见下面各条)和下面新增的三项,设计决定见 ADR 0032、0033。
使用者会看到的变化
- 内网安装和文档:
npx -y [--registry=<镜像地址>] paseo-req-kit@latest install一条命令装好,只需要 npm 源;req docs在本机打开文档站点。 - 在 Paseo 里审查原型:需求页面和"等你处理"里的主按钮"审查原型并确认方案",在原型上点要改的地方、选改法、用自己的话补一句,提交后整理成清单交给需求会话。
- 界面检查
req ui-check:用本机的 Edge 或 Chrome,用文字报告显示不全、遮挡、超出屏幕、文字太淡、没名字的控件、报错,并和确认过的原型对文字;功能验证自动使用,不需要模型看图。 - token:
req stats和插件的"token 花在哪";可选的每个需求预算(budget);开始时和req status里的"预计还要多久"。 - 后台进程意外退出时由插件直接继续,不再每小时叫醒对话;等待批准的权限进"等你处理"。
- 新增:打断大目录搜索(
scanGuard,默认开):步骤 agent 搜索整个磁盘、用户目录、Maven 本地仓库(~/.m2)、Gradle 缓存、全局或整个node_modules时,流水线一分钟后打断这个命令,并告诉 agent 改用什么办法(git grep、按坐标直接打开那一个依赖、mvn dependency:tree);任何搜索运行超过 5 分钟也打断。构建和测试命令不受影响。各步骤的提示词也写明了只在仓库里搜索。 - 新增:预算不起作用时会说:agent 不报告 token 用量时,设了预算的需求在第一步之后提醒一次"预算不会起作用",
req doctor也会检查。 - 新增:从别的电脑打开审查页时说明原因:审查页默认只在运行 Paseo 的电脑上能打开;从别的电脑打开 Paseo 网页、点"审查原型"时,页面写明为什么看不到、怎么设置。只设
REQ_KIT_REVIEW_HOST时,审查页地址用这台电脑的计算机名。
升级须知
- 新配置都可选:
budget(默认不限)、scanGuard(默认开:{ "enabled": true, "minutes": 5, "paths": [] },关闭写"enabled": false)。 - 打开
scanGuard时,流水线每分钟查看一次步骤 agent 的状态(以前每 10 分钟),只是读取状态,不占模型 token。 - 原型按新约定写(
data-ac、data-label、<section data-state>、不写脚本),旧原型照常能看,只是审查页认不出区域和状态。 - 1.12 时预约的"对话定时检查"会留到过期(最多 3 天),装了插件后新需求不再预约,不用手动删。
- 装过插件的,
req upgrade会一并更新插件。新的安装脚本只能安装 1.13 及以后的版本。 - 状态文件、使用记录和
req api的新增字段见各 beta 的升级须知;recoveries新增stop_scan。 - 发布前 Linux 和 Windows 的测试都必须通过。