@orbit-work/ui 0.1.0

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

@@ -0,0 +1,159 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { DesktopPetSettings } from "./index"
+import type { DesktopPetSettingsPet } from "./index"
+
+const meta = {
+  title: "Desktop/DesktopPetSettings",
+  component: DesktopPetSettings,
+  decorators: [
+    (Story) => (
+      <div style={{ padding: 20, background: "var(--ow-bg)", maxWidth: 800 }}>
+        <Story />
+      </div>
+    ),
+  ],
+} satisfies Meta<typeof DesktopPetSettings>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+const mockPets: DesktopPetSettingsPet[] = [
+  {
+    id: "default",
+    displayName: "Orbitwork 默认",
+    description: "Orbitwork 官方经典形象",
+    builtIn: true,
+  },
+  {
+    id: "cat",
+    displayName: "猫咪",
+    description: "可爱的猫咪宠物",
+    builtIn: true,
+  },
+  {
+    id: "custom-1",
+    displayName: "自定义角色",
+    builtIn: false,
+  },
+]
+
+export const Default: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: false,
+    scale: 1.0,
+    animationRate: 1.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    importing: false,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const Disabled: Story = {
+  args: {
+    enabled: false,
+    alwaysOnTop: false,
+    scale: 1.0,
+    animationRate: 1.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const AlwaysOnTop: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: true,
+    scale: 1.0,
+    animationRate: 1.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const LargeScale: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: false,
+    scale: 1.5,
+    animationRate: 1.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const FastAnimation: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: false,
+    scale: 1.0,
+    animationRate: 2.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const CustomPetSelected: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: false,
+    scale: 1.0,
+    animationRate: 1.0,
+    selectedPetId: "custom-1",
+    pets: mockPets,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}
+
+export const Importing: Story = {
+  args: {
+    enabled: true,
+    alwaysOnTop: false,
+    scale: 1.0,
+    animationRate: 1.0,
+    selectedPetId: "default",
+    pets: mockPets,
+    importing: true,
+    onEnabledChange: (enabled) => console.log("Enabled:", enabled),
+    onAlwaysOnTopChange: (alwaysOnTop) => console.log("Always on top:", alwaysOnTop),
+    onScaleChange: (scale) => console.log("Scale:", scale),
+    onAnimationRateChange: (rate) => console.log("Animation rate:", rate),
+    onSelect: (id) => console.log("Selected:", id),
+    onImport: () => console.log("Import"),
+  },
+}

package/src/components/domain/desktop/DesktopPetSettings/DesktopPetSettingsSource.test.mjs

@@ -0,0 +1,76 @@
+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 styles = await readFile(new URL("../../../../../styles/desktop-pet-settings.css", import.meta.url), "utf8")
+// R2：产物样式清单不再手抄在 tsup.config.ts 里，改由 styles/orbitwork.css 的 @import 顺序
+// 读出（三份手抄清单收成一份）。断言随之改打真正的清单来源。
+const cssEntry = await readFile(new URL("../../../../../styles/orbitwork.css", import.meta.url), "utf8")
+
+test("desktop pet settings advertises Orbitwork and Petdex package support", () => {
+  assert.match(source, /支持 Orbitwork v2 与 Petdex v1\/v2 宠物/)
+  assert.match(source, /安装 Petdex 宠物后，选择其 pet\.json，并确保图集文件位于同一目录/)
+})
+
+test("desktop pet import action keeps its label intact at narrow widths", () => {
+  assert.match(source, /className="desktop-pet-settings__import-button"/)
+  assert.match(source, /props\.importing \? ["']导入中…["'] : ["']导入宠物["']/)
+  // R2：选择器从 V1 的 .ow-btn / .ow-btn__label 改到 Button 原语真实发出的
+  // data-slot="button" / data-ow-part="label"——旧写法全仓选不中任何元素，这两条一直空转。
+  assert.match(
+    styles,
+    /\.desktop-pet-settings__import-button\[data-slot="button"\]\s*\{[^}]*width:\s*max-content;[^}]*min-width:\s*max-content;[^}]*flex:\s*0 0 auto;[^}]*white-space:\s*nowrap;/s,
+  )
+  assert.match(
+    styles,
+    /\.desktop-pet-settings__import-button \[data-ow-part="label"\]\s*\{[^}]*display:\s*inline-block;[^}]*white-space:\s*nowrap;[^}]*word-break:\s*keep-all;[^}]*overflow-wrap:\s*normal;/s,
+  )
+  // 退役的是「规则」，不是注释里的追溯记载——按选择器＋花括号的规则形状断言
+  assert.doesNotMatch(styles, /\.ow-btn[\w-]*\s*\{/)
+  // 说明列的 min-width:0 / flex:1 由 Section 的 head 承担；窄屏堆叠改打 Section 的 head 部件
+  assert.match(styles, /\.desktop-pet-settings__import > \[data-ow-part="head"\]/)
+  assert.match(
+    styles,
+    /@media \(max-width:\s*480px\)\s*\{\s*\.desktop-pet-settings__import > \[data-ow-part="head"\]\s*\{[^}]*flex-direction:\s*column;/s,
+  )
+  assert.match(cssEntry, /@import\s+["']\.\/desktop-pet-settings\.css["']/)
+})
+
+test("desktop pet settings expose accessible size and animation rate controls", () => {
+  assert.match(source, /title="宠物大小"/)
+  assert.match(
+    source,
+    /aria-label=["']宠物大小["']\s+type=["']range["']\s+min=["']0\.5["']\s+max=["']1\.5["']\s+step=["']0\.1["']/,
+  )
+  assert.match(source, /Math\.round\(props\.scale \* 100\)/)
+  assert.match(source, /title="动画速率"/)
+  assert.match(
+    source,
+    /aria-label=["']动画速率["']\s+type=["']range["']\s+min=["']0\.5["']\s+max=["']2["']\s+step=["']0\.1["']/,
+  )
+  assert.match(source, /props\.animationRate\.toFixed\(1\)/)
+  assert.match(styles, /\.desktop-pet-settings__range input:focus-visible/)
+  // DS2 §15 无彩选中：滑杆填充取 --ow-control-on；--ow-primary 暗档是荧黄，禁作选中色
+  assert.match(styles, /accent-color: var\(--ow-control-on\)/)
+  assert.doesNotMatch(styles, /var\(--ow-primary/)
+  // §6 focus-visible 走 focus-ring token，2px 环 + 2px 缝
+  assert.match(styles, /outline: var\(--ow-focus-ring-w\) solid var\(--ow-focus-ring\)/)
+  // §7 读数 mono + tabular-nums
+  assert.match(source, /ow-font-mono tabular-nums/)
+  assert.match(styles, /\.desktop-pet-settings__range span\s*\{[^}]*font-family: var\(--ow-font-mono\)/s)
+})
+
+test("desktop pet content omits its duplicate section title", () => {
+  assert.doesNotMatch(source, /<div className="set-section">桌面宠物<\/div>/)
+  assert.match(source, /role="radiogroup" aria-label="选择宠物"/)
+})
+
+test("分节标题归口 Section，行归口 ListRow（蓝图批次②合并件）", () => {
+  assert.match(source, /import \{ Section \}/)
+  assert.match(source, /<Section title="选择宠物">/)
+  assert.match(source, /title="导入自定义宠物"/)
+  // 裸标题/裸说明选择器退役，不得再出现在源码与样式里
+  assert.doesNotMatch(source, /desktop-pet-settings__heading|desktop-pet-settings__hint/)
+  assert.doesNotMatch(styles, /\.desktop-pet-settings__heading\s*\{|\.desktop-pet-settings__hint\s*\{/)
+})

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

@@ -0,0 +1,140 @@
+"use client"
+
+import { BeaconIcon } from "../../../composite/BeaconIcons"
+import { ListRow } from "../../../composite/ListRow"
+import { Section } from "../../../composite/Section"
+import { Button } from "../../../primitives"
+import { DesktopSelectionCard } from "../DesktopSelectionCard"
+
+export type DesktopPetSettingsPet = {
+  id: string
+  displayName: string
+  description?: string
+  builtIn: boolean
+}
+
+export interface DesktopPetSettingsProps {
+  enabled: boolean
+  alwaysOnTop: boolean
+  scale: number
+  animationRate: number
+  selectedPetId: string
+  pets: DesktopPetSettingsPet[]
+  importing?: boolean
+  onEnabledChange: (enabled: boolean) => void
+  onAlwaysOnTopChange: (alwaysOnTop: boolean) => void
+  onScaleChange: (scale: number) => void
+  onAnimationRateChange: (animationRate: number) => void
+  onSelect: (id: string) => void
+  onImport: () => void
+}
+
+/** 设置面板行：贴边留白 + 14px 上下气口（`DesktopSettingRow` 改卡形前的旧口径） */
+const SETTING_ROW = "px-0 py-3.5 gap-4"
+
+/**
+ * @deprecated A2-B5（裁决 2 · 原型 3308–3319）：设置只剩十段——常规 / 用量与套餐 /
+ * 模型配置 / 授权模式 / 安全中心 / 数据管理 / 桌面助理 / 记忆 / 快捷键 / 关于，
+ * **没有「桌面宠物」这一段**（「外观」段同批撤销，内容并进「常规」）。
+ * 本件与 `DesktopPet` 一起先留着不删：apps/desktop 还挂着入口，等研发把入口撤干净
+ * 再连同 `.desktop-pet-settings*` CSS 一起清。新代码不要再挂这一段。
+ */
+export function DesktopPetSettings(props: DesktopPetSettingsProps): React.ReactElement {
+  return (
+    <div className="desktop-pet-settings">
+      <ListRow
+        title="显示桌面宠物"
+        description="在桌面上显示独立的 Orbitwork 宠物窗口"
+        control="switch"
+        checked={props.enabled}
+        onCheckedChange={props.onEnabledChange}
+        className={SETTING_ROW}
+      />
+      <ListRow
+        title="始终置顶"
+        description="切换到其他软件或全屏空间时，宠物仍显示在最上层"
+        control="switch"
+        checked={props.alwaysOnTop}
+        onCheckedChange={props.onAlwaysOnTopChange}
+        className={SETTING_ROW}
+      />
+      <ListRow
+        title="宠物大小"
+        description="调整宠物在桌面上的显示尺寸"
+        className={SETTING_ROW}
+        action={
+          <label className="desktop-pet-settings__range">
+            <input
+              aria-label="宠物大小"
+              type="range"
+              min="0.5"
+              max="1.5"
+              step="0.1"
+              value={props.scale}
+              onChange={(event) => props.onScaleChange(Number(event.target.value))}
+            />
+            {/* §7 读数 mono + tabular-nums */}
+            <span className="ow-font-mono tabular-nums">{Math.round(props.scale * 100)}%</span>
+          </label>
+        }
+      />
+      <ListRow
+        title="动画速率"
+        description="调整宠物动作的播放速度"
+        className={SETTING_ROW}
+        action={
+          <label className="desktop-pet-settings__range">
+            <input
+              aria-label="动画速率"
+              type="range"
+              min="0.5"
+              max="2"
+              step="0.1"
+              value={props.animationRate}
+              onChange={(event) => props.onAnimationRateChange(Number(event.target.value))}
+            />
+            <span className="ow-font-mono tabular-nums">{props.animationRate.toFixed(1)}×</span>
+          </label>
+        }
+      />
+      <Section title="选择宠物">
+        <div className="desktop-selection-grid" role="radiogroup" aria-label="选择宠物">
+          {props.pets.map((pet) => (
+            <DesktopSelectionCard
+              key={pet.id}
+              selected={pet.id === props.selectedPetId}
+              title={pet.displayName}
+              description={pet.description || (pet.builtIn ? "Orbitwork 内置宠物" : "自定义宠物")}
+              leading={
+                /* §7 图标族：宠物头像位走信标族构造几何（agent＝桌面上的代理化身），
+                   不用 ✦ 文字符号；dot="off" 不占任何一极。 */
+                <span className="desktop-pet-settings__avatar">
+                  <BeaconIcon name="agent" size={20} />
+                </span>
+              }
+              badge={pet.builtIn ? "内置" : undefined}
+              onSelect={() => props.onSelect(pet.id)}
+            />
+          ))}
+        </div>
+      </Section>
+      <Section
+        className="desktop-pet-settings__import"
+        title="导入自定义宠物"
+        description="支持 Orbitwork v2 与 Petdex v1/v2 宠物。安装 Petdex 宠物后，选择其 pet.json，并确保图集文件位于同一目录。"
+        divider={false}
+        actions={
+          <Button
+            className="desktop-pet-settings__import-button"
+            variant="secondary"
+            size="sm"
+            disabled={props.importing}
+            onClick={props.onImport}
+          >
+            {props.importing ? "导入中…" : "导入宠物"}
+          </Button>
+        }
+      />
+    </div>
+  )
+}

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

@@ -0,0 +1,166 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { DesktopRunStatusView } from "./index"
+
+const meta = {
+  title: "Desktop/DesktopRunStatusView",
+  component: DesktopRunStatusView,
+  tags: ["autodocs"],
+  parameters: {
+    layout: "centered",
+    docs: {
+      description: {
+        component:
+          "运行状态条。故事文案一律用**真实中文**：产品是纯中文界面，而 CSS 给了 max-width 220px + ellipsis 截断——中文比等长英文宽得多，英文 fixture 永远走不到截断那条路径。`RunningWithContext` 那条是刻意的超长中文，专验 220px 截断。",
+      },
+    },
+  },
+} satisfies Meta<typeof DesktopRunStatusView>
+
+export default meta
+type Story = StoryObj<typeof meta>
+
+export const Running: Story = {
+  args: {
+    label: "正在执行 npm test",
+    tone: "running",
+  },
+}
+
+export const Stopping: Story = {
+  args: {
+    label: "正在停止",
+    tone: "stopping",
+  },
+}
+
+export const Restored: Story = {
+  args: {
+    label: "会话已恢复",
+    tone: "restored",
+  },
+}
+
+export const RunningWithContext: Story = {
+  args: {
+    label: "正在执行命令：pnpm --filter @orbit-work/ui build --watch --force",
+    tone: "running",
+  },
+}
+
+export const StoppingWithContext: Story = {
+  args: {
+    label: "正在取消当前操作",
+    tone: "stopping",
+  },
+}
+
+export const RestoredWithContext: Story = {
+  args: {
+    label: "已从断点恢复会话",
+    tone: "restored",
+  },
+}
+
+export const CustomClassName: Story = {
+  args: {
+    label: "正在执行",
+    tone: "running",
+    className: "custom-status",
+  },
+}
+
+export const AllTones: Story = {
+  render: () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: 16, alignItems: "flex-start" }}>
+      <div style={{ display: "flex", alignItems: "center", gap: 8 }}>
+        <DesktopRunStatusView label="正在执行" tone="running" />
+        <span style={{ fontSize: 12, color: "var(--ow-text-3)" }}>执行中</span>
+      </div>
+      <div style={{ display: "flex", alignItems: "center", gap: 8 }}>
+        <DesktopRunStatusView label="正在停止" tone="stopping" />
+        <span style={{ fontSize: 12, color: "var(--ow-text-3)" }}>取消中</span>
+      </div>
+      <div style={{ display: "flex", alignItems: "center", gap: 8 }}>
+        <DesktopRunStatusView label="会话已恢复" tone="restored" />
+        <span style={{ fontSize: 12, color: "var(--ow-text-3)" }}>已恢复</span>
+      </div>
+    </div>
+  ),
+}
+
+export const InConversationHeader: Story = {
+  render: () => (
+    <div
+      style={{
+        background: "var(--ow-surface)",
+        border: "1px solid var(--ow-border)",
+        borderRadius: 8,
+        padding: "12px 16px",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between",
+        maxWidth: 600,
+      }}
+    >
+      <div style={{ display: "flex", alignItems: "center", gap: 12 }}>
+        <div style={{ fontSize: 14, fontWeight: 500, color: "var(--ow-text)" }}>会话标题</div>
+      </div>
+      <DesktopRunStatusView label="正在执行" tone="running" />
+    </div>
+  ),
+}
+
+export const DifferentLabels: Story = {
+  render: () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: 12, alignItems: "flex-start" }}>
+      <DesktopRunStatusView label="处理中" tone="running" />
+      <DesktopRunStatusView label="正在分析代码" tone="running" />
+      <DesktopRunStatusView label="正在跑测试" tone="running" />
+      <DesktopRunStatusView label="正在构建项目" tone="running" />
+      <DesktopRunStatusView label="正在生成文档" tone="running" />
+      <DesktopRunStatusView label="已取消" tone="stopping" />
+      <DesktopRunStatusView label="已重连" tone="restored" />
+    </div>
+  ),
+}
+
+export const InDarkContext: Story = {
+  render: () => (
+    <div
+      style={{
+        background: "var(--ow-bg)",
+        padding: 24,
+        borderRadius: 8,
+        display: "flex",
+        flexDirection: "column",
+        gap: 16,
+        alignItems: "flex-start",
+      }}
+    >
+      <DesktopRunStatusView label="正在执行任务" tone="running" />
+      <DesktopRunStatusView label="正在停止任务" tone="stopping" />
+      <DesktopRunStatusView label="会话已恢复" tone="restored" />
+    </div>
+  ),
+}
+
+export const InLightContext: Story = {
+  render: () => (
+    <div
+      style={{
+        background: "var(--ow-bg)",
+        padding: 24,
+        borderRadius: 8,
+        display: "flex",
+        flexDirection: "column",
+        gap: 16,
+        alignItems: "flex-start",
+        border: "1px solid var(--ow-border)",
+      }}
+    >
+      <DesktopRunStatusView label="正在执行任务" tone="running" />
+      <DesktopRunStatusView label="正在停止任务" tone="stopping" />
+      <DesktopRunStatusView label="会话已恢复" tone="restored" />
+    </div>
+  ),
+}

package/src/components/domain/desktop/DesktopRunStatusView/DesktopRunStatusViewSource.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 css = await readFile(new URL("../../../../../styles/desktop-surfaces.css", import.meta.url), "utf8")
+
+test("Desktop run status exposes accessible state and theme-aware styling", () => {
+  assert.match(source, /role="status"/)
+  assert.ok(source.includes("desktop-run-status--${tone}"))
+  assert.match(source, /desktop-run-status__label/)
+  const baseRule = css.match(/\.desktop-run-status \{[^}]*\}/s)?.[0] ?? ""
+  const restoredRule = css.match(/\.desktop-run-status--restored \{[^}]*\}/s)?.[0] ?? ""
+  // §4 状态极归属（R-F 同口径）：聊天屏荧黄状态极已归锁定件 Thinking，本件一律中性——
+  // 面 surface-2 / 边 border，整族禁 --ow-primary（暗档解析为荧黄，会冒出第二处状态极）。
+  assert.match(baseRule, /background: var\(--ow-surface-2\)/)
+  assert.match(baseRule, /solid var\(--ow-border\)/)
+  assert.doesNotMatch(baseRule, /--ow-primary/)
+  assert.doesNotMatch(baseRule, /--ow-beacon/)
+  // §7 形状/高度：胶囊 999 只因「带状态点的真 chip」保留；高 28 在 {28,32,40} 表内。
+  assert.match(baseRule, /height: 28px/)
+  assert.match(baseRule, /border-radius: var\(--ow-radius-pill\)/)
+  // §5 贴地零影：会话头是贴地面，chip 不许带任何 box-shadow。
+  assert.doesNotMatch(baseRule, /box-shadow/)
+  assert.match(css, /\.desktop-run-status__label \{[^}]*text-overflow: ellipsis;/s)
+  // 已恢复只换字色与点色，不再自带第二种面（面已与基态同为 surface-2）。
+  assert.match(restoredRule, /var\(--ow-text-2\)/)
+  assert.match(css, /\.desktop-run-status--restored \.desktop-run-status__dot \{[^}]*var\(--ow-success\)/)
+  // R1 形差：停驻＝空环（真边框，不用仿边框的 inset 影）。
+  const stoppingDotRule = css.match(/\.desktop-run-status--stopping \.desktop-run-status__dot \{[^}]*\}/s)?.[0] ?? ""
+  assert.match(stoppingDotRule, /background: transparent/)
+  // W6-R2：1.5px 是形状表外的自造线宽，归 --ow-border-width-thin(1px)。
+  assert.match(stoppingDotRule, /border: var\(--ow-border-width-thin, 1px\) solid var\(--ow-text-3\)/)
+  assert.doesNotMatch(stoppingDotRule, /1\.5px/)
+  assert.doesNotMatch(stoppingDotRule, /box-shadow/)
+  // §9 呼吸退役：run-pulse 是 scale(0.72) 缩放呼吸（撞「禁缩放」＋装饰动效），状态点改静止实点；
+  // R1 双编码由「点的形＋.desktop-run-status__label 运行文案」承担，无动画即无需 reduced-motion 兜底。
+  const dotRule = css.match(/\.desktop-run-status__dot \{[^}]*\}/)?.[0] ?? ""
+  assert.match(dotRule, /background: var\(--ow-progress-fill\);/)
+  assert.doesNotMatch(dotRule, /animation:/)
+  assert.doesNotMatch(css, /@keyframes run-pulse/)
+  assert.doesNotMatch(css, /animation:[^;]*run-pulse/)
+  assert.doesNotMatch(baseRule, /--ow-sky-/)
+})
+
+test("Desktop run status self-certifies its beacon-pole ownership in code (§4 / R-F)", () => {
+  // 判据要求「在代码注释自证」：组件与样式两处都要留下同口径的归属说明。
+  assert.match(source, /状态极|Thinking/)
+  assert.match(source, /--ow-progress-fill/)
+  assert.match(css, /状态极归属自证/)
+})

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

@@ -0,0 +1,34 @@
+export type DesktopRunStatusTone = "running" | "stopping" | "restored"
+
+export interface DesktopRunStatusViewProps {
+  label: string
+  tone?: DesktopRunStatusTone
+  className?: string
+}
+
+/**
+ * DesktopRunStatusView — Desktop 会话头的运行状态 chip（`.desktop-run-status` 族）。
+ *
+ * 形（COMPONENT-RULES §7）：胶囊 999 是形状表里 999 的合法位之一「带状态点的真 chip」——
+ * 行首恒挂状态点、行尾恒挂文案，两者缺一就不该用 999；高 28，在控件高表 {28,32,40} 内。
+ *
+ * 三极归属自证（§4，与 ACCEPTANCE-PENDING R-F 同口径）：本件与 chat/Thinking 同屏
+ * （会话头 vs 转录流）。聊天屏的**荧黄状态极已归锁定件 Thinking**（§12），按 §4「状态极
+ * 各限一处」，本件一律走中性——面 `--ow-surface-2`、边 `--ow-border`、运行点
+ * `--ow-progress-fill`（浅＝墨 / 暗＝月白，与 SidebarCurrent 行尾点同口径），**不碰
+ * `--ow-primary` 族**（其暗档解析为荧黄，会在 Thinking 之外冒出第二处状态极）。
+ *
+ * R1 双编码：形（`running` 实心点 / `stopping` 空环 / `restored` success 实心点）
+ * ＋ `label` 文案；颜色只作第二编码，单色/色觉障碍下仍可读。
+ * §9：点静止无动画（旧 run-pulse 的 scale 呼吸已退役），故无需 reduced-motion 兜底。
+ */
+export function DesktopRunStatusView({ label, tone = "running", className = "" }: DesktopRunStatusViewProps) {
+  const classes = `desktop-run-status desktop-run-status--${tone}${className ? ` ${className}` : ""}`
+
+  return (
+    <span className={classes} role="status" title={label}>
+      <span className="desktop-run-status__dot" aria-hidden="true" />
+      <span className="desktop-run-status__label">{label}</span>
+    </span>
+  )
+}