代码提交

frontend-web/src/core/embed/embed-session.ts

@@ -39,6 +39,12 @@ export interface EmbedSession {
   theme: EmbedTheme;
   /** 隐藏深链底部「快捷跳转」栏（TaskJumpBar：底部按钮 + 右侧悬浮菜单）。 */
   hideJump: boolean;
+  /**
+   * 仅去全局 chrome（Header 导航栏 + PageSidebar 侧边栏），**不**强制主题、**不**隔离鉴权。
+   * 区别于 `embed`：嵌入态会额外强制主题 + 走 sessionStorage 隔离登录身份；`hideChrome` 只想要
+   * 一个干净的全屏页面（如「大屏绘制」`?hideChrome=1`），其余行为与正常标签页完全一致。
+   */
+  hideChrome: boolean;
   /** 独立会话：鉴权身份按本标签页隔离（走 sessionStorage），用于同浏览器登录不同账号互不覆盖。 */
   isolate: boolean;
 }
@@ -69,6 +75,11 @@ export function readHideJumpParam(search: string): FlagParam {
   return readFlagParam(search, "hideJump");
 }
 
+/** 读 URL 里的 `hideChrome` 三态（仅去全局导航栏 + 侧边栏）。 */
+export function readHideChromeParam(search: string): FlagParam {
+  return readFlagParam(search, "hideChrome");
+}
+
 /** 读 URL 里的 `isolate` 三态（独立会话登录）。 */
 export function readIsolateParam(search: string): FlagParam {
   return readFlagParam(search, "isolate");
@@ -99,6 +110,7 @@ export function readEmbedSession(): EmbedSession | null {
       embed: p.embed === true,
       theme: p.theme === "dark" ? "dark" : "light",
       hideJump: p.hideJump === true,
+      hideChrome: p.hideChrome === true,
       isolate: p.isolate === true,
     };
   } catch {
@@ -109,7 +121,7 @@ export function readEmbedSession(): EmbedSession | null {
 /** 写会话；无任何开关置位时直接清除（保持 sessionStorage 干净）。隐私模式/quota 异常静默失败。 */
 function writeEmbedSession(next: EmbedSession): void {
   try {
-    if (!next.embed && !next.hideJump && !next.isolate) {
+    if (!next.embed && !next.hideJump && !next.hideChrome && !next.isolate) {
       sessionStorage.removeItem(EMBED_SESSION_KEY);
       return;
     }
@@ -129,6 +141,16 @@ export function isJumpBarHidden(): boolean {
   return readEmbedSession()?.hideJump === true;
 }
 
+/**
+ * 本标签页是否要去全局 chrome（Header 导航栏 + PageSidebar 侧边栏）。
+ * `embed` 已隐含去 chrome，故这里取「embed || hideChrome」之并——任一置位都隐藏。
+ * 与 `isEmbedActive()` 的差别：`hideChrome` 不强制主题、不隔离鉴权，只去 chrome。
+ */
+export function isChromeHidden(): boolean {
+  const s = readEmbedSession();
+  return s?.embed === true || s?.hideChrome === true;
+}
+
 /**
  * 本标签页是否处于独立会话态：鉴权身份按标签页隔离（走 sessionStorage）。
  * `embed` 已隐含同样的隔离，故 `authStorage()` 取「embed || isolate」之并；这里只判 `isolate`，
@@ -146,7 +168,7 @@ export function isIsolatedSession(): boolean {
 export function syncEmbedSessionFromSearch(search: string): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, isolate: false };
+    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
   const next: EmbedSession = { ...cur };
 
   const embedParam = readEmbedParam(search);
@@ -161,6 +183,10 @@ export function syncEmbedSessionFromSearch(search: string): void {
   if (hideJumpParam === "on") next.hideJump = true;
   else if (hideJumpParam === "off") next.hideJump = false;
 
+  const hideChromeParam = readHideChromeParam(search);
+  if (hideChromeParam === "on") next.hideChrome = true;
+  else if (hideChromeParam === "off") next.hideChrome = false;
+
   const isolateParam = readIsolateParam(search);
   if (isolateParam === "on") next.isolate = true;
   else if (isolateParam === "off") next.isolate = false;
@@ -208,6 +234,6 @@ export function resolveForcedEmbedTheme(search: string): EmbedTheme | undefined
 export function setIsolatedSession(on: boolean): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, isolate: false };
+    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
   writeEmbedSession({ ...cur, isolate: on });
 }