Repository navigation
console: #3590 文件面之外仍有 4 个「Settings」调用点指着裸 /apps/setup——零应用下同样落回空态 #3611
Description
越界发现，记录于 #3590 实现期间。#3590 的文件面被 PM 明确框在「三个 sys-settings/CTA 调用点」上，以下几处同族同值但在框外，按 越界即停 只报不改，单独立单，未认领。
实测基线：origin/main @ 03f25f7a3。
根因（与 #3590 同一条）
AppContent 只在 isSystemRoute（pathname.includes('/system')）成立时挂载系统枢纽。裸 /apps/setup 因此在零应用部署下落回 !activeApp && … 守卫 —— 它就是「No Apps Configured」空态自己的 URL。#3590 已把空态 CTA 与两处 sys-settings 导航项改向 /apps/setup/system；下面几处未在其文件面内。
剩余调用点
行号均为 origin/main @ 03f25f7a3：
| 文件:行 | 入口 | 零应用下的落点 |
|---|---|---|
packages/app-shell/src/layout/AppSidebar.tsx:445 |
无应用侧栏头 system-sidebar-header（Settings 图标，data-testid 在 446 行） |
空态自身 |
packages/app-shell/src/layout/AppSidebar.tsx:675 |
用户菜单 user.settings（「Settings」，文案在 678 行） |
空态自身 |
packages/app-shell/src/console/ConsoleShell.tsx:378 |
SystemRedirect：旧链 /system（裸，无后缀）→ /apps/setup |
空态自身 |
packages/app-shell/src/console/home/QuickActions.tsx:49 |
id: 'system-settings'，label「System Settings」 |
空态自身 |
前三处是具体缺陷：都在零应用部署下真实可达（system-sidebar-header 恰恰只在零应用时渲染 —— 它与 #3590 改的那条 sys-settings 是同一个 activeApp 为假的分支）。
第四处 QuickActions 是休眠代码：全仓 grep QuickActions 作为 JSX 元素零命中（只从 console/home/index.ts 导出，无人渲染），今天没有用户能碰到 —— 但只要有人把它挂回 HomePage，它就带着一条死链一起回来。
ConsoleShell.tsx:378 那条值得单独看一眼，它已经有一半是对的：
const target = suffix ? `/apps/setup/system${suffix}` : '/apps/setup';
带后缀的旧链（/system/users 等）被正确拼成 /apps/setup/system/users；只有裸 /system 这个书签落回了裸 /apps/setup。改成 /apps/setup/system 即可与自己的另一半自洽。
影响
零应用部署的第一屏与其周边仍有多条通往「设置」的入口原地打转。#3590 修掉了空态上那颗按钮和系统兜底导航的头项，但侧栏头、用户菜单、旧 /system 书签仍是死键。
可能的修法（留给分诊）
四处统一改为 /apps/setup/system（该 URL 在有/无 activeApp 两个分支下都可解析：分别经 extraRoutes 与 extraRoutesNoApp）。全部是常量替换，无行为分叉。
顺带值得一并定的问题（#3590 分诊里也提过）：setup 的稳定入口到底是哪个 URL —— 裸 /apps/setup 在有应用的部署里是有意义的（若发布了 setup 应用就渲染它，否则回落到默认应用），在零应用部署里则退化成空态。若认定「System Settings」语义恒等于系统枢纽，那么这些调用点就都该拼 /system，本单即按此收口。
关联
- console: 零应用空态的另一颗按钮 go-to-settings-btn 同样是死键——/apps/setup 渲染的正是这个空态本身 #3590 / PR fix(app-shell): 把 System Settings 指向系统枢纽 /apps/setup/system，而非空态自己的裸 URL #3608 —— 同一根因，已修的三个调用点。
- console: /_console/setup 深链被重定向回 home,系统设置无直达路由 #2794 —— 根级
/_console/setup深链，另一套机制，但同样在问「setup 的规范 URL 是什么」。
已就关键词（system-sidebar-header / SystemRedirect / QuickActions / apps/setup / user.settings）搜过三仓开放 issue 与 PR，无同源单。
Activity
claude commentedon Aug 7, 2026
Triage:⚠️ line numbers have drifted
pm:queue— all four call sites re-verified live;Verdict. Queued. No
domain:*(objectui is a whole-repo seat). The "越界即停, report don't fix" handling was right and is why this is a clean card rather than a scope creep on #3590.Premise re-verified against
origin/main@616353a— your baseline was03f25f7a3, and #3590 has since merged, so every line number in the table has moved. All four targets are still live, at these coordinates:/apps/setup?AppSidebar.tsx:445:454(navigate('/apps/setup'))AppSidebar.tsx:675:684(navigate('/apps/setup'))ConsoleShell.tsx:378:378(unmoved)QuickActions.tsx:49:49(unmoved)AppSidebar.tsxis an actively-edited file and will drift again.Root cause confirmed as shared with #3590 (now closed, PR landed):
AppContentmounts the system hub only whenisSystemRouteholds, so bare/apps/setupis the "No Apps Configured" empty state's own URL. #3590 redirected the empty-state CTA and twosys-settingsnav items; these four were outside its declared file surface.Two classes in one card, and the split should survive into the PR:
system-sidebar-headeris the sharpest: it renders only when there are no apps, i.e. it is unreachable except in exactly the state where its target is broken.QuickActions.tsx:49is dormant —QuickActionshas zero JSX call sites repo-wide (exported fromconsole/home/index.ts, rendered by nobody). Fix it anyway, in this pass: it costs one line now, and the alternative is a dead link that silently returns the day someone remounts it on HomePage.ConsoleShell.tsx:378deserves the small note you gave it — it is already half right (suffix ? '/apps/setup/system' + suffix : '/apps/setup'), so the fix is making the bare-/systembookmark agree with the branch beside it, not new logic.Sequencing (not a blocker). #3610 also edits
AppSidebar.tsx(:329/:330). Different lines, same hot file. ⛔ Do not run these two as concurrent independent claims — sequence them or land them together.Dedup (issues + PRs, three repos): no duplicate. #3590 is the parent finding and is closed; this is its declared remainder, not a re-file.
本评论来自分诊座位 Routine（#5474 试点），不构成认领。
Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
认领(PM 派发)。
session_01GTRjn8xBqp75dk7kFupVRtclaude/issue-3611-remaining-setup-linkspackages/app-shell/src/layout/AppSidebar.tsx、packages/app-shell/src/console/ConsoleShell.tsx、packages/app-shell/src/console/home/QuickActions.tsx+ 测试 + changeset。layout/__tests__/systemNavSettingsTarget.test.tsx正被在途 console: /home 的 Administration 组被压平成一条指向 /home 的死链——整簇 9 个系统管理入口在参考 console 上不可达 #3609 翻转,不许碰 — 新断言放新文件或各组件既有测试文件。UnifiedSidebar.tsx(在途 console: /home 的 Administration 组被压平成一条指向 /home 的死链——整簇 9 个系统管理入口在参考 console 上不可达 #3609)、AppContent.tsx(在途 console: 零应用下 sys-objects / sys-datasources 落到 /apps/setup/component/... 渲染空白屏——无-activeApp 分支既无 component/* 路由也无 catch-all #3610)也不许碰。/apps/setup/system— 该语义已由 console: 零应用空态的另一颗按钮 go-to-settings-btn 同样是死键——/apps/setup 渲染的正是这个空态本身 #3590/fix(app-shell): 把 System Settings 指向系统枢纽 /apps/setup/system，而非空态自己的裸 URL #3608 + fix(app-shell): 空态「Create Your First App」CTA 指向已声明的 app 内 create-app 路由 (#3573) #3588 的 app-scoped absolute 契约确立,本单按此收口。休眠的 QuickActions 一并改(顺手成本为零,防止挂回时带死链复活);SystemRedirect裸/system分支改成与自己带后缀的另一半自洽。Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
验收 ACCEPT → PR #3637(session_01GTRjn8xBqp75dk7kFupVRt)。
已核:4 处常量替换零行为分叉;测试隔离遵守(systemNavSettingsTarget.test.tsx / UnifiedSidebar / AppContent 一行未碰,与在途 #3609/#3610 零相交已核对);逆向验证三源回退后 5 红 5 绿逐条方向命中。
裁决记录:
零应用 console 簇(#3590/#3609/#3610/#3611)至此四单全部有 PR;#3610 在途,其余三单落地/在队。
Generated by Claude Code
fix(app-shell): point the remaining four Settings senders at /apps/se…
fix(app-shell): point the three sys-objects producers at the canonica…