feat: add main agent governance foundation

web/storyforge-web-v4/assets/app.js

@@ -54,6 +54,11 @@ const appState = {
   onelinerMessages: [],
   onelinerActionRegistry: [],
   platformAgents: [],
+  onelinerGovernanceEffective: null,
+  userGlobalPolicy: null,
+  userCurrentPlatformPolicy: null,
+  adminSystemMainPolicy: null,
+  adminSystemPlatformPolicies: [],
   tenantQuota: null,
   tenantUsage: null,
   adminOpsOverview: null,
@@ -1038,6 +1043,9 @@ function renderOneLinerUi() {
   const status = document.querySelector('[data-role="oneliner-status"]');
   const input = document.querySelector('[data-role="oneliner-input"]');
   const profile = appState.onelinerProfile;
+  const effective = appState.onelinerGovernanceEffective;
+  const highlights = summarizePolicyHighlights(effective?.effective_policy || {}, effective?.platform || "");
+  const layers = safeArray(effective?.layers);
   if (fab) {
     fab.hidden = !appState.session;
   }
@@ -1050,6 +1058,11 @@ function renderOneLinerUi() {
         <span class="tag green">${escapeHtml(formatNumber(safeArray(appState.platformAgents).length))} 个平台 Agent</span>
       </div>
       <div class="helper-text">${escapeHtml(profile?.long_term_goal || "当前没有设置长期目标。你可以先在这里说目标，后续再逐步产品化。")}</div>
+      <div class="task-meta" style="margin-top:10px;">
+        ${layers.map((layer) => `<span class="tag ${layer.scope_kind === "admin_override" ? "orange" : "blue"}">${escapeHtml(policyScopeTagLabel(layer.scope_kind, layer.scope?.platform || effective?.platform || ""))}</span>`).join("") || `<span class="tag">还没有策略层</span>`}
+        ${highlights.map((item) => `<span class="tag green">${escapeHtml(item)}</span>`).join("")}
+        <span class="tag clickable-tag" data-action="open-user-global-policy">我的策略</span>
+      </div>
     `;
   }
   if (sessions) sessions.innerHTML = renderOneLinerSessionTabs();
@@ -1243,6 +1256,11 @@ async function logoutSession() {
   appState.onelinerMessages = [];
   appState.onelinerActionRegistry = [];
   appState.platformAgents = [];
+  appState.onelinerGovernanceEffective = null;
+  appState.userGlobalPolicy = null;
+  appState.userCurrentPlatformPolicy = null;
+  appState.adminSystemMainPolicy = null;
+  appState.adminSystemPlatformPolicies = [];
   appState.tenantQuota = null;
   appState.tenantUsage = null;
   appState.adminOpsOverview = null;
@@ -1284,16 +1302,22 @@ async function loadStorageStatus(projectId = "") {
 
 async function loadAgentControlSurfaces(projectId = "") {
   const normalizedProjectId = projectId || getOneLinerProjectId();
+  const governancePlatform = normalizePlatformValue(getPreferredPlatform(), "douyin");
   const supportsOneLinerProfile = backendSupports("/v2/oneliner/profile");
   const supportsOneLinerSessions = backendSupports("/v2/oneliner/sessions");
   const supportsActionRegistry = backendSupports("/v2/oneliner/action-registry");
   const supportsPlatformAgents = backendSupports("/v2/platform-agents");
+  const supportsGovernanceEffective = backendSupports("/v2/oneliner/governance/effective");
+  const supportsUserGlobalPolicy = backendSupports("/v2/oneliner/governance/user/global");
+  const supportsUserPlatformPolicy = backendSupports("/v2/oneliner/governance/user/platforms/{platform}");
+  const supportsAdminSystemMainPolicy = backendSupports("/v2/admin/oneliner/governance/system/main-agent");
+  const supportsAdminSystemPlatformPolicy = backendSupports("/v2/admin/oneliner/governance/system/platforms/{platform}");
   const supportsAdminOps = backendSupports("/v2/admin/ops/overview");
   const supportsAdminFixRuns = backendSupports("/v2/admin/ops/fix-runs");
   const supportsTenantQuota = backendSupports("/v2/tenant/quota");
   const supportsTenantUsage = backendSupports("/v2/tenant/usage");
 
-  const [profile, sessionsPayload, actionRegistryPayload, platformAgentsPayload, tenantQuota, tenantUsage, adminOpsOverview, adminFixRunsPayload] = await Promise.all([
+  const [profile, sessionsPayload, actionRegistryPayload, platformAgentsPayload, governanceEffective, userGlobalPolicy, userCurrentPlatformPolicy, adminSystemMainPolicy, adminSystemPlatformPolicies, tenantQuota, tenantUsage, adminOpsOverview, adminFixRunsPayload] = await Promise.all([
     supportsOneLinerProfile
       ? storyforgeFetch(`/v2/oneliner/profile?project_id=${encodeURIComponent(normalizedProjectId)}`).catch(() => null)
       : Promise.resolve(null),
@@ -1306,6 +1330,23 @@ async function loadAgentControlSurfaces(projectId = "") {
     supportsPlatformAgents
       ? storyforgeFetch(`/v2/platform-agents?project_id=${encodeURIComponent(normalizedProjectId)}`).catch(() => ({ items: [] }))
       : Promise.resolve({ items: [] }),
+    supportsGovernanceEffective
+      ? storyforgeFetch(`/v2/oneliner/governance/effective?project_id=${encodeURIComponent(normalizedProjectId)}&platform=${encodeURIComponent(governancePlatform)}`).catch(() => null)
+      : Promise.resolve(null),
+    supportsUserGlobalPolicy
+      ? storyforgeFetch(`/v2/oneliner/governance/user/global?project_id=${encodeURIComponent(normalizedProjectId)}`).catch(() => null)
+      : Promise.resolve(null),
+    supportsUserPlatformPolicy
+      ? storyforgeFetch(`/v2/oneliner/governance/user/platforms/${encodeURIComponent(governancePlatform)}?project_id=${encodeURIComponent(normalizedProjectId)}`).catch(() => null)
+      : Promise.resolve(null),
+    supportsAdminSystemMainPolicy && isSuperAdmin()
+      ? storyforgeFetch("/v2/admin/oneliner/governance/system/main-agent").catch(() => null)
+      : Promise.resolve(null),
+    supportsAdminSystemPlatformPolicy && isSuperAdmin()
+      ? Promise.all(ACTIVE_PLATFORMS.map((item) =>
+          storyforgeFetch(`/v2/admin/oneliner/governance/system/platforms/${encodeURIComponent(item.value)}`).catch(() => null)
+        ))
+      : Promise.resolve([]),
     supportsTenantQuota
       ? storyforgeFetch(`/v2/tenant/quota?project_id=${encodeURIComponent(normalizedProjectId)}`).catch(() => null)
       : Promise.resolve(null),
@@ -1327,6 +1368,11 @@ async function loadAgentControlSurfaces(projectId = "") {
     appState.selectedOnelinerSessionId = safeArray(appState.onelinerSessions)[0]?.id || "";
   }
   appState.platformAgents = safeArray(platformAgentsPayload?.items || platformAgentsPayload);
+  appState.onelinerGovernanceEffective = governanceEffective;
+  appState.userGlobalPolicy = userGlobalPolicy;
+  appState.userCurrentPlatformPolicy = userCurrentPlatformPolicy;
+  appState.adminSystemMainPolicy = adminSystemMainPolicy;
+  appState.adminSystemPlatformPolicies = safeArray(adminSystemPlatformPolicies);
   appState.tenantQuota = tenantQuota;
   appState.tenantUsage = tenantUsage;
   appState.adminOpsOverview = adminOpsOverview;
@@ -3138,6 +3184,91 @@ function renderTenantQuotaPanel() {
   `;
 }
 
+function policyScopeTagLabel(scopeKind, platform = "") {
+  if (scopeKind === "system_main") return "系统默认";
+  if (scopeKind === "system_platform") return `${platformLabel(platform || "douyin")} 默认`;
+  if (scopeKind === "user_global") return "我的全局";
+  if (scopeKind === "user_platform") return `${platformLabel(platform || "douyin")} 我的策略`;
+  if (scopeKind === "admin_override") return "管理员覆盖";
+  return "策略层";
+}
+
+function summarizePolicyHighlights(policy = {}, platform = "") {
+  const items = [];
+  if (policy?.tone?.style) items.push(`语气 ${policy.tone.style}`);
+  if (policy?.actions?.max_cards != null) items.push(`首页动作 ${formatNumber(policy.actions.max_cards)} 条`);
+  if (policy?.memory?.default_window) items.push(`记忆窗口 ${policy.memory.default_window}`);
+  if (platform && policy?.[platform]?.benchmark_mode) items.push(`${platformLabel(platform)} 对标 ${policy[platform].benchmark_mode}`);
+  if (policy?.guardrails?.require_admin_review) items.push("需管理员复核");
+  return items.slice(0, 4);
+}
+
+function renderGovernanceSummaryCard({ title, subtitle, effective, primaryAction = "", primaryLabel = "编辑策略", secondaryAction = "", secondaryLabel = "", secondaryPlatform = "" }) {
+  const layers = safeArray(effective?.layers);
+  const highlights = summarizePolicyHighlights(effective?.effective_policy || {}, effective?.platform || secondaryPlatform || "");
+  return `
+    <div class="task-item compact">
+      <h4>${escapeHtml(title)}</h4>
+      <p>${escapeHtml(subtitle || "当前还没有策略摘要。")}</p>
+      <div class="task-meta">
+        ${layers.map((layer) => `<span class="tag ${layer.scope_kind === "admin_override" ? "orange" : "blue"}">${escapeHtml(policyScopeTagLabel(layer.scope_kind, layer.scope?.platform || effective?.platform || ""))}</span>`).join("") || `<span class="tag">尚未发布</span>`}
+        ${highlights.map((item) => `<span class="tag green">${escapeHtml(item)}</span>`).join("")}
+      </div>
+      ${(primaryAction || secondaryAction) ? `
+        <div class="task-meta" style="margin-top:10px;">
+          ${primaryAction ? `<span class="tag clickable-tag" data-action="${escapeHtml(primaryAction)}">${escapeHtml(primaryLabel)}</span>` : ""}
+          ${secondaryAction ? `<span class="tag clickable-tag" data-action="${escapeHtml(secondaryAction)}" ${secondaryPlatform ? `data-platform="${escapeHtml(secondaryPlatform)}"` : ""}>${escapeHtml(secondaryLabel)}</span>` : ""}
+        </div>
+      ` : ""}
+    </div>
+  `;
+}
+
+function renderAdminGovernanceSummaryPanel() {
+  const systemMain = appState.adminSystemMainPolicy;
+  const systemPlatforms = safeArray(appState.adminSystemPlatformPolicies);
+  const configuredPlatforms = systemPlatforms.filter((item) => item?.current_version);
+  return `
+    <div class="panel pad" style="box-shadow:none; margin-bottom:18px;">
+      <div class="panel-head">
+        <div>
+          <h3>系统级主 Agent 治理</h3>
+          <div class="panel-subtitle">先管系统默认主 Agent，再按平台补默认策略，普通用户的个性化覆盖会叠加在这些底座之上。</div>
+        </div>
+        <div class="task-meta">
+          <span class="tag blue">系统主 Agent ${escapeHtml(systemMain?.current_version ? "已发布" : "未发布")}</span>
+          <span class="tag">${escapeHtml(formatNumber(configuredPlatforms.length))} 个平台默认策略</span>
+          <span class="tag clickable-tag" data-action="open-system-main-policy">编辑系统主 Agent</span>
+        </div>
+      </div>
+      <div class="three-col">
+        <div class="entity-card pad">
+          <div class="cell-title">系统主 Agent</div>
+          <div class="cell-desc">${escapeHtml(systemMain?.current_version?.summary || "还没有发布系统默认主 Agent 策略。")}</div>
+          <div class="entity-meta">
+            <span class="tag ${systemMain?.current_version ? "green" : "orange"}">${escapeHtml(systemMain?.current_version ? `版本 ${formatNumber(systemMain.current_version.version_no)}` : "未发布")}</span>
+            <span class="tag">历史 ${escapeHtml(formatNumber(systemMain?.versions?.count || 0))}</span>
+          </div>
+        </div>
+        ${ACTIVE_PLATFORMS.map((platformItem) => {
+          const item = systemPlatforms.find((entry) => entry?.scope?.platform === platformItem.value) || null;
+          return `
+            <div class="entity-card pad">
+              <div class="cell-title">${escapeHtml(platformItem.label)} 默认策略</div>
+              <div class="cell-desc">${escapeHtml(item?.current_version?.summary || "还没有平台默认策略，当前会沿用系统主 Agent 默认。")}</div>
+              <div class="entity-meta">
+                <span class="tag ${item?.current_version ? "green" : "blue"}">${escapeHtml(item?.current_version ? `版本 ${formatNumber(item.current_version.version_no)}` : "沿用系统默认")}</span>
+                <span class="tag">历史 ${escapeHtml(formatNumber(item?.versions?.count || 0))}</span>
+                <span class="tag clickable-tag" data-action="open-system-platform-policy" data-platform="${escapeHtml(platformItem.value)}">编辑</span>
+              </div>
+            </div>
+          `;
+        }).join("")}
+      </div>
+    </div>
+  `;
+}
+
 function renderPlatformAgentPanel() {
   const items = safeArray(appState.platformAgents);
   if (!items.length) {
@@ -3906,7 +4037,7 @@ function renderAdminWorkbenchScreen() {
           : activeTab === "storage"
             ? renderStorageStatusPanel()
             : activeTab === "agents"
-              ? `${renderPlatformAgentPanel()}<div style="margin-top:18px;">${renderOneLinerActionRegistryPanel()}</div>`
+              ? `${renderAdminGovernanceSummaryPanel()}${renderPlatformAgentPanel()}<div style="margin-top:18px;">${renderOneLinerActionRegistryPanel()}</div>`
               : renderAdminOpsPanel()}
       </div>
     `
@@ -4620,6 +4751,16 @@ function renderPlaybookScreen() {
                     <span class="tag clickable-tag" data-action="open-oneliner-profile">编辑配置</span>
                   </div>
                 </div>
+                ${renderGovernanceSummaryCard({
+                  title: "我的策略与历史",
+                  subtitle: appState.userGlobalPolicy?.current_version?.summary || "你和主 Agent 的策略对话，会先沉淀成用户全局策略，再按需要下放到单平台。",
+                  effective: appState.onelinerGovernanceEffective,
+                  primaryAction: "open-user-global-policy",
+                  primaryLabel: `编辑全局策略 · 历史 ${formatNumber(appState.userGlobalPolicy?.versions?.count || 0)}`,
+                  secondaryAction: "open-user-platform-policy",
+                  secondaryLabel: `编辑当前平台策略 · 历史 ${formatNumber(appState.userCurrentPlatformPolicy?.versions?.count || 0)}`,
+                  secondaryPlatform: appState.onelinerGovernanceEffective?.platform || appState.onelinerProfile?.default_platform || getPreferredPlatform()
+                })}
               </div>
               <div class="panel pad" style="box-shadow:none; margin-top:18px;">
                 <div class="panel-head">
@@ -6221,12 +6362,192 @@ function openOneLinerProfileAction() {
         }
       });
       appState.onelinerProfile = saved;
+      await loadAgentControlSurfaces(project.id);
       rememberAction("OneLiner 已保存", `已更新 OneLiner「${saved.display_name || "OneLiner"}」配置。`, "green", saved);
       renderAll();
     }
   });
 }
 
+function parsePolicyJsonField(rawValue, label = "策略 JSON") {
+  const text = String(rawValue || "").trim();
+  if (!text) return {};
+  try {
+    const parsed = JSON.parse(text);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error(`${label} 必须是 JSON 对象`);
+    }
+    return parsed;
+  } catch (error) {
+    throw new Error(`${label} 格式不正确：${error.message}`);
+  }
+}
+
+function renderPolicyVersionSummary(bundle, emptyText) {
+  if (!bundle?.current_version) {
+    return `
+      <div class="sheet-html">
+        <div class="task-item compact">
+          <h4>还没有已发布版本</h4>
+          <p>${escapeHtml(emptyText)}</p>
+        </div>
+      </div>
+    `;
+  }
+  return `
+    <div class="sheet-html">
+      <div class="task-item compact">
+        <h4>${escapeHtml(bundle.current_version.title || bundle.scope?.title || "当前版本")}</h4>
+        <p>${escapeHtml(bundle.current_version.summary || "当前版本还没有补摘要。")}</p>
+        <div class="task-meta">
+          <span class="tag blue">版本 ${escapeHtml(formatNumber(bundle.current_version.version_no || 0))}</span>
+          <span class="tag">历史 ${escapeHtml(formatNumber(bundle.versions?.count || 0))}</span>
+          ${bundle.effectivity?.effect_mode ? `<span class="tag">${escapeHtml(bundle.effectivity.effect_mode)}</span>` : ""}
+        </div>
+      </div>
+    </div>
+  `;
+}
+
+function openUserGlobalPolicyAction() {
+  const project = requireSelectedProject();
+  const bundle = appState.userGlobalPolicy || {};
+  const current = bundle.current_version || {};
+  openActionModal({
+    title: "编辑我的全局策略",
+    description: "这层策略只影响你自己，会优先被主 Agent 读取，再决定是否下发到各个平台 Agent。",
+    submitLabel: "保存全局策略",
+    fields: [
+      { type: "html", label: "当前版本", html: renderPolicyVersionSummary(bundle, "你还没有发布自己的全局策略，当前会沿用系统默认和平台默认。") },
+      { name: "title", label: "策略标题", value: current.title || bundle.scope?.title || "用户全局策略", placeholder: "例如：创业内容增长策略" },
+      { name: "summary", label: "摘要", type: "textarea", rows: 3, value: current.summary || "", placeholder: "写清楚这层策略主要在约束什么、优化什么" },
+      { name: "policyJson", label: "策略 JSON", type: "textarea", rows: 8, value: JSON.stringify(current.policy || {}, null, 2), placeholder: "{\"tone\":{\"style\":\"analytical\"}}" },
+      { name: "reason", label: "变更原因", type: "textarea", rows: 3, value: "", placeholder: "例如：用户要求首页动作更聚焦，默认走分析型语气" }
+    ],
+    onSubmit: async (values) => {
+      const saved = await storyforgeFetch("/v2/oneliner/governance/user/global", {
+        method: "PUT",
+        body: {
+          project_id: project.id,
+          title: values.title || "用户全局策略",
+          summary: values.summary || "",
+          policy: parsePolicyJsonField(values.policyJson, "全局策略 JSON"),
+          reason: values.reason || ""
+        }
+      });
+      appState.userGlobalPolicy = saved;
+      await loadAgentControlSurfaces(project.id);
+      rememberAction("我的全局策略已保存", `已发布版本 ${saved.current_version?.version_no || 1}。`, "green", saved);
+      renderAll();
+    }
+  });
+}
+
+function openUserPlatformPolicyAction(platform) {
+  const normalizedPlatform = normalizePlatformValue(platform || getPreferredPlatform(), "douyin");
+  const project = requireSelectedProject();
+  const bundle = appState.userCurrentPlatformPolicy || {};
+  const current = bundle.current_version || {};
+  openActionModal({
+    title: `编辑 ${platformLabel(normalizedPlatform)} 平台策略`,
+    description: "这层策略只作用于你当前项目下的单个平台，会覆盖你的全局策略，但不会影响其他平台。",
+    submitLabel: "保存平台策略",
+    fields: [
+      { type: "html", label: "当前版本", html: renderPolicyVersionSummary(bundle, "你还没有发布单平台策略，当前会沿用全局策略和系统默认。") },
+      { name: "title", label: "策略标题", value: current.title || `${platformLabel(normalizedPlatform)} 用户平台策略`, placeholder: "例如：抖音对标拆解策略" },
+      { name: "summary", label: "摘要", type: "textarea", rows: 3, value: current.summary || "", placeholder: "写清楚这个平台的特殊规则和工作方式" },
+      { name: "policyJson", label: "策略 JSON", type: "textarea", rows: 8, value: JSON.stringify(current.policy || {}, null, 2), placeholder: "{\"actions\":{\"max_cards\":1}}" },
+      { name: "reason", label: "变更原因", type: "textarea", rows: 3, value: "", placeholder: "例如：抖音只保留 1 条首页动作，优先高分作品拆解" }
+    ],
+    onSubmit: async (values) => {
+      const saved = await storyforgeFetch(`/v2/oneliner/governance/user/platforms/${encodeURIComponent(normalizedPlatform)}`, {
+        method: "PUT",
+        body: {
+          project_id: project.id,
+          title: values.title || `${platformLabel(normalizedPlatform)} 用户平台策略`,
+          summary: values.summary || "",
+          policy: parsePolicyJsonField(values.policyJson, "平台策略 JSON"),
+          reason: values.reason || ""
+        }
+      });
+      appState.userCurrentPlatformPolicy = saved;
+      await loadAgentControlSurfaces(project.id);
+      rememberAction(`${platformLabel(normalizedPlatform)} 平台策略已保存`, `已发布版本 ${saved.current_version?.version_no || 1}。`, "green", saved);
+      renderAll();
+    }
+  });
+}
+
+function openSystemMainPolicyAction() {
+  const projectId = getOneLinerProjectId();
+  const bundle = appState.adminSystemMainPolicy || {};
+  const current = bundle.current_version || {};
+  openActionModal({
+    title: "编辑系统主 Agent 策略",
+    description: "这是所有用户共享的系统级主 Agent 基座能力，后续用户层和管理员覆盖都会叠加在它上面。",
+    submitLabel: "保存系统策略",
+    fields: [
+      { type: "html", label: "当前版本", html: renderPolicyVersionSummary(bundle, "系统主 Agent 还没有系统默认策略。") },
+      { name: "title", label: "策略标题", value: current.title || bundle.scope?.title || "系统主 Agent 策略", placeholder: "例如：StoryForge 主 Agent 默认策略" },
+      { name: "summary", label: "摘要", type: "textarea", rows: 3, value: current.summary || "", placeholder: "写清楚当前系统主 Agent 主要服务的方向和约束" },
+      { name: "policyJson", label: "策略 JSON", type: "textarea", rows: 8, value: JSON.stringify(current.policy || {}, null, 2), placeholder: "{\"homepage\":{\"focus\":\"ops\"}}" },
+      { name: "reason", label: "发布原因", type: "textarea", rows: 3, value: "", placeholder: "例如：更新市场节奏后，需要调整首页推荐和调度逻辑" }
+    ],
+    onSubmit: async (values) => {
+      const saved = await storyforgeFetch("/v2/admin/oneliner/governance/system/main-agent", {
+        method: "PUT",
+        body: {
+          title: values.title || "系统主 Agent 策略",
+          summary: values.summary || "",
+          policy: parsePolicyJsonField(values.policyJson, "系统策略 JSON"),
+          reason: values.reason || ""
+        }
+      });
+      appState.adminSystemMainPolicy = saved;
+      await loadAgentControlSurfaces(projectId);
+      rememberAction("系统主 Agent 策略已保存", `已发布版本 ${saved.current_version?.version_no || 1}。`, "green", saved);
+      renderAll();
+    }
+  });
+}
+
+function openSystemPlatformPolicyAction(platform) {
+  const normalizedPlatform = normalizePlatformValue(platform, "douyin");
+  const projectId = getOneLinerProjectId();
+  const bundle = safeArray(appState.adminSystemPlatformPolicies).find((item) => item?.scope?.platform === normalizedPlatform) || {};
+  const current = bundle.current_version || {};
+  openActionModal({
+    title: `编辑 ${platformLabel(normalizedPlatform)} 系统平台策略`,
+    description: "这是所有用户共享的系统级平台默认策略，用户自己的平台偏好会在这层之上覆盖。",
+    submitLabel: "保存平台默认策略",
+    fields: [
+      { type: "html", label: "当前版本", html: renderPolicyVersionSummary(bundle, `当前 ${platformLabel(normalizedPlatform)} 还没有系统平台默认策略。`) },
+      { name: "title", label: "策略标题", value: current.title || `${platformLabel(normalizedPlatform)} 系统平台策略`, placeholder: "例如：抖音系统平台策略" },
+      { name: "summary", label: "摘要", type: "textarea", rows: 3, value: current.summary || "", placeholder: "写清楚这个平台默认遵循的拆解与执行逻辑" },
+      { name: "policyJson", label: "策略 JSON", type: "textarea", rows: 8, value: JSON.stringify(current.policy || {}, null, 2), placeholder: "{\"douyin\":{\"benchmark_mode\":\"strict\"}}" },
+      { name: "reason", label: "发布原因", type: "textarea", rows: 3, value: "", placeholder: "例如：平台节奏变化，需要调整系统默认方法论" }
+    ],
+    onSubmit: async (values) => {
+      const saved = await storyforgeFetch(`/v2/admin/oneliner/governance/system/platforms/${encodeURIComponent(normalizedPlatform)}`, {
+        method: "PUT",
+        body: {
+          title: values.title || `${platformLabel(normalizedPlatform)} 系统平台策略`,
+          summary: values.summary || "",
+          policy: parsePolicyJsonField(values.policyJson, "平台默认策略 JSON"),
+          reason: values.reason || ""
+        }
+      });
+      appState.adminSystemPlatformPolicies = safeArray(appState.adminSystemPlatformPolicies)
+        .filter((item) => item?.scope?.platform !== normalizedPlatform)
+        .concat(saved)
+        .sort((a, b) => String(a?.scope?.platform || "").localeCompare(String(b?.scope?.platform || "")));
+      await loadAgentControlSurfaces(projectId);
+      rememberAction(`${platformLabel(normalizedPlatform)} 系统平台策略已保存`, `已发布版本 ${saved.current_version?.version_no || 1}。`, "green", saved);
+      renderAll();
+    }
+  });
+}
+
 function openPlatformAgentProfileAction(platform) {
   const project = requireSelectedProject();
   const agents = safeArray(appState.platformAgents);
@@ -7991,6 +8312,22 @@ document.addEventListener("click", async (event) => {
       openOneLinerProfileAction();
       return;
     }
+    if (name === "open-user-global-policy") {
+      openUserGlobalPolicyAction();
+      return;
+    }
+    if (name === "open-user-platform-policy") {
+      openUserPlatformPolicyAction(action.dataset.platform || "");
+      return;
+    }
+    if (name === "open-system-main-policy") {
+      openSystemMainPolicyAction();
+      return;
+    }
+    if (name === "open-system-platform-policy") {
+      openSystemPlatformPolicyAction(action.dataset.platform || "");
+      return;
+    }
     if (name === "select-oneliner-session") {
       appState.selectedOnelinerSessionId = action.dataset.sessionId || "";
       await loadOneLinerMessages(appState.selectedOnelinerSessionId);

web/storyforge-web-v4/tests/workbench-pages.test.mjs

@@ -37,6 +37,9 @@ test("agent screen excludes quota and registry panels and uses page tabs", () =>
   assert.doesNotMatch(source, /renderTenantQuotaPanel\(/);
   assert.doesNotMatch(source, /renderOneLinerActionRegistryPanel\(/);
   assert.match(source, /renderDetailTabs\("playbookDetailTab"/);
+  assert.match(source, /renderGovernanceSummaryCard\(/);
+  assert.match(source, /open-user-global-policy/);
+  assert.match(source, /open-user-platform-policy/);
 });
 
 test("discovery, production, and admin screens use page tabs for heavy content", () => {
@@ -47,6 +50,7 @@ test("discovery, production, and admin screens use page tabs for heavy content",
   assert.match(discovery, /renderDetailTabs\("discoveryDetailTab"/);
   assert.match(production, /renderDetailTabs\("productionDetailTab"/);
   assert.match(admin, /renderDetailTabs\("adminWorkbenchTab"/);
+  assert.match(admin, /renderAdminGovernanceSummaryPanel\(/);
 });
 
 test("projects screen uses an adaptive project grid instead of a fixed three-column squeeze", () => {
@@ -93,3 +97,46 @@ test("oneliner submit failures stay inside the app instead of using a browser al
   assert.doesNotMatch(APP, /alert\("OneLiner 调度失败:/);
   assert.match(APP, /presentActionFailure\(error,\s*"OneLiner 调度失败"\)/);
 });
+
+test("agent control surfaces load governance endpoints for user and admin summaries", () => {
+  const source = extractBetween(APP, "async function loadAgentControlSurfaces(projectId = \"\")", "async function loadOneLinerMessages(sessionId)");
+  assert.match(source, /\/v2\/oneliner\/governance\/effective/);
+  assert.match(source, /\/v2\/oneliner\/governance\/user\/global/);
+  assert.match(source, /\/v2\/oneliner\/governance\/user\/platforms\/\$\{encodeURIComponent\(governancePlatform\)\}/);
+  assert.match(source, /\/v2\/admin\/oneliner\/governance\/system\/main-agent/);
+  assert.match(source, /\/v2\/admin\/oneliner\/governance\/system\/platforms\/\$\{encodeURIComponent\(item\.value\)\}/);
+});
+
+test("oneliner meta and action handlers expose governance entry points", () => {
+  const meta = extractBetween(APP, "function renderOneLinerUi()", "function openOneLinerPanel()");
+  const actions = extractBetween(APP, "document.addEventListener(\"click\", async (event) => {", "document.addEventListener(\"submit\", async (event) => {");
+  assert.match(meta, /open-user-global-policy/);
+  assert.match(meta, /policyScopeTagLabel/);
+  assert.match(actions, /name === "open-user-global-policy"/);
+  assert.match(actions, /name === "open-system-main-policy"/);
+});
+
+test("system governance saves refresh control surfaces after persisting", () => {
+  const profile = extractBetween(APP, "function openOneLinerProfileAction()", "function parsePolicyJsonField(rawValue, label = \"策略 JSON\")");
+  const userGlobal = extractBetween(APP, "function openUserGlobalPolicyAction()", "function openUserPlatformPolicyAction(platform)");
+  const userPlatform = extractBetween(APP, "function openUserPlatformPolicyAction(platform)", "function openSystemMainPolicyAction()");
+  const main = extractBetween(APP, "function openSystemMainPolicyAction()", "function openSystemPlatformPolicyAction(platform)");
+  const platform = extractBetween(APP, "function openSystemPlatformPolicyAction(platform)", "function openPlatformAgentProfileAction(platform)");
+
+  assert.match(profile, /appState\.onelinerProfile = saved;/);
+  assert.match(profile, /await loadAgentControlSurfaces\(project\.id\);/);
+
+  assert.match(userGlobal, /appState\.userGlobalPolicy = saved;/);
+  assert.match(userGlobal, /await loadAgentControlSurfaces\(project\.id\);/);
+
+  assert.match(userPlatform, /appState\.userCurrentPlatformPolicy = saved;/);
+  assert.match(userPlatform, /await loadAgentControlSurfaces\(project\.id\);/);
+
+  assert.match(main, /const projectId = getOneLinerProjectId\(\);/);
+  assert.match(main, /appState\.adminSystemMainPolicy = saved;/);
+  assert.match(main, /await loadAgentControlSurfaces\(projectId\);/);
+
+  assert.match(platform, /const projectId = getOneLinerProjectId\(\);/);
+  assert.match(platform, /appState\.adminSystemPlatformPolicies = safeArray\(appState\.adminSystemPlatformPolicies\)/);
+  assert.match(platform, /await loadAgentControlSurfaces\(projectId\);/);
+});