create-bubbles 0.1.27 → 0.1.28

package/template-vp-monorepo-react-nestjs/.spaces/06./350/256/244/350/257/201/344/270/216/344/274/232/350/257/235//344/277/256/346/224/271/345/257/206/347/240/201//346/265/213/350/257/225/346/212/245/345/221/212.md

@@ -2,37 +2,40 @@
 
 ## 1. 状态与范围
 
-- 状态：验证记录（2026-10-08，验证进行中）；本报告尚未形成完整验收结论。
+- 状态：验证记录（2026-10-08）；自动化与隔离 PostgreSQL／Redis 专项已执行，浏览器端到端与部署日志链路核验尚未完成，因此不作完整产品验收结论。
 - 依据：[需求文档](./需求文档.md)、[PRD](./PRD.md)、[技术契约](./技术契约.md)。
-- 验证对象为当前工作树中的 Shared、Server 与 React Web 增量；基线提交为 `c7f2bc6`。工作树未提交，后续代码变化须复测受影响项。
+- 验证对象为 Shared、Server 与 React Web 增量；功能实施提交为 `40bc837`，当前 HEAD 为 `42fd708`。测试归档路径与本文状态更新仍有未提交改动；后续代码或测试内容变化须复测受影响项。
 
 ## 2. 已执行的自动化
 
 | 范围与命令 | 实际结果 | 证据边界 |
 | --- | --- | --- |
-| Server：`vp test test/auth/password-operations.spec.ts` | 12 项通过 | 使用服务替身验证事务失败路径、权限、安全事件和登录并发判定；包含 Fastify inject 的路由响应钩子测试，不等同于真实数据库／Redis 联调 |
-| Server：`vp test` | 8 套件、45 项通过；2 套件、23 项因环境门控跳过 | 跳过项不得计为通过；真实依赖专项另记 |
+| Server：`vp test test/auth/password/password-operations.spec.ts`（`apps/server`） | 新路径 1 个文件、12 项通过，退出码 0 | 使用服务替身验证事务失败路径、权限、安全事件和登录并发判定；包含 Fastify inject 的路由响应钩子测试，不等同于真实数据库／Redis 联调 |
+| Server：`vp test`（测试归档后） | 8 套件、45 项通过；3 套件、28 项因环境门控跳过 | 跳过项不得计为通过；其中隔离存储专项另行启用并验证 5 项 |
+| Server：`vp test test/auth/password/password.integration.spec.ts`（`apps/server`），本机隔离 PostgreSQL 和 Redis DB 15 | 新路径 1 个文件、5 项通过，耗时 3.89 秒 | 随机临时数据库与独立 Redis 逻辑库；服务层调用真实存储与会话 Lua，撤销故障使用一次性注入；不等同于浏览器端到端 |
 | Server：`pnpm exec tsc --noEmit -p tsconfig.json`、`vp run build` | 均执行成功 | 类型检查与构建不能替代运行态验证 |
-| Web：定向运行 `password-actions.spec.ts`、`password-reset-action.spec.ts`、`workspaces-password-entry.spec.tsx` | 共 5 项通过 | 覆盖成功后清理本地会话、失败时保留会话、入口显示与空工作空间实际页面渲染；未覆盖真实浏览器全过程 |
+| Web：`vp test test/password/password-actions.spec.ts test/password/password-reset-action.spec.ts test/password/workspaces-password-entry.spec.tsx`（`apps/web`） | 新路径 3 个文件、5 项通过 | 覆盖成功后清理本地会话、失败时保留会话、入口显示与空工作空间实际页面渲染；未覆盖真实浏览器全过程 |
 | Web：`pnpm --filter web build` | 执行成功 | 类型检查与构建不能替代运行态验证 |
 
 Web 全量 `pnpm --filter web test` 的 20 个套件中，14 个套件运行通过，62 项测试通过；另 6 个套件在导入既有 `apps/web/src/i18n/instance.ts` 时因 Node 测试环境缺少 `localStorage` 而未进入用例。加临时 `NODE_OPTIONS=--localstorage-file` 后仍复现。改用 `pnpm --filter web exec vp test --environment happy-dom`，19 个套件运行，106 项通过；既有 `test/request.spec.ts` 的 11 项因 happy-dom 的 CORS 限制拒绝本地测试 HTTP 服务而失败。这些运行不能记为 Web 全量通过。
 
+本次 Server 与 Shared 改动的 16 个文件定向 `vp fmt --check`、归档后的 5 个密码测试文件定向 `vp fmt --check`，以及 `git diff --check` 均已通过。全目录 `vp check` 初跑存在 79 个格式问题，其中包含本次文件；修复本次后端与共享文件后复跑剩 71 个，集成测试文件当时仍在编辑。全目录检查未通过，其余格式问题尚待单独处理。
+
 ## 3. 验收场景与未覆盖项
 
 | 场景 | 当前证据 | 待补验证 |
 | --- | --- | --- |
-| 无工作空间用户进入本人改密、成功后回登录页 | Web 页面与会话清理定向自动化 | 真实浏览器和后端联动 |
-| 旧密码错误、密码复用、输入不合法时无密码变更 | Server 定向自动化 | 真实 PostgreSQL 写入前后比对 |
-| 平台管理员重置他人、自重置拒绝、越权拒绝、目标不存在 | Server 定向自动化及 Web 入口定向自动化 | 真实权限数据和 HTTP 联动 |
-| 撤销目标 Web、桌面端、移动端会话，管理员自身会话保持 | 服务替身验证撤销调用边界 | 真实 Redis 三终端会话验证 |
-| Redis 撤销失败时密码和成功审计回滚，旧密码并发登录不能重新建会话 | Server 定向自动化 | 真实 PostgreSQL／Redis 故障与并发验证 |
+| 无工作空间用户进入本人改密、成功后回登录页 | Web 页面与会话清理定向自动化；真实存储验证旧密码登录失败、新密码登录成功 | 真实浏览器和后端全过程联动 |
+| 旧密码错误、密码复用、输入不合法时无密码变更 | Server 定向自动化覆盖旧密码错误、复用与未知字段清洗；真实存储专项验证撤销故障时摘要原值 | 长度、确认密码及其他输入失败逐项进行真实 HTTP 与数据库核对 |
+| 平台管理员重置他人、自重置拒绝、越权拒绝、目标不存在 | Server 定向自动化；真实存储专项验证重置他人和自重置拒绝 | 非平台管理员、目标不存在的真实权限数据与 HTTP 联动；锁定／停用账号状态保持 |
+| 撤销目标 Web、桌面端、移动端会话，管理员自身会话保持 | 真实 Redis 三终端 Lua 校验：本人和重置目标旧会话失效，管理员 Web 会话有效 | 真实浏览器与其他端客户端交互 |
+| Redis 撤销失败时密码和成功审计回滚，旧密码并发登录不能重新建会话 | 真实 PostgreSQL 验证一次性注入的撤销故障会回滚摘要及成功审计，原会话有效；Server 定向自动化验证登录摘要复核 | 真实并发时序与运行态 Redis 停机故障 |
 | 响应、安全事件、管理审计和普通日志无密码明文或摘要 | Server 定向自动化覆盖固定安全事件与错误日志，代码审查已发现并修复两处问题 | 运行态日志、响应与审计数据抽检；部署日志保留期限与检索能力确认 |
 
-真实 PostgreSQL／Redis 专项、浏览器端到端场景及运行态日志／审计抽检尚待记录，不能据当前自动化结果认定需求第 6 节全部通过。相关前后端核对见[联调记录](./联调记录.md)。
+浏览器端到端场景、运行态安全事件／普通日志抽检，以及部署日志保留和检索能力尚待记录；不能据当前自动化与服务层集成结果认定[需求文档](./需求文档.md)第 6 节全部通过。相关前后端核对见[联调记录](./联调记录.md)。
 
 ## 4. 变更记录
 
 | 日期 | 摘要 | 影响范围 | 原因 |
 | --- | --- | --- | --- |
-| 2026-10-08 | 建立自动化与未覆盖场景记录，区分测试环境加载失败和真实依赖验证 | Shared、Server、Web、认证与会话 | 避免将代码级测试或构建结果误记为完整业务验收 |
+| 2026-10-08 | 记录定向／全量自动化、隔离 PostgreSQL／Redis 专项、测试环境失败与未覆盖场景 | Shared、Server、Web、认证与会话 | 区分代码级、真实依赖及浏览器和部署验证边界 |

package/template-vp-monorepo-react-nestjs/.spaces/06./350/256/244/350/257/201/344/270/216/344/274/232/350/257/235//344/277/256/346/224/271/345/257/206/347/240/201//350/201/224/350/260/203/350/256/260/345/275/225.md

@@ -2,20 +2,21 @@
 
 ## 1. 状态与依据
 
-- 状态：验证记录（2026-10-08，联调进行中）；目前记录前后端契约核对，尚未形成运行态完整联调结论。
+- 状态：验证记录（2026-10-08）；已完成静态契约核对和服务层真实 PostgreSQL／Redis 专项，尚无浏览器端到端联调证据。
 - 需求与用户流程见[需求文档](./需求文档.md)和[PRD](./PRD.md)；请求、响应、权限及失败语义见[技术契约](./技术契约.md)。执行结果见[测试报告](./测试报告.md)。
 
 ## 2. 已核对的接口衔接
 
 | 场景 | 当前代码衔接 | 验证边界 |
 | --- | --- | --- |
-| 本人改密 | Web `changePassword` 提交共享 `ChangePasswordRequest` 到 `POST /auth/change-password`；Server 使用当前会话 `userId` 处理并返回 `ChangePasswordResult` | 已完成源码与类型路径核对，运行态 HTTP 联动待记录 |
-| 平台管理员重置 | Web 平台账号管理提交共享 `ResetAccountPasswordRequest` 到 `POST /platform/accounts/:userId/reset-password`；Server 路由要求平台操作权限与内置管理员身份 | 已完成源码与类型路径核对，真实权限数据的 HTTP 联动待记录 |
+| 本人改密 | Web `changePassword` 提交共享 `ChangePasswordRequest` 到 `POST /auth/change-password`；Server 使用当前会话 `userId` 处理并返回 `ChangePasswordResult` | 已完成源码与类型路径核对；服务层真实存储验证新旧密码登录和三终端撤销，运行态 HTTP 联动待记录 |
+| 平台管理员重置 | Web 平台账号管理提交共享 `ResetAccountPasswordRequest` 到 `POST /platform/accounts/:userId/reset-password`；Server 路由要求平台操作权限与内置管理员身份 | 已完成源码与类型路径核对；服务层真实存储验证目标撤销、操作者会话及成功审计，运行态 HTTP 联动待记录 |
 | 成功与失败界面 | 本人成功后删除本地令牌并跳转登录页，重置成功后仅提示线下告知；失败保留仍有效的会话且不显示成功 | 定向 Web 自动化已执行，真实浏览器全过程待记录 |
 
 ## 3. 联调发现与待确认
 
-- 安全审查发现管理员重置请求的未知字段名可能进入 400 响应，以及重置时认证存储／审计故障可能返回与契约不符的 500。Server 已针对这两项修改，并在定向自动化中复测；真实依赖故障路径仍待验证。
+- 安全审查发现管理员重置请求的未知字段名可能进入 400 响应，以及重置时认证存储／审计故障可能返回与契约不符的 500。Server 已针对这两项修改，并在定向自动化中复测；隔离存储专项已验证一次性注入撤销故障的数据库回滚，运行态 Redis 停机故障尚未执行。
+- 隔离 PostgreSQL／Redis 5 项专项验证了本人改密和管理员重置成功路径、三终端旧会话撤销、管理员会话保留、一次性注入的撤销故障回滚与自重置拒绝。此专项直接调用服务，不代表已经通过浏览器到后端的运行态全链路。
 - Web 全量测试受既有 Node `localStorage` 加载条件和 happy-dom 本地 HTTP CORS 限制影响；具体运行数字和边界见[测试报告](./测试报告.md)。
 - 当前尚无真实浏览器端到端证据；部署日志的实际保留期限和检索能力也尚未核验。
 
@@ -23,4 +24,4 @@
 
 | 日期 | 摘要 | 影响范围 | 原因 |
 | --- | --- | --- | --- |
-| 2026-10-08 | 建立共享类型、Web 请求与 Server 路由的衔接核对及待联调边界 | Shared、Web、Server | 区分源码契约核对和真实运行态联调 |
+| 2026-10-08 | 核对共享类型、Web 请求与 Server 路由，记录隔离存储专项和待联调边界 | Shared、Web、Server、PostgreSQL、Redis | 区分源码契约、服务层真实依赖和浏览器运行态联调 |

package/template-vp-monorepo-react-nestjs/.spaces/06./350/256/244/350/257/201/344/270/216/344/274/232/350/257/235//344/277/256/346/224/271/345/257/206/347/240/201//350/256/276/350/256/241/346/226/271/346/241/210.md

@@ -2,7 +2,7 @@
 
 ## 1. 状态与来源
 
-- 状态：待实施；本文描述 2026-10-08 确定的实施设计，不表示当前接口已经上线。
+- 状态：当前有效设计；本方案已在当前工作树实现，自动化与隔离存储专项结果及未覆盖边界见[测试报告](./测试报告.md)，不代表已经部署上线。
 - 业务边界以[需求文档](./需求文档.md)为准，用户流程以[PRD](./PRD.md)为准，字段与错误以[技术契约](./技术契约.md)为准。
 - 沿用当前全局 `users` 账号、Argon2id 密码摘要和 Redis Session；不引入工作空间级密码、临时密码或 Refresh Token。
 
@@ -50,4 +50,5 @@
 
 | 日期 | 摘要 | 影响范围 | 原因 |
 | --- | --- | --- | --- |
+| 2026-10-08 | 同步当前工作树实现状态与验证边界 | Auth、平台账号、Web、Redis Session | 区分代码实现和未完成的浏览器、部署验收 |
 | 2026-10-08 | 确定入口、权限、事务内全端撤销、登录并发校验及安全记录边界 | Auth、平台账号、Web、Redis Session | 将已确认业务规则落实为可实现且可验证的方案 |

package/template-vp-monorepo-react-nestjs/.spaces/06./350/256/244/350/257/201/344/270/216/344/274/232/350/257/235//344/277/256/346/224/271/345/257/206/347/240/201//351/234/200/346/261/202/346/226/207/346/241/243.md

@@ -2,13 +2,13 @@
 
 ## 1. 文档状态
 
-- 状态：实施中；以下业务规则已确认，本功能尚待代码实现与验收完成。
+- 状态：当前有效需求；功能已在当前工作树实现，自动化与隔离存储专项已执行，浏览器端到端及部署日志链路核验仍待补充，详见[测试报告](./测试报告.md)。
 - 整理日期：2026-09-30。
-- 当前认证与会话基线见[会话管理需求文档](../会话管理/需求文档.md)和[会话管理技术契约](../会话管理/技术契约.md)。本功能的实施依据另见[PRD](./PRD.md)、[设计方案](./设计方案.md)和[技术契约](./技术契约.md)；拟新增能力在验收完成前不是现行接口。
+- 当前认证与会话基线见[会话管理需求文档](../会话管理/需求文档.md)和[会话管理技术契约](../会话管理/技术契约.md)。本功能的实现依据另见[PRD](./PRD.md)、[设计方案](./设计方案.md)和[技术契约](./技术契约.md)；已执行与未覆盖的验证见[测试报告](./测试报告.md)和[联调记录](./联调记录.md)。
 
 ## 2. 背景与目标
 
-当前用户注册后无法自行修改密码，管理员也无法为忘记密码的用户重置密码。账号是跨工作空间使用的全局身份；密码变更必须作用于全局账号，并及时使旧登录状态失效。
+此前用户注册后无法自行修改密码，管理员也无法为忘记密码的用户重置密码。账号是跨工作空间使用的全局身份；密码变更必须作用于全局账号，并及时使旧登录状态失效。
 
 本功能让已登录用户验证旧密码后修改自己的密码，让平台管理员为其他全局账号设定新密码，同时保护密码内容与各终端会话。
 
@@ -59,5 +59,6 @@
 
 | 日期 | 摘要 | 影响范围 | 原因 |
 | --- | --- | --- | --- |
+| 2026-10-08 | 标明当前工作树已实现双入口与后端处理，并关联实际验证和未覆盖边界 | 全局账号、认证、平台账号管理、Web 与会话 | 使需求状态与实现同步，避免把未执行的浏览器和部署验证写成通过 |
 | 2026-10-08 | 形成 PRD、设计与技术契约，明确接口和安全事件；保留周期作为交付待确认项 | 全局账号、认证、平台账号管理、Web 与会话 | 为已确认需求建立实施和联调依据，避免把部署状态写成已验证事实 |
 | 2026-09-30 | 确认本人改密与平台管理员重置、密码规则及全端会话撤销，建立待实施需求 | 全局账号、认证、平台账号管理与会话 | 补齐现有账号密码维护能力，并明确凭据与会话的安全边界 |

package/template-vp-monorepo-react-nestjs/.spaces/README.md

@@ -15,7 +15,7 @@
 | [03.任务队列](./03.任务队列/)         | BullMQ 公共队列                                | 公共队列基础能力已实现；具体业务任务另行接入                                                                             |
 | [04.界面与主题](./04.界面与主题/)     | 主题说明、UI 截图、视觉验证证据与工具、前端国际化 | 已归档验证产物；国际化已统一联动 antd、Pro Components 与 Day.js，不等同于业务验收                         |
 | [05.运行维护](./05.运行维护/)         | 平台操作、数据库迁移、备份与恢复工具           | 随当前实现维护；备份文件按敏感数据处理                                                                                   |
-| [06.认证与会话](./06.认证与会话/)     | 登录、终端会话、修改密码、令牌演进与实时撤权边界 | 当前 Redis Session 基线已记录；修改密码实施中，后续令牌演进必须先确认迁移契约                                             |
+| [06.认证与会话](./06.认证与会话/)     | 登录、终端会话、修改密码、令牌演进与实时撤权边界 | 当前 Redis Session 与修改密码增量已在工作树实现；浏览器和部署验证待补，后续令牌演进必须先确认迁移契约                                             |
 | [07.API与错误](./07.API与错误/)       | Server 成功响应、失败响应、请求关联 ID         | 当前有效契约                                                                                                             |
 
 ## 主要功能与产物导航
@@ -32,7 +32,7 @@
 | 前端国际化             | [需求文档](./04.界面与主题/国际化/需求文档.md)、[设计方案](./04.界面与主题/国际化/设计方案.md)、[测试报告](./04.界面与主题/国际化/测试报告.md)、[交付记录](./04.界面与主题/国际化/交付记录.md) | 语言切换统一驱动应用词条、antd、Pro Components、Day.js 与 `<html lang>`                                                                                                                                                                                                                                             |
 | 平台运行维护           | [平台操作手册](./05.运行维护/平台操作手册.md)、[数据库迁移指南](./05.运行维护/数据库迁移/操作指南.md)                                                                                                          | [备份与恢复材料](./05.运行维护/数据库迁移/备份/)；其中数据库转储按敏感数据管理                                                                                                                                                                                                                                                                                                        |
 | 认证与会话             | [需求文档](./06.认证与会话/会话管理/需求文档.md)、[技术契约](./06.认证与会话/会话管理/技术契约.md)                                                                                                             | 当前 Session 基线与后续演进边界                                                                                                                                                                                                                                                                                                                                                       |
-| 修改密码               | [需求文档](./06.认证与会话/修改密码/需求文档.md)、[PRD](./06.认证与会话/修改密码/PRD.md)、[设计方案](./06.认证与会话/修改密码/设计方案.md)、[技术契约](./06.认证与会话/修改密码/技术契约.md) | 实施中：本人改密、平台管理员重置及全端会话撤销；保留期限待交付核验 |
+| 修改密码               | [需求文档](./06.认证与会话/修改密码/需求文档.md)、[PRD](./06.认证与会话/修改密码/PRD.md)、[设计方案](./06.认证与会话/修改密码/设计方案.md)、[技术契约](./06.认证与会话/修改密码/技术契约.md) | [联调记录](./06.认证与会话/修改密码/联调记录.md)、[测试报告](./06.认证与会话/修改密码/测试报告.md)；工作树已实现且完成隔离存储专项，浏览器端到端与部署日志核验待补 |
 | API 与错误             | [技术契约](./07.API与错误/技术契约.md)                                                                                                                                                                         | 成功响应、失败响应与请求关联 ID                                                                                                                                                                                                                                                                                                                                                       |
 
 ## 从 Codex 历史提炼的当前决策
@@ -80,6 +80,7 @@
 
 | 日期       | 摘要                                                                                           | 影响范围                               | 原因                                                                          |
 | ---------- | ---------------------------------------------------------------------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------- |
+| 2026-10-08 | 同步修改密码当前工作树实现状态，补充联调与测试报告导航及未覆盖边界 | 认证与会话目录索引 | 使目录状态与代码和实际验证证据一致 |
 | 2026-10-08 | 补充修改密码 PRD、设计和技术契约导航，标明实施中及日志保留待核验 | 认证与会话目录索引 | 在开发前固定正式实施依据并保持状态真实 |
 | 2026-09-30 | 新增修改密码待实施需求导航，同步认证与会话主题状态 | 认证与会话目录索引 | 区分已确认的密码维护需求与当前尚未实现的接口 |
 | 2026-09-18 | 清理原始未完会话正文，记录企业层级实现偏差，并将企业邀请纠偏为“只确认产品入口、具体协议待确认” | 企业／项目正式文档索引、迁移与交付状态 | 现有邀请实现不能反向定义产品协议；消除索引与现行需求、PRD、技术契约之间的冲突 |

package/template-vp-monorepo-react-nestjs/apps/web/test/{password-actions.spec.ts → password/password-actions.spec.ts}

@@ -2,10 +2,10 @@ import { describe, expect, it, vi } from 'vite-plus/test'
 import type { ChangePasswordRequest, ChangePasswordResult } from 'shared/types'
 
 const session = vi.hoisted(() => ({ clear: vi.fn(), remove: vi.fn() }))
-vi.mock('../src/utils/request/workspace', () => ({ clearWorkspaceRequests: session.clear }))
-vi.mock('../src/utils/storage/cookie', () => ({ cookie: { remove: session.remove } }))
+vi.mock('../../src/utils/request/workspace', () => ({ clearWorkspaceRequests: session.clear }))
+vi.mock('../../src/utils/storage/cookie', () => ({ cookie: { remove: session.remove } }))
 
-import { changePasswordAndClearSession } from '../src/components/PasswordActions/change-password-session'
+import { changePasswordAndClearSession } from '../../src/components/PasswordActions/change-password-session'
 
 const input: ChangePasswordRequest = {
   oldPassword: 'old-example',

package/template-vp-monorepo-react-nestjs/apps/web/test/{password-reset-action.spec.ts → password/password-reset-action.spec.ts}

@@ -1,7 +1,7 @@
 import type { I18nState } from '@bubblesjs/i18n-core'
 import { describe, expect, it, vi } from 'vite-plus/test'
 import type { AccountRecord } from 'shared/types'
-import { createMemberTableColumns } from '../src/pages/access/components/MemberTable'
+import { createMemberTableColumns } from '../../src/pages/access/components/MemberTable'
 
 const tr = ((key: string) => key) as I18nState['tr']
 const target: AccountRecord = {
@@ -43,7 +43,9 @@ function resetAction(options: { currentUserId: string; canResetPassword: boolean
   const actions = render?.(undefined, target).props.children ?? []
   const button = actions.find(
     (item): item is { props: { children: string; onClick: () => void } } =>
-      typeof item === 'object' && item !== null && 'props' in item &&
+      typeof item === 'object' &&
+      item !== null &&
+      'props' in item &&
       (item as { props: { children?: unknown } }).props.children === '重置密码',
   )
   return { button, onResetPassword }

package/template-vp-monorepo-react-nestjs/apps/web/test/{workspaces-password-entry.spec.tsx → password/workspaces-password-entry.spec.tsx}

@@ -2,7 +2,7 @@
 
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vite-plus/test'
 
-vi.mock('../src/pages/workspaces/state', () => ({
+vi.mock('../../src/pages/workspaces/state', () => ({
   getWorkspaceState: () => ({
     workspaces: {
       user: { id: 'user-without-workspace', name: '无空间用户' },
@@ -10,14 +10,14 @@ vi.mock('../src/pages/workspaces/state', () => ({
     },
   }),
 }))
-vi.mock('../src/api/auth', () => ({ logout: vi.fn() }))
-vi.mock('../src/utils/request/workspace', () => ({ clearWorkspaceRequests: vi.fn() }))
-vi.mock('../src/components/Brand/Brand', () => ({ default: () => <span>万物</span> }))
-vi.mock('../src/components/LocaleSwitch/LocaleSwitch', () => ({ default: () => null }))
+vi.mock('../../src/api/auth', () => ({ logout: vi.fn() }))
+vi.mock('../../src/utils/request/workspace', () => ({ clearWorkspaceRequests: vi.fn() }))
+vi.mock('../../src/components/Brand/Brand', () => ({ default: () => <span>万物</span> }))
+vi.mock('../../src/components/LocaleSwitch/LocaleSwitch', () => ({ default: () => null }))
 vi.mock('@bubblesjs/i18n-react', () => ({
   useI18n: () => ({ tr: (key: string) => key }),
 }))
-vi.mock('../src/components/PasswordActions/ChangePasswordDialog', () => ({
+vi.mock('../../src/components/PasswordActions/ChangePasswordDialog', () => ({
   /** 模拟改密弹窗的引用接口，以验证页面入口能实际打开它。 */
   default: function PasswordDialog({ ref }: { ref: Ref<{ show: () => void; hide: () => void }> }) {
     const [open, setOpen] = useState(false)
@@ -27,7 +27,7 @@ vi.mock('../src/components/PasswordActions/ChangePasswordDialog', () => ({
 }))
 
 import { App } from 'antd'
-import WorkspacesPage from '../src/pages/workspaces'
+import WorkspacesPage from '../../src/pages/workspaces'
 
 let host: HTMLDivElement
 let root: ReturnType<typeof createRoot>

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/README.md

@@ -53,6 +53,8 @@ tr(`你好 ${name}`)
 
 扫描器故意不依赖 AST，按文本识别静态调用，因此不区分具体编程语言。对应的取舍是：注释或普通字符串中出现完整的 `tr('key')` 文本时，也会被识别。
 
+调用名与 `(`、`(` 与静态字符串、静态字符串与 `,` 或 `)` 之间允许空白、`//` 行注释和 `/* ... */` 块注释，例如 `tr(/* 说明 */ '保存' /* 说明 */)`。字符串内部的注释符号按词条正文保留；注释后是动态表达式时仍不提取。
+
 ## 命令
 
 ```bash

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/src/scanner.test.ts

@@ -21,6 +21,94 @@ describe('scanSource', () => {
     expect(scanSource(source)).toEqual([{ key: '你好 {name}', index: 16, line: 1, column: 17 }])
   })
 
+  it.each([
+    { boundary: 'call name', source: "tr/* 调用说明 */('保存')" },
+    { boundary: 'opening parenthesis', source: "tr(/* 参数说明 */ '保存')" },
+    { boundary: 'closing parenthesis', source: "tr('保存' /* 词条说明 */)" },
+    { boundary: 'comma', source: "tr('保存' /* 词条说明 */, { name })" },
+    {
+      boundary: 'adjacent mixed comments',
+      source: [
+        'tr/**/// 调用说明',
+        '(/* 参数说明 */ /**/ // 参数说明',
+        "  '保存' /**/ // 词条说明",
+        '  /* 词条说明 */)',
+      ].join('\n'),
+    },
+  ])('allows comments at the $boundary boundary', ({ source }) => {
+    expect(scanSource(source)).toEqual([{ key: '保存', index: 0, line: 1, column: 1 }])
+  })
+
+  it.each([
+    { name: 'LF', lineEnding: '\n' },
+    { name: 'CR', lineEnding: '\r' },
+    { name: 'CRLF', lineEnding: '\r\n' },
+    { name: 'U+2028', lineEnding: '\u2028' },
+    { name: 'U+2029', lineEnding: '\u2029' },
+  ])('ends line comments at $name and preserves source positions', ({ lineEnding }) => {
+    const source = [
+      'tr // 调用说明',
+      '  (// 参数说明',
+      "    'first' // 词条说明",
+      '  )',
+      "  tr('next')",
+    ].join(lineEnding)
+
+    expect(scanSource(source)).toEqual([
+      { key: 'first', index: 0, line: 1, column: 1 },
+      { key: 'next', index: source.indexOf("tr('next')"), line: 5, column: 3 },
+    ])
+  })
+
+  it('preserves comment markers inside static strings', () => {
+    const source = [
+      "tr('https://example.test/path/*说明*/')",
+      'tr("/* 开头 */ // 结尾")',
+      'tr(`// 第一行\n/* 第二行 */`)',
+    ].join('\n')
+
+    expect(scanSource(source).map(({ key }) => key)).toEqual([
+      'https://example.test/path/*说明*/',
+      '/* 开头 */ // 结尾',
+      '// 第一行\n/* 第二行 */',
+    ])
+  })
+
+  it('continues extracting complete calls inside comments and ordinary strings', () => {
+    const source = [
+      "// tr('行注释')",
+      "/* tr('块注释') */",
+      'const example = "tr(\'字符串\')"',
+    ].join('\r\n')
+
+    expect(scanSource(source)).toEqual([
+      { key: '行注释', index: 3, line: 1, column: 4 },
+      { key: '块注释', index: source.indexOf("tr('块注释')"), line: 2, column: 4 },
+      { key: '字符串', index: source.indexOf("tr('字符串')"), line: 3, column: 18 },
+    ])
+  })
+
+  it('still rejects dynamic expressions around comments', () => {
+    const source = [
+      'tr(/* 参数说明 */ key)',
+      "tr('a' /* 词条说明 */ + value)",
+      "tr('a' // 词条说明\n + value)",
+      "tr('a' /* 词条说明 */.trim())",
+      "tr('a' /* 词条说明 */ / divisor)",
+      'tr(`hello ${name}` /* 词条说明 */)',
+    ].join('\n')
+
+    expect(scanSource(source)).toEqual([])
+  })
+
+  it.each([
+    { boundary: 'call name', source: "tr/* 调用说明 ('保存')" },
+    { boundary: 'opening parenthesis', source: "tr(/* 参数说明 '保存')" },
+    { boundary: 'static string', source: "tr('保存' /* 词条说明)" },
+  ])('rejects an unterminated block comment after the $boundary', ({ source }) => {
+    expect(scanSource(source)).toEqual([])
+  })
+
   it('decodes common escapes without evaluating source code', () => {
     const source = String.raw`tr('It\'s\n中\t\x41\u6587\u{1F600}')`
 

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/src/scanner.ts

@@ -21,9 +21,10 @@ interface ParsedEscape {
 
 const identifierContinuePattern = /[\p{ID_Continue}_$]/u
 const whitespacePattern = /\s/u
+const lineTerminatorPattern = /[\n\r\u2028\u2029]/u
 const hexPattern = /^[\dA-Fa-f]+$/
 
-/** 扫描文本中的翻译调用及其静态字符串参数，返回词条与从 1 开始的行列位置；跳过插值模板和动态表达式。 */
+/** 扫描文本中的翻译调用及其静态字符串参数，允许调用边界的空白与注释；返回原始源码行列位置，跳过插值模板和动态表达式。 */
 export function scanSource(source: string, options: ScanOptions = {}): MessageOccurrence[] {
   const callNames = normalizeCallNames(options.callNames)
   const occurrences: MessageOccurrence[] = []
@@ -44,12 +45,12 @@ export function scanSource(source: string, options: ScanOptions = {}): MessageOc
         continue
       }
 
-      let cursor = skipWhitespace(source, index + callName.length)
+      let cursor = skipWhitespaceAndComments(source, index + callName.length)
       if (source[cursor] !== '(') {
         continue
       }
 
-      cursor = skipWhitespace(source, cursor + 1)
+      cursor = skipWhitespaceAndComments(source, cursor + 1)
       const quote = source[cursor]
       if (quote !== "'" && quote !== '"' && quote !== '`') {
         continue
@@ -60,7 +61,7 @@ export function scanSource(source: string, options: ScanOptions = {}): MessageOc
         continue
       }
 
-      const nextTokenIndex = skipWhitespace(source, parsed.endIndex)
+      const nextTokenIndex = skipWhitespaceAndComments(source, parsed.endIndex)
       const nextToken = source[nextTokenIndex]
       if (nextToken !== ',' && nextToken !== ')') {
         continue
@@ -114,11 +115,33 @@ function isIdentifierContinue(character: string | undefined): boolean {
   )
 }
 
-/** 从指定位置跳过空白字符，返回下一个非空白字符的索引。 */
-function skipWhitespace(source: string, startIndex: number): number {
+/** 跳过调用边界的空白、行注释和块注释；未闭合块注释返回源码末尾，使当前候选匹配失败。 */
+function skipWhitespaceAndComments(source: string, startIndex: number): number {
   let index = startIndex
-  while (index < source.length && whitespacePattern.test(source[index] ?? '')) {
-    index += 1
+  while (index < source.length) {
+    if (whitespacePattern.test(source[index] ?? '')) {
+      index += 1
+      continue
+    }
+
+    if (source.startsWith('//', index)) {
+      index += 2
+      while (index < source.length && !lineTerminatorPattern.test(source[index] ?? '')) {
+        index += 1
+      }
+      continue
+    }
+
+    if (source.startsWith('/*', index)) {
+      const closingIndex = source.indexOf('*/', index + 2)
+      if (closingIndex === -1) {
+        return source.length
+      }
+      index = closingIndex + 2
+      continue
+    }
+
+    break
   }
   return index
 }
@@ -131,7 +154,7 @@ function parseString(
 ): ParsedString | undefined {
   let value = ''
 
-  for (let index = startIndex + 1; index < source.length; ) {
+  for (let index = startIndex + 1; index < source.length;) {
     const character = source[index]
 
     if (character === quote) {
@@ -258,7 +281,7 @@ function parseCodePointEscape(source: string, slashIndex: number): ParsedEscape
   }
 }
 
-/** 收集每行起始偏移，兼容 LF、CRLF 和 CR 换行。 */
+/** 收集每行起始偏移，兼容 LF、CRLF、CR 以及 Unicode 行和段落分隔符。 */
 function collectLineStarts(source: string): number[] {
   const starts = [0]
 
@@ -268,7 +291,7 @@ function collectLineStarts(source: string): number[] {
         index += 1
       }
       starts.push(index + 1)
-    } else if (source[index] === '\n') {
+    } else if (lineTerminatorPattern.test(source[index] ?? '')) {
       starts.push(index + 1)
     }
   }

package/template-vp-monorepo-react-nestjs/packages/i18n/cli/test/command.test.ts

@@ -62,6 +62,42 @@ describe('runCli', () => {
     expect(output.join('\n')).toContain('Project web: 1 source files, 2 keys.')
   })
 
+  it('keeps translations for calls with comments when cleaning catalogs', async () => {
+    const root = temporaryDirectory.path
+    await mkdir(join(root, 'src'), { recursive: true })
+    await mkdir(join(root, 'locales'), { recursive: true })
+    await writeFile(
+      join(root, 'src', 'app.ts'),
+      "tr('正常')\ntr(/* 参数说明 */ '保留' /* 结束说明 */)\n",
+      'utf8',
+    )
+    await writeFile(
+      join(root, 'locales', 'en_US.json'),
+      JSON.stringify({ 正常: 'Normal', 保留: 'Keep translation', 废弃: 'Remove translation' }),
+      'utf8',
+    )
+    await writeFile(join(root, 'locales', 'zh_CN.json'), '{}\n', 'utf8')
+    await writeConfig(root)
+
+    await expect(runCli(['sync', '--clean'], { cwd: root, stdout: () => undefined })).resolves.toBe(
+      0,
+    )
+    expect(JSON.parse(await readFile(join(root, 'locales', 'en_US.json'), 'utf8'))).toEqual({
+      正常: 'Normal',
+      保留: 'Keep translation',
+    })
+    const report = JSON.parse(await readFile(join(root, '.reports', 'i18n.json'), 'utf8'))
+    expect(report.files).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          locale: 'en_US',
+          deleted: ['废弃'],
+          unchangedCount: 2,
+        }),
+      ]),
+    )
+  })
+
   it('checks without writing and can fail on unused keys', async () => {
     const root = temporaryDirectory.path
     await mkdir(join(root, 'src'), { recursive: true })

package/template-vp-monorepo-react-nestjs/packages/i18n/react/src/use-store.ts

@@ -1,5 +1,5 @@
-import { useSyncExternalStore } from 'react'
 import type { I18nState, I18nStore } from '@bubblesjs/i18n-core'
+import { useMemo, useSyncExternalStore } from 'react'
 
 /** 订阅国际化容器，并返回选择器提取的状态。 */
 export function useI18nStore<T>(store: I18nStore, selector: (state: I18nState) => T): T
@@ -10,8 +10,18 @@ export function useI18nStore<T>(
   store: I18nStore,
   selector?: (state: I18nState) => T,
 ): T | I18nState {
-  if (selector) {
-    return useSyncExternalStore(store.subscribe, () => selector(store.getState()))
-  }
-  return useSyncExternalStore(store.subscribe, store.getState)
+  const getSnapshot = useMemo(() => {
+    let cache: { state: I18nState; value: T | I18nState } | undefined
+    return () => {
+      const state = store.getState()
+      if (cache && Object.is(cache.state, state)) {
+        return cache.value
+      }
+      const value = selector ? selector(state) : state
+      cache = { state, value }
+      return value
+    }
+  }, [store, selector])
+
+  return useSyncExternalStore(store.subscribe, getSnapshot)
 }

package/template-vp-monorepo-react-nestjs/tsconfig.lib.json

@@ -2,7 +2,7 @@
   "extends": "./tsconfig.bundler.json",
   "compilerOptions": {
     "target": "ES2020",
-    "lib": ["ES2020"],
+    "lib": ["ES2020", "DOM"],
     "types": [],
     "useDefineForClassFields": true,
     "noUncheckedIndexedAccess": true

package/template-vp-react/package.json

@@ -26,14 +26,14 @@
   "devDependencies": {
     "@commitlint/cli": "^21.2.3",
     "@commitlint/config-conventional": "^21.2.3",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.4",
     "@types/react": "^19.3.0",
-    "@types/react-dom": "^19.2.7",
-    "@vitejs/plugin-react": "^6.1.1",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.2",
     "typescript": "~7.0.2",
     "unplugin-auto-import": "^21.1.0",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
     "vite-plugin-svgr": "^5.2.0",
-    "vite-plus": "0.3.3"
+    "vite-plus": "1.1.0"
   }
 }

package/template-vp-vue-eslint-vapor/.vscode/settings.json

@@ -0,0 +1,53 @@
+{
+  // Disable the default formatter, use eslint instead
+  "biome.enabled": false,
+  "oxc.enable": false,
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+  
+
+  // Auto fix
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+
+  // Silent the stylistic rules in your IDE, but still auto fix them
+  "eslint.rules.customizations": [
+    { "rule": "style/*", "severity": "off", "fixable": true },
+    { "rule": "format/*", "severity": "off", "fixable": true },
+    { "rule": "*-indent", "severity": "off", "fixable": true },
+    { "rule": "*-spacing", "severity": "off", "fixable": true },
+    { "rule": "*-spaces", "severity": "off", "fixable": true },
+    { "rule": "*-order", "severity": "off", "fixable": true },
+    { "rule": "*-dangle", "severity": "off", "fixable": true },
+    { "rule": "*-newline", "severity": "off", "fixable": true },
+    { "rule": "*quotes", "severity": "off", "fixable": true },
+    { "rule": "*semi", "severity": "off", "fixable": true }
+  ],
+
+  // Enable eslint for all supported languages
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "svelte",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ]
+}

package/template-vp-vue-eslint-vapor/package.json

@@ -16,6 +16,7 @@
     "@antdv-next/icons": "^1.1.2",
     "alova": "^3.5.5",
     "antdv-next": "^1.6.0",
+    "antdv-next-pro": "^0.1.3",
     "axios": "^1.20.0",
     "dayjs": "^1.11.23",
     "echarts": "^6.1.0",