fix: tighten zh operator copy on critical surfaces (#163)

xiaojiou176 · web-flow · commit d944ec464598 · 2026-04-17T16:28:25.000-07:00
diff --git a/apps/dashboard/app/command-tower/page.tsx b/apps/dashboard/app/command-tower/page.tsx
@@ -27,8 +27,49 @@ type CommandTowerHomeState = {
   hasLiveData: boolean;
 };
 
+function buildCommandTowerWarningSummary({
+  locale,
+  overviewWarning,
+  sessionsWarning,
+  hasLiveData,
+}: {
+  locale: UiLocale;
+  overviewWarning: string | null;
+  sessionsWarning: string | null;
+  hasLiveData: boolean;
+}): string {
+  if (!overviewWarning && !sessionsWarning) {
+    return "";
+  }
+
+  if (locale === "zh-CN") {
+    if (overviewWarning && sessionsWarning) {
+      return "指挥塔总览与 PM 会话列表当前都不可用。请稍后再试。";
+    }
+    if (overviewWarning) {
+      return hasLiveData
+        ? "指挥塔总览暂时不可用。当前页面只显示部分快照，继续操作前请直接核对运行记录或工作流案例。"
+        : "指挥塔总览暂时不可用。请稍后再试。";
+    }
+    return hasLiveData
+      ? "PM 会话列表暂时不可用。当前页面只显示部分快照，继续操作前请直接核对运行记录或工作流案例。"
+      : "PM 会话列表暂时不可用。请稍后再试。";
+  }
+
+  if (overviewWarning && sessionsWarning) {
+    return "Command Tower overview and PM session list are temporarily unavailable. Try again later.";
+  }
+  if (overviewWarning) {
+    return hasLiveData
+      ? "Command Tower overview is temporarily unavailable. The page is showing a partial snapshot, so verify runs or Workflow Cases directly before you act."
+      : "Command Tower overview is temporarily unavailable. Try again later.";
+  }
+  return hasLiveData
+    ? "The PM session list is temporarily unavailable. The page is showing a partial snapshot, so verify runs or Workflow Cases directly before you act."
+    : "The PM session list is temporarily unavailable. Try again later.";
+}
+
 async function loadCommandTowerHomeState(locale: UiLocale): Promise<CommandTowerHomeState> {
-  const commandTowerCopy = getUiCopy(locale).dashboard.commandTowerPage;
   const fallbackOverview: CommandTowerOverviewPayload = {
     generated_at: new Date().toISOString(),
     total_sessions: 0,
@@ -72,11 +113,16 @@ async function loadCommandTowerHomeState(locale: UiLocale): Promise<CommandTower
   const sessions = sessionsResult.data;
   const overviewWarning = overviewResult.warning;
   const sessionsWarning = sessionsResult.warning;
-  const warning = [overviewWarning, sessionsWarning].filter(Boolean).join(" ");
   const hasLiveData =
     (overview.total_sessions || 0) > 0 ||
     (overview.active_sessions || 0) > 0 ||
     (sessions?.length || 0) > 0;
+  const warning = buildCommandTowerWarningSummary({
+    locale,
+    overviewWarning,
+    sessionsWarning,
+    hasLiveData,
+  });
 
   return {
     overview,
@@ -190,7 +236,7 @@ export function CommandTowerPageIntro({
           <p id="command-tower-page-subtitle" className="page-subtitle">
             {recoveryMode
               ? locale === "zh-CN"
-                ? "指挥塔当前拿不到 live 总览。先确认只读真相，再走一条恢复路径。"
+                ? "指挥塔当前拿不到实时总览。先确认只读真相，再走一条恢复路径。"
                 : "Command Tower cannot read the live overview right now. Verify the read-only truth first, then take one recovery path."
               : partialMode
                 ? commandTowerCopy.partialNextAction
@@ -238,7 +284,7 @@ export function CommandTowerPageIntro({
                     ? commandTowerCopy.partialBadge
                     : commandTowerCopy.partialBadge
                 : locale === "zh-CN"
-                  ? "先看 live"
+                  ? "先看实时态"
                   : "Live first"}
             </Badge>
           </div>
@@ -247,13 +293,13 @@ export function CommandTowerPageIntro({
               <>
                 <div className="home-briefing-signal">
                   <span className="cell-sub mono muted">{locale === "zh-CN" ? "当前状态" : "Current state"}</span>
-                  <strong>{locale === "zh-CN" ? "live 总览暂时不可读" : "The live overview is temporarily unavailable"}</strong>
+                  <strong>{locale === "zh-CN" ? "实时总览暂时不可读" : "The live overview is temporarily unavailable"}</strong>
                   <p>{locale === "zh-CN" ? "这不是正常驾驶舱读面。先恢复主面，再继续值班。" : "This is not a normal cockpit read. Restore the surface first, then resume operator work."}</p>
                 </div>
                 <div className="home-briefing-signal">
                   <span className="cell-sub mono muted">{locale === "zh-CN" ? "仍然成立的真相" : "What still holds"}</span>
                   <strong>{locale === "zh-CN" ? "只读入口与证明室仍可用" : "The read-only rooms still work"}</strong>
-                  <p>{locale === "zh-CN" ? "你仍然可以回 PM、Runs 和 Workflow Cases，但不要把当前页面当成 live cockpit。 " : "You can still use PM, Runs, and Workflow Cases, but do not treat this page as a live cockpit right now."}</p>
+                  <p>{locale === "zh-CN" ? "你仍然可以回 PM 入口、运行记录和工作流案例，但不要把当前页面当成实时驾驶舱。 " : "You can still use PM, Runs, and Workflow Cases, but do not treat this page as a live cockpit right now."}</p>
                 </div>
                 <div className="home-briefing-signal">
                   <span className="cell-sub mono muted">{locale === "zh-CN" ? "恢复动作" : "Recovery move"}</span>
@@ -266,11 +312,11 @@ export function CommandTowerPageIntro({
                 <div className="home-briefing-signal">
                   <span className="cell-sub mono muted">{locale === "zh-CN" ? "当前状态" : "Current state"}</span>
                   <strong>{commandTowerCopy.partialTitle}</strong>
-                  <p>{locale === "zh-CN" ? "你现在看到的是部分可读的值班面，不是完整 live cockpit。首屏要先承认降级，再继续分诊。" : "You are looking at a partially readable operator surface, not a full live cockpit. The first screen should acknowledge degradation before continuing triage."}</p>
+                  <p>{locale === "zh-CN" ? "你现在看到的是部分可读的值班面，不是真正完整的实时驾驶舱。首屏要先承认降级，再继续分诊。" : "You are looking at a partially readable operator surface, not a full live cockpit. The first screen should acknowledge degradation before continuing triage."}</p>
                 </div>
                 <div className="home-briefing-signal">
                   <span className="cell-sub mono muted">{locale === "zh-CN" ? "仍然成立的真相" : "What still holds"}</span>
-                  <strong>{locale === "zh-CN" ? "可见 board 只算部分快照" : "The visible board only counts as a partial snapshot"}</strong>
+                  <strong>{locale === "zh-CN" ? "可见面板只算部分快照" : "The visible board only counts as a partial snapshot"}</strong>
                   <p>{commandTowerCopy.partialNextAction}</p>
                 </div>
                 <div className="home-briefing-signal">
diff --git a/apps/dashboard/components/DashboardHomeStorySections.tsx b/apps/dashboard/components/DashboardHomeStorySections.tsx
@@ -191,7 +191,7 @@ export default function DashboardHomeStorySections({
     locale === "zh-CN"
       ? [
           {
-            kicker: "当前 live",
+            kicker: "当前实况",
             value: hasRunHistory ? String(runningCount) : "0",
             detail: hasRunHistory ? "先读指挥塔，再下钻明细" : "先起第一条任务，系统才会亮起来",
           },
@@ -202,7 +202,7 @@ export default function DashboardHomeStorySections({
           },
           {
             kicker: "真相路径",
-            value: hasRunHistory ? "Workflow + Proof" : "Start in PM",
+            value: hasRunHistory ? "工作流 + 证明" : "先从 PM 开始",
             detail: hasRunHistory ? "首页只负责导向，不负责替代证明室" : "先写请求，再让真相面出现",
           },
         ]
diff --git a/apps/dashboard/tests/command_tower_page_render.test.tsx b/apps/dashboard/tests/command_tower_page_render.test.tsx
@@ -174,6 +174,11 @@ describe("command tower page render", () => {
     expect(screen.getByText("Partial truth / live surface degraded")).toBeInTheDocument();
     expect(screen.getByText("Command Tower is running with partial truth")).toBeInTheDocument();
     expect(screen.getByText("Partial context")).toBeInTheDocument();
+    expect(
+      screen.getByText(
+        "Command Tower overview is temporarily unavailable. The page is showing a partial snapshot, so verify runs or Workflow Cases directly before you act."
+      )
+    ).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "Reload Command Tower" })).toHaveAttribute("href", "/command-tower");
     expect(screen.getByRole("link", { name: "View runs" })).toHaveAttribute("href", "/runs");
     expect(screen.queryByTestId("ct-callout")).toBeNull();
@@ -203,6 +208,10 @@ describe("command tower page render", () => {
     expect(screen.getByText("部分真相 / live 面当前降级")).toBeInTheDocument();
     expect(screen.getByText("指挥塔当前只提供部分真相")).toBeInTheDocument();
     expect(screen.getByText("上下文不完整")).toBeInTheDocument();
+    expect(screen.getByText("可见面板只算部分快照")).toBeInTheDocument();
+    expect(
+      screen.getByText("指挥塔总览暂时不可用。当前页面只显示部分快照，继续操作前请直接核对运行记录或工作流案例。")
+    ).toBeInTheDocument();
     expect(screen.getByRole("status")).toHaveTextContent("正在加载指挥塔实时总览...");
     expect(screen.getByRole("link", { name: "重载指挥塔" })).toHaveAttribute("href", "/command-tower");
     expect(screen.getByRole("link", { name: "查看运行记录" })).toHaveAttribute("href", "/runs");
@@ -220,6 +229,9 @@ describe("command tower page render", () => {
     expect(
       screen.getByText("Command Tower cannot read the live overview right now. Verify the read-only truth first, then take one recovery path."),
     ).toBeInTheDocument();
+    expect(
+      screen.getByText("Command Tower overview and PM session list are temporarily unavailable. Try again later.")
+    ).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "Reload Command Tower" })).toHaveAttribute("href", "/command-tower");
     expect(screen.getByRole("link", { name: "Start from PM" })).toHaveAttribute("href", "/pm");
     expect(screen.queryByTestId("ct-live-client")).toBeNull();
@@ -236,7 +248,9 @@ describe("command tower page render", () => {
     render(await CommandTowerPage());
 
     expect(screen.getByText("恢复模式 / 当前主面不可用")).toBeInTheDocument();
-    expect(screen.getByText("指挥塔当前拿不到 live 总览。先确认只读真相，再走一条恢复路径。")).toBeInTheDocument();
+    expect(screen.getByText("指挥塔当前拿不到实时总览。先确认只读真相，再走一条恢复路径。")).toBeInTheDocument();
+    expect(screen.getByText("实时总览暂时不可读")).toBeInTheDocument();
+    expect(screen.getByText("指挥塔总览与 PM 会话列表当前都不可用。请稍后再试。")).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "重载指挥塔" })).toHaveAttribute("href", "/command-tower");
     expect(screen.getByRole("link", { name: "回到 PM 入口" })).toHaveAttribute("href", "/pm");
     expect(screen.queryByTestId("ct-live-client")).toBeNull();
diff --git a/apps/dashboard/tests/home_page.test.tsx b/apps/dashboard/tests/home_page.test.tsx
@@ -272,6 +272,9 @@ describe("dashboard home run-summary clarity", () => {
     expect(screen.getAllByText("只读 MCP 快速入口").length).toBeGreaterThan(0);
     expect(screen.getAllByText("API 与契约快速入口").length).toBeGreaterThan(0);
     expect(screen.getByText("显示四步首跑流程")).toBeInTheDocument();
+    expect(screen.getByText("当前实况")).toBeInTheDocument();
+    expect(screen.getByText("先从 PM 开始")).toBeInTheDocument();
+    expect(screen.queryByText("Start in PM")).not.toBeInTheDocument();
   });
 
   it("maps latest failure category to semantic label and provides governance link", async () => {
diff --git a/packages/frontend-shared/uiCopy.ts b/packages/frontend-shared/uiCopy.ts
@@ -2698,7 +2698,7 @@ const UI_COPY: Record<UiLocale, UiCopy> = {
         unavailableBadge: "实时数据缺失",
         partialTitle: "指挥塔当前只提供部分真相",
         partialNextAction:
-          "当前可见总览只能算部分快照。做审批、回滚或发布判断前，先直接核对 Runs 或 Workflow Cases。",
+          "当前可见总览只能算部分快照。做审批、回滚或发布判断前，先直接核对运行记录或工作流案例。",
         partialBadge: "上下文不完整",
         actions: {
           reload: "重载指挥塔",

Original file line number	Diff line number	Diff line change
`@@ -191,7 +191,7 @@ export default function DashboardHomeStorySections({`
`191`	`191`	`locale === "zh-CN"`
`192`	`192`	`? [`
`193`	`193`	`{`
`194`		`- kicker: "当前 live",`
	`194`	`+ kicker: "当前实况",`
`195`	`195`	`value: hasRunHistory ? String(runningCount) : "0",`
`196`	`196`	`detail: hasRunHistory ? "先读指挥塔，再下钻明细" : "先起第一条任务，系统才会亮起来",`
`197`	`197`	`},`
`@@ -202,7 +202,7 @@ export default function DashboardHomeStorySections({`
`202`	`202`	`},`
`203`	`203`	`{`
`204`	`204`	`kicker: "真相路径",`
`205`		`- value: hasRunHistory ? "Workflow + Proof" : "Start in PM",`
	`205`	`+ value: hasRunHistory ? "工作流 + 证明" : "先从 PM 开始",`
`206`	`206`	`detail: hasRunHistory ? "首页只负责导向，不负责替代证明室" : "先写请求，再让真相面出现",`
`207`	`207`	`},`
`208`	`208`	`]`