@orbit-work/ui 0.1.0

package/src/components/domain/desktop/DesktopConnectorDetailView/index.tsx

@@ -0,0 +1,301 @@
+"use client"
+
+import { Fragment, type ReactNode } from "react"
+import { Banner } from "../../../composite/Banner"
+import { Switch } from "../../../composite/Controls"
+import { Edit, Refresh, Terminal, Trash } from "../../../composite/Icons"
+import { Button, Chip } from "../../../primitives"
+import type { ChipDotTone } from "../../../primitives/Chip"
+import { EmptyState } from "../../../primitives/EmptyState"
+import { GlyphToneProvider } from "../../skills/SkillAvatarView"
+import { DesktopCatalogDetailActions, DesktopCatalogDetailShell } from "../DesktopCatalogView"
+
+/*
+ * 连接器详情接管页 —— A11-B4（裁决 16）从 `DesktopWorkspaceView` 整块搬来。
+ *
+ * 搬家理由：这件与「我的空间」毫无关系，只是历史上同住一个文件。宿主是
+ * `apps/desktop/src/renderer/features/skills/ConnectorModal.tsx:468`（插件中心 · 连接器），
+ * 「我的空间」整页退役时若跟着一起删就会误伤，所以先独立门户。
+ *
+ * 旧名（`DesktopWorkspaceConnector*`）在本文件尾部以 @deprecated 别名保留，
+ * 宿主与既有 import 不受影响；别名随下一次破坏性版本移除。
+ */
+export interface DesktopConnectorToolView {
+  id: string
+  name: ReactNode
+  description?: ReactNode
+  state?: ReactNode
+}
+export interface DesktopConnectorActionView {
+  id: string
+  label: ReactNode
+  icon?: ReactNode
+  variant?: "primary" | "secondary" | "danger"
+  disabled?: boolean
+  overflow?: boolean
+  onAction?: () => void
+}
+export interface DesktopConnectorMetaView {
+  id: string
+  label: ReactNode
+  value: ReactNode
+}
+export interface DesktopConnectorDetailViewProps {
+  logo: ReactNode
+  name: ReactNode
+  author?: ReactNode
+  version?: ReactNode
+  description: ReactNode
+  backLabel?: ReactNode
+  runtime?: ReactNode
+  status?: ReactNode
+  statusTone?: "ok" | "muted" | "warning" | "error"
+  command?: ReactNode
+  enabled?: boolean
+  error?: ReactNode
+  tools: DesktopConnectorToolView[]
+  toolSummary?: ReactNode
+  emptyToolsText?: ReactNode
+  toolAction?: DesktopConnectorActionView
+  actions?: DesktopConnectorActionView[]
+  metadata?: DesktopConnectorMetaView[]
+  authorization?: ReactNode
+  detailContent?: ReactNode
+  detailLoading?: boolean
+  detailError?: ReactNode
+  onBack: () => void
+  onToggle?: (enabled: boolean) => void
+  onRefresh?: () => void
+  onEdit?: () => void
+  onRemove?: () => void
+  onCopyDiagnostic?: () => void
+}
+
+/** Desktop 发现连接器详情接管页；行为由宿主 adapter 注入。 */
+export function DesktopConnectorDetailView({
+  logo,
+  name,
+  author = "Orbitwork 官方",
+  version,
+  description,
+  backLabel = "返回插件 · 连接器",
+  runtime = "stdio",
+  status,
+  statusTone = "muted",
+  command,
+  enabled,
+  error,
+  tools,
+  toolSummary,
+  emptyToolsText = "这个连接器暂未提供工具",
+  toolAction,
+  actions,
+  metadata = [],
+  authorization,
+  detailContent,
+  detailLoading,
+  detailError,
+  onBack,
+  onToggle,
+  onRefresh,
+  onEdit,
+  onRemove,
+  onCopyDiagnostic,
+}: DesktopConnectorDetailViewProps) {
+  /*
+   * A4-B4 动作组收敛（原型 2174–2187 与 4729–4732）：页头右侧只留一颗主钮 ＋ 一颗 ⋯。
+   * 主钮＝「编辑配置」（原型那颗随状态变文案的主钮，连接器域对应「重新配置」这条线），
+   * 「刷新状态」与破坏性的「断开连接」进 ⋯。两处改动：
+   * ① 顺序调头 —— 收敛规则是「第一颗上台面」，刷新在前会把一个轮询动作顶成行动极；
+   * ② 「卸载连接器」改叫「断开连接」并标 overflow —— 红色实底的破坏钮原来就杵在页头右上角
+   *    「编辑配置」旁边，形与主钮同级、色比主钮更响，是整页最抢眼的一颗。
+   */
+  const resolvedActions: DesktopConnectorActionView[] = actions ?? [
+    ...(onEdit
+      ? [{ id: "edit", label: "编辑配置", icon: <Edit />, variant: "primary" as const, onAction: onEdit }]
+      : []),
+    ...(onRefresh
+      ? [{ id: "refresh", label: "刷新状态", icon: <Refresh />, overflow: true, onAction: onRefresh }]
+      : []),
+    ...(onRemove
+      ? [
+          {
+            id: "remove",
+            label: "断开连接",
+            icon: <Trash />,
+            variant: "danger" as const,
+            overflow: true,
+            onAction: onRemove,
+          },
+        ]
+      : []),
+  ]
+  const inlineActions = resolvedActions.filter((action) => !action.overflow)
+  const overflowActions = resolvedActions.filter((action) => action.overflow)
+  // R1 双编码（COMPONENT-RULES §4）：连接状态由 Chip 的状态点色 + 文字同时承载，
+  // 颜色只作第二编码；R3 中性件，四档均取功能色 fill，不碰信标荧黄。
+  const statusDot: ChipDotTone =
+    statusTone === "ok"
+      ? "success"
+      : statusTone === "warning"
+        ? "warning"
+        : statusTone === "error"
+          ? "error"
+          : "neutral"
+  return (
+    <DesktopCatalogDetailShell
+      /* R2·T2/Q10：详情壳的字形章与卡同源——连接器一律中性（原型 4688 的 `g` 与卡的
+         `glyphOf` 是同一份口径）。`logo` 可能是裸首字 span，也可能是 `SkillAvatarView`，
+         后者把色写在内联样式上、CSS 压不住，所以这里同样用上下文钉档。 */
+      avatar={
+        <GlyphToneProvider value="neutral">
+          <span className="g">{logo}</span>
+        </GlyphToneProvider>
+      }
+      name={name}
+      author={author}
+      version={version}
+      /* 状态签留在标题旁（原型 2169）：Chip 带状态点，是这一族里唯一需要「运行中/已停止」
+         这种活体读数的地方，所以没并进 StatusTag 的三档静态词表。 */
+      status={<Chip dot={status ? statusDot : enabled ? "success" : "neutral"} label={status ?? runtime} />}
+      kind="连接器"
+      summary={description}
+      actions={
+        <DesktopCatalogDetailActions
+          leading={enabled !== undefined && onToggle ? <Switch checked={enabled} onChange={onToggle} /> : undefined}
+          actions={inlineActions.map((action) => ({
+            key: action.id,
+            label: action.label,
+            icon: action.icon,
+            variant: action.variant,
+            disabled: action.disabled,
+            onAction: action.onAction,
+          }))}
+          menuItems={overflowActions.map((action) => ({
+            key: action.id,
+            label: typeof action.label === "string" ? action.label : action.id,
+            icon: action.icon ?? <Edit />,
+            danger: action.variant === "danger",
+            disabled: action.disabled,
+          }))}
+          onMenuSelect={(key) => overflowActions.find((action) => action.id === key)?.onAction?.()}
+        />
+      }
+      backLabel={backLabel}
+      onBack={onBack}
+    >
+      {error && (
+        <Banner
+          variant="error"
+          className="mt-3"
+          action={
+            onCopyDiagnostic && (
+              <Button variant="secondary" size="sm" onClick={onCopyDiagnostic}>
+                复制诊断
+              </Button>
+            )
+          }
+        >
+          {error}
+        </Banner>
+      )}
+      {/* 简介退出正文：同一句话已经在 hero 的标题下面（原型 2172）。 */}
+      {(metadata.length > 0 || command) && (
+        <section className="skd__section">
+          <div className="lbl">基本信息</div>
+          <div className="connector-kv">
+            {command && (
+              <>
+                <span>连接命令</span>
+                <b className="mono">{command}</b>
+              </>
+            )}
+            {metadata.map((item) => (
+              <Fragment key={item.id}>
+                <span>{item.label}</span>
+                <b>{item.value}</b>
+              </Fragment>
+            ))}
+          </div>
+        </section>
+      )}
+      {authorization && (
+        <section className="skd__section">
+          <div className="lbl">授权</div>
+          {authorization}
+        </section>
+      )}
+      {(detailContent || detailLoading || detailError) && (
+        <section className="skd__section">
+          <div className="lbl">详细介绍</div>
+          {detailLoading && <div className="skd__empty">详细介绍加载中…</div>}
+          {detailError && <Banner variant="error">{detailError}</Banner>}
+          {detailContent && <div className="skd__doc">{detailContent}</div>}
+        </section>
+      )}
+      <section className="skd__section">
+        {/* 原型对齐 R5：计数只出一处。摘要（「3 个可见工具」「安装后可见」…）在时由摘要承担，
+            .cnt 圆章只在没有摘要时回落，避免「3」圆章与「3 个可见工具」同屏重复读数。 */}
+        <div className="lbl">
+          工具{" "}
+          {toolSummary ? (
+            <span className="skd__lbl-note">{toolSummary}</span>
+          ) : (
+            <span className="cnt">{tools.length}</span>
+          )}
+        </div>
+        <div className="conn-tools">
+          {tools.length === 0 ? (
+            /* W3 终验 G5：工具列表空态走 EmptyState 紧凑档（母题＋一句＋动作槽），
+               .conn-tools__empty 灰字规则退役，类名保留作定位钩子。 */
+            <EmptyState
+              className="conn-tools__empty"
+              size="sm"
+              message={emptyToolsText}
+              action={
+                toolAction && (
+                  <Button
+                    size="sm"
+                    variant={toolAction.variant ?? "secondary"}
+                    icon={toolAction.icon}
+                    disabled={toolAction.disabled}
+                    onClick={toolAction.onAction}
+                  >
+                    {toolAction.label}
+                  </Button>
+                )
+              }
+            />
+          ) : (
+            tools.map((tool) => (
+              <div className="mcp-tool" key={tool.id}>
+                <span className="tg">
+                  <Terminal />
+                </span>
+                <div className="tmeta">
+                  <div className="tn mono">{tool.name}</div>
+                  {tool.description && <div className="td">{tool.description}</div>}
+                </div>
+                <span className="mcp-tool__state">{tool.state ?? "可用"}</span>
+              </div>
+            ))
+          )}
+        </div>
+      </section>
+    </DesktopCatalogDetailShell>
+  )
+}
+
+/** @deprecated 改用 `DesktopConnectorToolView`；旧名只为兼容既有 import 保留（A11-B4）。 */
+export type DesktopWorkspaceConnectorToolView = DesktopConnectorToolView
+/** @deprecated 改用 `DesktopConnectorActionView`；旧名只为兼容既有 import 保留（A11-B4）。 */
+export type DesktopWorkspaceConnectorActionView = DesktopConnectorActionView
+/** @deprecated 改用 `DesktopConnectorMetaView`；旧名只为兼容既有 import 保留（A11-B4）。 */
+export type DesktopWorkspaceConnectorMetaView = DesktopConnectorMetaView
+/** @deprecated 改用 `DesktopConnectorDetailViewProps`；旧名只为兼容既有 import 保留（A11-B4）。 */
+export type DesktopWorkspaceConnectorDetailViewProps = DesktopConnectorDetailViewProps
+/**
+ * @deprecated 改用 `DesktopConnectorDetailView`。件本身没变，只是从
+ * `DesktopWorkspaceView` 搬了家（A11-B4）；旧名是同一枚函数的别名，可以直接改导入名。
+ */
+export const DesktopWorkspaceConnectorDetailView = DesktopConnectorDetailView

package/src/components/domain/desktop/DesktopHomeView/DesktopHomeView.stories.tsx

@@ -0,0 +1,103 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { useState } from "react"
+import { HomeBackdrop } from "../../../composite/HomeBackdrop"
+import { Composer } from "../../chat/Composer"
+import { StarterCapsules } from "../StarterCapsules"
+import { DesktopHomeView } from "./index"
+
+const noop = () => {}
+
+/**
+ * 主屏主视觉面（原型模板 835–861 · 裁决 18）。
+ *
+ * 层级：背景线纹 ＜ 居中列（34 品牌标 ＋ 32 展示字标题 / 起手胶囊 / [已挂载条] / composer 井）。
+ * 容器 `margin auto` 纵横居中、`max-width 800` ＋ `px 24` → 内容实宽 752（与会话列同宽）、`gap 20`。
+ * 主屏**不再借空态原语**——`DesktopChatEmptyStateView` 仍守它的容器空态语义（§6）。
+ */
+const meta = {
+  title: "Desktop/DesktopHomeView",
+  component: DesktopHomeView,
+  parameters: { layout: "fullscreen" },
+  decorators: [
+    (Story) => (
+      /* 复刻宿主：内容面 = --ow-surface + position relative + overflow hidden（线纹靠它裁切）。 */
+      <div
+        style={{
+          position: "relative",
+          overflow: "hidden",
+          display: "flex",
+          flexDirection: "column",
+          height: "100vh",
+          width: "100%",
+          background: "var(--ow-surface)",
+        }}
+      >
+        <Story />
+      </div>
+    ),
+  ],
+} satisfies Meta<typeof DesktopHomeView>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+/** 冷启动：线纹 ＋ 主视觉 ＋ 五枚起手胶囊 ＋ 空 composer（发送钮停在 disabled）。 */
+export const Default: Story = {
+  render: () => (
+    <DesktopHomeView backdrop={<HomeBackdrop />} capsules={<StarterCapsules />}>
+      <Composer placeholder="今天帮你做些什么？ / 调用技能与指令 @ 引用专家和连接器" onSend={noop} />
+    </DesktopHomeView>
+  ),
+}
+
+/** 起手胶囊接线（裁决 18）：点一下把这枚的文字塞进输入框，同时按下态回写。 */
+export const CapsuleFillsComposer: Story = {
+  render: () => {
+    const [draft, setDraft] = useState("")
+    const [picked, setPicked] = useState<string | null>(null)
+    return (
+      <DesktopHomeView
+        backdrop={<HomeBackdrop />}
+        capsules={
+          <StarterCapsules
+            value={picked}
+            onSelect={(option) => {
+              setPicked(option.id)
+              setDraft(option.label)
+            }}
+          />
+        }
+      >
+        <Composer
+          value={draft}
+          onChange={setDraft}
+          placeholder="今天帮你做些什么？ / 调用技能与指令 @ 引用专家和连接器"
+          onSend={() => setDraft("")}
+        />
+      </DesktopHomeView>
+    )
+  },
+}
+
+/** 带已挂载条：32 高的一条，眉标「已挂载」＋ 读数 ＋ 卸载全部。 */
+export const WithMounts: Story = {
+  render: () => (
+    <DesktopHomeView
+      backdrop={<HomeBackdrop />}
+      capsules={<StarterCapsules value="doc-writing" />}
+      mounts="orbit-fe · 渠道复盘_终稿.docx"
+      onDismissMounts={noop}
+    >
+      <Composer placeholder="今天帮你做些什么？ / 调用技能与指令 @ 引用专家和连接器" onSend={noop} />
+    </DesktopHomeView>
+  ),
+}
+
+/** 无线纹档：同一件搬到别的容器时（线纹只属主屏，不是全局水印）。 */
+export const WithoutBackdrop: Story = {
+  render: () => (
+    <DesktopHomeView capsules={<StarterCapsules />}>
+      <Composer placeholder="今天帮你做些什么？ / 调用技能与指令 @ 引用专家和连接器" onSend={noop} />
+    </DesktopHomeView>
+  ),
+}

package/src/components/domain/desktop/DesktopHomeView/DesktopHomeViewSource.test.mjs

@@ -0,0 +1,51 @@
+import assert from "node:assert/strict"
+import { readFile } from "node:fs/promises"
+import test from "node:test"
+
+const source = await readFile(new URL("./index.tsx", import.meta.url), "utf8")
+const emptyState = await readFile(new URL("../DesktopChatEmptyStateView/index.tsx", import.meta.url), "utf8")
+
+test("主视觉行：34 品牌标（§12 锁定件 auto 档）＋ 32 展示字标题，gap 14", () => {
+  assert.match(source, /<OrbitworkMark variant="auto" size=\{34\} \/>/)
+  assert.match(source, /gap-\[14px\]/)
+  assert.match(source, /ow-font-display text-ow-fs-headline font-medium/)
+  assert.match(source, /leading-\[var\(--ow-lh-headline\)\] tracking-\[0\.01em\] text-\[color:var\(--ow-text\)\]/)
+  assert.match(source, /title = "今天从哪件事开始\?"/)
+})
+
+test("容器几何：margin auto 纵横居中 / max-width 800 ＋ px-24（内容 752，与会话列同宽）/ gap 20", () => {
+  assert.match(source, /m-auto w-full max-w-\[800px\] px-6/)
+  assert.match(source, /flex flex-col items-center gap-5/)
+  assert.match(source, /relative box-border/)
+})
+
+test("本件贴地：不画底色、不画边框、不画影（材质只在 children 那口 composer 井上）", () => {
+  const container = source.slice(
+    source.indexOf('data-slot="desktop-home"'),
+    source.indexOf('data-slot="desktop-home-hero"'),
+  )
+  assert.doesNotMatch(container, /bg-\[|bg-ow-|border-\[|border border/)
+  assert.doesNotMatch(source, /shadow/)
+})
+
+test("已挂载条（原型 853–861）：32 高 / 0 4px 0 10px / 1px 边 / radius-sm / 眉标档文字", () => {
+  assert.match(source, /h-8 pl-\[10px\] pr-1 bg-transparent/)
+  assert.match(
+    source,
+    /text-\[length:var\(--ow-fs-eyebrow-cjk,12px\)\] tracking-\[var\(--ow-ls-eyebrow-cjk,0\.08em\)\]/,
+  )
+  assert.match(source, /已挂载/)
+  assert.match(source, /aria-label="卸载全部"/)
+})
+
+test("背景线纹只由主屏传入（槽），本件不写死，也不做成全局水印", () => {
+  assert.match(source, /backdrop\?: ReactNode/)
+  assert.match(source, /\{backdrop\}/)
+  assert.doesNotMatch(source, /from "[^"]*HomeBackdrop"/)
+})
+
+test("主屏与容器空态分家：本件不借空态原语，DesktopChatEmptyStateView 仍守 §6 语义", () => {
+  assert.doesNotMatch(source, /from "[^"]*primitives\/EmptyState"/)
+  assert.doesNotMatch(source, /<EmptyState|className="chat-empty/)
+  assert.match(emptyState, /from "\.\.\/\.\.\/\.\.\/primitives\/EmptyState"/)
+})

package/src/components/domain/desktop/DesktopHomeView/index.tsx

@@ -0,0 +1,122 @@
+import type { ReactNode } from "react"
+import { cn } from "../../../../lib/utils"
+import { Close } from "../../../composite/Icons"
+import { OrbitworkMark } from "../../../composite/OrbitworkLogo"
+
+/**
+ * DesktopHomeView — 主屏主视觉面（原型模板 835–861 · 裁决 18）
+ *
+ * 主屏不再借用容器空态：**空态是「这里本该有东西却没有」，主屏是「今天从哪件事开始」**，
+ * 两个概念分开——`DesktopChatEmptyStateView` 保留给真正的容器空态（§6 信标母题 ＋ 一句
+ * text-2），主屏改走本件。这样裁决 6 调空态体量时，不会顺手把主屏的品牌视觉一起放大。
+ *
+ * 层级（自上而下）：背景构造线纹（`composite/HomeBackdrop`，绝对定位挂在内容面上，只主屏出）
+ * ＜ 居中列 ＝ 主视觉行（34 品牌标 ＋ 32 展示字标题）/ 起手胶囊行 / [已挂载条] / composer 井。
+ *
+ * 几何（§7）：`margin: auto` 纵横居中；`max-width 800` ＋ `padding 0 24` → 内容实宽 **752**，
+ * 与会话列同宽（原型那边是 752/704 一档，我们整仓统一到 752，主屏与会话之间列宽不跳）。
+ * 竖向节律 `gap 20` 一档到底。
+ *
+ * 立面：本件自身不画底色、不画边、不画影——它坐在内容面（`--ow-surface`）上，
+ * 唯一有材质的是 children 里那口 composer 井（`--ow-surface-2`）。
+ *
+ * 三极（§4）：主视觉行的品牌标是**标志本体**（§12 锁定件，`variant="auto"` 随主题切
+ * 官方两档配色），不是状态极；本件不引信标动效、不亮荧黄，整面唯一的行动极是
+ * composer 的发送钮。
+ */
+
+export interface DesktopHomeViewProps {
+  /** 主视觉句（裁决 18 定的品牌口吻）。 */
+  title?: string
+  /** 背景线纹槽：传 `<HomeBackdrop />`。**只有主屏传**，别的屏留空——它不是全局水印。 */
+  backdrop?: ReactNode
+  /** 起手胶囊槽：传 `<StarterCapsules />`。 */
+  capsules?: ReactNode
+  /** 已挂载条的读数（如「orbit-fe · 3 个文件」）；不传即整条不出。 */
+  mounts?: ReactNode
+  /** 卸载全部；不传即不出那枚 ✕。 */
+  onDismissMounts?: () => void
+  /** composer 槽。 */
+  children?: ReactNode
+  className?: string
+}
+
+export function DesktopHomeView({
+  title = "今天从哪件事开始?",
+  backdrop,
+  capsules,
+  mounts,
+  onDismissMounts,
+  children,
+  className,
+}: DesktopHomeViewProps) {
+  return (
+    <>
+      {backdrop}
+      <div
+        data-slot="desktop-home"
+        className={cn(
+          "relative box-border m-auto w-full max-w-[800px] px-6",
+          "flex flex-col items-center gap-5",
+          className,
+        )}
+      >
+        <div data-slot="desktop-home-hero" className="flex items-center gap-[14px]">
+          {/* §12 锁定件：几何/配色不改，auto 档随 data-theme 在官方 light/dark 两档之间切；
+              标志在这里是品牌本体（role=img + 默认 label），不是装饰件 */}
+          <OrbitworkMark variant="auto" size={34} />
+          <h1
+            data-slot="desktop-home-title"
+            className={cn(
+              "m-0 ow-font-display text-ow-fs-headline font-medium",
+              "leading-[var(--ow-lh-headline)] tracking-[0.01em] text-[color:var(--ow-text)]",
+            )}
+          >
+            {title}
+          </h1>
+        </div>
+
+        {capsules}
+
+        {mounts != null && (
+          <div
+            data-slot="desktop-home-mounts"
+            className={cn(
+              "flex items-center gap-2 h-8 pl-[10px] pr-1 bg-transparent",
+              "border border-[color:var(--ow-border)] [border-radius:var(--ow-radius-sm)]",
+            )}
+          >
+            <span
+              className={cn(
+                "flex-none font-medium text-[color:var(--ow-eyebrow)]",
+                "text-[length:var(--ow-fs-eyebrow-cjk,12px)] tracking-[var(--ow-ls-eyebrow-cjk,0.08em)]",
+              )}
+            >
+              已挂载
+            </span>
+            <span className="text-ow-fs-ui text-[color:var(--ow-text-2)] whitespace-nowrap">{mounts}</span>
+            {onDismissMounts && (
+              <button
+                type="button"
+                title="卸载全部"
+                aria-label="卸载全部"
+                onClick={onDismissMounts}
+                className={cn(
+                  "flex-none grid place-items-center w-6 h-6 border-0 cursor-pointer",
+                  "[border-radius:var(--ow-radius-2xs)] bg-transparent text-[color:var(--ow-text-3)]",
+                  "transition-colors duration-[var(--ow-dur-1)] ease-[var(--ow-ease-beacon)]",
+                  "hover:bg-[var(--ow-hover)] hover:text-[color:var(--ow-text)]",
+                  "ow-focus-ring",
+                )}
+              >
+                <Close width={14} height={14} aria-hidden="true" />
+              </button>
+            )}
+          </div>
+        )}
+
+        {children}
+      </div>
+    </>
+  )
+}

package/src/components/domain/desktop/DesktopLibraryAuthorizationDialog/DesktopLibraryAuthorizationDialog.stories.tsx

@@ -0,0 +1,55 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { DesktopLibraryAuthorizationDialog } from "./index"
+import type { DesktopLibraryAuthorizationScope } from "./index"
+
+/**
+ * 合并记（origin/main 9.2 批次，2026-09-03）：研发新增件进库时没带 story，check:stories
+ * 会拦 pre-commit。四态：默认（带权限清单）/ 检查登录中 / 授权提交中 / 出错。
+ * authorizationUrl 走的是 Electron <webview>，story 里不给。
+ */
+const meta = {
+  title: "Desktop/DesktopLibraryAuthorizationDialog",
+  component: DesktopLibraryAuthorizationDialog,
+  parameters: {
+    layout: "fullscreen",
+  },
+} satisfies Meta<typeof DesktopLibraryAuthorizationDialog>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+const scopes: DesktopLibraryAuthorizationScope[] = [
+  {
+    title: "读取资料库内容",
+    description: "浏览与检索你在资料库中的文件",
+    owner: "Orbitwork 资料库",
+    required: true,
+  },
+  {
+    title: "以你的身份发起会话",
+    description: "从资料库页面直接打开对话",
+    owner: "Orbitwork 资料库",
+  },
+]
+
+const handlers = {
+  onApprove: () => console.log("approve"),
+  onDeny: () => console.log("deny"),
+  onClose: () => console.log("close"),
+}
+
+export const Default: Story = {
+  args: { open: true, scopes, ...handlers },
+}
+
+export const Loading: Story = {
+  args: { open: true, loading: true, ...handlers },
+}
+
+export const Submitting: Story = {
+  args: { open: true, scopes, submitting: "approve", ...handlers },
+}
+
+export const WithError: Story = {
+  args: { open: true, scopes, error: "授权请求超时，请重试。", ...handlers },
+}