1.14.0-beta.3

使用者会看到的变化

• 验收清单（req checklist <需求>，插件需求页面上的"验收清单（可一键试用）"）：按需求说明的验收标准生成清单，每条写着前置条件、操作、预期结果和流水线的验证结果，没验证或没通过的排在前面，报告里"需要你确认的决定"也列上。逐条点"通过 / 不对 / 先不验"，进度自动保存；提交后写成 acceptance.md 并提交，不通过时把不对的地方转给需求的对话。
• 一键试用（req try <需求>，验收清单页右上角"把它跑起来试用"）：用项目的 Paseo 服务脚本在需求自己的工作区里启动，给出访问地址和提测说明里的测试账号、数据；--stop 或"停止试用"停掉。没有服务脚本的项目给出提测说明里的启动方法。

升级须知

• req api review-url 新增 --page check；req reply 新增 --acceptance（验收页用）。验收页和原型审查页是同一个本机服务。

1.14.0-beta.2

使用者会看到的变化

• 修复：已经开发完（待验收、已验收）的需求在插件里显示"已确认，未开始开发"和"开始开发"按钮。 需求分支合并到主分支后，主分支里的需求文件夹没有运行状态（运行状态不提交），beta.1 把它当成了没开始。现在看到方案、完成报告等只有流水线才会写的文件，就按已开发处理：有完成报告的显示"待验收"（或验收记录里的结论），不会进"等你处理"。

1.14.0-beta.1

使用者会看到的变化

• 修复：自动新建工作区后只有需求说明、没有代码。 以前新建工作区只等 2 分钟，超时（大仓库在 Windows 上常见）或建好后启动前的检查没通过，启动命令就退出了，留下一个只有需求说明提交的分支；再启动又报"分支已存在"。现在工作区一建好就记下来，再次启动会在这个工作区里接着开始；最多等 15 分钟。以前版本留下的这种工作区，也会由 Paseo 接手接着做。
• 访谈改过的术语表（GLOSSARY.md）和设计决定（docs/adr/）随需求说明一起带到新工作区，在需求自己的分支上提交。
• 修复：需求说明可能被提交到主分支。 写需求说明的说明和"新需求"手册对是否提交说法不一致，现在统一为：要自动新建工作区的，确认后不提交，由流水线在新工作区里提交。需求说明已经提交在主分支上、本地主分支比远端落后、主目录还有别的未提交改动时，启动结果里会写明。
• 需求从开始谈就出现在插件里（"对齐中"）：建好功能目录后 /req 会登记它（start-pipeline --feature <功能目录> --track）；没登记的，插件也会在本机用过的项目里找到。
• 确认了却没开始开发的需求进"等你处理"：需求说明确认超过 30 分钟还没开始，或者上次启动没成功，插件里显示"还没开始开发"，点"开始开发"即可：在项目主目录中会新建（或接着用）需求自己的工作区，进展发回谈需求的那个对话。

升级须知

• req api list --all 也会列出对齐中的需求（没有运行状态）；attention 新增 not_started，waiting 新增 canStart；req api run 新增 start；需求索引新增可选的 chatAgentId；新增 ~/.req-kit/worktrees/ 记录。
• 更新后请在 Paseo 中重新加载插件（req upgrade 会自动做）。

1.13.0

稳定版：内网能装能用、在 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 的测试都必须通过。

1.13.0-beta.5

使用者会看到的变化

• Windows：配置成 .js / .mjs 脚本的外部命令能运行了：对接外部系统（integrations）、合并请求（push.mergeRequest）等配置的命令是一个 JavaScript 文件时，以前在 Windows 上启动不了（Windows 不认文件开头的 #!/usr/bin/env node），现在用 Node.js 运行它，其他系统也不再需要给脚本加执行权限。

维护

• 测试改为可以在 Windows 上运行（用 Node.js 直接启动 tsx；只能在 sh 下运行的几项在 Windows 上跳过），CI 的 Windows 任务把失败的测试和报错写在运行结果页上。

1.13.0-beta.4

使用者会看到的变化

• token 花在哪：req stats 和插件的"使用统计"页新增一节，按步骤、按模型列出 token（输入 + 输出）和占比，单独算出返工（方案修订、评审问题修复、缺陷修复、复验，以及第 2 轮起的审核和评审）占了多少、输入中多少来自提示缓存、每个完成需求的中位数。每一步用的模型从这个版本开始记录。
• token 预算（可选，budget.tokens）：用到 budget.warnPercent（默认 80%）时在对话里告知一次；用完时已完成的步骤保留，在下一步开始前停下，问需求方是否继续，继续会再给一份预算。
• 还要多久：本机已完成 3 个以上同档位需求后，开始开发时给出这类需求通常的 agent 用时和 token；req status 和插件的需求页面显示"预计还要约多久"。
• 后台进程意外退出时直接继续，不再叫醒对话：装了插件时，插件每 5 分钟在 daemon 里检查一次，发现"运行中但后台进程已不在"的需求就直接继续（req resume），不经过模型；这时流水线不再预约对话每小时一次的定时检查，省下这部分 token。接单器也改为直接继续。
• 等待批准权限进"等你处理"：步骤 agent 在等你允许一项操作时，插件的"等你处理"列出要批准的操作，点"打开这个 agent"去处理。

升级须知

• 新配置 budget（默认不限）。用 req stats 看过"每个完成需求的中位数"后，可以按它的两三倍设置。
• 停下原因新增 budget；状态文件新增 budget、waitingPermission；使用记录的步骤新增 cachedInputTokens、agent；req api 新增 watchdog，status 新增 estimate，attention 新增 permission。
• 插件设为只读时不做自动继续。
• CI 新增 Windows 任务（暂时只报告结果，不阻断发布）。

1.13.0-beta.3

使用者会看到的变化

• 原型审查页在 Paseo 里打开：网页端和桌面端不再跳到单独的浏览器窗口，审查页嵌在插件的"审查原型"页面中；手机上仍在浏览器中打开，页面右上角也可以"在新窗口打开"。
• 按钮更醒目："等你处理"和需求页面最上面，有原型的方案确认显示为主按钮"审查原型并确认方案"（"确认方案"变为次要按钮）；没在等确认时也有"审查原型"按钮。请你确认方案的对话消息也会告诉你去点这个按钮。

升级须知

• 审查页现在允许被本机地址上的页面嵌入（frame-ancestors）；从别的电脑访问时（设了 REQ_KIT_REVIEW_HOST）允许任何页面嵌入，地址中的令牌仍是访问的唯一凭证。可以用 REQ_KIT_REVIEW_FRAME_ANCESTORS 指定。

1.13.0-beta.2

在 Paseo 网页端审查原型，界面验证不再依赖桌面端和模型的视觉能力。见 ADR 0033。

使用者会看到的变化

• 原型审查页：界面改动的需求请你确认方案时，在插件的需求页面或"等你处理"里点"打开原型审查页"（终端：req review <需求>）。在原型上点要改的地方，选一种改法（文字改成…、大一点、换颜色、换位置、删掉、这里加东西……），用自己的话补一句；双击文字直接改字；切换正常、出错、空数据等状态和电脑、手机宽度。被点元素的文字、颜色、大小、位置和对应的验收标准自动记下，提交后整理成清单转给需求会话；没有要改的，直接同意开始写代码。意见自动保存；原型改过后再打开，会标出这一版改了哪里。
• 界面检查 req ui-check：用本机的 Edge 或 Chrome 打开页面，按电脑和手机宽度用文字报告文字显示不全、互相遮挡、超出屏幕、图片没加载、文字太淡、控件没有名字、控制台报错、请求失败，并和确认过的原型逐项对标题、按钮、字段名、表头。功能验证、缺陷修复和复验自动使用；不需要 Paseo 桌面端，不需要模型看图。截图只存成文件给人看，不再读进对话，省 token。
• 安装时 Paseo daemon 启动得慢不再判为失败；真的没启动时写出 Paseo 报的原因和日志位置。

升级须知

• 方案设计的原型按新约定写：改动区域标 data-ac、data-label，状态包在 <section data-state="…"> 中，原型里不写脚本（审查页不会运行它们）。
• req ui-check 第一次运行时从 npm 源安装 playwright-core 到 ~/.req-kit/tools（不下载浏览器）；本机要有 Edge 或 Chrome，或者用 --browser / REQ_KIT_BROWSER 指定浏览器程序。
• 原型审查页的服务默认只给本机访问。需求方从别的电脑访问 Paseo 网页端时，见《项目定制与运行规则》"方案确认点"一节的 REQ_KIT_REVIEW_* 环境变量。
• browserVerify: "off" 现在同时关闭界面检查。

1.13.0-beta.1

公司内网只有 npm 镜像、打不开 GitHub 和文档站点时，也能一条命令装好、升级和看文档。见 ADR 0032。

使用者会看到的变化

• npx 一条命令安装：npx -y paseo-req-kit@latest install，任何系统都可以，只需要 Node.js 22+ 和能访问的 npm 源。做的事和以前的一键安装完全一样：检查环境、安装、检查和安装 Paseo、启用、自动选好 agent、询问是否装插件。已安装时也可以运行 req install。
• 公司内网：npx -y --registry=<镜像地址> paseo-req-kit@latest install。镜像地址会保存为本机的 npm 源（屏幕上写出原来的值），以后 req upgrade 和安装 Paseo 命令行也走镜像；只想用一次加 --no-save-registry。镜像还没同步这个版本时直接说明，不再去访问 GitHub。
• req docs：在本机打开和所装版本一致的文档站点，不需要外网（发布时构建进 npm 包）。
• 安装脚本：install.sh / install.ps1 用法不变，新增 --registry / $ReqKitRegistry 和 --no-save-registry / $ReqKitNoSaveRegistry。文档站点首页增加 npx 的写法；站点放在别的地址（例如内网）时，首页的安装命令自动换成那个地址。

升级须知

• 安装脚本现在只负责选版本，其余步骤由所选版本自带的 req install 完成，所以新脚本只能安装 1.13 及以后的版本。要装更早的版本：npm i -g paseo-req-kit@<版本> && req setup。
• npm 包增加了 site-dist/（构建好的文档站点，约几 MB）和命令 paseo-req-kit（与 req 相同）。

1.12.1

修正 1.12.0 审查中发现的问题，不改变用法。

使用者会看到的变化

• 需求改了以后不再沿用旧 agent：继续时如果某一步还有上一次尝试留下的 agent（按旧需求在做），会先停掉它再新开，不再接着等它或采用它的结果。
• 超时只多等一轮：接着等上一次的 agent 时不再重新延长，卡住的步骤最多等两倍时限就会换人。
• 自答的问题有人复核：方案审核最后一轮的问题由 builder 自答后，再加一轮方案审核复核这些答案，然后才写代码（快速档也一样）。
• 连不上 Paseo 时不再挂住或泄漏连接：所有连接 30 秒连不上就放弃并关闭；接单器不会在 Paseo 离线期间积攒后台重连的连接。
• 卡片回复更稳妥：卡片上还有没回答的问题，或回复区只写了一个"是""对"时，不再当作确认；需求方写的内容里如果带有 </card-reply> 这样的标签，不会再被当成 req-kit 的话。
• 两个进程同时更新卡片记录时不再互相覆盖（流水线写 AI 区与接单器转达回复）。
• Windows：状态文件被杀毒软件或索引服务短暂占用时会重试，不再让流水线意外退出。
• 发布流程：测试通过后才打版本标签，失败的发布不再占用版本号。