源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)

packages/agent/gui/shared/workspaceSettingsPanel/workspaceSettingsPanelStore.spec.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "vitest";
+import {
+  getWorkspaceSettingsPanelStore,
+  openWorkspaceSettingsPanel
+} from "./workspaceSettingsPanelStore.ts";
+
+describe("workspace settings panel deep-link intent", () => {
+  it("carries section, pane, and provider and bumps the sequence", () => {
+    const before = getWorkspaceSettingsPanelStore().requestSequence;
+    openWorkspaceSettingsPanel({
+      section: "agent",
+      pane: "agents",
+      provider: "hermes"
+    });
+    const store = getWorkspaceSettingsPanelStore();
+    expect(store.section).toBe("agent");
+    expect(store.pane).toBe("agents");
+    expect(store.provider).toBe("hermes");
+    expect(store.requestSequence).toBe(before + 1);
+  });
+
+  it("resets pane and provider when omitted", () => {
+    openWorkspaceSettingsPanel({
+      section: "agent",
+      pane: "agents",
+      provider: "hermes"
+    });
+    openWorkspaceSettingsPanel({ section: "appearance" });
+    const store = getWorkspaceSettingsPanelStore();
+    expect(store.section).toBe("appearance");
+    expect(store.pane).toBeNull();
+    expect(store.provider).toBeNull();
+  });
+});

packages/agent/gui/shared/workspaceSettingsPanel/workspaceSettingsPanelStore.ts

@@ -0,0 +1,73 @@
+import { useSnapshot } from "valtio";
+import { proxy } from "valtio/vanilla";
+
+/**
+ * Deep-link intent to open the host's global workspace settings panel from
+ * anywhere in the agent-gui tree (e.g. the conversation rail's "Usage &
+ * Settings" popover). The host (apps/desktop) watches this singleton store and
+ * opens its settings panel, navigating to `section` when provided.
+ *
+ * Workspace settings keeps this legacy request channel; Agent Env uses an
+ * injected host command and a desktop-owned service instead
+ * settings service; it only publishes the intent as a plain string section.
+ */
+export interface WorkspaceSettingsPanelRequest {
+  /**
+   * Which settings section to navigate to, e.g. "agent". Kept as a plain string
+   * so agent-gui does not depend on the host's section id union; the host
+   * validates/casts it.
+   */
+  section: string | null;
+  /**
+   * Optional sub-pane within the section, e.g. "agents" to open the Agents tab
+   * of the agent section. Plain string; the host validates/casts it.
+   */
+  pane: string | null;
+  /**
+   * Optional provider/agent id to focus once the pane is open, e.g. deep-linking
+   * from an agent's "more" action to its row in the Agents tab. Plain string.
+   */
+  provider: string | null;
+  /**
+   * Bumped on every openWorkspaceSettingsPanel() call so the host reacts even
+   * when the panel is already open or the section is unchanged.
+   */
+  requestSequence: number;
+}
+
+export interface OpenWorkspaceSettingsPanelInput {
+  section?: string | null;
+  pane?: string | null;
+  provider?: string | null;
+}
+
+const workspaceSettingsPanelStore = proxy<WorkspaceSettingsPanelRequest>({
+  section: null,
+  pane: null,
+  provider: null,
+  requestSequence: 0
+});
+
+/**
+ * Request that the host open the global workspace settings panel. Safe to call
+ * from anywhere in the agent-gui tree; the host renders the actual panel and
+ * reacts to this singleton store.
+ */
+export function openWorkspaceSettingsPanel(
+  input?: OpenWorkspaceSettingsPanelInput
+): void {
+  workspaceSettingsPanelStore.section = input?.section ?? null;
+  workspaceSettingsPanelStore.pane = input?.pane ?? null;
+  workspaceSettingsPanelStore.provider = input?.provider ?? null;
+  workspaceSettingsPanelStore.requestSequence += 1;
+}
+
+/** Imperative read, mainly for tests. Components should use the hook. */
+export function getWorkspaceSettingsPanelStore(): WorkspaceSettingsPanelRequest {
+  return workspaceSettingsPanelStore;
+}
+
+/** Reactive snapshot of the panel request for the host renderer. */
+export function useWorkspaceSettingsPanelRequest(): WorkspaceSettingsPanelRequest {
+  return useSnapshot(workspaceSettingsPanelStore);
+}