代码提交

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

@@ -39,6 +39,8 @@ export interface EmbedSession {
   theme: EmbedTheme;
   /** 隐藏深链底部「快捷跳转」栏（TaskJumpBar：底部按钮 + 右侧悬浮菜单）。 */
   hideJump: boolean;
+  /** Only hide the global Header while retaining PageSidebar and normal app behavior. */
+  hideHeader: boolean;
   /**
    * 仅去全局 chrome（Header 导航栏 + PageSidebar 侧边栏），**不**强制主题、**不**隔离鉴权。
    * 区别于 `embed`：嵌入态会额外强制主题 + 走 sessionStorage 隔离登录身份；`hideChrome` 只想要
@@ -75,6 +77,11 @@ export function readHideJumpParam(search: string): FlagParam {
   return readFlagParam(search, "hideJump");
 }
 
+/** Read the URL's `hideHeader` three-state flag (hide only the global Header). */
+export function readHideHeaderParam(search: string): FlagParam {
+  return readFlagParam(search, "hideHeader");
+}
+
 /** 读 URL 里的 `hideChrome` 三态（仅去全局导航栏 + 侧边栏）。 */
 export function readHideChromeParam(search: string): FlagParam {
   return readFlagParam(search, "hideChrome");
@@ -110,6 +117,7 @@ export function readEmbedSession(): EmbedSession | null {
       embed: p.embed === true,
       theme: p.theme === "dark" ? "dark" : "light",
       hideJump: p.hideJump === true,
+      hideHeader: p.hideHeader === true,
       hideChrome: p.hideChrome === true,
       isolate: p.isolate === true,
     };
@@ -121,7 +129,7 @@ export function readEmbedSession(): EmbedSession | null {
 /** 写会话；无任何开关置位时直接清除（保持 sessionStorage 干净）。隐私模式/quota 异常静默失败。 */
 function writeEmbedSession(next: EmbedSession): void {
   try {
-    if (!next.embed && !next.hideJump && !next.hideChrome && !next.isolate) {
+    if (!next.embed && !next.hideJump && !next.hideHeader && !next.hideChrome && !next.isolate) {
       sessionStorage.removeItem(EMBED_SESSION_KEY);
       return;
     }
@@ -141,6 +149,16 @@ export function isJumpBarHidden(): boolean {
   return readEmbedSession()?.hideJump === true;
 }
 
+/**
+ * Whether this tab should hide its global Header.
+ * `embed` and `hideChrome` also hide the Header, while `hideHeader` alone
+ * deliberately leaves PageSidebar visible.
+ */
+export function isHeaderHidden(): boolean {
+  const session = readEmbedSession();
+  return session?.embed === true || session?.hideChrome === true || session?.hideHeader === true;
+}
+
 /**
  * 本标签页是否要去全局 chrome（Header 导航栏 + PageSidebar 侧边栏）。
  * `embed` 已隐含去 chrome，故这里取「embed || hideChrome」之并——任一置位都隐藏。
@@ -172,7 +190,14 @@ export function isIsolatedSession(): boolean {
 export function syncEmbedSessionFromSearch(search: string): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
+    {
+      embed: false,
+      theme: "light" as EmbedTheme,
+      hideJump: false,
+      hideHeader: false,
+      hideChrome: false,
+      isolate: false,
+    };
   const next: EmbedSession = { ...cur };
 
   const embedParam = readEmbedParam(search);
@@ -187,6 +212,10 @@ export function syncEmbedSessionFromSearch(search: string): void {
   if (hideJumpParam === "on") next.hideJump = true;
   else if (hideJumpParam === "off") next.hideJump = false;
 
+  const hideHeaderParam = readHideHeaderParam(search);
+  if (hideHeaderParam === "on") next.hideHeader = true;
+  else if (hideHeaderParam === "off") next.hideHeader = false;
+
   const hideChromeParam = readHideChromeParam(search);
   if (hideChromeParam === "on") next.hideChrome = true;
   else if (hideChromeParam === "off") next.hideChrome = false;
@@ -238,6 +267,13 @@ export function resolveForcedEmbedTheme(search: string): EmbedTheme | undefined
 export function setIsolatedSession(on: boolean): void {
   const cur =
     readEmbedSession() ??
-    { embed: false, theme: "light" as EmbedTheme, hideJump: false, hideChrome: false, isolate: false };
+    {
+      embed: false,
+      theme: "light" as EmbedTheme,
+      hideJump: false,
+      hideHeader: false,
+      hideChrome: false,
+      isolate: false,
+    };
   writeEmbedSession({ ...cur, isolate: on });
 }