Skip to content

feat(account): 增加修改密码入口 - #64

Merged
KyleHuangFromHZ merged 24 commits into
mainfrom
feature/48-change-password
Nov 20, 2026
Merged

KyleHuangFromHZ merged 24 commits into
mainfrom
feature/48-change-password

Conversation

@KyleHuangFromHZ

@KyleHuangFromHZ KyleHuangFromHZ commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

账户菜单为已登录云账号增加“修改密码”,点击后在系统浏览器打开配置网页。云端功能与 Sequence Lock 本地设置之间增加分割线,按参考图收紧分组间距,两个分组均有可见菜单时显示;菜单沿用现有顺序,分割线按 Figma 使用 --dc-color-border-disabled(浅色 #E2E8F0)。

CASDOOR_CHANGE_PASSWORD_URL(desktop;本地或 CI 注入)
  未设置 / 留空 → 正式账号页
  已设置       → 校验 HTTPS、无内嵌凭据
                    ├─ 源码启动 → desktop 配置 → 前端菜单 → 系统浏览器
                    └─ 最终打包 → 包内 auth.changePasswordUrl → 前端菜单

正式默认地址统一保留在 desktop 配置模块,与原生授权材料的 test/production 模式无关,Windows 社区包也默认使用正式账号页。移除前端 VITE 配置和按打包模式选择密码页的入口;真实测试地址只由环境变量注入,不出现在最终受跟踪文件中。包内 JSON 是自动生成的交付结果,安装版忽略用户机器的同名变量。.env 地址含 # 时须加引号,示例和回归测试已覆盖。

最终 PR 对 workflow、社区配置准备脚本和 packaging.config.json 均无差异。

Evidence

  • Before: 账户菜单缺少云账号修改密码入口。
    After: 单一 desktop 环境变量覆盖正式默认值,源码运行和最终打包共用解析规则,旧 JSON 值不能改变选择。

  • Frontend / desktop: 账户模块 36 项、真实 IPC/preload 链路 2 项通过;desktop 构建成功。

  • Packaging / configuration: 配置与打包检查 74 项通过,另 1 项 Windows 安装器专用检查在 Mac 跳过。覆盖 Windows 社区包默认正式地址、各原生模式注入覆盖、安装版忽略宿主变量、HTTPS 校验和 .env 路由片段保留。

  • Documentation: 31 项规则测试通过,文档策略检查 251 份 Markdown、0 违规。

  • Test fixtures: CodeQL 指出的两处测试代码拼接已改为独立子进程参数,相关两份测试文件复测 53 项通过、1 项平台检查跳过。

  • Menu grouping: el-divider 位于云端退出登录与本地菜单之间;Sequence Lock 因权限隐藏时,当前本地用户和本地修改密码仍参与显示判断。按 Figma 设计 读取分割线变量 dc/color/border/disabled = #e2e8f0,仅在菜单内覆盖该颜色,去除额外高度和上下 margin,两侧保留 4px 间距。36 项账户组件测试、ESLint、Prettier 和前端构建通过。提交 d41e91ed 的前端经 opentest-run stop/start 增量投递至 windows-huang 独立实例实测:云账号已登录、工程正常,DOM 实测颜色为 rgb(226, 232, 240),两侧各约 4px,截图已核对;后端、SDK、原生材料及插件沿用已验证的 178d6c49 部署。

  • Windows: 通过 opentest-run 在 windows-huang 的独立 change-password-48 实例部署并点击,云账号登录态真实存在,工程正常打开。未注入时 desktop 返回正式地址,点击后 Chrome 打开官网并被网站重定向到 /login/。随后以带引号的本地环境变量注入测试地址,基于提交 b53902c4 的干净工作树再次完整部署;desktop 返回完整地址,实际点击后由 Windows UIAutomation 确认 Chrome 位于测试站的 /account/#change-password,路由片段完整。

  • Runtime provenance: Windows 原生模块指纹与当前源码匹配,实际 Java 进程从本实例 release/backend/native 加载配套的测试 DLL;DLL 和 License.dat 通过内部插件 test-runtime 清单校验。两次有效运行实测均在 Windows 执行,Mac 只构建和运行自动化检查。

  • Scope / limits: 本轮验收是浏览器跳转;客户端与网站没有会话同步,不能据此声称免二次登录或已完成密码修改。未执行新的 Windows 安装器安装测试。

  • Type-check: 合入最新 main 后,完整前端 vue-tsc --noEmit -p tsconfig.app.json 检查通过(NODE_OPTIONS=--max-old-space-size=6144)。

  • Main sync: 合并提交 00c04eb8 无冲突合入 main@37492906;账户菜单、desktop 密码页地址解析和浏览器跳转实现保持一致。合并后账户组件 36 项、桌面浏览器跳转 2 项、配置与打包 74 项测试通过(另 1 项平台检查跳过),完整前端类型检查及前端构建通过。

Closes #48

Merge Danger

Door: Two-way

可回退菜单入口及地址解析改动。已有本机手写密码页地址需迁移至带引号的 CASDOOR_CHANGE_PASSWORD_URL;安装包地址在构建时固化。

Blast Radius: Account

@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team November 18, 2026 07:20

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

本 PR 在账号菜单中为已登录云账号增加“修改密码”入口,并通过外部浏览器打开对应环境的网站页面。入口仅在 isLogined 时显示,与 Sequence 锁密码入口分开,这一点符合 CONTEXT 中的术语边界。

主要问题有三点:

  1. 环境来源与领域约定不一致。
    • 修改密码页属于云账号服务,但 URL 由云许可证服务的授权环境决定。
    • 缺少授权环境时,代码按 import.meta.env.DEV 回退。
    • CONTEXT.md 明确规定:云账号登录服务与云许可证服务分别配置;授权环境与“是否以开发方式运行”分别描述。
    • 此外,signupUrl、forgetPasswordUrl 由桌面端 getPublicAuthConfig() 或环境变量配置,而 changePasswordUrl 被硬编码在前端,没有沿用现有配置通道。
  2. 桌面端到前端的取值缺少运行时校验。 licenseEnvironment 取值异常时,URL 可能是 undefined,浏览器分支不会报错。
  3. openExternalBrowser 的返回值依赖未在本 diff 中体现的主进程实现。 返回值不符合 { success } 时,浏览器已经打开,界面却会报错。

测试缺少以下场景:缺少 licenseEnvironment 时的回退、非 Electron 的 window.open 分支、打开失败时的提示,以及桌面端 get-service-config 新字段。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:411adca。维护者可评论 /review 重新审查。

Comment thread apps/desktop/src/ipcMainHandler.js Resolved
Comment thread CONTEXT.md Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现思路清晰:菜单项仅对云账号登录用户显示,changePasswordUrl 经过协议校验(仅 http/https,拒绝带用户信息的 URL),打包时白名单透传,并补充了 javascript:、未登录、失败返回等测试。但有几点需要处理:

  1. 描述与实现不一致:描述称根据 getAuthConfiguration() 在 test/production 下分别选择 design.opentest.com 和 www.opentest.com,但代码中没有任何按授权环境选择 URL 的逻辑,只读取 CASDOOR_CHANGE_PASSWORD_URL、本机设置 auth.changePasswordUrl 或 VITE_USER_CHANGE_PASSWORD_URL。示例配置均为空,本 PR 也没有修改社区包各模式的桌面配置来源。因此按 CONTRIBUTING 构建的三平台社区包很可能拿不到该地址,菜单显示后点击只会报错。Windows 验证能打开 design 地址,推测依赖了本机配置,无法证明打包产物可用。请补上各模式的配置来源(或真正实现按环境映射),并增加覆盖打包产物的测试。
  2. 桌面端返回值契约未在本 PR 中体现:openExternalBrowser 的类型被收紧为返回 { success, error? },前端要求 success === true,否则视为失败。但 diff 中没有 Electron 主进程或 preload 的改动。若现有处理器返回 undefined 或其他结构,桌面端点击会一律报错(测试中的 missing result 用例正说明了这一点)。请确认现有实现确实返回该结构,或在本 PR 中一并修改并补充桌面端测试。
  3. FrontendErrorCode.LINK_UNAVAILABLE 未出现在 diff 中,请确认该错误码及各语言文案已存在。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:667d8e9。维护者可评论 /review 重新审查。

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:前端入口、URL 协议校验、打包白名单透传和多语言文案都比较完整,测试覆盖了 Electron、浏览器、失败结果、非法协议和未登录隐藏等分支。主要问题是描述与实现不一致,另有一处与本需求无关的改动。

  1. 描述中的“按授权环境选择 URL”没有在代码中实现。 描述写明 test -> design.opentest.com、production -> www.opentest.com。但本次改动只从 CASDOOR_CHANGE_PASSWORD_URL、本机设置 auth.changePasswordUrl 或 VITE_USER_CHANGE_PASSWORD_URL 读取 URL:

    • local-settings.example.json 中该值为空。
    • 没有修改 packaging.config.json、社区包工作流或任何按 test/production 生成配置的位置。
    • 新增的 licenseEnvironment 类型也没有被使用。

    因此,按现有流程构建的社区包很可能拿不到该 URL,入口点击后只会报错。Windows 验证结果可能依赖了本地手工配置。请补充按授权环境写入 changePasswordUrl 的打包配置及对应测试,或者修正描述,说明 URL 需由部署方配置。

  2. 范围外改动。 use-grpc-exec.ts 的 getCollectionLength 重构与“修改密码入口”无关,也没有配套测试。合并方式为 squash,标题会成为唯一的提交说明,这处图谱逻辑变更将难以追溯。建议拆到独立的 fix/refactor 拉取请求。

  3. 描述中的测试数量和 Windows 实机结果无法从 diff 中核实,以上意见只依据代码本身。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:79a6709。维护者可评论 /review 重新审查。

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:修改密码入口仅对已登录云账号显示,前端对 URL 做了 http/https 和凭据校验,打包脚本也同步保留了新字段,测试覆盖了主要分支。主要问题如下。

  1. 描述与实现不一致:描述称按授权环境自动选择 design.opentest.com 或 www.opentest.com,但代码只读取 CASDOOR_CHANGE_PASSWORD_URL 或本机设置中的 auth.changePasswordUrl。仓库内没有任何环境到 URL 的映射,示例配置也是空串。社区包和日常包是否能得到正确地址,完全取决于 diff 之外的部署配置,本 PR 无法证明。
  2. 未配置时入口仍显示:URL 缺失或非法时,用户点击后只会看到错误提示。
  3. 范围超出描述:PR 混入了 use-grpc-exec.ts 的运行时逻辑改动和多个无关测试的修改,与 Merge Danger 中“仅影响账号菜单”的说法不符。建议拆分到单独的 PR,至少在描述中说明。
  4. 校验口径不一致(非本次引入):只有 changePasswordUrl 做了协议校验,signupUrl、forgetPasswordUrl 仍不校验。可考虑后续统一。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:2ec9cb8。维护者可评论 /review 重新审查。

@KyleHuangFromHZ
KyleHuangFromHZ force-pushed the feature/48-change-password branch from aa367dd to 3e423c2 Compare November 18, 2026 11:08

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:入口仅对云账号登录用户显示,浏览器分支在首个 await 之前调用 window.open,不会被弹窗拦截;渲染层对 URL 协议和内嵌凭据做了校验,失败时保持菜单打开并提示,测试覆盖了 Electron 与浏览器两条路径、非法 URL 和未登录隐藏。合入前建议确认或处理以下问题:

  1. 配置来源未在本 PR 中体现:描述称会打开"已配置的测试或正式密码页",但 diff 中只有空的示例值和打包透传。CASDOOR_CHANGE_PASSWORD_URL 在测试和正式环境的服务配置里由谁写入,无法从改动中确认。如果安装包中该值为空,所有已登录用户都会看到一个点击必然报错的菜单项(见行内意见)。
  2. Electron 主进程返回值契约未验证:前端把 openExternalBrowser 返回 undefined 视为失败。主进程 IPC 处理器和 preload 不在本次 diff 中。如果现有实现成功时不返回 { success: true }(例如直接透传 shell.openExternal 的 void),每次点击都会报错。描述也说明重构后的 Windows 实机点击复验尚未完成,建议补齐后再合入。另外,主进程侧是否同样限制 http/https 协议同样无法从 diff 确认;渲染层校验不能替代主进程校验。
  3. 混入与本功能无关的改动:use-grpc-exec.ts 的长度判断重写、api.test.ts 的 401 夹具及会话 mock、native-close.test.mjs 的路径处理、多处测试的类型标注、ElectronServiceConfig.licenseEnvironment 等,都与"修改密码入口"无关。仓库采用 squash 合并,标题会成为唯一提交说明,混入的行为或夹具变更会在历史中被掩盖,回滚本功能时也会一并回退。描述中的 Merge Danger 称"改动仅限账号菜单",与实际不符。建议拆分为独立 PR,或至少在描述中逐项说明原因。
  4. 缺少的测试:未覆盖 URL 未配置(空字符串)时的行为,也未覆盖 openExternalBrowser 抛出异常或 Promise 被拒绝时的行为。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:3e423c2。维护者可评论 /review 重新审查。

Comment thread apps/frontend/src/services/api.test.ts Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现方向合理:修改密码入口只对已登录云账号显示;URL 校验后在 Electron 中用系统浏览器打开,在浏览器构建中用 window.open 打开;打开失败时保留菜单并提示。打包、CI 和运行时配置链路都已补上,前端与工具测试覆盖了主要路径。

不能定位到具体行的意见:

  1. 描述与实现不一致:PR 描述称 URL 被校验为 public HTTP(S) URL。前端 sanitizeHttpUrl 与打包侧 normalizeChangePasswordUrl 实际只检查协议和是否带凭据,没有限制主机(例如 http://127.0.0.1、内网地址都能通过)。请修正描述,或按描述补充主机校验。
  2. 手动验证不完整:描述写明重构后的 Windows 点击复测仍待完成,且没有 Linux(production 模式)和 macOS 的实际打开验证。合并前建议至少在重构后的版本上补一次 Windows test 模式和一个 production 平台的点击验证。
  3. 新增桌面测试未覆盖新逻辑:apps/desktop/tests/unit/open-external-browser.test.mjs 断言 javascript: 被拒绝、shell.openExternal 失败时返回 { success: false },但本次 diff 未修改 ipcMainHandler.js 或 preload.js,这些断言验证的是既有行为。请确认现有主进程处理器确实对非 HTTP(S) 协议做了拦截;否则该测试会失败,或说明安全边界只在渲染进程一侧。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:82ce5f3。维护者可评论 /review 重新审查。

Comment thread packaging.config.json Resolved
Comment thread tools/packaging.mjs Resolved
Comment thread tools/packaging.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:前端和打包两侧都对修改密码 URL 做了 HTTP(S) 与凭据校验,Electron 主进程仍经过 resolveExternalHttpUrl 二次校验,失败路径保留菜单并提示错误,测试覆盖较完整。需要关注以下几点:

  1. 测试模式的地址可能不适用于公开分发的包(见行内意见)。按 CONTRIBUTING.zh-CN.md,Windows 社区包公开发布时使用 test 模式,且“当前没有独立测试服务器”。两个模式的 licenseUrl 也相同。这样一来,Windows 用户会被引导到 design.opentest.com,而不是正式站点。请确认这是预期行为。
  2. 校验规则不一致:本地打包经过 readConfig 时用 normalizeChangePasswordUrl 做严格校验;CI 路径 tools/ci/prepare-installer.mjs 只检查非空字符串。另外,readConfig 不要求模式必须提供 changePasswordUrl,CI 却强制要求。建议两条路径复用同一个校验函数,并统一“缺失时报错还是隐藏入口”的约定。
  3. 新增桌面测试较脆弱:open-external-browser.test.mjs 用 vm 加载 ipcMainHandler.js,靠手工维护的大量 mock 运行。未列入 mock 的模块会回落到真实 require。以后 ipcMainHandler.js 新增有副作用的依赖时,测试可能静默加载真实模块,或因无关原因失败。建议把 openExternalBrowser 处理函数抽到独立模块后直接测试,或至少让未 mock 的依赖直接报错。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:69ae6fd。维护者可评论 /review 重新审查。

Comment thread packaging.config.json Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved
@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team as a code owner November 19, 2026 01:32

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:前端和打包两侧都校验了 URL(仅 HTTP(S)、无凭据),菜单只对云账号登录显示,Electron IPC 返回稳定的结果对象,失败路径有测试覆盖。需要确认的问题有两类:

  1. 社区包 Windows(test 模式)的账号服务一致性:工作流把 Windows test 模式的修改密码地址覆盖成正式站点 www.opentest.com,而 packaging.config.json 中 test 模式配置的是 design.opentest.com。如果 test 模式的云账号登录走测试账号体系,用户会被引导到另一套账号体系修改密码。详见行内意见。
  2. 覆盖变量语义不明确:OPENTEST_CI_CHANGE_PASSWORD_URL 只作用于 test 模式,对 production 模式静默不生效;校验失败时的报错来源也不准确。

不能定位到具体行的意见:

  • PR 描述说“test 和 production 安装包写入各自配置的页面”,但当前唯一公开发布的 test 模式安装包(社区包 Windows)实际被覆盖为正式地址。建议在描述中写明这一例外及原因,便于审核者判断。
  • 描述中说明,最终工作树没有在 Windows 上完成实机验证,只有更早一次匹配运行时的验证。合入前最好补一次最终产物的手工验证,或至少在社区包构建产物上确认 local-settings.json 中的 auth.changePasswordUrl。
  • useElectronApi().openExternal 的类型从通用 AsyncHandler 收紧为 AsyncHandler<[string], OpenExternalResult>。PR 证据只列了单元测试,建议确认已运行类型检查(如 vue-tsc),避免其他调用方以不同参数调用时出现类型错误。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:4f166ee。维护者可评论 /review 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现完整:账号菜单只在已登录且 URL 有效时显示入口;渲染进程和主进程都校验 URL;打包、CI 和运行时配置链路都有对应测试。下面几点建议合并前确认。

  1. 修改密码地址按安装包模式选择,而不是按实际登录的账号服务选择。 Windows 社区包要在工作流里单独覆盖成正式地址,说明“安装包模式”和“账号环境”并不一一对应。如果普通 test 包实际登录的也是正式账号服务,packaging.config.json 中 test 模式的 design.opentest.com 会把用户带到另一套账号系统去改密码。具体见行内评论。
  2. 测试覆盖有缺口。 CI 安装器测试只验证了设置环境变量覆盖的情况,没有验证未覆盖时 test 模式取 packaging.config.json 的默认值。前端“隐藏入口”的测试只覆盖了浏览器构建的环境变量,没有覆盖 Electron getServiceConfig().auth.changePasswordUrl 为非法值的情况。
  3. ipcMainHandler.js 的改动只是把匿名函数提成了具名常量,行为没有变化,新增注释里“稳定的结果对象”的说法也不来自这次改动。这一点不影响正确性,只是提醒:新的桌面测试必须穷举 ipcMainHandler.js 的全部 require,以后该文件新增任何依赖,这个测试都会失败,维护成本较高。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:33af54f。维护者可评论 /review 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:前端、预加载桥和打包三处都校验 URL,入口只对已登录的云账号显示,失败时保留菜单并提示。以下几点建议修改或确认:

  1. 测试有效性:未登录隐藏入口的用例没有配置有效 URL,入口会因 URL 缺失而隐藏,无法证明 isLogined 条件生效。详见行内意见。
  2. 账号体系一致性(需确认):packaging.config.json 中 test 与 production 的 licenseUrl 相同,都是 update.opentest.com,但 test 模式的修改密码页指向 design.opentest.com。请确认 test 包登录所用的云账号服务(Casdoor)与 design.opentest.com 是同一套账号体系。否则普通 test 包用户会在另一套账号系统里修改密码。同理,Windows 社区包改用正式账号页,也依赖其登录服务确实是正式服务;描述中只给出“没有独立公开测试账号服务”的理由,缺少配置层面的证据。
  3. 文档同步:CONTRIBUTING.zh-CN.md 和 CONTRIBUTING.md 的“社区包”一节逐项说明了 Windows test 模式的配置差异,例如不写入 cloud.license.url。本 PR 新增了一个例外:Windows 使用 test 原生材料,但修改密码页用正式地址。建议在中英文两份文档中同步说明,避免维护者误以为 test 模式一律使用测试账号页。
  4. 类型检查:ElectronApi.openExternalBrowser 和 useElectronApi().openExternal 的签名从宽松的 unknown[] 收紧为 (url: string) => OpenExternalResult。现有的注册、找回密码、官网链接等调用点,如果传入 string | undefined 或使用其他参数形式,会出现类型错误。证据部分只列出单元测试,建议补充前端 vue-tsc/typecheck 的运行结果。
  5. 验证范围:描述说明最终工作树没有完成 Windows 实机点击验证,社区包的覆盖路径只通过生成配置的单元测试检查。合并前建议在三平台构建产物中至少抽查 Windows 安装后的 config/local-settings.json。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:2e7b306。维护者可评论 /review 重新审查。

Comment thread tools/ci/prepare-installer.mjs Resolved
Comment thread tools/packaging.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:改动范围清晰。前端、Electron 主进程和打包三层都校验了 URL,IPC 返回 { success, error? } 结构,失败时菜单保持打开,测试覆盖了主要分支。中英文 CONTRIBUTING 已同步更新。合并前需要确认以下几点。

  1. 修改密码页与登录服务是否属于同一账号体系(见工作流第 201 行):普通 test 包和公开 Windows 社区包使用同一个 backendProfile: qa 和同一套 test 原生材料,修改密码页却分别指向 design.opentest.com 和 www.opentest.com。云账号登录服务在本 PR 中没有随之区分。按现有配置,这两类包至少有一类的修改密码页与用户实际登录的账号服务不一致,用户可能改了另一套系统的密码,回到客户端后仍用旧密码登录。请提供依据,说明两类包各自登录的 Casdoor 服务与对应修改密码页一致。也建议在测试中加入一致性断言,或从登录服务配置推导修改密码页。
  2. Windows 实机验证:描述说明最终工作树因原生材料哈希不匹配,没有在 Windows 上实际启动验证。请在合并前或首个日常包上补做,确认社区包里的入口打开的是正式地址。
  3. 新增依赖:tools/ci/prepare-installer.mjs 原先只依赖 Node 内置模块,现在导入了 tools/packaging.mjs。请确认工作流中 Prepare installer settings 这一步执行时,packaging.mjs 的全部依赖已经可用。仅凭本 diff 无法确定。
  4. 校验规则分散:前端 sanitizeHttpUrl、打包 normalizeChangePasswordUrl 和主进程 resolveExternalHttpUrl 各自实现了 HTTP(S) 校验,规则以后可能不一致。另外,signupUrl 和 forgetPasswordUrl 仍不经过前端校验,与新字段处理方式不同。这一点不阻塞合并,可另开工单统一。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:9825f9a。维护者可评论 /review 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread tools/package.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:前端和打包两侧都校验了 URL 协议和内嵌凭据,Electron IPC 返回稳定的结果对象,菜单只对云账号登录用户显示,测试覆盖了主要成功和失败路径。以下几点需要确认或补充:

  1. 社区包登录服务与修改密码页是否属于同一账号体系(需确认):本次新增的 CONTRIBUTING 段落要求登录服务和修改密码页属于同一账号体系。但 diff 中看不到 test 模式实际使用的 Casdoor 登录地址:
    • 如果普通 test 包登录的是测试 Casdoor,那么公开 Windows 社区包(同为 test 模式)把修改密码页覆盖为 www.opentest.com,就会出现登录与改密不一致。这正是文档要避免的情况。
    • 请在描述中说明,或用测试证明 Windows 社区包的登录服务确实指向正式账号体系。
  2. 覆盖路径缺少手动验证:描述中的 Windows 手动验证打开的是测试地址的修改密码页,并且基于早期工作树。社区包覆盖为正式地址的路径目前只有单元测试,没有端到端验证。建议合入前在日常包中复验。
  3. 配置来源和优先级需要文档化:运行时环境变量 CASDOOR_CHANGE_PASSWORD_URL 的优先级最高;打包时以 packaging.config.json 中各模式的值为准,并覆盖 desktop 设置文件中的同名字段。文档没有写清楚这一点,见对应行评论。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:e9c9bd5。维护者可评论 /review 重新审查。

Comment thread tools/packaging.mjs Resolved
Comment thread CONTRIBUTING.zh-CN.md Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

总体评价:改动范围清晰。前端、桌面端和打包三层都对修改密码地址做了 HTTP(S) 协议和内嵌凭据校验。Electron IPC 返回固定的 { success, error? } 结构,前端失败时保持菜单打开并提示,处理方式合理。中英文 CONTRIBUTING 同步更新,符合文档双语规则。主要风险在于公开 Windows 社区包的登录服务和修改密码页是否属于同一账号体系,目前没有证据,也没有自动校验,详见行内意见。

无法定位到具体行的意见:

  • 描述中的 Windows 验证只覆盖了早期版本。最终工作树因原生材料哈希不一致未能启动验证,生产平台也没有实际点击验证。合并前建议至少在一个最终构建上完成一次手动验证,或在关联的 #48 中明确列为待复验项。
  • 只有 changePasswordUrl 经过 sanitizeHttpUrl 校验,signupUrl、forgetPasswordUrl 仍直接透传。这属于既有行为,不阻塞本 PR,但两类地址的校验标准已不一致。建议后续统一处理,或在代码中注明原因。
  • 描述称打包与配置测试覆盖了 URL 校验,但本次 diff 中没有任何针对 normalizeChangePasswordUrl 拒绝路径的测试,详见行内意见。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:be6d7bf。维护者可评论 /review 重新审查。

Comment thread .github/workflows/community-package.yml Resolved
Comment thread tools/packaging.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved
Comment thread CONTRIBUTING.md Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:修改密码入口只在已登录云账号且配置了合法地址时显示;打包、CI、桌面与前端都加了 URL 校验,IPC 返回结构也有测试覆盖。合入前请关注以下几点:

  1. 协议范围偏宽:前端和打包校验都允许 http:。这是承载密码修改的页面,建议至少在打包链路中只接受 https:(见行内意见)。
  2. 账号体系配对缺少自动检查:文档要求覆盖 OPENTEST_CASDOOR_URL 或登录租户时同步覆盖 changePasswordUrl,但代码和 CI 都没有校验两者是否属于同一账号体系。公开 Windows 社区包使用 test 原生材料,却指向正式站点。它的登录服务与 www.opentest.com 账号页属于同一 Casdoor 租户,目前只有描述中的人工说明作为依据。建议在发布前用社区包实际登录一次,并点击该入口确认。
  3. 最终验证不完整:描述说明最终工作树的 Windows 部署因原生材料哈希不匹配而未启动,也没有正式平台的手动点击结果。合入后请按日常包流程补做复验,不要直接关闭 #48。
  4. 类型收窄的影响:openExternalBrowser 由 (...args: unknown[]) => unknown 收窄为 (_url: string) => OpenExternalResult。vue-tsc 仍有基线错误,无法据此确认仓库中其他调用方(如注册、忘记密码、官网链接)的传参和返回值用法都兼容,建议用 rg openExternal 逐一核对。
  5. 空字符串无法禁用入口:packaging.config.json 中 changePasswordUrl 一旦存在就不能为空字符串,否则会抛错。要禁用入口只能删除字段,建议在文档中说明。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:712a013。维护者可评论 /review 重新审查。

Comment thread tools/packaging.mjs Resolved
Comment thread tools/packaging.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:前端对修改密码地址做了 HTTPS 和无凭据校验,Electron IPC 返回稳定的结果对象,打包配置也增加了校验,中英文文档同步更新,测试覆盖了主要路径。

需要处理或确认的问题:

  1. 禁用方式与实现不一致:文档写“删除当前模式的 changePasswordUrl 即可禁用入口”。但社区包流程中删除该字段会直接报错;普通打包流程则会回退到桌面设置文件中的值,不一定能禁用。详见行内意见。
  2. 测试账号页的归属需要确认:文档说明“没有独立公开测试账号服务 / 没有独立测试服务器”,但普通 test 包仍指向 design.opentest.com。请确认普通 test 包登录使用的 Casdoor 租户与该页面属于同一账号体系。否则用户会在另一套账号系统里修改密码。描述中只说明两个页面都提供 Casdoor Member System,没有说明它们与各自登录租户的对应关系。
  3. 验证不完整:描述已说明最终工作树没有在 Windows 上完成启动验证,正式包也没有手动点击验证。建议合入前或日常包复验时补充,并在 #48 中记录结果。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:cabb855。维护者可评论 /review 重新审查。

Comment thread tools/ci/prepare-installer.mjs Resolved
Comment thread CONTRIBUTING.zh-CN.md Resolved
Comment thread tools/packaging.mjs Resolved
Comment thread tools/__tests__/packaging.test.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:打包配置按模式校验修改密码地址,桌面端透传公开配置,前端在已登录且地址有效时才显示入口,IPC 失败时保留菜单并提示错误,测试覆盖了主要成功和失败路径。以下问题需要关注:

  • 配置回退与文档不一致:文档称 VITE_USER_CHANGE_PASSWORD_URL 只在浏览器构建中作为回退,但前端在 Electron 中同样会回退,影响通过清空桌面配置来禁用入口。
  • HTTPS 约束未覆盖所有来源:打包只校验 packaging.config.json 中的值;桌面设置文件里的回退值和运行时 CASDOOR_CHANGE_PASSWORD_URL 没有在打包或桌面侧校验,实际只依赖前端过滤。
  • 个别测试隔离不足:部分测试依赖宿主环境变量,或无法区分两个失败分支。
  • 验证状态:描述说明最终工作树未完成 Windows 实机启动,也没有正式平台的手动点击验证。本 PR 修改了 .github/workflows/community-package.yml 和 packaging.config.json,会触发三平台构建,并需要 CODEOWNERS 审查。建议合入前完成至少一个平台的最终产物手动验证。
  • 账号体系一致性无法从 diff 确认:普通 test 包指向 design.opentest.com,需要维护者确认 qa 后端实际使用的 Casdoor 租户与该页面属于同一账号体系。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:998561d。维护者可评论 /review 重新审查。

Comment thread tools/packaging.mjs Resolved
Comment thread tools/__tests__/packaging.test.mjs Resolved
Comment thread tools/ci/prepare-installer.mjs Resolved
cuimmm
cuimmm previously approved these changes Nov 19, 2026
yangdekun2026
yangdekun2026 previously approved these changes Nov 19, 2026
@KyleHuangFromHZ
KyleHuangFromHZ dismissed stale reviews from yangdekun2026 and cuimmm via b53902c November 19, 2026 07:55
@KyleHuangFromHZ
KyleHuangFromHZ removed the request for review from a team November 19, 2026 07:58

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:desktop 统一解析密码页地址,前端再做一次 HTTPS 校验,菜单只在云账号登录时显示,外链仍经主进程 resolveExternalHttpUrl 校验后打开;中英文贡献指南同步更新,测试覆盖了默认值、覆盖值、无效值、# 路由片段和安装版忽略宿主变量等主要路径。

不能定位到具体行的意见:

  • 与项目流程冲突:描述中使用 Closes #48。CONTRIBUTING.zh-CN.md 要求用 Refs #123 关联需求,由测试在之后的日常包里验证通过后再关闭。squash 合并后,GitHub 会在合入时自动关闭 #48,跳过日常包复验。请改为 Refs #48。
  • 需确认(无法从 diff 判断):文档称“手写本机 JSON 不能覆盖地址”。源码运行时确实成立,因为不读取 local.changePasswordUrl。但安装版走 local.changePasswordUrl || DEFAULT,这一结论取决于 readLocalSettings() 在 packaged 模式下是否只读包内生成的配置。如果它仍会读取用户可写的设置文件(例如 OPENTEST_LOCAL_SETTINGS_PATH 或用户数据目录),安装版就存在第二个手写入口。建议补一条用例,或在 PR 中说明该路径的来源。
  • FE.LINK_UNAVAILABLE 不在本次 diff 中。请确认它是已有错误码,并且各语言都有对应描述文案。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:178d6c4。维护者可评论 /review 重新审查。

Comment thread tools/packaging.mjs Resolved
Comment thread apps/desktop/src/config/public-auth.js Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:桌面端集中解析修改密码页地址,前端再做一次 HTTPS 校验,打包时固化地址,测试也覆盖了主要路径。审查中没有发现阻断性缺陷。以下几点建议在合并前确认:

  1. 与贡献流程冲突:PR 描述使用了 Closes #48。CONTRIBUTING.zh-CN.md 要求用 Refs #123 关联工单,等测试在之后的日常包中验证通过后再关闭。使用 Closes 会在 squash 合并时自动关闭 #48,跳过日常包复验。请改为 Refs #48。
  2. 本地打包可能固化测试地址:writeDesktopSettings 默认读取 process.env,文档也建议把覆盖值写入 .local/runtime.env。如果开发者在本机做过测试联调后直接本地打包,测试站地址会被固化进安装包,且安装版不能再通过环境变量纠正。CI 发布路径不受影响,但建议二选一:打包脚本在使用非默认地址时输出明显提示,或在文档中写明本地打包前应清空该变量。
  3. 无效覆盖值的影响范围:源码运行时,getPublicAuthConfig 遇到非法 CASDOOR_CHANGE_PASSWORD_URL 会直接抛错。注册、找回密码等其他账号配置会随之一起不可用,前端 getAuthConfiguration() 也没有捕获。这与现有 validateServiceConfiguration 的抛错风格一致,属于开发期问题,但影响面大于“修改密码入口不可用”。请确认这是预期行为。
  4. 菜单分割线的显示条件比较复杂,例如 Sequence Lock 因权限隐藏但本地用户菜单仍可见的情况。目前只有 Windows 手工验证,组件测试没有覆盖。建议补充断言。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:d41e91e。维护者可评论 /review 重新审查。

Comment thread apps/desktop/src/config/public-auth.js Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体实现清晰:桌面端统一解析地址,打包时固化;前端和主进程 resolveExternalHttpUrl 两层都限制为 HTTPS;中英文文档同步更新;单元测试覆盖了主要的成功、失败和隐藏路径。主要问题如下。

  • 与项目规范冲突:描述中使用 Closes #48。CONTRIBUTING.zh-CN.md 要求用 Refs #123 关联工单,由测试在之后的日常包中验证通过后再关闭。Closes 会在 squash 合并时自动关闭工单,跳过日常包复验。请改为 Refs #48。
  • 配置错误的影响范围:源码运行时,无效的 CASDOOR_CHANGE_PASSWORD_URL 会让整个 getPublicAuthConfig() 抛错,波及注册和找回密码入口,详见行内意见。
  • 本地打包的固化风险:缺少防护,详见行内意见。
  • 未改动部分的确认:packaged 分支对 signupUrl / forgetPasswordUrl 仍沿用 env || local,只有 changePasswordUrl 忽略环境变量。这与文档描述一致,属于有意的差异,无需修改。

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:00c04eb。维护者可评论 /review 重新审查。

Comment thread apps/desktop/src/config/public-auth.js Resolved
Comment thread tools/packaging.mjs Resolved
@KyleHuangFromHZ
KyleHuangFromHZ merged commit 4731cb5 into main Nov 20, 2026
17 of 18 checks passed
@KyleHuangFromHZ
KyleHuangFromHZ deleted the feature/48-change-password branch November 20, 2026 00:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[需求] 修改密码入口

5 participants