diff --git a/.agents/skills/migrate-radix-to-base/SKILL.md b/.agents/skills/migrate-radix-to-base/SKILL.md
index 5eb5dc5..cc173ce 100644
--- a/.agents/skills/migrate-radix-to-base/SKILL.md
+++ b/.agents/skills/migrate-radix-to-base/SKILL.md
@@ -42,7 +42,7 @@ transforming, and record gaps in the report.
      fetch base variants directly by URL instead
      (`https://ui.shadcn.com/r/styles/base-<style>/<component>.json`).
   3. PRISTINE wrappers, whole-project mode: `shadcn add <component>
-     --overwrite` delivers the base variant with the project's exact
+--overwrite` delivers the base variant with the project's exact
      icon/font/preset resolution. Never bulk `--all --overwrite`; go
      component by component, or you drown in unrelated registry version
      drift. PROGRESSIVE mode: never use `--overwrite` (it destroys the
@@ -59,9 +59,9 @@ transforming, and record gaps in the report.
      file. The registry sometimes reorders functions between variants, which
      makes three-way merges report zero conflicts while leaving stale radix
      hunks in place. A clean merge is NOT proof of a clean file.
-  This is more reliable than reconstructing transforms; use it whenever the
-  pair exists. Consumer/app code has no CLI mechanism: always hand-migrate it
-  against `consumer-props.md`.
+     This is more reliable than reconstructing transforms; use it whenever the
+     pair exists. Consumer/app code has no CLI mechanism: always hand-migrate it
+     against `consumer-props.md`.
 - **Legacy styles (new-york, new-york-v4, default): classification only, no
   replay.** These have no base counterpart (there is no base-new-york), and
   retargeting onto a base-<style> variant would restyle the user's app. Use
@@ -83,6 +83,7 @@ transforming, and record gaps in the report.
 ## Modes
 
 **Progressive (default).** "Migrate accordion" = one component, strangler-fig:
+
 1. Detect in-progress state first: an existing `<component>-base.tsx`,
    consumers split between old/new imports. The files ARE the state; resume,
    never restart.
@@ -126,6 +127,7 @@ Typecheck per file, build per batch, full build at the end vs the baseline.
 Reports live in a `.migration/` directory at the project root, ONE FILE PER
 COMPONENT: `.migration/<component>.md` (e.g. `.migration/accordion.md`).
 Rules:
+
 - Each run writes (or fully overwrites) the file for each component it
   migrated. Re-running a component replaces its report; never touch other
   components' files.
diff --git a/.agents/skills/migrate-radix-to-base/class-mapping.md b/.agents/skills/migrate-radix-to-base/class-mapping.md
index e6130b7..a236869 100644
--- a/.agents/skills/migrate-radix-to-base/class-mapping.md
+++ b/.agents/skills/migrate-radix-to-base/class-mapping.md
@@ -5,19 +5,19 @@ including app code. They are safe, mechanical rewrites.
 
 ## Data-attribute selectors
 
-| Radix pattern | Base UI pattern |
-|---|---|
-| `data-[state=open]:` | `data-open:` |
-| `data-[state=closed]:` | `data-closed:` |
-| `data-[state=checked]:` | `data-checked:` |
-| `data-[state=unchecked]:` | `data-unchecked:` |
-| `data-[state=active]:` (tabs) | `data-active:` |
-| `data-[state=on]:` (toggle) | `data-pressed:` |
-| `data-[highlighted]:` | `data-highlighted:` (unchanged) |
-| `data-[disabled]:` | `data-disabled:` (unchanged) |
-| `data-[side=...]:` | `data-[side=...]:` (unchanged, still parameterized) |
-| `group-data-[state=open]` / `peer-data-[state=open]` | `group-data-open` / `peer-data-open` |
-| submenu trigger open marker `data-[state=open]:` | `data-popup-open:` |
+| Radix pattern                                        | Base UI pattern                                     |
+| ---------------------------------------------------- | --------------------------------------------------- |
+| `data-[state=open]:`                                 | `data-open:`                                        |
+| `data-[state=closed]:`                               | `data-closed:`                                      |
+| `data-[state=checked]:`                              | `data-checked:`                                     |
+| `data-[state=unchecked]:`                            | `data-unchecked:`                                   |
+| `data-[state=active]:` (tabs)                        | `data-active:`                                      |
+| `data-[state=on]:` (toggle)                          | `data-pressed:`                                     |
+| `data-[highlighted]:`                                | `data-highlighted:` (unchanged)                     |
+| `data-[disabled]:`                                   | `data-disabled:` (unchanged)                        |
+| `data-[side=...]:`                                   | `data-[side=...]:` (unchanged, still parameterized) |
+| `group-data-[state=open]` / `peer-data-[state=open]` | `group-data-open` / `peer-data-open`                |
+| submenu trigger open marker `data-[state=open]:`     | `data-popup-open:`                                  |
 
 ## Animation idiom
 
@@ -34,15 +34,15 @@ uses per-side slide classes, keep the `data-[side=...]` or
 
 ## CSS variables
 
-| Radix var | Base UI var |
-|---|---|
-| `--radix-<comp>-content-transform-origin` | `--transform-origin` |
-| `--radix-<comp>-content-available-height` | `--available-height` |
-| `--radix-<comp>-content-available-width` | `--available-width` |
-| `--radix-<comp>-trigger-width` | `--anchor-width` |
-| `--radix-<comp>-trigger-height` | `--anchor-height` |
-| `--radix-accordion-content-height` | `--accordion-panel-height` |
-| `--radix-collapsible-content-height` | `--collapsible-panel-height` |
+| Radix var                                       | Base UI var                                  |
+| ----------------------------------------------- | -------------------------------------------- |
+| `--radix-<comp>-content-transform-origin`       | `--transform-origin`                         |
+| `--radix-<comp>-content-available-height`       | `--available-height`                         |
+| `--radix-<comp>-content-available-width`        | `--available-width`                          |
+| `--radix-<comp>-trigger-width`                  | `--anchor-width`                             |
+| `--radix-<comp>-trigger-height`                 | `--anchor-height`                            |
+| `--radix-accordion-content-height`              | `--accordion-panel-height`                   |
+| `--radix-collapsible-content-height`            | `--collapsible-panel-height`                 |
 | `--radix-navigation-menu-viewport-height/width` | `--positioner-height` / `--positioner-width` |
 
 ## Element changes kill pseudo-class variants
diff --git a/.agents/skills/migrate-radix-to-base/consumer-props.md b/.agents/skills/migrate-radix-to-base/consumer-props.md
index 92e1d90..d27b6bc 100644
--- a/.agents/skills/migrate-radix-to-base/consumer-props.md
+++ b/.agents/skills/migrate-radix-to-base/consumer-props.md
@@ -8,39 +8,39 @@ check node_modules/@base-ui/react/**/*.d.ts, never guess.
 
 ## Universal
 
-| Radix | Base UI | Call-site action |
-|---|---|---|
+| Radix                   | Base UI       | Call-site action                                                            |
+| ----------------------- | ------------- | --------------------------------------------------------------------------- |
 | `asChild` (any wrapper) | `render` prop | `<Trigger asChild><Button/></Trigger>` -> `<Trigger render={<Button/>}>...` |
 
 ## Per component
 
-| Component | Radix prop | Base UI fate | Call-site action |
-|---|---|---|---|
-| Accordion | `type="single"\|"multiple"` + `collapsible` | dropped; `value`/`defaultValue` are ALWAYS arrays; multiple-open via `multiple` | `type="single" collapsible` -> remove both; wrap values in arrays; `type="multiple"` -> `multiple` |
-| Tabs | `activationMode="manual"` | dropped; Base UI defaults to MANUAL activation | remove prop; near-equivalent opt-in is `Tabs.List activateOnFocus` (behavior delta: flag, do not auto-add) |
-| Select | `position="popper"\|"item-aligned"` | `alignItemWithTrigger` boolean (on Positioner; wrappers expose it) | `position="popper"` -> `alignItemWithTrigger={false}`; `item-aligned` -> `alignItemWithTrigger` (default) |
-| TooltipProvider | `delayDuration`, `skipDelayDuration` | `delay`; skip-delay concept dropped | rename / remove |
-| Tooltip | `disableHoverableContent` | NO equivalent | remove; FLAG the behavior change in the report |
-| Avatar.Image | `delayMs` | `delay` | rename |
-| ScrollArea | `type="always"\|"scroll"\|...` | dropped | remove |
-| Separator | `decorative` | dropped | remove |
-| Checkbox | `checked="indeterminate"` | `indeterminate` is a SEPARATE boolean prop | `checked="indeterminate"` -> `indeterminate` + boolean `checked` |
-| Slider | `onValueChange(value)` | signature gains event details; also `inverted` REMOVED | check handler arity; remove `inverted` (flag vertical-inverted usage) |
-| Select | `onValueChange(value: string)` | widens to `(value: Value \| null, eventDetails)` | `useState<string>` + `onValueChange={setState}` breaks: widen state to `string \| null` or wrap the setter |
-| Slider | `onValueCommit` | `onValueCommitted` | rename |
-| ToggleGroup | `type="single"\|"multiple"` | `multiple` boolean; value shape arrays | same treatment as Accordion |
-| ToggleGroup / Toolbar | `rovingFocus={false}` | dropped (roving focus always on); `loop` -> `loopFocus` | remove / rename |
-| Menubar | `value`/`onValueChange` (active menu) | dropped; control per Menu.Root `open` | restructure if used; usually unused |
-| Menubar | `loop` | `loopFocus` | rename |
-| ContextMenu.Root | `modal` | REMOVED | remove |
-| ContextMenu.Trigger | `disabled` | REMOVED | remove; gate the trigger yourself |
-| DropdownMenu/ContextMenu items | (Radix closed menu on select) | `closeOnClick` defaults FALSE on CheckboxItem/RadioItem | behavior delta: flag; add `closeOnClick` only if the user asks |
-| NavigationMenu | `delayDuration`(200), `skipDelayDuration`, `viewport` | `delay`(50) + `closeDelay`; viewport prop gone (Positioner handles it) | rename/remove; flag the 200->50 hover-delay feel change |
-| Popover / HoverCard | `openDelay`/`closeDelay` on Root | move to TRIGGER as `delay`/`closeDelay` | relocate props Root -> Trigger |
-| Dialog / AlertDialog | `onOpenAutoFocus` | `initialFocus` (element/ref-based, not event-based) | restructure: pass target instead of preventDefault handler |
-| Dialog / AlertDialog | `onCloseAutoFocus` | `finalFocus` | same restructure |
-| Dialog family | `onEscapeKeyDown`, `onPointerDownOutside`, `onInteractOutside` | consolidated; see the overlays reference for exact per-part signatures | consult overlays.md; do not guess |
-| DirectionProvider | `dir` | `direction` | rename |
+| Component                      | Radix prop                                                     | Base UI fate                                                                    | Call-site action                                                                                           |
+| ------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| Accordion                      | `type="single"\|"multiple"` + `collapsible`                    | dropped; `value`/`defaultValue` are ALWAYS arrays; multiple-open via `multiple` | `type="single" collapsible` -> remove both; wrap values in arrays; `type="multiple"` -> `multiple`         |
+| Tabs                           | `activationMode="manual"`                                      | dropped; Base UI defaults to MANUAL activation                                  | remove prop; near-equivalent opt-in is `Tabs.List activateOnFocus` (behavior delta: flag, do not auto-add) |
+| Select                         | `position="popper"\|"item-aligned"`                            | `alignItemWithTrigger` boolean (on Positioner; wrappers expose it)              | `position="popper"` -> `alignItemWithTrigger={false}`; `item-aligned` -> `alignItemWithTrigger` (default)  |
+| TooltipProvider                | `delayDuration`, `skipDelayDuration`                           | `delay`; skip-delay concept dropped                                             | rename / remove                                                                                            |
+| Tooltip                        | `disableHoverableContent`                                      | NO equivalent                                                                   | remove; FLAG the behavior change in the report                                                             |
+| Avatar.Image                   | `delayMs`                                                      | `delay`                                                                         | rename                                                                                                     |
+| ScrollArea                     | `type="always"\|"scroll"\|...`                                 | dropped                                                                         | remove                                                                                                     |
+| Separator                      | `decorative`                                                   | dropped                                                                         | remove                                                                                                     |
+| Checkbox                       | `checked="indeterminate"`                                      | `indeterminate` is a SEPARATE boolean prop                                      | `checked="indeterminate"` -> `indeterminate` + boolean `checked`                                           |
+| Slider                         | `onValueChange(value)`                                         | signature gains event details; also `inverted` REMOVED                          | check handler arity; remove `inverted` (flag vertical-inverted usage)                                      |
+| Select                         | `onValueChange(value: string)`                                 | widens to `(value: Value \| null, eventDetails)`                                | `useState<string>` + `onValueChange={setState}` breaks: widen state to `string \| null` or wrap the setter |
+| Slider                         | `onValueCommit`                                                | `onValueCommitted`                                                              | rename                                                                                                     |
+| ToggleGroup                    | `type="single"\|"multiple"`                                    | `multiple` boolean; value shape arrays                                          | same treatment as Accordion                                                                                |
+| ToggleGroup / Toolbar          | `rovingFocus={false}`                                          | dropped (roving focus always on); `loop` -> `loopFocus`                         | remove / rename                                                                                            |
+| Menubar                        | `value`/`onValueChange` (active menu)                          | dropped; control per Menu.Root `open`                                           | restructure if used; usually unused                                                                        |
+| Menubar                        | `loop`                                                         | `loopFocus`                                                                     | rename                                                                                                     |
+| ContextMenu.Root               | `modal`                                                        | REMOVED                                                                         | remove                                                                                                     |
+| ContextMenu.Trigger            | `disabled`                                                     | REMOVED                                                                         | remove; gate the trigger yourself                                                                          |
+| DropdownMenu/ContextMenu items | (Radix closed menu on select)                                  | `closeOnClick` defaults FALSE on CheckboxItem/RadioItem                         | behavior delta: flag; add `closeOnClick` only if the user asks                                             |
+| NavigationMenu                 | `delayDuration`(200), `skipDelayDuration`, `viewport`          | `delay`(50) + `closeDelay`; viewport prop gone (Positioner handles it)          | rename/remove; flag the 200->50 hover-delay feel change                                                    |
+| Popover / HoverCard            | `openDelay`/`closeDelay` on Root                               | move to TRIGGER as `delay`/`closeDelay`                                         | relocate props Root -> Trigger                                                                             |
+| Dialog / AlertDialog           | `onOpenAutoFocus`                                              | `initialFocus` (element/ref-based, not event-based)                             | restructure: pass target instead of preventDefault handler                                                 |
+| Dialog / AlertDialog           | `onCloseAutoFocus`                                             | `finalFocus`                                                                    | same restructure                                                                                           |
+| Dialog family                  | `onEscapeKeyDown`, `onPointerDownOutside`, `onInteractOutside` | consolidated; see the overlays reference for exact per-part signatures          | consult overlays.md; do not guess                                                                          |
+| DirectionProvider              | `dir`                                                          | `direction`                                                                     | rename                                                                                                     |
 
 ## Callback signature rule
 
diff --git a/.agents/skills/migrate-radix-to-base/disclosure.md b/.agents/skills/migrate-radix-to-base/disclosure.md
index 2d40cdc..fdac700 100644
--- a/.agents/skills/migrate-radix-to-base/disclosure.md
+++ b/.agents/skills/migrate-radix-to-base/disclosure.md
@@ -19,43 +19,43 @@ Part mapping: `Root → Root`, `Item → Item`, `Header → Header`, `Trigger 
 
 ## Accordion.Root → Accordion.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. Pass element to `render` instead of wrapping a child. |
-| `type` (required) | `"single" \| "multiple"` / — | `multiple` | Signature changed. `type="multiple"` → `multiple` (boolean, default `false`); `type="single"` → omit. |
-| `value` | `string` (single) or `string[]` (multiple) / — | `value` | Signature changed. Base UI is ALWAYS an array (`Value[]`, `Value = any`), even in single mode: `value="a"` → `value={["a"]}`. |
-| `defaultValue` | `string` or `string[]` / — | `defaultValue` | Same array caveat as `value`. |
-| `onValueChange` | `(value: string) => void` or `(value: string[]) => void` / — | `onValueChange` | Signature changed: `(value: Value[], eventDetails: Accordion.Root.ChangeEventDetails) => void`. Always receives an array; unwrap `value[0]` for single mode. |
-| `collapsible` | `boolean` / `false` | — dropped | Base UI single mode is always collapsible. To forbid closing the last open item (Radix `collapsible={false}` default), control `value` and ignore updates where the array is empty, or call `eventDetails.cancel()` when `value.length === 0`. |
-| `disabled` | `boolean` / `false` | `disabled` (default `false`) | Same. |
-| `dir` | `"ltr" \| "rtl"` / `"ltr"` | — dropped | Use DOM `dir` attribute / `DirectionProvider`. |
-| `orientation` | `"vertical" \| "horizontal"` / `"vertical"` | — dropped (prop exists but deprecated no-op) | Base UI removed roving arrow-key focus per the APG guidance update, so `orientation` (and `loopFocus`) no longer affect keyboard behavior. Do not carry it over. |
+| Radix prop        | Type / default                                               | Base UI equivalent                           | Migration note                                                                                                                                                                                                                                 |
+| ----------------- | ------------------------------------------------------------ | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean` / `false`                                          | `render`                                     | Signature changed. Pass element to `render` instead of wrapping a child.                                                                                                                                                                       |
+| `type` (required) | `"single" \| "multiple"` / —                                 | `multiple`                                   | Signature changed. `type="multiple"` → `multiple` (boolean, default `false`); `type="single"` → omit.                                                                                                                                          |
+| `value`           | `string` (single) or `string[]` (multiple) / —               | `value`                                      | Signature changed. Base UI is ALWAYS an array (`Value[]`, `Value = any`), even in single mode: `value="a"` → `value={["a"]}`.                                                                                                                  |
+| `defaultValue`    | `string` or `string[]` / —                                   | `defaultValue`                               | Same array caveat as `value`.                                                                                                                                                                                                                  |
+| `onValueChange`   | `(value: string) => void` or `(value: string[]) => void` / — | `onValueChange`                              | Signature changed: `(value: Value[], eventDetails: Accordion.Root.ChangeEventDetails) => void`. Always receives an array; unwrap `value[0]` for single mode.                                                                                   |
+| `collapsible`     | `boolean` / `false`                                          | — dropped                                    | Base UI single mode is always collapsible. To forbid closing the last open item (Radix `collapsible={false}` default), control `value` and ignore updates where the array is empty, or call `eventDetails.cancel()` when `value.length === 0`. |
+| `disabled`        | `boolean` / `false`                                          | `disabled` (default `false`)                 | Same.                                                                                                                                                                                                                                          |
+| `dir`             | `"ltr" \| "rtl"` / `"ltr"`                                   | — dropped                                    | Use DOM `dir` attribute / `DirectionProvider`.                                                                                                                                                                                                 |
+| `orientation`     | `"vertical" \| "horizontal"` / `"vertical"`                  | — dropped (prop exists but deprecated no-op) | Base UI removed roving arrow-key focus per the APG guidance update, so `orientation` (and `loopFocus`) no longer affect keyboard behavior. Do not carry it over.                                                                               |
 
 ## Accordion.Item → Accordion.Item
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `value` (required) | `string` / — | `value` | Renamed constraint: Base UI `value` is `any` and OPTIONAL (auto-generated from index when omitted). Keep passing strings for parity. |
-| `disabled` | `boolean` / `false` | `disabled` (default `false`) | Same. |
+| Radix prop         | Type / default      | Base UI equivalent           | Migration note                                                                                                                       |
+| ------------------ | ------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`          | `boolean` / `false` | `render`                     | Signature changed.                                                                                                                   |
+| `value` (required) | `string` / —        | `value`                      | Renamed constraint: Base UI `value` is `any` and OPTIONAL (auto-generated from index when omitted). Keep passing strings for parity. |
+| `disabled`         | `boolean` / `false` | `disabled` (default `false`) | Same.                                                                                                                                |
 
 ## Accordion.Header → Accordion.Header
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. Both render `<h3>` by default. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                    |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed. Both render `<h3>` by default. |
 
 ## Accordion.Trigger → Accordion.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
+| Radix prop | Type / default      | Base UI equivalent                          | Migration note     |
+| ---------- | ------------------- | ------------------------------------------- | ------------------ |
+| `asChild`  | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
 
 ## Accordion.Content → Accordion.Panel
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
+| Radix prop   | Type / default          | Base UI equivalent                       | Migration note                                                                                                              |
+| ------------ | ----------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`    | `boolean` / `false`     | `render`                                 | Signature changed.                                                                                                          |
 | `forceMount` | `true \| undefined` / — | `keepMounted` (boolean, default `false`) | Renamed. `forceMount` → `keepMounted` (closed panel stays in DOM, hidden). Also available on `Root` to apply to all panels. |
 
 ## Base UI only props worth knowing
@@ -68,21 +68,21 @@ Part mapping: `Root → Root`, `Item → Item`, `Header → Header`, `Trigger 
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
+| Radix                                                 | Base UI                                                                   | Note                                                                                                        |
+| ----------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
 | `Item/Header/Content [data-state="open" \| "closed"]` | `Item`, `Header`: `data-open` (presence); `Panel`: `data-open` (presence) | No `data-closed` on accordion parts (unlike collapsible); style closed state as the absence of `data-open`. |
-| `Trigger [data-state="open"]` | `Trigger [data-panel-open]` | Renamed. Trigger specifically uses `data-panel-open`, NOT `data-open`. |
-| `[data-disabled]` | `[data-disabled]` | Same (Root, Item, Header, Trigger, Panel). |
-| `[data-orientation]` (all parts) | `Root`, `Panel`: `data-orientation` | Deprecated along with orientation; avoid relying on it. |
-| — | `Item/Header/Panel [data-index]` | Base UI only: numeric item index. |
-| — | `Panel [data-starting-style]`, `[data-ending-style]` | Base UI only: CSS-transition animation hooks (replace Radix mount/unmount animation pattern). |
+| `Trigger [data-state="open"]`                         | `Trigger [data-panel-open]`                                               | Renamed. Trigger specifically uses `data-panel-open`, NOT `data-open`.                                      |
+| `[data-disabled]`                                     | `[data-disabled]`                                                         | Same (Root, Item, Header, Trigger, Panel).                                                                  |
+| `[data-orientation]` (all parts)                      | `Root`, `Panel`: `data-orientation`                                       | Deprecated along with orientation; avoid relying on it.                                                     |
+| —                                                     | `Item/Header/Panel [data-index]`                                          | Base UI only: numeric item index.                                                                           |
+| —                                                     | `Panel [data-starting-style]`, `[data-ending-style]`                      | Base UI only: CSS-transition animation hooks (replace Radix mount/unmount animation pattern).               |
 
 ## CSS var mapping
 
-| Radix | Base UI |
-|---|---|
+| Radix                              | Base UI                    |
+| ---------------------------------- | -------------------------- |
 | `--radix-accordion-content-height` | `--accordion-panel-height` |
-| `--radix-accordion-content-width` | `--accordion-panel-width` |
+| `--radix-accordion-content-width`  | `--accordion-panel-width`  |
 
 ---
 
@@ -92,26 +92,26 @@ Part mapping: `Root → Root`, `Trigger → Trigger`, `Content → Panel`.
 
 ## Collapsible.Root → Collapsible.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `defaultOpen` | `boolean` / — | `defaultOpen` (default `false`) | Same. |
-| `open` | `boolean` / — | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / — | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Collapsible.Root.ChangeEventDetails) => void`. |
-| `disabled` | `boolean` / — | `disabled` (default `false`) | Same. |
+| Radix prop     | Type / default                | Base UI equivalent              | Migration note                                                                                   |
+| -------------- | ----------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------ |
+| `asChild`      | `boolean` / `false`           | `render`                        | Signature changed.                                                                               |
+| `defaultOpen`  | `boolean` / —                 | `defaultOpen` (default `false`) | Same.                                                                                            |
+| `open`         | `boolean` / —                 | `open`                          | Same.                                                                                            |
+| `onOpenChange` | `(open: boolean) => void` / — | `onOpenChange`                  | Signature changed: `(open: boolean, eventDetails: Collapsible.Root.ChangeEventDetails) => void`. |
+| `disabled`     | `boolean` / —                 | `disabled` (default `false`)    | Same.                                                                                            |
 
 ## Collapsible.Trigger → Collapsible.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
+| Radix prop | Type / default      | Base UI equivalent                          | Migration note     |
+| ---------- | ------------------- | ------------------------------------------- | ------------------ |
+| `asChild`  | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
 
 ## Collapsible.Content → Collapsible.Panel
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `forceMount` | `true \| undefined` / — | `keepMounted` (boolean, default `false`) | Renamed. |
+| Radix prop   | Type / default          | Base UI equivalent                       | Migration note     |
+| ------------ | ----------------------- | ---------------------------------------- | ------------------ |
+| `asChild`    | `boolean` / `false`     | `render`                                 | Signature changed. |
+| `forceMount` | `true \| undefined` / — | `keepMounted` (boolean, default `false`) | Renamed.           |
 
 ## Base UI only props worth knowing
 
@@ -121,19 +121,19 @@ Part mapping: `Root → Root`, `Trigger → Trigger`, `Content → Panel`.
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
-| `Root/Content [data-state="open" \| "closed"]` | `Panel [data-open]` / `[data-closed]` | Renamed to presence attributes. Base UI Root renders a plain `<div>`; state attrs live on Panel/Trigger. |
-| `Trigger [data-state="open"]` | `Trigger [data-panel-open]` | Renamed; trigger-specific name. |
-| `[data-disabled]` | — (not emitted on collapsible parts) | Gate styles on the `disabled` prop / `:disabled` on the trigger instead. |
-| — | `Panel [data-starting-style]`, `[data-ending-style]` | Base UI only: animation hooks. |
+| Radix                                          | Base UI                                              | Note                                                                                                     |
+| ---------------------------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `Root/Content [data-state="open" \| "closed"]` | `Panel [data-open]` / `[data-closed]`                | Renamed to presence attributes. Base UI Root renders a plain `<div>`; state attrs live on Panel/Trigger. |
+| `Trigger [data-state="open"]`                  | `Trigger [data-panel-open]`                          | Renamed; trigger-specific name.                                                                          |
+| `[data-disabled]`                              | — (not emitted on collapsible parts)                 | Gate styles on the `disabled` prop / `:disabled` on the trigger instead.                                 |
+| —                                              | `Panel [data-starting-style]`, `[data-ending-style]` | Base UI only: animation hooks.                                                                           |
 
 ## CSS var mapping
 
-| Radix | Base UI |
-|---|---|
+| Radix                                | Base UI                      |
+| ------------------------------------ | ---------------------------- |
 | `--radix-collapsible-content-height` | `--collapsible-panel-height` |
-| `--radix-collapsible-content-width` | `--collapsible-panel-width` |
+| `--radix-collapsible-content-width`  | `--collapsible-panel-width`  |
 
 ---
 
@@ -143,38 +143,38 @@ Part mapping: `Root → Root`, `List → List`, `Trigger → Tab`, `Content →
 
 ## Tabs.Root → Tabs.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `defaultValue` | `string` / — | `defaultValue` | Signature changed: Base UI value type is `Tabs.Tab.Value` (`any`), default `0` (first tab active by default; Radix has no default active tab). Strings still work unchanged. |
-| `value` | `string` / — | `value` | Same shape for string values; type widened to `any`. |
-| `onValueChange` | `(value: string) => void` / — | `onValueChange` | Signature changed: `(value: Tabs.Tab.Value, eventDetails: Tabs.Root.ChangeEventDetails) => void`. |
-| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (default `'horizontal'`) | Same. |
-| `dir` | `"ltr" \| "rtl"` / — | — dropped | Use DOM `dir` / `DirectionProvider`. |
-| `activationMode` | `"automatic" \| "manual"` / `"automatic"` | moved + renamed: `List.activateOnFocus` (boolean, default `false`) | Moved from Root to List and inverted DEFAULT: Radix defaults to automatic, Base UI 1.6.0 defaults to `false` (manual). To preserve Radix default behavior set `<Tabs.List activateOnFocus>`; `activationMode="manual"` → omit. |
+| Radix prop       | Type / default                                | Base UI equivalent                                                 | Migration note                                                                                                                                                                                                                 |
+| ---------------- | --------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`        | `boolean` / `false`                           | `render`                                                           | Signature changed.                                                                                                                                                                                                             |
+| `defaultValue`   | `string` / —                                  | `defaultValue`                                                     | Signature changed: Base UI value type is `Tabs.Tab.Value` (`any`), default `0` (first tab active by default; Radix has no default active tab). Strings still work unchanged.                                                   |
+| `value`          | `string` / —                                  | `value`                                                            | Same shape for string values; type widened to `any`.                                                                                                                                                                           |
+| `onValueChange`  | `(value: string) => void` / —                 | `onValueChange`                                                    | Signature changed: `(value: Tabs.Tab.Value, eventDetails: Tabs.Root.ChangeEventDetails) => void`.                                                                                                                              |
+| `orientation`    | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (default `'horizontal'`)                             | Same.                                                                                                                                                                                                                          |
+| `dir`            | `"ltr" \| "rtl"` / —                          | — dropped                                                          | Use DOM `dir` / `DirectionProvider`.                                                                                                                                                                                           |
+| `activationMode` | `"automatic" \| "manual"` / `"automatic"`     | moved + renamed: `List.activateOnFocus` (boolean, default `false`) | Moved from Root to List and inverted DEFAULT: Radix defaults to automatic, Base UI 1.6.0 defaults to `false` (manual). To preserve Radix default behavior set `<Tabs.List activateOnFocus>`; `activationMode="manual"` → omit. |
 
 ## Tabs.List → Tabs.List
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `loop` | `boolean` / `true` | `loopFocus` (default `true`) | Renamed. |
+| Radix prop | Type / default      | Base UI equivalent           | Migration note     |
+| ---------- | ------------------- | ---------------------------- | ------------------ |
+| `asChild`  | `boolean` / `false` | `render`                     | Signature changed. |
+| `loop`     | `boolean` / `true`  | `loopFocus` (default `true`) | Renamed.           |
 
 ## Tabs.Trigger → Tabs.Tab
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
-| `value` (required) | `string` / — | `value` (required) | Type widened to `Tabs.Tab.Value` (`any`); strings unchanged. |
-| `disabled` | `boolean` / `false` | `disabled` | Same. |
+| Radix prop         | Type / default      | Base UI equivalent                          | Migration note                                               |
+| ------------------ | ------------------- | ------------------------------------------- | ------------------------------------------------------------ |
+| `asChild`          | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed.                                           |
+| `value` (required) | `string` / —        | `value` (required)                          | Type widened to `Tabs.Tab.Value` (`any`); strings unchanged. |
+| `disabled`         | `boolean` / `false` | `disabled`                                  | Same.                                                        |
 
 ## Tabs.Content → Tabs.Panel
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `value` (required) | `string` / — | `value` (required) | Type widened; strings unchanged. |
-| `forceMount` | `true \| undefined` / — | `keepMounted` (boolean, default `false`) | Renamed. Hidden panels stay in DOM with `data-hidden`. |
+| Radix prop         | Type / default          | Base UI equivalent                       | Migration note                                         |
+| ------------------ | ----------------------- | ---------------------------------------- | ------------------------------------------------------ |
+| `asChild`          | `boolean` / `false`     | `render`                                 | Signature changed.                                     |
+| `value` (required) | `string` / —            | `value` (required)                       | Type widened; strings unchanged.                       |
+| `forceMount`       | `true \| undefined` / — | `keepMounted` (boolean, default `false`) | Renamed. Hidden panels stay in DOM with `data-hidden`. |
 
 ## Base UI only props worth knowing
 
@@ -184,14 +184,14 @@ Part mapping: `Root → Root`, `List → List`, `Trigger → Tab`, `Content →
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
-| `Trigger [data-state="active" \| "inactive"]` | `Tab [data-active]` (presence) | Renamed. Inactive = absence of `data-active`. |
-| `Content [data-state="active" \| "inactive"]` | `Panel [data-hidden]` (presence when hidden) | Inverted polarity: Radix marks the active state, Base UI marks the hidden state. |
-| `[data-orientation]` (all parts) | `[data-orientation]` (Root, List, Tab, Panel, Indicator) | Same. |
-| `Trigger [data-disabled]` | `Tab [data-disabled]` | Same. |
-| — | `[data-activation-direction]` (`'left' \| 'right' \| 'up' \| 'down' \| 'none'`, all parts) | Base UI only: direction of the last tab change, useful for directional animations. |
-| — | `Panel [data-index]`, `[data-starting-style]`, `[data-ending-style]` | Base UI only. |
+| Radix                                         | Base UI                                                                                    | Note                                                                               |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |
+| `Trigger [data-state="active" \| "inactive"]` | `Tab [data-active]` (presence)                                                             | Renamed. Inactive = absence of `data-active`.                                      |
+| `Content [data-state="active" \| "inactive"]` | `Panel [data-hidden]` (presence when hidden)                                               | Inverted polarity: Radix marks the active state, Base UI marks the hidden state.   |
+| `[data-orientation]` (all parts)              | `[data-orientation]` (Root, List, Tab, Panel, Indicator)                                   | Same.                                                                              |
+| `Trigger [data-disabled]`                     | `Tab [data-disabled]`                                                                      | Same.                                                                              |
+| —                                             | `[data-activation-direction]` (`'left' \| 'right' \| 'up' \| 'down' \| 'none'`, all parts) | Base UI only: direction of the last tab change, useful for directional animations. |
+| —                                             | `Panel [data-index]`, `[data-starting-style]`, `[data-ending-style]`                       | Base UI only.                                                                      |
 
 ## CSS var mapping
 
@@ -205,13 +205,13 @@ Part mapping: `Toggle.Root → Toggle` (single-part; Base UI export is directly
 
 ## Toggle.Root → Toggle
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
-| `defaultPressed` | `boolean` / — | `defaultPressed` (default `false`) | Same. |
-| `pressed` | `boolean` / — | `pressed` | Same. |
-| `onPressedChange` | `(pressed: boolean) => void` / — | `onPressedChange` | Signature changed: `(pressed: boolean, eventDetails: Toggle.ChangeEventDetails) => void`. |
-| `disabled` | `boolean` / — | `disabled` (default `false`) | Same. |
+| Radix prop        | Type / default                   | Base UI equivalent                          | Migration note                                                                            |
+| ----------------- | -------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean` / `false`              | `render` (+ `nativeButton`, default `true`) | Signature changed.                                                                        |
+| `defaultPressed`  | `boolean` / —                    | `defaultPressed` (default `false`)          | Same.                                                                                     |
+| `pressed`         | `boolean` / —                    | `pressed`                                   | Same.                                                                                     |
+| `onPressedChange` | `(pressed: boolean) => void` / — | `onPressedChange`                           | Signature changed: `(pressed: boolean, eventDetails: Toggle.ChangeEventDetails) => void`. |
+| `disabled`        | `boolean` / —                    | `disabled` (default `false`)                | Same.                                                                                     |
 
 ## Base UI only props worth knowing
 
@@ -220,10 +220,10 @@ Part mapping: `Toggle.Root → Toggle` (single-part; Base UI export is directly
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
+| Radix                        | Base UI                     | Note                                      |
+| ---------------------------- | --------------------------- | ----------------------------------------- |
 | `[data-state="on" \| "off"]` | `[data-pressed]` (presence) | Renamed. Off = absence of `data-pressed`. |
-| `[data-disabled]` | `[data-disabled]` | Same. |
+| `[data-disabled]`            | `[data-disabled]`           | Same.                                     |
 
 ## CSS var mapping
 
@@ -237,26 +237,26 @@ Part mapping: `ToggleGroup.Root → ToggleGroup` (callable single export), `Togg
 
 ## ToggleGroup.Root → ToggleGroup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `type` (required) | `"single" \| "multiple"` / — | `multiple` (boolean, default `false`) | Signature changed, same pattern as accordion. |
-| `value` | `string` (single) or `string[]` (multiple) / — | `value` | Signature changed: always `readonly Value[]` (array), even single mode. `value="bold"` → `value={["bold"]}`. |
-| `defaultValue` | `string` or `string[]` / — | `defaultValue` | Same array caveat. |
-| `onValueChange` | `(value: string) => void` or `(value: string[]) => void` / — | `onValueChange` | Signature changed: `(groupValue: Value[], eventDetails: ToggleGroup.ChangeEventDetails) => void`. Always an array; single mode with nothing pressed = `[]` (Radix single mode signals this as `""`). |
-| `disabled` | `boolean` / `false` | `disabled` (default `false`) | Same. |
-| `rovingFocus` | `boolean` / `true` | — dropped | Roving focus is always on in Base UI; no opt-out. If you relied on `rovingFocus={false}` (every item tabbable), there is no direct workaround. |
-| `orientation` | `"horizontal" \| "vertical"` / `undefined` | `orientation` (default `'horizontal'`) | Same name; Base UI has an explicit default. |
-| `dir` | `"ltr" \| "rtl"` / — | — dropped | Use DOM `dir` / `DirectionProvider`. |
-| `loop` | `boolean` / `true` | `loopFocus` (default `true`) | Renamed. |
+| Radix prop        | Type / default                                               | Base UI equivalent                     | Migration note                                                                                                                                                                                       |
+| ----------------- | ------------------------------------------------------------ | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean` / `false`                                          | `render`                               | Signature changed.                                                                                                                                                                                   |
+| `type` (required) | `"single" \| "multiple"` / —                                 | `multiple` (boolean, default `false`)  | Signature changed, same pattern as accordion.                                                                                                                                                        |
+| `value`           | `string` (single) or `string[]` (multiple) / —               | `value`                                | Signature changed: always `readonly Value[]` (array), even single mode. `value="bold"` → `value={["bold"]}`.                                                                                         |
+| `defaultValue`    | `string` or `string[]` / —                                   | `defaultValue`                         | Same array caveat.                                                                                                                                                                                   |
+| `onValueChange`   | `(value: string) => void` or `(value: string[]) => void` / — | `onValueChange`                        | Signature changed: `(groupValue: Value[], eventDetails: ToggleGroup.ChangeEventDetails) => void`. Always an array; single mode with nothing pressed = `[]` (Radix single mode signals this as `""`). |
+| `disabled`        | `boolean` / `false`                                          | `disabled` (default `false`)           | Same.                                                                                                                                                                                                |
+| `rovingFocus`     | `boolean` / `true`                                           | — dropped                              | Roving focus is always on in Base UI; no opt-out. If you relied on `rovingFocus={false}` (every item tabbable), there is no direct workaround.                                                       |
+| `orientation`     | `"horizontal" \| "vertical"` / `undefined`                   | `orientation` (default `'horizontal'`) | Same name; Base UI has an explicit default.                                                                                                                                                          |
+| `dir`             | `"ltr" \| "rtl"` / —                                         | — dropped                              | Use DOM `dir` / `DirectionProvider`.                                                                                                                                                                 |
+| `loop`            | `boolean` / `true`                                           | `loopFocus` (default `true`)           | Renamed.                                                                                                                                                                                             |
 
 ## ToggleGroup.Item → Toggle
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
-| `value` (required) | `string` / — | `value` | Same meaning; on Base UI's `Toggle` it is optional in the type but required in practice for group membership. |
-| `disabled` | `boolean` / — | `disabled` (default `false`) | Same. |
+| Radix prop         | Type / default      | Base UI equivalent                          | Migration note                                                                                                |
+| ------------------ | ------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `asChild`          | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed.                                                                                            |
+| `value` (required) | `string` / —        | `value`                                     | Same meaning; on Base UI's `Toggle` it is optional in the type but required in practice for group membership. |
+| `disabled`         | `boolean` / —       | `disabled` (default `false`)                | Same.                                                                                                         |
 
 Note: the item also gains the full standalone `Toggle` API (`pressed`, `defaultPressed`, `onPressedChange` with `eventDetails`) since it IS the Toggle primitive; inside a group the group value normally drives pressed state.
 
@@ -268,12 +268,12 @@ Note: the item also gains the full standalone `Toggle` API (`pressed`, `defaultP
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
-| `Item [data-state="on" \| "off"]` | `Toggle [data-pressed]` (presence) | Renamed. |
-| `Item [data-disabled]` | `Toggle [data-disabled]` | Same. |
-| `Root/Item [data-orientation]` | `ToggleGroup [data-orientation]` | On the group only; items (Toggles) do not emit it. |
-| — | `ToggleGroup [data-disabled]`, `[data-multiple]` | Base UI only. |
+| Radix                             | Base UI                                          | Note                                               |
+| --------------------------------- | ------------------------------------------------ | -------------------------------------------------- |
+| `Item [data-state="on" \| "off"]` | `Toggle [data-pressed]` (presence)               | Renamed.                                           |
+| `Item [data-disabled]`            | `Toggle [data-disabled]`                         | Same.                                              |
+| `Root/Item [data-orientation]`    | `ToggleGroup [data-orientation]`                 | On the group only; items (Toggles) do not emit it. |
+| —                                 | `ToggleGroup [data-disabled]`, `[data-multiple]` | Base UI only.                                      |
 
 ## CSS var mapping
 
@@ -287,49 +287,49 @@ Part mapping: `Root → Root`, `Button → Button`, `Link → Link`, `Separator
 
 ## Toolbar.Root → Toolbar.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (default `'horizontal'`) | Same. |
-| `dir` | `"ltr" \| "rtl"` / — | — dropped | Use DOM `dir` / `DirectionProvider`. |
-| `loop` | `boolean` / `true` | `loopFocus` (default `true`) | Renamed. |
+| Radix prop    | Type / default                                | Base UI equivalent                     | Migration note                       |
+| ------------- | --------------------------------------------- | -------------------------------------- | ------------------------------------ |
+| `asChild`     | `boolean` / `false`                           | `render`                               | Signature changed.                   |
+| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (default `'horizontal'`) | Same.                                |
+| `dir`         | `"ltr" \| "rtl"` / —                          | — dropped                              | Use DOM `dir` / `DirectionProvider`. |
+| `loop`        | `boolean` / `true`                            | `loopFocus` (default `true`)           | Renamed.                             |
 
 ## Toolbar.Button → Toolbar.Button
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
+| Radix prop | Type / default      | Base UI equivalent                          | Migration note     |
+| ---------- | ------------------- | ------------------------------------------- | ------------------ |
+| `asChild`  | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | Signature changed. |
 
 ## Toolbar.Link → Toolbar.Link
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. Both render `<a>`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                        |
+| ---------- | ------------------- | ------------------ | ------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed. Both render `<a>`. |
 
 ## Toolbar.ToggleGroup → ToggleGroup (standalone, composed)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `type` (required) | `"single" \| "multiple"` / — | `multiple` (boolean, default `false`) | Moved: use the standalone `ToggleGroup` component inside `Toolbar.Root`; same mapping as toggle-group above. |
-| `value` / `defaultValue` | `string` or `string[]` / — | `value` / `defaultValue` on `ToggleGroup` | Always an array (see toggle-group). |
-| `onValueChange` | `(value: string \| string[]) => void` / — | `onValueChange` on `ToggleGroup` | `(groupValue: Value[], eventDetails) => void`. |
-| `disabled` | `boolean` / `false` | `disabled` on `ToggleGroup` | Same. |
+| Radix prop               | Type / default                            | Base UI equivalent                        | Migration note                                                                                               |
+| ------------------------ | ----------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `asChild`                | `boolean` / `false`                       | `render`                                  | Signature changed.                                                                                           |
+| `type` (required)        | `"single" \| "multiple"` / —              | `multiple` (boolean, default `false`)     | Moved: use the standalone `ToggleGroup` component inside `Toolbar.Root`; same mapping as toggle-group above. |
+| `value` / `defaultValue` | `string` or `string[]` / —                | `value` / `defaultValue` on `ToggleGroup` | Always an array (see toggle-group).                                                                          |
+| `onValueChange`          | `(value: string \| string[]) => void` / — | `onValueChange` on `ToggleGroup`          | `(groupValue: Value[], eventDetails) => void`.                                                               |
+| `disabled`               | `boolean` / `false`                       | `disabled` on `ToggleGroup`               | Same.                                                                                                        |
 
 ## Toolbar.ToggleItem → Toolbar.Button render={<Toggle />}
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | — | Moved: the composition IS the render prop: `<Toolbar.Button render={<Toggle />} value="bold" />`. Toolbar.Button supplies toolbar focus behavior, Toggle supplies pressed state. |
-| `value` (required) | `string` / — | `value` (on the composed element) | Same. |
-| `disabled` | `boolean` / — | `disabled` (on `Toolbar.Button`, default `false`) | Same; note `focusableWhenDisabled` defaults to `true` (disabled items stay focusable, Radix disabled items are not). |
+| Radix prop         | Type / default      | Base UI equivalent                                | Migration note                                                                                                                                                                   |
+| ------------------ | ------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`          | `boolean` / `false` | —                                                 | Moved: the composition IS the render prop: `<Toolbar.Button render={<Toggle />} value="bold" />`. Toolbar.Button supplies toolbar focus behavior, Toggle supplies pressed state. |
+| `value` (required) | `string` / —        | `value` (on the composed element)                 | Same.                                                                                                                                                                            |
+| `disabled`         | `boolean` / —       | `disabled` (on `Toolbar.Button`, default `false`) | Same; note `focusableWhenDisabled` defaults to `true` (disabled items stay focusable, Radix disabled items are not).                                                             |
 
 ## Toolbar.Separator → Toolbar.Separator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-|---|---|---|---|
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| — | — | `orientation` | Base UI only: defaults to the OPPOSITE of the toolbar's orientation (horizontal toolbar → vertical separator), which matches Radix's automatic behavior; usually omit. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                                                         |
+| ---------- | ------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed.                                                                                                                                                     |
+| —          | —                   | `orientation`      | Base UI only: defaults to the OPPOSITE of the toolbar's orientation (horizontal toolbar → vertical separator), which matches Radix's automatic behavior; usually omit. |
 
 ## Base UI only props worth knowing
 
@@ -341,12 +341,12 @@ Part mapping: `Root → Root`, `Button → Button`, `Link → Link`, `Separator
 
 ## Data-attribute mapping
 
-| Radix | Base UI | Note |
-|---|---|---|
+| Radix                                                                   | Base UI                                                            | Note                                                     |
+| ----------------------------------------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------- |
 | `[data-orientation]` (Root, Button, ToggleGroup, ToggleItem, Separator) | `[data-orientation]` (Root, Button, Link, Input, Group, Separator) | Same; Separator's value is perpendicular to the toolbar. |
-| `ToggleItem [data-state="on" \| "off"]` | `[data-pressed]` (presence, from the composed `Toggle`) | Renamed. |
-| `ToggleItem [data-disabled]` | `[data-disabled]` (Root, Button, Input, Group) | Same. |
-| — | `Button/Input [data-focusable]` | Base UI only: present when focusable-while-disabled. |
+| `ToggleItem [data-state="on" \| "off"]`                                 | `[data-pressed]` (presence, from the composed `Toggle`)            | Renamed.                                                 |
+| `ToggleItem [data-disabled]`                                            | `[data-disabled]` (Root, Button, Input, Group)                     | Same.                                                    |
+| —                                                                       | `Button/Input [data-focusable]`                                    | Base UI only: present when focusable-while-disabled.     |
 
 ## CSS var mapping
 
diff --git a/.agents/skills/migrate-radix-to-base/display-misc.md b/.agents/skills/migrate-radix-to-base/display-misc.md
index 9623e44..c8fdb43 100644
--- a/.agents/skills/migrate-radix-to-base/display-misc.md
+++ b/.agents/skills/migrate-radix-to-base/display-misc.md
@@ -16,18 +16,18 @@ Part mapping: `Progress.Root` → `Progress.Root`, `Progress.Indicator` → `Pro
 
 ## Progress.Root → Progress.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed (see header). |
-| `value` | `number \| null` / - | `value` | Same. Required in Base UI (default `null`). `null` = indeterminate in both. |
-| `max` | `number` / - | `max` | Same. Base UI default `100`; Base UI also adds `min` (default `0`). |
+| Radix prop      | Type / default                               | Base UI equivalent | Migration note                                                                                                                                                                   |
+| --------------- | -------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`       | `boolean` / `false`                          | `render`           | Signature changed (see header).                                                                                                                                                  |
+| `value`         | `number \| null` / -                         | `value`            | Same. Required in Base UI (default `null`). `null` = indeterminate in both.                                                                                                      |
+| `max`           | `number` / -                                 | `max`              | Same. Base UI default `100`; Base UI also adds `min` (default `0`).                                                                                                              |
 | `getValueLabel` | `(value: number, max: number) => string` / - | `getAriaValueText` | Renamed + signature changed: Base UI is `(formattedValue: string \| null, value: number \| null) => string`. Percent math is gone; use `format`/`locale` for formatting instead. |
 
 ## Progress.Indicator → Progress.Indicator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop. Nest inside `Progress.Track`; width is set by the primitive. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                          |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop. Nest inside `Progress.Track`; width is set by the primitive. |
 
 ### Base UI only props worth knowing
 
@@ -36,12 +36,12 @@ Part mapping: `Progress.Root` → `Progress.Root`, `Progress.Indicator` → `Pro
 
 ### Data attributes
 
-| Radix | Base UI |
-| --- | --- |
-| `[data-state="loading"]` | `[data-progressing]` (boolean-presence attrs replace the enum) |
-| `[data-state="complete"]` | `[data-complete]` |
-| `[data-state="indeterminate"]` | `[data-indeterminate]` |
-| `[data-value]`, `[data-max]` | Dropped. Read `value` in a `className`/`style` state function or set your own attribute. |
+| Radix                          | Base UI                                                                                  |
+| ------------------------------ | ---------------------------------------------------------------------------------------- |
+| `[data-state="loading"]`       | `[data-progressing]` (boolean-presence attrs replace the enum)                           |
+| `[data-state="complete"]`      | `[data-complete]`                                                                        |
+| `[data-state="indeterminate"]` | `[data-indeterminate]`                                                                   |
+| `[data-value]`, `[data-max]`   | Dropped. Read `value` in a `className`/`style` state function or set your own attribute. |
 
 All Base attrs are present on Root, Track, Indicator, Label, and Value alike. State type: `{ status: 'indeterminate' | 'progressing' | 'complete' }`.
 
@@ -57,39 +57,39 @@ Part mapping: `ScrollArea.Root` → `ScrollArea.Root`, `ScrollArea.Viewport` →
 
 ## ScrollArea.Root → ScrollArea.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `type` | `"auto" \| "always" \| "scroll" \| "hover"` / `"hover"` | Dropped | Visibility is CSS-driven: style Scrollbar `opacity` against `[data-hovering]`/`[data-scrolling]` (hover/scroll behavior), or always-visible CSS for `"always"` (+ `keepMounted` on Scrollbar). `"auto"` is the default mount behavior (scrollbar only mounts when scrollable). |
-| `scrollHideDelay` | `number` / `600` | Dropped | Reproduce with a CSS `transition-delay` on the scrollbar's opacity transition. |
-| `dir` | `"ltr" \| "rtl"` / - | Dropped | Base UI reads direction from the DOM (`dir` attribute) / its DirectionProvider utility; no per-component prop. |
-| `nonce` | `string` / - | Dropped | No documented CSP nonce equivalent. |
+| Radix prop        | Type / default                                          | Base UI equivalent | Migration note                                                                                                                                                                                                                                                                 |
+| ----------------- | ------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`         | `boolean` / `false`                                     | `render`           | Signature changed.                                                                                                                                                                                                                                                             |
+| `type`            | `"auto" \| "always" \| "scroll" \| "hover"` / `"hover"` | Dropped            | Visibility is CSS-driven: style Scrollbar `opacity` against `[data-hovering]`/`[data-scrolling]` (hover/scroll behavior), or always-visible CSS for `"always"` (+ `keepMounted` on Scrollbar). `"auto"` is the default mount behavior (scrollbar only mounts when scrollable). |
+| `scrollHideDelay` | `number` / `600`                                        | Dropped            | Reproduce with a CSS `transition-delay` on the scrollbar's opacity transition.                                                                                                                                                                                                 |
+| `dir`             | `"ltr" \| "rtl"` / -                                    | Dropped            | Base UI reads direction from the DOM (`dir` attribute) / its DirectionProvider utility; no per-component prop.                                                                                                                                                                 |
+| `nonce`           | `string` / -                                            | Dropped            | No documented CSP nonce equivalent.                                                                                                                                                                                                                                            |
 
 ## ScrollArea.Viewport → ScrollArea.Viewport
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same part role (the scrollable container). Wrap children in `ScrollArea.Content` when horizontal scrolling matters. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                      |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Same part role (the scrollable container). Wrap children in `ScrollArea.Content` when horizontal scrolling matters. |
 
 ## ScrollAreaScrollbar → ScrollArea.Scrollbar
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `forceMount` | `boolean` / - | `keepMounted` | Renamed; `boolean`, default `false`. Keeps the element in the DOM when the viewport is not scrollable. |
-| `orientation` | `"horizontal" \| "vertical"` / `"vertical"` | `orientation` | Same, same default. |
+| Radix prop    | Type / default                              | Base UI equivalent | Migration note                                                                                         |
+| ------------- | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------ |
+| `asChild`     | `boolean` / `false`                         | `render`           | Signature changed.                                                                                     |
+| `forceMount`  | `boolean` / -                               | `keepMounted`      | Renamed; `boolean`, default `false`. Keeps the element in the DOM when the viewport is not scrollable. |
+| `orientation` | `"horizontal" \| "vertical"` / `"vertical"` | `orientation`      | Same, same default.                                                                                    |
 
 ## ScrollAreaThumb → ScrollArea.Thumb
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop on both sides. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note           |
+| ---------- | ------------------- | ------------------ | ------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop on both sides. |
 
 ## ScrollArea.Corner → ScrollArea.Corner
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop on both sides. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note           |
+| ---------- | ------------------- | ------------------ | ------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop on both sides. |
 
 ### Base UI only props worth knowing
 
@@ -98,20 +98,20 @@ Part mapping: `ScrollArea.Root` → `ScrollArea.Root`, `ScrollArea.Viewport` →
 
 ### Data attributes
 
-| Radix | Base UI |
-| --- | --- |
-| Scrollbar `[data-state="visible" \| "hidden"]` | Dropped. Use `[data-hovering]`, `[data-scrolling]`, and `[data-has-overflow-x/y]` on Scrollbar to drive visibility styles. |
-| Scrollbar/Thumb `[data-orientation]` | Same (`data-orientation` on Scrollbar and Thumb). |
-| - | New, on Root/Content/Viewport/Scrollbar: `data-has-overflow-x`, `data-has-overflow-y`, `data-overflow-x-start/end`, `data-overflow-y-start/end`, `data-scrolling`; Scrollbar also `data-hovering`. |
+| Radix                                          | Base UI                                                                                                                                                                                            |
+| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Scrollbar `[data-state="visible" \| "hidden"]` | Dropped. Use `[data-hovering]`, `[data-scrolling]`, and `[data-has-overflow-x/y]` on Scrollbar to drive visibility styles.                                                                         |
+| Scrollbar/Thumb `[data-orientation]`           | Same (`data-orientation` on Scrollbar and Thumb).                                                                                                                                                  |
+| -                                              | New, on Root/Content/Viewport/Scrollbar: `data-has-overflow-x`, `data-has-overflow-y`, `data-overflow-x-start/end`, `data-overflow-y-start/end`, `data-scrolling`; Scrollbar also `data-hovering`. |
 
 ### CSS variables
 
 Radix's scroll-area docs list no CSS variables (its implementation ships undocumented `--radix-scroll-area-thumb-*`/`corner-*` vars). Base UI documents:
 
-| Base UI variable | Where |
-| --- | --- |
-| `--scroll-area-corner-width`, `--scroll-area-corner-height` | Root |
-| `--scroll-area-thumb-width`, `--scroll-area-thumb-height` | Scrollbar |
+| Base UI variable                                                           | Where                                                            |
+| -------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `--scroll-area-corner-width`, `--scroll-area-corner-height`                | Root                                                             |
+| `--scroll-area-thumb-width`, `--scroll-area-thumb-height`                  | Scrollbar                                                        |
 | `--scroll-area-overflow-x-start/end`, `--scroll-area-overflow-y-start/end` | Viewport (pixel distance from each edge, great for scroll fades) |
 
 ---
@@ -122,11 +122,11 @@ Part mapping: `Separator.Root` → `Separator` (callable single part, no `.Root`
 
 ## Separator.Root → Separator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` | Same, same default (`Orientation` type). |
-| `decorative` | `boolean` / - | Dropped | Base UI's separator is always semantic (`role="separator"`). For a purely visual rule, render a plain `<div aria-hidden="true">` or use a CSS border instead. |
+| Radix prop    | Type / default                                | Base UI equivalent | Migration note                                                                                                                                                |
+| ------------- | --------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`     | `boolean` / `false`                           | `render`           | Signature changed.                                                                                                                                            |
+| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation`      | Same, same default (`Orientation` type).                                                                                                                      |
+| `decorative`  | `boolean` / -                                 | Dropped            | Base UI's separator is always semantic (`role="separator"`). For a purely visual rule, render a plain `<div aria-hidden="true">` or use a CSS border instead. |
 
 ### Base UI only props worth knowing
 
@@ -148,23 +148,23 @@ Part mapping: `Avatar.Root` → `Avatar.Root`, `Avatar.Image` → `Avatar.Image`
 
 ## Avatar.Root → Avatar.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop on both sides. Base Root can also take plain children (e.g. initials) with no Image/Fallback. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                          |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop on both sides. Base Root can also take plain children (e.g. initials) with no Image/Fallback. |
 
 ## Avatar.Image → Avatar.Image
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
+| Radix prop              | Type / default                                                     | Base UI equivalent      | Migration note                              |
+| ----------------------- | ------------------------------------------------------------------ | ----------------------- | ------------------------------------------- |
+| `asChild`               | `boolean` / `false`                                                | `render`                | Signature changed.                          |
 | `onLoadingStatusChange` | `(status: "idle" \| "loading" \| "loaded" \| "error") => void` / - | `onLoadingStatusChange` | Same name, same `ImageLoadingStatus` union. |
 
 ## Avatar.Fallback → Avatar.Fallback
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `delayMs` | `number` / - | `delay` | Renamed, same meaning (ms to wait before showing the fallback). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                  |
+| ---------- | ------------------- | ------------------ | --------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed.                                              |
+| `delayMs`  | `number` / -        | `delay`            | Renamed, same meaning (ms to wait before showing the fallback). |
 
 ### Base UI only props worth knowing
 
@@ -186,80 +186,80 @@ The mental model changes completely: Radix toast is declarative (you render `<To
 
 Part mapping:
 
-| Radix part | Base UI part |
-| --- | --- |
-| `Toast.Provider` | `Toast.Provider` (props differ heavily) |
-| `Toast.Viewport` | `Toast.Portal` + `Toast.Viewport` (Portal is new; appends to `<body>` by default) |
-| `Toast.Root` | `Toast.Root` (requires `toast` object; typically wraps new `Toast.Content`) |
-| `Toast.Title` | `Toast.Title` (renders `<h2>`) |
-| `Toast.Description` | `Toast.Description` (renders `<p>`) |
-| `Toast.Action` | `Toast.Action` (rendered per-toast; props can come from `toast.actionProps`) |
-| `Toast.Close` | `Toast.Close` |
-| - | New: `Toast.Content`, `Toast.Positioner` + `Toast.Arrow` (anchored toasts), `Toast.createToastManager`, `Toast.useToastManager` |
+| Radix part          | Base UI part                                                                                                                    |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `Toast.Provider`    | `Toast.Provider` (props differ heavily)                                                                                         |
+| `Toast.Viewport`    | `Toast.Portal` + `Toast.Viewport` (Portal is new; appends to `<body>` by default)                                               |
+| `Toast.Root`        | `Toast.Root` (requires `toast` object; typically wraps new `Toast.Content`)                                                     |
+| `Toast.Title`       | `Toast.Title` (renders `<h2>`)                                                                                                  |
+| `Toast.Description` | `Toast.Description` (renders `<p>`)                                                                                             |
+| `Toast.Action`      | `Toast.Action` (rendered per-toast; props can come from `toast.actionProps`)                                                    |
+| `Toast.Close`       | `Toast.Close`                                                                                                                   |
+| -                   | New: `Toast.Content`, `Toast.Positioner` + `Toast.Arrow` (anchored toasts), `Toast.createToastManager`, `Toast.useToastManager` |
 
 ## Toast.Provider → Toast.Provider
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `duration` | `number` / `5000` | `timeout` | Renamed. Same default (`5000`, `0` disables auto-dismiss). Per-toast override moved to `add({ timeout })`. |
-| `label` (required) | `string` / `"Notification"` | Dropped | Base UI handles screen reader announcements internally; per-toast urgency via `priority: 'low' \| 'high'` in `add()`. |
-| `swipeDirection` | `"right" \| "left" \| "up" \| "down"` / `"right"` | Moved | Now `swipeDirection` on `Toast.Root`; accepts a single value or an array, default `['down', 'right']`. |
-| `swipeThreshold` | `number` / `50` | Dropped | Not configurable. Opt elements out of swipe with the `data-base-ui-swipe-ignore` attribute. |
-| `announcerContainer` | `Element \| DocumentFragment` / `document.body` | Dropped | Closest analog is `Toast.Portal container` for where the viewport renders. |
+| Radix prop           | Type / default                                    | Base UI equivalent | Migration note                                                                                                        |
+| -------------------- | ------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| `duration`           | `number` / `5000`                                 | `timeout`          | Renamed. Same default (`5000`, `0` disables auto-dismiss). Per-toast override moved to `add({ timeout })`.            |
+| `label` (required)   | `string` / `"Notification"`                       | Dropped            | Base UI handles screen reader announcements internally; per-toast urgency via `priority: 'low' \| 'high'` in `add()`. |
+| `swipeDirection`     | `"right" \| "left" \| "up" \| "down"` / `"right"` | Moved              | Now `swipeDirection` on `Toast.Root`; accepts a single value or an array, default `['down', 'right']`.                |
+| `swipeThreshold`     | `number` / `50`                                   | Dropped            | Not configurable. Opt elements out of swipe with the `data-base-ui-swipe-ignore` attribute.                           |
+| `announcerContainer` | `Element \| DocumentFragment` / `document.body`   | Dropped            | Closest analog is `Toast.Portal container` for where the viewport renders.                                            |
 
 ## Toast.Viewport → Toast.Portal + Toast.Viewport
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | On both Portal and Viewport. |
-| `hotkey` | `string[]` / `["F8"]` | Dropped | Base UI hard-wires F6 to focus the viewport landmark; not configurable. |
-| `label` | `string` / `"Notifications ({hotkey})"` | Dropped | Landmark labelling handled internally. |
+| Radix prop | Type / default                          | Base UI equivalent | Migration note                                                          |
+| ---------- | --------------------------------------- | ------------------ | ----------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false`                     | `render`           | On both Portal and Viewport.                                            |
+| `hotkey`   | `string[]` / `["F8"]`                   | Dropped            | Base UI hard-wires F6 to focus the viewport landmark; not configurable. |
+| `label`    | `string` / `"Notifications ({hotkey})"` | Dropped            | Landmark labelling handled internally.                                  |
 
 Base UI only: `Portal.container` (`HTMLElement | ShadowRoot | ref | null`).
 
 ## Toast.Root → Toast.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `type` | `"foreground" \| "background"` / `"foreground"` | `priority` in `add()` options | Moved + renamed: `foreground` ≈ `priority: 'high'` (announced urgently), `background` ≈ `'low'` (default). Careful: Base UI's `toast.type` is a different concept (a free-form styling category like `'success'`, surfaced as `data-type`). |
-| `duration` | `number` / - | `timeout` in `add()` options | Moved + renamed; per-toast override of Provider `timeout`. |
-| `defaultOpen` | `boolean` / `true` | Dropped | Open state lives in the manager. Create with `add()`, remove with `close(id)`. |
-| `open` | `boolean` / - | Dropped | Same as above; there is no controlled-open mode. `add({ id })` upserts an existing toast in place. |
-| `onOpenChange` | `(open: boolean) => void` / - | Dropped (workaround) | Use `onClose` / `onRemove` callbacks in the toast object (`add()` options). |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / - | Dropped | Esc-to-close still works when focus is in the viewport, but is not interceptable. |
-| `onPause` / `onResume` | `() => void` / - | Dropped | Timers still pause on hover, focus, and window blur automatically, but there are no callbacks. |
-| `onSwipeStart` / `onSwipeMove` / `onSwipeEnd` / `onSwipeCancel` | `(event: SwipeEvent) => void` / - | Dropped (workaround) | Swiping is styled, not scripted: `[data-swiping]`, `[data-swipe-direction]` and `--toast-swipe-movement-x/y` replace the event hooks. |
-| `forceMount` | `boolean` / - | Dropped | Roots render from the `toasts` array; exit animations get `data-ending-style` + `toast.transitionStatus: 'ending'` before removal (`onRemove` fires after). |
+| Radix prop                                                      | Type / default                                  | Base UI equivalent            | Migration note                                                                                                                                                                                                                              |
+| --------------------------------------------------------------- | ----------------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`                                                       | `boolean` / `false`                             | `render`                      | Signature changed.                                                                                                                                                                                                                          |
+| `type`                                                          | `"foreground" \| "background"` / `"foreground"` | `priority` in `add()` options | Moved + renamed: `foreground` ≈ `priority: 'high'` (announced urgently), `background` ≈ `'low'` (default). Careful: Base UI's `toast.type` is a different concept (a free-form styling category like `'success'`, surfaced as `data-type`). |
+| `duration`                                                      | `number` / -                                    | `timeout` in `add()` options  | Moved + renamed; per-toast override of Provider `timeout`.                                                                                                                                                                                  |
+| `defaultOpen`                                                   | `boolean` / `true`                              | Dropped                       | Open state lives in the manager. Create with `add()`, remove with `close(id)`.                                                                                                                                                              |
+| `open`                                                          | `boolean` / -                                   | Dropped                       | Same as above; there is no controlled-open mode. `add({ id })` upserts an existing toast in place.                                                                                                                                          |
+| `onOpenChange`                                                  | `(open: boolean) => void` / -                   | Dropped (workaround)          | Use `onClose` / `onRemove` callbacks in the toast object (`add()` options).                                                                                                                                                                 |
+| `onEscapeKeyDown`                                               | `(event: KeyboardEvent) => void` / -            | Dropped                       | Esc-to-close still works when focus is in the viewport, but is not interceptable.                                                                                                                                                           |
+| `onPause` / `onResume`                                          | `() => void` / -                                | Dropped                       | Timers still pause on hover, focus, and window blur automatically, but there are no callbacks.                                                                                                                                              |
+| `onSwipeStart` / `onSwipeMove` / `onSwipeEnd` / `onSwipeCancel` | `(event: SwipeEvent) => void` / -               | Dropped (workaround)          | Swiping is styled, not scripted: `[data-swiping]`, `[data-swipe-direction]` and `--toast-swipe-movement-x/y` replace the event hooks.                                                                                                       |
+| `forceMount`                                                    | `boolean` / -                                   | Dropped                       | Roots render from the `toasts` array; exit animations get `data-ending-style` + `toast.transitionStatus: 'ending'` before removal (`onRemove` fires after).                                                                                 |
 
 Base UI only on Root: `toast` (required `Toast.Root.ToastObject`: `id`, `title`, `description`, `type`, `timeout`, `priority`, `updateKey`, `limited`, `height`, `onClose`, `onRemove`, `actionProps`, `positionerProps`, `data`), `swipeDirection` (single or array).
 
 ## Toast.Title → Toast.Title
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop. Base renders `<h2>` (Radix rendered `<div>`); pass `render={<div />}` to keep a div. Content usually comes from `toast.title`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                            |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop. Base renders `<h2>` (Radix rendered `<div>`); pass `render={<div />}` to keep a div. Content usually comes from `toast.title`. |
 
 ## Toast.Description → Toast.Description
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Only prop. Base renders `<p>`. Content usually comes from `toast.description`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                 |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Only prop. Base renders `<p>`. Content usually comes from `toast.description`. |
 
 ## Toast.Action → Toast.Action
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `altText` (required) | `string` / - | Dropped | No equivalent prop. When creating toasts via the manager, pass the button's props (including handlers and aria attributes) through `add({ actionProps })`. |
+| Radix prop           | Type / default      | Base UI equivalent | Migration note                                                                                                                                             |
+| -------------------- | ------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`            | `boolean` / `false` | `render`           | Signature changed.                                                                                                                                         |
+| `altText` (required) | `string` / -        | Dropped            | No equivalent prop. When creating toasts via the manager, pass the button's props (including handlers and aria attributes) through `add({ actionProps })`. |
 
 Base UI only: `nativeButton` (`boolean`, default `true`, set `false` when `render` is not a button).
 
 ## Toast.Close → Toast.Close
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note     |
+| ---------- | ------------------- | ------------------ | ------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed. |
 
 Base UI only: `nativeButton` (as on Action).
 
@@ -271,20 +271,20 @@ Base UI only: `nativeButton` (as on Action).
 
 ### Data attributes
 
-| Radix | Base UI |
-| --- | --- |
-| Root `[data-state="open" \| "closed"]` | `data-starting-style` / `data-ending-style` (CSS transition hooks) |
-| Root `[data-swipe="start" \| "move" \| "cancel" \| "end"]` | `[data-swiping]` while swiping; `"end"` ≈ `[data-ending-style][data-swipe-direction=...]` |
-| Root `[data-swipe-direction]` (`up/down/left/right`) | Same name and values |
-| - | New: Root `data-expanded`, `data-limited`, `data-type`; Viewport `data-expanded`; Content `data-behind`, `data-expanded`; Title/Description/Close/Action `data-type`; Positioner/Arrow `data-side`, `data-align`, `data-anchor-hidden`/`data-uncentered` |
+| Radix                                                      | Base UI                                                                                                                                                                                                                                                  |
+| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Root `[data-state="open" \| "closed"]`                     | `data-starting-style` / `data-ending-style` (CSS transition hooks)                                                                                                                                                                                       |
+| Root `[data-swipe="start" \| "move" \| "cancel" \| "end"]` | `[data-swiping]` while swiping; `"end"` ≈ `[data-ending-style][data-swipe-direction=...]`                                                                                                                                                                |
+| Root `[data-swipe-direction]` (`up/down/left/right`)       | Same name and values                                                                                                                                                                                                                                     |
+| -                                                          | New: Root `data-expanded`, `data-limited`, `data-type`; Viewport `data-expanded`; Content `data-behind`, `data-expanded`; Title/Description/Close/Action `data-type`; Positioner/Arrow `data-side`, `data-align`, `data-anchor-hidden`/`data-uncentered` |
 
 ### CSS variables
 
-| Radix | Base UI |
-| --- | --- |
-| `--radix-toast-swipe-move-x` / `--radix-toast-swipe-move-y` | `--toast-swipe-movement-x` / `--toast-swipe-movement-y` |
-| `--radix-toast-swipe-end-x` / `--radix-toast-swipe-end-y` | Dropped; animate dismissal from `[data-ending-style][data-swipe-direction=...]` using the movement vars |
-| - | New on Root: `--toast-index`, `--toast-offset-y`, `--toast-height`; Viewport: `--toast-frontmost-height`; Positioner: `--anchor-width/height`, `--available-width/height`, `--transform-origin` |
+| Radix                                                       | Base UI                                                                                                                                                                                         |
+| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--radix-toast-swipe-move-x` / `--radix-toast-swipe-move-y` | `--toast-swipe-movement-x` / `--toast-swipe-movement-y`                                                                                                                                         |
+| `--radix-toast-swipe-end-x` / `--radix-toast-swipe-end-y`   | Dropped; animate dismissal from `[data-ending-style][data-swipe-direction=...]` using the movement vars                                                                                         |
+| -                                                           | New on Root: `--toast-index`, `--toast-offset-y`, `--toast-height`; Viewport: `--toast-frontmost-height`; Positioner: `--anchor-width/height`, `--available-width/height`, `--transform-origin` |
 
 ---
 
@@ -294,75 +294,75 @@ Base UI splits Radix Form across three components: `Form` (`@base-ui/react/form`
 
 Part mapping:
 
-| Radix part | Base UI part |
-| --- | --- |
-| `Form.Root` | `Form` (callable, no `.Root`) |
-| `Form.Field` | `Field.Root` |
-| `Form.Label` | `Field.Label` |
-| `Form.Control` | `Field.Control` (or any Base UI input component: Input, Checkbox, Select, ... work inside Field out of the box) |
-| `Form.Message` | `Field.Error` (validation errors); `Field.Description` for plain hint text |
-| `Form.ValidityState` | `Field.Validity` |
-| `Form.Submit` | Dropped; use a plain `<button type="submit">` |
-| - | New: `Fieldset.Root` + `Fieldset.Legend`, `Field.Item` (per-item wrapper in checkbox/radio groups) |
+| Radix part           | Base UI part                                                                                                    |
+| -------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `Form.Root`          | `Form` (callable, no `.Root`)                                                                                   |
+| `Form.Field`         | `Field.Root`                                                                                                    |
+| `Form.Label`         | `Field.Label`                                                                                                   |
+| `Form.Control`       | `Field.Control` (or any Base UI input component: Input, Checkbox, Select, ... work inside Field out of the box) |
+| `Form.Message`       | `Field.Error` (validation errors); `Field.Description` for plain hint text                                      |
+| `Form.ValidityState` | `Field.Validity`                                                                                                |
+| `Form.Submit`        | Dropped; use a plain `<button type="submit">`                                                                   |
+| -                    | New: `Fieldset.Root` + `Fieldset.Legend`, `Field.Item` (per-item wrapper in checkbox/radio groups)              |
 
 ## Form.Root → Form
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `onClearServerErrors` | `() => void` / - | Dropped (workaround) | The server-error model changed: pass an `errors` object (keys = `Field.Root` `name`, values = message(s)) to `Form`; clear your own error state in `onFormSubmit` (Base calls `preventDefault()` for you) or in `onValueChange` per field. |
+| Radix prop            | Type / default      | Base UI equivalent   | Migration note                                                                                                                                                                                                                             |
+| --------------------- | ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`             | `boolean` / `false` | `render`             | Signature changed.                                                                                                                                                                                                                         |
+| `onClearServerErrors` | `() => void` / -    | Dropped (workaround) | The server-error model changed: pass an `errors` object (keys = `Field.Root` `name`, values = message(s)) to `Form`; clear your own error state in `onFormSubmit` (Base calls `preventDefault()` for you) or in `onValueChange` per field. |
 
 Base UI only on Form: `errors` (`Errors`), `onFormSubmit` (`(formValues, eventDetails) => void`), `validationMode` (`'onSubmit' | 'onBlur' | 'onChange'`, default `'onSubmit'`), `actionsRef` (`{ validate(fieldName?) }`).
 
 ## Form.Field → Field.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `name` (required) | `string` / - | `name` | Same purpose (submission identity + matching `Form errors` keys); optional in Base UI and takes precedence over `name` on `Field.Control`. |
-| `serverInvalid` | `boolean` / - | Dropped (workaround) | Either supply the message via `Form errors={{ [name]: message }}` (field becomes invalid and `Field.Error` shows it), or force state with the `invalid` boolean prop on `Field.Root`. |
+| Radix prop        | Type / default      | Base UI equivalent   | Migration note                                                                                                                                                                        |
+| ----------------- | ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean` / `false` | `render`             | Signature changed.                                                                                                                                                                    |
+| `name` (required) | `string` / -        | `name`               | Same purpose (submission identity + matching `Form errors` keys); optional in Base UI and takes precedence over `name` on `Field.Control`.                                            |
+| `serverInvalid`   | `boolean` / -       | Dropped (workaround) | Either supply the message via `Form errors={{ [name]: message }}` (field becomes invalid and `Field.Error` shows it), or force state with the `invalid` boolean prop on `Field.Root`. |
 
 Base UI only on Field.Root: `validate` (`(value, formValues) => string | string[] | Promise<...> | null`, the custom-validation replacement for Radix function `match`), `validationMode`, `validationDebounceTime` (`0`), `disabled`, `invalid`, `dirty`, `touched`, `actionsRef` (`{ validate() }`).
 
 ## Form.Label → Field.Label
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. Auto-association with the control is preserved. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                     |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed. Auto-association with the control is preserved. |
 
 Base UI only: `nativeLabel` (`boolean`, default `true`; set `false` when `render` swaps in a non-label element, e.g. a `<div>` labelling a `<Select.Trigger>` button).
 
 ## Form.Control → Field.Control
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. For composite widgets, skip Control entirely: Base UI inputs (Input, Checkbox, Select, ...) wire into `Field.Root` directly, which Radix Form could not do. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                                                                 |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Signature changed. For composite widgets, skip Control entirely: Base UI inputs (Input, Checkbox, Select, ...) wire into `Field.Root` directly, which Radix Form could not do. |
 
 Base UI only: `defaultValue` (`string | number | string[]`), `onValueChange` (`(value, eventDetails) => void`).
 
 ## Form.Message → Field.Error
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Signature changed. |
-| `match` | `'badInput' \| 'patternMismatch' \| 'rangeOverflow' \| 'rangeUnderflow' \| 'stepMismatch' \| 'tooLong' \| 'tooShort' \| 'typeMismatch' \| 'valid' \| 'valueMissing' \| ((value, formData) => boolean \| Promise<boolean>)` / - | `match` | Signature changed: Base UI is `boolean \| 'valid' \| 'badInput' \| 'customError' \| 'patternMismatch' \| 'rangeOverflow' \| 'rangeUnderflow' \| 'stepMismatch' \| 'tooLong' \| 'tooShort' \| 'typeMismatch' \| 'valueMissing'`. The function form is gone: move custom rules to `validate` on `Field.Root` (returns error string(s)); an Error without `match` then displays them. `'customError'` matches `validate` failures. |
-| `forceMatch` | `boolean` / `false` | `match={true}` | Renamed/absorbed: `match` accepting `true` always shows the message (the documented hook for external libraries and server errors). |
-| `name` | `string` / - | Dropped | `Field.Error` cannot target a field from outside; it must be nested in the owning `Field.Root`. |
+| Radix prop   | Type / default                                                                                                                                                                                                                 | Base UI equivalent | Migration note                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`    | `boolean` / `false`                                                                                                                                                                                                            | `render`           | Signature changed.                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `match`      | `'badInput' \| 'patternMismatch' \| 'rangeOverflow' \| 'rangeUnderflow' \| 'stepMismatch' \| 'tooLong' \| 'tooShort' \| 'typeMismatch' \| 'valid' \| 'valueMissing' \| ((value, formData) => boolean \| Promise<boolean>)` / - | `match`            | Signature changed: Base UI is `boolean \| 'valid' \| 'badInput' \| 'customError' \| 'patternMismatch' \| 'rangeOverflow' \| 'rangeUnderflow' \| 'stepMismatch' \| 'tooLong' \| 'tooShort' \| 'typeMismatch' \| 'valueMissing'`. The function form is gone: move custom rules to `validate` on `Field.Root` (returns error string(s)); an Error without `match` then displays them. `'customError'` matches `validate` failures. |
+| `forceMatch` | `boolean` / `false`                                                                                                                                                                                                            | `match={true}`     | Renamed/absorbed: `match` accepting `true` always shows the message (the documented hook for external libraries and server errors).                                                                                                                                                                                                                                                                                             |
+| `name`       | `string` / -                                                                                                                                                                                                                   | Dropped            | `Field.Error` cannot target a field from outside; it must be nested in the owning `Field.Root`.                                                                                                                                                                                                                                                                                                                                 |
 
 Note: Radix rendered default English messages per `match` when `children` were omitted; Base UI renders the error string coming from `validate`/`Form errors`, otherwise provide `children`. `Field.Description` (className/style/render only) is the new home for non-error helper text. Error renders a `<div>`, Description a `<p>`.
 
 ## Form.ValidityState → Field.Validity
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
+| Radix prop | Type / default                                                  | Base UI equivalent    | Migration note                                                                                                                                                                                     |
+| ---------- | --------------------------------------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `children` | `(validity: ValidityState \| undefined) => React.ReactNode` / - | `children` (required) | Signature changed: `(state: Field.Validity.State) => React.ReactNode` where the native flags live at `state.validity.*` (plus `state.errors`, `state.error`, `state.value`, `state.initialValue`). |
-| `name` | `string` / - | Dropped | Must be nested inside `Field.Root`. |
+| `name`     | `string` / -                                                    | Dropped               | Must be nested inside `Field.Root`.                                                                                                                                                                |
 
 ## Form.Submit → (none)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | Dropped | No submit part; render a plain `<button type="submit">` (or the styled Button component). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                            |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | Dropped            | No submit part; render a plain `<button type="submit">` (or the styled Button component). |
 
 ## (new) Fieldset.Root and Fieldset.Legend
 
@@ -377,11 +377,11 @@ No Radix counterpart. `Fieldset.Root` renders a native `<fieldset>` (props: `cla
 
 ### Data attributes
 
-| Radix (Field/Label/Control/Message) | Base UI (all Field parts: Root, Item, Label, Control, Description, Error) |
-| --- | --- |
-| `[data-valid]` | `[data-valid]` (same) |
-| `[data-invalid]` | `[data-invalid]` (same) |
-| - | New: `data-dirty`, `data-touched`, `data-filled`, `data-focused`, `data-disabled`; Error also gets `data-starting-style`/`data-ending-style`. |
+| Radix (Field/Label/Control/Message) | Base UI (all Field parts: Root, Item, Label, Control, Description, Error)                                                                     |
+| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `[data-valid]`                      | `[data-valid]` (same)                                                                                                                         |
+| `[data-invalid]`                    | `[data-invalid]` (same)                                                                                                                       |
+| -                                   | New: `data-dirty`, `data-touched`, `data-filled`, `data-focused`, `data-disabled`; Error also gets `data-starting-style`/`data-ending-style`. |
 
 ### CSS variables
 
diff --git a/.agents/skills/migrate-radix-to-base/form-controls.md b/.agents/skills/migrate-radix-to-base/form-controls.md
index 829de39..e4b14c5 100644
--- a/.agents/skills/migrate-radix-to-base/form-controls.md
+++ b/.agents/skills/migrate-radix-to-base/form-controls.md
@@ -19,128 +19,128 @@ Part mapping: `Root -> Root`, `Trigger -> Trigger`, `Value -> Value`, `Icon -> I
 
 ## Select.Root → Select.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultValue` | `string`, no default | `defaultValue: Value[] \| Value \| null` | Same name, widened type. Values can be any type (objects supported), arrays for `multiple`. |
-| `value` | `string`, no default | `value: Value[] \| Value \| null` | Same name, widened type. `null` means "no value" (placeholder shown). |
-| `onValueChange` | `(value: string) => void` | `onValueChange: (value: Value[] \| Value \| null, eventDetails: Select.Root.ChangeEventDetails) => void` | Signature changed: second `eventDetails` arg with `reason` (`'trigger-press' \| 'outside-press' \| 'escape-key' \| 'window-resize' \| 'item-press' \| 'focus-out' \| 'list-navigation' \| 'cancel-open' \| 'none'`) and `cancel()`. |
-| `defaultOpen` | `boolean`, no default | `defaultOpen: boolean`, default `false` | Same. |
-| `open` | `boolean`, no default | `open: boolean` | Same. |
-| `onOpenChange` | `(open: boolean) => void` | `onOpenChange: (open: boolean, eventDetails: Select.Root.ChangeEventDetails) => void` | Signature changed: added `eventDetails` (same reason union as above). Radix Content's `onEscapeKeyDown`/`onPointerDownOutside` interception moves here (check `eventDetails.reason === 'escape-key'` / `'outside-press'`, call `eventDetails.cancel()` to keep open). |
-| `dir` | `"ltr" \| "rtl"`, no default | dropped | Use Base UI `DirectionProvider` or the `dir` attribute on an ancestor. |
-| `name` | `string`, no default | `name: string` | Same (Base UI renders a hidden `<input>`). |
-| `disabled` | `boolean`, no default | `disabled: boolean`, default `false` | Same. |
-| `required` | `boolean`, no default | `required: boolean`, default `false` | Same. |
+| Radix prop      | Type / default               | Base UI equivalent                                                                                       | Migration note                                                                                                                                                                                                                                                        |
+| --------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultValue`  | `string`, no default         | `defaultValue: Value[] \| Value \| null`                                                                 | Same name, widened type. Values can be any type (objects supported), arrays for `multiple`.                                                                                                                                                                           |
+| `value`         | `string`, no default         | `value: Value[] \| Value \| null`                                                                        | Same name, widened type. `null` means "no value" (placeholder shown).                                                                                                                                                                                                 |
+| `onValueChange` | `(value: string) => void`    | `onValueChange: (value: Value[] \| Value \| null, eventDetails: Select.Root.ChangeEventDetails) => void` | Signature changed: second `eventDetails` arg with `reason` (`'trigger-press' \| 'outside-press' \| 'escape-key' \| 'window-resize' \| 'item-press' \| 'focus-out' \| 'list-navigation' \| 'cancel-open' \| 'none'`) and `cancel()`.                                   |
+| `defaultOpen`   | `boolean`, no default        | `defaultOpen: boolean`, default `false`                                                                  | Same.                                                                                                                                                                                                                                                                 |
+| `open`          | `boolean`, no default        | `open: boolean`                                                                                          | Same.                                                                                                                                                                                                                                                                 |
+| `onOpenChange`  | `(open: boolean) => void`    | `onOpenChange: (open: boolean, eventDetails: Select.Root.ChangeEventDetails) => void`                    | Signature changed: added `eventDetails` (same reason union as above). Radix Content's `onEscapeKeyDown`/`onPointerDownOutside` interception moves here (check `eventDetails.reason === 'escape-key'` / `'outside-press'`, call `eventDetails.cancel()` to keep open). |
+| `dir`           | `"ltr" \| "rtl"`, no default | dropped                                                                                                  | Use Base UI `DirectionProvider` or the `dir` attribute on an ancestor.                                                                                                                                                                                                |
+| `name`          | `string`, no default         | `name: string`                                                                                           | Same (Base UI renders a hidden `<input>`).                                                                                                                                                                                                                            |
+| `disabled`      | `boolean`, no default        | `disabled: boolean`, default `false`                                                                     | Same.                                                                                                                                                                                                                                                                 |
+| `required`      | `boolean`, no default        | `required: boolean`, default `false`                                                                     | Same.                                                                                                                                                                                                                                                                 |
 
 Base UI `Select.Root` renders no HTML element (Radix Root doesn't either).
 
 ## Select.Trigger → Select.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | See global conventions. Base UI Trigger renders `<button>` by default; `nativeButton` defaults to `true` here, set it to `false` when rendering a non-button via `render`. |
-| (none) | - | `disabled: boolean` | Base UI allows disabling just the trigger. |
+| Radix prop | Type / default     | Base UI equivalent  | Migration note                                                                                                                                                             |
+| ---------- | ------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`            | See global conventions. Base UI Trigger renders `<button>` by default; `nativeButton` defaults to `true` here, set it to `false` when rendering a non-button via `render`. |
+| (none)     | -                  | `disabled: boolean` | Base UI allows disabling just the trigger.                                                                                                                                 |
 
 ## Select.Value → Select.Value
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
+| Radix prop    | Type / default          | Base UI equivalent             | Migration note                                                                                                                                                                                                                                                                                             |
+| ------------- | ----------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`     | `boolean`, `false`      | `render`                       | Same pattern.                                                                                                                                                                                                                                                                                              |
 | `placeholder` | `ReactNode`, no default | `placeholder: React.ReactNode` | Same name. Behavior change: Radix `Value` renders the selected Item's `ItemText` content; Base UI renders the raw value string unless you pass `items` on Root or a `children` function (`(value) => ReactNode`). If your item labels differ from values, supply `items` on Root or format via `children`. |
 
 ## Select.Icon → Select.Icon
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. Base UI Icon exposes `data-popup-open` for rotate-when-open styling. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                     |
+| ---------- | ------------------ | ------------------ | ---------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Same pattern. Base UI Icon exposes `data-popup-open` for rotate-when-open styling. |
 
 ## Select.Portal → Select.Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
+| Radix prop  | Type / default                         | Base UI equivalent                                                     | Migration note                                                                                                                       |
+| ----------- | -------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `container` | `HTMLElement`, default `document.body` | `container: HTMLElement \| ShadowRoot \| React.RefObject<...> \| null` | Same concept, type widened (accepts refs and ShadowRoot). Base UI Portal renders a `<div>` and accepts `className`/`style`/`render`. |
 
 ## Select.Content → Select.Portal > Select.Positioner > Select.Popup (moved/split)
 
 Radix `Content` handled positioning, collision, and the panel in one part. In Base UI, positioning props live on `Positioner`, panel/focus props live on `Popup`, dismiss interception lives on `Root.onOpenChange` eventDetails.
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` (on Positioner and/or Popup) | Same pattern. |
-| `position` | `"item-aligned" \| "popper"`, default `"item-aligned"` | `alignItemWithTrigger: boolean` on Positioner, default `true` | Signature changed: enum becomes boolean. `"item-aligned"` -> `alignItemWithTrigger` (true, the default), `"popper"` -> `alignItemWithTrigger={false}`. Base UI auto-disables it when space is insufficient or on touch input. |
-| `side` | `"top" \| "right" \| "bottom" \| "left"`, default `"bottom"` | `side: Side` on Positioner, default `'bottom'` | Moved. Base UI adds `'inline-start' \| 'inline-end'` logical values. Only applies when `alignItemWithTrigger` is off (as with Radix popper mode). |
-| `sideOffset` | `number`, default `0` | `sideOffset: number \| OffsetFunction` on Positioner, default `0` | Moved, type widened (accepts a function of `{ side, align, anchor, positioner }`). |
-| `align` | `"start" \| "center" \| "end"`, default `"start"` | `align: Align` on Positioner, default `'center'` | Moved. Default differs: Radix `"start"` vs Base UI `'center'`. Pass `align="start"` explicitly to preserve Radix behavior. |
-| `alignOffset` | `number`, default `0` | `alignOffset: number \| OffsetFunction` on Positioner, default `0` | Moved, type widened. |
-| `avoidCollisions` | `boolean`, default `true` | `collisionAvoidance: CollisionAvoidance` on Positioner | Signature changed: boolean becomes a config object `{ side: 'flip' \| 'shift' \| 'none', align: 'flip' \| 'shift' \| 'none', fallbackAxisSide: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` ~ `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`. |
-| `collisionBoundary` | `Boundary`, default `[]` | `collisionBoundary: Boundary` on Positioner, default `'clipping-ancestors'` | Moved, default differs (Radix default is the viewport, Base UI defaults to clipping ancestors). |
-| `collisionPadding` | `number \| Padding`, default `10` | `collisionPadding: Padding` on Positioner, default `5` | Moved, default differs (10 -> 5). |
-| `arrowPadding` | `number`, default `0` | `arrowPadding: number` on Positioner, default `5` | Moved, default differs (0 -> 5). |
-| `sticky` | `"partial" \| "always"`, default `"partial"` | `sticky: boolean` on Positioner, default `false` | Signature changed and semantics differ: Base UI `sticky` keeps the popup in the viewport after the anchor scrolls out of view. There is no `"always"` equivalent. |
-| `hideWhenDetached` | `boolean`, default `false` | dropped (workaround) | No prop. Style on `data-anchor-hidden` (present on Positioner when the anchor is hidden), e.g. `[data-anchor-hidden] { visibility: hidden }`. |
-| `onCloseAutoFocus` | `(event: Event) => void` | `finalFocus` on Popup | Signature changed: instead of preventing default in an event handler, pass `finalFocus` as `boolean \| RefObject \| ((closeType: InteractionType) => boolean \| void \| HTMLElement \| null)`. `false` = don't move focus (the `preventDefault()` equivalent), a ref/element = focus that. |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` | moved to `Root.onOpenChange` | Check `eventDetails.reason === 'escape-key'`; call `eventDetails.cancel()` to prevent close. |
-| `onPointerDownOutside` | `(event: PointerEvent) => void` | moved to `Root.onOpenChange` | Check `eventDetails.reason === 'outside-press'`; call `eventDetails.cancel()` to prevent close. |
+| Radix prop             | Type / default                                               | Base UI equivalent                                                          | Migration note                                                                                                                                                                                                                                                                              |
+| ---------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean`, `false`                                           | `render` (on Positioner and/or Popup)                                       | Same pattern.                                                                                                                                                                                                                                                                               |
+| `position`             | `"item-aligned" \| "popper"`, default `"item-aligned"`       | `alignItemWithTrigger: boolean` on Positioner, default `true`               | Signature changed: enum becomes boolean. `"item-aligned"` -> `alignItemWithTrigger` (true, the default), `"popper"` -> `alignItemWithTrigger={false}`. Base UI auto-disables it when space is insufficient or on touch input.                                                               |
+| `side`                 | `"top" \| "right" \| "bottom" \| "left"`, default `"bottom"` | `side: Side` on Positioner, default `'bottom'`                              | Moved. Base UI adds `'inline-start' \| 'inline-end'` logical values. Only applies when `alignItemWithTrigger` is off (as with Radix popper mode).                                                                                                                                           |
+| `sideOffset`           | `number`, default `0`                                        | `sideOffset: number \| OffsetFunction` on Positioner, default `0`           | Moved, type widened (accepts a function of `{ side, align, anchor, positioner }`).                                                                                                                                                                                                          |
+| `align`                | `"start" \| "center" \| "end"`, default `"start"`            | `align: Align` on Positioner, default `'center'`                            | Moved. Default differs: Radix `"start"` vs Base UI `'center'`. Pass `align="start"` explicitly to preserve Radix behavior.                                                                                                                                                                  |
+| `alignOffset`          | `number`, default `0`                                        | `alignOffset: number \| OffsetFunction` on Positioner, default `0`          | Moved, type widened.                                                                                                                                                                                                                                                                        |
+| `avoidCollisions`      | `boolean`, default `true`                                    | `collisionAvoidance: CollisionAvoidance` on Positioner                      | Signature changed: boolean becomes a config object `{ side: 'flip' \| 'shift' \| 'none', align: 'flip' \| 'shift' \| 'none', fallbackAxisSide: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` ~ `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`. |
+| `collisionBoundary`    | `Boundary`, default `[]`                                     | `collisionBoundary: Boundary` on Positioner, default `'clipping-ancestors'` | Moved, default differs (Radix default is the viewport, Base UI defaults to clipping ancestors).                                                                                                                                                                                             |
+| `collisionPadding`     | `number \| Padding`, default `10`                            | `collisionPadding: Padding` on Positioner, default `5`                      | Moved, default differs (10 -> 5).                                                                                                                                                                                                                                                           |
+| `arrowPadding`         | `number`, default `0`                                        | `arrowPadding: number` on Positioner, default `5`                           | Moved, default differs (0 -> 5).                                                                                                                                                                                                                                                            |
+| `sticky`               | `"partial" \| "always"`, default `"partial"`                 | `sticky: boolean` on Positioner, default `false`                            | Signature changed and semantics differ: Base UI `sticky` keeps the popup in the viewport after the anchor scrolls out of view. There is no `"always"` equivalent.                                                                                                                           |
+| `hideWhenDetached`     | `boolean`, default `false`                                   | dropped (workaround)                                                        | No prop. Style on `data-anchor-hidden` (present on Positioner when the anchor is hidden), e.g. `[data-anchor-hidden] { visibility: hidden }`.                                                                                                                                               |
+| `onCloseAutoFocus`     | `(event: Event) => void`                                     | `finalFocus` on Popup                                                       | Signature changed: instead of preventing default in an event handler, pass `finalFocus` as `boolean \| RefObject \| ((closeType: InteractionType) => boolean \| void \| HTMLElement \| null)`. `false` = don't move focus (the `preventDefault()` equivalent), a ref/element = focus that.  |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void`                             | moved to `Root.onOpenChange`                                                | Check `eventDetails.reason === 'escape-key'`; call `eventDetails.cancel()` to prevent close.                                                                                                                                                                                                |
+| `onPointerDownOutside` | `(event: PointerEvent) => void`                              | moved to `Root.onOpenChange`                                                | Check `eventDetails.reason === 'outside-press'`; call `eventDetails.cancel()` to prevent close.                                                                                                                                                                                             |
 
 ## Select.Viewport → Select.List (renamed)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Renamed part, no other props on either side. Radix required `<ScrollUpButton>`/`<Viewport>`/`<ScrollDownButton>` as siblings inside Content; in Base UI, `List` and the scroll arrows are children of `Popup`. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                                                                                                                                                 |
+| ---------- | ------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Renamed part, no other props on either side. Radix required `<ScrollUpButton>`/`<Viewport>`/`<ScrollDownButton>` as siblings inside Content; in Base UI, `List` and the scroll arrows are children of `Popup`. |
 
 ## Select.Item → Select.Item
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. Also `nativeButton` (default `false`, Base UI Item renders a `<div>`). |
-| `value` | `string`, required | `value: any`, default `null` | Same name, widened type (objects allowed, see Root `isItemEqualToValue` / `itemToString*`). `null` value marks the placeholder item. |
-| `disabled` | `boolean`, no default | `disabled: boolean`, default `false` | Same. |
-| `textValue` | `string`, no default | `label: string` | Renamed. Both drive typeahead text matching, defaulting to the item's text content. |
+| Radix prop  | Type / default        | Base UI equivalent                   | Migration note                                                                                                                       |
+| ----------- | --------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`   | `boolean`, `false`    | `render`                             | Same pattern. Also `nativeButton` (default `false`, Base UI Item renders a `<div>`).                                                 |
+| `value`     | `string`, required    | `value: any`, default `null`         | Same name, widened type (objects allowed, see Root `isItemEqualToValue` / `itemToString*`). `null` value marks the placeholder item. |
+| `disabled`  | `boolean`, no default | `disabled: boolean`, default `false` | Same.                                                                                                                                |
+| `textValue` | `string`, no default  | `label: string`                      | Renamed. Both drive typeahead text matching, defaulting to the item's text content.                                                  |
 
 ## Select.ItemText → Select.ItemText
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. Note element change: Radix renders `<span>`, Base UI renders `<div>`. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                      |
+| ---------- | ------------------ | ------------------ | ----------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Same pattern. Note element change: Radix renders `<span>`, Base UI renders `<div>`. |
 
 ## Select.ItemIndicator → Select.ItemIndicator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| (implicit conditional mount) | - | `keepMounted: boolean` | Base UI unmounts when unselected by default, same as Radix. `keepMounted` keeps it in the DOM (Radix had no `forceMount` on select's ItemIndicator). |
+| Radix prop                   | Type / default     | Base UI equivalent     | Migration note                                                                                                                                       |
+| ---------------------------- | ------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`                    | `boolean`, `false` | `render`               | Same pattern.                                                                                                                                        |
+| (implicit conditional mount) | -                  | `keepMounted: boolean` | Base UI unmounts when unselected by default, same as Radix. `keepMounted` keeps it in the DOM (Radix had no `forceMount` on select's ItemIndicator). |
 
 ## Select.ScrollUpButton / ScrollDownButton → Select.ScrollUpArrow / ScrollDownArrow (renamed)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Renamed parts. Base UI adds `keepMounted: boolean` (default `false`) to keep the arrow in the DOM while the popup is not scrollable. Base UI arrows do not render on touch input. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                                                                                                                    |
+| ---------- | ------------------ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Renamed parts. Base UI adds `keepMounted: boolean` (default `false`) to keep the arrow in the DOM while the popup is not scrollable. Base UI arrows do not render on touch input. |
 
 ## Select.Group → Select.Group
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note |
+| ---------- | ------------------ | ------------------ | -------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Same.          |
 
 ## Select.Label → Select.GroupLabel (renamed)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Renamed. Do NOT map to Base UI `Select.Label`, which is a new part that labels the select trigger itself (rendered outside the popup). |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                                                                         |
+| ---------- | ------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Renamed. Do NOT map to Base UI `Select.Label`, which is a new part that labels the select trigger itself (rendered outside the popup). |
 
 ## Select.Separator → Select.Separator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same. Base UI adds `orientation: Orientation`, default `'horizontal'`. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                         |
+| ---------- | ------------------ | ------------------ | ---------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Same. Base UI adds `orientation: Orientation`, default `'horizontal'`. |
 
 ## Select.Arrow → Select.Arrow
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| `width` | `number`, default `10` | dropped | Size the arrow with CSS; Base UI Arrow renders a `<div>` you fill with your own SVG. |
-| `height` | `number`, default `5` | dropped | Same as above. |
+| Radix prop | Type / default         | Base UI equivalent | Migration note                                                                       |
+| ---------- | ---------------------- | ------------------ | ------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean`, `false`     | `render`           | Same pattern.                                                                        |
+| `width`    | `number`, default `10` | dropped            | Size the arrow with CSS; Base UI Arrow renders a `<div>` you fill with your own SVG. |
+| `height`   | `number`, default `5`  | dropped            | Same as above.                                                                       |
 
 ## Base UI only props worth knowing (select)
 
@@ -154,29 +154,29 @@ Radix `Content` handled positioning, collision, and the panel in one part. In Ba
 
 ## Data-attribute mapping (select)
 
-| Radix | Base UI |
-| --- | --- |
-| Trigger `data-state="open" \| "closed"` | Trigger `data-popup-open` (presence), plus `data-pressed`, `data-popup-side` |
-| Trigger `data-placeholder` | Trigger/Value `data-placeholder` (same) |
-| Trigger `data-disabled` | Trigger `data-disabled` (same), plus `data-readonly`, `data-required`, Field attrs |
-| Content `data-state="open" \| "closed"` | Positioner/Popup `data-open` / `data-closed` (presence) |
-| Content `data-side` (`left/right/bottom/top`) | Positioner/Popup `data-side` (`none/top/bottom/left/right/inline-start/inline-end`) |
-| Content `data-align` | Positioner/Popup `data-align` (same values) |
-| Item `data-state="checked" \| "unchecked"` | Item `data-selected` (presence, no unchecked token) |
-| Item `data-highlighted` | Item `data-highlighted` (same) |
-| Item `data-disabled` | Item `data-disabled` (same) |
-| (none) | Popup/Backdrop/ItemIndicator/ScrollArrows `data-starting-style` / `data-ending-style` (animation hooks) |
-| (none) | Positioner `data-anchor-hidden`, ScrollArrows `data-direction` / `data-visible` |
+| Radix                                         | Base UI                                                                                                 |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| Trigger `data-state="open" \| "closed"`       | Trigger `data-popup-open` (presence), plus `data-pressed`, `data-popup-side`                            |
+| Trigger `data-placeholder`                    | Trigger/Value `data-placeholder` (same)                                                                 |
+| Trigger `data-disabled`                       | Trigger `data-disabled` (same), plus `data-readonly`, `data-required`, Field attrs                      |
+| Content `data-state="open" \| "closed"`       | Positioner/Popup `data-open` / `data-closed` (presence)                                                 |
+| Content `data-side` (`left/right/bottom/top`) | Positioner/Popup `data-side` (`none/top/bottom/left/right/inline-start/inline-end`)                     |
+| Content `data-align`                          | Positioner/Popup `data-align` (same values)                                                             |
+| Item `data-state="checked" \| "unchecked"`    | Item `data-selected` (presence, no unchecked token)                                                     |
+| Item `data-highlighted`                       | Item `data-highlighted` (same)                                                                          |
+| Item `data-disabled`                          | Item `data-disabled` (same)                                                                             |
+| (none)                                        | Popup/Backdrop/ItemIndicator/ScrollArrows `data-starting-style` / `data-ending-style` (animation hooks) |
+| (none)                                        | Positioner `data-anchor-hidden`, ScrollArrows `data-direction` / `data-visible`                         |
 
 ## CSS variable mapping (select)
 
 All Base UI vars are set on `Select.Positioner` (Radix set them on Content, popper mode only):
 
-| Radix | Base UI |
-| --- | --- |
-| `--radix-select-trigger-width` | `--anchor-width` |
-| `--radix-select-trigger-height` | `--anchor-height` |
-| `--radix-select-content-available-width` | `--available-width` |
+| Radix                                     | Base UI              |
+| ----------------------------------------- | -------------------- |
+| `--radix-select-trigger-width`            | `--anchor-width`     |
+| `--radix-select-trigger-height`           | `--anchor-height`    |
+| `--radix-select-content-available-width`  | `--available-width`  |
 | `--radix-select-content-available-height` | `--available-height` |
 | `--radix-select-content-transform-origin` | `--transform-origin` |
 
@@ -188,22 +188,22 @@ Part mapping: `Root -> Root`, `Indicator -> Indicator`. Element change: Radix Ro
 
 ## Checkbox.Root → Checkbox.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | See global conventions, pair with `nativeButton` when rendering a `<button>`. |
-| `defaultChecked` | `boolean \| 'indeterminate'`, no default | `defaultChecked: boolean`, default `false` | Signature changed: `'indeterminate'` is no longer a checked value. Use the separate `indeterminate: boolean` prop. |
-| `checked` | `boolean \| 'indeterminate'`, no default | `checked: boolean` + `indeterminate: boolean` | Signature changed: split into two props. Radix `checked="indeterminate"` -> Base UI `indeterminate` (a checkbox can be indeterminate and unchecked/checked independently). |
+| Radix prop        | Type / default                                  | Base UI equivalent                                                                            | Migration note                                                                                                                                                                                       |
+| ----------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean`, `false`                              | `render`                                                                                      | See global conventions, pair with `nativeButton` when rendering a `<button>`.                                                                                                                        |
+| `defaultChecked`  | `boolean \| 'indeterminate'`, no default        | `defaultChecked: boolean`, default `false`                                                    | Signature changed: `'indeterminate'` is no longer a checked value. Use the separate `indeterminate: boolean` prop.                                                                                   |
+| `checked`         | `boolean \| 'indeterminate'`, no default        | `checked: boolean` + `indeterminate: boolean`                                                 | Signature changed: split into two props. Radix `checked="indeterminate"` -> Base UI `indeterminate` (a checkbox can be indeterminate and unchecked/checked independently).                           |
 | `onCheckedChange` | `(checked: boolean \| 'indeterminate') => void` | `onCheckedChange: (checked: boolean, eventDetails: Checkbox.Root.ChangeEventDetails) => void` | Signature changed: `checked` is always boolean, `eventDetails` added (`reason: 'none'`). Indeterminate transitions are managed by you via the `indeterminate` prop (or `parent` in a CheckboxGroup). |
-| `disabled` | `boolean`, no default | `disabled: boolean`, default `false` | Same. |
-| `required` | `boolean`, no default | `required: boolean`, default `false` | Same. |
-| `name` | `string`, no default | `name: string` | Same. |
-| `value` | `string`, default `"on"` | `value: string` | Same name. Radix documents the default as `"on"`; Base UI docs list no default but hidden-input submission matches native checkbox behavior (`"on"` when unset). |
+| `disabled`        | `boolean`, no default                           | `disabled: boolean`, default `false`                                                          | Same.                                                                                                                                                                                                |
+| `required`        | `boolean`, no default                           | `required: boolean`, default `false`                                                          | Same.                                                                                                                                                                                                |
+| `name`            | `string`, no default                            | `name: string`                                                                                | Same.                                                                                                                                                                                                |
+| `value`           | `string`, default `"on"`                        | `value: string`                                                                               | Same name. Radix documents the default as `"on"`; Base UI docs list no default but hidden-input submission matches native checkbox behavior (`"on"` when unset).                                     |
 
 ## Checkbox.Indicator → Checkbox.Indicator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
+| Radix prop   | Type / default        | Base UI equivalent                      | Migration note                                                                                                                     |
+| ------------ | --------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`    | `boolean`, `false`    | `render`                                | Same pattern.                                                                                                                      |
 | `forceMount` | `boolean`, no default | `keepMounted: boolean`, default `false` | Renamed. Both keep the element in the DOM when unchecked (for animation). Base UI also renders the indicator when `indeterminate`. |
 
 ## Base UI only props worth knowing (checkbox)
@@ -214,14 +214,14 @@ Part mapping: `Root -> Root`, `Indicator -> Indicator`. Element change: Radix Ro
 
 ## Data-attribute mapping (checkbox)
 
-| Radix | Base UI |
-| --- | --- |
-| `data-state="checked"` | `data-checked` |
-| `data-state="unchecked"` | `data-unchecked` |
-| `data-state="indeterminate"` | `data-indeterminate` |
-| `data-disabled` | `data-disabled` (same) |
-| (none) | `data-readonly`, `data-required`, `data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused` (Field integration) |
-| (none) | Indicator `data-starting-style` / `data-ending-style` |
+| Radix                        | Base UI                                                                                                                                         |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `data-state="checked"`       | `data-checked`                                                                                                                                  |
+| `data-state="unchecked"`     | `data-unchecked`                                                                                                                                |
+| `data-state="indeterminate"` | `data-indeterminate`                                                                                                                            |
+| `data-disabled`              | `data-disabled` (same)                                                                                                                          |
+| (none)                       | `data-readonly`, `data-required`, `data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused` (Field integration) |
+| (none)                       | Indicator `data-starting-style` / `data-ending-style`                                                                                           |
 
 No CSS variables on either side.
 
@@ -233,34 +233,34 @@ Part mapping: Radix ships one `RadioGroup` namespace; Base UI splits it into `Ra
 
 ## RadioGroup.Root → RadioGroup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| `defaultValue` | `string`, no default | `defaultValue: Value` | Same name, widened type (any value type). |
-| `value` | `string`, no default | `value: Value` | Same name, widened type. |
-| `onValueChange` | `(value: string) => void` | `onValueChange: (value: Value, eventDetails: RadioGroup.ChangeEventDetails) => void` | Signature changed: added `eventDetails` (`reason: 'none'`). |
-| `disabled` | `boolean`, no default | `disabled: boolean`, default `false` | Same. |
-| `name` | `string`, no default | `name: string` | Same. |
-| `required` | `boolean`, no default | `required: boolean`, default `false` | Same. |
-| `orientation` | `enum`, default `undefined` | dropped | Base UI arrow-key navigation handles both axes automatically; there is no orientation prop (set `aria-orientation` yourself if needed for AT). |
-| `dir` | `"ltr" \| "rtl"`, no default | dropped | Use `DirectionProvider`. |
-| `loop` | `boolean`, default `true` | dropped | Focus wrapping is built in and not configurable. |
+| Radix prop      | Type / default               | Base UI equivalent                                                                   | Migration note                                                                                                                                 |
+| --------------- | ---------------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`       | `boolean`, `false`           | `render`                                                                             | Same pattern.                                                                                                                                  |
+| `defaultValue`  | `string`, no default         | `defaultValue: Value`                                                                | Same name, widened type (any value type).                                                                                                      |
+| `value`         | `string`, no default         | `value: Value`                                                                       | Same name, widened type.                                                                                                                       |
+| `onValueChange` | `(value: string) => void`    | `onValueChange: (value: Value, eventDetails: RadioGroup.ChangeEventDetails) => void` | Signature changed: added `eventDetails` (`reason: 'none'`).                                                                                    |
+| `disabled`      | `boolean`, no default        | `disabled: boolean`, default `false`                                                 | Same.                                                                                                                                          |
+| `name`          | `string`, no default         | `name: string`                                                                       | Same.                                                                                                                                          |
+| `required`      | `boolean`, no default        | `required: boolean`, default `false`                                                 | Same.                                                                                                                                          |
+| `orientation`   | `enum`, default `undefined`  | dropped                                                                              | Base UI arrow-key navigation handles both axes automatically; there is no orientation prop (set `aria-orientation` yourself if needed for AT). |
+| `dir`           | `"ltr" \| "rtl"`, no default | dropped                                                                              | Use `DirectionProvider`.                                                                                                                       |
+| `loop`          | `boolean`, default `true`    | dropped                                                                              | Focus wrapping is built in and not configurable.                                                                                               |
 
 ## RadioGroup.Item → Radio.Root (moved to Radio namespace)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern, plus `nativeButton` (default `false`). |
-| `value` | `string`, required | `value: Value`, required | Same name, widened type. |
-| `disabled` | `boolean`, no default | `disabled: boolean` | Same. |
-| `required` | `boolean`, no default | `required: boolean` | Same. |
+| Radix prop | Type / default        | Base UI equivalent       | Migration note                                       |
+| ---------- | --------------------- | ------------------------ | ---------------------------------------------------- |
+| `asChild`  | `boolean`, `false`    | `render`                 | Same pattern, plus `nativeButton` (default `false`). |
+| `value`    | `string`, required    | `value: Value`, required | Same name, widened type.                             |
+| `disabled` | `boolean`, no default | `disabled: boolean`      | Same.                                                |
+| `required` | `boolean`, no default | `required: boolean`      | Same.                                                |
 
 ## RadioGroup.Indicator → Radio.Indicator (moved to Radio namespace)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| `forceMount` | `boolean`, no default | `keepMounted: boolean`, default `false` | Renamed. |
+| Radix prop   | Type / default        | Base UI equivalent                      | Migration note |
+| ------------ | --------------------- | --------------------------------------- | -------------- |
+| `asChild`    | `boolean`, `false`    | `render`                                | Same pattern.  |
+| `forceMount` | `boolean`, no default | `keepMounted: boolean`, default `false` | Renamed.       |
 
 ## Base UI only props worth knowing (radio-group)
 
@@ -269,14 +269,14 @@ Part mapping: Radix ships one `RadioGroup` namespace; Base UI splits it into `Ra
 
 ## Data-attribute mapping (radio-group)
 
-| Radix | Base UI |
-| --- | --- |
-| Root `data-disabled` | RadioGroup `data-disabled` (same) |
-| Item/Indicator `data-state="checked"` | Radio.Root/Indicator `data-checked` |
-| Item/Indicator `data-state="unchecked"` | Radio.Root/Indicator `data-unchecked` |
-| Item/Indicator `data-disabled` | `data-disabled` (same) |
-| (none) | `data-readonly`, `data-required`, Field attrs (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused`) |
-| (none) | Indicator `data-starting-style` / `data-ending-style` |
+| Radix                                   | Base UI                                                                                                                                   |
+| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| Root `data-disabled`                    | RadioGroup `data-disabled` (same)                                                                                                         |
+| Item/Indicator `data-state="checked"`   | Radio.Root/Indicator `data-checked`                                                                                                       |
+| Item/Indicator `data-state="unchecked"` | Radio.Root/Indicator `data-unchecked`                                                                                                     |
+| Item/Indicator `data-disabled`          | `data-disabled` (same)                                                                                                                    |
+| (none)                                  | `data-readonly`, `data-required`, Field attrs (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused`) |
+| (none)                                  | Indicator `data-starting-style` / `data-ending-style`                                                                                     |
 
 No CSS variables on either side.
 
@@ -288,22 +288,22 @@ Part mapping: `Root -> Root`, `Thumb -> Thumb`. Element change: Radix Root rende
 
 ## Switch.Root → Switch.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern, pair with `nativeButton`. |
-| `defaultChecked` | `boolean`, no default | `defaultChecked: boolean`, default `false` | Same. |
-| `checked` | `boolean`, no default | `checked: boolean` | Same. |
-| `onCheckedChange` | `(checked: boolean) => void` | `onCheckedChange: (checked: boolean, eventDetails: Switch.Root.ChangeEventDetails) => void` | Signature changed: added `eventDetails` (`reason: 'none'`). |
-| `disabled` | `boolean`, no default | `disabled: boolean`, default `false` | Same. |
-| `required` | `boolean`, no default | `required: boolean`, default `false` | Same. |
-| `name` | `string`, no default | `name: string` | Same. |
-| `value` | `string`, default `"on"` | `value: string` | Same name. Base UI submits `"on"` by default, matching native checkbox behavior. |
+| Radix prop        | Type / default               | Base UI equivalent                                                                          | Migration note                                                                   |
+| ----------------- | ---------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `asChild`         | `boolean`, `false`           | `render`                                                                                    | Same pattern, pair with `nativeButton`.                                          |
+| `defaultChecked`  | `boolean`, no default        | `defaultChecked: boolean`, default `false`                                                  | Same.                                                                            |
+| `checked`         | `boolean`, no default        | `checked: boolean`                                                                          | Same.                                                                            |
+| `onCheckedChange` | `(checked: boolean) => void` | `onCheckedChange: (checked: boolean, eventDetails: Switch.Root.ChangeEventDetails) => void` | Signature changed: added `eventDetails` (`reason: 'none'`).                      |
+| `disabled`        | `boolean`, no default        | `disabled: boolean`, default `false`                                                        | Same.                                                                            |
+| `required`        | `boolean`, no default        | `required: boolean`, default `false`                                                        | Same.                                                                            |
+| `name`            | `string`, no default         | `name: string`                                                                              | Same.                                                                            |
+| `value`           | `string`, default `"on"`     | `value: string`                                                                             | Same name. Base UI submits `"on"` by default, matching native checkbox behavior. |
 
 ## Switch.Thumb → Switch.Thumb
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern, only prop on either side. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                          |
+| ---------- | ------------------ | ------------------ | --------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Same pattern, only prop on either side. |
 
 ## Base UI only props worth knowing (switch)
 
@@ -311,12 +311,12 @@ Part mapping: `Root -> Root`, `Thumb -> Thumb`. Element change: Radix Root rende
 
 ## Data-attribute mapping (switch)
 
-| Radix | Base UI |
-| --- | --- |
-| Root/Thumb `data-state="checked"` | `data-checked` |
-| Root/Thumb `data-state="unchecked"` | `data-unchecked` |
-| Root/Thumb `data-disabled` | `data-disabled` (same) |
-| (none) | `data-readonly`, `data-required`, Field attrs (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused`) |
+| Radix                               | Base UI                                                                                                                                   |
+| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| Root/Thumb `data-state="checked"`   | `data-checked`                                                                                                                            |
+| Root/Thumb `data-state="unchecked"` | `data-unchecked`                                                                                                                          |
+| Root/Thumb `data-disabled`          | `data-disabled` (same)                                                                                                                    |
+| (none)                              | `data-readonly`, `data-required`, Field attrs (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-filled`, `data-focused`) |
 
 No CSS variables on either side.
 
@@ -328,42 +328,42 @@ Part mapping: `Root -> Root`, `Track -> Track`, `Range -> Indicator` (renamed),
 
 ## Slider.Root → Slider.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| `defaultValue` | `number[]`, no default | `defaultValue: number \| number[]` | Same name, widened: a single `number` gives a single-thumb slider (no array wrapper needed). |
-| `value` | `number[]`, no default | `value: number \| number[]` | Same, widened. Ranged sliders still take an array. |
-| `onValueChange` | `(value: number[]) => void` | `onValueChange: (value: number \| number[], eventDetails: Slider.Root.ChangeEventDetails) => void` | Signature changed: value matches the shape you pass in (number for single), `eventDetails` added with `reason: 'input-change' \| 'track-press' \| 'drag' \| 'keyboard' \| 'none'` and `activeThumbIndex: number`. |
-| `onValueCommit` | `(value: number[]) => void` | `onValueCommitted: (value: number \| number[], eventDetails: Slider.Root.CommitEventDetails) => void` | Renamed (`Commit` -> `Committed`) and signature changed (same shape/eventDetails notes as above). Base UI does not fire it if the value did not change. |
-| `name` | `string`, no default | `name: string` | Same. |
-| `disabled` | `boolean`, default `false` | `disabled: boolean`, default `false` | Same. |
-| `orientation` | `"horizontal" \| "vertical"`, default `"horizontal"` | `orientation: Orientation`, default `'horizontal'` | Same. |
-| `dir` | `"ltr" \| "rtl"`, no default | dropped | Use `DirectionProvider`. |
-| `inverted` | `boolean`, default `false` | dropped (workaround) | No equivalent. For horizontal sliders, wrap in `DirectionProvider dir="rtl"` (direction-based inversion); there is no built-in way to invert a vertical slider. |
-| `min` | `number`, default `0` | `min: number`, default `0` | Same. |
-| `max` | `number`, default `100` | `max: number`, default `100` | Same. |
-| `step` | `number`, default `1` | `step: number`, default `1` | Same. |
-| `minStepsBetweenThumbs` | `number`, default `0` | `minStepsBetweenValues: number`, default `0` | Renamed (`Thumbs` -> `Values`). |
-| `form` | `string`, no default | `form: string` | Same. |
+| Radix prop              | Type / default                                       | Base UI equivalent                                                                                    | Migration note                                                                                                                                                                                                    |
+| ----------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`               | `boolean`, `false`                                   | `render`                                                                                              | Same pattern.                                                                                                                                                                                                     |
+| `defaultValue`          | `number[]`, no default                               | `defaultValue: number \| number[]`                                                                    | Same name, widened: a single `number` gives a single-thumb slider (no array wrapper needed).                                                                                                                      |
+| `value`                 | `number[]`, no default                               | `value: number \| number[]`                                                                           | Same, widened. Ranged sliders still take an array.                                                                                                                                                                |
+| `onValueChange`         | `(value: number[]) => void`                          | `onValueChange: (value: number \| number[], eventDetails: Slider.Root.ChangeEventDetails) => void`    | Signature changed: value matches the shape you pass in (number for single), `eventDetails` added with `reason: 'input-change' \| 'track-press' \| 'drag' \| 'keyboard' \| 'none'` and `activeThumbIndex: number`. |
+| `onValueCommit`         | `(value: number[]) => void`                          | `onValueCommitted: (value: number \| number[], eventDetails: Slider.Root.CommitEventDetails) => void` | Renamed (`Commit` -> `Committed`) and signature changed (same shape/eventDetails notes as above). Base UI does not fire it if the value did not change.                                                           |
+| `name`                  | `string`, no default                                 | `name: string`                                                                                        | Same.                                                                                                                                                                                                             |
+| `disabled`              | `boolean`, default `false`                           | `disabled: boolean`, default `false`                                                                  | Same.                                                                                                                                                                                                             |
+| `orientation`           | `"horizontal" \| "vertical"`, default `"horizontal"` | `orientation: Orientation`, default `'horizontal'`                                                    | Same.                                                                                                                                                                                                             |
+| `dir`                   | `"ltr" \| "rtl"`, no default                         | dropped                                                                                               | Use `DirectionProvider`.                                                                                                                                                                                          |
+| `inverted`              | `boolean`, default `false`                           | dropped (workaround)                                                                                  | No equivalent. For horizontal sliders, wrap in `DirectionProvider dir="rtl"` (direction-based inversion); there is no built-in way to invert a vertical slider.                                                   |
+| `min`                   | `number`, default `0`                                | `min: number`, default `0`                                                                            | Same.                                                                                                                                                                                                             |
+| `max`                   | `number`, default `100`                              | `max: number`, default `100`                                                                          | Same.                                                                                                                                                                                                             |
+| `step`                  | `number`, default `1`                                | `step: number`, default `1`                                                                           | Same.                                                                                                                                                                                                             |
+| `minStepsBetweenThumbs` | `number`, default `0`                                | `minStepsBetweenValues: number`, default `0`                                                          | Renamed (`Thumbs` -> `Values`).                                                                                                                                                                                   |
+| `form`                  | `string`, no default                                 | `form: string`                                                                                        | Same.                                                                                                                                                                                                             |
 
 ## Slider.Track → Slider.Track (moved inside Control)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. Structural move: Track must now be nested in the new `Slider.Control` part, and `Thumb` moves inside `Track` (Radix had Thumb as a sibling of Track under Root). |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                                                                                                                 |
+| ---------- | ------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean`, `false` | `render`           | Same pattern. Structural move: Track must now be nested in the new `Slider.Control` part, and `Thumb` moves inside `Track` (Radix had Thumb as a sibling of Track under Root). |
 
 ## Slider.Range → Slider.Indicator (renamed)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Renamed part, same role (visualizes the filled portion), still a child of Track. |
+| Radix prop | Type / default     | Base UI equivalent | Migration note                                                                   |
+| ---------- | ------------------ | ------------------ | -------------------------------------------------------------------------------- |
+| `asChild`  | `boolean`, `false` | `render`           | Renamed part, same role (visualizes the filled portion), still a child of Track. |
 
 ## Slider.Thumb → Slider.Thumb
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean`, `false` | `render` | Same pattern. |
-| (per-thumb accessibility via aria props) | - | `index: number`, `getAriaLabel(index)`, `getAriaValueText(formattedValue, value, index)`, `aria-valuetext` | Base UI thumbs take `index` (required for SSR of multi-thumb range sliders) and a11y formatters. Also `disabled`, `inputRef`, `tabIndex`, `onFocus`/`onBlur`/`onKeyDown` forwarded to the nested `<input type="range">`. |
+| Radix prop                               | Type / default     | Base UI equivalent                                                                                         | Migration note                                                                                                                                                                                                           |
+| ---------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`                                | `boolean`, `false` | `render`                                                                                                   | Same pattern.                                                                                                                                                                                                            |
+| (per-thumb accessibility via aria props) | -                  | `index: number`, `getAriaLabel(index)`, `getAriaValueText(formattedValue, value, index)`, `aria-valuetext` | Base UI thumbs take `index` (required for SSR of multi-thumb range sliders) and a11y formatters. Also `disabled`, `inputRef`, `tabIndex`, `onFocus`/`onBlur`/`onKeyDown` forwarded to the nested `<input type="range">`. |
 
 ## (new part) Slider.Control
 
@@ -379,12 +379,12 @@ No Radix equivalent. The interactive surface that receives pointer events; wrap
 
 ## Data-attribute mapping (slider)
 
-| Radix | Base UI |
-| --- | --- |
-| `data-disabled` (all parts) | `data-disabled` (same, all parts) |
-| `data-orientation` (`horizontal/vertical`, all parts) | `data-orientation` (same values, all parts) |
-| (none) | `data-dragging` (present on all parts while dragging) |
-| (none) | Thumb `data-index` (thumb index in range sliders) |
-| (none) | Field attrs on all parts (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-focused`) |
+| Radix                                                 | Base UI                                                                                               |
+| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `data-disabled` (all parts)                           | `data-disabled` (same, all parts)                                                                     |
+| `data-orientation` (`horizontal/vertical`, all parts) | `data-orientation` (same values, all parts)                                                           |
+| (none)                                                | `data-dragging` (present on all parts while dragging)                                                 |
+| (none)                                                | Thumb `data-index` (thumb index in range sliders)                                                     |
+| (none)                                                | Field attrs on all parts (`data-valid`, `data-invalid`, `data-dirty`, `data-touched`, `data-focused`) |
 
 No CSS variables on either side (Radix slider positions thumbs via inline styles; Base UI does the same).
diff --git a/.agents/skills/migrate-radix-to-base/menus.md b/.agents/skills/migrate-radix-to-base/menus.md
index 128e13d..151418c 100644
--- a/.agents/skills/migrate-radix-to-base/menus.md
+++ b/.agents/skills/migrate-radix-to-base/menus.md
@@ -6,15 +6,15 @@ Part-mapping ground truth (from our wrappers): `Content` → `Portal > Positione
 
 Cross-cutting rules (apply to every part below):
 
-| Radix pattern | Base UI equivalent |
-| --- | --- |
-| `asChild` (`boolean`, `false`) | `render` (`ReactElement \| ((props: HTMLProps, state) => ReactElement)`). No merge-onto-child boolean; pass the element or a function. |
-| `dir` (`"ltr" \| "rtl"`) on roots | Dropped everywhere. Base UI reads direction from `<DirectionProvider>` (`@base-ui-components/react/direction-provider`) or the DOM `dir` attribute. |
-| `forceMount` (`boolean`) | `keepMounted` (`boolean`, `false`) on `Portal` / indicator parts. Same use case (animation/SEO), presence is CSS-driven via `data-starting-style` / `data-ending-style` instead of Radix `data-state` + forced mount. |
+| Radix pattern                                                                                       | Base UI equivalent                                                                                                                                                                                                                                                |
+| --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild` (`boolean`, `false`)                                                                      | `render` (`ReactElement \| ((props: HTMLProps, state) => ReactElement)`). No merge-onto-child boolean; pass the element or a function.                                                                                                                            |
+| `dir` (`"ltr" \| "rtl"`) on roots                                                                   | Dropped everywhere. Base UI reads direction from `<DirectionProvider>` (`@base-ui-components/react/direction-provider`) or the DOM `dir` attribute.                                                                                                               |
+| `forceMount` (`boolean`)                                                                            | `keepMounted` (`boolean`, `false`) on `Portal` / indicator parts. Same use case (animation/SEO), presence is CSS-driven via `data-starting-style` / `data-ending-style` instead of Radix `data-state` + forced mount.                                             |
 | `onEscapeKeyDown` / `onPointerDownOutside` / `onFocusOutside` / `onInteractOutside` (content parts) | Dropped as separate props. Use `onOpenChange(open, eventDetails)` on the Root and branch on `eventDetails.reason` (`'escape-key'`, `'outside-press'`, `'focus-out'`, ...). Call `eventDetails.cancel()` to prevent the close (replaces `event.preventDefault()`). |
-| `onSelect` on items (`(event: Event) => void`; `event.preventDefault()` keeps menu open) | `onClick` (`(event: BaseUIEvent<React.MouseEvent<HTMLDivElement>>) => void`) plus `closeOnClick` (`boolean`) to control whether the menu closes. |
-| `textValue` on items (`string`, typeahead) | `label` (`string`). |
-| Controlled callbacks `(value) => void` | All Base UI change callbacks take a second `eventDetails` argument (`{ reason, event, cancel(), allowPropagation(), isCanceled, isPropagationAllowed, trigger }`). |
+| `onSelect` on items (`(event: Event) => void`; `event.preventDefault()` keeps menu open)            | `onClick` (`(event: BaseUIEvent<React.MouseEvent<HTMLDivElement>>) => void`) plus `closeOnClick` (`boolean`) to control whether the menu closes.                                                                                                                  |
+| `textValue` on items (`string`, typeahead)                                                          | `label` (`string`).                                                                                                                                                                                                                                               |
+| Controlled callbacks `(value) => void`                                                              | All Base UI change callbacks take a second `eventDetails` argument (`{ reason, event, cancel(), allowPropagation(), isCanceled, isPropagationAllowed, trigger }`).                                                                                                |
 
 ---
 
@@ -22,136 +22,136 @@ Cross-cutting rules (apply to every part below):
 
 ## Root → Menu.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / – | `defaultOpen` (`boolean`, `false`) | Same. |
-| `open` | `boolean` / – | `open` (`boolean`) | Same. |
-| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Menu.Root.ChangeEventDetails) => void`. `eventDetails.reason` is one of `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'focus-out' \| 'list-navigation' \| 'escape-key' \| 'item-press' \| 'close-press' \| 'sibling-open' \| 'cancel-open' \| 'imperative-action' \| 'none'`; `eventDetails.cancel()` blocks the state change. |
-| `modal` | `boolean` / `true` | `modal` (`boolean`, `true`) | Same. |
-| `dir` | `"ltr" \| "rtl"` / – | – | Dropped. Use `DirectionProvider`. |
+| Radix prop     | Type / default                | Base UI equivalent                 | Migration note                                                                                                                                                                                                                                                                                                                                                                                                  |
+| -------------- | ----------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / –                 | `defaultOpen` (`boolean`, `false`) | Same.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `open`         | `boolean` / –                 | `open` (`boolean`)                 | Same.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange`                     | Signature changed: `(open: boolean, eventDetails: Menu.Root.ChangeEventDetails) => void`. `eventDetails.reason` is one of `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'focus-out' \| 'list-navigation' \| 'escape-key' \| 'item-press' \| 'close-press' \| 'sibling-open' \| 'cancel-open' \| 'imperative-action' \| 'none'`; `eventDetails.cancel()` blocks the state change. |
+| `modal`        | `boolean` / `true`            | `modal` (`boolean`, `true`)        | Same.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `dir`          | `"ltr" \| "rtl"` / –          | –                                  | Dropped. Use `DirectionProvider`.                                                                                                                                                                                                                                                                                                                                                                               |
 
 ## Trigger → Menu.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | See cross-cutting rules. When rendering a non-button, also set `nativeButton={false}`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                         |
+| ---------- | ------------------- | ------------------ | -------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | See cross-cutting rules. When rendering a non-button, also set `nativeButton={false}`. |
 
 ## Portal → Menu.Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / – | `keepMounted` (`boolean`, `false`) | Renamed; keeps portal in DOM while hidden. |
-| `container` | `HTMLElement` / `document.body` | `container` (`HTMLElement \| ShadowRoot \| React.RefObject<HTMLElement \| ShadowRoot \| null> \| null`) | Same, wider type (accepts refs and ShadowRoot). |
+| Radix prop   | Type / default                  | Base UI equivalent                                                                                      | Migration note                                  |
+| ------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| `forceMount` | `boolean` / –                   | `keepMounted` (`boolean`, `false`)                                                                      | Renamed; keeps portal in DOM while hidden.      |
+| `container`  | `HTMLElement` / `document.body` | `container` (`HTMLElement \| ShadowRoot \| React.RefObject<HTMLElement \| ShadowRoot \| null> \| null`) | Same, wider type (accepts refs and ShadowRoot). |
 
 ## Content → Menu.Portal > Menu.Positioner > Menu.Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` on `Popup` | See cross-cutting rules. |
-| `loop` | `boolean` / `false` | `loopFocus` on **Root** (`boolean`, `true`) | Moved + renamed. Default flips: Base UI loops by default. |
-| `onCloseAutoFocus` | `(event: Event) => void` / – | `finalFocus` on **Popup** | Signature changed: `boolean \| React.RefObject<HTMLElement \| null> \| ((closeType: InteractionType) => boolean \| void \| HTMLElement \| null)` where `InteractionType = 'mouse' \| 'touch' \| 'pen' \| 'keyboard'`. Return `false` to replicate `event.preventDefault()`; return an element to redirect focus. |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / – | – | Dropped → `onOpenChange` with `reason === 'escape-key'`. |
-| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / – | – | Dropped → `onOpenChange` with `reason === 'outside-press'`. |
-| `onFocusOutside` | `(event: FocusOutsideEvent) => void` / – | – | Dropped → `onOpenChange` with `reason === 'focus-out'`. |
-| `onInteractOutside` | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / – | – | Dropped → `onOpenChange` with `reason === 'outside-press' \|\| 'focus-out'`. |
-| `forceMount` | `boolean` / – | `keepMounted` on **Portal** | Moved; animate with `data-starting-style`/`data-ending-style`. |
-| `side` | `"top" \| "right" \| "bottom" \| "left"` / `"bottom"` | `side` on **Positioner** (`Side`, `'bottom'`) | Moved. Base adds logical values: `Side = 'top' \| 'bottom' \| 'left' \| 'right' \| 'inline-end' \| 'inline-start'`. |
-| `sideOffset` | `number` / `0` | `sideOffset` on **Positioner** (`number \| OffsetFunction`, `0`) | Moved; also accepts `(data: { side, align, anchor: {width,height}, positioner: {width,height} }) => number`. |
-| `align` | `"start" \| "center" \| "end"` / `"center"` | `align` on **Positioner** (`Align`, `'center'`) | Moved, same values/default. |
-| `alignOffset` | `number` / `0` | `alignOffset` on **Positioner** (`number \| OffsetFunction`, `0`) | Moved; also accepts function form. |
-| `avoidCollisions` | `boolean` / `true` | `collisionAvoidance` on **Positioner** (`CollisionAvoidance`) | Signature changed: object `{ side?: 'flip' \| 'shift' \| 'none'; align?: 'flip' \| 'shift' \| 'none'; fallbackAxisSide?: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` → `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`. |
-| `collisionBoundary` | `Element \| null \| Array<Element \| null>` / `[]` | `collisionBoundary` on **Positioner** (`Boundary`, `'clipping-ancestors'`) | Default changes: Radix `[]` means viewport/clipping ancestors; Base default `'clipping-ancestors'` is equivalent. Also accepts an element or rect. |
-| `collisionPadding` | `number \| Padding` / `0` | `collisionPadding` on **Positioner** (`Padding`, `5`) | Same shape; default changes 0 → 5. |
-| `arrowPadding` | `number` / `0` | `arrowPadding` on **Positioner** (`number`, `5`) | Same; default changes 0 → 5. |
-| `sticky` | `"partial" \| "always"` / `"partial"` | – (see note) | Different concept. Radix `sticky` controls align-axis sticking; closest Base knob is `collisionAvoidance.align` (`'shift'` ≈ partial). Base UI's own `sticky` (`boolean`, `false`) instead keeps the popup in the viewport after the anchor scrolls away, which has no Radix equivalent. |
-| `hideWhenDetached` | `boolean` / `false` | – | Dropped as behavior prop. Base always exposes `data-anchor-hidden` on Positioner/Popup; hide via CSS: `[data-anchor-hidden] { visibility: hidden }`. |
+| Radix prop             | Type / default                                                      | Base UI equivalent                                                         | Migration note                                                                                                                                                                                                                                                                                                   |
+| ---------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean` / `false`                                                 | `render` on `Popup`                                                        | See cross-cutting rules.                                                                                                                                                                                                                                                                                         |
+| `loop`                 | `boolean` / `false`                                                 | `loopFocus` on **Root** (`boolean`, `true`)                                | Moved + renamed. Default flips: Base UI loops by default.                                                                                                                                                                                                                                                        |
+| `onCloseAutoFocus`     | `(event: Event) => void` / –                                        | `finalFocus` on **Popup**                                                  | Signature changed: `boolean \| React.RefObject<HTMLElement \| null> \| ((closeType: InteractionType) => boolean \| void \| HTMLElement \| null)` where `InteractionType = 'mouse' \| 'touch' \| 'pen' \| 'keyboard'`. Return `false` to replicate `event.preventDefault()`; return an element to redirect focus. |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void` / –                                | –                                                                          | Dropped → `onOpenChange` with `reason === 'escape-key'`.                                                                                                                                                                                                                                                         |
+| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / –                      | –                                                                          | Dropped → `onOpenChange` with `reason === 'outside-press'`.                                                                                                                                                                                                                                                      |
+| `onFocusOutside`       | `(event: FocusOutsideEvent) => void` / –                            | –                                                                          | Dropped → `onOpenChange` with `reason === 'focus-out'`.                                                                                                                                                                                                                                                          |
+| `onInteractOutside`    | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / – | –                                                                          | Dropped → `onOpenChange` with `reason === 'outside-press' \|\| 'focus-out'`.                                                                                                                                                                                                                                     |
+| `forceMount`           | `boolean` / –                                                       | `keepMounted` on **Portal**                                                | Moved; animate with `data-starting-style`/`data-ending-style`.                                                                                                                                                                                                                                                   |
+| `side`                 | `"top" \| "right" \| "bottom" \| "left"` / `"bottom"`               | `side` on **Positioner** (`Side`, `'bottom'`)                              | Moved. Base adds logical values: `Side = 'top' \| 'bottom' \| 'left' \| 'right' \| 'inline-end' \| 'inline-start'`.                                                                                                                                                                                              |
+| `sideOffset`           | `number` / `0`                                                      | `sideOffset` on **Positioner** (`number \| OffsetFunction`, `0`)           | Moved; also accepts `(data: { side, align, anchor: {width,height}, positioner: {width,height} }) => number`.                                                                                                                                                                                                     |
+| `align`                | `"start" \| "center" \| "end"` / `"center"`                         | `align` on **Positioner** (`Align`, `'center'`)                            | Moved, same values/default.                                                                                                                                                                                                                                                                                      |
+| `alignOffset`          | `number` / `0`                                                      | `alignOffset` on **Positioner** (`number \| OffsetFunction`, `0`)          | Moved; also accepts function form.                                                                                                                                                                                                                                                                               |
+| `avoidCollisions`      | `boolean` / `true`                                                  | `collisionAvoidance` on **Positioner** (`CollisionAvoidance`)              | Signature changed: object `{ side?: 'flip' \| 'shift' \| 'none'; align?: 'flip' \| 'shift' \| 'none'; fallbackAxisSide?: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` → `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`.                                            |
+| `collisionBoundary`    | `Element \| null \| Array<Element \| null>` / `[]`                  | `collisionBoundary` on **Positioner** (`Boundary`, `'clipping-ancestors'`) | Default changes: Radix `[]` means viewport/clipping ancestors; Base default `'clipping-ancestors'` is equivalent. Also accepts an element or rect.                                                                                                                                                               |
+| `collisionPadding`     | `number \| Padding` / `0`                                           | `collisionPadding` on **Positioner** (`Padding`, `5`)                      | Same shape; default changes 0 → 5.                                                                                                                                                                                                                                                                               |
+| `arrowPadding`         | `number` / `0`                                                      | `arrowPadding` on **Positioner** (`number`, `5`)                           | Same; default changes 0 → 5.                                                                                                                                                                                                                                                                                     |
+| `sticky`               | `"partial" \| "always"` / `"partial"`                               | – (see note)                                                               | Different concept. Radix `sticky` controls align-axis sticking; closest Base knob is `collisionAvoidance.align` (`'shift'` ≈ partial). Base UI's own `sticky` (`boolean`, `false`) instead keeps the popup in the viewport after the anchor scrolls away, which has no Radix equivalent.                         |
+| `hideWhenDetached`     | `boolean` / `false`                                                 | –                                                                          | Dropped as behavior prop. Base always exposes `data-anchor-hidden` on Positioner/Popup; hide via CSS: `[data-anchor-hidden] { visibility: hidden }`.                                                                                                                                                             |
 
 ## Arrow → Menu.Arrow
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base Arrow renders a `<div>` you fill with an SVG (Radix renders the svg itself). Place inside `Popup`. |
-| `width` | `number` / `10` | – | Dropped; size the child SVG/element with CSS. |
-| `height` | `number` / `5` | – | Dropped; size with CSS. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                          |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base Arrow renders a `<div>` you fill with an SVG (Radix renders the svg itself). Place inside `Popup`. |
+| `width`    | `number` / `10`     | –                  | Dropped; size the child SVG/element with CSS.                                                           |
+| `height`   | `number` / `5`      | –                  | Dropped; size with CSS.                                                                                 |
 
 ## Item → Menu.Item
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | For links use `Menu.LinkItem` (renders `<a>`) instead of `render`. |
-| `disabled` | `boolean` / – | `disabled` (`boolean`, `false`) | Same. |
-| `onSelect` | `(event: Event) => void` / – | `onClick` (`(event: BaseUIEvent<React.MouseEvent<HTMLDivElement>>) => void`) | Renamed + signature changed. `event.preventDefault()` in `onSelect` (keep open) → `closeOnClick={false}` (`boolean`, default `true` on Item). |
-| `textValue` | `string` / – | `label` (`string`) | Renamed. |
+| Radix prop  | Type / default               | Base UI equivalent                                                           | Migration note                                                                                                                                |
+| ----------- | ---------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`   | `boolean` / `false`          | `render`                                                                     | For links use `Menu.LinkItem` (renders `<a>`) instead of `render`.                                                                            |
+| `disabled`  | `boolean` / –                | `disabled` (`boolean`, `false`)                                              | Same.                                                                                                                                         |
+| `onSelect`  | `(event: Event) => void` / – | `onClick` (`(event: BaseUIEvent<React.MouseEvent<HTMLDivElement>>) => void`) | Renamed + signature changed. `event.preventDefault()` in `onSelect` (keep open) → `closeOnClick={false}` (`boolean`, default `true` on Item). |
+| `textValue` | `string` / –                 | `label` (`string`)                                                           | Renamed.                                                                                                                                      |
 
 ## Group → Menu.Group
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same otherwise. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note  |
+| ---------- | ------------------- | ------------------ | --------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Same otherwise. |
 
 ## Label → Menu.GroupLabel
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Part renamed. Base GroupLabel must be inside a `Group` (it wires `aria-labelledby`); Radix Label could float freely. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                       |
+| ---------- | ------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Part renamed. Base GroupLabel must be inside a `Group` (it wires `aria-labelledby`); Radix Label could float freely. |
 
 ## CheckboxItem → Menu.CheckboxItem
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | – |
-| `checked` | `boolean \| 'indeterminate'` / – | `checked` (`boolean`) | `'indeterminate'` dropped. Base adds `defaultChecked` (`boolean`, `false`) for uncontrolled use. |
-| `onCheckedChange` | `(checked: boolean) => void` / – | `onCheckedChange` | Signature changed: `(checked: boolean, eventDetails: Menu.CheckboxItem.ChangeEventDetails) => void`. |
-| `disabled` | `boolean` / – | `disabled` (`boolean`, `false`) | Same. |
-| `onSelect` | `(event: Event) => void` / – | `onClick` + `closeOnClick` | Behavior default flips: Radix closes on select (unless prevented); Base `closeOnClick` defaults to `false` on CheckboxItem. Set `closeOnClick` explicitly to preserve Radix behavior. |
-| `textValue` | `string` / – | `label` | Renamed. |
+| Radix prop        | Type / default                   | Base UI equivalent              | Migration note                                                                                                                                                                        |
+| ----------------- | -------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`         | `boolean` / `false`              | `render`                        | –                                                                                                                                                                                     |
+| `checked`         | `boolean \| 'indeterminate'` / – | `checked` (`boolean`)           | `'indeterminate'` dropped. Base adds `defaultChecked` (`boolean`, `false`) for uncontrolled use.                                                                                      |
+| `onCheckedChange` | `(checked: boolean) => void` / – | `onCheckedChange`               | Signature changed: `(checked: boolean, eventDetails: Menu.CheckboxItem.ChangeEventDetails) => void`.                                                                                  |
+| `disabled`        | `boolean` / –                    | `disabled` (`boolean`, `false`) | Same.                                                                                                                                                                                 |
+| `onSelect`        | `(event: Event) => void` / –     | `onClick` + `closeOnClick`      | Behavior default flips: Radix closes on select (unless prevented); Base `closeOnClick` defaults to `false` on CheckboxItem. Set `closeOnClick` explicitly to preserve Radix behavior. |
+| `textValue`       | `string` / –                     | `label`                         | Renamed.                                                                                                                                                                              |
 
 ## RadioGroup → Menu.RadioGroup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | – |
-| `value` | `string` / – | `value` (`any`) | Type widens to `any`. Base adds `defaultValue` (`any`) and `disabled` (`boolean`, `false`). |
-| `onValueChange` | `(value: string) => void` / – | `onValueChange` | Signature changed: `(value: any, eventDetails: Menu.RadioGroup.ChangeEventDetails) => void`. |
+| Radix prop      | Type / default                | Base UI equivalent | Migration note                                                                               |
+| --------------- | ----------------------------- | ------------------ | -------------------------------------------------------------------------------------------- |
+| `asChild`       | `boolean` / `false`           | `render`           | –                                                                                            |
+| `value`         | `string` / –                  | `value` (`any`)    | Type widens to `any`. Base adds `defaultValue` (`any`) and `disabled` (`boolean`, `false`).  |
+| `onValueChange` | `(value: string) => void` / – | `onValueChange`    | Signature changed: `(value: any, eventDetails: Menu.RadioGroup.ChangeEventDetails) => void`. |
 
 ## RadioItem → Menu.RadioItem
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | – |
-| `value`* | `string` / – | `value`* (`any`) | Same (required); type widens. |
-| `disabled` | `boolean` / – | `disabled` (`boolean`, `false`) | Same. |
-| `onSelect` | `(event: Event) => void` / – | `onClick` + `closeOnClick` | `closeOnClick` defaults to `false` on RadioItem (Radix closed by default). |
-| `textValue` | `string` / – | `label` | Renamed. |
+| Radix prop  | Type / default               | Base UI equivalent              | Migration note                                                             |
+| ----------- | ---------------------------- | ------------------------------- | -------------------------------------------------------------------------- |
+| `asChild`   | `boolean` / `false`          | `render`                        | –                                                                          |
+| `value`*    | `string` / –                 | `value`* (`any`)                | Same (required); type widens.                                              |
+| `disabled`  | `boolean` / –                | `disabled` (`boolean`, `false`) | Same.                                                                      |
+| `onSelect`  | `(event: Event) => void` / – | `onClick` + `closeOnClick`      | `closeOnClick` defaults to `false` on RadioItem (Radix closed by default). |
+| `textValue` | `string` / –                 | `label`                         | Renamed.                                                                   |
 
 ## ItemIndicator → Menu.CheckboxItemIndicator / Menu.RadioItemIndicator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Part splits: use the indicator matching the parent item type. Renders `<span>`. |
-| `forceMount` | `boolean` / – | `keepMounted` (`boolean`, `false`) | Renamed. |
+| Radix prop   | Type / default      | Base UI equivalent                 | Migration note                                                                  |
+| ------------ | ------------------- | ---------------------------------- | ------------------------------------------------------------------------------- |
+| `asChild`    | `boolean` / `false` | `render`                           | Part splits: use the indicator matching the parent item type. Renders `<span>`. |
+| `forceMount` | `boolean` / –       | `keepMounted` (`boolean`, `false`) | Renamed.                                                                        |
 
 ## Separator → Menu.Separator
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base adds `orientation` (`'horizontal' \| 'vertical'`, `'horizontal'`). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                          |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base adds `orientation` (`'horizontal' \| 'vertical'`, `'horizontal'`). |
 
 ## Sub → Menu.SubmenuRoot
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / – | `defaultOpen` (`boolean`, `false`) | Same. |
-| `open` | `boolean` / – | `open` (`boolean`) | Same. |
-| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Menu.SubmenuRoot.ChangeEventDetails) => void` (same reason union as Root). |
+| Radix prop     | Type / default                | Base UI equivalent                 | Migration note                                                                                                               |
+| -------------- | ----------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / –                 | `defaultOpen` (`boolean`, `false`) | Same.                                                                                                                        |
+| `open`         | `boolean` / –                 | `open` (`boolean`)                 | Same.                                                                                                                        |
+| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange`                     | Signature changed: `(open: boolean, eventDetails: Menu.SubmenuRoot.ChangeEventDetails) => void` (same reason union as Root). |
 
 ## SubTrigger → Menu.SubmenuTrigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Renders `<div>`; `nativeButton` defaults `false` here. |
-| `disabled` | `boolean` / – | `disabled` (`boolean`, `false`) | Same. |
-| `textValue` | `string` / – | `label` | Renamed. Base adds `openOnHover` / `delay` (`100`) / `closeDelay` (`0`) and `onClick`. |
+| Radix prop  | Type / default      | Base UI equivalent              | Migration note                                                                         |
+| ----------- | ------------------- | ------------------------------- | -------------------------------------------------------------------------------------- |
+| `asChild`   | `boolean` / `false` | `render`                        | Renders `<div>`; `nativeButton` defaults `false` here.                                 |
+| `disabled`  | `boolean` / –       | `disabled` (`boolean`, `false`) | Same.                                                                                  |
+| `textValue` | `string` / –        | `label`                         | Renamed. Base adds `openOnHover` / `delay` (`100`) / `closeDelay` (`0`) and `onClick`. |
 
 ## SubContent → Menu.Portal > Menu.Positioner > Menu.Popup (inside SubmenuRoot)
 
@@ -170,30 +170,30 @@ Same prop fates as **Content** above; Radix-specific defaults to be aware of: `a
 
 ## Data-attribute mapping (dropdown/context/menubar menus)
 
-| Radix | Base UI |
-| --- | --- |
-| Trigger `[data-state="open" \| "closed"]` | `data-popup-open` (presence) + `data-pressed` |
-| Content `[data-state="open" \| "closed"]` | `data-open` / `data-closed` on Positioner and Popup |
-| – | `data-starting-style` / `data-ending-style` (CSS transition hooks, replace animating on `data-state`) |
-| Content `[data-side="left" \| "right" \| "bottom" \| "top"]` | `data-side` (`'top' \| 'bottom' \| 'left' \| 'right' \| 'inline-end' \| 'inline-start'`) on Positioner/Popup/Arrow |
-| Content `[data-align="start" \| "end" \| "center"]` | `data-align` (same values) on Positioner/Popup/Arrow |
-| Content/Item `[data-orientation]` | Dropped on menu parts |
-| Item `[data-highlighted]` | `data-highlighted` (same) |
-| Item `[data-disabled]` | `data-disabled` (same) |
-| Checkbox/RadioItem `[data-state="checked" \| "unchecked" \| "indeterminate"]` | `data-checked` / `data-unchecked` presence attrs; no indeterminate |
-| ItemIndicator `[data-state]` | `data-checked` / `data-unchecked` + `data-starting-style` / `data-ending-style` on the split indicators |
-| SubTrigger `[data-state="open" \| "closed"]` | `data-popup-open` on SubmenuTrigger |
-| – | Popup `data-instant` (`'click' \| 'dismiss' \| 'group' \| 'trigger-change'`), Positioner `data-anchor-hidden` |
+| Radix                                                                         | Base UI                                                                                                            |
+| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| Trigger `[data-state="open" \| "closed"]`                                     | `data-popup-open` (presence) + `data-pressed`                                                                      |
+| Content `[data-state="open" \| "closed"]`                                     | `data-open` / `data-closed` on Positioner and Popup                                                                |
+| –                                                                             | `data-starting-style` / `data-ending-style` (CSS transition hooks, replace animating on `data-state`)              |
+| Content `[data-side="left" \| "right" \| "bottom" \| "top"]`                  | `data-side` (`'top' \| 'bottom' \| 'left' \| 'right' \| 'inline-end' \| 'inline-start'`) on Positioner/Popup/Arrow |
+| Content `[data-align="start" \| "end" \| "center"]`                           | `data-align` (same values) on Positioner/Popup/Arrow                                                               |
+| Content/Item `[data-orientation]`                                             | Dropped on menu parts                                                                                              |
+| Item `[data-highlighted]`                                                     | `data-highlighted` (same)                                                                                          |
+| Item `[data-disabled]`                                                        | `data-disabled` (same)                                                                                             |
+| Checkbox/RadioItem `[data-state="checked" \| "unchecked" \| "indeterminate"]` | `data-checked` / `data-unchecked` presence attrs; no indeterminate                                                 |
+| ItemIndicator `[data-state]`                                                  | `data-checked` / `data-unchecked` + `data-starting-style` / `data-ending-style` on the split indicators            |
+| SubTrigger `[data-state="open" \| "closed"]`                                  | `data-popup-open` on SubmenuTrigger                                                                                |
+| –                                                                             | Popup `data-instant` (`'click' \| 'dismiss' \| 'group' \| 'trigger-change'`), Positioner `data-anchor-hidden`      |
 
 ## CSS variable mapping (per menu flavor: `dropdown-menu` / `context-menu` / `menubar`)
 
-| Radix (on Content/SubContent) | Base UI (on Positioner) |
-| --- | --- |
-| `--radix-<name>-content-transform-origin` | `--transform-origin` |
-| `--radix-<name>-content-available-width` | `--available-width` |
-| `--radix-<name>-content-available-height` | `--available-height` |
-| `--radix-<name>-trigger-width` | `--anchor-width` |
-| `--radix-<name>-trigger-height` | `--anchor-height` |
+| Radix (on Content/SubContent)             | Base UI (on Positioner) |
+| ----------------------------------------- | ----------------------- |
+| `--radix-<name>-content-transform-origin` | `--transform-origin`    |
+| `--radix-<name>-content-available-width`  | `--available-width`     |
+| `--radix-<name>-content-available-height` | `--available-height`    |
+| `--radix-<name>-trigger-width`            | `--anchor-width`        |
+| `--radix-<name>-trigger-height`           | `--anchor-height`       |
 
 Base UI Menu.Viewport additionally exposes `--popup-width` / `--popup-height` (previous-content dimensions during transitions).
 
@@ -205,19 +205,19 @@ Base UI ContextMenu shares the Menu part set: `Root, Trigger, Portal, Backdrop,
 
 ## Root → ContextMenu.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `dir` | `"ltr" \| "rtl"` / – | – | Dropped; `DirectionProvider`. |
-| `open` | `boolean` / – | `open` (`boolean`) | Same. Base also adds `defaultOpen` (`false`), which Radix ContextMenu lacked. |
-| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: ContextMenu.Root.ChangeEventDetails) => void` (same reason union as Menu). |
-| `modal` | `boolean` / `true` | – | **Dropped.** Base UI ContextMenu.Root has no `modal` prop (behavior is fixed). If you relied on `modal={false}`, there is no direct equivalent. |
+| Radix prop     | Type / default                | Base UI equivalent | Migration note                                                                                                                                  |
+| -------------- | ----------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `dir`          | `"ltr" \| "rtl"` / –          | –                  | Dropped; `DirectionProvider`.                                                                                                                   |
+| `open`         | `boolean` / –                 | `open` (`boolean`) | Same. Base also adds `defaultOpen` (`false`), which Radix ContextMenu lacked.                                                                   |
+| `onOpenChange` | `(open: boolean) => void` / – | `onOpenChange`     | Signature changed: `(open: boolean, eventDetails: ContextMenu.Root.ChangeEventDetails) => void` (same reason union as Menu).                    |
+| `modal`        | `boolean` / `true`            | –                  | **Dropped.** Base UI ContextMenu.Root has no `modal` prop (behavior is fixed). If you relied on `modal={false}`, there is no direct equivalent. |
 
 ## Trigger → ContextMenu.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base Trigger renders a `<div>` (also handles long-press on touch). |
-| `disabled` | `boolean` / `false` | – | **Dropped.** ContextMenu.Trigger has only `className`/`style`/`render`. Workaround: conditionally render content outside the Trigger, or intercept `onContextMenu` with `preventDefault` + `stopPropagation` on a child. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                                                                                                           |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Base Trigger renders a `<div>` (also handles long-press on touch).                                                                                                                                                       |
+| `disabled` | `boolean` / `false` | –                  | **Dropped.** ContextMenu.Trigger has only `className`/`style`/`render`. Workaround: conditionally render content outside the Trigger, or intercept `onContextMenu` with `preventDefault` + `stopPropagation` on a child. |
 
 ## Portal → ContextMenu.Portal
 
@@ -229,10 +229,10 @@ Same fates as dropdown-menu Content for: `asChild`, `loop` (→ Root `loopFocus`
 
 Radix-specific deltas:
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `alignOffset` | `number` / `0` | `alignOffset` on Positioner (`number \| OffsetFunction`, `0`) | Radix ContextMenu.Content has no `side`/`sideOffset`/`align` props (anchored to pointer). Base Positioner still accepts `side`/`align`/`sideOffset` but anchors to the pointer position by default; usually leave them off. |
-| (no `arrowPadding` on Content) | – | `arrowPadding` (`5`) on Positioner | Available in Base if you add an Arrow. |
+| Radix prop                     | Type / default | Base UI equivalent                                            | Migration note                                                                                                                                                                                                              |
+| ------------------------------ | -------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `alignOffset`                  | `number` / `0` | `alignOffset` on Positioner (`number \| OffsetFunction`, `0`) | Radix ContextMenu.Content has no `side`/`sideOffset`/`align` props (anchored to pointer). Base Positioner still accepts `side`/`align`/`sideOffset` but anchors to the pointer position by default; usually leave them off. |
+| (no `arrowPadding` on Content) | –              | `arrowPadding` (`5`) on Positioner                            | Available in Base if you add an Arrow.                                                                                                                                                                                      |
 
 ## Arrow / Item / Group / Label / CheckboxItem / RadioGroup / RadioItem / ItemIndicator / Separator / Sub / SubTrigger / SubContent
 
@@ -250,31 +250,31 @@ Base UI's menubar module exports a single `<Menubar>` container. Every menu insi
 
 ## Root → Menubar
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same pattern. |
-| `defaultValue` | `string` / – | – | **Dropped.** Base Menubar has no controlled/uncontrolled active-menu value. To pre-open a menu, use `defaultOpen` on that `Menu.Root`. |
-| `value` | `string` / – | – | **Dropped.** Control individual `Menu.Root` `open` props instead. |
-| `onValueChange` | `(value: string) => void` / – | – | **Dropped.** Listen via each `Menu.Root` `onOpenChange`. |
-| `dir` | `"ltr" \| "rtl"` / – | – | Dropped; `DirectionProvider`. |
-| `loop` | `boolean` / `false` | `loopFocus` (`boolean`, `true`) | Renamed; default flips to `true`. |
+| Radix prop      | Type / default                | Base UI equivalent              | Migration note                                                                                                                         |
+| --------------- | ----------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`       | `boolean` / `false`           | `render`                        | Same pattern.                                                                                                                          |
+| `defaultValue`  | `string` / –                  | –                               | **Dropped.** Base Menubar has no controlled/uncontrolled active-menu value. To pre-open a menu, use `defaultOpen` on that `Menu.Root`. |
+| `value`         | `string` / –                  | –                               | **Dropped.** Control individual `Menu.Root` `open` props instead.                                                                      |
+| `onValueChange` | `(value: string) => void` / – | –                               | **Dropped.** Listen via each `Menu.Root` `onOpenChange`.                                                                               |
+| `dir`           | `"ltr" \| "rtl"` / –          | –                               | Dropped; `DirectionProvider`.                                                                                                          |
+| `loop`          | `boolean` / `false`           | `loopFocus` (`boolean`, `true`) | Renamed; default flips to `true`.                                                                                                      |
 
 Base UI only on `Menubar`: `modal` (`boolean`, `true`), `disabled` (`boolean`, `false`), `orientation` (`'horizontal' \| 'vertical'`, `'horizontal'`).
 
 ## Menu → Menu.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | – | Menu.Root renders no element; drop it. |
-| `value` | `string` / – | – | Dropped with the Menubar value system (see Root). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                    |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | –                  | Menu.Root renders no element; drop it.            |
+| `value`    | `string` / –        | –                  | Dropped with the Menubar value system (see Root). |
 
 Note: `Menu.Root` inside a Menubar accepts all Menu.Root props (`open`, `defaultOpen`, `onOpenChange(open, eventDetails)`, `modal`, `loopFocus`, `orientation`, `disabled`, ...). Hover-switching between menubar menus is built in.
 
 ## Trigger → Menu.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton={false}` for non-buttons) | Radix Menubar.Trigger data attrs `[data-state]`/`[data-highlighted]`/`[data-disabled]` → `data-popup-open`/`data-pressed` (no highlighted state on Base trigger). |
+| Radix prop | Type / default      | Base UI equivalent                                  | Migration note                                                                                                                                                    |
+| ---------- | ------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render` (+ `nativeButton={false}` for non-buttons) | Radix Menubar.Trigger data attrs `[data-state]`/`[data-highlighted]`/`[data-disabled]` → `data-popup-open`/`data-pressed` (no highlighted state on Base trigger). |
 
 ## Portal / Content / Arrow / Item / Group / Label / CheckboxItem / RadioGroup / RadioItem / ItemIndicator / Separator / Sub / SubTrigger / SubContent
 
@@ -299,76 +299,76 @@ Base UI parts: `Root, List, Item, Trigger, Icon, Content, Portal, Backdrop, Posi
 
 ## Root → NavigationMenu.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultValue` | `string` / – | `defaultValue` (`Value \| null`, `null`) | Type widens (`Value = any`); `null` = closed. |
-| `value` | `string` / – | `value` (`Value \| null`, `null`) | Same; non-nullish = open. |
-| `onValueChange` | `(value: string) => void` / – | `onValueChange` | Signature changed: `(value: Value \| null, eventDetails: NavigationMenu.Root.ChangeEventDetails) => void`; reasons: `'trigger-press' \| 'trigger-hover' \| 'outside-press' \| 'list-navigation' \| 'focus-out' \| 'escape-key' \| 'link-press' \| 'none'`. |
-| `delayDuration` | `number` / `200` | `delay` (`number`, `50`) | Renamed; default 200 → 50. |
-| `skipDelayDuration` | `number` / `300` | – | **Dropped.** No skip-delay window; Base instead has `closeDelay` (`number`, `50`). |
-| `dir` | `"ltr" \| "rtl"` / – | – | Dropped; `DirectionProvider`. |
-| `orientation` | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (same values/default) | Same. |
+| Radix prop          | Type / default                                | Base UI equivalent                       | Migration note                                                                                                                                                                                                                                             |
+| ------------------- | --------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultValue`      | `string` / –                                  | `defaultValue` (`Value \| null`, `null`) | Type widens (`Value = any`); `null` = closed.                                                                                                                                                                                                              |
+| `value`             | `string` / –                                  | `value` (`Value \| null`, `null`)        | Same; non-nullish = open.                                                                                                                                                                                                                                  |
+| `onValueChange`     | `(value: string) => void` / –                 | `onValueChange`                          | Signature changed: `(value: Value \| null, eventDetails: NavigationMenu.Root.ChangeEventDetails) => void`; reasons: `'trigger-press' \| 'trigger-hover' \| 'outside-press' \| 'list-navigation' \| 'focus-out' \| 'escape-key' \| 'link-press' \| 'none'`. |
+| `delayDuration`     | `number` / `200`                              | `delay` (`number`, `50`)                 | Renamed; default 200 → 50.                                                                                                                                                                                                                                 |
+| `skipDelayDuration` | `number` / `300`                              | –                                        | **Dropped.** No skip-delay window; Base instead has `closeDelay` (`number`, `50`).                                                                                                                                                                         |
+| `dir`               | `"ltr" \| "rtl"` / –                          | –                                        | Dropped; `DirectionProvider`.                                                                                                                                                                                                                              |
+| `orientation`       | `"horizontal" \| "vertical"` / `"horizontal"` | `orientation` (same values/default)      | Same.                                                                                                                                                                                                                                                      |
 
 Base UI only on Root: `closeDelay` (`50`), `actionsRef` (`{ unmount() }`), `onOpenChangeComplete(open)`. Root renders a `<nav>` element (Radix Root also rendered `<nav>`; Base renders `<div>` when nested).
 
 ## Sub → nested NavigationMenu.Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultValue` / `value` / `onValueChange` / `orientation` | as Root | same props on the nested `Root` | Part dropped: nest a whole `NavigationMenu.Root` (with its own `List`/`Portal`/`Positioner`/`Popup`) inside a `Content`; it renders a `<div>` when nested. Unlike Radix Sub, a nested Base menu is closed by default (`null`), not required to always have an active item. |
+| Radix prop                                                 | Type / default | Base UI equivalent              | Migration note                                                                                                                                                                                                                                                             |
+| ---------------------------------------------------------- | -------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultValue` / `value` / `onValueChange` / `orientation` | as Root        | same props on the nested `Root` | Part dropped: nest a whole `NavigationMenu.Root` (with its own `List`/`Portal`/`Positioner`/`Popup`) inside a `Content`; it renders a `<div>` when nested. Unlike Radix Sub, a nested Base menu is closed by default (`null`), not required to always have an active item. |
 
 ## List → NavigationMenu.List
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base List renders `<ul>` (Radix also `<ul>`). Radix `[data-orientation]` attr dropped. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                         |
+| ---------- | ------------------- | ------------------ | -------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base List renders `<ul>` (Radix also `<ul>`). Radix `[data-orientation]` attr dropped. |
 
 ## Item → NavigationMenu.Item
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base Item renders `<li>`. |
-| `value` | `string` / – | `value` (`any`) | Same; auto-generated if omitted. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                   |
+| ---------- | ------------------- | ------------------ | -------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base Item renders `<li>`.        |
+| `value`    | `string` / –        | `value` (`any`)    | Same; auto-generated if omitted. |
 
 ## Trigger → NavigationMenu.Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | `[data-state="open" \| "closed"]` → `data-popup-open`; `[data-disabled]` dropped (no disabled prop either — gate at the item level yourself). |
+| Radix prop | Type / default      | Base UI equivalent                          | Migration note                                                                                                                                |
+| ---------- | ------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render` (+ `nativeButton`, default `true`) | `[data-state="open" \| "closed"]` → `data-popup-open`; `[data-disabled]` dropped (no disabled prop either — gate at the item level yourself). |
 
 ## Content → NavigationMenu.Content
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | – |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / – | – | Dropped → Root `onValueChange` with `reason === 'escape-key'` + `eventDetails.cancel()`. |
-| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / – | – | Dropped → `reason === 'outside-press'`. |
-| `onFocusOutside` | `(event: FocusOutsideEvent) => void` / – | – | Dropped → `reason === 'focus-out'`. |
-| `onInteractOutside` | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / – | – | Dropped → `'outside-press' \| 'focus-out'`. |
-| `forceMount` | `boolean` / – | `keepMounted` (`boolean`, `false`) | Renamed, stays on Content (keeps content in DOM while closed, e.g. for SEO/SSR). |
+| Radix prop             | Type / default                                                      | Base UI equivalent                 | Migration note                                                                           |
+| ---------------------- | ------------------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean` / `false`                                                 | `render`                           | –                                                                                        |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void` / –                                | –                                  | Dropped → Root `onValueChange` with `reason === 'escape-key'` + `eventDetails.cancel()`. |
+| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / –                      | –                                  | Dropped → `reason === 'outside-press'`.                                                  |
+| `onFocusOutside`       | `(event: FocusOutsideEvent) => void` / –                            | –                                  | Dropped → `reason === 'focus-out'`.                                                      |
+| `onInteractOutside`    | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / – | –                                  | Dropped → `'outside-press' \| 'focus-out'`.                                              |
+| `forceMount`           | `boolean` / –                                                       | `keepMounted` (`boolean`, `false`) | Renamed, stays on Content (keeps content in DOM while closed, e.g. for SEO/SSR).         |
 
 ## Link → NavigationMenu.Link
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | For framework links: `render={<NextLink href=... />}`. |
-| `active` | `boolean` / `false` | `active` (`boolean`, `false`) | Same (sets `aria-current` + `data-active`). |
-| `onSelect` | `(event: Event) => void` / – | – | Dropped. Use `onClick` (plain DOM prop) and `closeOnClick` (`boolean`, `false`) — note Radix closed the menu on link select by default, Base does not; set `closeOnClick` for parity. |
+| Radix prop | Type / default               | Base UI equivalent            | Migration note                                                                                                                                                                        |
+| ---------- | ---------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false`          | `render`                      | For framework links: `render={<NextLink href=... />}`.                                                                                                                                |
+| `active`   | `boolean` / `false`          | `active` (`boolean`, `false`) | Same (sets `aria-current` + `data-active`).                                                                                                                                           |
+| `onSelect` | `(event: Event) => void` / – | –                             | Dropped. Use `onClick` (plain DOM prop) and `closeOnClick` (`boolean`, `false`) — note Radix closed the menu on link select by default, Base does not; set `closeOnClick` for parity. |
 
 ## Indicator → NavigationMenu.Icon (per wrapper ground truth)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Different role: Radix Indicator tracked the active trigger below the List; Base `Icon` is a chevron inside the Trigger (`data-popup-open` when its menu is open). For a popup-anchored pointer, Base's `Arrow` (inside `Popup`, with `data-side`/`data-align`/`data-uncentered`) is the closest visual analogue. There is no Base part that tracks the active trigger along the list. |
-| `forceMount` | `boolean` / – | – | Dropped (Icon is always rendered). |
-| `[data-state="visible" \| "hidden"]`, `[data-orientation]` | – | – | Dropped; Icon exposes only `data-popup-open`. |
+| Radix prop                                                 | Type / default      | Base UI equivalent | Migration note                                                                                                                                                                                                                                                                                                                                                                        |
+| ---------------------------------------------------------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`                                                  | `boolean` / `false` | `render`           | Different role: Radix Indicator tracked the active trigger below the List; Base `Icon` is a chevron inside the Trigger (`data-popup-open` when its menu is open). For a popup-anchored pointer, Base's `Arrow` (inside `Popup`, with `data-side`/`data-align`/`data-uncentered`) is the closest visual analogue. There is no Base part that tracks the active trigger along the list. |
+| `forceMount`                                               | `boolean` / –       | –                  | Dropped (Icon is always rendered).                                                                                                                                                                                                                                                                                                                                                    |
+| `[data-state="visible" \| "hidden"]`, `[data-orientation]` | –                   | –                  | Dropped; Icon exposes only `data-popup-open`.                                                                                                                                                                                                                                                                                                                                         |
 
 ## Viewport → NavigationMenu.Portal > Positioner > Popup > Viewport
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` on each new part | One Radix part becomes four: `Portal` (props: `container`, `keepMounted`), `Positioner` (full anchored-positioning prop set identical to Menu.Positioner: `side`/`sideOffset`/`align`/`alignOffset` (`number \| OffsetFunction`), `anchor`, `collisionAvoidance`, `collisionBoundary` `'clipping-ancestors'`, `collisionPadding` `5`, `arrowPadding` `5`, `sticky` boolean, `positionMethod`, `disableAnchorTracking`), `Popup` (renders `<nav>`), `Viewport` (clips/animates the active `Content`). |
-| `forceMount` | `boolean` / – | `keepMounted` on **Portal** | Renamed + moved. |
+| Radix prop   | Type / default      | Base UI equivalent          | Migration note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| ------------ | ------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`    | `boolean` / `false` | `render` on each new part   | One Radix part becomes four: `Portal` (props: `container`, `keepMounted`), `Positioner` (full anchored-positioning prop set identical to Menu.Positioner: `side`/`sideOffset`/`align`/`alignOffset` (`number \| OffsetFunction`), `anchor`, `collisionAvoidance`, `collisionBoundary` `'clipping-ancestors'`, `collisionPadding` `5`, `arrowPadding` `5`, `sticky` boolean, `positionMethod`, `disableAnchorTracking`), `Popup` (renders `<nav>`), `Viewport` (clips/animates the active `Content`). |
+| `forceMount` | `boolean` / –       | `keepMounted` on **Portal** | Renamed + moved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 ## Base UI only props worth knowing (NavigationMenu)
 
@@ -380,25 +380,25 @@ Base UI only on Root: `closeDelay` (`50`), `actionsRef` (`{ unmount() }`), `onOp
 
 ## Data-attribute mapping (navigation-menu)
 
-| Radix | Base UI |
-| --- | --- |
-| Root/Sub/List/Item `[data-orientation]` | Dropped. |
-| Trigger `[data-state="open" \| "closed"]` | `data-popup-open` on Trigger (and on Icon). |
-| Trigger `[data-disabled]` | Dropped. |
-| Content `[data-state="open" \| "closed"]` | `data-open` / `data-closed` on Content (also on Positioner/Popup/Backdrop). |
+| Radix                                                                        | Base UI                                                                                                                                                                                |
+| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Root/Sub/List/Item `[data-orientation]`                                      | Dropped.                                                                                                                                                                               |
+| Trigger `[data-state="open" \| "closed"]`                                    | `data-popup-open` on Trigger (and on Icon).                                                                                                                                            |
+| Trigger `[data-disabled]`                                                    | Dropped.                                                                                                                                                                               |
+| Content `[data-state="open" \| "closed"]`                                    | `data-open` / `data-closed` on Content (also on Positioner/Popup/Backdrop).                                                                                                            |
 | Content `[data-motion="to-start" \| "to-end" \| "from-start" \| "from-end"]` | `data-activation-direction` (`'left' \| 'right' \| 'up' \| 'down'`) on Content — direction the newly-activated trigger is relative to the previous one; use for enter/exit animations. |
-| Link `[data-active]` | `data-active` (same). |
-| Indicator `[data-state="visible" \| "hidden"]` | No equivalent (see Indicator row). Arrow exposes `data-open`/`data-closed`/`data-uncentered`/`data-side`/`data-align`. |
-| Viewport `[data-state]`, `[data-orientation]` | `data-open`/`data-closed` + `data-starting-style`/`data-ending-style` on Popup/Positioner; Viewport itself exposes none. |
-| – | Positioner: `data-anchor-hidden`, `data-instant`; Popup: `data-side`, `data-align`. |
+| Link `[data-active]`                                                         | `data-active` (same).                                                                                                                                                                  |
+| Indicator `[data-state="visible" \| "hidden"]`                               | No equivalent (see Indicator row). Arrow exposes `data-open`/`data-closed`/`data-uncentered`/`data-side`/`data-align`.                                                                 |
+| Viewport `[data-state]`, `[data-orientation]`                                | `data-open`/`data-closed` + `data-starting-style`/`data-ending-style` on Popup/Positioner; Viewport itself exposes none.                                                               |
+| –                                                                            | Positioner: `data-anchor-hidden`, `data-instant`; Popup: `data-side`, `data-align`.                                                                                                    |
 
 ## CSS variable mapping (navigation-menu)
 
-| Radix | Base UI |
-| --- | --- |
-| `--radix-navigation-menu-viewport-width` (on Viewport) | `--popup-width` (`number`, on **Popup**) — fixed width of the popup; animate `width: var(--popup-width)`. |
-| `--radix-navigation-menu-viewport-height` (on Viewport) | `--popup-height` (`number`, on **Popup**). |
-| – | Positioner also exposes `--anchor-width`, `--anchor-height`, `--available-width`, `--available-height`, `--positioner-width`, `--positioner-height`, `--transform-origin`. |
+| Radix                                                   | Base UI                                                                                                                                                                    |
+| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--radix-navigation-menu-viewport-width` (on Viewport)  | `--popup-width` (`number`, on **Popup**) — fixed width of the popup; animate `width: var(--popup-width)`.                                                                  |
+| `--radix-navigation-menu-viewport-height` (on Viewport) | `--popup-height` (`number`, on **Popup**).                                                                                                                                 |
+| –                                                       | Positioner also exposes `--anchor-width`, `--anchor-height`, `--available-width`, `--available-height`, `--positioner-width`, `--positioner-height`, `--transform-origin`. |
 
 ---
 
diff --git a/.agents/skills/migrate-radix-to-base/overlays.md b/.agents/skills/migrate-radix-to-base/overlays.md
index ea950e1..a5872dd 100644
--- a/.agents/skills/migrate-radix-to-base/overlays.md
+++ b/.agents/skills/migrate-radix-to-base/overlays.md
@@ -21,52 +21,52 @@ Part mapping: Root→Root, Trigger→Trigger, Portal→Portal, Overlay→Backdro
 
 ## Root → Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / - (Base default `false`) | `defaultOpen` | Same. |
-| `open` | `boolean` / - | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / - | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Dialog.Root.ChangeEventDetails) => void`. Reasons: `'trigger-press' \| 'outside-press' \| 'escape-key' \| 'close-press' \| 'focus-out' \| 'imperative-action' \| 'none'`. |
-| `modal` | `boolean` / `true` | `modal` | Widened: `boolean \| 'trap-focus'`, default `true`. `'trap-focus'` traps focus without scroll lock / outside-pointer blocking. |
+| Radix prop     | Type / default                       | Base UI equivalent | Migration note                                                                                                                                                                                                              |
+| -------------- | ------------------------------------ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / - (Base default `false`) | `defaultOpen`      | Same.                                                                                                                                                                                                                       |
+| `open`         | `boolean` / -                        | `open`             | Same.                                                                                                                                                                                                                       |
+| `onOpenChange` | `(open: boolean) => void` / -        | `onOpenChange`     | Signature changed: `(open: boolean, eventDetails: Dialog.Root.ChangeEventDetails) => void`. Reasons: `'trigger-press' \| 'outside-press' \| 'escape-key' \| 'close-press' \| 'focus-out' \| 'imperative-action' \| 'none'`. |
+| `modal`        | `boolean` / `true`                   | `modal`            | Widened: `boolean \| 'trap-focus'`, default `true`. `'trap-focus'` traps focus without scroll lock / outside-pointer blocking.                                                                                              |
 
 ## Trigger → Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | `render={<MyButton />}`; add `nativeButton={false}` if the rendered element is not a `<button>`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                   |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | `render={<MyButton />}`; add `nativeButton={false}` if the rendered element is not a `<button>`. |
 
 ## Portal → Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / - | `keepMounted` | Renamed + inverted intent: `keepMounted?: boolean` (default `false`) keeps the portal in the DOM while hidden. Usually droppable; Base UI keeps the popup mounted during exit animations automatically. |
-| `container` | `HTMLElement` / `document.body` | `container` | Same name, wider type: `HTMLElement \| ShadowRoot \| React.RefObject<HTMLElement \| ShadowRoot \| null> \| null`. Note: Base UI Portal renders a `<div>` wrapper (Radix Portal renders nothing extra per child). |
+| Radix prop   | Type / default                  | Base UI equivalent | Migration note                                                                                                                                                                                                   |
+| ------------ | ------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forceMount` | `boolean` / -                   | `keepMounted`      | Renamed + inverted intent: `keepMounted?: boolean` (default `false`) keeps the portal in the DOM while hidden. Usually droppable; Base UI keeps the popup mounted during exit animations automatically.          |
+| `container`  | `HTMLElement` / `document.body` | `container`        | Same name, wider type: `HTMLElement \| ShadowRoot \| React.RefObject<HTMLElement \| ShadowRoot \| null> \| null`. Note: Base UI Portal renders a `<div>` wrapper (Radix Portal renders nothing extra per child). |
 
 ## Overlay → Backdrop
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same pattern. |
-| `forceMount` | `boolean` / - | dropped | Backdrop stays mounted through exit animations natively; use `Portal keepMounted` if you need always-mounted DOM. Base-only: `forceRender` (`boolean`, default `false`) forces the backdrop to render even when the dialog is nested. |
+| Radix prop   | Type / default      | Base UI equivalent | Migration note                                                                                                                                                                                                                        |
+| ------------ | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`    | `boolean` / `false` | `render`           | Same pattern.                                                                                                                                                                                                                         |
+| `forceMount` | `boolean` / -       | dropped            | Backdrop stays mounted through exit animations natively; use `Portal keepMounted` if you need always-mounted DOM. Base-only: `forceRender` (`boolean`, default `false`) forces the backdrop to render even when the dialog is nested. |
 
 ## Content → Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same pattern. |
-| `forceMount` | `boolean` / - | dropped | See Portal `keepMounted` + `Root actionsRef.unmount()` + `onOpenChangeComplete`. |
-| `onOpenAutoFocus` | `(event: Event) => void` / - | moved to Popup `initialFocus` | Signature changed. Radix: prevent via `event.preventDefault()`. Base: `initialFocus?: boolean \| RefObject<HTMLElement \| null> \| ((openType: InteractionType) => boolean \| void \| HTMLElement \| null)`. `false` = don't move focus; ref/element = focus target; function receives `'mouse' \| 'touch' \| 'pen' \| 'keyboard'`. |
-| `onCloseAutoFocus` | `(event: Event) => void` / - | moved to Popup `finalFocus` | Same shape as `initialFocus` but for close (`closeType: InteractionType`). |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / - | moved to Root `onOpenChange` | `if (eventDetails.reason === 'escape-key') eventDetails.cancel()` replaces `event.preventDefault()`. |
-| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / - | moved to Root `onOpenChange` | Reason `'outside-press'`; cancel with `eventDetails.cancel()`. Declarative shortcut: Root `disablePointerDismissal` (`boolean`, default `false`). |
-| `onInteractOutside` | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / - | moved to Root `onOpenChange` | Covers reasons `'outside-press'` and `'focus-out'` (focus-out applies to non-modal dialogs). |
+| Radix prop             | Type / default                                                      | Base UI equivalent            | Migration note                                                                                                                                                                                                                                                                                                                      |
+| ---------------------- | ------------------------------------------------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean` / `false`                                                 | `render`                      | Same pattern.                                                                                                                                                                                                                                                                                                                       |
+| `forceMount`           | `boolean` / -                                                       | dropped                       | See Portal `keepMounted` + `Root actionsRef.unmount()` + `onOpenChangeComplete`.                                                                                                                                                                                                                                                    |
+| `onOpenAutoFocus`      | `(event: Event) => void` / -                                        | moved to Popup `initialFocus` | Signature changed. Radix: prevent via `event.preventDefault()`. Base: `initialFocus?: boolean \| RefObject<HTMLElement \| null> \| ((openType: InteractionType) => boolean \| void \| HTMLElement \| null)`. `false` = don't move focus; ref/element = focus target; function receives `'mouse' \| 'touch' \| 'pen' \| 'keyboard'`. |
+| `onCloseAutoFocus`     | `(event: Event) => void` / -                                        | moved to Popup `finalFocus`   | Same shape as `initialFocus` but for close (`closeType: InteractionType`).                                                                                                                                                                                                                                                          |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void` / -                                | moved to Root `onOpenChange`  | `if (eventDetails.reason === 'escape-key') eventDetails.cancel()` replaces `event.preventDefault()`.                                                                                                                                                                                                                                |
+| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / -                      | moved to Root `onOpenChange`  | Reason `'outside-press'`; cancel with `eventDetails.cancel()`. Declarative shortcut: Root `disablePointerDismissal` (`boolean`, default `false`).                                                                                                                                                                                   |
+| `onInteractOutside`    | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / - | moved to Root `onOpenChange`  | Covers reasons `'outside-press'` and `'focus-out'` (focus-out applies to non-modal dialogs).                                                                                                                                                                                                                                        |
 
 ## Title → Title / Description → Description / Close → Close
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` (Title) | `boolean` / `false` | `render` | Base Title renders `<h2>`. |
-| `asChild` (Description) | `boolean` / `false` | `render` | Base Description renders `<p>`. |
-| `asChild` (Close) | `boolean` / `false` | `render` | Base Close renders `<button>`; `nativeButton` available. |
+| Radix prop              | Type / default      | Base UI equivalent | Migration note                                           |
+| ----------------------- | ------------------- | ------------------ | -------------------------------------------------------- |
+| `asChild` (Title)       | `boolean` / `false` | `render`           | Base Title renders `<h2>`.                               |
+| `asChild` (Description) | `boolean` / `false` | `render`           | Base Description renders `<p>`.                          |
+| `asChild` (Close)       | `boolean` / `false` | `render`           | Base Close renders `<button>`; `nativeButton` available. |
 
 ## Base UI only props worth knowing (dialog)
 
@@ -78,19 +78,19 @@ Part mapping: Root→Root, Trigger→Trigger, Portal→Portal, Overlay→Backdro
 
 ## Data attributes (dialog)
 
-| Radix | Base UI | Where |
-| --- | --- | --- |
-| `[data-state="open"]` | `data-open` | Backdrop, Popup, Viewport (presence attr). |
-| `[data-state="closed"]` | `data-closed` | Backdrop, Popup, Viewport. |
-| `[data-state]` on Trigger | `data-popup-open` | Trigger (presence attr). |
-| - | `data-disabled` | Trigger, Close. |
-| - | `data-starting-style` / `data-ending-style` | Backdrop, Popup, Viewport; hooks for enter/exit CSS transitions (replaces Radix animate-on-`data-state` idiom). |
-| - | `data-nested`, `data-nested-dialog-open` | Popup, Viewport. |
+| Radix                     | Base UI                                     | Where                                                                                                           |
+| ------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `[data-state="open"]`     | `data-open`                                 | Backdrop, Popup, Viewport (presence attr).                                                                      |
+| `[data-state="closed"]`   | `data-closed`                               | Backdrop, Popup, Viewport.                                                                                      |
+| `[data-state]` on Trigger | `data-popup-open`                           | Trigger (presence attr).                                                                                        |
+| -                         | `data-disabled`                             | Trigger, Close.                                                                                                 |
+| -                         | `data-starting-style` / `data-ending-style` | Backdrop, Popup, Viewport; hooks for enter/exit CSS transitions (replaces Radix animate-on-`data-state` idiom). |
+| -                         | `data-nested`, `data-nested-dialog-open`    | Popup, Viewport.                                                                                                |
 
 ## CSS variables (dialog)
 
-| Radix | Base UI |
-| --- | --- |
+| Radix             | Base UI                                                                  |
+| ----------------- | ------------------------------------------------------------------------ |
 | (none documented) | `--nested-dialogs` (`number`, on Popup): count of dialogs nested within. |
 
 ---
@@ -101,43 +101,43 @@ Part mapping: Root→Root, Trigger→Trigger, Portal→Portal, Overlay→Backdro
 
 ## Root → Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / - (Base default `false`) | `defaultOpen` | Same. |
-| `open` | `boolean` / - | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / - | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: AlertDialog.Root.ChangeEventDetails) => void`. Same reason union as dialog. |
+| Radix prop     | Type / default                       | Base UI equivalent | Migration note                                                                                                                |
+| -------------- | ------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / - (Base default `false`) | `defaultOpen`      | Same.                                                                                                                         |
+| `open`         | `boolean` / -                        | `open`             | Same.                                                                                                                         |
+| `onOpenChange` | `(open: boolean) => void` / -        | `onOpenChange`     | Signature changed: `(open: boolean, eventDetails: AlertDialog.Root.ChangeEventDetails) => void`. Same reason union as dialog. |
 
 (Radix AlertDialog.Root has no `modal` prop; Base UI AlertDialog.Root also has none. Parity.)
 
 ## Trigger → Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Plus `nativeButton`, `payload`, `handle`, `id`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                  |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Plus `nativeButton`, `payload`, `handle`, `id`. |
 
 ## Portal → Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / - | `keepMounted` | Same as dialog. |
-| `container` | `HTMLElement` / `document.body` | `container` | Same as dialog (wider type, renders a `<div>`). |
+| Radix prop   | Type / default                  | Base UI equivalent | Migration note                                  |
+| ------------ | ------------------------------- | ------------------ | ----------------------------------------------- |
+| `forceMount` | `boolean` / -                   | `keepMounted`      | Same as dialog.                                 |
+| `container`  | `HTMLElement` / `document.body` | `container`        | Same as dialog (wider type, renders a `<div>`). |
 
 ## Overlay → Backdrop
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same pattern. |
-| `forceMount` | `boolean` / - | dropped | Base-only `forceRender` exists for nested cases. |
+| Radix prop   | Type / default      | Base UI equivalent | Migration note                                   |
+| ------------ | ------------------- | ------------------ | ------------------------------------------------ |
+| `asChild`    | `boolean` / `false` | `render`           | Same pattern.                                    |
+| `forceMount` | `boolean` / -       | dropped            | Base-only `forceRender` exists for nested cases. |
 
 ## Content → Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Same pattern. |
-| `forceMount` | `boolean` / - | dropped | See dialog notes. |
-| `onOpenAutoFocus` | `(event: Event) => void` / - | moved to Popup `initialFocus` | Same semantics as dialog. Note: Radix alert-dialog focuses `Cancel` by default; Base UI focuses the first tabbable element. To preserve Radix behavior pass `initialFocus={cancelRef}`. |
-| `onCloseAutoFocus` | `(event: Event) => void` / - | moved to Popup `finalFocus` | Same as dialog. |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / - | moved to Root `onOpenChange` | Reason `'escape-key'` + `eventDetails.cancel()`. |
+| Radix prop         | Type / default                       | Base UI equivalent            | Migration note                                                                                                                                                                          |
+| ------------------ | ------------------------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`          | `boolean` / `false`                  | `render`                      | Same pattern.                                                                                                                                                                           |
+| `forceMount`       | `boolean` / -                        | dropped                       | See dialog notes.                                                                                                                                                                       |
+| `onOpenAutoFocus`  | `(event: Event) => void` / -         | moved to Popup `initialFocus` | Same semantics as dialog. Note: Radix alert-dialog focuses `Cancel` by default; Base UI focuses the first tabbable element. To preserve Radix behavior pass `initialFocus={cancelRef}`. |
+| `onCloseAutoFocus` | `(event: Event) => void` / -         | moved to Popup `finalFocus`   | Same as dialog.                                                                                                                                                                         |
+| `onEscapeKeyDown`  | `(event: KeyboardEvent) => void` / - | moved to Root `onOpenChange`  | Reason `'escape-key'` + `eventDetails.cancel()`.                                                                                                                                        |
 
 (Radix AlertDialog.Content intentionally has no `onPointerDownOutside`/`onInteractOutside`; nothing to map.)
 
@@ -147,15 +147,15 @@ Same as dialog: `asChild` → `render`. Title renders `<h2>`, Description render
 
 ## Cancel → Close
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` on `AlertDialog.Close` | Renamed part. `nativeButton` available. Radix's "Cancel receives focus on open" default must be recreated with Popup `initialFocus`. |
+| Radix prop | Type / default      | Base UI equivalent              | Migration note                                                                                                                       |
+| ---------- | ------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render` on `AlertDialog.Close` | Renamed part. `nativeButton` available. Radix's "Cancel receives focus on open" default must be recreated with Popup `initialFocus`. |
 
 ## Action → (no primitive)
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | dropped | No Base UI part. Wrapper renders a styled `<button>`; close after the action via controlled `open`, `actionsRef.current.close()`, or by composing `AlertDialog.Close` and running the action in `onClick`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                                                                                             |
+| ---------- | ------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | dropped            | No Base UI part. Wrapper renders a styled `<button>`; close after the action via controlled `open`, `actionsRef.current.close()`, or by composing `AlertDialog.Close` and running the action in `onClick`. |
 
 ## Base UI only props worth knowing (alert-dialog)
 
@@ -169,8 +169,8 @@ Identical table to dialog: `data-state="open"/"closed"` → `data-open`/`data-cl
 
 ## CSS variables (alert-dialog)
 
-| Radix | Base UI |
-| --- | --- |
+| Radix             | Base UI                                  |
+| ----------------- | ---------------------------------------- |
 | (none documented) | `--nested-dialogs` (`number`, on Popup). |
 
 ---
@@ -181,68 +181,68 @@ Part mapping: Root→Root, Trigger→Trigger, Anchor→(Positioner `anchor` prop
 
 ## Root → Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / - (Base default `false`) | `defaultOpen` | Same. |
-| `open` | `boolean` / - | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / - | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Popover.Root.ChangeEventDetails) => void`. Reasons add hover/focus: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'close-press' \| 'focus-out' \| 'imperative-action' \| 'none'`. |
-| `modal` | `boolean` / `false` | `modal` | Widened: `boolean \| 'trap-focus'`, default `false`. When `true`, focus trapping requires a `Popover.Close` inside the Popup (can be `sr-only`). |
+| Radix prop     | Type / default                       | Base UI equivalent | Migration note                                                                                                                                                                                                                                                                     |
+| -------------- | ------------------------------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / - (Base default `false`) | `defaultOpen`      | Same.                                                                                                                                                                                                                                                                              |
+| `open`         | `boolean` / -                        | `open`             | Same.                                                                                                                                                                                                                                                                              |
+| `onOpenChange` | `(open: boolean) => void` / -        | `onOpenChange`     | Signature changed: `(open: boolean, eventDetails: Popover.Root.ChangeEventDetails) => void`. Reasons add hover/focus: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'close-press' \| 'focus-out' \| 'imperative-action' \| 'none'`. |
+| `modal`        | `boolean` / `false`                  | `modal`            | Widened: `boolean \| 'trap-focus'`, default `false`. When `true`, focus trapping requires a `Popover.Close` inside the Popup (can be `sr-only`).                                                                                                                                   |
 
 ## Trigger → Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Plus `nativeButton`. Base-only on Trigger: `openOnHover` (`false`), `delay` (`300`), `closeDelay` (`0`), `payload`, `handle`, `id`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                      |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Plus `nativeButton`. Base-only on Trigger: `openOnHover` (`false`), `delay` (`300`), `closeDelay` (`0`), `payload`, `handle`, `id`. |
 
 ## Anchor → Positioner `anchor` prop
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | dropped (part removed) | No Anchor part. Pass `anchor` to Positioner: `Element \| VirtualElement \| React.RefObject<Element \| null> \| (() => Element \| VirtualElement \| null) \| null`. Default anchor is the trigger. |
+| Radix prop | Type / default      | Base UI equivalent     | Migration note                                                                                                                                                                                    |
+| ---------- | ------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | dropped (part removed) | No Anchor part. Pass `anchor` to Positioner: `Element \| VirtualElement \| React.RefObject<Element \| null> \| (() => Element \| VirtualElement \| null) \| null`. Default anchor is the trigger. |
 
 ## Portal → Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / - | `keepMounted` | `boolean`, default `false`. |
-| `container` | `HTMLElement` / `document.body` | `container` | Wider type (adds ShadowRoot/RefObject); Portal renders a `<div>`. |
+| Radix prop   | Type / default                  | Base UI equivalent | Migration note                                                    |
+| ------------ | ------------------------------- | ------------------ | ----------------------------------------------------------------- |
+| `forceMount` | `boolean` / -                   | `keepMounted`      | `boolean`, default `false`.                                       |
+| `container`  | `HTMLElement` / `document.body` | `container`        | Wider type (adds ShadowRoot/RefObject); Portal renders a `<div>`. |
 
 ## Content → Positioner + Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` (Popup) | Same pattern. |
-| `onOpenAutoFocus` | `(event: Event) => void` / - | moved to Popup `initialFocus` | Same shape as dialog (`boolean \| RefObject \| (openType: InteractionType) => ...`). |
-| `onCloseAutoFocus` | `(event: Event) => void` / - | moved to Popup `finalFocus` | Same shape. |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / - | moved to Root `onOpenChange` | Reason `'escape-key'` + `eventDetails.cancel()`. |
-| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / - | moved to Root `onOpenChange` | Reason `'outside-press'` + `eventDetails.cancel()`. |
-| `onFocusOutside` | `(event: FocusOutsideEvent) => void` / - | moved to Root `onOpenChange` | Reason `'focus-out'` + `eventDetails.cancel()`. |
-| `onInteractOutside` | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / - | moved to Root `onOpenChange` | Handle both `'outside-press'` and `'focus-out'`. |
-| `forceMount` | `boolean` / - | dropped | Use Portal `keepMounted`, `onOpenChangeComplete`, `actionsRef.unmount()`. |
-| `side` | `"top" \| "right" \| "bottom" \| "left"` / `"bottom"` | moved to Positioner `side` | Type is `Side` which adds logical values `'inline-start' \| 'inline-end'`. Default `'bottom'` (same). |
-| `sideOffset` | `number` / `0` | moved to Positioner `sideOffset` | Widened: `number \| OffsetFunction` where the function receives `{ anchor, positioner, side, align }`. Default `0` (same). |
-| `align` | `"start" \| "center" \| "end"` / `"center"` | moved to Positioner `align` | Same values/default. |
-| `alignOffset` | `number` / `0` | moved to Positioner `alignOffset` | Widened: `number \| OffsetFunction`. Default `0` (same). |
-| `avoidCollisions` | `boolean` / `true` | moved to Positioner `collisionAvoidance` | Signature changed. Radix boolean → Base `CollisionAvoidance` object `{ side?: 'flip' \| 'shift' \| 'none'; align?: 'flip' \| 'shift' \| 'none'; fallbackAxisSide?: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` → `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`. |
-| `collisionBoundary` | `Boundary (Element \| null \| Array<Element \| null>)` / `[]` | moved to Positioner `collisionBoundary` | Same name; Base `Boundary` defaults to `'clipping-ancestors'` (Radix default = viewport/clipping ancestors via `[]`). |
-| `collisionPadding` | `number \| Padding` / `0` | moved to Positioner `collisionPadding` | Same shape; default changes `0` → `5`. |
-| `arrowPadding` | `number` / `0` | moved to Positioner `arrowPadding` | Same; default changes `0` → `5`. |
-| `sticky` | `"partial" \| "always"` / `"partial"` | dropped (repurposed name) | Radix `sticky` governed alignment-axis sticking; Base equivalent is `collisionAvoidance.align` (`'shift'` ≈ sticky behavior). CAUTION: Base UI Positioner has a `sticky: boolean` (default `false`) prop with a DIFFERENT meaning: keep the popup in the viewport after the anchor scrolls out of view. Do not copy the Radix value across. |
-| `hideWhenDetached` | `boolean` / `false` | dropped (with workaround) | Positioner/Popup expose `data-anchor-hidden` when the anchor is hidden; recreate with CSS: `[data-anchor-hidden] { visibility: hidden }` on the Positioner. |
+| Radix prop             | Type / default                                                      | Base UI equivalent                       | Migration note                                                                                                                                                                                                                                                                                                                              |
+| ---------------------- | ------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean` / `false`                                                 | `render` (Popup)                         | Same pattern.                                                                                                                                                                                                                                                                                                                               |
+| `onOpenAutoFocus`      | `(event: Event) => void` / -                                        | moved to Popup `initialFocus`            | Same shape as dialog (`boolean \| RefObject \| (openType: InteractionType) => ...`).                                                                                                                                                                                                                                                        |
+| `onCloseAutoFocus`     | `(event: Event) => void` / -                                        | moved to Popup `finalFocus`              | Same shape.                                                                                                                                                                                                                                                                                                                                 |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void` / -                                | moved to Root `onOpenChange`             | Reason `'escape-key'` + `eventDetails.cancel()`.                                                                                                                                                                                                                                                                                            |
+| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / -                      | moved to Root `onOpenChange`             | Reason `'outside-press'` + `eventDetails.cancel()`.                                                                                                                                                                                                                                                                                         |
+| `onFocusOutside`       | `(event: FocusOutsideEvent) => void` / -                            | moved to Root `onOpenChange`             | Reason `'focus-out'` + `eventDetails.cancel()`.                                                                                                                                                                                                                                                                                             |
+| `onInteractOutside`    | `(event: PointerDownOutsideEvent \| FocusOutsideEvent) => void` / - | moved to Root `onOpenChange`             | Handle both `'outside-press'` and `'focus-out'`.                                                                                                                                                                                                                                                                                            |
+| `forceMount`           | `boolean` / -                                                       | dropped                                  | Use Portal `keepMounted`, `onOpenChangeComplete`, `actionsRef.unmount()`.                                                                                                                                                                                                                                                                   |
+| `side`                 | `"top" \| "right" \| "bottom" \| "left"` / `"bottom"`               | moved to Positioner `side`               | Type is `Side` which adds logical values `'inline-start' \| 'inline-end'`. Default `'bottom'` (same).                                                                                                                                                                                                                                       |
+| `sideOffset`           | `number` / `0`                                                      | moved to Positioner `sideOffset`         | Widened: `number \| OffsetFunction` where the function receives `{ anchor, positioner, side, align }`. Default `0` (same).                                                                                                                                                                                                                  |
+| `align`                | `"start" \| "center" \| "end"` / `"center"`                         | moved to Positioner `align`              | Same values/default.                                                                                                                                                                                                                                                                                                                        |
+| `alignOffset`          | `number` / `0`                                                      | moved to Positioner `alignOffset`        | Widened: `number \| OffsetFunction`. Default `0` (same).                                                                                                                                                                                                                                                                                    |
+| `avoidCollisions`      | `boolean` / `true`                                                  | moved to Positioner `collisionAvoidance` | Signature changed. Radix boolean → Base `CollisionAvoidance` object `{ side?: 'flip' \| 'shift' \| 'none'; align?: 'flip' \| 'shift' \| 'none'; fallbackAxisSide?: 'start' \| 'end' \| 'none' }`. `avoidCollisions={false}` → `collisionAvoidance={{ side: 'none', align: 'none', fallbackAxisSide: 'none' }}`.                             |
+| `collisionBoundary`    | `Boundary (Element \| null \| Array<Element \| null>)` / `[]`       | moved to Positioner `collisionBoundary`  | Same name; Base `Boundary` defaults to `'clipping-ancestors'` (Radix default = viewport/clipping ancestors via `[]`).                                                                                                                                                                                                                       |
+| `collisionPadding`     | `number \| Padding` / `0`                                           | moved to Positioner `collisionPadding`   | Same shape; default changes `0` → `5`.                                                                                                                                                                                                                                                                                                      |
+| `arrowPadding`         | `number` / `0`                                                      | moved to Positioner `arrowPadding`       | Same; default changes `0` → `5`.                                                                                                                                                                                                                                                                                                            |
+| `sticky`               | `"partial" \| "always"` / `"partial"`                               | dropped (repurposed name)                | Radix `sticky` governed alignment-axis sticking; Base equivalent is `collisionAvoidance.align` (`'shift'` ≈ sticky behavior). CAUTION: Base UI Positioner has a `sticky: boolean` (default `false`) prop with a DIFFERENT meaning: keep the popup in the viewport after the anchor scrolls out of view. Do not copy the Radix value across. |
+| `hideWhenDetached`     | `boolean` / `false`                                                 | dropped (with workaround)                | Positioner/Popup expose `data-anchor-hidden` when the anchor is hidden; recreate with CSS: `[data-anchor-hidden] { visibility: hidden }` on the Positioner.                                                                                                                                                                                 |
 
 ## Close → Close
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Plus `nativeButton`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note       |
+| ---------- | ------------------- | ------------------ | -------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Plus `nativeButton`. |
 
 ## Arrow → Arrow
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Radix renders an `<svg>`; Base renders a `<div>` — supply your own SVG child. |
-| `width` | `number` / `10` | dropped | Size the arrow element/SVG via CSS. |
-| `height` | `number` / `5` | dropped | Size via CSS. Arrow must be a child of Popup (inside Positioner). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                |
+| ---------- | ------------------- | ------------------ | ----------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Radix renders an `<svg>`; Base renders a `<div>` — supply your own SVG child. |
+| `width`    | `number` / `10`     | dropped            | Size the arrow element/SVG via CSS.                                           |
+| `height`   | `number` / `5`      | dropped            | Size via CSS. Arrow must be a child of Popup (inside Positioner).             |
 
 ## Base UI only props worth knowing (popover)
 
@@ -254,27 +254,27 @@ Part mapping: Root→Root, Trigger→Trigger, Anchor→(Positioner `anchor` prop
 
 ## Data attributes (popover)
 
-| Radix (on Content/Trigger/Arrow) | Base UI | Where |
-| --- | --- | --- |
-| `[data-state="open"/"closed"]` | `data-open` / `data-closed` | Backdrop, Positioner, Popup, Arrow. |
-| `[data-state]` on Trigger | `data-popup-open` | Trigger. Base also adds `data-pressed`. |
-| `[data-side]` `"left" \| "right" \| "bottom" \| "top"` | `data-side` | Positioner, Popup, Arrow; values extended with `'inline-start' \| 'inline-end'`. |
-| `[data-align]` `"start" \| "end" \| "center"` | `data-align` | Positioner, Popup, Arrow. |
-| - | `data-starting-style` / `data-ending-style` | Popup, Backdrop (enter/exit animation hooks). |
-| - | `data-anchor-hidden` | Positioner (replaces `hideWhenDetached`). |
-| - | `data-instant` (`'click' \| 'dismiss' \| 'focus' \| 'trigger-change'`) | Popup. |
-| - | `data-uncentered` | Arrow (arrow can't center on anchor). |
+| Radix (on Content/Trigger/Arrow)                       | Base UI                                                                | Where                                                                            |
+| ------------------------------------------------------ | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `[data-state="open"/"closed"]`                         | `data-open` / `data-closed`                                            | Backdrop, Positioner, Popup, Arrow.                                              |
+| `[data-state]` on Trigger                              | `data-popup-open`                                                      | Trigger. Base also adds `data-pressed`.                                          |
+| `[data-side]` `"left" \| "right" \| "bottom" \| "top"` | `data-side`                                                            | Positioner, Popup, Arrow; values extended with `'inline-start' \| 'inline-end'`. |
+| `[data-align]` `"start" \| "end" \| "center"`          | `data-align`                                                           | Positioner, Popup, Arrow.                                                        |
+| -                                                      | `data-starting-style` / `data-ending-style`                            | Popup, Backdrop (enter/exit animation hooks).                                    |
+| -                                                      | `data-anchor-hidden`                                                   | Positioner (replaces `hideWhenDetached`).                                        |
+| -                                                      | `data-instant` (`'click' \| 'dismiss' \| 'focus' \| 'trigger-change'`) | Popup.                                                                           |
+| -                                                      | `data-uncentered`                                                      | Arrow (arrow can't center on anchor).                                            |
 
 ## CSS variables (popover)
 
-| Radix (on Content) | Base UI (on Positioner unless noted) |
-| --- | --- |
-| `--radix-popover-content-transform-origin` | `--transform-origin` |
-| `--radix-popover-content-available-width` | `--available-width` |
-| `--radix-popover-content-available-height` | `--available-height` |
-| `--radix-popover-trigger-width` | `--anchor-width` |
-| `--radix-popover-trigger-height` | `--anchor-height` |
-| - | `--positioner-width` / `--positioner-height` (Positioner), `--popup-width` / `--popup-height` (Popup, and on Viewport's previous container) |
+| Radix (on Content)                         | Base UI (on Positioner unless noted)                                                                                                        |
+| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--radix-popover-content-transform-origin` | `--transform-origin`                                                                                                                        |
+| `--radix-popover-content-available-width`  | `--available-width`                                                                                                                         |
+| `--radix-popover-content-available-height` | `--available-height`                                                                                                                        |
+| `--radix-popover-trigger-width`            | `--anchor-width`                                                                                                                            |
+| `--radix-popover-trigger-height`           | `--anchor-height`                                                                                                                           |
+| -                                          | `--positioner-width` / `--positioner-height` (Positioner), `--popup-width` / `--popup-height` (Popup, and on Viewport's previous container) |
 
 ---
 
@@ -284,62 +284,62 @@ Part mapping: Provider→Provider, Root→Root, Trigger→Trigger, Portal→Port
 
 ## Provider → Provider
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `delayDuration` | `number` / `700` | `delay` | Renamed. Base has no documented default on Provider (Trigger default is `600`). |
-| `skipDelayDuration` | `number` / `300` | `timeout` | Renamed + semantics kept: another tooltip opens instantly if the previous closed within `timeout` ms. Default `300` → `400`. |
-| `disableHoverableContent` | `boolean` / - | dropped at Provider; see Root `disableHoverablePopup` | Base UI equivalent exists only per-Root (renamed). |
+| Radix prop                | Type / default   | Base UI equivalent                                    | Migration note                                                                                                               |
+| ------------------------- | ---------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `delayDuration`           | `number` / `700` | `delay`                                               | Renamed. Base has no documented default on Provider (Trigger default is `600`).                                              |
+| `skipDelayDuration`       | `number` / `300` | `timeout`                                             | Renamed + semantics kept: another tooltip opens instantly if the previous closed within `timeout` ms. Default `300` → `400`. |
+| `disableHoverableContent` | `boolean` / -    | dropped at Provider; see Root `disableHoverablePopup` | Base UI equivalent exists only per-Root (renamed).                                                                           |
 
 ## Root → Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / - (Base default `false`) | `defaultOpen` | Same. |
-| `open` | `boolean` / - | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / - | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: Tooltip.Root.ChangeEventDetails) => void`. Reasons: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'disabled' \| 'imperative-action' \| 'none'`. |
-| `delayDuration` | `number` / `700` | moved to Trigger `delay` | `number`, default `600`. `closeDelay` (default `0`) is also on Trigger. |
-| `disableHoverableContent` | `boolean` / - | `disableHoverablePopup` | Renamed; `boolean`, default `false`. |
+| Radix prop                | Type / default                       | Base UI equivalent       | Migration note                                                                                                                                                                                                                                   |
+| ------------------------- | ------------------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `defaultOpen`             | `boolean` / - (Base default `false`) | `defaultOpen`            | Same.                                                                                                                                                                                                                                            |
+| `open`                    | `boolean` / -                        | `open`                   | Same.                                                                                                                                                                                                                                            |
+| `onOpenChange`            | `(open: boolean) => void` / -        | `onOpenChange`           | Signature changed: `(open: boolean, eventDetails: Tooltip.Root.ChangeEventDetails) => void`. Reasons: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'disabled' \| 'imperative-action' \| 'none'`. |
+| `delayDuration`           | `number` / `700`                     | moved to Trigger `delay` | `number`, default `600`. `closeDelay` (default `0`) is also on Trigger.                                                                                                                                                                          |
+| `disableHoverableContent` | `boolean` / -                        | `disableHoverablePopup`  | Renamed; `boolean`, default `false`.                                                                                                                                                                                                             |
 
 ## Trigger → Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base-only on Trigger: `delay` (`600`), `closeDelay` (`0`), `closeOnClick` (`true`), `disabled` (`false`), `payload`, `handle`. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                 |
+| ---------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| `asChild`  | `boolean` / `false` | `render`           | Base-only on Trigger: `delay` (`600`), `closeDelay` (`0`), `closeOnClick` (`true`), `disabled` (`false`), `payload`, `handle`. |
 
 ## Portal → Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / - | `keepMounted` | `boolean`, default `false`. |
-| `container` | `HTMLElement` / `document.body` | `container` | Wider type; renders a `<div>`. |
+| Radix prop   | Type / default                  | Base UI equivalent | Migration note                 |
+| ------------ | ------------------------------- | ------------------ | ------------------------------ |
+| `forceMount` | `boolean` / -                   | `keepMounted`      | `boolean`, default `false`.    |
+| `container`  | `HTMLElement` / `document.body` | `container`        | Wider type; renders a `<div>`. |
 
 ## Content → Positioner + Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` (Popup) | Same pattern. |
-| `aria-label` | `string` / - | dropped (plain DOM attr) | Pass `aria-label` straight through to Popup if needed; no special prop. |
-| `onEscapeKeyDown` | `(event: KeyboardEvent) => void` / - | moved to Root `onOpenChange` | Reason `'escape-key'` + `eventDetails.cancel()`. |
-| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / - | moved to Root `onOpenChange` | Reason `'outside-press'` + `eventDetails.cancel()`. |
-| `forceMount` | `boolean` / - | dropped | Portal `keepMounted` / `actionsRef.unmount()`. |
-| `side` | enum / `"top"` | moved to Positioner `side` | `Side` (adds `'inline-start' \| 'inline-end'`); default `'top'` (same). |
-| `sideOffset` | `number` / `0` | moved to Positioner `sideOffset` | `number \| OffsetFunction`; default `0`. |
-| `align` | enum / `"center"` | moved to Positioner `align` | Same values/default. |
-| `alignOffset` | `number` / `0` | moved to Positioner `alignOffset` | `number \| OffsetFunction`; default `0`. |
-| `avoidCollisions` | `boolean` / `true` | moved to Positioner `collisionAvoidance` | Same conversion as popover (`false` → all-`'none'` object). |
-| `collisionBoundary` | `Boundary` / `[]` | moved to Positioner `collisionBoundary` | Base default `'clipping-ancestors'`. |
-| `collisionPadding` | `number \| Padding` / `0` | moved to Positioner `collisionPadding` | Default `0` → `5`. |
-| `arrowPadding` | `number` / `0` | moved to Positioner `arrowPadding` | Default `0` → `5`. |
-| `sticky` | `"partial" \| "always"` / `"partial"` | dropped (repurposed name) | Same caveat as popover: Base `sticky: boolean` means "stay in viewport when anchor scrolls away"; alignment sticking is `collisionAvoidance.align`. |
-| `hideWhenDetached` | `boolean` / `false` | dropped (with workaround) | Style `[data-anchor-hidden]` on Positioner. |
+| Radix prop             | Type / default                                 | Base UI equivalent                       | Migration note                                                                                                                                      |
+| ---------------------- | ---------------------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`              | `boolean` / `false`                            | `render` (Popup)                         | Same pattern.                                                                                                                                       |
+| `aria-label`           | `string` / -                                   | dropped (plain DOM attr)                 | Pass `aria-label` straight through to Popup if needed; no special prop.                                                                             |
+| `onEscapeKeyDown`      | `(event: KeyboardEvent) => void` / -           | moved to Root `onOpenChange`             | Reason `'escape-key'` + `eventDetails.cancel()`.                                                                                                    |
+| `onPointerDownOutside` | `(event: PointerDownOutsideEvent) => void` / - | moved to Root `onOpenChange`             | Reason `'outside-press'` + `eventDetails.cancel()`.                                                                                                 |
+| `forceMount`           | `boolean` / -                                  | dropped                                  | Portal `keepMounted` / `actionsRef.unmount()`.                                                                                                      |
+| `side`                 | enum / `"top"`                                 | moved to Positioner `side`               | `Side` (adds `'inline-start' \| 'inline-end'`); default `'top'` (same).                                                                             |
+| `sideOffset`           | `number` / `0`                                 | moved to Positioner `sideOffset`         | `number \| OffsetFunction`; default `0`.                                                                                                            |
+| `align`                | enum / `"center"`                              | moved to Positioner `align`              | Same values/default.                                                                                                                                |
+| `alignOffset`          | `number` / `0`                                 | moved to Positioner `alignOffset`        | `number \| OffsetFunction`; default `0`.                                                                                                            |
+| `avoidCollisions`      | `boolean` / `true`                             | moved to Positioner `collisionAvoidance` | Same conversion as popover (`false` → all-`'none'` object).                                                                                         |
+| `collisionBoundary`    | `Boundary` / `[]`                              | moved to Positioner `collisionBoundary`  | Base default `'clipping-ancestors'`.                                                                                                                |
+| `collisionPadding`     | `number \| Padding` / `0`                      | moved to Positioner `collisionPadding`   | Default `0` → `5`.                                                                                                                                  |
+| `arrowPadding`         | `number` / `0`                                 | moved to Positioner `arrowPadding`       | Default `0` → `5`.                                                                                                                                  |
+| `sticky`               | `"partial" \| "always"` / `"partial"`          | dropped (repurposed name)                | Same caveat as popover: Base `sticky: boolean` means "stay in viewport when anchor scrolls away"; alignment sticking is `collisionAvoidance.align`. |
+| `hideWhenDetached`     | `boolean` / `false`                            | dropped (with workaround)                | Style `[data-anchor-hidden]` on Positioner.                                                                                                         |
 
 ## Arrow → Arrow
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base renders `<div>`; bring your own SVG. |
-| `width` | `number` / `10` | dropped | CSS sizing. |
-| `height` | `number` / `5` | dropped | CSS sizing. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                            |
+| ---------- | ------------------- | ------------------ | ----------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base renders `<div>`; bring your own SVG. |
+| `width`    | `number` / `10`     | dropped            | CSS sizing.                               |
+| `height`   | `number` / `5`      | dropped            | CSS sizing.                               |
 
 ## Base UI only props worth knowing (tooltip)
 
@@ -351,26 +351,26 @@ Part mapping: Provider→Provider, Root→Root, Trigger→Trigger, Portal→Port
 
 ## Data attributes (tooltip)
 
-| Radix | Base UI | Where |
-| --- | --- | --- |
+| Radix                                                                   | Base UI                                                                          | Where                                                                                                     |
+| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
 | `[data-state]` `"closed" \| "delayed-open" \| "instant-open"` (Content) | `data-open` / `data-closed` + `data-instant` (`'delay' \| 'dismiss' \| 'focus'`) | Popup, Arrow, Positioner (open/closed). The delayed/instant distinction becomes the `data-instant` value. |
-| `[data-state]` (Trigger) | `data-popup-open` | Trigger. Base also adds `data-trigger-disabled`. |
-| `[data-side]` | `data-side` | Positioner, Popup, Arrow; adds `'inline-start' \| 'inline-end'`. |
-| `[data-align]` | `data-align` | Positioner, Popup, Arrow. |
-| - | `data-starting-style` / `data-ending-style` | Popup. |
-| - | `data-anchor-hidden` | Positioner. |
-| - | `data-uncentered` | Arrow. |
+| `[data-state]` (Trigger)                                                | `data-popup-open`                                                                | Trigger. Base also adds `data-trigger-disabled`.                                                          |
+| `[data-side]`                                                           | `data-side`                                                                      | Positioner, Popup, Arrow; adds `'inline-start' \| 'inline-end'`.                                          |
+| `[data-align]`                                                          | `data-align`                                                                     | Positioner, Popup, Arrow.                                                                                 |
+| -                                                                       | `data-starting-style` / `data-ending-style`                                      | Popup.                                                                                                    |
+| -                                                                       | `data-anchor-hidden`                                                             | Positioner.                                                                                               |
+| -                                                                       | `data-uncentered`                                                                | Arrow.                                                                                                    |
 
 ## CSS variables (tooltip)
 
-| Radix (on Content) | Base UI (on Positioner) |
-| --- | --- |
-| `--radix-tooltip-content-transform-origin` | `--transform-origin` |
-| `--radix-tooltip-content-available-width` | `--available-width` |
-| `--radix-tooltip-content-available-height` | `--available-height` |
-| `--radix-tooltip-trigger-width` | `--anchor-width` |
-| `--radix-tooltip-trigger-height` | `--anchor-height` |
-| - | `--popup-width` / `--popup-height` (Viewport's previous container). |
+| Radix (on Content)                         | Base UI (on Positioner)                                             |
+| ------------------------------------------ | ------------------------------------------------------------------- |
+| `--radix-tooltip-content-transform-origin` | `--transform-origin`                                                |
+| `--radix-tooltip-content-available-width`  | `--available-width`                                                 |
+| `--radix-tooltip-content-available-height` | `--available-height`                                                |
+| `--radix-tooltip-trigger-width`            | `--anchor-width`                                                    |
+| `--radix-tooltip-trigger-height`           | `--anchor-height`                                                   |
+| -                                          | `--popup-width` / `--popup-height` (Viewport's previous container). |
 
 ---
 
@@ -380,53 +380,53 @@ Part mapping: HoverCard.Root→PreviewCard.Root, Trigger→Trigger, Portal→Por
 
 ## Root → Root
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `defaultOpen` | `boolean` / - (Base default `false`) | `defaultOpen` | Same. |
-| `open` | `boolean` / - | `open` | Same. |
-| `onOpenChange` | `(open: boolean) => void` / - | `onOpenChange` | Signature changed: `(open: boolean, eventDetails: PreviewCard.Root.ChangeEventDetails) => void`. Reasons: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'imperative-action' \| 'none'`. |
-| `openDelay` | `number` / `700` | moved to Trigger `delay` | Renamed + moved; default changes `700` → `600`. |
-| `closeDelay` | `number` / `300` | moved to Trigger `closeDelay` | Moved; default `300` (same). |
+| Radix prop     | Type / default                       | Base UI equivalent            | Migration note                                                                                                                                                                                                                         |
+| -------------- | ------------------------------------ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `defaultOpen`  | `boolean` / - (Base default `false`) | `defaultOpen`                 | Same.                                                                                                                                                                                                                                  |
+| `open`         | `boolean` / -                        | `open`                        | Same.                                                                                                                                                                                                                                  |
+| `onOpenChange` | `(open: boolean) => void` / -        | `onOpenChange`                | Signature changed: `(open: boolean, eventDetails: PreviewCard.Root.ChangeEventDetails) => void`. Reasons: `'trigger-hover' \| 'trigger-focus' \| 'trigger-press' \| 'outside-press' \| 'escape-key' \| 'imperative-action' \| 'none'`. |
+| `openDelay`    | `number` / `700`                     | moved to Trigger `delay`      | Renamed + moved; default changes `700` → `600`.                                                                                                                                                                                        |
+| `closeDelay`   | `number` / `300`                     | moved to Trigger `closeDelay` | Moved; default `300` (same).                                                                                                                                                                                                           |
 
 ## Trigger → Trigger
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base Trigger renders `<a>`; Base-only: `delay` (`600`), `closeDelay` (`300`), `payload`, `handle`. No `nativeButton` (it is a link, not a button). |
+| Radix prop | Type / default      | Base UI equivalent | Migration note                                                                                                                                     |
+| ---------- | ------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base Trigger renders `<a>`; Base-only: `delay` (`600`), `closeDelay` (`300`), `payload`, `handle`. No `nativeButton` (it is a link, not a button). |
 
 ## Portal → Portal
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `forceMount` | `boolean` / - | `keepMounted` | `boolean`, default `false`. |
-| `container` | `HTMLElement` / `document.body` | `container` | Wider type; renders a `<div>`. |
+| Radix prop   | Type / default                  | Base UI equivalent | Migration note                 |
+| ------------ | ------------------------------- | ------------------ | ------------------------------ |
+| `forceMount` | `boolean` / -                   | `keepMounted`      | `boolean`, default `false`.    |
+| `container`  | `HTMLElement` / `document.body` | `container`        | Wider type; renders a `<div>`. |
 
 ## Content → Positioner + Popup
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` (Popup) | Same pattern. |
-| `forceMount` | `boolean` / - | dropped | Portal `keepMounted` / `actionsRef.unmount()` / `onOpenChangeComplete`. |
-| `side` | enum / `"bottom"` | moved to Positioner `side` | `Side` (adds `'inline-start' \| 'inline-end'`); default `'bottom'` (same). |
-| `sideOffset` | `number` / `0` | moved to Positioner `sideOffset` | `number \| OffsetFunction`; default `0`. |
-| `align` | enum / `"center"` | moved to Positioner `align` | Same values/default. |
-| `alignOffset` | `number` / `0` | moved to Positioner `alignOffset` | `number \| OffsetFunction`; default `0`. |
-| `avoidCollisions` | `boolean` / `true` | moved to Positioner `collisionAvoidance` | Same conversion as popover. |
-| `collisionBoundary` | `Boundary` / `[]` | moved to Positioner `collisionBoundary` | Base default `'clipping-ancestors'`. |
-| `collisionPadding` | `number \| Padding` / `0` | moved to Positioner `collisionPadding` | Default `0` → `5`. |
-| `arrowPadding` | `number` / `0` | moved to Positioner `arrowPadding` | Default `0` → `5`. |
-| `sticky` | `"partial" \| "always"` / `"partial"` | dropped (repurposed name) | Same caveat as popover/tooltip. |
-| `hideWhenDetached` | `boolean` / `false` | dropped (with workaround) | Style `[data-anchor-hidden]` on Positioner. |
+| Radix prop          | Type / default                        | Base UI equivalent                       | Migration note                                                             |
+| ------------------- | ------------------------------------- | ---------------------------------------- | -------------------------------------------------------------------------- |
+| `asChild`           | `boolean` / `false`                   | `render` (Popup)                         | Same pattern.                                                              |
+| `forceMount`        | `boolean` / -                         | dropped                                  | Portal `keepMounted` / `actionsRef.unmount()` / `onOpenChangeComplete`.    |
+| `side`              | enum / `"bottom"`                     | moved to Positioner `side`               | `Side` (adds `'inline-start' \| 'inline-end'`); default `'bottom'` (same). |
+| `sideOffset`        | `number` / `0`                        | moved to Positioner `sideOffset`         | `number \| OffsetFunction`; default `0`.                                   |
+| `align`             | enum / `"center"`                     | moved to Positioner `align`              | Same values/default.                                                       |
+| `alignOffset`       | `number` / `0`                        | moved to Positioner `alignOffset`        | `number \| OffsetFunction`; default `0`.                                   |
+| `avoidCollisions`   | `boolean` / `true`                    | moved to Positioner `collisionAvoidance` | Same conversion as popover.                                                |
+| `collisionBoundary` | `Boundary` / `[]`                     | moved to Positioner `collisionBoundary`  | Base default `'clipping-ancestors'`.                                       |
+| `collisionPadding`  | `number \| Padding` / `0`             | moved to Positioner `collisionPadding`   | Default `0` → `5`.                                                         |
+| `arrowPadding`      | `number` / `0`                        | moved to Positioner `arrowPadding`       | Default `0` → `5`.                                                         |
+| `sticky`            | `"partial" \| "always"` / `"partial"` | dropped (repurposed name)                | Same caveat as popover/tooltip.                                            |
+| `hideWhenDetached`  | `boolean` / `false`                   | dropped (with workaround)                | Style `[data-anchor-hidden]` on Positioner.                                |
 
 (Radix HoverCard.Content documents no dismiss callbacks; escape/outside dismissal maps to Root `onOpenChange` reasons `'escape-key'` / `'outside-press'` if needed.)
 
 ## Arrow → Arrow
 
-| Radix prop | Type / default | Base UI equivalent | Migration note |
-| --- | --- | --- | --- |
-| `asChild` | `boolean` / `false` | `render` | Base renders `<div>`. |
-| `width` | `number` / `10` | dropped | CSS sizing. |
-| `height` | `number` / `5` | dropped | CSS sizing. |
+| Radix prop | Type / default      | Base UI equivalent | Migration note        |
+| ---------- | ------------------- | ------------------ | --------------------- |
+| `asChild`  | `boolean` / `false` | `render`           | Base renders `<div>`. |
+| `width`    | `number` / `10`     | dropped            | CSS sizing.           |
+| `height`   | `number` / `5`      | dropped            | CSS sizing.           |
 
 ## Base UI only props worth knowing (preview-card)
 
@@ -437,23 +437,23 @@ Part mapping: HoverCard.Root→PreviewCard.Root, Trigger→Trigger, Portal→Por
 
 ## Data attributes (preview-card)
 
-| Radix | Base UI | Where |
-| --- | --- | --- |
-| `[data-state="open"/"closed"]` | `data-open` / `data-closed` | Backdrop, Positioner, Popup, Arrow. |
-| `[data-state]` (Trigger) | `data-popup-open` | Trigger. |
-| `[data-side]` | `data-side` | Positioner, Popup, Arrow; adds `'inline-start' \| 'inline-end'`. |
-| `[data-align]` | `data-align` | Positioner, Popup, Arrow. |
-| - | `data-starting-style` / `data-ending-style` | Popup, Backdrop. |
-| - | `data-anchor-hidden` | Positioner. |
-| - | `data-uncentered` | Arrow. |
+| Radix                          | Base UI                                     | Where                                                            |
+| ------------------------------ | ------------------------------------------- | ---------------------------------------------------------------- |
+| `[data-state="open"/"closed"]` | `data-open` / `data-closed`                 | Backdrop, Positioner, Popup, Arrow.                              |
+| `[data-state]` (Trigger)       | `data-popup-open`                           | Trigger.                                                         |
+| `[data-side]`                  | `data-side`                                 | Positioner, Popup, Arrow; adds `'inline-start' \| 'inline-end'`. |
+| `[data-align]`                 | `data-align`                                | Positioner, Popup, Arrow.                                        |
+| -                              | `data-starting-style` / `data-ending-style` | Popup, Backdrop.                                                 |
+| -                              | `data-anchor-hidden`                        | Positioner.                                                      |
+| -                              | `data-uncentered`                           | Arrow.                                                           |
 
 ## CSS variables (preview-card)
 
-| Radix (on Content) | Base UI (on Positioner) |
-| --- | --- |
-| `--radix-hover-card-content-transform-origin` | `--transform-origin` |
-| `--radix-hover-card-content-available-width` | `--available-width` |
-| `--radix-hover-card-content-available-height` | `--available-height` |
-| `--radix-hover-card-trigger-width` | `--anchor-width` |
-| `--radix-hover-card-trigger-height` | `--anchor-height` |
-| - | `--popup-width` / `--popup-height` (Viewport's previous container). |
+| Radix (on Content)                            | Base UI (on Positioner)                                             |
+| --------------------------------------------- | ------------------------------------------------------------------- |
+| `--radix-hover-card-content-transform-origin` | `--transform-origin`                                                |
+| `--radix-hover-card-content-available-width`  | `--available-width`                                                 |
+| `--radix-hover-card-content-available-height` | `--available-height`                                                |
+| `--radix-hover-card-trigger-width`            | `--anchor-width`                                                    |
+| `--radix-hover-card-trigger-height`           | `--anchor-height`                                                   |
+| -                                             | `--popup-width` / `--popup-height` (Viewport's previous container). |
diff --git a/.agents/skills/migrate-radix-to-base/universal-patterns.md b/.agents/skills/migrate-radix-to-base/universal-patterns.md
index 424cf9e..bedd251 100644
--- a/.agents/skills/migrate-radix-to-base/universal-patterns.md
+++ b/.agents/skills/migrate-radix-to-base/universal-patterns.md
@@ -10,48 +10,48 @@ migration agent's `primitives/` skills.
 
 All radix-ui exports, classified for migration:
 
-| Radix primitive | Base UI target | Class |
-|---|---|---|
-| Accordion | Accordion | direct (Content->Panel) |
-| AlertDialog | Alert Dialog | restructured (Overlay->Backdrop, Content->Popup, Cancel->Close, Action dropped) |
-| AspectRatio | none | missing: plain div + CSS `aspect-ratio` (`--ratio` var) |
-| Avatar | Avatar | direct |
-| Checkbox | Checkbox | direct (cleanest 1:1) |
-| Collapsible | Collapsible | direct (Content->Panel) |
-| ContextMenu | Context Menu | restructured (menu mapping) |
-| Dialog | Dialog | restructured (Overlay->Backdrop, Content->Popup) |
-| DropdownMenu | Menu | RENAMED + restructured (canonical menu mapping) |
-| Form | Form + Field + Fieldset | restructured (split into three) |
-| HoverCard | Preview Card | RENAMED + positioner model |
-| Label | none | missing: native `<label>` (Field.Label inside forms) |
-| Menubar | Menubar + Menu | restructured (menubar root only; menus delegate to Menu) |
-| NavigationMenu | Navigation Menu | heavily restructured (Viewport -> Positioner/Popup/Viewport, Indicator->Icon) |
-| Popover | Popover | positioner model (Anchor dropped; verify vs docs) |
-| Progress | Progress | restructured (new Track/Label/Value parts, no manual transform) |
-| RadioGroup | Radio Group + Radio | restructured (Item -> Radio.Root, two subpath imports) |
-| ScrollArea | Scroll Area | direct (Scrollbar/Thumb renames) |
-| Select | Select | restructured (Viewport->List, ScrollButtons->ScrollArrows, alignItemWithTrigger) |
-| Separator | Separator | direct (callable; `decorative` dropped) |
-| Slider | Slider | restructured (Range->Indicator, new Control, thumbAlignment) |
-| Switch | Switch | direct (1:1) |
-| Tabs | Tabs | direct (Trigger->Tab, Content->Panel) |
-| Toast | Toast | restructured (not in our registry pairs; spec from docs; shadcn users mostly use sonner) |
-| Toggle | Toggle | direct (callable) |
-| ToggleGroup | Toggle Group + Toggle | direct (items use Toggle primitive) |
-| Toolbar | Toolbar | direct-ish (not in our pairs; spec from docs) |
-| Tooltip | Tooltip | positioner model (delayDuration->delay on Provider) |
-| unstable_OneTimePasswordField | OTP Field | from docs (our registry uses input-otp instead) |
-| unstable_PasswordToggleField | none | missing: Input + custom toggle |
+| Radix primitive               | Base UI target          | Class                                                                                    |
+| ----------------------------- | ----------------------- | ---------------------------------------------------------------------------------------- |
+| Accordion                     | Accordion               | direct (Content->Panel)                                                                  |
+| AlertDialog                   | Alert Dialog            | restructured (Overlay->Backdrop, Content->Popup, Cancel->Close, Action dropped)          |
+| AspectRatio                   | none                    | missing: plain div + CSS `aspect-ratio` (`--ratio` var)                                  |
+| Avatar                        | Avatar                  | direct                                                                                   |
+| Checkbox                      | Checkbox                | direct (cleanest 1:1)                                                                    |
+| Collapsible                   | Collapsible             | direct (Content->Panel)                                                                  |
+| ContextMenu                   | Context Menu            | restructured (menu mapping)                                                              |
+| Dialog                        | Dialog                  | restructured (Overlay->Backdrop, Content->Popup)                                         |
+| DropdownMenu                  | Menu                    | RENAMED + restructured (canonical menu mapping)                                          |
+| Form                          | Form + Field + Fieldset | restructured (split into three)                                                          |
+| HoverCard                     | Preview Card            | RENAMED + positioner model                                                               |
+| Label                         | none                    | missing: native `<label>` (Field.Label inside forms)                                     |
+| Menubar                       | Menubar + Menu          | restructured (menubar root only; menus delegate to Menu)                                 |
+| NavigationMenu                | Navigation Menu         | heavily restructured (Viewport -> Positioner/Popup/Viewport, Indicator->Icon)            |
+| Popover                       | Popover                 | positioner model (Anchor dropped; verify vs docs)                                        |
+| Progress                      | Progress                | restructured (new Track/Label/Value parts, no manual transform)                          |
+| RadioGroup                    | Radio Group + Radio     | restructured (Item -> Radio.Root, two subpath imports)                                   |
+| ScrollArea                    | Scroll Area             | direct (Scrollbar/Thumb renames)                                                         |
+| Select                        | Select                  | restructured (Viewport->List, ScrollButtons->ScrollArrows, alignItemWithTrigger)         |
+| Separator                     | Separator               | direct (callable; `decorative` dropped)                                                  |
+| Slider                        | Slider                  | restructured (Range->Indicator, new Control, thumbAlignment)                             |
+| Switch                        | Switch                  | direct (1:1)                                                                             |
+| Tabs                          | Tabs                    | direct (Trigger->Tab, Content->Panel)                                                    |
+| Toast                         | Toast                   | restructured (not in our registry pairs; spec from docs; shadcn users mostly use sonner) |
+| Toggle                        | Toggle                  | direct (callable)                                                                        |
+| ToggleGroup                   | Toggle Group + Toggle   | direct (items use Toggle primitive)                                                      |
+| Toolbar                       | Toolbar                 | direct-ish (not in our pairs; spec from docs)                                            |
+| Tooltip                       | Tooltip                 | positioner model (delayDuration->delay on Provider)                                      |
+| unstable_OneTimePasswordField | OTP Field               | from docs (our registry uses input-otp instead)                                          |
+| unstable_PasswordToggleField  | none                    | missing: Input + custom toggle                                                           |
 
 Utilities:
 
-| Radix utility | Base UI equivalent |
-|---|---|
+| Radix utility  | Base UI equivalent                                                  |
+| -------------- | ------------------------------------------------------------------- |
 | Slot / asChild | `render` prop; `useRender` + `mergeProps` for the manual Slot idiom |
-| Portal | none standalone; per-component `Portal` parts |
-| VisuallyHidden | none; `sr-only` class |
-| AccessibleIcon | none; aria-label + sr-only text |
-| Direction | Direction Provider |
+| Portal         | none standalone; per-component `Portal` parts                       |
+| VisuallyHidden | none; `sr-only` class                                               |
+| AccessibleIcon | none; aria-label + sr-only text                                     |
+| Direction      | Direction Provider                                                  |
 
 Base UI-only (new capabilities, NOT migration targets): Autocomplete, Combobox,
 Input, Number Field, Checkbox Group, Meter, Filter, CSP Provider.
@@ -69,7 +69,9 @@ sonner, input-otp, react-day-picker (calendar), recharts (chart).
 ## Universal patterns (apply across all components)
 
 ### Imports
+
 Radix appears in TWO import forms; both map to the same Base UI subpath:
+
 - Unified package (current shadcn):
   `import { X as XPrimitive } from "radix-ui"` ->
   `import { X as XPrimitive } from "@base-ui/react/<kebab-name>"`.
@@ -78,13 +80,14 @@ Radix appears in TWO import forms; both map to the same Base UI subpath:
   `import { X as XPrimitive } from "@base-ui/react/<kebab-name>"`.
   (The namespace `* as` import becomes a named import; remove the individual
   `@radix-ui/react-*` package from package.json.)
-One subpath per component either way.
+  One subpath per component either way.
 - Types: `React.ComponentProps<typeof XPrimitive.Part>` -> `XPrimitive.Part.Props`.
   Positioner props via `Pick<XPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">`.
 - Single-part primitives are callable: radix `XPrimitive.Root` -> `XPrimitive`
   (separator, toggle, toggle-group root, radio-group root, menubar root).
 
 ### asChild -> render
+
 - `<Primitive.Close asChild><Button/></Primitive.Close>` ->
   `<Primitive.Close render={<Button/>}>...</Primitive.Close>`.
 - Manual Slot idiom (`const Comp = asChild ? Slot.Root : "a"`) ->
@@ -92,6 +95,7 @@ One subpath per component either way.
   `@base-ui/react/merge-props`; prop type `useRender.ComponentProps<"a">`.
 
 ### Portal / positioning model (biggest structural change)
+
 - Radix: `Portal > Content`, positioning props on Content.
 - Base UI: `Portal > Positioner > Popup`. `side`, `sideOffset`, `align`,
   `alignOffset` (and select's `alignItemWithTrigger`) move to Positioner;
@@ -100,6 +104,7 @@ One subpath per component either way.
   (dialog/alert-dialog) use Popup WITHOUT a Positioner.
 
 ### Data attributes / class hooks
+
 - `data-[state=open]` -> `data-open`; `data-[state=closed]` -> `data-closed`.
 - Enter/exit animations: `data-[state=open]:animate-in` /
   `data-[state=closed]:animate-out` -> `data-starting-style:*` /
@@ -109,6 +114,7 @@ One subpath per component either way.
   (accordion, tabs).
 
 ### CSS custom properties
+
 - `--radix-<comp>-content-transform-origin` -> `--transform-origin`
 - `--radix-<comp>-content-available-height` -> `--available-height`
 - `--radix-<comp>-trigger-width` -> `--anchor-width`
@@ -117,6 +123,7 @@ One subpath per component either way.
   `--positioner-height/width`, `--popup-height/width`, `--available-width`
 
 ### Props
+
 - Tooltip Provider: `delayDuration` -> `delay`.
 - Select: `position="popper"|"item-aligned"` -> `alignItemWithTrigger` boolean.
 - Slider: gains `thumbAlignment` ("edge"); `Range` -> `Indicator` + new `Control`.
@@ -127,37 +134,39 @@ One subpath per component either way.
 
 ## Part-rename quick reference
 
-| radix part | Base UI part |
-|---|---|
-| `*.Root` (single-part comps) | callable `*Primitive` |
-| `Overlay` | `Backdrop` |
-| `Content` (overlay comps) | `Popup` (inside `Positioner`) |
-| `Content` (accordion/collapsible/tabs) | `Panel` |
-| tabs `Trigger` | `Tab` |
-| menu `Label` | `GroupLabel` |
-| menu `ItemIndicator` | `CheckboxItemIndicator` / `RadioItemIndicator` |
-| `Sub` / `SubTrigger` | `SubmenuRoot` / `SubmenuTrigger` |
-| slider `Range` | `Indicator` (+ new `Control`) |
-| select `Viewport` | `List` |
-| select `ScrollUp/DownButton` | `ScrollUp/DownArrow` |
-| scroll-area `ScrollAreaScrollbar` / `ScrollAreaThumb` | `Scrollbar` / `Thumb` |
-| nav-menu `Indicator` | `Icon` |
-| nav-menu `Viewport` | `Positioner > Popup > Viewport` |
-| hover-card `HoverCard*` | `PreviewCard*` |
-| radio-group `Item` / `Indicator` | `Radio.Root` / `Radio.Indicator` |
-| popover `Anchor` | dropped (verify against docs) |
-| alert-dialog `Cancel` / `Action` | `Close` / dropped (plain Button) |
-| separator `decorative` prop | dropped |
-| Label primitive | native `<label>` |
+| radix part                                            | Base UI part                                   |
+| ----------------------------------------------------- | ---------------------------------------------- |
+| `*.Root` (single-part comps)                          | callable `*Primitive`                          |
+| `Overlay`                                             | `Backdrop`                                     |
+| `Content` (overlay comps)                             | `Popup` (inside `Positioner`)                  |
+| `Content` (accordion/collapsible/tabs)                | `Panel`                                        |
+| tabs `Trigger`                                        | `Tab`                                          |
+| menu `Label`                                          | `GroupLabel`                                   |
+| menu `ItemIndicator`                                  | `CheckboxItemIndicator` / `RadioItemIndicator` |
+| `Sub` / `SubTrigger`                                  | `SubmenuRoot` / `SubmenuTrigger`               |
+| slider `Range`                                        | `Indicator` (+ new `Control`)                  |
+| select `Viewport`                                     | `List`                                         |
+| select `ScrollUp/DownButton`                          | `ScrollUp/DownArrow`                           |
+| scroll-area `ScrollAreaScrollbar` / `ScrollAreaThumb` | `Scrollbar` / `Thumb`                          |
+| nav-menu `Indicator`                                  | `Icon`                                         |
+| nav-menu `Viewport`                                   | `Positioner > Popup > Viewport`                |
+| hover-card `HoverCard*`                               | `PreviewCard*`                                 |
+| radio-group `Item` / `Indicator`                      | `Radio.Root` / `Radio.Indicator`               |
+| popover `Anchor`                                      | dropped (verify against docs)                  |
+| alert-dialog `Cancel` / `Action`                      | `Close` / dropped (plain Button)               |
+| separator `decorative` prop                           | dropped                                        |
+| Label primitive                                       | native `<label>`                               |
 
 ## Per-component notes
 
 ### accordion
+
 Root/Item/Header/Trigger same; Content -> Panel. Trigger `disabled:*` ->
 `aria-disabled:*`. Height var -> `--accordion-panel-height`; add
 `data-starting-style:h-0 data-ending-style:h-0`.
 
 ### dialog / alert-dialog / sheet
+
 Overlay -> Backdrop, Content -> Popup, Close kept (`asChild` -> `render`).
 Alert-dialog: Cancel -> Close; Action has no primitive (plain Button).
 Sheet: slide animations rewritten from animate-in/out to
@@ -165,6 +174,7 @@ Sheet: slide animations rewritten from animate-in/out to
 `data-[side=...]`. Centered modals: no Positioner.
 
 ### drawer (vaul -> Base UI) — OPT-IN ONLY, not part of a radix migration
+
 Vaul is NOT radix: during a radix -> base-ui migration, leave drawer.tsx
 untouched and report it (hard rule in SKILL.md). This mapping exists only for
 when the user EXPLICITLY asks to also move their drawer off vaul.
@@ -175,6 +185,7 @@ Root gains `modal`, `snapPoints`, `swipeDirection` (default "down"),
 context provider in our wrapper. This is a vaul migration, not radix.
 
 ### popover / tooltip / hover-card
+
 Portal > Positioner > Popup. Popover: Anchor dropped, Title is now a real
 primitive part. Tooltip: Provider `delayDuration` -> `delay`; Content gains
 side/align/alignOffset; default sideOffset 0 -> 4; Arrow gets explicit
@@ -182,6 +193,7 @@ per-side positioning classes. HoverCard: primitive renamed PreviewCard
 (public wrapper names stay HoverCard*).
 
 ### menus (dropdown-menu -> Menu; context-menu; menubar)
+
 Canonical mapping: Label -> GroupLabel, ItemIndicator ->
 CheckboxItemIndicator/RadioItemIndicator, Sub -> SubmenuRoot, SubTrigger ->
 SubmenuTrigger, Content -> Portal > Positioner > Popup, SubContent rebuilt
@@ -192,12 +204,14 @@ checkbox/radio items are menubar/menu primitives; everything else delegates
 to the Menu wrappers (radix Menubar.Menu -> Menu.Root).
 
 ### select
+
 Label -> GroupLabel, Viewport -> List, ScrollUp/DownButton ->
 ScrollUp/DownArrow. Icon/ItemIndicator go `asChild` -> `render`.
 `position` -> `alignItemWithTrigger` (default true) on Positioner. Vars ->
 `--available-height` / `--anchor-width` / `--transform-origin`.
 
 ### form controls
+
 Checkbox: 1:1. Switch: 1:1. Radio group: group from
 `@base-ui/react/radio-group` (callable), items from `@base-ui/react/radio`
 (`Radio.Root` + `Radio.Indicator`). Slider: `Root > Control > Track >
@@ -205,6 +219,7 @@ Indicator` + Thumbs, `thumbAlignment="edge"`; layout classes move Root ->
 Control. Toggle/toggle-group: callable primitives; group items reuse Toggle.
 
 ### tabs / collapsible / progress / separator / scroll-area / label
+
 Tabs: Trigger -> Tab, Content -> Panel, `aria-disabled:*` added. Collapsible:
 Content -> Panel. Progress: new Track/Label/Value parts; primitive computes
 fill (drop the manual translateX). Separator: callable, `decorative` dropped.
@@ -212,6 +227,7 @@ Scroll-area: Scrollbar/Thumb renames only. Label: no primitive; native
 `<label>`.
 
 ### navigation-menu
+
 Viewport moves out of Root into `Portal > Positioner > Popup > Viewport`
 (our NavigationMenuPositioner). Indicator -> Icon. `viewport` boolean prop
 removed; `align` forwarded to Positioner. New `data-instant`,
@@ -219,6 +235,7 @@ removed; `align` forwarded to Positioner. New `data-instant`,
 `--popup-height/width`.
 
 ### breadcrumb / marker (Slot users)
+
 `Slot.Root` + `asChild` -> `useRender` + `mergeProps`
 (`useRender.ComponentProps<"a">`, `render` prop, `state.slot`).
 
@@ -239,18 +256,24 @@ removed; `align` forwarded to Positioner. New `data-instant`,
 ## Slot -> useRender: WORKED EXAMPLE (avoid the mergeProps pitfall)
 
 Radix:
+
 ```tsx
-import { Slot } from "radix-ui"
-function BreadcrumbLink({ asChild, className, ...props }: React.ComponentProps<"a"> & { asChild?: boolean }) {
-  const Comp = asChild ? Slot.Root : "a"
-  return <Comp data-slot="breadcrumb-link" className={cn("...", className)} {...props} />
+import { Slot } from "radix-ui";
+function BreadcrumbLink({
+  asChild,
+  className,
+  ...props
+}: React.ComponentProps<"a"> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot.Root : "a";
+  return <Comp data-slot="breadcrumb-link" className={cn("...", className)} {...props} />;
 }
 ```
 
 Base UI:
+
 ```tsx
-import { mergeProps } from "@base-ui/react/merge-props"
-import { useRender } from "@base-ui/react/use-render"
+import { mergeProps } from "@base-ui/react/merge-props";
+import { useRender } from "@base-ui/react/use-render";
 
 function BreadcrumbLink({ className, render, ...props }: useRender.ComponentProps<"a">) {
   return useRender({
@@ -260,14 +283,18 @@ function BreadcrumbLink({ className, render, ...props }: useRender.ComponentProp
       // PITFALL: data-* attributes fail excess-property checking when passed
       // as an object literal into mergeProps (they are only special-cased in
       // JSX). Cast the literal:
-      { "data-slot": "breadcrumb-link", className: cn("...", className) } as React.ComponentProps<"a">,
-      props
+      {
+        "data-slot": "breadcrumb-link",
+        className: cn("...", className),
+      } as React.ComponentProps<"a">,
+      props,
     ),
-  })
+  });
 }
 ```
 
 Two rules:
+
 1. This pattern is ONLY for non-button polymorphic components (breadcrumb
    link, marker, badge, item...). `button.tsx` migrates to the real
    `@base-ui/react/button` primitive, which accepts `render` natively.
diff --git a/.agents/skills/migrate-radix-to-base/wrapper-shapes.md b/.agents/skills/migrate-radix-to-base/wrapper-shapes.md
index 58227ad..a17a22a 100644
--- a/.agents/skills/migrate-radix-to-base/wrapper-shapes.md
+++ b/.agents/skills/migrate-radix-to-base/wrapper-shapes.md
@@ -34,7 +34,7 @@ non-button polymorphic components (breadcrumb link, marker).
   className={cn(
     "cn-tooltip-arrow cn-tooltip-arrow-logical",
     "data-[side=bottom]:top-1 data-[side=left]:right-[-13px] data-[side=left]:top-1/2! data-[side=left]:-translate-y-1/2 data-[side=right]:left-[-13px] data-[side=right]:top-1/2! data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5",
-    className
+    className,
   )}
 />
 ```
@@ -58,7 +58,7 @@ function DropdownMenuSubContent(props) {
       className={cn("w-auto", props.className)}
       {...props}
     />
-  )
+  );
 }
 ```
 
@@ -70,10 +70,11 @@ styling) rather than composing. When a golden pair exists, copy the golden
 shape; this example is the fallback.
 
 DANGER — do not confuse SubContent defaults with main-Content defaults. The
-values above are ONLY for the *submenu* wrappers (DropdownMenuSubContent /
+values above are ONLY for the _submenu_ wrappers (DropdownMenuSubContent /
 ContextMenuSubContent). The MAIN ContextMenuContent (the pointer-anchored
 right-click menu) keeps its own positioning — do NOT apply
 `side="right"`/`alignOffset` to it, or every right-click menu mispositions.
+
 - ContextMenu SUBContent defaults: `align="start" alignOffset={4} side="right" sideOffset={0}`.
 - DropdownMenu SUBContent defaults: `align="start" alignOffset={-3} side="right" sideOffset={0}`.
 - Main Content (either): keep the wrapper's existing align/sideOffset; do not add a side.
@@ -93,8 +94,8 @@ class existed; the open styling was previously data-[state=open]).
 - Drop the radix `position` prop entirely; expose `alignItemWithTrigger`
   (default true) picked from Positioner.Props, `sideOffset = 4`.
 - Item anatomy: `ItemText` FIRST with `cn-select-item-text shrink-0
-  whitespace-nowrap`, then `ItemIndicator render={<span
-  className="cn-select-item-indicator" />}`.
+whitespace-nowrap`, then `ItemIndicator render={<span
+className="cn-select-item-indicator" />}`.
 - Scroll arrows get `top-0 w-full` / `bottom-0 w-full`; List has no classes.
 
 ## Accordion animation placement
diff --git a/.agents/skills/shadcn/SKILL.md b/.agents/skills/shadcn/SKILL.md
index 1b4c414..800606b 100644
--- a/.agents/skills/shadcn/SKILL.md
+++ b/.agents/skills/shadcn/SKILL.md
@@ -137,7 +137,7 @@ These are the most common patterns that differentiate correct shadcn/ui code. Fo
 | Data display               | `Table`, `Card`, `Badge`, `Avatar`                                                                  |
 | Navigation                 | `Sidebar`, `NavigationMenu`, `Breadcrumb`, `Tabs`, `Pagination`                                     |
 | Overlays                   | `Dialog` (modal), `Sheet` (side panel), `Drawer` (bottom sheet), `AlertDialog` (confirmation)       |
-| Feedback                   | `toast` (Base UI), `sonner` (Radix/Aria), `Alert`, `Progress`, `Skeleton`, `Spinner`                 |
+| Feedback                   | `toast` (Base UI), `sonner` (Radix/Aria), `Alert`, `Progress`, `Skeleton`, `Spinner`                |
 | Command palette            | `Command` inside `Dialog`                                                                           |
 | Charts                     | `Chart` (wraps Recharts)                                                                            |
 | Layout                     | `Card`, `Separator`, `Resizable`, `ScrollArea`, `Accordion`, `Collapsible`                          |
diff --git a/.agents/skills/shadcn/cli.md b/.agents/skills/shadcn/cli.md
index 8a1d195..39a58fc 100644
--- a/.agents/skills/shadcn/cli.md
+++ b/.agents/skills/shadcn/cli.md
@@ -138,14 +138,14 @@ Supports namespaces (`@acme`), public GitHub registry sources (`owner/repo`),
 and registry catalog URLs. Without `-q`, lists all items. When no registries are
 passed, searches every registry configured in `components.json`.
 
-| Flag                | Short | Description                                       | Default |
-| ------------------- | ----- | ------------------------------------------------- | ------- |
-| `--query <query>`   | `-q`  | Search query                                      | —       |
+| Flag                | Short | Description                                                       | Default |
+| ------------------- | ----- | ----------------------------------------------------------------- | ------- |
+| `--query <query>`   | `-q`  | Search query                                                      | —       |
 | `--type <type>`     | `-t`  | Filter by item type (e.g. `ui`, `block`, `hook`); comma-separated | —       |
-| `--limit <number>`  | `-l`  | Max items to display                              | `100`   |
-| `--offset <number>` | `-o`  | Items to skip                                     | `0`     |
-| `--json`            |       | Output as JSON                                    | `false` |
-| `--cwd <cwd>`       | `-c`  | Working directory                                 | current |
+| `--limit <number>`  | `-l`  | Max items to display                                              | `100`   |
+| `--offset <number>` | `-o`  | Items to skip                                                     | `0`     |
+| `--json`            |       | Output as JSON                                                    | `false` |
+| `--cwd <cwd>`       | `-c`  | Working directory                                                 | current |
 
 ### `view` — View item details
 
diff --git a/.agents/skills/shadcn/customization.md b/.agents/skills/shadcn/customization.md
index 16954f5..2c76e4a 100644
--- a/.agents/skills/shadcn/customization.md
+++ b/.agents/skills/shadcn/customization.md
@@ -52,11 +52,11 @@ Colors use OKLCH: `--primary: oklch(0.205 0 0)` where values are lightness (0–
 Class-based toggle via `.dark` on the root element. In Next.js, use `next-themes`:
 
 ```tsx
-import { ThemeProvider } from "next-themes"
+import { ThemeProvider } from "next-themes";
 
 <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
   {children}
-</ThemeProvider>
+</ThemeProvider>;
 ```
 
 ---
@@ -117,12 +117,11 @@ module.exports = {
     extend: {
       colors: {
         warning: "oklch(var(--warning) / <alpha-value>)",
-        "warning-foreground":
-          "oklch(var(--warning-foreground) / <alpha-value>)",
+        "warning-foreground": "oklch(var(--warning-foreground) / <alpha-value>)",
       },
     },
   },
-}
+};
 ```
 
 ```tsx
@@ -187,7 +186,7 @@ export function ConfirmDialog({ title, description, onConfirm, children }) {
         </AlertDialogFooter>
       </AlertDialogContent>
     </AlertDialog>
-  )
+  );
 }
 ```
 
diff --git a/.agents/skills/shadcn/rules/base-vs-radix.md b/.agents/skills/shadcn/rules/base-vs-radix.md
index c1ed7d1..36b84da 100644
--- a/.agents/skills/shadcn/rules/base-vs-radix.md
+++ b/.agents/skills/shadcn/rules/base-vs-radix.md
@@ -90,7 +90,9 @@ Same for triggers whose `render` is not a `Button`:
 
 ```tsx
 <Select>
-  <SelectTrigger><SelectValue placeholder="Select a fruit" /></SelectTrigger>
+  <SelectTrigger>
+    <SelectValue placeholder="Select a fruit" />
+  </SelectTrigger>
 </Select>
 ```
 
@@ -157,7 +159,7 @@ Base supports `multiple`, render-function children on `SelectValue`, and object
 <Select items={items} multiple defaultValue={[]}>
   <SelectTrigger>
     <SelectValue>
-      {(value: string[]) => value.length === 0 ? "Select fruits" : `${value.length} selected`}
+      {(value: string[]) => (value.length === 0 ? "Select fruits" : `${value.length} selected`)}
     </SelectValue>
   </SelectTrigger>
   ...
diff --git a/.agents/skills/shadcn/rules/chat.md b/.agents/skills/shadcn/rules/chat.md
index 8ce62fe..278e567 100644
--- a/.agents/skills/shadcn/rules/chat.md
+++ b/.agents/skills/shadcn/rules/chat.md
@@ -114,9 +114,7 @@ with absolutely-positioned `Badge`s.
 **Incorrect:**
 
 ```tsx
-<div className="w-fit rounded-2xl bg-primary px-3 py-2 text-primary-foreground">
-  {text}
-</div>
+<div className="w-fit rounded-2xl bg-primary px-3 py-2 text-primary-foreground">{text}</div>
 ```
 
 **Correct:**
diff --git a/.agents/skills/shadcn/rules/composition.md b/.agents/skills/shadcn/rules/composition.md
index a8aa427..6e180e6 100644
--- a/.agents/skills/shadcn/rules/composition.md
+++ b/.agents/skills/shadcn/rules/composition.md
@@ -44,17 +44,17 @@ Never render items directly inside the content container.
 
 This applies to all group-based components:
 
-| Item | Group |
-|------|-------|
-| `SelectItem`, `SelectLabel` | `SelectGroup` |
-| `DropdownMenuItem`, `DropdownMenuLabel`, `DropdownMenuSub` | `DropdownMenuGroup` |
-| `MenubarItem` | `MenubarGroup` |
-| `ContextMenuItem` | `ContextMenuGroup` |
-| `CommandItem` | `CommandGroup` |
-| `MessageScrollerItem` | `MessageScrollerContent` |
-| `Message` (consecutive, same sender) | `MessageGroup` |
-| `Bubble` (stacked) | `BubbleGroup` |
-| `Attachment` (in a row) | `AttachmentGroup` |
+| Item                                                       | Group                    |
+| ---------------------------------------------------------- | ------------------------ |
+| `SelectItem`, `SelectLabel`                                | `SelectGroup`            |
+| `DropdownMenuItem`, `DropdownMenuLabel`, `DropdownMenuSub` | `DropdownMenuGroup`      |
+| `MenubarItem`                                              | `MenubarGroup`           |
+| `ContextMenuItem`                                          | `ContextMenuGroup`       |
+| `CommandItem`                                              | `CommandGroup`           |
+| `MessageScrollerItem`                                      | `MessageScrollerContent` |
+| `Message` (consecutive, same sender)                       | `MessageGroup`           |
+| `Bubble` (stacked)                                         | `BubbleGroup`            |
+| `Attachment` (in a row)                                    | `AttachmentGroup`        |
 
 Chat components nest in a fixed order (`MessageScrollerProvider` → `MessageScroller` → `MessageScrollerViewport` → `MessageScrollerContent` → `MessageScrollerItem`). See [chat.md](./chat.md).
 
@@ -76,7 +76,9 @@ Chat components nest in a fixed order (`MessageScrollerProvider` → `MessageScr
 ```tsx
 <Empty>
   <EmptyHeader>
-    <EmptyMedia variant="icon"><FolderIcon /></EmptyMedia>
+    <EmptyMedia variant="icon">
+      <FolderIcon />
+    </EmptyMedia>
     <EmptyTitle>No projects yet</EmptyTitle>
     <EmptyDescription>Get started by creating a new project.</EmptyDescription>
   </EmptyHeader>
@@ -93,37 +95,37 @@ Chat components nest in a fixed order (`MessageScrollerProvider` → `MessageScr
 For Base UI projects, use the `toast` component:
 
 ```tsx
-import { toast } from "@/components/ui/toast"
+import { toast } from "@/components/ui/toast";
 
 toast.add({
   title: "Changes saved.",
-})
+});
 ```
 
 For Radix and React Aria projects, use Sonner:
 
 ```tsx
-import { toast } from "sonner"
+import { toast } from "sonner";
 
-toast.success("Changes saved.")
-toast.error("Something went wrong.")
+toast.success("Changes saved.");
+toast.error("Something went wrong.");
 toast("File deleted.", {
   action: { label: "Undo", onClick: () => undoDelete() },
-})
+});
 ```
 
 ---
 
 ## Choosing between overlay components
 
-| Use case | Component |
-|----------|-----------|
-| Focused task that requires input | `Dialog` |
-| Destructive action confirmation | `AlertDialog` |
-| Side panel with details or filters | `Sheet` |
-| Mobile-first bottom panel | `Drawer` |
-| Quick info on hover | `HoverCard` |
-| Small contextual content on click | `Popover` |
+| Use case                           | Component     |
+| ---------------------------------- | ------------- |
+| Focused task that requires input   | `Dialog`      |
+| Destructive action confirmation    | `AlertDialog` |
+| Side panel with details or filters | `Sheet`       |
+| Mobile-first bottom panel          | `Drawer`      |
+| Quick info on hover                | `HoverCard`   |
+| Small contextual content on click  | `Popover`     |
 
 ---
 
@@ -206,8 +208,8 @@ Always include `AvatarFallback` for when the image fails to load:
 
 ## Use existing components instead of custom markup
 
-| Instead of | Use |
-|---|---|
-| `<hr>` or `<div className="border-t">` | `<Separator />` |
+| Instead of                                         | Use                                  |
+| -------------------------------------------------- | ------------------------------------ |
+| `<hr>` or `<div className="border-t">`             | `<Separator />`                      |
 | `<div className="animate-pulse">` with styled divs | `<Skeleton className="h-4 w-3/4" />` |
-| `<span className="rounded-full bg-green-100 ...">` | `<Badge variant="secondary">` |
+| `<span className="rounded-full bg-green-100 ...">` | `<Badge variant="secondary">`        |
diff --git a/.agents/skills/shadcn/rules/forms.md b/.agents/skills/shadcn/rules/forms.md
index f451e2f..6205d64 100644
--- a/.agents/skills/shadcn/rules/forms.md
+++ b/.agents/skills/shadcn/rules/forms.md
@@ -59,11 +59,11 @@ Never use raw `Input` or `Textarea` inside an `InputGroup`.
 **Correct:**
 
 ```tsx
-import { InputGroup, InputGroupInput } from "@/components/ui/input-group"
+import { InputGroup, InputGroupInput } from "@/components/ui/input-group";
 
 <InputGroup>
   <InputGroupInput placeholder="Search..." />
-</InputGroup>
+</InputGroup>;
 ```
 
 ---
@@ -86,7 +86,7 @@ Never place a `Button` directly inside or adjacent to an `Input` with custom pos
 **Correct:**
 
 ```tsx
-import { InputGroup, InputGroupInput, InputGroupAddon } from "@/components/ui/input-group"
+import { InputGroup, InputGroupInput, InputGroupAddon } from "@/components/ui/input-group";
 
 <InputGroup>
   <InputGroupInput placeholder="Search..." />
@@ -95,7 +95,7 @@ import { InputGroup, InputGroupInput, InputGroupAddon } from "@/components/ui/in
       <SearchIcon data-icon="inline-start" />
     </Button>
   </InputGroupAddon>
-</InputGroup>
+</InputGroup>;
 ```
 
 ---
@@ -125,13 +125,13 @@ const [selected, setSelected] = useState("daily")
 **Correct:**
 
 ```tsx
-import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
+import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";
 
 <ToggleGroup spacing={2}>
   <ToggleGroupItem value="daily">Daily</ToggleGroupItem>
   <ToggleGroupItem value="weekly">Weekly</ToggleGroupItem>
   <ToggleGroupItem value="monthly">Monthly</ToggleGroupItem>
-</ToggleGroup>
+</ToggleGroup>;
 ```
 
 Combine with `Field` for labelled toggle groups:
@@ -162,7 +162,9 @@ Use `FieldSet` + `FieldLegend` for related checkboxes, radios, or switches — n
   <FieldGroup className="gap-3">
     <Field orientation="horizontal">
       <Checkbox id="dark" />
-      <FieldLabel htmlFor="dark" className="font-normal">Dark mode</FieldLabel>
+      <FieldLabel htmlFor="dark" className="font-normal">
+        Dark mode
+      </FieldLabel>
     </Field>
   </FieldGroup>
 </FieldSet>
diff --git a/.agents/skills/shadcn/rules/icons.md b/.agents/skills/shadcn/rules/icons.md
index bba8102..3b5dcf3 100644
--- a/.agents/skills/shadcn/rules/icons.md
+++ b/.agents/skills/shadcn/rules/icons.md
@@ -77,25 +77,25 @@ Use `icon={CheckIcon}`, not a string key to a lookup map.
 const iconMap = {
   check: CheckIcon,
   alert: AlertIcon,
-}
+};
 
 function StatusBadge({ icon }: { icon: string }) {
-  const Icon = iconMap[icon]
-  return <Icon />
+  const Icon = iconMap[icon];
+  return <Icon />;
 }
 
-<StatusBadge icon="check" />
+<StatusBadge icon="check" />;
 ```
 
 **Correct:**
 
 ```tsx
 // Import from the project's configured iconLibrary (e.g. lucide-react, @tabler/icons-react).
-import { CheckIcon } from "lucide-react"
+import { CheckIcon } from "lucide-react";
 
 function StatusBadge({ icon: Icon }: { icon: React.ComponentType }) {
-  return <Icon />
+  return <Icon />;
 }
 
-<StatusBadge icon={CheckIcon} />
+<StatusBadge icon={CheckIcon} />;
 ```
diff --git a/.agents/skills/shadcn/rules/styling.md b/.agents/skills/shadcn/rules/styling.md
index fe75197..d7e62b7 100644
--- a/.agents/skills/shadcn/rules/styling.md
+++ b/.agents/skills/shadcn/rules/styling.md
@@ -66,9 +66,7 @@ If you need a success/positive color that doesn't exist as a semantic token, use
 **Incorrect:**
 
 ```tsx
-<Button className="border border-input bg-transparent hover:bg-accent">
-  Click me
-</Button>
+<Button className="border border-input bg-transparent hover:bg-accent">Click me</Button>
 ```
 
 **Correct:**
@@ -100,6 +98,7 @@ Use `className` for layout (e.g. `max-w-md`, `mx-auto`, `mt-4`), **not** for ove
 ```
 
 To customize a component's appearance, prefer these approaches in order:
+
 1. **Built-in variants** — `variant="outline"`, `variant="destructive"`, etc.
 2. **Semantic color tokens** — `bg-primary`, `text-muted-foreground`.
 3. **CSS variables** — define custom colors in the global CSS file (see [customization.md](../customization.md)).
diff --git a/.gitleaks.toml b/.gitleaks.toml
index b00e575..68f4848 100644
--- a/.gitleaks.toml
+++ b/.gitleaks.toml
@@ -5,10 +5,7 @@ useDefault = true
 
 [[allowlists]]
 description = "Repository files that intentionally contain secret-like patterns"
-paths = [
-  '''(^|/)\.gitleaks\.toml$''',
-  '''(^|/)pnpm-lock\.yaml$''',
-]
+paths = ['''(^|/)\.gitleaks\.toml$''', '''(^|/)pnpm-lock\.yaml$''']
 
 [[rules]]
 id = "alibaba-cloud-access-key-id"
diff --git a/.oxlintrc.json b/.oxlintrc.json
deleted file mode 100644
index 98bb34c..0000000
--- a/.oxlintrc.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
-  "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "categories": {
-    "correctness": "error",
-    "suspicious": "off",
-    "perf": "off",
-    "style": "off"
-  },
-  "rules": {
-    "no-unused-vars": "error",
-    "unicorn/no-useless-fallback-in-spread": "off",
-    "unicorn/no-useless-spread": "off",
-    "no-console": "off",
-    "eqeqeq": "error",
-    "no-var": "error",
-    "prefer-const": "error"
-  },
-  "ignorePatterns": ["node_modules", "dist", "build", ".vite", "pnpm-lock.yaml", "*.db"]
-}
diff --git a/.husky/pre-commit b/.vite-hooks/pre-commit
similarity index 98%
rename from .husky/pre-commit
rename to .vite-hooks/pre-commit
index f5d6cde..644937d 100755
--- a/.husky/pre-commit
+++ b/.vite-hooks/pre-commit
@@ -18,3 +18,4 @@ fi
 
 echo "[gitleaks] scanning staged changes..."
 pnpm secrets:scan:staged
+vp staged
diff --git a/.husky/pre-push b/.vite-hooks/pre-push
similarity index 100%
rename from .husky/pre-push
rename to .vite-hooks/pre-push
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 645b516..1e0d3b3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,12 +19,12 @@ flowchart LR
   Verify --> PR[PR notes]
 ```
 
-| Step | Contributor task |
-| ---- | ---------------- |
-| Scope | Decide whether OpenSpec is required and identify affected systems, docs, wiki, and high-risk categories. |
-| Patch | Keep changes focused and update docs/tests with behavior. |
-| Verify | Run the full gate when feasible. |
-| PR | Include validation notes, documentation impact, and risk areas. |
+| Step   | Contributor task                                                                                         |
+| ------ | -------------------------------------------------------------------------------------------------------- |
+| Scope  | Decide whether OpenSpec is required and identify affected systems, docs, wiki, and high-risk categories. |
+| Patch  | Keep changes focused and update docs/tests with behavior.                                                |
+| Verify | Run the full gate when feasible.                                                                         |
+| PR     | Include validation notes, documentation impact, and risk areas.                                          |
 
 ## Local Validation
 
diff --git a/README.md b/README.md
index 5d931d8..e9e09f8 100644
--- a/README.md
+++ b/README.md
@@ -6,14 +6,14 @@ CNode（cnodejs.org）是 Node.js 中文专业社区，起源于 nodeclub。本
 
 ## Features
 
-| Area | Capabilities |
-| ---- | ------------- |
-| Web | React Router v7 SSR, Vite, Tailwind CSS v4, shadcn/ui |
-| API | Hono on Node.js, cookie auth, GitHub OAuth, legacy `accesstoken` compatibility |
-| Data | PostgreSQL-only Drizzle schema and Mongo-to-PostgreSQL migration tools |
-| Moderation | Keyword rules, scan jobs, audit-oriented admin workflows |
-| Delivery | Docker Compose production runbook and GHCR image workflow documentation |
-| Safety | Secret handling guidance, Gitleaks scan command, security reporting entry |
+| Area       | Capabilities                                                                   |
+| ---------- | ------------------------------------------------------------------------------ |
+| Web        | React Router v7 SSR, Vite, Tailwind CSS v4, shadcn/ui                          |
+| API        | Hono on Node.js, cookie auth, GitHub OAuth, legacy `accesstoken` compatibility |
+| Data       | PostgreSQL-only Drizzle schema and Mongo-to-PostgreSQL migration tools         |
+| Moderation | Keyword rules, scan jobs, audit-oriented admin workflows                       |
+| Delivery   | Docker Compose production runbook and GHCR image workflow documentation        |
+| Safety     | Secret handling guidance, Gitleaks scan command, security reporting entry      |
 
 Shared TypeScript and Zod contracts span Web and API. pnpm workspace manages the monorepo.
 
@@ -28,27 +28,27 @@ pnpm dev
 
 Local endpoints:
 
-| Service | URL |
-| ------- | --- |
-| Web | `http://localhost:5173` |
-| API | `http://localhost:3001` |
+| Service | URL                     |
+| ------- | ----------------------- |
+| Web     | `http://localhost:5173` |
+| API     | `http://localhost:3001` |
 
 Root `.env` is the single default local environment source. Do not commit real `.env` files or secrets. See [docs/conventions.md](docs/conventions.md) for documentation, development, and secret handling conventions.
 
 ## Documentation
 
-| Need | Start here |
-| ---- | ---------- |
-| Documentation and contribution conventions | [docs/conventions.md](docs/conventions.md) |
-| Architecture and runtime boundaries | [docs/architecture.md](docs/architecture.md) |
-| Local development and verification | [docs/development.md](docs/development.md) |
-| Production deployment | [deployment/README.md](deployment/README.md) |
-| PostgreSQL schema and migration rules | [docs/database.md](docs/database.md) |
-| Mongo-to-PostgreSQL migration background | [wiki/migration-background.md](wiki/migration-background.md) |
-| API reference | [api/openapi.json](api/openapi.json) (auto-generated, view at `/api` page) |
-| Content moderation | [docs/content-moderation.md](docs/content-moderation.md) |
-| Historical context and legacy behavior notes | [wiki/README.md](wiki/README.md) |
-| Security practices | [docs/security.md](docs/security.md), [SECURITY.md](SECURITY.md) |
+| Need                                         | Start here                                                                 |
+| -------------------------------------------- | -------------------------------------------------------------------------- |
+| Documentation and contribution conventions   | [docs/conventions.md](docs/conventions.md)                                 |
+| Architecture and runtime boundaries          | [docs/architecture.md](docs/architecture.md)                               |
+| Local development and verification           | [docs/development.md](docs/development.md)                                 |
+| Production deployment                        | [deployment/README.md](deployment/README.md)                               |
+| PostgreSQL schema and migration rules        | [docs/database.md](docs/database.md)                                       |
+| Mongo-to-PostgreSQL migration background     | [wiki/migration-background.md](wiki/migration-background.md)               |
+| API reference                                | [api/openapi.json](api/openapi.json) (auto-generated, view at `/api` page) |
+| Content moderation                           | [docs/content-moderation.md](docs/content-moderation.md)                   |
+| Historical context and legacy behavior notes | [wiki/README.md](wiki/README.md)                                           |
+| Security practices                           | [docs/security.md](docs/security.md), [SECURITY.md](SECURITY.md)           |
 
 ## Contributing
 
diff --git a/api/openapi.json b/api/openapi.json
index 62f35fa..1744aae 100644
--- a/api/openapi.json
+++ b/api/openapi.json
@@ -22,9 +22,7 @@
   "paths": {
     "/topics": {
       "get": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "获取话题列表",
         "description": "支持 page、limit、tab、mdrender 参数。",
         "parameters": [
@@ -78,9 +76,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -131,10 +127,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -158,11 +151,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -187,13 +176,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -216,11 +199,7 @@
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total"
-                  ]
+                  "required": ["success", "data", "total"]
                 }
               }
             }
@@ -228,9 +207,7 @@
         }
       },
       "post": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "创建话题",
         "description": "需要登录。新用户需通过 Turnstile 人机验证。",
         "requestBody": {
@@ -249,11 +226,7 @@
                   },
                   "tab": {
                     "type": "string",
-                    "enum": [
-                      "share",
-                      "ask",
-                      "job"
-                    ]
+                    "enum": ["share", "ask", "job"]
                   },
                   "content": {
                     "type": "string",
@@ -283,11 +256,7 @@
                       },
                       "remote": {
                         "type": "string",
-                        "enum": [
-                          "on-site",
-                          "hybrid",
-                          "remote"
-                        ]
+                        "enum": ["on-site", "hybrid", "remote"]
                       },
                       "salary_min": {
                         "type": "number",
@@ -312,20 +281,10 @@
                         "minLength": 1
                       }
                     },
-                    "required": [
-                      "company",
-                      "position",
-                      "location",
-                      "remote",
-                      "contact"
-                    ]
+                    "required": ["company", "position", "location", "remote", "contact"]
                   }
                 },
-                "required": [
-                  "title",
-                  "tab",
-                  "content"
-                ]
+                "required": ["title", "tab", "content"]
               }
             }
           }
@@ -340,18 +299,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "topic_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "topic_id"
-                  ]
+                  "required": ["success", "topic_id"]
                 }
               }
             }
@@ -365,9 +319,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -376,9 +328,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -392,9 +342,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -403,9 +351,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -419,9 +365,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -430,9 +374,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -442,9 +384,7 @@
     },
     "/topic/{topic_id}": {
       "get": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "获取话题详情",
         "description": "包含作者、回复和引用摘要。支持 mdrender 和 accesstoken 参数。",
         "parameters": [
@@ -484,9 +424,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -535,10 +473,7 @@
                               "type": "string"
                             }
                           },
-                          "required": [
-                            "loginname",
-                            "avatar_url"
-                          ]
+                          "required": ["loginname", "avatar_url"]
                         },
                         "job_meta": {
                           "type": "object",
@@ -562,11 +497,7 @@
                             },
                             "remote": {
                               "type": "string",
-                              "enum": [
-                                "on-site",
-                                "hybrid",
-                                "remote"
-                              ]
+                              "enum": ["on-site", "hybrid", "remote"]
                             },
                             "salary_min": {
                               "type": "number",
@@ -591,13 +522,7 @@
                               "minLength": 1
                             }
                           },
-                          "required": [
-                            "company",
-                            "position",
-                            "location",
-                            "remote",
-                            "contact"
-                          ]
+                          "required": ["company", "position", "location", "remote", "contact"]
                         },
                         "collect_count": {
                           "type": "number"
@@ -623,10 +548,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "content": {
                                 "type": "string"
@@ -661,10 +583,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "content_excerpt": {
                                     "type": "string"
@@ -673,12 +592,7 @@
                                     "type": "boolean"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "content_excerpt",
-                                  "deleted"
-                                ]
+                                "required": ["id", "author", "content_excerpt", "deleted"]
                               },
                               "is_uped": {
                                 "type": "boolean"
@@ -715,10 +629,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -732,9 +643,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -743,9 +652,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -759,9 +666,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -770,9 +675,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -782,9 +685,7 @@
     },
     "/topics/update": {
       "post": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "编辑话题",
         "description": "作者或管理员可编辑。锁定的话题仅管理员可编辑。",
         "requestBody": {
@@ -807,11 +708,7 @@
                   },
                   "tab": {
                     "type": "string",
-                    "enum": [
-                      "share",
-                      "ask",
-                      "job"
-                    ]
+                    "enum": ["share", "ask", "job"]
                   },
                   "content": {
                     "type": "string",
@@ -838,11 +735,7 @@
                       },
                       "remote": {
                         "type": "string",
-                        "enum": [
-                          "on-site",
-                          "hybrid",
-                          "remote"
-                        ]
+                        "enum": ["on-site", "hybrid", "remote"]
                       },
                       "salary_min": {
                         "type": "number",
@@ -867,21 +760,10 @@
                         "minLength": 1
                       }
                     },
-                    "required": [
-                      "company",
-                      "position",
-                      "location",
-                      "remote",
-                      "contact"
-                    ]
+                    "required": ["company", "position", "location", "remote", "contact"]
                   }
                 },
-                "required": [
-                  "topic_id",
-                  "title",
-                  "tab",
-                  "content"
-                ]
+                "required": ["topic_id", "title", "tab", "content"]
               }
             }
           }
@@ -896,18 +778,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "topic_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "topic_id"
-                  ]
+                  "required": ["success", "topic_id"]
                 }
               }
             }
@@ -921,9 +798,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -932,9 +807,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -948,9 +821,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -959,9 +830,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -975,9 +844,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -986,9 +853,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1002,9 +867,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1013,9 +876,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1025,9 +886,7 @@
     },
     "/topic/{topic_id}/replies": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "创建回复",
         "description": "创建线性回复，可传 reply_id 回复另一条回复。需要登录。",
         "parameters": [
@@ -1060,9 +919,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "content"
-                ]
+                "required": ["content"]
               }
             }
           }
@@ -1077,18 +934,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "reply_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "reply_id"
-                  ]
+                  "required": ["success", "reply_id"]
                 }
               }
             }
@@ -1102,9 +954,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1113,9 +963,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1129,9 +977,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1140,9 +986,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1156,9 +1000,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1167,9 +1009,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1183,9 +1023,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1194,9 +1032,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1206,9 +1042,7 @@
     },
     "/reply/{reply_id}": {
       "get": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "获取回复（编辑用）",
         "description": "获取回复详情用于编辑。需要登录且为作者或管理员。",
         "parameters": [
@@ -1239,9 +1073,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -1263,19 +1095,10 @@
                           "nullable": true
                         }
                       },
-                      "required": [
-                        "id",
-                        "topic_id",
-                        "content",
-                        "create_at",
-                        "update_at"
-                      ]
+                      "required": ["id", "topic_id", "content", "create_at", "update_at"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -1289,9 +1112,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1300,9 +1121,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1316,9 +1135,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1327,9 +1144,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1343,9 +1158,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1354,9 +1167,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1366,9 +1177,7 @@
     },
     "/reply/{reply_id}/edit": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "编辑回复",
         "description": "作者或管理员可编辑。锁定的话题仅管理员可编辑。",
         "parameters": [
@@ -1395,9 +1204,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "content"
-                ]
+                "required": ["content"]
               }
             }
           }
@@ -1412,18 +1219,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "reply_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "reply_id"
-                  ]
+                  "required": ["success", "reply_id"]
                 }
               }
             }
@@ -1437,9 +1239,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1448,9 +1248,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1464,9 +1262,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1475,9 +1271,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1491,9 +1285,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1502,9 +1294,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1518,9 +1308,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1529,9 +1317,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1541,9 +1327,7 @@
     },
     "/reply/{reply_id}/delete": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "删除回复",
         "description": "作者或管理员可删除。软删除。",
         "parameters": [
@@ -1580,18 +1364,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "status": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "status"
-                  ]
+                  "required": ["success", "status"]
                 }
               }
             }
@@ -1605,9 +1384,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1616,9 +1393,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1632,9 +1407,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1643,9 +1416,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1659,9 +1430,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1670,9 +1439,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1686,9 +1453,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1697,9 +1462,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1709,9 +1472,7 @@
     },
     "/reply/{reply_id}/ups": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "回复点赞/取消点赞",
         "description": "切换点赞状态。不能给自己的回复点赞（非 dev 模式）。",
         "parameters": [
@@ -1748,22 +1509,14 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "action": {
                       "type": "string",
-                      "enum": [
-                        "up",
-                        "down"
-                      ]
+                      "enum": ["up", "down"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "action"
-                  ]
+                  "required": ["success", "action"]
                 }
               }
             }
@@ -1777,9 +1530,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1788,9 +1539,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1804,9 +1553,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1815,9 +1562,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1831,9 +1576,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1842,9 +1585,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1854,9 +1595,7 @@
     },
     "/users/stars": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取星标用户",
         "responses": {
           "200": {
@@ -1868,9 +1607,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -1919,10 +1656,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -1932,9 +1666,7 @@
     },
     "/users/top100": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取积分前 100 用户",
         "responses": {
           "200": {
@@ -1946,9 +1678,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -1997,10 +1727,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -2010,9 +1737,7 @@
     },
     "/user/{loginname}/topics": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的话题列表",
         "parameters": [
           {
@@ -2055,9 +1780,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2108,10 +1831,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2135,11 +1855,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2164,13 +1880,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2236,12 +1946,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2255,9 +1960,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2266,9 +1969,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2278,9 +1979,7 @@
     },
     "/user/{loginname}/replies": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的回复列表",
         "parameters": [
           {
@@ -2323,9 +2022,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2376,10 +2073,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2403,11 +2097,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2432,13 +2122,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2504,12 +2188,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2523,9 +2202,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2534,9 +2211,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2546,9 +2221,7 @@
     },
     "/user/{loginname}/collections": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的收藏列表",
         "parameters": [
           {
@@ -2591,9 +2264,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2644,10 +2315,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2671,11 +2339,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2700,13 +2364,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2772,12 +2430,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2791,9 +2444,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2802,9 +2453,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2814,9 +2463,7 @@
     },
     "/user/{loginname}": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取用户详情",
         "parameters": [
           {
@@ -2838,9 +2485,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -2870,11 +2515,7 @@
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "enum": [
-                              "admin",
-                              "moderator",
-                              "recruiter"
-                            ]
+                            "enum": ["admin", "moderator", "recruiter"]
                           }
                         },
                         "create_at": {
@@ -2916,10 +2557,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "title": {
                                 "type": "string"
@@ -2929,12 +2567,7 @@
                                 "nullable": true
                               }
                             },
-                            "required": [
-                              "id",
-                              "author",
-                              "title",
-                              "last_reply_at"
-                            ]
+                            "required": ["id", "author", "title", "last_reply_at"]
                           }
                         },
                         "recent_replies": {
@@ -2955,10 +2588,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "title": {
                                 "type": "string"
@@ -2968,12 +2598,7 @@
                                 "nullable": true
                               }
                             },
-                            "required": [
-                              "id",
-                              "author",
-                              "title",
-                              "last_reply_at"
-                            ]
+                            "required": ["id", "author", "title", "last_reply_at"]
                           }
                         }
                       },
@@ -2997,10 +2622,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3014,9 +2636,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3025,9 +2645,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3037,9 +2655,7 @@
     },
     "/accesstoken": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "验证 accessToken",
         "requestBody": {
           "content": {
@@ -3051,9 +2667,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "accesstoken"
-                ]
+                "required": ["accesstoken"]
               }
             }
           }
@@ -3068,9 +2682,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "loginname": {
                       "type": "string"
@@ -3088,14 +2700,7 @@
                       "type": "boolean"
                     }
                   },
-                  "required": [
-                    "success",
-                    "loginname",
-                    "avatar_url",
-                    "id",
-                    "is_block",
-                    "is_muted"
-                  ]
+                  "required": ["success", "loginname", "avatar_url", "id", "is_block", "is_muted"]
                 }
               }
             }
@@ -3109,9 +2714,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3120,9 +2723,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3136,9 +2737,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3147,9 +2746,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3159,9 +2756,7 @@
     },
     "/user/refresh_token": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "刷新 accessToken",
         "responses": {
           "200": {
@@ -3173,18 +2768,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "accessToken": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "accessToken"
-                  ]
+                  "required": ["success", "accessToken"]
                 }
               }
             }
@@ -3198,9 +2788,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3209,9 +2797,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3221,9 +2807,7 @@
     },
     "/messages": {
       "get": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "获取消息列表",
         "parameters": [
           {
@@ -3254,9 +2838,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -3271,11 +2853,7 @@
                               },
                               "type": {
                                 "type": "string",
-                                "enum": [
-                                  "reply",
-                                  "reply2",
-                                  "at"
-                                ]
+                                "enum": ["reply", "reply2", "at"]
                               },
                               "has_read": {
                                 "type": "boolean"
@@ -3293,10 +2871,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "topic": {
                                 "type": "object",
@@ -3314,10 +2889,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "title": {
                                     "type": "string"
@@ -3327,12 +2899,7 @@
                                     "nullable": true
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "title",
-                                  "last_reply_at"
-                                ]
+                                "required": ["id", "author", "title", "last_reply_at"]
                               },
                               "reply": {
                                 "type": "object",
@@ -3353,12 +2920,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "content",
-                                  "ups",
-                                  "create_at"
-                                ]
+                                "required": ["id", "content", "ups", "create_at"]
                               }
                             },
                             "required": [
@@ -3382,11 +2944,7 @@
                               },
                               "type": {
                                 "type": "string",
-                                "enum": [
-                                  "reply",
-                                  "reply2",
-                                  "at"
-                                ]
+                                "enum": ["reply", "reply2", "at"]
                               },
                               "has_read": {
                                 "type": "boolean"
@@ -3404,10 +2962,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "topic": {
                                 "type": "object",
@@ -3425,10 +2980,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "title": {
                                     "type": "string"
@@ -3438,12 +2990,7 @@
                                     "nullable": true
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "title",
-                                  "last_reply_at"
-                                ]
+                                "required": ["id", "author", "title", "last_reply_at"]
                               },
                               "reply": {
                                 "type": "object",
@@ -3464,12 +3011,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "content",
-                                  "ups",
-                                  "create_at"
-                                ]
+                                "required": ["id", "content", "ups", "create_at"]
                               }
                             },
                             "required": [
@@ -3484,16 +3026,10 @@
                           }
                         }
                       },
-                      "required": [
-                        "has_read_messages",
-                        "hasnot_read_messages"
-                      ]
+                      "required": ["has_read_messages", "hasnot_read_messages"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3507,9 +3043,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3518,9 +3052,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3530,9 +3062,7 @@
     },
     "/message/count": {
       "get": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "获取未读消息数",
         "parameters": [
           {
@@ -3554,18 +3084,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3579,9 +3104,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3590,9 +3113,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3602,9 +3123,7 @@
     },
     "/message/mark_all": {
       "post": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "标记全部已读",
         "requestBody": {
           "content": {
@@ -3630,9 +3149,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "marked_msgs": {
                       "type": "array",
@@ -3643,16 +3160,11 @@
                             "type": "string"
                           }
                         },
-                        "required": [
-                          "id"
-                        ]
+                        "required": ["id"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "marked_msgs"
-                  ]
+                  "required": ["success", "marked_msgs"]
                 }
               }
             }
@@ -3666,9 +3178,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3677,9 +3187,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3689,9 +3197,7 @@
     },
     "/message/mark_one/{msg_id}": {
       "post": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "标记单条已读",
         "parameters": [
           {
@@ -3727,18 +3233,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "marked_msg_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "marked_msg_id"
-                  ]
+                  "required": ["success", "marked_msg_id"]
                 }
               }
             }
@@ -3752,9 +3253,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3763,9 +3262,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3775,9 +3272,7 @@
     },
     "/topic_collect/{loginname}": {
       "get": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "获取用户收藏列表",
         "parameters": [
           {
@@ -3799,9 +3294,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -3852,10 +3345,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -3879,11 +3369,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -3908,13 +3394,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -3934,10 +3414,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3951,9 +3428,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3962,9 +3437,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3974,9 +3447,7 @@
     },
     "/topic_collect/collect": {
       "post": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "收藏话题",
         "requestBody": {
           "content": {
@@ -3992,9 +3463,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "topic_id"
-                ]
+                "required": ["topic_id"]
               }
             }
           }
@@ -4009,14 +3478,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4030,9 +3495,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4041,9 +3504,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4057,9 +3518,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4068,9 +3527,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4084,9 +3541,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4095,9 +3550,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4107,9 +3560,7 @@
     },
     "/topic_collect/de_collect": {
       "post": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "取消收藏",
         "requestBody": {
           "content": {
@@ -4125,9 +3576,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "topic_id"
-                ]
+                "required": ["topic_id"]
               }
             }
           }
@@ -4142,14 +3591,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4163,9 +3608,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4174,9 +3617,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4190,9 +3631,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4201,9 +3640,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4213,9 +3650,7 @@
     },
     "/auth/local/login": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "本地登录",
         "requestBody": {
           "content": {
@@ -4232,10 +3667,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "name",
-                  "pass"
-                ]
+                "required": ["name", "pass"]
               }
             }
           }
@@ -4250,14 +3682,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4271,9 +3699,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4282,9 +3708,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4294,9 +3718,7 @@
     },
     "/auth/config": {
       "get": {
-        "tags": [
-          "system config"
-        ],
+        "tags": ["system config"],
         "summary": "获取公开认证配置",
         "responses": {
           "200": {
@@ -4308,9 +3730,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -4319,15 +3739,10 @@
                           "type": "boolean"
                         }
                       },
-                      "required": [
-                        "allow_signup"
-                      ]
+                      "required": ["allow_signup"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -4337,9 +3752,7 @@
     },
     "/auth/local/signup": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "本地注册",
         "requestBody": {
           "content": {
@@ -4366,11 +3779,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "loginname",
-                  "pass",
-                  "email"
-                ]
+                "required": ["loginname", "pass", "email"]
               }
             }
           }
@@ -4385,18 +3794,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4410,9 +3814,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4421,9 +3823,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4437,9 +3837,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4448,9 +3846,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4460,9 +3856,7 @@
     },
     "/auth/local/active_account": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "激活账号",
         "parameters": [
           {
@@ -4484,18 +3878,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4509,9 +3898,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4520,9 +3907,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4532,9 +3917,7 @@
     },
     "/auth/local/search_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "找回密码",
         "requestBody": {
           "content": {
@@ -4550,9 +3933,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "email"
-                ]
+                "required": ["email"]
               }
             }
           }
@@ -4567,18 +3948,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4592,9 +3968,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4603,9 +3977,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4619,9 +3991,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4630,9 +4000,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4642,9 +4010,7 @@
     },
     "/auth/local/reset_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "重置密码",
         "requestBody": {
           "content": {
@@ -4662,10 +4028,7 @@
                     "pattern": "[a-zA-Z]"
                   }
                 },
-                "required": [
-                  "key",
-                  "psw"
-                ]
+                "required": ["key", "psw"]
               }
             }
           }
@@ -4680,18 +4043,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4705,9 +4063,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4716,9 +4072,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4728,9 +4082,7 @@
     },
     "/auth/github/pending": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取 GitHub pending profile",
         "responses": {
           "200": {
@@ -4742,9 +4094,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -4762,17 +4112,10 @@
                           "type": "boolean"
                         }
                       },
-                      "required": [
-                        "loginname",
-                        "email",
-                        "email_exists"
-                      ]
+                      "required": ["loginname", "email", "email_exists"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -4786,9 +4129,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4797,9 +4138,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4809,9 +4148,7 @@
     },
     "/auth/github/create": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "GitHub 注册或关联",
         "requestBody": {
           "content": {
@@ -4843,14 +4180,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4864,9 +4197,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4875,9 +4206,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4891,9 +4220,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4902,9 +4229,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4918,9 +4243,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4929,9 +4252,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4945,9 +4266,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4956,9 +4275,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4968,9 +4285,7 @@
     },
     "/auth/github/unbind": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "解绑 GitHub",
         "requestBody": {
           "content": {
@@ -4983,9 +4298,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "password"
-                ],
+                "required": ["password"],
                 "additionalProperties": false
               }
             }
@@ -5001,14 +4314,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5022,9 +4331,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5033,9 +4340,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5049,9 +4354,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5060,9 +4363,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5076,9 +4377,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5087,9 +4386,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5103,9 +4400,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5114,9 +4409,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5126,9 +4419,7 @@
     },
     "/auth/signout": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "退出登录",
         "responses": {
           "200": {
@@ -5140,14 +4431,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5157,9 +4444,7 @@
     },
     "/auth/me": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取当前登录用户",
         "responses": {
           "200": {
@@ -5176,9 +4461,7 @@
                       "nullable": true
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5188,9 +4471,7 @@
     },
     "/auth/local/setting": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "更新个人资料",
         "requestBody": {
           "content": {
@@ -5234,14 +4515,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5255,9 +4532,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5266,9 +4541,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5278,9 +4551,7 @@
     },
     "/auth/local/change_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "修改密码",
         "requestBody": {
           "content": {
@@ -5295,10 +4566,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "oldPass",
-                  "newPass"
-                ]
+                "required": ["oldPass", "newPass"]
               }
             }
           }
@@ -5313,14 +4581,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5334,9 +4598,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5345,9 +4607,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5361,9 +4621,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5372,9 +4630,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5388,9 +4644,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5399,9 +4653,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5411,9 +4663,7 @@
     },
     "/upload/presign": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取图片上传预签名 URL",
         "requestBody": {
           "content": {
@@ -5445,9 +4695,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "url": {
                       "type": "string"
@@ -5468,14 +4716,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "url",
-                    "upload_url",
-                    "method",
-                    "headers",
-                    "filename"
-                  ]
+                  "required": ["success", "url", "upload_url", "method", "headers", "filename"]
                 }
               }
             }
@@ -5489,9 +4730,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5500,9 +4739,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5516,9 +4753,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5527,9 +4762,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5539,9 +4772,7 @@
     },
     "/admin/reports": {
       "post": {
-        "tags": [
-          "admin"
-        ],
+        "tags": ["admin"],
         "summary": "创建举报",
         "requestBody": {
           "content": {
@@ -5551,10 +4782,7 @@
                 "properties": {
                   "targetType": {
                     "type": "string",
-                    "enum": [
-                      "topic",
-                      "reply"
-                    ]
+                    "enum": ["topic", "reply"]
                   },
                   "targetId": {
                     "type": "integer",
@@ -5571,10 +4799,7 @@
                     "maxLength": 1000
                   }
                 },
-                "required": [
-                  "targetType",
-                  "targetId"
-                ]
+                "required": ["targetType", "targetId"]
               }
             }
           }
@@ -5589,14 +4814,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5610,9 +4831,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5621,9 +4840,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5637,9 +4854,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5648,9 +4863,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5664,9 +4877,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5675,9 +4886,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5687,9 +4896,7 @@
     },
     "/sidebar/home": {
       "get": {
-        "tags": [
-          "system config"
-        ],
+        "tags": ["system config"],
         "summary": "首页侧边栏数据",
         "responses": {
           "200": {
@@ -5701,9 +4908,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -5732,10 +4937,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "create_at": {
                                 "type": "string"
@@ -5772,12 +4974,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "id",
-                              "title",
-                              "tab",
-                              "create_at"
-                            ]
+                            "required": ["id", "title", "tab", "create_at"]
                           }
                         },
                         "top_users": {
@@ -5798,12 +4995,7 @@
                                 "type": "number"
                               }
                             },
-                            "required": [
-                              "id",
-                              "loginname",
-                              "avatar_url",
-                              "score"
-                            ]
+                            "required": ["id", "loginname", "avatar_url", "score"]
                           }
                         },
                         "partners": {
@@ -5821,11 +5013,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "name",
-                              "url",
-                              "description"
-                            ]
+                            "required": ["name", "url", "description"]
                           }
                         },
                         "resources": {
@@ -5840,10 +5028,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "name",
-                              "url"
-                            ]
+                            "required": ["name", "url"]
                           }
                         }
                       },
@@ -5856,10 +5041,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -5869,9 +5051,7 @@
     },
     "/zone/jobs": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "招聘专区列表",
         "parameters": [
           {
@@ -5933,9 +5113,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6022,11 +5200,7 @@
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total"
-                  ]
+                  "required": ["success", "data", "total"]
                 }
               }
             }
@@ -6036,9 +5210,7 @@
     },
     "/zone/jobs/facets": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "招聘专区 facet 聚合",
         "responses": {
           "200": {
@@ -6050,9 +5222,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -6070,16 +5240,10 @@
                           }
                         }
                       },
-                      "required": [
-                        "locations",
-                        "remote_options"
-                      ]
+                      "required": ["locations", "remote_options"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -6089,9 +5253,7 @@
     },
     "/zones": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "公开专区列表（仅 visible）",
         "responses": {
           "200": {
@@ -6103,9 +5265,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6136,20 +5296,11 @@
                             "type": "number"
                           }
                         },
-                        "required": [
-                          "id",
-                          "slug",
-                          "name",
-                          "visible",
-                          "sort_order"
-                        ]
+                        "required": ["id", "slug", "name", "visible", "sort_order"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -6159,9 +5310,7 @@
     },
     "/tabs": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "社区 tab 列表",
         "responses": {
           "200": {
@@ -6173,9 +5322,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6199,27 +5346,15 @@
                           },
                           "scope": {
                             "type": "string",
-                            "enum": [
-                              "public",
-                              "admin"
-                            ],
+                            "enum": ["public", "admin"],
                             "default": "public"
                           }
                         },
-                        "required": [
-                          "id",
-                          "key",
-                          "label",
-                          "visible",
-                          "sort_order"
-                        ]
+                        "required": ["id", "key", "label", "visible", "sort_order"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
diff --git a/apps/api/package.json b/apps/api/package.json
index 6ba3348..0e9d645 100644
--- a/apps/api/package.json
+++ b/apps/api/package.json
@@ -7,7 +7,7 @@
     "dev": "tsx watch src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
-    "test": "vitest run",
+    "test": "vp test run",
     "worker:moderation": "tsx src/worker/moderation-scan.ts",
     "typecheck": "tsc --noEmit",
     "gen:openapi": "tsx scripts/gen-openapi.ts"
@@ -45,6 +45,7 @@
     "@types/uuid": "^10.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
-    "vitest": "^4.1.10"
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
   }
 }
diff --git a/apps/api/src/lib/admin-governance.ts b/apps/api/src/lib/admin-governance.ts
index 83c7589..293dff8 100644
--- a/apps/api/src/lib/admin-governance.ts
+++ b/apps/api/src/lib/admin-governance.ts
@@ -19,7 +19,13 @@ export type AdminTopicFilters = {
   dateField: "create_at" | "update_at" | "last_reply_at";
   dateFrom: Date | null;
   dateTo: Date | null;
-  sort: "create_at_desc" | "update_at_desc" | "last_reply_at_desc" | "reply_count_desc" | "visit_count_desc" | "collect_count_desc";
+  sort:
+    | "create_at_desc"
+    | "update_at_desc"
+    | "last_reply_at_desc"
+    | "reply_count_desc"
+    | "visit_count_desc"
+    | "collect_count_desc";
 };
 
 function parseDateBound(value: string | null | undefined, endOfDay = false) {
@@ -32,11 +38,17 @@ function parseDateBound(value: string | null | undefined, endOfDay = false) {
   return date;
 }
 
-function enumValue<T extends string>(value: string | null | undefined, allowed: Set<string>, fallback: T): T {
+function enumValue<T extends string>(
+  value: string | null | undefined,
+  allowed: Set<string>,
+  fallback: T,
+): T {
   return value && allowed.has(value) ? (value as T) : fallback;
 }
 
-export function parseAdminTopicFilters(query: Record<string, string | null | undefined>): AdminTopicFilters {
+export function parseAdminTopicFilters(
+  query: Record<string, string | null | undefined>,
+): AdminTopicFilters {
   return {
     q: query.q?.trim() || "",
     tab: query.tab && query.tab !== "all" ? query.tab.trim() : "",
@@ -64,6 +76,9 @@ export function canRunJobBulkModerationAction(action: string, isAdmin: boolean)
 
 export function normalizePermanentTopicDeleteIds(body: any) {
   return Array.isArray(body?.ids)
-    ? body.ids.map(Number).filter((id: number) => id > 0).slice(0, 20)
+    ? body.ids
+        .map(Number)
+        .filter((id: number) => id > 0)
+        .slice(0, 20)
     : [Number(body?.id || body?.topic_id || 0)].filter((id) => id > 0);
 }
diff --git a/apps/api/src/lib/db.ts b/apps/api/src/lib/db.ts
index a13d43e..8c5d9ba 100644
--- a/apps/api/src/lib/db.ts
+++ b/apps/api/src/lib/db.ts
@@ -216,7 +216,9 @@ export const roleQueries = {
     const rows = await db
       .select({ id: userRoles.id })
       .from(userRoles)
-      .where(and(eq(userRoles.userId, userId), eq(userRoles.role, role), isNull(userRoles.revokedAt)))
+      .where(
+        and(eq(userRoles.userId, userId), eq(userRoles.role, role), isNull(userRoles.revokedAt)),
+      )
       .limit(1);
     return rows.length > 0;
   },
@@ -225,7 +227,14 @@ export const roleQueries = {
     const db = getDb();
     await db
       .insert(userRoles)
-      .values({ userId, role, grantedBy, reason: reason || null, createAt: new Date(), updateAt: new Date() })
+      .values({
+        userId,
+        role,
+        grantedBy,
+        reason: reason || null,
+        createAt: new Date(),
+        updateAt: new Date(),
+      })
       .onConflictDoNothing();
     return roleQueries.listByUserId(userId);
   },
@@ -235,7 +244,9 @@ export const roleQueries = {
     await db
       .update(userRoles)
       .set({ revokedAt: new Date(), updateAt: new Date() })
-      .where(and(eq(userRoles.userId, userId), eq(userRoles.role, role), isNull(userRoles.revokedAt)));
+      .where(
+        and(eq(userRoles.userId, userId), eq(userRoles.role, role), isNull(userRoles.revokedAt)),
+      );
     return roleQueries.listByUserId(userId);
   },
 };
@@ -377,7 +388,11 @@ export function buildTopicsByQuery(db: DB, where: any, opt?: any) {
   const limit = opt?.limit || 20;
   const offset = opt?.offset || 0;
   return q
-    .orderBy(desc(topics.top), sql`coalesce(${topics.lastReplyAt}, ${topics.createAt}) desc nulls last`, desc(topics.id))
+    .orderBy(
+      desc(topics.top),
+      sql`coalesce(${topics.lastReplyAt}, ${topics.createAt}) desc nulls last`,
+      desc(topics.id),
+    )
     .limit(limit)
     .offset(offset);
 }
@@ -408,57 +423,60 @@ export const replyQueries = {
   async createWithAggregates(content: string, topicId: number, authorId: number, replyId?: number) {
     const db = getDb();
     const store: ReplyCreationStore = {
-      transaction: (callback) => db.transaction(async (tx: DB) => callback({
-        async lockTopic(id) {
-          const rows = await tx
-            .select({ locked: topics.lock })
-            .from(topics)
-            .where(eq(topics.id, id))
-            .limit(1)
-            .for("update");
-          return rows[0] ? (rows[0].locked ? "locked" : "open") : null;
-        },
-        async insertReply(input) {
-          const now = new Date();
-          const [reply] = await tx
-            .insert(replies)
-            .values({ ...input, createAt: now, updateAt: now })
-            .returning();
-          return reply;
-        },
-        async incrementAuthor(id) {
-          await tx
-            .update(users)
-            .set({
-              score: sql`coalesce(${users.score}, 0) + 5`,
-              replyCount: sql`coalesce(${users.replyCount}, 0) + 1`,
-            })
-            .where(eq(users.id, id));
-        },
-        async readTopicAggregate(id) {
-          const [countRows, latestRows] = await Promise.all([
-            tx
-              .select({ value: count() })
-              .from(replies)
-              .where(and(eq(replies.topicId, id), boolEq(replies.deleted, false))),
-            tx
-              .select({ id: replies.id, createAt: replies.createAt })
-              .from(replies)
-              .where(and(eq(replies.topicId, id), boolEq(replies.deleted, false)))
-              .orderBy(sql`${replies.createAt} desc nulls last`, desc(replies.id))
-              .limit(1),
-          ]);
-          const latest = latestRows[0];
-          return {
-            replyCount: Number(countRows[0]?.value || 0),
-            lastReplyId: latest?.id ?? null,
-            lastReplyAt: latest?.createAt ?? null,
-          };
-        },
-        async writeTopicAggregate(id, aggregate) {
-          await tx.update(topics).set(aggregate).where(eq(topics.id, id));
-        },
-      })),
+      transaction: (callback) =>
+        db.transaction(async (tx: DB) =>
+          callback({
+            async lockTopic(id) {
+              const rows = await tx
+                .select({ locked: topics.lock })
+                .from(topics)
+                .where(eq(topics.id, id))
+                .limit(1)
+                .for("update");
+              return rows[0] ? (rows[0].locked ? "locked" : "open") : null;
+            },
+            async insertReply(input) {
+              const now = new Date();
+              const [reply] = await tx
+                .insert(replies)
+                .values({ ...input, createAt: now, updateAt: now })
+                .returning();
+              return reply;
+            },
+            async incrementAuthor(id) {
+              await tx
+                .update(users)
+                .set({
+                  score: sql`coalesce(${users.score}, 0) + 5`,
+                  replyCount: sql`coalesce(${users.replyCount}, 0) + 1`,
+                })
+                .where(eq(users.id, id));
+            },
+            async readTopicAggregate(id) {
+              const [countRows, latestRows] = await Promise.all([
+                tx
+                  .select({ value: count() })
+                  .from(replies)
+                  .where(and(eq(replies.topicId, id), boolEq(replies.deleted, false))),
+                tx
+                  .select({ id: replies.id, createAt: replies.createAt })
+                  .from(replies)
+                  .where(and(eq(replies.topicId, id), boolEq(replies.deleted, false)))
+                  .orderBy(sql`${replies.createAt} desc nulls last`, desc(replies.id))
+                  .limit(1),
+              ]);
+              const latest = latestRows[0];
+              return {
+                replyCount: Number(countRows[0]?.value || 0),
+                lastReplyId: latest?.id ?? null,
+                lastReplyAt: latest?.createAt ?? null,
+              };
+            },
+            async writeTopicAggregate(id, aggregate) {
+              await tx.update(topics).set(aggregate).where(eq(topics.id, id));
+            },
+          }),
+        ),
     };
     return createReplyWithStore(store, { content, topicId, authorId, replyId });
   },
@@ -482,61 +500,69 @@ export const replyQueries = {
   async deleteWithAggregates(replyId: number, actorId: number, isAdmin: boolean) {
     const db = getDb();
     const store: ReplyDeletionStore = {
-      transaction: (callback) => db.transaction(async (tx: DB) => callback({
-        async lockReply(id) {
-          const rows = await tx.select().from(replies).where(eq(replies.id, id)).limit(1).for("update");
-          return rows[0] || null;
-        },
-        async lockTopic(topicId) {
-          const rows = await tx
-            .select({ id: topics.id })
-            .from(topics)
-            .where(eq(topics.id, topicId))
-            .limit(1)
-            .for("update");
-          return rows.length > 0;
-        },
-        async markDeleted(id) {
-          const rows = await tx
-            .update(replies)
-            .set({ deleted: boolValue(true) } as any)
-            .where(and(eq(replies.id, id), boolEq(replies.deleted, false)))
-            .returning({ id: replies.id });
-          return rows.length > 0;
-        },
-        async decrementAuthor(authorId) {
-          await tx
-            .update(users)
-            .set({
-              score: sql`greatest(coalesce(${users.score}, 0) - 5, 0)`,
-              replyCount: sql`greatest(coalesce(${users.replyCount}, 0) - 1, 0)`,
-            })
-            .where(eq(users.id, authorId));
-        },
-        async readTopicAggregate(topicId) {
-          const [countRows, latestRows] = await Promise.all([
-            tx
-              .select({ value: count() })
-              .from(replies)
-              .where(and(eq(replies.topicId, topicId), boolEq(replies.deleted, false))),
-            tx
-              .select({ id: replies.id, createAt: replies.createAt })
-              .from(replies)
-              .where(and(eq(replies.topicId, topicId), boolEq(replies.deleted, false)))
-              .orderBy(sql`${replies.createAt} desc nulls last`, desc(replies.id))
-              .limit(1),
-          ]);
-          const latest = latestRows[0];
-          return {
-            replyCount: Number(countRows[0]?.value || 0),
-            lastReplyId: latest?.id ?? null,
-            lastReplyAt: latest?.createAt ?? null,
-          };
-        },
-        async writeTopicAggregate(topicId, aggregate) {
-          await tx.update(topics).set(aggregate).where(eq(topics.id, topicId));
-        },
-      })),
+      transaction: (callback) =>
+        db.transaction(async (tx: DB) =>
+          callback({
+            async lockReply(id) {
+              const rows = await tx
+                .select()
+                .from(replies)
+                .where(eq(replies.id, id))
+                .limit(1)
+                .for("update");
+              return rows[0] || null;
+            },
+            async lockTopic(topicId) {
+              const rows = await tx
+                .select({ id: topics.id })
+                .from(topics)
+                .where(eq(topics.id, topicId))
+                .limit(1)
+                .for("update");
+              return rows.length > 0;
+            },
+            async markDeleted(id) {
+              const rows = await tx
+                .update(replies)
+                .set({ deleted: boolValue(true) } as any)
+                .where(and(eq(replies.id, id), boolEq(replies.deleted, false)))
+                .returning({ id: replies.id });
+              return rows.length > 0;
+            },
+            async decrementAuthor(authorId) {
+              await tx
+                .update(users)
+                .set({
+                  score: sql`greatest(coalesce(${users.score}, 0) - 5, 0)`,
+                  replyCount: sql`greatest(coalesce(${users.replyCount}, 0) - 1, 0)`,
+                })
+                .where(eq(users.id, authorId));
+            },
+            async readTopicAggregate(topicId) {
+              const [countRows, latestRows] = await Promise.all([
+                tx
+                  .select({ value: count() })
+                  .from(replies)
+                  .where(and(eq(replies.topicId, topicId), boolEq(replies.deleted, false))),
+                tx
+                  .select({ id: replies.id, createAt: replies.createAt })
+                  .from(replies)
+                  .where(and(eq(replies.topicId, topicId), boolEq(replies.deleted, false)))
+                  .orderBy(sql`${replies.createAt} desc nulls last`, desc(replies.id))
+                  .limit(1),
+              ]);
+              const latest = latestRows[0];
+              return {
+                replyCount: Number(countRows[0]?.value || 0),
+                lastReplyId: latest?.id ?? null,
+                lastReplyAt: latest?.createAt ?? null,
+              };
+            },
+            async writeTopicAggregate(topicId, aggregate) {
+              await tx.update(topics).set(aggregate).where(eq(topics.id, topicId));
+            },
+          }),
+        ),
     };
     return deleteReplyWithStore(store, replyId, actorId, isAdmin);
   },
@@ -560,9 +586,7 @@ export const replyQueries = {
         .where(and(eq(replyUps.replyId, replyId), eq(replyUps.userId, userId)));
       return "down" as const;
     }
-    await db
-      .insert(replyUps)
-      .values({ replyId, userId, createAt: new Date() } as any);
+    await db.insert(replyUps).values({ replyId, userId, createAt: new Date() } as any);
     return "up" as const;
   },
 };
@@ -720,18 +744,21 @@ export const settingQueries = {
 };
 
 export const jobMetaQueries = {
-  async upsert(topicId: number, data: {
-    company: string;
-    companyLogo?: string | null;
-    position: string;
-    location: string;
-    remote: string;
-    salaryMin?: number | null;
-    salaryMax?: number | null;
-    experience?: string | null;
-    techTags?: string[];
-    contact: string;
-  }) {
+  async upsert(
+    topicId: number,
+    data: {
+      company: string;
+      companyLogo?: string | null;
+      position: string;
+      location: string;
+      remote: string;
+      salaryMin?: number | null;
+      salaryMax?: number | null;
+      experience?: string | null;
+      techTags?: string[];
+      contact: string;
+    },
+  ) {
     const db = getDb();
     await db
       .insert(jobMeta)
@@ -793,7 +820,9 @@ export const jobMetaQueries = {
     if (params.remote) conditions.push(eq(jobMeta.remote, params.remote));
     if (params.salaryMin) conditions.push(sql`${jobMeta.salaryMax} >= ${params.salaryMin}`);
     if (params.tags && params.tags.length > 0) {
-      conditions.push(sql`${jobMeta.techTags} && ${sql.raw(`ARRAY[${params.tags.map((t) => `'${t.replace(/'/g, "''")}'`).join(",")}]::text[]`)}`);
+      conditions.push(
+        sql`${jobMeta.techTags} && ${sql.raw(`ARRAY[${params.tags.map((t) => `'${t.replace(/'/g, "''")}'`).join(",")}]::text[]`)}`,
+      );
     }
     const where = and(...conditions);
     const listQuery = db
@@ -842,7 +871,9 @@ export const jobMetaQueries = {
     if (params.remote) conditions.push(eq(jobMeta.remote, params.remote));
     if (params.salaryMin) conditions.push(sql`${jobMeta.salaryMax} >= ${params.salaryMin}`);
     if (params.tags && params.tags.length > 0) {
-      conditions.push(sql`${jobMeta.techTags} && ${sql.raw(`ARRAY[${params.tags.map((t) => `'${t.replace(/'/g, "''")}'`).join(",")}]::text[]`)}`);
+      conditions.push(
+        sql`${jobMeta.techTags} && ${sql.raw(`ARRAY[${params.tags.map((t) => `'${t.replace(/'/g, "''")}'`).join(",")}]::text[]`)}`,
+      );
     }
     const where = and(...conditions);
     const result = await db
@@ -872,11 +903,7 @@ export const tabQueries = {
 
   async listVisible() {
     const db = getDb();
-    return db
-      .select()
-      .from(tabs)
-      .where(boolEq(tabs.visible, true))
-      .orderBy(tabs.sortOrder);
+    return db.select().from(tabs).where(boolEq(tabs.visible, true)).orderBy(tabs.sortOrder);
   },
 
   async updateById(id: number, data: { label?: string; visible?: boolean; sortOrder?: number }) {
@@ -902,7 +929,16 @@ export const zoneQueries = {
     return db.select().from(zones).where(boolEq(zones.visible, true)).orderBy(zones.sortOrder);
   },
 
-  async updateById(id: number, data: { name?: string; description?: string; icon?: string; visible?: boolean; sortOrder?: number }) {
+  async updateById(
+    id: number,
+    data: {
+      name?: string;
+      description?: string;
+      icon?: string;
+      visible?: boolean;
+      sortOrder?: number;
+    },
+  ) {
     const db = getDb();
     const update: any = { updateAt: new Date() };
     if (data.name !== undefined) update.name = data.name;
diff --git a/apps/api/src/lib/mail-template.tsx b/apps/api/src/lib/mail-template.tsx
index 27f907b..b68adcd 100644
--- a/apps/api/src/lib/mail-template.tsx
+++ b/apps/api/src/lib/mail-template.tsx
@@ -170,7 +170,12 @@ function CNodeEmailLayout({
           <Section style={styles.header}>
             <Row>
               <Column>
-                <Img src={logoUrl || absoluteWebUrl(CNODE_LOGO_LIGHT_PATH)} width="120" alt="CNode" style={styles.logo} />
+                <Img
+                  src={logoUrl || absoluteWebUrl(CNODE_LOGO_LIGHT_PATH)}
+                  width="120"
+                  alt="CNode"
+                  style={styles.logo}
+                />
               </Column>
               <Column style={styles.tagline}>Node.js 中文技术社区</Column>
             </Row>
diff --git a/apps/api/src/lib/message.ts b/apps/api/src/lib/message.ts
index 3ba668f..252e345 100644
--- a/apps/api/src/lib/message.ts
+++ b/apps/api/src/lib/message.ts
@@ -62,7 +62,13 @@ export async function sendReply2Message(
   });
 }
 
-export async function sendAtMessage(masterId: number, authorId: number, topicId: number, replyId: number, content = "") {
+export async function sendAtMessage(
+  masterId: number,
+  authorId: number,
+  topicId: number,
+  replyId: number,
+  content = "",
+) {
   if (masterId === authorId) return;
 
   const db = getDb();
@@ -74,7 +80,10 @@ export async function sendAtMessage(masterId: number, authorId: number, topicId:
     replyId,
     createAt: new Date(),
   });
-  const [master, topic] = await Promise.all([userQueries.getById(masterId), topicQueries.getById(topicId)]);
+  const [master, topic] = await Promise.all([
+    userQueries.getById(masterId),
+    topicQueries.getById(topicId),
+  ]);
   if (master?.receiveAtMail && master.email && topic) {
     await sendAtNotifyMail(
       master.email,
@@ -140,5 +149,8 @@ export async function updateMessagesToRead(userId: number, msgIds: number[]) {
 
 export async function updateOneMessageToRead(msgId: number) {
   const db = getDb();
-  await db.update(messages).set({ hasRead: boolValue(true) } as any).where(eq(messages.id, msgId));
+  await db
+    .update(messages)
+    .set({ hasRead: boolValue(true) } as any)
+    .where(eq(messages.id, msgId));
 }
diff --git a/apps/api/src/lib/moderation-scan.ts b/apps/api/src/lib/moderation-scan.ts
index d8cddf1..c3388df 100644
--- a/apps/api/src/lib/moderation-scan.ts
+++ b/apps/api/src/lib/moderation-scan.ts
@@ -2,7 +2,14 @@ import { and, asc, desc, eq, gt, inArray, lt, ne, sql } from "drizzle-orm";
 import { moderationHits, moderationScanJobs, replies, topics } from "@cnode/db";
 import { getDb } from "./db";
 import { boolEq } from "./db-compat";
-import { createHitDedupeKey, createHitPreview, incrementSensitiveWordHits, loadWords, matchContent, type SensitiveWordEntry } from "./moderation";
+import {
+  createHitDedupeKey,
+  createHitPreview,
+  incrementSensitiveWordHits,
+  loadWords,
+  matchContent,
+  type SensitiveWordEntry,
+} from "./moderation";
 import { getRedis } from "./redis";
 
 export type ScanScope = "topics" | "replies" | "all";
@@ -19,7 +26,9 @@ export function scanDefaults() {
   return {
     batchSize: Number(process.env.MODERATION_SCAN_BATCH_SIZE || DEFAULT_BATCH_SIZE),
     throttleMs: Number(process.env.MODERATION_SCAN_THROTTLE_MS || DEFAULT_THROTTLE_MS),
-    maxBatchesPerRun: Number(process.env.MODERATION_SCAN_MAX_BATCHES_PER_RUN || DEFAULT_MAX_BATCHES),
+    maxBatchesPerRun: Number(
+      process.env.MODERATION_SCAN_MAX_BATCHES_PER_RUN || DEFAULT_MAX_BATCHES,
+    ),
   };
 }
 
@@ -103,7 +112,12 @@ export async function createScheduledScanJobIfNeeded() {
   const existing = await db
     .select()
     .from(moderationScanJobs)
-    .where(and(eq(moderationScanJobs.reason, "scheduled"), inArray(moderationScanJobs.status, ["pending", "running", "paused"])))
+    .where(
+      and(
+        eq(moderationScanJobs.reason, "scheduled"),
+        inArray(moderationScanJobs.status, ["pending", "running", "paused"]),
+      ),
+    )
     .limit(1);
   if (existing.length) return null;
   const lastDone = await db
@@ -123,17 +137,29 @@ export async function createScheduledScanJobIfNeeded() {
 
 export async function listScanJobs(limit = 50) {
   const db = getDb();
-  return db.select().from(moderationScanJobs).orderBy(desc(moderationScanJobs.createAt)).limit(limit);
+  return db
+    .select()
+    .from(moderationScanJobs)
+    .orderBy(desc(moderationScanJobs.createAt))
+    .limit(limit);
 }
 
 export async function listPendingHits(limit = 100) {
   const db = getDb();
-  return db.select().from(moderationHits).where(eq(moderationHits.status, "pending")).orderBy(desc(moderationHits.scannedAt)).limit(limit);
+  return db
+    .select()
+    .from(moderationHits)
+    .where(eq(moderationHits.status, "pending"))
+    .orderBy(desc(moderationHits.scannedAt))
+    .limit(limit);
 }
 
 export async function pendingHitCount() {
   const db = getDb();
-  const rows = await db.select({ c: sql<number>`count(*)` }).from(moderationHits).where(eq(moderationHits.status, "pending"));
+  const rows = await db
+    .select({ c: sql<number>`count(*)` })
+    .from(moderationHits)
+    .where(eq(moderationHits.status, "pending"));
   return Number(rows[0]?.c || 0);
 }
 
@@ -143,7 +169,10 @@ export async function claimNextScanJob() {
     .select()
     .from(moderationScanJobs)
     .where(inArray(moderationScanJobs.status, ["running", "pending"]))
-    .orderBy(sql`case when ${moderationScanJobs.status} = 'running' then 0 else 1 end`, asc(moderationScanJobs.createAt))
+    .orderBy(
+      sql`case when ${moderationScanJobs.status} = 'running' then 0 else 1 end`,
+      asc(moderationScanJobs.createAt),
+    )
     .limit(1);
   const job = rows[0];
   if (!job) return null;
@@ -157,7 +186,11 @@ export async function claimNextScanJob() {
 
 export async function runScanJobNow(id: number) {
   const db = getDb();
-  const rows = await db.select().from(moderationScanJobs).where(eq(moderationScanJobs.id, id)).limit(1);
+  const rows = await db
+    .select()
+    .from(moderationScanJobs)
+    .where(eq(moderationScanJobs.id, id))
+    .limit(1);
   const job = rows[0];
   if (!job) return null;
   if (["done", "failed", "cancelled"].includes(job.status)) return job;
@@ -169,32 +202,50 @@ export async function runScanJobNow(id: number) {
       .returning();
     return updated || job;
   }
-  await db.update(moderationScanJobs).set({ updateAt: dateValue() } as any).where(eq(moderationScanJobs.id, id));
+  await db
+    .update(moderationScanJobs)
+    .set({ updateAt: dateValue() } as any)
+    .where(eq(moderationScanJobs.id, id));
   return job;
 }
 
 export async function cancelScanJob(id: number) {
   const db = getDb();
-  const rows = await db.select().from(moderationScanJobs).where(eq(moderationScanJobs.id, id)).limit(1);
+  const rows = await db
+    .select()
+    .from(moderationScanJobs)
+    .where(eq(moderationScanJobs.id, id))
+    .limit(1);
   const job = rows[0];
   if (!job) return null;
   if (["done", "failed", "cancelled"].includes(job.status)) return job;
   const [updated] = await db
     .update(moderationScanJobs)
     .set({ status: "cancelled", finishedAt: dateValue(), updateAt: dateValue() } as any)
-    .where(and(eq(moderationScanJobs.id, id), inArray(moderationScanJobs.status, ["pending", "running", "paused"])))
+    .where(
+      and(
+        eq(moderationScanJobs.id, id),
+        inArray(moderationScanJobs.status, ["pending", "running", "paused"]),
+      ),
+    )
     .returning();
   return updated || job;
 }
 
 export async function pauseScanJob(id: number) {
   const db = getDb();
-  await db.update(moderationScanJobs).set({ status: "paused", updateAt: dateValue() } as any).where(eq(moderationScanJobs.id, id));
+  await db
+    .update(moderationScanJobs)
+    .set({ status: "paused", updateAt: dateValue() } as any)
+    .where(eq(moderationScanJobs.id, id));
 }
 
 export async function resumeScanJob(id: number) {
   const db = getDb();
-  await db.update(moderationScanJobs).set({ status: "pending", updateAt: dateValue() } as any).where(eq(moderationScanJobs.id, id));
+  await db
+    .update(moderationScanJobs)
+    .set({ status: "pending", updateAt: dateValue() } as any)
+    .where(eq(moderationScanJobs.id, id));
 }
 
 export async function failScanJob(id: number, error: unknown) {
@@ -203,22 +254,38 @@ export async function failScanJob(id: number, error: unknown) {
   if (current?.status === "cancelled") return;
   await db
     .update(moderationScanJobs)
-    .set({ status: "failed", error: error instanceof Error ? error.message : String(error), finishedAt: dateValue(), updateAt: dateValue() } as any)
+    .set({
+      status: "failed",
+      error: error instanceof Error ? error.message : String(error),
+      finishedAt: dateValue(),
+      updateAt: dateValue(),
+    } as any)
     .where(eq(moderationScanJobs.id, id));
 }
 
 async function finishScanJob(id: number) {
   const db = getDb();
-  await db.update(moderationScanJobs).set({ status: "done", finishedAt: dateValue(), updateAt: dateValue() } as any).where(eq(moderationScanJobs.id, id));
+  await db
+    .update(moderationScanJobs)
+    .set({ status: "done", finishedAt: dateValue(), updateAt: dateValue() } as any)
+    .where(eq(moderationScanJobs.id, id));
 }
 
 async function refreshJob(id: number) {
   const db = getDb();
-  const rows = await db.select().from(moderationScanJobs).where(eq(moderationScanJobs.id, id)).limit(1);
+  const rows = await db
+    .select()
+    .from(moderationScanJobs)
+    .where(eq(moderationScanJobs.id, id))
+    .limit(1);
   return rows[0] || null;
 }
 
-async function updateScanJobProgress(id: number, topicResult: { scanned: number; hits: number; cursor: number }, replyResult: { scanned: number; hits: number; cursor: number }) {
+async function updateScanJobProgress(
+  id: number,
+  topicResult: { scanned: number; hits: number; cursor: number },
+  replyResult: { scanned: number; hits: number; cursor: number },
+) {
   const scanned = topicResult.scanned + replyResult.scanned;
   const hits = topicResult.hits + replyResult.hits;
   await getDb()
@@ -256,8 +323,17 @@ async function insertHit(data: {
   const db = getDb();
   const keywords = data.hits.map((hit) => hit.word);
   const keywordIds = data.hits.map((hit) => hit.keywordId).filter((id): id is number => !!id);
-  const dedupeKey = createHitDedupeKey(data.targetType, data.targetId, data.field, keywords.join("|"));
-  const existing = await db.select().from(moderationHits).where(eq(moderationHits.dedupeKey, dedupeKey)).limit(1);
+  const dedupeKey = createHitDedupeKey(
+    data.targetType,
+    data.targetId,
+    data.field,
+    keywords.join("|"),
+  );
+  const existing = await db
+    .select()
+    .from(moderationHits)
+    .where(eq(moderationHits.dedupeKey, dedupeKey))
+    .limit(1);
   if (existing[0]?.status === "confirmed") {
     await db
       .update(moderationHits)
@@ -315,7 +391,12 @@ async function scanTopicBatch(job: any, words: SensitiveWordEntry[]) {
     conditions.unshift(gt(topics.id, cursor));
   }
   const rows = await db
-    .select({ id: topics.id, title: topics.title, content: topics.content, authorId: topics.authorId })
+    .select({
+      id: topics.id,
+      title: topics.title,
+      content: topics.content,
+      authorId: topics.authorId,
+    })
     .from(topics)
     .where(and(...conditions))
     .orderBy(historical ? desc(topics.id) : asc(topics.id))
@@ -356,7 +437,12 @@ async function scanReplyBatch(job: any, words: SensitiveWordEntry[]) {
     conditions.unshift(gt(replies.id, cursor));
   }
   const rows = await db
-    .select({ id: replies.id, topicId: replies.topicId, content: replies.content, authorId: replies.authorId })
+    .select({
+      id: replies.id,
+      topicId: replies.topicId,
+      content: replies.content,
+      authorId: replies.authorId,
+    })
     .from(replies)
     .where(and(...conditions))
     .orderBy(historical ? desc(replies.id) : asc(replies.id))
@@ -393,17 +479,23 @@ export async function processScanBatch(job: any) {
   const scope = current.scope as ScanScope;
   const shouldScanTopics = scope === "topics" || scope === "all";
   const shouldScanReplies = scope === "replies" || scope === "all";
-  const topicResult = shouldScanTopics ? await scanTopicBatch(current, words) : { scanned: 0, hits: 0, cursor: Number(current.cursorTopicId || 0) };
+  const topicResult = shouldScanTopics
+    ? await scanTopicBatch(current, words)
+    : { scanned: 0, hits: 0, cursor: Number(current.cursorTopicId || 0) };
   const afterTopics = await refreshJob(current.id);
   if (!afterTopics || afterTopics.status !== "running") {
     const replyResult = { scanned: 0, hits: 0, cursor: Number(current.cursorReplyId || 0) };
     const progress = await updateScanJobProgress(current.id, topicResult, replyResult);
     return { done: true, ...progress };
   }
-  const replyResult = shouldScanReplies ? await scanReplyBatch(afterTopics || current, words) : { scanned: 0, hits: 0, cursor: Number(current.cursorReplyId || 0) };
+  const replyResult = shouldScanReplies
+    ? await scanReplyBatch(afterTopics || current, words)
+    : { scanned: 0, hits: 0, cursor: Number(current.cursorReplyId || 0) };
   const { scanned, hits } = await updateScanJobProgress(current.id, topicResult, replyResult);
 
-  const done = (!shouldScanTopics || topicResult.scanned === 0) && (!shouldScanReplies || replyResult.scanned === 0);
+  const done =
+    (!shouldScanTopics || topicResult.scanned === 0) &&
+    (!shouldScanReplies || replyResult.scanned === 0);
   if (done) {
     const latest = await refreshJob(current.id);
     if (latest?.status === "running") await finishScanJob(current.id);
@@ -447,15 +539,26 @@ export async function triggerScanDrain() {
   }
 }
 
-export async function handleModerationHit(id: number, action: "confirm" | "falsepositive" | "ignore", handlerId: number) {
+export async function handleModerationHit(
+  id: number,
+  action: "confirm" | "falsepositive" | "ignore",
+  handlerId: number,
+) {
   const db = getDb();
   const rows = await db.select().from(moderationHits).where(eq(moderationHits.id, id)).limit(1);
   const hit = rows[0];
   if (!hit) return null;
-  const status = action === "confirm" ? "confirmed" : action === "falsepositive" ? "false_positive" : "ignored";
+  const status =
+    action === "confirm" ? "confirmed" : action === "falsepositive" ? "false_positive" : "ignored";
   await db
     .update(moderationHits)
-    .set({ status, action, handledBy: handlerId, handledAt: dateValue(), updateAt: dateValue() } as any)
+    .set({
+      status,
+      action,
+      handledBy: handlerId,
+      handledAt: dateValue(),
+      updateAt: dateValue(),
+    } as any)
     .where(eq(moderationHits.id, id));
   return hit;
 }
diff --git a/apps/api/src/lib/moderation.ts b/apps/api/src/lib/moderation.ts
index 29f5da4..8affffc 100644
--- a/apps/api/src/lib/moderation.ts
+++ b/apps/api/src/lib/moderation.ts
@@ -49,7 +49,10 @@ export async function incrementSensitiveWordHits(hits: ContentHit[]) {
   if (!ids.length) return;
   const db = getDb();
   for (const id of ids) {
-    await db.update(sensitiveWords).set({ hitCount: sql`${sensitiveWords.hitCount} + 1` } as any).where(eq(sensitiveWords.id, id));
+    await db
+      .update(sensitiveWords)
+      .set({ hitCount: sql`${sensitiveWords.hitCount} + 1` } as any)
+      .where(eq(sensitiveWords.id, id));
   }
 }
 
@@ -77,6 +80,11 @@ export function createHitPreview(content: string, index: number, radius = 80): s
   return `${prefix}${content.slice(start, end)}${suffix}`;
 }
 
-export function createHitDedupeKey(targetType: string, targetId: number, field: string, keyword: string): string {
+export function createHitDedupeKey(
+  targetType: string,
+  targetId: number,
+  field: string,
+  keyword: string,
+): string {
   return `${targetType}:${targetId}:${field}:${keyword.toLowerCase()}`;
 }
diff --git a/apps/api/src/lib/penalty.ts b/apps/api/src/lib/penalty.ts
index 4cdbac6..1735981 100644
--- a/apps/api/src/lib/penalty.ts
+++ b/apps/api/src/lib/penalty.ts
@@ -21,13 +21,21 @@ export async function ensureMuteNotExpired(user: any) {
   const state = parsePenaltyState(user.level);
   if (state.muteUntil && Date.now() > state.muteUntil && !user.isBlock) {
     const nextLevel = JSON.stringify({ ...state, muteUntil: null });
-    await getDb().update(users).set({ isMuted: boolValue(false), level: nextLevel } as any).where(eq(users.id, user.id));
+    await getDb()
+      .update(users)
+      .set({ isMuted: boolValue(false), level: nextLevel } as any)
+      .where(eq(users.id, user.id));
     return { ...user, isMuted: false, level: nextLevel };
   }
   return user;
 }
 
-export async function applyProgressivePenalty(authorId: number, operatorId: number, operatorName: string, reason: string) {
+export async function applyProgressivePenalty(
+  authorId: number,
+  operatorId: number,
+  operatorName: string,
+  reason: string,
+) {
   const db = getDb();
   const user = (await db.select().from(users).where(eq(users.id, authorId)).limit(1))[0] as any;
   if (!user) return null;
@@ -52,6 +60,13 @@ export async function applyProgressivePenalty(authorId: number, operatorId: numb
   }
 
   await db.update(users).set(updates).where(eq(users.id, authorId));
-  await auditQueries.log(operatorId, operatorName, `progressive_penalty_${action}`, { type: "user", id: String(authorId), name: user.loginname }, "success", reason);
+  await auditQueries.log(
+    operatorId,
+    operatorName,
+    `progressive_penalty_${action}`,
+    { type: "user", id: String(authorId), name: user.loginname },
+    "success",
+    reason,
+  );
   return { action, strikes };
 }
diff --git a/apps/api/src/lib/redis.ts b/apps/api/src/lib/redis.ts
index 61e6c22..46ae88b 100644
--- a/apps/api/src/lib/redis.ts
+++ b/apps/api/src/lib/redis.ts
@@ -28,7 +28,9 @@ export function getRedis(): RedisClient {
     client = {
       get: (key: string) => instance.get(key),
       set: (key: string, value: string, mode?: string, seconds?: number) =>
-        seconds !== undefined ? (instance.set as any)(key, value, mode, seconds) : instance.set(key, value),
+        seconds !== undefined
+          ? (instance.set as any)(key, value, mode, seconds)
+          : instance.set(key, value),
       setex: (key: string, seconds: number, value: string) => instance.setex(key, seconds, value),
       setnx: (key: string, value: string) => instance.setnx(key, value),
       incr: (key: string) => instance.incr(key),
diff --git a/apps/api/src/lib/score.ts b/apps/api/src/lib/score.ts
index 092408c..ac15032 100644
--- a/apps/api/src/lib/score.ts
+++ b/apps/api/src/lib/score.ts
@@ -74,6 +74,8 @@ export async function decrementCollectTopicCount(userId: number) {
   const db = getDb();
   await db
     .update(users)
-    .set({ collectTopicCount: sql`case when ${users.collectTopicCount} - 1 < 0 then 0 else ${users.collectTopicCount} - 1 end` })
+    .set({
+      collectTopicCount: sql`case when ${users.collectTopicCount} - 1 < 0 then 0 else ${users.collectTopicCount} - 1 end`,
+    })
     .where(eq(users.id, userId));
 }
diff --git a/apps/api/src/lib/turnstile.ts b/apps/api/src/lib/turnstile.ts
index b283209..8c94a71 100644
--- a/apps/api/src/lib/turnstile.ts
+++ b/apps/api/src/lib/turnstile.ts
@@ -20,5 +20,9 @@ export async function verifyTurnstile(token: string | undefined, remoteIp?: stri
 }
 
 export function requestIp(c: any) {
-  return c.req.header("x-real-ip") || c.req.header("cf-connecting-ip") || c.req.header("x-forwarded-for")?.split(",")[0]?.trim();
+  return (
+    c.req.header("x-real-ip") ||
+    c.req.header("cf-connecting-ip") ||
+    c.req.header("x-forwarded-for")?.split(",")[0]?.trim()
+  );
 }
diff --git a/apps/api/src/load-env.ts b/apps/api/src/load-env.ts
index bbdc52e..6832089 100644
--- a/apps/api/src/load-env.ts
+++ b/apps/api/src/load-env.ts
@@ -24,7 +24,10 @@ function findWorkspaceRoot(cwd: string) {
 
 function parseValue(value: string) {
   const trimmed = value.trim();
-  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+  if (
+    (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+    (trimmed.startsWith("'") && trimmed.endsWith("'"))
+  ) {
     return trimmed.slice(1, -1);
   }
   return trimmed;
@@ -50,7 +53,9 @@ function loadEnvFile(path: string, protectedKeys: Set<string>, overrideLoaded: b
 
 function loadRootEnv() {
   const root = findWorkspaceRoot(import.meta.dirname);
-  const protectedKeys = new Set(Object.keys(process.env).filter((key) => process.env[key] !== undefined));
+  const protectedKeys = new Set(
+    Object.keys(process.env).filter((key) => process.env[key] !== undefined),
+  );
 
   loadEnvFile(resolve(root, ".env"), protectedKeys, false);
 
diff --git a/apps/api/src/middleware/auth.ts b/apps/api/src/middleware/auth.ts
index 4902c1b..e4b37d3 100644
--- a/apps/api/src/middleware/auth.ts
+++ b/apps/api/src/middleware/auth.ts
@@ -11,10 +11,7 @@ export interface AuthVars {
   roles: string[];
 }
 
-export function setSessionCookie(
-  c: any,
-  userId: number,
-) {
+export function setSessionCookie(c: any, userId: number) {
   const cookieName = process.env.AUTH_COOKIE_NAME || "node_club";
   const domain = process.env.AUTH_COOKIE_DOMAIN || undefined;
   const secret = process.env.AUTH_SESSION_SECRET || "local-dev-secret";
@@ -42,7 +39,7 @@ export const authMiddleware = () =>
   }>(async (c, next) => {
     const cookieName = process.env.AUTH_COOKIE_NAME || "node_club";
     const secret = process.env.AUTH_SESSION_SECRET || "local-dev-secret";
-  const token = (getCookie as any)(c, cookieName, secret);
+    const token = (getCookie as any)(c, cookieName, secret);
 
     let user: AuthVars["user"] = null;
 
diff --git a/apps/api/src/middleware/ip-ban.ts b/apps/api/src/middleware/ip-ban.ts
index a822937..09cc938 100644
--- a/apps/api/src/middleware/ip-ban.ts
+++ b/apps/api/src/middleware/ip-ban.ts
@@ -24,7 +24,14 @@ export function isValidIpRule(rule: string) {
   if (isIP(rule)) return true;
   const [base, prefixRaw] = rule.split("/");
   const prefix = Number(prefixRaw);
-  return !!base && prefixRaw !== undefined && isIP(base) === 4 && Number.isInteger(prefix) && prefix >= 0 && prefix <= 32;
+  return (
+    !!base &&
+    prefixRaw !== undefined &&
+    isIP(base) === 4 &&
+    Number.isInteger(prefix) &&
+    prefix >= 0 &&
+    prefix <= 32
+  );
 }
 
 export function matchesIpRule(ip: string, rule: string) {
diff --git a/apps/api/src/middleware/rate-limit.ts b/apps/api/src/middleware/rate-limit.ts
index a46ac3e..c61ad3d 100644
--- a/apps/api/src/middleware/rate-limit.ts
+++ b/apps/api/src/middleware/rate-limit.ts
@@ -29,7 +29,8 @@ function makePerDayLimiter(options: RateLimitOptions) {
     const cache = getCache();
     const count = await cache.incr(key, SECONDS_PER_DAY);
 
-    const limitCount = typeof options.limitCount === "function" ? await options.limitCount() : options.limitCount;
+    const limitCount =
+      typeof options.limitCount === "function" ? await options.limitCount() : options.limitCount;
 
     if (count > limitCount) {
       c.status(403);
@@ -54,7 +55,11 @@ function makePerDayLimiter(options: RateLimitOptions) {
   });
 }
 
-export function perUserPerDay(name: string, limitCount: number | (() => number | Promise<number>), showJson = true) {
+export function perUserPerDay(
+  name: string,
+  limitCount: number | (() => number | Promise<number>),
+  showJson = true,
+) {
   return makePerDayLimiter({
     identityName: "peruserperday",
     name,
@@ -92,10 +97,19 @@ export function perIpPerDay(name: string, limitCount: number, showJson = true) {
   });
 }
 
-export function perUserPerDaySetting(name: string, settingKey: string, defaultLimit: number, showJson = true) {
+export function perUserPerDaySetting(
+  name: string,
+  settingKey: string,
+  defaultLimit: number,
+  showJson = true,
+) {
   return perUserPerDay(
     name,
-    async () => Math.max(1, Number(await settingQueries.get(settingKey, String(defaultLimit))) || defaultLimit),
+    async () =>
+      Math.max(
+        1,
+        Number(await settingQueries.get(settingKey, String(defaultLimit))) || defaultLimit,
+      ),
     showJson,
   );
 }
diff --git a/apps/api/src/routes/admin.ts b/apps/api/src/routes/admin.ts
index 705f66d..da4dcf5 100644
--- a/apps/api/src/routes/admin.ts
+++ b/apps/api/src/routes/admin.ts
@@ -54,7 +54,13 @@ import {
   parseAdminTopicFilters,
   type AdminTopicFilters,
 } from "../lib/admin-governance";
-import { adminUserBulkGovernanceBodySchema, createReportBodySchema, errorResponseSchema, roleAssignmentSchema, userRoleSchema } from "@cnode/shared";
+import {
+  adminUserBulkGovernanceBodySchema,
+  createReportBodySchema,
+  errorResponseSchema,
+  roleAssignmentSchema,
+  userRoleSchema,
+} from "@cnode/shared";
 
 const admin = new OpenAPIHono<{
   Variables: AuthVars;
@@ -62,9 +68,29 @@ const admin = new OpenAPIHono<{
 
 const ADMIN_DEFAULT_LIMIT = 50;
 const ADMIN_MAX_LIMIT = 100;
-const auditCategoryValues = new Set(["content", "user", "role", "account", "security", "moderation", "system"]);
+const auditCategoryValues = new Set([
+  "content",
+  "user",
+  "role",
+  "account",
+  "security",
+  "moderation",
+  "system",
+]);
 const auditRiskValues = new Set(["low", "medium", "high", "critical"]);
-const auditTargetTypeValues = new Set(["topic", "topics", "reply", "user", "ip", "report", "scan_job", "settings", "zone", "tab", "moderation_hit"]);
+const auditTargetTypeValues = new Set([
+  "topic",
+  "topics",
+  "reply",
+  "user",
+  "ip",
+  "report",
+  "scan_job",
+  "settings",
+  "zone",
+  "tab",
+  "moderation_hit",
+]);
 
 type Pagination = {
   page: number;
@@ -72,7 +98,10 @@ type Pagination = {
   offset: number;
 };
 
-export function parseAdminPagination(query: { page?: string | null; limit?: string | null }, defaultLimit = ADMIN_DEFAULT_LIMIT): Pagination {
+export function parseAdminPagination(
+  query: { page?: string | null; limit?: string | null },
+  defaultLimit = ADMIN_DEFAULT_LIMIT,
+): Pagination {
   const page = Math.max(1, Number(query.page) || 1);
   const requestedLimit = Number(query.limit) || defaultLimit;
   const limit = Math.min(ADMIN_MAX_LIMIT, Math.max(1, requestedLimit));
@@ -80,11 +109,20 @@ export function parseAdminPagination(query: { page?: string | null; limit?: stri
 }
 
 function getPagination(c: any, defaultLimit = ADMIN_DEFAULT_LIMIT): Pagination {
-  return parseAdminPagination({ page: c.req.query("page"), limit: c.req.query("limit") }, defaultLimit);
+  return parseAdminPagination(
+    { page: c.req.query("page"), limit: c.req.query("limit") },
+    defaultLimit,
+  );
 }
 
 function paginated<T>(data: T[], total: number, pagination: Pagination) {
-  return { success: true, data: data as any, total, page: pagination.page, limit: pagination.limit };
+  return {
+    success: true,
+    data: data as any,
+    total,
+    page: pagination.page,
+    limit: pagination.limit,
+  };
 }
 
 function enumQueryValue(value: string | null | undefined, allowed: Set<string>) {
@@ -128,24 +166,47 @@ export function auditEventMeta(action: string) {
     update_zone: "修改专区",
     update_tab: "修改 Tab",
   };
-  const category = action.startsWith("report_") || action.startsWith("moderation_")
-    ? "moderation"
-    : action === "grant_role" || action === "revoke_role"
-      ? "role"
-      : action === "reset_password" || action.startsWith("github_")
-        ? "account"
-        : action === "ban_ip" || action === "unban_ip"
-          ? "security"
-          : action.startsWith("update_")
-            ? "system"
-            : ["block_user", "unblock_user", "mute_user", "unmute_user", "bulk_unblock_user", "bulk_unmute_user", "delete_all_user_content"].includes(action)
-              ? "user"
-              : "content";
-  const risk = ["delete_topic", "delete_reply", "delete_all_user_content", "permanent_delete_topic"].includes(action)
+  const category =
+    action.startsWith("report_") || action.startsWith("moderation_")
+      ? "moderation"
+      : action === "grant_role" || action === "revoke_role"
+        ? "role"
+        : action === "reset_password" || action.startsWith("github_")
+          ? "account"
+          : action === "ban_ip" || action === "unban_ip"
+            ? "security"
+            : action.startsWith("update_")
+              ? "system"
+              : [
+                    "block_user",
+                    "unblock_user",
+                    "mute_user",
+                    "unmute_user",
+                    "bulk_unblock_user",
+                    "bulk_unmute_user",
+                    "delete_all_user_content",
+                  ].includes(action)
+                ? "user"
+                : "content";
+  const risk = [
+    "delete_topic",
+    "delete_reply",
+    "delete_all_user_content",
+    "permanent_delete_topic",
+  ].includes(action)
     ? "critical"
     : ["grant_role", "revoke_role", "reset_password", "ban_ip", "unban_ip"].includes(action)
       ? "high"
-      : ["lock", "unlock", "block_user", "unblock_user", "mute_user", "unmute_user", "bulk_unblock_user", "bulk_unmute_user"].includes(action)
+      : [
+            "lock",
+            "unlock",
+            "block_user",
+            "unblock_user",
+            "mute_user",
+            "unmute_user",
+            "bulk_unblock_user",
+            "bulk_unmute_user",
+          ].includes(action)
         ? "medium"
         : "low";
   return { category, risk, label: labels[action] || action.replace(/_/g, " ") };
@@ -156,7 +217,10 @@ function redactSensitive(value: unknown): unknown {
   if (!value || typeof value !== "object") return value;
   const result: Record<string, unknown> = {};
   for (const [key, child] of Object.entries(value)) {
-    result[key] = /password|passwd|secret|token|access[_-]?token|private|credential|database_url/i.test(key) ? "[redacted]" : redactSensitive(child);
+    result[key] =
+      /password|passwd|secret|token|access[_-]?token|private|credential|database_url/i.test(key)
+        ? "[redacted]"
+        : redactSensitive(child);
   }
   return result;
 }
@@ -166,7 +230,10 @@ export function sanitizeAuditDetail(detail?: string | null) {
   try {
     return JSON.stringify(redactSensitive(JSON.parse(detail)));
   } catch {
-    return detail.replace(/(password|passwd|secret|token|access[_-]?token|database_url)(\s*[=:]\s*)\S+/gi, "$1$2[redacted]");
+    return detail.replace(
+      /(password|passwd|secret|token|access[_-]?token|database_url)(\s*[=:]\s*)\S+/gi,
+      "$1$2[redacted]",
+    );
   }
 }
 
@@ -206,20 +273,41 @@ function buildAuditConditions(c: any) {
   if (operator) conditions.push(sql`${auditLogs.operatorName} LIKE ${`%${operator}%`}`);
   if (targetType) conditions.push(eq(auditLogs.targetType, targetType));
   if (result && result !== "all") conditions.push(eq(auditLogs.result, result));
-  if (q) conditions.push(or(sql`${auditLogs.action} LIKE ${`%${q}%`}`, sql`${auditLogs.operatorName} LIKE ${`%${q}%`}`, sql`${auditLogs.targetName} LIKE ${`%${q}%`}`, sql`${auditLogs.targetId} LIKE ${`%${q}%`}`, sql`${auditLogs.detail} LIKE ${`%${q}%`}`));
+  if (q)
+    conditions.push(
+      or(
+        sql`${auditLogs.action} LIKE ${`%${q}%`}`,
+        sql`${auditLogs.operatorName} LIKE ${`%${q}%`}`,
+        sql`${auditLogs.targetName} LIKE ${`%${q}%`}`,
+        sql`${auditLogs.targetId} LIKE ${`%${q}%`}`,
+        sql`${auditLogs.detail} LIKE ${`%${q}%`}`,
+      ),
+    );
   return { conditions, category, risk };
 }
 
 function auditSummary(logs: any[]) {
-  return logs.reduce((summary, log) => {
-    const meta = auditEventMeta(log.action);
-    if (meta.risk === "high" || meta.risk === "critical") summary.high_risk += 1;
-    if (["delete_topic", "delete_reply", "delete_all_user_content", "permanent_delete_topic"].includes(log.action)) summary.content_deletions += 1;
-    if (meta.category === "role") summary.role_changes += 1;
-    if (meta.category === "account") summary.account_security += 1;
-    if (!["success", "confirmed", "dismissed", "created"].includes(String(log.result || ""))) summary.failures += 1;
-    return summary;
-  }, { high_risk: 0, content_deletions: 0, role_changes: 0, account_security: 0, failures: 0 });
+  return logs.reduce(
+    (summary, log) => {
+      const meta = auditEventMeta(log.action);
+      if (meta.risk === "high" || meta.risk === "critical") summary.high_risk += 1;
+      if (
+        [
+          "delete_topic",
+          "delete_reply",
+          "delete_all_user_content",
+          "permanent_delete_topic",
+        ].includes(log.action)
+      )
+        summary.content_deletions += 1;
+      if (meta.category === "role") summary.role_changes += 1;
+      if (meta.category === "account") summary.account_security += 1;
+      if (!["success", "confirmed", "dismissed", "created"].includes(String(log.result || "")))
+        summary.failures += 1;
+      return summary;
+    },
+    { high_risk: 0, content_deletions: 0, role_changes: 0, account_security: 0, failures: 0 },
+  );
 }
 
 function topicDateColumn(field: AdminTopicFilters["dateField"]) {
@@ -271,7 +359,12 @@ export function bulkUserGovernanceAuditAction(action: "unmute" | "unblock") {
   return action === "unmute" ? "bulk_unmute_user" : "bulk_unblock_user";
 }
 
-export function buildBulkUserGovernancePlan(action: "unmute" | "unblock", requestedIds: number[], currentUserId: number, existingUsers: { id: number }[]) {
+export function buildBulkUserGovernancePlan(
+  action: "unmute" | "unblock",
+  requestedIds: number[],
+  currentUserId: number,
+  existingUsers: { id: number }[],
+) {
   const ids = Array.from(new Set(requestedIds));
   const selfSkippedIds = ids.filter((id) => id === currentUserId);
   const existingIds = existingUsers.map((user) => user.id);
@@ -288,14 +381,26 @@ async function getReportTargetSummary(targetType: string, targetId: number) {
   if (targetType === "topic") {
     const topic = await topicQueries.getById(targetId);
     if (!topic || topic.deleted) return null;
-    return { target_type: "topic", target_id: String(topic.id), topic_id: String(topic.id), title: topic.title, summary: topic.title };
+    return {
+      target_type: "topic",
+      target_id: String(topic.id),
+      topic_id: String(topic.id),
+      title: topic.title,
+      summary: topic.title,
+    };
   }
   if (targetType === "reply") {
     const reply = await replyQueries.getById(targetId);
     if (!reply || reply.deleted) return null;
     const topic = await topicQueries.getById(reply.topicId);
     if (!topic || topic.deleted) return null;
-    return { target_type: "reply", target_id: String(reply.id), topic_id: String(topic.id), title: topic.title, summary: reply.content.slice(0, 160) };
+    return {
+      target_type: "reply",
+      target_id: String(reply.id),
+      topic_id: String(topic.id),
+      title: topic.title,
+      summary: reply.content.slice(0, 160),
+    };
   }
   return null;
 }
@@ -305,7 +410,10 @@ async function hideReportTarget(targetType: string, targetId: number) {
   if (targetType === "topic") {
     const topic = await topicQueries.getById(targetId);
     if (!topic || topic.deleted) return null;
-    await db.update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.id, targetId));
+    await db
+      .update(topics)
+      .set({ deleted: boolValue(true), status: "deleted" } as any)
+      .where(eq(topics.id, targetId));
     return topic.authorId;
   }
   if (targetType === "reply") {
@@ -324,39 +432,113 @@ async function permanentlyDeleteTopic(topicId: number) {
   if (!topic) return null;
 
   return db.transaction(async (tx: any) => {
-    const replyRows = await tx.select({ id: replies.id }).from(replies).where(eq(replies.topicId, topicId));
+    const replyRows = await tx
+      .select({ id: replies.id })
+      .from(replies)
+      .where(eq(replies.topicId, topicId));
     const replyIds = replyRows.map((reply: any) => reply.id);
 
     if (replyIds.length > 0) {
       await tx.delete(replyUps).where(inArray(replyUps.replyId, replyIds));
-      await tx.delete(messages).where(or(eq(messages.topicId, topicId), inArray(messages.replyId, replyIds)));
-      await tx.delete(reports).where(or(and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId)), and(eq(reports.targetType, "reply"), inArray(reports.targetId, replyIds))));
-      await tx.delete(moderationHits).where(or(eq(moderationHits.topicId, topicId), and(eq(moderationHits.targetType, "topic"), eq(moderationHits.targetId, topicId)), and(eq(moderationHits.targetType, "reply"), inArray(moderationHits.targetId, replyIds))));
+      await tx
+        .delete(messages)
+        .where(or(eq(messages.topicId, topicId), inArray(messages.replyId, replyIds)));
+      await tx
+        .delete(reports)
+        .where(
+          or(
+            and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId)),
+            and(eq(reports.targetType, "reply"), inArray(reports.targetId, replyIds)),
+          ),
+        );
+      await tx
+        .delete(moderationHits)
+        .where(
+          or(
+            eq(moderationHits.topicId, topicId),
+            and(eq(moderationHits.targetType, "topic"), eq(moderationHits.targetId, topicId)),
+            and(eq(moderationHits.targetType, "reply"), inArray(moderationHits.targetId, replyIds)),
+          ),
+        );
       await tx.delete(replies).where(inArray(replies.id, replyIds));
     } else {
       await tx.delete(messages).where(eq(messages.topicId, topicId));
-      await tx.delete(reports).where(and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId)));
-      await tx.delete(moderationHits).where(or(eq(moderationHits.topicId, topicId), and(eq(moderationHits.targetType, "topic"), eq(moderationHits.targetId, topicId))));
+      await tx
+        .delete(reports)
+        .where(and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId)));
+      await tx
+        .delete(moderationHits)
+        .where(
+          or(
+            eq(moderationHits.topicId, topicId),
+            and(eq(moderationHits.targetType, "topic"), eq(moderationHits.targetId, topicId)),
+          ),
+        );
     }
 
     await tx.delete(topicCollects).where(eq(topicCollects.topicId, topicId));
     await tx.delete(jobMeta).where(eq(jobMeta.topicId, topicId));
     await tx.delete(topics).where(eq(topics.id, topicId));
 
-    const [remainingTopics, remainingReplies, remainingCollects, remainingJobMeta, remainingMessages, remainingHits, remainingReports, remainingReplyUps, remainingReplyMessages, remainingReplyHits, remainingReplyReports] = await Promise.all([
+    const [
+      remainingTopics,
+      remainingReplies,
+      remainingCollects,
+      remainingJobMeta,
+      remainingMessages,
+      remainingHits,
+      remainingReports,
+      remainingReplyUps,
+      remainingReplyMessages,
+      remainingReplyHits,
+      remainingReplyReports,
+    ] = await Promise.all([
       tx.select({ c: count() }).from(topics).where(eq(topics.id, topicId)),
       tx.select({ c: count() }).from(replies).where(eq(replies.topicId, topicId)),
       tx.select({ c: count() }).from(topicCollects).where(eq(topicCollects.topicId, topicId)),
       tx.select({ c: count() }).from(jobMeta).where(eq(jobMeta.topicId, topicId)),
       tx.select({ c: count() }).from(messages).where(eq(messages.topicId, topicId)),
       tx.select({ c: count() }).from(moderationHits).where(eq(moderationHits.topicId, topicId)),
-      tx.select({ c: count() }).from(reports).where(and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId))),
-      replyIds.length ? tx.select({ c: count() }).from(replyUps).where(inArray(replyUps.replyId, replyIds)) : Promise.resolve([{ c: 0 }]),
-      replyIds.length ? tx.select({ c: count() }).from(messages).where(inArray(messages.replyId, replyIds)) : Promise.resolve([{ c: 0 }]),
-      replyIds.length ? tx.select({ c: count() }).from(moderationHits).where(and(eq(moderationHits.targetType, "reply"), inArray(moderationHits.targetId, replyIds))) : Promise.resolve([{ c: 0 }]),
-      replyIds.length ? tx.select({ c: count() }).from(reports).where(and(eq(reports.targetType, "reply"), inArray(reports.targetId, replyIds))) : Promise.resolve([{ c: 0 }]),
+      tx
+        .select({ c: count() })
+        .from(reports)
+        .where(and(eq(reports.targetType, "topic"), eq(reports.targetId, topicId))),
+      replyIds.length
+        ? tx.select({ c: count() }).from(replyUps).where(inArray(replyUps.replyId, replyIds))
+        : Promise.resolve([{ c: 0 }]),
+      replyIds.length
+        ? tx.select({ c: count() }).from(messages).where(inArray(messages.replyId, replyIds))
+        : Promise.resolve([{ c: 0 }]),
+      replyIds.length
+        ? tx
+            .select({ c: count() })
+            .from(moderationHits)
+            .where(
+              and(
+                eq(moderationHits.targetType, "reply"),
+                inArray(moderationHits.targetId, replyIds),
+              ),
+            )
+        : Promise.resolve([{ c: 0 }]),
+      replyIds.length
+        ? tx
+            .select({ c: count() })
+            .from(reports)
+            .where(and(eq(reports.targetType, "reply"), inArray(reports.targetId, replyIds)))
+        : Promise.resolve([{ c: 0 }]),
     ]);
-    const remaining = Number(remainingTopics[0]?.c || 0) + Number(remainingReplies[0]?.c || 0) + Number(remainingCollects[0]?.c || 0) + Number(remainingJobMeta[0]?.c || 0) + Number(remainingMessages[0]?.c || 0) + Number(remainingHits[0]?.c || 0) + Number(remainingReports[0]?.c || 0) + Number(remainingReplyUps[0]?.c || 0) + Number(remainingReplyMessages[0]?.c || 0) + Number(remainingReplyHits[0]?.c || 0) + Number(remainingReplyReports[0]?.c || 0);
+    const remaining =
+      Number(remainingTopics[0]?.c || 0) +
+      Number(remainingReplies[0]?.c || 0) +
+      Number(remainingCollects[0]?.c || 0) +
+      Number(remainingJobMeta[0]?.c || 0) +
+      Number(remainingMessages[0]?.c || 0) +
+      Number(remainingHits[0]?.c || 0) +
+      Number(remainingReports[0]?.c || 0) +
+      Number(remainingReplyUps[0]?.c || 0) +
+      Number(remainingReplyMessages[0]?.c || 0) +
+      Number(remainingReplyHits[0]?.c || 0) +
+      Number(remainingReplyReports[0]?.c || 0);
     if (remaining > 0) throw new Error("话题真实删除后仍存在关联数据");
 
     return { topic, deletedReplies: replyIds.length };
@@ -370,24 +552,73 @@ admin.get("/admin/stats", adminRequired(), async (c) => {
   const topicCount = (await db.select({ c: count() }).from(topics))[0]?.c ?? 0;
   const replyCount = (await db.select({ c: count() }).from(replies))[0]?.c ?? 0;
   const today = new Date().toISOString().split("T")[0];
-  const todayTopics = (await db.select({ c: count() }).from(topics).where(sql`date(${topics.createAt}) = ${today}`))[0]?.c ?? 0;
-  const todayReplies = (await db.select({ c: count() }).from(replies).where(sql`date(${replies.createAt}) = ${today}`))[0]?.c ?? 0;
-  const todayUsers = (await db.select({ c: count() }).from(users).where(sql`date(${users.createAt}) = ${today}`))[0]?.c ?? 0;
+  const todayTopics =
+    (
+      await db
+        .select({ c: count() })
+        .from(topics)
+        .where(sql`date(${topics.createAt}) = ${today}`)
+    )[0]?.c ?? 0;
+  const todayReplies =
+    (
+      await db
+        .select({ c: count() })
+        .from(replies)
+        .where(sql`date(${replies.createAt}) = ${today}`)
+    )[0]?.c ?? 0;
+  const todayUsers =
+    (
+      await db
+        .select({ c: count() })
+        .from(users)
+        .where(sql`date(${users.createAt}) = ${today}`)
+    )[0]?.c ?? 0;
   const moderationPending = await pendingHitCount();
-  const pendingReports = (await db.select({ c: count() }).from(reports).where(eq(reports.status, "pending")))[0]?.c ?? 0;
-  return c.json({ success: true, data: { userCount, topicCount, replyCount, todayTopics, todayReplies, todayUsers, pendingReports, moderationPending } });
+  const pendingReports =
+    (await db.select({ c: count() }).from(reports).where(eq(reports.status, "pending")))[0]?.c ?? 0;
+  return c.json({
+    success: true,
+    data: {
+      userCount,
+      topicCount,
+      replyCount,
+      todayTopics,
+      todayReplies,
+      todayUsers,
+      pendingReports,
+      moderationPending,
+    },
+  });
 });
 
 admin.get("/admin/recent-users", adminRequired(), async (c) => {
   const db = getDb();
   const recent = await db.select().from(users).orderBy(desc(users.createAt)).limit(10);
-  return c.json({ success: true, data: recent.map((u: any) => ({ id: u.id, loginname: u.loginname, avatar_url: u.avatar, create_at: u.createAt, is_block: !!u.isBlock, is_muted: !!u.isMuted || !!u.isBlock })) });
+  return c.json({
+    success: true,
+    data: recent.map((u: any) => ({
+      id: u.id,
+      loginname: u.loginname,
+      avatar_url: u.avatar,
+      create_at: u.createAt,
+      is_block: !!u.isBlock,
+      is_muted: !!u.isMuted || !!u.isBlock,
+    })),
+  });
 });
 
 admin.get("/admin/recent-topics", adminRequired(), async (c) => {
   const db = getDb();
-  const recent = await db.select().from(topics).where(boolEq(topics.deleted, false)).orderBy(desc(topics.createAt)).limit(10);
-  return c.json({ success: true, data: recent.map((t: any) => ({ id: t.id, title: t.title, create_at: t.createAt })) });
+  const recent = await db
+    .select()
+    .from(topics)
+    .where(boolEq(topics.deleted, false))
+    .orderBy(desc(topics.createAt))
+    .limit(10);
+  return c.json({
+    success: true,
+    data: recent.map((t: any) => ({ id: t.id, title: t.title, create_at: t.createAt })),
+  });
 });
 
 // ── Topic management ──
@@ -405,16 +636,53 @@ admin.get("/admin/topics", modRequired(), async (c) => {
   });
   const db = getDb();
   const conditions = buildAdminTopicConditions(filters);
-  const where = conditions.length === 0 ? undefined : conditions.length === 1 ? conditions[0] : and(...conditions);
+  const where =
+    conditions.length === 0
+      ? undefined
+      : conditions.length === 1
+        ? conditions[0]
+        : and(...conditions);
   let listQuery = db.select().from(topics).$dynamic();
   let totalQuery = db.select({ c: count() }).from(topics).$dynamic();
-  if (where) { listQuery = listQuery.where(where) as any; totalQuery = totalQuery.where(where) as any; }
-  const [list, totalResult] = await Promise.all([listQuery.orderBy(topicOrder(filters.sort), desc(topics.id)).limit(pagination.limit).offset(pagination.offset), totalQuery]);
-  return c.json(paginated(list.map((t: any) => ({ id: t.id, title: t.title, tab: t.tab, top: t.top, good: t.good, lock: t.lock, archived: t.archived, status: t.status, deleted: t.deleted, reply_count: t.replyCount, visit_count: t.visitCount, collect_count: t.collectCount, create_at: t.createAt, update_at: t.updateAt, last_reply_at: t.lastReplyAt })), Number(totalResult[0]?.c || 0), pagination));
+  if (where) {
+    listQuery = listQuery.where(where) as any;
+    totalQuery = totalQuery.where(where) as any;
+  }
+  const [list, totalResult] = await Promise.all([
+    listQuery
+      .orderBy(topicOrder(filters.sort), desc(topics.id))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
+    totalQuery,
+  ]);
+  return c.json(
+    paginated(
+      list.map((t: any) => ({
+        id: t.id,
+        title: t.title,
+        tab: t.tab,
+        top: t.top,
+        good: t.good,
+        lock: t.lock,
+        archived: t.archived,
+        status: t.status,
+        deleted: t.deleted,
+        reply_count: t.replyCount,
+        visit_count: t.visitCount,
+        collect_count: t.collectCount,
+        create_at: t.createAt,
+        update_at: t.updateAt,
+        last_reply_at: t.lastReplyAt,
+      })),
+      Number(totalResult[0]?.c || 0),
+      pagination,
+    ),
+  );
 });
 
 admin.post("/admin/topics/permanent-delete", adminRequired(), async (c) => {
-  if (!canRunPermanentTopicDelete(c.get("isAdmin"))) return c.json({ success: false, error_msg: "需要管理员权限" }, 403);
+  if (!canRunPermanentTopicDelete(c.get("isAdmin")))
+    return c.json({ success: false, error_msg: "需要管理员权限" }, 403);
   const body = await c.req.json().catch(() => ({}));
   const ids = normalizePermanentTopicDeleteIds(body);
   if (!ids.length) return c.json({ success: false, error_msg: "话题 ID 无效" }, 400);
@@ -423,29 +691,61 @@ admin.post("/admin/topics/permanent-delete", adminRequired(), async (c) => {
   for (const id of ids) {
     const result = await permanentlyDeleteTopic(id);
     if (!result) continue;
-    results.push({ topic_id: id, title: result.topic.title, deleted_replies: result.deletedReplies });
+    results.push({
+      topic_id: id,
+      title: result.topic.title,
+      deleted_replies: result.deletedReplies,
+    });
   }
   if (!results.length) return c.json({ success: false, error_msg: "话题不存在" }, 404);
-  await auditQueries.log(user.id, user.loginname, "permanent_delete_topic", { type: "topics", id: results.map((item) => item.topic_id).join(","), name: results[0]?.title }, "success", JSON.stringify({ topics: results, deleted: results.length }));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "permanent_delete_topic",
+    { type: "topics", id: results.map((item) => item.topic_id).join(","), name: results[0]?.title },
+    "success",
+    JSON.stringify({ topics: results, deleted: results.length }),
+  );
   return c.json({ success: true, deleted: results.length, topics: results });
 });
 
 admin.post("/admin/topics/:action", modRequired(), async (c) => {
   const action = c.req.param("action");
-  if (!canRunTopicAction(action, true, true)) return c.json({ success: false, error_msg: "未知操作" }, 400);
-  if (!canRunTopicAction(action, c.get("isAdmin"), c.get("isMod"))) return c.json({ success: false, error_msg: "需要管理员权限" }, 403);
+  if (!canRunTopicAction(action, true, true))
+    return c.json({ success: false, error_msg: "未知操作" }, 400);
+  if (!canRunTopicAction(action, c.get("isAdmin"), c.get("isMod")))
+    return c.json({ success: false, error_msg: "需要管理员权限" }, 403);
   const body = await c.req.json().catch(() => ({}));
   const ids: number[] = body.ids || [];
   if (ids.length === 0) return c.json({ success: false, error_msg: "no ids" }, 400);
   const db = getDb();
   const user = c.get("user")!;
   for (const id of ids) {
-    if (action === "top") await db.update(topics).set({ top: sql`NOT ${topics.top}` }).where(eq(topics.id, id));
-    else if (action === "good") await db.update(topics).set({ good: sql`NOT ${topics.good}` }).where(eq(topics.id, id));
-    else if (action === "mute") await db.update(topics).set({ status: "muted" }).where(eq(topics.id, id));
-    else if (action === "delete") await db.update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.id, id));
+    if (action === "top")
+      await db
+        .update(topics)
+        .set({ top: sql`NOT ${topics.top}` })
+        .where(eq(topics.id, id));
+    else if (action === "good")
+      await db
+        .update(topics)
+        .set({ good: sql`NOT ${topics.good}` })
+        .where(eq(topics.id, id));
+    else if (action === "mute")
+      await db.update(topics).set({ status: "muted" }).where(eq(topics.id, id));
+    else if (action === "delete")
+      await db
+        .update(topics)
+        .set({ deleted: boolValue(true), status: "deleted" } as any)
+        .where(eq(topics.id, id));
   }
-  await auditQueries.log(user.id, user.loginname, `batch_${action}`, { type: "topics", id: ids.join(",") }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    `batch_${action}`,
+    { type: "topics", id: ids.join(",") },
+    "success",
+  );
   return c.json({ success: true });
 });
 
@@ -454,9 +754,18 @@ admin.post("/topic/:tid/top", modRequired(), async (c) => {
   const topic = await topicQueries.getById(tid);
   if (!topic) return c.json({ success: false, error_msg: "话题不存在" }, 404);
   const db = getDb();
-  await db.update(topics).set({ top: boolValue(!topic.top) } as any).where(eq(topics.id, tid));
+  await db
+    .update(topics)
+    .set({ top: boolValue(!topic.top) } as any)
+    .where(eq(topics.id, tid));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, topic.top ? "untop" : "top", { type: "topic", id: String(tid), name: topic.title }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    topic.top ? "untop" : "top",
+    { type: "topic", id: String(tid), name: topic.title },
+    "success",
+  );
   return c.json({ success: true, message: topic.top ? "已取消置顶" : "已置顶" });
 });
 
@@ -465,9 +774,18 @@ admin.post("/topic/:tid/good", modRequired(), async (c) => {
   const topic = await topicQueries.getById(tid);
   if (!topic) return c.json({ success: false, error_msg: "话题不存在" }, 404);
   const db = getDb();
-  await db.update(topics).set({ good: boolValue(!topic.good) } as any).where(eq(topics.id, tid));
+  await db
+    .update(topics)
+    .set({ good: boolValue(!topic.good) } as any)
+    .where(eq(topics.id, tid));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, topic.good ? "ungood" : "good", { type: "topic", id: String(tid), name: topic.title }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    topic.good ? "ungood" : "good",
+    { type: "topic", id: String(tid), name: topic.title },
+    "success",
+  );
   return c.json({ success: true, message: topic.good ? "已取消加精" : "已加精" });
 });
 
@@ -476,9 +794,18 @@ admin.post("/topic/:tid/lock", modRequired(), async (c) => {
   const topic = await topicQueries.getById(tid);
   if (!topic) return c.json({ success: false, error_msg: "话题不存在" }, 404);
   const db = getDb();
-  await db.update(topics).set({ lock: boolValue(!topic.lock) } as any).where(eq(topics.id, tid));
+  await db
+    .update(topics)
+    .set({ lock: boolValue(!topic.lock) } as any)
+    .where(eq(topics.id, tid));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, topic.lock ? "unlock" : "lock", { type: "topic", id: String(tid), name: topic.title }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    topic.lock ? "unlock" : "lock",
+    { type: "topic", id: String(tid), name: topic.title },
+    "success",
+  );
   return c.json({ success: true, message: topic.lock ? "已解锁" : "已锁定" });
 });
 
@@ -488,11 +815,24 @@ admin.post("/topic/:tid/delete", async (c) => {
   const tid = Number(c.req.param("tid"));
   const topic = await topicQueries.getById(tid);
   if (!topic) return c.json({ success: false, error_msg: "话题不存在" }, 404);
-  if (topic.authorId !== user.id && !c.get("isMod")) return c.json({ success: false, error_msg: "无权限" }, 403);
+  if (topic.authorId !== user.id && !c.get("isMod"))
+    return c.json({ success: false, error_msg: "无权限" }, 403);
   const db = getDb();
-  await db.update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.id, tid));
-  await db.update(users).set({ score: sql`${users.score} - 5`, topicCount: sql`${users.topicCount} - 1` }).where(eq(users.id, topic.authorId));
-  await auditQueries.log(user.id, user.loginname, "delete_topic", { type: "topic", id: String(tid), name: topic.title }, "success");
+  await db
+    .update(topics)
+    .set({ deleted: boolValue(true), status: "deleted" } as any)
+    .where(eq(topics.id, tid));
+  await db
+    .update(users)
+    .set({ score: sql`${users.score} - 5`, topicCount: sql`${users.topicCount} - 1` })
+    .where(eq(users.id, topic.authorId));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "delete_topic",
+    { type: "topic", id: String(tid), name: topic.title },
+    "success",
+  );
   return c.json({ success: true, message: "话题已删除" });
 });
 
@@ -505,7 +845,13 @@ admin.post("/admin/reply/:rid/delete", modRequired(), async (c) => {
   const user = c.get("user")!;
   const result = await replyQueries.deleteWithAggregates(rid, user.id, true);
   if (result.status !== "deleted") return c.json({ success: false, error_msg: "回复已删除" }, 422);
-  await auditQueries.log(user.id, user.loginname, "delete_reply", { type: "reply", id: String(rid), name: topic?.title || String(reply.topicId) }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "delete_reply",
+    { type: "reply", id: String(rid), name: topic?.title || String(reply.topicId) },
+    "success",
+  );
   return c.json({ success: true, message: "回复已删除" });
 });
 
@@ -514,13 +860,40 @@ admin.get("/admin/users", adminRequired(), async (c) => {
   const pagination = getPagination(c);
   const q = c.req.query("q")?.trim();
   const db = getDb();
-  const where = q ? sql`(${users.loginname} LIKE ${`%${q}%`} OR ${users.email} LIKE ${`%${q}%`})` : undefined;
+  const where = q
+    ? sql`(${users.loginname} LIKE ${`%${q}%`} OR ${users.email} LIKE ${`%${q}%`})`
+    : undefined;
   let listQuery = db.select().from(users).$dynamic();
   let totalQuery = db.select({ c: count() }).from(users).$dynamic();
-  if (where) { listQuery = listQuery.where(where) as any; totalQuery = totalQuery.where(where) as any; }
-  const [list, totalResult] = await Promise.all([listQuery.orderBy(desc(users.createAt)).limit(pagination.limit).offset(pagination.offset), totalQuery]);
+  if (where) {
+    listQuery = listQuery.where(where) as any;
+    totalQuery = totalQuery.where(where) as any;
+  }
+  const [list, totalResult] = await Promise.all([
+    listQuery.orderBy(desc(users.createAt)).limit(pagination.limit).offset(pagination.offset),
+    totalQuery,
+  ]);
   const rolesByUserId = await roleQueries.listByUserIds(list.map((u: any) => u.id));
-  return c.json(paginated(list.map((u: any) => ({ id: u.id, loginname: u.loginname, email: u.email, avatar_url: u.avatar, score: u.score, topic_count: u.topicCount, reply_count: u.replyCount, roles: rolesByUserId.get(u.id) || [], is_block: !!u.isBlock, is_muted: !!u.isMuted || !!u.isBlock, active: !!u.active, create_at: u.createAt })), Number(totalResult[0]?.c || 0), pagination));
+  return c.json(
+    paginated(
+      list.map((u: any) => ({
+        id: u.id,
+        loginname: u.loginname,
+        email: u.email,
+        avatar_url: u.avatar,
+        score: u.score,
+        topic_count: u.topicCount,
+        reply_count: u.replyCount,
+        roles: rolesByUserId.get(u.id) || [],
+        is_block: !!u.isBlock,
+        is_muted: !!u.isMuted || !!u.isBlock,
+        active: !!u.active,
+        create_at: u.createAt,
+      })),
+      Number(totalResult[0]?.c || 0),
+      pagination,
+    ),
+  );
 });
 
 admin.get("/admin/users/:id/roles", adminRequired(), async (c) => {
@@ -540,7 +913,14 @@ admin.post("/admin/users/:id/roles", adminRequired(), async (c) => {
   if (!parsed.success) return c.json({ success: false, error_msg: "角色无效" }, 422);
   const user = c.get("user")!;
   const roles = await roleQueries.grant(id, parsed.data.role, user.id, parsed.data.reason);
-  await auditQueries.log(user.id, user.loginname, "grant_role", { type: "user", id: String(id), name: target.loginname }, "success", JSON.stringify({ role: parsed.data.role, reason: parsed.data.reason || null }));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "grant_role",
+    { type: "user", id: String(id), name: target.loginname },
+    "success",
+    JSON.stringify({ role: parsed.data.role, reason: parsed.data.reason || null }),
+  );
   return c.json({ success: true, data: { user_id: id, roles } });
 });
 
@@ -553,7 +933,14 @@ admin.delete("/admin/users/:id/roles/:role", adminRequired(), async (c) => {
   if (!parsed.success) return c.json({ success: false, error_msg: "角色无效" }, 422);
   const user = c.get("user")!;
   const roles = await roleQueries.revoke(id, parsed.data);
-  await auditQueries.log(user.id, user.loginname, "revoke_role", { type: "user", id: String(id), name: target.loginname }, "success", JSON.stringify({ role: parsed.data }));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "revoke_role",
+    { type: "user", id: String(id), name: target.loginname },
+    "success",
+    JSON.stringify({ role: parsed.data }),
+  );
   return c.json({ success: true, data: { user_id: id, roles } });
 });
 
@@ -569,21 +956,42 @@ admin.post("/admin/users/bulk-governance", adminRequired(), async (c) => {
   }
 
   const db = getDb();
-  const targetRows = await db.select({ id: users.id, loginname: users.loginname }).from(users).where(inArray(users.id, targetIds));
+  const targetRows = await db
+    .select({ id: users.id, loginname: users.loginname })
+    .from(users)
+    .where(inArray(users.id, targetIds));
   const plan = buildBulkUserGovernancePlan(parsed.data.action, ids, currentUser.id, targetRows);
   if (plan.processedIds.length > 0) {
-    await db.update(users).set(plan.update as any).where(inArray(users.id, plan.processedIds));
+    await db
+      .update(users)
+      .set(plan.update as any)
+      .where(inArray(users.id, plan.processedIds));
   }
 
   await auditQueries.log(
     currentUser.id,
     currentUser.loginname,
     bulkUserGovernanceAuditAction(parsed.data.action),
-    { type: "user", id: plan.processedIds.join(","), name: targetRows.map((user: any) => user.loginname).join(",") },
+    {
+      type: "user",
+      id: plan.processedIds.join(","),
+      name: targetRows.map((user: any) => user.loginname).join(","),
+    },
     "success",
-    JSON.stringify({ action: parsed.data.action, ids: plan.ids, processed_ids: plan.processedIds, skipped_ids: plan.skippedIds, processed: plan.processedIds.length }),
+    JSON.stringify({
+      action: parsed.data.action,
+      ids: plan.ids,
+      processed_ids: plan.processedIds,
+      skipped_ids: plan.skippedIds,
+      processed: plan.processedIds.length,
+    }),
   );
-  return c.json({ success: true, processed: plan.processedIds.length, processed_ids: plan.processedIds, skipped_ids: plan.skippedIds });
+  return c.json({
+    success: true,
+    processed: plan.processedIds.length,
+    processed_ids: plan.processedIds,
+    skipped_ids: plan.skippedIds,
+  });
 });
 
 admin.post("/user/:name/block", adminRequired(), async (c) => {
@@ -593,9 +1001,18 @@ admin.post("/user/:name/block", adminRequired(), async (c) => {
   const selfError = rejectSelfTarget(c, userData);
   if (selfError) return selfError;
   const db = getDb();
-  await db.update(users).set({ isBlock: boolValue(true) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isBlock: boolValue(true) } as any)
+    .where(eq(users.id, userData.id));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "block_user", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "block_user",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, message: "已隐藏该用户内容" });
 });
 
@@ -606,9 +1023,18 @@ admin.post("/user/:name/unblock", adminRequired(), async (c) => {
   const selfError = rejectSelfTarget(c, userData);
   if (selfError) return selfError;
   const db = getDb();
-  await db.update(users).set({ isBlock: boolValue(false) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isBlock: boolValue(false) } as any)
+    .where(eq(users.id, userData.id));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "unblock_user", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "unblock_user",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, message: "已恢复该用户内容可见性" });
 });
 
@@ -619,9 +1045,18 @@ admin.post("/user/:name/mute", adminRequired(), async (c) => {
   const selfError = rejectSelfTarget(c, userData);
   if (selfError) return selfError;
   const db = getDb();
-  await db.update(users).set({ isMuted: boolValue(true) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isMuted: boolValue(true) } as any)
+    .where(eq(users.id, userData.id));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "mute_user", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "mute_user",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, message: "已禁言" });
 });
 
@@ -632,9 +1067,18 @@ admin.post("/user/:name/unmute", adminRequired(), async (c) => {
   const selfError = rejectSelfTarget(c, userData);
   if (selfError) return selfError;
   const db = getDb();
-  await db.update(users).set({ isMuted: boolValue(false) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isMuted: boolValue(false) } as any)
+    .where(eq(users.id, userData.id));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "unmute_user", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "unmute_user",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, message: "已解除禁言" });
 });
 
@@ -645,10 +1089,22 @@ admin.post("/user/:name/delete_all", adminRequired(), async (c) => {
   const selfError = rejectSelfTarget(c, userData);
   if (selfError) return selfError;
   const db = getDb();
-  await db.update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.authorId, userData.id));
-  await db.update(replies).set({ deleted: boolValue(true) } as any).where(eq(replies.authorId, userData.id));
+  await db
+    .update(topics)
+    .set({ deleted: boolValue(true), status: "deleted" } as any)
+    .where(eq(topics.authorId, userData.id));
+  await db
+    .update(replies)
+    .set({ deleted: boolValue(true) } as any)
+    .where(eq(replies.authorId, userData.id));
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "delete_all_user_content", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "delete_all_user_content",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, message: "已删除所有发言" });
 });
 
@@ -659,7 +1115,10 @@ admin.post("/user/set_star", adminRequired(), async (c) => {
   const userData = await userQueries.getByLoginName(name);
   if (!userData) return c.json({ success: false, error_msg: "用户不存在" }, 404);
   const db = getDb();
-  await db.update(users).set({ isStar: boolValue(true) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isStar: boolValue(true) } as any)
+    .where(eq(users.id, userData.id));
   return c.json({ success: true, message: "已设为达人" });
 });
 
@@ -670,7 +1129,10 @@ admin.post("/user/cancel_star", adminRequired(), async (c) => {
   const userData = await userQueries.getByLoginName(name);
   if (!userData) return c.json({ success: false, error_msg: "用户不存在" }, 404);
   const db = getDb();
-  await db.update(users).set({ isStar: boolValue(false) } as any).where(eq(users.id, userData.id));
+  await db
+    .update(users)
+    .set({ isStar: boolValue(false) } as any)
+    .where(eq(users.id, userData.id));
   return c.json({ success: true, message: "已取消达人" });
 });
 
@@ -685,7 +1147,13 @@ admin.post("/user/:name/reset_password", adminRequired(), async (c) => {
   await userQueries.updatePass(userData.id, passhash);
   await userQueries.updateRetrieveKey(userData.id, "", 0);
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "reset_password", { type: "user", id: String(userData.id), name }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "reset_password",
+    { type: "user", id: String(userData.id), name },
+    "success",
+  );
   return c.json({ success: true, newPassword: newPass });
 });
 
@@ -696,17 +1164,39 @@ admin.get("/admin/bans/users", adminRequired(), async (c) => {
   const db = getDb();
   const where = status === "muted" ? boolEq(users.isMuted, true) : boolEq(users.isBlock, true);
   const [banned, totalResult] = await Promise.all([
-    db.select().from(users).where(where).orderBy(desc(users.createAt)).limit(pagination.limit).offset(pagination.offset),
+    db
+      .select()
+      .from(users)
+      .where(where)
+      .orderBy(desc(users.createAt))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
     db.select({ c: count() }).from(users).where(where),
   ]);
-  return c.json(paginated(banned.map((u: any) => ({ id: u.id, loginname: u.loginname, is_block: !!u.isBlock, is_muted: !!u.isMuted })), Number(totalResult[0]?.c || 0), pagination));
+  return c.json(
+    paginated(
+      banned.map((u: any) => ({
+        id: u.id,
+        loginname: u.loginname,
+        is_block: !!u.isBlock,
+        is_muted: !!u.isMuted,
+      })),
+      Number(totalResult[0]?.c || 0),
+      pagination,
+    ),
+  );
 });
 
 admin.get("/admin/bans/ips", adminRequired(), async (c) => {
   const pagination = getPagination(c);
   const db = getDb();
   const [list, totalResult] = await Promise.all([
-    db.select().from(ipBans).orderBy(desc(ipBans.createAt)).limit(pagination.limit).offset(pagination.offset),
+    db
+      .select()
+      .from(ipBans)
+      .orderBy(desc(ipBans.createAt))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
     db.select({ c: count() }).from(ipBans),
   ]);
   return c.json(paginated(list, Number(totalResult[0]?.c || 0), pagination));
@@ -728,7 +1218,13 @@ admin.delete("/admin/bans/ips/:id", adminRequired(), async (c) => {
   const id = Number(c.req.param("id"));
   await ipBanQueries.remove(id);
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "unban_ip", { type: "ip", id: String(id) }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "unban_ip",
+    { type: "ip", id: String(id) },
+    "success",
+  );
   return c.json({ success: true });
 });
 
@@ -739,21 +1235,54 @@ admin.get("/admin/reports", modRequired(), async (c) => {
   const db = getDb();
   const where = eq(reports.status, status);
   const [list, totalResult] = await Promise.all([
-    db.select().from(reports).where(where).orderBy(desc(reports.createAt)).limit(pagination.limit).offset(pagination.offset),
+    db
+      .select()
+      .from(reports)
+      .where(where)
+      .orderBy(desc(reports.createAt))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
     db.select({ c: count() }).from(reports).where(where),
   ]);
-  const data = await Promise.all(list.map(async (report: any) => {
-    const summary = await getReportTargetSummary(report.targetType, report.targetId);
-    const reporterCount = (await db.select({ c: sql<number>`count(distinct ${reports.reporterId})` }).from(reports).where(and(eq(reports.targetType, report.targetType), eq(reports.targetId, report.targetId), eq(reports.status, status))))[0]?.c ?? 0;
-    return { id: report.id, type: report.type, description: report.description, status: report.status, reporter_count: Number(reporterCount), target_type: report.targetType, target_id: String(report.targetId), topic_id: summary?.topic_id || null, topic_title: summary?.title || "目标内容已不可见", target_summary: summary?.summary || "目标内容已不可见", create_at: report.createAt };
-  }));
+  const data = await Promise.all(
+    list.map(async (report: any) => {
+      const summary = await getReportTargetSummary(report.targetType, report.targetId);
+      const reporterCount =
+        (
+          await db
+            .select({ c: sql<number>`count(distinct ${reports.reporterId})` })
+            .from(reports)
+            .where(
+              and(
+                eq(reports.targetType, report.targetType),
+                eq(reports.targetId, report.targetId),
+                eq(reports.status, status),
+              ),
+            )
+        )[0]?.c ?? 0;
+      return {
+        id: report.id,
+        type: report.type,
+        description: report.description,
+        status: report.status,
+        reporter_count: Number(reporterCount),
+        target_type: report.targetType,
+        target_id: String(report.targetId),
+        topic_id: summary?.topic_id || null,
+        topic_title: summary?.title || "目标内容已不可见",
+        target_summary: summary?.summary || "目标内容已不可见",
+        create_at: report.createAt,
+      };
+    }),
+  );
   return c.json(paginated(data, Number(totalResult[0]?.c || 0), pagination));
 });
 
 admin.post("/admin/reports/:id/:action", modRequired(), async (c) => {
   const id = Number(c.req.param("id"));
   const action = c.req.param("action");
-  if (!["confirm", "dismiss"].includes(action)) return c.json({ success: false, error_msg: "不支持的操作" }, 400);
+  if (!["confirm", "dismiss"].includes(action))
+    return c.json({ success: false, error_msg: "不支持的操作" }, 400);
   const user = c.get("user")!;
   const db = getDb();
   const report = (await db.select().from(reports).where(eq(reports.id, id)).limit(1))[0] as any;
@@ -763,30 +1292,79 @@ admin.post("/admin/reports/:id/:action", modRequired(), async (c) => {
     const authorId = await hideReportTarget(report.targetType, report.targetId);
     if (authorId) await applyProgressivePenalty(authorId, user.id, user.loginname, `report:${id}`);
   }
-  await auditQueries.log(user.id, user.loginname, `report_${action}`, { type: "report", id: String(id) }, action === "confirm" ? "confirmed" : "dismissed");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    `report_${action}`,
+    { type: "report", id: String(id) },
+    action === "confirm" ? "confirmed" : "dismissed",
+  );
   return c.json({ success: true });
 });
 
 const createReportRoute = createRoute({
-  method: "post", path: "/admin/reports", tags: ["admin"], summary: "创建举报",
+  method: "post",
+  path: "/admin/reports",
+  tags: ["admin"],
+  summary: "创建举报",
   request: { body: { content: { "application/json": { schema: createReportBodySchema } } } },
-  responses: { 200: { description: "举报成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 404: { description: "目标不存在", content: { "application/json": { schema: errorResponseSchema } } }, 422: { description: "目标无效", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "举报成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "目标不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "目标无效",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 admin.openapi(createReportRoute, async (c) => {
   const user = c.get("user");
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const { targetType, targetId, type, description } = c.req.valid("json");
   const tid = Number(targetId);
-  if (!tid || Number.isNaN(tid)) return c.json({ success: false as const, error_msg: "举报目标无效" }, 422);
+  if (!tid || Number.isNaN(tid))
+    return c.json({ success: false as const, error_msg: "举报目标无效" }, 422);
   const summary = await getReportTargetSummary(targetType, tid);
   if (!summary) return c.json({ success: false as const, error_msg: "举报目标不存在" }, 404);
   await reportQueries.create({ targetType, targetId: tid, reporterId: user.id, type, description });
   const db = getDb();
-  const threshold = Math.max(1, Number(await settingQueries.get("report_auto_hide_threshold", "3")) || 3);
-  const reporterCount = (await db.select({ c: sql<number>`count(distinct ${reports.reporterId})` }).from(reports).where(and(eq(reports.targetType, targetType), eq(reports.targetId, tid), eq(reports.status, "pending"))))[0]?.c ?? 0;
+  const threshold = Math.max(
+    1,
+    Number(await settingQueries.get("report_auto_hide_threshold", "3")) || 3,
+  );
+  const reporterCount =
+    (
+      await db
+        .select({ c: sql<number>`count(distinct ${reports.reporterId})` })
+        .from(reports)
+        .where(
+          and(
+            eq(reports.targetType, targetType),
+            eq(reports.targetId, tid),
+            eq(reports.status, "pending"),
+          ),
+        )
+    )[0]?.c ?? 0;
   if (Number(reporterCount) >= threshold) {
     await hideReportTarget(targetType, tid);
-    await auditQueries.log(user.id, user.loginname, "report_auto_hide", { type: targetType, id: String(tid), name: summary.title }, "success", JSON.stringify({ reporter_count: Number(reporterCount), threshold }));
+    await auditQueries.log(
+      user.id,
+      user.loginname,
+      "report_auto_hide",
+      { type: targetType, id: String(tid), name: summary.title },
+      "success",
+      JSON.stringify({ reporter_count: Number(reporterCount), threshold }),
+    );
   }
   return c.json({ success: true as const }, 200);
 });
@@ -800,11 +1378,25 @@ admin.get("/admin/keywords", adminRequired(), async (c) => {
   const conditions: any[] = [];
   if (q) conditions.push(sql`${sensitiveWords.word} LIKE ${`%${q}%`}`);
   if (category) conditions.push(eq(sensitiveWords.category, category));
-  const where = conditions.length === 0 ? undefined : conditions.length === 1 ? conditions[0] : and(...conditions);
+  const where =
+    conditions.length === 0
+      ? undefined
+      : conditions.length === 1
+        ? conditions[0]
+        : and(...conditions);
   let listQuery = db.select().from(sensitiveWords).$dynamic();
   let totalQuery = db.select({ c: count() }).from(sensitiveWords).$dynamic();
-  if (where) { listQuery = listQuery.where(where) as any; totalQuery = totalQuery.where(where) as any; }
-  const [list, totalResult] = await Promise.all([listQuery.orderBy(desc(sensitiveWords.createAt)).limit(pagination.limit).offset(pagination.offset), totalQuery]);
+  if (where) {
+    listQuery = listQuery.where(where) as any;
+    totalQuery = totalQuery.where(where) as any;
+  }
+  const [list, totalResult] = await Promise.all([
+    listQuery
+      .orderBy(desc(sensitiveWords.createAt))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
+    totalQuery,
+  ]);
   return c.json(paginated(list, Number(totalResult[0]?.c || 0), pagination));
 });
 
@@ -813,7 +1405,13 @@ admin.post("/admin/keywords", adminRequired(), async (c) => {
   if (!body.word) return c.json({ success: false, error_msg: "缺少 word" }, 400);
   const keyword = await keywordQueries.add(body.word, body.category);
   invalidateWordCache();
-  if (keyword?.id) await createScanJob({ scope: "all", mode: "historical", reason: "keyword_added", keywordIds: [keyword.id] });
+  if (keyword?.id)
+    await createScanJob({
+      scope: "all",
+      mode: "historical",
+      reason: "keyword_added",
+      keywordIds: [keyword.id],
+    });
   return c.json({ success: true });
 });
 
@@ -829,7 +1427,8 @@ admin.post("/admin/keywords/bulk", adminRequired(), async (c) => {
     if (keyword?.id) keywordIds.push(keyword.id);
   }
   invalidateWordCache();
-  if (keywordIds.length) await createScanJob({ scope: "all", mode: "historical", reason: "keyword_added", keywordIds });
+  if (keywordIds.length)
+    await createScanJob({ scope: "all", mode: "historical", reason: "keyword_added", keywordIds });
   return c.json({ success: true, added: words.length });
 });
 
@@ -851,51 +1450,127 @@ admin.get("/admin/moderation", modRequired(), async (c) => {
   if (status !== "all") conditions.push(eq(moderationHits.status, status));
   if (type === "topic" || type === "reply") conditions.push(eq(moderationHits.targetType, type));
   if (jobId > 0) conditions.push(eq(moderationHits.scanJobId, jobId));
-  const where = conditions.length === 0 ? undefined : conditions.length === 1 ? conditions[0] : and(...conditions);
+  const where =
+    conditions.length === 0
+      ? undefined
+      : conditions.length === 1
+        ? conditions[0]
+        : and(...conditions);
   let listQuery = db.select().from(moderationHits).$dynamic();
   let totalQuery = db.select({ c: count() }).from(moderationHits).$dynamic();
-  if (where) { listQuery = listQuery.where(where) as any; totalQuery = totalQuery.where(where) as any; }
-  const [list, totalResult] = await Promise.all([listQuery.orderBy(desc(moderationHits.scannedAt), desc(moderationHits.targetId)).limit(pagination.limit).offset(pagination.offset), totalQuery]);
-  const summary = list.reduce((acc: any, hit: any) => {
-    acc.by_type[hit.targetType] = (acc.by_type[hit.targetType] || 0) + 1;
-    const keywords = Array.isArray(hit.keywords) ? hit.keywords : JSON.parse(hit.keywords || "[]");
-    for (const keyword of keywords) acc.by_keyword[keyword] = (acc.by_keyword[keyword] || 0) + 1;
-    return acc;
-  }, { by_type: {}, by_keyword: {} });
-  return c.json({ success: true, data: list.map((hit: any) => ({ id: hit.id, scan_job_id: hit.scanJobId, type: hit.targetType, target_id: hit.targetId, topic_id: hit.topicId, author_id: hit.authorId, field: hit.field, scanned_at: hit.scannedAt, keywords: Array.isArray(hit.keywords) ? hit.keywords : JSON.parse(hit.keywords || "[]"), preview: hit.preview, status: hit.status })), total: Number(totalResult[0]?.c || 0), page: pagination.page, limit: pagination.limit, summary });
+  if (where) {
+    listQuery = listQuery.where(where) as any;
+    totalQuery = totalQuery.where(where) as any;
+  }
+  const [list, totalResult] = await Promise.all([
+    listQuery
+      .orderBy(desc(moderationHits.scannedAt), desc(moderationHits.targetId))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
+    totalQuery,
+  ]);
+  const summary = list.reduce(
+    (acc: any, hit: any) => {
+      acc.by_type[hit.targetType] = (acc.by_type[hit.targetType] || 0) + 1;
+      const keywords = Array.isArray(hit.keywords)
+        ? hit.keywords
+        : JSON.parse(hit.keywords || "[]");
+      for (const keyword of keywords) acc.by_keyword[keyword] = (acc.by_keyword[keyword] || 0) + 1;
+      return acc;
+    },
+    { by_type: {}, by_keyword: {} },
+  );
+  return c.json({
+    success: true,
+    data: list.map((hit: any) => ({
+      id: hit.id,
+      scan_job_id: hit.scanJobId,
+      type: hit.targetType,
+      target_id: hit.targetId,
+      topic_id: hit.topicId,
+      author_id: hit.authorId,
+      field: hit.field,
+      scanned_at: hit.scannedAt,
+      keywords: Array.isArray(hit.keywords) ? hit.keywords : JSON.parse(hit.keywords || "[]"),
+      preview: hit.preview,
+      status: hit.status,
+    })),
+    total: Number(totalResult[0]?.c || 0),
+    page: pagination.page,
+    limit: pagination.limit,
+    summary,
+  });
 });
 
-async function applyModerationHitAction(hit: any, action: "confirm" | "falsepositive" | "ignore", user: any) {
+async function applyModerationHitAction(
+  hit: any,
+  action: "confirm" | "falsepositive" | "ignore",
+  user: any,
+) {
   const db = getDb();
   const current = await handleModerationHit(hit.id, action, user.id);
   if (!current) return false;
   if (action === "confirm") {
-    if (hit.targetType === "topic") await db.update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.id, hit.targetId));
+    if (hit.targetType === "topic")
+      await db
+        .update(topics)
+        .set({ deleted: boolValue(true), status: "deleted" } as any)
+        .where(eq(topics.id, hit.targetId));
     else if (hit.targetType === "reply") {
       const reply = await replyQueries.getById(hit.targetId);
-      if (reply && !reply.deleted) await replyQueries.deleteWithAggregates(reply.id, reply.authorId, true);
+      if (reply && !reply.deleted)
+        await replyQueries.deleteWithAggregates(reply.id, reply.authorId, true);
     }
-    if (hit.authorId) await applyProgressivePenalty(hit.authorId, user.id, user.loginname, `moderation_hit:${hit.id}`);
+    if (hit.authorId)
+      await applyProgressivePenalty(
+        hit.authorId,
+        user.id,
+        user.loginname,
+        `moderation_hit:${hit.id}`,
+      );
   }
   return true;
 }
 
 admin.post("/admin/moderation/bulk", modRequired(), async (c) => {
   const body = await c.req.json().catch(() => ({}));
-  const ids = Array.isArray(body.ids) ? body.ids.map(Number).filter((id: number) => id > 0).slice(0, 100) : [];
+  const ids = Array.isArray(body.ids)
+    ? body.ids
+        .map(Number)
+        .filter((id: number) => id > 0)
+        .slice(0, 100)
+    : [];
   const jobId = Number(body.job_id || 0);
   const action = String(body.action || "");
-  if (!["confirm", "falsepositive", "ignore"].includes(action)) return c.json({ success: false, error_msg: "不支持的操作" }, 400);
+  if (!["confirm", "falsepositive", "ignore"].includes(action))
+    return c.json({ success: false, error_msg: "不支持的操作" }, 400);
   const db = getDb();
   const user = c.get("user")!;
   if (jobId > 0 && !ids.length) {
-    if (!canRunJobBulkModerationAction(action, c.get("isAdmin"))) return c.json({ success: false, error_msg: action === "confirm" ? "需要管理员权限" : "任务级批量处理仅支持确认删除" }, action === "confirm" ? 403 : 400);
-    const hits = await db.select().from(moderationHits).where(and(eq(moderationHits.scanJobId, jobId), eq(moderationHits.status, "pending")));
+    if (!canRunJobBulkModerationAction(action, c.get("isAdmin")))
+      return c.json(
+        {
+          success: false,
+          error_msg: action === "confirm" ? "需要管理员权限" : "任务级批量处理仅支持确认删除",
+        },
+        action === "confirm" ? 403 : 400,
+      );
+    const hits = await db
+      .select()
+      .from(moderationHits)
+      .where(and(eq(moderationHits.scanJobId, jobId), eq(moderationHits.status, "pending")));
     let handled = 0;
     for (const hit of hits) {
       if (await applyModerationHitAction(hit, action as any, user)) handled += 1;
     }
-    await auditQueries.log(user.id, user.loginname, `moderation_job_bulk_${action}`, { type: "scan_job", id: String(jobId) }, action, JSON.stringify({ job_id: jobId, handled }));
+    await auditQueries.log(
+      user.id,
+      user.loginname,
+      `moderation_job_bulk_${action}`,
+      { type: "scan_job", id: String(jobId) },
+      action,
+      JSON.stringify({ job_id: jobId, handled }),
+    );
     return c.json({ success: true, handled });
   }
   if (!ids.length) return c.json({ success: false, error_msg: "未选择巡检记录" }, 400);
@@ -904,7 +1579,14 @@ admin.post("/admin/moderation/bulk", modRequired(), async (c) => {
   for (const hit of hits) {
     if (await applyModerationHitAction(hit, action as any, user)) handled += 1;
   }
-  await auditQueries.log(user.id, user.loginname, `moderation_bulk_${action}`, { type: "moderation_hit" }, action, JSON.stringify({ ids, handled }));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    `moderation_bulk_${action}`,
+    { type: "moderation_hit" },
+    action,
+    JSON.stringify({ ids, handled }),
+  );
   return c.json({ success: true, handled });
 });
 
@@ -912,18 +1594,37 @@ admin.post("/admin/moderation/:id/:action", modRequired(), async (c) => {
   const id = Number(c.req.param("id"));
   const action = c.req.param("action");
   const user = c.get("user")!;
-  if (!["confirm", "falsepositive", "ignore"].includes(action)) return c.json({ success: false, error_msg: "不支持的操作" }, 400);
+  if (!["confirm", "falsepositive", "ignore"].includes(action))
+    return c.json({ success: false, error_msg: "不支持的操作" }, 400);
   const hit = await handleModerationHit(id, action as any, user.id);
   if (!hit) return c.json({ success: false, error_msg: "巡检记录不存在" }, 404);
   if (action === "confirm") {
-    if (hit.targetType === "topic") await getDb().update(topics).set({ deleted: boolValue(true), status: "deleted" } as any).where(eq(topics.id, hit.targetId));
+    if (hit.targetType === "topic")
+      await getDb()
+        .update(topics)
+        .set({ deleted: boolValue(true), status: "deleted" } as any)
+        .where(eq(topics.id, hit.targetId));
     else if (hit.targetType === "reply") {
       const reply = await replyQueries.getById(hit.targetId);
-      if (reply && !reply.deleted) await replyQueries.deleteWithAggregates(reply.id, reply.authorId, true);
+      if (reply && !reply.deleted)
+        await replyQueries.deleteWithAggregates(reply.id, reply.authorId, true);
     }
-    if (hit.authorId) await applyProgressivePenalty(hit.authorId, user.id, user.loginname, `moderation_hit:${hit.id}`);
+    if (hit.authorId)
+      await applyProgressivePenalty(
+        hit.authorId,
+        user.id,
+        user.loginname,
+        `moderation_hit:${hit.id}`,
+      );
   }
-  await auditQueries.log(user.id, user.loginname, `moderation_${action}`, { type: hit.targetType, id: String(hit.targetId) }, action, JSON.stringify({ hit_id: id, topic_id: hit.topicId }));
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    `moderation_${action}`,
+    { type: hit.targetType, id: String(hit.targetId) },
+    action,
+    JSON.stringify({ hit_id: id, topic_id: hit.topicId }),
+  );
   return c.json({ success: true });
 });
 
@@ -931,24 +1632,46 @@ admin.get("/admin/moderation/jobs", adminRequired(), async (c) => {
   const pagination = getPagination(c);
   const db = getDb();
   const [list, totalResult] = await Promise.all([
-    db.select().from(moderationScanJobs).orderBy(desc(moderationScanJobs.createAt)).limit(pagination.limit).offset(pagination.offset),
+    db
+      .select()
+      .from(moderationScanJobs)
+      .orderBy(desc(moderationScanJobs.createAt))
+      .limit(pagination.limit)
+      .offset(pagination.offset),
     db.select({ c: count() }).from(moderationScanJobs),
   ]);
   const hitCounts = await Promise.all(
     list.map(async (job: any) => {
-      const rows = await db.select({ c: count() }).from(moderationHits).where(eq(moderationHits.scanJobId, job.id));
+      const rows = await db
+        .select({ c: count() })
+        .from(moderationHits)
+        .where(eq(moderationHits.scanJobId, job.id));
       return [job.id, Number(rows[0]?.c || 0)] as const;
     }),
   );
   const pendingCounts = await Promise.all(
     list.map(async (job: any) => {
-      const rows = await db.select({ c: count() }).from(moderationHits).where(and(eq(moderationHits.scanJobId, job.id), eq(moderationHits.status, "pending")));
+      const rows = await db
+        .select({ c: count() })
+        .from(moderationHits)
+        .where(and(eq(moderationHits.scanJobId, job.id), eq(moderationHits.status, "pending")));
       return [job.id, Number(rows[0]?.c || 0)] as const;
     }),
   );
   const hitsByJobId = new Map(hitCounts);
   const pendingByJobId = new Map(pendingCounts);
-  return c.json(paginated(list.map((job: any) => ({ ...job, hitCount: hitsByJobId.get(job.id) || 0, rawHitCount: job.hitCount || 0, pendingHitCount: pendingByJobId.get(job.id) || 0 })), Number(totalResult[0]?.c || 0), pagination));
+  return c.json(
+    paginated(
+      list.map((job: any) => ({
+        ...job,
+        hitCount: hitsByJobId.get(job.id) || 0,
+        rawHitCount: job.hitCount || 0,
+        pendingHitCount: pendingByJobId.get(job.id) || 0,
+      })),
+      Number(totalResult[0]?.c || 0),
+      pagination,
+    ),
+  );
 });
 
 admin.post("/admin/moderation/jobs", adminRequired(), async (c) => {
@@ -957,7 +1680,13 @@ admin.post("/admin/moderation/jobs", adminRequired(), async (c) => {
   const mode = body.mode === "incremental" ? "incremental" : "historical";
   const job = await createScanJob({ scope, mode, reason: "manual" });
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "moderation_scan_create", { type: "scan_job", id: String(job.id) }, "created");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "moderation_scan_create",
+    { type: "scan_job", id: String(job.id) },
+    "created",
+  );
   void triggerScanDrain().catch((error) => console.error("[moderation scan trigger]", error));
   return c.json({ success: true, data: job });
 });
@@ -967,18 +1696,28 @@ admin.post("/admin/moderation/jobs/:id/:action", adminRequired(), async (c) => {
   const action = c.req.param("action");
   const user = c.get("user")!;
   if (action === "pause") await pauseScanJob(id);
-  else if (action === "resume") { await resumeScanJob(id); void triggerScanDrain().catch((error) => console.error("[moderation scan trigger]", error)); }
-  else if (action === "run") {
+  else if (action === "resume") {
+    await resumeScanJob(id);
+    void triggerScanDrain().catch((error) => console.error("[moderation scan trigger]", error));
+  } else if (action === "run") {
     const job = await runScanJobNow(id);
     if (!job) return c.json({ success: false, error_msg: "任务不存在" }, 404);
-    if (["done", "failed", "cancelled"].includes(job.status)) return c.json({ success: false, error_msg: "任务已结束，不能立即执行" }, 422);
+    if (["done", "failed", "cancelled"].includes(job.status))
+      return c.json({ success: false, error_msg: "任务已结束，不能立即执行" }, 422);
     void triggerScanDrain().catch((error) => console.error("[moderation scan trigger]", error));
   } else if (action === "cancel") {
     const job = await cancelScanJob(id);
     if (!job) return c.json({ success: false, error_msg: "任务不存在" }, 404);
-    if (["done", "failed"].includes(job.status)) return c.json({ success: false, error_msg: "任务已结束，不能取消" }, 422);
+    if (["done", "failed"].includes(job.status))
+      return c.json({ success: false, error_msg: "任务已结束，不能取消" }, 422);
   } else return c.json({ success: false, error_msg: "不支持的操作" }, 400);
-  await auditQueries.log(user.id, user.loginname, `moderation_scan_${action}`, { type: "scan_job", id: String(id) }, action);
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    `moderation_scan_${action}`,
+    { type: "scan_job", id: String(id) },
+    action,
+  );
   return c.json({ success: true });
 });
 
@@ -1006,11 +1745,16 @@ admin.get("/admin/audit", adminRequired(), async (c) => {
     return (!category || meta.category === category) && (!risk || meta.risk === risk);
   };
   const filteredSummaryRows = summaryRows.filter(matchesMeta);
-  const pageRows = category || risk
-    ? filteredSummaryRows.slice(pagination.offset, pagination.offset + pagination.limit)
-    : list;
+  const pageRows =
+    category || risk
+      ? filteredSummaryRows.slice(pagination.offset, pagination.offset + pagination.limit)
+      : list;
   return c.json({
-    ...paginated(pageRows.map(formatAuditLog), category || risk ? filteredSummaryRows.length : Number(totalResult[0]?.c || 0), pagination),
+    ...paginated(
+      pageRows.map(formatAuditLog),
+      category || risk ? filteredSummaryRows.length : Number(totalResult[0]?.c || 0),
+      pagination,
+    ),
     summary: auditSummary(filteredSummaryRows),
   });
 });
@@ -1018,25 +1762,51 @@ admin.get("/admin/audit", adminRequired(), async (c) => {
 // ── Settings ──
 admin.get("/admin/settings", adminRequired(), async (c) => {
   const settings = await settingQueries.getAll();
-  return c.json({ success: true, data: { allow_signup: settings.allow_signup !== "false", new_user_min_hours: Number(settings.new_user_min_hours) || 24, new_user_min_replies: Number(settings.new_user_min_replies) || 3, rate_topic: Number(settings.rate_topic) || 1000, rate_reply: Number(settings.rate_reply) || 1000 } });
+  return c.json({
+    success: true,
+    data: {
+      allow_signup: settings.allow_signup !== "false",
+      new_user_min_hours: Number(settings.new_user_min_hours) || 24,
+      new_user_min_replies: Number(settings.new_user_min_replies) || 3,
+      rate_topic: Number(settings.rate_topic) || 1000,
+      rate_reply: Number(settings.rate_reply) || 1000,
+    },
+  });
 });
 
 admin.post("/admin/settings", adminRequired(), async (c) => {
   const body = await c.req.json().catch(() => ({}));
-  const allowedKeys = new Set(["allow_signup", "new_user_min_hours", "new_user_min_replies", "rate_topic", "rate_reply"]);
-  for (const [key, value] of Object.entries(body)) { if (!allowedKeys.has(key)) continue; await settingQueries.set(key, String(value)); }
+  const allowedKeys = new Set([
+    "allow_signup",
+    "new_user_min_hours",
+    "new_user_min_replies",
+    "rate_topic",
+    "rate_reply",
+  ]);
+  for (const [key, value] of Object.entries(body)) {
+    if (!allowedKeys.has(key)) continue;
+    await settingQueries.set(key, String(value));
+  }
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "update_settings", { type: "settings" }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "update_settings",
+    { type: "settings" },
+    "success",
+  );
   return c.json({ success: true });
 });
 
 // ── RSS ──
 admin.get("/rss", async (c) => {
   const topicsList = await topicQueries.getByQuery({ deleted: 0 }, { limit: 50 });
-  const items = topicsList.map((t: any) => {
-    const pubDate = t.createAt ? new Date(t.createAt) : new Date();
-    return `    <item>\n      <title><![CDATA[${t.title}]]></title>\n      <link>https://cnodejs.org/topic/${t.id}</link>\n      <guid>https://cnodejs.org/topic/${t.id}</guid>\n      <pubDate>${isNaN(pubDate.getTime()) ? new Date().toUTCString() : pubDate.toUTCString()}</pubDate>\n    </item>`;
-  }).join("");
+  const items = topicsList
+    .map((t: any) => {
+      const pubDate = t.createAt ? new Date(t.createAt) : new Date();
+      return `    <item>\n      <title><![CDATA[${t.title}]]></title>\n      <link>https://cnodejs.org/topic/${t.id}</link>\n      <guid>https://cnodejs.org/topic/${t.id}</guid>\n      <pubDate>${isNaN(pubDate.getTime()) ? new Date().toUTCString() : pubDate.toUTCString()}</pubDate>\n    </item>`;
+    })
+    .join("");
   const xml = `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0">\n  <channel>\n    <title>CNode：Node.js专业中文社区</title>\n    <link>https://cnodejs.org</link>\n    <language>zh-cn</language>\n    <description>CNode：Node.js专业中文社区</description>\n    ${items}\n  </channel>\n</rss>`;
   return c.body(xml, { headers: { "Content-Type": "application/xml; charset=utf-8" } });
 });
@@ -1044,12 +1814,14 @@ admin.get("/rss", async (c) => {
 // ── Sitemap ──
 admin.get("/sitemap.xml", async (c) => {
   const topicsList = await topicQueries.getByQuery({ deleted: 0 }, { limit: 50000 });
-  const urls = topicsList.map((t: any) => {
-    const dateStr = t.updateAt || t.createAt;
-    const date = dateStr ? new Date(dateStr) : new Date();
-    const iso = isNaN(date.getTime()) ? new Date().toISOString() : date.toISOString();
-    return `  <url>\n    <loc>https://cnodejs.org/topic/${t.id}</loc>\n    <lastmod>${iso}</lastmod>\n  </url>`;
-  }).join("");
+  const urls = topicsList
+    .map((t: any) => {
+      const dateStr = t.updateAt || t.createAt;
+      const date = dateStr ? new Date(dateStr) : new Date();
+      const iso = isNaN(date.getTime()) ? new Date().toISOString() : date.toISOString();
+      return `  <url>\n    <loc>https://cnodejs.org/topic/${t.id}</loc>\n    <lastmod>${iso}</lastmod>\n  </url>`;
+    })
+    .join("");
   const xml = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n  <url><loc>https://cnodejs.org</loc></url>\n  ${urls}\n</urlset>`;
   return c.body(xml, { headers: { "Content-Type": "application/xml; charset=utf-8" } });
 });
@@ -1060,16 +1832,43 @@ admin.get("/search", async (c) => {
   const engine = c.req.query("engine") || process.env.CNODE_SEARCH_ENGINE || "google";
   if (engine === "local") {
     const db = getDb();
-    const results = await db.select().from(topics).where(and(sql`(${topics.title} LIKE ${`%${q}%`} OR ${topics.content} LIKE ${`%${q}%`})`, boolEq(topics.deleted, false), sql`${topics.status} != 'deleted'`, sql`${topics.tab} NOT IN ('dev', 'test')`)).orderBy(desc(topics.lastReplyAt)).limit(20);
+    const results = await db
+      .select()
+      .from(topics)
+      .where(
+        and(
+          sql`(${topics.title} LIKE ${`%${q}%`} OR ${topics.content} LIKE ${`%${q}%`})`,
+          boolEq(topics.deleted, false),
+          sql`${topics.status} != 'deleted'`,
+          sql`${topics.tab} NOT IN ('dev', 'test')`,
+        ),
+      )
+      .orderBy(desc(topics.lastReplyAt))
+      .limit(20);
     const data: any[] = [];
     for (const topic of results as any[]) {
       const author = await userQueries.getById(topic.authorId);
       if (author?.isBlock) continue;
-      data.push({ id: String(topic.id), author_id: String(topic.authorId), tab: topic.tab, title: topic.title, last_reply_at: topic.lastReplyAt, good: !!topic.good, top: !!topic.top, reply_count: topic.replyCount, visit_count: topic.visitCount, create_at: topic.createAt, author: userSummary(author) });
+      data.push({
+        id: String(topic.id),
+        author_id: String(topic.authorId),
+        tab: topic.tab,
+        title: topic.title,
+        last_reply_at: topic.lastReplyAt,
+        good: !!topic.good,
+        top: !!topic.top,
+        reply_count: topic.replyCount,
+        visit_count: topic.visitCount,
+        create_at: topic.createAt,
+        author: userSummary(author),
+      });
     }
     return c.json({ success: true, data });
   }
-  const searchUrls: Record<string, string> = { google: `https://www.google.com/search?q=site:cnodejs.org+${encodeURIComponent(q)}`, baidu: `https://www.baidu.com/s?wd=site:cnodejs.org+${encodeURIComponent(q)}` };
+  const searchUrls: Record<string, string> = {
+    google: `https://www.google.com/search?q=site:cnodejs.org+${encodeURIComponent(q)}`,
+    baidu: `https://www.baidu.com/s?wd=site:cnodejs.org+${encodeURIComponent(q)}`,
+  };
   return c.redirect(searchUrls[engine] || searchUrls.google);
 });
 
@@ -1102,7 +1901,13 @@ admin.patch("/admin/zones/:id", adminRequired(), async (c) => {
   if (!updated) return c.json({ success: false, error_msg: "专区不存在" }, 404);
 
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "update_zone", { type: "zone", id: String(id), name: updated.slug }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "update_zone",
+    { type: "zone", id: String(id), name: updated.slug },
+    "success",
+  );
   return c.json({
     success: true,
     data: {
@@ -1143,7 +1948,13 @@ admin.patch("/admin/tabs/:id", adminRequired(), async (c) => {
   if (!updated) return c.json({ success: false, error_msg: "Tab 不存在" }, 404);
 
   const user = c.get("user")!;
-  await auditQueries.log(user.id, user.loginname, "update_tab", { type: "tab", id: String(id), name: updated.key }, "success");
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    "update_tab",
+    { type: "tab", id: String(id), name: updated.key },
+    "success",
+  );
   return c.json({
     success: true,
     data: {
diff --git a/apps/api/src/routes/auth.ts b/apps/api/src/routes/auth.ts
index f130159..7ee0dab 100644
--- a/apps/api/src/routes/auth.ts
+++ b/apps/api/src/routes/auth.ts
@@ -16,7 +16,12 @@ import {
 } from "@cnode/shared";
 import { auditQueries, settingQueries, userQueries } from "../lib/db";
 import { sendActiveMail, sendResetPassMail } from "../lib/mail";
-import { setSessionCookie, clearSessionCookie, authMiddleware, type AuthVars } from "../middleware/auth";
+import {
+  setSessionCookie,
+  clearSessionCookie,
+  authMiddleware,
+  type AuthVars,
+} from "../middleware/auth";
 import { perIpPerDay, perUserPerDay } from "../middleware/rate-limit";
 import { requestIp, verifyTurnstile } from "../lib/turnstile";
 import {
@@ -36,9 +41,18 @@ const GITHUB_OAUTH_COOKIE = "github_oauth_state";
 
 const presignUploadSchema = z.object({
   filename: z.string().max(255).optional(),
-  contentType: z.string().regex(/^image\/(png|jpeg|gif|webp|svg\+xml)$/).default("image/png"),
+  contentType: z
+    .string()
+    .regex(/^image\/(png|jpeg|gif|webp|svg\+xml)$/)
+    .default("image/png"),
 });
-const allowedImageTypes = new Set(["image/png", "image/jpeg", "image/gif", "image/webp", "image/svg+xml"]);
+const allowedImageTypes = new Set([
+  "image/png",
+  "image/jpeg",
+  "image/gif",
+  "image/webp",
+  "image/svg+xml",
+]);
 const allowedImageExtensions = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"]);
 
 function extensionForContentType(contentType: string) {
@@ -54,53 +68,132 @@ function createOssClient() {
   const bucket = process.env.OSS_BUCKET;
   const region = process.env.OSS_REGION || "oss-cn-hangzhou";
   const endpoint = process.env.OSS_ENDPOINT || undefined;
-  if (!accessKeyId || !accessKeySecret || !bucket) throw new Error("OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET and OSS_BUCKET are required");
+  if (!accessKeyId || !accessKeySecret || !bucket)
+    throw new Error("OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET and OSS_BUCKET are required");
   return new OSS({ accessKeyId, accessKeySecret, bucket, region, endpoint });
 }
 function uploadPrefix(purpose?: string | null) {
   const base = (process.env.OSS_UPLOAD_PREFIX || "cnode-next/uploads").replace(/^\/+|\/+$/g, "");
   return purpose === "job-logo" ? `${base}/jobs` : base;
 }
-function staticUploadUrl(filename: string) { return `${(process.env.OSS_STATIC_HOST || "https://static.cnodejs.org").replace(/\/+$/g, "")}/${filename}`; }
-function safeOriginalName(name: string) { return name.replace(/[/\\]/g, "").trim().slice(0, 255) || "image"; }
-function extensionForFilename(name: string) { return name.toLowerCase().match(/\.[a-z0-9]+$/)?.[0] || ""; }
-function webBaseUrl() { return process.env.CNODE_WEB_BASE_URL || "http://localhost:5173"; }
-function cookieSecret() { return process.env.AUTH_SESSION_SECRET || "local-dev-secret"; }
+function staticUploadUrl(filename: string) {
+  return `${(process.env.OSS_STATIC_HOST || "https://static.cnodejs.org").replace(/\/+$/g, "")}/${filename}`;
+}
+function safeOriginalName(name: string) {
+  return name.replace(/[/\\]/g, "").trim().slice(0, 255) || "image";
+}
+function extensionForFilename(name: string) {
+  return name.toLowerCase().match(/\.[a-z0-9]+$/)?.[0] || "";
+}
+function webBaseUrl() {
+  return process.env.CNODE_WEB_BASE_URL || "http://localhost:5173";
+}
+function cookieSecret() {
+  return process.env.AUTH_SESSION_SECRET || "local-dev-secret";
+}
 
 function setPendingGithubProfile(c: any, profile: PendingGithubProfile) {
   const domain = process.env.AUTH_COOKIE_DOMAIN || undefined;
-  setCookie(c, GITHUB_PENDING_COOKIE, Buffer.from(JSON.stringify(profile)).toString("base64url"), { domain, path: "/", httpOnly: true, signed: true, secret: cookieSecret(), maxAge: 600, sameSite: "Lax" } as any);
+  setCookie(c, GITHUB_PENDING_COOKIE, Buffer.from(JSON.stringify(profile)).toString("base64url"), {
+    domain,
+    path: "/",
+    httpOnly: true,
+    signed: true,
+    secret: cookieSecret(),
+    maxAge: 600,
+    sameSite: "Lax",
+  } as any);
+}
+function clearPendingGithubProfile(c: any) {
+  deleteCookie(c, GITHUB_PENDING_COOKIE, {
+    domain: process.env.AUTH_COOKIE_DOMAIN || undefined,
+    path: "/",
+  });
 }
-function clearPendingGithubProfile(c: any) { deleteCookie(c, GITHUB_PENDING_COOKIE, { domain: process.env.AUTH_COOKIE_DOMAIN || undefined, path: "/" }); }
 function getPendingGithubProfile(c: any): PendingGithubProfile | null {
   const raw = (getCookie as any)(c, GITHUB_PENDING_COOKIE, cookieSecret());
   if (!raw) return null;
-  try { const p = JSON.parse(Buffer.from(raw, "base64url").toString("utf8")); return p.id && p.login && p.email && p.accessToken ? p : null; } catch { return null; }
+  try {
+    const p = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
+    return p.id && p.login && p.email && p.accessToken ? p : null;
+  } catch {
+    return null;
+  }
 }
 function getGithubOAuthState(c: any): GithubOAuthState | null {
-  const raw = getCookie(c, GITHUB_OAUTH_COOKIE); if (!raw) return null;
-  try { const p = JSON.parse(decodeURIComponent(raw)); return p.state && ["login","bind"].includes(p.intent) ? p : null; } catch { return null; }
+  const raw = getCookie(c, GITHUB_OAUTH_COOKIE);
+  if (!raw) return null;
+  try {
+    const p = JSON.parse(decodeURIComponent(raw));
+    return p.state && ["login", "bind"].includes(p.intent) ? p : null;
+  } catch {
+    return null;
+  }
+}
+function clearGithubOAuthState(c: any) {
+  deleteCookie(c, GITHUB_OAUTH_COOKIE, {
+    domain: process.env.AUTH_COOKIE_DOMAIN || undefined,
+    path: "/",
+  });
 }
-function clearGithubOAuthState(c: any) { deleteCookie(c, GITHUB_OAUTH_COOKIE, { domain: process.env.AUTH_COOKIE_DOMAIN || undefined, path: "/" }); }
-async function logGithubAccountAction(user: { id: number; loginname: string }, action: string, result: string, detail: Record<string, string | number | null>) {
-  await auditQueries.log(user.id, user.loginname, action, { type: "user", id: String(user.id), name: user.loginname }, result, JSON.stringify(detail));
+async function logGithubAccountAction(
+  user: { id: number; loginname: string },
+  action: string,
+  result: string,
+  detail: Record<string, string | number | null>,
+) {
+  await auditQueries.log(
+    user.id,
+    user.loginname,
+    action,
+    { type: "user", id: String(user.id), name: user.loginname },
+    result,
+    JSON.stringify(detail),
+  );
 }
-async function rejectGithubBind(c: any, currentUser: { id: number; loginname: string }, githubId: string, githubUsername: string, accessToken: string, error: "github_already_bound" | "github_different_account") {
+async function rejectGithubBind(
+  c: any,
+  currentUser: { id: number; loginname: string },
+  githubId: string,
+  githubUsername: string,
+  accessToken: string,
+  error: "github_already_bound" | "github_different_account",
+) {
   const revoke = await revokeGithubToken(accessToken);
-  await logGithubAccountAction(currentUser, "github_bind", "rejected", { githubId, githubUsername, reason: error, tokenRevoke: revoke.revoked ? revoke.reason : "failed" });
+  await logGithubAccountAction(currentUser, "github_bind", "rejected", {
+    githubId,
+    githubUsername,
+    reason: error,
+    tokenRevoke: revoke.revoked ? revoke.reason : "failed",
+  });
   return c.redirect(`${webBaseUrl()}/setting?error=${error}`);
 }
 
-type PendingGithubProfile = { id: string; login: string; email: string; avatarUrl?: string; accessToken: string };
+type PendingGithubProfile = {
+  id: string;
+  login: string;
+  email: string;
+  avatarUrl?: string;
+  accessToken: string;
+};
 type GithubOAuthState = { state: string; intent: "login" | "bind" };
 
 // --- POST /auth/local/login ---
 const loginRoute = createRoute({
-  method: "post", path: "/auth/local/login", tags: ["auth"], summary: "本地登录",
+  method: "post",
+  path: "/auth/local/login",
+  tags: ["auth"],
+  summary: "本地登录",
   request: { body: { content: { "application/json": { schema: signinBodySchema } } } },
   responses: {
-    200: { description: "登录成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } },
-    403: { description: "用户名或密码错误或账号未激活", content: { "application/json": { schema: errorResponseSchema } } },
+    200: {
+      description: "登录成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    403: {
+      description: "用户名或密码错误或账号未激活",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
   },
 });
 auth.openapi(loginRoute, async (c) => {
@@ -117,8 +210,23 @@ auth.openapi(loginRoute, async (c) => {
 
 // --- GET /auth/config ---
 const configRoute = createRoute({
-  method: "get", path: "/auth/config", tags: ["system config"], summary: "获取公开认证配置",
-  responses: { 200: { description: "配置", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.object({ allow_signup: z.boolean() }) }) } } } },
+  method: "get",
+  path: "/auth/config",
+  tags: ["system config"],
+  summary: "获取公开认证配置",
+  responses: {
+    200: {
+      description: "配置",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.object({ allow_signup: z.boolean() }),
+          }),
+        },
+      },
+    },
+  },
 });
 auth.openapi(configRoute, async (c) => {
   const allowSignup = (await settingQueries.get("allow_signup", "true")) !== "false";
@@ -127,25 +235,47 @@ auth.openapi(configRoute, async (c) => {
 
 // --- POST /auth/local/signup ---
 const signupRoute = createRoute({
-  method: "post", path: "/auth/local/signup", tags: ["auth"], summary: "本地注册",
+  method: "post",
+  path: "/auth/local/signup",
+  tags: ["auth"],
+  summary: "本地注册",
   middleware: [perIpPerDay("create_user_per_ip", CREATE_USER_PER_IP, true)],
   request: { body: { content: { "application/json": { schema: signupBodySchema } } } },
   responses: {
-    200: { description: "注册成功", content: { "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) } } },
-    403: { description: "注册关闭或人机验证失败", content: { "application/json": { schema: errorResponseSchema } } },
-    422: { description: "用户名或邮箱已存在", content: { "application/json": { schema: errorResponseSchema } } },
+    200: {
+      description: "注册成功",
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) },
+      },
+    },
+    403: {
+      description: "注册关闭或人机验证失败",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "用户名或邮箱已存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
   },
 });
 auth.openapi(signupRoute, async (c) => {
   const allowSignup = (await settingQueries.get("allow_signup", "true")) !== "false";
   if (!allowSignup) return c.json({ success: false as const, error_msg: "当前暂不开放注册" }, 403);
   const { loginname, pass, email, turnstileToken } = c.req.valid("json");
-  if (!(await verifyTurnstile(turnstileToken, requestIp(c)))) return c.json({ success: false as const, error_msg: "人机验证失败" }, 403);
-  if (await userQueries.getByLoginName(loginname.toLowerCase())) return c.json({ success: false as const, error_msg: "用户名已被使用" }, 422);
-  if (await userQueries.getByEmail(email)) return c.json({ success: false as const, error_msg: "邮箱已被使用" }, 422);
+  if (!(await verifyTurnstile(turnstileToken, requestIp(c))))
+    return c.json({ success: false as const, error_msg: "人机验证失败" }, 403);
+  if (await userQueries.getByLoginName(loginname.toLowerCase()))
+    return c.json({ success: false as const, error_msg: "用户名已被使用" }, 422);
+  if (await userQueries.getByEmail(email))
+    return c.json({ success: false as const, error_msg: "邮箱已被使用" }, 422);
   const passhash = await bcryptjs.hash(pass, 10);
   const retrieveKey = uuidv4();
-  const user = await userQueries.newAndSave({ loginname: loginname.toLowerCase(), pass: passhash, email, active: false });
+  const user = await userQueries.newAndSave({
+    loginname: loginname.toLowerCase(),
+    pass: passhash,
+    email,
+    active: false,
+  });
   await userQueries.updateRetrieveKey(user.id, retrieveKey, Date.now());
   if (process.env.CNODE_ENV !== "development") await sendActiveMail(email, retrieveKey);
   return c.json({ success: true as const, message: "注册成功,请查收邮件激活账号" }, 200);
@@ -153,9 +283,23 @@ auth.openapi(signupRoute, async (c) => {
 
 // --- GET /auth/local/active_account ---
 const activeAccountRoute = createRoute({
-  method: "get", path: "/auth/local/active_account", tags: ["auth"], summary: "激活账号",
+  method: "get",
+  path: "/auth/local/active_account",
+  tags: ["auth"],
+  summary: "激活账号",
   request: { query: z.object({ key: z.string().optional() }) },
-  responses: { 200: { description: "激活成功", content: { "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) } } }, 400: { description: "无效链接", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "激活成功",
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) },
+      },
+    },
+    400: {
+      description: "无效链接",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(activeAccountRoute, async (c) => {
   const { key } = c.req.valid("query");
@@ -169,13 +313,32 @@ auth.openapi(activeAccountRoute, async (c) => {
 
 // --- POST /auth/local/search_pass ---
 const searchPassRoute = createRoute({
-  method: "post", path: "/auth/local/search_pass", tags: ["auth"], summary: "找回密码",
+  method: "post",
+  path: "/auth/local/search_pass",
+  tags: ["auth"],
+  summary: "找回密码",
   request: { body: { content: { "application/json": { schema: searchPassBodySchema } } } },
-  responses: { 200: { description: "邮件已发送", content: { "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) } } }, 403: { description: "人机验证失败", content: { "application/json": { schema: errorResponseSchema } } }, 404: { description: "邮箱不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "邮件已发送",
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) },
+      },
+    },
+    403: {
+      description: "人机验证失败",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "邮箱不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(searchPassRoute, async (c) => {
   const { email, turnstileToken } = c.req.valid("json");
-  if (!(await verifyTurnstile(turnstileToken, requestIp(c)))) return c.json({ success: false as const, error_msg: "人机验证失败" }, 403);
+  if (!(await verifyTurnstile(turnstileToken, requestIp(c))))
+    return c.json({ success: false as const, error_msg: "人机验证失败" }, 403);
   const user = await userQueries.getByEmail(email);
   if (!user) return c.json({ success: false as const, error_msg: "邮箱不存在" }, 404);
   const key = uuidv4();
@@ -186,14 +349,29 @@ auth.openapi(searchPassRoute, async (c) => {
 
 // --- POST /auth/local/reset_pass ---
 const resetPassRoute = createRoute({
-  method: "post", path: "/auth/local/reset_pass", tags: ["auth"], summary: "重置密码",
+  method: "post",
+  path: "/auth/local/reset_pass",
+  tags: ["auth"],
+  summary: "重置密码",
   request: { body: { content: { "application/json": { schema: resetPassBodySchema } } } },
-  responses: { 200: { description: "重置成功", content: { "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) } } }, 400: { description: "链接无效或过期", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "重置成功",
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), message: z.string() }) },
+      },
+    },
+    400: {
+      description: "链接无效或过期",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(resetPassRoute, async (c) => {
   const { key, psw } = c.req.valid("json");
   const user = await userQueries.getByRetrieveKey(key);
-  if (!user || !user.retrieveTime || Date.now() - Number(user.retrieveTime) > RETRIEVE_KEY_TTL) return c.json({ success: false as const, error_msg: "重置链接无效或已过期" }, 400);
+  if (!user || !user.retrieveTime || Date.now() - Number(user.retrieveTime) > RETRIEVE_KEY_TTL)
+    return c.json({ success: false as const, error_msg: "重置链接无效或已过期" }, 400);
   await userQueries.updatePass(user.id, await bcryptjs.hash(psw, 10));
   await userQueries.updateRetrieveKey(user.id, null, null);
   return c.json({ success: true as const, message: "密码已重置" }, 200);
@@ -209,83 +387,278 @@ auth.get("/auth/github/callback", async (c) => {
   if (!code) return c.json({ success: false, error_msg: "missing code" }, 400);
   const oauthState = getGithubOAuthState(c);
   clearGithubOAuthState(c);
-  if (!state || !oauthState || state !== oauthState.state) return c.redirect(`${webBaseUrl()}/signin?error=github_state_invalid`);
+  if (!state || !oauthState || state !== oauthState.state)
+    return c.redirect(`${webBaseUrl()}/signin?error=github_state_invalid`);
   const clientId = process.env.AUTH_GITHUB_CLIENT_ID;
   const clientSecret = process.env.AUTH_GITHUB_CLIENT_SECRET;
-  if (!clientId || !clientSecret) return c.json({ success: false, error_msg: "GitHub OAuth 未配置" }, 500);
+  if (!clientId || !clientSecret)
+    return c.json({ success: false, error_msg: "GitHub OAuth 未配置" }, 500);
   try {
-    const tokenRes = await fetch("https://github.com/login/oauth/access_token", { method: "POST", headers: { "Content-Type": "application/json", Accept: "application/json" }, body: JSON.stringify({ client_id: clientId, client_secret: clientSecret, code }) });
+    const tokenRes = await fetch("https://github.com/login/oauth/access_token", {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Accept: "application/json" },
+      body: JSON.stringify({ client_id: clientId, client_secret: clientSecret, code }),
+    });
     const tokenData: any = await tokenRes.json();
     if (tokenData.error) return c.json({ success: false, error_msg: tokenData.error }, 400);
     const ghAccessToken = tokenData.access_token;
     if (!ghAccessToken) return c.json({ success: false, error_msg: "no access_token" }, 400);
-    const profileRes = await fetch("https://api.github.com/user", { headers: { Authorization: `token ${ghAccessToken}`, "User-Agent": "cnode-next" } });
+    const profileRes = await fetch("https://api.github.com/user", {
+      headers: { Authorization: `token ${ghAccessToken}`, "User-Agent": "cnode-next" },
+    });
     const profile: any = await profileRes.json();
     if (!profile.id) return c.json({ success: false, error_msg: "failed to get profile" }, 400);
     let email = profile.email;
-    if (!email) { const emailsRes = await fetch("https://api.github.com/user/emails", { headers: { Authorization: `token ${ghAccessToken}`, "User-Agent": "cnode-next" } }); const emails: any = await emailsRes.json(); email = Array.isArray(emails) ? emails.find((e: any) => e.primary)?.email : null; }
+    if (!email) {
+      const emailsRes = await fetch("https://api.github.com/user/emails", {
+        headers: { Authorization: `token ${ghAccessToken}`, "User-Agent": "cnode-next" },
+      });
+      const emails: any = await emailsRes.json();
+      email = Array.isArray(emails) ? emails.find((e: any) => e.primary)?.email : null;
+    }
     if (!email) return c.redirect(`${webBaseUrl()}/auth/github/no-email`);
     const user = await userQueries.getByGithubId(String(profile.id));
     if (oauthState.intent === "bind") {
       const currentUser = c.get("user");
-      if (!currentUser) { await revokeGithubToken(ghAccessToken); return c.redirect(`${webBaseUrl()}/signin?error=github_bind_login_required`); }
-      const decision = decideGithubBind(currentUser.githubId, String(profile.id), user?.id ?? null, currentUser.id);
-      if (decision === "reject-different" || decision === "reject-occupied") return rejectGithubBind(c, currentUser, String(profile.id), profile.login, ghAccessToken, decision === "reject-different" ? "github_different_account" : "github_already_bound");
-      try { await userQueries.updateGithubInfo(currentUser.id, { githubId: String(profile.id), githubUsername: profile.login, githubAccessToken: ghAccessToken, avatar: profile.avatar_url }); } catch (error) { if (isGithubIdUniqueViolation(error)) return rejectGithubBind(c, currentUser, String(profile.id), profile.login, ghAccessToken, "github_already_bound"); throw error; }
-      await logGithubAccountAction(currentUser, "github_bind", "success", { githubId: String(profile.id), githubUsername: profile.login, mode: decision });
+      if (!currentUser) {
+        await revokeGithubToken(ghAccessToken);
+        return c.redirect(`${webBaseUrl()}/signin?error=github_bind_login_required`);
+      }
+      const decision = decideGithubBind(
+        currentUser.githubId,
+        String(profile.id),
+        user?.id ?? null,
+        currentUser.id,
+      );
+      if (decision === "reject-different" || decision === "reject-occupied")
+        return rejectGithubBind(
+          c,
+          currentUser,
+          String(profile.id),
+          profile.login,
+          ghAccessToken,
+          decision === "reject-different" ? "github_different_account" : "github_already_bound",
+        );
+      try {
+        await userQueries.updateGithubInfo(currentUser.id, {
+          githubId: String(profile.id),
+          githubUsername: profile.login,
+          githubAccessToken: ghAccessToken,
+          avatar: profile.avatar_url,
+        });
+      } catch (error) {
+        if (isGithubIdUniqueViolation(error))
+          return rejectGithubBind(
+            c,
+            currentUser,
+            String(profile.id),
+            profile.login,
+            ghAccessToken,
+            "github_already_bound",
+          );
+        throw error;
+      }
+      await logGithubAccountAction(currentUser, "github_bind", "success", {
+        githubId: String(profile.id),
+        githubUsername: profile.login,
+        mode: decision,
+      });
       return c.redirect(`${webBaseUrl()}/setting?github=bound`);
     }
-    if (user) { await userQueries.updateGithubInfo(user.id, { githubId: String(profile.id), githubUsername: profile.login, githubAccessToken: ghAccessToken, avatar: profile.avatar_url }); }
-    else { setPendingGithubProfile(c, { id: String(profile.id), login: profile.login, email, avatarUrl: profile.avatar_url, accessToken: ghAccessToken }); return c.redirect(`${webBaseUrl()}/auth/github/new`); }
+    if (user) {
+      await userQueries.updateGithubInfo(user.id, {
+        githubId: String(profile.id),
+        githubUsername: profile.login,
+        githubAccessToken: ghAccessToken,
+        avatar: profile.avatar_url,
+      });
+    } else {
+      setPendingGithubProfile(c, {
+        id: String(profile.id),
+        login: profile.login,
+        email,
+        avatarUrl: profile.avatar_url,
+        accessToken: ghAccessToken,
+      });
+      return c.redirect(`${webBaseUrl()}/auth/github/new`);
+    }
     setSessionCookie(c, user.id);
     return c.redirect(`${webBaseUrl()}${c.req.query("redirect") || "/"}`);
-  } catch { return c.json({ success: false, error_msg: "GitHub 登录暂时不可用" }, 500); }
+  } catch {
+    return c.json({ success: false, error_msg: "GitHub 登录暂时不可用" }, 500);
+  }
 });
 
 // --- GET /auth/github/pending ---
 const githubPendingRoute = createRoute({
-  method: "get", path: "/auth/github/pending", tags: ["auth"], summary: "获取 GitHub pending profile",
-  responses: { 200: { description: "pending profile", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.object({ loginname: z.string(), email: z.string(), avatar_url: z.string().optional(), email_exists: z.boolean() }) }) } } }, 401: { description: "状态过期", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "get",
+  path: "/auth/github/pending",
+  tags: ["auth"],
+  summary: "获取 GitHub pending profile",
+  responses: {
+    200: {
+      description: "pending profile",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.object({
+              loginname: z.string(),
+              email: z.string(),
+              avatar_url: z.string().optional(),
+              email_exists: z.boolean(),
+            }),
+          }),
+        },
+      },
+    },
+    401: {
+      description: "状态过期",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(githubPendingRoute, async (c) => {
   const profile = getPendingGithubProfile(c);
   if (!profile) return c.json({ success: false as const, error_msg: "GitHub 登录状态已过期" }, 401);
   const existingByEmail = await userQueries.getByEmail(profile.email);
-  return c.json({ success: true as const, data: { loginname: profile.login, email: profile.email, avatar_url: profile.avatarUrl, email_exists: !!existingByEmail } }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: {
+        loginname: profile.login,
+        email: profile.email,
+        avatar_url: profile.avatarUrl,
+        email_exists: !!existingByEmail,
+      },
+    },
+    200,
+  );
 });
 
 // --- POST /auth/github/create ---
 const githubCreateRoute = createRoute({
-  method: "post", path: "/auth/github/create", tags: ["auth"], summary: "GitHub 注册或关联",
+  method: "post",
+  path: "/auth/github/create",
+  tags: ["auth"],
+  summary: "GitHub 注册或关联",
   middleware: [perIpPerDay("create_user_per_ip", CREATE_USER_PER_IP, true)],
   request: { body: { content: { "application/json": { schema: githubCreateBodySchema } } } },
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "状态过期", content: { "application/json": { schema: errorResponseSchema } } }, 403: { description: "账号名或密码错误", content: { "application/json": { schema: errorResponseSchema } } }, 409: { description: "绑定冲突", content: { "application/json": { schema: errorResponseSchema } } }, 422: { description: "用户名或邮箱已存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "状态过期",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "账号名或密码错误",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    409: {
+      description: "绑定冲突",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "用户名或邮箱已存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(githubCreateRoute, async (c) => {
   const profile = getPendingGithubProfile(c);
-  if (!profile) return c.json({ success: false as const, error_msg: "GitHub 登录状态已过期，请重新授权" }, 401);
+  if (!profile)
+    return c.json({ success: false as const, error_msg: "GitHub 登录状态已过期，请重新授权" }, 401);
   const body = c.req.valid("json");
   let user: Awaited<ReturnType<typeof userQueries.getById>> | null = null;
   if (body.isnew) {
     const loginname = profile.login.toLowerCase();
-    if (await userQueries.getByLoginName(loginname)) return c.json({ success: false as const, error_msg: "GitHub 用户名已被使用，请关联老账号" }, 422);
-    if (await userQueries.getByEmail(profile.email)) return c.json({ success: false as const, error_msg: "该邮箱已注册，请关联老账号" }, 422);
-    try { user = await userQueries.newAndSave({ loginname, pass: await bcryptjs.hash(uuidv4(), 10), email: profile.email, avatar: profile.avatarUrl, active: true, githubId: profile.id, githubUsername: profile.login, githubAccessToken: profile.accessToken }); }
-    catch (error) { if (isGithubIdUniqueViolation(error)) { await revokeGithubToken(profile.accessToken); clearPendingGithubProfile(c); return c.json({ success: false as const, error_msg: "该 GitHub 账号已绑定到其他用户" }, 409); } throw error; }
+    if (await userQueries.getByLoginName(loginname))
+      return c.json(
+        { success: false as const, error_msg: "GitHub 用户名已被使用，请关联老账号" },
+        422,
+      );
+    if (await userQueries.getByEmail(profile.email))
+      return c.json({ success: false as const, error_msg: "该邮箱已注册，请关联老账号" }, 422);
+    try {
+      user = await userQueries.newAndSave({
+        loginname,
+        pass: await bcryptjs.hash(uuidv4(), 10),
+        email: profile.email,
+        avatar: profile.avatarUrl,
+        active: true,
+        githubId: profile.id,
+        githubUsername: profile.login,
+        githubAccessToken: profile.accessToken,
+      });
+    } catch (error) {
+      if (isGithubIdUniqueViolation(error)) {
+        await revokeGithubToken(profile.accessToken);
+        clearPendingGithubProfile(c);
+        return c.json(
+          { success: false as const, error_msg: "该 GitHub 账号已绑定到其他用户" },
+          409,
+        );
+      }
+      throw error;
+    }
   } else {
     const loginname = (body.name || "").trim().toLowerCase();
     const pass = body.pass || "";
-    if (!loginname || !pass) return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
+    if (!loginname || !pass)
+      return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
     user = await userQueries.getByLoginName(loginname);
-    if (!user || !user.pass) return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
-    if (!(await bcryptjs.compare(pass, user.pass))) return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
+    if (!user || !user.pass)
+      return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
+    if (!(await bcryptjs.compare(pass, user.pass)))
+      return c.json({ success: false as const, error_msg: "账号名或密码错误" }, 403);
     const occupyingUser = await userQueries.getByGithubId(profile.id);
-    const decision = decideGithubBind(user.githubId, profile.id, occupyingUser?.id ?? null, user.id);
-    if (decision === "reject-different" || decision === "reject-occupied") { await revokeGithubToken(profile.accessToken); clearPendingGithubProfile(c); return c.json({ success: false as const, error_msg: decision === "reject-different" ? "当前账号已绑定其他 GitHub 账号，请先解绑" : "该 GitHub 账号已绑定到其他用户" }, 409); }
-    try { await userQueries.updateGithubInfo(user.id, { githubId: profile.id, githubUsername: profile.login, githubAccessToken: profile.accessToken, avatar: profile.avatarUrl }); }
-    catch (error) { if (isGithubIdUniqueViolation(error)) { await revokeGithubToken(profile.accessToken); clearPendingGithubProfile(c); return c.json({ success: false as const, error_msg: "该 GitHub 账号已绑定到其他用户" }, 409); } throw error; }
+    const decision = decideGithubBind(
+      user.githubId,
+      profile.id,
+      occupyingUser?.id ?? null,
+      user.id,
+    );
+    if (decision === "reject-different" || decision === "reject-occupied") {
+      await revokeGithubToken(profile.accessToken);
+      clearPendingGithubProfile(c);
+      return c.json(
+        {
+          success: false as const,
+          error_msg:
+            decision === "reject-different"
+              ? "当前账号已绑定其他 GitHub 账号，请先解绑"
+              : "该 GitHub 账号已绑定到其他用户",
+        },
+        409,
+      );
+    }
+    try {
+      await userQueries.updateGithubInfo(user.id, {
+        githubId: profile.id,
+        githubUsername: profile.login,
+        githubAccessToken: profile.accessToken,
+        avatar: profile.avatarUrl,
+      });
+    } catch (error) {
+      if (isGithubIdUniqueViolation(error)) {
+        await revokeGithubToken(profile.accessToken);
+        clearPendingGithubProfile(c);
+        return c.json(
+          { success: false as const, error_msg: "该 GitHub 账号已绑定到其他用户" },
+          409,
+        );
+      }
+      throw error;
+    }
   }
-  await logGithubAccountAction(user, "github_bind", "success", { githubId: profile.id, githubUsername: profile.login, mode: body.isnew ? "new-user" : "existing-user" });
+  await logGithubAccountAction(user, "github_bind", "success", {
+    githubId: profile.id,
+    githubUsername: profile.login,
+    mode: body.isnew ? "new-user" : "existing-user",
+  });
   clearPendingGithubProfile(c);
   setSessionCookie(c, user.id);
   return c.json({ success: true as const }, 200);
@@ -293,40 +666,131 @@ auth.openapi(githubCreateRoute, async (c) => {
 
 // --- POST /auth/github/unbind ---
 const githubUnbindRoute = createRoute({
-  method: "post", path: "/auth/github/unbind", tags: ["auth"], summary: "解绑 GitHub",
+  method: "post",
+  path: "/auth/github/unbind",
+  tags: ["auth"],
+  summary: "解绑 GitHub",
   middleware: [perUserPerDay("github_unbind", 10, true)],
   request: { body: { content: { "application/json": { schema: githubUnbindSchema } } } },
-  responses: { 200: { description: "解绑成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 403: { description: "密码错误", content: { "application/json": { schema: errorResponseSchema } } }, 409: { description: "未绑定或状态变化", content: { "application/json": { schema: errorResponseSchema } } }, 503: { description: "操作失败", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "解绑成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "密码错误",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    409: {
+      description: "未绑定或状态变化",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    503: {
+      description: "操作失败",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(githubUnbindRoute, async (c) => {
   const sessionUser = c.get("user");
   if (!sessionUser) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const user = await userQueries.getById(sessionUser.id);
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
-  if (!user.githubId) return c.json({ success: false as const, error_msg: "当前账号未绑定 GitHub" }, 409);
+  if (!user.githubId)
+    return c.json({ success: false as const, error_msg: "当前账号未绑定 GitHub" }, 409);
   const { password } = c.req.valid("json");
   let result: Awaited<ReturnType<typeof executeGithubUnbind>>;
-  try { result = await executeGithubUnbind(user, password, { clearGithubInfo: userQueries.clearGithubInfo, revokeToken: revokeGithubToken, verifyPassword: bcryptjs.compare }); }
-  catch { await logGithubAccountAction(user, "github_unbind", "failed", { githubId: user.githubId, reason: "local-operation-failed" }); return c.json({ success: false as const, error_msg: "解除绑定暂时失败，请稍后重试" }, 503); }
-  if (!result.success && result.reason === "invalid-password") { await logGithubAccountAction(user, "github_unbind", "rejected", { githubId: user.githubId, reason: "invalid-password" }); return c.json({ success: false as const, error_msg: "当前密码错误；如果你从未设置过密码，请先重置密码" }, 403); }
-  if (!result.success && result.reason === "revoke-failed") { await logGithubAccountAction(user, "github_unbind", "failed", { githubId: user.githubId, reason: "token-revoke-failed" }); return c.json({ success: false as const, error_msg: "GitHub 授权暂时无法撤销，请稍后重试" }, 503); }
-  if (!result.success && result.reason === "binding-changed") { await logGithubAccountAction(user, "github_unbind", "failed", { githubId: user.githubId, reason: "binding-changed" }); return c.json({ success: false as const, error_msg: "GitHub 绑定状态已变化，请刷新后重试" }, 409); }
-  if (!result.success) return c.json({ success: false as const, error_msg: "当前账号未绑定 GitHub" }, 409);
-  await logGithubAccountAction(user, "github_unbind", "success", { githubId: user.githubId, githubUsername: user.githubUsername, tokenRevoke: result.tokenRevoke });
+  try {
+    result = await executeGithubUnbind(user, password, {
+      clearGithubInfo: userQueries.clearGithubInfo,
+      revokeToken: revokeGithubToken,
+      verifyPassword: bcryptjs.compare,
+    });
+  } catch {
+    await logGithubAccountAction(user, "github_unbind", "failed", {
+      githubId: user.githubId,
+      reason: "local-operation-failed",
+    });
+    return c.json({ success: false as const, error_msg: "解除绑定暂时失败，请稍后重试" }, 503);
+  }
+  if (!result.success && result.reason === "invalid-password") {
+    await logGithubAccountAction(user, "github_unbind", "rejected", {
+      githubId: user.githubId,
+      reason: "invalid-password",
+    });
+    return c.json(
+      { success: false as const, error_msg: "当前密码错误；如果你从未设置过密码，请先重置密码" },
+      403,
+    );
+  }
+  if (!result.success && result.reason === "revoke-failed") {
+    await logGithubAccountAction(user, "github_unbind", "failed", {
+      githubId: user.githubId,
+      reason: "token-revoke-failed",
+    });
+    return c.json(
+      { success: false as const, error_msg: "GitHub 授权暂时无法撤销，请稍后重试" },
+      503,
+    );
+  }
+  if (!result.success && result.reason === "binding-changed") {
+    await logGithubAccountAction(user, "github_unbind", "failed", {
+      githubId: user.githubId,
+      reason: "binding-changed",
+    });
+    return c.json(
+      { success: false as const, error_msg: "GitHub 绑定状态已变化，请刷新后重试" },
+      409,
+    );
+  }
+  if (!result.success)
+    return c.json({ success: false as const, error_msg: "当前账号未绑定 GitHub" }, 409);
+  await logGithubAccountAction(user, "github_unbind", "success", {
+    githubId: user.githubId,
+    githubUsername: user.githubUsername,
+    tokenRevoke: result.tokenRevoke,
+  });
   return c.json({ success: true as const }, 200);
 });
 
 // --- POST /auth/signout ---
 const signoutRoute = createRoute({
-  method: "post", path: "/auth/signout", tags: ["auth"], summary: "退出登录",
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } } },
+  method: "post",
+  path: "/auth/signout",
+  tags: ["auth"],
+  summary: "退出登录",
+  responses: {
+    200: {
+      description: "成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+  },
+});
+auth.openapi(signoutRoute, (c) => {
+  clearSessionCookie(c);
+  return c.json({ success: true as const }, 200);
 });
-auth.openapi(signoutRoute, (c) => { clearSessionCookie(c); return c.json({ success: true as const }, 200); });
 
 // --- GET /auth/me ---
 const meRoute = createRoute({
-  method: "get", path: "/auth/me", tags: ["auth"], summary: "获取当前登录用户",
-  responses: { 200: { description: "当前用户", content: { "application/json": { schema: z.object({ success: z.boolean(), data: z.any().nullable() }) } } } },
+  method: "get",
+  path: "/auth/me",
+  tags: ["auth"],
+  summary: "获取当前登录用户",
+  responses: {
+    200: {
+      description: "当前用户",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.boolean(), data: z.any().nullable() }),
+        },
+      },
+    },
+  },
 });
 auth.openapi(meRoute, async (c) => {
   const user = c.get("user");
@@ -334,54 +798,189 @@ auth.openapi(meRoute, async (c) => {
   const roles = c.get("roles");
   const isAdmin = c.get("isAdmin");
   const isMod = c.get("isMod");
-  return c.json({ success: true, data: { loginname: user.loginname, email: user.email, github_username: user.githubUsername, github_bound: !!user.githubId, url: user.url, location: user.location, signature: user.signature, weibo: user.weibo, receive_reply_mail: !!user.receiveReplyMail, receive_at_mail: !!user.receiveAtMail, is_admin: isAdmin, is_mod: isMod, roles, is_muted: !!user.isMuted || !!user.isBlock, is_block: !!user.isBlock } }, 200);
+  return c.json(
+    {
+      success: true,
+      data: {
+        loginname: user.loginname,
+        email: user.email,
+        github_username: user.githubUsername,
+        github_bound: !!user.githubId,
+        url: user.url,
+        location: user.location,
+        signature: user.signature,
+        weibo: user.weibo,
+        receive_reply_mail: !!user.receiveReplyMail,
+        receive_at_mail: !!user.receiveAtMail,
+        is_admin: isAdmin,
+        is_mod: isMod,
+        roles,
+        is_muted: !!user.isMuted || !!user.isBlock,
+        is_block: !!user.isBlock,
+      },
+    },
+    200,
+  );
 });
 
 // --- POST /auth/local/setting ---
 const settingRoute = createRoute({
-  method: "post", path: "/auth/local/setting", tags: ["auth"], summary: "更新个人资料",
-  request: { body: { content: { "application/json": { schema: z.object({ url: z.string().optional(), location: z.string().optional(), signature: z.string().optional(), weibo: z.string().optional(), receive_reply_mail: z.boolean().optional(), receive_at_mail: z.boolean().optional() }).passthrough() } } } },
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "post",
+  path: "/auth/local/setting",
+  tags: ["auth"],
+  summary: "更新个人资料",
+  request: {
+    body: {
+      content: {
+        "application/json": {
+          schema: z
+            .object({
+              url: z.string().optional(),
+              location: z.string().optional(),
+              signature: z.string().optional(),
+              weibo: z.string().optional(),
+              receive_reply_mail: z.boolean().optional(),
+              receive_at_mail: z.boolean().optional(),
+            })
+            .passthrough(),
+        },
+      },
+    },
+  },
+  responses: {
+    200: {
+      description: "成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(settingRoute, async (c) => {
   const user = c.get("user");
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
-  const { url, location, signature, weibo, receive_reply_mail, receive_at_mail } = c.req.valid("json");
-  await userQueries.updateProfile(user.id, { url, location, signature, weibo, receive_reply_mail, receive_at_mail });
+  const { url, location, signature, weibo, receive_reply_mail, receive_at_mail } =
+    c.req.valid("json");
+  await userQueries.updateProfile(user.id, {
+    url,
+    location,
+    signature,
+    weibo,
+    receive_reply_mail,
+    receive_at_mail,
+  });
   return c.json({ success: true as const }, 200);
 });
 
 // --- POST /auth/local/change_pass ---
 const changePassRoute = createRoute({
-  method: "post", path: "/auth/local/change_pass", tags: ["auth"], summary: "修改密码",
-  request: { body: { content: { "application/json": { schema: z.object({ oldPass: z.string(), newPass: z.string() }) } } } },
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 403: { description: "原密码错误", content: { "application/json": { schema: errorResponseSchema } } }, 422: { description: "新密码不合规", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "post",
+  path: "/auth/local/change_pass",
+  tags: ["auth"],
+  summary: "修改密码",
+  request: {
+    body: {
+      content: {
+        "application/json": { schema: z.object({ oldPass: z.string(), newPass: z.string() }) },
+      },
+    },
+  },
+  responses: {
+    200: {
+      description: "成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "原密码错误",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "新密码不合规",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(changePassRoute, async (c) => {
   const user = c.get("user");
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const { oldPass, newPass } = c.req.valid("json");
-  if (!(await bcryptjs.compare(oldPass, user.pass))) return c.json({ success: false as const, error_msg: "原密码错误" }, 403);
-  if (newPass.length < 8 || !/[a-zA-Z]/.test(newPass) || !/[0-9]/.test(newPass)) return c.json({ success: false as const, error_msg: "新密码至少 8 位,必须包含字母和数字" }, 422);
+  if (!(await bcryptjs.compare(oldPass, user.pass)))
+    return c.json({ success: false as const, error_msg: "原密码错误" }, 403);
+  if (newPass.length < 8 || !/[a-zA-Z]/.test(newPass) || !/[0-9]/.test(newPass))
+    return c.json(
+      { success: false as const, error_msg: "新密码至少 8 位,必须包含字母和数字" },
+      422,
+    );
   await userQueries.updatePass(user.id, await bcryptjs.hash(newPass, 10));
   return c.json({ success: true as const }, 200);
 });
 
 // --- POST /upload/presign ---
 const presignRoute = createRoute({
-  method: "post", path: "/upload/presign", tags: ["auth"], summary: "获取图片上传预签名 URL",
+  method: "post",
+  path: "/upload/presign",
+  tags: ["auth"],
+  summary: "获取图片上传预签名 URL",
   request: { body: { content: { "application/json": { schema: presignUploadSchema } } } },
-  responses: { 200: { description: "预签名 URL", content: { "application/json": { schema: z.object({ success: z.literal(true), url: z.string(), upload_url: z.string(), method: z.string(), headers: z.record(z.string(), z.string()), filename: z.string() }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 422: { description: "不支持的图片类型", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "预签名 URL",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            url: z.string(),
+            upload_url: z.string(),
+            method: z.string(),
+            headers: z.record(z.string(), z.string()),
+            filename: z.string(),
+          }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "不支持的图片类型",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 auth.openapi(presignRoute, async (c) => {
   const user = c.get("user");
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const parsed = presignUploadSchema.safeParse(await c.req.json().catch(() => ({})));
-  if (!parsed.success) return c.json({ success: false as const, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" }, 422);
+  if (!parsed.success)
+    return c.json(
+      { success: false as const, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" },
+      422,
+    );
   const { contentType } = parsed.data;
   const filename = `${uploadPrefix()}/${uuidv4()}${extensionForContentType(contentType)}`;
-  const uploadUrl = createOssClient().signatureUrl(filename, { method: "PUT", expires: Number(process.env.OSS_UPLOAD_EXPIRES || 600), headers: { "Content-Type": contentType } });
-  return c.json({ success: true as const, url: staticUploadUrl(filename), upload_url: uploadUrl, method: "PUT", headers: { "Content-Type": contentType }, filename }, 200);
+  const uploadUrl = createOssClient().signatureUrl(filename, {
+    method: "PUT",
+    expires: Number(process.env.OSS_UPLOAD_EXPIRES || 600),
+    headers: { "Content-Type": contentType },
+  });
+  return c.json(
+    {
+      success: true as const,
+      url: staticUploadUrl(filename),
+      upload_url: uploadUrl,
+      method: "PUT",
+      headers: { "Content-Type": contentType },
+      filename,
+    },
+    200,
+  );
 });
 
 // --- POST /upload/image (formData, no OAS) ---
@@ -390,16 +989,22 @@ auth.post("/upload/image", async (c) => {
   if (!user) return c.json({ success: false, error_msg: "未登录" }, 401);
   const formData = await c.req.formData().catch(() => null);
   const file = formData?.get("file");
-  if (!(file instanceof File)) return c.json({ success: false, error_msg: "请选择要上传的图片" }, 400);
-  if (!allowedImageTypes.has(file.type)) return c.json({ success: false, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" }, 422);
+  if (!(file instanceof File))
+    return c.json({ success: false, error_msg: "请选择要上传的图片" }, 400);
+  if (!allowedImageTypes.has(file.type))
+    return c.json({ success: false, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" }, 422);
   const originalName = safeOriginalName(file.name);
   const originalExtension = extensionForFilename(originalName);
-  if (originalExtension && !allowedImageExtensions.has(originalExtension)) return c.json({ success: false, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" }, 422);
+  if (originalExtension && !allowedImageExtensions.has(originalExtension))
+    return c.json({ success: false, error_msg: "只支持 png/jpeg/gif/webp/svg 图片上传" }, 422);
   const maxSize = Number(process.env.OSS_UPLOAD_MAX_BYTES || 5 * 1024 * 1024);
   if (file.size > maxSize) return c.json({ success: false, error_msg: "图片不能超过 5MB" }, 413);
-  const purpose = typeof formData?.get("purpose") === "string" ? String(formData.get("purpose")) : null;
+  const purpose =
+    typeof formData?.get("purpose") === "string" ? String(formData.get("purpose")) : null;
   const filename = `${uploadPrefix(purpose)}/${uuidv4()}${extensionForContentType(file.type)}`;
-  await createOssClient().put(filename, Buffer.from(await file.arrayBuffer()), { headers: { "Content-Type": file.type } });
+  await createOssClient().put(filename, Buffer.from(await file.arrayBuffer()), {
+    headers: { "Content-Type": file.type },
+  });
   return c.json({ success: true, url: staticUploadUrl(filename), filename: originalName });
 });
 
diff --git a/apps/api/src/routes/collect.ts b/apps/api/src/routes/collect.ts
index 1f57a1c..a408ab3 100644
--- a/apps/api/src/routes/collect.ts
+++ b/apps/api/src/routes/collect.ts
@@ -7,60 +7,115 @@ import { eq, and } from "drizzle-orm";
 import { incrementCollectTopicCount, decrementCollectTopicCount } from "../lib/score";
 import { linkUsers } from "../lib/at";
 import type { AuthVars } from "../middleware/auth";
-import { collectBodySchema, collectLoginNameParamSchema, topicDTOSchema, errorResponseSchema } from "@cnode/shared";
+import {
+  collectBodySchema,
+  collectLoginNameParamSchema,
+  topicDTOSchema,
+  errorResponseSchema,
+} from "@cnode/shared";
 
 const collect = new OpenAPIHono<{ Variables: AuthVars }>();
 
 const INTERNAL_TABS = new Set(["dev", "test"]);
 
 async function isPublicTopic(topicData: any) {
-  if (!topicData || topicData.deleted || topicData.status === "deleted" || INTERNAL_TABS.has(topicData.tab || "")) return false;
+  if (
+    !topicData ||
+    topicData.deleted ||
+    topicData.status === "deleted" ||
+    INTERNAL_TABS.has(topicData.tab || "")
+  )
+    return false;
   const author = await userQueries.getById(topicData.authorId);
   return !author?.isBlock;
 }
 
 // GET /topic_collect/:loginname
 const listCollectRoute = createRoute({
-  method: "get", path: "/topic_collect/{loginname}", tags: ["collections"], summary: "获取用户收藏列表",
+  method: "get",
+  path: "/topic_collect/{loginname}",
+  tags: ["collections"],
+  summary: "获取用户收藏列表",
   request: { params: collectLoginNameParamSchema },
-  responses: { 200: { description: "收藏列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(topicDTOSchema) }) } } }, 404: { description: "用户不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "收藏列表",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: z.array(topicDTOSchema) }),
+        },
+      },
+    },
+    404: {
+      description: "用户不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 collect.openapi(listCollectRoute, async (c) => {
   const { loginname } = c.req.valid("param");
   const userData = await userQueries.getByLoginName(loginname);
   if (!userData) return c.json({ success: false as const, error_msg: "用户不存在" }, 404);
   const db = getDb();
-  const collects = await db.select().from(topicCollects).where(eq(topicCollects.userId, userData.id)).limit(100);
+  const collects = await db
+    .select()
+    .from(topicCollects)
+    .where(eq(topicCollects.userId, userData.id))
+    .limit(100);
   const ids = collects.map((doc) => doc.topicId);
   if (ids.length === 0) return c.json({ success: true as const, data: [] }, 200);
   const topics = await Promise.all(ids.map((id) => topicQueries.getById(id)));
   const data = await Promise.all(
-    (await Promise.all(topics.map(async (t: any) => ((await isPublicTopic(t)) ? t : null)))).filter(Boolean).map(async (t: any) => {
-      const author = await userQueries.getById(t.authorId);
-      return {
-        id: String(t.id),
-        author_id: String(t.authorId),
-        tab: t.tab,
-        content: linkUsers(t.content),
-        title: t.title,
-        last_reply_at: t.lastReplyAt,
-        good: !!t.good,
-        top: !!t.top,
-        reply_count: t.replyCount,
-        visit_count: t.visitCount,
-        create_at: t.createAt,
-        author: author ? { loginname: author.loginname, avatar_url: author.avatar } : { loginname: "", avatar_url: "" },
-      };
-    }),
+    (await Promise.all(topics.map(async (t: any) => ((await isPublicTopic(t)) ? t : null))))
+      .filter(Boolean)
+      .map(async (t: any) => {
+        const author = await userQueries.getById(t.authorId);
+        return {
+          id: String(t.id),
+          author_id: String(t.authorId),
+          tab: t.tab,
+          content: linkUsers(t.content),
+          title: t.title,
+          last_reply_at: t.lastReplyAt,
+          good: !!t.good,
+          top: !!t.top,
+          reply_count: t.replyCount,
+          visit_count: t.visitCount,
+          create_at: t.createAt,
+          author: author
+            ? { loginname: author.loginname, avatar_url: author.avatar }
+            : { loginname: "", avatar_url: "" },
+        };
+      }),
   );
   return c.json({ success: true as const, data }, 200);
 });
 
 // POST /topic_collect/collect
 const collectRoute = createRoute({
-  method: "post", path: "/topic_collect/collect", tags: ["collections"], summary: "收藏话题",
+  method: "post",
+  path: "/topic_collect/collect",
+  tags: ["collections"],
+  summary: "收藏话题",
   request: { body: { content: { "application/json": { schema: collectBodySchema } } } },
-  responses: { 200: { description: "收藏成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 404: { description: "话题不存在", content: { "application/json": { schema: errorResponseSchema } } }, 409: { description: "已收藏", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "收藏成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "话题不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    409: {
+      description: "已收藏",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 collect.openapi(collectRoute, async (c) => {
   const { topic_id, accesstoken } = c.req.valid("json");
@@ -69,10 +124,16 @@ collect.openapi(collectRoute, async (c) => {
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const tid = Number(topic_id);
   const topicData = await topicQueries.getById(tid);
-  if (!(await isPublicTopic(topicData))) return c.json({ success: false as const, error_msg: "话题不存在" }, 404);
+  if (!(await isPublicTopic(topicData)))
+    return c.json({ success: false as const, error_msg: "话题不存在" }, 404);
   const db = getDb();
-  const existing = await db.select().from(topicCollects).where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid))).limit(1);
-  if (existing.length > 0) return c.json({ success: false as const, error_msg: "已经收藏过该主题" }, 409);
+  const existing = await db
+    .select()
+    .from(topicCollects)
+    .where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid)))
+    .limit(1);
+  if (existing.length > 0)
+    return c.json({ success: false as const, error_msg: "已经收藏过该主题" }, 409);
   await db.insert(topicCollects).values({ userId: user.id, topicId: tid, createAt: new Date() });
   await incrementCollectTopicCount(user.id);
   await topicQueries.incrementCollectCount(tid);
@@ -81,9 +142,25 @@ collect.openapi(collectRoute, async (c) => {
 
 // POST /topic_collect/de_collect
 const deCollectRoute = createRoute({
-  method: "post", path: "/topic_collect/de_collect", tags: ["collections"], summary: "取消收藏",
+  method: "post",
+  path: "/topic_collect/de_collect",
+  tags: ["collections"],
+  summary: "取消收藏",
   request: { body: { content: { "application/json": { schema: collectBodySchema } } } },
-  responses: { 200: { description: "取消成功", content: { "application/json": { schema: z.object({ success: z.literal(true) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } }, 404: { description: "话题不存在或未收藏", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "取消成功",
+      content: { "application/json": { schema: z.object({ success: z.literal(true) }) } },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "话题不存在或未收藏",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 collect.openapi(deCollectRoute, async (c) => {
   const { topic_id, accesstoken } = c.req.valid("json");
@@ -92,11 +169,19 @@ collect.openapi(deCollectRoute, async (c) => {
   if (!user) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const tid = Number(topic_id);
   const topicData = await topicQueries.getById(tid);
-  if (!(await isPublicTopic(topicData))) return c.json({ success: false as const, error_msg: "话题不存在" }, 404);
+  if (!(await isPublicTopic(topicData)))
+    return c.json({ success: false as const, error_msg: "话题不存在" }, 404);
   const db = getDb();
-  const existing = await db.select().from(topicCollects).where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid))).limit(1);
-  if (existing.length === 0) return c.json({ success: false as const, error_msg: "尚未收藏该主题" }, 404);
-  await db.delete(topicCollects).where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid)));
+  const existing = await db
+    .select()
+    .from(topicCollects)
+    .where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid)))
+    .limit(1);
+  if (existing.length === 0)
+    return c.json({ success: false as const, error_msg: "尚未收藏该主题" }, 404);
+  await db
+    .delete(topicCollects)
+    .where(and(eq(topicCollects.userId, user.id), eq(topicCollects.topicId, tid)));
   await decrementCollectTopicCount(user.id);
   await topicQueries.decrementCollectCount(tid);
   return c.json({ success: true as const }, 200);
diff --git a/apps/api/src/routes/community.ts b/apps/api/src/routes/community.ts
index 4536aba..55e001a 100644
--- a/apps/api/src/routes/community.ts
+++ b/apps/api/src/routes/community.ts
@@ -11,38 +11,94 @@ const community = new OpenAPIHono();
 const INTERNAL_TABS = ["dev", "test"];
 
 function publicTopicSql(topicId: any = topics.id) {
-  return sql`${boolEq(topics.deleted, false)} and coalesce(${topics.status}, 'published') <> 'deleted' and (${topics.tab} is null or ${topics.tab} not in (${sql.join(INTERNAL_TABS.map((tab) => sql`${tab}`), sql`, `)})) and exists (select 1 from ${users} where ${users.id} = ${topics.authorId} and ${boolEq(users.isBlock, false)}) and ${topics.id} = ${topicId}`;
+  return sql`${boolEq(topics.deleted, false)} and coalesce(${topics.status}, 'published') <> 'deleted' and (${topics.tab} is null or ${topics.tab} not in (${sql.join(
+    INTERNAL_TABS.map((tab) => sql`${tab}`),
+    sql`, `,
+  )})) and exists (select 1 from ${users} where ${users.id} = ${topics.authorId} and ${boolEq(users.isBlock, false)}) and ${topics.id} = ${topicId}`;
 }
 
 const sidebarHomeRoute = createRoute({
-  method: "get", path: "/sidebar/home", tags: ["system config"], summary: "首页侧边栏数据",
-  responses: { 200: { description: "侧边栏数据", content: { "application/json": { schema: z.object({ success: z.literal(true), data: sidebarHomeResponseSchema }) } } } },
+  method: "get",
+  path: "/sidebar/home",
+  tags: ["system config"],
+  summary: "首页侧边栏数据",
+  responses: {
+    200: {
+      description: "侧边栏数据",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: sidebarHomeResponseSchema }),
+        },
+      },
+    },
+  },
 });
 community.openapi(sidebarHomeRoute, async (c) => {
   const db = getDb();
   const replyNotDeleted = boolEq(replies.deleted, false);
   const replyTopicVisible = sql`exists (select 1 from ${topics} where ${publicTopicSql(replies.topicId)})`;
   const [latestRepliesRaw, noReplyTopicsRaw, topUsersRaw] = await Promise.all([
-    db.select().from(replies).where(and(replyNotDeleted, replyTopicVisible)).orderBy(desc(replies.createAt)).limit(5),
-    db.select().from(topics).where(sql`${publicTopicSql()} and ${topics.replyCount} = 0`).orderBy(desc(topics.createAt)).limit(5),
+    db
+      .select()
+      .from(replies)
+      .where(and(replyNotDeleted, replyTopicVisible))
+      .orderBy(desc(replies.createAt))
+      .limit(5),
+    db
+      .select()
+      .from(topics)
+      .where(sql`${publicTopicSql()} and ${topics.replyCount} = 0`)
+      .orderBy(desc(topics.createAt))
+      .limit(5),
     db.select().from(users).orderBy(desc(users.score)).limit(5),
   ]);
   const latestReplies = await Promise.all(
     latestRepliesRaw.map(async (reply: any) => {
-      const [author, topic] = await Promise.all([userQueries.getById(reply.authorId), topicQueries.getById(reply.topicId)]);
-      return { id: String(reply.id), topic_id: String(reply.topicId), topic_title: topic?.title || "已删除的话题", author: userSummary(author), create_at: reply.createAt, excerpt: excerptMarkdown(reply.content, 64) };
+      const [author, topic] = await Promise.all([
+        userQueries.getById(reply.authorId),
+        topicQueries.getById(reply.topicId),
+      ]);
+      return {
+        id: String(reply.id),
+        topic_id: String(reply.topicId),
+        topic_title: topic?.title || "已删除的话题",
+        author: userSummary(author),
+        create_at: reply.createAt,
+        excerpt: excerptMarkdown(reply.content, 64),
+      };
     }),
   );
-  return c.json({
-    success: true as const,
-    data: {
-      latest_replies: latestReplies,
-      no_reply_topics: noReplyTopicsRaw.map((topic: any) => ({ id: String(topic.id), title: topic.title, tab: topic.tab, create_at: topic.createAt })),
-      top_users: topUsersRaw.map((user: any) => ({ id: String(user.id), loginname: user.loginname, avatar_url: userSummary(user).avatar_url, score: user.score || 0 })),
-      partners: [{ name: "Node.js", url: "https://nodejs.org", description: "JavaScript runtime" }, { name: "npm", url: "https://www.npmjs.com", description: "Package ecosystem" }, { name: "Cloudflare", url: "https://www.cloudflare.com", description: "Edge platform" }],
-      resources: [{ name: "Express", url: "https://expressjs.com" }, { name: "Koa", url: "https://koajs.com" }, { name: "Egg", url: "https://eggjs.org" }],
+  return c.json(
+    {
+      success: true as const,
+      data: {
+        latest_replies: latestReplies,
+        no_reply_topics: noReplyTopicsRaw.map((topic: any) => ({
+          id: String(topic.id),
+          title: topic.title,
+          tab: topic.tab,
+          create_at: topic.createAt,
+        })),
+        top_users: topUsersRaw.map((user: any) => ({
+          id: String(user.id),
+          loginname: user.loginname,
+          avatar_url: userSummary(user).avatar_url,
+          score: user.score || 0,
+        })),
+        partners: [
+          { name: "Node.js", url: "https://nodejs.org", description: "JavaScript runtime" },
+          { name: "npm", url: "https://www.npmjs.com", description: "Package ecosystem" },
+          { name: "Cloudflare", url: "https://www.cloudflare.com", description: "Edge platform" },
+        ],
+        resources: [
+          { name: "Express", url: "https://expressjs.com" },
+          { name: "Koa", url: "https://koajs.com" },
+          { name: "Egg", url: "https://eggjs.org" },
+        ],
+      },
     },
-  }, 200);
+    200,
+  );
 });
 
 export { community as communityRoutes };
diff --git a/apps/api/src/routes/message.ts b/apps/api/src/routes/message.ts
index 92367d2..811bedf 100644
--- a/apps/api/src/routes/message.ts
+++ b/apps/api/src/routes/message.ts
@@ -10,15 +10,44 @@ import {
 } from "../lib/message";
 import { renderMarkdown } from "../lib/markdown";
 import type { AuthVars } from "../middleware/auth";
-import { errorResponseSchema, markAllBodySchema, markOneBodySchema, mdrenderQuerySchema, messageDTOSchema, msgIdParamSchema } from "@cnode/shared";
+import {
+  errorResponseSchema,
+  markAllBodySchema,
+  markOneBodySchema,
+  mdrenderQuerySchema,
+  messageDTOSchema,
+  msgIdParamSchema,
+} from "@cnode/shared";
 
 const message = new OpenAPIHono<{ Variables: AuthVars }>();
 
 // GET /messages
 const listMessagesRoute = createRoute({
-  method: "get", path: "/messages", tags: ["messages"], summary: "获取消息列表",
+  method: "get",
+  path: "/messages",
+  tags: ["messages"],
+  summary: "获取消息列表",
   request: { query: mdrenderQuerySchema.extend({ accesstoken: z.string().optional() }) },
-  responses: { 200: { description: "消息列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.object({ has_read_messages: z.array(messageDTOSchema), hasnot_read_messages: z.array(messageDTOSchema) }) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "消息列表",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.object({
+              has_read_messages: z.array(messageDTOSchema),
+              hasnot_read_messages: z.array(messageDTOSchema),
+            }),
+          }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 message.openapi(listMessagesRoute, async (c) => {
   let currentUser = c.get("user");
@@ -28,7 +57,10 @@ message.openapi(listMessagesRoute, async (c) => {
     currentUser = (await userQueries.getByToken(accesstoken)) || undefined;
   }
   if (!currentUser) return c.json({ success: false as const, error_msg: "未登录" }, 401);
-  const [readMsgs, unreadMsgs] = await Promise.all([getReadMessagesByUserId(currentUser.id), getUnreadMessagesByUserId(currentUser.id)]);
+  const [readMsgs, unreadMsgs] = await Promise.all([
+    getReadMessagesByUserId(currentUser.id),
+    getUnreadMessagesByUserId(currentUser.id),
+  ]);
   const formatMessage = async (msg: any) => {
     const relations = await getMessageRelations(msg);
     return {
@@ -36,22 +68,66 @@ message.openapi(listMessagesRoute, async (c) => {
       type: relations.type,
       has_read: !!relations.hasRead,
       create_at: relations.createAt,
-      author: relations.author ? { loginname: relations.author.loginname, avatar_url: relations.author.avatar } : { loginname: "", avatar_url: "" },
-      topic: relations.topic ? { id: String(relations.topic.id), author: relations.topic.author ? { loginname: relations.topic.author.loginname, avatar_url: relations.topic.author.avatar } : { loginname: "", avatar_url: "" }, title: relations.topic.title, last_reply_at: relations.topic.lastReplyAt } : null,
-      reply: relations.reply ? { id: String(relations.reply.id), content: renderMarkdown(relations.reply.content, mdrender), ups: [], create_at: relations.reply.createAt } : {},
+      author: relations.author
+        ? { loginname: relations.author.loginname, avatar_url: relations.author.avatar }
+        : { loginname: "", avatar_url: "" },
+      topic: relations.topic
+        ? {
+            id: String(relations.topic.id),
+            author: relations.topic.author
+              ? {
+                  loginname: relations.topic.author.loginname,
+                  avatar_url: relations.topic.author.avatar,
+                }
+              : { loginname: "", avatar_url: "" },
+            title: relations.topic.title,
+            last_reply_at: relations.topic.lastReplyAt,
+          }
+        : null,
+      reply: relations.reply
+        ? {
+            id: String(relations.reply.id),
+            content: renderMarkdown(relations.reply.content, mdrender),
+            ups: [],
+            create_at: relations.reply.createAt,
+          }
+        : {},
     };
   };
-  const [hasReadRaw, hasUnreadRaw] = await Promise.all([Promise.all(readMsgs.map(formatMessage)), Promise.all(unreadMsgs.map(formatMessage))]);
+  const [hasReadRaw, hasUnreadRaw] = await Promise.all([
+    Promise.all(readMsgs.map(formatMessage)),
+    Promise.all(unreadMsgs.map(formatMessage)),
+  ]);
   const hasRead = hasReadRaw.filter((msg: any) => msg.author?.loginname && msg.topic);
   const hasUnread = hasUnreadRaw.filter((msg: any) => msg.author?.loginname && msg.topic);
-  return c.json({ success: true as const, data: { has_read_messages: hasRead, hasnot_read_messages: hasUnread } }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: { has_read_messages: hasRead, hasnot_read_messages: hasUnread },
+    },
+    200,
+  );
 });
 
 // GET /message/count
 const messageCountRoute = createRoute({
-  method: "get", path: "/message/count", tags: ["messages"], summary: "获取未读消息数",
+  method: "get",
+  path: "/message/count",
+  tags: ["messages"],
+  summary: "获取未读消息数",
   request: { query: z.object({ accesstoken: z.string().optional() }) },
-  responses: { 200: { description: "未读数", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.number() }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "未读数",
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), data: z.number() }) },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 message.openapi(messageCountRoute, async (c) => {
   let currentUser = c.get("user");
@@ -67,9 +143,28 @@ message.openapi(messageCountRoute, async (c) => {
 
 // POST /message/mark_all
 const markAllRoute = createRoute({
-  method: "post", path: "/message/mark_all", tags: ["messages"], summary: "标记全部已读",
+  method: "post",
+  path: "/message/mark_all",
+  tags: ["messages"],
+  summary: "标记全部已读",
   request: { body: { content: { "application/json": { schema: markAllBodySchema } } } },
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true), marked_msgs: z.array(z.object({ id: z.string() })) }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "成功",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            marked_msgs: z.array(z.object({ id: z.string() })),
+          }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 message.openapi(markAllRoute, async (c) => {
   const body = c.req.valid("json");
@@ -81,15 +176,40 @@ message.openapi(markAllRoute, async (c) => {
   }
   if (!currentUser) return c.json({ success: false as const, error_msg: "未登录" }, 401);
   const unread = await getUnreadMessagesByUserId(currentUser.id);
-  await updateMessagesToRead(currentUser.id, unread.map((m) => m.id));
-  return c.json({ success: true as const, marked_msgs: unread.map((m) => ({ id: String(m.id) })) }, 200);
+  await updateMessagesToRead(
+    currentUser.id,
+    unread.map((m) => m.id),
+  );
+  return c.json(
+    { success: true as const, marked_msgs: unread.map((m) => ({ id: String(m.id) })) },
+    200,
+  );
 });
 
 // POST /message/mark_one/:msg_id
 const markOneRoute = createRoute({
-  method: "post", path: "/message/mark_one/{msg_id}", tags: ["messages"], summary: "标记单条已读",
-  request: { params: msgIdParamSchema, body: { content: { "application/json": { schema: markOneBodySchema } } } },
-  responses: { 200: { description: "成功", content: { "application/json": { schema: z.object({ success: z.literal(true), marked_msg_id: z.string() }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "post",
+  path: "/message/mark_one/{msg_id}",
+  tags: ["messages"],
+  summary: "标记单条已读",
+  request: {
+    params: msgIdParamSchema,
+    body: { content: { "application/json": { schema: markOneBodySchema } } },
+  },
+  responses: {
+    200: {
+      description: "成功",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), marked_msg_id: z.string() }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 message.openapi(markOneRoute, async (c) => {
   const { msg_id } = c.req.valid("param");
diff --git a/apps/api/src/routes/reply.ts b/apps/api/src/routes/reply.ts
index 66cce01..4a59ab9 100644
--- a/apps/api/src/routes/reply.ts
+++ b/apps/api/src/routes/reply.ts
@@ -36,9 +36,7 @@ const createReplyRoute = createRoute({
   tags: ["replies"],
   summary: "创建回复",
   description: "创建线性回复，可传 reply_id 回复另一条回复。需要登录。",
-  middleware: [
-    perUserPerDaySetting("create_reply", "rate_reply", CREATE_REPLY_PER_DAY, true),
-  ],
+  middleware: [perUserPerDaySetting("create_reply", "rate_reply", CREATE_REPLY_PER_DAY, true)],
   request: {
     params: z.object({ topic_id: z.string() }),
     body: { content: { "application/json": { schema: createReplyBodySchema } } },
@@ -46,12 +44,28 @@ const createReplyRoute = createRoute({
   responses: {
     200: {
       description: "创建成功",
-      content: { "application/json": { schema: z.object({ success: z.literal(true), reply_id: z.string() }) } },
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), reply_id: z.string() }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "禁言或人机验证失败",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "话题不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "包含敏感词",
+      content: { "application/json": { schema: errorResponseSchema } },
     },
-    401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } },
-    403: { description: "禁言或人机验证失败", content: { "application/json": { schema: errorResponseSchema } } },
-    404: { description: "话题不存在", content: { "application/json": { schema: errorResponseSchema } } },
-    422: { description: "包含敏感词", content: { "application/json": { schema: errorResponseSchema } } },
   },
 });
 
@@ -76,7 +90,10 @@ reply.openapi(createReplyRoute, async (c) => {
   const contentCheck = await checkContent(content);
   if (contentCheck.hit) {
     return c.json(
-      { success: false as const, error_msg: `回复内容包含敏感词: ${contentCheck.words.join(", ")}` },
+      {
+        success: false as const,
+        error_msg: `回复内容包含敏感词: ${contentCheck.words.join(", ")}`,
+      },
       422,
     );
   }
@@ -136,11 +153,24 @@ const getReplyRoute = createRoute({
   responses: {
     200: {
       description: "回复详情",
-      content: { "application/json": { schema: z.object({ success: z.literal(true), data: replyDTOSchema }) } },
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: replyDTOSchema }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "无权限",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "回复或话题不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
     },
-    401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } },
-    403: { description: "无权限", content: { "application/json": { schema: errorResponseSchema } } },
-    404: { description: "回复或话题不存在", content: { "application/json": { schema: errorResponseSchema } } },
   },
 });
 
@@ -164,16 +194,19 @@ reply.openapi(getReplyRoute, async (c) => {
     return c.json({ success: false as const, error_msg: "无权限编辑" }, 403);
   }
 
-  return c.json({
-    success: true as const,
-    data: {
-      id: String(replyData.id),
-      topic_id: String(replyData.topicId),
-      content: replyData.content,
-      create_at: replyData.createAt,
-      update_at: replyData.updateAt,
+  return c.json(
+    {
+      success: true as const,
+      data: {
+        id: String(replyData.id),
+        topic_id: String(replyData.topicId),
+        content: replyData.content,
+        create_at: replyData.createAt,
+        update_at: replyData.updateAt,
+      },
     },
-  }, 200);
+    200,
+  );
 });
 
 const editReplyRoute = createRoute({
@@ -189,12 +222,28 @@ const editReplyRoute = createRoute({
   responses: {
     200: {
       description: "编辑成功",
-      content: { "application/json": { schema: z.object({ success: z.literal(true), reply_id: z.string() }) } },
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), reply_id: z.string() }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "无权限或话题锁定",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "回复或话题不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "包含敏感词",
+      content: { "application/json": { schema: errorResponseSchema } },
     },
-    401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } },
-    403: { description: "无权限或话题锁定", content: { "application/json": { schema: errorResponseSchema } } },
-    404: { description: "回复或话题不存在", content: { "application/json": { schema: errorResponseSchema } } },
-    422: { description: "包含敏感词", content: { "application/json": { schema: errorResponseSchema } } },
   },
 });
 
@@ -225,7 +274,10 @@ reply.openapi(editReplyRoute, async (c) => {
   const contentCheck = await checkContent(body.content);
   if (contentCheck.hit) {
     return c.json(
-      { success: false as const, error_msg: `回复内容包含敏感词: ${contentCheck.words.join(", ")}` },
+      {
+        success: false as const,
+        error_msg: `回复内容包含敏感词: ${contentCheck.words.join(", ")}`,
+      },
       422,
     );
   }
@@ -249,12 +301,26 @@ const deleteReplyRoute = createRoute({
   responses: {
     200: {
       description: "删除成功",
-      content: { "application/json": { schema: z.object({ success: z.literal(true), status: z.string() }) } },
+      content: {
+        "application/json": { schema: z.object({ success: z.literal(true), status: z.string() }) },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "无权限",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "回复不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    422: {
+      description: "回复已删除",
+      content: { "application/json": { schema: errorResponseSchema } },
     },
-    401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } },
-    403: { description: "无权限", content: { "application/json": { schema: errorResponseSchema } } },
-    404: { description: "回复不存在", content: { "application/json": { schema: errorResponseSchema } } },
-    422: { description: "回复已删除", content: { "application/json": { schema: errorResponseSchema } } },
   },
 });
 
@@ -294,11 +360,24 @@ const upsReplyRoute = createRoute({
   responses: {
     200: {
       description: "操作成功",
-      content: { "application/json": { schema: z.object({ success: z.literal(true), action: z.enum(["up", "down"]) }) } },
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), action: z.enum(["up", "down"]) }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "不能给自己点赞",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    404: {
+      description: "回复不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
     },
-    401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } },
-    403: { description: "不能给自己点赞", content: { "application/json": { schema: errorResponseSchema } } },
-    404: { description: "回复不存在", content: { "application/json": { schema: errorResponseSchema } } },
   },
 });
 
diff --git a/apps/api/src/routes/topic.ts b/apps/api/src/routes/topic.ts
index 0a45f06..14c3366 100644
--- a/apps/api/src/routes/topic.ts
+++ b/apps/api/src/routes/topic.ts
@@ -1,6 +1,13 @@
 import { OpenAPIHono, createRoute } from "@hono/zod-openapi";
 import _ from "lodash";
-import { settingQueries, topicQueries, userQueries, replyQueries, jobMetaQueries, roleQueries } from "../lib/db";
+import {
+  settingQueries,
+  topicQueries,
+  userQueries,
+  replyQueries,
+  jobMetaQueries,
+  roleQueries,
+} from "../lib/db";
 import { incrementScoreAndTopicCount } from "../lib/score";
 import { sendMessageToMentionUsers } from "../lib/at";
 import { checkContent } from "../lib/moderation";
@@ -32,7 +39,10 @@ const INTERNAL_TABS = new Set(["dev", "test"]);
 
 async function assertNewUserCanCreateTopic(user: any) {
   const minHours = Math.max(0, Number(await settingQueries.get("new_user_min_hours", "24")) || 24);
-  const minReplies = Math.max(0, Number(await settingQueries.get("new_user_min_replies", "3")) || 3);
+  const minReplies = Math.max(
+    0,
+    Number(await settingQueries.get("new_user_min_replies", "3")) || 3,
+  );
   const createdAt = user.createAt ? new Date(user.createAt).getTime() : Date.now();
   const accountAgeHours = Math.floor((Date.now() - createdAt) / 3600000);
   if (accountAgeHours < minHours || Number(user.replyCount || 0) < minReplies) {
@@ -43,7 +53,10 @@ async function assertNewUserCanCreateTopic(user: any) {
 
 async function isNewUserForTopicGate(user: any) {
   const minHours = Math.max(0, Number(await settingQueries.get("new_user_min_hours", "24")) || 24);
-  const minReplies = Math.max(0, Number(await settingQueries.get("new_user_min_replies", "3")) || 3);
+  const minReplies = Math.max(
+    0,
+    Number(await settingQueries.get("new_user_min_replies", "3")) || 3,
+  );
   const createdAt = user.createAt ? new Date(user.createAt).getTime() : Date.now();
   const accountAgeHours = Math.floor((Date.now() - createdAt) / 3600000);
   return accountAgeHours < minHours || Number(user.replyCount || 0) < minReplies;
@@ -201,7 +214,10 @@ topic.openapi(getTopicRoute, async (c) => {
   await topicQueries.incrementVisitCount(id);
 
   const author = await userQueries.getById(topicData.authorId);
-  if (!c.get("isAdmin") && (topicData.status === "deleted" || INTERNAL_TABS.has(topicData.tab || "") || author?.isBlock)) {
+  if (
+    !c.get("isAdmin") &&
+    (topicData.status === "deleted" || INTERNAL_TABS.has(topicData.tab || "") || author?.isBlock)
+  ) {
     return c.json({ success: false as const, error_msg: "话题不存在" }, 404);
   }
   const repliesList = await replyQueries.getByTopicId(id);
@@ -221,7 +237,9 @@ topic.openapi(getTopicRoute, async (c) => {
         ? replyMap.get(r.replyId) || (await replyQueries.getById(r.replyId))
         : null;
       const visibleParentReply = parentReply && !parentReply.deleted ? parentReply : null;
-      const parentAuthor = visibleParentReply ? await userQueries.getById(visibleParentReply.authorId) : null;
+      const parentAuthor = visibleParentReply
+        ? await userQueries.getById(visibleParentReply.authorId)
+        : null;
       const ups = upsByReplyId.get(r.id) || [];
       return {
         id: String(r.id),
@@ -287,9 +305,7 @@ const createTopicRoute = createRoute({
   tags: ["topics"],
   summary: "创建话题",
   description: "需要登录。新用户需通过 Turnstile 人机验证。",
-  middleware: [
-    perUserPerDaySetting("create_topic", "rate_topic", CREATE_TOPIC_PER_DAY, true),
-  ],
+  middleware: [perUserPerDaySetting("create_topic", "rate_topic", CREATE_TOPIC_PER_DAY, true)],
   request: {
     body: {
       content: { "application/json": { schema: createTopicBodySchema } },
@@ -329,7 +345,10 @@ topic.openapi(createTopicRoute, async (c) => {
     return c.json({ success: false as const, error_msg: "您已被禁言" }, 403);
   }
   const body = c.req.valid("json");
-  if ((await isNewUserForTopicGate(user)) && !(await verifyTurnstile(body.turnstileToken, requestIp(c)))) {
+  if (
+    (await isNewUserForTopicGate(user)) &&
+    !(await verifyTurnstile(body.turnstileToken, requestIp(c)))
+  ) {
     return c.json({ success: false as const, error_msg: "人机验证失败" }, 403);
   }
   const newUserError = await assertNewUserCanCreateTopic(user);
diff --git a/apps/api/src/routes/user.ts b/apps/api/src/routes/user.ts
index 9deaee4..acba770 100644
--- a/apps/api/src/routes/user.ts
+++ b/apps/api/src/routes/user.ts
@@ -25,14 +25,20 @@ function publicTopicWhere(extra?: any) {
   return and(
     boolEq(topics.deleted, false),
     sql`coalesce(${topics.status}, 'published') <> 'deleted'`,
-    sql`(${topics.tab} is null or ${topics.tab} not in (${sql.join(INTERNAL_TABS.map((tab) => sql`${tab}`), sql`, `)}))`,
+    sql`(${topics.tab} is null or ${topics.tab} not in (${sql.join(
+      INTERNAL_TABS.map((tab) => sql`${tab}`),
+      sql`, `,
+    )}))`,
     sql`exists (select 1 from ${users} where ${users.id} = ${topics.authorId} and ${boolEq(users.isBlock, false)})`,
     ...(extra ? [extra] : []),
   );
 }
 
 function publicTopicExists(topicId: any) {
-  return sql`exists (select 1 from ${topics} where ${topics.id} = ${topicId} and ${boolEq(topics.deleted, false)} and coalesce(${topics.status}, 'published') <> 'deleted' and (${topics.tab} is null or ${topics.tab} not in (${sql.join(INTERNAL_TABS.map((tab) => sql`${tab}`), sql`, `)})) and exists (select 1 from ${users} where ${users.id} = ${topics.authorId} and ${boolEq(users.isBlock, false)}))`;
+  return sql`exists (select 1 from ${topics} where ${topics.id} = ${topicId} and ${boolEq(topics.deleted, false)} and coalesce(${topics.status}, 'published') <> 'deleted' and (${topics.tab} is null or ${topics.tab} not in (${sql.join(
+    INTERNAL_TABS.map((tab) => sql`${tab}`),
+    sql`, `,
+  )})) and exists (select 1 from ${users} where ${users.id} = ${topics.authorId} and ${boolEq(users.isBlock, false)}))`;
 }
 
 function formatPublicUser(userData: any): PublicUserDTO {
@@ -63,37 +69,93 @@ async function formatTopic(t: any) {
     reply_count: t.replyCount,
     visit_count: t.visitCount,
     create_at: t.createAt,
-    author: author ? { loginname: author.loginname, avatar_url: author.avatar } : { loginname: "", avatar_url: "" },
+    author: author
+      ? { loginname: author.loginname, avatar_url: author.avatar }
+      : { loginname: "", avatar_url: "" },
   };
 }
 
 // GET /users/stars
 const starsRoute = createRoute({
-  method: "get", path: "/users/stars", tags: ["users"], summary: "获取星标用户",
-  responses: { 200: { description: "星标用户列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(publicUserSchema) }) } } } },
+  method: "get",
+  path: "/users/stars",
+  tags: ["users"],
+  summary: "获取星标用户",
+  responses: {
+    200: {
+      description: "星标用户列表",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: z.array(publicUserSchema) }),
+        },
+      },
+    },
+  },
 });
 user.openapi(starsRoute, async (c) => {
   const db = getDb();
-  const stars = await db.select().from(users).where(boolEq(users.isStar, true)).orderBy(desc(users.score));
+  const stars = await db
+    .select()
+    .from(users)
+    .where(boolEq(users.isStar, true))
+    .orderBy(desc(users.score));
   return c.json({ success: true as const, data: stars.map(formatPublicUser) }, 200);
 });
 
 // GET /users/top100
 const top100Route = createRoute({
-  method: "get", path: "/users/top100", tags: ["users"], summary: "获取积分前 100 用户",
-  responses: { 200: { description: "Top 100 用户", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(publicUserSchema) }) } } } },
+  method: "get",
+  path: "/users/top100",
+  tags: ["users"],
+  summary: "获取积分前 100 用户",
+  responses: {
+    200: {
+      description: "Top 100 用户",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: z.array(publicUserSchema) }),
+        },
+      },
+    },
+  },
 });
 user.openapi(top100Route, async (c) => {
   const db = getDb();
-  const tops = await db.select().from(users).where(boolEq(users.isBlock, false)).orderBy(desc(users.score)).limit(100);
+  const tops = await db
+    .select()
+    .from(users)
+    .where(boolEq(users.isBlock, false))
+    .orderBy(desc(users.score))
+    .limit(100);
   return c.json({ success: true as const, data: tops.map(formatPublicUser) }, 200);
 });
 
 // GET /user/:loginname/topics
 const userTopicsRoute = createRoute({
-  method: "get", path: "/user/{loginname}/topics", tags: ["users"], summary: "用户的话题列表",
+  method: "get",
+  path: "/user/{loginname}/topics",
+  tags: ["users"],
+  summary: "用户的话题列表",
   request: { params: loginNameParamSchema, query: paginationQuerySchema },
-  responses: { 200: { description: "话题列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(topicDTOSchema), total: z.number(), user: publicUserSchema }) } } }, 404: { description: "用户不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "话题列表",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.array(topicDTOSchema),
+            total: z.number(),
+            user: publicUserSchema,
+          }),
+        },
+      },
+    },
+    404: {
+      description: "用户不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(userTopicsRoute, async (c) => {
   const { loginname } = c.req.valid("param");
@@ -103,17 +165,52 @@ user.openapi(userTopicsRoute, async (c) => {
   const db = getDb();
   const where = publicTopicWhere(eq(topics.authorId, userData.id));
   const [list, totalResult] = await Promise.all([
-    db.select().from(topics).where(where).orderBy(desc(topics.createAt)).limit(limit).offset((page - 1) * limit),
+    db
+      .select()
+      .from(topics)
+      .where(where)
+      .orderBy(desc(topics.createAt))
+      .limit(limit)
+      .offset((page - 1) * limit),
     db.select({ c: count() }).from(topics).where(where),
   ]);
-  return c.json({ success: true as const, data: await Promise.all(list.map(formatTopic)), total: Number(totalResult[0]?.c || 0), user: formatPublicUser(userData) }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: await Promise.all(list.map(formatTopic)),
+      total: Number(totalResult[0]?.c || 0),
+      user: formatPublicUser(userData),
+    },
+    200,
+  );
 });
 
 // GET /user/:loginname/replies
 const userRepliesRoute = createRoute({
-  method: "get", path: "/user/{loginname}/replies", tags: ["users"], summary: "用户的回复列表",
+  method: "get",
+  path: "/user/{loginname}/replies",
+  tags: ["users"],
+  summary: "用户的回复列表",
   request: { params: loginNameParamSchema, query: paginationQuerySchema },
-  responses: { 200: { description: "回复列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(topicDTOSchema), total: z.number(), user: publicUserSchema }) } } }, 404: { description: "用户不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "回复列表",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.array(topicDTOSchema),
+            total: z.number(),
+            user: publicUserSchema,
+          }),
+        },
+      },
+    },
+    404: {
+      description: "用户不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(userRepliesRoute, async (c) => {
   const { loginname } = c.req.valid("param");
@@ -122,20 +219,67 @@ user.openapi(userRepliesRoute, async (c) => {
   if (!userData) return c.json({ success: false as const, error_msg: "用户不存在" }, 404);
   const db = getDb();
   const visibleTopicExists = publicTopicExists(replies.topicId);
-  const topicRows = await db.select({ topicId: replies.topicId, lastReplyAt: sql`max(${replies.createAt})` }).from(replies).where(and(eq(replies.authorId, userData.id), boolEq(replies.deleted, false), visibleTopicExists)).groupBy(replies.topicId).orderBy(desc(sql`max(${replies.createAt})`)).limit(limit).offset((page - 1) * limit);
-  const totalRows = await db.select({ c: sql<number>`count(distinct ${replies.topicId})` }).from(replies).where(and(eq(replies.authorId, userData.id), boolEq(replies.deleted, false)));
+  const topicRows = await db
+    .select({ topicId: replies.topicId, lastReplyAt: sql`max(${replies.createAt})` })
+    .from(replies)
+    .where(
+      and(eq(replies.authorId, userData.id), boolEq(replies.deleted, false), visibleTopicExists),
+    )
+    .groupBy(replies.topicId)
+    .orderBy(desc(sql`max(${replies.createAt})`))
+    .limit(limit)
+    .offset((page - 1) * limit);
+  const totalRows = await db
+    .select({ c: sql<number>`count(distinct ${replies.topicId})` })
+    .from(replies)
+    .where(and(eq(replies.authorId, userData.id), boolEq(replies.deleted, false)));
   const ids = topicRows.map((row: any) => row.topicId).filter(Boolean);
-  const topicList = ids.length > 0 ? await db.select().from(topics).where(publicTopicWhere(inArray(topics.id, ids))) : [];
+  const topicList =
+    ids.length > 0
+      ? await db
+          .select()
+          .from(topics)
+          .where(publicTopicWhere(inArray(topics.id, ids)))
+      : [];
   const byId = new Map(topicList.map((topic: any) => [topic.id, topic]));
   const ordered = ids.map((id) => byId.get(id)).filter(Boolean);
-  return c.json({ success: true as const, data: await Promise.all(ordered.map(formatTopic)), total: Number(totalRows[0]?.c || 0), user: formatPublicUser(userData) }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: await Promise.all(ordered.map(formatTopic)),
+      total: Number(totalRows[0]?.c || 0),
+      user: formatPublicUser(userData),
+    },
+    200,
+  );
 });
 
 // GET /user/:loginname/collections
 const userCollectionsRoute = createRoute({
-  method: "get", path: "/user/{loginname}/collections", tags: ["users"], summary: "用户的收藏列表",
+  method: "get",
+  path: "/user/{loginname}/collections",
+  tags: ["users"],
+  summary: "用户的收藏列表",
   request: { params: loginNameParamSchema, query: paginationQuerySchema },
-  responses: { 200: { description: "收藏列表", content: { "application/json": { schema: z.object({ success: z.literal(true), data: z.array(topicDTOSchema), total: z.number(), user: publicUserSchema }) } } }, 404: { description: "用户不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "收藏列表",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            data: z.array(topicDTOSchema),
+            total: z.number(),
+            user: publicUserSchema,
+          }),
+        },
+      },
+    },
+    404: {
+      description: "用户不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(userCollectionsRoute, async (c) => {
   const { loginname } = c.req.valid("param");
@@ -143,30 +287,72 @@ user.openapi(userCollectionsRoute, async (c) => {
   const userData = await userQueries.getByLoginName(loginname);
   if (!userData) return c.json({ success: false as const, error_msg: "用户不存在" }, 404);
   const db = getDb();
-  const visibleCollectWhere = and(eq(topicCollects.userId, userData.id), publicTopicExists(topicCollects.topicId));
+  const visibleCollectWhere = and(
+    eq(topicCollects.userId, userData.id),
+    publicTopicExists(topicCollects.topicId),
+  );
   const [collects, totalResult] = await Promise.all([
-    db.select().from(topicCollects).where(visibleCollectWhere).orderBy(desc(topicCollects.createAt)).limit(limit).offset((page - 1) * limit),
+    db
+      .select()
+      .from(topicCollects)
+      .where(visibleCollectWhere)
+      .orderBy(desc(topicCollects.createAt))
+      .limit(limit)
+      .offset((page - 1) * limit),
     db.select({ c: count() }).from(topicCollects).where(visibleCollectWhere),
   ]);
   const ids = collects.map((doc) => doc.topicId);
-  const topicList = ids.length > 0 ? await db.select().from(topics).where(publicTopicWhere(inArray(topics.id, ids))) : [];
+  const topicList =
+    ids.length > 0
+      ? await db
+          .select()
+          .from(topics)
+          .where(publicTopicWhere(inArray(topics.id, ids)))
+      : [];
   const byId = new Map(topicList.map((topic: any) => [topic.id, topic]));
   const ordered = ids.map((id) => byId.get(id)).filter(Boolean);
-  return c.json({ success: true as const, data: await Promise.all(ordered.map(formatTopic)), total: Number(totalResult[0]?.c || 0), user: formatPublicUser(userData) }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: await Promise.all(ordered.map(formatTopic)),
+      total: Number(totalResult[0]?.c || 0),
+      user: formatPublicUser(userData),
+    },
+    200,
+  );
 });
 
 // GET /user/:loginname
 const userDetailRoute = createRoute({
-  method: "get", path: "/user/{loginname}", tags: ["users"], summary: "获取用户详情",
+  method: "get",
+  path: "/user/{loginname}",
+  tags: ["users"],
+  summary: "获取用户详情",
   request: { params: loginNameParamSchema },
-  responses: { 200: { description: "用户详情", content: { "application/json": { schema: z.object({ success: z.literal(true), data: userDetailSchema }) } } }, 404: { description: "用户不存在", content: { "application/json": { schema: errorResponseSchema } } } },
+  responses: {
+    200: {
+      description: "用户详情",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), data: userDetailSchema }),
+        },
+      },
+    },
+    404: {
+      description: "用户不存在",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(userDetailRoute, async (c) => {
   const { loginname } = c.req.valid("param");
   const userData = await userQueries.getByLoginName(loginname);
   if (!userData) return c.json({ success: false as const, error_msg: "用户不存在" }, 404);
   const [recentTopics, userReplies, roles] = await Promise.all([
-    topicQueries.getByQuery({ authorId: userData.id, publicVisible: true }, { limit: 15, orderBy: undefined }),
+    topicQueries.getByQuery(
+      { authorId: userData.id, publicVisible: true },
+      { limit: 15, orderBy: undefined },
+    ),
     replyQueries.getByAuthorId(userData.id, { limit: 20 }),
     roleQueries.listByUserId(userData.id),
   ]);
@@ -174,35 +360,125 @@ user.openapi(userDetailRoute, async (c) => {
   const replyTopics = await Promise.all(replyTopicIds.map((tid) => topicQueries.getById(tid)));
   const recentRepliesTopics: any[] = [];
   for (const topic of replyTopics) {
-    if (!topic || topic.deleted || topic.status === "deleted" || INTERNAL_TABS.includes(topic.tab || "")) continue;
+    if (
+      !topic ||
+      topic.deleted ||
+      topic.status === "deleted" ||
+      INTERNAL_TABS.includes(topic.tab || "")
+    )
+      continue;
     const author = await userQueries.getById(topic.authorId);
     if (author?.isBlock) continue;
     recentRepliesTopics.push(topic);
     if (recentRepliesTopics.length >= 5) break;
   }
-  const fmtTopic = (t: any) => ({ id: String(t.id), author: { loginname: userData.loginname, avatar_url: userData.avatar }, title: t.title, last_reply_at: t.lastReplyAt });
+  const fmtTopic = (t: any) => ({
+    id: String(t.id),
+    author: { loginname: userData.loginname, avatar_url: userData.avatar },
+    title: t.title,
+    last_reply_at: t.lastReplyAt,
+  });
   const { identities } = resolveUserAccess(userData.loginname, roles);
-  return c.json({ success: true as const, data: { loginname: userData.loginname, avatar_url: userData.avatar, githubUsername: userData.githubUsername?.trim() || "", location: userData.location?.trim() || null, url: userData.url?.trim() || null, signature: userData.signature?.trim() || null, identities, create_at: userData.createAt, score: userData.score || 0, topic_count: userData.topicCount || 0, reply_count: userData.replyCount || 0, collect_topic_count: userData.collectTopicCount || 0, is_block: !!userData.isBlock, is_muted: !!userData.isMuted, recent_topics: recentTopics.map(fmtTopic), recent_replies: recentRepliesTopics.map(fmtTopic) } }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: {
+        loginname: userData.loginname,
+        avatar_url: userData.avatar,
+        githubUsername: userData.githubUsername?.trim() || "",
+        location: userData.location?.trim() || null,
+        url: userData.url?.trim() || null,
+        signature: userData.signature?.trim() || null,
+        identities,
+        create_at: userData.createAt,
+        score: userData.score || 0,
+        topic_count: userData.topicCount || 0,
+        reply_count: userData.replyCount || 0,
+        collect_topic_count: userData.collectTopicCount || 0,
+        is_block: !!userData.isBlock,
+        is_muted: !!userData.isMuted,
+        recent_topics: recentTopics.map(fmtTopic),
+        recent_replies: recentRepliesTopics.map(fmtTopic),
+      },
+    },
+    200,
+  );
 });
 
 // POST /accesstoken
 const accessTokenRoute = createRoute({
-  method: "post", path: "/accesstoken", tags: ["auth"], summary: "验证 accessToken",
-  request: { body: { content: { "application/json": { schema: z.object({ accesstoken: z.string() }) } } } },
-  responses: { 200: { description: "验证成功", content: { "application/json": { schema: z.object({ success: z.literal(true), loginname: z.string(), avatar_url: z.string(), id: z.string(), is_block: z.boolean(), is_muted: z.boolean() }) } } }, 400: { description: "缺少 accesstoken", content: { "application/json": { schema: errorResponseSchema } } }, 403: { description: "accesstoken 无效", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "post",
+  path: "/accesstoken",
+  tags: ["auth"],
+  summary: "验证 accessToken",
+  request: {
+    body: { content: { "application/json": { schema: z.object({ accesstoken: z.string() }) } } },
+  },
+  responses: {
+    200: {
+      description: "验证成功",
+      content: {
+        "application/json": {
+          schema: z.object({
+            success: z.literal(true),
+            loginname: z.string(),
+            avatar_url: z.string(),
+            id: z.string(),
+            is_block: z.boolean(),
+            is_muted: z.boolean(),
+          }),
+        },
+      },
+    },
+    400: {
+      description: "缺少 accesstoken",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+    403: {
+      description: "accesstoken 无效",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(accessTokenRoute, async (c) => {
   const { accesstoken } = c.req.valid("json");
-  if (!accesstoken) return c.json({ success: false as const, error_msg: "accesstoken is required" }, 400);
+  if (!accesstoken)
+    return c.json({ success: false as const, error_msg: "accesstoken is required" }, 400);
   const userData = await userQueries.getByToken(accesstoken);
   if (!userData) return c.json({ success: false as const, error_msg: "accesstoken 无效" }, 403);
-  return c.json({ success: true as const, loginname: userData.loginname, avatar_url: userData.avatar, id: String(userData.id), is_block: !!userData.isBlock, is_muted: !!userData.isMuted || !!userData.isBlock }, 200);
+  return c.json(
+    {
+      success: true as const,
+      loginname: userData.loginname,
+      avatar_url: userData.avatar,
+      id: String(userData.id),
+      is_block: !!userData.isBlock,
+      is_muted: !!userData.isMuted || !!userData.isBlock,
+    },
+    200,
+  );
 });
 
 // POST /user/refresh_token
 const refreshTokenRoute = createRoute({
-  method: "post", path: "/user/refresh_token", tags: ["auth"], summary: "刷新 accessToken",
-  responses: { 200: { description: "刷新成功", content: { "application/json": { schema: z.object({ success: z.literal(true), accessToken: z.string() }) } } }, 401: { description: "未登录", content: { "application/json": { schema: errorResponseSchema } } } },
+  method: "post",
+  path: "/user/refresh_token",
+  tags: ["auth"],
+  summary: "刷新 accessToken",
+  responses: {
+    200: {
+      description: "刷新成功",
+      content: {
+        "application/json": {
+          schema: z.object({ success: z.literal(true), accessToken: z.string() }),
+        },
+      },
+    },
+    401: {
+      description: "未登录",
+      content: { "application/json": { schema: errorResponseSchema } },
+    },
+  },
 });
 user.openapi(refreshTokenRoute, async (c) => {
   const currentUser = c.get("user");
diff --git a/apps/api/src/routes/zone.ts b/apps/api/src/routes/zone.ts
index e122481..09508e6 100644
--- a/apps/api/src/routes/zone.ts
+++ b/apps/api/src/routes/zone.ts
@@ -125,10 +125,13 @@ const facetsRoute = createRoute({
 
 zone.openapi(facetsRoute, async (c) => {
   const locations = await jobMetaQueries.facetLocations();
-  return c.json({
-    success: true as const,
-    data: { locations, remote_options: REMOTE_OPTIONS },
-  }, 200);
+  return c.json(
+    {
+      success: true as const,
+      data: { locations, remote_options: REMOTE_OPTIONS },
+    },
+    200,
+  );
 });
 
 const listZonesRoute = createRoute({
diff --git a/apps/api/test/admin-pagination.test.ts b/apps/api/test/admin-pagination.test.ts
index bbd4efd..2d61c63 100644
--- a/apps/api/test/admin-pagination.test.ts
+++ b/apps/api/test/admin-pagination.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { parseAdminPagination } from "../src/routes/admin";
 
 test("admin pagination defaults", () => {
@@ -6,10 +6,22 @@ test("admin pagination defaults", () => {
 });
 
 test("admin pagination parses valid input", () => {
-  expect(parseAdminPagination({ page: "3", limit: "20" })).toEqual({ page: 3, limit: 20, offset: 40 });
+  expect(parseAdminPagination({ page: "3", limit: "20" })).toEqual({
+    page: 3,
+    limit: 20,
+    offset: 40,
+  });
 });
 
 test("admin pagination clamps invalid input", () => {
-  expect(parseAdminPagination({ page: "0", limit: "999" })).toEqual({ page: 1, limit: 100, offset: 0 });
-  expect(parseAdminPagination({ page: "99", limit: "10" })).toEqual({ page: 99, limit: 10, offset: 980 });
+  expect(parseAdminPagination({ page: "0", limit: "999" })).toEqual({
+    page: 1,
+    limit: 100,
+    offset: 0,
+  });
+  expect(parseAdminPagination({ page: "99", limit: "10" })).toEqual({
+    page: 99,
+    limit: 10,
+    offset: 980,
+  });
 });
diff --git a/apps/api/test/admin-topic-filters.test.ts b/apps/api/test/admin-topic-filters.test.ts
index 902aadc..8a2ed0c 100644
--- a/apps/api/test/admin-topic-filters.test.ts
+++ b/apps/api/test/admin-topic-filters.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { parseAdminTopicFilters } from "../src/lib/admin-governance";
 
 test("admin topic filters parse supported values", () => {
diff --git a/apps/api/test/audit-events.test.ts b/apps/api/test/audit-events.test.ts
index 6e40c65..13ddf20 100644
--- a/apps/api/test/audit-events.test.ts
+++ b/apps/api/test/audit-events.test.ts
@@ -1,5 +1,10 @@
-import { expect, test } from "vitest";
-import { auditEventMeta, buildBulkUserGovernancePlan, bulkUserGovernanceAuditAction, sanitizeAuditDetail } from "../src/routes/admin";
+import { expect, test } from "vite-plus/test";
+import {
+  auditEventMeta,
+  buildBulkUserGovernancePlan,
+  bulkUserGovernanceAuditAction,
+  sanitizeAuditDetail,
+} from "../src/routes/admin";
 
 test("audit events classify sensitive actions by category and risk", () => {
   expect(auditEventMeta("delete_all_user_content")).toEqual({
@@ -46,7 +51,11 @@ test("bulk user governance plan maps unblock without changing mute", () => {
 
 test("audit detail sanitizer redacts sensitive JSON and text values", () => {
   expect(
-    sanitizeAuditDetail(JSON.stringify({ role: "admin", token: "secret-token", nested: { password: "pw" } })),
-  ).toBe(JSON.stringify({ role: "admin", token: "[redacted]", nested: { password: "[redacted]" } }));
+    sanitizeAuditDetail(
+      JSON.stringify({ role: "admin", token: "secret-token", nested: { password: "pw" } }),
+    ),
+  ).toBe(
+    JSON.stringify({ role: "admin", token: "[redacted]", nested: { password: "[redacted]" } }),
+  );
   expect(sanitizeAuditDetail("token=abc123 action=ok")).toBe("token=[redacted] action=ok");
 });
diff --git a/apps/api/test/format.test.ts b/apps/api/test/format.test.ts
index 6c75c9c..8867b95 100644
--- a/apps/api/test/format.test.ts
+++ b/apps/api/test/format.test.ts
@@ -1,16 +1,19 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { normalizeAvatarUrl } from "../src/lib/format";
 
 describe("normalizeAvatarUrl", () => {
   it("upgrades legacy Gravatar URLs to HTTPS", () => {
-    expect(normalizeAvatarUrl("http://www.gravatar.com/avatar/hash?size=48"))
-      .toBe("https://www.gravatar.com/avatar/hash?size=48");
-    expect(normalizeAvatarUrl("http://gravatar.com/avatar/hash"))
-      .toBe("https://gravatar.com/avatar/hash");
+    expect(normalizeAvatarUrl("http://www.gravatar.com/avatar/hash?size=48")).toBe(
+      "https://www.gravatar.com/avatar/hash?size=48",
+    );
+    expect(normalizeAvatarUrl("http://gravatar.com/avatar/hash")).toBe(
+      "https://gravatar.com/avatar/hash",
+    );
   });
 
   it("does not rewrite unrelated absolute avatar URLs", () => {
-    expect(normalizeAvatarUrl("http://images.example.com/avatar.png"))
-      .toBe("http://images.example.com/avatar.png");
+    expect(normalizeAvatarUrl("http://images.example.com/avatar.png")).toBe(
+      "http://images.example.com/avatar.png",
+    );
   });
 });
diff --git a/apps/api/test/health.test.ts b/apps/api/test/health.test.ts
index e793c3f..dba28ae 100644
--- a/apps/api/test/health.test.ts
+++ b/apps/api/test/health.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import app from "../src/app";
 
 test("GET /health returns shallow build metadata without sensitive leakage", async () => {
@@ -24,7 +24,9 @@ test("GET /health returns shallow build metadata without sensitive leakage", asy
 
     const serialized = JSON.stringify(body);
     expect(serialized).not.toMatch(/POSTGRES_PASSWORD|AUTH_SESSION_SECRET|TURNSTILE_SECRET_KEY/);
-    expect(serialized).not.toMatch(/secret-postgres-password|super-secret-session|turnstile-secret-token/);
+    expect(serialized).not.toMatch(
+      /secret-postgres-password|super-secret-session|turnstile-secret-token/,
+    );
     expect(serialized).not.toMatch(/postgres:\/\//);
     expect(serialized).not.toMatch(/stack/i);
   } finally {
diff --git a/apps/api/test/ip-ban-rules.test.ts b/apps/api/test/ip-ban-rules.test.ts
index b7212ba..7ba0349 100644
--- a/apps/api/test/ip-ban-rules.test.ts
+++ b/apps/api/test/ip-ban-rules.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { isValidIpRule, matchesIpRule } from "../src/middleware/ip-ban";
 
 test("isValidIpRule accepts single IPv4", () => {
diff --git a/apps/api/test/mail-template.test.ts b/apps/api/test/mail-template.test.ts
index 7a50e97..d615623 100644
--- a/apps/api/test/mail-template.test.ts
+++ b/apps/api/test/mail-template.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import {
   buildActiveMail,
   buildAtNotifyMail,
@@ -6,7 +6,12 @@ import {
   buildResetPassMail,
 } from "../src/lib/mail-template";
 
-function assertBrandedMail(mail: { html: string; text: string }, actionLabel: string, url: string, logoUrl = "http://localhost:5173/cnodejs_light.svg") {
+function assertBrandedMail(
+  mail: { html: string; text: string },
+  actionLabel: string,
+  url: string,
+  logoUrl = "http://localhost:5173/cnodejs_light.svg",
+) {
   expect(mail.html).toMatch(/<!doctype html/i);
   expect(mail.html).toContain(logoUrl);
   expect(mail.html).toContain("#80bd01");
@@ -24,7 +29,12 @@ test("builds branded activation and password reset emails", async () => {
   const activation = await buildActiveMail("a/b c&d", "https://next.cnodejs.org///");
   const activationUrl = "https://next.cnodejs.org/active_account?key=a%2Fb%20c%26d";
   expect(activation.subject).toBe("CNode 账号激活");
-  assertBrandedMail(activation, "激活账号", activationUrl, "https://next.cnodejs.org/cnodejs_light.svg");
+  assertBrandedMail(
+    activation,
+    "激活账号",
+    activationUrl,
+    "https://next.cnodejs.org/cnodejs_light.svg",
+  );
 
   const reset = await buildResetPassMail("reset-key", "http://localhost:5173/");
   const resetUrl = "http://localhost:5173/reset_pass?key=reset-key";
@@ -52,7 +62,9 @@ test("lets React escape untrusted titles, content, and attributes", async () =>
   const content = '<img src=x onerror="alert(1)">\n<style>body{display:none}</style>';
   const mail = await buildReplyNotifyMail(title, content, "https://cnodejs.org/topic/1?a=1&b=2");
 
-  expect(mail.html).toContain("&lt;script&gt;alert(&quot;title&quot;)&lt;/script&gt; &amp; discussion");
+  expect(mail.html).toContain(
+    "&lt;script&gt;alert(&quot;title&quot;)&lt;/script&gt; &amp; discussion",
+  );
   expect(mail.html).toContain("&lt;img src=x onerror=&quot;alert(1)&quot;&gt;");
   expect(mail.html.includes("<script>alert")).toBe(false);
   expect(mail.html.includes("<img src=x")).toBe(false);
@@ -63,8 +75,12 @@ test("lets React escape untrusted titles, content, and attributes", async () =>
 });
 
 test("rejects malformed and non-HTTP action URLs", async () => {
-  await expect(buildReplyNotifyMail("topic", "reply", "javascript:alert(1)")).rejects.toThrow(/must use HTTP\(S\)/);
-  await expect(buildAtNotifyMail("topic", "reply", "/topic/1")).rejects.toThrow(/must be an absolute HTTP\(S\) URL/);
+  await expect(buildReplyNotifyMail("topic", "reply", "javascript:alert(1)")).rejects.toThrow(
+    /must use HTTP\(S\)/,
+  );
+  await expect(buildAtNotifyMail("topic", "reply", "/topic/1")).rejects.toThrow(
+    /must be an absolute HTTP\(S\) URL/,
+  );
   await expect(buildActiveMail("key", "file:///tmp/site")).rejects.toThrow(/must use HTTP\(S\)/);
 });
 
diff --git a/apps/api/test/mdrender-query.test.ts b/apps/api/test/mdrender-query.test.ts
index 71bd033..162037f 100644
--- a/apps/api/test/mdrender-query.test.ts
+++ b/apps/api/test/mdrender-query.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { mdrenderQuerySchema } from "@cnode/shared";
 
 test("mdrender query parses explicit false strings", () => {
diff --git a/apps/api/test/message-rendering.test.ts b/apps/api/test/message-rendering.test.ts
index bb7e9e7..0d0aefa 100644
--- a/apps/api/test/message-rendering.test.ts
+++ b/apps/api/test/message-rendering.test.ts
@@ -1,5 +1,5 @@
 import { Hono } from "hono";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import type { AuthVars } from "../src/middleware/auth";
 
 const message = {
@@ -62,7 +62,9 @@ describe("message mdrender compatibility", () => {
       const body = await response.json();
 
       expect(response.status).toBe(200);
-      expect(body.data.hasnot_read_messages[0].reply.content).toBe("<p><strong>不错哦</strong></p>");
+      expect(body.data.hasnot_read_messages[0].reply.content).toBe(
+        "<p><strong>不错哦</strong></p>",
+      );
     },
   );
 
diff --git a/apps/api/test/moderation-helpers.test.ts b/apps/api/test/moderation-helpers.test.ts
index eb6c2cb..ef5af9a 100644
--- a/apps/api/test/moderation-helpers.test.ts
+++ b/apps/api/test/moderation-helpers.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { createHitDedupeKey, createHitPreview, matchContent } from "../src/lib/moderation";
 
 const words = [
diff --git a/apps/api/test/public-identities.test.ts b/apps/api/test/public-identities.test.ts
index a479c54..0218565 100644
--- a/apps/api/test/public-identities.test.ts
+++ b/apps/api/test/public-identities.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { publicIdentitiesSchema } from "@cnode/shared";
 import { PgDialect } from "drizzle-orm/pg-core";
 import { activeUserRoleCondition } from "../src/lib/db";
@@ -10,11 +10,13 @@ test("public identities remain independent from inherited permissions", () => {
     isAdmin: true,
     isMod: true,
   });
-  expect(resolveUserAccess("alice", ["recruiter"], ["alice"]).identities).toEqual(["admin", "recruiter"]);
-  expect(resolveUserAccess("alice", ["moderator", "recruiter", "moderator"], []).identities).toEqual([
-    "moderator",
+  expect(resolveUserAccess("alice", ["recruiter"], ["alice"]).identities).toEqual([
+    "admin",
     "recruiter",
   ]);
+  expect(
+    resolveUserAccess("alice", ["moderator", "recruiter", "moderator"], []).identities,
+  ).toEqual(["moderator", "recruiter"]);
   expect(resolveUserAccess("alice", ["recruiter", "moderator"], ["alice"]).identities).toEqual([
     "admin",
     "moderator",
diff --git a/apps/api/test/reply-data-consistency.test.ts b/apps/api/test/reply-data-consistency.test.ts
index cbc06c7..31e9991 100644
--- a/apps/api/test/reply-data-consistency.test.ts
+++ b/apps/api/test/reply-data-consistency.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "vite-plus/test";
 import { drizzle } from "drizzle-orm/node-postgres";
 import * as schema from "@cnode/db";
 import { buildRepliesByTopicQuery, buildTopicsByQuery } from "../src/lib/db";
@@ -28,7 +28,9 @@ describe("reply query ordering", () => {
     const db = drizzle.mock({ schema });
     const { sql } = buildTopicsByQuery(db, { deleted: false }).toSQL();
 
-    expect(sql).toContain('coalesce("topics"."last_reply_at", "topics"."create_at") desc nulls last');
+    expect(sql).toContain(
+      'coalesce("topics"."last_reply_at", "topics"."create_at") desc nulls last',
+    );
   });
 });
 
@@ -60,7 +62,9 @@ class MemoryReplyDeletionStore implements ReplyDeletionStore {
   private async runExclusive<T>(callback: () => Promise<T>): Promise<T> {
     const previous = this.queue;
     let release!: () => void;
-    this.queue = new Promise<void>((resolve) => { release = resolve; });
+    this.queue = new Promise<void>((resolve) => {
+      release = resolve;
+    });
     await previous;
     try {
       return await callback();
@@ -97,13 +101,15 @@ class MemoryReplyDeletionStore implements ReplyDeletionStore {
         this.author.replyCount = Math.max(0, this.author.replyCount - 1);
       },
       readTopicAggregate: async (topicId) => this.aggregate(topicId),
-      writeTopicAggregate: async (_id, aggregate) => { Object.assign(this.topic, aggregate); },
+      writeTopicAggregate: async (_id, aggregate) => {
+        Object.assign(this.topic, aggregate);
+      },
     };
   }
 
   private creationTransaction(): ReplyCreationTransaction {
     return {
-      lockTopic: async (id) => id === this.topic.id ? (this.locked ? "locked" : "open") : null,
+      lockTopic: async (id) => (id === this.topic.id ? (this.locked ? "locked" : "open") : null),
       insertReply: async (input) => {
         const reply = {
           id: Math.max(0, ...this.replies.map(({ id }) => id)) + 1,
@@ -121,7 +127,9 @@ class MemoryReplyDeletionStore implements ReplyDeletionStore {
         this.author.replyCount += 1;
       },
       readTopicAggregate: async (topicId) => this.aggregate(topicId),
-      writeTopicAggregate: async (_id, aggregate) => { Object.assign(this.topic, aggregate); },
+      writeTopicAggregate: async (_id, aggregate) => {
+        Object.assign(this.topic, aggregate);
+      },
     };
   }
 }
@@ -136,7 +144,12 @@ function storeWithReplies(ids: number[]) {
   }));
   return new MemoryReplyDeletionStore(
     replies,
-    { id: 10, replyCount: ids.length, lastReplyId: ids.at(-1) ?? null, lastReplyAt: replies.at(-1)?.createAt ?? null },
+    {
+      id: 10,
+      replyCount: ids.length,
+      lastReplyId: ids.at(-1) ?? null,
+      lastReplyAt: replies.at(-1)?.createAt ?? null,
+    },
     { id: 7, score: 20, replyCount: ids.length },
   );
 }
@@ -174,11 +187,13 @@ describe("atomic reply deletion", () => {
     const base = storeWithReplies([]);
     const store = new MemoryReplyDeletionStore(base.replies, base.topic, base.author, true);
 
-    await expect(createReplyWithStore(store.creationStore(), {
-      content: "blocked reply",
-      topicId: 10,
-      authorId: 7,
-    })).resolves.toEqual({ status: "locked" });
+    await expect(
+      createReplyWithStore(store.creationStore(), {
+        content: "blocked reply",
+        topicId: 10,
+        authorId: 7,
+      }),
+    ).resolves.toEqual({ status: "locked" });
     expect(store.replies).toHaveLength(0);
     expect(store.topic.replyCount).toBe(0);
   });
@@ -186,7 +201,11 @@ describe("atomic reply deletion", () => {
   test("deleting the latest reply falls back to the previous active reply", async () => {
     const store = storeWithReplies([1, 2, 3]);
     await deleteReplyWithStore(store, 3, 7, false);
-    expect(store.topic).toMatchObject({ replyCount: 2, lastReplyId: 2, lastReplyAt: store.replies[1].createAt });
+    expect(store.topic).toMatchObject({
+      replyCount: 2,
+      lastReplyId: 2,
+      lastReplyAt: store.replies[1].createAt,
+    });
   });
 
   test("deleting the only reply clears last reply metadata", async () => {
diff --git a/apps/api/test/reply-postgres-integration.test.ts b/apps/api/test/reply-postgres-integration.test.ts
index a6092d3..ebda6a6 100644
--- a/apps/api/test/reply-postgres-integration.test.ts
+++ b/apps/api/test/reply-postgres-integration.test.ts
@@ -1,4 +1,4 @@
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
+import { afterAll, beforeAll, describe, expect, test } from "vite-plus/test";
 import { and, eq } from "drizzle-orm";
 import { replies, topics, users } from "@cnode/db";
 import { getDb, replyQueries } from "../src/lib/db";
@@ -12,10 +12,10 @@ runPostgresIntegration("PostgreSQL reply transactions", () => {
 
   beforeAll(async () => {
     if (
-      process.env.POSTGRES_HOST !== "127.0.0.1"
-      || process.env.POSTGRES_PORT !== "65433"
-      || process.env.POSTGRES_DB !== "cnode_validation"
-      || process.env.POSTGRES_USER !== "cnode_validation"
+      process.env.POSTGRES_HOST !== "127.0.0.1" ||
+      process.env.POSTGRES_PORT !== "65433" ||
+      process.env.POSTGRES_DB !== "cnode_validation" ||
+      process.env.POSTGRES_USER !== "cnode_validation"
     ) {
       throw new Error("PostgreSQL integration tests require the isolated validation database");
     }
@@ -24,13 +24,20 @@ runPostgresIntegration("PostgreSQL reply transactions", () => {
     const suffix = `${process.pid}-${Date.now()}`;
     const [user] = await db
       .insert(users)
-      .values({ loginname: `reply-validation-${suffix}`, email: `reply-validation-${suffix}@invalid.test` })
+      .values({
+        loginname: `reply-validation-${suffix}`,
+        email: `reply-validation-${suffix}@invalid.test`,
+      })
       .returning({ id: users.id });
     userId = user.id;
 
     const [topic] = await db
       .insert(topics)
-      .values({ title: "Reply transaction validation", content: "isolated fixture", authorId: userId })
+      .values({
+        title: "Reply transaction validation",
+        content: "isolated fixture",
+        authorId: userId,
+      })
       .returning({ id: topics.id });
     topicId = topic.id;
   });
@@ -93,8 +100,9 @@ runPostgresIntegration("PostgreSQL reply transactions", () => {
   test("rejects creation when the locked topic row is rechecked", async () => {
     await db.update(topics).set({ lock: true }).where(eq(topics.id, topicId));
 
-    await expect(replyQueries.createWithAggregates("blocked", topicId, userId))
-      .resolves.toEqual({ status: "locked" });
+    await expect(replyQueries.createWithAggregates("blocked", topicId, userId)).resolves.toEqual({
+      status: "locked",
+    });
 
     const activeReplies = await db
       .select({ id: replies.id })
diff --git a/apps/api/test/roles-permissions.test.ts b/apps/api/test/roles-permissions.test.ts
index 58152d4..dd2511d 100644
--- a/apps/api/test/roles-permissions.test.ts
+++ b/apps/api/test/roles-permissions.test.ts
@@ -1,6 +1,11 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { userRoleSchema } from "@cnode/shared";
-import { canRunJobBulkModerationAction, canRunPermanentTopicDelete, canRunTopicAction, normalizePermanentTopicDeleteIds } from "../src/lib/admin-governance";
+import {
+  canRunJobBulkModerationAction,
+  canRunPermanentTopicDelete,
+  canRunTopicAction,
+  normalizePermanentTopicDeleteIds,
+} from "../src/lib/admin-governance";
 import { canPostJobFromRoles } from "../src/routes/topic";
 
 test("job posting requires admin or recruiter", () => {
@@ -41,5 +46,8 @@ test("permanent topic delete ids are normalized and capped", () => {
   expect(normalizePermanentTopicDeleteIds({ id: "12" })).toEqual([12]);
   expect(normalizePermanentTopicDeleteIds({ topic_id: 13 })).toEqual([13]);
   expect(normalizePermanentTopicDeleteIds({ ids: ["1", 0, -1, "bad", 2] })).toEqual([1, 2]);
-  expect(normalizePermanentTopicDeleteIds({ ids: Array.from({ length: 30 }, (_, index) => index + 1) }).length).toBe(20);
+  expect(
+    normalizePermanentTopicDeleteIds({ ids: Array.from({ length: 30 }, (_, index) => index + 1) })
+      .length,
+  ).toBe(20);
 });
diff --git a/apps/api/test/rss-source.test.ts b/apps/api/test/rss-source.test.ts
index 1091cd7..faf8f57 100644
--- a/apps/api/test/rss-source.test.ts
+++ b/apps/api/test/rss-source.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { toRssPubDate, topicUrl } from "../src/routes/feed";
 
 test("rss source builds canonical topic URLs", () => {
diff --git a/apps/api/test/runtime-config.test.ts b/apps/api/test/runtime-config.test.ts
index a339961..1eb0c8a 100644
--- a/apps/api/test/runtime-config.test.ts
+++ b/apps/api/test/runtime-config.test.ts
@@ -1,15 +1,17 @@
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "vite-plus/test";
 import { parsePostgresConfig, parseRedisConfig } from "@cnode/shared";
 import { createRedisOptions } from "../src/lib/redis";
 
 describe("runtime resource config", () => {
   test("parses the namespaced PostgreSQL contract with one default port", () => {
-    expect(parsePostgresConfig({
-      POSTGRES_HOST: "postgres.internal",
-      POSTGRES_DB: "cnode",
-      POSTGRES_USER: "cnode",
-      POSTGRES_PASSWORD: "postgres-secret",
-    })).toEqual({
+    expect(
+      parsePostgresConfig({
+        POSTGRES_HOST: "postgres.internal",
+        POSTGRES_DB: "cnode",
+        POSTGRES_USER: "cnode",
+        POSTGRES_PASSWORD: "postgres-secret",
+      }),
+    ).toEqual({
       host: "postgres.internal",
       port: 5432,
       database: "cnode",
@@ -20,12 +22,14 @@ describe("runtime resource config", () => {
 
   test("rejects legacy-only PostgreSQL variables without exposing their values", () => {
     const legacySecret = "legacy-postgres-secret";
-    expect(() => parsePostgresConfig({
-      DB_HOST: "legacy.internal",
-      DB_NAME: "cnode",
-      DB_USER: "cnode",
-      DB_PASSWORD: legacySecret,
-    })).toThrow("POSTGRES_HOST is required");
+    expect(() =>
+      parsePostgresConfig({
+        DB_HOST: "legacy.internal",
+        DB_NAME: "cnode",
+        DB_USER: "cnode",
+        DB_PASSWORD: legacySecret,
+      }),
+    ).toThrow("POSTGRES_HOST is required");
 
     try {
       parsePostgresConfig({
@@ -41,13 +45,15 @@ describe("runtime resource config", () => {
   });
 
   test("rejects invalid PostgreSQL ports before connecting", () => {
-    expect(() => parsePostgresConfig({
-      POSTGRES_HOST: "postgres.internal",
-      POSTGRES_PORT: "70000",
-      POSTGRES_DB: "cnode",
-      POSTGRES_USER: "cnode",
-      POSTGRES_PASSWORD: "postgres-secret",
-    })).toThrow("POSTGRES_PORT must be an integer between 1 and 65535");
+    expect(() =>
+      parsePostgresConfig({
+        POSTGRES_HOST: "postgres.internal",
+        POSTGRES_PORT: "70000",
+        POSTGRES_DB: "cnode",
+        POSTGRES_USER: "cnode",
+        POSTGRES_PASSWORD: "postgres-secret",
+      }),
+    ).toThrow("POSTGRES_PORT must be an integer between 1 and 65535");
   });
 
   test("parses Redis defaults and maps the semantic database field for ioredis", () => {
@@ -68,11 +74,13 @@ describe("runtime resource config", () => {
 
   test("parses REDIS_DB and rejects invalid Redis config without exposing password", () => {
     const redisSecret = "redis-secret";
-    expect(parseRedisConfig({
-      REDIS_HOST: "redis.internal",
-      REDIS_DB: "3",
-      REDIS_PASSWORD: redisSecret,
-    }).database).toBe(3);
+    expect(
+      parseRedisConfig({
+        REDIS_HOST: "redis.internal",
+        REDIS_DB: "3",
+        REDIS_PASSWORD: redisSecret,
+      }).database,
+    ).toBe(3);
 
     try {
       parseRedisConfig({
diff --git a/apps/api/test/topic-edit-contract.test.ts b/apps/api/test/topic-edit-contract.test.ts
index bfdd1c9..d9038bd 100644
--- a/apps/api/test/topic-edit-contract.test.ts
+++ b/apps/api/test/topic-edit-contract.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "vite-plus/test";
 import { mdrenderQuerySchema, updateTopicBodySchema } from "@cnode/shared";
 import { renderMarkdown } from "../src/lib/markdown";
 
diff --git a/apps/api/test/topic-list-visibility.test.ts b/apps/api/test/topic-list-visibility.test.ts
index 156fae7..8759314 100644
--- a/apps/api/test/topic-list-visibility.test.ts
+++ b/apps/api/test/topic-list-visibility.test.ts
@@ -1,4 +1,4 @@
-import { expect, test } from "vitest";
+import { expect, test } from "vite-plus/test";
 import { buildTopicListQuery, shouldIncludeInternalTabsInTopicList } from "../src/routes/topic";
 
 test("public all topic list excludes internal tabs for admins too", () => {
@@ -14,16 +14,44 @@ test("internal tabs are only available when explicitly selected by admins", () =
 });
 
 test("topic list query keeps all and normal tab filters outside internal tabs", () => {
-  expect(buildTopicListQuery(undefined, false)).toMatchObject({ excludeTabs: ["job"], publicVisible: true, includeInternalTabs: false });
-  expect(buildTopicListQuery("all", true)).toMatchObject({ excludeTabs: ["job"], publicVisible: true, includeInternalTabs: false });
-  expect(buildTopicListQuery("share", true)).toMatchObject({ tab: "share", publicVisible: true, includeInternalTabs: false });
-  expect(buildTopicListQuery("ask", false)).toMatchObject({ tab: "ask", publicVisible: true, includeInternalTabs: false });
-  expect(buildTopicListQuery("good", true)).toMatchObject({ good: 1, publicVisible: true, includeInternalTabs: false });
+  expect(buildTopicListQuery(undefined, false)).toMatchObject({
+    excludeTabs: ["job"],
+    publicVisible: true,
+    includeInternalTabs: false,
+  });
+  expect(buildTopicListQuery("all", true)).toMatchObject({
+    excludeTabs: ["job"],
+    publicVisible: true,
+    includeInternalTabs: false,
+  });
+  expect(buildTopicListQuery("share", true)).toMatchObject({
+    tab: "share",
+    publicVisible: true,
+    includeInternalTabs: false,
+  });
+  expect(buildTopicListQuery("ask", false)).toMatchObject({
+    tab: "ask",
+    publicVisible: true,
+    includeInternalTabs: false,
+  });
+  expect(buildTopicListQuery("good", true)).toMatchObject({
+    good: 1,
+    publicVisible: true,
+    includeInternalTabs: false,
+  });
 });
 
 test("topic list query only allows explicit internal tabs for admins", () => {
   expect(buildTopicListQuery("dev", false)).toBeNull();
   expect(buildTopicListQuery("test", false)).toBeNull();
-  expect(buildTopicListQuery("dev", true)).toMatchObject({ tab: "dev", publicVisible: true, includeInternalTabs: true });
-  expect(buildTopicListQuery("test", true)).toMatchObject({ tab: "test", publicVisible: true, includeInternalTabs: true });
+  expect(buildTopicListQuery("dev", true)).toMatchObject({
+    tab: "dev",
+    publicVisible: true,
+    includeInternalTabs: true,
+  });
+  expect(buildTopicListQuery("test", true)).toMatchObject({
+    tab: "test",
+    publicVisible: true,
+    includeInternalTabs: true,
+  });
 });
diff --git a/apps/api/test/topic-reply-repair.test.ts b/apps/api/test/topic-reply-repair.test.ts
index a5e7c29..056d476 100644
--- a/apps/api/test/topic-reply-repair.test.ts
+++ b/apps/api/test/topic-reply-repair.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "vite-plus/test";
 import {
   repairTopicReplyAggregates,
   topicReplyRepairApplySql,
@@ -6,25 +6,39 @@ import {
   type TopicReplyRepairClient,
 } from "@cnode/db";
 
-type Topic = { id: number; replyCount: number; lastReplyId: number | null; lastReplyAt: Date | null };
+type Topic = {
+  id: number;
+  replyCount: number;
+  lastReplyId: number | null;
+  lastReplyAt: Date | null;
+};
 type Reply = { id: number; topicId: number; deleted: boolean; createAt: Date };
 
 class MemoryRepairClient implements TopicReplyRepairClient {
-  constructor(readonly topics: Topic[], readonly replies: Reply[]) {}
+  constructor(
+    readonly topics: Topic[],
+    readonly replies: Reply[],
+  ) {}
 
   private expected(topicId: number) {
     const active = this.replies
       .filter((reply) => reply.topicId === topicId && !reply.deleted)
       .sort((a, b) => b.createAt.getTime() - a.createAt.getTime() || b.id - a.id);
-    return { replyCount: active.length, lastReplyId: active[0]?.id ?? null, lastReplyAt: active[0]?.createAt ?? null };
+    return {
+      replyCount: active.length,
+      lastReplyId: active[0]?.id ?? null,
+      lastReplyAt: active[0]?.createAt ?? null,
+    };
   }
 
   private mismatches() {
     return this.topics.filter((topic) => {
       const expected = this.expected(topic.id);
-      return topic.replyCount !== expected.replyCount
-        || topic.lastReplyId !== expected.lastReplyId
-        || topic.lastReplyAt?.getTime() !== expected.lastReplyAt?.getTime();
+      return (
+        topic.replyCount !== expected.replyCount ||
+        topic.lastReplyId !== expected.lastReplyId ||
+        topic.lastReplyAt?.getTime() !== expected.lastReplyAt?.getTime()
+      );
     });
   }
 
@@ -60,8 +74,14 @@ describe("topic reply aggregate repair", () => {
     const users = [{ id: 9, score: 100, replyCount: 99 }];
     const client = new MemoryRepairClient(topics, replies);
 
-    expect(await repairTopicReplyAggregates(client, true)).toMatchObject({ mode: "dry-run", mismatchedTopics: 3 });
-    expect(await repairTopicReplyAggregates(client, false)).toMatchObject({ mode: "apply", repairedTopics: 3 });
+    expect(await repairTopicReplyAggregates(client, true)).toMatchObject({
+      mode: "dry-run",
+      mismatchedTopics: 3,
+    });
+    expect(await repairTopicReplyAggregates(client, false)).toMatchObject({
+      mode: "apply",
+      repairedTopics: 3,
+    });
     expect(topics).toEqual([
       { id: 1, replyCount: 0, lastReplyId: null, lastReplyAt: null },
       { id: 2, replyCount: 1, lastReplyId: 21, lastReplyAt: new Date("2026-02-01") },
diff --git a/apps/api/test/user-detail-contract.test.ts b/apps/api/test/user-detail-contract.test.ts
index b9106c5..d2fa18c 100644
--- a/apps/api/test/user-detail-contract.test.ts
+++ b/apps/api/test/user-detail-contract.test.ts
@@ -1,4 +1,4 @@
-import { afterEach, expect, test, vi } from "vitest";
+import { afterEach, expect, test, vi } from "vite-plus/test";
 import { userDetailSchema } from "@cnode/shared";
 import app from "../src/app";
 import { replyQueries, roleQueries, topicQueries, userQueries } from "../src/lib/db";
@@ -81,6 +81,13 @@ test("GET /api/v1/user/:loginname normalizes blank public fields and keeps gover
   const response = await app.request("/api/v1/user/bob");
   const body = await response.json();
 
-  expect(body.data).toMatchObject({ location: null, url: null, signature: null, identities: [], is_block: true, is_muted: false });
+  expect(body.data).toMatchObject({
+    location: null,
+    url: null,
+    signature: null,
+    identities: [],
+    is_block: true,
+    is_muted: false,
+  });
   expect(userDetailSchema.safeParse(body.data).success).toBe(true);
 });
diff --git a/apps/api/vitest.config.ts b/apps/api/vitest.config.ts
index 7c52ed6..6d1520d 100644
--- a/apps/api/vitest.config.ts
+++ b/apps/api/vitest.config.ts
@@ -1,4 +1,4 @@
-import { defineConfig } from "vitest/config";
+import { defineConfig } from "vite-plus";
 
 export default defineConfig({
   test: {
diff --git a/apps/web/app/components/AdminLayout.tsx b/apps/web/app/components/AdminLayout.tsx
index 4a4f287..82bdfe9 100644
--- a/apps/web/app/components/AdminLayout.tsx
+++ b/apps/web/app/components/AdminLayout.tsx
@@ -51,15 +51,11 @@ const NAV_GROUPS = [
   },
   {
     label: "审计",
-    items: [
-      { href: "/admin/audit", icon: ScrollText, label: "审计日志", adminOnly: true },
-    ],
+    items: [{ href: "/admin/audit", icon: ScrollText, label: "审计日志", adminOnly: true }],
   },
   {
     label: "系统",
-    items: [
-      { href: "/admin/settings", icon: Settings, label: "系统设置", adminOnly: true },
-    ],
+    items: [{ href: "/admin/settings", icon: Settings, label: "系统设置", adminOnly: true }],
   },
 ];
 
@@ -83,7 +79,9 @@ export function AdminLayout({ children }: { children: React.ReactNode }) {
           <div className="flex min-w-0 items-center gap-3">
             <div className="md:hidden">
               <Sheet>
-                <SheetTrigger render={<Button variant="ghost" size="icon" aria-label="打开后台导航" />}>
+                <SheetTrigger
+                  render={<Button variant="ghost" size="icon" aria-label="打开后台导航" />}
+                >
                   <Menu />
                 </SheetTrigger>
                 <SheetContent side="left" className="w-72 max-w-[calc(100%-2rem)]">
@@ -96,38 +94,38 @@ export function AdminLayout({ children }: { children: React.ReactNode }) {
             </div>
             <CNodeLogo admin />
             <Button
-                type="button"
-                variant="secondary"
-                className="hidden w-64 justify-start lg:inline-flex"
-                onClick={(event) => {
-                  commandFinalFocusRef.current = event.currentTarget;
-                  setCommandOpen(true);
-                }}
-                aria-label="搜索后台内容"
-              >
-                <Search />
-                <span className="min-w-0 flex-1 truncate text-left">搜索后台内容...</span>
-                <kbd className="text-xs text-muted-foreground">⌘K</kbd>
-              </Button>
+              type="button"
+              variant="secondary"
+              className="hidden w-64 justify-start lg:inline-flex"
+              onClick={(event) => {
+                commandFinalFocusRef.current = event.currentTarget;
+                setCommandOpen(true);
+              }}
+              aria-label="搜索后台内容"
+            >
+              <Search />
+              <span className="min-w-0 flex-1 truncate text-left">搜索后台内容...</span>
+              <kbd className="text-xs text-muted-foreground">⌘K</kbd>
+            </Button>
             <AdminTopNavigation isAdmin={isAdmin} />
           </div>
 
           <div className="flex items-center gap-2 md:gap-3">
-              <Button
-                type="button"
-                variant="ghost"
-                size="icon"
-                className="lg:hidden"
-                onClick={(event) => {
-                  commandFinalFocusRef.current = event.currentTarget;
-                  setCommandOpen(true);
-                }}
-                aria-label="搜索后台"
-              >
-                <Search />
-              </Button>
-              <ThemeToggle />
-              <HeaderUserArea />
+            <Button
+              type="button"
+              variant="ghost"
+              size="icon"
+              className="lg:hidden"
+              onClick={(event) => {
+                commandFinalFocusRef.current = event.currentTarget;
+                setCommandOpen(true);
+              }}
+              aria-label="搜索后台"
+            >
+              <Search />
+            </Button>
+            <ThemeToggle />
+            <HeaderUserArea />
           </div>
         </PageContainer>
         <CommandPalette
@@ -174,21 +172,24 @@ function AdminNavigation({ isAdmin }: { isAdmin: boolean }) {
         <div key={group.label} className="flex flex-col gap-1">
           <p className="px-2 text-xs font-medium text-muted-foreground">{group.label}</p>
           <div className="flex flex-col gap-1">
-              {group.items.map(({ href, icon: Icon, label }) => {
-                const active = pathname === href || (href !== "/admin" && pathname.startsWith(href));
+            {group.items.map(({ href, icon: Icon, label }) => {
+              const active = pathname === href || (href !== "/admin" && pathname.startsWith(href));
 
-                return (
-                  <Link
-                    key={href}
-                    to={href}
-                    aria-current={active ? "page" : undefined}
-                    className={cn(buttonVariants({ variant: active ? "default" : "ghost", size: "sm" }), "w-full justify-start")}
-                  >
-                    <Icon data-icon="inline-start" />
-                    <span>{label}</span>
-                  </Link>
-                );
-              })}
+              return (
+                <Link
+                  key={href}
+                  to={href}
+                  aria-current={active ? "page" : undefined}
+                  className={cn(
+                    buttonVariants({ variant: active ? "default" : "ghost", size: "sm" }),
+                    "w-full justify-start",
+                  )}
+                >
+                  <Icon data-icon="inline-start" />
+                  <span>{label}</span>
+                </Link>
+              );
+            })}
           </div>
         </div>
       ))}
@@ -203,7 +204,10 @@ function AdminTopNavigation({ isAdmin }: { isAdmin: boolean }) {
     <nav aria-label="后台分区" className="hidden items-center gap-1 xl:flex">
       {visibleGroups(isAdmin).map((group) => {
         const href = group.items[0].href;
-        const active = group.items.some((item) => pathname === item.href || (item.href !== "/admin" && pathname.startsWith(item.href)));
+        const active = group.items.some(
+          (item) =>
+            pathname === item.href || (item.href !== "/admin" && pathname.startsWith(item.href)),
+        );
         return (
           <Link
             key={group.label}
diff --git a/apps/web/app/components/AdminPage.tsx b/apps/web/app/components/AdminPage.tsx
index f5d76da..c6d579a 100644
--- a/apps/web/app/components/AdminPage.tsx
+++ b/apps/web/app/components/AdminPage.tsx
@@ -4,8 +4,20 @@ import { PageHeader } from "./PageShell";
 import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "./ui/card";
 import { Link } from "react-router";
 
-export function AdminPage({ children, className, archetype = "data-list" }: { children: React.ReactNode; className?: string; archetype?: "dashboard" | "data-list" | "workflow" }) {
-  return <div data-page-archetype={archetype} className={cn("flex flex-col gap-4", className)}>{children}</div>;
+export function AdminPage({
+  children,
+  className,
+  archetype = "data-list",
+}: {
+  children: React.ReactNode;
+  className?: string;
+  archetype?: "dashboard" | "data-list" | "workflow";
+}) {
+  return (
+    <div data-page-archetype={archetype} className={cn("flex flex-col gap-4", className)}>
+      {children}
+    </div>
+  );
 }
 
 export function AdminPageHeader({
@@ -19,7 +31,11 @@ export function AdminPageHeader({
 }) {
   return (
     <PageHeader
-      breadcrumbs={title === "管理概览" ? [{ label: "管理后台" }] : [{ label: "管理后台", to: "/admin" }, { label: title }]}
+      breadcrumbs={
+        title === "管理概览"
+          ? [{ label: "管理后台" }]
+          : [{ label: "管理后台", to: "/admin" }, { label: title }]
+      }
       title={title}
       description={description}
       action={action}
@@ -60,15 +76,34 @@ export function AdminPanel({
   );
 }
 
-export function AdminToolbar({ children, className }: { children: React.ReactNode; className?: string }) {
+export function AdminToolbar({
+  children,
+  className,
+}: {
+  children: React.ReactNode;
+  className?: string;
+}) {
   return (
-    <div className={cn("flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between", className)}>
+    <div
+      className={cn(
+        "flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between",
+        className,
+      )}
+    >
       {children}
     </div>
   );
 }
 
-export function AdminMetricCard({ label, value, href }: { label: string; value: React.ReactNode; href?: string }) {
+export function AdminMetricCard({
+  label,
+  value,
+  href,
+}: {
+  label: string;
+  value: React.ReactNode;
+  href?: string;
+}) {
   const card = (
     <Card size="sm">
       <CardHeader>
diff --git a/apps/web/app/components/AuthShell.tsx b/apps/web/app/components/AuthShell.tsx
index e7032a0..231429a 100644
--- a/apps/web/app/components/AuthShell.tsx
+++ b/apps/web/app/components/AuthShell.tsx
@@ -20,7 +20,9 @@ export function AuthShell({
           <div>
             <p className="text-sm font-semibold tracking-[0.2em] text-brand-accent">{eyebrow}</p>
             <div className="mt-4 max-w-md text-4xl font-bold tracking-tight">{title}</div>
-            <p className="mt-4 max-w-md text-sm leading-6 text-brand-foreground/70">{description}</p>
+            <p className="mt-4 max-w-md text-sm leading-6 text-brand-foreground/70">
+              {description}
+            </p>
           </div>
         </div>
         <div className="relative grid gap-3 text-sm text-brand-foreground/80">
@@ -43,7 +45,9 @@ export function AuthShell({
         </div>
         <div className="mb-6 lg:hidden">
           <p className="text-xs font-semibold tracking-[0.2em] text-primary">{eyebrow}</p>
-          <h1 className="mt-2 text-2xl font-bold tracking-tight text-foreground lg:sr-only">{title}</h1>
+          <h1 className="mt-2 text-2xl font-bold tracking-tight text-foreground lg:sr-only">
+            {title}
+          </h1>
           <p className="mt-2 text-sm leading-6 text-muted-foreground">{description}</p>
         </div>
         <div className="rounded-xl bg-card p-5 shadow-sm sm:p-6">{children}</div>
diff --git a/apps/web/app/components/CNodeLogo.tsx b/apps/web/app/components/CNodeLogo.tsx
index 0c9801a..5c89c8f 100644
--- a/apps/web/app/components/CNodeLogo.tsx
+++ b/apps/web/app/components/CNodeLogo.tsx
@@ -20,13 +20,29 @@ export function CNodeLogo({ to = "/", admin = false, compact = false, className
       <span className="inline-flex h-10 items-start pt-[3px]">
         {compact ? (
           <>
-            <img src={CNODE_LOGO_DARK} alt="CNode" className="block h-7 w-auto max-w-[88px] dark:hidden" />
-            <img src={CNODE_LOGO_LIGHT} alt="CNode" className="hidden h-7 w-auto max-w-[88px] dark:block" />
+            <img
+              src={CNODE_LOGO_DARK}
+              alt="CNode"
+              className="block h-7 w-auto max-w-[88px] dark:hidden"
+            />
+            <img
+              src={CNODE_LOGO_LIGHT}
+              alt="CNode"
+              className="hidden h-7 w-auto max-w-[88px] dark:block"
+            />
           </>
         ) : (
           <>
-            <img src={CNODE_LOGO_DARK} alt="CNode" className="block h-7 w-auto min-w-[118px] dark:hidden" />
-            <img src={CNODE_LOGO_LIGHT} alt="CNode" className="hidden h-7 w-auto min-w-[118px] dark:block" />
+            <img
+              src={CNODE_LOGO_DARK}
+              alt="CNode"
+              className="block h-7 w-auto min-w-[118px] dark:hidden"
+            />
+            <img
+              src={CNODE_LOGO_LIGHT}
+              alt="CNode"
+              className="hidden h-7 w-auto min-w-[118px] dark:block"
+            />
           </>
         )}
       </span>
diff --git a/apps/web/app/components/CommandPalette.tsx b/apps/web/app/components/CommandPalette.tsx
index 5c359c1..48abefd 100644
--- a/apps/web/app/components/CommandPalette.tsx
+++ b/apps/web/app/components/CommandPalette.tsx
@@ -1,15 +1,15 @@
 import { useEffect, useRef, useState, type RefObject } from "react";
 import { useNavigate, useRouteLoaderData } from "react-router";
-import {
-  FileText,
-  Info,
-  LayoutDashboard,
-  MessageSquare,
-  Pencil,
-  X,
-} from "lucide-react";
+import { FileText, Info, LayoutDashboard, MessageSquare, Pencil, X } from "lucide-react";
 import { Button } from "./ui/button";
-import { Dialog, DialogClose, DialogContent, DialogDescription, DialogHeader, DialogTitle } from "./ui/dialog";
+import {
+  Dialog,
+  DialogClose,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "./ui/dialog";
 import {
   Command,
   CommandEmpty,
@@ -39,7 +39,9 @@ export function CommandPalette({
   const fallbackFinalFocusRef = useRef<HTMLElement | null>(null);
   const finalFocusRef = finalFocus ?? fallbackFinalFocusRef;
   const navigate = useNavigate();
-  const rootData = useRouteLoaderData("root") as { user?: { is_admin?: boolean; is_mod?: boolean } } | undefined;
+  const rootData = useRouteLoaderData("root") as
+    | { user?: { is_admin?: boolean; is_mod?: boolean } }
+    | undefined;
   const managementAction = rootData?.user?.is_admin
     ? { label: "管理后台", to: "/admin", icon: LayoutDashboard }
     : rootData?.user?.is_mod
@@ -102,7 +104,14 @@ export function CommandPalette({
               />
             </form>
             <DialogClose
-              render={<Button type="button" variant="ghost" size="icon-sm" className="size-11 shrink-0 sm:size-8" />}
+              render={
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="icon-sm"
+                  className="size-11 shrink-0 sm:size-8"
+                />
+              }
               aria-label="关闭搜索面板"
             >
               <X />
@@ -122,7 +131,9 @@ export function CommandPalette({
             </CommandGroup>
           </CommandList>
           <div className="bg-muted p-2 text-xs text-muted-foreground">
-            {query.trim() ? `按 Enter 搜索“${query.trim()}”` : "使用方向键选择，Enter 打开，Escape 关闭"}
+            {query.trim()
+              ? `按 Enter 搜索“${query.trim()}”`
+              : "使用方向键选择，Enter 打开，Escape 关闭"}
           </div>
         </Command>
       </DialogContent>
diff --git a/apps/web/app/components/Form.tsx b/apps/web/app/components/Form.tsx
index 024d721..3872771 100644
--- a/apps/web/app/components/Form.tsx
+++ b/apps/web/app/components/Form.tsx
@@ -9,12 +9,7 @@ import {
   type FieldPath,
   type FieldValues,
 } from "react-hook-form";
-import {
-  Field,
-  FieldDescription,
-  FieldError,
-  FieldLabel,
-} from "~/components/ui/field";
+import { Field, FieldDescription, FieldError, FieldLabel } from "~/components/ui/field";
 
 const Form = FormProvider;
 
@@ -90,36 +85,28 @@ FormItemBody.displayName = "FormItemBody";
 
 const FormLabel = React.forwardRef<HTMLLabelElement, React.ComponentPropsWithoutRef<"label">>(
   ({ className, ...props }, ref) => {
-  const { formItemId } = useFormField();
-  return (
-    <FieldLabel
-      ref={ref}
-      className={className}
-      htmlFor={formItemId}
-      {...props}
-    />
-  );
-});
+    const { formItemId } = useFormField();
+    return <FieldLabel ref={ref} className={className} htmlFor={formItemId} {...props} />;
+  },
+);
 FormLabel.displayName = "FormLabel";
 
 const FormControl = React.forwardRef<HTMLElement, useRender.ComponentProps<"div">>(
   ({ render, ...props }, ref) => {
-  const { error, formItemId, formDescriptionId, formMessageId } = useFormField();
-  return useRender({
-    defaultTagName: "div",
-    render,
-    ref,
-    props: mergeProps<"div">(
-      {
-        id: formItemId,
-        "aria-describedby": !error
-          ? formDescriptionId
-          : `${formDescriptionId} ${formMessageId}`,
-        "aria-invalid": !!error,
-      },
-      props,
-    ),
-  });
+    const { error, formItemId, formDescriptionId, formMessageId } = useFormField();
+    return useRender({
+      defaultTagName: "div",
+      render,
+      ref,
+      props: mergeProps<"div">(
+        {
+          id: formItemId,
+          "aria-describedby": !error ? formDescriptionId : `${formDescriptionId} ${formMessageId}`,
+          "aria-invalid": !!error,
+        },
+        props,
+      ),
+    });
   },
 );
 FormControl.displayName = "FormControl";
@@ -129,14 +116,7 @@ const FormDescription = React.forwardRef<
   React.HTMLAttributes<HTMLParagraphElement>
 >(({ className, ...props }, ref) => {
   const { formDescriptionId } = useFormField();
-  return (
-    <FieldDescription
-      ref={ref}
-      id={formDescriptionId}
-      className={className}
-      {...props}
-    />
-  );
+  return <FieldDescription ref={ref} id={formDescriptionId} className={className} {...props} />;
 });
 FormDescription.displayName = "FormDescription";
 
@@ -148,12 +128,7 @@ const FormMessage = React.forwardRef<
   const body = error ? String(error?.message ?? "") : children;
   if (!body) return null;
   return (
-    <FieldError
-      ref={ref}
-      id={formMessageId}
-      className={className}
-      {...props}
-    >
+    <FieldError ref={ref} id={formMessageId} className={className} {...props}>
       {body}
     </FieldError>
   );
diff --git a/apps/web/app/components/JobCardGrid.tsx b/apps/web/app/components/JobCardGrid.tsx
index 6cbb465..1905eb9 100644
--- a/apps/web/app/components/JobCardGrid.tsx
+++ b/apps/web/app/components/JobCardGrid.tsx
@@ -68,9 +68,7 @@ function JobCardItem({ job }: { job: JobCardData }) {
               )}
             </Avatar>
             <div className="min-w-0 flex-1">
-              <p className="truncate text-sm font-semibold text-foreground">
-                {job.company}
-              </p>
+              <p className="truncate text-sm font-semibold text-foreground">{job.company}</p>
               <p className="truncate text-xs text-muted-foreground">{job.position}</p>
             </div>
           </div>
@@ -99,9 +97,7 @@ function JobCardItem({ job }: { job: JobCardData }) {
             </div>
           )}
 
-          <p className="line-clamp-2 text-xs leading-4 text-muted-foreground">
-            {job.excerpt}
-          </p>
+          <p className="line-clamp-2 text-xs leading-4 text-muted-foreground">{job.excerpt}</p>
 
           <div className="flex items-center gap-3 text-xs text-muted-foreground">
             <span className="flex items-center gap-1">
diff --git a/apps/web/app/components/JobFilterBar.tsx b/apps/web/app/components/JobFilterBar.tsx
index 0970c6a..4db5e08 100644
--- a/apps/web/app/components/JobFilterBar.tsx
+++ b/apps/web/app/components/JobFilterBar.tsx
@@ -43,7 +43,9 @@ export function JobFilterBar({ locations }: JobFilterBarProps) {
   const filterControls = (
     <div className="grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
       <div className="flex flex-col gap-1.5">
-        <Label htmlFor="job-location-filter" className="text-xs">地点</Label>
+        <Label htmlFor="job-location-filter" className="text-xs">
+          地点
+        </Label>
         <NativeSelect
           id="job-location-filter"
           className="w-full"
@@ -60,7 +62,9 @@ export function JobFilterBar({ locations }: JobFilterBarProps) {
       </div>
 
       <div className="flex flex-col gap-1.5">
-        <Label htmlFor="job-remote-filter" className="text-xs">远程</Label>
+        <Label htmlFor="job-remote-filter" className="text-xs">
+          远程
+        </Label>
         <NativeSelect
           id="job-remote-filter"
           className="w-full"
@@ -77,7 +81,9 @@ export function JobFilterBar({ locations }: JobFilterBarProps) {
       </div>
 
       <div className="flex flex-col gap-1.5">
-        <Label htmlFor="job-salary-filter" className="text-xs">薪资下限 (K)</Label>
+        <Label htmlFor="job-salary-filter" className="text-xs">
+          薪资下限 (K)
+        </Label>
         <Input
           id="job-salary-filter"
           name="salary_min"
@@ -90,7 +96,9 @@ export function JobFilterBar({ locations }: JobFilterBarProps) {
       </div>
 
       <div className="flex flex-col gap-1.5">
-        <Label htmlFor="job-tags-filter" className="text-xs">技术栈</Label>
+        <Label htmlFor="job-tags-filter" className="text-xs">
+          技术栈
+        </Label>
         <Input
           id="job-tags-filter"
           name="tags"
@@ -111,7 +119,9 @@ export function JobFilterBar({ locations }: JobFilterBarProps) {
             <div className="flex items-center gap-2 font-semibold text-foreground">
               <Filter className="h-4 w-4 text-primary" /> 筛选职位
             </div>
-            <p className="mt-1 text-xs text-muted-foreground">按地点、办公方式、薪资和技术栈缩小结果范围</p>
+            <p className="mt-1 text-xs text-muted-foreground">
+              按地点、办公方式、薪资和技术栈缩小结果范围
+            </p>
           </div>
           {activeFilterCount > 0 && (
             <Button type="button" variant="ghost" size="sm" onClick={clearAll}>
diff --git a/apps/web/app/components/JobMetaForm.tsx b/apps/web/app/components/JobMetaForm.tsx
index b1cf8b0..10c7c8d 100644
--- a/apps/web/app/components/JobMetaForm.tsx
+++ b/apps/web/app/components/JobMetaForm.tsx
@@ -68,7 +68,10 @@ export function JobMetaForm({ value, onChange }: JobMetaFormProps) {
 
   function removeTag(tag: string) {
     const tags = value.tech_tags || [];
-    update("tech_tags", tags.filter((t) => t !== tag));
+    update(
+      "tech_tags",
+      tags.filter((t) => t !== tag),
+    );
   }
 
   return (
@@ -140,8 +143,16 @@ export function JobMetaForm({ value, onChange }: JobMetaFormProps) {
               )}
             </Button>
           </div>
-          {uploadError && <p role="alert" className="text-xs text-destructive">{uploadError}</p>}
-          {uploadSuccess && <p role="status" className="text-xs text-muted-foreground">公司 Logo 上传成功</p>}
+          {uploadError && (
+            <p role="alert" className="text-xs text-destructive">
+              {uploadError}
+            </p>
+          )}
+          {uploadSuccess && (
+            <p role="status" className="text-xs text-muted-foreground">
+              公司 Logo 上传成功
+            </p>
+          )}
         </div>
 
         <div className="flex flex-col gap-2">
@@ -159,10 +170,10 @@ export function JobMetaForm({ value, onChange }: JobMetaFormProps) {
         <div className="grid grid-cols-2 gap-3">
           <div className="flex flex-col gap-2">
             <Label htmlFor="location">地点 *</Label>
-              <Input
-                id="location"
-                name="location"
-                autoComplete="address-level2"
+            <Input
+              id="location"
+              name="location"
+              autoComplete="address-level2"
               value={value.location}
               onChange={(e) => update("location", e.target.value)}
               placeholder="如：上海"
diff --git a/apps/web/app/components/Layout.tsx b/apps/web/app/components/Layout.tsx
index cdde1aa..4d990fa 100644
--- a/apps/web/app/components/Layout.tsx
+++ b/apps/web/app/components/Layout.tsx
@@ -47,7 +47,14 @@ export function Layout({ children }: { children: React.ReactNode }) {
         跳到主要内容
       </a>
       <Header />
-      <main id="main-content" tabIndex={-1} className={cn("flex-1 transition-opacity duration-200", isNavigating ? "opacity-60" : "opacity-100")}>
+      <main
+        id="main-content"
+        tabIndex={-1}
+        className={cn(
+          "flex-1 transition-opacity duration-200",
+          isNavigating ? "opacity-60" : "opacity-100",
+        )}
+      >
         <PageContainer className="py-6">{children}</PageContainer>
       </main>
       <Footer />
@@ -60,7 +67,9 @@ export function Header() {
   const [commandOpen, setCommandOpen] = useState(false);
   const commandFinalFocusRef = useRef<HTMLElement | null>(null);
   const rootData = useRouteLoaderData("root") as { zones?: any[]; tabs?: any[] } | undefined;
-  const visibleZones = (rootData?.zones || []).filter((z: any) => z.visible).sort((a: any, b: any) => a.sort_order - b.sort_order);
+  const visibleZones = (rootData?.zones || [])
+    .filter((z: any) => z.visible)
+    .sort((a: any, b: any) => a.sort_order - b.sort_order);
 
   return (
     <header className="sticky top-0 z-40 bg-background/90 shadow-sm backdrop-blur-xl">
@@ -194,18 +203,17 @@ export function HeaderUserArea() {
       </Button>
       <DropdownMenu>
         <DropdownMenuTrigger
-          render={<Button
-            variant="ghost"
-            size="icon"
-            className="h-9 w-9 rounded-full p-0"
-            aria-label="用户菜单"
-          />}
+          render={
+            <Button
+              variant="ghost"
+              size="icon"
+              className="h-9 w-9 rounded-full p-0"
+              aria-label="用户菜单"
+            />
+          }
         >
           <Avatar className="size-7">
-            <AvatarImage
-              src={getAvatarUrl(user.avatar_url, 32)}
-              alt={user.loginname}
-            />
+            <AvatarImage src={getAvatarUrl(user.avatar_url, 32)} alt={user.loginname} />
             <AvatarFallback>{getAvatarFallback(user.loginname)}</AvatarFallback>
           </Avatar>
         </DropdownMenuTrigger>
@@ -213,16 +221,11 @@ export function HeaderUserArea() {
           <DropdownMenuGroup>
             <DropdownMenuLabel className="mb-1 flex items-center gap-2 rounded-lg bg-muted px-2 py-2 font-normal">
               <Avatar className="size-8">
-                <AvatarImage
-                  src={getAvatarUrl(user.avatar_url, 32)}
-                  alt={user.loginname}
-                />
+                <AvatarImage src={getAvatarUrl(user.avatar_url, 32)} alt={user.loginname} />
                 <AvatarFallback>{getAvatarFallback(user.loginname)}</AvatarFallback>
               </Avatar>
               <div className="min-w-0">
-                <div className="truncate text-sm font-medium text-foreground">
-                  {user.loginname}
-                </div>
+                <div className="truncate text-sm font-medium text-foreground">{user.loginname}</div>
                 <div className="text-xs text-muted-foreground">已登录</div>
               </div>
             </DropdownMenuLabel>
@@ -273,7 +276,10 @@ function MobileNavTrigger({ visibleZones = [] }: { visibleZones?: any[] }) {
         <SheetTrigger render={<Button variant="ghost" size="icon" aria-label="打开导航" />}>
           <Menu className="h-5 w-5" />
         </SheetTrigger>
-        <SheetContent side="bottom" className="max-h-[82vh] overflow-y-auto pb-[calc(env(safe-area-inset-bottom)+1rem)]">
+        <SheetContent
+          side="bottom"
+          className="max-h-[82vh] overflow-y-auto pb-[calc(env(safe-area-inset-bottom)+1rem)]"
+        >
           <SheetHeader className="text-left">
             <SheetTitle>导航</SheetTitle>
           </SheetHeader>
@@ -336,7 +342,8 @@ function MobileNavTrigger({ visibleZones = [] }: { visibleZones?: any[] }) {
                     to={user.is_admin ? "/admin" : "/admin/topics"}
                     className="col-span-2 flex min-h-12 items-center gap-3 rounded-xl bg-muted px-3 text-sm text-foreground transition-colors hover:bg-accent"
                   >
-                    <Shield className="h-5 w-5 text-primary" /> {user.is_admin ? "管理后台" : "内容管理"}
+                    <Shield className="h-5 w-5 text-primary" />{" "}
+                    {user.is_admin ? "管理后台" : "内容管理"}
                   </Link>
                 )}
               </>
@@ -375,11 +382,7 @@ export function Footer() {
                   <Button render={<Link to="/topic/create" />} size="sm">
                     发布话题
                   </Button>
-                  <Button
-                    render={<Link to="/about" />}
-                    variant="secondary"
-                    size="sm"
-                  >
+                  <Button render={<Link to="/about" />} variant="secondary" size="sm">
                     了解社区
                   </Button>
                 </div>
@@ -423,9 +426,7 @@ export function Footer() {
       <div>
         <PageContainer className="flex flex-col gap-2 py-4 text-xs text-muted-foreground sm:flex-row sm:items-center sm:justify-between">
           <p>© {new Date().getFullYear()} CNode Next. Node.js 中文技术社区。</p>
-          <p>
-            Inspired by CNode 社区，内容版权归原作者所有。
-          </p>
+          <p>Inspired by CNode 社区，内容版权归原作者所有。</p>
         </PageContainer>
       </div>
     </footer>
diff --git a/apps/web/app/components/MarkdownEditor.tsx b/apps/web/app/components/MarkdownEditor.tsx
index 8eedcf0..fcc95b7 100644
--- a/apps/web/app/components/MarkdownEditor.tsx
+++ b/apps/web/app/components/MarkdownEditor.tsx
@@ -53,7 +53,7 @@ export function MarkdownEditor({
   useEffect(() => {
     const query = window.matchMedia("(min-width: 64rem)");
     const syncMode = () => {
-      if (!query.matches) setMode((current) => current === "split" ? "edit" : current);
+      if (!query.matches) setMode((current) => (current === "split" ? "edit" : current));
     };
     syncMode();
     query.addEventListener("change", syncMode);
@@ -83,12 +83,7 @@ export function MarkdownEditor({
     const start = textarea.selectionStart;
     const end = textarea.selectionEnd;
     const selected = value.slice(start, end) || fallback;
-    const newValue =
-      value.slice(0, start) +
-      before +
-      selected +
-      after +
-      value.slice(end);
+    const newValue = value.slice(0, start) + before + selected + after + value.slice(end);
     updateValue(newValue, start + before.length, start + before.length + selected.length);
   }
 
@@ -99,7 +94,11 @@ export function MarkdownEditor({
     const end = textarea.selectionEnd;
     const selected = value.slice(start, end) || "链接文字";
     const markdown = `[${selected}](url)`;
-    updateValue(value.slice(0, start) + markdown + value.slice(end), start + 1, start + 1 + selected.length);
+    updateValue(
+      value.slice(0, start) + markdown + value.slice(end),
+      start + 1,
+      start + 1 + selected.length,
+    );
   }
 
   function insertImagePlaceholder() {
@@ -129,7 +128,11 @@ export function MarkdownEditor({
       .split("\n")
       .map((line) => (line.startsWith(prefix) ? line : `${prefix}${line || "内容"}`))
       .join("\n");
-    updateValue(value.slice(0, lineStart) + replacement + value.slice(end), lineStart, lineStart + replacement.length);
+    updateValue(
+      value.slice(0, lineStart) + replacement + value.slice(end),
+      lineStart,
+      lineStart + replacement.length,
+    );
   }
 
   async function uploadFiles(files: FileList | File[]) {
@@ -150,14 +153,18 @@ export function MarkdownEditor({
   }
 
   function handlePaste(event: ClipboardEvent<HTMLTextAreaElement>) {
-    const files = Array.from(event.clipboardData.files).filter((file) => file.type.startsWith("image/"));
+    const files = Array.from(event.clipboardData.files).filter((file) =>
+      file.type.startsWith("image/"),
+    );
     if (!files.length) return;
     event.preventDefault();
     void uploadFiles(files);
   }
 
   function handleDrop(event: DragEvent<HTMLTextAreaElement>) {
-    const files = Array.from(event.dataTransfer.files).filter((file) => file.type.startsWith("image/"));
+    const files = Array.from(event.dataTransfer.files).filter((file) =>
+      file.type.startsWith("image/"),
+    );
     setIsDragging(false);
     if (!files.length) return;
     event.preventDefault();
@@ -195,10 +202,7 @@ export function MarkdownEditor({
       placeholder={placeholder || "支持 Markdown 格式"}
       aria-label={placeholder || "支持 Markdown 格式"}
       style={{ minHeight }}
-      className={cn(
-        "resize-y",
-        isDragging && "ring-2 ring-ring",
-      )}
+      className={cn("resize-y", isDragging && "ring-2 ring-ring")}
     />
   );
   const preview = (
@@ -237,24 +241,57 @@ export function MarkdownEditor({
         />
         <div className="flex-1" />
         {uploading ? (
-          <span role="status" className="inline-flex items-center gap-1 px-2 text-xs text-muted-foreground">
+          <span
+            role="status"
+            className="inline-flex items-center gap-1 px-2 text-xs text-muted-foreground"
+          >
             <Spinner /> 上传中
           </span>
         ) : null}
         <div className="flex items-center gap-1" role="group" aria-label="编辑器视图">
-          <Button type="button" variant={mode === "edit" ? "secondary" : "ghost"} size="sm" onClick={() => setMode("edit")}>
+          <Button
+            type="button"
+            variant={mode === "edit" ? "secondary" : "ghost"}
+            size="sm"
+            onClick={() => setMode("edit")}
+          >
             <Pencil data-icon="inline-start" /> 编辑
           </Button>
-          <Button type="button" variant={mode === "preview" ? "secondary" : "ghost"} size="sm" onClick={() => setMode("preview")}>
+          <Button
+            type="button"
+            variant={mode === "preview" ? "secondary" : "ghost"}
+            size="sm"
+            onClick={() => setMode("preview")}
+          >
             <Eye data-icon="inline-start" /> 预览
           </Button>
-          <Button type="button" variant={mode === "split" ? "secondary" : "ghost"} size="sm" className="hidden lg:inline-flex" onClick={() => setMode("split")}>
+          <Button
+            type="button"
+            variant={mode === "split" ? "secondary" : "ghost"}
+            size="sm"
+            className="hidden lg:inline-flex"
+            onClick={() => setMode("split")}
+          >
             <Columns2 data-icon="inline-start" /> 双栏
           </Button>
         </div>
       </div>
-      {uploadError ? <div role="alert" className="mx-1 mb-1 rounded-lg bg-destructive/10 px-3 py-2 text-xs text-destructive">{uploadError}</div> : null}
-      {uploadSuccess ? <div role="status" className="mx-1 mb-1 rounded-lg bg-background px-3 py-2 text-xs text-muted-foreground">图片上传成功，已插入正文</div> : null}
+      {uploadError ? (
+        <div
+          role="alert"
+          className="mx-1 mb-1 rounded-lg bg-destructive/10 px-3 py-2 text-xs text-destructive"
+        >
+          {uploadError}
+        </div>
+      ) : null}
+      {uploadSuccess ? (
+        <div
+          role="status"
+          className="mx-1 mb-1 rounded-lg bg-background px-3 py-2 text-xs text-muted-foreground"
+        >
+          图片上传成功，已插入正文
+        </div>
+      ) : null}
       {mode === "preview" ? preview : null}
       {mode === "edit" ? textarea : null}
       {mode === "split" ? (
diff --git a/apps/web/app/components/MarkdownView.tsx b/apps/web/app/components/MarkdownView.tsx
index a6e89dd..d303766 100644
--- a/apps/web/app/components/MarkdownView.tsx
+++ b/apps/web/app/components/MarkdownView.tsx
@@ -27,16 +27,13 @@ export function MarkdownView({ content, className }: MarkdownViewProps) {
   const headingIdsByLine = markdownHeadingIdsByLine(content);
 
   function headingId(children: React.ReactNode, node: unknown, line?: number) {
-    return headingIdsByLine.get(line ?? -1) ?? slugifyHeading(nodeText(children) || hastNodeText(node));
+    return (
+      headingIdsByLine.get(line ?? -1) ?? slugifyHeading(nodeText(children) || hastNodeText(node))
+    );
   }
 
   return (
-    <div
-      className={cn(
-        "typeset typeset-docs max-w-none",
-        className,
-      )}
-    >
+    <div className={cn("typeset typeset-docs max-w-none", className)}>
       <ReactMarkdown
         remarkPlugins={[remarkGfm]}
         rehypePlugins={[
@@ -93,7 +90,12 @@ function MarkdownImage({ alt, src, ...props }: ComponentPropsWithoutRef<"img">)
           重新加载
         </button>
         {src && (
-          <a href={src} target="_blank" rel="noopener noreferrer" className="font-medium text-foreground underline-offset-4 hover:underline">
+          <a
+            href={src}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="font-medium text-foreground underline-offset-4 hover:underline"
+          >
             打开原图
           </a>
         )}
@@ -111,7 +113,8 @@ function MarkdownImage({ alt, src, ...props }: ComponentPropsWithoutRef<"img">)
       decoding="async"
       onError={() => setFailed(true)}
       onLoad={(event) => {
-        if (!event.currentTarget.naturalWidth || !event.currentTarget.naturalHeight) setFailed(true);
+        if (!event.currentTarget.naturalWidth || !event.currentTarget.naturalHeight)
+          setFailed(true);
       }}
     />
   );
@@ -129,6 +132,7 @@ function nodeText(node: React.ReactNode): string {
 function hastNodeText(node: unknown): string {
   if (!node || typeof node !== "object") return "";
   if ("value" in node && typeof node.value === "string") return node.value;
-  if ("children" in node && Array.isArray(node.children)) return node.children.map(hastNodeText).join("");
+  if ("children" in node && Array.isArray(node.children))
+    return node.children.map(hastNodeText).join("");
   return "";
 }
diff --git a/apps/web/app/components/PageShell.tsx b/apps/web/app/components/PageShell.tsx
index 127a9e6..5938479 100644
--- a/apps/web/app/components/PageShell.tsx
+++ b/apps/web/app/components/PageShell.tsx
@@ -31,37 +31,44 @@ export function PageHeader({
       )}
     >
       {breadcrumbs && breadcrumbs.length > 0 && (
-          <nav aria-label="面包屑">
-            <ol className="flex flex-wrap items-center gap-1.5 text-xs text-muted-foreground">
-              {breadcrumbs.map((item, index) => (
-                <li key={`${item.label}-${index}`} className="flex items-center gap-1.5">
-                  {index > 0 && <span aria-hidden="true">/</span>}
-                  {item.to ? (
-                    <Link to={item.to} className="hover:text-foreground">{item.label}</Link>
-                  ) : (
-                    <span aria-current="page">{item.label}</span>
-                  )}
-                </li>
-              ))}
-            </ol>
-          </nav>
+        <nav aria-label="面包屑">
+          <ol className="flex flex-wrap items-center gap-1.5 text-xs text-muted-foreground">
+            {breadcrumbs.map((item, index) => (
+              <li key={`${item.label}-${index}`} className="flex items-center gap-1.5">
+                {index > 0 && <span aria-hidden="true">/</span>}
+                {item.to ? (
+                  <Link to={item.to} className="hover:text-foreground">
+                    {item.label}
+                  </Link>
+                ) : (
+                  <span aria-current="page">{item.label}</span>
+                )}
+              </li>
+            ))}
+          </ol>
+        </nav>
       )}
-      <div className={cn(
-        "flex min-w-0 flex-col gap-4 sm:flex-row sm:items-end sm:justify-between",
-        variant === "default" && "rounded-xl bg-brand p-5 text-brand-foreground sm:p-6",
-      )}>
-        <div className="flex min-w-0 flex-col gap-1.5">
-        {!breadcrumbs?.length && eyebrow && (
-          <p className={cn("text-xs font-medium uppercase tracking-widest text-muted-foreground", variant === "marketing" && "text-brand-accent")}>
-            {eyebrow}
-          </p>
-        )}
-        <h1 className="text-2xl font-medium tracking-tight sm:text-3xl">{title}</h1>
-        {description && (
-          <p className="max-w-2xl text-sm text-brand-foreground/70">
-            {description}
-          </p>
+      <div
+        className={cn(
+          "flex min-w-0 flex-col gap-4 sm:flex-row sm:items-end sm:justify-between",
+          variant === "default" && "rounded-xl bg-brand p-5 text-brand-foreground sm:p-6",
         )}
+      >
+        <div className="flex min-w-0 flex-col gap-1.5">
+          {!breadcrumbs?.length && eyebrow && (
+            <p
+              className={cn(
+                "text-xs font-medium uppercase tracking-widest text-muted-foreground",
+                variant === "marketing" && "text-brand-accent",
+              )}
+            >
+              {eyebrow}
+            </p>
+          )}
+          <h1 className="text-2xl font-medium tracking-tight sm:text-3xl">{title}</h1>
+          {description && (
+            <p className="max-w-2xl text-sm text-brand-foreground/70">{description}</p>
+          )}
         </div>
         {action && <div className="shrink-0">{action}</div>}
       </div>
@@ -93,15 +100,35 @@ export function ReadingPage(props: Omit<React.ComponentProps<typeof ArchetypePag
   return <ArchetypePage archetype="reading" {...props} />;
 }
 
-export function ComposePage({ className, ...props }: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">) {
-  return <ArchetypePage archetype="compose" className={cn("mx-auto w-full max-w-5xl", className)} {...props} />;
+export function ComposePage({
+  className,
+  ...props
+}: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">) {
+  return (
+    <ArchetypePage
+      archetype="compose"
+      className={cn("mx-auto w-full max-w-5xl", className)}
+      {...props}
+    />
+  );
 }
 
-export function AccountPage({ className, ...props }: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">) {
-  return <ArchetypePage archetype="account" className={cn("mx-auto w-full max-w-md", className)} {...props} />;
+export function AccountPage({
+  className,
+  ...props
+}: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">) {
+  return (
+    <ArchetypePage
+      archetype="account"
+      className={cn("mx-auto w-full max-w-md", className)}
+      {...props}
+    />
+  );
 }
 
-export function DirectoryPage(props: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">) {
+export function DirectoryPage(
+  props: Omit<React.ComponentProps<typeof ArchetypePage>, "archetype">,
+) {
   return <ArchetypePage archetype="directory" {...props} />;
 }
 
@@ -154,17 +181,10 @@ export function ReadingGrid({
   className?: string;
 }) {
   return (
-    <div
-      className={cn(
-        "grid gap-6 xl:grid-cols-[minmax(0,1fr)_18rem]",
-        className,
-      )}
-    >
+    <div className={cn("grid gap-6 xl:grid-cols-[minmax(0,1fr)_18rem]", className)}>
       <div className="min-w-0 xl:col-start-1">{children}</div>
       {aside && (
-        <aside className="min-w-0 xl:col-start-2 xl:row-span-2 xl:row-start-1">
-          {aside}
-        </aside>
+        <aside className="min-w-0 xl:col-start-2 xl:row-span-2 xl:row-start-1">{aside}</aside>
       )}
       {afterAside && <div className="min-w-0 xl:col-start-1">{afterAside}</div>}
     </div>
diff --git a/apps/web/app/components/Pagination.tsx b/apps/web/app/components/Pagination.tsx
index bff8752..251aa78 100644
--- a/apps/web/app/components/Pagination.tsx
+++ b/apps/web/app/components/Pagination.tsx
@@ -48,7 +48,9 @@ export function Pagination({
             {page > 1 ? <PaginationPrevious render={<Link to={buildUrl(page - 1)} />} /> : <span />}
           </PaginationItem>
           <PaginationItem>
-            {page < totalPages ? <PaginationNext render={<Link to={buildUrl(page + 1)} />} /> : null}
+            {page < totalPages ? (
+              <PaginationNext render={<Link to={buildUrl(page + 1)} />} />
+            ) : null}
           </PaginationItem>
         </PaginationContent>
       </PaginationNav>
@@ -68,16 +70,28 @@ export function Pagination({
             <PaginationLink render={<Link to={buildUrl(1)} />}>1</PaginationLink>
           </PaginationItem>
         )}
-        {start > 2 && <PaginationItem><PaginationEllipsis /></PaginationItem>}
+        {start > 2 && (
+          <PaginationItem>
+            <PaginationEllipsis />
+          </PaginationItem>
+        )}
         {pages.map((p) => (
           <PaginationItem key={p}>
-            <PaginationLink render={<Link to={buildUrl(p)} />} isActive={p === page}>{p}</PaginationLink>
+            <PaginationLink render={<Link to={buildUrl(p)} />} isActive={p === page}>
+              {p}
+            </PaginationLink>
           </PaginationItem>
         ))}
-        {end < totalPages - 1 && <PaginationItem><PaginationEllipsis /></PaginationItem>}
+        {end < totalPages - 1 && (
+          <PaginationItem>
+            <PaginationEllipsis />
+          </PaginationItem>
+        )}
         {end < totalPages && (
           <PaginationItem>
-            <PaginationLink render={<Link to={buildUrl(totalPages)} />}>{totalPages}</PaginationLink>
+            <PaginationLink render={<Link to={buildUrl(totalPages)} />}>
+              {totalPages}
+            </PaginationLink>
           </PaginationItem>
         )}
         {page < totalPages && (
diff --git a/apps/web/app/components/ScrollTopButton.tsx b/apps/web/app/components/ScrollTopButton.tsx
index 1f3ee4e..f39f2d8 100644
--- a/apps/web/app/components/ScrollTopButton.tsx
+++ b/apps/web/app/components/ScrollTopButton.tsx
@@ -27,7 +27,9 @@ export function ScrollTopButton({ className }: { className?: string }) {
       onClick={() =>
         window.scrollTo({
           top: 0,
-          behavior: window.matchMedia("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth",
+          behavior: window.matchMedia("(prefers-reduced-motion: reduce)").matches
+            ? "auto"
+            : "smooth",
         })
       }
       aria-label="回到顶部"
diff --git a/apps/web/app/components/Sidebar.tsx b/apps/web/app/components/Sidebar.tsx
index 1a76ea6..74d646f 100644
--- a/apps/web/app/components/Sidebar.tsx
+++ b/apps/web/app/components/Sidebar.tsx
@@ -40,7 +40,9 @@ export function Sidebar() {
           <CardTitle>社区合作</CardTitle>
         </CardHeader>
         <CardContent className="flex flex-col gap-3">
-          <p className="text-sm text-muted-foreground">面向开源项目、开发者工具与 Node.js 技术活动的社区展示位。</p>
+          <p className="text-sm text-muted-foreground">
+            面向开源项目、开发者工具与 Node.js 技术活动的社区展示位。
+          </p>
           <Button
             render={<Link to="/about#cooperation" />}
             variant="secondary"
@@ -56,7 +58,11 @@ export function Sidebar() {
       {data ? <LatestReplies replies={data.latest_replies} /> : <SidebarSkeleton />}
       {data ? <Leaderboard users={data.top_users} /> : <SidebarSkeleton />}
       {data ? <NoReplyTopics topics={data.no_reply_topics} /> : <SidebarSkeleton />}
-      {data ? <CommunityLinks partners={data.partners} resources={data.resources} /> : <SidebarSkeleton />}
+      {data ? (
+        <CommunityLinks partners={data.partners} resources={data.resources} />
+      ) : (
+        <SidebarSkeleton />
+      )}
     </aside>
   );
 }
@@ -84,9 +90,16 @@ function LatestReplies({ replies }: { replies: SidebarData["latest_replies"] })
         {replies.map((reply) => {
           const author = reply.author;
           return (
-            <Link key={reply.id} to={`/topic/${reply.topic_id}#${reply.id}`} className="group flex gap-3">
+            <Link
+              key={reply.id}
+              to={`/topic/${reply.topic_id}#${reply.id}`}
+              className="group flex gap-3"
+            >
               <Avatar className="mt-0.5 size-8">
-                <AvatarImage src={getAvatarUrl(author?.avatar_url, 32)} alt={author?.loginname || "CNode"} />
+                <AvatarImage
+                  src={getAvatarUrl(author?.avatar_url, 32)}
+                  alt={author?.loginname || "CNode"}
+                />
                 <AvatarFallback>{getAvatarFallback(author?.loginname)}</AvatarFallback>
               </Avatar>
               <span className="min-w-0 flex-1 text-xs">
@@ -94,7 +107,8 @@ function LatestReplies({ replies }: { replies: SidebarData["latest_replies"] })
                   {reply.topic_title}
                 </span>
                 <span className="mt-0.5 block truncate text-muted-foreground">
-                  {author?.loginname || "社区成员"} · {reply.create_at ? <TimeAgo date={reply.create_at} /> : null}
+                  {author?.loginname || "社区成员"} ·{" "}
+                  {reply.create_at ? <TimeAgo date={reply.create_at} /> : null}
                 </span>
               </span>
             </Link>
@@ -117,7 +131,10 @@ function NoReplyTopics({ topics }: { topics: SidebarData["no_reply_topics"] }) {
         <ul className="flex flex-col gap-2 text-xs">
           {topics.map((t) => (
             <li key={t.id}>
-              <Link to={`/topic/${t.id}`} className="block truncate font-medium text-foreground hover:text-primary">
+              <Link
+                to={`/topic/${t.id}`}
+                className="block truncate font-medium text-foreground hover:text-primary"
+              >
                 {t.title}
               </Link>
               <div className="mt-0.5 flex items-center gap-2 text-muted-foreground">
@@ -143,13 +160,19 @@ function Leaderboard({ users }: { users: SidebarData["top_users"] }) {
       </CardHeader>
       <CardContent className="flex flex-col gap-3">
         {users.map((user, index) => (
-          <Link key={user.id} to={`/user/${user.loginname}`} className="flex items-center gap-3 text-sm">
+          <Link
+            key={user.id}
+            to={`/user/${user.loginname}`}
+            className="flex items-center gap-3 text-sm"
+          >
             <span className="w-5 text-xs font-semibold text-muted-foreground">#{index + 1}</span>
             <Avatar className="size-8">
               <AvatarImage src={getAvatarUrl(user.avatar_url, 32)} alt={user.loginname} />
               <AvatarFallback>{getAvatarFallback(user.loginname)}</AvatarFallback>
             </Avatar>
-            <span className="min-w-0 flex-1 truncate font-medium hover:text-primary">{user.loginname}</span>
+            <span className="min-w-0 flex-1 truncate font-medium hover:text-primary">
+              {user.loginname}
+            </span>
             <span className="text-xs text-muted-foreground">{user.score}</span>
           </Link>
         ))}
@@ -183,7 +206,9 @@ function CommunityLinks({
               <span className="flex items-center justify-between font-medium text-foreground">
                 {l.name} <ArrowUpRight className="h-3 w-3" />
               </span>
-              {l.description && <span className="mt-1 block text-muted-foreground">{l.description}</span>}
+              {l.description && (
+                <span className="mt-1 block text-muted-foreground">{l.description}</span>
+              )}
             </a>
           ))}
         </div>
diff --git a/apps/web/app/components/TopicList.tsx b/apps/web/app/components/TopicList.tsx
index 357a0a6..f540730 100644
--- a/apps/web/app/components/TopicList.tsx
+++ b/apps/web/app/components/TopicList.tsx
@@ -17,10 +17,10 @@ export function TopicListItem({ topic }: { topic: TopicDTO }) {
     <Item render={<article />}>
       <ItemMedia variant="image">
         <Link to={`/user/${author.loginname}`}>
-        <Avatar>
-          <AvatarImage src={getAvatarUrl(author.avatar_url, 48)} alt={author.loginname} />
-          <AvatarFallback>{getAvatarFallback(author.loginname)}</AvatarFallback>
-        </Avatar>
+          <Avatar>
+            <AvatarImage src={getAvatarUrl(author.avatar_url, 48)} alt={author.loginname} />
+            <AvatarFallback>{getAvatarFallback(author.loginname)}</AvatarFallback>
+          </Avatar>
         </Link>
       </ItemMedia>
 
diff --git a/apps/web/app/components/TurnstileWidget.tsx b/apps/web/app/components/TurnstileWidget.tsx
index c545303..09ef47e 100644
--- a/apps/web/app/components/TurnstileWidget.tsx
+++ b/apps/web/app/components/TurnstileWidget.tsx
@@ -29,7 +29,11 @@ function loadTurnstileScript() {
     const existing = document.querySelector<HTMLScriptElement>('script[data-turnstile-api="true"]');
     if (existing) {
       existing.addEventListener("load", () => resolve(), { once: true });
-      existing.addEventListener("error", () => reject(new Error("Turnstile script failed to load")), { once: true });
+      existing.addEventListener(
+        "error",
+        () => reject(new Error("Turnstile script failed to load")),
+        { once: true },
+      );
       return;
     }
 
@@ -39,7 +43,9 @@ function loadTurnstileScript() {
     script.defer = true;
     script.dataset.turnstileApi = "true";
     script.addEventListener("load", () => resolve(), { once: true });
-    script.addEventListener("error", () => reject(new Error("Turnstile script failed to load")), { once: true });
+    script.addEventListener("error", () => reject(new Error("Turnstile script failed to load")), {
+      once: true,
+    });
     document.head.appendChild(script);
   });
   return turnstileScriptPromise;
@@ -111,7 +117,9 @@ export function TurnstileWidget() {
       <div ref={containerRef} />
       <p
         role={status === "error" ? "alert" : "status"}
-        className={status === "error" ? "text-sm text-destructive" : "text-sm text-muted-foreground"}
+        className={
+          status === "error" ? "text-sm text-destructive" : "text-sm text-muted-foreground"
+        }
       >
         {message}
       </p>
@@ -121,5 +129,9 @@ export function TurnstileWidget() {
 
 export function getTurnstileToken() {
   if (typeof document === "undefined") return "";
-  return currentToken || (document.querySelector('[name="cf-turnstile-response"]') as HTMLInputElement | null)?.value || "";
+  return (
+    currentToken ||
+    (document.querySelector('[name="cf-turnstile-response"]') as HTMLInputElement | null)?.value ||
+    ""
+  );
 }
diff --git a/apps/web/app/components/UserIdentityBadges.tsx b/apps/web/app/components/UserIdentityBadges.tsx
index 48594dc..75af13c 100644
--- a/apps/web/app/components/UserIdentityBadges.tsx
+++ b/apps/web/app/components/UserIdentityBadges.tsx
@@ -13,7 +13,11 @@ const identityVariants: Record<PublicIdentity, "default" | "secondary" | "outlin
   recruiter: "outline",
 };
 
-export function UserIdentityBadges({ identities = [] }: { identities?: readonly PublicIdentity[] }) {
+export function UserIdentityBadges({
+  identities = [],
+}: {
+  identities?: readonly PublicIdentity[];
+}) {
   if (identities.length === 0) return null;
 
   return (
diff --git a/apps/web/app/components/ui/alert-dialog.tsx b/apps/web/app/components/ui/alert-dialog.tsx
index 02938c2..f2b5579 100644
--- a/apps/web/app/components/ui/alert-dialog.tsx
+++ b/apps/web/app/components/ui/alert-dialog.tsx
@@ -1,39 +1,32 @@
-import * as React from "react"
-import { AlertDialog as AlertDialogPrimitive } from "@base-ui/react/alert-dialog"
+import * as React from "react";
+import { AlertDialog as AlertDialogPrimitive } from "@base-ui/react/alert-dialog";
 
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
 
 function AlertDialog({ ...props }: AlertDialogPrimitive.Root.Props) {
-  return <AlertDialogPrimitive.Root data-slot="alert-dialog" {...props} />
+  return <AlertDialogPrimitive.Root data-slot="alert-dialog" {...props} />;
 }
 
 function AlertDialogTrigger({ ...props }: AlertDialogPrimitive.Trigger.Props) {
-  return (
-    <AlertDialogPrimitive.Trigger data-slot="alert-dialog-trigger" {...props} />
-  )
+  return <AlertDialogPrimitive.Trigger data-slot="alert-dialog-trigger" {...props} />;
 }
 
 function AlertDialogPortal({ ...props }: AlertDialogPrimitive.Portal.Props) {
-  return (
-    <AlertDialogPrimitive.Portal data-slot="alert-dialog-portal" {...props} />
-  )
+  return <AlertDialogPrimitive.Portal data-slot="alert-dialog-portal" {...props} />;
 }
 
-function AlertDialogOverlay({
-  className,
-  ...props
-}: AlertDialogPrimitive.Backdrop.Props) {
+function AlertDialogOverlay({ className, ...props }: AlertDialogPrimitive.Backdrop.Props) {
   return (
     <AlertDialogPrimitive.Backdrop
       data-slot="alert-dialog-overlay"
       className={cn(
         "fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AlertDialogContent({
@@ -41,7 +34,7 @@ function AlertDialogContent({
   size = "default",
   ...props
 }: AlertDialogPrimitive.Popup.Props & {
-  size?: "default" | "sm"
+  size?: "default" | "sm";
 }) {
   return (
     <AlertDialogPortal>
@@ -51,60 +44,51 @@ function AlertDialogContent({
         data-size={size}
         className={cn(
           "group/alert-dialog-content fixed top-1/2 left-1/2 z-50 grid max-h-[calc(100dvh-2rem)] w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 overflow-y-auto overscroll-contain rounded-xl bg-popover p-4 text-popover-foreground ring-1 ring-foreground/10 duration-100 outline-none data-[size=default]:max-w-xs data-[size=sm]:max-w-xs data-[size=default]:sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
-          className
+          className,
         )}
         {...props}
       />
     </AlertDialogPortal>
-  )
+  );
 }
 
-function AlertDialogHeader({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function AlertDialogHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="alert-dialog-header"
       className={cn(
         "grid grid-rows-[auto_1fr] place-items-center gap-1.5 text-center has-data-[slot=alert-dialog-media]:grid-rows-[auto_auto_1fr] has-data-[slot=alert-dialog-media]:gap-x-4 sm:group-data-[size=default]/alert-dialog-content:place-items-start sm:group-data-[size=default]/alert-dialog-content:text-left sm:group-data-[size=default]/alert-dialog-content:has-data-[slot=alert-dialog-media]:grid-rows-[auto_1fr]",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function AlertDialogFooter({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function AlertDialogFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="alert-dialog-footer"
       className={cn(
         "-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t bg-muted/50 p-4 group-data-[size=sm]/alert-dialog-content:grid group-data-[size=sm]/alert-dialog-content:grid-cols-2 sm:flex-row sm:justify-end",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function AlertDialogMedia({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function AlertDialogMedia({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="alert-dialog-media"
       className={cn(
         "mb-2 inline-flex size-10 items-center justify-center rounded-md bg-muted sm:group-data-[size=default]/alert-dialog-content:row-span-2 *:[svg:not([class*='size-'])]:size-6",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AlertDialogTitle({
@@ -116,11 +100,11 @@ function AlertDialogTitle({
       data-slot="alert-dialog-title"
       className={cn(
         "text-base font-medium sm:group-data-[size=default]/alert-dialog-content:group-has-data-[slot=alert-dialog-media]/alert-dialog-content:col-start-2",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AlertDialogDescription({
@@ -132,24 +116,15 @@ function AlertDialogDescription({
       data-slot="alert-dialog-description"
       className={cn(
         "text-sm text-balance text-muted-foreground md:text-pretty *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function AlertDialogAction({
-  className,
-  ...props
-}: React.ComponentProps<typeof Button>) {
-  return (
-    <Button
-      data-slot="alert-dialog-action"
-      className={cn(className)}
-      {...props}
-    />
-  )
+function AlertDialogAction({ className, ...props }: React.ComponentProps<typeof Button>) {
+  return <Button data-slot="alert-dialog-action" className={cn(className)} {...props} />;
 }
 
 function AlertDialogCancel({
@@ -166,7 +141,7 @@ function AlertDialogCancel({
       render={<Button variant={variant} size={size} />}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -182,4 +157,4 @@ export {
   AlertDialogPortal,
   AlertDialogTitle,
   AlertDialogTrigger,
-}
+};
diff --git a/apps/web/app/components/ui/alert.tsx b/apps/web/app/components/ui/alert.tsx
index 7f9aa12..5ae448b 100644
--- a/apps/web/app/components/ui/alert.tsx
+++ b/apps/web/app/components/ui/alert.tsx
@@ -1,7 +1,7 @@
-import * as React from "react"
-import { cva, type VariantProps } from "class-variance-authority"
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 const alertVariants = cva(
   "group/alert relative grid w-full gap-0.5 rounded-lg border px-2.5 py-2 text-left text-sm has-data-[slot=alert-action]:relative has-data-[slot=alert-action]:pr-18 has-[>svg]:grid-cols-[auto_1fr] has-[>svg]:gap-x-2 *:[svg]:row-span-2 *:[svg]:translate-y-0.5 *:[svg]:text-current *:[svg:not([class*='size-'])]:size-4",
@@ -16,8 +16,8 @@ const alertVariants = cva(
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
 function Alert({
   className,
@@ -31,7 +31,7 @@ function Alert({
       className={cn(alertVariants({ variant }), className)}
       {...props}
     />
-  )
+  );
 }
 
 function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
@@ -40,37 +40,30 @@ function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="alert-title"
       className={cn(
         "font-medium group-has-[>svg]/alert:col-start-2 [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function AlertDescription({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function AlertDescription({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="alert-description"
       className={cn(
         "text-sm text-balance text-muted-foreground md:text-pretty [&_a]:underline [&_a]:underline-offset-3 [&_a]:hover:text-foreground [&_p:not(:last-child)]:mb-4",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AlertAction({ className, ...props }: React.ComponentProps<"div">) {
   return (
-    <div
-      data-slot="alert-action"
-      className={cn("absolute top-2 right-2", className)}
-      {...props}
-    />
-  )
+    <div data-slot="alert-action" className={cn("absolute top-2 right-2", className)} {...props} />
+  );
 }
 
-export { Alert, AlertTitle, AlertDescription, AlertAction }
+export { Alert, AlertTitle, AlertDescription, AlertAction };
diff --git a/apps/web/app/components/ui/avatar.tsx b/apps/web/app/components/ui/avatar.tsx
index 38553c2..4f8ecc9 100644
--- a/apps/web/app/components/ui/avatar.tsx
+++ b/apps/web/app/components/ui/avatar.tsx
@@ -1,14 +1,14 @@
-import * as React from "react"
-import { Avatar as AvatarPrimitive } from "@base-ui/react/avatar"
+import * as React from "react";
+import { Avatar as AvatarPrimitive } from "@base-ui/react/avatar";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Avatar({
   className,
   size = "default",
   ...props
 }: AvatarPrimitive.Root.Props & {
-  size?: "default" | "sm" | "lg"
+  size?: "default" | "sm" | "lg";
 }) {
   return (
     <AvatarPrimitive.Root
@@ -16,40 +16,34 @@ function Avatar({
       data-size={size}
       className={cn(
         "group/avatar relative flex size-8 shrink-0 rounded-full select-none after:absolute after:inset-0 after:rounded-full after:border after:border-border after:mix-blend-darken data-[size=lg]:size-10 data-[size=sm]:size-6 dark:after:mix-blend-lighten",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AvatarImage({ className, ...props }: AvatarPrimitive.Image.Props) {
   return (
     <AvatarPrimitive.Image
       data-slot="avatar-image"
-      className={cn(
-        "aspect-square size-full rounded-full object-cover",
-        className
-      )}
+      className={cn("aspect-square size-full rounded-full object-cover", className)}
       {...props}
     />
-  )
+  );
 }
 
-function AvatarFallback({
-  className,
-  ...props
-}: AvatarPrimitive.Fallback.Props) {
+function AvatarFallback({ className, ...props }: AvatarPrimitive.Fallback.Props) {
   return (
     <AvatarPrimitive.Fallback
       data-slot="avatar-fallback"
       className={cn(
         "flex size-full items-center justify-center rounded-full bg-muted text-sm text-muted-foreground group-data-[size=sm]/avatar:text-xs",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AvatarBadge({ className, ...props }: React.ComponentProps<"span">) {
@@ -61,11 +55,11 @@ function AvatarBadge({ className, ...props }: React.ComponentProps<"span">) {
         "group-data-[size=sm]/avatar:size-2 group-data-[size=sm]/avatar:[&>svg]:hidden",
         "group-data-[size=default]/avatar:size-2.5 group-data-[size=default]/avatar:[&>svg]:size-2",
         "group-data-[size=lg]/avatar:size-3 group-data-[size=lg]/avatar:[&>svg]:size-2",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function AvatarGroup({ className, ...props }: React.ComponentProps<"div">) {
@@ -74,34 +68,24 @@ function AvatarGroup({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="avatar-group"
       className={cn(
         "group/avatar-group flex -space-x-2 *:data-[slot=avatar]:ring-2 *:data-[slot=avatar]:ring-background",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function AvatarGroupCount({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function AvatarGroupCount({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="avatar-group-count"
       className={cn(
         "relative flex size-8 shrink-0 items-center justify-center rounded-full bg-muted text-sm text-muted-foreground ring-2 ring-background group-has-data-[size=lg]/avatar-group:size-10 group-has-data-[size=sm]/avatar-group:size-6 [&>svg]:size-4 group-has-data-[size=lg]/avatar-group:[&>svg]:size-5 group-has-data-[size=sm]/avatar-group:[&>svg]:size-3",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export {
-  Avatar,
-  AvatarImage,
-  AvatarFallback,
-  AvatarGroup,
-  AvatarGroupCount,
-  AvatarBadge,
-}
+export { Avatar, AvatarImage, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarBadge };
diff --git a/apps/web/app/components/ui/badge.tsx b/apps/web/app/components/ui/badge.tsx
index 944d67b..4c1f0f9 100644
--- a/apps/web/app/components/ui/badge.tsx
+++ b/apps/web/app/components/ui/badge.tsx
@@ -1,8 +1,8 @@
-import { mergeProps } from "@base-ui/react/merge-props"
-import { useRender } from "@base-ui/react/use-render"
-import { cva, type VariantProps } from "class-variance-authority"
+import { mergeProps } from "@base-ui/react/merge-props";
+import { useRender } from "@base-ui/react/use-render";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 const badgeVariants = cva(
   "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!",
@@ -10,22 +10,19 @@ const badgeVariants = cva(
     variants: {
       variant: {
         default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
-        secondary:
-          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
+        secondary: "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
         destructive:
           "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
-        outline:
-          "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
-        ghost:
-          "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
+        outline: "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
+        ghost: "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
         link: "text-primary underline-offset-4 hover:underline",
       },
     },
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
 function Badge({
   className,
@@ -39,14 +36,14 @@ function Badge({
       {
         className: cn(badgeVariants({ variant }), className),
       },
-      props
+      props,
     ),
     render,
     state: {
       slot: "badge",
       variant,
     },
-  })
+  });
 }
 
-export { Badge, badgeVariants }
+export { Badge, badgeVariants };
diff --git a/apps/web/app/components/ui/button.tsx b/apps/web/app/components/ui/button.tsx
index fd9f42c..0219ad0 100644
--- a/apps/web/app/components/ui/button.tsx
+++ b/apps/web/app/components/ui/button.tsx
@@ -1,8 +1,8 @@
-import * as React from "react"
-import { Button as ButtonPrimitive } from "@base-ui/react/button"
-import { cva, type VariantProps } from "class-variance-authority"
+import * as React from "react";
+import { Button as ButtonPrimitive } from "@base-ui/react/button";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 const buttonVariants = cva(
   "group/button inline-flex shrink-0 items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
@@ -38,8 +38,8 @@ const buttonVariants = cva(
       variant: "default",
       size: "default",
     },
-  }
-)
+  },
+);
 
 function Button({
   className,
@@ -50,8 +50,9 @@ function Button({
   role,
   ...props
 }: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>) {
-  const rendersLink = React.isValidElement<{ href?: unknown; to?: unknown }>(render)
-    && (render.type === "a" || render.props.href !== undefined || render.props.to !== undefined)
+  const rendersLink =
+    React.isValidElement<{ href?: unknown; to?: unknown }>(render) &&
+    (render.type === "a" || render.props.href !== undefined || render.props.to !== undefined);
 
   return (
     <ButtonPrimitive
@@ -62,7 +63,7 @@ function Button({
       role={role ?? (rendersLink ? "link" : undefined)}
       {...props}
     />
-  )
+  );
 }
 
-export { Button, buttonVariants }
+export { Button, buttonVariants };
diff --git a/apps/web/app/components/ui/card.tsx b/apps/web/app/components/ui/card.tsx
index 0372208..03e6d44 100644
--- a/apps/web/app/components/ui/card.tsx
+++ b/apps/web/app/components/ui/card.tsx
@@ -1,6 +1,6 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Card({
   className,
@@ -13,11 +13,11 @@ function Card({
       data-size={size}
       className={cn(
         "group/card flex flex-col gap-(--card-spacing) overflow-hidden rounded-xl bg-card py-(--card-spacing) text-sm text-card-foreground ring-1 ring-foreground/10 [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
@@ -26,11 +26,11 @@ function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="card-header"
       className={cn(
         "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
@@ -39,11 +39,11 @@ function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="card-title"
       className={cn(
         "text-base leading-snug font-medium group-data-[size=sm]/card:text-sm",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
@@ -53,30 +53,23 @@ function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("text-sm text-muted-foreground", className)}
       {...props}
     />
-  )
+  );
 }
 
 function CardAction({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="card-action"
-      className={cn(
-        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
-        className
-      )}
+      className={cn("col-start-2 row-span-2 row-start-1 self-start justify-self-end", className)}
       {...props}
     />
-  )
+  );
 }
 
 function CardContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
-    <div
-      data-slot="card-content"
-      className={cn("px-(--card-spacing)", className)}
-      {...props}
-    />
-  )
+    <div data-slot="card-content" className={cn("px-(--card-spacing)", className)} {...props} />
+  );
 }
 
 function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
@@ -85,19 +78,11 @@ function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="card-footer"
       className={cn(
         "flex items-center rounded-b-xl border-t bg-muted/50 p-(--card-spacing)",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export {
-  Card,
-  CardHeader,
-  CardFooter,
-  CardTitle,
-  CardAction,
-  CardDescription,
-  CardContent,
-}
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent };
diff --git a/apps/web/app/components/ui/checkbox.tsx b/apps/web/app/components/ui/checkbox.tsx
index a747002..308b21d 100644
--- a/apps/web/app/components/ui/checkbox.tsx
+++ b/apps/web/app/components/ui/checkbox.tsx
@@ -1,9 +1,9 @@
-"use client"
+"use client";
 
-import { Checkbox as CheckboxPrimitive } from "@base-ui/react/checkbox"
+import { Checkbox as CheckboxPrimitive } from "@base-ui/react/checkbox";
 
-import { cn } from "~/lib/utils"
-import { CheckIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { CheckIcon } from "lucide-react";
 
 function Checkbox({ className, ...props }: CheckboxPrimitive.Root.Props) {
   return (
@@ -11,7 +11,7 @@ function Checkbox({ className, ...props }: CheckboxPrimitive.Root.Props) {
       data-slot="checkbox"
       className={cn(
         "peer relative flex size-4 shrink-0 items-center justify-center rounded-[4px] border border-input transition-colors outline-none group-has-disabled/field:opacity-50 after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-primary dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-primary data-checked:bg-primary data-checked:text-primary-foreground dark:data-checked:bg-primary",
-        className
+        className,
       )}
       {...props}
     >
@@ -19,11 +19,10 @@ function Checkbox({ className, ...props }: CheckboxPrimitive.Root.Props) {
         data-slot="checkbox-indicator"
         className="grid place-content-center text-current transition-none [&>svg]:size-3.5"
       >
-        <CheckIcon
-        />
+        <CheckIcon />
       </CheckboxPrimitive.Indicator>
     </CheckboxPrimitive.Root>
-  )
+  );
 }
 
-export { Checkbox }
+export { Checkbox };
diff --git a/apps/web/app/components/ui/command.tsx b/apps/web/app/components/ui/command.tsx
index fa0cef1..0d89a02 100644
--- a/apps/web/app/components/ui/command.tsx
+++ b/apps/web/app/components/ui/command.tsx
@@ -1,34 +1,28 @@
-import * as React from "react"
-import { Command as CommandPrimitive } from "cmdk"
+import * as React from "react";
+import { Command as CommandPrimitive } from "cmdk";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 import {
   Dialog,
   DialogContent,
   DialogDescription,
   DialogHeader,
   DialogTitle,
-} from "~/components/ui/dialog"
-import {
-  InputGroup,
-  InputGroupAddon,
-} from "~/components/ui/input-group"
-import { SearchIcon, CheckIcon } from "lucide-react"
+} from "~/components/ui/dialog";
+import { InputGroup, InputGroupAddon } from "~/components/ui/input-group";
+import { SearchIcon, CheckIcon } from "lucide-react";
 
-function Command({
-  className,
-  ...props
-}: React.ComponentProps<typeof CommandPrimitive>) {
+function Command({ className, ...props }: React.ComponentProps<typeof CommandPrimitive>) {
   return (
     <CommandPrimitive
       data-slot="command"
       className={cn(
         "flex size-full flex-col overflow-hidden rounded-xl! bg-popover p-1 text-popover-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CommandDialog({
@@ -39,11 +33,11 @@ function CommandDialog({
   showCloseButton = false,
   ...props
 }: Omit<React.ComponentProps<typeof Dialog>, "children"> & {
-  title?: string
-  description?: string
-  className?: string
-  showCloseButton?: boolean
-  children: React.ReactNode
+  title?: string;
+  description?: string;
+  className?: string;
+  showCloseButton?: boolean;
+  children: React.ReactNode;
 }) {
   return (
     <Dialog {...props}>
@@ -52,16 +46,13 @@ function CommandDialog({
         <DialogDescription>{description}</DialogDescription>
       </DialogHeader>
       <DialogContent
-        className={cn(
-          "top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0",
-          className
-        )}
+        className={cn("top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0", className)}
         showCloseButton={showCloseButton}
       >
         {children}
       </DialogContent>
     </Dialog>
-  )
+  );
 }
 
 function CommandInput({
@@ -75,7 +66,7 @@ function CommandInput({
           data-slot="command-input"
           className={cn(
             "w-full text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50",
-            className
+            className,
           )}
           {...props}
         />
@@ -84,23 +75,20 @@ function CommandInput({
         </InputGroupAddon>
       </InputGroup>
     </div>
-  )
+  );
 }
 
-function CommandList({
-  className,
-  ...props
-}: React.ComponentProps<typeof CommandPrimitive.List>) {
+function CommandList({ className, ...props }: React.ComponentProps<typeof CommandPrimitive.List>) {
   return (
     <CommandPrimitive.List
       data-slot="command-list"
       className={cn(
         "no-scrollbar max-h-72 scroll-py-1 overflow-x-hidden overflow-y-auto outline-none",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CommandEmpty({
@@ -113,7 +101,7 @@ function CommandEmpty({
       className={cn("py-6 text-center text-sm", className)}
       {...props}
     />
-  )
+  );
 }
 
 function CommandGroup({
@@ -125,11 +113,11 @@ function CommandGroup({
       data-slot="command-group"
       className={cn(
         "overflow-hidden p-1 text-foreground **:[[cmdk-group-heading]]:px-2 **:[[cmdk-group-heading]]:py-1.5 **:[[cmdk-group-heading]]:text-xs **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function CommandSeparator({
@@ -142,7 +130,7 @@ function CommandSeparator({
       className={cn("-mx-1 h-px bg-border", className)}
       {...props}
     />
-  )
+  );
 }
 
 function CommandItem({
@@ -155,30 +143,27 @@ function CommandItem({
       data-slot="command-item"
       className={cn(
         "group/command-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none in-data-[slot=dialog-content]:rounded-lg! data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 data-selected:bg-muted data-selected:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-selected:*:[svg]:text-foreground",
-        className
+        className,
       )}
       {...props}
     >
       {children}
       <CheckIcon className="ml-auto opacity-0 group-has-data-[slot=command-shortcut]/command-item:hidden group-data-[checked=true]/command-item:opacity-100" />
     </CommandPrimitive.Item>
-  )
+  );
 }
 
-function CommandShortcut({
-  className,
-  ...props
-}: React.ComponentProps<"span">) {
+function CommandShortcut({ className, ...props }: React.ComponentProps<"span">) {
   return (
     <span
       data-slot="command-shortcut"
       className={cn(
         "ml-auto text-xs tracking-widest text-muted-foreground group-data-selected/command-item:text-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -191,4 +176,4 @@ export {
   CommandItem,
   CommandShortcut,
   CommandSeparator,
-}
+};
diff --git a/apps/web/app/components/ui/dialog.tsx b/apps/web/app/components/ui/dialog.tsx
index 15890bc..fbafbd5 100644
--- a/apps/web/app/components/ui/dialog.tsx
+++ b/apps/web/app/components/ui/dialog.tsx
@@ -1,42 +1,39 @@
-"use client"
+"use client";
 
-import * as React from "react"
-import { Dialog as DialogPrimitive } from "@base-ui/react/dialog"
+import * as React from "react";
+import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
 
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
-import { XIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
+import { XIcon } from "lucide-react";
 
 function Dialog({ ...props }: DialogPrimitive.Root.Props) {
-  return <DialogPrimitive.Root data-slot="dialog" {...props} />
+  return <DialogPrimitive.Root data-slot="dialog" {...props} />;
 }
 
 function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props) {
-  return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />
+  return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />;
 }
 
 function DialogPortal({ ...props }: DialogPrimitive.Portal.Props) {
-  return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />
+  return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />;
 }
 
 function DialogClose({ ...props }: DialogPrimitive.Close.Props) {
-  return <DialogPrimitive.Close data-slot="dialog-close" {...props} />
+  return <DialogPrimitive.Close data-slot="dialog-close" {...props} />;
 }
 
-function DialogOverlay({
-  className,
-  ...props
-}: DialogPrimitive.Backdrop.Props) {
+function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props) {
   return (
     <DialogPrimitive.Backdrop
       data-slot="dialog-overlay"
       className={cn(
         "fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function DialogContent({
@@ -45,7 +42,7 @@ function DialogContent({
   showCloseButton = true,
   ...props
 }: DialogPrimitive.Popup.Props & {
-  showCloseButton?: boolean
+  showCloseButton?: boolean;
 }) {
   return (
     <DialogPortal>
@@ -54,7 +51,7 @@ function DialogContent({
         data-slot="dialog-content"
         className={cn(
           "fixed top-1/2 left-1/2 z-50 grid max-h-[calc(100dvh-2rem)] w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 overflow-y-auto overscroll-contain rounded-xl bg-popover p-4 text-sm text-popover-foreground ring-1 ring-foreground/10 duration-100 outline-none sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
-          className
+          className,
         )}
         {...props}
       >
@@ -62,32 +59,21 @@ function DialogContent({
         {showCloseButton && (
           <DialogPrimitive.Close
             data-slot="dialog-close"
-            render={
-              <Button
-                variant="ghost"
-                className="absolute top-2 right-2"
-                size="icon-sm"
-              />
-            }
+            render={<Button variant="ghost" className="absolute top-2 right-2" size="icon-sm" />}
           >
-            <XIcon
-            />
+            <XIcon />
             <span className="sr-only">关闭</span>
           </DialogPrimitive.Close>
         )}
       </DialogPrimitive.Popup>
     </DialogPortal>
-  )
+  );
 }
 
 function DialogHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
-    <div
-      data-slot="dialog-header"
-      className={cn("flex flex-col gap-2", className)}
-      {...props}
-    />
-  )
+    <div data-slot="dialog-header" className={cn("flex flex-col gap-2", className)} {...props} />
+  );
 }
 
 function DialogFooter({
@@ -96,54 +82,46 @@ function DialogFooter({
   children,
   ...props
 }: React.ComponentProps<"div"> & {
-  showCloseButton?: boolean
+  showCloseButton?: boolean;
 }) {
   return (
     <div
       data-slot="dialog-footer"
       className={cn(
         "-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t bg-muted/50 p-4 sm:flex-row sm:justify-end",
-        className
+        className,
       )}
       {...props}
     >
       {children}
       {showCloseButton && (
-        <DialogPrimitive.Close render={<Button variant="outline" />}>
-          关闭
-        </DialogPrimitive.Close>
+        <DialogPrimitive.Close render={<Button variant="outline" />}>关闭</DialogPrimitive.Close>
       )}
     </div>
-  )
+  );
 }
 
 function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props) {
   return (
     <DialogPrimitive.Title
       data-slot="dialog-title"
-      className={cn(
-        "text-base leading-none font-medium",
-        className
-      )}
+      className={cn("text-base leading-none font-medium", className)}
       {...props}
     />
-  )
+  );
 }
 
-function DialogDescription({
-  className,
-  ...props
-}: DialogPrimitive.Description.Props) {
+function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props) {
   return (
     <DialogPrimitive.Description
       data-slot="dialog-description"
       className={cn(
         "text-sm text-muted-foreground *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -157,4 +135,4 @@ export {
   DialogPortal,
   DialogTitle,
   DialogTrigger,
-}
+};
diff --git a/apps/web/app/components/ui/dropdown-menu.tsx b/apps/web/app/components/ui/dropdown-menu.tsx
index de2cc84..1fad0d1 100644
--- a/apps/web/app/components/ui/dropdown-menu.tsx
+++ b/apps/web/app/components/ui/dropdown-menu.tsx
@@ -1,21 +1,21 @@
-"use client"
+"use client";
 
-import * as React from "react"
-import { Menu as MenuPrimitive } from "@base-ui/react/menu"
+import * as React from "react";
+import { Menu as MenuPrimitive } from "@base-ui/react/menu";
 
-import { cn } from "~/lib/utils"
-import { ChevronRightIcon, CheckIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { ChevronRightIcon, CheckIcon } from "lucide-react";
 
 function DropdownMenu({ ...props }: MenuPrimitive.Root.Props) {
-  return <MenuPrimitive.Root data-slot="dropdown-menu" {...props} />
+  return <MenuPrimitive.Root data-slot="dropdown-menu" {...props} />;
 }
 
 function DropdownMenuPortal({ ...props }: MenuPrimitive.Portal.Props) {
-  return <MenuPrimitive.Portal data-slot="dropdown-menu-portal" {...props} />
+  return <MenuPrimitive.Portal data-slot="dropdown-menu-portal" {...props} />;
 }
 
 function DropdownMenuTrigger({ ...props }: MenuPrimitive.Trigger.Props) {
-  return <MenuPrimitive.Trigger data-slot="dropdown-menu-trigger" {...props} />
+  return <MenuPrimitive.Trigger data-slot="dropdown-menu-trigger" {...props} />;
 }
 
 function DropdownMenuContent({
@@ -26,10 +26,7 @@ function DropdownMenuContent({
   className,
   ...props
 }: MenuPrimitive.Popup.Props &
-  Pick<
-    MenuPrimitive.Positioner.Props,
-    "align" | "alignOffset" | "side" | "sideOffset"
-  >) {
+  Pick<MenuPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">) {
   return (
     <MenuPrimitive.Portal>
       <MenuPrimitive.Positioner
@@ -41,16 +38,19 @@ function DropdownMenuContent({
       >
         <MenuPrimitive.Popup
           data-slot="dropdown-menu-content"
-          className={cn("z-50 max-h-(--available-height) w-(--anchor-width) min-w-32 origin-(--transform-origin) overflow-x-hidden overflow-y-auto overscroll-contain rounded-lg bg-popover p-1 text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 outline-none data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:overflow-hidden data-closed:fade-out-0 data-closed:zoom-out-95", className )}
+          className={cn(
+            "z-50 max-h-(--available-height) w-(--anchor-width) min-w-32 origin-(--transform-origin) overflow-x-hidden overflow-y-auto overscroll-contain rounded-lg bg-popover p-1 text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 outline-none data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:overflow-hidden data-closed:fade-out-0 data-closed:zoom-out-95",
+            className,
+          )}
           {...props}
         />
       </MenuPrimitive.Positioner>
     </MenuPrimitive.Portal>
-  )
+  );
 }
 
 function DropdownMenuGroup({ ...props }: MenuPrimitive.Group.Props) {
-  return <MenuPrimitive.Group data-slot="dropdown-menu-group" {...props} />
+  return <MenuPrimitive.Group data-slot="dropdown-menu-group" {...props} />;
 }
 
 function DropdownMenuLabel({
@@ -58,7 +58,7 @@ function DropdownMenuLabel({
   inset,
   ...props
 }: MenuPrimitive.GroupLabel.Props & {
-  inset?: boolean
+  inset?: boolean;
 }) {
   return (
     <MenuPrimitive.GroupLabel
@@ -66,11 +66,11 @@ function DropdownMenuLabel({
       data-inset={inset}
       className={cn(
         "px-1.5 py-1 text-xs font-medium text-muted-foreground data-inset:pl-7",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function DropdownMenuItem({
@@ -79,8 +79,8 @@ function DropdownMenuItem({
   variant = "default",
   ...props
 }: MenuPrimitive.Item.Props & {
-  inset?: boolean
-  variant?: "default" | "destructive"
+  inset?: boolean;
+  variant?: "default" | "destructive";
 }) {
   return (
     <MenuPrimitive.Item
@@ -89,15 +89,15 @@ function DropdownMenuItem({
       data-variant={variant}
       className={cn(
         "group/dropdown-menu-item relative flex cursor-default items-center gap-1.5 rounded-md px-1.5 py-1 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-inset:pl-7 data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 data-[variant=destructive]:focus:text-destructive dark:data-[variant=destructive]:focus:bg-destructive/20 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-[variant=destructive]:*:[svg]:text-destructive",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function DropdownMenuSub({ ...props }: MenuPrimitive.SubmenuRoot.Props) {
-  return <MenuPrimitive.SubmenuRoot data-slot="dropdown-menu-sub" {...props} />
+  return <MenuPrimitive.SubmenuRoot data-slot="dropdown-menu-sub" {...props} />;
 }
 
 function DropdownMenuSubTrigger({
@@ -106,7 +106,7 @@ function DropdownMenuSubTrigger({
   children,
   ...props
 }: MenuPrimitive.SubmenuTrigger.Props & {
-  inset?: boolean
+  inset?: boolean;
 }) {
   return (
     <MenuPrimitive.SubmenuTrigger
@@ -114,14 +114,14 @@ function DropdownMenuSubTrigger({
       data-inset={inset}
       className={cn(
         "flex cursor-default items-center gap-1.5 rounded-md px-1.5 py-1 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-inset:pl-7 data-popup-open:bg-accent data-popup-open:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
       {children}
       <ChevronRightIcon className="ml-auto" />
     </MenuPrimitive.SubmenuTrigger>
-  )
+  );
 }
 
 function DropdownMenuSubContent({
@@ -135,14 +135,17 @@ function DropdownMenuSubContent({
   return (
     <DropdownMenuContent
       data-slot="dropdown-menu-sub-content"
-      className={cn("w-auto min-w-[96px] rounded-lg bg-popover p-1 text-popover-foreground shadow-lg ring-1 ring-foreground/10 duration-100 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", className )}
+      className={cn(
+        "w-auto min-w-[96px] rounded-lg bg-popover p-1 text-popover-foreground shadow-lg ring-1 ring-foreground/10 duration-100 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+        className,
+      )}
       align={align}
       alignOffset={alignOffset}
       side={side}
       sideOffset={sideOffset}
       {...props}
     />
-  )
+  );
 }
 
 function DropdownMenuCheckboxItem({
@@ -152,7 +155,7 @@ function DropdownMenuCheckboxItem({
   inset,
   ...props
 }: MenuPrimitive.CheckboxItem.Props & {
-  inset?: boolean
+  inset?: boolean;
 }) {
   return (
     <MenuPrimitive.CheckboxItem
@@ -160,7 +163,7 @@ function DropdownMenuCheckboxItem({
       data-inset={inset}
       className={cn(
         "relative flex cursor-default items-center gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground data-inset:pl-7 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       checked={checked}
       {...props}
@@ -170,22 +173,16 @@ function DropdownMenuCheckboxItem({
         data-slot="dropdown-menu-checkbox-item-indicator"
       >
         <MenuPrimitive.CheckboxItemIndicator>
-          <CheckIcon
-          />
+          <CheckIcon />
         </MenuPrimitive.CheckboxItemIndicator>
       </span>
       {children}
     </MenuPrimitive.CheckboxItem>
-  )
+  );
 }
 
 function DropdownMenuRadioGroup({ ...props }: MenuPrimitive.RadioGroup.Props) {
-  return (
-    <MenuPrimitive.RadioGroup
-      data-slot="dropdown-menu-radio-group"
-      {...props}
-    />
-  )
+  return <MenuPrimitive.RadioGroup data-slot="dropdown-menu-radio-group" {...props} />;
 }
 
 function DropdownMenuRadioItem({
@@ -194,7 +191,7 @@ function DropdownMenuRadioItem({
   inset,
   ...props
 }: MenuPrimitive.RadioItem.Props & {
-  inset?: boolean
+  inset?: boolean;
 }) {
   return (
     <MenuPrimitive.RadioItem
@@ -202,7 +199,7 @@ function DropdownMenuRadioItem({
       data-inset={inset}
       className={cn(
         "relative flex cursor-default items-center gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground data-inset:pl-7 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
@@ -211,42 +208,35 @@ function DropdownMenuRadioItem({
         data-slot="dropdown-menu-radio-item-indicator"
       >
         <MenuPrimitive.RadioItemIndicator>
-          <CheckIcon
-          />
+          <CheckIcon />
         </MenuPrimitive.RadioItemIndicator>
       </span>
       {children}
     </MenuPrimitive.RadioItem>
-  )
+  );
 }
 
-function DropdownMenuSeparator({
-  className,
-  ...props
-}: MenuPrimitive.Separator.Props) {
+function DropdownMenuSeparator({ className, ...props }: MenuPrimitive.Separator.Props) {
   return (
     <MenuPrimitive.Separator
       data-slot="dropdown-menu-separator"
       className={cn("-mx-1 my-1 h-px bg-border", className)}
       {...props}
     />
-  )
+  );
 }
 
-function DropdownMenuShortcut({
-  className,
-  ...props
-}: React.ComponentProps<"span">) {
+function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">) {
   return (
     <span
       data-slot="dropdown-menu-shortcut"
       className={cn(
         "ml-auto text-xs tracking-widest text-muted-foreground group-focus/dropdown-menu-item:text-accent-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -265,4 +255,4 @@ export {
   DropdownMenuSub,
   DropdownMenuSubTrigger,
   DropdownMenuSubContent,
-}
+};
diff --git a/apps/web/app/components/ui/empty.tsx b/apps/web/app/components/ui/empty.tsx
index ab32cfe..431a3b7 100644
--- a/apps/web/app/components/ui/empty.tsx
+++ b/apps/web/app/components/ui/empty.tsx
@@ -1,6 +1,6 @@
-import { cva, type VariantProps } from "class-variance-authority"
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Empty({ className, ...props }: React.ComponentProps<"div">) {
   return (
@@ -8,11 +8,11 @@ function Empty({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="empty"
       className={cn(
         "flex w-full min-w-0 flex-1 flex-col items-center justify-center gap-4 rounded-xl border-dashed p-6 text-center text-balance",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function EmptyHeader({ className, ...props }: React.ComponentProps<"div">) {
@@ -22,7 +22,7 @@ function EmptyHeader({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("flex max-w-sm flex-col items-center gap-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 const emptyMediaVariants = cva(
@@ -37,8 +37,8 @@ const emptyMediaVariants = cva(
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
 function EmptyMedia({
   className,
@@ -52,20 +52,17 @@ function EmptyMedia({
       className={cn(emptyMediaVariants({ variant, className }))}
       {...props}
     />
-  )
+  );
 }
 
 function EmptyTitle({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="empty-title"
-      className={cn(
-        "text-sm font-medium tracking-tight",
-        className
-      )}
+      className={cn("text-sm font-medium tracking-tight", className)}
       {...props}
     />
-  )
+  );
 }
 
 function EmptyDescription({ className, ...props }: React.ComponentProps<"p">) {
@@ -74,11 +71,11 @@ function EmptyDescription({ className, ...props }: React.ComponentProps<"p">) {
       data-slot="empty-description"
       className={cn(
         "text-sm/relaxed text-muted-foreground [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function EmptyContent({ className, ...props }: React.ComponentProps<"div">) {
@@ -87,18 +84,11 @@ function EmptyContent({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="empty-content"
       className={cn(
         "flex w-full max-w-sm min-w-0 flex-col items-center gap-2.5 text-sm text-balance",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export {
-  Empty,
-  EmptyHeader,
-  EmptyTitle,
-  EmptyDescription,
-  EmptyContent,
-  EmptyMedia,
-}
+export { Empty, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyMedia };
diff --git a/apps/web/app/components/ui/field.tsx b/apps/web/app/components/ui/field.tsx
index 62ed3cf..60e15bb 100644
--- a/apps/web/app/components/ui/field.tsx
+++ b/apps/web/app/components/ui/field.tsx
@@ -1,11 +1,11 @@
-"use client"
+"use client";
 
-import { useMemo } from "react"
-import { cva, type VariantProps } from "class-variance-authority"
+import { useMemo } from "react";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
-import { Label } from "~/components/ui/label"
-import { Separator } from "~/components/ui/separator"
+import { cn } from "~/lib/utils";
+import { Label } from "~/components/ui/label";
+import { Separator } from "~/components/ui/separator";
 
 function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
   return (
@@ -13,11 +13,11 @@ function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
       data-slot="field-set"
       className={cn(
         "flex flex-col gap-4 has-[>[data-slot=checkbox-group]]:gap-3 has-[>[data-slot=radio-group]]:gap-3",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function FieldLegend({
@@ -31,11 +31,11 @@ function FieldLegend({
       data-variant={variant}
       className={cn(
         "mb-1.5 font-medium data-[variant=label]:text-sm data-[variant=legend]:text-base",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function FieldGroup({ className, ...props }: React.ComponentProps<"div">) {
@@ -44,30 +44,27 @@ function FieldGroup({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="field-group"
       className={cn(
         "group/field-group @container/field-group flex w-full flex-col gap-5 data-[slot=checkbox-group]:gap-3 *:data-[slot=field-group]:gap-4",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-const fieldVariants = cva(
-  "group/field flex w-full gap-2 data-[invalid=true]:text-destructive",
-  {
-    variants: {
-      orientation: {
-        vertical: "flex-col *:w-full [&>.sr-only]:w-auto",
-        horizontal:
-          "flex-row items-center has-[>[data-slot=field-content]]:items-start *:data-[slot=field-label]:flex-auto has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
-        responsive:
-          "flex-col *:w-full @md/field-group:flex-row @md/field-group:items-center @md/field-group:*:w-auto @md/field-group:has-[>[data-slot=field-content]]:items-start @md/field-group:*:data-[slot=field-label]:flex-auto [&>.sr-only]:w-auto @md/field-group:has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
-      },
+const fieldVariants = cva("group/field flex w-full gap-2 data-[invalid=true]:text-destructive", {
+  variants: {
+    orientation: {
+      vertical: "flex-col *:w-full [&>.sr-only]:w-auto",
+      horizontal:
+        "flex-row items-center has-[>[data-slot=field-content]]:items-start *:data-[slot=field-label]:flex-auto has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
+      responsive:
+        "flex-col *:w-full @md/field-group:flex-row @md/field-group:items-center @md/field-group:*:w-auto @md/field-group:has-[>[data-slot=field-content]]:items-start @md/field-group:*:data-[slot=field-label]:flex-auto [&>.sr-only]:w-auto @md/field-group:has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
     },
-    defaultVariants: {
-      orientation: "vertical",
-    },
-  }
-)
+  },
+  defaultVariants: {
+    orientation: "vertical",
+  },
+});
 
 function Field({
   className,
@@ -82,37 +79,31 @@ function Field({
       className={cn(fieldVariants({ orientation }), className)}
       {...props}
     />
-  )
+  );
 }
 
 function FieldContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="field-content"
-      className={cn(
-        "group/field-content flex flex-1 flex-col gap-0.5 leading-snug",
-        className
-      )}
+      className={cn("group/field-content flex flex-1 flex-col gap-0.5 leading-snug", className)}
       {...props}
     />
-  )
+  );
 }
 
-function FieldLabel({
-  className,
-  ...props
-}: React.ComponentProps<typeof Label>) {
+function FieldLabel({ className, ...props }: React.ComponentProps<typeof Label>) {
   return (
     <Label
       data-slot="field-label"
       className={cn(
         "group/field-label peer/field-label flex w-fit gap-2 leading-snug group-data-[disabled=true]/field:opacity-50 has-data-checked:border-primary/30 has-data-checked:bg-primary/5 has-[>[data-slot=field]]:rounded-lg has-[>[data-slot=field]]:border *:data-[slot=field]:p-2.5 dark:has-data-checked:border-primary/20 dark:has-data-checked:bg-primary/10",
         "has-[>[data-slot=field]]:w-full has-[>[data-slot=field]]:flex-col",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function FieldTitle({ className, ...props }: React.ComponentProps<"div">) {
@@ -121,11 +112,11 @@ function FieldTitle({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="field-label"
       className={cn(
         "flex w-fit items-center gap-2 text-sm font-medium group-data-[disabled=true]/field:opacity-50",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function FieldDescription({ className, ...props }: React.ComponentProps<"p">) {
@@ -136,11 +127,11 @@ function FieldDescription({ className, ...props }: React.ComponentProps<"p">) {
         "text-left text-sm leading-normal font-normal text-muted-foreground group-has-data-horizontal/field:text-balance [[data-variant=legend]+&]:-mt-1.5",
         "last:mt-0 nth-last-2:-mt-1",
         "[&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function FieldSeparator({
@@ -148,7 +139,7 @@ function FieldSeparator({
   className,
   ...props
 }: React.ComponentProps<"div"> & {
-  children?: React.ReactNode
+  children?: React.ReactNode;
 }) {
   return (
     <div
@@ -156,7 +147,7 @@ function FieldSeparator({
       data-content={!!children}
       className={cn(
         "relative -my-2 h-5 text-sm group-data-[variant=outline]/field-group:-mb-2",
-        className
+        className,
       )}
       {...props}
     >
@@ -170,7 +161,7 @@ function FieldSeparator({
         </span>
       )}
     </div>
-  )
+  );
 }
 
 function FieldError({
@@ -179,37 +170,32 @@ function FieldError({
   errors,
   ...props
 }: React.ComponentProps<"div"> & {
-  errors?: Array<{ message?: string } | undefined>
+  errors?: Array<{ message?: string } | undefined>;
 }) {
   const content = useMemo(() => {
     if (children) {
-      return children
+      return children;
     }
 
     if (!errors?.length) {
-      return null
+      return null;
     }
 
-    const uniqueErrors = [
-      ...new Map(errors.map((error) => [error?.message, error])).values(),
-    ]
+    const uniqueErrors = [...new Map(errors.map((error) => [error?.message, error])).values()];
 
     if (uniqueErrors?.length === 1) {
-      return uniqueErrors[0]?.message
+      return uniqueErrors[0]?.message;
     }
 
     return (
       <ul className="ml-4 flex list-disc flex-col gap-1">
-        {uniqueErrors.map(
-          (error, index) =>
-            error?.message && <li key={index}>{error.message}</li>
-        )}
+        {uniqueErrors.map((error, index) => error?.message && <li key={index}>{error.message}</li>)}
       </ul>
-    )
-  }, [children, errors])
+    );
+  }, [children, errors]);
 
   if (!content) {
-    return null
+    return null;
   }
 
   return (
@@ -221,7 +207,7 @@ function FieldError({
     >
       {content}
     </div>
-  )
+  );
 }
 
 export {
@@ -235,4 +221,4 @@ export {
   FieldSet,
   FieldContent,
   FieldTitle,
-}
+};
diff --git a/apps/web/app/components/ui/input-group.tsx b/apps/web/app/components/ui/input-group.tsx
index 68e7382..4fd4d35 100644
--- a/apps/web/app/components/ui/input-group.tsx
+++ b/apps/web/app/components/ui/input-group.tsx
@@ -1,12 +1,12 @@
-"use client"
+"use client";
 
-import * as React from "react"
-import { cva, type VariantProps } from "class-variance-authority"
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
-import { Input } from "~/components/ui/input"
-import { Textarea } from "~/components/ui/textarea"
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
+import { Input } from "~/components/ui/input";
+import { Textarea } from "~/components/ui/textarea";
 
 function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
   return (
@@ -15,11 +15,11 @@ function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
       role="group"
       className={cn(
         "group/input-group relative flex h-8 w-full min-w-0 items-center rounded-lg border border-input transition-colors outline-none in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-disabled:bg-input/50 has-disabled:opacity-50 has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot][aria-invalid=true]]:border-destructive has-[[data-slot][aria-invalid=true]]:ring-3 has-[[data-slot][aria-invalid=true]]:ring-destructive/20 has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>textarea]:h-auto dark:bg-input/30 dark:has-disabled:bg-input/80 dark:has-[[data-slot][aria-invalid=true]]:ring-destructive/40 has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pr-1.5 has-[>[data-align=inline-start]]:[&>input]:pl-1.5",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 const inputGroupAddonVariants = cva(
@@ -27,10 +27,8 @@ const inputGroupAddonVariants = cva(
   {
     variants: {
       align: {
-        "inline-start":
-          "order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
-        "inline-end":
-          "order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
+        "inline-start": "order-first pl-2 has-[>button]:ml-[-0.3rem] has-[>kbd]:ml-[-0.15rem]",
+        "inline-end": "order-last pr-2 has-[>button]:mr-[-0.3rem] has-[>kbd]:mr-[-0.15rem]",
         "block-start":
           "order-first w-full justify-start px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2",
         "block-end":
@@ -40,8 +38,8 @@ const inputGroupAddonVariants = cva(
     defaultVariants: {
       align: "inline-start",
     },
-  }
-)
+  },
+);
 
 function InputGroupAddon({
   className,
@@ -56,32 +54,28 @@ function InputGroupAddon({
       className={cn(inputGroupAddonVariants({ align }), className)}
       onClick={(e) => {
         if ((e.target as HTMLElement).closest("button")) {
-          return
+          return;
         }
-        e.currentTarget.parentElement?.querySelector("input")?.focus()
+        e.currentTarget.parentElement?.querySelector("input")?.focus();
       }}
       {...props}
     />
-  )
+  );
 }
 
-const inputGroupButtonVariants = cva(
-  "flex items-center gap-2 text-sm shadow-none",
-  {
-    variants: {
-      size: {
-        xs: "h-6 gap-1 rounded-[calc(var(--radius)-3px)] px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
-        sm: "",
-        "icon-xs":
-          "size-6 rounded-[calc(var(--radius)-3px)] p-0 has-[>svg]:p-0",
-        "icon-sm": "size-8 p-0 has-[>svg]:p-0",
-      },
-    },
-    defaultVariants: {
-      size: "xs",
+const inputGroupButtonVariants = cva("flex items-center gap-2 text-sm shadow-none", {
+  variants: {
+    size: {
+      xs: "h-6 gap-1 rounded-[calc(var(--radius)-3px)] px-1.5 [&>svg:not([class*='size-'])]:size-3.5",
+      sm: "",
+      "icon-xs": "size-6 rounded-[calc(var(--radius)-3px)] p-0 has-[>svg]:p-0",
+      "icon-sm": "size-8 p-0 has-[>svg]:p-0",
     },
-  }
-)
+  },
+  defaultVariants: {
+    size: "xs",
+  },
+});
 
 function InputGroupButton({
   className,
@@ -91,7 +85,7 @@ function InputGroupButton({
   ...props
 }: Omit<React.ComponentProps<typeof Button>, "size" | "type"> &
   VariantProps<typeof inputGroupButtonVariants> & {
-    type?: "button" | "submit" | "reset"
+    type?: "button" | "submit" | "reset";
   }) {
   return (
     <Button
@@ -101,7 +95,7 @@ function InputGroupButton({
       className={cn(inputGroupButtonVariants({ size }), className)}
       {...props}
     />
-  )
+  );
 }
 
 function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
@@ -109,43 +103,37 @@ function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
     <span
       className={cn(
         "flex items-center gap-2 text-sm text-muted-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function InputGroupInput({
-  className,
-  ...props
-}: React.ComponentProps<"input">) {
+function InputGroupInput({ className, ...props }: React.ComponentProps<"input">) {
   return (
     <Input
       data-slot="input-group-control"
       className={cn(
         "flex-1 rounded-none border-0 bg-transparent shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function InputGroupTextarea({
-  className,
-  ...props
-}: React.ComponentProps<"textarea">) {
+function InputGroupTextarea({ className, ...props }: React.ComponentProps<"textarea">) {
   return (
     <Textarea
       data-slot="input-group-control"
       className={cn(
         "flex-1 resize-none rounded-none border-0 bg-transparent py-2 shadow-none ring-0 focus-visible:ring-0 disabled:bg-transparent aria-invalid:ring-0 dark:bg-transparent dark:disabled:bg-transparent",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -155,4 +143,4 @@ export {
   InputGroupText,
   InputGroupInput,
   InputGroupTextarea,
-}
+};
diff --git a/apps/web/app/components/ui/input.tsx b/apps/web/app/components/ui/input.tsx
index f293fc0..3c6b317 100644
--- a/apps/web/app/components/ui/input.tsx
+++ b/apps/web/app/components/ui/input.tsx
@@ -1,7 +1,7 @@
-import * as React from "react"
-import { Input as InputPrimitive } from "@base-ui/react/input"
+import * as React from "react";
+import { Input as InputPrimitive } from "@base-ui/react/input";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Input({ className, type, ...props }: React.ComponentProps<"input">) {
   return (
@@ -10,11 +10,11 @@ function Input({ className, type, ...props }: React.ComponentProps<"input">) {
       data-slot="input"
       className={cn(
         "h-8 w-full min-w-0 rounded-lg border border-input bg-transparent px-2.5 py-1 text-base transition-colors outline-none file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export { Input }
+export { Input };
diff --git a/apps/web/app/components/ui/item.tsx b/apps/web/app/components/ui/item.tsx
index 032bf9c..493b6cc 100644
--- a/apps/web/app/components/ui/item.tsx
+++ b/apps/web/app/components/ui/item.tsx
@@ -1,10 +1,10 @@
-import * as React from "react"
-import { mergeProps } from "@base-ui/react/merge-props"
-import { useRender } from "@base-ui/react/use-render"
-import { cva, type VariantProps } from "class-variance-authority"
+import * as React from "react";
+import { mergeProps } from "@base-ui/react/merge-props";
+import { useRender } from "@base-ui/react/use-render";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
-import { Separator } from "~/components/ui/separator"
+import { cn } from "~/lib/utils";
+import { Separator } from "~/components/ui/separator";
 
 function ItemGroup({ className, ...props }: React.ComponentProps<"div">) {
   return (
@@ -13,17 +13,14 @@ function ItemGroup({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="item-group"
       className={cn(
         "group/item-group flex w-full flex-col gap-4 has-data-[size=sm]:gap-2.5 has-data-[size=xs]:gap-2",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function ItemSeparator({
-  className,
-  ...props
-}: React.ComponentProps<typeof Separator>) {
+function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>) {
   return (
     <Separator
       data-slot="item-separator"
@@ -31,7 +28,7 @@ function ItemSeparator({
       className={cn("my-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 const itemVariants = cva(
@@ -53,8 +50,8 @@ const itemVariants = cva(
       variant: "default",
       size: "default",
     },
-  }
-)
+  },
+);
 
 function Item({
   className,
@@ -69,7 +66,7 @@ function Item({
       {
         className: cn(itemVariants({ variant, size, className })),
       },
-      props
+      props,
     ),
     render,
     state: {
@@ -77,7 +74,7 @@ function Item({
       variant,
       size,
     },
-  })
+  });
 }
 
 const itemMediaVariants = cva(
@@ -94,8 +91,8 @@ const itemMediaVariants = cva(
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
 function ItemMedia({
   className,
@@ -109,7 +106,7 @@ function ItemMedia({
       className={cn(itemMediaVariants({ variant, className }))}
       {...props}
     />
-  )
+  );
 }
 
 function ItemContent({ className, ...props }: React.ComponentProps<"div">) {
@@ -118,11 +115,11 @@ function ItemContent({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="item-content"
       className={cn(
         "flex flex-1 flex-col gap-1 group-data-[size=xs]/item:gap-0 [&+[data-slot=item-content]]:flex-none",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function ItemTitle({ className, ...props }: React.ComponentProps<"div">) {
@@ -131,11 +128,11 @@ function ItemTitle({ className, ...props }: React.ComponentProps<"div">) {
       data-slot="item-title"
       className={cn(
         "line-clamp-1 flex w-fit items-center gap-2 text-sm leading-snug font-medium underline-offset-4",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function ItemDescription({ className, ...props }: React.ComponentProps<"p">) {
@@ -144,47 +141,37 @@ function ItemDescription({ className, ...props }: React.ComponentProps<"p">) {
       data-slot="item-description"
       className={cn(
         "line-clamp-2 text-left text-sm leading-normal font-normal text-muted-foreground group-data-[size=xs]/item:text-xs [&>a]:underline [&>a]:underline-offset-4 [&>a:hover]:text-primary",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function ItemActions({ className, ...props }: React.ComponentProps<"div">) {
   return (
-    <div
-      data-slot="item-actions"
-      className={cn("flex items-center gap-2", className)}
-      {...props}
-    />
-  )
+    <div data-slot="item-actions" className={cn("flex items-center gap-2", className)} {...props} />
+  );
 }
 
 function ItemHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="item-header"
-      className={cn(
-        "flex basis-full items-center justify-between gap-2",
-        className
-      )}
+      className={cn("flex basis-full items-center justify-between gap-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 function ItemFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="item-footer"
-      className={cn(
-        "flex basis-full items-center justify-between gap-2",
-        className
-      )}
+      className={cn("flex basis-full items-center justify-between gap-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -198,4 +185,4 @@ export {
   ItemDescription,
   ItemHeader,
   ItemFooter,
-}
+};
diff --git a/apps/web/app/components/ui/label.tsx b/apps/web/app/components/ui/label.tsx
index 7bd207a..1e3dcce 100644
--- a/apps/web/app/components/ui/label.tsx
+++ b/apps/web/app/components/ui/label.tsx
@@ -1,6 +1,6 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Label({ className, ...props }: React.ComponentProps<"label">) {
   return (
@@ -8,11 +8,11 @@ function Label({ className, ...props }: React.ComponentProps<"label">) {
       data-slot="label"
       className={cn(
         "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export { Label }
+export { Label };
diff --git a/apps/web/app/components/ui/native-select.tsx b/apps/web/app/components/ui/native-select.tsx
index 4aca54e..1941d09 100644
--- a/apps/web/app/components/ui/native-select.tsx
+++ b/apps/web/app/components/ui/native-select.tsx
@@ -1,22 +1,18 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
-import { ChevronDownIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { ChevronDownIcon } from "lucide-react";
 
 type NativeSelectProps = Omit<React.ComponentProps<"select">, "size"> & {
-  size?: "sm" | "default"
-}
+  size?: "sm" | "default";
+};
 
-function NativeSelect({
-  className,
-  size = "default",
-  ...props
-}: NativeSelectProps) {
+function NativeSelect({ className, size = "default", ...props }: NativeSelectProps) {
   return (
     <div
       className={cn(
         "group/native-select relative w-fit has-[select:disabled]:opacity-50",
-        className
+        className,
       )}
       data-slot="native-select-wrapper"
       data-size={size}
@@ -27,35 +23,33 @@ function NativeSelect({
         className="h-8 w-full min-w-0 appearance-none rounded-lg border border-input bg-transparent py-1 pr-8 pl-2.5 text-sm transition-colors outline-none select-none selection:bg-primary selection:text-primary-foreground placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:cursor-not-allowed aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 data-[size=sm]:h-7 data-[size=sm]:rounded-[min(var(--radius-md),10px)] data-[size=sm]:py-0.5 dark:bg-input/30 dark:hover:bg-input/50 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40"
         {...props}
       />
-      <ChevronDownIcon className="pointer-events-none absolute top-1/2 right-2.5 size-4 -translate-y-1/2 text-muted-foreground select-none" aria-hidden="true" data-slot="native-select-icon" />
+      <ChevronDownIcon
+        className="pointer-events-none absolute top-1/2 right-2.5 size-4 -translate-y-1/2 text-muted-foreground select-none"
+        aria-hidden="true"
+        data-slot="native-select-icon"
+      />
     </div>
-  )
+  );
 }
 
-function NativeSelectOption({
-  className,
-  ...props
-}: React.ComponentProps<"option">) {
+function NativeSelectOption({ className, ...props }: React.ComponentProps<"option">) {
   return (
     <option
       data-slot="native-select-option"
       className={cn("bg-[Canvas] text-[CanvasText]", className)}
       {...props}
     />
-  )
+  );
 }
 
-function NativeSelectOptGroup({
-  className,
-  ...props
-}: React.ComponentProps<"optgroup">) {
+function NativeSelectOptGroup({ className, ...props }: React.ComponentProps<"optgroup">) {
   return (
     <optgroup
       data-slot="native-select-optgroup"
       className={cn("bg-[Canvas] text-[CanvasText]", className)}
       {...props}
     />
-  )
+  );
 }
 
-export { NativeSelect, NativeSelectOptGroup, NativeSelectOption }
+export { NativeSelect, NativeSelectOptGroup, NativeSelectOption };
diff --git a/apps/web/app/components/ui/pagination.tsx b/apps/web/app/components/ui/pagination.tsx
index 5da3473..221ba0d 100644
--- a/apps/web/app/components/ui/pagination.tsx
+++ b/apps/web/app/components/ui/pagination.tsx
@@ -1,8 +1,8 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
-import { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
+import { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from "lucide-react";
 
 function Pagination({ className, ...props }: React.ComponentProps<"nav">) {
   return (
@@ -13,29 +13,26 @@ function Pagination({ className, ...props }: React.ComponentProps<"nav">) {
       className={cn("mx-auto flex w-full justify-center", className)}
       {...props}
     />
-  )
+  );
 }
 
-function PaginationContent({
-  className,
-  ...props
-}: React.ComponentProps<"ul">) {
+function PaginationContent({ className, ...props }: React.ComponentProps<"ul">) {
   return (
     <ul
       data-slot="pagination-content"
       className={cn("flex items-center gap-0.5", className)}
       {...props}
     />
-  )
+  );
 }
 
 function PaginationItem({ ...props }: React.ComponentProps<"li">) {
-  return <li data-slot="pagination-item" {...props} />
+  return <li data-slot="pagination-item" {...props} />;
 }
 
 type PaginationLinkProps = {
-  isActive?: boolean
-} & Omit<React.ComponentProps<typeof Button>, "variant">
+  isActive?: boolean;
+} & Omit<React.ComponentProps<typeof Button>, "variant">;
 
 function PaginationLink({
   className,
@@ -56,7 +53,7 @@ function PaginationLink({
       data-active={isActive}
       {...props}
     />
-  )
+  );
 }
 
 function PaginationPrevious({
@@ -74,7 +71,7 @@ function PaginationPrevious({
       <ChevronLeftIcon data-icon="inline-start" />
       <span className="hidden sm:block">{text}</span>
     </PaginationLink>
-  )
+  );
 }
 
 function PaginationNext({
@@ -92,28 +89,24 @@ function PaginationNext({
       <span className="hidden sm:block">{text}</span>
       <ChevronRightIcon data-icon="inline-end" />
     </PaginationLink>
-  )
+  );
 }
 
-function PaginationEllipsis({
-  className,
-  ...props
-}: React.ComponentProps<"span">) {
+function PaginationEllipsis({ className, ...props }: React.ComponentProps<"span">) {
   return (
     <span
       aria-hidden
       data-slot="pagination-ellipsis"
       className={cn(
         "flex size-8 items-center justify-center [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
-      <MoreHorizontalIcon
-      />
+      <MoreHorizontalIcon />
       <span className="sr-only">更多页</span>
     </span>
-  )
+  );
 }
 
 export {
@@ -124,4 +117,4 @@ export {
   PaginationLink,
   PaginationNext,
   PaginationPrevious,
-}
+};
diff --git a/apps/web/app/components/ui/radio-group.tsx b/apps/web/app/components/ui/radio-group.tsx
index c25635f..3a47d26 100644
--- a/apps/web/app/components/ui/radio-group.tsx
+++ b/apps/web/app/components/ui/radio-group.tsx
@@ -1,9 +1,9 @@
-"use client"
+"use client";
 
-import { Radio as RadioPrimitive } from "@base-ui/react/radio"
-import { RadioGroup as RadioGroupPrimitive } from "@base-ui/react/radio-group"
+import { Radio as RadioPrimitive } from "@base-ui/react/radio";
+import { RadioGroup as RadioGroupPrimitive } from "@base-ui/react/radio-group";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function RadioGroup({ className, ...props }: RadioGroupPrimitive.Props) {
   return (
@@ -12,7 +12,7 @@ function RadioGroup({ className, ...props }: RadioGroupPrimitive.Props) {
       className={cn("grid w-full gap-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 function RadioGroupItem({ className, ...props }: RadioPrimitive.Root.Props) {
@@ -21,7 +21,7 @@ function RadioGroupItem({ className, ...props }: RadioPrimitive.Root.Props) {
       data-slot="radio-group-item"
       className={cn(
         "group/radio-group-item peer relative flex aspect-square size-4 shrink-0 rounded-full border border-input outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-primary dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-primary data-checked:bg-primary data-checked:text-primary-foreground dark:data-checked:bg-primary",
-        className
+        className,
       )}
       {...props}
     >
@@ -32,7 +32,7 @@ function RadioGroupItem({ className, ...props }: RadioPrimitive.Root.Props) {
         <span className="absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-primary-foreground" />
       </RadioPrimitive.Indicator>
     </RadioPrimitive.Root>
-  )
+  );
 }
 
-export { RadioGroup, RadioGroupItem }
+export { RadioGroup, RadioGroupItem };
diff --git a/apps/web/app/components/ui/select.tsx b/apps/web/app/components/ui/select.tsx
index 8d70d29..45783b6 100644
--- a/apps/web/app/components/ui/select.tsx
+++ b/apps/web/app/components/ui/select.tsx
@@ -1,10 +1,10 @@
-import * as React from "react"
-import { Select as SelectPrimitive } from "@base-ui/react/select"
+import * as React from "react";
+import { Select as SelectPrimitive } from "@base-ui/react/select";
 
-import { cn } from "~/lib/utils"
-import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react";
 
-const Select = SelectPrimitive.Root
+const Select = SelectPrimitive.Root;
 
 function SelectGroup({ className, ...props }: SelectPrimitive.Group.Props) {
   return (
@@ -13,7 +13,7 @@ function SelectGroup({ className, ...props }: SelectPrimitive.Group.Props) {
       className={cn("scroll-my-1 p-1", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SelectValue({ className, ...props }: SelectPrimitive.Value.Props) {
@@ -23,7 +23,7 @@ function SelectValue({ className, ...props }: SelectPrimitive.Value.Props) {
       className={cn("flex flex-1 text-left", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SelectTrigger({
@@ -32,7 +32,7 @@ function SelectTrigger({
   children,
   ...props
 }: SelectPrimitive.Trigger.Props & {
-  size?: "sm" | "default"
+  size?: "sm" | "default";
 }) {
   return (
     <SelectPrimitive.Trigger
@@ -40,18 +40,16 @@ function SelectTrigger({
       data-size={size}
       className={cn(
         "flex w-fit items-center justify-between gap-1.5 rounded-lg border border-input bg-transparent py-2 pr-2 pl-2.5 text-sm whitespace-nowrap transition-colors outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 data-placeholder:text-muted-foreground data-[size=default]:h-8 data-[size=sm]:h-7 data-[size=sm]:rounded-[min(var(--radius-md),10px)] *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-1.5 dark:bg-input/30 dark:hover:bg-input/50 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
       {children}
       <SelectPrimitive.Icon
-        render={
-          <ChevronDownIcon className="pointer-events-none size-4 text-muted-foreground" />
-        }
+        render={<ChevronDownIcon className="pointer-events-none size-4 text-muted-foreground" />}
       />
     </SelectPrimitive.Trigger>
-  )
+  );
 }
 
 function SelectContent({
@@ -81,7 +79,10 @@ function SelectContent({
         <SelectPrimitive.Popup
           data-slot="select-content"
           data-align-trigger={alignItemWithTrigger}
-          className={cn("relative isolate z-50 max-h-(--available-height) w-(--anchor-width) min-w-36 origin-(--transform-origin) overflow-x-hidden overflow-y-auto rounded-lg bg-popover text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 data-[align-trigger=true]:animate-none data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", className )}
+          className={cn(
+            "relative isolate z-50 max-h-(--available-height) w-(--anchor-width) min-w-36 origin-(--transform-origin) overflow-x-hidden overflow-y-auto rounded-lg bg-popover text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 data-[align-trigger=true]:animate-none data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+            className,
+          )}
           {...props}
         >
           <SelectScrollUpButton />
@@ -90,33 +91,26 @@ function SelectContent({
         </SelectPrimitive.Popup>
       </SelectPrimitive.Positioner>
     </SelectPrimitive.Portal>
-  )
+  );
 }
 
-function SelectLabel({
-  className,
-  ...props
-}: SelectPrimitive.GroupLabel.Props) {
+function SelectLabel({ className, ...props }: SelectPrimitive.GroupLabel.Props) {
   return (
     <SelectPrimitive.GroupLabel
       data-slot="select-label"
       className={cn("px-1.5 py-1 text-xs text-muted-foreground", className)}
       {...props}
     />
-  )
+  );
 }
 
-function SelectItem({
-  className,
-  children,
-  ...props
-}: SelectPrimitive.Item.Props) {
+function SelectItem({ className, children, ...props }: SelectPrimitive.Item.Props) {
   return (
     <SelectPrimitive.Item
       data-slot="select-item"
       className={cn(
         "relative flex w-full cursor-default items-center gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2",
-        className
+        className,
       )}
       {...props}
     >
@@ -131,20 +125,17 @@ function SelectItem({
         <CheckIcon className="pointer-events-none" />
       </SelectPrimitive.ItemIndicator>
     </SelectPrimitive.Item>
-  )
+  );
 }
 
-function SelectSeparator({
-  className,
-  ...props
-}: SelectPrimitive.Separator.Props) {
+function SelectSeparator({ className, ...props }: SelectPrimitive.Separator.Props) {
   return (
     <SelectPrimitive.Separator
       data-slot="select-separator"
       className={cn("pointer-events-none -mx-1 my-1 h-px bg-border", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SelectScrollUpButton({
@@ -156,14 +147,13 @@ function SelectScrollUpButton({
       data-slot="select-scroll-up-button"
       className={cn(
         "top-0 z-10 flex w-full cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
-      <ChevronUpIcon
-      />
+      <ChevronUpIcon />
     </SelectPrimitive.ScrollUpArrow>
-  )
+  );
 }
 
 function SelectScrollDownButton({
@@ -175,14 +165,13 @@ function SelectScrollDownButton({
       data-slot="select-scroll-down-button"
       className={cn(
         "bottom-0 z-10 flex w-full cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
-        className
+        className,
       )}
       {...props}
     >
-      <ChevronDownIcon
-      />
+      <ChevronDownIcon />
     </SelectPrimitive.ScrollDownArrow>
-  )
+  );
 }
 
 export {
@@ -196,4 +185,4 @@ export {
   SelectSeparator,
   SelectTrigger,
   SelectValue,
-}
+};
diff --git a/apps/web/app/components/ui/separator.tsx b/apps/web/app/components/ui/separator.tsx
index 57bd87c..dedd554 100644
--- a/apps/web/app/components/ui/separator.tsx
+++ b/apps/web/app/components/ui/separator.tsx
@@ -1,25 +1,21 @@
-"use client"
+"use client";
 
-import { Separator as SeparatorPrimitive } from "@base-ui/react/separator"
+import { Separator as SeparatorPrimitive } from "@base-ui/react/separator";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
-function Separator({
-  className,
-  orientation = "horizontal",
-  ...props
-}: SeparatorPrimitive.Props) {
+function Separator({ className, orientation = "horizontal", ...props }: SeparatorPrimitive.Props) {
   return (
     <SeparatorPrimitive
       data-slot="separator"
       orientation={orientation}
       className={cn(
         "shrink-0 bg-border data-horizontal:h-px data-horizontal:w-full data-vertical:w-px data-vertical:self-stretch",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export { Separator }
+export { Separator };
diff --git a/apps/web/app/components/ui/sheet.tsx b/apps/web/app/components/ui/sheet.tsx
index 756dd2a..b48ecb3 100644
--- a/apps/web/app/components/ui/sheet.tsx
+++ b/apps/web/app/components/ui/sheet.tsx
@@ -1,24 +1,24 @@
-import * as React from "react"
-import { Dialog as SheetPrimitive } from "@base-ui/react/dialog"
+import * as React from "react";
+import { Dialog as SheetPrimitive } from "@base-ui/react/dialog";
 
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
-import { XIcon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
+import { XIcon } from "lucide-react";
 
 function Sheet({ ...props }: SheetPrimitive.Root.Props) {
-  return <SheetPrimitive.Root data-slot="sheet" {...props} />
+  return <SheetPrimitive.Root data-slot="sheet" {...props} />;
 }
 
 function SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props) {
-  return <SheetPrimitive.Trigger data-slot="sheet-trigger" {...props} />
+  return <SheetPrimitive.Trigger data-slot="sheet-trigger" {...props} />;
 }
 
 function SheetClose({ ...props }: SheetPrimitive.Close.Props) {
-  return <SheetPrimitive.Close data-slot="sheet-close" {...props} />
+  return <SheetPrimitive.Close data-slot="sheet-close" {...props} />;
 }
 
 function SheetPortal({ ...props }: SheetPrimitive.Portal.Props) {
-  return <SheetPrimitive.Portal data-slot="sheet-portal" {...props} />
+  return <SheetPrimitive.Portal data-slot="sheet-portal" {...props} />;
 }
 
 function SheetOverlay({ className, ...props }: SheetPrimitive.Backdrop.Props) {
@@ -27,11 +27,11 @@ function SheetOverlay({ className, ...props }: SheetPrimitive.Backdrop.Props) {
       data-slot="sheet-overlay"
       className={cn(
         "fixed inset-0 z-50 bg-black/10 transition-opacity duration-150 data-ending-style:opacity-0 data-starting-style:opacity-0 supports-backdrop-filter:backdrop-blur-xs",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function SheetContent({
@@ -41,8 +41,8 @@ function SheetContent({
   showCloseButton = true,
   ...props
 }: SheetPrimitive.Popup.Props & {
-  side?: "top" | "right" | "bottom" | "left"
-  showCloseButton?: boolean
+  side?: "top" | "right" | "bottom" | "left";
+  showCloseButton?: boolean;
 }) {
   return (
     <SheetPortal>
@@ -52,7 +52,7 @@ function SheetContent({
         data-side={side}
         className={cn(
           "fixed z-50 flex max-h-[100dvh] flex-col gap-4 overflow-y-auto overscroll-contain bg-popover bg-clip-padding pt-[env(safe-area-inset-top)] pr-[env(safe-area-inset-right)] pb-[env(safe-area-inset-bottom)] pl-[env(safe-area-inset-left)] text-sm text-popover-foreground shadow-lg transition duration-200 ease-in-out data-ending-style:opacity-0 data-starting-style:opacity-0 data-[side=bottom]:inset-x-0 data-[side=bottom]:bottom-0 data-[side=bottom]:h-auto data-[side=bottom]:border-t data-[side=bottom]:data-ending-style:translate-y-[2.5rem] data-[side=bottom]:data-starting-style:translate-y-[2.5rem] data-[side=left]:inset-y-0 data-[side=left]:left-0 data-[side=left]:h-full data-[side=left]:w-3/4 data-[side=left]:border-r data-[side=left]:data-ending-style:translate-x-[-2.5rem] data-[side=left]:data-starting-style:translate-x-[-2.5rem] data-[side=right]:inset-y-0 data-[side=right]:right-0 data-[side=right]:h-full data-[side=right]:w-3/4 data-[side=right]:border-l data-[side=right]:data-ending-style:translate-x-[2.5rem] data-[side=right]:data-starting-style:translate-x-[2.5rem] data-[side=top]:inset-x-0 data-[side=top]:top-0 data-[side=top]:h-auto data-[side=top]:border-b data-[side=top]:data-ending-style:translate-y-[-2.5rem] data-[side=top]:data-starting-style:translate-y-[-2.5rem] data-[side=left]:sm:max-w-sm data-[side=right]:sm:max-w-sm",
-          className
+          className,
         )}
         {...props}
       >
@@ -60,22 +60,15 @@ function SheetContent({
         {showCloseButton && (
           <SheetPrimitive.Close
             data-slot="sheet-close"
-            render={
-              <Button
-                variant="ghost"
-                className="absolute top-3 right-3"
-                size="icon-sm"
-              />
-            }
+            render={<Button variant="ghost" className="absolute top-3 right-3" size="icon-sm" />}
           >
-            <XIcon
-            />
+            <XIcon />
             <span className="sr-only">关闭</span>
           </SheetPrimitive.Close>
         )}
       </SheetPrimitive.Popup>
     </SheetPortal>
-  )
+  );
 }
 
 function SheetHeader({ className, ...props }: React.ComponentProps<"div">) {
@@ -85,7 +78,7 @@ function SheetHeader({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("flex flex-col gap-0.5 p-4", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
@@ -95,33 +88,27 @@ function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("mt-auto flex flex-col gap-2 p-4", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SheetTitle({ className, ...props }: SheetPrimitive.Title.Props) {
   return (
     <SheetPrimitive.Title
       data-slot="sheet-title"
-      className={cn(
-        "text-base font-medium text-foreground",
-        className
-      )}
+      className={cn("text-base font-medium text-foreground", className)}
       {...props}
     />
-  )
+  );
 }
 
-function SheetDescription({
-  className,
-  ...props
-}: SheetPrimitive.Description.Props) {
+function SheetDescription({ className, ...props }: SheetPrimitive.Description.Props) {
   return (
     <SheetPrimitive.Description
       data-slot="sheet-description"
       className={cn("text-sm text-muted-foreground", className)}
       {...props}
     />
-  )
+  );
 }
 
 export {
@@ -133,4 +120,4 @@ export {
   SheetFooter,
   SheetTitle,
   SheetDescription,
-}
+};
diff --git a/apps/web/app/components/ui/sidebar.tsx b/apps/web/app/components/ui/sidebar.tsx
index 2ccf619..9d7a273 100644
--- a/apps/web/app/components/ui/sidebar.tsx
+++ b/apps/web/app/components/ui/sidebar.tsx
@@ -1,54 +1,50 @@
-import * as React from "react"
-import { mergeProps } from "@base-ui/react/merge-props"
-import { useRender } from "@base-ui/react/use-render"
-import { cva, type VariantProps } from "class-variance-authority"
-
-import { useIsMobile } from "~/hooks/use-mobile"
-import { cn } from "~/lib/utils"
-import { Button } from "~/components/ui/button"
-import { Input } from "~/components/ui/input"
-import { Separator } from "~/components/ui/separator"
+import * as React from "react";
+import { mergeProps } from "@base-ui/react/merge-props";
+import { useRender } from "@base-ui/react/use-render";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { useIsMobile } from "~/hooks/use-mobile";
+import { cn } from "~/lib/utils";
+import { Button } from "~/components/ui/button";
+import { Input } from "~/components/ui/input";
+import { Separator } from "~/components/ui/separator";
 import {
   Sheet,
   SheetContent,
   SheetDescription,
   SheetHeader,
   SheetTitle,
-} from "~/components/ui/sheet"
-import { Skeleton } from "~/components/ui/skeleton"
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipTrigger,
-} from "~/components/ui/tooltip"
-import { PanelLeftIcon } from "lucide-react"
-
-const SIDEBAR_COOKIE_NAME = "sidebar_state"
-const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7
-const SIDEBAR_WIDTH = "16rem"
-const SIDEBAR_WIDTH_MOBILE = "18rem"
-const SIDEBAR_WIDTH_ICON = "3rem"
-const SIDEBAR_KEYBOARD_SHORTCUT = "b"
+} from "~/components/ui/sheet";
+import { Skeleton } from "~/components/ui/skeleton";
+import { Tooltip, TooltipContent, TooltipTrigger } from "~/components/ui/tooltip";
+import { PanelLeftIcon } from "lucide-react";
+
+const SIDEBAR_COOKIE_NAME = "sidebar_state";
+const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+const SIDEBAR_WIDTH = "16rem";
+const SIDEBAR_WIDTH_MOBILE = "18rem";
+const SIDEBAR_WIDTH_ICON = "3rem";
+const SIDEBAR_KEYBOARD_SHORTCUT = "b";
 
 type SidebarContextProps = {
-  state: "expanded" | "collapsed"
-  open: boolean
-  setOpen: (open: boolean) => void
-  openMobile: boolean
-  setOpenMobile: (open: boolean) => void
-  isMobile: boolean
-  toggleSidebar: () => void
-}
+  state: "expanded" | "collapsed";
+  open: boolean;
+  setOpen: (open: boolean) => void;
+  openMobile: boolean;
+  setOpenMobile: (open: boolean) => void;
+  isMobile: boolean;
+  toggleSidebar: () => void;
+};
 
-const SidebarContext = React.createContext<SidebarContextProps | null>(null)
+const SidebarContext = React.createContext<SidebarContextProps | null>(null);
 
 function useSidebar() {
-  const context = React.useContext(SidebarContext)
+  const context = React.useContext(SidebarContext);
   if (!context) {
-    throw new Error("useSidebar must be used within a SidebarProvider.")
+    throw new Error("useSidebar must be used within a SidebarProvider.");
   }
 
-  return context
+  return context;
 }
 
 function SidebarProvider({
@@ -60,56 +56,53 @@ function SidebarProvider({
   children,
   ...props
 }: React.ComponentProps<"div"> & {
-  defaultOpen?: boolean
-  open?: boolean
-  onOpenChange?: (open: boolean) => void
+  defaultOpen?: boolean;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
 }) {
-  const isMobile = useIsMobile()
-  const [openMobile, setOpenMobile] = React.useState(false)
+  const isMobile = useIsMobile();
+  const [openMobile, setOpenMobile] = React.useState(false);
 
   // This is the internal state of the sidebar.
   // We use openProp and setOpenProp for control from outside the component.
-  const [_open, _setOpen] = React.useState(defaultOpen)
-  const open = openProp ?? _open
+  const [_open, _setOpen] = React.useState(defaultOpen);
+  const open = openProp ?? _open;
   const setOpen = React.useCallback(
     (value: boolean | ((value: boolean) => boolean)) => {
-      const openState = typeof value === "function" ? value(open) : value
+      const openState = typeof value === "function" ? value(open) : value;
       if (setOpenProp) {
-        setOpenProp(openState)
+        setOpenProp(openState);
       } else {
-        _setOpen(openState)
+        _setOpen(openState);
       }
 
       // This sets the cookie to keep the sidebar state.
-      document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`
+      document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
     },
-    [setOpenProp, open]
-  )
+    [setOpenProp, open],
+  );
 
   // Helper to toggle the sidebar.
   const toggleSidebar = React.useCallback(() => {
-    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open)
-  }, [isMobile, setOpen, setOpenMobile])
+    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);
+  }, [isMobile, setOpen, setOpenMobile]);
 
   // Adds a keyboard shortcut to toggle the sidebar.
   React.useEffect(() => {
     const handleKeyDown = (event: KeyboardEvent) => {
-      if (
-        event.key === SIDEBAR_KEYBOARD_SHORTCUT &&
-        (event.metaKey || event.ctrlKey)
-      ) {
-        event.preventDefault()
-        toggleSidebar()
+      if (event.key === SIDEBAR_KEYBOARD_SHORTCUT && (event.metaKey || event.ctrlKey)) {
+        event.preventDefault();
+        toggleSidebar();
       }
-    }
+    };
 
-    window.addEventListener("keydown", handleKeyDown)
-    return () => window.removeEventListener("keydown", handleKeyDown)
-  }, [toggleSidebar])
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [toggleSidebar]);
 
   // We add a state so that we can do data-state="expanded" or "collapsed".
   // This makes it easier to style the sidebar with Tailwind classes.
-  const state = open ? "expanded" : "collapsed"
+  const state = open ? "expanded" : "collapsed";
 
   const contextValue = React.useMemo<SidebarContextProps>(
     () => ({
@@ -121,8 +114,8 @@ function SidebarProvider({
       setOpenMobile,
       toggleSidebar,
     }),
-    [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar]
-  )
+    [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar],
+  );
 
   return (
     <SidebarContext.Provider value={contextValue}>
@@ -137,14 +130,14 @@ function SidebarProvider({
         }
         className={cn(
           "group/sidebar-wrapper flex min-h-svh w-full has-data-[variant=inset]:bg-sidebar",
-          className
+          className,
         )}
         {...props}
       >
         {children}
       </div>
     </SidebarContext.Provider>
-  )
+  );
 }
 
 function Sidebar({
@@ -156,11 +149,11 @@ function Sidebar({
   dir,
   ...props
 }: React.ComponentProps<"div"> & {
-  side?: "left" | "right"
-  variant?: "sidebar" | "floating" | "inset"
-  collapsible?: "offcanvas" | "icon" | "none"
+  side?: "left" | "right";
+  variant?: "sidebar" | "floating" | "inset";
+  collapsible?: "offcanvas" | "icon" | "none";
 }) {
-  const { isMobile, state, openMobile, setOpenMobile } = useSidebar()
+  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();
 
   if (collapsible === "none") {
     return (
@@ -168,13 +161,13 @@ function Sidebar({
         data-slot="sidebar"
         className={cn(
           "flex h-full w-(--sidebar-width) flex-col bg-sidebar text-sidebar-foreground",
-          className
+          className,
         )}
         {...props}
       >
         {children}
       </div>
-    )
+    );
   }
 
   if (isMobile) {
@@ -200,7 +193,7 @@ function Sidebar({
           <div className="flex h-full w-full flex-col">{children}</div>
         </SheetContent>
       </Sheet>
-    )
+    );
   }
 
   return (
@@ -221,7 +214,7 @@ function Sidebar({
           "group-data-[side=right]:rotate-180",
           variant === "floating" || variant === "inset"
             ? "group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]"
-            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)"
+            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)",
         )}
       />
       <div
@@ -233,7 +226,7 @@ function Sidebar({
           variant === "floating" || variant === "inset"
             ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"
             : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",
-          className
+          className,
         )}
         {...props}
       >
@@ -246,15 +239,11 @@ function Sidebar({
         </div>
       </div>
     </div>
-  )
+  );
 }
 
-function SidebarTrigger({
-  className,
-  onClick,
-  ...props
-}: React.ComponentProps<typeof Button>) {
-  const { toggleSidebar } = useSidebar()
+function SidebarTrigger({ className, onClick, ...props }: React.ComponentProps<typeof Button>) {
+  const { toggleSidebar } = useSidebar();
 
   return (
     <Button
@@ -264,19 +253,19 @@ function SidebarTrigger({
       size="icon-sm"
       className={cn(className)}
       onClick={(event) => {
-        onClick?.(event)
-        toggleSidebar()
+        onClick?.(event);
+        toggleSidebar();
       }}
       {...props}
     >
       <PanelLeftIcon />
       <span className="sr-only">切换侧边栏</span>
     </Button>
-  )
+  );
 }
 
 function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
-  const { toggleSidebar } = useSidebar()
+  const { toggleSidebar } = useSidebar();
 
   return (
     <button
@@ -293,11 +282,11 @@ function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
         "group-data-[collapsible=offcanvas]:translate-x-0 group-data-[collapsible=offcanvas]:after:left-full hover:group-data-[collapsible=offcanvas]:bg-sidebar",
         "[[data-side=left][data-collapsible=offcanvas]_&]:-right-2",
         "[[data-side=right][data-collapsible=offcanvas]_&]:-left-2",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
@@ -306,17 +295,14 @@ function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
       data-slot="sidebar-inset"
       className={cn(
         "relative flex w-full flex-1 flex-col bg-background md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function SidebarInput({
-  className,
-  ...props
-}: React.ComponentProps<typeof Input>) {
+function SidebarInput({ className, ...props }: React.ComponentProps<typeof Input>) {
   return (
     <Input
       data-slot="sidebar-input"
@@ -324,7 +310,7 @@ function SidebarInput({
       className={cn("h-8 w-full bg-background shadow-none", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
@@ -335,7 +321,7 @@ function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("flex flex-col gap-2 p-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
@@ -346,13 +332,10 @@ function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("flex flex-col gap-2 p-2", className)}
       {...props}
     />
-  )
+  );
 }
 
-function SidebarSeparator({
-  className,
-  ...props
-}: React.ComponentProps<typeof Separator>) {
+function SidebarSeparator({ className, ...props }: React.ComponentProps<typeof Separator>) {
   return (
     <Separator
       data-slot="sidebar-separator"
@@ -360,7 +343,7 @@ function SidebarSeparator({
       className={cn("mx-2 w-auto bg-sidebar-border", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
@@ -370,11 +353,11 @@ function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
       data-sidebar="content"
       className={cn(
         "no-scrollbar flex min-h-0 flex-1 flex-col gap-0 overflow-auto group-data-[collapsible=icon]:overflow-hidden",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
@@ -385,7 +368,7 @@ function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("relative flex w-full min-w-0 flex-col p-2", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarGroupLabel({
@@ -399,17 +382,17 @@ function SidebarGroupLabel({
       {
         className: cn(
           "flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium text-sidebar-foreground/70 ring-sidebar-ring outline-hidden transition-[margin,opacity] duration-200 ease-linear group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0 focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
-          className
+          className,
         ),
       },
-      props
+      props,
     ),
     render,
     state: {
       slot: "sidebar-group-label",
       sidebar: "group-label",
     },
-  })
+  });
 }
 
 function SidebarGroupAction({
@@ -423,23 +406,20 @@ function SidebarGroupAction({
       {
         className: cn(
           "absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground ring-sidebar-ring outline-hidden transition-transform group-data-[collapsible=icon]:hidden after:absolute after:-inset-2 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 md:after:hidden [&>svg]:size-4 [&>svg]:shrink-0",
-          className
+          className,
         ),
       },
-      props
+      props,
     ),
     render,
     state: {
       slot: "sidebar-group-action",
       sidebar: "group-action",
     },
-  })
+  });
 }
 
-function SidebarGroupContent({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function SidebarGroupContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="sidebar-group-content"
@@ -447,7 +427,7 @@ function SidebarGroupContent({
       className={cn("w-full text-sm", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
@@ -458,7 +438,7 @@ function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
       className={cn("flex w-full min-w-0 flex-col gap-0", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
@@ -469,7 +449,7 @@ function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
       className={cn("group/menu-item relative", className)}
       {...props}
     />
-  )
+  );
 }
 
 const sidebarMenuButtonVariants = cva(
@@ -491,8 +471,8 @@ const sidebarMenuButtonVariants = cva(
       variant: "default",
       size: "default",
     },
-  }
-)
+  },
+);
 
 function SidebarMenuButton({
   render,
@@ -504,17 +484,17 @@ function SidebarMenuButton({
   ...props
 }: useRender.ComponentProps<"button"> &
   React.ComponentProps<"button"> & {
-    isActive?: boolean
-    tooltip?: string | React.ComponentProps<typeof TooltipContent>
+    isActive?: boolean;
+    tooltip?: string | React.ComponentProps<typeof TooltipContent>;
   } & VariantProps<typeof sidebarMenuButtonVariants>) {
-  const { isMobile, state } = useSidebar()
+  const { isMobile, state } = useSidebar();
   const comp = useRender({
     defaultTagName: "button",
     props: mergeProps<"button">(
       {
         className: cn(sidebarMenuButtonVariants({ variant, size }), className),
       },
-      props
+      props,
     ),
     render: !tooltip ? render : <TooltipTrigger render={render} />,
     state: {
@@ -523,16 +503,16 @@ function SidebarMenuButton({
       size,
       active: isActive,
     },
-  })
+  });
 
   if (!tooltip) {
-    return comp
+    return comp;
   }
 
   if (typeof tooltip === "string") {
     tooltip = {
       children: tooltip,
-    }
+    };
   }
 
   return (
@@ -545,7 +525,7 @@ function SidebarMenuButton({
         {...tooltip}
       />
     </Tooltip>
-  )
+  );
 }
 
 function SidebarMenuAction({
@@ -555,7 +535,7 @@ function SidebarMenuAction({
   ...props
 }: useRender.ComponentProps<"button"> &
   React.ComponentProps<"button"> & {
-    showOnHover?: boolean
+    showOnHover?: boolean;
   }) {
   return useRender({
     defaultTagName: "button",
@@ -565,34 +545,31 @@ function SidebarMenuAction({
           "absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground ring-sidebar-ring outline-hidden transition-transform group-data-[collapsible=icon]:hidden peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 after:absolute after:-inset-2 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 md:after:hidden [&>svg]:size-4 [&>svg]:shrink-0",
           showOnHover &&
             "group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 peer-data-active/menu-button:text-sidebar-accent-foreground aria-expanded:opacity-100 md:opacity-0",
-          className
+          className,
         ),
       },
-      props
+      props,
     ),
     render,
     state: {
       slot: "sidebar-menu-action",
       sidebar: "menu-action",
     },
-  })
+  });
 }
 
-function SidebarMenuBadge({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
+function SidebarMenuBadge({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
       data-slot="sidebar-menu-badge"
       data-sidebar="menu-badge"
       className={cn(
         "pointer-events-none absolute right-1 flex h-5 min-w-5 items-center justify-center rounded-md px-1 text-xs font-medium text-sidebar-foreground tabular-nums select-none group-data-[collapsible=icon]:hidden peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 peer-data-active/menu-button:text-sidebar-accent-foreground",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarMenuSkeleton({
@@ -600,12 +577,12 @@ function SidebarMenuSkeleton({
   showIcon = false,
   ...props
 }: React.ComponentProps<"div"> & {
-  showIcon?: boolean
+  showIcon?: boolean;
 }) {
   // Random width between 50 to 90%.
   const [width] = React.useState(() => {
-    return `${Math.floor(Math.random() * 40) + 50}%`
-  })
+    return `${Math.floor(Math.random() * 40) + 50}%`;
+  });
 
   return (
     <div
@@ -614,12 +591,7 @@ function SidebarMenuSkeleton({
       className={cn("flex h-8 items-center gap-2 rounded-md px-2", className)}
       {...props}
     >
-      {showIcon && (
-        <Skeleton
-          className="size-4 rounded-md"
-          data-sidebar="menu-skeleton-icon"
-        />
-      )}
+      {showIcon && <Skeleton className="size-4 rounded-md" data-sidebar="menu-skeleton-icon" />}
       <Skeleton
         className="h-4 max-w-(--skeleton-width) flex-1"
         data-sidebar="menu-skeleton-text"
@@ -630,7 +602,7 @@ function SidebarMenuSkeleton({
         }
       />
     </div>
-  )
+  );
 }
 
 function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
@@ -640,17 +612,14 @@ function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
       data-sidebar="menu-sub"
       className={cn(
         "mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l border-sidebar-border px-2.5 py-0.5 group-data-[collapsible=icon]:hidden",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-function SidebarMenuSubItem({
-  className,
-  ...props
-}: React.ComponentProps<"li">) {
+function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<"li">) {
   return (
     <li
       data-slot="sidebar-menu-sub-item"
@@ -658,7 +627,7 @@ function SidebarMenuSubItem({
       className={cn("group/menu-sub-item relative", className)}
       {...props}
     />
-  )
+  );
 }
 
 function SidebarMenuSubButton({
@@ -669,8 +638,8 @@ function SidebarMenuSubButton({
   ...props
 }: useRender.ComponentProps<"a"> &
   React.ComponentProps<"a"> & {
-    size?: "sm" | "md"
-    isActive?: boolean
+    size?: "sm" | "md";
+    isActive?: boolean;
   }) {
   return useRender({
     defaultTagName: "a",
@@ -678,10 +647,10 @@ function SidebarMenuSubButton({
       {
         className: cn(
           "flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 text-sidebar-foreground ring-sidebar-ring outline-hidden group-data-[collapsible=icon]:hidden hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[size=md]:text-sm data-[size=sm]:text-xs data-active:bg-sidebar-accent data-active:text-sidebar-accent-foreground [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>svg]:text-sidebar-accent-foreground",
-          className
+          className,
         ),
       },
-      props
+      props,
     ),
     render,
     state: {
@@ -690,7 +659,7 @@ function SidebarMenuSubButton({
       size,
       active: isActive,
     },
-  })
+  });
 }
 
 export {
@@ -718,4 +687,4 @@ export {
   SidebarSeparator,
   SidebarTrigger,
   useSidebar,
-}
+};
diff --git a/apps/web/app/components/ui/skeleton.tsx b/apps/web/app/components/ui/skeleton.tsx
index 91720f2..8c659cd 100644
--- a/apps/web/app/components/ui/skeleton.tsx
+++ b/apps/web/app/components/ui/skeleton.tsx
@@ -1,4 +1,4 @@
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
   return (
@@ -7,7 +7,7 @@ function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
       className={cn("animate-pulse rounded-md bg-muted", className)}
       {...props}
     />
-  )
+  );
 }
 
-export { Skeleton }
+export { Skeleton };
diff --git a/apps/web/app/components/ui/sonner.tsx b/apps/web/app/components/ui/sonner.tsx
index 9280ee5..7cbe96b 100644
--- a/apps/web/app/components/ui/sonner.tsx
+++ b/apps/web/app/components/ui/sonner.tsx
@@ -1,32 +1,28 @@
-"use client"
+"use client";
 
-import { useTheme } from "next-themes"
-import { Toaster as Sonner, type ToasterProps } from "sonner"
-import { CircleCheckIcon, InfoIcon, TriangleAlertIcon, OctagonXIcon, Loader2Icon } from "lucide-react"
+import { useTheme } from "next-themes";
+import { Toaster as Sonner, type ToasterProps } from "sonner";
+import {
+  CircleCheckIcon,
+  InfoIcon,
+  TriangleAlertIcon,
+  OctagonXIcon,
+  Loader2Icon,
+} from "lucide-react";
 
 const Toaster = ({ ...props }: ToasterProps) => {
-  const { theme = "system" } = useTheme()
+  const { theme = "system" } = useTheme();
 
   return (
     <Sonner
       theme={theme as ToasterProps["theme"]}
       className="toaster group"
       icons={{
-        success: (
-          <CircleCheckIcon className="size-4" />
-        ),
-        info: (
-          <InfoIcon className="size-4" />
-        ),
-        warning: (
-          <TriangleAlertIcon className="size-4" />
-        ),
-        error: (
-          <OctagonXIcon className="size-4" />
-        ),
-        loading: (
-          <Loader2Icon className="size-4 animate-spin" />
-        ),
+        success: <CircleCheckIcon className="size-4" />,
+        info: <InfoIcon className="size-4" />,
+        warning: <TriangleAlertIcon className="size-4" />,
+        error: <OctagonXIcon className="size-4" />,
+        loading: <Loader2Icon className="size-4 animate-spin" />,
       }}
       style={
         {
@@ -43,7 +39,7 @@ const Toaster = ({ ...props }: ToasterProps) => {
       }}
       {...props}
     />
-  )
-}
+  );
+};
 
-export { Toaster }
+export { Toaster };
diff --git a/apps/web/app/components/ui/spinner.tsx b/apps/web/app/components/ui/spinner.tsx
index f7f9ec8..9518344 100644
--- a/apps/web/app/components/ui/spinner.tsx
+++ b/apps/web/app/components/ui/spinner.tsx
@@ -1,10 +1,16 @@
-import { cn } from "~/lib/utils"
-import { Loader2Icon } from "lucide-react"
+import { cn } from "~/lib/utils";
+import { Loader2Icon } from "lucide-react";
 
 function Spinner({ className, ...props }: Omit<React.ComponentProps<"svg">, "ref">) {
   return (
-    <Loader2Icon data-slot="spinner" role="status" aria-label="Loading" className={cn("size-4 animate-spin", className)} {...props} />
-  )
+    <Loader2Icon
+      data-slot="spinner"
+      role="status"
+      aria-label="Loading"
+      className={cn("size-4 animate-spin", className)}
+      {...props}
+    />
+  );
 }
 
-export { Spinner }
+export { Spinner };
diff --git a/apps/web/app/components/ui/table.tsx b/apps/web/app/components/ui/table.tsx
index 3ea2e34..8bc934a 100644
--- a/apps/web/app/components/ui/table.tsx
+++ b/apps/web/app/components/ui/table.tsx
@@ -1,30 +1,21 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Table({ className, ...props }: React.ComponentProps<"table">) {
   return (
-    <div
-      data-slot="table-container"
-      className="relative w-full overflow-x-auto"
-    >
+    <div data-slot="table-container" className="relative w-full overflow-x-auto">
       <table
         data-slot="table"
         className={cn("w-full caption-bottom text-sm", className)}
         {...props}
       />
     </div>
-  )
+  );
 }
 
 function TableHeader({ className, ...props }: React.ComponentProps<"thead">) {
-  return (
-    <thead
-      data-slot="table-header"
-      className={cn("[&_tr]:border-b", className)}
-      {...props}
-    />
-  )
+  return <thead data-slot="table-header" className={cn("[&_tr]:border-b", className)} {...props} />;
 }
 
 function TableBody({ className, ...props }: React.ComponentProps<"tbody">) {
@@ -34,20 +25,17 @@ function TableBody({ className, ...props }: React.ComponentProps<"tbody">) {
       className={cn("[&_tr:last-child]:border-0", className)}
       {...props}
     />
-  )
+  );
 }
 
 function TableFooter({ className, ...props }: React.ComponentProps<"tfoot">) {
   return (
     <tfoot
       data-slot="table-footer"
-      className={cn(
-        "border-t bg-muted/50 font-medium [&>tr]:last:border-b-0",
-        className
-      )}
+      className={cn("border-t bg-muted/50 font-medium [&>tr]:last:border-b-0", className)}
       {...props}
     />
-  )
+  );
 }
 
 function TableRow({ className, ...props }: React.ComponentProps<"tr">) {
@@ -56,11 +44,11 @@ function TableRow({ className, ...props }: React.ComponentProps<"tr">) {
       data-slot="table-row"
       className={cn(
         "border-b transition-colors hover:bg-muted/50 has-aria-expanded:bg-muted/50 data-[state=selected]:bg-muted",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function TableHead({ className, ...props }: React.ComponentProps<"th">) {
@@ -69,46 +57,31 @@ function TableHead({ className, ...props }: React.ComponentProps<"th">) {
       data-slot="table-head"
       className={cn(
         "h-10 px-2 text-left align-middle font-medium whitespace-nowrap text-foreground [&:has([role=checkbox])]:pr-0",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function TableCell({ className, ...props }: React.ComponentProps<"td">) {
   return (
     <td
       data-slot="table-cell"
-      className={cn(
-        "p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0",
-        className
-      )}
+      className={cn("p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0", className)}
       {...props}
     />
-  )
+  );
 }
 
-function TableCaption({
-  className,
-  ...props
-}: React.ComponentProps<"caption">) {
+function TableCaption({ className, ...props }: React.ComponentProps<"caption">) {
   return (
     <caption
       data-slot="table-caption"
       className={cn("mt-4 text-sm text-muted-foreground", className)}
       {...props}
     />
-  )
+  );
 }
 
-export {
-  Table,
-  TableHeader,
-  TableBody,
-  TableFooter,
-  TableHead,
-  TableRow,
-  TableCell,
-  TableCaption,
-}
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption };
diff --git a/apps/web/app/components/ui/tabs.tsx b/apps/web/app/components/ui/tabs.tsx
index a44ec83..45ab7f8 100644
--- a/apps/web/app/components/ui/tabs.tsx
+++ b/apps/web/app/components/ui/tabs.tsx
@@ -1,24 +1,17 @@
-import { Tabs as TabsPrimitive } from "@base-ui/react/tabs"
-import { cva, type VariantProps } from "class-variance-authority"
+import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
-function Tabs({
-  className,
-  orientation = "horizontal",
-  ...props
-}: TabsPrimitive.Root.Props) {
+function Tabs({ className, orientation = "horizontal", ...props }: TabsPrimitive.Root.Props) {
   return (
     <TabsPrimitive.Root
       data-slot="tabs"
       data-orientation={orientation}
-      className={cn(
-        "group/tabs flex gap-2 data-horizontal:flex-col",
-        className
-      )}
+      className={cn("group/tabs flex gap-2 data-horizontal:flex-col", className)}
       {...props}
     />
-  )
+  );
 }
 
 const tabsListVariants = cva(
@@ -33,8 +26,8 @@ const tabsListVariants = cva(
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
 function TabsList({
   className,
@@ -50,7 +43,7 @@ function TabsList({
       className={cn(tabsListVariants({ variant }), className)}
       {...props}
     />
-  )
+  );
 }
 
 function TabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props) {
@@ -62,11 +55,11 @@ function TabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props) {
         "group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent dark:group-data-[variant=line]/tabs-list:data-active:border-transparent dark:group-data-[variant=line]/tabs-list:data-active:bg-transparent",
         "data-active:bg-background data-active:text-foreground dark:data-active:border-input dark:data-active:bg-input/30 dark:data-active:text-foreground",
         "after:absolute after:bg-foreground after:opacity-0 after:transition-opacity group-data-horizontal/tabs:after:inset-x-0 group-data-horizontal/tabs:after:bottom-[-5px] group-data-horizontal/tabs:after:h-0.5 group-data-vertical/tabs:after:inset-y-0 group-data-vertical/tabs:after:-right-1 group-data-vertical/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
 function TabsContent({ className, ...props }: TabsPrimitive.Panel.Props) {
@@ -76,7 +69,7 @@ function TabsContent({ className, ...props }: TabsPrimitive.Panel.Props) {
       className={cn("flex-1 text-sm outline-none", className)}
       {...props}
     />
-  )
+  );
 }
 
-export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants };
diff --git a/apps/web/app/components/ui/textarea.tsx b/apps/web/app/components/ui/textarea.tsx
index da52002..54b8353 100644
--- a/apps/web/app/components/ui/textarea.tsx
+++ b/apps/web/app/components/ui/textarea.tsx
@@ -1,6 +1,6 @@
-import * as React from "react"
+import * as React from "react";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
   return (
@@ -8,11 +8,11 @@ function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
       data-slot="textarea"
       className={cn(
         "flex field-sizing-content min-h-16 w-full rounded-lg border border-input bg-transparent px-2.5 py-2 text-base transition-colors outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40",
-        className
+        className,
       )}
       {...props}
     />
-  )
+  );
 }
 
-export { Textarea }
+export { Textarea };
diff --git a/apps/web/app/components/ui/toggle-group.tsx b/apps/web/app/components/ui/toggle-group.tsx
index acb54fc..d1848cb 100644
--- a/apps/web/app/components/ui/toggle-group.tsx
+++ b/apps/web/app/components/ui/toggle-group.tsx
@@ -1,22 +1,22 @@
-import * as React from "react"
-import { Toggle as TogglePrimitive } from "@base-ui/react/toggle"
-import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group"
-import { type VariantProps } from "class-variance-authority"
+import * as React from "react";
+import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
+import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group";
+import { type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
-import { toggleVariants } from "~/components/ui/toggle"
+import { cn } from "~/lib/utils";
+import { toggleVariants } from "~/components/ui/toggle";
 
 const ToggleGroupContext = React.createContext<
   VariantProps<typeof toggleVariants> & {
-    spacing?: number
-    orientation?: "horizontal" | "vertical"
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
   }
 >({
   size: "default",
   variant: "default",
   spacing: 2,
   orientation: "horizontal",
-})
+});
 
 function ToggleGroup({
   className,
@@ -28,8 +28,8 @@ function ToggleGroup({
   ...props
 }: ToggleGroupPrimitive.Props &
   VariantProps<typeof toggleVariants> & {
-    spacing?: number
-    orientation?: "horizontal" | "vertical"
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
   }) {
   return (
     <ToggleGroupPrimitive
@@ -41,17 +41,15 @@ function ToggleGroup({
       style={{ "--gap": spacing } as React.CSSProperties}
       className={cn(
         "group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] rounded-lg data-[size=sm]:rounded-[min(var(--radius-md),10px)] data-vertical:flex-col data-vertical:items-stretch",
-        className
+        className,
       )}
       {...props}
     >
-      <ToggleGroupContext.Provider
-        value={{ variant, size, spacing, orientation }}
-      >
+      <ToggleGroupContext.Provider value={{ variant, size, spacing, orientation }}>
         {children}
       </ToggleGroupContext.Provider>
     </ToggleGroupPrimitive>
-  )
+  );
 }
 
 function ToggleGroupItem({
@@ -61,7 +59,7 @@ function ToggleGroupItem({
   size = "default",
   ...props
 }: TogglePrimitive.Props & VariantProps<typeof toggleVariants>) {
-  const context = React.useContext(ToggleGroupContext)
+  const context = React.useContext(ToggleGroupContext);
 
   return (
     <TogglePrimitive
@@ -75,13 +73,13 @@ function ToggleGroupItem({
           variant: context.variant || variant,
           size: context.size || size,
         }),
-        className
+        className,
       )}
       {...props}
     >
       {children}
     </TogglePrimitive>
-  )
+  );
 }
 
-export { ToggleGroup, ToggleGroupItem }
+export { ToggleGroup, ToggleGroupItem };
diff --git a/apps/web/app/components/ui/toggle.tsx b/apps/web/app/components/ui/toggle.tsx
index 08a6b88..46fd482 100644
--- a/apps/web/app/components/ui/toggle.tsx
+++ b/apps/web/app/components/ui/toggle.tsx
@@ -1,9 +1,9 @@
-"use client"
+"use client";
 
-import { Toggle as TogglePrimitive } from "@base-ui/react/toggle"
-import { cva, type VariantProps } from "class-variance-authority"
+import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
+import { cva, type VariantProps } from "class-variance-authority";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
 const toggleVariants = cva(
   "group/toggle inline-flex items-center justify-center gap-1 rounded-lg text-sm font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
@@ -24,8 +24,8 @@ const toggleVariants = cva(
       variant: "default",
       size: "default",
     },
-  }
-)
+  },
+);
 
 function Toggle({
   className,
@@ -39,7 +39,7 @@ function Toggle({
       className={cn(toggleVariants({ variant, size, className }))}
       {...props}
     />
-  )
+  );
 }
 
-export { Toggle, toggleVariants }
+export { Toggle, toggleVariants };
diff --git a/apps/web/app/components/ui/tooltip.tsx b/apps/web/app/components/ui/tooltip.tsx
index c46d387..2fa6e34 100644
--- a/apps/web/app/components/ui/tooltip.tsx
+++ b/apps/web/app/components/ui/tooltip.tsx
@@ -1,26 +1,17 @@
-import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
 
-import { cn } from "~/lib/utils"
+import { cn } from "~/lib/utils";
 
-function TooltipProvider({
-  delay = 0,
-  ...props
-}: TooltipPrimitive.Provider.Props) {
-  return (
-    <TooltipPrimitive.Provider
-      data-slot="tooltip-provider"
-      delay={delay}
-      {...props}
-    />
-  )
+function TooltipProvider({ delay = 0, ...props }: TooltipPrimitive.Provider.Props) {
+  return <TooltipPrimitive.Provider data-slot="tooltip-provider" delay={delay} {...props} />;
 }
 
 function Tooltip({ ...props }: TooltipPrimitive.Root.Props) {
-  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+  return <TooltipPrimitive.Root data-slot="tooltip" {...props} />;
 }
 
 function TooltipTrigger({ ...props }: TooltipPrimitive.Trigger.Props) {
-  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
 }
 
 function TooltipContent({
@@ -32,10 +23,7 @@ function TooltipContent({
   children,
   ...props
 }: TooltipPrimitive.Popup.Props &
-  Pick<
-    TooltipPrimitive.Positioner.Props,
-    "align" | "alignOffset" | "side" | "sideOffset"
-  >) {
+  Pick<TooltipPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">) {
   return (
     <TooltipPrimitive.Portal>
       <TooltipPrimitive.Positioner
@@ -49,7 +37,7 @@ function TooltipContent({
           data-slot="tooltip-content"
           className={cn(
             "z-50 inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
-            className
+            className,
           )}
           {...props}
         >
@@ -58,7 +46,7 @@ function TooltipContent({
         </TooltipPrimitive.Popup>
       </TooltipPrimitive.Positioner>
     </TooltipPrimitive.Portal>
-  )
+  );
 }
 
-export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
diff --git a/apps/web/app/hooks/use-async-action.ts b/apps/web/app/hooks/use-async-action.ts
index 56e3c26..61ab703 100644
--- a/apps/web/app/hooks/use-async-action.ts
+++ b/apps/web/app/hooks/use-async-action.ts
@@ -29,7 +29,9 @@ export function useAsyncAction<TArgs extends unknown[], TResult>(
       .then((result: TResult) => {
         const { successMessage, onSuccess } = optsRef.current;
         if (successMessage) {
-          toast.success(typeof successMessage === "function" ? successMessage(result) : successMessage);
+          toast.success(
+            typeof successMessage === "function" ? successMessage(result) : successMessage,
+          );
         }
         onSuccess?.(result);
       })
diff --git a/apps/web/app/hooks/use-mobile.ts b/apps/web/app/hooks/use-mobile.ts
index 2b0fe1d..502fd32 100644
--- a/apps/web/app/hooks/use-mobile.ts
+++ b/apps/web/app/hooks/use-mobile.ts
@@ -1,19 +1,19 @@
-import * as React from "react"
+import * as React from "react";
 
-const MOBILE_BREAKPOINT = 768
+const MOBILE_BREAKPOINT = 768;
 
 export function useIsMobile() {
-  const [isMobile, setIsMobile] = React.useState<boolean | undefined>(undefined)
+  const [isMobile, setIsMobile] = React.useState<boolean | undefined>(undefined);
 
   React.useEffect(() => {
-    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`)
+    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
     const onChange = () => {
-      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
-    }
-    mql.addEventListener("change", onChange)
-    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
-    return () => mql.removeEventListener("change", onChange)
-  }, [])
+      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    };
+    mql.addEventListener("change", onChange);
+    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
 
-  return !!isMobile
+  return !!isMobile;
 }
diff --git a/apps/web/app/hooks/use-unsaved-changes.tsx b/apps/web/app/hooks/use-unsaved-changes.tsx
index 825f5a7..3ac1b9d 100644
--- a/apps/web/app/hooks/use-unsaved-changes.tsx
+++ b/apps/web/app/hooks/use-unsaved-changes.tsx
@@ -40,11 +40,7 @@ export function useUnsavedChanges(isDirty: boolean) {
   };
 }
 
-export function UnsavedChangesDialog({
-  blocker,
-}: {
-  blocker: ReturnType<typeof useBlocker>;
-}) {
+export function UnsavedChangesDialog({ blocker }: { blocker: ReturnType<typeof useBlocker> }) {
   const blocked = blocker.state === "blocked";
   return (
     <AlertDialog
@@ -64,9 +60,7 @@ export function UnsavedChangesDialog({
           <AlertDialogCancel onClick={() => blocker.state === "blocked" && blocker.reset()}>
             继续编辑
           </AlertDialogCancel>
-          <AlertDialogAction
-            onClick={() => blocker.state === "blocked" && blocker.proceed()}
-          >
+          <AlertDialogAction onClick={() => blocker.state === "blocked" && blocker.proceed()}>
             放弃并离开
           </AlertDialogAction>
         </AlertDialogFooter>
diff --git a/apps/web/app/lib/api-client.ts b/apps/web/app/lib/api-client.ts
index bb247fc..59c5e7c 100644
--- a/apps/web/app/lib/api-client.ts
+++ b/apps/web/app/lib/api-client.ts
@@ -52,7 +52,10 @@ export async function apiFetch<T>(path: string, opts: FetchOptions = {}): Promis
   const data = await res.json().catch(() => null);
 
   if (data === null) {
-    return { success: false, error_msg: res.ok ? "响应解析失败" : `请求失败 (HTTP ${res.status})` } as T;
+    return {
+      success: false,
+      error_msg: res.ok ? "响应解析失败" : `请求失败 (HTTP ${res.status})`,
+    } as T;
   }
 
   return data as T;
diff --git a/apps/web/app/lib/brand.ts b/apps/web/app/lib/brand.ts
index 1806f44..065a9f4 100644
--- a/apps/web/app/lib/brand.ts
+++ b/apps/web/app/lib/brand.ts
@@ -25,7 +25,10 @@ const DEFAULT_TAB_LABELS: Record<string, string> = {
   good: "精华",
 };
 
-export function getTabLabel(tab?: string | null, tabs?: Array<{ key: string; label: string }>): string {
+export function getTabLabel(
+  tab?: string | null,
+  tabs?: Array<{ key: string; label: string }>,
+): string {
   if (tabs && tab) {
     const found = tabs.find((t) => t.key === tab);
     if (found) return found.label;
diff --git a/apps/web/app/lib/markdown-headings.ts b/apps/web/app/lib/markdown-headings.ts
index 2122e99..3a9af1a 100644
--- a/apps/web/app/lib/markdown-headings.ts
+++ b/apps/web/app/lib/markdown-headings.ts
@@ -34,7 +34,10 @@ function extractHeadingEntries(markdown: string): Array<MarkdownHeading & { line
       return {
         line: index + 1,
         depth: Number(htmlMatch?.[1] ?? markdownMatch![1].length) as 2 | 3,
-        text: (htmlMatch?.[2] ?? markdownMatch![2]).replace(/<[^>]+>/g, "").replace(/#+$/, "").trim(),
+        text: (htmlMatch?.[2] ?? markdownMatch![2])
+          .replace(/<[^>]+>/g, "")
+          .replace(/#+$/, "")
+          .trim(),
       };
     })
     .filter((heading): heading is { line: number; depth: 2 | 3; text: string } => Boolean(heading))
diff --git a/apps/web/app/lib/seo.ts b/apps/web/app/lib/seo.ts
index 19f6cc6..a9555d7 100644
--- a/apps/web/app/lib/seo.ts
+++ b/apps/web/app/lib/seo.ts
@@ -37,7 +37,9 @@ export function markdownExcerpt(value?: string | null, length = 140) {
 
 export function firstMarkdownImage(value?: string | null) {
   if (!value) return null;
-  const markdown = value.match(/!\[[^\]]*\]\(\s*<?(https:\/\/[^\s)>]+|\/[^\s)>]+)>?(?:\s+["'][^"']*["'])?\s*\)/i)?.[1];
+  const markdown = value.match(
+    /!\[[^\]]*\]\(\s*<?(https:\/\/[^\s)>]+|\/[^\s)>]+)>?(?:\s+["'][^"']*["'])?\s*\)/i,
+  )?.[1];
   if (markdown) return absoluteUrl(markdown);
   const html = value.match(/<img\b[^>]*\bsrc=["'](https:\/\/[^"']+|\/[^"']+)["'][^>]*>/i)?.[1];
   return html ? absoluteUrl(html) : null;
@@ -92,7 +94,9 @@ export function discussionForumPostingJsonLd(topic: {
     articleBody: markdownExcerpt(topic.content, 500),
     url,
     mainEntityOfPage: url,
-    image: topic.image ? absoluteUrl(topic.image) : firstMarkdownImage(topic.content) || DEFAULT_OG_IMAGE,
+    image: topic.image
+      ? absoluteUrl(topic.image)
+      : firstMarkdownImage(topic.content) || DEFAULT_OG_IMAGE,
     author: {
       "@type": "Person",
       name: topic.author?.loginname || "CNode 用户",
diff --git a/apps/web/app/lib/topic-action-presentation.ts b/apps/web/app/lib/topic-action-presentation.ts
index 29ae2e4..5fb9d43 100644
--- a/apps/web/app/lib/topic-action-presentation.ts
+++ b/apps/web/app/lib/topic-action-presentation.ts
@@ -11,11 +11,14 @@ export type TopicActionPresentation = {
 
 export function getTopicActionPresentation(
   topic: { author?: { loginname?: string } } | null | undefined,
-  currentUser: {
-    loginname?: string;
-    is_admin?: boolean;
-    is_mod?: boolean;
-  } | null | undefined,
+  currentUser:
+    | {
+        loginname?: string;
+        is_admin?: boolean;
+        is_mod?: boolean;
+      }
+    | null
+    | undefined,
 ): TopicActionPresentation {
   const authenticated = !!currentUser;
   const isAuthor = authenticated && currentUser.loginname === topic?.author?.loginname;
diff --git a/apps/web/app/lib/upload-client.ts b/apps/web/app/lib/upload-client.ts
index 637975f..fa752c5 100644
--- a/apps/web/app/lib/upload-client.ts
+++ b/apps/web/app/lib/upload-client.ts
@@ -7,7 +7,10 @@ type UploadImageResponse = {
   error_msg?: string;
 };
 
-async function uploadImage(file: File, purpose?: string): Promise<{ url: string; filename: string }> {
+async function uploadImage(
+  file: File,
+  purpose?: string,
+): Promise<{ url: string; filename: string }> {
   const formData = new FormData();
   formData.append("file", file);
   if (purpose) formData.append("purpose", purpose);
diff --git a/apps/web/app/root.tsx b/apps/web/app/root.tsx
index 4fc0aa0..02f9e85 100644
--- a/apps/web/app/root.tsx
+++ b/apps/web/app/root.tsx
@@ -18,14 +18,18 @@ export async function loader({ request }: { request: Request }) {
 
   let zones: any[] | null = await kvGet(kv, zonesCacheKey);
   if (!zones) {
-    const res = await apiFetch<{ success: boolean; data: any[] }>("/api/v1/zones", { headers: { cookie } });
+    const res = await apiFetch<{ success: boolean; data: any[] }>("/api/v1/zones", {
+      headers: { cookie },
+    });
     zones = res.success ? res.data : [];
     await kvSet(kv, zonesCacheKey, zones, 300);
   }
 
   let tabs: any[] | null = await kvGet(kv, tabsCacheKey);
   if (!tabs) {
-    const res = await apiFetch<{ success: boolean; data: any[] }>("/api/v1/tabs", { headers: { cookie } });
+    const res = await apiFetch<{ success: boolean; data: any[] }>("/api/v1/tabs", {
+      headers: { cookie },
+    });
     tabs = res.success ? res.data : [];
     await kvSet(kv, tabsCacheKey, tabs, 300);
   }
@@ -40,7 +44,8 @@ export async function loader({ request }: { request: Request }) {
       build: {
         service: "cnode-web",
         version: packageJson.version,
-        commit: process.env.CNODE_GIT_SHA || process.env.GIT_SHA || process.env.COMMIT_SHA || "unknown",
+        commit:
+          process.env.CNODE_GIT_SHA || process.env.GIT_SHA || process.env.COMMIT_SHA || "unknown",
         buildTime: process.env.CNODE_BUILD_TIME || process.env.BUILD_TIME || "unknown",
       },
     },
@@ -49,7 +54,13 @@ export async function loader({ request }: { request: Request }) {
 
 export function Layout({ children }: { children: React.ReactNode }) {
   const data = useRouteLoaderData("root") as
-    | { publicConfig?: { apiBaseUrl?: string; turnstileSiteKey?: string; build?: Record<string, string> } }
+    | {
+        publicConfig?: {
+          apiBaseUrl?: string;
+          turnstileSiteKey?: string;
+          build?: Record<string, string>;
+        };
+      }
     | undefined;
   const publicConfig = data?.publicConfig || { apiBaseUrl: "https://api.cnodejs.org" };
 
diff --git a/apps/web/app/routes/_index.tsx b/apps/web/app/routes/_index.tsx
index cc424d3..44a5bee 100644
--- a/apps/web/app/routes/_index.tsx
+++ b/apps/web/app/routes/_index.tsx
@@ -33,7 +33,14 @@ export async function loader({ request, context }: Route.LoaderArgs) {
   const kv = (context as any)?.cloudflare?.env?.KV;
   const cached = await kvGet<{ data: any[]; total: number }>(kv, cacheKey);
   if (cached) {
-    return { topics: normalizeTopicAvatars(cached.data), page, tab, limit, total: cached.total, kv };
+    return {
+      topics: normalizeTopicAvatars(cached.data),
+      page,
+      tab,
+      limit,
+      total: cached.total,
+      kv,
+    };
   }
 
   const res = await apiFetch<{ success: boolean; data: any[]; total?: number }>(
@@ -42,7 +49,7 @@ export async function loader({ request, context }: Route.LoaderArgs) {
   );
 
   const topics = normalizeTopicAvatars(res.success ? res.data : []);
-  const total = res.success ? res.total ?? topics.length : 0;
+  const total = res.success ? (res.total ?? topics.length) : 0;
   await kvSet(kv, cacheKey, { data: topics, total }, 60);
 
   return { topics, page, tab, limit, total, kv };
@@ -65,7 +72,10 @@ export default function Index({ loaderData }: Route.ComponentProps) {
   const visibleTabs = allTabs
     .filter((t: any) => t.visible && ((t.scope || "public") === "public" || isAdmin))
     .sort((a: any, b: any) => a.sort_order - b.sort_order);
-  const tabs = [{ key: "all", label: "全部" }, ...visibleTabs.map((t: any) => ({ key: t.key, label: t.label }))];
+  const tabs = [
+    { key: "all", label: "全部" },
+    ...visibleTabs.map((t: any) => ({ key: t.key, label: t.label })),
+  ];
 
   return (
     <Layout>
@@ -75,54 +85,61 @@ export default function Index({ loaderData }: Route.ComponentProps) {
           eyebrow="COMMUNITY"
           title="Node.js 专业中文社区"
           description="浏览最新讨论、技术问答与实践分享。"
-          action={(
+          action={
             <div className="flex flex-wrap gap-2">
               <Button render={<Link to="/topic/create" />}>发布话题</Button>
-              <Button render={<Link to="/about" />} variant="secondary">了解社区</Button>
+              <Button render={<Link to="/about" />} variant="secondary">
+                了解社区
+              </Button>
             </div>
-          )}
+          }
         />
         <FeedGrid className="items-start">
-        <div className="min-w-0">
-          <Tabs
-            value={tab}
-            onValueChange={(value) => {
-              const params = new URLSearchParams();
-              if (value !== "all") params.set("tab", value);
-              navigate(params.size ? `/?${params.toString()}` : "/");
-            }}
-          >
-          <Card>
-            <CardHeader>
-              <TabsList aria-label="话题分类" className="w-full max-w-full justify-start overflow-x-auto">
-                {tabs.map((t) => {
-                  return (
-                    <TabsTrigger key={t.key} value={t.key} className="flex-none">{t.label}</TabsTrigger>
-                  );
-                })}
-              </TabsList>
-            </CardHeader>
-            <CardContent>
-              <TabsContent value={tab}>
-                <TopicList topics={topics} />
-              </TabsContent>
-            </CardContent>
-          </Card>
-          </Tabs>
+          <div className="min-w-0">
+            <Tabs
+              value={tab}
+              onValueChange={(value) => {
+                const params = new URLSearchParams();
+                if (value !== "all") params.set("tab", value);
+                navigate(params.size ? `/?${params.toString()}` : "/");
+              }}
+            >
+              <Card>
+                <CardHeader>
+                  <TabsList
+                    aria-label="话题分类"
+                    className="w-full max-w-full justify-start overflow-x-auto"
+                  >
+                    {tabs.map((t) => {
+                      return (
+                        <TabsTrigger key={t.key} value={t.key} className="flex-none">
+                          {t.label}
+                        </TabsTrigger>
+                      );
+                    })}
+                  </TabsList>
+                </CardHeader>
+                <CardContent>
+                  <TabsContent value={tab}>
+                    <TopicList topics={topics} />
+                  </TabsContent>
+                </CardContent>
+              </Card>
+            </Tabs>
 
-          <Pagination
-            page={page}
-            total={total}
-            limit={limit}
-            basePath="/"
-            searchParams={{ ...(tab !== "all" ? { tab } : {}) }}
-            variant="simple"
-          />
-        </div>
+            <Pagination
+              page={page}
+              total={total}
+              limit={limit}
+              basePath="/"
+              searchParams={{ ...(tab !== "all" ? { tab } : {}) }}
+              variant="simple"
+            />
+          </div>
 
-        <div className="min-w-0 lg:sticky lg:top-24">
-          <Sidebar />
-        </div>
+          <div className="min-w-0 lg:sticky lg:top-24">
+            <Sidebar />
+          </div>
         </FeedGrid>
       </FeedPage>
     </Layout>
diff --git a/apps/web/app/routes/about.tsx b/apps/web/app/routes/about.tsx
index 165efe0..0398146 100644
--- a/apps/web/app/routes/about.tsx
+++ b/apps/web/app/routes/about.tsx
@@ -59,18 +59,21 @@ export default function About() {
           eyebrow="ABOUT CNODE"
           title="Node.js 专业中文社区"
           description="CNode 聚集 Node.js 和现代 Web 开发者，用话题、问答和实践分享沉淀中文技术经验。"
-          action={<div className="flex flex-wrap gap-3">
-            <Button render={<Link to="/topic/create" />}>
-              发布话题
-            </Button>
-            <Button render={<a href="#guide" />} variant="secondary">
-              参与指南
-            </Button>
-          </div>}
+          action={
+            <div className="flex flex-wrap gap-3">
+              <Button render={<Link to="/topic/create" />}>发布话题</Button>
+              <Button render={<a href="#guide" />} variant="secondary">
+                参与指南
+              </Button>
+            </div>
+          }
         />
 
         <div className="grid min-w-0 gap-6 lg:grid-cols-[13rem_minmax(0,1fr)]">
-          <nav aria-label="关于页面导航" className="flex gap-2 overflow-x-auto lg:sticky lg:top-24 lg:self-start lg:flex-col">
+          <nav
+            aria-label="关于页面导航"
+            className="flex gap-2 overflow-x-auto lg:sticky lg:top-24 lg:self-start lg:flex-col"
+          >
             {[
               ["社区介绍", "#community"],
               ["参与指南", "#guide"],
@@ -79,100 +82,135 @@ export default function About() {
               ["社区客户端", "#client"],
               ["常见问题", "#faq"],
             ].map(([label, href]) => (
-              <Button key={href} render={<a href={href} />} variant="ghost" className="justify-start">
+              <Button
+                key={href}
+                render={<a href={href} />}
+                variant="ghost"
+                className="justify-start"
+              >
                 {label}
               </Button>
             ))}
           </nav>
 
           <div data-slot="about-sections" className="flex min-w-0 flex-col gap-12 md:gap-16">
-              <section id="community" className="scroll-mt-24">
-                <SectionIntro eyebrow="COMMUNITY" title="关于 CNode" description="CNode 面向中文 Node.js 与现代 Web 开发者，希望让真实问题、可复用经验和生态实践被长期检索与讨论。" />
-                <ItemGroup className="mt-4 grid gap-4 md:grid-cols-3">
-                  {communityValues.map(([title, body]) => (
-                    <Item key={title} variant="muted" className="items-start">
-                      <ItemContent>
-                        <ItemTitle>{title}</ItemTitle>
-                        <ItemDescription className="line-clamp-none">{body}</ItemDescription>
-                      </ItemContent>
-                    </Item>
-                  ))}
-                </ItemGroup>
-              </section>
+            <section id="community" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="COMMUNITY"
+                title="关于 CNode"
+                description="CNode 面向中文 Node.js 与现代 Web 开发者，希望让真实问题、可复用经验和生态实践被长期检索与讨论。"
+              />
+              <ItemGroup className="mt-4 grid gap-4 md:grid-cols-3">
+                {communityValues.map(([title, body]) => (
+                  <Item key={title} variant="muted" className="items-start">
+                    <ItemContent>
+                      <ItemTitle>{title}</ItemTitle>
+                      <ItemDescription className="line-clamp-none">{body}</ItemDescription>
+                    </ItemContent>
+                  </Item>
+                ))}
+              </ItemGroup>
+            </section>
 
-              <section id="guide" className="scroll-mt-24">
-                <SectionIntro eyebrow="GET INVOLVED" title="参与指南" description="从浏览讨论到发布内容，选择清晰的上下文比追求形式更重要。" />
-                <ItemGroup className="mt-4 grid gap-4 sm:grid-cols-2">
-                  {guideSections.map(([title, body]) => (
-                    <Item key={title} variant="outline" className="items-start">
-                      <ItemContent>
-                        <ItemTitle>{title}</ItemTitle>
-                        <ItemDescription className="line-clamp-none">{body}</ItemDescription>
-                      </ItemContent>
-                    </Item>
-                  ))}
-                </ItemGroup>
-              </section>
+            <section id="guide" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="GET INVOLVED"
+                title="参与指南"
+                description="从浏览讨论到发布内容，选择清晰的上下文比追求形式更重要。"
+              />
+              <ItemGroup className="mt-4 grid gap-4 sm:grid-cols-2">
+                {guideSections.map(([title, body]) => (
+                  <Item key={title} variant="outline" className="items-start">
+                    <ItemContent>
+                      <ItemTitle>{title}</ItemTitle>
+                      <ItemDescription className="line-clamp-none">{body}</ItemDescription>
+                    </ItemContent>
+                  </Item>
+                ))}
+              </ItemGroup>
+            </section>
 
-              <section id="discussion" className="scroll-mt-24">
-                <SectionIntro eyebrow="DISCUSSION" title="讨论与内容规范" description="高质量讨论从可复现的信息、可阅读的格式和对彼此时间的尊重开始。" />
-                <ol className="mt-5 grid gap-5 md:grid-cols-3">
-                  {discussionSections.map(([title, body], index) => (
-                    <li key={title} className="min-w-0">
-                      <p className="text-xs font-medium tracking-widest text-primary">0{index + 1}</p>
-                      <h3 className="mt-2 font-medium text-foreground">{title}</h3>
-                      <p className="mt-2 text-sm leading-6 text-muted-foreground">{body}</p>
-                    </li>
-                  ))}
-                </ol>
-              </section>
+            <section id="discussion" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="DISCUSSION"
+                title="讨论与内容规范"
+                description="高质量讨论从可复现的信息、可阅读的格式和对彼此时间的尊重开始。"
+              />
+              <ol className="mt-5 grid gap-5 md:grid-cols-3">
+                {discussionSections.map(([title, body], index) => (
+                  <li key={title} className="min-w-0">
+                    <p className="text-xs font-medium tracking-widest text-primary">0{index + 1}</p>
+                    <h3 className="mt-2 font-medium text-foreground">{title}</h3>
+                    <p className="mt-2 text-sm leading-6 text-muted-foreground">{body}</p>
+                  </li>
+                ))}
+              </ol>
+            </section>
 
-              <section id="cooperation" className="scroll-mt-24">
-                <SectionIntro eyebrow="COMMUNITY PARTNERS" title="社区合作" description="首页保留一个社区合作展示位，用于介绍与 CNode 读者相关的开源项目、开发者工具和技术活动。合作内容需要明确来源并与 Node.js 开发者相关。" />
-                <ItemGroup className="mt-4 grid gap-4 md:grid-cols-3">
-                  {cooperationSections.map(([title, body]) => (
-                    <Item key={title} variant="muted" className="items-start">
-                      <ItemContent>
-                        <ItemTitle>{title}</ItemTitle>
-                        <ItemDescription className="line-clamp-none">{body}</ItemDescription>
-                      </ItemContent>
-                    </Item>
-                  ))}
-                </ItemGroup>
-                <Button render={<Link to="/topic/create" />} variant="outline" className="mt-4">
-                  发布合作介绍
-                </Button>
-              </section>
+            <section id="cooperation" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="COMMUNITY PARTNERS"
+                title="社区合作"
+                description="首页保留一个社区合作展示位，用于介绍与 CNode 读者相关的开源项目、开发者工具和技术活动。合作内容需要明确来源并与 Node.js 开发者相关。"
+              />
+              <ItemGroup className="mt-4 grid gap-4 md:grid-cols-3">
+                {cooperationSections.map(([title, body]) => (
+                  <Item key={title} variant="muted" className="items-start">
+                    <ItemContent>
+                      <ItemTitle>{title}</ItemTitle>
+                      <ItemDescription className="line-clamp-none">{body}</ItemDescription>
+                    </ItemContent>
+                  </Item>
+                ))}
+              </ItemGroup>
+              <Button render={<Link to="/topic/create" />} variant="outline" className="mt-4">
+                发布合作介绍
+              </Button>
+            </section>
 
-              <section id="client" className="scroll-mt-24">
-                <SectionIntro eyebrow="COMMUNITY CLIENT" title="社区客户端" description="CNode 曾有由社区开发者维护的 React Native 客户端。它不是本站官方发行的软件，安装或使用前请先查看原项目的维护状态、平台支持和安全说明。" />
-                <Button
-                  render={<a href="https://github.com/soliury/noder-react-native/blob/master/README.md" target="_blank" rel="noopener noreferrer" />}
-                  variant="outline"
-                  className="mt-4"
-                >
-                  查看客户端项目
-                </Button>
-              </section>
+            <section id="client" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="COMMUNITY CLIENT"
+                title="社区客户端"
+                description="CNode 曾有由社区开发者维护的 React Native 客户端。它不是本站官方发行的软件，安装或使用前请先查看原项目的维护状态、平台支持和安全说明。"
+              />
+              <Button
+                render={
+                  <a
+                    href="https://github.com/soliury/noder-react-native/blob/master/README.md"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                  />
+                }
+                variant="outline"
+                className="mt-4"
+              >
+                查看客户端项目
+              </Button>
+            </section>
 
-              <section id="faq" className="scroll-mt-24">
-                <SectionIntro eyebrow="FAQ" title="常见问题" description="账号、消息、话题和回复的常见使用说明。" />
-                <div className="mt-5 grid gap-x-8 gap-y-6 md:grid-cols-2">
-                  {faqGroups.map((group) => (
-                    <div key={group.title}>
-                      <h3 className="font-medium text-foreground">{group.title}</h3>
-                      <dl className="mt-3 flex flex-col gap-4">
-                        {group.items.map(([question, answer]) => (
-                          <div key={question}>
-                            <dt className="text-sm font-medium">{question}</dt>
-                            <dd className="mt-1 text-sm leading-6 text-muted-foreground">{answer}</dd>
-                          </div>
-                        ))}
-                      </dl>
-                    </div>
-                  ))}
-                </div>
-              </section>
+            <section id="faq" className="scroll-mt-24">
+              <SectionIntro
+                eyebrow="FAQ"
+                title="常见问题"
+                description="账号、消息、话题和回复的常见使用说明。"
+              />
+              <div className="mt-5 grid gap-x-8 gap-y-6 md:grid-cols-2">
+                {faqGroups.map((group) => (
+                  <div key={group.title}>
+                    <h3 className="font-medium text-foreground">{group.title}</h3>
+                    <dl className="mt-3 flex flex-col gap-4">
+                      {group.items.map(([question, answer]) => (
+                        <div key={question}>
+                          <dt className="text-sm font-medium">{question}</dt>
+                          <dd className="mt-1 text-sm leading-6 text-muted-foreground">{answer}</dd>
+                        </div>
+                      ))}
+                    </dl>
+                  </div>
+                ))}
+              </div>
+            </section>
           </div>
         </div>
       </DirectoryPage>
@@ -180,11 +218,23 @@ export default function About() {
   );
 }
 
-function SectionIntro({ eyebrow, title, description }: { eyebrow: string; title: string; description: string }) {
+function SectionIntro({
+  eyebrow,
+  title,
+  description,
+}: {
+  eyebrow: string;
+  title: string;
+  description: string;
+}) {
   return (
     <div className="max-w-3xl">
-      <p className="text-xs font-medium uppercase tracking-widest text-muted-foreground">{eyebrow}</p>
-      <h2 className="mt-2 text-xl font-medium tracking-tight text-foreground sm:text-2xl">{title}</h2>
+      <p className="text-xs font-medium uppercase tracking-widest text-muted-foreground">
+        {eyebrow}
+      </p>
+      <h2 className="mt-2 text-xl font-medium tracking-tight text-foreground sm:text-2xl">
+        {title}
+      </h2>
       <p className="mt-2 text-sm leading-6 text-muted-foreground">{description}</p>
     </div>
   );
diff --git a/apps/web/app/routes/active_account.tsx b/apps/web/app/routes/active_account.tsx
index baa6cb0..5be0ada 100644
--- a/apps/web/app/routes/active_account.tsx
+++ b/apps/web/app/routes/active_account.tsx
@@ -3,7 +3,13 @@ import { AccountPage, PageHeader } from "~/components/PageShell";
 import { apiFetch } from "~/lib/api-client";
 import { useSearchParams, useNavigate } from "react-router";
 import { useState, useEffect } from "react";
-import { Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyTitle } from "~/components/ui/empty";
+import {
+  Empty,
+  EmptyContent,
+  EmptyDescription,
+  EmptyHeader,
+  EmptyTitle,
+} from "~/components/ui/empty";
 import { Button } from "~/components/ui/button";
 
 export function meta() {
@@ -46,15 +52,31 @@ export default function ActiveAccount() {
   return (
     <Layout>
       <AccountPage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "账号激活" }]} title="账号激活" description="验证激活链接并启用你的社区账号。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "账号激活" }]}
+          title="账号激活"
+          description="验证激活链接并启用你的社区账号。"
+        />
         <Empty>
-            {status === "loading" && <p className="text-muted-foreground">正在激活账号...</p>}
-            {status === "success" && (
-              <EmptyHeader><EmptyTitle>{message}</EmptyTitle><EmptyDescription>即将跳转到登录页...</EmptyDescription></EmptyHeader>
-            )}
-            {status === "error" && (
-              <><EmptyHeader><EmptyTitle>{message}</EmptyTitle></EmptyHeader><EmptyContent><Button render={<a href="/signin" />} variant="outline">返回登录</Button></EmptyContent></>
-            )}
+          {status === "loading" && <p className="text-muted-foreground">正在激活账号...</p>}
+          {status === "success" && (
+            <EmptyHeader>
+              <EmptyTitle>{message}</EmptyTitle>
+              <EmptyDescription>即将跳转到登录页...</EmptyDescription>
+            </EmptyHeader>
+          )}
+          {status === "error" && (
+            <>
+              <EmptyHeader>
+                <EmptyTitle>{message}</EmptyTitle>
+              </EmptyHeader>
+              <EmptyContent>
+                <Button render={<a href="/signin" />} variant="outline">
+                  返回登录
+                </Button>
+              </EmptyContent>
+            </>
+          )}
         </Empty>
       </AccountPage>
     </Layout>
diff --git a/apps/web/app/routes/admin/_index.tsx b/apps/web/app/routes/admin/_index.tsx
index 3aa00d0..2f9be0b 100644
--- a/apps/web/app/routes/admin/_index.tsx
+++ b/apps/web/app/routes/admin/_index.tsx
@@ -5,7 +5,14 @@ import { requireAdmin } from "~/lib/auth";
 import { Link } from "react-router";
 import { AdminMetricCard, AdminPage, AdminPageHeader, AdminPanel } from "~/components/AdminPage";
 import { Avatar, AvatarFallback, AvatarImage } from "~/components/ui/avatar";
-import { Item, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "~/components/ui/item";
+import {
+  Item,
+  ItemContent,
+  ItemDescription,
+  ItemGroup,
+  ItemMedia,
+  ItemTitle,
+} from "~/components/ui/item";
 
 export function meta() {
   return [{ title: "管理概览 · CNode Admin" }];
@@ -15,9 +22,15 @@ export async function loader({ request }: any) {
   await requireAdmin(request);
   const cookie = request.headers.get("cookie") || "";
   const [statsRes, recentUsersRes, recentTopicsRes] = await Promise.all([
-    apiFetch<{ success: boolean; data: any }>("/api/v1/admin/stats", { headers: { cookie } }).catch(() => null),
-    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/recent-users", { headers: { cookie } }).catch(() => null),
-    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/recent-topics", { headers: { cookie } }).catch(() => null),
+    apiFetch<{ success: boolean; data: any }>("/api/v1/admin/stats", { headers: { cookie } }).catch(
+      () => null,
+    ),
+    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/recent-users", {
+      headers: { cookie },
+    }).catch(() => null),
+    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/recent-topics", {
+      headers: { cookie },
+    }).catch(() => null),
   ]);
   return {
     stats: statsRes?.success ? statsRes.data : null,
@@ -31,57 +44,81 @@ export default function AdminIndex({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="dashboard">
-      <AdminPageHeader title="管理概览" description="社区运行状态、近期内容和新用户的统一工作台。" />
-      <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
-        <AdminMetricCard label="用户总数" value={stats?.userCount ?? "-"} />
-        <AdminMetricCard label="话题总数" value={stats?.topicCount ?? "-"} />
-        <AdminMetricCard label="回复总数" value={stats?.replyCount ?? "-"} />
-        <AdminMetricCard label="今日发帖" value={stats?.todayTopics ?? "-"} />
-        <AdminMetricCard label="今日回复" value={stats?.todayReplies ?? "-"} />
-        <AdminMetricCard label="今日注册" value={stats?.todayUsers ?? "-"} />
-        <AdminMetricCard label="待处理举报" value={stats?.pendingReports ?? "-"} href="/admin/reports?status=pending" />
-        <AdminMetricCard label="待处理巡检" value={stats?.moderationPending ?? "-"} href="/admin/moderation" />
-      </div>
-      <div className="grid items-start gap-4 md:grid-cols-2">
-        <AdminPanel title="最近注册用户" description="快速发现新增成员">
-          <ItemGroup>
-          {recentUsers.length > 0 ? (
-            recentUsers.map((u: any) => (
-              <Item key={u.id} size="sm" render={<Link to={`/user/${u.loginname}`} />}>
-                <ItemMedia>
-                  <Avatar>
-                    <AvatarImage src={u.avatar_url || "https://gravatar.com/avatar/?size=32"} alt="" />
-                    <AvatarFallback>{String(u.loginname || "?").slice(0, 1).toUpperCase()}</AvatarFallback>
-                  </Avatar>
-                </ItemMedia>
-                <ItemContent>
-                  <ItemTitle>{u.loginname}</ItemTitle>
-                  <ItemDescription>注册于 <TimeAgo date={u.create_at} /></ItemDescription>
-                </ItemContent>
-              </Item>
-            ))
-          ) : (
-            <div className="text-sm text-muted-foreground">暂无数据</div>
-          )}
-          </ItemGroup>
-        </AdminPanel>
-        <AdminPanel title="最近发布话题" description="关注新增内容质量">
-          <ItemGroup>
-          {recentTopics.length > 0 ? (
-            recentTopics.map((t: any) => (
-              <Item key={t.id} size="sm" render={<Link to={`/topic/${t.id}`} />}>
-                <ItemContent>
-                  <ItemTitle>{t.title}</ItemTitle>
-                  {t.create_at && <ItemDescription>发布于 <TimeAgo date={t.create_at} /></ItemDescription>}
-                </ItemContent>
-              </Item>
-            ))
-          ) : (
-            <div className="text-sm text-muted-foreground">暂无数据</div>
-          )}
-          </ItemGroup>
-        </AdminPanel>
-      </div>
+        <AdminPageHeader
+          title="管理概览"
+          description="社区运行状态、近期内容和新用户的统一工作台。"
+        />
+        <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
+          <AdminMetricCard label="用户总数" value={stats?.userCount ?? "-"} />
+          <AdminMetricCard label="话题总数" value={stats?.topicCount ?? "-"} />
+          <AdminMetricCard label="回复总数" value={stats?.replyCount ?? "-"} />
+          <AdminMetricCard label="今日发帖" value={stats?.todayTopics ?? "-"} />
+          <AdminMetricCard label="今日回复" value={stats?.todayReplies ?? "-"} />
+          <AdminMetricCard label="今日注册" value={stats?.todayUsers ?? "-"} />
+          <AdminMetricCard
+            label="待处理举报"
+            value={stats?.pendingReports ?? "-"}
+            href="/admin/reports?status=pending"
+          />
+          <AdminMetricCard
+            label="待处理巡检"
+            value={stats?.moderationPending ?? "-"}
+            href="/admin/moderation"
+          />
+        </div>
+        <div className="grid items-start gap-4 md:grid-cols-2">
+          <AdminPanel title="最近注册用户" description="快速发现新增成员">
+            <ItemGroup>
+              {recentUsers.length > 0 ? (
+                recentUsers.map((u: any) => (
+                  <Item key={u.id} size="sm" render={<Link to={`/user/${u.loginname}`} />}>
+                    <ItemMedia>
+                      <Avatar>
+                        <AvatarImage
+                          src={u.avatar_url || "https://gravatar.com/avatar/?size=32"}
+                          alt=""
+                        />
+                        <AvatarFallback>
+                          {String(u.loginname || "?")
+                            .slice(0, 1)
+                            .toUpperCase()}
+                        </AvatarFallback>
+                      </Avatar>
+                    </ItemMedia>
+                    <ItemContent>
+                      <ItemTitle>{u.loginname}</ItemTitle>
+                      <ItemDescription>
+                        注册于 <TimeAgo date={u.create_at} />
+                      </ItemDescription>
+                    </ItemContent>
+                  </Item>
+                ))
+              ) : (
+                <div className="text-sm text-muted-foreground">暂无数据</div>
+              )}
+            </ItemGroup>
+          </AdminPanel>
+          <AdminPanel title="最近发布话题" description="关注新增内容质量">
+            <ItemGroup>
+              {recentTopics.length > 0 ? (
+                recentTopics.map((t: any) => (
+                  <Item key={t.id} size="sm" render={<Link to={`/topic/${t.id}`} />}>
+                    <ItemContent>
+                      <ItemTitle>{t.title}</ItemTitle>
+                      {t.create_at && (
+                        <ItemDescription>
+                          发布于 <TimeAgo date={t.create_at} />
+                        </ItemDescription>
+                      )}
+                    </ItemContent>
+                  </Item>
+                ))
+              ) : (
+                <div className="text-sm text-muted-foreground">暂无数据</div>
+              )}
+            </ItemGroup>
+          </AdminPanel>
+        </div>
       </AdminPage>
     </AdminLayout>
   );
diff --git a/apps/web/app/routes/admin/audit.tsx b/apps/web/app/routes/admin/audit.tsx
index bb7dd89..cbd9f23 100644
--- a/apps/web/app/routes/admin/audit.tsx
+++ b/apps/web/app/routes/admin/audit.tsx
@@ -2,7 +2,13 @@ import { requireAdmin } from "~/lib/auth";
 import { AdminLayout } from "~/components/AdminLayout";
 import { apiFetch } from "~/lib/api-client";
 import { TimeAgo } from "~/components/TimeAgo";
-import { AdminMetricCard, AdminPage, AdminPageHeader, AdminPanel, AdminToolbar } from "~/components/AdminPage";
+import {
+  AdminMetricCard,
+  AdminPage,
+  AdminPageHeader,
+  AdminPanel,
+  AdminToolbar,
+} from "~/components/AdminPage";
 import { Pagination } from "~/components/Pagination";
 import { Badge } from "~/components/ui/badge";
 import { Button } from "~/components/ui/button";
@@ -10,7 +16,14 @@ import { Input } from "~/components/ui/input";
 import { NativeSelect } from "~/components/ui/native-select";
 import { Form, Link } from "react-router";
 import { EmptyState } from "~/components/EmptyState";
-import { Item, ItemContent, ItemDescription, ItemGroup, ItemHeader, ItemTitle } from "~/components/ui/item";
+import {
+  Item,
+  ItemContent,
+  ItemDescription,
+  ItemGroup,
+  ItemHeader,
+  ItemTitle,
+} from "~/components/ui/item";
 import { Separator } from "~/components/ui/separator";
 
 type AuditLog = {
@@ -47,7 +60,12 @@ const categoryLabels: Record<string, string> = {
   system: "系统设置",
 };
 
-const riskLabels = { low: "低风险", medium: "中风险", high: "高风险", critical: "极高风险" } as const;
+const riskLabels = {
+  low: "低风险",
+  medium: "中风险",
+  high: "高风险",
+  critical: "极高风险",
+} as const;
 
 export function meta() {
   return [{ title: "审计中心 · CNode Admin" }];
@@ -62,18 +80,33 @@ function riskVariant(risk: AuditLog["risk"]) {
 
 function targetHref(log: AuditLog) {
   if (log.target_type === "user" && log.target_name) return `/user/${log.target_name}`;
-  if ((log.target_type === "topic" || log.target_type === "topics") && log.target_id) return `/topic/${log.target_id.split(",")[0]}`;
+  if ((log.target_type === "topic" || log.target_type === "topics") && log.target_id)
+    return `/topic/${log.target_id.split(",")[0]}`;
   if (log.target_type === "report") return "/admin/reports";
-  if (log.target_type === "scan_job" || log.target_type === "moderation_hit") return "/admin/moderation";
+  if (log.target_type === "scan_job" || log.target_type === "moderation_hit")
+    return "/admin/moderation";
   return null;
 }
 
 function DetailBlock({ detail }: { detail: string | null }) {
-  if (!detail) return <div className="min-w-0 bg-muted p-3 text-xs text-muted-foreground">该审计事件没有附加详情。</div>;
+  if (!detail)
+    return (
+      <div className="min-w-0 bg-muted p-3 text-xs text-muted-foreground">
+        该审计事件没有附加详情。
+      </div>
+    );
   try {
-    return <pre className="max-w-full overflow-auto bg-muted p-3 text-xs">{JSON.stringify(JSON.parse(detail), null, 2)}</pre>;
+    return (
+      <pre className="max-w-full overflow-auto bg-muted p-3 text-xs">
+        {JSON.stringify(JSON.parse(detail), null, 2)}
+      </pre>
+    );
   } catch {
-    return <pre className="max-w-full overflow-auto bg-muted p-3 text-xs whitespace-pre-wrap break-all">{detail}</pre>;
+    return (
+      <pre className="max-w-full overflow-auto bg-muted p-3 text-xs whitespace-pre-wrap break-all">
+        {detail}
+      </pre>
+    );
   }
 }
 
@@ -90,7 +123,10 @@ export default function AdminAudit({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="workflow">
-        <AdminPageHeader title="审计中心" description="追踪后台关键操作、权限变更、内容治理和系统设置变更。" />
+        <AdminPageHeader
+          title="审计中心"
+          description="追踪后台关键操作、权限变更、内容治理和系统设置变更。"
+        />
 
         <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-5">
           <AdminMetricCard label="高风险操作" value={summary.high_risk} />
@@ -100,22 +136,54 @@ export default function AdminAudit({ loaderData }: any) {
           <AdminMetricCard label="失败/异常" value={summary.failures} />
         </div>
 
-        <AdminPanel title="审计事件" description={`当前显示 ${logs.length} / ${total} 条记录`} contentClassName="flex flex-col gap-4">
+        <AdminPanel
+          title="审计事件"
+          description={`当前显示 ${logs.length} / ${total} 条记录`}
+          contentClassName="flex flex-col gap-4"
+        >
           <AdminToolbar>
             <Form method="get" className="grid w-full gap-2 md:grid-cols-4 xl:grid-cols-7">
-              <Input type="date" name="date_from" defaultValue={filters.date_from || ""} aria-label="开始日期" />
-              <Input type="date" name="date_to" defaultValue={filters.date_to || ""} aria-label="结束日期" />
-              <NativeSelect name="category" defaultValue={filters.category || ""} aria-label="审计类型">
+              <Input
+                type="date"
+                name="date_from"
+                defaultValue={filters.date_from || ""}
+                aria-label="开始日期"
+              />
+              <Input
+                type="date"
+                name="date_to"
+                defaultValue={filters.date_to || ""}
+                aria-label="结束日期"
+              />
+              <NativeSelect
+                name="category"
+                defaultValue={filters.category || ""}
+                aria-label="审计类型"
+              >
                 <option value="">全部类型</option>
-                {Object.entries(categoryLabels).map(([value, label]) => <option key={value} value={value}>{label}</option>)}
+                {Object.entries(categoryLabels).map(([value, label]) => (
+                  <option key={value} value={value}>
+                    {label}
+                  </option>
+                ))}
               </NativeSelect>
               <NativeSelect name="risk" defaultValue={filters.risk || ""} aria-label="风险等级">
                 <option value="">全部风险</option>
-                {Object.entries(riskLabels).map(([value, label]) => <option key={value} value={value}>{label}</option>)}
+                {Object.entries(riskLabels).map(([value, label]) => (
+                  <option key={value} value={value}>
+                    {label}
+                  </option>
+                ))}
               </NativeSelect>
               <Input name="operator" defaultValue={filters.operator || ""} placeholder="操作人" />
-              <Input name="q" defaultValue={filters.q || ""} placeholder="搜索 action/目标/detail" />
-              <Button type="submit" variant="outline">筛选</Button>
+              <Input
+                name="q"
+                defaultValue={filters.q || ""}
+                placeholder="搜索 action/目标/detail"
+              />
+              <Button type="submit" variant="outline">
+                筛选
+              </Button>
             </Form>
           </AdminToolbar>
 
@@ -126,7 +194,11 @@ export default function AdminAudit({ loaderData }: any) {
               <EmptyState
                 title="没有匹配的审计记录"
                 message="当前日期、类型、风险或关键词筛选没有结果。"
-                action={<Button render={<Link to="/admin/audit" />} variant="outline">清除筛选</Button>}
+                action={
+                  <Button render={<Link to="/admin/audit" />} variant="outline">
+                    清除筛选
+                  </Button>
+                }
               />
             )}
             {logs.map((log) => {
@@ -137,42 +209,81 @@ export default function AdminAudit({ loaderData }: any) {
                     <ItemHeader>
                       <ItemTitle className="w-full flex-wrap whitespace-normal">
                         <Badge variant={riskVariant(log.risk)}>{riskLabels[log.risk]}</Badge>
-                        <Badge variant="secondary">{categoryLabels[log.category] || log.category}</Badge>
+                        <Badge variant="secondary">
+                          {categoryLabels[log.category] || log.category}
+                        </Badge>
                         <span className="font-semibold text-foreground">{log.label}</span>
                       </ItemTitle>
                     </ItemHeader>
                     <ItemDescription>
-                        {log.operator_name || "system"} · <TimeAgo date={log.create_at} /> · {log.result || "unknown"}
+                      {log.operator_name || "system"} · <TimeAgo date={log.create_at} /> ·{" "}
+                      {log.result || "unknown"}
                     </ItemDescription>
                     <div className="min-w-0 break-all text-sm">
-                        目标：{href ? <Link to={href} className="text-primary hover:underline">{log.target_name || log.target_id}</Link> : <span>{log.target_name || log.target_id || "无"}</span>}
-                        {log.target_type && <span className="ml-2 text-xs text-muted-foreground">{log.target_type}</span>}
+                      目标：
+                      {href ? (
+                        <Link to={href} className="text-primary hover:underline">
+                          {log.target_name || log.target_id}
+                        </Link>
+                      ) : (
+                        <span>{log.target_name || log.target_id || "无"}</span>
+                      )}
+                      {log.target_type && (
+                        <span className="ml-2 text-xs text-muted-foreground">
+                          {log.target_type}
+                        </span>
+                      )}
                     </div>
 
-                  <details className="border-t pt-3 text-sm">
-                    <summary className="cursor-pointer font-medium text-foreground">查看审计字段</summary>
-                    <div className="mt-3 grid gap-3 lg:grid-cols-[16rem_minmax(0,1fr)]">
-                      <dl className="flex min-w-0 flex-col gap-1 break-all text-xs text-muted-foreground">
-                        <div className="mb-2 font-semibold text-foreground">基础字段</div>
-                        <div><dt className="inline font-semibold">id: </dt><dd className="inline">{log.id}</dd></div>
-                        <div><dt className="inline font-semibold">action: </dt><dd className="inline">{log.action}</dd></div>
-                        <div><dt className="inline font-semibold">operator_id: </dt><dd className="inline">{log.operator_id ?? ""}</dd></div>
-                        <div><dt className="inline font-semibold">target_type: </dt><dd className="inline">{log.target_type || ""}</dd></div>
-                        <div><dt className="inline font-semibold">target_id: </dt><dd className="inline">{log.target_id || ""}</dd></div>
-                      </dl>
-                      <div className="flex min-w-0 flex-col gap-2">
-                        <div className="text-xs font-semibold text-foreground">附加详情 detail</div>
-                        <DetailBlock detail={log.detail} />
+                    <details className="border-t pt-3 text-sm">
+                      <summary className="cursor-pointer font-medium text-foreground">
+                        查看审计字段
+                      </summary>
+                      <div className="mt-3 grid gap-3 lg:grid-cols-[16rem_minmax(0,1fr)]">
+                        <dl className="flex min-w-0 flex-col gap-1 break-all text-xs text-muted-foreground">
+                          <div className="mb-2 font-semibold text-foreground">基础字段</div>
+                          <div>
+                            <dt className="inline font-semibold">id: </dt>
+                            <dd className="inline">{log.id}</dd>
+                          </div>
+                          <div>
+                            <dt className="inline font-semibold">action: </dt>
+                            <dd className="inline">{log.action}</dd>
+                          </div>
+                          <div>
+                            <dt className="inline font-semibold">operator_id: </dt>
+                            <dd className="inline">{log.operator_id ?? ""}</dd>
+                          </div>
+                          <div>
+                            <dt className="inline font-semibold">target_type: </dt>
+                            <dd className="inline">{log.target_type || ""}</dd>
+                          </div>
+                          <div>
+                            <dt className="inline font-semibold">target_id: </dt>
+                            <dd className="inline">{log.target_id || ""}</dd>
+                          </div>
+                        </dl>
+                        <div className="flex min-w-0 flex-col gap-2">
+                          <div className="text-xs font-semibold text-foreground">
+                            附加详情 detail
+                          </div>
+                          <DetailBlock detail={log.detail} />
+                        </div>
                       </div>
-                    </div>
-                  </details>
+                    </details>
                   </ItemContent>
                 </Item>
               );
             })}
           </ItemGroup>
 
-          <Pagination page={page} total={total} limit={limit} basePath="/admin/audit" searchParams={filters} />
+          <Pagination
+            page={page}
+            total={total}
+            limit={limit}
+            basePath="/admin/audit"
+            searchParams={filters}
+          />
         </AdminPanel>
       </AdminPage>
     </AdminLayout>
@@ -187,23 +298,40 @@ export async function loader({ request }: any) {
   const cookie = request.headers.get("cookie") || "";
   const params = new URLSearchParams({ page: String(page), limit: String(limit) });
   const filters: Record<string, string> = {};
-  for (const key of ["date_from", "date_to", "operator", "category", "risk", "target_type", "result", "q"]) {
+  for (const key of [
+    "date_from",
+    "date_to",
+    "operator",
+    "category",
+    "risk",
+    "target_type",
+    "result",
+    "q",
+  ]) {
     const value = url.searchParams.get(key)?.trim();
     if (value) {
       params.set(key, value);
       filters[key] = value;
     }
   }
-  const res = await apiFetch<{ success: boolean; data: AuditLog[]; total?: number; summary?: AuditSummary }>(
-    `/api/v1/admin/audit?${params.toString()}`,
-    { headers: { cookie } },
-  );
+  const res = await apiFetch<{
+    success: boolean;
+    data: AuditLog[];
+    total?: number;
+    summary?: AuditSummary;
+  }>(`/api/v1/admin/audit?${params.toString()}`, { headers: { cookie } });
   return {
     logs: res.success ? res.data || [] : [],
     total: res.total ?? 0,
     page,
     limit,
     filters,
-    summary: res.summary || { high_risk: 0, content_deletions: 0, role_changes: 0, account_security: 0, failures: 0 },
+    summary: res.summary || {
+      high_risk: 0,
+      content_deletions: 0,
+      role_changes: 0,
+      account_security: 0,
+      failures: 0,
+    },
   };
 }
diff --git a/apps/web/app/routes/admin/bans.tsx b/apps/web/app/routes/admin/bans.tsx
index 62710bf..c6070fa 100644
--- a/apps/web/app/routes/admin/bans.tsx
+++ b/apps/web/app/routes/admin/bans.tsx
@@ -60,14 +60,25 @@ export async function loader({ request }: any) {
   const page = Math.max(1, Number(url.searchParams.get("page")) || 1);
   const limit = Math.min(100, Number(url.searchParams.get("limit")) || 50);
   const tab = url.searchParams.get("tab") === "ips" ? "ips" : "users";
-  const userStatus: UserGovernanceStatus = url.searchParams.get("status") === "blocked" ? "blocked" : "muted";
+  const userStatus: UserGovernanceStatus =
+    url.searchParams.get("status") === "blocked" ? "blocked" : "muted";
   const cookie = request.headers.get("cookie") || "";
-  const userParams = new URLSearchParams({ page: String(page), limit: String(limit), status: userStatus });
+  const userParams = new URLSearchParams({
+    page: String(page),
+    limit: String(limit),
+    status: userStatus,
+  });
   const [usersRes, ipsRes] = await Promise.all([
-    apiFetch<{ success: boolean; data: any[]; total?: number }>(`/api/v1/admin/bans/users?${userParams.toString()}`, {
-      headers: { cookie },
-    }),
-    apiFetch<{ success: boolean; data: any[]; total?: number }>(`/api/v1/admin/bans/ips?page=${page}&limit=${limit}`, { headers: { cookie } }),
+    apiFetch<{ success: boolean; data: any[]; total?: number }>(
+      `/api/v1/admin/bans/users?${userParams.toString()}`,
+      {
+        headers: { cookie },
+      },
+    ),
+    apiFetch<{ success: boolean; data: any[]; total?: number }>(
+      `/api/v1/admin/bans/ips?page=${page}&limit=${limit}`,
+      { headers: { cookie } },
+    ),
   ]);
   return {
     bannedUsers: usersRes.success ? usersRes.data || [] : [],
@@ -105,22 +116,32 @@ export default function AdminBans({ loaderData }: any) {
 
   const currentUserIds = bannedUsers.map((user: any) => Number(user.id));
   const selectedCurrentUserIds = selectedUserIds.filter((id) => currentUserIds.includes(id));
-  const allCurrentUsersSelected = currentUserIds.length > 0 && selectedCurrentUserIds.length === currentUserIds.length;
+  const allCurrentUsersSelected =
+    currentUserIds.length > 0 && selectedCurrentUserIds.length === currentUserIds.length;
   const userAction = userGovernanceApiAction(userStatus);
   const userActionLabel = userGovernanceActionLabel(userStatus);
   const userStatusLabel = USER_GOVERNANCE_STATUS_LABELS[userStatus];
 
   const toggleUserSelection = (id: number, checked: boolean) => {
-    setSelectedUserIds((ids) => checked ? Array.from(new Set([...ids, id])) : ids.filter((item) => item !== id));
+    setSelectedUserIds((ids) =>
+      checked ? Array.from(new Set([...ids, id])) : ids.filter((item) => item !== id),
+    );
   };
 
   const toggleAllCurrentUsers = (checked: boolean) => {
-    setSelectedUserIds((ids) => checked ? Array.from(new Set([...ids, ...currentUserIds])) : ids.filter((id) => !currentUserIds.includes(id)));
+    setSelectedUserIds((ids) =>
+      checked
+        ? Array.from(new Set([...ids, ...currentUserIds]))
+        : ids.filter((id) => !currentUserIds.includes(id)),
+    );
   };
 
   const { run: handleSingleUserGovernance, pending: singleUserPending } = useAsyncAction(
     async () => {
-      const res = await apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/user/${singleUserTarget}/${userAction}`, { method: "POST" });
+      const res = await apiFetch<{ success: boolean; error_msg?: string }>(
+        `/api/v1/user/${singleUserTarget}/${userAction}`,
+        { method: "POST" },
+      );
       return { ...res, name: singleUserTarget };
     },
     {
@@ -128,7 +149,13 @@ export default function AdminBans({ loaderData }: any) {
         if (result.success) {
           toast.success(`已${userActionLabel} ${result.name}`);
           setSingleUserTarget(null);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: bannedUsers.length, removedCount: 1 });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: bannedUsers.length,
+            removedCount: 1,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -140,7 +167,12 @@ export default function AdminBans({ loaderData }: any) {
 
   const { run: handleBulkUserGovernance, pending: bulkUserPending } = useAsyncAction(
     async () => {
-      const res = await apiFetch<{ success: boolean; error_msg?: string; processed?: number; skipped_ids?: number[] }>("/api/v1/admin/users/bulk-governance", {
+      const res = await apiFetch<{
+        success: boolean;
+        error_msg?: string;
+        processed?: number;
+        skipped_ids?: number[];
+      }>("/api/v1/admin/users/bulk-governance", {
         method: "POST",
         body: JSON.stringify({ action: userAction, ids: selectedCurrentUserIds }),
       });
@@ -150,10 +182,19 @@ export default function AdminBans({ loaderData }: any) {
       onSuccess: (result) => {
         if (result.success) {
           const feedback = bulkUserGovernanceFeedback(userActionLabel, result);
-          toast.success(feedback.message, feedback.description ? { description: feedback.description } : undefined);
+          toast.success(
+            feedback.message,
+            feedback.description ? { description: feedback.description } : undefined,
+          );
           setSelectedUserIds(result.skipped_ids || []);
           setBulkUserConfirmOpen(false);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: bannedUsers.length, removedCount: result.processed || 0 });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: bannedUsers.length,
+            removedCount: result.processed || 0,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -195,7 +236,13 @@ export default function AdminBans({ loaderData }: any) {
         if (res.success) {
           toast.success("IP 规则已移除");
           setRemoveIpTarget(null);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: bannedIps.length, removedCount: 1 });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: bannedIps.length,
+            removedCount: 1,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -208,177 +255,265 @@ export default function AdminBans({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="data-list">
-      <AdminPageHeader title="封禁管理" description="管理用户禁言、内容屏蔽和 IP 风控规则，保持社区秩序。" />
-      <Tabs
-        value={tab}
-        onValueChange={(value) => {
-          if (!value || value === tab) return;
-          const next = new URLSearchParams(searchParams);
-          next.set("tab", value);
-          next.delete("page");
-          if (value === "ips") next.delete("status");
-          setSearchParams(next);
-        }}
-      >
-        <TabsList>
-          <TabsTrigger value="users">用户治理</TabsTrigger>
-          <TabsTrigger value="ips">IP 封禁</TabsTrigger>
-        </TabsList>
-        <TabsContent value="users">
-          <AdminPanel title={userStatusLabel} description={`当前显示 ${bannedUsers.length} / ${bannedUsersTotal} 个${userStatusLabel}`} flush>
-            <AdminToolbar>
-              <div className="flex w-full flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
-                <div className="flex gap-2">
-                  <Button render={<Link to={`/admin/bans?tab=users&status=muted&limit=${limit}`} />} size="sm" variant={userStatus === "muted" ? "default" : "outline"}>
-                    禁言用户
-                  </Button>
-                  <Button render={<Link to={`/admin/bans?tab=users&status=blocked&limit=${limit}`} />} size="sm" variant={userStatus === "blocked" ? "default" : "outline"}>
-                    内容已屏蔽用户
+        <AdminPageHeader
+          title="封禁管理"
+          description="管理用户禁言、内容屏蔽和 IP 风控规则，保持社区秩序。"
+        />
+        <Tabs
+          value={tab}
+          onValueChange={(value) => {
+            if (!value || value === tab) return;
+            const next = new URLSearchParams(searchParams);
+            next.set("tab", value);
+            next.delete("page");
+            if (value === "ips") next.delete("status");
+            setSearchParams(next);
+          }}
+        >
+          <TabsList>
+            <TabsTrigger value="users">用户治理</TabsTrigger>
+            <TabsTrigger value="ips">IP 封禁</TabsTrigger>
+          </TabsList>
+          <TabsContent value="users">
+            <AdminPanel
+              title={userStatusLabel}
+              description={`当前显示 ${bannedUsers.length} / ${bannedUsersTotal} 个${userStatusLabel}`}
+              flush
+            >
+              <AdminToolbar>
+                <div className="flex w-full flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
+                  <div className="flex gap-2">
+                    <Button
+                      render={<Link to={`/admin/bans?tab=users&status=muted&limit=${limit}`} />}
+                      size="sm"
+                      variant={userStatus === "muted" ? "default" : "outline"}
+                    >
+                      禁言用户
+                    </Button>
+                    <Button
+                      render={<Link to={`/admin/bans?tab=users&status=blocked&limit=${limit}`} />}
+                      size="sm"
+                      variant={userStatus === "blocked" ? "default" : "outline"}
+                    >
+                      内容已屏蔽用户
+                    </Button>
+                  </div>
+                  <Button
+                    size="sm"
+                    onClick={(event) => {
+                      userActionTriggerRef.current = event.currentTarget;
+                      setBulkUserConfirmOpen(true);
+                    }}
+                    disabled={bulkUserPending || selectedCurrentUserIds.length === 0}
+                  >
+                    {bulkUserPending
+                      ? "处理中"
+                      : `批量${userActionLabel} (${selectedCurrentUserIds.length})`}
                   </Button>
                 </div>
-                <Button size="sm" onClick={(event) => {
-                  userActionTriggerRef.current = event.currentTarget;
-                  setBulkUserConfirmOpen(true);
-                }} disabled={bulkUserPending || selectedCurrentUserIds.length === 0}>
-                  {bulkUserPending ? "处理中" : `批量${userActionLabel} (${selectedCurrentUserIds.length})`}
-                </Button>
-              </div>
-            </AdminToolbar>
-            <Table className="min-w-[680px]">
-              <TableHeader>
-                <TableRow>
-                  <TableHead className="w-10">
-                    <Checkbox checked={allCurrentUsersSelected} onCheckedChange={(checked) => toggleAllCurrentUsers(checked === true)} aria-label={`选择当前页${userStatusLabel}`} />
-                  </TableHead>
-                  <TableHead>用户</TableHead>
-                  <TableHead>状态</TableHead>
-                  <TableHead className="text-right">操作</TableHead>
-                </TableRow>
-              </TableHeader>
-              <TableBody>
-                {bannedUsers.map((u: any) => (
-                  <TableRow key={u.id}>
-                    <TableCell>
-                      <Checkbox checked={selectedUserIds.includes(Number(u.id))} onCheckedChange={(checked) => toggleUserSelection(Number(u.id), checked === true)} aria-label={`选择 ${u.loginname}`} />
-                    </TableCell>
-                    <TableCell>{u.loginname}</TableCell>
-                    <TableCell>
-                      <div className="flex flex-wrap gap-1">
-                        {u.is_muted && <Badge variant="destructive">禁言</Badge>}
-                        {u.is_block && <Badge variant="destructive">内容已屏蔽</Badge>}
-                      </div>
-                    </TableCell>
-                    <TableCell className="text-right">
-                      <Button size="sm" variant="ghost" disabled={singleUserPending} onClick={(event) => {
-                        userActionTriggerRef.current = event.currentTarget;
-                        setSingleUserTarget(u.loginname);
-                      }}>
-                        {singleUserPending ? "处理中" : userActionLabel}
-                      </Button>
-                    </TableCell>
-                  </TableRow>
-                ))}
-                {bannedUsers.length === 0 && (
+              </AdminToolbar>
+              <Table className="min-w-[680px]">
+                <TableHeader>
                   <TableRow>
-                    <TableCell colSpan={4} className="py-8 text-center text-sm text-muted-foreground">
-                      暂无{userStatusLabel}
-                    </TableCell>
+                    <TableHead className="w-10">
+                      <Checkbox
+                        checked={allCurrentUsersSelected}
+                        onCheckedChange={(checked) => toggleAllCurrentUsers(checked === true)}
+                        aria-label={`选择当前页${userStatusLabel}`}
+                      />
+                    </TableHead>
+                    <TableHead>用户</TableHead>
+                    <TableHead>状态</TableHead>
+                    <TableHead className="text-right">操作</TableHead>
                   </TableRow>
-                )}
-              </TableBody>
-            </Table>
-            <Pagination page={page} total={bannedUsersTotal} limit={limit} basePath="/admin/bans" searchParams={{ tab: "users", status: userStatus }} />
-            <ConfirmationDialog
-              open={singleUserTarget !== null}
-              onOpenChange={(open) => !open && setSingleUserTarget(null)}
-              title={userStatus === "muted" ? "解除用户禁言" : "恢复用户内容可见"}
-              description={userStatus === "muted"
-                ? `将恢复 ${singleUserTarget} 发布话题和回复的能力；不会取消内容屏蔽或恢复已删除内容。`
-                : `将恢复 ${singleUserTarget} 的内容可见性；不会解除禁言或恢复已删除内容。`}
-              confirmLabel={userActionLabel}
-              pending={singleUserPending}
-              destructive={false}
-              finalFocus={userActionTriggerRef}
-              onConfirm={handleSingleUserGovernance}
-            />
-            <ConfirmationDialog
-              open={bulkUserConfirmOpen}
-              onOpenChange={setBulkUserConfirmOpen}
-              title={`批量${userActionLabel}`}
-              description={userStatus === "muted"
-                ? `将为 ${selectedCurrentUserIds.length} 个用户解除禁言；不会取消内容屏蔽或恢复已删除内容。`
-                : `将为 ${selectedCurrentUserIds.length} 个用户恢复内容可见；不会解除禁言或恢复已删除内容。`}
-              confirmLabel={`确认${userActionLabel} ${selectedCurrentUserIds.length} 个用户`}
-              pending={bulkUserPending}
-              destructive={false}
-              finalFocus={userActionTriggerRef}
-              onConfirm={handleBulkUserGovernance}
-            />
-          </AdminPanel>
-        </TabsContent>
-        <TabsContent value="ips">
-          <AdminPanel title="IP 封禁" description={`当前显示 ${bannedIps.length} / ${bannedIpsTotal} 条 IP 规则`} flush>
-            <AdminToolbar>
-              <Input value={ip} onChange={(event) => setIp(event.target.value)} placeholder="IP 或 CIDR (如 1.2.3.4 或 1.2.3.0/24)" className="w-full sm:max-w-md" />
-              <Input value={reason} onChange={(event) => setReason(event.target.value)} placeholder="原因" className="w-full sm:max-w-sm" />
-              <Button onClick={(event) => {
-                addIpTriggerRef.current = event.currentTarget;
-                setAddIpConfirmOpen(true);
-              }} disabled={savingIp || !ip.trim()}>
-                {savingIp ? "添加中" : "添加"}
-              </Button>
-            </AdminToolbar>
-            <Table className="min-w-[680px]">
-              <TableHeader>
-                <TableRow>
-                  <TableHead>IP/段</TableHead>
-                  <TableHead>原因</TableHead>
-                  <TableHead>操作</TableHead>
-                </TableRow>
-              </TableHeader>
-              <TableBody>
-                {bannedIps.map((ip: any, i: number) => (
-                  <TableRow key={i}>
-                    <TableCell className="break-all">{ip.ip}</TableCell>
-                    <TableCell className="break-words text-muted-foreground">{ip.reason}</TableCell>
-                    <TableCell>
-                      <Button size="sm" variant="destructive" onClick={(event) => {
-                        removeIpTriggerRef.current = event.currentTarget;
-                        setRemoveIpTarget({ id: ip.id, ip: ip.ip });
-                      }}>
-                        移除
-                      </Button>
-                    </TableCell>
+                </TableHeader>
+                <TableBody>
+                  {bannedUsers.map((u: any) => (
+                    <TableRow key={u.id}>
+                      <TableCell>
+                        <Checkbox
+                          checked={selectedUserIds.includes(Number(u.id))}
+                          onCheckedChange={(checked) =>
+                            toggleUserSelection(Number(u.id), checked === true)
+                          }
+                          aria-label={`选择 ${u.loginname}`}
+                        />
+                      </TableCell>
+                      <TableCell>{u.loginname}</TableCell>
+                      <TableCell>
+                        <div className="flex flex-wrap gap-1">
+                          {u.is_muted && <Badge variant="destructive">禁言</Badge>}
+                          {u.is_block && <Badge variant="destructive">内容已屏蔽</Badge>}
+                        </div>
+                      </TableCell>
+                      <TableCell className="text-right">
+                        <Button
+                          size="sm"
+                          variant="ghost"
+                          disabled={singleUserPending}
+                          onClick={(event) => {
+                            userActionTriggerRef.current = event.currentTarget;
+                            setSingleUserTarget(u.loginname);
+                          }}
+                        >
+                          {singleUserPending ? "处理中" : userActionLabel}
+                        </Button>
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                  {bannedUsers.length === 0 && (
+                    <TableRow>
+                      <TableCell
+                        colSpan={4}
+                        className="py-8 text-center text-sm text-muted-foreground"
+                      >
+                        暂无{userStatusLabel}
+                      </TableCell>
+                    </TableRow>
+                  )}
+                </TableBody>
+              </Table>
+              <Pagination
+                page={page}
+                total={bannedUsersTotal}
+                limit={limit}
+                basePath="/admin/bans"
+                searchParams={{ tab: "users", status: userStatus }}
+              />
+              <ConfirmationDialog
+                open={singleUserTarget !== null}
+                onOpenChange={(open) => !open && setSingleUserTarget(null)}
+                title={userStatus === "muted" ? "解除用户禁言" : "恢复用户内容可见"}
+                description={
+                  userStatus === "muted"
+                    ? `将恢复 ${singleUserTarget} 发布话题和回复的能力；不会取消内容屏蔽或恢复已删除内容。`
+                    : `将恢复 ${singleUserTarget} 的内容可见性；不会解除禁言或恢复已删除内容。`
+                }
+                confirmLabel={userActionLabel}
+                pending={singleUserPending}
+                destructive={false}
+                finalFocus={userActionTriggerRef}
+                onConfirm={handleSingleUserGovernance}
+              />
+              <ConfirmationDialog
+                open={bulkUserConfirmOpen}
+                onOpenChange={setBulkUserConfirmOpen}
+                title={`批量${userActionLabel}`}
+                description={
+                  userStatus === "muted"
+                    ? `将为 ${selectedCurrentUserIds.length} 个用户解除禁言；不会取消内容屏蔽或恢复已删除内容。`
+                    : `将为 ${selectedCurrentUserIds.length} 个用户恢复内容可见；不会解除禁言或恢复已删除内容。`
+                }
+                confirmLabel={`确认${userActionLabel} ${selectedCurrentUserIds.length} 个用户`}
+                pending={bulkUserPending}
+                destructive={false}
+                finalFocus={userActionTriggerRef}
+                onConfirm={handleBulkUserGovernance}
+              />
+            </AdminPanel>
+          </TabsContent>
+          <TabsContent value="ips">
+            <AdminPanel
+              title="IP 封禁"
+              description={`当前显示 ${bannedIps.length} / ${bannedIpsTotal} 条 IP 规则`}
+              flush
+            >
+              <AdminToolbar>
+                <Input
+                  value={ip}
+                  onChange={(event) => setIp(event.target.value)}
+                  placeholder="IP 或 CIDR (如 1.2.3.4 或 1.2.3.0/24)"
+                  className="w-full sm:max-w-md"
+                />
+                <Input
+                  value={reason}
+                  onChange={(event) => setReason(event.target.value)}
+                  placeholder="原因"
+                  className="w-full sm:max-w-sm"
+                />
+                <Button
+                  onClick={(event) => {
+                    addIpTriggerRef.current = event.currentTarget;
+                    setAddIpConfirmOpen(true);
+                  }}
+                  disabled={savingIp || !ip.trim()}
+                >
+                  {savingIp ? "添加中" : "添加"}
+                </Button>
+              </AdminToolbar>
+              <Table className="min-w-[680px]">
+                <TableHeader>
+                  <TableRow>
+                    <TableHead>IP/段</TableHead>
+                    <TableHead>原因</TableHead>
+                    <TableHead>操作</TableHead>
                   </TableRow>
-                ))}
-              </TableBody>
-            </Table>
-            <Pagination page={page} total={bannedIpsTotal} limit={limit} basePath="/admin/bans" searchParams={{ tab: "ips" }} />
-            <ConfirmationDialog
-              open={addIpConfirmOpen}
-              onOpenChange={setAddIpConfirmOpen}
-              title="确认添加 IP 封禁规则"
-              description={<>将封禁 {ip.trim()} 匹配的请求。原因：{reason.trim() || "未填写"}。该规则生效后，匹配请求将被阻止。</>}
-              confirmLabel="确认添加 IP 规则"
-              pendingLabel="添加中"
-              pending={savingIp}
-              finalFocus={addIpTriggerRef}
-              onConfirm={handleAddIp}
-            />
-            <ConfirmationDialog
-              open={removeIpTarget !== null}
-              onOpenChange={(open) => !open && setRemoveIpTarget(null)}
-              title="删除 IP 封禁规则"
-              description={<>将删除规则 {removeIpTarget?.ip}。删除后匹配该 IP 或网段的请求将不再被此规则阻止。</>}
-              confirmLabel="确认删除 IP 规则"
-              pendingLabel="删除中"
-              pending={removingIp}
-              finalFocus={removeIpTriggerRef}
-              onConfirm={() => removeIpTarget && handleRemoveIp(removeIpTarget.id)}
-            />
-          </AdminPanel>
-        </TabsContent>
-      </Tabs>
+                </TableHeader>
+                <TableBody>
+                  {bannedIps.map((ip: any, i: number) => (
+                    <TableRow key={i}>
+                      <TableCell className="break-all">{ip.ip}</TableCell>
+                      <TableCell className="break-words text-muted-foreground">
+                        {ip.reason}
+                      </TableCell>
+                      <TableCell>
+                        <Button
+                          size="sm"
+                          variant="destructive"
+                          onClick={(event) => {
+                            removeIpTriggerRef.current = event.currentTarget;
+                            setRemoveIpTarget({ id: ip.id, ip: ip.ip });
+                          }}
+                        >
+                          移除
+                        </Button>
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                </TableBody>
+              </Table>
+              <Pagination
+                page={page}
+                total={bannedIpsTotal}
+                limit={limit}
+                basePath="/admin/bans"
+                searchParams={{ tab: "ips" }}
+              />
+              <ConfirmationDialog
+                open={addIpConfirmOpen}
+                onOpenChange={setAddIpConfirmOpen}
+                title="确认添加 IP 封禁规则"
+                description={
+                  <>
+                    将封禁 {ip.trim()} 匹配的请求。原因：{reason.trim() || "未填写"}
+                    。该规则生效后，匹配请求将被阻止。
+                  </>
+                }
+                confirmLabel="确认添加 IP 规则"
+                pendingLabel="添加中"
+                pending={savingIp}
+                finalFocus={addIpTriggerRef}
+                onConfirm={handleAddIp}
+              />
+              <ConfirmationDialog
+                open={removeIpTarget !== null}
+                onOpenChange={(open) => !open && setRemoveIpTarget(null)}
+                title="删除 IP 封禁规则"
+                description={
+                  <>
+                    将删除规则 {removeIpTarget?.ip}。删除后匹配该 IP
+                    或网段的请求将不再被此规则阻止。
+                  </>
+                }
+                confirmLabel="确认删除 IP 规则"
+                pendingLabel="删除中"
+                pending={removingIp}
+                finalFocus={removeIpTriggerRef}
+                onConfirm={() => removeIpTarget && handleRemoveIp(removeIpTarget.id)}
+              />
+            </AdminPanel>
+          </TabsContent>
+        </Tabs>
       </AdminPage>
     </AdminLayout>
   );
diff --git a/apps/web/app/routes/admin/keywords.tsx b/apps/web/app/routes/admin/keywords.tsx
index 0b3e6a7..0d5e8cf 100644
--- a/apps/web/app/routes/admin/keywords.tsx
+++ b/apps/web/app/routes/admin/keywords.tsx
@@ -78,13 +78,21 @@ export default function AdminKeywords({ loaderData }: any) {
 
   const { run: handleDelete, pending: deleting } = useAsyncAction(
     (id: number) =>
-      apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/admin/keywords/${id}`, { method: "DELETE" }),
+      apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/admin/keywords/${id}`, {
+        method: "DELETE",
+      }),
     {
       onSuccess: (res) => {
         if (res.success) {
           toast.success("已删除");
           setDeleteTarget(null);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: keywords.length, removedCount: 1 });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: keywords.length,
+            removedCount: 1,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -97,10 +105,13 @@ export default function AdminKeywords({ loaderData }: any) {
   const { run: runBulk, pending: importing } = useAsyncAction(
     async () => {
       const lines = bulkText.split("\n").filter(Boolean);
-      const res = await apiFetch<{ success: boolean; error_msg?: string }>("/api/v1/admin/keywords/bulk", {
-        method: "POST",
-        body: JSON.stringify({ words: lines }),
-      });
+      const res = await apiFetch<{ success: boolean; error_msg?: string }>(
+        "/api/v1/admin/keywords/bulk",
+        {
+          method: "POST",
+          body: JSON.stringify({ words: lines }),
+        },
+      );
       return { ...res, count: lines.length };
     },
     {
@@ -124,25 +135,36 @@ export default function AdminKeywords({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="data-list">
-        <AdminPageHeader title="敏感词管理" description="维护巡检词库，让内容审核有稳定、可追踪的判断依据。" />
-        <AdminPanel title="词库" description={`当前显示 ${keywords.length} / ${total} 个敏感词`} flush>
+        <AdminPageHeader
+          title="敏感词管理"
+          description="维护巡检词库，让内容审核有稳定、可追踪的判断依据。"
+        />
+        <AdminPanel
+          title="词库"
+          description={`当前显示 ${keywords.length} / ${total} 个敏感词`}
+          flush
+        >
           <AdminToolbar className="items-stretch sm:items-center">
             <div className="flex w-full flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
               <Form method="get" className="flex w-full gap-2 sm:max-w-sm">
                 <Input name="q" defaultValue={q} placeholder="搜索敏感词" className="flex-1" />
-                <Button type="submit" variant="outline">搜索</Button>
+                <Button type="submit" variant="outline">
+                  搜索
+                </Button>
               </Form>
               <div className="flex w-full gap-2 sm:max-w-xl">
-              <Input
-                value={newWord}
-                onChange={(e) => setNewWord(e.target.value)}
-                placeholder="添加敏感词"
-                className="flex-1"
-              />
-               <Button onClick={handleAdd} disabled={adding || !newWord.trim()}>{adding ? "添加中" : "添加"}</Button>
-              <Button variant="outline" onClick={() => setShowBulk(!showBulk)}>
-                批量导入
-              </Button>
+                <Input
+                  value={newWord}
+                  onChange={(e) => setNewWord(e.target.value)}
+                  placeholder="添加敏感词"
+                  className="flex-1"
+                />
+                <Button onClick={handleAdd} disabled={adding || !newWord.trim()}>
+                  {adding ? "添加中" : "添加"}
+                </Button>
+                <Button variant="outline" onClick={() => setShowBulk(!showBulk)}>
+                  批量导入
+                </Button>
               </div>
             </div>
           </AdminToolbar>
@@ -154,57 +176,70 @@ export default function AdminKeywords({ loaderData }: any) {
                 placeholder="一行一个词"
                 rows={5}
               />
-               <Button onClick={handleBulk} disabled={importing || !bulkText.trim()}>
-                 {importing ? "导入中" : "导入"}
+              <Button onClick={handleBulk} disabled={importing || !bulkText.trim()}>
+                {importing ? "导入中" : "导入"}
               </Button>
             </div>
           )}
           <Table className="min-w-[560px]">
-          <colgroup>
-            <col />
-            <col className="w-32" />
-            <col className="w-24" />
-          </colgroup>
-          <TableHeader>
-            <TableRow>
-              <TableHead>敏感词</TableHead>
-              <TableHead className="text-right">命中次数</TableHead>
-              <TableHead className="text-right">操作</TableHead>
-            </TableRow>
-          </TableHeader>
-          <TableBody>
-            {keywords.map((kw: any) => (
-              <TableRow key={kw.id}>
-                <TableCell className="max-w-md break-all">{kw.word}</TableCell>
-                <TableCell className="text-right tabular-nums text-muted-foreground">{kw.hit_count}</TableCell>
-                <TableCell className="text-right">
-                  <Button
-                    size="sm"
-                    variant="destructive"
-                    onClick={(event) => {
-                      deleteTriggerRef.current = event.currentTarget;
-                      setDeleteTarget({ id: kw.id, word: kw.word });
-                    }}
-                  >
-                    删除
-                  </Button>
-                </TableCell>
+            <colgroup>
+              <col />
+              <col className="w-32" />
+              <col className="w-24" />
+            </colgroup>
+            <TableHeader>
+              <TableRow>
+                <TableHead>敏感词</TableHead>
+                <TableHead className="text-right">命中次数</TableHead>
+                <TableHead className="text-right">操作</TableHead>
               </TableRow>
-            ))}
-          </TableBody>
+            </TableHeader>
+            <TableBody>
+              {keywords.map((kw: any) => (
+                <TableRow key={kw.id}>
+                  <TableCell className="max-w-md break-all">{kw.word}</TableCell>
+                  <TableCell className="text-right tabular-nums text-muted-foreground">
+                    {kw.hit_count}
+                  </TableCell>
+                  <TableCell className="text-right">
+                    <Button
+                      size="sm"
+                      variant="destructive"
+                      onClick={(event) => {
+                        deleteTriggerRef.current = event.currentTarget;
+                        setDeleteTarget({ id: kw.id, word: kw.word });
+                      }}
+                    >
+                      删除
+                    </Button>
+                  </TableCell>
+                </TableRow>
+              ))}
+            </TableBody>
           </Table>
           <ConfirmationDialog
             open={deleteTarget !== null}
             onOpenChange={(open) => !open && setDeleteTarget(null)}
             title="删除敏感词规则"
-            description={<>将删除敏感词“{deleteTarget?.word}”。删除后新内容不再匹配该规则，历史巡检记录不会被删除。</>}
+            description={
+              <>
+                将删除敏感词“{deleteTarget?.word}
+                ”。删除后新内容不再匹配该规则，历史巡检记录不会被删除。
+              </>
+            }
             confirmLabel="确认删除规则"
             pendingLabel="删除中"
             pending={deleting}
             finalFocus={deleteTriggerRef}
             onConfirm={() => deleteTarget && handleDelete(deleteTarget.id)}
           />
-          <Pagination page={page} total={total} limit={limit} basePath="/admin/keywords" searchParams={{ ...(q ? { q } : {}) }} />
+          <Pagination
+            page={page}
+            total={total}
+            limit={limit}
+            basePath="/admin/keywords"
+            searchParams={{ ...(q ? { q } : {}) }}
+          />
         </AdminPanel>
       </AdminPage>
     </AdminLayout>
diff --git a/apps/web/app/routes/admin/mod.tsx b/apps/web/app/routes/admin/mod.tsx
index ba653ec..4309c17 100644
--- a/apps/web/app/routes/admin/mod.tsx
+++ b/apps/web/app/routes/admin/mod.tsx
@@ -65,10 +65,25 @@ export async function loader({ request }: any) {
   if (type) params.set("type", type);
   if (jobId > 0) params.set("job_id", String(jobId));
   const [res, jobsRes] = await Promise.all([
-    apiFetch<{ success: boolean; data: any[]; total?: number; summary?: any }>(`/api/v1/admin/moderation?${params.toString()}`, { headers: { cookie } }),
-    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/moderation/jobs", { headers: { cookie } }),
+    apiFetch<{ success: boolean; data: any[]; total?: number; summary?: any }>(
+      `/api/v1/admin/moderation?${params.toString()}`,
+      { headers: { cookie } },
+    ),
+    apiFetch<{ success: boolean; data: any[] }>("/api/v1/admin/moderation/jobs", {
+      headers: { cookie },
+    }),
   ]);
-  return { results: res.success ? res.data || [] : [], total: res.total ?? 0, summary: res.summary || {}, jobs: jobsRes.success ? jobsRes.data || [] : [], page, limit, status, type, jobId };
+  return {
+    results: res.success ? res.data || [] : [],
+    total: res.total ?? 0,
+    summary: res.summary || {},
+    jobs: jobsRes.success ? jobsRes.data || [] : [],
+    page,
+    limit,
+    status,
+    type,
+    jobId,
+  };
 }
 
 export default function AdminMod({ loaderData }: any) {
@@ -88,7 +103,10 @@ export default function AdminMod({ loaderData }: any) {
 
   const { run: handleAction, pending: actionPending } = useAsyncAction(
     (id: number, action: string) =>
-      apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/admin/moderation/${id}/${action}`, { method: "POST" }),
+      apiFetch<{ success: boolean; error_msg?: string }>(
+        `/api/v1/admin/moderation/${id}/${action}`,
+        { method: "POST" },
+      ),
     {
       onSuccess: (res) => {
         if (res.success) {
@@ -104,10 +122,13 @@ export default function AdminMod({ loaderData }: any) {
 
   const { run: runBulkAction, pending: bulkPending } = useAsyncAction(
     (action: string) =>
-      apiFetch<{ success: boolean; error_msg?: string; handled?: number }>("/api/v1/admin/moderation/bulk", {
-        method: "POST",
-        body: JSON.stringify({ ids: selected, action }),
-      }),
+      apiFetch<{ success: boolean; error_msg?: string; handled?: number }>(
+        "/api/v1/admin/moderation/bulk",
+        {
+          method: "POST",
+          body: JSON.stringify({ ids: selected, action }),
+        },
+      ),
     {
       onSuccess: (res) => {
         if (res.success) {
@@ -124,10 +145,13 @@ export default function AdminMod({ loaderData }: any) {
 
   const { run: runJobBulkConfirm, pending: jobBulkPending } = useAsyncAction(
     (id: number) =>
-      apiFetch<{ success: boolean; error_msg?: string; handled?: number }>("/api/v1/admin/moderation/bulk", {
-        method: "POST",
-        body: JSON.stringify({ job_id: id, action: "confirm" }),
-      }),
+      apiFetch<{ success: boolean; error_msg?: string; handled?: number }>(
+        "/api/v1/admin/moderation/bulk",
+        {
+          method: "POST",
+          body: JSON.stringify({ job_id: id, action: "confirm" }),
+        },
+      ),
     {
       onSuccess: (res) => {
         if (res.success) {
@@ -167,13 +191,22 @@ export default function AdminMod({ loaderData }: any) {
 
   const { run: updateJob, pending: jobPending } = useAsyncAction(
     async (id: number, action: string) => {
-      const res = await apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/admin/moderation/jobs/${id}/${action}`, { method: "POST" });
+      const res = await apiFetch<{ success: boolean; error_msg?: string }>(
+        `/api/v1/admin/moderation/jobs/${id}/${action}`,
+        { method: "POST" },
+      );
       return { ...res, action };
     },
     {
       onSuccess: (result) => {
         if (result.success) {
-          toast.success(result.action === "run" ? "已触发立即执行" : result.action === "cancel" ? "任务已取消" : "任务已更新");
+          toast.success(
+            result.action === "run"
+              ? "已触发立即执行"
+              : result.action === "cancel"
+                ? "任务已取消"
+                : "任务已更新",
+          );
           if (result.action === "cancel") setCancelJobId(null);
           revalidate();
         } else {
@@ -186,15 +219,34 @@ export default function AdminMod({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="workflow">
-        <AdminPageHeader title="巡检结果" description="处理敏感词和自动审核命中的内容，保留人工复核入口。" />
+        <AdminPageHeader
+          title="巡检结果"
+          description="处理敏感词和自动审核命中的内容，保留人工复核入口。"
+        />
         <AdminPanel
           title="扫描任务"
           description={`共 ${jobs.length} 个任务`}
           action={
             <div className="flex flex-wrap gap-2">
-              <Button size="sm" variant="outline" disabled={creatingJob} onClick={() => createJob("topics")}>扫描话题</Button>
-              <Button size="sm" variant="outline" disabled={creatingJob} onClick={() => createJob("replies")}>扫描回复</Button>
-              <Button size="sm" disabled={creatingJob} onClick={() => createJob("all")}>{creatingJob ? "创建中" : "扫描全部"}</Button>
+              <Button
+                size="sm"
+                variant="outline"
+                disabled={creatingJob}
+                onClick={() => createJob("topics")}
+              >
+                扫描话题
+              </Button>
+              <Button
+                size="sm"
+                variant="outline"
+                disabled={creatingJob}
+                onClick={() => createJob("replies")}
+              >
+                扫描回复
+              </Button>
+              <Button size="sm" disabled={creatingJob} onClick={() => createJob("all")}>
+                {creatingJob ? "创建中" : "扫描全部"}
+              </Button>
             </div>
           }
         >
@@ -206,12 +258,15 @@ export default function AdminMod({ loaderData }: any) {
                 <Item key={job.id} variant="outline" className="min-w-0">
                   <div className="grid w-full min-w-0 gap-3 lg:grid-cols-[10rem_minmax(0,1fr)_auto] lg:items-center">
                     <div className="flex items-center gap-2 lg:flex-col lg:items-start">
-                      <Badge variant={jobStatusVariant(job.status)}>{jobStatusLabels[job.status] || job.status}</Badge>
+                      <Badge variant={jobStatusVariant(job.status)}>
+                        {jobStatusLabels[job.status] || job.status}
+                      </Badge>
                       <span className="font-medium text-foreground">任务 #{job.id}</span>
                     </div>
                     <ItemContent className="min-w-0">
                       <ItemDescription>
-                        {scopeLabels[job.scope] || job.scope} · {modeLabels[job.mode] || job.mode}{job.reason ? ` · ${job.reason}` : ""}
+                        {scopeLabels[job.scope] || job.scope} · {modeLabels[job.mode] || job.mode}
+                        {job.reason ? ` · ${job.reason}` : ""}
                       </ItemDescription>
                       <dl className="grid gap-x-4 gap-y-2 text-sm sm:grid-cols-3 xl:grid-cols-5">
                         {[
@@ -221,7 +276,10 @@ export default function AdminMod({ loaderData }: any) {
                           ["话题游标", job.cursorTopicId || 0],
                           ["回复游标", job.cursorReplyId || 0],
                         ].map(([label, value]) => (
-                          <div key={label} className="flex items-baseline justify-between gap-2 sm:block">
+                          <div
+                            key={label}
+                            className="flex items-baseline justify-between gap-2 sm:block"
+                          >
                             <dt className="text-xs text-muted-foreground">{label}</dt>
                             <dd className="font-medium tabular-nums text-foreground">{value}</dd>
                           </div>
@@ -230,7 +288,11 @@ export default function AdminMod({ loaderData }: any) {
                     </ItemContent>
                     <ItemActions className="flex-wrap justify-end lg:max-w-72">
                       <Button
-                        render={<Link to={`/admin/moderation?status=${encodeURIComponent(status)}${type ? `&type=${encodeURIComponent(type)}` : ""}&job_id=${job.id}`} />}
+                        render={
+                          <Link
+                            to={`/admin/moderation?status=${encodeURIComponent(status)}${type ? `&type=${encodeURIComponent(type)}` : ""}&job_id=${job.id}`}
+                          />
+                        }
                         size="sm"
                         variant={jobId === job.id ? "default" : "outline"}
                       >
@@ -244,12 +306,37 @@ export default function AdminMod({ loaderData }: any) {
                             confirmJobFinalFocusRef.current = event.currentTarget;
                             setConfirmJobId(job.id);
                           }}
-                        >批量确认删除</Button>
+                        >
+                          批量确认删除
+                        </Button>
+                      ) : null}
+                      {job.status === "running" ? (
+                        <Button
+                          size="sm"
+                          variant="outline"
+                          onClick={() => updateJob(job.id, "pause")}
+                        >
+                          暂停
+                        </Button>
+                      ) : null}
+                      {job.status === "paused" || job.status === "failed" ? (
+                        <Button
+                          size="sm"
+                          variant="outline"
+                          onClick={() => updateJob(job.id, "resume")}
+                        >
+                          恢复
+                        </Button>
                       ) : null}
-                      {job.status === "running" ? <Button size="sm" variant="outline" onClick={() => updateJob(job.id, "pause")}>暂停</Button> : null}
-                      {job.status === "paused" || job.status === "failed" ? <Button size="sm" variant="outline" onClick={() => updateJob(job.id, "resume")}>恢复</Button> : null}
                       {job.status === "pending" || job.status === "paused" ? (
-                        <Button size="sm" variant="outline" onClick={() => updateJob(job.id, "run")} disabled={jobPending}>立即执行</Button>
+                        <Button
+                          size="sm"
+                          variant="outline"
+                          onClick={() => updateJob(job.id, "run")}
+                          disabled={jobPending}
+                        >
+                          立即执行
+                        </Button>
                       ) : null}
                       {["pending", "paused", "running"].includes(job.status) ? (
                         <Button
@@ -260,7 +347,9 @@ export default function AdminMod({ loaderData }: any) {
                             setCancelJobId(job.id);
                           }}
                           disabled={jobPending}
-                        >取消</Button>
+                        >
+                          取消
+                        </Button>
                       ) : null}
                     </ItemActions>
                   </div>
@@ -278,7 +367,9 @@ export default function AdminMod({ loaderData }: any) {
             open={cancelJobId !== null}
             onOpenChange={(open) => !open && setCancelJobId(null)}
             title="确认取消巡检任务"
-            description={<>取消任务 #{cancelJobId} 后将停止继续扫描；已经生成的巡检命中记录会保留。</>}
+            description={
+              <>取消任务 #{cancelJobId} 后将停止继续扫描；已经生成的巡检命中记录会保留。</>
+            }
             confirmLabel="确认取消任务"
             pendingLabel="取消中"
             pending={jobPending}
@@ -289,34 +380,73 @@ export default function AdminMod({ loaderData }: any) {
             open={confirmJobId !== null}
             onOpenChange={(open) => !open && setConfirmJobId(null)}
             title="确认批量删除巡检命中的原始内容"
-            description={<>将确认删除任务 #{confirmJobId} 下所有待处理命中的原始话题或回复。该操作会沿用现有软删除、计数器维护和处罚逻辑，不会从数据库物理删除内容。</>}
+            description={
+              <>
+                将确认删除任务 #{confirmJobId}{" "}
+                下所有待处理命中的原始话题或回复。该操作会沿用现有软删除、计数器维护和处罚逻辑，不会从数据库物理删除内容。
+              </>
+            }
             confirmLabel={`确认删除任务 #${confirmJobId} 的待处理命中`}
             pending={jobBulkPending}
             finalFocus={confirmJobFinalFocusRef}
             onConfirm={() => confirmJobId && runJobBulkConfirm(confirmJobId)}
           />
         </AdminPanel>
-        <AdminPanel title={jobId > 0 ? `任务 #${jobId} 待复核内容` : "待复核内容"} description={`当前页 ${results.length} 条 / 共 ${total} 条`} action={jobId > 0 ? <Button render={<Link to="/admin/moderation" />} size="sm" variant="outline">查看全部</Button> : null}>
+        <AdminPanel
+          title={jobId > 0 ? `任务 #${jobId} 待复核内容` : "待复核内容"}
+          description={`当前页 ${results.length} 条 / 共 ${total} 条`}
+          action={
+            jobId > 0 ? (
+              <Button render={<Link to="/admin/moderation" />} size="sm" variant="outline">
+                查看全部
+              </Button>
+            ) : null
+          }
+        >
           <Item variant="muted" size="sm">
             <ItemContent>
               <ItemTitle>队列摘要</ItemTitle>
               <div className="flex flex-wrap gap-2">
                 <Badge variant="outline">话题 {summary.by_type?.topic || 0}</Badge>
                 <Badge variant="outline">回复 {summary.by_type?.reply || 0}</Badge>
-                {Object.entries(summary.by_keyword || {}).slice(0, 6).map(([keyword, count]) => (
-                  <Badge key={String(keyword)} variant="secondary">{String(keyword)}: {String(count)}</Badge>
-                ))}
+                {Object.entries(summary.by_keyword || {})
+                  .slice(0, 6)
+                  .map(([keyword, count]) => (
+                    <Badge key={String(keyword)} variant="secondary">
+                      {String(keyword)}: {String(count)}
+                    </Badge>
+                  ))}
               </div>
             </ItemContent>
             {selected.length > 0 ? (
               <ItemActions className="basis-full flex-wrap sm:basis-auto">
                 <span className="font-medium">已选 {selected.length} 条</span>
-                <Button size="sm" variant="outline" disabled={bulkPending} onClick={() => handleBulkAction("ignore")}>批量忽略</Button>
-                <Button size="sm" variant="outline" disabled={bulkPending} onClick={() => handleBulkAction("falsepositive")}>批量误报</Button>
-                <Button size="sm" variant="destructive" onClick={(event) => {
-                  deleteFinalFocusRef.current = event.currentTarget;
-                  setDeleteTarget({ ids: selected, label: `${selected.length} 条巡检命中` });
-                }}>删除选中</Button>
+                <Button
+                  size="sm"
+                  variant="outline"
+                  disabled={bulkPending}
+                  onClick={() => handleBulkAction("ignore")}
+                >
+                  批量忽略
+                </Button>
+                <Button
+                  size="sm"
+                  variant="outline"
+                  disabled={bulkPending}
+                  onClick={() => handleBulkAction("falsepositive")}
+                >
+                  批量误报
+                </Button>
+                <Button
+                  size="sm"
+                  variant="destructive"
+                  onClick={(event) => {
+                    deleteFinalFocusRef.current = event.currentTarget;
+                    setDeleteTarget({ ids: selected, label: `${selected.length} 条巡检命中` });
+                  }}
+                >
+                  删除选中
+                </Button>
               </ItemActions>
             ) : null}
           </Item>
@@ -328,7 +458,9 @@ export default function AdminMod({ loaderData }: any) {
                 <Checkbox
                   aria-label="选择当前页全部巡检记录"
                   checked={selected.length === results.length && results.length > 0}
-                  onCheckedChange={(checked) => setSelected(checked ? results.map((r: any) => r.id) : [])}
+                  onCheckedChange={(checked) =>
+                    setSelected(checked ? results.map((r: any) => r.id) : [])
+                  }
                 />
                 选择当前页全部记录
               </label>
@@ -341,23 +473,34 @@ export default function AdminMod({ loaderData }: any) {
                         checked={selected.includes(r.id)}
                         onCheckedChange={() => toggleSelect(r.id)}
                       />
-                      <Badge variant={r.type === "topic" ? "default" : "secondary"}>{r.type === "topic" ? "话题" : "回复"}</Badge>
-                      <Badge variant="outline">{resultStatusLabels[r.status] || r.status || "待处理"}</Badge>
+                      <Badge variant={r.type === "topic" ? "default" : "secondary"}>
+                        {r.type === "topic" ? "话题" : "回复"}
+                      </Badge>
+                      <Badge variant="outline">
+                        {resultStatusLabels[r.status] || r.status || "待处理"}
+                      </Badge>
                     </div>
                     <ItemContent className="min-w-0">
-                      <ItemTitle className="w-full whitespace-normal">{r.type === "topic" ? "话题" : "回复"} #{r.target_id}</ItemTitle>
+                      <ItemTitle className="w-full whitespace-normal">
+                        {r.type === "topic" ? "话题" : "回复"} #{r.target_id}
+                      </ItemTitle>
                       <ItemDescription>
                         {r.scan_job_id ? <>任务 #{r.scan_job_id} · </> : null}
                         字段 {r.field || "content"} · 巡检时间 {r.scanned_at}
                       </ItemDescription>
                       <div className="text-sm text-muted-foreground">
-                        所属话题: <Link to={`/topic/${r.topic_id || r.target_id}`}>#{r.topic_id || r.target_id}</Link>
+                        所属话题:{" "}
+                        <Link to={`/topic/${r.topic_id || r.target_id}`}>
+                          #{r.topic_id || r.target_id}
+                        </Link>
                         {r.author_id ? <span> · 作者 ID {r.author_id}</span> : null}
                       </div>
                       <div className="flex flex-wrap items-center gap-2 text-sm">
                         <span>命中敏感词:</span>
                         {r.keywords?.map((kw: string) => (
-                          <Badge key={kw} variant="destructive">{kw}</Badge>
+                          <Badge key={kw} variant="destructive">
+                            {kw}
+                          </Badge>
                         ))}
                       </div>
                       <Alert>
@@ -366,24 +509,61 @@ export default function AdminMod({ loaderData }: any) {
                       </Alert>
                     </ItemContent>
                     <ItemActions className="flex-wrap justify-end md:max-w-52">
-                      <Button size="sm" variant="destructive" onClick={(event) => {
-                        deleteFinalFocusRef.current = event.currentTarget;
-                        setDeleteTarget({ ids: [r.id], label: `${r.type === "topic" ? "话题" : "回复"} #${r.target_id}` });
-                      }}>确认删除</Button>
-                      <Button size="sm" variant="outline" disabled={actionPending} onClick={() => handleAction(r.id, "ignore")}>忽略</Button>
-                      <Button size="sm" variant="ghost" disabled={actionPending} onClick={() => handleAction(r.id, "falsepositive")}>标记误报</Button>
+                      <Button
+                        size="sm"
+                        variant="destructive"
+                        onClick={(event) => {
+                          deleteFinalFocusRef.current = event.currentTarget;
+                          setDeleteTarget({
+                            ids: [r.id],
+                            label: `${r.type === "topic" ? "话题" : "回复"} #${r.target_id}`,
+                          });
+                        }}
+                      >
+                        确认删除
+                      </Button>
+                      <Button
+                        size="sm"
+                        variant="outline"
+                        disabled={actionPending}
+                        onClick={() => handleAction(r.id, "ignore")}
+                      >
+                        忽略
+                      </Button>
+                      <Button
+                        size="sm"
+                        variant="ghost"
+                        disabled={actionPending}
+                        onClick={() => handleAction(r.id, "falsepositive")}
+                      >
+                        标记误报
+                      </Button>
                     </ItemActions>
                   </div>
                 </Item>
               ))}
-              <Pagination page={page} total={total} limit={limit} basePath="/admin/moderation" searchParams={{ status, ...(type ? { type } : {}), ...(jobId > 0 ? { job_id: String(jobId) } : {}) }} />
+              <Pagination
+                page={page}
+                total={total}
+                limit={limit}
+                basePath="/admin/moderation"
+                searchParams={{
+                  status,
+                  ...(type ? { type } : {}),
+                  ...(jobId > 0 ? { job_id: String(jobId) } : {}),
+                }}
+              />
             </ItemGroup>
           )}
           <ConfirmationDialog
             open={deleteTarget !== null}
             onOpenChange={(open) => !open && setDeleteTarget(null)}
             title="确认违规并删除命中内容"
-            description={<>将确认 {deleteTarget?.label} 违规并软删除对应原始内容。该操作会更新计数和处罚记录。</>}
+            description={
+              <>
+                将确认 {deleteTarget?.label} 违规并软删除对应原始内容。该操作会更新计数和处罚记录。
+              </>
+            }
             confirmLabel={`确认删除 ${deleteTarget?.ids.length || 0} 条内容`}
             pending={deleteTarget?.ids.length === 1 ? actionPending : bulkPending}
             finalFocus={deleteFinalFocusRef}
diff --git a/apps/web/app/routes/admin/reports.tsx b/apps/web/app/routes/admin/reports.tsx
index 9791a55..1e782aa 100644
--- a/apps/web/app/routes/admin/reports.tsx
+++ b/apps/web/app/routes/admin/reports.tsx
@@ -13,7 +13,15 @@ import { NativeSelect } from "~/components/ui/native-select";
 import { useRef, useState } from "react";
 import { ConfirmationDialog } from "~/components/ConfirmationDialog";
 import { previousPageAfterRemoval } from "~/lib/post-mutation-navigation";
-import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemHeader, ItemTitle } from "~/components/ui/item";
+import {
+  Item,
+  ItemActions,
+  ItemContent,
+  ItemDescription,
+  ItemGroup,
+  ItemHeader,
+  ItemTitle,
+} from "~/components/ui/item";
 
 export function meta() {
   return [{ title: "举报队列 · CNode Admin" }];
@@ -54,7 +62,13 @@ export default function AdminReports({ loaderData }: any) {
         if (result.success) {
           toast.success(result.action === "confirm" ? "已确认违规" : "已驳回");
           if (result.action === "confirm") setConfirmTarget(null);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: reports.length, removedCount: 1 });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: reports.length,
+            removedCount: 1,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -67,15 +81,28 @@ export default function AdminReports({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="workflow">
-        <AdminPageHeader title="举报队列" description="集中确认用户举报，区分违规内容和误报反馈。" />
-        <AdminPanel title="举报记录" description={`当前显示 ${reports.length} / ${total} 条举报记录`}>
+        <AdminPageHeader
+          title="举报队列"
+          description="集中确认用户举报，区分违规内容和误报反馈。"
+        />
+        <AdminPanel
+          title="举报记录"
+          description={`当前显示 ${reports.length} / ${total} 条举报记录`}
+        >
           <Form method="get" className="mb-4 flex max-w-xs gap-2">
-            <NativeSelect name="status" defaultValue={status} aria-label="举报状态" className="flex-1">
+            <NativeSelect
+              name="status"
+              defaultValue={status}
+              aria-label="举报状态"
+              className="flex-1"
+            >
               <option value="pending">待处理</option>
               <option value="confirmed">已确认</option>
               <option value="dismissed">已驳回</option>
             </NativeSelect>
-            <Button type="submit" variant="outline">筛选</Button>
+            <Button type="submit" variant="outline">
+              筛选
+            </Button>
           </Form>
           {reports.length === 0 ? (
             <EmptyState message="暂无举报" />
@@ -87,29 +114,44 @@ export default function AdminReports({ loaderData }: any) {
                     <ItemHeader>
                       <ItemTitle>
                         <Badge variant="destructive">{r.type}</Badge>
-                        <a href={r.topic_id ? `/topic/${r.topic_id}` : "#"}>{r.topic_title || "目标内容已不可见"}</a>
+                        <a href={r.topic_id ? `/topic/${r.topic_id}` : "#"}>
+                          {r.topic_title || "目标内容已不可见"}
+                        </a>
                       </ItemTitle>
                     </ItemHeader>
-                    <ItemDescription>{r.reporter_count || 0} 人举报 · {r.target_type} #{r.target_id}</ItemDescription>
-                    {r.target_type === "reply" && <p className="break-words text-sm text-muted-foreground">{r.target_summary}</p>}
-              {r.description && (
-                    <p className="border-l-2 pl-3 text-sm break-words text-muted-foreground">{r.description}</p>
-              )}
+                    <ItemDescription>
+                      {r.reporter_count || 0} 人举报 · {r.target_type} #{r.target_id}
+                    </ItemDescription>
+                    {r.target_type === "reply" && (
+                      <p className="break-words text-sm text-muted-foreground">
+                        {r.target_summary}
+                      </p>
+                    )}
+                    {r.description && (
+                      <p className="border-l-2 pl-3 text-sm break-words text-muted-foreground">
+                        {r.description}
+                      </p>
+                    )}
                   </ItemContent>
                   <ItemActions className="basis-full flex-wrap sm:basis-auto">
-                <Button
-                  size="sm"
-                  variant="destructive"
-                  onClick={(event) => {
-                    confirmTriggerRef.current = event.currentTarget;
-                    setConfirmTarget(r);
-                  }}
-                >
-                  确认违规
-                </Button>
-                <Button size="sm" variant="outline" disabled={handling} onClick={() => handleAction(r.id, "dismiss")}>
-                  {handling ? "处理中" : "驳回"}
-                </Button>
+                    <Button
+                      size="sm"
+                      variant="destructive"
+                      onClick={(event) => {
+                        confirmTriggerRef.current = event.currentTarget;
+                        setConfirmTarget(r);
+                      }}
+                    >
+                      确认违规
+                    </Button>
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      disabled={handling}
+                      onClick={() => handleAction(r.id, "dismiss")}
+                    >
+                      {handling ? "处理中" : "驳回"}
+                    </Button>
                   </ItemActions>
                 </Item>
               ))}
@@ -119,14 +161,26 @@ export default function AdminReports({ loaderData }: any) {
             open={confirmTarget !== null}
             onOpenChange={(open) => !open && setConfirmTarget(null)}
             title="确认违规并删除内容"
-            description={<>将确认举报 #{confirmTarget?.id} 违规，并删除{confirmTarget?.target_type === "reply" ? "回复" : "话题"} #{confirmTarget?.target_id}：{confirmTarget?.topic_title || "目标内容"}。</>}
+            description={
+              <>
+                将确认举报 #{confirmTarget?.id} 违规，并删除
+                {confirmTarget?.target_type === "reply" ? "回复" : "话题"} #
+                {confirmTarget?.target_id}：{confirmTarget?.topic_title || "目标内容"}。
+              </>
+            }
             confirmLabel="确认违规并删除"
             pendingLabel="处理中"
             pending={handling}
             finalFocus={confirmTriggerRef}
             onConfirm={() => confirmTarget && handleAction(confirmTarget.id, "confirm")}
           />
-          <Pagination page={page} total={total} limit={limit} basePath="/admin/reports" searchParams={{ status }} />
+          <Pagination
+            page={page}
+            total={total}
+            limit={limit}
+            basePath="/admin/reports"
+            searchParams={{ status }}
+          />
         </AdminPanel>
       </AdminPage>
     </AdminLayout>
diff --git a/apps/web/app/routes/admin/settings.tsx b/apps/web/app/routes/admin/settings.tsx
index ef0798d..ed40ef8 100644
--- a/apps/web/app/routes/admin/settings.tsx
+++ b/apps/web/app/routes/admin/settings.tsx
@@ -19,18 +19,22 @@ export function meta() {
 export async function loader({ request }: any) {
   await requireAdmin(request);
   const cookie = request.headers.get("cookie") || "";
-  const res = await apiFetch<{ success: boolean; data: any }>("/api/v1/admin/settings", { headers: { cookie } });
+  const res = await apiFetch<{ success: boolean; data: any }>("/api/v1/admin/settings", {
+    headers: { cookie },
+  });
   const requestedTab = new URL(request.url).searchParams.get("tab");
   const tab = requestedTab === "newuser" || requestedTab === "rate" ? requestedTab : "registration";
   return {
     tab,
-    config: res.success ? res.data : {
-      allow_signup: true,
-      new_user_min_hours: 24,
-      new_user_min_replies: 3,
-      rate_topic: 1000,
-      rate_reply: 1000,
-    },
+    config: res.success
+      ? res.data
+      : {
+          allow_signup: true,
+          new_user_min_hours: 24,
+          new_user_min_replies: 3,
+          rate_topic: 1000,
+          rate_reply: 1000,
+        },
   };
 }
 
@@ -38,7 +42,11 @@ export default function AdminSettings({ loaderData }: any) {
   const [config, setConfig] = useState(loaderData.config);
   const [searchParams, setSearchParams] = useSearchParams();
   const { run: handleSave, pending: saving } = useAsyncAction(
-    () => apiFetch<{ success: boolean; error_msg?: string }>("/api/v1/admin/settings", { method: "POST", body: JSON.stringify(config) }),
+    () =>
+      apiFetch<{ success: boolean; error_msg?: string }>("/api/v1/admin/settings", {
+        method: "POST",
+        body: JSON.stringify(config),
+      }),
     {
       errorMessage: "保存失败",
       onSuccess: (result) => {
@@ -51,120 +59,139 @@ export default function AdminSettings({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="workflow">
-      <AdminPageHeader title="系统设置" description="维护注册、内容巡检、新用户门槛和基础限流策略。" />
-      <Tabs
-        value={loaderData.tab}
-        onValueChange={(value) => {
-          if (!value || value === loaderData.tab) return;
-          const next = new URLSearchParams(searchParams);
-          next.set("tab", value);
-          setSearchParams(next);
-        }}
-        className="flex flex-col gap-4"
-      >
-        <TabsList className="w-full max-w-3xl flex-wrap justify-start">
-          <TabsTrigger value="registration" className="flex-none">注册配置</TabsTrigger>
-          <TabsTrigger value="newuser" className="flex-none">新用户限制</TabsTrigger>
-          <TabsTrigger value="rate" className="flex-none">限流配置</TabsTrigger>
-        </TabsList>
-        <TabsContent value="registration">
-          <AdminPanel title="注册配置" description="控制新用户是否可以自主注册" className="max-w-3xl">
-            <FieldSet>
-              <FieldLegend className="sr-only">注册配置</FieldLegend>
-              <FieldGroup>
-              <Field orientation="responsive">
-                <FieldLabel htmlFor="allow_signup">
-                  开放注册
-                </FieldLabel>
-                <Checkbox
-                  id="allow_signup"
-                  aria-label="开放注册"
-                  checked={config.allow_signup}
-                  onCheckedChange={(v) => setConfig({ ...config, allow_signup: !!v })}
-                />
-              </Field>
-              <div className="flex justify-end">
-                <Button onClick={handleSave} disabled={saving}>
-                  {saving ? "保存中..." : "保存"}
-                </Button>
-              </div>
-              </FieldGroup>
-            </FieldSet>
-          </AdminPanel>
-        </TabsContent>
-        <TabsContent value="newuser">
-          <AdminPanel title="新用户限制" description="降低新注册账号的灌水和垃圾内容风险" className="max-w-3xl">
-            <FieldSet>
-              <FieldLegend className="sr-only">新用户限制</FieldLegend>
-              <FieldGroup>
-              <Field orientation="responsive">
-                <FieldLabel htmlFor="new-user-min-hours">注册多少小时后可发帖</FieldLabel>
-                <Input
-                  id="new-user-min-hours"
-                  type="number"
-                  value={config.new_user_min_hours}
-                  onChange={(e) =>
-                    setConfig({ ...config, new_user_min_hours: Number(e.target.value) })
-                  }
-                  className="w-32"
-                />
-              </Field>
-              <Field orientation="responsive">
-                <FieldLabel htmlFor="new-user-min-replies">回复多少条后可发帖</FieldLabel>
-                <Input
-                  id="new-user-min-replies"
-                  type="number"
-                  value={config.new_user_min_replies}
-                  onChange={(e) =>
-                    setConfig({ ...config, new_user_min_replies: Number(e.target.value) })
-                  }
-                  className="w-32"
-                />
-              </Field>
-              <div className="flex justify-end">
-                <Button onClick={handleSave} disabled={saving}>
-                  {saving ? "保存中..." : "保存"}
-                </Button>
-              </div>
-              </FieldGroup>
-            </FieldSet>
-          </AdminPanel>
-        </TabsContent>
-        <TabsContent value="rate">
-          <AdminPanel title="限流配置" description="按用户维度限制每日发帖与回复频率" className="max-w-3xl">
-            <FieldSet>
-              <FieldLegend className="sr-only">限流配置</FieldLegend>
-              <FieldGroup>
-              <Field orientation="responsive">
-                <FieldLabel htmlFor="rate-topic">每用户每天发帖</FieldLabel>
-                <Input
-                  id="rate-topic"
-                  type="number"
-                  value={config.rate_topic}
-                  onChange={(e) => setConfig({ ...config, rate_topic: Number(e.target.value) })}
-                  className="w-32"
-                />
-              </Field>
-              <Field orientation="responsive">
-                <FieldLabel htmlFor="rate-reply">每用户每天回复</FieldLabel>
-                <Input
-                  id="rate-reply"
-                  type="number"
-                  value={config.rate_reply}
-                  onChange={(e) => setConfig({ ...config, rate_reply: Number(e.target.value) })}
-                  className="w-32"
-                />
-              </Field>
-              <div className="flex justify-end">
-                <Button onClick={handleSave} disabled={saving}>
-                  {saving ? "保存中..." : "保存"}
-                </Button>
-              </div>
-              </FieldGroup>
-            </FieldSet>
-          </AdminPanel>
-        </TabsContent>
-      </Tabs>
+        <AdminPageHeader
+          title="系统设置"
+          description="维护注册、内容巡检、新用户门槛和基础限流策略。"
+        />
+        <Tabs
+          value={loaderData.tab}
+          onValueChange={(value) => {
+            if (!value || value === loaderData.tab) return;
+            const next = new URLSearchParams(searchParams);
+            next.set("tab", value);
+            setSearchParams(next);
+          }}
+          className="flex flex-col gap-4"
+        >
+          <TabsList className="w-full max-w-3xl flex-wrap justify-start">
+            <TabsTrigger value="registration" className="flex-none">
+              注册配置
+            </TabsTrigger>
+            <TabsTrigger value="newuser" className="flex-none">
+              新用户限制
+            </TabsTrigger>
+            <TabsTrigger value="rate" className="flex-none">
+              限流配置
+            </TabsTrigger>
+          </TabsList>
+          <TabsContent value="registration">
+            <AdminPanel
+              title="注册配置"
+              description="控制新用户是否可以自主注册"
+              className="max-w-3xl"
+            >
+              <FieldSet>
+                <FieldLegend className="sr-only">注册配置</FieldLegend>
+                <FieldGroup>
+                  <Field orientation="responsive">
+                    <FieldLabel htmlFor="allow_signup">开放注册</FieldLabel>
+                    <Checkbox
+                      id="allow_signup"
+                      aria-label="开放注册"
+                      checked={config.allow_signup}
+                      onCheckedChange={(v) => setConfig({ ...config, allow_signup: !!v })}
+                    />
+                  </Field>
+                  <div className="flex justify-end">
+                    <Button onClick={handleSave} disabled={saving}>
+                      {saving ? "保存中..." : "保存"}
+                    </Button>
+                  </div>
+                </FieldGroup>
+              </FieldSet>
+            </AdminPanel>
+          </TabsContent>
+          <TabsContent value="newuser">
+            <AdminPanel
+              title="新用户限制"
+              description="降低新注册账号的灌水和垃圾内容风险"
+              className="max-w-3xl"
+            >
+              <FieldSet>
+                <FieldLegend className="sr-only">新用户限制</FieldLegend>
+                <FieldGroup>
+                  <Field orientation="responsive">
+                    <FieldLabel htmlFor="new-user-min-hours">注册多少小时后可发帖</FieldLabel>
+                    <Input
+                      id="new-user-min-hours"
+                      type="number"
+                      value={config.new_user_min_hours}
+                      onChange={(e) =>
+                        setConfig({ ...config, new_user_min_hours: Number(e.target.value) })
+                      }
+                      className="w-32"
+                    />
+                  </Field>
+                  <Field orientation="responsive">
+                    <FieldLabel htmlFor="new-user-min-replies">回复多少条后可发帖</FieldLabel>
+                    <Input
+                      id="new-user-min-replies"
+                      type="number"
+                      value={config.new_user_min_replies}
+                      onChange={(e) =>
+                        setConfig({ ...config, new_user_min_replies: Number(e.target.value) })
+                      }
+                      className="w-32"
+                    />
+                  </Field>
+                  <div className="flex justify-end">
+                    <Button onClick={handleSave} disabled={saving}>
+                      {saving ? "保存中..." : "保存"}
+                    </Button>
+                  </div>
+                </FieldGroup>
+              </FieldSet>
+            </AdminPanel>
+          </TabsContent>
+          <TabsContent value="rate">
+            <AdminPanel
+              title="限流配置"
+              description="按用户维度限制每日发帖与回复频率"
+              className="max-w-3xl"
+            >
+              <FieldSet>
+                <FieldLegend className="sr-only">限流配置</FieldLegend>
+                <FieldGroup>
+                  <Field orientation="responsive">
+                    <FieldLabel htmlFor="rate-topic">每用户每天发帖</FieldLabel>
+                    <Input
+                      id="rate-topic"
+                      type="number"
+                      value={config.rate_topic}
+                      onChange={(e) => setConfig({ ...config, rate_topic: Number(e.target.value) })}
+                      className="w-32"
+                    />
+                  </Field>
+                  <Field orientation="responsive">
+                    <FieldLabel htmlFor="rate-reply">每用户每天回复</FieldLabel>
+                    <Input
+                      id="rate-reply"
+                      type="number"
+                      value={config.rate_reply}
+                      onChange={(e) => setConfig({ ...config, rate_reply: Number(e.target.value) })}
+                      className="w-32"
+                    />
+                  </Field>
+                  <div className="flex justify-end">
+                    <Button onClick={handleSave} disabled={saving}>
+                      {saving ? "保存中..." : "保存"}
+                    </Button>
+                  </div>
+                </FieldGroup>
+              </FieldSet>
+            </AdminPanel>
+          </TabsContent>
+        </Tabs>
       </AdminPage>
     </AdminLayout>
   );
diff --git a/apps/web/app/routes/admin/tabs.tsx b/apps/web/app/routes/admin/tabs.tsx
index 8cf5621..99e9570 100644
--- a/apps/web/app/routes/admin/tabs.tsx
+++ b/apps/web/app/routes/admin/tabs.tsx
@@ -50,9 +50,7 @@ export default function AdminTabs({ loaderData }: { loaderData: any }) {
   }, [initialTabs]);
 
   function updateField(id: number, field: keyof TabRow, value: any) {
-    setTabs((prev) =>
-      prev.map((t) => (t.id === id ? { ...t, [field]: value } : t)),
-    );
+    setTabs((prev) => prev.map((t) => (t.id === id ? { ...t, [field]: value } : t)));
   }
 
   async function saveTab(id: number) {
@@ -85,70 +83,73 @@ export default function AdminTabs({ loaderData }: { loaderData: any }) {
   return (
     <AdminLayout>
       <AdminPage archetype="data-list">
-          <AdminPageHeader title="Tab 管理" description="控制首页 tab 按钮的可见性、标签和排序；内部 tab 仅管理员可见。" />
+        <AdminPageHeader
+          title="Tab 管理"
+          description="控制首页 tab 按钮的可见性、标签和排序；内部 tab 仅管理员可见。"
+        />
         <AdminPanel title="Tab 列表" description={`共 ${tabs.length} 个 tab`} flush>
-            <Table className="min-w-[640px]">
-              <TableHeader>
-                <TableRow>
-                  <TableHead className="w-24">Key (只读)</TableHead>
-                  <TableHead className="min-w-32">标签</TableHead>
-                  <TableHead className="w-24">范围</TableHead>
-                  <TableHead className="w-28">可见状态</TableHead>
-                  <TableHead className="w-20">排序</TableHead>
-                  <TableHead className="w-24 text-right">操作</TableHead>
+          <Table className="min-w-[640px]">
+            <TableHeader>
+              <TableRow>
+                <TableHead className="w-24">Key (只读)</TableHead>
+                <TableHead className="min-w-32">标签</TableHead>
+                <TableHead className="w-24">范围</TableHead>
+                <TableHead className="w-28">可见状态</TableHead>
+                <TableHead className="w-20">排序</TableHead>
+                <TableHead className="w-24 text-right">操作</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {tabs.map((tab) => (
+                <TableRow key={tab.id}>
+                  <TableCell className="font-mono text-xs">{tab.key}</TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${tab.key} 标签`}
+                      value={tab.label}
+                      onChange={(e) => updateField(tab.id, "label", e.target.value)}
+                    />
+                  </TableCell>
+                  <TableCell className="text-xs text-muted-foreground">
+                    {tab.scope === "admin" ? "管理员专用" : "公开"}
+                  </TableCell>
+                  <TableCell>
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant={tab.visible ? "secondary" : "ghost"}
+                      aria-pressed={tab.visible}
+                      aria-label={`${tab.key} 当前${tab.visible ? "可见" : "隐藏"}，点击切换`}
+                      className="min-w-20 justify-start"
+                      onClick={() => updateField(tab.id, "visible", !tab.visible)}
+                    >
+                      {tab.visible ? <Eye /> : <EyeOff />}
+                      {tab.visible ? "显示" : "隐藏"}
+                    </Button>
+                  </TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${tab.key} 排序`}
+                      type="number"
+                      value={tab.sort_order}
+                      onChange={(e) => updateField(tab.id, "sort_order", Number(e.target.value))}
+                      className="w-20"
+                    />
+                  </TableCell>
+                  <TableCell className="text-right">
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      onClick={() => saveTab(tab.id)}
+                      disabled={saving === tab.id}
+                    >
+                      {saving === tab.id ? "保存中…" : "保存"}
+                    </Button>
+                  </TableCell>
                 </TableRow>
-              </TableHeader>
-              <TableBody>
-                {tabs.map((tab) => (
-                  <TableRow key={tab.id}>
-                    <TableCell className="font-mono text-xs">{tab.key}</TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${tab.key} 标签`}
-                        value={tab.label}
-                        onChange={(e) => updateField(tab.id, "label", e.target.value)}
-                      />
-                    </TableCell>
-                    <TableCell className="text-xs text-muted-foreground">
-                      {tab.scope === "admin" ? "管理员专用" : "公开"}
-                    </TableCell>
-                    <TableCell>
-                      <Button
-                        type="button"
-                        size="sm"
-                        variant={tab.visible ? "secondary" : "ghost"}
-                        aria-pressed={tab.visible}
-                        aria-label={`${tab.key} 当前${tab.visible ? "可见" : "隐藏"}，点击切换`}
-                        className="min-w-20 justify-start"
-                        onClick={() => updateField(tab.id, "visible", !tab.visible)}
-                      >
-                        {tab.visible ? <Eye /> : <EyeOff />}
-                        {tab.visible ? "显示" : "隐藏"}
-                      </Button>
-                    </TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${tab.key} 排序`}
-                        type="number"
-                        value={tab.sort_order}
-                        onChange={(e) => updateField(tab.id, "sort_order", Number(e.target.value))}
-                        className="w-20"
-                      />
-                    </TableCell>
-                    <TableCell className="text-right">
-                      <Button
-                        size="sm"
-                        variant="outline"
-                        onClick={() => saveTab(tab.id)}
-                        disabled={saving === tab.id}
-                      >
-                        {saving === tab.id ? "保存中…" : "保存"}
-                      </Button>
-                    </TableCell>
-                  </TableRow>
-                ))}
-              </TableBody>
-            </Table>
+              ))}
+            </TableBody>
+          </Table>
         </AdminPanel>
       </AdminPage>
     </AdminLayout>
diff --git a/apps/web/app/routes/admin/topics.tsx b/apps/web/app/routes/admin/topics.tsx
index dccc20c..16a8a69 100644
--- a/apps/web/app/routes/admin/topics.tsx
+++ b/apps/web/app/routes/admin/topics.tsx
@@ -52,15 +52,46 @@ export async function loader({ request }: any) {
   if (dateFrom) params.set("date_from", dateFrom);
   if (dateTo) params.set("date_to", dateTo);
   if (sort && sort !== "create_at_desc") params.set("sort", sort);
-  const res = await apiFetch<{ success: boolean; data: any[]; total?: number; page?: number; limit?: number }>(
-    `/api/v1/admin/topics?${params.toString()}`,
-    { headers: { cookie } },
-  );
-  return { topics: res.success ? res.data || [] : [], total: res.total ?? 0, page, limit, q, tab, visibility, flag, dateField, dateFrom, dateTo, sort, user };
+  const res = await apiFetch<{
+    success: boolean;
+    data: any[];
+    total?: number;
+    page?: number;
+    limit?: number;
+  }>(`/api/v1/admin/topics?${params.toString()}`, { headers: { cookie } });
+  return {
+    topics: res.success ? res.data || [] : [],
+    total: res.total ?? 0,
+    page,
+    limit,
+    q,
+    tab,
+    visibility,
+    flag,
+    dateField,
+    dateFrom,
+    dateTo,
+    sort,
+    user,
+  };
 }
 
 export default function AdminTopics({ loaderData }: any) {
-  const { topics, total, page, limit, q, tab, visibility, flag, dateField, dateFrom, dateTo, sort, user } = loaderData;
+  const {
+    topics,
+    total,
+    page,
+    limit,
+    q,
+    tab,
+    visibility,
+    flag,
+    dateField,
+    dateFrom,
+    dateTo,
+    sort,
+    user,
+  } = loaderData;
   const isAdmin = !!user?.is_admin;
   const [selected, setSelected] = useState<number[]>([]);
   const [muteIds, setMuteIds] = useState<number[]>([]);
@@ -72,8 +103,19 @@ export default function AdminTopics({ loaderData }: any) {
   const { revalidate } = useRevalidator();
   const location = useLocation();
   const navigate = useNavigate();
-  const activeFilterCount = [q, tab, visibility !== "all" ? visibility : "", flag !== "all" ? flag : "", dateFrom, dateTo, dateField !== "create_at" ? dateField : "", sort !== "create_at_desc" ? sort : ""].filter(Boolean).length;
-  const visibleDeleted = topics.filter((topic: any) => topic.deleted > 0 || topic.status === "deleted").length;
+  const activeFilterCount = [
+    q,
+    tab,
+    visibility !== "all" ? visibility : "",
+    flag !== "all" ? flag : "",
+    dateFrom,
+    dateTo,
+    dateField !== "create_at" ? dateField : "",
+    sort !== "create_at_desc" ? sort : "",
+  ].filter(Boolean).length;
+  const visibleDeleted = topics.filter(
+    (topic: any) => topic.deleted > 0 || topic.status === "deleted",
+  ).length;
   const visibleMuted = topics.filter((topic: any) => topic.status === "muted").length;
   const visibleFeatured = topics.filter((topic: any) => topic.top > 0 || topic.good > 0).length;
   const paginationParams = {
@@ -106,7 +148,16 @@ export default function AdminTopics({ loaderData }: any) {
           setSelected([]);
           setMuteIds([]);
           setSoftDeleteIds([]);
-          const fallback = res.action === "delete" ? previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: topics.length, removedCount: res.ids.length }) : null;
+          const fallback =
+            res.action === "delete"
+              ? previousPageAfterRemoval({
+                  pathname: location.pathname,
+                  search: location.search,
+                  page,
+                  currentItemCount: topics.length,
+                  removedCount: res.ids.length,
+                })
+              : null;
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -128,7 +179,13 @@ export default function AdminTopics({ loaderData }: any) {
           toast.success(`已永久删除 ${res.deleted || permanentDeleteIds.length} 个话题`);
           setSelected([]);
           setPermanentDeleteIds([]);
-          const fallback = previousPageAfterRemoval({ pathname: location.pathname, search: location.search, page, currentItemCount: topics.length, removedCount: res.deleted || permanentDeleteIds.length });
+          const fallback = previousPageAfterRemoval({
+            pathname: location.pathname,
+            search: location.search,
+            page,
+            currentItemCount: topics.length,
+            removedCount: res.deleted || permanentDeleteIds.length,
+          });
           if (fallback) navigate(fallback, { replace: true });
           else revalidate();
         } else {
@@ -147,8 +204,15 @@ export default function AdminTopics({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="data-list">
-        <AdminPageHeader title="话题管理" description="集中处理置顶、加精、隐藏和删除等内容运营动作。" />
-        <AdminPanel title="内容治理队列" description={`当前页 ${topics.length} 条 / 共 ${total} 条`} flush>
+        <AdminPageHeader
+          title="话题管理"
+          description="集中处理置顶、加精、隐藏和删除等内容运营动作。"
+        />
+        <AdminPanel
+          title="内容治理队列"
+          description={`当前页 ${topics.length} 条 / 共 ${total} 条`}
+          flush
+        >
           <div className="grid gap-3 sm:grid-cols-4">
             <div>
               <div className="text-xs text-muted-foreground">筛选结果</div>
@@ -160,7 +224,9 @@ export default function AdminTopics({ loaderData }: any) {
             </div>
             <div>
               <div className="text-xs text-muted-foreground">隐藏 / 删除</div>
-              <div className="mt-1 text-2xl font-semibold text-foreground">{visibleMuted} / {visibleDeleted}</div>
+              <div className="mt-1 text-2xl font-semibold text-foreground">
+                {visibleMuted} / {visibleDeleted}
+              </div>
             </div>
             <div>
               <div className="text-xs text-muted-foreground">活跃筛选</div>
@@ -168,7 +234,10 @@ export default function AdminTopics({ loaderData }: any) {
             </div>
           </div>
           <AdminToolbar className="items-stretch sm:flex-col sm:items-stretch">
-            <Form method="get" className="grid gap-2 lg:grid-cols-[minmax(220px,1fr)_repeat(4,minmax(112px,auto))_auto_auto]">
+            <Form
+              method="get"
+              className="grid gap-2 lg:grid-cols-[minmax(220px,1fr)_repeat(4,minmax(112px,auto))_auto_auto]"
+            >
               <Input name="q" defaultValue={q} placeholder="搜索话题标题" />
               <NativeSelect name="tab" defaultValue={tab || "all"} size="sm" aria-label="Tab 筛选">
                 <option value="all">全部 Tab</option>
@@ -178,7 +247,12 @@ export default function AdminTopics({ loaderData }: any) {
                 <option value="dev">dev</option>
                 <option value="test">test</option>
               </NativeSelect>
-              <NativeSelect name="visibility" defaultValue={visibility} size="sm" aria-label="状态筛选">
+              <NativeSelect
+                name="visibility"
+                defaultValue={visibility}
+                size="sm"
+                aria-label="状态筛选"
+              >
                 <option value="all">全部状态</option>
                 <option value="normal">正常</option>
                 <option value="muted">已隐藏</option>
@@ -199,36 +273,73 @@ export default function AdminTopics({ loaderData }: any) {
                 <option value="visit_count_desc">浏览最多</option>
                 <option value="collect_count_desc">收藏最多</option>
               </NativeSelect>
-              <Button type="submit" size="sm">筛选</Button>
+              <Button type="submit" size="sm">
+                筛选
+              </Button>
               <Button render={<Link to="/admin/topics" />} size="sm" variant="ghost">
                 重置
               </Button>
               <div className="grid gap-2 border-t pt-2 lg:col-span-7 lg:grid-cols-[minmax(120px,160px)_minmax(120px,180px)_minmax(120px,180px)_1fr]">
-                <NativeSelect name="date_field" defaultValue={dateField} size="sm" aria-label="日期字段">
+                <NativeSelect
+                  name="date_field"
+                  defaultValue={dateField}
+                  size="sm"
+                  aria-label="日期字段"
+                >
                   <option value="create_at">创建时间</option>
                   <option value="update_at">更新时间</option>
                   <option value="last_reply_at">最后回复</option>
                 </NativeSelect>
                 <Input type="date" name="date_from" defaultValue={dateFrom} aria-label="开始日期" />
                 <Input type="date" name="date_to" defaultValue={dateTo} aria-label="结束日期" />
-                <div className="flex items-center text-xs text-muted-foreground">日期是辅助筛选，默认按创建时间倒序。</div>
+                <div className="flex items-center text-xs text-muted-foreground">
+                  日期是辅助筛选，默认按创建时间倒序。
+                </div>
               </div>
             </Form>
             {selected.length > 0 && (
               <div className="flex flex-wrap items-center gap-2 border-t pt-3 text-sm">
                 <Badge variant="default">已选 {selected.length}</Badge>
-                <Button size="sm" variant="outline" disabled={actionPending} onClick={() => handleAction("top")}>{actionPending ? "处理中" : "切换置顶"}</Button>
+                <Button
+                  size="sm"
+                  variant="outline"
+                  disabled={actionPending}
+                  onClick={() => handleAction("top")}
+                >
+                  {actionPending ? "处理中" : "切换置顶"}
+                </Button>
                 {isAdmin && (
                   <>
-                    <Button size="sm" variant="outline" disabled={actionPending} onClick={() => handleAction("good")}>加精</Button>
-                    <Button size="sm" variant="outline" disabled={actionPending} onClick={(event) => {
-                      muteFinalFocusRef.current = event.currentTarget;
-                      setMuteIds(selected);
-                    }}>隐藏</Button>
-                    <Button size="sm" variant="destructive" onClick={(event) => {
-                      softDeleteFinalFocusRef.current = event.currentTarget;
-                      setSoftDeleteIds(selected);
-                    }} disabled={actionPending}>删除</Button>
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      disabled={actionPending}
+                      onClick={() => handleAction("good")}
+                    >
+                      加精
+                    </Button>
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      disabled={actionPending}
+                      onClick={(event) => {
+                        muteFinalFocusRef.current = event.currentTarget;
+                        setMuteIds(selected);
+                      }}
+                    >
+                      隐藏
+                    </Button>
+                    <Button
+                      size="sm"
+                      variant="destructive"
+                      onClick={(event) => {
+                        softDeleteFinalFocusRef.current = event.currentTarget;
+                        setSoftDeleteIds(selected);
+                      }}
+                      disabled={actionPending}
+                    >
+                      删除
+                    </Button>
                     <Button
                       size="sm"
                       variant="destructive"
@@ -236,97 +347,158 @@ export default function AdminTopics({ loaderData }: any) {
                         permanentDeleteFinalFocusRef.current = event.currentTarget;
                         setPermanentDeleteIds(selected);
                       }}
-                    >永久删除</Button>
+                    >
+                      永久删除
+                    </Button>
                   </>
                 )}
               </div>
             )}
           </AdminToolbar>
           <Table className="min-w-[1040px]">
-          <TableHeader>
-            <TableRow>
-              <TableHead className="w-10">
-                <Checkbox
-                  aria-label="选择全部话题"
-                  checked={selected.length === topics.length && topics.length > 0}
-                  onCheckedChange={(checked) => setSelected(checked ? topics.map((t: any) => t.id) : [])}
-                />
-              </TableHead>
-              <TableHead>话题</TableHead>
-              <TableHead className="w-32">状态</TableHead>
-              <TableHead className="w-40">互动</TableHead>
-              <TableHead className="w-44">时间</TableHead>
-              <TableHead className="w-36 text-right">操作</TableHead>
-            </TableRow>
-          </TableHeader>
-          <TableBody>
-            {topics.map((t: any) => (
-              <TableRow key={t.id} className="align-top">
-                <TableCell>
-                  <Checkbox aria-label={`选择话题 ${t.title}`} checked={selected.includes(t.id)} onCheckedChange={() => toggleSelect(t.id)} />
-                </TableCell>
-                <TableCell className="max-w-2xl">
-                  <div className="flex min-w-0 items-start gap-3">
-                    <TagBadge tab={t.tab} />
-                    <div className="flex min-w-0 flex-col gap-2">
-                      <a href={`/topic/${t.id}`} className="line-clamp-2 font-medium leading-6 text-foreground hover:text-primary hover:underline">
-                        {t.title}
-                      </a>
-                      <div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
-                        <span>#{t.id}</span>
-                        {t.status ? <span>status: {t.status}</span> : null}
-                        {t.deleted > 0 ? <Badge variant="destructive">已删除</Badge> : null}
+            <TableHeader>
+              <TableRow>
+                <TableHead className="w-10">
+                  <Checkbox
+                    aria-label="选择全部话题"
+                    checked={selected.length === topics.length && topics.length > 0}
+                    onCheckedChange={(checked) =>
+                      setSelected(checked ? topics.map((t: any) => t.id) : [])
+                    }
+                  />
+                </TableHead>
+                <TableHead>话题</TableHead>
+                <TableHead className="w-32">状态</TableHead>
+                <TableHead className="w-40">互动</TableHead>
+                <TableHead className="w-44">时间</TableHead>
+                <TableHead className="w-36 text-right">操作</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {topics.map((t: any) => (
+                <TableRow key={t.id} className="align-top">
+                  <TableCell>
+                    <Checkbox
+                      aria-label={`选择话题 ${t.title}`}
+                      checked={selected.includes(t.id)}
+                      onCheckedChange={() => toggleSelect(t.id)}
+                    />
+                  </TableCell>
+                  <TableCell className="max-w-2xl">
+                    <div className="flex min-w-0 items-start gap-3">
+                      <TagBadge tab={t.tab} />
+                      <div className="flex min-w-0 flex-col gap-2">
+                        <a
+                          href={`/topic/${t.id}`}
+                          className="line-clamp-2 font-medium leading-6 text-foreground hover:text-primary hover:underline"
+                        >
+                          {t.title}
+                        </a>
+                        <div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+                          <span>#{t.id}</span>
+                          {t.status ? <span>status: {t.status}</span> : null}
+                          {t.deleted > 0 ? <Badge variant="destructive">已删除</Badge> : null}
+                        </div>
                       </div>
                     </div>
-                  </div>
-                </TableCell>
-                <TableCell>
-                  <div className="flex flex-wrap gap-1.5">
-                    {t.top > 0 && <StatusBadge type="top" />}
-                    {t.good > 0 && <StatusBadge type="good" />}
-                    {t.lock > 0 && <StatusBadge type="lock" />}
-                    {t.archived > 0 && <StatusBadge type="archived" />}
-                    {t.status === "muted" && <StatusBadge type="muted" />}
-                    {t.top <= 0 && t.good <= 0 && t.lock <= 0 && t.archived <= 0 && t.status !== "muted" && t.deleted <= 0 ? <Badge variant="outline">正常</Badge> : null}
-                  </div>
-                </TableCell>
-                <TableCell className="text-sm">
-                  <div className="grid grid-cols-3 gap-2 text-center">
-                    <span><b>{t.reply_count}</b><br /><span className="text-xs text-muted-foreground">回复</span></span>
-                    <span><b>{t.visit_count}</b><br /><span className="text-xs text-muted-foreground">浏览</span></span>
-                    <span><b>{t.collect_count}</b><br /><span className="text-xs text-muted-foreground">收藏</span></span>
-                  </div>
-                </TableCell>
-                <TableCell className="whitespace-nowrap text-xs text-muted-foreground">
-                  <div>创建 <TimeAgo date={t.create_at} /></div>
-                  {t.update_at ? <div>更新 <TimeAgo date={t.update_at} /></div> : null}
-                  {t.last_reply_at ? <div>回复 <TimeAgo date={t.last_reply_at} /></div> : null}
-                </TableCell>
-                <TableCell className="text-right">
-                  <div className="flex justify-end gap-1">
-                    <Button size="sm" variant="ghost" disabled={actionPending} onClick={() => handleAction("top", t.id)}>{actionPending ? "处理中" : "置顶"}</Button>
-                    {isAdmin ? (
+                  </TableCell>
+                  <TableCell>
+                    <div className="flex flex-wrap gap-1.5">
+                      {t.top > 0 && <StatusBadge type="top" />}
+                      {t.good > 0 && <StatusBadge type="good" />}
+                      {t.lock > 0 && <StatusBadge type="lock" />}
+                      {t.archived > 0 && <StatusBadge type="archived" />}
+                      {t.status === "muted" && <StatusBadge type="muted" />}
+                      {t.top <= 0 &&
+                      t.good <= 0 &&
+                      t.lock <= 0 &&
+                      t.archived <= 0 &&
+                      t.status !== "muted" &&
+                      t.deleted <= 0 ? (
+                        <Badge variant="outline">正常</Badge>
+                      ) : null}
+                    </div>
+                  </TableCell>
+                  <TableCell className="text-sm">
+                    <div className="grid grid-cols-3 gap-2 text-center">
+                      <span>
+                        <b>{t.reply_count}</b>
+                        <br />
+                        <span className="text-xs text-muted-foreground">回复</span>
+                      </span>
+                      <span>
+                        <b>{t.visit_count}</b>
+                        <br />
+                        <span className="text-xs text-muted-foreground">浏览</span>
+                      </span>
+                      <span>
+                        <b>{t.collect_count}</b>
+                        <br />
+                        <span className="text-xs text-muted-foreground">收藏</span>
+                      </span>
+                    </div>
+                  </TableCell>
+                  <TableCell className="whitespace-nowrap text-xs text-muted-foreground">
+                    <div>
+                      创建 <TimeAgo date={t.create_at} />
+                    </div>
+                    {t.update_at ? (
+                      <div>
+                        更新 <TimeAgo date={t.update_at} />
+                      </div>
+                    ) : null}
+                    {t.last_reply_at ? (
+                      <div>
+                        回复 <TimeAgo date={t.last_reply_at} />
+                      </div>
+                    ) : null}
+                  </TableCell>
+                  <TableCell className="text-right">
+                    <div className="flex justify-end gap-1">
                       <Button
                         size="sm"
-                        variant="destructive"
-                        onClick={(event) => {
-                          permanentDeleteFinalFocusRef.current = event.currentTarget;
-                          setPermanentDeleteIds([t.id]);
-                        }}
-                      >永久删除</Button>
-                    ) : null}
-                  </div>
-                </TableCell>
-              </TableRow>
-            ))}
-          </TableBody>
+                        variant="ghost"
+                        disabled={actionPending}
+                        onClick={() => handleAction("top", t.id)}
+                      >
+                        {actionPending ? "处理中" : "置顶"}
+                      </Button>
+                      {isAdmin ? (
+                        <Button
+                          size="sm"
+                          variant="destructive"
+                          onClick={(event) => {
+                            permanentDeleteFinalFocusRef.current = event.currentTarget;
+                            setPermanentDeleteIds([t.id]);
+                          }}
+                        >
+                          永久删除
+                        </Button>
+                      ) : null}
+                    </div>
+                  </TableCell>
+                </TableRow>
+              ))}
+            </TableBody>
           </Table>
-          <Pagination page={page} total={total} limit={limit} basePath="/admin/topics" searchParams={paginationParams} />
+          <Pagination
+            page={page}
+            total={total}
+            limit={limit}
+            basePath="/admin/topics"
+            searchParams={paginationParams}
+          />
           <ConfirmationDialog
             open={muteIds.length > 0}
             onOpenChange={(open) => !open && setMuteIds([])}
             title="确认切换话题可见性"
-            description={<>将切换 {muteIds.length} 个话题的隐藏状态，影响其公开列表和详情页可见性。该操作不会删除内容，也没有限时 undo。</>}
+            description={
+              <>
+                将切换 {muteIds.length}{" "}
+                个话题的隐藏状态，影响其公开列表和详情页可见性。该操作不会删除内容，也没有限时
+                undo。
+              </>
+            }
             confirmLabel={`确认切换 ${muteIds.length} 个话题`}
             pending={actionPending}
             finalFocus={muteFinalFocusRef}
@@ -336,7 +508,12 @@ export default function AdminTopics({ loaderData }: any) {
             open={softDeleteIds.length > 0}
             onOpenChange={(open) => !open && setSoftDeleteIds([])}
             title="确认删除话题"
-            description={<>将软删除 {softDeleteIds.length} 个话题，使其从公开列表和详情页隐藏。该操作不同于从数据库永久删除。</>}
+            description={
+              <>
+                将软删除 {softDeleteIds.length}{" "}
+                个话题，使其从公开列表和详情页隐藏。该操作不同于从数据库永久删除。
+              </>
+            }
             confirmLabel={`确认删除 ${softDeleteIds.length} 个话题`}
             pendingLabel="删除中"
             pending={actionPending}
@@ -347,7 +524,12 @@ export default function AdminTopics({ loaderData }: any) {
             open={permanentDeleteIds.length > 0}
             onOpenChange={(open) => !open && setPermanentDeleteIds([])}
             title="确认从数据库永久删除话题"
-            description={<>将永久删除 {permanentDeleteIds.length} 个话题及其回复、收藏、招聘扩展、巡检命中和消息引用。该操作不同于普通删除，无法通过系统自动恢复。</>}
+            description={
+              <>
+                将永久删除 {permanentDeleteIds.length}{" "}
+                个话题及其回复、收藏、招聘扩展、巡检命中和消息引用。该操作不同于普通删除，无法通过系统自动恢复。
+              </>
+            }
             confirmLabel={`确认永久删除 ${permanentDeleteIds.length} 个话题`}
             pendingLabel="永久删除中"
             pending={permanentDeletePending}
diff --git a/apps/web/app/routes/admin/users.tsx b/apps/web/app/routes/admin/users.tsx
index fabd396..71bb112 100644
--- a/apps/web/app/routes/admin/users.tsx
+++ b/apps/web/app/routes/admin/users.tsx
@@ -57,25 +57,50 @@ export async function loader({ request }: any) {
     `/api/v1/admin/users?${params.toString()}`,
     { headers: { cookie } },
   );
-  return { users: res.success ? res.data || [] : [], total: res.total ?? 0, page, limit, q, currentUser };
+  return {
+    users: res.success ? res.data || [] : [],
+    total: res.total ?? 0,
+    page,
+    limit,
+    q,
+    currentUser,
+  };
 }
 
 export default function AdminUsers({ loaderData }: any) {
   const { users, total, page, limit, q, currentUser } = loaderData;
   const [resetTarget, setResetTarget] = useState<{ id: number; loginname: string } | null>(null);
   const [deleteAllTarget, setDeleteAllTarget] = useState<string | null>(null);
-  const [governanceTarget, setGovernanceTarget] = useState<{ name: string; kind: "block" | "mute"; enabled: boolean } | null>(null);
-  const [roleTarget, setRoleTarget] = useState<{ id: number; name: string; role: "moderator" | "recruiter"; enabled: boolean; currentRoles: string[] } | null>(null);
+  const [governanceTarget, setGovernanceTarget] = useState<{
+    name: string;
+    kind: "block" | "mute";
+    enabled: boolean;
+  } | null>(null);
+  const [roleTarget, setRoleTarget] = useState<{
+    id: number;
+    name: string;
+    role: "moderator" | "recruiter";
+    enabled: boolean;
+    currentRoles: string[];
+  } | null>(null);
   const managementTriggerRef = useRef<HTMLElement | null>(null);
   const { revalidate } = useRevalidator();
 
   const { run: runGovernance, pending: governancePending } = useAsyncAction(
     async () => {
       if (!governanceTarget) return { success: false, error_msg: "未选择用户" };
-      const action = governanceTarget.kind === "block"
-        ? governanceTarget.enabled ? "block" : "unblock"
-        : governanceTarget.enabled ? "mute" : "unmute";
-      return apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/user/${governanceTarget.name}/${action}`, { method: "POST" });
+      const action =
+        governanceTarget.kind === "block"
+          ? governanceTarget.enabled
+            ? "block"
+            : "unblock"
+          : governanceTarget.enabled
+            ? "mute"
+            : "unmute";
+      return apiFetch<{ success: boolean; error_msg?: string }>(
+        `/api/v1/user/${governanceTarget.name}/${action}`,
+        { method: "POST" },
+      );
     },
     {
       onSuccess: (res) => {
@@ -92,7 +117,9 @@ export default function AdminUsers({ loaderData }: any) {
     async () => {
       if (!roleTarget) return { success: false, error_msg: "未选择用户" };
       return apiFetch<{ success: boolean; error_msg?: string }>(
-        roleTarget.enabled ? `/api/v1/admin/users/${roleTarget.id}/roles` : `/api/v1/admin/users/${roleTarget.id}/roles/${roleTarget.role}`,
+        roleTarget.enabled
+          ? `/api/v1/admin/users/${roleTarget.id}/roles`
+          : `/api/v1/admin/users/${roleTarget.id}/roles/${roleTarget.role}`,
         {
           method: roleTarget.enabled ? "POST" : "DELETE",
           ...(roleTarget.enabled ? { body: JSON.stringify({ role: roleTarget.role }) } : {}),
@@ -145,12 +172,12 @@ export default function AdminUsers({ loaderData }: any) {
     {
       errorMessage: "重置失败，请重试",
       onSuccess: (res) => {
-      if (res.success && res.newPassword) {
-        toast.success("密码已重置", { description: `新密码: ${res.newPassword}` });
-        setResetTarget(null);
-      } else {
-        toast.error(res.error_msg || "重置失败");
-      }
+        if (res.success && res.newPassword) {
+          toast.success("密码已重置", { description: `新密码: ${res.newPassword}` });
+          setResetTarget(null);
+        } else {
+          toast.error(res.error_msg || "重置失败");
+        }
       },
     },
   );
@@ -158,113 +185,202 @@ export default function AdminUsers({ loaderData }: any) {
   return (
     <AdminLayout>
       <AdminPage archetype="data-list">
-        <AdminPageHeader title="用户管理" description="查看社区用户状态，执行内容屏蔽、禁言、密码重置和清理操作。" />
-        <AdminPanel title="用户列表" description={`当前显示 ${users.length} / ${total} 个用户`} flush>
+        <AdminPageHeader
+          title="用户管理"
+          description="查看社区用户状态，执行内容屏蔽、禁言、密码重置和清理操作。"
+        />
+        <AdminPanel
+          title="用户列表"
+          description={`当前显示 ${users.length} / ${total} 个用户`}
+          flush
+        >
           <AdminToolbar>
             <Form method="get" className="flex w-full gap-2 sm:max-w-md">
               <Input name="q" defaultValue={q} placeholder="搜索用户名/邮箱" className="flex-1" />
-              <Button type="submit" variant="outline">搜索</Button>
+              <Button type="submit" variant="outline">
+                搜索
+              </Button>
             </Form>
           </AdminToolbar>
           <Table className="min-w-[720px]">
-          <TableHeader>
-            <TableRow>
-              <TableHead>用户</TableHead>
-              <TableHead>状态</TableHead>
-              <TableHead>角色</TableHead>
-              <TableHead className="text-right">操作</TableHead>
-            </TableRow>
-          </TableHeader>
-          <TableBody>
-            {users.map((u: any) => {
-              const isSelf = currentUser?.loginname === u.loginname || String(currentUser?.id || "") === String(u.id);
-              return (
-              <TableRow key={u.id}>
-                <TableCell className="max-w-md break-all">
-                  <Link to={`/user/${u.loginname}`} className="font-medium text-primary hover:underline">
-                    {u.loginname}
-                  </Link>
-                  <div className="mt-1 text-xs text-muted-foreground">{u.email}</div>
-                </TableCell>
-                <TableCell>
-                  <div className="flex flex-wrap gap-1">
-                    {u.is_block && <Badge variant="destructive">内容已屏蔽</Badge>}
-                    {u.is_muted && <Badge variant="destructive">禁言</Badge>}
-                    {!u.is_block && !u.is_muted && <Badge variant="secondary">正常</Badge>}
-                  </div>
-                </TableCell>
-                <TableCell>
-                  <div className="flex flex-wrap gap-1">
-                    {(u.roles || []).includes("moderator") && <Badge variant="secondary">版主</Badge>}
-                    {(u.roles || []).includes("recruiter") && <Badge variant="secondary">猎头</Badge>}
-                    {!(u.roles || []).length && <span className="text-xs text-muted-foreground">无</span>}
-                  </div>
-                </TableCell>
-                <TableCell className="w-36 text-right">
-                  <div className="flex items-center justify-end gap-2">
-                    <Button render={<Link to={`/user/${u.loginname}`} />} size="sm" variant="ghost">
-                      查看
-                    </Button>
-                    <DropdownMenu>
-                      <DropdownMenuTrigger
-                        render={<Button
-                          size="sm"
-                          variant="outline"
-                          onClick={(event) => {
-                            managementTriggerRef.current = event.currentTarget;
-                          }}
-                        />}
-                      >
-                        管理
-                      </DropdownMenuTrigger>
-                      <DropdownMenuContent align="end" className="w-52">
-                        <DropdownMenuGroup>
-                          <DropdownMenuLabel>{USER_MANAGEMENT_GROUP_LABELS.governance}</DropdownMenuLabel>
-                          <DropdownMenuItem disabled={isSelf} onClick={() => setGovernanceTarget({ name: u.loginname, kind: "block", enabled: !u.is_block })}>
-                            {userBlockActionLabel(u.is_block)}
-                          </DropdownMenuItem>
-                          <DropdownMenuItem disabled={isSelf} onClick={() => setGovernanceTarget({ name: u.loginname, kind: "mute", enabled: !u.is_muted })}>
-                            {u.is_muted ? "解除禁言" : "禁言"}
-                          </DropdownMenuItem>
-                        </DropdownMenuGroup>
-                        <DropdownMenuSeparator />
-                        <DropdownMenuGroup>
-                          <DropdownMenuLabel>{USER_MANAGEMENT_GROUP_LABELS.roles}</DropdownMenuLabel>
-                          <DropdownMenuItem disabled={isSelf} onClick={() => setRoleTarget({ id: u.id, name: u.loginname, role: "moderator", enabled: !(u.roles || []).includes("moderator"), currentRoles: u.roles || [] })}>
-                            {(u.roles || []).includes("moderator") ? "撤销版主" : "授予版主"}
-                          </DropdownMenuItem>
-                          <DropdownMenuItem disabled={isSelf} onClick={() => setRoleTarget({ id: u.id, name: u.loginname, role: "recruiter", enabled: !(u.roles || []).includes("recruiter"), currentRoles: u.roles || [] })}>
-                            {(u.roles || []).includes("recruiter") ? "撤销猎头" : "授予猎头"}
-                          </DropdownMenuItem>
-                        </DropdownMenuGroup>
-                        <DropdownMenuSeparator />
-                        <DropdownMenuGroup>
-                          <DropdownMenuLabel>{USER_MANAGEMENT_GROUP_LABELS.security}</DropdownMenuLabel>
-                          <DropdownMenuItem onClick={() => setResetTarget({ id: u.id, loginname: u.loginname })}>
-                            重置密码
-                          </DropdownMenuItem>
-                        </DropdownMenuGroup>
-                        <DropdownMenuSeparator />
-                        <DropdownMenuGroup>
-                          <DropdownMenuLabel>{USER_MANAGEMENT_GROUP_LABELS.danger}</DropdownMenuLabel>
-                          <DropdownMenuItem disabled={isSelf} className="text-destructive data-[highlighted]:text-destructive" onClick={() => setDeleteAllTarget(u.loginname)}>
-                            删除所有发言
-                          </DropdownMenuItem>
-                        </DropdownMenuGroup>
-                      </DropdownMenuContent>
-                    </DropdownMenu>
-                  </div>
-                </TableCell>
+            <TableHeader>
+              <TableRow>
+                <TableHead>用户</TableHead>
+                <TableHead>状态</TableHead>
+                <TableHead>角色</TableHead>
+                <TableHead className="text-right">操作</TableHead>
               </TableRow>
-            );})}
-          </TableBody>
+            </TableHeader>
+            <TableBody>
+              {users.map((u: any) => {
+                const isSelf =
+                  currentUser?.loginname === u.loginname ||
+                  String(currentUser?.id || "") === String(u.id);
+                return (
+                  <TableRow key={u.id}>
+                    <TableCell className="max-w-md break-all">
+                      <Link
+                        to={`/user/${u.loginname}`}
+                        className="font-medium text-primary hover:underline"
+                      >
+                        {u.loginname}
+                      </Link>
+                      <div className="mt-1 text-xs text-muted-foreground">{u.email}</div>
+                    </TableCell>
+                    <TableCell>
+                      <div className="flex flex-wrap gap-1">
+                        {u.is_block && <Badge variant="destructive">内容已屏蔽</Badge>}
+                        {u.is_muted && <Badge variant="destructive">禁言</Badge>}
+                        {!u.is_block && !u.is_muted && <Badge variant="secondary">正常</Badge>}
+                      </div>
+                    </TableCell>
+                    <TableCell>
+                      <div className="flex flex-wrap gap-1">
+                        {(u.roles || []).includes("moderator") && (
+                          <Badge variant="secondary">版主</Badge>
+                        )}
+                        {(u.roles || []).includes("recruiter") && (
+                          <Badge variant="secondary">猎头</Badge>
+                        )}
+                        {!(u.roles || []).length && (
+                          <span className="text-xs text-muted-foreground">无</span>
+                        )}
+                      </div>
+                    </TableCell>
+                    <TableCell className="w-36 text-right">
+                      <div className="flex items-center justify-end gap-2">
+                        <Button
+                          render={<Link to={`/user/${u.loginname}`} />}
+                          size="sm"
+                          variant="ghost"
+                        >
+                          查看
+                        </Button>
+                        <DropdownMenu>
+                          <DropdownMenuTrigger
+                            render={
+                              <Button
+                                size="sm"
+                                variant="outline"
+                                onClick={(event) => {
+                                  managementTriggerRef.current = event.currentTarget;
+                                }}
+                              />
+                            }
+                          >
+                            管理
+                          </DropdownMenuTrigger>
+                          <DropdownMenuContent align="end" className="w-52">
+                            <DropdownMenuGroup>
+                              <DropdownMenuLabel>
+                                {USER_MANAGEMENT_GROUP_LABELS.governance}
+                              </DropdownMenuLabel>
+                              <DropdownMenuItem
+                                disabled={isSelf}
+                                onClick={() =>
+                                  setGovernanceTarget({
+                                    name: u.loginname,
+                                    kind: "block",
+                                    enabled: !u.is_block,
+                                  })
+                                }
+                              >
+                                {userBlockActionLabel(u.is_block)}
+                              </DropdownMenuItem>
+                              <DropdownMenuItem
+                                disabled={isSelf}
+                                onClick={() =>
+                                  setGovernanceTarget({
+                                    name: u.loginname,
+                                    kind: "mute",
+                                    enabled: !u.is_muted,
+                                  })
+                                }
+                              >
+                                {u.is_muted ? "解除禁言" : "禁言"}
+                              </DropdownMenuItem>
+                            </DropdownMenuGroup>
+                            <DropdownMenuSeparator />
+                            <DropdownMenuGroup>
+                              <DropdownMenuLabel>
+                                {USER_MANAGEMENT_GROUP_LABELS.roles}
+                              </DropdownMenuLabel>
+                              <DropdownMenuItem
+                                disabled={isSelf}
+                                onClick={() =>
+                                  setRoleTarget({
+                                    id: u.id,
+                                    name: u.loginname,
+                                    role: "moderator",
+                                    enabled: !(u.roles || []).includes("moderator"),
+                                    currentRoles: u.roles || [],
+                                  })
+                                }
+                              >
+                                {(u.roles || []).includes("moderator") ? "撤销版主" : "授予版主"}
+                              </DropdownMenuItem>
+                              <DropdownMenuItem
+                                disabled={isSelf}
+                                onClick={() =>
+                                  setRoleTarget({
+                                    id: u.id,
+                                    name: u.loginname,
+                                    role: "recruiter",
+                                    enabled: !(u.roles || []).includes("recruiter"),
+                                    currentRoles: u.roles || [],
+                                  })
+                                }
+                              >
+                                {(u.roles || []).includes("recruiter") ? "撤销猎头" : "授予猎头"}
+                              </DropdownMenuItem>
+                            </DropdownMenuGroup>
+                            <DropdownMenuSeparator />
+                            <DropdownMenuGroup>
+                              <DropdownMenuLabel>
+                                {USER_MANAGEMENT_GROUP_LABELS.security}
+                              </DropdownMenuLabel>
+                              <DropdownMenuItem
+                                onClick={() => setResetTarget({ id: u.id, loginname: u.loginname })}
+                              >
+                                重置密码
+                              </DropdownMenuItem>
+                            </DropdownMenuGroup>
+                            <DropdownMenuSeparator />
+                            <DropdownMenuGroup>
+                              <DropdownMenuLabel>
+                                {USER_MANAGEMENT_GROUP_LABELS.danger}
+                              </DropdownMenuLabel>
+                              <DropdownMenuItem
+                                disabled={isSelf}
+                                className="text-destructive data-[highlighted]:text-destructive"
+                                onClick={() => setDeleteAllTarget(u.loginname)}
+                              >
+                                删除所有发言
+                              </DropdownMenuItem>
+                            </DropdownMenuGroup>
+                          </DropdownMenuContent>
+                        </DropdownMenu>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                );
+              })}
+            </TableBody>
           </Table>
-          <Pagination page={page} total={total} limit={limit} basePath="/admin/users" searchParams={{ ...(q ? { q } : {}) }} />
+          <Pagination
+            page={page}
+            total={total}
+            limit={limit}
+            basePath="/admin/users"
+            searchParams={{ ...(q ? { q } : {}) }}
+          />
           <ConfirmationDialog
             open={deleteAllTarget !== null}
             onOpenChange={(open) => !open && setDeleteAllTarget(null)}
             title="删除用户所有发言"
-            description={<>将删除 {deleteAllTarget} 的全部话题和回复并写入审计日志；用户账号本身不会删除。</>}
+            description={
+              <>将删除 {deleteAllTarget} 的全部话题和回复并写入审计日志；用户账号本身不会删除。</>
+            }
             confirmLabel="确认删除所有发言"
             pendingLabel="删除中"
             pending={deletingAll}
@@ -277,16 +393,24 @@ export default function AdminUsers({ loaderData }: any) {
       <ConfirmationDialog
         open={governanceTarget !== null}
         onOpenChange={(open) => !open && setGovernanceTarget(null)}
-        title={governanceTarget?.kind === "block"
-          ? governanceTarget.enabled ? "屏蔽用户内容" : "恢复用户内容可见"
-          : governanceTarget?.enabled ? "禁言用户" : "解除用户禁言"}
-        description={governanceTarget?.kind === "block"
-          ? governanceTarget.enabled
-            ? `将隐藏 ${governanceTarget.name} 的公开内容；这不等同于禁言，不会单独阻止其发布新内容。`
-            : `将恢复 ${governanceTarget.name} 的内容可见性；不会解除禁言或恢复已删除内容。`
-          : governanceTarget?.enabled
-            ? `将禁止 ${governanceTarget.name} 新增话题和回复；已有内容不会因此自动隐藏。`
-            : `将恢复 ${governanceTarget?.name} 新增话题和回复的能力；不会取消内容屏蔽。`}
+        title={
+          governanceTarget?.kind === "block"
+            ? governanceTarget.enabled
+              ? "屏蔽用户内容"
+              : "恢复用户内容可见"
+            : governanceTarget?.enabled
+              ? "禁言用户"
+              : "解除用户禁言"
+        }
+        description={
+          governanceTarget?.kind === "block"
+            ? governanceTarget.enabled
+              ? `将隐藏 ${governanceTarget.name} 的公开内容；这不等同于禁言，不会单独阻止其发布新内容。`
+              : `将恢复 ${governanceTarget.name} 的内容可见性；不会解除禁言或恢复已删除内容。`
+            : governanceTarget?.enabled
+              ? `将禁止 ${governanceTarget.name} 新增话题和回复；已有内容不会因此自动隐藏。`
+              : `将恢复 ${governanceTarget?.name} 新增话题和回复的能力；不会取消内容屏蔽。`
+        }
         confirmLabel="确认变更用户状态"
         pending={governancePending}
         destructive={!!governanceTarget?.enabled}
@@ -297,7 +421,11 @@ export default function AdminUsers({ loaderData }: any) {
         open={roleTarget !== null}
         onOpenChange={(open) => !open && setRoleTarget(null)}
         title={roleTarget?.enabled ? "授予用户角色" : "撤销用户角色"}
-        description={roleTarget ? `${roleTarget.name} 当前角色：${roleTarget.currentRoles.join("、") || "无"}。变更后${roleTarget.enabled ? "将拥有" : "将失去"}${roleTarget.role === "moderator" ? "版主内容治理" : "招聘发布"}权限。` : ""}
+        description={
+          roleTarget
+            ? `${roleTarget.name} 当前角色：${roleTarget.currentRoles.join("、") || "无"}。变更后${roleTarget.enabled ? "将拥有" : "将失去"}${roleTarget.role === "moderator" ? "版主内容治理" : "招聘发布"}权限。`
+            : ""
+        }
         confirmLabel={roleTarget?.enabled ? "确认授予角色" : "确认撤销角色"}
         pending={rolePending}
         destructive={!roleTarget?.enabled}
@@ -308,7 +436,12 @@ export default function AdminUsers({ loaderData }: any) {
         open={resetTarget !== null}
         onOpenChange={(open) => !open && setResetTarget(null)}
         title="重置用户密码"
-        description={<>将重置用户 {resetTarget?.loginname} 的登录凭证；现有密码将立即失效，新凭证仅在成功后显示。</>}
+        description={
+          <>
+            将重置用户 {resetTarget?.loginname}{" "}
+            的登录凭证；现有密码将立即失效，新凭证仅在成功后显示。
+          </>
+        }
         confirmLabel="确认重置密码"
         pendingLabel="重置中"
         pending={resetting}
diff --git a/apps/web/app/routes/admin/zones.tsx b/apps/web/app/routes/admin/zones.tsx
index 46f9cb4..b0d26fe 100644
--- a/apps/web/app/routes/admin/zones.tsx
+++ b/apps/web/app/routes/admin/zones.tsx
@@ -51,9 +51,7 @@ export default function AdminZones({ loaderData }: { loaderData: any }) {
   }, [initialZones]);
 
   function updateField(id: number, field: keyof ZoneRow, value: any) {
-    setZones((prev) =>
-      prev.map((z) => (z.id === id ? { ...z, [field]: value } : z)),
-    );
+    setZones((prev) => prev.map((z) => (z.id === id ? { ...z, [field]: value } : z)));
   }
 
   async function saveZone(id: number) {
@@ -90,81 +88,81 @@ export default function AdminZones({ loaderData }: { loaderData: any }) {
       <AdminPage archetype="data-list">
         <AdminPageHeader title="专区管理" description="控制专区在导航栏的可见性与排序。" />
         <AdminPanel title="专区列表" description={`共 ${zones.length} 个专区`} flush>
-            <Table className="min-w-[820px]">
-              <TableHeader>
-                <TableRow>
-                  <TableHead className="w-24">Slug</TableHead>
-                  <TableHead className="min-w-32">名称</TableHead>
-                  <TableHead className="min-w-40">描述</TableHead>
-                  <TableHead className="w-32">图标</TableHead>
-                  <TableHead className="w-28">可见状态</TableHead>
-                  <TableHead className="w-20">排序</TableHead>
-                  <TableHead className="w-24 text-right">操作</TableHead>
+          <Table className="min-w-[820px]">
+            <TableHeader>
+              <TableRow>
+                <TableHead className="w-24">Slug</TableHead>
+                <TableHead className="min-w-32">名称</TableHead>
+                <TableHead className="min-w-40">描述</TableHead>
+                <TableHead className="w-32">图标</TableHead>
+                <TableHead className="w-28">可见状态</TableHead>
+                <TableHead className="w-20">排序</TableHead>
+                <TableHead className="w-24 text-right">操作</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {zones.map((zone) => (
+                <TableRow key={zone.id}>
+                  <TableCell className="font-mono text-xs">{zone.slug}</TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${zone.slug} 名称`}
+                      value={zone.name}
+                      onChange={(e) => updateField(zone.id, "name", e.target.value)}
+                    />
+                  </TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${zone.slug} 描述`}
+                      value={zone.description || ""}
+                      onChange={(e) => updateField(zone.id, "description", e.target.value)}
+                    />
+                  </TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${zone.slug} 图标`}
+                      value={zone.icon || ""}
+                      onChange={(e) => updateField(zone.id, "icon", e.target.value)}
+                      placeholder="lucide icon"
+                    />
+                  </TableCell>
+                  <TableCell>
+                    <Button
+                      type="button"
+                      size="sm"
+                      variant={zone.visible ? "secondary" : "ghost"}
+                      aria-pressed={zone.visible}
+                      aria-label={`${zone.slug} 当前${zone.visible ? "可见" : "隐藏"}，点击切换`}
+                      className="min-w-20 justify-start"
+                      onClick={() => updateField(zone.id, "visible", !zone.visible)}
+                    >
+                      {zone.visible ? <Eye /> : <EyeOff />}
+                      {zone.visible ? "显示" : "隐藏"}
+                    </Button>
+                  </TableCell>
+                  <TableCell>
+                    <Input
+                      aria-label={`${zone.slug} 排序`}
+                      type="number"
+                      value={zone.sort_order}
+                      onChange={(e) => updateField(zone.id, "sort_order", Number(e.target.value))}
+                      className="w-20"
+                    />
+                  </TableCell>
+                  <TableCell className="text-right">
+                    <Button
+                      size="sm"
+                      variant="outline"
+                      onClick={() => saveZone(zone.id)}
+                      disabled={saving === zone.id}
+                    >
+                      {saving === zone.id ? "保存中…" : "保存"}
+                    </Button>
+                  </TableCell>
                 </TableRow>
-              </TableHeader>
-              <TableBody>
-                {zones.map((zone) => (
-                  <TableRow key={zone.id}>
-                    <TableCell className="font-mono text-xs">{zone.slug}</TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${zone.slug} 名称`}
-                        value={zone.name}
-                        onChange={(e) => updateField(zone.id, "name", e.target.value)}
-                      />
-                    </TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${zone.slug} 描述`}
-                        value={zone.description || ""}
-                        onChange={(e) => updateField(zone.id, "description", e.target.value)}
-                      />
-                    </TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${zone.slug} 图标`}
-                        value={zone.icon || ""}
-                        onChange={(e) => updateField(zone.id, "icon", e.target.value)}
-                        placeholder="lucide icon"
-                      />
-                    </TableCell>
-                    <TableCell>
-                      <Button
-                        type="button"
-                        size="sm"
-                        variant={zone.visible ? "secondary" : "ghost"}
-                        aria-pressed={zone.visible}
-                        aria-label={`${zone.slug} 当前${zone.visible ? "可见" : "隐藏"}，点击切换`}
-                        className="min-w-20 justify-start"
-                        onClick={() => updateField(zone.id, "visible", !zone.visible)}
-                      >
-                        {zone.visible ? <Eye /> : <EyeOff />}
-                        {zone.visible ? "显示" : "隐藏"}
-                      </Button>
-                    </TableCell>
-                    <TableCell>
-                      <Input
-                        aria-label={`${zone.slug} 排序`}
-                        type="number"
-                        value={zone.sort_order}
-                        onChange={(e) => updateField(zone.id, "sort_order", Number(e.target.value))}
-                        className="w-20"
-                      />
-                    </TableCell>
-                    <TableCell className="text-right">
-                      <Button
-                        size="sm"
-                        variant="outline"
-                        onClick={() => saveZone(zone.id)}
-                        disabled={saving === zone.id}
-                      >
-                        {saving === zone.id ? "保存中…" : "保存"}
-                      </Button>
-                    </TableCell>
-                  </TableRow>
-                ))}
-              </TableBody>
-            </Table>
+              ))}
+            </TableBody>
+          </Table>
         </AdminPanel>
       </AdminPage>
     </AdminLayout>
diff --git a/apps/web/app/routes/api.tsx b/apps/web/app/routes/api.tsx
index e6749ac..97f7028 100644
--- a/apps/web/app/routes/api.tsx
+++ b/apps/web/app/routes/api.tsx
@@ -12,12 +12,17 @@ export default function ApiDocs() {
   return (
     <Layout>
       <DirectoryPage>
-        <PageHeader variant="marketing" eyebrow="API" title="CNode API 文档" description="基于 Hono、Zod OpenAPI 与 Swagger UI 自动生成。" />
+        <PageHeader
+          variant="marketing"
+          eyebrow="API"
+          title="CNode API 文档"
+          description="基于 Hono、Zod OpenAPI 与 Swagger UI 自动生成。"
+        />
         <Card>
           <CardContent>
-          <div className="overflow-x-auto">
-          <SwaggerUI url="/openapi.json" docExpansion="none" defaultModelsExpandDepth={1} />
-          </div>
+            <div className="overflow-x-auto">
+              <SwaggerUI url="/openapi.json" docExpansion="none" defaultModelsExpandDepth={1} />
+            </div>
           </CardContent>
         </Card>
       </DirectoryPage>
diff --git a/apps/web/app/routes/auth.github.new.tsx b/apps/web/app/routes/auth.github.new.tsx
index 088b8d5..20fb530 100644
--- a/apps/web/app/routes/auth.github.new.tsx
+++ b/apps/web/app/routes/auth.github.new.tsx
@@ -21,9 +21,12 @@ export function meta() {
 
 export async function loader({ request }: Route.LoaderArgs) {
   const cookie = request.headers.get("cookie") || "";
-  const res = await apiFetch<{ success: boolean; data?: any; error_msg?: string }>("/api/v1/auth/github/pending", {
-    headers: { cookie },
-  });
+  const res = await apiFetch<{ success: boolean; data?: any; error_msg?: string }>(
+    "/api/v1/auth/github/pending",
+    {
+      headers: { cookie },
+    },
+  );
   return { profile: res.success ? res.data : null, error: res.error_msg };
 }
 
@@ -56,70 +59,100 @@ export default function GithubNew({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell eyebrow="GITHUB" title="完成 GitHub 登录" description="选择创建新账号，或把 GitHub 绑定到已有 CNode 账号。">
-        <h2 className="mb-6 text-lg font-semibold tracking-tight">选择账号处理方式</h2>
-        <div className="flex flex-col gap-5">
-          {!profile ? (
-            <div className="flex flex-col gap-4 text-sm text-muted-foreground">
-              <Alert variant="destructive"><AlertDescription>{error || "GitHub 登录状态已过期，请重新授权。"}</AlertDescription></Alert>
-              <Button render={<a href="/auth/github" />} className="w-full">
-                重新授权
-              </Button>
-            </div>
-          ) : (
-            <>
-              <Item variant="muted">
-                <ItemMedia><Avatar>
-                  <AvatarImage src={getAvatarUrl(profile.avatar_url, 40)} alt={profile.loginname} />
-                  <AvatarFallback>{getAvatarFallback(profile.loginname)}</AvatarFallback>
-                </Avatar></ItemMedia>
-                <ItemContent>
-                  <ItemTitle>{profile.loginname}</ItemTitle>
-                  <div className="truncate text-muted-foreground">{profile.email}</div>
-                </ItemContent>
-              </Item>
-
-              <div className="grid gap-3 sm:grid-cols-2">
-                <button
-                  type="button"
-                  onClick={() => setMode("new")}
-                  aria-pressed={mode === "new"}
-                  className={`rounded-lg border p-4 text-left text-sm outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50 ${mode === "new" ? "bg-accent text-accent-foreground" : "bg-muted hover:bg-accent"}`}
-                >
-                  <div className="font-medium">注册新账号</div>
-                  <div className="mt-1 text-muted-foreground">使用 GitHub 用户名创建新的 CNode 账号。</div>
-                </button>
-                <button
-                  type="button"
-                  onClick={() => setMode("bind")}
-                  aria-pressed={mode === "bind"}
-                  className={`rounded-lg border p-4 text-left text-sm outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50 ${mode === "bind" ? "bg-accent text-accent-foreground" : "bg-muted hover:bg-accent"}`}
-                >
-                  <div className="font-medium">关联老账号</div>
-                  <div className="mt-1 text-muted-foreground">输入已有 CNode 账号密码完成绑定。</div>
-                </button>
+        <AuthShell
+          eyebrow="GITHUB"
+          title="完成 GitHub 登录"
+          description="选择创建新账号，或把 GitHub 绑定到已有 CNode 账号。"
+        >
+          <h2 className="mb-6 text-lg font-semibold tracking-tight">选择账号处理方式</h2>
+          <div className="flex flex-col gap-5">
+            {!profile ? (
+              <div className="flex flex-col gap-4 text-sm text-muted-foreground">
+                <Alert variant="destructive">
+                  <AlertDescription>
+                    {error || "GitHub 登录状态已过期，请重新授权。"}
+                  </AlertDescription>
+                </Alert>
+                <Button render={<a href="/auth/github" />} className="w-full">
+                  重新授权
+                </Button>
               </div>
+            ) : (
+              <>
+                <Item variant="muted">
+                  <ItemMedia>
+                    <Avatar>
+                      <AvatarImage
+                        src={getAvatarUrl(profile.avatar_url, 40)}
+                        alt={profile.loginname}
+                      />
+                      <AvatarFallback>{getAvatarFallback(profile.loginname)}</AvatarFallback>
+                    </Avatar>
+                  </ItemMedia>
+                  <ItemContent>
+                    <ItemTitle>{profile.loginname}</ItemTitle>
+                    <div className="truncate text-muted-foreground">{profile.email}</div>
+                  </ItemContent>
+                </Item>
 
-              {mode === "bind" && (
-                <FieldGroup>
-                  <Field>
-                    <FieldLabel htmlFor="github-bind-name">用户名</FieldLabel>
-                    <Input id="github-bind-name" value={name} onChange={(event) => setName(event.target.value)} />
-                  </Field>
-                  <Field>
-                    <FieldLabel htmlFor="github-bind-pass">密码</FieldLabel>
-                    <Input id="github-bind-pass" type="password" value={pass} onChange={(event) => setPass(event.target.value)} />
-                  </Field>
-                </FieldGroup>
-              )}
+                <div className="grid gap-3 sm:grid-cols-2">
+                  <button
+                    type="button"
+                    onClick={() => setMode("new")}
+                    aria-pressed={mode === "new"}
+                    className={`rounded-lg border p-4 text-left text-sm outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50 ${mode === "new" ? "bg-accent text-accent-foreground" : "bg-muted hover:bg-accent"}`}
+                  >
+                    <div className="font-medium">注册新账号</div>
+                    <div className="mt-1 text-muted-foreground">
+                      使用 GitHub 用户名创建新的 CNode 账号。
+                    </div>
+                  </button>
+                  <button
+                    type="button"
+                    onClick={() => setMode("bind")}
+                    aria-pressed={mode === "bind"}
+                    className={`rounded-lg border p-4 text-left text-sm outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50 ${mode === "bind" ? "bg-accent text-accent-foreground" : "bg-muted hover:bg-accent"}`}
+                  >
+                    <div className="font-medium">关联老账号</div>
+                    <div className="mt-1 text-muted-foreground">
+                      输入已有 CNode 账号密码完成绑定。
+                    </div>
+                  </button>
+                </div>
 
-              <Button className="w-full" disabled={loading || (mode === "bind" && (!name || !pass))} onClick={submit}>
-                {loading ? "处理中..." : mode === "new" ? "注册并登录" : "关联并登录"}
-              </Button>
-            </>
-          )}
-        </div>
-      </AuthShell>
+                {mode === "bind" && (
+                  <FieldGroup>
+                    <Field>
+                      <FieldLabel htmlFor="github-bind-name">用户名</FieldLabel>
+                      <Input
+                        id="github-bind-name"
+                        value={name}
+                        onChange={(event) => setName(event.target.value)}
+                      />
+                    </Field>
+                    <Field>
+                      <FieldLabel htmlFor="github-bind-pass">密码</FieldLabel>
+                      <Input
+                        id="github-bind-pass"
+                        type="password"
+                        value={pass}
+                        onChange={(event) => setPass(event.target.value)}
+                      />
+                    </Field>
+                  </FieldGroup>
+                )}
+
+                <Button
+                  className="w-full"
+                  disabled={loading || (mode === "bind" && (!name || !pass))}
+                  onClick={submit}
+                >
+                  {loading ? "处理中..." : mode === "new" ? "注册并登录" : "关联并登录"}
+                </Button>
+              </>
+            )}
+          </div>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/auth.github.no-email.tsx b/apps/web/app/routes/auth.github.no-email.tsx
index 10a1583..36696c2 100644
--- a/apps/web/app/routes/auth.github.no-email.tsx
+++ b/apps/web/app/routes/auth.github.no-email.tsx
@@ -12,15 +12,21 @@ export default function GithubNoEmail() {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell eyebrow="GITHUB EMAIL" title="GitHub 邮箱不可用" description="CNode 需要一个可用邮箱来创建或关联社区账号。">
-        <h2 className="mb-6 text-lg font-semibold tracking-tight">无法继续 GitHub 登录</h2>
-        <div className="flex flex-col gap-4 text-sm text-muted-foreground">
-          <p>请到 GitHub 设置中公开邮箱，或确认主邮箱可通过 GitHub emails API 读取，然后重新登录。</p>
-          <Button render={<Link to="/signin" />} className="w-full">
-            返回登录
-          </Button>
-        </div>
-      </AuthShell>
+        <AuthShell
+          eyebrow="GITHUB EMAIL"
+          title="GitHub 邮箱不可用"
+          description="CNode 需要一个可用邮箱来创建或关联社区账号。"
+        >
+          <h2 className="mb-6 text-lg font-semibold tracking-tight">无法继续 GitHub 登录</h2>
+          <div className="flex flex-col gap-4 text-sm text-muted-foreground">
+            <p>
+              请到 GitHub 设置中公开邮箱，或确认主邮箱可通过 GitHub emails API 读取，然后重新登录。
+            </p>
+            <Button render={<Link to="/signin" />} className="w-full">
+              返回登录
+            </Button>
+          </div>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/auth.github.tsx b/apps/web/app/routes/auth.github.tsx
index 1e7a5c4..8be5f1c 100644
--- a/apps/web/app/routes/auth.github.tsx
+++ b/apps/web/app/routes/auth.github.tsx
@@ -30,7 +30,9 @@ export async function loader({ request }: { request: Request }) {
     "SameSite=Lax",
     "Max-Age=600",
     domain ? `Domain=${domain}` : "",
-  ].filter(Boolean).join("; ");
+  ]
+    .filter(Boolean)
+    .join("; ");
 
   return redirect(redirectUrl, { headers: { "Set-Cookie": cookie } });
 }
diff --git a/apps/web/app/routes/my.messages.tsx b/apps/web/app/routes/my.messages.tsx
index f710a5b..cc1b0e4 100644
--- a/apps/web/app/routes/my.messages.tsx
+++ b/apps/web/app/routes/my.messages.tsx
@@ -17,7 +17,14 @@ import { Button } from "~/components/ui/button";
 import { Card, CardAction, CardContent, CardHeader, CardTitle } from "~/components/ui/card";
 import { EmptyState } from "~/components/EmptyState";
 import { useAsyncAction } from "~/hooks/use-async-action";
-import { Item, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "~/components/ui/item";
+import {
+  Item,
+  ItemContent,
+  ItemDescription,
+  ItemGroup,
+  ItemMedia,
+  ItemTitle,
+} from "~/components/ui/item";
 
 export function meta() {
   return [{ title: "消息 · CNode" }];
@@ -75,12 +82,18 @@ export default function Messages({ loaderData }: Route.ComponentProps) {
 
   const { run: markAllRead, pending: markingAll } = useAsyncAction(
     async () => {
-      return apiFetch<{ success: boolean }>("/api/v1/message/mark_all", { method: "POST", body: JSON.stringify({}) });
+      return apiFetch<{ success: boolean }>("/api/v1/message/mark_all", {
+        method: "POST",
+        body: JSON.stringify({}),
+      });
     },
     {
       onSuccess: (res) => {
         if (!res.success) return;
-        setReadMsgs((items) => [...unreadMsgs.map((msg) => ({ ...msg, has_read: true })), ...items]);
+        setReadMsgs((items) => [
+          ...unreadMsgs.map((msg) => ({ ...msg, has_read: true })),
+          ...items,
+        ]);
         setUnreadMsgs([]);
         setUnreadCount(0);
         toast.success("已全部标记已读");
@@ -93,19 +106,41 @@ export default function Messages({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <DirectoryPage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "消息中心" }]} title="消息中心" description="查看回复、定向回复和 @ 提及通知。" action={
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "消息中心" }]}
+          title="消息中心"
+          description="查看回复、定向回复和 @ 提及通知。"
+          action={
             <div className="flex items-center gap-2">
               <Badge variant={unreadMsgs.length > 0 ? "default" : "secondary"}>
                 {unreadMsgs.length} 条新消息
               </Badge>
-              <Button size="sm" variant="secondary" onClick={() => markAllRead()} disabled={unreadMsgs.length === 0 || markingAll}>
+              <Button
+                size="sm"
+                variant="secondary"
+                onClick={() => markAllRead()}
+                disabled={unreadMsgs.length === 0 || markingAll}
+              >
                 <CheckCheck data-icon="inline-start" /> {markingAll ? "处理中" : "全部已读"}
               </Button>
             </div>
-        } />
+          }
+        />
 
-        <MessageGroup title="新消息" icon={<Bell />} messages={unreadMsgs} onMarkRead={markOneRead} pending={markingOne} />
-        <MessageGroup title="过往消息" icon={<Inbox />} messages={readMsgs} onMarkRead={markOneRead} pending={markingOne} />
+        <MessageGroup
+          title="新消息"
+          icon={<Bell />}
+          messages={unreadMsgs}
+          onMarkRead={markOneRead}
+          pending={markingOne}
+        />
+        <MessageGroup
+          title="过往消息"
+          icon={<Inbox />}
+          messages={readMsgs}
+          onMarkRead={markOneRead}
+          pending={markingOne}
+        />
       </DirectoryPage>
     </Layout>
   );
@@ -132,7 +167,9 @@ function MessageGroup({
           {title}
           <span className="text-sm font-normal text-muted-foreground">({messages.length})</span>
         </CardTitle>
-        <CardAction><Badge variant="secondary">{messages.length}</Badge></CardAction>
+        <CardAction>
+          <Badge variant="secondary">{messages.length}</Badge>
+        </CardAction>
       </CardHeader>
       <CardContent>
         {messages.length > 0 ? (
@@ -149,24 +186,38 @@ function MessageGroup({
   );
 }
 
-function MessageItem({ msg, onMarkRead, pending }: { msg: any; onMarkRead: (id: string) => void; pending: boolean }) {
+function MessageItem({
+  msg,
+  onMarkRead,
+  pending,
+}: {
+  msg: any;
+  onMarkRead: (id: string) => void;
+  pending: boolean;
+}) {
   const typeText =
     msg.type === "reply"
       ? "回复了你的话题"
       : msg.type === "reply2"
         ? "在话题中回复了你"
         : "在话题中 @ 了你";
-  const topicHref = msg.topic ? `/topic/${msg.topic.id}${msg.reply?.id ? `#${msg.reply.id}` : ""}` : "#";
+  const topicHref = msg.topic
+    ? `/topic/${msg.topic.id}${msg.reply?.id ? `#${msg.reply.id}` : ""}`
+    : "#";
   const summary = messageContentSummary(msg.reply?.content);
 
   return (
     <Item>
       <ItemMedia>
         <Link to={`/user/${msg.author?.loginname}`}>
-        <Avatar>
-          <AvatarImage src={getAvatarUrl(msg.author?.avatar_url, 40)} alt={msg.author?.loginname || "CNode"} />
-          <AvatarFallback>{getAvatarFallback(msg.author?.loginname)}</AvatarFallback>
-        </Avatar></Link>
+          <Avatar>
+            <AvatarImage
+              src={getAvatarUrl(msg.author?.avatar_url, 40)}
+              alt={msg.author?.loginname || "CNode"}
+            />
+            <AvatarFallback>{getAvatarFallback(msg.author?.loginname)}</AvatarFallback>
+          </Avatar>
+        </Link>
       </ItemMedia>
       <ItemContent>
         <ItemTitle>
@@ -181,11 +232,7 @@ function MessageItem({ msg, onMarkRead, pending }: { msg: any; onMarkRead: (id:
             {msg.topic.title}
           </Link>
         )}
-        {summary && (
-          <ItemDescription>
-            {summary}
-          </ItemDescription>
-        )}
+        {summary && <ItemDescription>{summary}</ItemDescription>}
         <div className="flex flex-wrap items-center gap-3 text-xs text-muted-foreground">
           <TimeAgo date={msg.create_at} />
           {!msg.has_read && (
diff --git a/apps/web/app/routes/reply.$id.edit.tsx b/apps/web/app/routes/reply.$id.edit.tsx
index 66a81da..317b9b2 100644
--- a/apps/web/app/routes/reply.$id.edit.tsx
+++ b/apps/web/app/routes/reply.$id.edit.tsx
@@ -36,13 +36,10 @@ export default function ReplyEdit({ loaderData }: Route.ComponentProps) {
 
   const { run: submitReply, pending: saving } = useAsyncAction(
     async () => {
-      return apiFetch<{ success: boolean; error_msg?: string }>(
-        `/api/v1/reply/${reply?.id}/edit`,
-        {
-          method: "POST",
-          body: JSON.stringify({ content }),
-        },
-      );
+      return apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/reply/${reply?.id}/edit`, {
+        method: "POST",
+        body: JSON.stringify({ content }),
+      });
     },
     {
       onSuccess: (res) => {
@@ -67,7 +64,12 @@ export default function ReplyEdit({ loaderData }: Route.ComponentProps) {
   if (!reply) {
     return (
       <Layout>
-        <Empty><EmptyHeader><EmptyTitle>回复不存在</EmptyTitle><EmptyDescription>该回复可能已被删除。</EmptyDescription></EmptyHeader></Empty>
+        <Empty>
+          <EmptyHeader>
+            <EmptyTitle>回复不存在</EmptyTitle>
+            <EmptyDescription>该回复可能已被删除。</EmptyDescription>
+          </EmptyHeader>
+        </Empty>
       </Layout>
     );
   }
@@ -75,28 +77,36 @@ export default function ReplyEdit({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <ComposePage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "编辑回复" }]} title="编辑回复" description="调整回复内容，保持讨论上下文清晰。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "编辑回复" }]}
+          title="编辑回复"
+          description="调整回复内容，保持讨论上下文清晰。"
+        />
         <Card>
           <CardHeader>
             <CardTitle>回复内容</CardTitle>
           </CardHeader>
           <CardContent>
-        <form onSubmit={handleSubmit}>
-          <FieldGroup>
-          <Field>
-          <FieldLabel>回复内容</FieldLabel>
-          <MarkdownEditor value={content} onChange={setContent} placeholder="支持 Markdown 格式" />
-          </Field>
-          <div className="flex justify-end gap-2">
-            <Button type="button" variant="outline" onClick={() => navigate(-1)}>
-              取消
-            </Button>
-            <Button type="submit" disabled={saving}>
-              {saving ? "保存中..." : "保存"}
-            </Button>
-          </div>
-          </FieldGroup>
-        </form>
+            <form onSubmit={handleSubmit}>
+              <FieldGroup>
+                <Field>
+                  <FieldLabel>回复内容</FieldLabel>
+                  <MarkdownEditor
+                    value={content}
+                    onChange={setContent}
+                    placeholder="支持 Markdown 格式"
+                  />
+                </Field>
+                <div className="flex justify-end gap-2">
+                  <Button type="button" variant="outline" onClick={() => navigate(-1)}>
+                    取消
+                  </Button>
+                  <Button type="submit" disabled={saving}>
+                    {saving ? "保存中..." : "保存"}
+                  </Button>
+                </div>
+              </FieldGroup>
+            </form>
           </CardContent>
         </Card>
       </ComposePage>
diff --git a/apps/web/app/routes/reset_pass.tsx b/apps/web/app/routes/reset_pass.tsx
index 1c74ffa..127fe6d 100644
--- a/apps/web/app/routes/reset_pass.tsx
+++ b/apps/web/app/routes/reset_pass.tsx
@@ -61,40 +61,48 @@ export default function ResetPass() {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell
-        eyebrow="RESET PASSWORD"
-        title="重新设置你的访问凭证"
-        description="使用邮件中的安全链接设置新密码，完成后即可继续参与社区讨论。"
-      >
+        <AuthShell
+          eyebrow="RESET PASSWORD"
+          title="重新设置你的访问凭证"
+          description="使用邮件中的安全链接设置新密码，完成后即可继续参与社区讨论。"
+        >
           <h2 className="mb-6 text-lg font-semibold tracking-tight">重置密码</h2>
           <div>
-            {success && <Alert><AlertDescription role="status">{success}</AlertDescription></Alert>}
+            {success && (
+              <Alert>
+                <AlertDescription role="status">{success}</AlertDescription>
+              </Alert>
+            )}
             <form onSubmit={handleSubmit} aria-busy={loading}>
               <FieldGroup>
-              <Field data-invalid={newPass.length > 0 && !passValid || !!error}>
-                <FieldLabel htmlFor="new-password">新密码</FieldLabel>
-                <Input
-                  id="new-password"
-                  name="new-password"
-                  type="password"
-                  autoComplete="new-password"
-                  spellCheck={false}
-                  value={newPass}
-                  onChange={(e) => setNewPass(e.target.value)}
-                  aria-invalid={newPass.length > 0 && !passValid || !!error}
-                  aria-describedby="new-password-help new-password-error"
-                  placeholder="至少8位,含字母和数字"
-                  required
-                />
-                <FieldDescription id="new-password-help">
-                  密码需至少 8 位,包含字母和数字
-                </FieldDescription>
-                <FieldError id="new-password-error">{error}</FieldError>
-              </Field>
-              <Button type="submit" disabled={loading} className="w-full">
-                {loading ? "提交中..." : "重置密码"}
-              </Button>
-              {loading && <p role="status" className="text-center text-sm text-muted-foreground">正在重置密码</p>}
+                <Field data-invalid={(newPass.length > 0 && !passValid) || !!error}>
+                  <FieldLabel htmlFor="new-password">新密码</FieldLabel>
+                  <Input
+                    id="new-password"
+                    name="new-password"
+                    type="password"
+                    autoComplete="new-password"
+                    spellCheck={false}
+                    value={newPass}
+                    onChange={(e) => setNewPass(e.target.value)}
+                    aria-invalid={(newPass.length > 0 && !passValid) || !!error}
+                    aria-describedby="new-password-help new-password-error"
+                    placeholder="至少8位,含字母和数字"
+                    required
+                  />
+                  <FieldDescription id="new-password-help">
+                    密码需至少 8 位,包含字母和数字
+                  </FieldDescription>
+                  <FieldError id="new-password-error">{error}</FieldError>
+                </Field>
+                <Button type="submit" disabled={loading} className="w-full">
+                  {loading ? "提交中..." : "重置密码"}
+                </Button>
+                {loading && (
+                  <p role="status" className="text-center text-sm text-muted-foreground">
+                    正在重置密码
+                  </p>
+                )}
               </FieldGroup>
             </form>
             <div className="mt-4 text-sm text-muted-foreground">
@@ -103,7 +111,7 @@ export default function ResetPass() {
               </Link>
             </div>
           </div>
-      </AuthShell>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/rss.tsx b/apps/web/app/routes/rss.tsx
index 0f30d24..37d272b 100644
--- a/apps/web/app/routes/rss.tsx
+++ b/apps/web/app/routes/rss.tsx
@@ -29,7 +29,13 @@ export function cleanXml(value: string) {
   let result = "";
   for (const char of value) {
     const codePoint = char.codePointAt(0) || 0;
-    if (codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d || (codePoint >= 0x20 && codePoint <= 0xd7ff) || (codePoint >= 0xe000 && codePoint <= 0xfffd)) {
+    if (
+      codePoint === 0x09 ||
+      codePoint === 0x0a ||
+      codePoint === 0x0d ||
+      (codePoint >= 0x20 && codePoint <= 0xd7ff) ||
+      (codePoint >= 0xe000 && codePoint <= 0xfffd)
+    ) {
       result += char;
     }
   }
@@ -80,7 +86,9 @@ ${items ? `${items}\n` : ""}  </channel>
 }
 
 export async function loader() {
-  const res = await apiFetch<{ success: boolean; data?: RssSource }>("/api/v1/rss-source").catch(() => null);
+  const res = await apiFetch<{ success: boolean; data?: RssSource }>("/api/v1/rss-source").catch(
+    () => null,
+  );
   const source = res?.success && res.data ? res.data : fallbackSource;
   return new Response(buildRssXml(source), {
     headers: { "Content-Type": "application/rss+xml; charset=utf-8" },
diff --git a/apps/web/app/routes/search.tsx b/apps/web/app/routes/search.tsx
index 1d5c609..73c2289 100644
--- a/apps/web/app/routes/search.tsx
+++ b/apps/web/app/routes/search.tsx
@@ -90,10 +90,16 @@ export default function Search() {
   return (
     <Layout>
       <FeedPage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "搜索" }]} title="搜索 CNode 内容" description="输入关键词查找话题标题、内容和社区讨论。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "搜索" }]}
+          title="搜索 CNode 内容"
+          description="输入关键词查找话题标题、内容和社区讨论。"
+        />
         <form onSubmit={handleSubmit} aria-busy={loading}>
           <Field orientation="horizontal">
-            <FieldLabel htmlFor="site-search" className="sr-only">搜索话题</FieldLabel>
+            <FieldLabel htmlFor="site-search" className="sr-only">
+              搜索话题
+            </FieldLabel>
             <Input
               id="site-search"
               name="q"
@@ -119,10 +125,17 @@ export default function Search() {
 
         {!loading && error && (
           <Alert variant="destructive">
-            <AlertDescription className="flex items-center justify-between gap-3">{error}
-            <Button type="button" variant="outline" size="sm" onClick={() => setRetryCount((count) => count + 1)}>
-              重试
-            </Button></AlertDescription>
+            <AlertDescription className="flex items-center justify-between gap-3">
+              {error}
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                onClick={() => setRetryCount((count) => count + 1)}
+              >
+                重试
+              </Button>
+            </AlertDescription>
           </Alert>
         )}
 
@@ -131,17 +144,21 @@ export default function Search() {
             {results.length > 0 ? (
               <Card>
                 <CardContent>
-                <p role="status" className="text-sm text-muted-foreground">
-                  找到 {results.length} 条与 “{q}” 相关的结果
-                </p>
-                <TopicList topics={results} />
+                  <p role="status" className="text-sm text-muted-foreground">
+                    找到 {results.length} 条与 “{q}” 相关的结果
+                  </p>
+                  <TopicList topics={results} />
                 </CardContent>
               </Card>
             ) : (
               <EmptyState
                 title="没有匹配的搜索结果"
                 message={`未找到与 "${q}" 相关的内容`}
-                action={<Button render={<Link to="/search" />} variant="outline">清除搜索</Button>}
+                action={
+                  <Button render={<Link to="/search" />} variant="outline">
+                    清除搜索
+                  </Button>
+                }
               />
             )}
           </>
diff --git a/apps/web/app/routes/search_pass.tsx b/apps/web/app/routes/search_pass.tsx
index 0fc01af..f19739f 100644
--- a/apps/web/app/routes/search_pass.tsx
+++ b/apps/web/app/routes/search_pass.tsx
@@ -49,38 +49,46 @@ export default function SearchPass() {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell
-        eyebrow="ACCOUNT RECOVERY"
-        title="找回你的 CNode 账号"
-        description="输入注册邮箱后，我们会发送密码重置邮件，帮助你安全回到社区。"
-      >
+        <AuthShell
+          eyebrow="ACCOUNT RECOVERY"
+          title="找回你的 CNode 账号"
+          description="输入注册邮箱后，我们会发送密码重置邮件，帮助你安全回到社区。"
+        >
           <h2 className="mb-6 text-lg font-semibold tracking-tight">找回密码</h2>
           <div>
-            {success && <Alert><AlertDescription role="status">{success}</AlertDescription></Alert>}
+            {success && (
+              <Alert>
+                <AlertDescription role="status">{success}</AlertDescription>
+              </Alert>
+            )}
             <form onSubmit={handleSubmit} aria-busy={loading}>
               <FieldGroup>
-              <Field data-invalid={!!error}>
-                <FieldLabel htmlFor="recovery-email">注册邮箱</FieldLabel>
-                <Input
-                  id="recovery-email"
-                  name="email"
-                  type="email"
-                  autoComplete="email"
-                  spellCheck={false}
-                  value={email}
-                  onChange={(e) => setEmail(e.target.value)}
-                  aria-invalid={!!error}
-                  aria-describedby={error ? "email-error" : undefined}
-                  placeholder="your@email.com"
-                  required
-                />
-                <FieldError id="email-error">{error}</FieldError>
-              </Field>
-              <TurnstileWidget />
-              <Button type="submit" disabled={loading} className="w-full">
-                {loading ? "发送中..." : "发送重置邮件"}
-              </Button>
-              {loading && <p role="status" className="text-center text-sm text-muted-foreground">正在发送重置邮件</p>}
+                <Field data-invalid={!!error}>
+                  <FieldLabel htmlFor="recovery-email">注册邮箱</FieldLabel>
+                  <Input
+                    id="recovery-email"
+                    name="email"
+                    type="email"
+                    autoComplete="email"
+                    spellCheck={false}
+                    value={email}
+                    onChange={(e) => setEmail(e.target.value)}
+                    aria-invalid={!!error}
+                    aria-describedby={error ? "email-error" : undefined}
+                    placeholder="your@email.com"
+                    required
+                  />
+                  <FieldError id="email-error">{error}</FieldError>
+                </Field>
+                <TurnstileWidget />
+                <Button type="submit" disabled={loading} className="w-full">
+                  {loading ? "发送中..." : "发送重置邮件"}
+                </Button>
+                {loading && (
+                  <p role="status" className="text-center text-sm text-muted-foreground">
+                    正在发送重置邮件
+                  </p>
+                )}
               </FieldGroup>
             </form>
             <div className="mt-4 text-sm text-muted-foreground">
@@ -89,7 +97,7 @@ export default function SearchPass() {
               </Link>
             </div>
           </div>
-      </AuthShell>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/setting.tsx b/apps/web/app/routes/setting.tsx
index 4ac5aa3..3c32027 100644
--- a/apps/web/app/routes/setting.tsx
+++ b/apps/web/app/routes/setting.tsx
@@ -163,12 +163,14 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
     }
   };
 
-
-
   return (
     <Layout>
       <AccountPage className="max-w-6xl">
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "用户设置" }]} title="用户设置" description="维护个人资料、通知偏好、密码和 API Token。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "用户设置" }]}
+          title="用户设置"
+          description="维护个人资料、通知偏好、密码和 API Token。"
+        />
 
         <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_20rem]">
           <div className="flex min-w-0 flex-col gap-6">
@@ -231,7 +233,12 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       解除绑定
                     </Button>
                   ) : (
-                    <Button render={<Link to="/auth/github?intent=bind" />} variant="outline" size="sm" className="self-start sm:self-auto">
+                    <Button
+                      render={<Link to="/auth/github?intent=bind" />}
+                      variant="outline"
+                      size="sm"
+                      className="self-start sm:self-auto"
+                    >
                       绑定 GitHub
                     </Button>
                   )}
@@ -255,7 +262,17 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel>个人网站</FormLabel>
-                          <FormControl render={<Input type="url" autoComplete="url" spellCheck={false} placeholder="https://" {...field} />} />
+                          <FormControl
+                            render={
+                              <Input
+                                type="url"
+                                autoComplete="url"
+                                spellCheck={false}
+                                placeholder="https://"
+                                {...field}
+                              />
+                            }
+                          />
                           <FormMessage />
                         </FormItem>
                       )}
@@ -266,7 +283,9 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel>所在地</FormLabel>
-                          <FormControl render={<Input autoComplete="address-level2" {...field} />} />
+                          <FormControl
+                            render={<Input autoComplete="address-level2" {...field} />}
+                          />
                           <FormMessage />
                         </FormItem>
                       )}
@@ -278,7 +297,9 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                         <FormItem>
                           <FormLabel>签名</FormLabel>
                           <FormControl
-                            render={<Textarea rows={2} autoComplete="off" spellCheck={true} {...field} />}
+                            render={
+                              <Textarea rows={2} autoComplete="off" spellCheck={true} {...field} />
+                            }
                           />
                           <FormMessage />
                         </FormItem>
@@ -290,7 +311,17 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel>微博</FormLabel>
-                          <FormControl render={<Input type="url" autoComplete="url" spellCheck={false} placeholder="https://weibo.com/xxx" {...field} />} />
+                          <FormControl
+                            render={
+                              <Input
+                                type="url"
+                                autoComplete="url"
+                                spellCheck={false}
+                                placeholder="https://weibo.com/xxx"
+                                {...field}
+                              />
+                            }
+                          />
                           <FormMessage />
                         </FormItem>
                       )}
@@ -300,7 +331,11 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       name="receive_reply_mail"
                       render={({ field }) => (
                         <FormItem orientation="horizontal">
-                          <FormControl render={<Checkbox checked={field.value} onCheckedChange={field.onChange} />} />
+                          <FormControl
+                            render={
+                              <Checkbox checked={field.value} onCheckedChange={field.onChange} />
+                            }
+                          />
                           <FormLabel className="font-normal text-muted-foreground">
                             有人回复我的话题时邮件通知
                           </FormLabel>
@@ -312,7 +347,11 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       name="receive_at_mail"
                       render={({ field }) => (
                         <FormItem orientation="horizontal">
-                          <FormControl render={<Checkbox checked={field.value} onCheckedChange={field.onChange} />} />
+                          <FormControl
+                            render={
+                              <Checkbox checked={field.value} onCheckedChange={field.onChange} />
+                            }
+                          />
                           <FormLabel className="font-normal text-muted-foreground">
                             有人 @我 时邮件通知
                           </FormLabel>
@@ -322,7 +361,11 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                     <Button type="submit" disabled={profileForm.formState.isSubmitting}>
                       {profileForm.formState.isSubmitting ? "保存中..." : "保存"}
                     </Button>
-                    {profileForm.formState.isSubmitting && <p role="status" className="text-sm text-muted-foreground">正在保存个人资料</p>}
+                    {profileForm.formState.isSubmitting && (
+                      <p role="status" className="text-sm text-muted-foreground">
+                        正在保存个人资料
+                      </p>
+                    )}
                   </form>
                 </Form>
               </CardContent>
@@ -345,7 +388,17 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel>当前密码</FormLabel>
-                          <FormControl render={<Input type="password" autoComplete="current-password" spellCheck={false} placeholder="当前密码" {...field} />} />
+                          <FormControl
+                            render={
+                              <Input
+                                type="password"
+                                autoComplete="current-password"
+                                spellCheck={false}
+                                placeholder="当前密码"
+                                {...field}
+                              />
+                            }
+                          />
                           <FormMessage />
                         </FormItem>
                       )}
@@ -356,7 +409,17 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel>新密码</FormLabel>
-                          <FormControl render={<Input type="password" autoComplete="new-password" spellCheck={false} placeholder="至少8位,含字母和数字" {...field} />} />
+                          <FormControl
+                            render={
+                              <Input
+                                type="password"
+                                autoComplete="new-password"
+                                spellCheck={false}
+                                placeholder="至少8位,含字母和数字"
+                                {...field}
+                              />
+                            }
+                          />
                           <FormDescription>密码需至少 8 位,包含字母和数字</FormDescription>
                           <FormMessage />
                         </FormItem>
@@ -365,7 +428,11 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
                     <Button type="submit" disabled={passForm.formState.isSubmitting}>
                       {passForm.formState.isSubmitting ? "修改中..." : "修改密码"}
                     </Button>
-                    {passForm.formState.isSubmitting && <p role="status" className="text-sm text-muted-foreground">正在修改密码</p>}
+                    {passForm.formState.isSubmitting && (
+                      <p role="status" className="text-sm text-muted-foreground">
+                        正在修改密码
+                      </p>
+                    )}
                   </form>
                 </Form>
               </CardContent>
@@ -416,14 +483,19 @@ export default function Setting({ loaderData }: Route.ComponentProps) {
             </DialogDescription>
           </DialogHeader>
           <Form {...unbindForm}>
-            <form onSubmit={unbindForm.handleSubmit(onUnbindSubmit)} className="flex flex-col gap-5">
+            <form
+              onSubmit={unbindForm.handleSubmit(onUnbindSubmit)}
+              className="flex flex-col gap-5"
+            >
               <FormField
                 control={unbindForm.control}
                 name="password"
                 render={({ field }) => (
                   <FormItem>
                     <FormLabel>当前密码</FormLabel>
-                    <FormControl render={<Input type="password" autoComplete="current-password" {...field} />} />
+                    <FormControl
+                      render={<Input type="password" autoComplete="current-password" {...field} />}
+                    />
                     <FormMessage />
                   </FormItem>
                 )}
diff --git a/apps/web/app/routes/signin.tsx b/apps/web/app/routes/signin.tsx
index efb986e..ae9f874 100644
--- a/apps/web/app/routes/signin.tsx
+++ b/apps/web/app/routes/signin.tsx
@@ -9,14 +9,7 @@ import { signinBodySchema as signinSchema } from "@cnode/shared";
 import type { z } from "zod";
 import { Button } from "~/components/ui/button";
 import { Input } from "~/components/ui/input";
-import {
-  Form,
-  FormControl,
-  FormField,
-  FormItem,
-  FormLabel,
-  FormMessage,
-} from "~/components/Form";
+import { Form, FormControl, FormField, FormItem, FormLabel, FormMessage } from "~/components/Form";
 import { AuthShell } from "~/components/AuthShell";
 import { redirectIfAuthenticated } from "~/lib/auth";
 import { AccountPage } from "~/components/PageShell";
@@ -54,10 +47,10 @@ export default function Signin() {
 
   const { run: onSubmit, pending: loading } = useAsyncAction(
     async (values: SigninValues) => {
-      return apiFetch<{ success: boolean; error_msg?: string }>(
-        "/api/v1/auth/local/login",
-        { method: "POST", body: JSON.stringify(values) },
-      );
+      return apiFetch<{ success: boolean; error_msg?: string }>("/api/v1/auth/local/login", {
+        method: "POST",
+        body: JSON.stringify(values),
+      });
     },
     {
       errorMessage: "网络错误,请稍后重试",
@@ -75,18 +68,24 @@ export default function Signin() {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell
-        eyebrow="WELCOME BACK"
-        title="回到 CNode 社区"
-        description="登录后可以发布话题、参与回复、收藏内容并接收与你相关的站内消息。"
-      >
+        <AuthShell
+          eyebrow="WELCOME BACK"
+          title="回到 CNode 社区"
+          description="登录后可以发布话题、参与回复、收藏内容并接收与你相关的站内消息。"
+        >
           <h2 className="mb-6 text-lg font-semibold tracking-tight">登录</h2>
           <div>
             {errParam && (
-              <Alert variant="destructive"><AlertDescription>{errorMsg[errParam] || errParam}</AlertDescription></Alert>
+              <Alert variant="destructive">
+                <AlertDescription>{errorMsg[errParam] || errParam}</AlertDescription>
+              </Alert>
             )}
             <Form {...form}>
-              <form onSubmit={form.handleSubmit(onSubmit)} aria-busy={loading} className="flex flex-col gap-4">
+              <form
+                onSubmit={form.handleSubmit(onSubmit)}
+                aria-busy={loading}
+                className="flex flex-col gap-4"
+              >
                 <FormField
                   control={form.control}
                   name="name"
@@ -136,7 +135,11 @@ export default function Signin() {
                 <Button type="submit" disabled={loading} className="w-full">
                   {loading ? "登录中..." : "登录"}
                 </Button>
-                {loading && <p role="status" className="text-center text-sm text-muted-foreground">正在登录</p>}
+                {loading && (
+                  <p role="status" className="text-center text-sm text-muted-foreground">
+                    正在登录
+                  </p>
+                )}
               </form>
             </Form>
             <div className="mt-4 text-sm text-muted-foreground text-center">
@@ -147,9 +150,9 @@ export default function Signin() {
               <Link to="/auth/github" className="text-primary hover:underline">
                 GitHub 登录
               </Link>
-              </div>
+            </div>
           </div>
-      </AuthShell>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/signup.tsx b/apps/web/app/routes/signup.tsx
index 509d845..73382ea 100644
--- a/apps/web/app/routes/signup.tsx
+++ b/apps/web/app/routes/signup.tsx
@@ -41,7 +41,9 @@ export function meta() {
 
 export async function loader({ request }: { request: Request }) {
   await redirectIfAuthenticated(request);
-  const res = await apiFetch<{ success: boolean; data?: { allow_signup: boolean } }>("/api/v1/auth/config");
+  const res = await apiFetch<{ success: boolean; data?: { allow_signup: boolean } }>(
+    "/api/v1/auth/config",
+  );
   return { allowSignup: res.success ? res.data?.allow_signup !== false : true };
 }
 
@@ -85,109 +87,122 @@ export default function Signup({ loaderData }: any) {
   return (
     <Layout>
       <AccountPage className="max-w-none">
-      <AuthShell
-        eyebrow="JOIN CNODE"
-        title="创建社区账号"
-        description="加入后可以发布问题、分享项目、参与讨论，并保存对你有价值的话题。"
-      >
+        <AuthShell
+          eyebrow="JOIN CNODE"
+          title="创建社区账号"
+          description="加入后可以发布问题、分享项目、参与讨论，并保存对你有价值的话题。"
+        >
           <h2 className="mb-6 text-lg font-semibold tracking-tight">注册</h2>
           <div>
             {allowSignup ? (
-            <Form {...form}>
-              <form onSubmit={form.handleSubmit(onSubmit)} aria-busy={loading} className="flex flex-col gap-4">
-                <FormField
-                  control={form.control}
-                  name="loginname"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>用户名</FormLabel>
-                      <FormControl
-                        render={
-                          <Input
-                            autoComplete="username"
-                            spellCheck={false}
-                            placeholder="字母/数字/_/-"
-                            {...field}
-                          />
-                        }
-                      />
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-                <FormField
-                  control={form.control}
-                  name="pass"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>密码</FormLabel>
-                      <FormControl
-                        render={
-                          <Input
-                            type="password"
-                            autoComplete="new-password"
-                            spellCheck={false}
-                            placeholder="至少8位,含字母和数字"
-                            {...field}
-                          />
-                        }
-                      />
-                      <FormDescription>密码需至少 8 位,包含字母和数字</FormDescription>
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-                <FormField
-                  control={form.control}
-                  name="confirmPass"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>确认密码</FormLabel>
-                      <FormControl
-                        render={
-                          <Input
-                            type="password"
-                            autoComplete="new-password"
-                            spellCheck={false}
-                            placeholder="再次输入密码"
-                            {...field}
-                          />
-                        }
-                      />
-                      <FormMessage />
-                    </FormItem>
-                  )}
-                />
-                <FormField
-                  control={form.control}
-                  name="email"
-                  render={({ field }) => (
-                    <FormItem>
-                      <FormLabel>邮箱</FormLabel>
-                      <FormControl
-                        render={
-                          <Input
-                            type="email"
-                            autoComplete="email"
-                            spellCheck={false}
-                            placeholder="your@email.com"
-                            {...field}
-                          />
-                        }
-                      />
-                      <FormMessage />
-                    </FormItem>
+              <Form {...form}>
+                <form
+                  onSubmit={form.handleSubmit(onSubmit)}
+                  aria-busy={loading}
+                  className="flex flex-col gap-4"
+                >
+                  <FormField
+                    control={form.control}
+                    name="loginname"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>用户名</FormLabel>
+                        <FormControl
+                          render={
+                            <Input
+                              autoComplete="username"
+                              spellCheck={false}
+                              placeholder="字母/数字/_/-"
+                              {...field}
+                            />
+                          }
+                        />
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="pass"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>密码</FormLabel>
+                        <FormControl
+                          render={
+                            <Input
+                              type="password"
+                              autoComplete="new-password"
+                              spellCheck={false}
+                              placeholder="至少8位,含字母和数字"
+                              {...field}
+                            />
+                          }
+                        />
+                        <FormDescription>密码需至少 8 位,包含字母和数字</FormDescription>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="confirmPass"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>确认密码</FormLabel>
+                        <FormControl
+                          render={
+                            <Input
+                              type="password"
+                              autoComplete="new-password"
+                              spellCheck={false}
+                              placeholder="再次输入密码"
+                              {...field}
+                            />
+                          }
+                        />
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                  <FormField
+                    control={form.control}
+                    name="email"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>邮箱</FormLabel>
+                        <FormControl
+                          render={
+                            <Input
+                              type="email"
+                              autoComplete="email"
+                              spellCheck={false}
+                              placeholder="your@email.com"
+                              {...field}
+                            />
+                          }
+                        />
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+                  <TurnstileWidget />
+                  <Button type="submit" disabled={loading} className="w-full">
+                    {loading ? "注册中..." : "注册"}
+                  </Button>
+                  {loading && (
+                    <p role="status" className="text-center text-sm text-muted-foreground">
+                      正在注册账号
+                    </p>
                   )}
-                />
-                <TurnstileWidget />
-                <Button type="submit" disabled={loading} className="w-full">
-                  {loading ? "注册中..." : "注册"}
-                </Button>
-                {loading && <p role="status" className="text-center text-sm text-muted-foreground">正在注册账号</p>}
-              </form>
-            </Form>
+                </form>
+              </Form>
             ) : (
-              <Empty><EmptyHeader><EmptyTitle>暂不开放注册</EmptyTitle><EmptyDescription>当前暂不开放注册。</EmptyDescription></EmptyHeader></Empty>
+              <Empty>
+                <EmptyHeader>
+                  <EmptyTitle>暂不开放注册</EmptyTitle>
+                  <EmptyDescription>当前暂不开放注册。</EmptyDescription>
+                </EmptyHeader>
+              </Empty>
             )}
             <div className="mt-4 text-sm text-muted-foreground text-center">
               <Link to="/signin" className="text-primary hover:underline">
@@ -197,9 +212,9 @@ export default function Signup({ loaderData }: any) {
               <Link to="/auth/github" className="text-primary hover:underline">
                 GitHub 登录
               </Link>
-              </div>
+            </div>
           </div>
-      </AuthShell>
+        </AuthShell>
       </AccountPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/stars.tsx b/apps/web/app/routes/stars.tsx
index efe5ea0..a4520cb 100644
--- a/apps/web/app/routes/stars.tsx
+++ b/apps/web/app/routes/stars.tsx
@@ -28,7 +28,11 @@ export default function Stars({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <DirectoryPage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "社区达人" }]} title="社区达人" description="由管理员标记的 CNode 社区活跃成员。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "社区达人" }]}
+          title="社区达人"
+          description="由管理员标记的 CNode 社区活跃成员。"
+        />
         <UserGrid users={users} empty="暂无达人" />
       </DirectoryPage>
     </Layout>
@@ -43,20 +47,24 @@ export function UserGrid({ users, empty }: { users: any[]; empty: string }) {
   return (
     <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
       {users.map((user, index) => (
-        <Item key={user.id || user.loginname} render={<Link to={`/user/${user.loginname}`} />} variant="outline">
-            <ItemMedia>
-              <Avatar>
-                <AvatarImage src={getAvatarUrl(user.avatar_url, 48)} alt={user.loginname} />
-                <AvatarFallback>{getAvatarFallback(user.loginname)}</AvatarFallback>
-              </Avatar>
-            </ItemMedia>
-            <ItemContent>
-              <ItemTitle>{user.loginname}</ItemTitle>
-              <div className="text-sm text-muted-foreground">积分 {user.score || 0}</div>
-            </ItemContent>
-            <ItemActions>
-              <Badge variant="secondary">#{index + 1}</Badge>
-            </ItemActions>
+        <Item
+          key={user.id || user.loginname}
+          render={<Link to={`/user/${user.loginname}`} />}
+          variant="outline"
+        >
+          <ItemMedia>
+            <Avatar>
+              <AvatarImage src={getAvatarUrl(user.avatar_url, 48)} alt={user.loginname} />
+              <AvatarFallback>{getAvatarFallback(user.loginname)}</AvatarFallback>
+            </Avatar>
+          </ItemMedia>
+          <ItemContent>
+            <ItemTitle>{user.loginname}</ItemTitle>
+            <div className="text-sm text-muted-foreground">积分 {user.score || 0}</div>
+          </ItemContent>
+          <ItemActions>
+            <Badge variant="secondary">#{index + 1}</Badge>
+          </ItemActions>
         </Item>
       ))}
     </div>
diff --git a/apps/web/app/routes/topic.$tid.edit.tsx b/apps/web/app/routes/topic.$tid.edit.tsx
index c3226a3..930c08a 100644
--- a/apps/web/app/routes/topic.$tid.edit.tsx
+++ b/apps/web/app/routes/topic.$tid.edit.tsx
@@ -10,7 +10,14 @@ import { toast } from "sonner";
 import { useAsyncAction } from "~/hooks/use-async-action";
 import { Button } from "~/components/ui/button";
 import { Input } from "~/components/ui/input";
-import { Select, SelectContent, SelectGroup, SelectItem, SelectTrigger, SelectValue } from "~/components/ui/select";
+import {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "~/components/ui/select";
 import { Skeleton } from "~/components/ui/skeleton";
 import { ComposePage, PageHeader } from "~/components/PageShell";
 import { Card, CardContent, CardHeader, CardTitle } from "~/components/ui/card";
@@ -80,15 +87,19 @@ export default function TopicEdit() {
             };
             setJobMeta(nextJobMeta);
           }
-          initialRef.current = JSON.stringify({ title: nextTitle, tab: nextTab, content: nextContent, jobMeta: nextJobMeta });
+          initialRef.current = JSON.stringify({
+            title: nextTitle,
+            tab: nextTab,
+            content: nextContent,
+            jobMeta: nextJobMeta,
+          });
         }
       })
       .finally(() => setLoading(false));
   }, [tid]);
 
   const isDirty =
-    !loading &&
-    initialRef.current !== JSON.stringify({ title, tab, content, jobMeta });
+    !loading && initialRef.current !== JSON.stringify({ title, tab, content, jobMeta });
   const { blocker, allowNavigation } = useUnsavedChanges(isDirty);
 
   const { run: submitTopic, pending: saving } = useAsyncAction(
@@ -147,7 +158,11 @@ export default function TopicEdit() {
   return (
     <Layout>
       <ComposePage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "编辑话题" }]} title="编辑话题" description="更新标题、分类和正文内容。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "编辑话题" }]}
+          title="编辑话题"
+          description="更新标题、分类和正文内容。"
+        />
         <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_20rem]">
           <Card className="min-w-0">
             <CardHeader>
@@ -156,34 +171,46 @@ export default function TopicEdit() {
             <CardContent>
               <form onSubmit={handleSubmit}>
                 <FieldGroup>
-                <Field>
-                  <FieldLabel htmlFor="title">标题</FieldLabel>
-                  <Input id="title" name="title" autoComplete="off" value={title} onChange={(e) => setTitle(e.target.value)} />
-                </Field>
-                <Field>
-                  <FieldLabel htmlFor="tab">分类</FieldLabel>
-                  <Select value={tab} onValueChange={(value) => value && setTab(value)}>
-                    <SelectTrigger id="tab">
-                      <SelectValue>{(value) => topicTabLabels[value] ?? value}</SelectValue>
-                    </SelectTrigger>
-                    <SelectContent>
-                      <SelectGroup>
-                        <SelectItem value="share">分享</SelectItem>
-                        <SelectItem value="ask">问答</SelectItem>
-                        <SelectItem value="job">招聘</SelectItem>
-                      </SelectGroup>
-                    </SelectContent>
-                  </Select>
-                </Field>
-                <Field>
-                  <FieldLabel htmlFor="content">正文</FieldLabel>
-                  <MarkdownEditor id="content" name="content" value={content} onChange={setContent} minHeight={280} />
-                </Field>
-                <div className="flex justify-end">
-                  <Button type="submit" disabled={saving}>
-                    {saving ? "保存中…" : "保存"}
-                  </Button>
-                </div>
+                  <Field>
+                    <FieldLabel htmlFor="title">标题</FieldLabel>
+                    <Input
+                      id="title"
+                      name="title"
+                      autoComplete="off"
+                      value={title}
+                      onChange={(e) => setTitle(e.target.value)}
+                    />
+                  </Field>
+                  <Field>
+                    <FieldLabel htmlFor="tab">分类</FieldLabel>
+                    <Select value={tab} onValueChange={(value) => value && setTab(value)}>
+                      <SelectTrigger id="tab">
+                        <SelectValue>{(value) => topicTabLabels[value] ?? value}</SelectValue>
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectGroup>
+                          <SelectItem value="share">分享</SelectItem>
+                          <SelectItem value="ask">问答</SelectItem>
+                          <SelectItem value="job">招聘</SelectItem>
+                        </SelectGroup>
+                      </SelectContent>
+                    </Select>
+                  </Field>
+                  <Field>
+                    <FieldLabel htmlFor="content">正文</FieldLabel>
+                    <MarkdownEditor
+                      id="content"
+                      name="content"
+                      value={content}
+                      onChange={setContent}
+                      minHeight={280}
+                    />
+                  </Field>
+                  <div className="flex justify-end">
+                    <Button type="submit" disabled={saving}>
+                      {saving ? "保存中…" : "保存"}
+                    </Button>
+                  </div>
                 </FieldGroup>
               </form>
             </CardContent>
diff --git a/apps/web/app/routes/topic.$tid.tsx b/apps/web/app/routes/topic.$tid.tsx
index 5307499..1b8618a 100644
--- a/apps/web/app/routes/topic.$tid.tsx
+++ b/apps/web/app/routes/topic.$tid.tsx
@@ -3,7 +3,21 @@ import type { PublicIdentity } from "@cnode/shared";
 import type { Route } from "../../.react-router/types/app/routes/+types/topic.$tid";
 import { Link, useRevalidator } from "react-router";
 import { toast } from "sonner";
-import { CalendarDays, Clock3, Code, Edit3, ExternalLink, Eye, Flag, MapPin, MessageSquare, MoreHorizontal, Star, ThumbsUp, Trash2 } from "lucide-react";
+import {
+  CalendarDays,
+  Clock3,
+  Code,
+  Edit3,
+  ExternalLink,
+  Eye,
+  Flag,
+  MapPin,
+  MessageSquare,
+  MoreHorizontal,
+  Star,
+  ThumbsUp,
+  Trash2,
+} from "lucide-react";
 import { Layout } from "~/components/Layout";
 import { MarkdownView } from "~/components/MarkdownView";
 import { TimeAgo } from "~/components/TimeAgo";
@@ -42,9 +56,20 @@ import { useAsyncAction } from "~/hooks/use-async-action";
 import { UserIdentityBadges } from "~/components/UserIdentityBadges";
 import { externalUrlLabel, githubProfileUrl, safeExternalUrl } from "~/lib/public-profile";
 import { getTopicActionPresentation } from "~/lib/topic-action-presentation";
-import { Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyTitle } from "~/components/ui/empty";
+import {
+  Empty,
+  EmptyContent,
+  EmptyDescription,
+  EmptyHeader,
+  EmptyTitle,
+} from "~/components/ui/empty";
 import { Separator } from "~/components/ui/separator";
-import { discussionForumPostingJsonLd, firstMarkdownImage, markdownExcerpt, seoMeta } from "~/lib/seo";
+import {
+  discussionForumPostingJsonLd,
+  firstMarkdownImage,
+  markdownExcerpt,
+  seoMeta,
+} from "~/lib/seo";
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -65,20 +90,27 @@ export async function loader({ params, request, context }: Route.LoaderArgs) {
   let topic = cached;
 
   if (!topic) {
-    const res = await apiFetch<{ success: boolean; data: any }>(`/api/v1/topic/${tid}?mdrender=false`, {
-      headers: { cookie },
-    });
+    const res = await apiFetch<{ success: boolean; data: any }>(
+      `/api/v1/topic/${tid}?mdrender=false`,
+      {
+        headers: { cookie },
+      },
+    );
     if (!res.success) return { topic: null, authorProfile: null, kv, currentUser };
     topic = res.data;
     if (!currentUser) await kvSet(kv, cacheKey, topic, 60);
   }
 
   const authorName = topic.author?.loginname;
-  let authorProfile = authorName && !currentUser ? await kvGet<any>(kv, `user:${authorName}`) : null;
+  let authorProfile =
+    authorName && !currentUser ? await kvGet<any>(kv, `user:${authorName}`) : null;
   if (authorName && !authorProfile) {
-    const profileResponse = await apiFetch<{ success: boolean; data: any }>(`/api/v1/user/${encodeURIComponent(authorName)}`, {
-      headers: { cookie },
-    }).catch(() => null);
+    const profileResponse = await apiFetch<{ success: boolean; data: any }>(
+      `/api/v1/user/${encodeURIComponent(authorName)}`,
+      {
+        headers: { cookie },
+      },
+    ).catch(() => null);
     if (profileResponse?.success) {
       authorProfile = profileResponse.data;
       if (!currentUser) await kvSet(kv, `user:${authorName}`, authorProfile, 60);
@@ -106,11 +138,12 @@ export default function TopicDetail({ loaderData }: Route.ComponentProps) {
     return (
       <Layout>
         <Empty>
-          <EmptyHeader><EmptyTitle>话题不存在或已被删除</EmptyTitle><EmptyDescription>返回首页继续浏览社区最新内容。</EmptyDescription></EmptyHeader>
+          <EmptyHeader>
+            <EmptyTitle>话题不存在或已被删除</EmptyTitle>
+            <EmptyDescription>返回首页继续浏览社区最新内容。</EmptyDescription>
+          </EmptyHeader>
           <EmptyContent>
-            <Button render={<Link to="/" />}>
-              返回首页
-            </Button>
+            <Button render={<Link to="/" />}>返回首页</Button>
           </EmptyContent>
         </Empty>
       </Layout>
@@ -128,33 +161,37 @@ export default function TopicDetail({ loaderData }: Route.ComponentProps) {
         dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd).replace(/</g, "\\u003c") }}
       />
       <ReadingPage>
-      <ReadingGrid
-        aside={<TopicContext topic={topic} authorProfile={authorProfile} />}
-        afterAside={(
-          <div className="flex flex-col gap-5">
-            <TopicActions topic={topic} currentUser={currentUser} />
-            <ReplySection replies={topic.replies || []} topicId={topic.id} currentUser={currentUser} />
-          </div>
-        )}
-      >
-        <article className="flex flex-col gap-5">
-          <TopicHeader topic={topic} />
-          <Card>
-            <CardContent className="flex flex-col gap-4">
-              {toc}
-              {topic.tab === "job" && topic.job_meta && (
-                <div>
-                  <JobMetaCard meta={topic.job_meta} />
-                </div>
-              )}
-              <MarkdownView
-                content={topic.content}
-                className="prose-base prose-img:rounded-xl prose-pre:overflow-x-auto"
+        <ReadingGrid
+          aside={<TopicContext topic={topic} authorProfile={authorProfile} />}
+          afterAside={
+            <div className="flex flex-col gap-5">
+              <TopicActions topic={topic} currentUser={currentUser} />
+              <ReplySection
+                replies={topic.replies || []}
+                topicId={topic.id}
+                currentUser={currentUser}
               />
-            </CardContent>
-          </Card>
-        </article>
-      </ReadingGrid>
+            </div>
+          }
+        >
+          <article className="flex flex-col gap-5">
+            <TopicHeader topic={topic} />
+            <Card>
+              <CardContent className="flex flex-col gap-4">
+                {toc}
+                {topic.tab === "job" && topic.job_meta && (
+                  <div>
+                    <JobMetaCard meta={topic.job_meta} />
+                  </div>
+                )}
+                <MarkdownView
+                  content={topic.content}
+                  className="prose-base prose-img:rounded-xl prose-pre:overflow-x-auto"
+                />
+              </CardContent>
+            </Card>
+          </article>
+        </ReadingGrid>
       </ReadingPage>
     </Layout>
   );
@@ -175,7 +212,9 @@ function TopicHeader({ topic }: { topic: any }) {
           </Link>
         </div>
         <div className="flex flex-wrap items-start justify-between gap-3">
-          <h1 className="min-w-0 flex-1 text-2xl font-medium tracking-tight sm:text-3xl">{topic.title}</h1>
+          <h1 className="min-w-0 flex-1 text-2xl font-medium tracking-tight sm:text-3xl">
+            {topic.title}
+          </h1>
           <div className="flex shrink-0 flex-wrap items-center gap-2 pt-1">
             {topic.top && <StatusBadge type="top" />}
             {topic.good && <StatusBadge type="good" />}
@@ -187,9 +226,15 @@ function TopicHeader({ topic }: { topic: any }) {
       <CardContent>
         <div className="flex flex-col gap-3 text-sm text-muted-foreground sm:flex-row sm:items-center sm:justify-between">
           <div className="flex flex-wrap items-center gap-x-3 gap-y-2">
-            <Link to={`/user/${author?.loginname}`} className="flex items-center gap-2 text-foreground hover:text-primary">
+            <Link
+              to={`/user/${author?.loginname}`}
+              className="flex items-center gap-2 text-foreground hover:text-primary"
+            >
               <Avatar className="size-8">
-                <AvatarImage src={getAvatarUrl(author?.avatar_url, 36)} alt={author?.loginname || "CNode"} />
+                <AvatarImage
+                  src={getAvatarUrl(author?.avatar_url, 36)}
+                  alt={author?.loginname || "CNode"}
+                />
                 <AvatarFallback>{getAvatarFallback(author?.loginname)}</AvatarFallback>
               </Avatar>
               <span className="font-medium">{author?.loginname || "社区成员"}</span>
@@ -206,15 +251,27 @@ function TopicHeader({ topic }: { topic: any }) {
             )}
           </div>
           <div className="flex items-center gap-3 sm:justify-end">
-            <span className="flex items-center gap-1" aria-label={`${topic.reply_count || 0} 回复`} title="回复">
+            <span
+              className="flex items-center gap-1"
+              aria-label={`${topic.reply_count || 0} 回复`}
+              title="回复"
+            >
               <MessageSquare aria-hidden="true" className="size-3.5" />
               {topic.reply_count || 0}
             </span>
-            <span className="flex items-center gap-1" aria-label={`${topic.visit_count || 0} 浏览`} title="浏览">
+            <span
+              className="flex items-center gap-1"
+              aria-label={`${topic.visit_count || 0} 浏览`}
+              title="浏览"
+            >
               <Eye aria-hidden="true" className="size-3.5" />
               {topic.visit_count || 0}
             </span>
-            <span className="flex items-center gap-1" aria-label={`${topic.collect_count || 0} 收藏`} title="收藏">
+            <span
+              className="flex items-center gap-1"
+              aria-label={`${topic.collect_count || 0} 收藏`}
+              title="收藏"
+            >
               <Star aria-hidden="true" className="size-3.5" />
               {topic.collect_count || 0}
             </span>
@@ -257,16 +314,32 @@ function TopicContext({ topic, authorProfile }: { topic: any; authorProfile?: an
           <CardTitle>话题信息</CardTitle>
         </CardHeader>
         <CardContent className="flex flex-col gap-2">
-          <div className="flex justify-between"><span>分类</span><span>{getTabLabel(topic.tab)}</span></div>
-          <div className="flex justify-between"><span>回复</span><span>{topic.reply_count || 0}</span></div>
-          <div className="flex justify-between"><span>浏览</span><span>{topic.visit_count || 0}</span></div>
+          <div className="flex justify-between">
+            <span>分类</span>
+            <span>{getTabLabel(topic.tab)}</span>
+          </div>
+          <div className="flex justify-between">
+            <span>回复</span>
+            <span>{topic.reply_count || 0}</span>
+          </div>
+          <div className="flex justify-between">
+            <span>浏览</span>
+            <span>{topic.visit_count || 0}</span>
+          </div>
         </CardContent>
       </Card>
       <Card size="sm">
         <CardContent className="flex flex-col gap-3">
           <p className="text-sm font-medium text-foreground">参与讨论前</p>
-          <p className="text-xs text-muted-foreground">请提供可复现信息、尊重不同经验背景，并善用 Markdown 格式化代码。</p>
-          <Button render={<Link to="/about#discussion" />} variant="outline" size="sm" className="w-full">
+          <p className="text-xs text-muted-foreground">
+            请提供可复现信息、尊重不同经验背景，并善用 Markdown 格式化代码。
+          </p>
+          <Button
+            render={<Link to="/about#discussion" />}
+            variant="outline"
+            size="sm"
+            className="w-full"
+          >
             查看讨论规范
           </Button>
         </CardContent>
@@ -293,26 +366,50 @@ function TopicAuthorCard({ author, profile }: { author: any; profile?: any }) {
             <AvatarFallback>{getAvatarFallback(loginname)}</AvatarFallback>
           </Avatar>
           <div className="flex min-w-0 flex-col gap-1.5">
-            <Link to={`/user/${loginname}`} className="block truncate font-semibold hover:text-primary">
+            <Link
+              to={`/user/${loginname}`}
+              className="block truncate font-semibold hover:text-primary"
+            >
               {loginname}
             </Link>
             <UserIdentityBadges identities={(profile?.identities || []) as PublicIdentity[]} />
           </div>
         </div>
 
-        {profile?.signature && <p className="whitespace-pre-wrap break-words text-sm leading-5 text-foreground/80">{profile.signature}</p>}
+        {profile?.signature && (
+          <p className="whitespace-pre-wrap break-words text-sm leading-5 text-foreground/80">
+            {profile.signature}
+          </p>
+        )}
 
         {(profile?.location || websiteUrl || githubUrl) && (
           <div className="flex flex-col gap-2 text-xs text-muted-foreground">
-            {profile?.location && <div className="flex items-center gap-2"><MapPin className="h-3.5 w-3.5" /><span className="truncate">{profile.location}</span></div>}
+            {profile?.location && (
+              <div className="flex items-center gap-2">
+                <MapPin className="h-3.5 w-3.5" />
+                <span className="truncate">{profile.location}</span>
+              </div>
+            )}
             {websiteUrl && (
-              <a className="flex items-center gap-2 hover:text-primary" href={websiteUrl} target="_blank" rel="noopener noreferrer">
-                <ExternalLink className="h-3.5 w-3.5" /><span className="truncate">{externalUrlLabel(websiteUrl)}</span>
+              <a
+                className="flex items-center gap-2 hover:text-primary"
+                href={websiteUrl}
+                target="_blank"
+                rel="noopener noreferrer"
+              >
+                <ExternalLink className="h-3.5 w-3.5" />
+                <span className="truncate">{externalUrlLabel(websiteUrl)}</span>
               </a>
             )}
             {githubUrl && (
-              <a className="flex items-center gap-2 hover:text-primary" href={githubUrl} target="_blank" rel="noopener noreferrer">
-                <Code className="h-3.5 w-3.5" /><span className="truncate">@{profile.githubUsername}</span>
+              <a
+                className="flex items-center gap-2 hover:text-primary"
+                href={githubUrl}
+                target="_blank"
+                rel="noopener noreferrer"
+              >
+                <Code className="h-3.5 w-3.5" />
+                <span className="truncate">@{profile.githubUsername}</span>
               </a>
             )}
           </div>
@@ -333,7 +430,12 @@ function TopicAuthorCard({ author, profile }: { author: any; profile?: any }) {
           </dl>
         )}
 
-        <Button render={<Link to={`/user/${loginname}`} />} variant="outline" size="sm" className="w-full">
+        <Button
+          render={<Link to={`/user/${loginname}`} />}
+          variant="outline"
+          size="sm"
+          className="w-full"
+        >
           查看用户主页
         </Button>
       </CardContent>
@@ -354,11 +456,16 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
         toast.error("登录后即可收藏话题");
         return { success: false, skipped: true };
       }
-      const path = topic.is_collect ? "/api/v1/topic_collect/de_collect" : "/api/v1/topic_collect/collect";
+      const path = topic.is_collect
+        ? "/api/v1/topic_collect/de_collect"
+        : "/api/v1/topic_collect/collect";
       return apiFetch<{ success: boolean; error_msg?: string }>(path, {
         method: "POST",
         body: JSON.stringify({ topic_id: topic.id }),
-      }).catch(() => ({ success: false, error_msg: topic.is_collect ? "取消收藏失败" : "收藏失败" }));
+      }).catch(() => ({
+        success: false,
+        error_msg: topic.is_collect ? "取消收藏失败" : "收藏失败",
+      }));
     },
     {
       onSuccess: (res) => {
@@ -376,9 +483,23 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
   const { run: runTopicAction, pending: adminPending } = useAsyncAction(
     async (
       action: "delete" | "top" | "good",
-    ): Promise<{ success: boolean; message?: string; error_msg?: string; skipped?: boolean; actionLabel: string }> => {
+    ): Promise<{
+      success: boolean;
+      message?: string;
+      error_msg?: string;
+      skipped?: boolean;
+      actionLabel: string;
+    }> => {
       const actionLabel =
-        action === "delete" ? "删除帖子" : action === "top" ? (topic.top ? "取消置顶" : "置顶") : topic.good ? "取消高亮" : "高亮";
+        action === "delete"
+          ? "删除帖子"
+          : action === "top"
+            ? topic.top
+              ? "取消置顶"
+              : "置顶"
+            : topic.good
+              ? "取消高亮"
+              : "高亮";
       if (!canManage) return { success: false, skipped: true, actionLabel };
       const res = await apiFetch<{ success: boolean; message?: string; error_msg?: string }>(
         `/api/v1/topic/${topic.id}/${action}`,
@@ -406,8 +527,14 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
   return (
     <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
       <div className="flex flex-wrap gap-2">
-        <Button variant={topic.is_collect ? "default" : "outline"} size="sm" onClick={() => toggleCollect()} disabled={collecting}>
-          <Star className="h-4 w-4" /> {collecting ? "处理中" : topic.is_collect ? "取消收藏" : "收藏话题"}
+        <Button
+          variant={topic.is_collect ? "default" : "outline"}
+          size="sm"
+          onClick={() => toggleCollect()}
+          disabled={collecting}
+        >
+          <Star className="h-4 w-4" />{" "}
+          {collecting ? "处理中" : topic.is_collect ? "取消收藏" : "收藏话题"}
         </Button>
         <Button render={<a href="#replies" />} variant="ghost" size="sm">
           <MessageSquare className="h-4 w-4" /> 查看回复
@@ -425,11 +552,22 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
             <>
               <DropdownMenu>
                 <DropdownMenuTrigger
-                  render={<Button ref={managementTriggerRef} type="button" variant="outline" size="sm" disabled={adminPending} />}
+                  render={
+                    <Button
+                      ref={managementTriggerRef}
+                      type="button"
+                      variant="outline"
+                      size="sm"
+                      disabled={adminPending}
+                    />
+                  }
                 >
                   <MoreHorizontal className="h-4 w-4" /> 管理
                 </DropdownMenuTrigger>
-                <DropdownMenuContent align="end" className="w-48 pb-[max(0.25rem,env(safe-area-inset-bottom))]">
+                <DropdownMenuContent
+                  align="end"
+                  className="w-48 pb-[max(0.25rem,env(safe-area-inset-bottom))]"
+                >
                   <DropdownMenuGroup>
                     <DropdownMenuLabel>话题管理</DropdownMenuLabel>
                     {presentation.showManagementEdit && (
@@ -438,12 +576,18 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
                       </DropdownMenuItem>
                     )}
                     {presentation.showPin && (
-                      <DropdownMenuItem onClick={() => runTopicAction("top")} disabled={adminPending}>
+                      <DropdownMenuItem
+                        onClick={() => runTopicAction("top")}
+                        disabled={adminPending}
+                      >
                         {topic.top ? "取消置顶" : "置顶帖子"}
                       </DropdownMenuItem>
                     )}
                     {presentation.showHighlight && (
-                      <DropdownMenuItem onClick={() => runTopicAction("good")} disabled={adminPending}>
+                      <DropdownMenuItem
+                        onClick={() => runTopicAction("good")}
+                        disabled={adminPending}
+                      >
                         {topic.good ? "取消高亮" : "高亮帖子"}
                       </DropdownMenuItem>
                     )}
@@ -482,10 +626,13 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
                 </AlertDialogDescription>
               </AlertDialogHeader>
               <AlertDialogFooter>
-                <AlertDialogCancel disabled={adminPending}>
-                  取消
-                </AlertDialogCancel>
-                <Button type="button" variant="destructive" onClick={() => runTopicAction("delete")} disabled={adminPending}>
+                <AlertDialogCancel disabled={adminPending}>取消</AlertDialogCancel>
+                <Button
+                  type="button"
+                  variant="destructive"
+                  onClick={() => runTopicAction("delete")}
+                  disabled={adminPending}
+                >
                   {adminPending ? "删除中" : "确认删除帖子"}
                 </Button>
               </AlertDialogFooter>
@@ -498,7 +645,9 @@ export function TopicActions({ topic, currentUser }: { topic: any; currentUser:
 }
 
 export function canEditTopic(topic: any, currentUser: any) {
-  return !!currentUser && (currentUser.is_admin || currentUser.loginname === topic?.author?.loginname);
+  return (
+    !!currentUser && (currentUser.is_admin || currentUser.loginname === topic?.author?.loginname)
+  );
 }
 
 function ReplySection({
@@ -533,10 +682,17 @@ function ReplySection({
 
   const { run: submitReply, pending: submitting } = useAsyncAction(
     async () => {
-      return apiFetch<{ success: boolean; error_msg?: string }>(`/api/v1/topic/${topicId}/replies`, {
-        method: "POST",
-        body: JSON.stringify({ content, reply_id: targetReply?.id, turnstileToken: getTurnstileToken() }),
-      });
+      return apiFetch<{ success: boolean; error_msg?: string }>(
+        `/api/v1/topic/${topicId}/replies`,
+        {
+          method: "POST",
+          body: JSON.stringify({
+            content,
+            reply_id: targetReply?.id,
+            turnstileToken: getTurnstileToken(),
+          }),
+        },
+      );
     },
     {
       onSuccess: (res) => {
@@ -571,21 +727,37 @@ function ReplySection({
 
       {replies.length === 0 ? (
         <Card>
-          <CardContent><p className="text-center text-sm text-muted-foreground">暂无回复，成为第一个参与讨论的人。</p></CardContent>
+          <CardContent>
+            <p className="text-center text-sm text-muted-foreground">
+              暂无回复，成为第一个参与讨论的人。
+            </p>
+          </CardContent>
         </Card>
       ) : (
         <div className="flex flex-col gap-3">
           {replies.map((reply, index) => (
-            <ReplyItem key={reply.id} reply={reply} floor={index + 1} currentUser={currentUser} onReply={() => startReply(reply)} />
+            <ReplyItem
+              key={reply.id}
+              reply={reply}
+              floor={index + 1}
+              currentUser={currentUser}
+              onReply={() => startReply(reply)}
+            />
           ))}
         </div>
       )}
 
       <Card>
         <CardContent>
-        <h2 className="mb-4 text-base font-semibold">{targetReply ? `回复 ${targetReply.author?.loginname}` : "参与回复"}</h2>
+          <h2 className="mb-4 text-base font-semibold">
+            {targetReply ? `回复 ${targetReply.author?.loginname}` : "参与回复"}
+          </h2>
           {currentUser ? (
-            <form ref={formRef} onSubmit={handleSubmit} className="flex scroll-mt-24 flex-col gap-3">
+            <form
+              ref={formRef}
+              onSubmit={handleSubmit}
+              className="flex scroll-mt-24 flex-col gap-3"
+            >
               {targetReply && (
                 <div className="rounded-lg bg-accent p-3 text-sm text-accent-foreground">
                   <div className="mb-1 flex items-center justify-between gap-3">
@@ -597,7 +769,11 @@ function ReplySection({
                   <p className="line-clamp-2 text-muted-foreground">{targetReply.content}</p>
                 </div>
               )}
-              <MarkdownEditor value={content} onChange={setContent} placeholder="支持 Markdown，建议贴出代码和错误信息" />
+              <MarkdownEditor
+                value={content}
+                onChange={setContent}
+                placeholder="支持 Markdown，建议贴出代码和错误信息"
+              />
               <TurnstileWidget />
               <div className="flex justify-end">
                 <Button type="submit" size="sm" disabled={!content.trim() || submitting}>
@@ -636,15 +812,23 @@ function ReplyItem({
   const { revalidate } = useRevalidator();
 
   const { run: toggleUp, pending: upping } = useAsyncAction(
-    async (): Promise<{ success: boolean; action?: "up" | "down"; error_msg?: string; skipped?: boolean }> => {
+    async (): Promise<{
+      success: boolean;
+      action?: "up" | "down";
+      error_msg?: string;
+      skipped?: boolean;
+    }> => {
       if (!currentUser) {
         toast.error("登录后即可点赞回复");
         return { success: false, skipped: true };
       }
-      return apiFetch<{ success: boolean; action?: "up" | "down"; error_msg?: string }>(`/api/v1/reply/${reply.id}/ups`, {
-        method: "POST",
-        body: JSON.stringify({}),
-      }).catch(() => ({ success: false, error_msg: "点赞失败" }));
+      return apiFetch<{ success: boolean; action?: "up" | "down"; error_msg?: string }>(
+        `/api/v1/reply/${reply.id}/ups`,
+        {
+          method: "POST",
+          body: JSON.stringify({}),
+        },
+      ).catch(() => ({ success: false, error_msg: "点赞失败" }));
     },
     {
       onSuccess: (res) => {
@@ -662,7 +846,9 @@ function ReplyItem({
   const { run: deleteReply, pending: deleting } = useAsyncAction(
     async (): Promise<{ success: boolean; error_msg?: string; skipped?: boolean }> => {
       if (!currentUser) return { success: false, skipped: true };
-      const path = currentUser.is_mod ? `/api/v1/admin/reply/${reply.id}/delete` : `/api/v1/reply/${reply.id}/delete`;
+      const path = currentUser.is_mod
+        ? `/api/v1/admin/reply/${reply.id}/delete`
+        : `/api/v1/reply/${reply.id}/delete`;
       return apiFetch<{ success: boolean; error_msg?: string }>(path, {
         method: "POST",
         body: JSON.stringify({}),
@@ -683,13 +869,17 @@ function ReplyItem({
   );
 
   const upCount = Array.isArray(reply.ups) ? reply.ups.length : 0;
-  const canDelete = currentUser && (currentUser.is_mod || currentUser.loginname === author?.loginname);
+  const canDelete =
+    currentUser && (currentUser.is_mod || currentUser.loginname === author?.loginname);
   return (
     <Card id={reply.id} className="scroll-mt-24">
       <CardHeader>
         <div className="flex min-w-0 items-center gap-3">
           <Avatar className="size-8">
-            <AvatarImage src={getAvatarUrl(author?.avatar_url, 40)} alt={author?.loginname || "CNode"} />
+            <AvatarImage
+              src={getAvatarUrl(author?.avatar_url, 40)}
+              alt={author?.loginname || "CNode"}
+            />
             <AvatarFallback>{getAvatarFallback(author?.loginname)}</AvatarFallback>
           </Avatar>
           <div className="flex min-w-0 flex-wrap items-center gap-2 text-sm">
@@ -711,25 +901,32 @@ function ReplyItem({
               href={`#${reply.reply_to.id}`}
               className="block rounded-lg bg-muted p-3 text-sm transition-colors hover:bg-accent"
             >
-              <span className="font-medium text-foreground">引用 {reply.reply_to.author?.loginname || "社区成员"}</span>
-              <span className="mt-1 block line-clamp-2 text-muted-foreground">{reply.reply_to.content_excerpt}</span>
+              <span className="font-medium text-foreground">
+                引用 {reply.reply_to.author?.loginname || "社区成员"}
+              </span>
+              <span className="mt-1 block line-clamp-2 text-muted-foreground">
+                {reply.reply_to.content_excerpt}
+              </span>
             </a>
           )}
           <MarkdownView content={reply.content} />
-          <div className="flex flex-wrap items-center justify-between gap-2" aria-label={`回复 #${floor} 操作`}>
+          <div
+            className="flex flex-wrap items-center justify-between gap-2"
+            aria-label={`回复 #${floor} 操作`}
+          >
             <div className="flex items-center gap-1" aria-label="参与操作">
-            <Button
-              type="button"
-              variant={reply.is_uped ? "default" : "ghost"}
-              size="sm"
-              onClick={toggleUp}
-              disabled={upping}
-            >
-              <ThumbsUp /> {upping ? "处理中" : upCount > 0 ? `${upCount} 赞` : "赞"}
-            </Button>
-            <Button type="button" variant="ghost" size="sm" onClick={onReply}>
-              <MessageSquare /> 回复
-            </Button>
+              <Button
+                type="button"
+                variant={reply.is_uped ? "default" : "ghost"}
+                size="sm"
+                onClick={toggleUp}
+                disabled={upping}
+              >
+                <ThumbsUp /> {upping ? "处理中" : upCount > 0 ? `${upCount} 赞` : "赞"}
+              </Button>
+              <Button type="button" variant="ghost" size="sm" onClick={onReply}>
+                <MessageSquare /> 回复
+              </Button>
             </div>
             {(currentUser || canDelete) && (
               <div className="flex items-center gap-1" aria-label="治理操作">
@@ -767,10 +964,20 @@ function ReplyItem({
                 </DialogDescription>
               </DialogHeader>
               <DialogFooter>
-                <Button type="button" variant="outline" onClick={() => setDeleteOpen(false)} disabled={deleting}>
+                <Button
+                  type="button"
+                  variant="outline"
+                  onClick={() => setDeleteOpen(false)}
+                  disabled={deleting}
+                >
                   取消
                 </Button>
-                <Button type="button" variant="destructive" onClick={deleteReply} disabled={deleting}>
+                <Button
+                  type="button"
+                  variant="destructive"
+                  onClick={deleteReply}
+                  disabled={deleting}
+                >
                   {deleting ? "删除中" : "确认删除回复"}
                 </Button>
               </DialogFooter>
@@ -782,7 +989,13 @@ function ReplyItem({
   );
 }
 
-function ReportButton({ targetType, targetId }: { targetType: "topic" | "reply"; targetId: string }) {
+function ReportButton({
+  targetType,
+  targetId,
+}: {
+  targetType: "topic" | "reply";
+  targetId: string;
+}) {
   const [open, setOpen] = useState(false);
   const [type, setType] = useState("spam");
   const [description, setDescription] = useState("");
@@ -810,7 +1023,13 @@ function ReportButton({ targetType, targetId }: { targetType: "topic" | "reply";
 
   return (
     <>
-      <Button ref={triggerRef} type="button" variant="ghost" size="sm" onClick={() => setOpen(true)}>
+      <Button
+        ref={triggerRef}
+        type="button"
+        variant="ghost"
+        size="sm"
+        onClick={() => setOpen(true)}
+      >
         <Flag /> 举报
       </Button>
       <Dialog
@@ -826,10 +1045,16 @@ function ReportButton({ targetType, targetId }: { targetType: "topic" | "reply";
         <DialogContent finalFocus={triggerRef}>
           <DialogHeader>
             <DialogTitle>举报内容</DialogTitle>
-            <DialogDescription>请选择举报类型，也可以补充说明，管理员会在后台处理。</DialogDescription>
+            <DialogDescription>
+              请选择举报类型，也可以补充说明，管理员会在后台处理。
+            </DialogDescription>
           </DialogHeader>
           <div className="flex flex-col gap-3">
-            <NativeSelect value={type} onChange={(event) => setType(event.target.value)} aria-label="举报类型">
+            <NativeSelect
+              value={type}
+              onChange={(event) => setType(event.target.value)}
+              aria-label="举报类型"
+            >
               <option value="spam">垃圾广告</option>
               <option value="attack">攻击辱骂</option>
               <option value="irrelevant">无关内容</option>
@@ -843,8 +1068,17 @@ function ReportButton({ targetType, targetId }: { targetType: "topic" | "reply";
             />
           </div>
           <DialogFooter>
-            <Button type="button" variant="outline" onClick={() => setOpen(false)} disabled={submitting}>取消</Button>
-            <Button type="button" onClick={submitReport} disabled={submitting}>{submitting ? "提交中" : "提交举报"}</Button>
+            <Button
+              type="button"
+              variant="outline"
+              onClick={() => setOpen(false)}
+              disabled={submitting}
+            >
+              取消
+            </Button>
+            <Button type="button" onClick={submitReport} disabled={submitting}>
+              {submitting ? "提交中" : "提交举报"}
+            </Button>
           </DialogFooter>
         </DialogContent>
       </Dialog>
diff --git a/apps/web/app/routes/topic.create.tsx b/apps/web/app/routes/topic.create.tsx
index d3e508a..bf4c528 100644
--- a/apps/web/app/routes/topic.create.tsx
+++ b/apps/web/app/routes/topic.create.tsx
@@ -11,7 +11,14 @@ import { toast } from "sonner";
 import { useAsyncAction } from "~/hooks/use-async-action";
 import { Button } from "~/components/ui/button";
 import { Input } from "~/components/ui/input";
-import { Select, SelectContent, SelectGroup, SelectItem, SelectTrigger, SelectValue } from "~/components/ui/select";
+import {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "~/components/ui/select";
 import { ComposePage, PageHeader } from "~/components/PageShell";
 import { Card, CardContent, CardHeader, CardTitle } from "~/components/ui/card";
 import { Field, FieldDescription, FieldGroup, FieldLabel } from "~/components/ui/field";
@@ -70,7 +77,12 @@ export default function TopicCreate({ loaderData }: Route.ComponentProps) {
 
   const { run: submitTopic, pending: saving } = useAsyncAction(
     async () => {
-      const body: Record<string, unknown> = { title, tab, content, turnstileToken: getTurnstileToken() };
+      const body: Record<string, unknown> = {
+        title,
+        tab,
+        content,
+        turnstileToken: getTurnstileToken(),
+      };
       if (tab === "job") {
         body.job_meta = {
           company: jobMeta.company,
@@ -120,7 +132,11 @@ export default function TopicCreate({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <ComposePage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "发布话题" }]} title="发布话题" description="选择正确分类，写清楚上下文，代码和日志请使用 Markdown 代码块。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "发布话题" }]}
+          title="发布话题"
+          description="选择正确分类，写清楚上下文，代码和日志请使用 Markdown 代码块。"
+        />
         <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_20rem]">
           <Card className="min-w-0">
             <CardHeader>
@@ -129,50 +145,59 @@ export default function TopicCreate({ loaderData }: Route.ComponentProps) {
             <CardContent>
               <form onSubmit={handleSubmit}>
                 <FieldGroup>
-                <Field>
-                  <FieldLabel htmlFor="title">标题</FieldLabel>
-                  <Input
-                    id="title"
-                    name="title"
-                    autoComplete="off"
-                    value={title}
-                    onChange={(e) => setTitle(e.target.value)}
-                    placeholder="例如：如何在 Node.js 中定位内存泄漏…"
-                  />
-                </Field>
-                <Field>
-                  <FieldLabel htmlFor="tab">分类</FieldLabel>
-                  <Select value={tab} onValueChange={(value) => value && setTab(value)}>
-                    <SelectTrigger id="tab" aria-describedby={!canPostJob ? "tab-description" : undefined}>
-                      <SelectValue>{(value) => topicTabLabels[value] ?? value}</SelectValue>
-                    </SelectTrigger>
-                    <SelectContent>
-                      <SelectGroup>
-                        <SelectItem value="share">分享</SelectItem>
-                        <SelectItem value="ask">问答</SelectItem>
-                        <SelectItem value="job" disabled={!canPostJob}>招聘{canPostJob ? "" : "（需要授权）"}</SelectItem>
-                      </SelectGroup>
-                    </SelectContent>
-                  </Select>
-                  {!canPostJob && <FieldDescription id="tab-description">招聘发布需要猎头角色授权。</FieldDescription>}
-                </Field>
-                <Field>
-                  <FieldLabel htmlFor="content">正文</FieldLabel>
-                  <MarkdownEditor
-                    id="content"
-                    name="content"
-                    value={content}
-                    onChange={setContent}
-                    placeholder="支持 Markdown 格式…"
-                    minHeight={320}
-                  />
-                </Field>
-                <TurnstileWidget />
-                <div className="flex justify-end">
-                  <Button type="submit" disabled={saving}>
-                    {saving ? "发布中…" : "发布"}
-                  </Button>
-                </div>
+                  <Field>
+                    <FieldLabel htmlFor="title">标题</FieldLabel>
+                    <Input
+                      id="title"
+                      name="title"
+                      autoComplete="off"
+                      value={title}
+                      onChange={(e) => setTitle(e.target.value)}
+                      placeholder="例如：如何在 Node.js 中定位内存泄漏…"
+                    />
+                  </Field>
+                  <Field>
+                    <FieldLabel htmlFor="tab">分类</FieldLabel>
+                    <Select value={tab} onValueChange={(value) => value && setTab(value)}>
+                      <SelectTrigger
+                        id="tab"
+                        aria-describedby={!canPostJob ? "tab-description" : undefined}
+                      >
+                        <SelectValue>{(value) => topicTabLabels[value] ?? value}</SelectValue>
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectGroup>
+                          <SelectItem value="share">分享</SelectItem>
+                          <SelectItem value="ask">问答</SelectItem>
+                          <SelectItem value="job" disabled={!canPostJob}>
+                            招聘{canPostJob ? "" : "（需要授权）"}
+                          </SelectItem>
+                        </SelectGroup>
+                      </SelectContent>
+                    </Select>
+                    {!canPostJob && (
+                      <FieldDescription id="tab-description">
+                        招聘发布需要猎头角色授权。
+                      </FieldDescription>
+                    )}
+                  </Field>
+                  <Field>
+                    <FieldLabel htmlFor="content">正文</FieldLabel>
+                    <MarkdownEditor
+                      id="content"
+                      name="content"
+                      value={content}
+                      onChange={setContent}
+                      placeholder="支持 Markdown 格式…"
+                      minHeight={320}
+                    />
+                  </Field>
+                  <TurnstileWidget />
+                  <div className="flex justify-end">
+                    <Button type="submit" disabled={saving}>
+                      {saving ? "发布中…" : "发布"}
+                    </Button>
+                  </div>
                 </FieldGroup>
               </form>
             </CardContent>
diff --git a/apps/web/app/routes/user.$name.collections.tsx b/apps/web/app/routes/user.$name.collections.tsx
index 854bcd7..4e6707d 100644
--- a/apps/web/app/routes/user.$name.collections.tsx
+++ b/apps/web/app/routes/user.$name.collections.tsx
@@ -23,9 +23,12 @@ export async function loader({ params, request }: Route.LoaderArgs) {
   const url = new URL(request.url);
   const page = Math.max(1, Number(url.searchParams.get("page")) || 1);
   const limit = 20;
-  const collectionsRes = await apiFetch<{ success: boolean; data: any[]; total?: number; user?: any }>(
-    `/api/v1/user/${name}/collections?page=${page}&limit=${limit}`,
-  );
+  const collectionsRes = await apiFetch<{
+    success: boolean;
+    data: any[];
+    total?: number;
+    user?: any;
+  }>(`/api/v1/user/${name}/collections?page=${page}&limit=${limit}`);
   return {
     topics: collectionsRes.success ? collectionsRes.data : [],
     user: collectionsRes.success ? collectionsRes.user : null,
@@ -45,10 +48,19 @@ export default function UserCollections({ loaderData }: Route.ComponentProps) {
         {user && <UserHero user={user} />}
         <UserTabs loginname={loginname} active="collections" />
         <Card>
-          <CardHeader><CardTitle>{loginname} 的收藏</CardTitle></CardHeader>
-          <CardContent><TopicList topics={topics} /></CardContent>
+          <CardHeader>
+            <CardTitle>{loginname} 的收藏</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <TopicList topics={topics} />
+          </CardContent>
         </Card>
-        <Pagination page={page} total={total} limit={limit} basePath={`/user/${loginname}/collections`} />
+        <Pagination
+          page={page}
+          total={total}
+          limit={limit}
+          basePath={`/user/${loginname}/collections`}
+        />
       </FeedPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/user.$name.replies.tsx b/apps/web/app/routes/user.$name.replies.tsx
index b523a65..69281e8 100644
--- a/apps/web/app/routes/user.$name.replies.tsx
+++ b/apps/web/app/routes/user.$name.replies.tsx
@@ -29,7 +29,14 @@ export async function loader({ params, request }: Route.LoaderArgs) {
   const res = await apiFetch<{ success: boolean; data: any[]; total?: number; user?: any }>(
     `/api/v1/user/${name}/replies?page=${page}&limit=${limit}`,
   );
-  return { replies: res.success ? res.data || [] : [], user: res.success ? res.user : null, loginname: name, page, limit, total: res.total || 0 };
+  return {
+    replies: res.success ? res.data || [] : [],
+    user: res.success ? res.user : null,
+    loginname: name,
+    page,
+    limit,
+    total: res.total || 0,
+  };
 }
 
 export default function UserReplies({ loaderData }: Route.ComponentProps) {
@@ -50,10 +57,11 @@ export default function UserReplies({ loaderData }: Route.ComponentProps) {
                 {replies.map((topic: any) => (
                   <Item key={topic.id} render={<Link to={`/topic/${topic.id}`} />}>
                     <ItemContent>
-                    <ItemDescription>
-                      在话题中回复 · {topic.last_reply_at ? <TimeAgo date={topic.last_reply_at} /> : null}
-                    </ItemDescription>
-                    <ItemTitle>{topic.title}</ItemTitle>
+                      <ItemDescription>
+                        在话题中回复 ·{" "}
+                        {topic.last_reply_at ? <TimeAgo date={topic.last_reply_at} /> : null}
+                      </ItemDescription>
+                      <ItemTitle>{topic.title}</ItemTitle>
                     </ItemContent>
                   </Item>
                 ))}
@@ -63,7 +71,12 @@ export default function UserReplies({ loaderData }: Route.ComponentProps) {
             )}
           </CardContent>
         </Card>
-        <Pagination page={page} total={total} limit={limit} basePath={`/user/${loginname}/replies`} />
+        <Pagination
+          page={page}
+          total={total}
+          limit={limit}
+          basePath={`/user/${loginname}/replies`}
+        />
       </FeedPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/user.$name.topics.tsx b/apps/web/app/routes/user.$name.topics.tsx
index d4aedf7..4440e13 100644
--- a/apps/web/app/routes/user.$name.topics.tsx
+++ b/apps/web/app/routes/user.$name.topics.tsx
@@ -26,7 +26,14 @@ export async function loader({ params, request }: Route.LoaderArgs) {
   const res = await apiFetch<{ success: boolean; data: any[]; total?: number; user?: any }>(
     `/api/v1/user/${name}/topics?page=${page}&limit=${limit}`,
   );
-  return { topics: res.success ? res.data || [] : [], user: res.success ? res.user : null, loginname: name, page, limit, total: res.total || 0 };
+  return {
+    topics: res.success ? res.data || [] : [],
+    user: res.success ? res.user : null,
+    loginname: name,
+    page,
+    limit,
+    total: res.total || 0,
+  };
 }
 
 export default function UserTopics({ loaderData }: Route.ComponentProps) {
@@ -38,10 +45,19 @@ export default function UserTopics({ loaderData }: Route.ComponentProps) {
         {user && <UserHero user={user} />}
         <UserTabs loginname={loginname} active="topics" />
         <Card>
-          <CardHeader><CardTitle>{loginname} 的话题</CardTitle></CardHeader>
-          <CardContent><TopicList topics={topics} /></CardContent>
+          <CardHeader>
+            <CardTitle>{loginname} 的话题</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <TopicList topics={topics} />
+          </CardContent>
         </Card>
-        <Pagination page={page} total={total} limit={limit} basePath={`/user/${loginname}/topics`} />
+        <Pagination
+          page={page}
+          total={total}
+          limit={limit}
+          basePath={`/user/${loginname}/topics`}
+        />
       </FeedPage>
     </Layout>
   );
diff --git a/apps/web/app/routes/user.$name.tsx b/apps/web/app/routes/user.$name.tsx
index 6ff4c62..a1713a6 100644
--- a/apps/web/app/routes/user.$name.tsx
+++ b/apps/web/app/routes/user.$name.tsx
@@ -64,7 +64,12 @@ export default function UserProfile({ loaderData }: Route.ComponentProps) {
   if (!user)
     return (
       <Layout>
-        <Empty><EmptyHeader><EmptyTitle>用户不存在</EmptyTitle><EmptyDescription>请检查用户名后重试。</EmptyDescription></EmptyHeader></Empty>
+        <Empty>
+          <EmptyHeader>
+            <EmptyTitle>用户不存在</EmptyTitle>
+            <EmptyDescription>请检查用户名后重试。</EmptyDescription>
+          </EmptyHeader>
+        </Empty>
       </Layout>
     );
 
@@ -111,46 +116,55 @@ function UserHero({ user, currentUser }: { user: any; currentUser?: any }) {
   const websiteUrl = safeExternalUrl(user.url);
   const githubUrl = githubProfileUrl(user.githubUsername);
 
-  const actionConfig = actionTarget === "block"
-    ? {
-        title: user.is_block ? "恢复用户内容可见" : "屏蔽用户内容",
-        description: user.is_block
-          ? `恢复 ${user.loginname} 的历史内容可见性。若该用户仍被禁言，仍不能新增发帖或回复。`
-          : `屏蔽 ${user.loginname} 创建的话题和相关回复聚合。该操作不等同于禁言。`,
-        confirm: user.is_block ? "确认恢复可见" : "确认隐藏内容",
-        variant: user.is_block ? "default" : "destructive",
-      }
-    : actionTarget === "mute"
+  const actionConfig =
+    actionTarget === "block"
       ? {
-          title: user.is_muted ? "解除用户禁言" : "禁言用户",
-          description: user.is_muted
-            ? `解除 ${user.loginname} 的禁言后，该用户可恢复新增发帖和回复能力，除非仍受其他限制。`
-            : `禁言 ${user.loginname} 后，该用户不能新增发帖或回复；历史内容不会因此隐藏。`,
-          confirm: user.is_muted ? "确认解除禁言" : "确认禁言",
-          variant: user.is_muted ? "default" : "destructive",
+          title: user.is_block ? "恢复用户内容可见" : "屏蔽用户内容",
+          description: user.is_block
+            ? `恢复 ${user.loginname} 的历史内容可见性。若该用户仍被禁言，仍不能新增发帖或回复。`
+            : `屏蔽 ${user.loginname} 创建的话题和相关回复聚合。该操作不等同于禁言。`,
+          confirm: user.is_block ? "确认恢复可见" : "确认隐藏内容",
+          variant: user.is_block ? "default" : "destructive",
         }
-      : actionTarget === "delete_all"
+      : actionTarget === "mute"
         ? {
-            title: "删除用户所有发言",
-            description: `将删除 ${user.loginname} 的所有话题和回复，并写入审计日志。此操作不会删除用户账号。`,
-            confirm: "确认删除所有发言",
-            variant: "destructive",
+            title: user.is_muted ? "解除用户禁言" : "禁言用户",
+            description: user.is_muted
+              ? `解除 ${user.loginname} 的禁言后，该用户可恢复新增发帖和回复能力，除非仍受其他限制。`
+              : `禁言 ${user.loginname} 后，该用户不能新增发帖或回复；历史内容不会因此隐藏。`,
+            confirm: user.is_muted ? "确认解除禁言" : "确认禁言",
+            variant: user.is_muted ? "default" : "destructive",
           }
-        : null;
+        : actionTarget === "delete_all"
+          ? {
+              title: "删除用户所有发言",
+              description: `将删除 ${user.loginname} 的所有话题和回复，并写入审计日志。此操作不会删除用户账号。`,
+              confirm: "确认删除所有发言",
+              variant: "destructive",
+            }
+          : null;
 
   const { run: runUserAction, pending: submitting } = useAsyncAction(
     async () => {
       if (!canManage || !actionTarget) return { success: false, error_msg: "操作失败" };
-      const action = actionTarget === "block"
-        ? user.is_block ? "unblock" : "block"
-        : actionTarget === "mute"
-          ? user.is_muted ? "unmute" : "mute"
-          : "delete_all";
+      const action =
+        actionTarget === "block"
+          ? user.is_block
+            ? "unblock"
+            : "block"
+          : actionTarget === "mute"
+            ? user.is_muted
+              ? "unmute"
+              : "mute"
+            : "delete_all";
       const fallback = actionTarget === "delete_all" ? "删除失败" : "操作失败";
-      return apiFetch<{ success: boolean; message?: string; error_msg?: string }>(`/api/v1/user/${user.loginname}/${action}`, {
-        method: "POST",
-        body: JSON.stringify({}),
-      }).catch(() => ({ success: false, error_msg: fallback }));
+      return apiFetch<{ success: boolean; message?: string; error_msg?: string }>(
+        `/api/v1/user/${user.loginname}/${action}`,
+        {
+          method: "POST",
+          body: JSON.stringify({}),
+        },
+      ).catch(() => ({ success: false, error_msg: fallback }));
     },
     {
       onSuccess: (res) => {
@@ -167,7 +181,11 @@ function UserHero({ user, currentUser }: { user: any; currentUser?: any }) {
 
   return (
     <section className="flex flex-col gap-6">
-      <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "用户" }]} title={user.loginname} description={user.signature || "CNode 社区成员"} />
+      <PageHeader
+        breadcrumbs={[{ label: "首页", to: "/" }, { label: "用户" }]}
+        title={user.loginname}
+        description={user.signature || "CNode 社区成员"}
+      />
       <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_auto] lg:items-start">
         <div className="flex min-w-0 flex-col gap-5 sm:flex-row">
           <Avatar className="size-20 shrink-0">
@@ -177,18 +195,36 @@ function UserHero({ user, currentUser }: { user: any; currentUser?: any }) {
           <div className="flex min-w-0 flex-col gap-3">
             <UserIdentityBadges identities={(user.identities || []) as PublicIdentity[]} />
             <div className="flex flex-wrap items-center gap-x-4 gap-y-2 text-sm text-muted-foreground">
-              <span>注册于 <TimeAgo date={user.create_at} /></span>
-              {user.location && <span className="inline-flex items-center gap-1"><MapPin className="h-4 w-4" />{user.location}</span>}
+              <span>
+                注册于 <TimeAgo date={user.create_at} />
+              </span>
+              {user.location && (
+                <span className="inline-flex items-center gap-1">
+                  <MapPin className="h-4 w-4" />
+                  {user.location}
+                </span>
+              )}
             </div>
             {(websiteUrl || githubUrl) && (
               <div className="flex flex-wrap items-center gap-x-4 gap-y-2 text-sm">
                 {websiteUrl && (
-                  <a className="inline-flex items-center gap-1 text-primary hover:underline" href={websiteUrl} target="_blank" rel="noopener noreferrer">
-                    <ExternalLink className="h-4 w-4" />{externalUrlLabel(websiteUrl)}
+                  <a
+                    className="inline-flex items-center gap-1 text-primary hover:underline"
+                    href={websiteUrl}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                  >
+                    <ExternalLink className="h-4 w-4" />
+                    {externalUrlLabel(websiteUrl)}
                   </a>
                 )}
                 {githubUrl && (
-                  <a className="inline-flex items-center gap-1 text-primary hover:underline" href={githubUrl} target="_blank" rel="noopener noreferrer">
+                  <a
+                    className="inline-flex items-center gap-1 text-primary hover:underline"
+                    href={githubUrl}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                  >
                     <Code className="h-4 w-4" />@{user.githubUsername}
                   </a>
                 )}
@@ -200,46 +236,58 @@ function UserHero({ user, currentUser }: { user: any; currentUser?: any }) {
           <div className="flex flex-wrap items-center justify-start gap-2 lg:justify-end">
             {user.is_block && <Badge variant="destructive">内容已屏蔽</Badge>}
             {user.is_muted && <Badge variant="destructive">已禁言</Badge>}
-          {canManage && !isSelf && (
-            <>
-              <DropdownMenu>
-                <DropdownMenuTrigger
-                  render={<Button ref={managementTriggerRef} type="button" variant="outline" size="sm" disabled={submitting} />}
-                >
-                  <MoreHorizontal className="h-4 w-4" />管理
-                </DropdownMenuTrigger>
-                <DropdownMenuContent align="end" className="w-52">
-                  <DropdownMenuGroup>
-                    <DropdownMenuLabel>用户治理</DropdownMenuLabel>
-                    <DropdownMenuItem onClick={() => setActionTarget("block")}>
-                      {user.is_block ? "恢复用户内容" : "屏蔽用户内容"}
-                    </DropdownMenuItem>
-                    <DropdownMenuItem onClick={() => setActionTarget("mute")}>
-                      {user.is_muted ? "解除禁言" : "禁言用户"}
-                    </DropdownMenuItem>
-                  </DropdownMenuGroup>
-                  <DropdownMenuSeparator />
-                  <DropdownMenuGroup>
-                    <DropdownMenuLabel>危险操作</DropdownMenuLabel>
-                    <DropdownMenuItem variant="destructive" onClick={() => setActionTarget("delete_all")}>
-                      删除所有发言
-                    </DropdownMenuItem>
-                  </DropdownMenuGroup>
-                </DropdownMenuContent>
-              </DropdownMenu>
-              <ConfirmationDialog
-                open={!!actionTarget}
-                onOpenChange={(open) => !open && setActionTarget(null)}
-                title={actionConfig?.title || "确认用户治理操作"}
-                description={actionConfig?.description || "请确认目标用户和操作影响。"}
-                confirmLabel={actionConfig?.confirm || "确认"}
-                pending={submitting}
-                destructive={actionConfig?.variant === "destructive"}
-                finalFocus={managementTriggerRef}
-                onConfirm={runUserAction}
-              />
-            </>
-          )}
+            {canManage && !isSelf && (
+              <>
+                <DropdownMenu>
+                  <DropdownMenuTrigger
+                    render={
+                      <Button
+                        ref={managementTriggerRef}
+                        type="button"
+                        variant="outline"
+                        size="sm"
+                        disabled={submitting}
+                      />
+                    }
+                  >
+                    <MoreHorizontal className="h-4 w-4" />
+                    管理
+                  </DropdownMenuTrigger>
+                  <DropdownMenuContent align="end" className="w-52">
+                    <DropdownMenuGroup>
+                      <DropdownMenuLabel>用户治理</DropdownMenuLabel>
+                      <DropdownMenuItem onClick={() => setActionTarget("block")}>
+                        {user.is_block ? "恢复用户内容" : "屏蔽用户内容"}
+                      </DropdownMenuItem>
+                      <DropdownMenuItem onClick={() => setActionTarget("mute")}>
+                        {user.is_muted ? "解除禁言" : "禁言用户"}
+                      </DropdownMenuItem>
+                    </DropdownMenuGroup>
+                    <DropdownMenuSeparator />
+                    <DropdownMenuGroup>
+                      <DropdownMenuLabel>危险操作</DropdownMenuLabel>
+                      <DropdownMenuItem
+                        variant="destructive"
+                        onClick={() => setActionTarget("delete_all")}
+                      >
+                        删除所有发言
+                      </DropdownMenuItem>
+                    </DropdownMenuGroup>
+                  </DropdownMenuContent>
+                </DropdownMenu>
+                <ConfirmationDialog
+                  open={!!actionTarget}
+                  onOpenChange={(open) => !open && setActionTarget(null)}
+                  title={actionConfig?.title || "确认用户治理操作"}
+                  description={actionConfig?.description || "请确认目标用户和操作影响。"}
+                  confirmLabel={actionConfig?.confirm || "确认"}
+                  pending={submitting}
+                  destructive={actionConfig?.variant === "destructive"}
+                  finalFocus={managementTriggerRef}
+                  onConfirm={runUserAction}
+                />
+              </>
+            )}
           </div>
           <dl className="grid grid-cols-2 gap-2 sm:grid-cols-4 lg:grid-cols-2">
             {[
@@ -260,7 +308,13 @@ function UserHero({ user, currentUser }: { user: any; currentUser?: any }) {
   );
 }
 
-function UserTabs({ loginname, active }: { loginname: string; active: "home" | "topics" | "replies" | "collections" }) {
+function UserTabs({
+  loginname,
+  active,
+}: {
+  loginname: string;
+  active: "home" | "topics" | "replies" | "collections";
+}) {
   const items = [
     ["home", "主页", `/user/${loginname}`],
     ["topics", "话题", `/user/${loginname}/topics`],
@@ -269,20 +323,20 @@ function UserTabs({ loginname, active }: { loginname: string; active: "home" | "
   ] as const;
   return (
     <nav aria-label="用户内容" className="flex gap-1 overflow-x-auto">
-        {items.map(([key, label, to]) => (
-          <Link
-            key={key}
-            to={to}
-            aria-current={active === key ? "page" : undefined}
-            className={
-              active === key
-                ? "rounded-lg bg-accent px-3 py-1.5 text-sm text-accent-foreground"
-                : "rounded-lg px-3 py-1.5 text-sm text-muted-foreground hover:bg-accent hover:text-accent-foreground"
-            }
-          >
-            {label}
-          </Link>
-        ))}
+      {items.map(([key, label, to]) => (
+        <Link
+          key={key}
+          to={to}
+          aria-current={active === key ? "page" : undefined}
+          className={
+            active === key
+              ? "rounded-lg bg-accent px-3 py-1.5 text-sm text-accent-foreground"
+              : "rounded-lg px-3 py-1.5 text-sm text-muted-foreground hover:bg-accent hover:text-accent-foreground"
+          }
+        >
+          {label}
+        </Link>
+      ))}
     </nav>
   );
 }
diff --git a/apps/web/app/routes/users.top100.tsx b/apps/web/app/routes/users.top100.tsx
index 3b07410..b6056fc 100644
--- a/apps/web/app/routes/users.top100.tsx
+++ b/apps/web/app/routes/users.top100.tsx
@@ -23,7 +23,11 @@ export default function Top100({ loaderData }: Route.ComponentProps) {
   return (
     <Layout>
       <DirectoryPage>
-        <PageHeader breadcrumbs={[{ label: "首页", to: "/" }, { label: "积分榜" }]} title="积分榜" description="未禁言用户按积分排序的前 100 名。" />
+        <PageHeader
+          breadcrumbs={[{ label: "首页", to: "/" }, { label: "积分榜" }]}
+          title="积分榜"
+          description="未禁言用户按积分排序的前 100 名。"
+        />
         <UserGrid users={users} empty="暂无用户" />
       </DirectoryPage>
     </Layout>
diff --git a/apps/web/app/styles/typeset.css b/apps/web/app/styles/typeset.css
index 3931815..f715a96 100644
--- a/apps/web/app/styles/typeset.css
+++ b/apps/web/app/styles/typeset.css
@@ -31,21 +31,10 @@
       --color-muted-foreground,
       color-mix(in oklab, currentColor 60%, transparent)
     );
-    --typeset-rule: var(
-      --color-border,
-      color-mix(in oklab, currentColor 20%, transparent)
-    );
+    --typeset-rule: var(--color-border, color-mix(in oklab, currentColor 20%, transparent));
   }
 
-  .typeset
-    *:not(
-      :where(
-        .not-typeset,
-        [data-not-typeset],
-        .not-typeset *,
-        [data-not-typeset] *
-      )
-    ) {
+  .typeset *:not(:where(.not-typeset, [data-not-typeset], .not-typeset *, [data-not-typeset] *)) {
     &:where(p) {
       margin-block-start: var(--typeset-flow);
       margin-block-end: 0;
@@ -149,21 +138,41 @@
       position: relative;
       vertical-align: baseline;
     }
-    &:where(sup) { top: -0.5em; }
-    &:where(sub) { bottom: -0.25em; }
+    &:where(sup) {
+      top: -0.5em;
+    }
+    &:where(sub) {
+      bottom: -0.25em;
+    }
     &:where(sup a) {
       text-decoration-line: none;
       font-weight: 500;
     }
 
-    &:where(ul) { list-style-type: disc; }
-    &:where(ol) { list-style-type: decimal; }
-    &:where(ul ul) { list-style-type: circle; }
-    &:where(ul ul ul) { list-style-type: square; }
-    &:where(ol[type="a" i]) { list-style-type: lower-alpha; }
-    &:where(ol[type="i" i]) { list-style-type: lower-roman; }
-    &:where(ol[type="A" s]) { list-style-type: upper-alpha; }
-    &:where(ol[type="I" s]) { list-style-type: upper-roman; }
+    &:where(ul) {
+      list-style-type: disc;
+    }
+    &:where(ol) {
+      list-style-type: decimal;
+    }
+    &:where(ul ul) {
+      list-style-type: circle;
+    }
+    &:where(ul ul ul) {
+      list-style-type: square;
+    }
+    &:where(ol[type="a" i]) {
+      list-style-type: lower-alpha;
+    }
+    &:where(ol[type="i" i]) {
+      list-style-type: lower-roman;
+    }
+    &:where(ol[type="A" s]) {
+      list-style-type: upper-alpha;
+    }
+    &:where(ol[type="I" s]) {
+      list-style-type: upper-roman;
+    }
     &:where(ul, ol) {
       margin-block-start: var(--typeset-flow);
       margin-block-end: 0;
@@ -173,9 +182,15 @@
       margin-block-start: 0.5em;
       padding-inline-start: 0.4em;
     }
-    &:where(li > p, li > ul, li > ol) { margin-block-start: 0.5em; }
-    &:where(ul > li)::marker { color: var(--typeset-muted); }
-    &:where(ol > li)::marker { color: var(--typeset-muted); }
+    &:where(li > p, li > ul, li > ol) {
+      margin-block-start: 0.5em;
+    }
+    &:where(ul > li)::marker {
+      color: var(--typeset-muted);
+    }
+    &:where(ol > li)::marker {
+      color: var(--typeset-muted);
+    }
     &:where(ul.contains-task-list) {
       list-style-type: none;
       padding-inline-start: 0.25em;
@@ -194,7 +209,9 @@
       cursor: pointer;
       font-weight: 500;
     }
-    &:where(summary)::marker { color: var(--typeset-muted); }
+    &:where(summary)::marker {
+      color: var(--typeset-muted);
+    }
 
     &:where(kbd) {
       font-family: inherit;
@@ -214,7 +231,9 @@
       font-weight: 500;
       margin-block-start: 1em;
     }
-    &:where(dt + dt) { margin-block-start: 0.25em; }
+    &:where(dt + dt) {
+      margin-block-start: 0.25em;
+    }
     &:where(dd) {
       margin-block-start: 0.25em;
       margin-inline-start: 0;
@@ -263,7 +282,9 @@
       margin-block-start: calc(var(--typeset-flow) * 2.4);
       margin-block-end: 0;
     }
-    &:where(hr + h1, hr + h2, hr + h3, hr + h4) { margin-block-start: var(--typeset-flow); }
+    &:where(hr + h1, hr + h2, hr + h3, hr + h4) {
+      margin-block-start: var(--typeset-flow);
+    }
 
     &:where(.footnotes, [data-footnotes]) {
       margin-block-start: calc(var(--typeset-flow) * 2);
@@ -287,7 +308,9 @@
       margin-block-start: var(--typeset-flow);
       margin-block-end: 0;
     }
-    &:where(p img) { margin-block-start: 0; }
+    &:where(p img) {
+      margin-block-start: 0;
+    }
     &:where(figure) {
       margin-block-start: var(--typeset-flow);
       margin-block-end: 0;
@@ -299,7 +322,9 @@
       text-align: center;
       margin-block-start: calc(0.75em / 0.875);
     }
-    &:where(caption) { caption-side: bottom; }
+    &:where(caption) {
+      caption-side: bottom;
+    }
 
     &:where(table) {
       max-width: 100%;
@@ -316,7 +341,9 @@
       overflow-x: auto;
       margin-block-start: var(--typeset-flow);
     }
-    &:where(.typeset-scroll > *) { margin-block-start: 0; }
+    &:where(.typeset-scroll > *) {
+      margin-block-start: 0;
+    }
     &:where(.typeset-scroll table) {
       width: max-content;
       max-width: none;
@@ -333,20 +360,38 @@
       vertical-align: top;
       border-block-start: 1px solid var(--typeset-rule);
     }
-    &:where(tbody th, tfoot th) { font-weight: 500; }
-    &:where(th:first-child, td:first-child) { padding-inline-start: 0; }
-    &:where(th[align="center"], td[align="center"]) { text-align: center; }
-    &:where(th[align="right"], td[align="right"]) { text-align: end; }
+    &:where(tbody th, tfoot th) {
+      font-weight: 500;
+    }
+    &:where(th:first-child, td:first-child) {
+      padding-inline-start: 0;
+    }
+    &:where(th[align="center"], td[align="center"]) {
+      text-align: center;
+    }
+    &:where(th[align="right"], td[align="right"]) {
+      text-align: end;
+    }
 
-    &:where(li > blockquote, li > table, li > figure) { margin-block-start: 0.5em; }
-    &:where(li > pre) { margin-block-start: calc(0.5em / 0.875); }
+    &:where(li > blockquote, li > table, li > figure) {
+      margin-block-start: 0.5em;
+    }
+    &:where(li > pre) {
+      margin-block-start: calc(0.5em / 0.875);
+    }
 
     @media print {
-      &:where(pre, table, blockquote, figure) { break-inside: avoid; }
-      &:where(h1, h2, h3, h4) { break-after: avoid; }
+      &:where(pre, table, blockquote, figure) {
+        break-inside: avoid;
+      }
+      &:where(h1, h2, h3, h4) {
+        break-after: avoid;
+      }
     }
     @media (forced-colors: active) {
-      &:where(:not(pre) > code) { border: 1px solid; }
+      &:where(:not(pre) > code) {
+        border: 1px solid;
+      }
     }
   }
 
@@ -368,9 +413,7 @@
       dd > :first-child,
       figure > :first-child,
       figure > picture > img
-    ):not(
-      :where(.not-typeset, [data-not-typeset], .not-typeset *, [data-not-typeset] *)
-    ) {
+    ):not(:where(.not-typeset, [data-not-typeset], .not-typeset *, [data-not-typeset] *)) {
     margin-block-start: 0;
   }
 }
diff --git a/apps/web/package.json b/apps/web/package.json
index 58f719f..b6571ac 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -8,7 +8,7 @@
     "build": "react-router build",
     "start": "react-router-serve build/server/index.js",
     "deploy": "wrangler deploy",
-    "test": "vitest run",
+    "test": "vp test run",
     "typecheck": "react-router typegen && tsc --noEmit"
   },
   "dependencies": {
@@ -57,8 +57,9 @@
     "tailwindcss": "^4.0.0",
     "tw-animate-css": "1.4.0",
     "typescript": "^5.7.0",
-    "vite": "7.3.6",
-    "vitest": "^4.1.10",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "vitest": "catalog:",
     "wrangler": "^4.0.0"
   }
 }
diff --git a/apps/web/public/openapi.json b/apps/web/public/openapi.json
index 62f35fa..1744aae 100644
--- a/apps/web/public/openapi.json
+++ b/apps/web/public/openapi.json
@@ -22,9 +22,7 @@
   "paths": {
     "/topics": {
       "get": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "获取话题列表",
         "description": "支持 page、limit、tab、mdrender 参数。",
         "parameters": [
@@ -78,9 +76,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -131,10 +127,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -158,11 +151,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -187,13 +176,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -216,11 +199,7 @@
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total"
-                  ]
+                  "required": ["success", "data", "total"]
                 }
               }
             }
@@ -228,9 +207,7 @@
         }
       },
       "post": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "创建话题",
         "description": "需要登录。新用户需通过 Turnstile 人机验证。",
         "requestBody": {
@@ -249,11 +226,7 @@
                   },
                   "tab": {
                     "type": "string",
-                    "enum": [
-                      "share",
-                      "ask",
-                      "job"
-                    ]
+                    "enum": ["share", "ask", "job"]
                   },
                   "content": {
                     "type": "string",
@@ -283,11 +256,7 @@
                       },
                       "remote": {
                         "type": "string",
-                        "enum": [
-                          "on-site",
-                          "hybrid",
-                          "remote"
-                        ]
+                        "enum": ["on-site", "hybrid", "remote"]
                       },
                       "salary_min": {
                         "type": "number",
@@ -312,20 +281,10 @@
                         "minLength": 1
                       }
                     },
-                    "required": [
-                      "company",
-                      "position",
-                      "location",
-                      "remote",
-                      "contact"
-                    ]
+                    "required": ["company", "position", "location", "remote", "contact"]
                   }
                 },
-                "required": [
-                  "title",
-                  "tab",
-                  "content"
-                ]
+                "required": ["title", "tab", "content"]
               }
             }
           }
@@ -340,18 +299,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "topic_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "topic_id"
-                  ]
+                  "required": ["success", "topic_id"]
                 }
               }
             }
@@ -365,9 +319,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -376,9 +328,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -392,9 +342,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -403,9 +351,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -419,9 +365,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -430,9 +374,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -442,9 +384,7 @@
     },
     "/topic/{topic_id}": {
       "get": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "获取话题详情",
         "description": "包含作者、回复和引用摘要。支持 mdrender 和 accesstoken 参数。",
         "parameters": [
@@ -484,9 +424,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -535,10 +473,7 @@
                               "type": "string"
                             }
                           },
-                          "required": [
-                            "loginname",
-                            "avatar_url"
-                          ]
+                          "required": ["loginname", "avatar_url"]
                         },
                         "job_meta": {
                           "type": "object",
@@ -562,11 +497,7 @@
                             },
                             "remote": {
                               "type": "string",
-                              "enum": [
-                                "on-site",
-                                "hybrid",
-                                "remote"
-                              ]
+                              "enum": ["on-site", "hybrid", "remote"]
                             },
                             "salary_min": {
                               "type": "number",
@@ -591,13 +522,7 @@
                               "minLength": 1
                             }
                           },
-                          "required": [
-                            "company",
-                            "position",
-                            "location",
-                            "remote",
-                            "contact"
-                          ]
+                          "required": ["company", "position", "location", "remote", "contact"]
                         },
                         "collect_count": {
                           "type": "number"
@@ -623,10 +548,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "content": {
                                 "type": "string"
@@ -661,10 +583,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "content_excerpt": {
                                     "type": "string"
@@ -673,12 +592,7 @@
                                     "type": "boolean"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "content_excerpt",
-                                  "deleted"
-                                ]
+                                "required": ["id", "author", "content_excerpt", "deleted"]
                               },
                               "is_uped": {
                                 "type": "boolean"
@@ -715,10 +629,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -732,9 +643,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -743,9 +652,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -759,9 +666,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -770,9 +675,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -782,9 +685,7 @@
     },
     "/topics/update": {
       "post": {
-        "tags": [
-          "topics"
-        ],
+        "tags": ["topics"],
         "summary": "编辑话题",
         "description": "作者或管理员可编辑。锁定的话题仅管理员可编辑。",
         "requestBody": {
@@ -807,11 +708,7 @@
                   },
                   "tab": {
                     "type": "string",
-                    "enum": [
-                      "share",
-                      "ask",
-                      "job"
-                    ]
+                    "enum": ["share", "ask", "job"]
                   },
                   "content": {
                     "type": "string",
@@ -838,11 +735,7 @@
                       },
                       "remote": {
                         "type": "string",
-                        "enum": [
-                          "on-site",
-                          "hybrid",
-                          "remote"
-                        ]
+                        "enum": ["on-site", "hybrid", "remote"]
                       },
                       "salary_min": {
                         "type": "number",
@@ -867,21 +760,10 @@
                         "minLength": 1
                       }
                     },
-                    "required": [
-                      "company",
-                      "position",
-                      "location",
-                      "remote",
-                      "contact"
-                    ]
+                    "required": ["company", "position", "location", "remote", "contact"]
                   }
                 },
-                "required": [
-                  "topic_id",
-                  "title",
-                  "tab",
-                  "content"
-                ]
+                "required": ["topic_id", "title", "tab", "content"]
               }
             }
           }
@@ -896,18 +778,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "topic_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "topic_id"
-                  ]
+                  "required": ["success", "topic_id"]
                 }
               }
             }
@@ -921,9 +798,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -932,9 +807,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -948,9 +821,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -959,9 +830,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -975,9 +844,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -986,9 +853,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1002,9 +867,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1013,9 +876,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1025,9 +886,7 @@
     },
     "/topic/{topic_id}/replies": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "创建回复",
         "description": "创建线性回复，可传 reply_id 回复另一条回复。需要登录。",
         "parameters": [
@@ -1060,9 +919,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "content"
-                ]
+                "required": ["content"]
               }
             }
           }
@@ -1077,18 +934,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "reply_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "reply_id"
-                  ]
+                  "required": ["success", "reply_id"]
                 }
               }
             }
@@ -1102,9 +954,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1113,9 +963,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1129,9 +977,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1140,9 +986,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1156,9 +1000,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1167,9 +1009,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1183,9 +1023,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1194,9 +1032,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1206,9 +1042,7 @@
     },
     "/reply/{reply_id}": {
       "get": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "获取回复（编辑用）",
         "description": "获取回复详情用于编辑。需要登录且为作者或管理员。",
         "parameters": [
@@ -1239,9 +1073,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -1263,19 +1095,10 @@
                           "nullable": true
                         }
                       },
-                      "required": [
-                        "id",
-                        "topic_id",
-                        "content",
-                        "create_at",
-                        "update_at"
-                      ]
+                      "required": ["id", "topic_id", "content", "create_at", "update_at"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -1289,9 +1112,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1300,9 +1121,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1316,9 +1135,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1327,9 +1144,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1343,9 +1158,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1354,9 +1167,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1366,9 +1177,7 @@
     },
     "/reply/{reply_id}/edit": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "编辑回复",
         "description": "作者或管理员可编辑。锁定的话题仅管理员可编辑。",
         "parameters": [
@@ -1395,9 +1204,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "content"
-                ]
+                "required": ["content"]
               }
             }
           }
@@ -1412,18 +1219,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "reply_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "reply_id"
-                  ]
+                  "required": ["success", "reply_id"]
                 }
               }
             }
@@ -1437,9 +1239,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1448,9 +1248,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1464,9 +1262,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1475,9 +1271,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1491,9 +1285,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1502,9 +1294,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1518,9 +1308,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1529,9 +1317,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1541,9 +1327,7 @@
     },
     "/reply/{reply_id}/delete": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "删除回复",
         "description": "作者或管理员可删除。软删除。",
         "parameters": [
@@ -1580,18 +1364,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "status": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "status"
-                  ]
+                  "required": ["success", "status"]
                 }
               }
             }
@@ -1605,9 +1384,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1616,9 +1393,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1632,9 +1407,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1643,9 +1416,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1659,9 +1430,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1670,9 +1439,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1686,9 +1453,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1697,9 +1462,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1709,9 +1472,7 @@
     },
     "/reply/{reply_id}/ups": {
       "post": {
-        "tags": [
-          "replies"
-        ],
+        "tags": ["replies"],
         "summary": "回复点赞/取消点赞",
         "description": "切换点赞状态。不能给自己的回复点赞（非 dev 模式）。",
         "parameters": [
@@ -1748,22 +1509,14 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "action": {
                       "type": "string",
-                      "enum": [
-                        "up",
-                        "down"
-                      ]
+                      "enum": ["up", "down"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "action"
-                  ]
+                  "required": ["success", "action"]
                 }
               }
             }
@@ -1777,9 +1530,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1788,9 +1539,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1804,9 +1553,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1815,9 +1562,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1831,9 +1576,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -1842,9 +1585,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -1854,9 +1595,7 @@
     },
     "/users/stars": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取星标用户",
         "responses": {
           "200": {
@@ -1868,9 +1607,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -1919,10 +1656,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -1932,9 +1666,7 @@
     },
     "/users/top100": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取积分前 100 用户",
         "responses": {
           "200": {
@@ -1946,9 +1678,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -1997,10 +1727,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -2010,9 +1737,7 @@
     },
     "/user/{loginname}/topics": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的话题列表",
         "parameters": [
           {
@@ -2055,9 +1780,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2108,10 +1831,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2135,11 +1855,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2164,13 +1880,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2236,12 +1946,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2255,9 +1960,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2266,9 +1969,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2278,9 +1979,7 @@
     },
     "/user/{loginname}/replies": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的回复列表",
         "parameters": [
           {
@@ -2323,9 +2022,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2376,10 +2073,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2403,11 +2097,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2432,13 +2122,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2504,12 +2188,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2523,9 +2202,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2534,9 +2211,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2546,9 +2221,7 @@
     },
     "/user/{loginname}/collections": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "用户的收藏列表",
         "parameters": [
           {
@@ -2591,9 +2264,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -2644,10 +2315,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -2671,11 +2339,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -2700,13 +2364,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -2772,12 +2430,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total",
-                    "user"
-                  ]
+                  "required": ["success", "data", "total", "user"]
                 }
               }
             }
@@ -2791,9 +2444,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -2802,9 +2453,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -2814,9 +2463,7 @@
     },
     "/user/{loginname}": {
       "get": {
-        "tags": [
-          "users"
-        ],
+        "tags": ["users"],
         "summary": "获取用户详情",
         "parameters": [
           {
@@ -2838,9 +2485,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -2870,11 +2515,7 @@
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "enum": [
-                              "admin",
-                              "moderator",
-                              "recruiter"
-                            ]
+                            "enum": ["admin", "moderator", "recruiter"]
                           }
                         },
                         "create_at": {
@@ -2916,10 +2557,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "title": {
                                 "type": "string"
@@ -2929,12 +2567,7 @@
                                 "nullable": true
                               }
                             },
-                            "required": [
-                              "id",
-                              "author",
-                              "title",
-                              "last_reply_at"
-                            ]
+                            "required": ["id", "author", "title", "last_reply_at"]
                           }
                         },
                         "recent_replies": {
@@ -2955,10 +2588,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "title": {
                                 "type": "string"
@@ -2968,12 +2598,7 @@
                                 "nullable": true
                               }
                             },
-                            "required": [
-                              "id",
-                              "author",
-                              "title",
-                              "last_reply_at"
-                            ]
+                            "required": ["id", "author", "title", "last_reply_at"]
                           }
                         }
                       },
@@ -2997,10 +2622,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3014,9 +2636,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3025,9 +2645,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3037,9 +2655,7 @@
     },
     "/accesstoken": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "验证 accessToken",
         "requestBody": {
           "content": {
@@ -3051,9 +2667,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "accesstoken"
-                ]
+                "required": ["accesstoken"]
               }
             }
           }
@@ -3068,9 +2682,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "loginname": {
                       "type": "string"
@@ -3088,14 +2700,7 @@
                       "type": "boolean"
                     }
                   },
-                  "required": [
-                    "success",
-                    "loginname",
-                    "avatar_url",
-                    "id",
-                    "is_block",
-                    "is_muted"
-                  ]
+                  "required": ["success", "loginname", "avatar_url", "id", "is_block", "is_muted"]
                 }
               }
             }
@@ -3109,9 +2714,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3120,9 +2723,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3136,9 +2737,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3147,9 +2746,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3159,9 +2756,7 @@
     },
     "/user/refresh_token": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "刷新 accessToken",
         "responses": {
           "200": {
@@ -3173,18 +2768,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "accessToken": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "accessToken"
-                  ]
+                  "required": ["success", "accessToken"]
                 }
               }
             }
@@ -3198,9 +2788,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3209,9 +2797,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3221,9 +2807,7 @@
     },
     "/messages": {
       "get": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "获取消息列表",
         "parameters": [
           {
@@ -3254,9 +2838,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -3271,11 +2853,7 @@
                               },
                               "type": {
                                 "type": "string",
-                                "enum": [
-                                  "reply",
-                                  "reply2",
-                                  "at"
-                                ]
+                                "enum": ["reply", "reply2", "at"]
                               },
                               "has_read": {
                                 "type": "boolean"
@@ -3293,10 +2871,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "topic": {
                                 "type": "object",
@@ -3314,10 +2889,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "title": {
                                     "type": "string"
@@ -3327,12 +2899,7 @@
                                     "nullable": true
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "title",
-                                  "last_reply_at"
-                                ]
+                                "required": ["id", "author", "title", "last_reply_at"]
                               },
                               "reply": {
                                 "type": "object",
@@ -3353,12 +2920,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "content",
-                                  "ups",
-                                  "create_at"
-                                ]
+                                "required": ["id", "content", "ups", "create_at"]
                               }
                             },
                             "required": [
@@ -3382,11 +2944,7 @@
                               },
                               "type": {
                                 "type": "string",
-                                "enum": [
-                                  "reply",
-                                  "reply2",
-                                  "at"
-                                ]
+                                "enum": ["reply", "reply2", "at"]
                               },
                               "has_read": {
                                 "type": "boolean"
@@ -3404,10 +2962,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "topic": {
                                 "type": "object",
@@ -3425,10 +2980,7 @@
                                         "type": "string"
                                       }
                                     },
-                                    "required": [
-                                      "loginname",
-                                      "avatar_url"
-                                    ]
+                                    "required": ["loginname", "avatar_url"]
                                   },
                                   "title": {
                                     "type": "string"
@@ -3438,12 +2990,7 @@
                                     "nullable": true
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "author",
-                                  "title",
-                                  "last_reply_at"
-                                ]
+                                "required": ["id", "author", "title", "last_reply_at"]
                               },
                               "reply": {
                                 "type": "object",
@@ -3464,12 +3011,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "id",
-                                  "content",
-                                  "ups",
-                                  "create_at"
-                                ]
+                                "required": ["id", "content", "ups", "create_at"]
                               }
                             },
                             "required": [
@@ -3484,16 +3026,10 @@
                           }
                         }
                       },
-                      "required": [
-                        "has_read_messages",
-                        "hasnot_read_messages"
-                      ]
+                      "required": ["has_read_messages", "hasnot_read_messages"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3507,9 +3043,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3518,9 +3052,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3530,9 +3062,7 @@
     },
     "/message/count": {
       "get": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "获取未读消息数",
         "parameters": [
           {
@@ -3554,18 +3084,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3579,9 +3104,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3590,9 +3113,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3602,9 +3123,7 @@
     },
     "/message/mark_all": {
       "post": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "标记全部已读",
         "requestBody": {
           "content": {
@@ -3630,9 +3149,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "marked_msgs": {
                       "type": "array",
@@ -3643,16 +3160,11 @@
                             "type": "string"
                           }
                         },
-                        "required": [
-                          "id"
-                        ]
+                        "required": ["id"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "marked_msgs"
-                  ]
+                  "required": ["success", "marked_msgs"]
                 }
               }
             }
@@ -3666,9 +3178,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3677,9 +3187,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3689,9 +3197,7 @@
     },
     "/message/mark_one/{msg_id}": {
       "post": {
-        "tags": [
-          "messages"
-        ],
+        "tags": ["messages"],
         "summary": "标记单条已读",
         "parameters": [
           {
@@ -3727,18 +3233,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "marked_msg_id": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "marked_msg_id"
-                  ]
+                  "required": ["success", "marked_msg_id"]
                 }
               }
             }
@@ -3752,9 +3253,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3763,9 +3262,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3775,9 +3272,7 @@
     },
     "/topic_collect/{loginname}": {
       "get": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "获取用户收藏列表",
         "parameters": [
           {
@@ -3799,9 +3294,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -3852,10 +3345,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "loginname",
-                              "avatar_url"
-                            ]
+                            "required": ["loginname", "avatar_url"]
                           },
                           "job_meta": {
                             "type": "object",
@@ -3879,11 +3369,7 @@
                               },
                               "remote": {
                                 "type": "string",
-                                "enum": [
-                                  "on-site",
-                                  "hybrid",
-                                  "remote"
-                                ]
+                                "enum": ["on-site", "hybrid", "remote"]
                               },
                               "salary_min": {
                                 "type": "number",
@@ -3908,13 +3394,7 @@
                                 "minLength": 1
                               }
                             },
-                            "required": [
-                              "company",
-                              "position",
-                              "location",
-                              "remote",
-                              "contact"
-                            ]
+                            "required": ["company", "position", "location", "remote", "contact"]
                           }
                         },
                         "required": [
@@ -3934,10 +3414,7 @@
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -3951,9 +3428,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -3962,9 +3437,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -3974,9 +3447,7 @@
     },
     "/topic_collect/collect": {
       "post": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "收藏话题",
         "requestBody": {
           "content": {
@@ -3992,9 +3463,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "topic_id"
-                ]
+                "required": ["topic_id"]
               }
             }
           }
@@ -4009,14 +3478,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4030,9 +3495,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4041,9 +3504,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4057,9 +3518,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4068,9 +3527,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4084,9 +3541,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4095,9 +3550,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4107,9 +3560,7 @@
     },
     "/topic_collect/de_collect": {
       "post": {
-        "tags": [
-          "collections"
-        ],
+        "tags": ["collections"],
         "summary": "取消收藏",
         "requestBody": {
           "content": {
@@ -4125,9 +3576,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "topic_id"
-                ]
+                "required": ["topic_id"]
               }
             }
           }
@@ -4142,14 +3591,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4163,9 +3608,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4174,9 +3617,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4190,9 +3631,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4201,9 +3640,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4213,9 +3650,7 @@
     },
     "/auth/local/login": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "本地登录",
         "requestBody": {
           "content": {
@@ -4232,10 +3667,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "name",
-                  "pass"
-                ]
+                "required": ["name", "pass"]
               }
             }
           }
@@ -4250,14 +3682,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4271,9 +3699,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4282,9 +3708,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4294,9 +3718,7 @@
     },
     "/auth/config": {
       "get": {
-        "tags": [
-          "system config"
-        ],
+        "tags": ["system config"],
         "summary": "获取公开认证配置",
         "responses": {
           "200": {
@@ -4308,9 +3730,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -4319,15 +3739,10 @@
                           "type": "boolean"
                         }
                       },
-                      "required": [
-                        "allow_signup"
-                      ]
+                      "required": ["allow_signup"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -4337,9 +3752,7 @@
     },
     "/auth/local/signup": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "本地注册",
         "requestBody": {
           "content": {
@@ -4366,11 +3779,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "loginname",
-                  "pass",
-                  "email"
-                ]
+                "required": ["loginname", "pass", "email"]
               }
             }
           }
@@ -4385,18 +3794,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4410,9 +3814,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4421,9 +3823,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4437,9 +3837,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4448,9 +3846,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4460,9 +3856,7 @@
     },
     "/auth/local/active_account": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "激活账号",
         "parameters": [
           {
@@ -4484,18 +3878,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4509,9 +3898,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4520,9 +3907,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4532,9 +3917,7 @@
     },
     "/auth/local/search_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "找回密码",
         "requestBody": {
           "content": {
@@ -4550,9 +3933,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "email"
-                ]
+                "required": ["email"]
               }
             }
           }
@@ -4567,18 +3948,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4592,9 +3968,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4603,9 +3977,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4619,9 +3991,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4630,9 +4000,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4642,9 +4010,7 @@
     },
     "/auth/local/reset_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "重置密码",
         "requestBody": {
           "content": {
@@ -4662,10 +4028,7 @@
                     "pattern": "[a-zA-Z]"
                   }
                 },
-                "required": [
-                  "key",
-                  "psw"
-                ]
+                "required": ["key", "psw"]
               }
             }
           }
@@ -4680,18 +4043,13 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "message": {
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "message"
-                  ]
+                  "required": ["success", "message"]
                 }
               }
             }
@@ -4705,9 +4063,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4716,9 +4072,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4728,9 +4082,7 @@
     },
     "/auth/github/pending": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取 GitHub pending profile",
         "responses": {
           "200": {
@@ -4742,9 +4094,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -4762,17 +4112,10 @@
                           "type": "boolean"
                         }
                       },
-                      "required": [
-                        "loginname",
-                        "email",
-                        "email_exists"
-                      ]
+                      "required": ["loginname", "email", "email_exists"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -4786,9 +4129,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4797,9 +4138,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4809,9 +4148,7 @@
     },
     "/auth/github/create": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "GitHub 注册或关联",
         "requestBody": {
           "content": {
@@ -4843,14 +4180,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4864,9 +4197,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4875,9 +4206,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4891,9 +4220,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4902,9 +4229,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4918,9 +4243,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4929,9 +4252,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4945,9 +4266,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -4956,9 +4275,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -4968,9 +4285,7 @@
     },
     "/auth/github/unbind": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "解绑 GitHub",
         "requestBody": {
           "content": {
@@ -4983,9 +4298,7 @@
                     "minLength": 1
                   }
                 },
-                "required": [
-                  "password"
-                ],
+                "required": ["password"],
                 "additionalProperties": false
               }
             }
@@ -5001,14 +4314,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5022,9 +4331,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5033,9 +4340,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5049,9 +4354,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5060,9 +4363,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5076,9 +4377,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5087,9 +4386,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5103,9 +4400,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5114,9 +4409,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5126,9 +4419,7 @@
     },
     "/auth/signout": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "退出登录",
         "responses": {
           "200": {
@@ -5140,14 +4431,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5157,9 +4444,7 @@
     },
     "/auth/me": {
       "get": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取当前登录用户",
         "responses": {
           "200": {
@@ -5176,9 +4461,7 @@
                       "nullable": true
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5188,9 +4471,7 @@
     },
     "/auth/local/setting": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "更新个人资料",
         "requestBody": {
           "content": {
@@ -5234,14 +4515,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5255,9 +4532,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5266,9 +4541,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5278,9 +4551,7 @@
     },
     "/auth/local/change_pass": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "修改密码",
         "requestBody": {
           "content": {
@@ -5295,10 +4566,7 @@
                     "type": "string"
                   }
                 },
-                "required": [
-                  "oldPass",
-                  "newPass"
-                ]
+                "required": ["oldPass", "newPass"]
               }
             }
           }
@@ -5313,14 +4581,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5334,9 +4598,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5345,9 +4607,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5361,9 +4621,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5372,9 +4630,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5388,9 +4644,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5399,9 +4653,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5411,9 +4663,7 @@
     },
     "/upload/presign": {
       "post": {
-        "tags": [
-          "auth"
-        ],
+        "tags": ["auth"],
         "summary": "获取图片上传预签名 URL",
         "requestBody": {
           "content": {
@@ -5445,9 +4695,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "url": {
                       "type": "string"
@@ -5468,14 +4716,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success",
-                    "url",
-                    "upload_url",
-                    "method",
-                    "headers",
-                    "filename"
-                  ]
+                  "required": ["success", "url", "upload_url", "method", "headers", "filename"]
                 }
               }
             }
@@ -5489,9 +4730,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5500,9 +4739,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5516,9 +4753,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5527,9 +4762,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5539,9 +4772,7 @@
     },
     "/admin/reports": {
       "post": {
-        "tags": [
-          "admin"
-        ],
+        "tags": ["admin"],
         "summary": "创建举报",
         "requestBody": {
           "content": {
@@ -5551,10 +4782,7 @@
                 "properties": {
                   "targetType": {
                     "type": "string",
-                    "enum": [
-                      "topic",
-                      "reply"
-                    ]
+                    "enum": ["topic", "reply"]
                   },
                   "targetId": {
                     "type": "integer",
@@ -5571,10 +4799,7 @@
                     "maxLength": 1000
                   }
                 },
-                "required": [
-                  "targetType",
-                  "targetId"
-                ]
+                "required": ["targetType", "targetId"]
               }
             }
           }
@@ -5589,14 +4814,10 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5610,9 +4831,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5621,9 +4840,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5637,9 +4854,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5648,9 +4863,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5664,9 +4877,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        false
-                      ]
+                      "enum": [false]
                     },
                     "error_msg": {
                       "type": "string"
@@ -5675,9 +4886,7 @@
                       "type": "string"
                     }
                   },
-                  "required": [
-                    "success"
-                  ]
+                  "required": ["success"]
                 }
               }
             }
@@ -5687,9 +4896,7 @@
     },
     "/sidebar/home": {
       "get": {
-        "tags": [
-          "system config"
-        ],
+        "tags": ["system config"],
         "summary": "首页侧边栏数据",
         "responses": {
           "200": {
@@ -5701,9 +4908,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -5732,10 +4937,7 @@
                                     "type": "string"
                                   }
                                 },
-                                "required": [
-                                  "loginname",
-                                  "avatar_url"
-                                ]
+                                "required": ["loginname", "avatar_url"]
                               },
                               "create_at": {
                                 "type": "string"
@@ -5772,12 +4974,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "id",
-                              "title",
-                              "tab",
-                              "create_at"
-                            ]
+                            "required": ["id", "title", "tab", "create_at"]
                           }
                         },
                         "top_users": {
@@ -5798,12 +4995,7 @@
                                 "type": "number"
                               }
                             },
-                            "required": [
-                              "id",
-                              "loginname",
-                              "avatar_url",
-                              "score"
-                            ]
+                            "required": ["id", "loginname", "avatar_url", "score"]
                           }
                         },
                         "partners": {
@@ -5821,11 +5013,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "name",
-                              "url",
-                              "description"
-                            ]
+                            "required": ["name", "url", "description"]
                           }
                         },
                         "resources": {
@@ -5840,10 +5028,7 @@
                                 "type": "string"
                               }
                             },
-                            "required": [
-                              "name",
-                              "url"
-                            ]
+                            "required": ["name", "url"]
                           }
                         }
                       },
@@ -5856,10 +5041,7 @@
                       ]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -5869,9 +5051,7 @@
     },
     "/zone/jobs": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "招聘专区列表",
         "parameters": [
           {
@@ -5933,9 +5113,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6022,11 +5200,7 @@
                       "type": "number"
                     }
                   },
-                  "required": [
-                    "success",
-                    "data",
-                    "total"
-                  ]
+                  "required": ["success", "data", "total"]
                 }
               }
             }
@@ -6036,9 +5210,7 @@
     },
     "/zone/jobs/facets": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "招聘专区 facet 聚合",
         "responses": {
           "200": {
@@ -6050,9 +5222,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "object",
@@ -6070,16 +5240,10 @@
                           }
                         }
                       },
-                      "required": [
-                        "locations",
-                        "remote_options"
-                      ]
+                      "required": ["locations", "remote_options"]
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -6089,9 +5253,7 @@
     },
     "/zones": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "公开专区列表（仅 visible）",
         "responses": {
           "200": {
@@ -6103,9 +5265,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6136,20 +5296,11 @@
                             "type": "number"
                           }
                         },
-                        "required": [
-                          "id",
-                          "slug",
-                          "name",
-                          "visible",
-                          "sort_order"
-                        ]
+                        "required": ["id", "slug", "name", "visible", "sort_order"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
@@ -6159,9 +5310,7 @@
     },
     "/tabs": {
       "get": {
-        "tags": [
-          "zones"
-        ],
+        "tags": ["zones"],
         "summary": "社区 tab 列表",
         "responses": {
           "200": {
@@ -6173,9 +5322,7 @@
                   "properties": {
                     "success": {
                       "type": "boolean",
-                      "enum": [
-                        true
-                      ]
+                      "enum": [true]
                     },
                     "data": {
                       "type": "array",
@@ -6199,27 +5346,15 @@
                           },
                           "scope": {
                             "type": "string",
-                            "enum": [
-                              "public",
-                              "admin"
-                            ],
+                            "enum": ["public", "admin"],
                             "default": "public"
                           }
                         },
-                        "required": [
-                          "id",
-                          "key",
-                          "label",
-                          "visible",
-                          "sort_order"
-                        ]
+                        "required": ["id", "key", "label", "visible", "sort_order"]
                       }
                     }
                   },
-                  "required": [
-                    "success",
-                    "data"
-                  ]
+                  "required": ["success", "data"]
                 }
               }
             }
diff --git a/apps/web/tests/AboutPage.test.tsx b/apps/web/tests/AboutPage.test.tsx
index 0f7ab38..40eec77 100644
--- a/apps/web/tests/AboutPage.test.tsx
+++ b/apps/web/tests/AboutPage.test.tsx
@@ -1,6 +1,6 @@
 import { render, screen, within } from "@testing-library/react";
 import { MemoryRouter } from "react-router";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import About from "~/routes/about";
 
 vi.mock("~/components/Layout", () => ({
@@ -25,7 +25,10 @@ describe("About 合并内容页", () => {
     expect(screen.getByRole("heading", { name: "社区合作" })).toBeInTheDocument();
     expect(screen.getByRole("heading", { name: "社区客户端" })).toBeInTheDocument();
     expect(screen.getByRole("heading", { name: "常见问题" })).toBeInTheDocument();
-    expect(screen.getByRole("heading", { name: "Node.js 专业中文社区" })).toHaveClass("text-2xl", "sm:text-3xl");
+    expect(screen.getByRole("heading", { name: "Node.js 专业中文社区" })).toHaveClass(
+      "text-2xl",
+      "sm:text-3xl",
+    );
     expect(container.querySelector("#guide")).toBeInTheDocument();
     expect(container.querySelector("#discussion")).toBeInTheDocument();
     expect(container.querySelector("#cooperation")).toBeInTheDocument();
@@ -43,22 +46,40 @@ describe("About 合并内容页", () => {
     expect(faq.querySelectorAll("dl")).toHaveLength(2);
   });
 
-  it.each([375, 768, 1280, 1440])("keeps section structure, spacing and overflow safeguards at %ipx", (width) => {
-    window.innerWidth = width;
-    window.dispatchEvent(new Event("resize"));
-    const { container } = renderAbout();
+  it.each([375, 768, 1280, 1440])(
+    "keeps section structure, spacing and overflow safeguards at %ipx",
+    (width) => {
+      window.innerWidth = width;
+      window.dispatchEvent(new Event("resize"));
+      const { container } = renderAbout();
 
-    const navigation = screen.getByRole("navigation", { name: "关于页面导航" });
-    const sections = container.querySelector('[data-slot="about-sections"]')!;
-    expect(navigation).toHaveClass("overflow-x-auto");
-    expect(sections).toHaveClass("min-w-0", "gap-12", "md:gap-16");
-    expect(sections.querySelectorAll(":scope > section")).toHaveLength(6);
-    expect(container.querySelector('[data-slot="card"]')).not.toBeInTheDocument();
-    expect(within(navigation).getByRole("link", { name: "社区介绍" })).toHaveAttribute("href", "#community");
-    expect(within(navigation).getByRole("link", { name: "讨论规范" })).toHaveAttribute("href", "#discussion");
-    expect(within(navigation).getByRole("link", { name: "社区合作" })).toHaveAttribute("href", "#cooperation");
-    expect(within(navigation).getByRole("link", { name: "社区客户端" })).toHaveAttribute("href", "#client");
-    expect(within(navigation).getByRole("link", { name: "常见问题" })).toHaveAttribute("href", "#faq");
-    expect(container.querySelectorAll(".gap-4").length).toBeGreaterThanOrEqual(3);
-  });
+      const navigation = screen.getByRole("navigation", { name: "关于页面导航" });
+      const sections = container.querySelector('[data-slot="about-sections"]')!;
+      expect(navigation).toHaveClass("overflow-x-auto");
+      expect(sections).toHaveClass("min-w-0", "gap-12", "md:gap-16");
+      expect(sections.querySelectorAll(":scope > section")).toHaveLength(6);
+      expect(container.querySelector('[data-slot="card"]')).not.toBeInTheDocument();
+      expect(within(navigation).getByRole("link", { name: "社区介绍" })).toHaveAttribute(
+        "href",
+        "#community",
+      );
+      expect(within(navigation).getByRole("link", { name: "讨论规范" })).toHaveAttribute(
+        "href",
+        "#discussion",
+      );
+      expect(within(navigation).getByRole("link", { name: "社区合作" })).toHaveAttribute(
+        "href",
+        "#cooperation",
+      );
+      expect(within(navigation).getByRole("link", { name: "社区客户端" })).toHaveAttribute(
+        "href",
+        "#client",
+      );
+      expect(within(navigation).getByRole("link", { name: "常见问题" })).toHaveAttribute(
+        "href",
+        "#faq",
+      );
+      expect(container.querySelectorAll(".gap-4").length).toBeGreaterThanOrEqual(3);
+    },
+  );
 });
diff --git a/apps/web/tests/AdminDestructiveConfirmations.test.tsx b/apps/web/tests/AdminDestructiveConfirmations.test.tsx
index 41669c2..0315950 100644
--- a/apps/web/tests/AdminDestructiveConfirmations.test.tsx
+++ b/apps/web/tests/AdminDestructiveConfirmations.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import AdminKeywords from "~/routes/admin/keywords";
 import AdminBans from "~/routes/admin/bans";
 import AdminReports from "~/routes/admin/reports";
@@ -35,13 +35,18 @@ describe("后台破坏性操作确认", () => {
 
   it("does not delete a keyword on cancel and blocks close while deletion is pending", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/keywords", <AdminKeywords loaderData={{
-      keywords: [{ id: 7, word: "spam", hit_count: 3 }],
-      total: 1,
-      page: 1,
-      limit: 50,
-      q: "",
-    }} />);
+    renderRoute(
+      "/admin/keywords",
+      <AdminKeywords
+        loaderData={{
+          keywords: [{ id: 7, word: "spam", hit_count: 3 }],
+          total: 1,
+          page: 1,
+          limit: 50,
+          q: "",
+        }}
+      />,
+    );
 
     const trigger = screen.getByRole("button", { name: "删除" });
     await user.click(trigger);
@@ -52,7 +57,11 @@ describe("后台破坏性操作确认", () => {
 
     await user.click(trigger);
     let resolveRequest: (value: unknown) => void = () => {};
-    apiFetch.mockReturnValueOnce(new Promise((resolve) => { resolveRequest = resolve; }));
+    apiFetch.mockReturnValueOnce(
+      new Promise((resolve) => {
+        resolveRequest = resolve;
+      }),
+    );
     await user.click(screen.getByRole("button", { name: "确认删除规则" }));
     expect(screen.getByRole("button", { name: "删除中" })).toBeDisabled();
     expect(screen.getByRole("status")).toHaveTextContent("删除中");
@@ -64,13 +73,28 @@ describe("后台破坏性操作确认", () => {
 
   it("identifies the reported target before confirming violation deletion", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/reports", <AdminReports loaderData={{
-      reports: [{ id: 9, type: "spam", target_type: "reply", target_id: 22, topic_id: 10, topic_title: "问题标题", reporter_count: 2 }],
-      total: 1,
-      page: 1,
-      limit: 50,
-      status: "pending",
-    }} />);
+    renderRoute(
+      "/admin/reports",
+      <AdminReports
+        loaderData={{
+          reports: [
+            {
+              id: 9,
+              type: "spam",
+              target_type: "reply",
+              target_id: 22,
+              topic_id: 10,
+              topic_title: "问题标题",
+              reporter_count: 2,
+            },
+          ],
+          total: 1,
+          page: 1,
+          limit: 50,
+          status: "pending",
+        }}
+      />,
+    );
 
     await user.click(screen.getByRole("button", { name: "确认违规" }));
     const dialog = screen.getByRole("alertdialog", { name: "确认违规并删除内容" });
@@ -82,14 +106,28 @@ describe("后台破坏性操作确认", () => {
 
   it("uses distinct confirmations for block, mute, roles, credentials, and delete-all", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/users", <AdminUsers loaderData={{
-      users: [{ id: 2, loginname: "alice", email: "alice@example.com", is_block: false, is_muted: false, roles: [] }],
-      total: 1,
-      page: 1,
-      limit: 50,
-      q: "",
-      currentUser: { id: 1, loginname: "admin", is_admin: true },
-    }} />);
+    renderRoute(
+      "/admin/users",
+      <AdminUsers
+        loaderData={{
+          users: [
+            {
+              id: 2,
+              loginname: "alice",
+              email: "alice@example.com",
+              is_block: false,
+              is_muted: false,
+              roles: [],
+            },
+          ],
+          total: 1,
+          page: 1,
+          limit: 50,
+          q: "",
+          currentUser: { id: 1, loginname: "admin", is_admin: true },
+        }}
+      />,
+    );
     const trigger = screen.getByRole("button", { name: "管理" });
     const openMenu = async () => {
       trigger.focus();
@@ -98,12 +136,16 @@ describe("后台破坏性操作确认", () => {
 
     await openMenu();
     await user.click(await screen.findByRole("menuitem", { name: "屏蔽用户内容" }));
-    expect(screen.getByRole("alertdialog", { name: "屏蔽用户内容" })).toHaveTextContent("不等同于禁言");
+    expect(screen.getByRole("alertdialog", { name: "屏蔽用户内容" })).toHaveTextContent(
+      "不等同于禁言",
+    );
     await user.click(screen.getByRole("button", { name: "取消" }));
 
     await openMenu();
     await user.click(await screen.findByRole("menuitem", { name: "禁言" }));
-    expect(screen.getByRole("alertdialog", { name: "禁言用户" })).toHaveTextContent("已有内容不会因此自动隐藏");
+    expect(screen.getByRole("alertdialog", { name: "禁言用户" })).toHaveTextContent(
+      "已有内容不会因此自动隐藏",
+    );
     await user.click(screen.getByRole("button", { name: "取消" }));
 
     await openMenu();
@@ -115,37 +157,64 @@ describe("后台破坏性操作确认", () => {
 
     await openMenu();
     await user.click(await screen.findByRole("menuitem", { name: "重置密码" }));
-    expect(screen.getByRole("alertdialog", { name: "重置用户密码" })).toHaveTextContent("现有密码将立即失效");
+    expect(screen.getByRole("alertdialog", { name: "重置用户密码" })).toHaveTextContent(
+      "现有密码将立即失效",
+    );
     await user.click(screen.getByRole("button", { name: "取消" }));
 
     await openMenu();
     await user.click(await screen.findByRole("menuitem", { name: "删除所有发言" }));
-    expect(screen.getByRole("alertdialog", { name: "删除用户所有发言" })).toHaveTextContent("用户账号本身不会删除");
+    expect(screen.getByRole("alertdialog", { name: "删除用户所有发言" })).toHaveTextContent(
+      "用户账号本身不会删除",
+    );
     await user.click(screen.getByRole("button", { name: "取消" }));
     expect(apiFetch).not.toHaveBeenCalled();
   });
 
   it("requires confirmation before hiding topics", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/topics", <AdminTopics loaderData={{
-      topics: [{ id: 4, title: "需要隐藏的话题", tab: "share", status: "published", deleted: 0, top: 0, good: 0, lock: 0, archived: 0, reply_count: 0, visit_count: 0, collect_count: 0, create_at: "2026-08-02" }],
-      total: 1,
-      page: 1,
-      limit: 50,
-      q: "",
-      tab: "",
-      visibility: "all",
-      flag: "all",
-      dateField: "create_at",
-      dateFrom: "",
-      dateTo: "",
-      sort: "create_at_desc",
-      user: { is_admin: true },
-    }} />);
+    renderRoute(
+      "/admin/topics",
+      <AdminTopics
+        loaderData={{
+          topics: [
+            {
+              id: 4,
+              title: "需要隐藏的话题",
+              tab: "share",
+              status: "published",
+              deleted: 0,
+              top: 0,
+              good: 0,
+              lock: 0,
+              archived: 0,
+              reply_count: 0,
+              visit_count: 0,
+              collect_count: 0,
+              create_at: "2026-08-02",
+            },
+          ],
+          total: 1,
+          page: 1,
+          limit: 50,
+          q: "",
+          tab: "",
+          visibility: "all",
+          flag: "all",
+          dateField: "create_at",
+          dateFrom: "",
+          dateTo: "",
+          sort: "create_at_desc",
+          user: { is_admin: true },
+        }}
+      />,
+    );
 
     await user.click(screen.getByRole("checkbox", { name: "选择话题 需要隐藏的话题" }));
     await user.click(screen.getByRole("button", { name: "隐藏" }));
-    expect(screen.getByRole("alertdialog", { name: "确认切换话题可见性" })).toHaveTextContent("1 个话题");
+    expect(screen.getByRole("alertdialog", { name: "确认切换话题可见性" })).toHaveTextContent(
+      "1 个话题",
+    );
     expect(apiFetch).not.toHaveBeenCalled();
     await user.click(screen.getByRole("button", { name: "取消" }));
     expect(apiFetch).not.toHaveBeenCalled();
@@ -153,25 +222,37 @@ describe("后台破坏性操作确认", () => {
 
   it("keeps a failed IP rule confirmation and its input available for retry", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/bans", <AdminBans loaderData={{
-      bannedUsers: [],
-      bannedUsersTotal: 0,
-      bannedIps: [],
-      bannedIpsTotal: 0,
-      page: 1,
-      limit: 50,
-      tab: "ips",
-      userStatus: "muted",
-    }} />);
-
-    await user.type(screen.getByPlaceholderText("IP 或 CIDR (如 1.2.3.4 或 1.2.3.0/24)"), "1.2.3.4");
+    renderRoute(
+      "/admin/bans",
+      <AdminBans
+        loaderData={{
+          bannedUsers: [],
+          bannedUsersTotal: 0,
+          bannedIps: [],
+          bannedIpsTotal: 0,
+          page: 1,
+          limit: 50,
+          tab: "ips",
+          userStatus: "muted",
+        }}
+      />,
+    );
+
+    await user.type(
+      screen.getByPlaceholderText("IP 或 CIDR (如 1.2.3.4 或 1.2.3.0/24)"),
+      "1.2.3.4",
+    );
     await user.click(screen.getByRole("button", { name: "添加" }));
-    expect(screen.getByRole("alertdialog", { name: "确认添加 IP 封禁规则" })).toHaveTextContent("1.2.3.4");
+    expect(screen.getByRole("alertdialog", { name: "确认添加 IP 封禁规则" })).toHaveTextContent(
+      "1.2.3.4",
+    );
     expect(apiFetch).not.toHaveBeenCalled();
 
     apiFetch.mockResolvedValueOnce({ success: false, error_msg: "规则冲突" });
     await user.click(screen.getByRole("button", { name: "确认添加 IP 规则" }));
-    await waitFor(() => expect(screen.getByRole("button", { name: "确认添加 IP 规则" })).toBeEnabled());
+    await waitFor(() =>
+      expect(screen.getByRole("button", { name: "确认添加 IP 规则" })).toBeEnabled(),
+    );
     expect(screen.getByRole("alertdialog", { name: "确认添加 IP 封禁规则" })).toBeInTheDocument();
     expect(screen.getByDisplayValue("1.2.3.4")).toBeInTheDocument();
     expect(toastError).toHaveBeenCalledWith("规则冲突");
@@ -180,19 +261,24 @@ describe("后台破坏性操作确认", () => {
 
   it("keeps skipped bulk governance targets selected for retry", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/bans", <AdminBans loaderData={{
-      bannedUsers: [
-        { id: 1, loginname: "alice", is_muted: true, is_block: false },
-        { id: 2, loginname: "bob", is_muted: true, is_block: false },
-      ],
-      bannedUsersTotal: 2,
-      bannedIps: [],
-      bannedIpsTotal: 0,
-      page: 1,
-      limit: 50,
-      tab: "users",
-      userStatus: "muted",
-    }} />);
+    renderRoute(
+      "/admin/bans",
+      <AdminBans
+        loaderData={{
+          bannedUsers: [
+            { id: 1, loginname: "alice", is_muted: true, is_block: false },
+            { id: 2, loginname: "bob", is_muted: true, is_block: false },
+          ],
+          bannedUsersTotal: 2,
+          bannedIps: [],
+          bannedIpsTotal: 0,
+          page: 1,
+          limit: 50,
+          tab: "users",
+          userStatus: "muted",
+        }}
+      />,
+    );
 
     await user.click(screen.getByRole("checkbox", { name: "选择当前页禁言用户" }));
     await user.click(screen.getByRole("button", { name: "批量解除禁言 (2)" }));
@@ -201,24 +287,28 @@ describe("后台破坏性操作确认", () => {
     await waitFor(() => expect(screen.queryByRole("alertdialog")).not.toBeInTheDocument());
     expect(screen.getByRole("checkbox", { name: "选择 alice" })).not.toBeChecked();
     expect(screen.getByRole("checkbox", { name: "选择 bob" })).toBeChecked();
-    expect(toastSuccess).toHaveBeenCalledWith(
-      "解除禁言结果：成功 1 个，跳过 1 个，失败 0 个",
-      { description: "可重试目标：2" },
-    );
+    expect(toastSuccess).toHaveBeenCalledWith("解除禁言结果：成功 1 个，跳过 1 个，失败 0 个", {
+      description: "可重试目标：2",
+    });
   });
 
   it("does not report a failed settings save as successful", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/settings", <AdminSettings loaderData={{
-      tab: "registration",
-      config: {
-        allow_signup: true,
-        new_user_min_hours: 24,
-        new_user_min_replies: 3,
-        rate_topic: 1000,
-        rate_reply: 1000,
-      },
-    }} />);
+    renderRoute(
+      "/admin/settings",
+      <AdminSettings
+        loaderData={{
+          tab: "registration",
+          config: {
+            allow_signup: true,
+            new_user_min_hours: 24,
+            new_user_min_replies: 3,
+            rate_topic: 1000,
+            rate_reply: 1000,
+          },
+        }}
+      />,
+    );
     apiFetch.mockResolvedValueOnce({ success: false, error_msg: "保存冲突" });
     await user.click(screen.getByRole("button", { name: "保存" }));
     await waitFor(() => expect(screen.getByRole("button", { name: "保存" })).toBeEnabled());
@@ -228,14 +318,28 @@ describe("后台破坏性操作确认", () => {
 
   it("keeps password reset context open after a business failure", async () => {
     const user = userEvent.setup();
-    renderRoute("/admin/users", <AdminUsers loaderData={{
-      users: [{ id: 2, loginname: "alice", email: "alice@example.com", is_block: false, is_muted: false, roles: [] }],
-      total: 1,
-      page: 1,
-      limit: 50,
-      q: "",
-      currentUser: { id: 1, loginname: "admin", is_admin: true },
-    }} />);
+    renderRoute(
+      "/admin/users",
+      <AdminUsers
+        loaderData={{
+          users: [
+            {
+              id: 2,
+              loginname: "alice",
+              email: "alice@example.com",
+              is_block: false,
+              is_muted: false,
+              roles: [],
+            },
+          ],
+          total: 1,
+          page: 1,
+          limit: 50,
+          q: "",
+          currentUser: { id: 1, loginname: "admin", is_admin: true },
+        }}
+      />,
+    );
 
     const trigger = screen.getByRole("button", { name: "管理" });
     trigger.focus();
diff --git a/apps/web/tests/AdminModeration.test.tsx b/apps/web/tests/AdminModeration.test.tsx
index ffc1080..7d5c4f3 100644
--- a/apps/web/tests/AdminModeration.test.tsx
+++ b/apps/web/tests/AdminModeration.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import AdminMod from "~/routes/admin/mod";
 
 const { apiFetch } = vi.hoisted(() => ({ apiFetch: vi.fn() }));
@@ -13,30 +13,34 @@ vi.mock("~/components/AdminLayout", () => ({
 }));
 
 const loaderData = {
-  jobs: [{
-    id: 12,
-    scope: "all",
-    mode: "historical",
-    reason: "manual",
-    status: "running",
-    scannedCount: 40,
-    hitCount: 3,
-    pendingHitCount: 1,
-    cursorTopicId: 30,
-    cursorReplyId: 10,
-  }],
-  results: [{
-    id: 8,
-    scan_job_id: 12,
-    type: "topic",
-    target_id: 42,
-    topic_id: 42,
-    author_id: 5,
-    field: "content",
-    scanned_at: "2026-08-03",
-    keywords: ["spam"],
-    preview: "matched content preview",
-  }],
+  jobs: [
+    {
+      id: 12,
+      scope: "all",
+      mode: "historical",
+      reason: "manual",
+      status: "running",
+      scannedCount: 40,
+      hitCount: 3,
+      pendingHitCount: 1,
+      cursorTopicId: 30,
+      cursorReplyId: 10,
+    },
+  ],
+  results: [
+    {
+      id: 8,
+      scan_job_id: 12,
+      type: "topic",
+      target_id: 42,
+      topic_id: 42,
+      author_id: 5,
+      field: "content",
+      scanned_at: "2026-08-03",
+      keywords: ["spam"],
+      preview: "matched content preview",
+    },
+  ],
   total: 1,
   summary: { by_type: { topic: 1, reply: 0 }, by_keyword: { spam: 1 } },
   page: 1,
@@ -73,10 +77,14 @@ describe("后台巡检工作流", () => {
     renderRoute();
 
     await user.click(screen.getByRole("button", { name: "取消" }));
-    expect(screen.getByRole("alertdialog", { name: "确认取消巡检任务" })).toHaveTextContent("任务 #12");
+    expect(screen.getByRole("alertdialog", { name: "确认取消巡检任务" })).toHaveTextContent(
+      "任务 #12",
+    );
     expect(apiFetch).not.toHaveBeenCalled();
     await user.click(screen.getByRole("button", { name: "确认取消任务" }));
-    expect(apiFetch).toHaveBeenCalledWith("/api/v1/admin/moderation/jobs/12/cancel", { method: "POST" });
+    expect(apiFetch).toHaveBeenCalledWith("/api/v1/admin/moderation/jobs/12/cancel", {
+      method: "POST",
+    });
   });
 
   it("requires confirmation before deleting a moderation hit", async () => {
@@ -84,7 +92,9 @@ describe("后台巡检工作流", () => {
     renderRoute();
 
     await user.click(screen.getByRole("button", { name: "确认删除" }));
-    expect(screen.getByRole("alertdialog", { name: "确认违规并删除命中内容" })).toHaveTextContent("话题 #42");
+    expect(screen.getByRole("alertdialog", { name: "确认违规并删除命中内容" })).toHaveTextContent(
+      "话题 #42",
+    );
     expect(apiFetch).not.toHaveBeenCalled();
   });
 });
diff --git a/apps/web/tests/AdminUrlState.test.tsx b/apps/web/tests/AdminUrlState.test.tsx
index 9454522..bde8256 100644
--- a/apps/web/tests/AdminUrlState.test.tsx
+++ b/apps/web/tests/AdminUrlState.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import AdminBans from "~/routes/admin/bans";
 import AdminSettings from "~/routes/admin/settings";
 
@@ -20,10 +20,12 @@ const config = {
 describe("后台 URL 状态", () => {
   it("writes the selected settings tab to the URL", async () => {
     const router = createMemoryRouter(
-      [{
-        path: "/admin/settings",
-        element: <AdminSettings loaderData={{ config, tab: "registration" }} />,
-      }],
+      [
+        {
+          path: "/admin/settings",
+          element: <AdminSettings loaderData={{ config, tab: "registration" }} />,
+        },
+      ],
       { initialEntries: ["/admin/settings?source=audit"] },
     );
     render(<RouterProvider router={router} />);
@@ -34,19 +36,25 @@ describe("后台 URL 状态", () => {
 
   it("writes bans tabs to the URL while resetting incompatible paging state", async () => {
     const router = createMemoryRouter(
-      [{
-        path: "/admin/bans",
-        element: <AdminBans loaderData={{
-          bannedUsers: [],
-          bannedUsersTotal: 0,
-          bannedIps: [],
-          bannedIpsTotal: 0,
-          page: 3,
-          limit: 50,
-          tab: "users",
-          userStatus: "muted",
-        }} />,
-      }],
+      [
+        {
+          path: "/admin/bans",
+          element: (
+            <AdminBans
+              loaderData={{
+                bannedUsers: [],
+                bannedUsersTotal: 0,
+                bannedIps: [],
+                bannedIpsTotal: 0,
+                page: 3,
+                limit: 50,
+                tab: "users",
+                userStatus: "muted",
+              }}
+            />
+          ),
+        },
+      ],
       { initialEntries: ["/admin/bans?tab=users&status=muted&page=3&limit=50"] },
     );
     render(<RouterProvider router={router} />);
diff --git a/apps/web/tests/AdminUsersActions.test.ts b/apps/web/tests/AdminUsersActions.test.ts
index 4d36eac..9f2e28f 100644
--- a/apps/web/tests/AdminUsersActions.test.ts
+++ b/apps/web/tests/AdminUsersActions.test.ts
@@ -1,6 +1,10 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { adminUserBulkGovernanceBodySchema, adminUsersQuerySchema } from "@cnode/shared";
-import { bulkUserGovernanceFeedback, USER_GOVERNANCE_STATUS_LABELS, userGovernanceActionLabel } from "~/routes/admin/bans";
+import {
+  bulkUserGovernanceFeedback,
+  USER_GOVERNANCE_STATUS_LABELS,
+  userGovernanceActionLabel,
+} from "~/routes/admin/bans";
 import { USER_MANAGEMENT_GROUP_LABELS, userBlockActionLabel } from "~/routes/admin/users";
 
 describe("admin users action model", () => {
@@ -25,10 +29,18 @@ describe("admin users action model", () => {
   });
 
   it("validates bulk user governance input", () => {
-    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "unmute", ids: [1, "2"] }).success).toBe(true);
-    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "unblock", ids: [1] }).success).toBe(true);
-    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "mute", ids: [1] }).success).toBe(false);
-    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "unmute", ids: [] }).success).toBe(false);
+    expect(
+      adminUserBulkGovernanceBodySchema.safeParse({ action: "unmute", ids: [1, "2"] }).success,
+    ).toBe(true);
+    expect(
+      adminUserBulkGovernanceBodySchema.safeParse({ action: "unblock", ids: [1] }).success,
+    ).toBe(true);
+    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "mute", ids: [1] }).success).toBe(
+      false,
+    );
+    expect(adminUserBulkGovernanceBodySchema.safeParse({ action: "unmute", ids: [] }).success).toBe(
+      false,
+    );
   });
 
   it("separates mute and block labels in ban management", () => {
@@ -41,10 +53,12 @@ describe("admin users action model", () => {
   });
 
   it("identifies partial-success retry scope", () => {
-    expect(bulkUserGovernanceFeedback("解除禁言", {
-      processed: 2,
-      skipped_ids: [7, 9],
-    })).toEqual({
+    expect(
+      bulkUserGovernanceFeedback("解除禁言", {
+        processed: 2,
+        skipped_ids: [7, 9],
+      }),
+    ).toEqual({
       message: "解除禁言结果：成功 2 个，跳过 2 个，失败 0 个",
       description: "可重试目标：7、9",
     });
diff --git a/apps/web/tests/AsyncFeedback.test.tsx b/apps/web/tests/AsyncFeedback.test.tsx
index e739ae9..7812d24 100644
--- a/apps/web/tests/AsyncFeedback.test.tsx
+++ b/apps/web/tests/AsyncFeedback.test.tsx
@@ -1,7 +1,7 @@
 import { act, render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, MemoryRouter, RouterProvider } from "react-router";
-import { afterEach, describe, expect, it, vi } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vite-plus/test";
 import { TurnstileWidget } from "~/components/TurnstileWidget";
 import Search from "~/routes/search";
 
@@ -28,14 +28,11 @@ describe("异步反馈", () => {
       remove: vi.fn(),
       reset: vi.fn(),
     };
-    const router = createMemoryRouter(
-      [{ id: "root", path: "/", element: <TurnstileWidget /> }],
-      {
-        hydrationData: {
-          loaderData: { root: { publicConfig: { turnstileSiteKey: "site-key" } } },
-        },
+    const router = createMemoryRouter([{ id: "root", path: "/", element: <TurnstileWidget /> }], {
+      hydrationData: {
+        loaderData: { root: { publicConfig: { turnstileSiteKey: "site-key" } } },
       },
-    );
+    });
     render(<RouterProvider router={router} />);
 
     expect(await screen.findByRole("status")).toHaveTextContent("请完成人机验证");
diff --git a/apps/web/tests/AuthFormAccessibility.test.tsx b/apps/web/tests/AuthFormAccessibility.test.tsx
index e3e5e19..d3f3dfa 100644
--- a/apps/web/tests/AuthFormAccessibility.test.tsx
+++ b/apps/web/tests/AuthFormAccessibility.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { MemoryRouter } from "react-router";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import ResetPass from "~/routes/reset_pass";
 import SearchPass from "~/routes/search_pass";
 import Signin from "~/routes/signin";
diff --git a/apps/web/tests/DesignSystemGovernance.test.ts b/apps/web/tests/DesignSystemGovernance.test.ts
index b93cc6f..4d5bad9 100644
--- a/apps/web/tests/DesignSystemGovernance.test.ts
+++ b/apps/web/tests/DesignSystemGovernance.test.ts
@@ -1,6 +1,6 @@
 import { readFileSync, readdirSync } from "node:fs";
 import { extname, join, resolve } from "node:path";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 
 const webRoot = process.cwd();
 
@@ -30,15 +30,21 @@ describe("design system governance", () => {
     const routesRoot = resolve(webRoot, "app/routes");
     for (const file of sourceFiles(routesRoot)) {
       const source = readFileSync(file, "utf8");
-      expect(source, file).not.toMatch(/cnode-|surface-|brand-(?:ink|on)|shadow-(?:card|floating|brand)|space-[xy]-/);
-      expect(source, file).not.toMatch(/(?:bg|text|border|ring)-(?:red|blue|green|emerald|amber|orange|yellow|purple|pink|gray|slate|zinc|neutral)-\d/);
+      expect(source, file).not.toMatch(
+        /cnode-|surface-|brand-(?:ink|on)|shadow-(?:card|floating|brand)|space-[xy]-/,
+      );
+      expect(source, file).not.toMatch(
+        /(?:bg|text|border|ring)-(?:red|blue|green|emerald|amber|orange|yellow|purple|pink|gray|slate|zinc|neutral)-\d/,
+      );
       expect(source, file).not.toMatch(/rounded-(?:2xl|3xl|\[[^\]]+\])/);
     }
   });
 
   it("does not visually restyle core primitives from routes", () => {
-    const primitive = /<(?:Button|Input|Textarea|SelectTrigger|NativeSelect|Card|CardHeader|CardContent|Badge|TabsList|TableRow)\b[\s\S]*?>/g;
-    const visual = /className=(?:"[^"]*(?:\bbg-|\bborder-(?!collapse)|\bshadow-|\bring-|\brounded-|\bp[trblxy]?-)"|\{[^}]*(?:\bbg-|\bborder-|\bshadow-|\bring-|\brounded-|\bp[trblxy]?-)\})/;
+    const primitive =
+      /<(?:Button|Input|Textarea|SelectTrigger|NativeSelect|Card|CardHeader|CardContent|Badge|TabsList|TableRow)\b[\s\S]*?>/g;
+    const visual =
+      /className=(?:"[^"]*(?:\bbg-|\bborder-(?!collapse)|\bshadow-|\bring-|\brounded-|\bp[trblxy]?-)"|\{[^}]*(?:\bbg-|\bborder-|\bshadow-|\bring-|\brounded-|\bp[trblxy]?-)\})/;
     for (const file of sourceFiles(resolve(webRoot, "app/routes"))) {
       const source = readFileSync(file, "utf8");
       for (const tag of source.match(primitive) ?? []) {
diff --git a/apps/web/tests/LayoutNavigation.test.tsx b/apps/web/tests/LayoutNavigation.test.tsx
index 43f900d..91a5810 100644
--- a/apps/web/tests/LayoutNavigation.test.tsx
+++ b/apps/web/tests/LayoutNavigation.test.tsx
@@ -2,7 +2,7 @@ import { render, screen, waitFor, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, MemoryRouter, RouterProvider } from "react-router";
 import { renderToString } from "react-dom/server";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { Footer, Header, Layout } from "~/components/Layout";
 import { CommandPalette } from "~/components/CommandPalette";
 import { AdminLayout } from "~/components/AdminLayout";
@@ -10,21 +10,26 @@ import { AuthShell } from "~/components/AuthShell";
 import { CardHeader, CardTitle } from "~/components/ui/card";
 import { UserTabs } from "~/routes/user.$name";
 
-function renderWithRoot(element: React.ReactNode, initialEntry = "/", user: Record<string, boolean> | null = null) {
-  const router = createMemoryRouter(
-    [{ id: "root", path: "*", element }],
-    {
-      initialEntries: [initialEntry],
-      hydrationData: { loaderData: { root: { zones: [], user } } },
-    },
-  );
+function renderWithRoot(
+  element: React.ReactNode,
+  initialEntry = "/",
+  user: Record<string, boolean> | null = null,
+) {
+  const router = createMemoryRouter([{ id: "root", path: "*", element }], {
+    initialEntries: [initialEntry],
+    hydrationData: { loaderData: { root: { zones: [], user } } },
+  });
   return { ...render(<RouterProvider router={router} />), router };
 }
 
 describe("公开导航收束", () => {
   it("puts a focusable skip link before the public shell main landmark", async () => {
     const user = userEvent.setup();
-    renderWithRoot(<Layout><h1>测试页面</h1></Layout>);
+    renderWithRoot(
+      <Layout>
+        <h1>测试页面</h1>
+      </Layout>,
+    );
 
     const skipLink = screen.getByRole("link", { name: "跳到主要内容" });
     const main = screen.getByRole("main");
@@ -73,7 +78,9 @@ describe("公开导航收束", () => {
 
   it("routes each governance role only to an accessible admin destination", async () => {
     const user = userEvent.setup();
-    const moderator = renderWithRoot(<CommandPalette open onOpenChange={() => {}} />, "/", { is_mod: true });
+    const moderator = renderWithRoot(<CommandPalette open onOpenChange={() => {}} />, "/", {
+      is_mod: true,
+    });
     await user.click(screen.getByRole("option", { name: "内容管理" }));
     await waitFor(() => expect(moderator.router.state.location.pathname).toBe("/admin/topics"));
     expect(screen.queryByRole("option", { name: "管理后台" })).not.toBeInTheDocument();
@@ -102,21 +109,24 @@ describe("公开导航收束", () => {
     expect(await screen.findByRole("status")).toHaveTextContent("没有匹配的快捷命令");
   });
 
-  it.each([375, 1280])("allocates a non-overlapping search row and touch-safe close control at %ipx", (width) => {
-    window.innerWidth = width;
-    window.dispatchEvent(new Event("resize"));
-    const { container } = renderWithRoot(<CommandPalette open onOpenChange={() => {}} />);
-
-    const row = container.ownerDocument.querySelector('[data-slot="command-search-row"]')!;
-    const input = screen.getByRole("combobox", { name: "搜索命令" });
-    const close = screen.getByRole("button", { name: "关闭搜索面板" });
-    expect(row).toHaveClass("flex", "min-w-0");
-    expect(input.closest("form")).toHaveClass("min-w-0", "flex-1");
-    expect(close).toHaveClass("size-11", "shrink-0", "sm:size-8");
-    expect(close).not.toHaveClass("absolute");
-    expect(row.children).toContain(input.closest("form"));
-    expect(row.children).toContain(close);
-  });
+  it.each([375, 1280])(
+    "allocates a non-overlapping search row and touch-safe close control at %ipx",
+    (width) => {
+      window.innerWidth = width;
+      window.dispatchEvent(new Event("resize"));
+      const { container } = renderWithRoot(<CommandPalette open onOpenChange={() => {}} />);
+
+      const row = container.ownerDocument.querySelector('[data-slot="command-search-row"]')!;
+      const input = screen.getByRole("combobox", { name: "搜索命令" });
+      const close = screen.getByRole("button", { name: "关闭搜索面板" });
+      expect(row).toHaveClass("flex", "min-w-0");
+      expect(input.closest("form")).toHaveClass("min-w-0", "flex-1");
+      expect(close).toHaveClass("size-11", "shrink-0", "sm:size-8");
+      expect(close).not.toHaveClass("absolute");
+      expect(row.children).toContain(input.closest("form"));
+      expect(row.children).toContain(close);
+    },
+  );
 
   it("returns focus to the header trigger after Escape", async () => {
     const user = userEvent.setup();
@@ -150,14 +160,23 @@ describe("公开导航收束", () => {
 
     expect(screen.getAllByRole("link", { name: "了解社区" })[0]).toHaveAttribute("href", "/about");
     const community = screen.getByText("社区").parentElement!;
-    expect(within(community).getByRole("link", { name: "用户排行" })).toHaveAttribute("href", "/users/top100");
-    expect(within(community).getByRole("link", { name: "精华话题" })).toHaveAttribute("href", "/stars");
+    expect(within(community).getByRole("link", { name: "用户排行" })).toHaveAttribute(
+      "href",
+      "/users/top100",
+    );
+    expect(within(community).getByRole("link", { name: "精华话题" })).toHaveAttribute(
+      "href",
+      "/stars",
+    );
     const resources = screen.getByText("资源").parentElement!;
     expect(within(resources).getByRole("link", { name: "API" })).toHaveAttribute("href", "/api");
     expect(within(resources).getByRole("link", { name: "RSS" })).toHaveAttribute("href", "/rss");
     const developer = screen.getByText("开发者").parentElement!;
     expect(within(developer).getAllByRole("link")).toHaveLength(1);
-    expect(within(developer).getByRole("link", { name: "GitHub" })).toHaveAttribute("rel", "noopener noreferrer");
+    expect(within(developer).getByRole("link", { name: "GitHub" })).toHaveAttribute(
+      "rel",
+      "noopener noreferrer",
+    );
     expect(screen.queryByText("RSS 订阅")).not.toBeInTheDocument();
     expect(screen.queryByText("新手指南")).not.toBeInTheDocument();
     expect(screen.queryByText("FAQ")).not.toBeInTheDocument();
@@ -171,7 +190,17 @@ describe("Shell landmark 与标题", () => {
   it("provides the same skip target in the admin shell", async () => {
     const user = userEvent.setup();
     const router = createMemoryRouter(
-      [{ id: "root", path: "/admin", element: <AdminLayout><h1>后台页面</h1></AdminLayout> }],
+      [
+        {
+          id: "root",
+          path: "/admin",
+          element: (
+            <AdminLayout>
+              <h1>后台页面</h1>
+            </AdminLayout>
+          ),
+        },
+      ],
       {
         initialEntries: ["/admin"],
         hydrationData: { loaderData: { root: { zones: [], user: null } } },
@@ -187,7 +216,17 @@ describe("Shell landmark 与标题", () => {
 
   it("server-renders the contained admin navigation shell", () => {
     const router = createMemoryRouter(
-      [{ id: "root", path: "*", element: <AdminLayout><h1>话题管理</h1></AdminLayout> }],
+      [
+        {
+          id: "root",
+          path: "*",
+          element: (
+            <AdminLayout>
+              <h1>话题管理</h1>
+            </AdminLayout>
+          ),
+        },
+      ],
       {
         initialEntries: ["/admin/topics"],
         hydrationData: { loaderData: { root: { zones: [], user: null } } },
@@ -206,7 +245,11 @@ describe("Shell landmark 与标题", () => {
     render(
       <MemoryRouter>
         <AuthShell eyebrow="WELCOME" title="回到社区" description="登录说明">
-          <CardHeader><CardTitle><h2>登录</h2></CardTitle></CardHeader>
+          <CardHeader>
+            <CardTitle>
+              <h2>登录</h2>
+            </CardTitle>
+          </CardHeader>
         </AuthShell>
       </MemoryRouter>,
     );
@@ -219,7 +262,17 @@ describe("Shell landmark 与标题", () => {
 describe("导航当前项", () => {
   it("uses the contained navigation structure and keeps one destination current with a query string", () => {
     const router = createMemoryRouter(
-      [{ id: "root", path: "*", element: <AdminLayout><h1>话题管理</h1></AdminLayout> }],
+      [
+        {
+          id: "root",
+          path: "*",
+          element: (
+            <AdminLayout>
+              <h1>话题管理</h1>
+            </AdminLayout>
+          ),
+        },
+      ],
       {
         initialEntries: ["/admin/topics?status=open&page=2"],
         hydrationData: { loaderData: { root: { zones: [], user: null } } },
@@ -227,12 +280,17 @@ describe("导航当前项", () => {
     );
     const { container } = render(<RouterProvider router={router} />);
     const navigation = screen.getByRole("navigation", { name: "后台导航" });
-    expect(within(navigation).getByRole("link", { name: "话题管理" })).toHaveAttribute("aria-current", "page");
+    expect(within(navigation).getByRole("link", { name: "话题管理" })).toHaveAttribute(
+      "aria-current",
+      "page",
+    );
     expect(within(navigation).getAllByRole("link")).toHaveLength(3);
     expect(within(navigation).queryByRole("link", { name: "概览" })).not.toBeInTheDocument();
     expect(within(navigation).queryByRole("link", { name: "用户管理" })).not.toBeInTheDocument();
     expect(container.querySelector("[data-admin-shell]")).toBeInTheDocument();
-    expect(container.querySelector('[data-slot="card"] nav[aria-label="后台导航"]')).toBeInTheDocument();
+    expect(
+      container.querySelector('[data-slot="card"] nav[aria-label="后台导航"]'),
+    ).toBeInTheDocument();
   });
 
   it("opens the shared navigation in the mobile Sheet", async () => {
@@ -240,7 +298,17 @@ describe("导航当前项", () => {
     const desktopWidth = window.innerWidth;
     window.innerWidth = 375;
     const router = createMemoryRouter(
-      [{ id: "root", path: "*", element: <AdminLayout><h1>话题管理</h1></AdminLayout> }],
+      [
+        {
+          id: "root",
+          path: "*",
+          element: (
+            <AdminLayout>
+              <h1>话题管理</h1>
+            </AdminLayout>
+          ),
+        },
+      ],
       {
         initialEntries: ["/admin/topics?status=open"],
         hydrationData: { loaderData: { root: { zones: [], user: null } } },
@@ -251,7 +319,10 @@ describe("导航当前项", () => {
     await user.click(screen.getByRole("button", { name: "打开后台导航" }));
     const dialog = await screen.findByRole("dialog", { name: "后台导航" });
     const navigation = within(dialog).getByRole("navigation", { name: "后台导航" });
-    expect(within(navigation).getByRole("link", { name: "话题管理" })).toHaveAttribute("aria-current", "page");
+    expect(within(navigation).getByRole("link", { name: "话题管理" })).toHaveAttribute(
+      "aria-current",
+      "page",
+    );
 
     view.unmount();
     window.innerWidth = desktopWidth;
diff --git a/apps/web/tests/MarkdownEditor.test.tsx b/apps/web/tests/MarkdownEditor.test.tsx
index 423f34a..8bc9dbb 100644
--- a/apps/web/tests/MarkdownEditor.test.tsx
+++ b/apps/web/tests/MarkdownEditor.test.tsx
@@ -1,6 +1,6 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import { MarkdownEditor } from "~/components/MarkdownEditor";
 
 vi.mock("~/lib/upload-client", () => ({
@@ -30,7 +30,9 @@ describe("MarkdownEditor", () => {
   it("inserts Markdown around the current selection", async () => {
     const onChange = vi.fn();
     render(<MarkdownEditor value="hello world" onChange={onChange} />);
-    const textarea = screen.getByRole("textbox", { name: "支持 Markdown 格式" }) as HTMLTextAreaElement;
+    const textarea = screen.getByRole("textbox", {
+      name: "支持 Markdown 格式",
+    }) as HTMLTextAreaElement;
 
     textarea.focus();
     textarea.setSelectionRange(6, 11);
@@ -48,7 +50,10 @@ describe("MarkdownEditor", () => {
     const onChange = vi.fn();
     render(<MarkdownEditor value="正文" onChange={onChange} />);
     const file = new File(["png"], "avatar.png", { type: "image/png" });
-    expect(screen.getByLabelText("上传图片文件")).toHaveAttribute("accept", expect.stringContaining("image/svg+xml"));
+    expect(screen.getByLabelText("上传图片文件")).toHaveAttribute(
+      "accept",
+      expect.stringContaining("image/svg+xml"),
+    );
 
     await userEvent.upload(screen.getByLabelText("上传图片文件"), file);
 
diff --git a/apps/web/tests/MarkdownView.test.tsx b/apps/web/tests/MarkdownView.test.tsx
index cf8199f..86b94c8 100644
--- a/apps/web/tests/MarkdownView.test.tsx
+++ b/apps/web/tests/MarkdownView.test.tsx
@@ -1,6 +1,6 @@
 import { fireEvent, render, screen, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { renderToString } from "react-dom/server";
 import { MarkdownView } from "~/components/MarkdownView";
 
@@ -50,7 +50,9 @@ describe("MarkdownView", () => {
 
     expect(looseItem).not.toBeNull();
     expect(within(looseItem!).getByText("quote in list")).toBeInTheDocument();
-    expect(looseItem!.querySelector("pre code")).toHaveTextContent('const message = "long content";');
+    expect(looseItem!.querySelector("pre code")).toHaveTextContent(
+      'const message = "long content";',
+    );
     expect(container.querySelector("ol")).toBeInTheDocument();
   });
 
@@ -60,7 +62,10 @@ describe("MarkdownView", () => {
     );
 
     expect(container.querySelector("script")).not.toBeInTheDocument();
-    expect(screen.getByText("unsafe")).not.toHaveAttribute("href", expect.stringContaining("javascript:"));
+    expect(screen.getByText("unsafe")).not.toHaveAttribute(
+      "href",
+      expect.stringContaining("javascript:"),
+    );
   });
 
   it("renders a lazy image without leaking the Markdown AST node", () => {
@@ -76,11 +81,19 @@ describe("MarkdownView", () => {
     render(<MarkdownView content="![architecture](https://example.com/missing.png)" />);
     fireEvent.error(screen.getByRole("img", { name: "architecture" }));
 
-    expect(screen.getByRole("group", { name: "architecture加载失败" })).toHaveTextContent("图片暂时无法加载：architecture");
+    expect(screen.getByRole("group", { name: "architecture加载失败" })).toHaveTextContent(
+      "图片暂时无法加载：architecture",
+    );
     expect(screen.queryByRole("img")).not.toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "打开原图" })).toHaveAttribute("href", "https://example.com/missing.png");
+    expect(screen.getByRole("link", { name: "打开原图" })).toHaveAttribute(
+      "href",
+      "https://example.com/missing.png",
+    );
     expect(screen.getByRole("link", { name: "打开原图" })).toHaveAttribute("target", "_blank");
-    expect(screen.getByRole("link", { name: "打开原图" })).toHaveAttribute("rel", "noopener noreferrer");
+    expect(screen.getByRole("link", { name: "打开原图" })).toHaveAttribute(
+      "rel",
+      "noopener noreferrer",
+    );
   });
 
   it("retries only after a manual action and can recover", async () => {
@@ -102,9 +115,7 @@ describe("MarkdownView", () => {
   });
 
   it("resets failure state when the image source changes", () => {
-    const { rerender } = render(
-      <MarkdownView content="![diagram](https://example.com/old.png)" />,
-    );
+    const { rerender } = render(<MarkdownView content="![diagram](https://example.com/old.png)" />);
     fireEvent.error(screen.getByRole("img", { name: "diagram" }));
 
     rerender(<MarkdownView content="![diagram](https://example.com/new.png)" />);
@@ -124,7 +135,13 @@ describe("MarkdownView", () => {
   });
 
   it("uses a useful fallback for missing alt and keeps unsafe image URLs sanitized", () => {
-    const { container } = render(<MarkdownView content={'![](https://example.com/image.png)\n\n<img src="javascript:alert(1)" alt="unsafe">'} />);
+    const { container } = render(
+      <MarkdownView
+        content={
+          '![](https://example.com/image.png)\n\n<img src="javascript:alert(1)" alt="unsafe">'
+        }
+      />,
+    );
     const image = screen.getByRole("img", { name: "文章图片" });
     fireEvent.error(image);
 
@@ -145,7 +162,9 @@ describe("MarkdownView", () => {
 
   it("assigns semantic ids to persisted HTML headings", () => {
     const html = renderToString(
-      <MarkdownView content={'<h2 id="legacy">创建数据库</h2>\r\n<h2>编写接口</h2>\r\n<h2>创建数据库</h2>'} />,
+      <MarkdownView
+        content={'<h2 id="legacy">创建数据库</h2>\r\n<h2>编写接口</h2>\r\n<h2>创建数据库</h2>'}
+      />,
     );
 
     expect(html).toContain('id="创建数据库"');
diff --git a/apps/web/tests/MessageSummary.test.ts b/apps/web/tests/MessageSummary.test.ts
index ef545b9..f7db9b5 100644
--- a/apps/web/tests/MessageSummary.test.ts
+++ b/apps/web/tests/MessageSummary.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { messageContentSummary } from "@cnode/shared";
 
 describe("messageContentSummary", () => {
diff --git a/apps/web/tests/Messages.test.tsx b/apps/web/tests/Messages.test.tsx
index c100588..796c1ff 100644
--- a/apps/web/tests/Messages.test.tsx
+++ b/apps/web/tests/Messages.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import Messages, { loader } from "~/routes/my.messages";
 
 const mocks = vi.hoisted(() => ({
@@ -13,7 +13,9 @@ const mocks = vi.hoisted(() => ({
 
 vi.mock("~/lib/api-client", () => ({ apiFetch: mocks.apiFetch }));
 vi.mock("~/lib/auth", () => ({ requireUser: mocks.requireUser }));
-vi.mock("~/components/Layout", () => ({ Layout: ({ children }: { children: React.ReactNode }) => children }));
+vi.mock("~/components/Layout", () => ({
+  Layout: ({ children }: { children: React.ReactNode }) => children,
+}));
 vi.mock("~/lib/stores/auth-store", () => ({
   useAuthStore: (selector: (state: Record<string, unknown>) => unknown) =>
     selector({ fetchUnread: mocks.fetchUnread, setUnreadCount: mocks.setUnreadCount }),
@@ -58,7 +60,9 @@ describe("messages page", () => {
       data: { has_read_messages: [], hasnot_read_messages: [] },
     });
 
-    await loader({ request: new Request("http://localhost/my/messages", { headers: { cookie: "session=1" } }) } as never);
+    await loader({
+      request: new Request("http://localhost/my/messages", { headers: { cookie: "session=1" } }),
+    } as never);
 
     expect(mocks.apiFetch).toHaveBeenCalledWith("/api/v1/messages?mdrender=false", {
       headers: { cookie: "session=1" },
@@ -86,10 +90,7 @@ describe("messages page", () => {
   });
 
   it("omits empty summaries and limits long content", () => {
-    renderMessages(
-      [makeMessage("empty", "   ", true)],
-      [makeMessage("long", "字".repeat(170))],
-    );
+    renderMessages([makeMessage("empty", "   ", true)], [makeMessage("long", "字".repeat(170))]);
 
     expect(document.querySelectorAll('[data-slot="item-description"]')).toHaveLength(1);
     expect(messageGroup("新消息").getByText(`${"字".repeat(160)}…`)).toBeInTheDocument();
@@ -102,7 +103,9 @@ describe("messages page", () => {
     expect(messageGroup("新消息").getByText("不错哦")).toBeInTheDocument();
     await userEvent.click(messageGroup("新消息").getByRole("button", { name: "标记已读" }));
 
-    await waitFor(() => expect(messageGroup("新消息").queryByText("不错哦")).not.toBeInTheDocument());
+    await waitFor(() =>
+      expect(messageGroup("新消息").queryByText("不错哦")).not.toBeInTheDocument(),
+    );
     expect(messageGroup("过往消息").getByText("不错哦")).toBeInTheDocument();
     expect(screen.queryByText(/<p>|<\/p>/)).not.toBeInTheDocument();
   });
diff --git a/apps/web/tests/Pagination.test.tsx b/apps/web/tests/Pagination.test.tsx
index 238e97c..13c9ab0 100644
--- a/apps/web/tests/Pagination.test.tsx
+++ b/apps/web/tests/Pagination.test.tsx
@@ -1,6 +1,6 @@
 import { render, screen } from "@testing-library/react";
 import { MemoryRouter } from "react-router";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { Pagination } from "~/components/Pagination";
 
 describe("Pagination", () => {
@@ -38,8 +38,14 @@ describe("Pagination", () => {
     }
     expect(screen.getByRole("link", { name: "1" })).toBeInTheDocument();
     expect(screen.getByRole("link", { name: "12" })).toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "上一页" })).toHaveAttribute("href", "/zone/jobs?page=5");
-    expect(screen.getByRole("link", { name: "下一页" })).toHaveAttribute("href", "/zone/jobs?page=7");
+    expect(screen.getByRole("link", { name: "上一页" })).toHaveAttribute(
+      "href",
+      "/zone/jobs?page=5",
+    );
+    expect(screen.getByRole("link", { name: "下一页" })).toHaveAttribute(
+      "href",
+      "/zone/jobs?page=7",
+    );
   });
 
   it("renders simple pagination without page numbers", () => {
diff --git a/apps/web/tests/PostMutationNavigation.test.ts b/apps/web/tests/PostMutationNavigation.test.ts
index b4ae0a8..9b3d768 100644
--- a/apps/web/tests/PostMutationNavigation.test.ts
+++ b/apps/web/tests/PostMutationNavigation.test.ts
@@ -1,19 +1,37 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { previousPageAfterRemoval } from "~/lib/post-mutation-navigation";
 
 describe("治理后分页上下文", () => {
   it("preserves filters while moving an emptied page backward", () => {
-    expect(previousPageAfterRemoval({
-      pathname: "/admin/topics",
-      search: "?q=node&visibility=deleted&page=3&sort=update_at_desc",
-      page: 3,
-      currentItemCount: 2,
-      removedCount: 2,
-    })).toBe("/admin/topics?q=node&visibility=deleted&page=2&sort=update_at_desc");
+    expect(
+      previousPageAfterRemoval({
+        pathname: "/admin/topics",
+        search: "?q=node&visibility=deleted&page=3&sort=update_at_desc",
+        page: 3,
+        currentItemCount: 2,
+        removedCount: 2,
+      }),
+    ).toBe("/admin/topics?q=node&visibility=deleted&page=2&sort=update_at_desc");
   });
 
   it("stays on the current URL when results remain or already on page one", () => {
-    expect(previousPageAfterRemoval({ pathname: "/admin/users", search: "?q=a&page=2", page: 2, currentItemCount: 4, removedCount: 1 })).toBeNull();
-    expect(previousPageAfterRemoval({ pathname: "/admin/users", search: "?q=a&page=1", page: 1, currentItemCount: 1, removedCount: 1 })).toBeNull();
+    expect(
+      previousPageAfterRemoval({
+        pathname: "/admin/users",
+        search: "?q=a&page=2",
+        page: 2,
+        currentItemCount: 4,
+        removedCount: 1,
+      }),
+    ).toBeNull();
+    expect(
+      previousPageAfterRemoval({
+        pathname: "/admin/users",
+        search: "?q=a&page=1",
+        page: 1,
+        currentItemCount: 1,
+        removedCount: 1,
+      }),
+    ).toBeNull();
   });
 });
diff --git a/apps/web/tests/PrimitiveMigrationBaseline.test.tsx b/apps/web/tests/PrimitiveMigrationBaseline.test.tsx
index e1c1ced..1b5277d 100644
--- a/apps/web/tests/PrimitiveMigrationBaseline.test.tsx
+++ b/apps/web/tests/PrimitiveMigrationBaseline.test.tsx
@@ -2,7 +2,7 @@ import { render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { renderToString } from "react-dom/server";
 import { useRef, useState } from "react";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import { Button } from "~/components/ui/button";
 import { Checkbox } from "~/components/ui/checkbox";
 import { Input } from "~/components/ui/input";
@@ -24,11 +24,7 @@ import { Sheet, SheetContent, SheetTitle } from "~/components/ui/sheet";
 
 describe("primitive migration baseline", () => {
   it("composes a Button with one semantic link", () => {
-    render(
-      <Button render={<a href="/about" />}>
-        关于
-      </Button>,
-    );
+    render(<Button render={<a href="/about" />}>关于</Button>);
 
     const link = screen.getByRole("link", { name: "关于" });
     expect(link).toHaveAttribute("href", "/about");
@@ -151,7 +147,10 @@ describe("primitive migration baseline", () => {
     );
 
     expect(screen.getByRole("textbox", { name: "无效字段" })).toBeDisabled();
-    expect(screen.getByRole("textbox", { name: "无效字段" })).toHaveAttribute("aria-invalid", "true");
+    expect(screen.getByRole("textbox", { name: "无效字段" })).toHaveAttribute(
+      "aria-invalid",
+      "true",
+    );
     expect(screen.getByRole("button", { name: "不可操作" })).toBeDisabled();
   });
 
@@ -197,9 +196,7 @@ describe("primitive migration baseline", () => {
   it("renders deterministic primitive structure during SSR", () => {
     const html = renderToString(
       <div>
-        <Button render={<a href="/about" />}>
-          关于
-        </Button>
+        <Button render={<a href="/about" />}>关于</Button>
         <Checkbox name="selected" aria-label="选择话题" />
       </div>,
     );
diff --git a/apps/web/tests/RoutesConfig.test.ts b/apps/web/tests/RoutesConfig.test.ts
index 6647f1c..558dc23 100644
--- a/apps/web/tests/RoutesConfig.test.ts
+++ b/apps/web/tests/RoutesConfig.test.ts
@@ -1,5 +1,5 @@
 import { matchRoutes } from "react-router";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import routes from "../app/routes";
 
 describe("Web route surface", () => {
@@ -15,6 +15,8 @@ describe("Web route surface", () => {
     expect(matchRoutes(routes as any, "/user/alice")?.at(-1)?.params.name).toBe("alice");
     expect(matchRoutes(routes as any, "/user/alice/topics")?.at(-1)?.params.name).toBe("alice");
     expect(matchRoutes(routes as any, "/user/alice/replies")?.at(-1)?.params.name).toBe("alice");
-    expect(matchRoutes(routes as any, "/user/alice/collections")?.at(-1)?.params.name).toBe("alice");
+    expect(matchRoutes(routes as any, "/user/alice/collections")?.at(-1)?.params.name).toBe(
+      "alice",
+    );
   });
 });
diff --git a/apps/web/tests/RssRoute.test.ts b/apps/web/tests/RssRoute.test.ts
index 25f5418..adcbdfe 100644
--- a/apps/web/tests/RssRoute.test.ts
+++ b/apps/web/tests/RssRoute.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { buildRssXml } from "~/routes/rss";
 
 describe("rss route", () => {
@@ -22,11 +22,15 @@ describe("rss route", () => {
 
     expect(xml).toContain('xmlns:atom="http://www.w3.org/2005/Atom"');
     expect(xml).toContain('xmlns:dc="http://purl.org/dc/elements/1.1/"');
-    expect(xml).toContain('<atom:link href="https://cnodejs.org/rss" rel="self" type="application/rss+xml" />');
+    expect(xml).toContain(
+      '<atom:link href="https://cnodejs.org/rss" rel="self" type="application/rss+xml" />',
+    );
     expect(xml).toContain("<item>");
     expect(xml).toContain("A &lt;B&gt; &amp; C");
-    expect(xml).toContain('&lt;a href=&quot;https://cnodejs.org/topic/1&quot;&gt;Hello &amp; welcome&lt;/a&gt;');
-    expect(xml).toContain('src=&quot;https://cnodejs.org/avatar.png&quot;');
+    expect(xml).toContain(
+      "&lt;a href=&quot;https://cnodejs.org/topic/1&quot;&gt;Hello &amp; welcome&lt;/a&gt;",
+    );
+    expect(xml).toContain("src=&quot;https://cnodejs.org/avatar.png&quot;");
     expect(xml).toContain("<dc:creator>foo</dc:creator>");
     expect(xml).not.toContain("<author>foo</author>");
   });
diff --git a/apps/web/tests/Seo.test.ts b/apps/web/tests/Seo.test.ts
index d94021c..8774af6 100644
--- a/apps/web/tests/Seo.test.ts
+++ b/apps/web/tests/Seo.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { getAvatarUrl } from "~/lib/brand";
 import {
   DEFAULT_OG_IMAGE,
@@ -10,15 +10,28 @@ import {
 
 describe("SEO metadata", () => {
   it("builds canonical Open Graph and Twitter metadata", () => {
-    const meta = seoMeta({ title: "测试 · CNode", description: "测试描述", path: "/topic/1", type: "article" });
-    expect(meta).toContainEqual({ tagName: "link", rel: "canonical", href: "https://cnodejs.org/topic/1" });
+    const meta = seoMeta({
+      title: "测试 · CNode",
+      description: "测试描述",
+      path: "/topic/1",
+      type: "article",
+    });
+    expect(meta).toContainEqual({
+      tagName: "link",
+      rel: "canonical",
+      href: "https://cnodejs.org/topic/1",
+    });
     expect(meta).toContainEqual({ property: "og:image", content: DEFAULT_OG_IMAGE });
     expect(meta).toContainEqual({ name: "twitter:card", content: "summary_large_image" });
   });
 
   it("cleans Markdown and extracts only secure images", () => {
-    expect(markdownExcerpt("# 标题\n\n[链接](https://example.com) **正文**")).toBe("标题 链接 正文");
-    expect(firstMarkdownImage("![图](https://static.example.com/a.png)")).toBe("https://static.example.com/a.png");
+    expect(markdownExcerpt("# 标题\n\n[链接](https://example.com) **正文**")).toBe(
+      "标题 链接 正文",
+    );
+    expect(firstMarkdownImage("![图](https://static.example.com/a.png)")).toBe(
+      "https://static.example.com/a.png",
+    );
     expect(firstMarkdownImage("![图](http://static.example.com/a.png)")).toBeNull();
   });
 
@@ -42,9 +55,11 @@ describe("SEO metadata", () => {
 
 describe("avatar metadata safety", () => {
   it("upgrades legacy Gravatar URLs without rewriting unrelated hosts", () => {
-    expect(getAvatarUrl("http://www.gravatar.com/avatar/hash?size=48"))
-      .toBe("https://www.gravatar.com/avatar/hash?size=48");
-    expect(getAvatarUrl("http://images.example.com/avatar.png"))
-      .toBe("http://images.example.com/avatar.png");
+    expect(getAvatarUrl("http://www.gravatar.com/avatar/hash?size=48")).toBe(
+      "https://www.gravatar.com/avatar/hash?size=48",
+    );
+    expect(getAvatarUrl("http://images.example.com/avatar.png")).toBe(
+      "http://images.example.com/avatar.png",
+    );
   });
 });
diff --git a/apps/web/tests/SettingGithubLinking.test.tsx b/apps/web/tests/SettingGithubLinking.test.tsx
index 22ea201..7cccf6c 100644
--- a/apps/web/tests/SettingGithubLinking.test.tsx
+++ b/apps/web/tests/SettingGithubLinking.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import Setting from "~/routes/setting";
 
 const { apiFetch } = vi.hoisted(() => ({ apiFetch: vi.fn() }));
@@ -44,10 +44,11 @@ describe("设置页 GitHub 账号身份", () => {
     expect(screen.getByText("octocat")).toBeInTheDocument();
     expect(screen.getByText("已绑定")).toBeInTheDocument();
     expect(screen.getByRole("button", { name: "解除绑定" })).toBeInTheDocument();
-    expect(screen.getByRole("checkbox", { name: "有人回复我的话题时邮件通知" }).closest('[data-slot="field"]')).toHaveAttribute(
-      "data-orientation",
-      "horizontal",
-    );
+    expect(
+      screen
+        .getByRole("checkbox", { name: "有人回复我的话题时邮件通知" })
+        .closest('[data-slot="field"]'),
+    ).toHaveAttribute("data-orientation", "horizontal");
   });
 
   it("shows the unbound state and bind action in the same GitHub row", () => {
diff --git a/apps/web/tests/SharedPrimitives.test.tsx b/apps/web/tests/SharedPrimitives.test.tsx
index 0edbcc6..9d75b84 100644
--- a/apps/web/tests/SharedPrimitives.test.tsx
+++ b/apps/web/tests/SharedPrimitives.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import { Alert, AlertDescription, AlertTitle } from "~/components/ui/alert";
 import {
   AlertDialog,
@@ -17,7 +17,13 @@ import { Empty, EmptyDescription, EmptyHeader, EmptyTitle } from "~/components/u
 import { NativeSelect } from "~/components/ui/native-select";
 import { Pagination } from "~/components/Pagination";
 import { RadioGroup, RadioGroupItem } from "~/components/ui/radio-group";
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "~/components/ui/select";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "~/components/ui/select";
 import { Textarea } from "~/components/ui/textarea";
 
 function renderWithRouter(element: React.ReactNode) {
@@ -49,10 +55,12 @@ describe("shared primitives", () => {
         <Textarea id="note" name="note" defaultValue="hello" />
         <RadioGroup name="visibility" defaultValue="public" aria-label="可见性">
           <label className="flex items-center gap-2">
-            <RadioGroupItem value="public" />公开
+            <RadioGroupItem value="public" />
+            公开
           </label>
           <label className="flex items-center gap-2">
-            <RadioGroupItem value="private" />私有
+            <RadioGroupItem value="private" />
+            私有
           </label>
         </RadioGroup>
         <button type="submit">提交</button>
@@ -61,7 +69,11 @@ describe("shared primitives", () => {
 
     await operator.click(screen.getByRole("button", { name: "提交" }));
 
-    expect(submit.mock.results[0]?.value).toEqual({ tab: "share", note: "hello", visibility: "public" });
+    expect(submit.mock.results[0]?.value).toEqual({
+      tab: "share",
+      note: "hello",
+      visibility: "public",
+    });
   });
 
   it("submits the selected Base Select value through a native form", async () => {
@@ -76,12 +88,16 @@ describe("shared primitives", () => {
         <label htmlFor="topic-tab">分类</label>
         <Select name="tab" defaultValue="share">
           <SelectTrigger id="topic-tab">
-            <SelectValue>{(value) => ({ share: "分享", ask: "问答", job: "招聘" })[value as string] ?? value}</SelectValue>
+            <SelectValue>
+              {(value) => ({ share: "分享", ask: "问答", job: "招聘" })[value as string] ?? value}
+            </SelectValue>
           </SelectTrigger>
           <SelectContent>
             <SelectItem value="share">分享</SelectItem>
             <SelectItem value="ask">问答</SelectItem>
-            <SelectItem value="job" disabled>招聘（需要授权）</SelectItem>
+            <SelectItem value="job" disabled>
+              招聘（需要授权）
+            </SelectItem>
           </SelectContent>
         </Select>
         <button type="submit">提交</button>
@@ -113,12 +129,21 @@ describe("shared primitives", () => {
 
   it("keeps domain pagination URL generation and current-page semantics", () => {
     renderWithRouter(
-      <Pagination page={3} total={100} limit={10} basePath="/topics" searchParams={{ tab: "share" }} />,
+      <Pagination
+        page={3}
+        total={100}
+        limit={10}
+        basePath="/topics"
+        searchParams={{ tab: "share" }}
+      />,
     );
 
     expect(screen.getByRole("navigation", { name: "分页导航" })).toBeInTheDocument();
     expect(screen.getByRole("link", { current: "page" })).toHaveTextContent("3");
-    expect(screen.getByRole("link", { name: "上一页" })).toHaveAttribute("href", "/topics?tab=share&page=2");
+    expect(screen.getByRole("link", { name: "上一页" })).toHaveAttribute(
+      "href",
+      "/topics?tab=share&page=2",
+    );
   });
 
   it("renders branded empty and command empty states", () => {
diff --git a/apps/web/tests/Sidebar.test.tsx b/apps/web/tests/Sidebar.test.tsx
index 7a41c74..919c085 100644
--- a/apps/web/tests/Sidebar.test.tsx
+++ b/apps/web/tests/Sidebar.test.tsx
@@ -1,6 +1,6 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import { MemoryRouter } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import { Sidebar } from "~/components/Sidebar";
 
 const mocks = vi.hoisted(() => ({ apiFetch: vi.fn() }));
@@ -34,19 +34,30 @@ describe("home Sidebar", () => {
 
     const sidebar = container.querySelector("aside")!;
     expect(sidebar).toHaveClass("gap-5", "md:gap-6");
-    expect(screen.getByRole("link", { name: "了解合作方式" })).toHaveAttribute("href", "/about#cooperation");
+    expect(screen.getByRole("link", { name: "了解合作方式" })).toHaveAttribute(
+      "href",
+      "/about#cooperation",
+    );
 
     const latestReplies = await screen.findByText("最新回复");
     const leaderboard = screen.getByText("积分榜");
     const unanswered = screen.getByText("无人回复的话题");
 
-    expect(latestReplies.compareDocumentPosition(leaderboard) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
-    expect(leaderboard.compareDocumentPosition(unanswered) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
+    expect(
+      latestReplies.compareDocumentPosition(leaderboard) & Node.DOCUMENT_POSITION_FOLLOWING,
+    ).toBeTruthy();
+    expect(
+      leaderboard.compareDocumentPosition(unanswered) & Node.DOCUMENT_POSITION_FOLLOWING,
+    ).toBeTruthy();
   });
 
   it("uses the same top-level rhythm while skeleton cards are replaced", async () => {
     let resolveRequest!: (value: { success: boolean; data: typeof sidebarData }) => void;
-    mocks.apiFetch.mockReturnValue(new Promise((resolve) => { resolveRequest = resolve; }));
+    mocks.apiFetch.mockReturnValue(
+      new Promise((resolve) => {
+        resolveRequest = resolve;
+      }),
+    );
     const { container } = render(
       <MemoryRouter>
         <Sidebar />
@@ -61,10 +72,14 @@ describe("home Sidebar", () => {
     resolveRequest({ success: true, data: sidebarData });
     await screen.findByText("最新回复");
 
-    await waitFor(() => expect(sidebar.querySelector('[data-slot="skeleton"]')).not.toBeInTheDocument());
+    await waitFor(() =>
+      expect(sidebar.querySelector('[data-slot="skeleton"]')).not.toBeInTheDocument(),
+    );
     expect(sidebar.querySelectorAll(":scope > [data-slot=card]")).toHaveLength(5);
     expect(
-      Array.from(sidebar.querySelectorAll('[data-slot="card-title"]')).map((title) => title.textContent?.trim()),
+      Array.from(sidebar.querySelectorAll('[data-slot="card-title"]')).map((title) =>
+        title.textContent?.trim(),
+      ),
     ).toEqual(["社区合作", "最新回复", "积分榜", "无人回复的话题", "生态资源"]);
   });
 });
diff --git a/apps/web/tests/ThemeContrast.test.ts b/apps/web/tests/ThemeContrast.test.ts
index c3d1b7d..07f287d 100644
--- a/apps/web/tests/ThemeContrast.test.ts
+++ b/apps/web/tests/ThemeContrast.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 
 type Pair = [name: string, foreground: string, background: string, minimum: number];
 
@@ -40,7 +40,10 @@ function contrast(foreground: string, background: string) {
 }
 
 describe("theme token contrast", () => {
-  it.each([...lightPairs, ...darkPairs])("keeps %s above WCAG minimum", (_name, foreground, background, minimum) => {
-    expect(contrast(foreground, background)).toBeGreaterThanOrEqual(minimum);
-  });
+  it.each([...lightPairs, ...darkPairs])(
+    "keeps %s above WCAG minimum",
+    (_name, foreground, background, minimum) => {
+      expect(contrast(foreground, background)).toBeGreaterThanOrEqual(minimum);
+    },
+  );
 });
diff --git a/apps/web/tests/ThemeSystem.test.ts b/apps/web/tests/ThemeSystem.test.ts
index ce9a4e6..93915a6 100644
--- a/apps/web/tests/ThemeSystem.test.ts
+++ b/apps/web/tests/ThemeSystem.test.ts
@@ -1,4 +1,4 @@
-import { afterEach, describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it } from "vite-plus/test";
 import { applyResolvedTheme } from "~/lib/stores/theme-store";
 
 describe("theme system integration", () => {
diff --git a/apps/web/tests/ThemeTokens.test.ts b/apps/web/tests/ThemeTokens.test.ts
index 74d2fd1..64d2118 100644
--- a/apps/web/tests/ThemeTokens.test.ts
+++ b/apps/web/tests/ThemeTokens.test.ts
@@ -1,18 +1,43 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 
 const css = readFileSync(resolve(process.cwd(), "app/styles/global.css"), "utf8");
 
 describe("Base Nova semantic theme", () => {
   it("declares complete core, chart and sidebar token families", () => {
     for (const token of [
-      "background", "foreground", "card", "card-foreground", "popover", "popover-foreground",
-      "primary", "primary-foreground", "secondary", "secondary-foreground", "muted",
-      "muted-foreground", "accent", "accent-foreground", "destructive", "border", "input", "ring",
-      "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground",
-      "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground",
-      "sidebar-border", "sidebar-ring",
+      "background",
+      "foreground",
+      "card",
+      "card-foreground",
+      "popover",
+      "popover-foreground",
+      "primary",
+      "primary-foreground",
+      "secondary",
+      "secondary-foreground",
+      "muted",
+      "muted-foreground",
+      "accent",
+      "accent-foreground",
+      "destructive",
+      "border",
+      "input",
+      "ring",
+      "chart-1",
+      "chart-2",
+      "chart-3",
+      "chart-4",
+      "chart-5",
+      "sidebar",
+      "sidebar-foreground",
+      "sidebar-primary",
+      "sidebar-primary-foreground",
+      "sidebar-accent",
+      "sidebar-accent-foreground",
+      "sidebar-border",
+      "sidebar-ring",
     ]) {
       expect(css).toContain(`--${token}:`);
       expect(css).toContain(`--color-${token}: var(--${token})`);
diff --git a/apps/web/tests/TopicActionPresentation.test.ts b/apps/web/tests/TopicActionPresentation.test.ts
index 139db12..b4e266c 100644
--- a/apps/web/tests/TopicActionPresentation.test.ts
+++ b/apps/web/tests/TopicActionPresentation.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { getTopicActionPresentation } from "~/lib/topic-action-presentation";
 
 const topic = { author: { loginname: "alice" } };
@@ -6,13 +6,41 @@ const topic = { author: { loginname: "alice" } };
 describe("话题动作呈现矩阵", () => {
   it.each([
     ["匿名", null, { report: false, directEdit: false, management: false, managementEdit: false }],
-    ["普通用户", { loginname: "bob" }, { report: true, directEdit: false, management: false, managementEdit: false }],
-    ["作者", { loginname: "alice" }, { report: false, directEdit: true, management: false, managementEdit: false }],
-    ["版主", { loginname: "bob", is_mod: true }, { report: false, directEdit: false, management: true, managementEdit: false }],
-    ["作者兼版主", { loginname: "alice", is_mod: true }, { report: false, directEdit: true, management: true, managementEdit: false }],
-    ["管理员", { loginname: "bob", is_admin: true }, { report: false, directEdit: false, management: true, managementEdit: true }],
-    ["作者兼管理员", { loginname: "alice", is_admin: true }, { report: false, directEdit: true, management: true, managementEdit: false }],
-    ["管理员兼版主", { loginname: "bob", is_admin: true, is_mod: true }, { report: false, directEdit: false, management: true, managementEdit: true }],
+    [
+      "普通用户",
+      { loginname: "bob" },
+      { report: true, directEdit: false, management: false, managementEdit: false },
+    ],
+    [
+      "作者",
+      { loginname: "alice" },
+      { report: false, directEdit: true, management: false, managementEdit: false },
+    ],
+    [
+      "版主",
+      { loginname: "bob", is_mod: true },
+      { report: false, directEdit: false, management: true, managementEdit: false },
+    ],
+    [
+      "作者兼版主",
+      { loginname: "alice", is_mod: true },
+      { report: false, directEdit: true, management: true, managementEdit: false },
+    ],
+    [
+      "管理员",
+      { loginname: "bob", is_admin: true },
+      { report: false, directEdit: false, management: true, managementEdit: true },
+    ],
+    [
+      "作者兼管理员",
+      { loginname: "alice", is_admin: true },
+      { report: false, directEdit: true, management: true, managementEdit: false },
+    ],
+    [
+      "管理员兼版主",
+      { loginname: "bob", is_admin: true, is_mod: true },
+      { report: false, directEdit: false, management: true, managementEdit: true },
+    ],
   ])("presents actions for %s", (_label, user, expected) => {
     const result = getTopicActionPresentation(topic, user);
     expect(result).toMatchObject({
diff --git a/apps/web/tests/TopicActions.test.tsx b/apps/web/tests/TopicActions.test.tsx
index 35e9075..22449e9 100644
--- a/apps/web/tests/TopicActions.test.tsx
+++ b/apps/web/tests/TopicActions.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import { TopicActions } from "~/routes/topic.$tid";
 
 const { apiFetch } = vi.hoisted(() => ({ apiFetch: vi.fn() }));
@@ -40,7 +40,10 @@ describe("话题动作层级", () => {
 
   it("keeps author edit direct without exposing governance", () => {
     renderActions({ loginname: "alice" });
-    expect(screen.getByRole("link", { name: "编辑话题" })).toHaveAttribute("href", "/topic/42/edit");
+    expect(screen.getByRole("link", { name: "编辑话题" })).toHaveAttribute(
+      "href",
+      "/topic/42/edit",
+    );
     expect(screen.queryByRole("button", { name: "管理" })).not.toBeInTheDocument();
     expect(screen.queryByRole("button", { name: /举报/ })).not.toBeInTheDocument();
   });
@@ -58,8 +61,14 @@ describe("话题动作层级", () => {
     screen.getByRole("button", { name: "管理" }).focus();
     await user.keyboard("{Enter}");
     expect(await screen.findByRole("menuitem", { name: "编辑话题" })).toBeInTheDocument();
-    expect(screen.getByRole("menu")).toHaveClass("overscroll-contain", "pb-[max(0.25rem,env(safe-area-inset-bottom))]");
-    expect(screen.getByLabelText("更多话题操作").parentElement).toHaveClass("flex-col", "sm:flex-row");
+    expect(screen.getByRole("menu")).toHaveClass(
+      "overscroll-contain",
+      "pb-[max(0.25rem,env(safe-area-inset-bottom))]",
+    );
+    expect(screen.getByLabelText("更多话题操作").parentElement).toHaveClass(
+      "flex-col",
+      "sm:flex-row",
+    );
     expect(screen.getByRole("menuitem", { name: "置顶帖子" })).toBeInTheDocument();
     expect(screen.getByRole("menuitem", { name: "高亮帖子" })).toBeInTheDocument();
     expect(screen.getByRole("menuitem", { name: "删除帖子" })).toBeInTheDocument();
@@ -83,7 +92,11 @@ describe("话题动作层级", () => {
     await user.keyboard("{Enter}");
     await user.click(await screen.findByRole("menuitem", { name: "删除帖子" }));
     let resolveRequest: (value: unknown) => void = () => {};
-    apiFetch.mockReturnValueOnce(new Promise((resolve) => { resolveRequest = resolve; }));
+    apiFetch.mockReturnValueOnce(
+      new Promise((resolve) => {
+        resolveRequest = resolve;
+      }),
+    );
     await user.click(screen.getByRole("button", { name: "确认删除帖子" }));
     expect(screen.getByRole("button", { name: "删除中" })).toBeDisabled();
     await user.keyboard("{Escape}");
@@ -95,7 +108,11 @@ describe("话题动作层级", () => {
   it("prevents duplicate governance actions while reporting pending state", async () => {
     const user = userEvent.setup();
     let resolveRequest: (value: unknown) => void = () => {};
-    apiFetch.mockReturnValueOnce(new Promise((resolve) => { resolveRequest = resolve; }));
+    apiFetch.mockReturnValueOnce(
+      new Promise((resolve) => {
+        resolveRequest = resolve;
+      }),
+    );
     renderActions({ loginname: "moderator", is_mod: true });
     const trigger = screen.getByRole("button", { name: "管理" });
     trigger.focus();
diff --git a/apps/web/tests/TopicAuthorCard.test.tsx b/apps/web/tests/TopicAuthorCard.test.tsx
index c9468dc..8f6ab91 100644
--- a/apps/web/tests/TopicAuthorCard.test.tsx
+++ b/apps/web/tests/TopicAuthorCard.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { MemoryRouter } from "react-router";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { TopicAuthorCard, TopicToc } from "~/routes/topic.$tid";
 import { ReadingGrid } from "~/components/PageShell";
 
@@ -41,7 +41,10 @@ describe("话题详情作者卡", () => {
     expect(screen.getByText("回复").parentElement).toHaveTextContent("42");
     expect(screen.queryByText("不应显示的最近话题")).not.toBeInTheDocument();
     expect(screen.queryByText("不应显示的最近参与")).not.toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "查看用户主页" })).toHaveAttribute("href", "/user/alice");
+    expect(screen.getByRole("link", { name: "查看用户主页" })).toHaveAttribute(
+      "href",
+      "/user/alice",
+    );
   });
 
   it("falls back to the lightweight topic author", () => {
@@ -50,7 +53,10 @@ describe("话题详情作者卡", () => {
     expect(screen.getByText("alice")).toBeInTheDocument();
     expect(screen.queryByLabelText("用户身份")).not.toBeInTheDocument();
     expect(screen.queryByText("积分")).not.toBeInTheDocument();
-    expect(screen.getByRole("link", { name: "查看用户主页" })).toHaveAttribute("href", "/user/alice");
+    expect(screen.getByRole("link", { name: "查看用户主页" })).toHaveAttribute(
+      "href",
+      "/user/alice",
+    );
   });
 
   it("places author context between the topic body and replies in the mobile document order", () => {
@@ -67,23 +73,28 @@ describe("话题详情作者卡", () => {
     const context = screen.getByTestId("author-context");
     const replies = screen.getByTestId("reply-flow");
     expect(body.compareDocumentPosition(context) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
-    expect(context.compareDocumentPosition(replies) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
+    expect(
+      context.compareDocumentPosition(replies) & Node.DOCUMENT_POSITION_FOLLOWING,
+    ).toBeTruthy();
   });
 
-  it.each([1279, 1280, 1440])("keeps the %dpx reading layout to main content and one right rail", (width) => {
-    window.innerWidth = width;
-    const { container } = render(
-      <ReadingGrid aside={<div>上下文</div>} afterAside={<div>回复</div>}>
-        <div>正文</div>
-      </ReadingGrid>,
-    );
-    const grid = container.firstElementChild;
+  it.each([1279, 1280, 1440])(
+    "keeps the %dpx reading layout to main content and one right rail",
+    (width) => {
+      window.innerWidth = width;
+      const { container } = render(
+        <ReadingGrid aside={<div>上下文</div>} afterAside={<div>回复</div>}>
+          <div>正文</div>
+        </ReadingGrid>,
+      );
+      const grid = container.firstElementChild;
 
-    expect(grid).toHaveClass("xl:grid-cols-[minmax(0,1fr)_18rem]");
-    expect(grid?.className).not.toContain("12rem");
-    expect(grid?.querySelectorAll("aside")).toHaveLength(1);
-    expect(screen.getByText("正文").parentElement).toHaveClass("xl:col-start-1");
-  });
+      expect(grid).toHaveClass("xl:grid-cols-[minmax(0,1fr)_18rem]");
+      expect(grid?.className).not.toContain("12rem");
+      expect(grid?.querySelectorAll("aside")).toHaveLength(1);
+      expect(screen.getByText("正文").parentElement).toHaveClass("xl:col-start-1");
+    },
+  );
 
   it("renders the topic TOC as a default-collapsed disclosure and closes it after navigation", async () => {
     const user = userEvent.setup();
diff --git a/apps/web/tests/TopicAuthorLoader.test.ts b/apps/web/tests/TopicAuthorLoader.test.ts
index 8dbc003..1f44ce2 100644
--- a/apps/web/tests/TopicAuthorLoader.test.ts
+++ b/apps/web/tests/TopicAuthorLoader.test.ts
@@ -1,4 +1,4 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 
 const mocks = vi.hoisted(() => ({
   apiFetch: vi.fn(),
@@ -7,7 +7,10 @@ const mocks = vi.hoisted(() => ({
   kvSet: vi.fn(),
 }));
 
-vi.mock("~/lib/api-client", () => ({ apiFetch: mocks.apiFetch, getCurrentUser: mocks.getCurrentUser }));
+vi.mock("~/lib/api-client", () => ({
+  apiFetch: mocks.apiFetch,
+  getCurrentUser: mocks.getCurrentUser,
+}));
 vi.mock("~/lib/kv-cache", () => ({ kvGet: mocks.kvGet, kvSet: mocks.kvSet }));
 
 import { loader } from "~/routes/topic.$tid";
@@ -22,8 +25,14 @@ describe("话题详情作者资料 loader", () => {
 
   it("queries and caches the public profile after loading the topic", async () => {
     mocks.apiFetch
-      .mockResolvedValueOnce({ success: true, data: { id: "1", author: { loginname: "alice", avatar_url: "" } } })
-      .mockResolvedValueOnce({ success: true, data: { loginname: "alice", identities: ["admin"] } });
+      .mockResolvedValueOnce({
+        success: true,
+        data: { id: "1", author: { loginname: "alice", avatar_url: "" } },
+      })
+      .mockResolvedValueOnce({
+        success: true,
+        data: { loginname: "alice", identities: ["admin"] },
+      });
 
     const result = await loader({
       params: { tid: "1" },
@@ -31,15 +40,27 @@ describe("话题详情作者资料 loader", () => {
       context: { cloudflare: { env: { KV: {} } } },
     } as any);
 
-    expect(mocks.apiFetch).toHaveBeenNthCalledWith(1, "/api/v1/topic/1?mdrender=false", { headers: { cookie: "" } });
-    expect(mocks.apiFetch).toHaveBeenNthCalledWith(2, "/api/v1/user/alice", { headers: { cookie: "" } });
+    expect(mocks.apiFetch).toHaveBeenNthCalledWith(1, "/api/v1/topic/1?mdrender=false", {
+      headers: { cookie: "" },
+    });
+    expect(mocks.apiFetch).toHaveBeenNthCalledWith(2, "/api/v1/user/alice", {
+      headers: { cookie: "" },
+    });
     expect(result.authorProfile).toEqual({ loginname: "alice", identities: ["admin"] });
-    expect(mocks.kvSet).toHaveBeenCalledWith(expect.anything(), "user:alice", result.authorProfile, 60);
+    expect(mocks.kvSet).toHaveBeenCalledWith(
+      expect.anything(),
+      "user:alice",
+      result.authorProfile,
+      60,
+    );
   });
 
   it("keeps the topic usable when the public profile request fails", async () => {
     mocks.apiFetch
-      .mockResolvedValueOnce({ success: true, data: { id: "1", author: { loginname: "alice", avatar_url: "" } } })
+      .mockResolvedValueOnce({
+        success: true,
+        data: { id: "1", author: { loginname: "alice", avatar_url: "" } },
+      })
       .mockRejectedValueOnce(new Error("profile unavailable"));
 
     const result = await loader({
diff --git a/apps/web/tests/TopicEditEntry.test.ts b/apps/web/tests/TopicEditEntry.test.ts
index 58971d7..299d577 100644
--- a/apps/web/tests/TopicEditEntry.test.ts
+++ b/apps/web/tests/TopicEditEntry.test.ts
@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { canEditTopic } from "~/routes/topic.$tid";
 
 const topic = {
diff --git a/apps/web/tests/UnsavedChanges.test.tsx b/apps/web/tests/UnsavedChanges.test.tsx
index 07056d0..f972c73 100644
--- a/apps/web/tests/UnsavedChanges.test.tsx
+++ b/apps/web/tests/UnsavedChanges.test.tsx
@@ -1,7 +1,7 @@
 import { render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, Link, RouterProvider, useNavigate } from "react-router";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "vite-plus/test";
 import { UnsavedChangesDialog, useUnsavedChanges } from "~/hooks/use-unsaved-changes";
 import { useState } from "react";
 
@@ -29,11 +29,14 @@ function Draft() {
 }
 
 function renderDraft() {
-  const router = createMemoryRouter([
-    { path: "/draft", element: <Draft /> },
-    { path: "/elsewhere", element: <h1>其他页面</h1> },
-    { path: "/saved", element: <h1>已保存</h1> },
-  ], { initialEntries: ["/draft"] });
+  const router = createMemoryRouter(
+    [
+      { path: "/draft", element: <Draft /> },
+      { path: "/elsewhere", element: <h1>其他页面</h1> },
+      { path: "/saved", element: <h1>已保存</h1> },
+    ],
+    { initialEntries: ["/draft"] },
+  );
   return render(<RouterProvider router={router} />);
 }
 
diff --git a/apps/web/tests/UserProfileHero.test.tsx b/apps/web/tests/UserProfileHero.test.tsx
index 6e76453..237df6b 100644
--- a/apps/web/tests/UserProfileHero.test.tsx
+++ b/apps/web/tests/UserProfileHero.test.tsx
@@ -1,10 +1,14 @@
 import { render, screen, waitFor, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { createMemoryRouter, RouterProvider } from "react-router";
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vite-plus/test";
 import { UserHero } from "~/routes/user.$name";
 
-const { apiFetch, toastError, toastSuccess } = vi.hoisted(() => ({ apiFetch: vi.fn(), toastError: vi.fn(), toastSuccess: vi.fn() }));
+const { apiFetch, toastError, toastSuccess } = vi.hoisted(() => ({
+  apiFetch: vi.fn(),
+  toastError: vi.fn(),
+  toastSuccess: vi.fn(),
+}));
 
 vi.mock("~/lib/api-client", async () => {
   const actual = await vi.importActual<typeof import("~/lib/api-client")>("~/lib/api-client");
@@ -54,15 +58,28 @@ describe("用户公开资料 Hero", () => {
     expect(screen.queryByText("版主")).not.toBeInTheDocument();
     expect(screen.getByText("Hangzhou")).toBeInTheDocument();
     expect(screen.getByText("Node.js developer")).toBeInTheDocument();
-    expect(screen.getByRole("link", { name: /alice\.example\.com/ })).toHaveAttribute("href", "https://alice.example.com/");
-    expect(screen.getByRole("link", { name: /@alice-gh/ })).toHaveAttribute("href", "https://github.com/alice-gh");
+    expect(screen.getByRole("link", { name: /alice\.example\.com/ })).toHaveAttribute(
+      "href",
+      "https://alice.example.com/",
+    );
+    expect(screen.getByRole("link", { name: /@alice-gh/ })).toHaveAttribute(
+      "href",
+      "https://github.com/alice-gh",
+    );
     expect(screen.getByText("话题").parentElement).toHaveTextContent("8");
     expect(screen.getByText("回复").parentElement).toHaveTextContent("42");
     expect(screen.getByText("收藏").parentElement).toHaveTextContent("5");
   });
 
   it("hides empty and unsafe public profile fields", () => {
-    renderHero({ ...baseUser, identities: [], location: null, url: "javascript:alert(1)", githubUsername: "", signature: null });
+    renderHero({
+      ...baseUser,
+      identities: [],
+      location: null,
+      url: "javascript:alert(1)",
+      githubUsername: "",
+      signature: null,
+    });
 
     expect(screen.queryByLabelText("用户身份")).not.toBeInTheDocument();
     expect(screen.queryByText("Hangzhou")).not.toBeInTheDocument();
@@ -89,7 +106,10 @@ describe("用户公开资料 Hero", () => {
 
   it("keeps block and mute actions independent", async () => {
     const operator = userEvent.setup();
-    renderHero({ ...baseUser, is_block: true, is_muted: false }, { loginname: "admin", is_admin: true });
+    renderHero(
+      { ...baseUser, is_block: true, is_muted: false },
+      { loginname: "admin", is_admin: true },
+    );
 
     expect(screen.getByText("内容已屏蔽")).toBeInTheDocument();
     expect(screen.queryByText("已禁言")).not.toBeInTheDocument();
diff --git a/apps/web/tests/ZoneJobsSsr.test.tsx b/apps/web/tests/ZoneJobsSsr.test.tsx
index b7ed4bc..3abe961 100644
--- a/apps/web/tests/ZoneJobsSsr.test.tsx
+++ b/apps/web/tests/ZoneJobsSsr.test.tsx
@@ -1,6 +1,6 @@
 import { renderToString } from "react-dom/server";
 import { MemoryRouter } from "react-router";
-import { describe, expect, it, vi } from "vitest";
+import { describe, expect, it, vi } from "vite-plus/test";
 import ZoneJobs, { loader } from "~/routes/zone.jobs";
 
 const { apiFetch } = vi.hoisted(() => ({ apiFetch: vi.fn() }));
@@ -16,7 +16,9 @@ describe("招聘页 SSR 状态", () => {
       .mockResolvedValueOnce({ success: true, data: [], total: 60 })
       .mockResolvedValueOnce({ success: true, data: { locations: ["上海"], remote_options: [] } });
     const data = await loader({
-      request: new Request("https://cnodejs.org/zone/jobs?location=%E4%B8%8A%E6%B5%B7&remote=hybrid&page=2"),
+      request: new Request(
+        "https://cnodejs.org/zone/jobs?location=%E4%B8%8A%E6%B5%B7&remote=hybrid&page=2",
+      ),
     });
 
     expect(data.searchParams).toEqual({ location: "上海", remote: "hybrid" });
@@ -32,11 +34,14 @@ describe("招聘页 SSR 状态", () => {
       locations: ["上海"],
       searchParams: { location: "上海", remote: "hybrid" },
     };
-    const renderPage = () => renderToString(
-      <MemoryRouter initialEntries={["/zone/jobs?location=%E4%B8%8A%E6%B5%B7&remote=hybrid&page=2"]}>
-        <ZoneJobs loaderData={loaderData} />
-      </MemoryRouter>,
-    );
+    const renderPage = () =>
+      renderToString(
+        <MemoryRouter
+          initialEntries={["/zone/jobs?location=%E4%B8%8A%E6%B5%B7&remote=hybrid&page=2"]}
+        >
+          <ZoneJobs loaderData={loaderData} />
+        </MemoryRouter>,
+      );
 
     window.history.replaceState({}, "", "/unrelated?remote=remote");
     const first = renderPage();
diff --git a/apps/web/tsconfig.json b/apps/web/tsconfig.json
index 95297d4..cdb76bc 100644
--- a/apps/web/tsconfig.json
+++ b/apps/web/tsconfig.json
@@ -9,8 +9,7 @@
       "~/*": ["./app/*"],
       "~/db": ["../../packages/db/src/index.ts"],
       "~/shared": ["../../packages/shared/src/index.ts"]
-    },
-    "baseUrl": "."
+    }
   },
   "include": ["**/*.ts", "**/*.tsx", "**/.react-router/types/**/*"],
   "exclude": ["node_modules", "dist", "build"]
diff --git a/apps/web/vite.config.ts b/apps/web/vite.config.ts
index 5c9fe1d..0153e01 100644
--- a/apps/web/vite.config.ts
+++ b/apps/web/vite.config.ts
@@ -1,13 +1,13 @@
 import { reactRouter } from "@react-router/dev/vite";
 import tailwindcss from "@tailwindcss/vite";
-import { defineConfig } from "vite";
+import { defineConfig, lazyPlugins } from "vite-plus";
 import path from "path";
 import { loadRootEnv } from "../../scripts/env";
 
 loadRootEnv({ cwd: import.meta.dirname });
 
 export default defineConfig({
-  plugins: [reactRouter(), tailwindcss()],
+  plugins: lazyPlugins(() => [reactRouter(), tailwindcss()]),
   resolve: {
     alias: {
       "~": path.resolve(import.meta.dirname, "app"),
diff --git a/apps/web/vitest.config.ts b/apps/web/vitest.config.ts
index cc86aeb..09e785e 100644
--- a/apps/web/vitest.config.ts
+++ b/apps/web/vitest.config.ts
@@ -1,4 +1,4 @@
-import { defineConfig } from "vitest/config";
+import { defineConfig } from "vite-plus";
 import { resolve } from "node:path";
 
 export default defineConfig({
diff --git a/deployment/docker-compose.yml b/deployment/docker-compose.yml
index cd59064..1f41dbe 100644
--- a/deployment/docker-compose.yml
+++ b/deployment/docker-compose.yml
@@ -10,7 +10,11 @@ services:
       redis:
         condition: service_healthy
     healthcheck:
-      test: ["CMD-SHELL", "node -e \"fetch('http://localhost:3001/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))\""]
+      test:
+        [
+          "CMD-SHELL",
+          'node -e "fetch(''http://localhost:3001/health'').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"',
+        ]
       interval: 10s
       timeout: 5s
       retries: 5
diff --git a/deployment/scripts/smoke-api-contract.ts b/deployment/scripts/smoke-api-contract.ts
index 60b4c47..df4ed0a 100644
--- a/deployment/scripts/smoke-api-contract.ts
+++ b/deployment/scripts/smoke-api-contract.ts
@@ -38,7 +38,17 @@ async function verifyTopics() {
   if (!Array.isArray(json.data)) throw new Error("topics.data must be an array");
   const topic = json.data[0];
   required("topics.data[0]", topic);
-  for (const key of ["id", "author_id", "title", "content", "last_reply_at", "reply_count", "visit_count", "create_at", "author"]) {
+  for (const key of [
+    "id",
+    "author_id",
+    "title",
+    "content",
+    "last_reply_at",
+    "reply_count",
+    "visit_count",
+    "create_at",
+    "author",
+  ]) {
     required(`topics.data[0].${key}`, topic[key]);
   }
   required("topics.data[0].author.loginname", topic.author.loginname);
@@ -50,7 +60,11 @@ async function verifyMarkdownRender(topicId: string) {
   const rendered = await getJson(`/api/v1/topic/${topicId}?mdrender=true`);
   required("markdown.raw.success", raw.success);
   required("markdown.rendered.success", rendered.success);
-  if (raw.data?.content && raw.data.content === rendered.data?.content && /[#*_`[]/.test(raw.data.content)) {
+  if (
+    raw.data?.content &&
+    raw.data.content === rendered.data?.content &&
+    /[#*_`[]/.test(raw.data.content)
+  ) {
     throw new Error("mdrender=true should return rendered HTML for markdown content");
   }
 }
@@ -65,7 +79,8 @@ async function verifyTopic(id: string) {
   if (!Array.isArray(json.data.replies)) throw new Error("topic.data.replies must be an array");
   for (const reply of json.data.replies) {
     if (!Array.isArray(reply.ups)) throw new Error("topic.data.replies[].ups must be an array");
-    if (typeof reply.is_uped !== "boolean") throw new Error("topic.data.replies[].is_uped must be boolean");
+    if (typeof reply.is_uped !== "boolean")
+      throw new Error("topic.data.replies[].is_uped must be boolean");
   }
   return json.data;
 }
@@ -74,11 +89,20 @@ async function verifyUser(loginname: string) {
   const json = await getJson(`/api/v1/user/${encodeURIComponent(loginname)}`);
   required("user.success", json.success);
   required("user.data", json.data);
-  for (const key of ["loginname", "avatar_url", "create_at", "score", "recent_topics", "recent_replies"]) {
+  for (const key of [
+    "loginname",
+    "avatar_url",
+    "create_at",
+    "score",
+    "recent_topics",
+    "recent_replies",
+  ]) {
     required(`user.data.${key}`, json.data[key]);
   }
-  if (!Array.isArray(json.data.recent_topics)) throw new Error("user.data.recent_topics must be an array");
-  if (!Array.isArray(json.data.recent_replies)) throw new Error("user.data.recent_replies must be an array");
+  if (!Array.isArray(json.data.recent_topics))
+    throw new Error("user.data.recent_topics must be an array");
+  if (!Array.isArray(json.data.recent_replies))
+    throw new Error("user.data.recent_replies must be an array");
 }
 
 async function verifyUserLists(loginname: string) {
@@ -127,7 +151,9 @@ async function verifyWritePaths(topic: any) {
 
   const topicId = process.env.API_TEST_TOPIC_ID || String(topic.id);
   const tokenUser = await verifyAccessToken(token);
-  const topicJson = await getJson(`/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`);
+  const topicJson = await getJson(
+    `/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`,
+  );
   required("write.topic.success", topicJson.success);
   const topicData = topicJson.data;
   const userBefore = await getJson(`/api/v1/user/${encodeURIComponent(tokenUser.loginname)}`);
@@ -147,17 +173,32 @@ async function verifyWritePaths(topic: any) {
   const createProbe = await fetch(`${apiBase}/api/v1/topics`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ accesstoken: "invalid-token", title: "invalid token probe", tab: "share", content: "probe" }),
+    body: JSON.stringify({
+      accesstoken: "invalid-token",
+      title: "invalid token probe",
+      tab: "share",
+      content: "probe",
+    }),
   });
   if (!createProbe.headers.get("X-RateLimit-Limit")) {
     console.log("skip rate-limit header assertion: limiter may be in development identity bypass");
   }
 
-  const collectPath = topicData.is_collect ? "/api/v1/topic_collect/de_collect" : "/api/v1/topic_collect/collect";
-  const restoreCollectPath = topicData.is_collect ? "/api/v1/topic_collect/collect" : "/api/v1/topic_collect/de_collect";
-  const collect = await postJson(collectPath, { accesstoken: token, topic_id: String(topicData.id) });
+  const collectPath = topicData.is_collect
+    ? "/api/v1/topic_collect/de_collect"
+    : "/api/v1/topic_collect/collect";
+  const restoreCollectPath = topicData.is_collect
+    ? "/api/v1/topic_collect/collect"
+    : "/api/v1/topic_collect/de_collect";
+  const collect = await postJson(collectPath, {
+    accesstoken: token,
+    topic_id: String(topicData.id),
+  });
   required("write.topic_collect.toggle.success", collect.success);
-  const restoreCollect = await postJson(restoreCollectPath, { accesstoken: token, topic_id: String(topicData.id) });
+  const restoreCollect = await postJson(restoreCollectPath, {
+    accesstoken: token,
+    topic_id: String(topicData.id),
+  });
   required("write.topic_collect.restore.success", restoreCollect.success);
 
   const newReply = await postJson(`/api/v1/topic/${topicId}/replies`, {
@@ -165,7 +206,9 @@ async function verifyWritePaths(topic: any) {
     content: `api contract smoke reply ${Date.now()}`,
   });
   required("write.reply.create.success", newReply.success);
-  const afterCreateTopic = await getJson(`/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`);
+  const afterCreateTopic = await getJson(
+    `/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`,
+  );
   if (Number(afterCreateTopic.data.reply_count || 0) !== replyCountBefore + 1) {
     throw new Error("creating reply should increment topic.reply_count");
   }
@@ -176,9 +219,13 @@ async function verifyWritePaths(topic: any) {
   if (Number(afterCreateUser.data.reply_count || 0) !== userReplyCountBefore + 1) {
     throw new Error("creating reply should increment user reply_count");
   }
-  const deleteReply = await postJson(`/api/v1/reply/${newReply.reply_id}/delete`, { accesstoken: token });
+  const deleteReply = await postJson(`/api/v1/reply/${newReply.reply_id}/delete`, {
+    accesstoken: token,
+  });
   required("write.reply.delete.success", deleteReply.success);
-  const afterDeleteTopic = await getJson(`/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`);
+  const afterDeleteTopic = await getJson(
+    `/api/v1/topic/${topicId}?accesstoken=${encodeURIComponent(token)}&mdrender=false`,
+  );
   if (Number(afterDeleteTopic.data.reply_count || 0) !== replyCountBefore) {
     throw new Error("deleting smoke reply should restore topic.reply_count");
   }
@@ -196,20 +243,22 @@ async function verifyWritePaths(topic: any) {
     return;
   }
 
-  const replyResponse = await fetch(`${apiBase}/api/v1/reply/${replyId}?accesstoken=${encodeURIComponent(token)}`);
+  const replyResponse = await fetch(
+    `${apiBase}/api/v1/reply/${replyId}?accesstoken=${encodeURIComponent(token)}`,
+  );
   if (replyResponse.ok) {
     const replyJson = await replyResponse.json();
     const editReply = await postJson(`/api/v1/reply/${replyId}/edit`, {
       accesstoken: token,
       content: replyJson.data.content,
     });
-      required("write.reply.edit.success", editReply.success);
-      const deleteProbe = await fetch(`${apiBase}/api/v1/reply/${replyId}/delete`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ accesstoken: "invalid-token" }),
-      });
-      if (deleteProbe.ok) throw new Error("reply delete should reject invalid token");
+    required("write.reply.edit.success", editReply.success);
+    const deleteProbe = await fetch(`${apiBase}/api/v1/reply/${replyId}/delete`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ accesstoken: "invalid-token" }),
+    });
+    if (deleteProbe.ok) throw new Error("reply delete should reject invalid token");
   } else {
     console.log("skip reply edit smoke: token user cannot edit selected reply");
   }
diff --git a/docs/architecture.md b/docs/architecture.md
index 06c2611..6cf07b5 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -29,14 +29,14 @@ graph TB
   Worker --> Pg
 ```
 
-| Component | Responsibility |
-| --------- | -------------- |
-| `apps/web` | SSR pages, client interactions, runtime public config. |
-| `apps/api` | HTTP API, auth, moderation/admin routes, workers. |
-| `packages/db` | Drizzle PostgreSQL schema and database helpers. |
-| `packages/shared` | API types, Zod schemas, constants, pure helpers. |
-| Redis | Session/cache/rate-limit state and worker locks. |
-| PostgreSQL | The only supported runtime database. |
+| Component         | Responsibility                                         |
+| ----------------- | ------------------------------------------------------ |
+| `apps/web`        | SSR pages, client interactions, runtime public config. |
+| `apps/api`        | HTTP API, auth, moderation/admin routes, workers.      |
+| `packages/db`     | Drizzle PostgreSQL schema and database helpers.        |
+| `packages/shared` | API types, Zod schemas, constants, pure helpers.       |
+| Redis             | Session/cache/rate-limit state and worker locks.       |
+| PostgreSQL        | The only supported runtime database.                   |
 
 ## Request And Upload Flow
 
@@ -60,11 +60,11 @@ sequenceDiagram
   B->>O: PUT file directly
 ```
 
-| Flow | Boundary |
-| ---- | -------- |
-| SSR data | Web server to API. |
+| Flow       | Boundary                                                     |
+| ---------- | ------------------------------------------------------------ |
+| SSR data   | Web server to API.                                           |
 | Client API | Browser to API with cookie or access token where applicable. |
-| Uploads | API signs; browser uploads directly to object storage. |
+| Uploads    | API signs; browser uploads directly to object storage.       |
 
 ## Release Boundary
 
@@ -80,26 +80,26 @@ flowchart LR
   Smoke --> Audit[audit record]
 ```
 
-| Stage | Task |
-| ----- | ---- |
-| Verify | Run lint, typecheck, tests, build, OpenSpec validation, and secret scan. |
-| Images | Use published image tags or digests. |
-| Runbook | Follow [deployment/README.md](../deployment/README.md). |
-| Audit | Record what changed and what was checked. |
+| Stage   | Task                                                                     |
+| ------- | ------------------------------------------------------------------------ |
+| Verify  | Run lint, typecheck, tests, build, OpenSpec validation, and secret scan. |
+| Images  | Use published image tags or digests.                                     |
+| Runbook | Follow [deployment/README.md](../deployment/README.md).                  |
+| Audit   | Record what changed and what was checked.                                |
 
 ## Repository Map
 
-| Path | Role |
-| ---- | ---- |
-| `apps/web` | React Router SSR application. |
-| `apps/api` | Hono API and worker entrypoints. |
-| `packages/db` | PostgreSQL schema and migrations. |
-| `packages/shared` | Shared TypeScript contracts. |
-| `docs` | Stable task documentation. |
-| `wiki` | Sourced historical and business-logic notes. |
-| `api` | OpenAPI specification (single source of truth for API contracts). |
-| `openspec` | Behavior change proposals and specs. |
-| `deployment` | Production runbook and deployment assets. |
+| Path              | Role                                                              |
+| ----------------- | ----------------------------------------------------------------- |
+| `apps/web`        | React Router SSR application.                                     |
+| `apps/api`        | Hono API and worker entrypoints.                                  |
+| `packages/db`     | PostgreSQL schema and migrations.                                 |
+| `packages/shared` | Shared TypeScript contracts.                                      |
+| `docs`            | Stable task documentation.                                        |
+| `wiki`            | Sourced historical and business-logic notes.                      |
+| `api`             | OpenAPI specification (single source of truth for API contracts). |
+| `openspec`        | Behavior change proposals and specs.                              |
+| `deployment`      | Production runbook and deployment assets.                         |
 
 ## Runtime Rules
 
diff --git a/docs/content-moderation.md b/docs/content-moderation.md
index 09288d5..b4b5efe 100644
--- a/docs/content-moderation.md
+++ b/docs/content-moderation.md
@@ -4,13 +4,13 @@ This document summarizes current moderation tasks and database-backed moderation
 
 ## Moderation Areas
 
-| Area | Current task |
-| ---- | ------------ |
-| Keyword rules | Store and update sensitive-word rules through admin workflows. |
-| Submission checks | Block or flag topic/reply content that matches active rules. |
-| Scan jobs | Scan existing content and store findings for review. |
-| Reports | Capture user reports for moderator review. |
-| Audit | Record moderator actions and important state changes. |
+| Area              | Current task                                                   |
+| ----------------- | -------------------------------------------------------------- |
+| Keyword rules     | Store and update sensitive-word rules through admin workflows. |
+| Submission checks | Block or flag topic/reply content that matches active rules.   |
+| Scan jobs         | Scan existing content and store findings for review.           |
+| Reports           | Capture user reports for moderator review.                     |
+| Audit             | Record moderator actions and important state changes.          |
 
 ## Scan Flow
 
@@ -25,24 +25,24 @@ flowchart LR
   Review --> Action[keep, mute, delete, or restore]
 ```
 
-| Step | Result |
-| ---- | ------ |
-| Rules | Current sensitive-word set is selected. |
-| Scan | Existing topic and reply content is checked. |
-| Hits | Findings are deduplicated and stored. |
+| Step   | Result                                              |
+| ------ | --------------------------------------------------- |
+| Rules  | Current sensitive-word set is selected.             |
+| Scan   | Existing topic and reply content is checked.        |
+| Hits   | Findings are deduplicated and stored.               |
 | Review | Moderators decide action and leave auditable state. |
 
 ## Admin Review Operations
 
 Moderation hits are review records, not the content itself. Admin review can filter hits by scan job through `moderation_hits.scan_job_id` so a task such as `#11` can show the findings it created.
 
-| Operation | Effect |
-| --------- | ------ |
-| View job hits | Shows hits whose `scan_job_id` matches the selected scan job. |
-| Confirm hit | Deletes the original topic or reply using the existing soft-delete lifecycle and marks the hit confirmed. |
-| Ignore hit | Leaves the original content visible and removes the hit from the pending queue. |
-| False positive | Leaves the original content visible and records the hit as a false positive. |
-| Confirm all pending hits for a job | Admin-only dangerous operation that confirms every pending hit for the selected scan job. |
+| Operation                          | Effect                                                                                                    |
+| ---------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| View job hits                      | Shows hits whose `scan_job_id` matches the selected scan job.                                             |
+| Confirm hit                        | Deletes the original topic or reply using the existing soft-delete lifecycle and marks the hit confirmed. |
+| Ignore hit                         | Leaves the original content visible and removes the hit from the pending queue.                           |
+| False positive                     | Leaves the original content visible and records the hit as a false positive.                              |
+| Confirm all pending hits for a job | Admin-only dangerous operation that confirms every pending hit for the selected scan job.                 |
 
 Job-level bulk confirmation deletes the original topic or reply, but it still uses the normal soft-delete behavior. It does not physically delete rows from PostgreSQL.
 
@@ -52,12 +52,12 @@ Permanent topic deletion is a separate admin-only operation in topic management.
 
 The admin audit page is an operational review surface, not just a raw log table. It groups audit events by operational category, highlights high-risk actions, and keeps raw event data available for accountability.
 
-| Audit area | Purpose |
-| ---------- | ------- |
+| Audit area    | Purpose                                                                                                                      |
+| ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | Summary cards | Show high-risk actions, content deletions, role changes, account-security actions, and failures in the current filter scope. |
-| Filters | Narrow events by date range, category, risk, operator, target type, result, and keyword. |
-| Event stream | Present each action with a human-readable label, risk badge, operator, target, result, and time. |
-| Details | Preserve raw `action`, operator, target fields, and sanitized `detail` for traceability. |
+| Filters       | Narrow events by date range, category, risk, operator, target type, result, and keyword.                                     |
+| Event stream  | Present each action with a human-readable label, risk badge, operator, target, result, and time.                             |
+| Details       | Preserve raw `action`, operator, target fields, and sanitized `detail` for traceability.                                     |
 
 User governance actions in admin lists are grouped by risk: content blocking and mute actions live under user governance, role grants under role permissions, password reset under account security, and bulk deletion under dangerous operations.
 
diff --git a/docs/conventions.md b/docs/conventions.md
index f06faaa..d7295cf 100644
--- a/docs/conventions.md
+++ b/docs/conventions.md
@@ -4,13 +4,13 @@ This repository keeps public project documentation concise, task-oriented, and s
 
 ## Documentation Domains
 
-| Domain | Purpose | Rules |
-| ------ | ------- | ----- |
-| `README.md` | Open-source project entry | Intro, features, stack, quick start, docs, contributing, security, license. No large diagrams or historical narrative. |
-| `docs/` | Stable task documentation | Architecture, development, database, migration, API reference, moderation, and security tasks. Keep current behavior first. |
-| `wiki/` | Knowledge base | Historical context, legacy behavior, migration background, community rules, and business logic notes. Must follow [wiki/writing-guidelines.md](../wiki/writing-guidelines.md). |
-| `deployment/` | Production deployment domain | Production runbook, compose file, grouped dotenv template, audit template, and real operator assets. |
-| `openspec/` | Proposed and accepted behavior changes | Use for scoped product, API, migration, release, architecture, database, security, permissions, deployment, or data repair changes. |
+| Domain        | Purpose                                | Rules                                                                                                                                                                          |
+| ------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `README.md`   | Open-source project entry              | Intro, features, stack, quick start, docs, contributing, security, license. No large diagrams or historical narrative.                                                         |
+| `docs/`       | Stable task documentation              | Architecture, development, database, migration, API reference, moderation, and security tasks. Keep current behavior first.                                                    |
+| `wiki/`       | Knowledge base                         | Historical context, legacy behavior, migration background, community rules, and business logic notes. Must follow [wiki/writing-guidelines.md](../wiki/writing-guidelines.md). |
+| `deployment/` | Production deployment domain           | Production runbook, compose file, grouped dotenv template, audit template, and real operator assets.                                                                           |
+| `openspec/`   | Proposed and accepted behavior changes | Use for scoped product, API, migration, release, architecture, database, security, permissions, deployment, or data repair changes.                                            |
 
 `docs/`, `wiki/`, and `deployment/` are sibling domains. `docs/` answers "how do I develop, understand, or use this now?". `wiki/` records "why is this true, where did it come from, and what still needs review?". `deployment/` contains the production runbook and files operators can copy, validate, or execute.
 
@@ -60,29 +60,29 @@ These are current implementation conventions, so no `wiki/` synchronization is r
 
 ## Git Workflow
 
-| Item | Rule |
-| ---- | ---- |
-| Branch naming | `feat/<scope>-<short>`, `fix/<scope>-<short>`, `docs/<short>`, `chore/<short>`, or OpenSpec change name. |
-| Base branch | `main`. |
-| Commit style | Conventional Commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`, `ci:`, `refactor:`, `perf:`. Scope optional, e.g. `feat(api):`. |
-| Commit message | Imperative mood, lowercase first letter, no trailing period. Body explains why, not what. |
-| Atomic commits | One logical change per commit. Split mixed changes into a chain of PRs when possible. |
-| Branch lifecycle | Delete feature branches after merge. |
-| Force push | Never on shared branches. Use `--force-with-lease` on your own branch only when truly needed. |
+| Item             | Rule                                                                                                                               |
+| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| Branch naming    | `feat/<scope>-<short>`, `fix/<scope>-<short>`, `docs/<short>`, `chore/<short>`, or OpenSpec change name.                           |
+| Base branch      | `main`.                                                                                                                            |
+| Commit style     | Conventional Commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`, `ci:`, `refactor:`, `perf:`. Scope optional, e.g. `feat(api):`. |
+| Commit message   | Imperative mood, lowercase first letter, no trailing period. Body explains why, not what.                                          |
+| Atomic commits   | One logical change per commit. Split mixed changes into a chain of PRs when possible.                                              |
+| Branch lifecycle | Delete feature branches after merge.                                                                                               |
+| Force push       | Never on shared branches. Use `--force-with-lease` on your own branch only when truly needed.                                      |
 
 ## Pull Requests
 
-| Step | Expectation |
-| ---- | ----------- |
-| Scope | One concern per PR. Reference an OpenSpec change when behavior, product, API, migration, release, or architecture is touched. |
-| Title | Conventional Commit format matching the primary change type. |
-| Description | State what changed and why. Note migration, deployment, and secret-handling impact. |
-| Tests | Add or update tests for behavior changes. Pure refactors still pass `pnpm test`. |
-| Docs | Update `docs/` and `apps/api/src/routes/*.ts` zod-openapi declarations when API behavior changes. Run `pnpm gen:openapi` to regenerate `api/openapi.json`. |
+| Step           | Expectation                                                                                                                                                                         |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Scope          | One concern per PR. Reference an OpenSpec change when behavior, product, API, migration, release, or architecture is touched.                                                       |
+| Title          | Conventional Commit format matching the primary change type.                                                                                                                        |
+| Description    | State what changed and why. Note migration, deployment, and secret-handling impact.                                                                                                 |
+| Tests          | Add or update tests for behavior changes. Pure refactors still pass `pnpm test`.                                                                                                    |
+| Docs           | Update `docs/` and `apps/api/src/routes/*.ts` zod-openapi declarations when API behavior changes. Run `pnpm gen:openapi` to regenerate `api/openapi.json`.                          |
 | Database audit | For PostgreSQL schema, migration, seed/bootstrap, index, constraint, backfill, cleanup, repair, retention, or field semantic changes, link to the OpenSpec `Database Change Audit`. |
-| Verification | Run `pnpm verify` when feasible. If not, list the subset that was run and why. |
-| Reviews | At least one maintainer approval for `main`. Request review from domain owners for affected packages. |
-| Squash merge | Default. The squashed commit message should follow Conventional Commits. |
+| Verification   | Run `pnpm verify` when feasible. If not, list the subset that was run and why.                                                                                                      |
+| Reviews        | At least one maintainer approval for `main`. Request review from domain owners for affected packages.                                                                               |
+| Squash merge   | Default. The squashed commit message should follow Conventional Commits.                                                                                                            |
 
 ## Code Review
 
@@ -94,15 +94,15 @@ These are current implementation conventions, so no `wiki/` synchronization is r
 
 ## Testing
 
-| Level | Expectation |
-| ----- | ----------- |
-| Unit | Pure logic in `packages/shared` and helpers must have unit tests. |
-| API route | `apps/api` uses Vitest. Route tests may use Hono `app.request` and fake/mock service boundaries, but must not connect to a real database. |
+| Level       | Expectation                                                                                                                                                  |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Unit        | Pure logic in `packages/shared` and helpers must have unit tests.                                                                                            |
+| API route   | `apps/api` uses Vitest. Route tests may use Hono `app.request` and fake/mock service boundaries, but must not connect to a real database.                    |
 | DB behavior | Do not add database integration tests unless a future OpenSpec change defines a PostgreSQL-only strategy. Current API tests do not use a real test database. |
-| Contract | `pnpm gen:openapi` regenerates `api/openapi.json` from route zod-openapi declarations. `pnpm verify` includes this step. |
-| No SQLite | Tests must not make SQLite, PGlite, in-memory SQL, or dialect fallback a release path. Pure logic checks are acceptable when no DB is needed. |
-| Naming | `apps/api` tests live under `apps/api/test/**/*.test.ts`; other packages use `*.test.ts` next to source or under `__tests__`. |
-| Running | `apps/api` runs `vitest run` with automatic test discovery. Use `pnpm test` per package, `pnpm -r test` across the workspace. |
+| Contract    | `pnpm gen:openapi` regenerates `api/openapi.json` from route zod-openapi declarations. `pnpm verify` includes this step.                                     |
+| No SQLite   | Tests must not make SQLite, PGlite, in-memory SQL, or dialect fallback a release path. Pure logic checks are acceptable when no DB is needed.                |
+| Naming      | `apps/api` tests live under `apps/api/test/**/*.test.ts`; other packages use `*.test.ts` next to source or under `__tests__`.                                |
+| Running     | `apps/api` runs `vitest run` with automatic test discovery. Use `pnpm test` per package, `pnpm -r test` across the workspace.                                |
 
 API tests must not require `POSTGRES_HOST`, `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB`, or any real PostgreSQL test database. Tests that need database-backed branches should fake the service/query boundary and state that they verify route behavior, not PostgreSQL semantics.
 
@@ -118,11 +118,11 @@ API tests must not require `POSTGRES_HOST`, `POSTGRES_USER`, `POSTGRES_PASSWORD`
 
 ## Documentation Sync Rules
 
-| Change area | Documentation expectation |
-| ----------- | ------------------------- |
-| Current development, runtime, architecture, API, database, migration, moderation, or security behavior | Update the relevant `docs/` page or explain why stable docs are not affected. |
-| Business rules, legacy behavior, migration background, community rules, or sourced historical context | Update the relevant `wiki/` page and follow [wiki/writing-guidelines.md](../wiki/writing-guidelines.md). |
-| API contract behavior | Update route zod-openapi declarations and regenerate `api/openapi.json` with `pnpm gen:openapi`. |
+| Change area                                                                                               | Documentation expectation                                                                                                             |
+| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| Current development, runtime, architecture, API, database, migration, moderation, or security behavior    | Update the relevant `docs/` page or explain why stable docs are not affected.                                                         |
+| Business rules, legacy behavior, migration background, community rules, or sourced historical context     | Update the relevant `wiki/` page and follow [wiki/writing-guidelines.md](../wiki/writing-guidelines.md).                              |
+| API contract behavior                                                                                     | Update route zod-openapi declarations and regenerate `api/openapi.json` with `pnpm gen:openapi`.                                      |
 | PostgreSQL schema, migration, index, constraint, backfill, cleanup, repair, retention, or field semantics | Include OpenSpec `Database Change Audit`; update `docs/database.md` or `wiki/migration-background.md` when durable knowledge changes. |
 
 ## API Documentation Rules
diff --git a/docs/database.md b/docs/database.md
index 61a7e01..87d4bea 100644
--- a/docs/database.md
+++ b/docs/database.md
@@ -18,25 +18,25 @@ erDiagram
   users ||--o{ reply_ups : likes
 ```
 
-| Rule | Requirement |
-| ---- | ----------- |
-| Runtime database | PostgreSQL only. |
-| Schema source | `packages/db/src/schema/`. |
-| Migration files | `packages/db/migrations/pg/`. |
-| Compatibility | Do not add dialect fallback or local database compatibility paths. |
+| Rule             | Requirement                                                        |
+| ---------------- | ------------------------------------------------------------------ |
+| Runtime database | PostgreSQL only.                                                   |
+| Schema source    | `packages/db/src/schema/`.                                         |
+| Migration files  | `packages/db/migrations/pg/`.                                      |
+| Compatibility    | Do not add dialect fallback or local database compatibility paths. |
 
 ## Tables
 
-| Table | Purpose |
-| ----- | ------- |
-| `users` | Accounts, auth fields, profile fields, counters. |
-| `topics` | Topics and lifecycle status. |
-| `replies` | Topic replies. |
-| `reply_ups` | Reply likes as a join table. |
-| `messages` | Reply, reply2, and mention notifications. |
-| `topic_collects` | Topic collections with user/topic uniqueness. |
-| `moderation_scan_jobs` | Historical or scheduled moderation scan jobs. |
-| `moderation_hits` | Moderation findings and handling state. |
+| Table                  | Purpose                                          |
+| ---------------------- | ------------------------------------------------ |
+| `users`                | Accounts, auth fields, profile fields, counters. |
+| `topics`               | Topics and lifecycle status.                     |
+| `replies`              | Topic replies.                                   |
+| `reply_ups`            | Reply likes as a join table.                     |
+| `messages`             | Reply, reply2, and mention notifications.        |
+| `topic_collects`       | Topic collections with user/topic uniqueness.    |
+| `moderation_scan_jobs` | Historical or scheduled moderation scan jobs.    |
+| `moderation_hits`      | Moderation findings and handling state.          |
 
 ## Schema Workflow
 
@@ -51,13 +51,13 @@ flowchart LR
   Push --> Pg
 ```
 
-| Command | Use |
-| ------- | --- |
-| `pnpm db:generate` | Generate PostgreSQL migration files. |
-| `pnpm db:push:pg` | Create or update a disposable local PostgreSQL schema. |
-| `pnpm db:migrate` | Apply reviewed PostgreSQL migration files. |
-| `pnpm migrate:mongo-to-pg` | Run explicit data migration tooling. |
-| `pnpm migrate:reconcile` | Compare migrated target counts with source expectations. |
+| Command                               | Use                                                                        |
+| ------------------------------------- | -------------------------------------------------------------------------- |
+| `pnpm db:generate`                    | Generate PostgreSQL migration files.                                       |
+| `pnpm db:push:pg`                     | Create or update a disposable local PostgreSQL schema.                     |
+| `pnpm db:migrate`                     | Apply reviewed PostgreSQL migration files.                                 |
+| `pnpm migrate:mongo-to-pg`            | Run explicit data migration tooling.                                       |
+| `pnpm migrate:reconcile`              | Compare migrated target counts with source expectations.                   |
 | `pnpm repair:topic-replies --dry-run` | Count topics whose reply aggregates differ from active PostgreSQL replies. |
 
 ## PostgreSQL Constraints
diff --git a/docs/design-system.md b/docs/design-system.md
index 149ea2f..987e84d 100644
--- a/docs/design-system.md
+++ b/docs/design-system.md
@@ -44,16 +44,16 @@ Theme values use OKLCH. Base Nova radius is `0.625rem`; consumers use standard r
 
 ## Page Archetypes
 
-| Archetype | Purpose | Representative routes |
-| --- | --- | --- |
-| feed | filters, feed, optional rail, pagination | `/`, search, stars, collections |
-| reading | readable content, context, replies | topic detail |
-| compose | fields, editor, action footer | topic/reply create and edit |
-| account | constrained identity and settings forms | sign-in, sign-up, settings |
-| directory | responsive people/resource records | profiles, top users, jobs |
-| dashboard | real summaries and recent records | `/admin` |
-| data-list | filters, comparison records, pagination | admin users/topics/config lists |
-| workflow | queues and actionable event records | moderation, reports, audit |
+| Archetype | Purpose                                  | Representative routes           |
+| --------- | ---------------------------------------- | ------------------------------- |
+| feed      | filters, feed, optional rail, pagination | `/`, search, stars, collections |
+| reading   | readable content, context, replies       | topic detail                    |
+| compose   | fields, editor, action footer            | topic/reply create and edit     |
+| account   | constrained identity and settings forms  | sign-in, sign-up, settings      |
+| directory | responsive people/resource records       | profiles, top users, jobs       |
+| dashboard | real summaries and recent records        | `/admin`                        |
+| data-list | filters, comparison records, pagination  | admin users/topics/config lists |
+| workflow  | queues and actionable event records      | moderation, reports, audit      |
 
 Public entry and explanatory pages use the larger marketing `PageHeader`. Task-oriented pages use the compact variant with breadcrumbs above the title surface. Both variants share the same brand surface, title hierarchy, description treatment, radius, and action alignment; scale and surrounding context distinguish a Hero from an application header.
 
@@ -67,14 +67,14 @@ Review representative pages at 375px, 768px, 1280px, and 1440px in light and dar
 
 Admin data that requires column comparison remains one scrollable Table. Task-oriented records use responsive Item composition. Do not maintain separate mobile and desktop behavior trees.
 
-| Admin route | Narrow-screen decision | Priority |
-| --- | --- | --- |
-| users, bans | scrollable Table | identity/rule, status, action |
-| topics | scrollable Table | selection, title, status, metrics, action |
-| tabs, zones, keywords | scrollable inline-edit Table | key fields and save/delete action |
-| reports, audit, moderation | responsive Item/workflow record | status, target, reason/detail, action |
-| dashboard | Item summaries | identity/title and timestamp |
-| settings | constrained FieldSet | label, control, validation, save action |
+| Admin route                | Narrow-screen decision          | Priority                                  |
+| -------------------------- | ------------------------------- | ----------------------------------------- |
+| users, bans                | scrollable Table                | identity/rule, status, action             |
+| topics                     | scrollable Table                | selection, title, status, metrics, action |
+| tabs, zones, keywords      | scrollable inline-edit Table    | key fields and save/delete action         |
+| reports, audit, moderation | responsive Item/workflow record | status, target, reason/detail, action     |
+| dashboard                  | Item summaries                  | identity/title and timestamp              |
+| settings                   | constrained FieldSet            | label, control, validation, save action   |
 
 ## Markdown
 
diff --git a/docs/development.md b/docs/development.md
index 805c3d7..314c6bc 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -4,12 +4,12 @@ This guide gets a local cnode-next workspace running. It is not a production dep
 
 ## Requirements
 
-| Requirement | Version or rule |
-| ----------- | --------------- |
-| Node.js | `>= 24.0.0` |
-| pnpm | Managed by `packageManager` and Corepack. |
-| PostgreSQL | Required. SQLite is not supported. |
-| Redis | Required for sessions, cache, rate limits, and worker paths. |
+| Requirement | Version or rule                                              |
+| ----------- | ------------------------------------------------------------ |
+| Node.js     | `>= 24.0.0`                                                  |
+| pnpm        | Managed by `packageManager` and Corepack.                    |
+| PostgreSQL  | Required. SQLite is not supported.                           |
+| Redis       | Required for sessions, cache, rate limits, and worker paths. |
 
 ## Environment
 
@@ -72,10 +72,10 @@ pnpm dev
 
 Local endpoints:
 
-| Service | URL |
-| ------- | --- |
-| Web | `http://localhost:5173` |
-| API | `http://localhost:3001` |
+| Service | URL                     |
+| ------- | ----------------------- |
+| Web     | `http://localhost:5173` |
+| API     | `http://localhost:3001` |
 
 Quick smoke:
 
@@ -86,35 +86,35 @@ curl -fsS 'http://localhost:5173/'
 
 ## Common Commands
 
-| Command | Use |
-| ------- | --- |
-| `pnpm dev` | Start Web and API locally. |
-| `pnpm lint` | Run oxlint. |
-| `pnpm typecheck` | Run TypeScript checks across the workspace. |
-| `pnpm test` | Run package tests. |
-| `pnpm build` | Build all apps/packages. |
-| `pnpm db:push:pg` | Create or update the PostgreSQL schema. |
-| `pnpm db:seed` | Seed development data. |
-| `pnpm migrate:mongo-to-pg` | Run explicit Mongo-to-PostgreSQL migration tooling. |
-| `pnpm migrate:reconcile` | Reconcile migrated data. |
-| `pnpm verify` | Full validation gate. Run before release or PR validation when feasible. |
+| Command                    | Use                                                                      |
+| -------------------------- | ------------------------------------------------------------------------ |
+| `pnpm dev`                 | Start Web and API locally.                                               |
+| `pnpm lint`                | Run oxlint.                                                              |
+| `pnpm typecheck`           | Run TypeScript checks across the workspace.                              |
+| `pnpm test`                | Run package tests.                                                       |
+| `pnpm build`               | Build all apps/packages.                                                 |
+| `pnpm db:push:pg`          | Create or update the PostgreSQL schema.                                  |
+| `pnpm db:seed`             | Seed development data.                                                   |
+| `pnpm migrate:mongo-to-pg` | Run explicit Mongo-to-PostgreSQL migration tooling.                      |
+| `pnpm migrate:reconcile`   | Reconcile migrated data.                                                 |
+| `pnpm verify`              | Full validation gate. Run before release or PR validation when feasible. |
 
 ## Environment Loading Matrix
 
 Runtime commands keep their default command shape and load root `.env` from their natural config or script entrypoints. Explicit profiles override root `.env` values with `CNODE_ENV_FILE`, while shell/CI/compose-provided variables remain authoritative.
 
-| Command | Local env behavior |
-| ------- | ------------------ |
-| `pnpm dev` | Keeps existing Web/API scripts; Web loads root `.env` from `apps/web/vite.config.ts`, API from `apps/api/src/load-env.ts`. |
-| `pnpm --filter @cnode/web dev` | Keeps `react-router dev`; Vite config loads root `.env`. |
-| `pnpm --filter @cnode/web build` | Keeps `react-router build`; Vite config loads root `.env`. |
-| `pnpm --filter @cnode/web typecheck` | Keeps `react-router typegen && tsc --noEmit`; Vite config loads root `.env` for React Router typegen. |
-| `pnpm --filter @cnode/api dev` | Keeps `tsx watch src/index.ts`; API runtime loader loads root `.env`. |
-| `pnpm --filter @cnode/api worker:moderation` | Keeps worker command; API worker imports the runtime loader. |
-| `pnpm db:push:pg`, `pnpm db:generate` | Keep `drizzle-kit` commands; Drizzle config loads root `.env`. |
-| `pnpm db:migrate`, `pnpm db:seed` | Keep `tsx src/*` commands; DB scripts load root `.env`. |
-| `pnpm migrate:mongo-to-pg`, `pnpm migrate:reconcile` | Keep root `tsx scripts/*` commands; scripts load root `.env`; non-default profiles require explicit `CNODE_ENV_FILE`. |
-| `pnpm lint`, `pnpm format`, `pnpm secrets:scan` | Do not load local dotenv files. |
+| Command                                              | Local env behavior                                                                                                         |
+| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `pnpm dev`                                           | Keeps existing Web/API scripts; Web loads root `.env` from `apps/web/vite.config.ts`, API from `apps/api/src/load-env.ts`. |
+| `pnpm --filter @cnode/web dev`                       | Keeps `react-router dev`; Vite config loads root `.env`.                                                                   |
+| `pnpm --filter @cnode/web build`                     | Keeps `react-router build`; Vite config loads root `.env`.                                                                 |
+| `pnpm --filter @cnode/web typecheck`                 | Keeps `react-router typegen && tsc --noEmit`; Vite config loads root `.env` for React Router typegen.                      |
+| `pnpm --filter @cnode/api dev`                       | Keeps `tsx watch src/index.ts`; API runtime loader loads root `.env`.                                                      |
+| `pnpm --filter @cnode/api worker:moderation`         | Keeps worker command; API worker imports the runtime loader.                                                               |
+| `pnpm db:push:pg`, `pnpm db:generate`                | Keep `drizzle-kit` commands; Drizzle config loads root `.env`.                                                             |
+| `pnpm db:migrate`, `pnpm db:seed`                    | Keep `tsx src/*` commands; DB scripts load root `.env`.                                                                    |
+| `pnpm migrate:mongo-to-pg`, `pnpm migrate:reconcile` | Keep root `tsx scripts/*` commands; scripts load root `.env`; non-default profiles require explicit `CNODE_ENV_FILE`.      |
+| `pnpm lint`, `pnpm format`, `pnpm secrets:scan`      | Do not load local dotenv files.                                                                                            |
 
 Example explicit rehearsal profile:
 
diff --git a/docs/openspec-governance.md b/docs/openspec-governance.md
index 4e0d36d..c396066 100644
--- a/docs/openspec-governance.md
+++ b/docs/openspec-governance.md
@@ -58,15 +58,15 @@ Every proposal must state how `docs/` and `wiki/` are affected. The answer can b
 
 `docs/` describes current development, runtime, architecture, database, API, moderation, security, migration, and deployment tasks. `wiki/` preserves sourced business knowledge, legacy behavior, migration background, community rules, and facts that need review. Do not write implementation logs into either domain.
 
-| Change kind | Usually update |
-| --- | --- |
-| Runtime architecture, request flow, worker boundary | `docs/architecture.md` |
-| Local development or verification commands | `docs/development.md`, `docs/conventions.md` |
-| PostgreSQL schema, migration, index, data repair | `docs/database.md`, `wiki/migration-background.md` |
-| Security, auth, roles, audit, secret handling | `docs/security.md` |
-| Content moderation operation | `docs/content-moderation.md`, `wiki/community-rules.md` |
-| Business rule or legacy behavior | `wiki/business-rules.md`, `wiki/legacy-behavior.md` |
-| Mongo to PostgreSQL mapping or migration background | `wiki/migration-background.md` |
+| Change kind                                         | Usually update                                          |
+| --------------------------------------------------- | ------------------------------------------------------- |
+| Runtime architecture, request flow, worker boundary | `docs/architecture.md`                                  |
+| Local development or verification commands          | `docs/development.md`, `docs/conventions.md`            |
+| PostgreSQL schema, migration, index, data repair    | `docs/database.md`, `wiki/migration-background.md`      |
+| Security, auth, roles, audit, secret handling       | `docs/security.md`                                      |
+| Content moderation operation                        | `docs/content-moderation.md`, `wiki/community-rules.md` |
+| Business rule or legacy behavior                    | `wiki/business-rules.md`, `wiki/legacy-behavior.md`     |
+| Mongo to PostgreSQL mapping or migration background | `wiki/migration-background.md`                          |
 
 Wiki updates must follow `wiki/writing-guidelines.md`: cite sources, separate facts from inferences, and mark uncertain statements as `To Confirm`.
 
@@ -74,14 +74,14 @@ Wiki updates must follow `wiki/writing-guidelines.md`: cite sources, separate fa
 
 Use diagrams when prose alone would hide boundaries, ordering, or risk.
 
-| Impact | Preferred form |
-| --- | --- |
-| Architecture or module boundary | Mermaid `flowchart` or `graph` |
-| Request, auth, or integration flow | Mermaid `sequenceDiagram` |
-| Data model or relationship | Mermaid `erDiagram` or a field table |
-| Lifecycle or state transition | Mermaid `stateDiagram-v2` |
-| Permission boundary | Matrix table or Mermaid `flowchart` |
-| Migration, backfill, or release ordering | Mermaid `flowchart LR` |
+| Impact                                   | Preferred form                       |
+| ---------------------------------------- | ------------------------------------ |
+| Architecture or module boundary          | Mermaid `flowchart` or `graph`       |
+| Request, auth, or integration flow       | Mermaid `sequenceDiagram`            |
+| Data model or relationship               | Mermaid `erDiagram` or a field table |
+| Lifecycle or state transition            | Mermaid `stateDiagram-v2`            |
+| Permission boundary                      | Matrix table or Mermaid `flowchart`  |
+| Migration, backfill, or release ordering | Mermaid `flowchart LR`               |
 
 If no diagram is needed, explain why the change is single-boundary or clear enough in prose.
 
diff --git a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/admin-dashboard/spec.md
index c1afebc..955c4c2 100644
--- a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/admin-dashboard/spec.md
@@ -5,21 +5,25 @@
 系统 MUST 在前台用户页、帖子详情页和回复项中向有权限的管理人员展示就地管理动作入口，并且所有动作必须通过后端管理 API 校验权限和写入审计日志。
 
 #### Scenario: 管理员在用户页看到用户管理入口
+
 - **WHEN** admin 访问任意用户主页
 - **THEN** 页面 MUST 显示 block 或 unblock 操作入口
 - **AND** 当前用户状态 MUST 决定显示封禁或解禁动作
 
 #### Scenario: 版主或管理员在帖子页看到内容管理入口
+
 - **WHEN** admin 或 mod 访问帖子详情页
 - **THEN** 页面 MUST 显示删除帖子、置顶切换和高亮切换入口
 - **AND** 普通登录用户和匿名用户 MUST NOT 看到这些管理入口
 
 #### Scenario: 版主或管理员在回复项看到删除入口
+
 - **WHEN** admin 或 mod 查看帖子详情页中的回复列表
 - **THEN** 每条未删除回复 MUST 提供删除回复入口
 - **AND** 删除回复入口 MUST 明确表示目标是回复而不是整帖
 
 #### Scenario: 管理动作反馈和审计
+
 - **WHEN** 管理人员执行任意前台管理动作
 - **THEN** 系统 MUST 显示成功或失败反馈
 - **AND** 成功后 MUST 刷新当前页面数据
diff --git a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/comment-reply-experience/spec.md b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/comment-reply-experience/spec.md
index 7c52a04..38adfbf 100644
--- a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/comment-reply-experience/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/comment-reply-experience/spec.md
@@ -5,15 +5,18 @@
 系统 MUST 在回复项上为 admin 和 mod 提供删除回复入口，入口必须符合现有线性评论流体验，并且不得误导为删除整帖。
 
 #### Scenario: 回复项显示删除回复入口
+
 - **WHEN** admin 或 mod 查看帖子详情页回复列表
 - **THEN** 每条未删除回复 MUST 显示删除回复操作
 - **AND** 操作文案 MUST 明确目标为回复
 
 #### Scenario: 删除回复后刷新评论流
+
 - **WHEN** admin 或 mod 成功删除回复
 - **THEN** 页面 MUST 刷新评论流或移除该回复
 - **AND** 评论楼层或 anchor 展示不得出现坏链接或死控件
 
 #### Scenario: 普通用户不看到管理删除入口
+
 - **WHEN** 普通登录用户或匿名用户查看回复列表
 - **THEN** 页面 MUST NOT 显示管理删除回复入口
diff --git a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/content-lifecycle/spec.md b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/content-lifecycle/spec.md
index 44c54a2..da8c2c9 100644
--- a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/content-lifecycle/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/content-lifecycle/spec.md
@@ -5,6 +5,7 @@
 系统 MUST 允许 admin 和 mod 在帖子详情页执行内容删除动作，删除帖子和删除回复必须保持不同目标粒度，并且删除后公共列表与详情不再展示对应内容。
 
 #### Scenario: 版主或管理员删除帖子
+
 - **WHEN** admin 或 mod 在帖子详情页删除帖子
 - **THEN** 系统 MUST 将目标话题标记为已删除
 - **AND** 目标话题 MUST 不再出现在公开话题列表
@@ -12,6 +13,7 @@
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 版主或管理员删除回复
+
 - **WHEN** admin 或 mod 在回复项上删除回复
 - **THEN** 系统 MUST 只将目标回复标记为已删除
 - **AND** 系统 MUST 维护回复作者积分、回复数和话题回复数
@@ -20,11 +22,13 @@
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 删除动作目标粒度明确
+
 - **WHEN** 管理人员查看帖子详情页的删除按钮
 - **THEN** UI MUST 使用“删除帖子”和“删除回复”等明确文案
 - **AND** 不得用同一个模糊动作同时表示删除帖子和删除回复
 
 #### Scenario: 非管理人员不可执行前台内容删除
+
 - **WHEN** 非 admin 且非 mod 用户尝试调用前台内容管理删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标帖子或回复状态保持不变
diff --git a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/topic-pin-management/spec.md b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/topic-pin-management/spec.md
index a6be6b2..91966ed 100644
--- a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/topic-pin-management/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/topic-pin-management/spec.md
@@ -5,24 +5,28 @@
 系统 MUST 允许 admin 和 mod 在帖子详情页对当前话题执行置顶/取消置顶和高亮/取消高亮，并保证公开展示状态与后台管理一致。
 
 #### Scenario: 帖子详情页置顶切换
+
 - **WHEN** admin 或 mod 在帖子详情页对未置顶话题执行置顶操作
 - **THEN** 系统 MUST 将目标话题 `top` 设置为 true
 - **AND** 公开话题列表 MUST 优先展示该话题并显示置顶状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页取消置顶
+
 - **WHEN** admin 或 mod 在帖子详情页对已置顶话题执行取消置顶操作
 - **THEN** 系统 MUST 将目标话题 `top` 设置为 false
 - **AND** 公开话题列表 MUST 不再显示该话题为置顶状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页高亮切换
+
 - **WHEN** admin 或 mod 在帖子详情页对普通话题执行高亮操作
 - **THEN** 系统 MUST 将目标话题 `good` 设置为 true
 - **AND** 话题详情和列表 MUST 展示高亮或精华状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页取消高亮
+
 - **WHEN** admin 或 mod 在帖子详情页对已高亮话题执行取消高亮操作
 - **THEN** 系统 MUST 将目标话题 `good` 设置为 false
 - **AND** 话题详情和列表 MUST 不再展示高亮或精华状态
diff --git a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/user-management/spec.md b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/user-management/spec.md
index a21ca6a..123ab67 100644
--- a/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/user-management/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-admin-user-content-actions/specs/user-management/spec.md
@@ -5,18 +5,21 @@
 系统 MUST 允许 admin 在用户主页对目标用户执行 block/unblock 操作，操作效果必须与后台用户管理中的禁言/解禁一致。
 
 #### Scenario: 用户页封禁用户
+
 - **WHEN** admin 在用户主页点击封禁用户
 - **THEN** 系统 MUST 将目标用户 `is_block` 设置为 true
 - **AND** 目标用户 MUST 无法继续发帖、回复或点赞
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 用户页解禁用户
+
 - **WHEN** admin 在已封禁用户主页点击解禁用户
 - **THEN** 系统 MUST 将目标用户 `is_block` 设置为 false
 - **AND** 目标用户恢复普通用户可执行的发帖、回复和点赞能力
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 非管理员不可在用户页封禁或解禁
+
 - **WHEN** 非 admin 用户尝试调用用户页封禁或解禁接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标用户 `is_block` 状态保持不变
diff --git a/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/content-moderation/spec.md b/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/content-moderation/spec.md
index f357631..899531d 100644
--- a/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/content-moderation/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/content-moderation/spec.md
@@ -5,11 +5,13 @@
 巡检命中队列依赖扫描任务生成，系统 SHALL 提供管理员可操作的任务执行控制，避免任务因轮询间隔或误创建而长期堆积。
 
 #### Scenario: 管理员立即推进巡检队列
+
 - **WHEN** 管理员发现巡检任务处于 pending 或 paused
 - **THEN** 管理员 MUST 能触发立即执行
 - **AND** 系统 MUST 尽快开始或恢复扫描
 
 #### Scenario: 管理员取消误创建任务
+
 - **WHEN** 管理员发现巡检任务范围或触发原因错误
 - **THEN** 管理员 MUST 能取消未完成任务
 - **AND** 取消任务 MUST 不再继续产生命中记录
diff --git a/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/moderation-scan-jobs/spec.md b/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/moderation-scan-jobs/spec.md
index 11f5c7e..28c8865 100644
--- a/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/moderation-scan-jobs/spec.md
+++ b/openspec/changes/archive/2026-07-26-add-moderation-scan-job-controls/specs/moderation-scan-jobs/spec.md
@@ -5,17 +5,20 @@
 系统 MUST 允许 admin 对未完成的巡检任务执行立即执行操作，使任务不必等待 worker 的下一次固定轮询。
 
 #### Scenario: 立即执行 pending 任务
+
 - **WHEN** admin 对 pending 巡检任务点击立即执行
 - **THEN** 系统 MUST 触发 worker 尽快 claim 该任务
 - **AND** HTTP 请求 MUST 在触发成功后返回，不等待扫描完成
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 立即执行 paused 任务
+
 - **WHEN** admin 对 paused 巡检任务点击立即执行
 - **THEN** 系统 MUST 将任务恢复为可执行状态
 - **AND** worker MUST 从最后成功游标继续扫描
 
 #### Scenario: 立即执行 running 任务
+
 - **WHEN** admin 对 running 巡检任务点击立即执行
 - **THEN** 系统 MUST 不创建重复扫描实例
 - **AND** 若 worker 已在处理该任务，系统 MUST 返回成功或当前运行状态
@@ -25,18 +28,21 @@
 系统 MUST 允许 admin 取消 pending、paused 或 running 巡检任务。取消后的任务 MUST 进入 `cancelled` 终态，并且不得继续被 worker claim 或继续扫描。
 
 #### Scenario: 取消 pending 任务
+
 - **WHEN** admin 取消 pending 巡检任务
 - **THEN** 任务状态 MUST 变为 `cancelled`
 - **AND** worker MUST 不再 claim 该任务
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 取消 running 任务
+
 - **WHEN** admin 取消 running 巡检任务
 - **THEN** worker MUST 在当前 batch 结束后停止继续扫描
 - **AND** 任务状态 MUST 保持 `cancelled`
 - **AND** 取消后 MUST 不再新增该任务的扫描命中
 
 #### Scenario: 取消已完成任务
+
 - **WHEN** admin 尝试取消 done、failed 或 cancelled 任务
 - **THEN** 系统 MUST 返回失败或幂等响应
 - **AND** 不得改变任务终态和扫描结果
@@ -46,12 +52,14 @@
 系统 SHALL 在后台任务列表展示立即执行和取消所需状态，并防止普通用户调用任务控制接口。
 
 #### Scenario: 任务列表展示操作按钮
+
 - **WHEN** admin 查看巡检任务列表
 - **THEN** pending、paused 和 running 任务 MUST 展示取消入口
 - **AND** pending 或 paused 任务 MUST 展示立即执行入口
 - **AND** done、failed、cancelled 任务 MUST NOT 展示会改变状态的执行入口
 
 #### Scenario: 非管理员不可控制任务
+
 - **WHEN** 非 admin 用户调用立即执行或取消接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标任务状态保持不变
diff --git a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/api-contract/spec.md b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/api-contract/spec.md
index d982b92..0b1d482 100644
--- a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/api-contract/spec.md
+++ b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/api-contract/spec.md
@@ -5,26 +5,31 @@
 `/api/v1/*` 中面向公开客户端的话题列表、用户聚合和收藏查询 SHALL 排除不可公开话题。不可公开话题包括 `deleted=true`、`status='deleted'`、`tab` 为 `dev` 或 `test`、以及作者处于 block 状态的话题。mute 状态只限制写入，不影响已有内容公开可见性。
 
 #### Scenario: 获取公开话题列表排除内部和受限内容
+
 - **WHEN** 调用 `GET /api/v1/topics?page=1&limit=20&tab=all`
 - **THEN** 返回的话题 MUST 不包含 `tab=dev` 或 `tab=test` 的话题
 - **AND** MUST 不包含已删除话题
 - **AND** MUST 不包含作者已被 block 的话题
 
 #### Scenario: 获取公开话题列表按指定 tab 查询
+
 - **WHEN** 调用 `GET /api/v1/topics?tab=share` 或其他公开 tab
 - **THEN** 返回的话题 MUST 仍然排除已删除话题和作者已被 block 的话题
 - **AND** 当请求 `tab=dev` 或 `tab=test` 时，公共 API MUST 返回空列表或权限错误，而不是公开内部内容
 
 #### Scenario: 收藏 API 排除不可公开话题
+
 - **WHEN** 调用 `GET /api/v1/topic_collect/:loginname`
 - **THEN** 返回的话题 MUST 不包含已删除、内部 tab 或作者已被 block 的话题
 
 #### Scenario: 用户聚合 API 排除不可公开话题
+
 - **WHEN** 调用 `GET /api/v1/user/:loginname`
 - **THEN** `recent_topics` 和 `recent_replies` MUST 只包含公开可见话题
 - **AND** 回复聚合 MUST 排除所属话题不可公开的回复记录
 
 #### Scenario: mute 用户内容仍按普通公开规则展示
+
 - **WHEN** 某用户仅处于 mute 状态且未处于 block 状态
 - **THEN** 该用户已有话题 MUST 按 tab、deleted 和 status 等普通公开规则决定是否展示
 - **AND** 公共 API MUST NOT 仅因 mute 状态隐藏其已有话题
diff --git a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/content-lifecycle/spec.md b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/content-lifecycle/spec.md
index 194c5d0..dfcce99 100644
--- a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/content-lifecycle/spec.md
+++ b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/content-lifecycle/spec.md
@@ -5,25 +5,30 @@
 公共查询 SHALL 使用统一内容可见性规则：隐藏已删除话题、内部 tab 话题、被 block 用户创建的话题，以及所属话题不可见的回复聚合。mute 用户只受写入限制，不因 mute 自动隐藏历史内容。
 
 #### Scenario: 已删除话题不可公开
+
 - **WHEN** 话题 `deleted=true` 或 `status='deleted'`
 - **THEN** 该话题 MUST 不出现在任何公共列表、sidebar、用户聚合或收藏结果中
 - **AND** 普通用户访问详情 MUST 得到不存在或不可见响应
 
 #### Scenario: 内部 tab 话题不可公开
+
 - **WHEN** 话题 `tab=dev` 或 `tab=test`
 - **THEN** 该话题 MUST 不出现在首页 feed、最新回复、无人回复、用户话题、用户参与或用户收藏中
 
 #### Scenario: 被 block 用户创建的话题不可公开
+
 - **WHEN** 话题作者处于 block 状态
 - **THEN** 该话题 MUST 不出现在公共列表、sidebar、用户聚合或收藏结果中
 - **AND** 其他用户在该话题下的回复也 MUST 不通过最新回复或用户参与聚合曝光该话题
 
 #### Scenario: 被 mute 用户不能新增内容但历史内容不自动隐藏
+
 - **WHEN** 用户处于 mute 状态且未处于 block 状态
 - **THEN** 该用户 MUST 不能新增话题或回复
 - **AND** 该用户已有话题 MUST 不因 mute 状态被公共查询隐藏
 
 #### Scenario: 管理后台不受公共过滤影响
+
 - **WHEN** 管理员访问后台话题、用户、巡检或审计页面
 - **THEN** 系统 MAY 展示 dev/test、已删除或 block 用户内容用于运营处理
 - **AND** 这些后台入口 MUST 继续由后端权限校验保护
diff --git a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/home-sidebar-information/spec.md b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/home-sidebar-information/spec.md
index d0bf461..f08e3c1 100644
--- a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/home-sidebar-information/spec.md
+++ b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/home-sidebar-information/spec.md
@@ -5,20 +5,24 @@
 首页 sidebar 的最新回复和无人回复模块 SHALL 使用与首页公开 feed 一致的可见性规则，不能显示内部 tab、已删除内容或被 block 用户创建的话题。仅处于 mute 状态的用户内容不应因此被隐藏。
 
 #### Scenario: 最新回复排除内部话题
+
 - **WHEN** 首页 sidebar 加载最新回复
 - **THEN** 最新回复 MUST 不包含所属话题 `tab=dev` 或 `tab=test` 的回复
 - **AND** 点击最新回复不得进入内部话题详情
 
 #### Scenario: 最新回复排除受限话题
+
 - **WHEN** 最新回复属于已删除话题或作者已被 block 的话题
 - **THEN** 该回复 MUST 不出现在最新回复模块
 
 #### Scenario: 无人回复排除内部和受限话题
+
 - **WHEN** 首页 sidebar 加载无人回复话题
 - **THEN** 无人回复列表 MUST 不包含 `dev/test` 话题
 - **AND** MUST 不包含已删除话题
 - **AND** MUST 不包含作者已被 block 的话题
 
 #### Scenario: mute 用户内容不从 sidebar 自动隐藏
+
 - **WHEN** 话题作者仅处于 mute 状态且未处于 block 状态
 - **THEN** 最新回复和无人回复模块 MUST 按普通公开规则决定是否展示该话题
diff --git a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-management/spec.md b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-management/spec.md
index 10b84d7..aa76934 100644
--- a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-management/spec.md
+++ b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-management/spec.md
@@ -5,18 +5,21 @@
 系统 SHALL 为 admin 提供 block/unblock 和 mute/unmute 两组独立用户操作。block 控制目标用户内容在公共接口和公共页面中的可见性；mute 控制目标用户继续新增话题和回复的能力。
 
 #### Scenario: 管理员 block 用户
+
 - **WHEN** admin 对目标用户执行 block
 - **THEN** 系统 MUST 将目标用户标记为 block 状态
 - **AND** 目标用户创建的话题 MUST 不再出现在公共列表、sidebar、用户聚合和收藏结果中
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 unblock 用户
+
 - **WHEN** admin 对处于 block 状态的目标用户执行 unblock
 - **THEN** 系统 MUST 取消目标用户 block 状态
 - **AND** 目标用户已有内容恢复按普通公开规则展示
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 mute 用户
+
 - **WHEN** admin 对目标用户执行 mute
 - **THEN** 系统 MUST 将目标用户标记为 mute 状态
 - **AND** 目标用户 MUST 无法新增话题或回复
@@ -24,12 +27,14 @@
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 unmute 用户
+
 - **WHEN** admin 对处于 mute 状态的目标用户执行 unmute
 - **THEN** 系统 MUST 取消目标用户 mute 状态
 - **AND** 目标用户恢复新增话题和回复能力，除非仍受其他限制
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 历史禁言状态兼容
+
 - **WHEN** 系统部署 block/mute 双状态
 - **THEN** 现有 `is_block=true` 用户 MUST 不恢复新增话题或回复能力
 - **AND** 迁移或兼容逻辑 MUST 将这些用户视为已 mute，直到 admin 明确 unmute
@@ -39,6 +44,7 @@
 系统 SHALL 在用户主页为 admin 提供删除目标用户所有发言的入口，行为对齐 `nodeclub/web_router.js` 中 `POST /user/:name/delete_all` 的管理员操作。
 
 #### Scenario: 管理员在用户主页删除用户所有发言
+
 - **WHEN** admin 访问任意用户主页
 - **THEN** 页面 MUST 显示“删除该用户所有发言”或等价明确文案的操作入口
 - **AND** 操作前 MUST 要求确认目标用户和影响范围
@@ -46,12 +52,14 @@
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 非管理员不可批量删除用户发言
+
 - **WHEN** 非 admin 用户访问用户主页或直接调用批量删除接口
 - **THEN** 页面 MUST NOT 显示批量删除入口
 - **AND** 后端 MUST 返回权限错误
 - **AND** 目标用户内容状态保持不变
 
 #### Scenario: 批量删除后公开接口不可见
+
 - **WHEN** admin 成功删除某用户所有发言
 - **THEN** 该用户话题 MUST 不再出现在首页、用户话题、用户参与、用户收藏、最新回复和无人回复等公共入口
 - **AND** 该用户回复 MUST 不再出现在话题详情回复列表和最新回复模块
diff --git a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-profile-experience/spec.md b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-profile-experience/spec.md
index e31ad56..20185b9 100644
--- a/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-profile-experience/spec.md
+++ b/openspec/changes/archive/2026-07-26-align-public-content-visibility-rules/specs/user-profile-experience/spec.md
@@ -5,6 +5,7 @@
 用户主页、用户话题、用户参与和用户收藏列表 SHALL 只展示公开可见内容，并保持分页 total 与过滤后的结果一致。block 用户内容不可公开；仅处于 mute 状态的用户内容不应因此被隐藏。
 
 #### Scenario: 用户话题列表过滤内部和受限内容
+
 - **WHEN** 用户访问 `/user/:name/topics?page=N`
 - **THEN** 列表 MUST 排除 `tab=dev` 或 `tab=test` 的话题
 - **AND** MUST 排除已删除话题
@@ -13,16 +14,19 @@
 - **AND** total MUST 按相同过滤条件计算
 
 #### Scenario: 用户参与列表过滤不可公开所属话题
+
 - **WHEN** 用户访问 `/user/:name/replies?page=N`
 - **THEN** 列表 MUST 排除已删除回复
 - **AND** MUST 排除所属话题为 dev/test、已删除或作者已被 block 的回复聚合
 - **AND** total MUST 按过滤后的去重话题计算
 
 #### Scenario: 用户收藏列表过滤不可公开话题
+
 - **WHEN** 用户访问 `/user/:name/collections?page=N`
 - **THEN** 列表 MUST 排除 dev/test、已删除或作者已被 block 的话题
 - **AND** total MUST 按过滤后的收藏话题计算
 
 #### Scenario: 用户主页 recent 数据过滤不可公开内容
+
 - **WHEN** 用户访问 `/user/:name`
 - **THEN** `recent_topics` 和 `recent_replies` MUST 只包含公开可见话题
diff --git a/openspec/changes/archive/2026-07-26-fix-moderation-scan-job-completion/specs/moderation-scan-jobs/spec.md b/openspec/changes/archive/2026-07-26-fix-moderation-scan-job-completion/specs/moderation-scan-jobs/spec.md
index 046e083..7cc9b22 100644
--- a/openspec/changes/archive/2026-07-26-fix-moderation-scan-job-completion/specs/moderation-scan-jobs/spec.md
+++ b/openspec/changes/archive/2026-07-26-fix-moderation-scan-job-completion/specs/moderation-scan-jobs/spec.md
@@ -5,12 +5,14 @@
 系统 MUST 使用持久化任务记录执行历史和定时内容巡检，任务状态、进度游标、扫描范围和资源限制必须可查询和恢复。任务被 worker 领取后 MUST 执行到 `done`、`failed` 或管理员暂停，不能因为达到单轮批次数限制永久停留在 `running`。
 
 #### Scenario: 创建历史扫描任务
+
 - **WHEN** 管理员新增敏感词或手动发起历史扫描
 - **THEN** 系统 MUST 创建巡检扫描任务
 - **AND** 任务 MUST 记录扫描范围、触发原因、敏感词范围、批大小、限速配置和初始游标
 - **AND** HTTP 请求 MUST 在任务创建后返回，不等待全库扫描完成
 
 #### Scenario: 任务状态流转
+
 - **WHEN** worker 开始处理扫描任务
 - **THEN** 任务状态 MUST 从 `pending` 变为 `running`
 - **AND** worker MUST 在每批完成后更新游标、已扫描数量和命中数量
@@ -19,6 +21,7 @@
 - **AND** worker 达到单轮批次数限制时 MUST 继续处理到完成，或将未完成任务恢复为后续 worker 可领取的状态
 
 #### Scenario: 暂停和恢复任务
+
 - **WHEN** 管理员暂停正在执行的扫描任务
 - **THEN** worker MUST 在当前批次结束后停止继续扫描
 - **AND** 任务 MUST 保留最后成功游标
@@ -26,6 +29,7 @@
 - **THEN** worker MUST 从最后成功游标继续扫描
 
 #### Scenario: 恢复悬挂任务
+
 - **WHEN** worker 重启或上一 worker 崩溃后存在未完成的 `running` 巡检任务
 - **THEN** 后续 worker MUST 能从最后成功游标继续执行该任务
 - **AND** 同一时间 MUST 只有一个 worker 继续执行该任务
@@ -35,6 +39,7 @@
 系统 MUST 按固定大小批次扫描话题和回复，避免单次数据库查询加载大量数据。批次限制和批间休眠 MUST 控制每批资源占用，但不能破坏巡检任务最终完成或可恢复的语义。
 
 #### Scenario: 按游标扫描话题
+
 - **WHEN** worker 扫描话题内容
 - **THEN** 增量任务每批 MUST 使用主键游标读取 `id > cursor` 的话题
 - **AND** 历史任务每批 MUST 从最新话题开始按 `id` 倒序扫描
@@ -42,6 +47,7 @@
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 按游标扫描回复
+
 - **WHEN** worker 扫描回复内容
 - **THEN** 增量任务每批 MUST 使用主键游标读取 `id > cursor` 的回复
 - **AND** 历史任务每批 MUST 从最新回复开始按 `id` 倒序扫描
@@ -49,11 +55,13 @@
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 扫描限速
+
 - **WHEN** worker 完成一个扫描批次
 - **THEN** worker MUST 按任务配置或环境变量休眠指定时间
 - **AND** worker MUST 控制单批处理规模，避免一次性占用大量 CPU 和数据库连接
 
 #### Scenario: 超过单轮批次数的数据集
+
 - **WHEN** 巡检任务的数据量超过 `maxBatchesPerRun * batchSize`
 - **THEN** 系统 MUST 保留已完成批次的游标和计数
 - **AND** 任务 MUST 继续执行到 `done` 或保持后续 worker 可继续领取和执行
diff --git a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/proposal.md b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/proposal.md
index 97477e6..a9f25e9 100644
--- a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/proposal.md
+++ b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/proposal.md
@@ -13,9 +13,11 @@
 ## Capabilities
 
 ### New Capabilities
+
 - `admin-list-pagination`: 后台管理列表统一分页契约和 Web 分页体验。
 
 ### Modified Capabilities
+
 - `admin-dashboard`: 后台管理页中承载数据列表的页面需要提供分页访问，不再只显示固定数量结果。
 
 ## Non-goals
diff --git a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-dashboard/spec.md
index 3cc416c..e01a545 100644
--- a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-dashboard/spec.md
@@ -1,24 +1,29 @@
 ## ADDED Requirements
 
 ### Requirement: 后台列表分页访问
+
 系统 MUST 在后台管理中为完整数据列表提供分页访问，避免管理员只能查看接口固定返回的最近记录。
 
 #### Scenario: 话题管理分页
+
 - **WHEN** 管理员或版主访问后台话题管理页
 - **THEN** 页面显示分页后的话题列表
 - **AND** 可以通过页码访问超过当前第一页的数据
 
 #### Scenario: 用户管理分页
+
 - **WHEN** 管理员访问后台用户管理页
 - **THEN** 页面显示分页后的用户列表
 - **AND** 可以通过页码访问超过当前第一页的数据
 
 #### Scenario: 内容治理列表分页
+
 - **WHEN** 管理员访问举报队列、敏感词管理或封禁管理页
 - **THEN** 页面显示分页后的管理列表
 - **AND** 翻页时保留当前筛选或搜索条件
 
 #### Scenario: 审计日志分页
+
 - **WHEN** 管理员访问审计日志页
 - **THEN** 页面显示分页后的审计日志
 - **AND** 可以访问历史审计记录
diff --git a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-list-pagination/spec.md b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-list-pagination/spec.md
index 6034669..e687f86 100644
--- a/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-list-pagination/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-admin-list-pagination/specs/admin-list-pagination/spec.md
@@ -1,50 +1,61 @@
 ## ADDED Requirements
 
 ### Requirement: 后台列表 API 分页契约
+
 后台管理列表 API SHALL 支持页码分页，并返回列表数据和总数信息。
 
 #### Scenario: 请求第一页后台列表
+
 - **WHEN** 管理员请求支持分页的后台列表接口且未提供 `page`
 - **THEN** 系统按 `page=1` 处理
 - **AND** 响应包含 `data`、`total`、`page`、`limit`
 
 #### Scenario: 请求指定页后台列表
+
 - **WHEN** 管理员请求支持分页的后台列表接口并提供 `page=3&limit=20`
 - **THEN** 系统返回第 3 页数据
 - **AND** `limit` 为 20
 - **AND** `total` 为符合当前筛选条件的总记录数
 
 #### Scenario: 限制过大 limit
+
 - **WHEN** 管理员请求支持分页的后台列表接口并提供超过最大值的 `limit`
 - **THEN** 系统使用允许的最大 `limit`
 - **AND** 响应中的 `limit` MUST 反映实际使用值
 
 #### Scenario: 空页返回稳定结构
+
 - **WHEN** 管理员请求超出数据范围的页码
 - **THEN** 系统返回空 `data` 数组
 - **AND** 仍返回正确的 `total`、`page`、`limit`
 
 ### Requirement: 后台分页页面体验
+
 后台管理页面 SHALL 使用分页控件访问完整列表，并在翻页时保留当前筛选和搜索条件。
 
 #### Scenario: 后台表格显示分页控件
+
 - **WHEN** 管理员访问支持分页的后台管理页面且总数超过每页数量
 - **THEN** 页面显示分页控件
 - **AND** 分页控件允许访问上一页、下一页和附近页码
 
 #### Scenario: 翻页保留搜索条件
+
 - **WHEN** 管理员在带搜索条件的后台列表中切换页码
 - **THEN** 新页面 URL 保留当前搜索或筛选参数
 - **AND** 后台接口按这些条件返回对应页数据
 
 ### Requirement: 分页覆盖的后台列表
+
 系统 MUST 为承载完整管理列表的后台接口和页面提供分页，摘要型最近 N 条接口不属于此范围。
 
 #### Scenario: 完整管理列表需要分页
+
 - **WHEN** 后台页面展示话题、用户、审计日志、举报、敏感词、用户封禁或 IP 封禁的完整管理列表
 - **THEN** 对应 API 和 Web 页面 MUST 支持分页
 
 #### Scenario: 概览摘要不分页
+
 - **WHEN** 管理员访问后台概览页的统计卡片或最近 N 条摘要模块
 - **THEN** 系统可以继续返回固定数量摘要数据
 - **AND** 不要求这些摘要接口返回 `total`
diff --git a/openspec/changes/archive/2026-07-27-add-gitleaks-hooks/specs/secret-scanning/spec.md b/openspec/changes/archive/2026-07-27-add-gitleaks-hooks/specs/secret-scanning/spec.md
index 460bd5c..a2191a7 100644
--- a/openspec/changes/archive/2026-07-27-add-gitleaks-hooks/specs/secret-scanning/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-gitleaks-hooks/specs/secret-scanning/spec.md
@@ -5,6 +5,7 @@
 仓库 SHALL 使用根目录 `.gitleaks.toml` 作为 secret scanning 的唯一规则源。所有本地命令、git hooks 和后续 CI 命令 MUST 显式使用该配置文件。
 
 #### Scenario: 手动运行全量扫描
+
 - **WHEN** 开发者运行项目定义的 secret scan 命令
 - **THEN** 命令使用 `.gitleaks.toml`
 - **AND** 输出不得展示完整 secret 值
@@ -14,6 +15,7 @@
 仓库 SHALL 提供一条项目命令安装本地 git hooks。安装命令 MUST 使用 Husky 安装仓库内版本化 hook。
 
 #### Scenario: 安装 hooks
+
 - **WHEN** 开发者运行 hooks 安装命令
 - **THEN** 当前仓库安装了 Husky 管理的本地 hooks
 - **AND** 不修改全局 git 配置
@@ -23,11 +25,13 @@
 本地 pre-commit hook MUST 在创建 commit 前扫描 staged changes。检测到 secret 时 MUST 阻断提交，并提示开发者修复内容或更新 allowlist。
 
 #### Scenario: staged secret 被阻断
+
 - **WHEN** staged changes 包含 `.gitleaks.toml` 规则识别出的 secret
 - **THEN** `git commit` 被阻断
 - **AND** 输出包含运行 gitleaks 的失败提示
 
 #### Scenario: staged changes 无 secret
+
 - **WHEN** staged changes 不包含 secret
 - **THEN** `git commit` 可以继续
 
@@ -36,6 +40,7 @@
 本地 pre-push hook MUST 扫描即将推送的 commit range。检测到 secret 时 MUST 阻断推送。
 
 #### Scenario: 推送范围内 secret 被阻断
+
 - **WHEN** 即将推送的 commit range 包含 secret
 - **THEN** `git push` 被阻断
 - **AND** 输出包含失败原因和手动复查命令
@@ -45,6 +50,7 @@
 本地 hooks MUST 在找不到 `gitleaks` 命令时失败，并提示安装方式或项目文档位置。hooks MUST NOT 静默跳过 secret scanning。
 
 #### Scenario: 未安装 gitleaks
+
 - **WHEN** 开发者运行 `git commit` 或 `git push` 且本机没有 `gitleaks`
 - **THEN** hook 阻断操作
 - **AND** 输出提示安装 gitleaks
@@ -54,5 +60,6 @@
 仓库 SHALL 文档化 secret scanning 的安装流程、手动扫描命令、误报处理方式和临时跳过方式。临时跳过方式 MUST 显式命名为风险操作。
 
 #### Scenario: 开发者查看文档
+
 - **WHEN** 开发者需要配置本地 secret scanning
 - **THEN** 文档提供安装命令、扫描命令、失败处理和跳过风险说明
diff --git a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/admin-dashboard/spec.md
index 58ca13e..5a0b879 100644
--- a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/admin-dashboard/spec.md
@@ -5,24 +5,28 @@
 管理后台 MUST 展示敏感词巡检命中队列，支持管理员对话题和回复命中进行复核处理。
 
 #### Scenario: 查看巡检命中
+
 - **WHEN** 管理员访问 `/admin/moderation`
 - **THEN** 系统 MUST 展示待处理巡检命中列表
 - **AND** 每条命中 MUST 显示目标类型、目标 ID、所属话题、作者、命中词、上下文预览和扫描时间
 - **AND** 管理员 MUST 能跳转查看原始话题或回复所在话题
 
 #### Scenario: 处理话题命中
+
 - **WHEN** 管理员确认话题命中违规
 - **THEN** 系统 MUST 执行话题删除或隐藏动作
 - **AND** 将命中记录标记为已处理
 - **AND** 写入审计日志
 
 #### Scenario: 处理回复命中
+
 - **WHEN** 管理员确认回复命中违规
 - **THEN** 系统 MUST 执行回复删除动作
 - **AND** 将命中记录标记为已处理
 - **AND** 写入审计日志
 
 #### Scenario: 标记误报或忽略
+
 - **WHEN** 管理员将巡检命中标记为误报或忽略
 - **THEN** 系统 MUST 保留原内容可见
 - **AND** 将命中记录从待处理队列移除
@@ -33,15 +37,18 @@
 管理后台 MUST 展示巡检扫描任务状态，并允许管理员对任务进行基础控制。
 
 #### Scenario: 查看扫描任务状态
+
 - **WHEN** 管理员查看巡检任务列表
 - **THEN** 系统 MUST 展示任务状态、扫描范围、触发原因、已扫描数量、命中数量、游标、开始时间、结束时间和错误信息
 
 #### Scenario: 手动创建扫描任务
+
 - **WHEN** 管理员手动发起全量或增量扫描
 - **THEN** 系统 MUST 创建扫描任务
 - **AND** 管理员 MUST 能选择扫描话题、回复或全部内容
 
 #### Scenario: 暂停和恢复扫描任务
+
 - **WHEN** 管理员暂停或恢复扫描任务
 - **THEN** 系统 MUST 更新任务状态
 - **AND** worker MUST 按更新后的状态继续或停止扫描
@@ -53,29 +60,35 @@
 系统 MUST 提供管理概览页，展示社区运营数据和待处理事项。
 
 #### Scenario: 统计卡片
+
 - **WHEN** 管理员访问 /admin 概览页
 - **THEN** 显示当前值卡片: 用户总数、话题总数、回复总数、今日发帖、今日回复、今日注册、待审举报、巡检命中待处理数
 
 #### Scenario: 7 天趋势图
+
 - **WHEN** 管理员查看概览页趋势图
 - **THEN** 显示最近 7 天的折线图，可切换查看: 新增话题数、新增回复数、新增注册用户数、活跃用户数
 
 #### Scenario: 最近注册用户
+
 - **WHEN** 管理员查看概览页
 - **THEN** 显示最近 10 个注册用户 (头像、用户名、注册时间、状态)
 - **AND** 点击可跳转用户主页
 
 #### Scenario: 最近发布话题
+
 - **WHEN** 管理员查看概览页
 - **THEN** 显示最近 10 条话题 (标题、作者、发布时间、状态)
 - **AND** 点击可跳转话题详情
 
 #### Scenario: 待处理事项
+
 - **WHEN** 管理员查看概览页
 - **THEN** 显示待审举报数、巡检命中待处理数、自动封禁用户数
 - **AND** 巡检命中待处理数 MUST 来自待处理巡检命中队列
 - **AND** 每项带跳转链接到对应管理页面
 
 #### Scenario: 最近审计操作
+
 - **WHEN** 管理员查看概览页
 - **THEN** 显示最近 10 条审计日志 (时间、操作人、动作、目标、结果)
diff --git a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/anti-spam/spec.md b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/anti-spam/spec.md
index c3bb2e9..e8384a2 100644
--- a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/anti-spam/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/anti-spam/spec.md
@@ -5,17 +5,20 @@
 系统 MUST 记录管理员操作、系统巡检动作和关键用户行为，可查询追溯。
 
 #### Scenario: 审计日志记录
+
 - **WHEN** 管理员执行操作 (禁言/解禁/删除/置顶/加精/锁定/重置密码/巡检确认删除/巡检误报/巡检忽略/处理举报)
 - **OR** 用户举报/被举报
 - **OR** 系统创建巡检扫描任务、完成巡检扫描任务或自动隐藏内容
 - **THEN** 记录: 时间、操作人或系统标识、动作、目标、结果
 
 #### Scenario: 巡检处理审计
+
 - **WHEN** 管理员处理巡检命中
 - **THEN** 审计日志 MUST 记录命中 ID、目标类型、目标 ID、处理动作和处理结果
 - **AND** 对回复命中 MUST 记录所属话题 ID
 
 #### Scenario: 审计日志查询
+
 - **WHEN** 管理员访问审计日志面板
 - **THEN** 可按操作人/目标/时间范围/动作类型筛选
 - **AND** 日志至少保留 90 天
diff --git a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/content-moderation/spec.md b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/content-moderation/spec.md
index 3ce169d..fdd7ae5 100644
--- a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/content-moderation/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/content-moderation/spec.md
@@ -5,6 +5,7 @@
 系统 MUST 定期巡检已发布的内容，按低负载批处理方式检查话题和回复中的敏感词命中，并将命中内容记录到巡检队列供管理员复核。
 
 #### Scenario: 巡检任务执行
+
 - **WHEN** 定时任务触发
 - **THEN** 系统 MUST 扫描新增或更新的已发布话题和回复
 - **AND** 检测标题、话题内容和回复内容是否包含敏感词
@@ -12,18 +13,21 @@
 - **AND** 记录巡检任务日志，包括时间、扫描条目数、命中条目数和处理结果
 
 #### Scenario: 新增敏感词触发历史扫描
+
 - **WHEN** 管理员新增敏感词
 - **THEN** 系统 MUST 创建针对新增敏感词的历史扫描任务
 - **AND** 历史扫描任务 MUST 覆盖未删除的话题和回复
 - **AND** 新增敏感词请求 MUST 不等待历史扫描完成
 
 #### Scenario: 历史命中不默认隐藏
+
 - **WHEN** 历史扫描发现命中敏感词的话题或回复
 - **THEN** 系统 MUST 将命中记录标记为待复核
 - **AND** 系统 MUST NOT 默认删除或隐藏历史命中内容
 - **AND** 管理员确认违规后才执行删除或隐藏动作
 
 #### Scenario: 管理员可处理巡检命中
+
 - **WHEN** 管理员浏览巡检结果
 - **THEN** 系统 MUST 展示命中对象、命中敏感词、上下文预览、作者和扫描时间
 - **AND** 管理员 MUST 能够确认删除、标记误报或忽略命中
@@ -35,14 +39,17 @@
 系统 MUST 为每个敏感词扫描命中保存可复核记录，覆盖话题和回复两类内容。
 
 #### Scenario: 记录话题命中
+
 - **WHEN** 扫描发现话题标题或内容命中敏感词
 - **THEN** 系统 MUST 保存命中记录，包含 `target_type=topic`、话题 ID、作者 ID、命中词、命中字段和上下文预览
 
 #### Scenario: 记录回复命中
+
 - **WHEN** 扫描发现回复内容命中敏感词
 - **THEN** 系统 MUST 保存命中记录，包含 `target_type=reply`、回复 ID、所属话题 ID、作者 ID、命中词和上下文预览
 
 #### Scenario: 避免重复命中记录
+
 - **WHEN** 同一任务或后续任务再次扫描到同一对象命中同一敏感词
 - **THEN** 系统 MUST 避免创建重复的待处理命中记录
 - **AND** 已处理为误报的命中 MUST NOT 被同一敏感词反复加入待处理队列
diff --git a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/moderation-scan-jobs/spec.md b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/moderation-scan-jobs/spec.md
index d6e716f..4af3764 100644
--- a/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/moderation-scan-jobs/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-low-impact-moderation-scans/specs/moderation-scan-jobs/spec.md
@@ -5,12 +5,14 @@
 系统 MUST 使用持久化任务记录执行历史和定时内容巡检，任务状态、进度游标、扫描范围和资源限制必须可查询和恢复。
 
 #### Scenario: 创建历史扫描任务
+
 - **WHEN** 管理员新增敏感词或手动发起历史扫描
 - **THEN** 系统 MUST 创建巡检扫描任务
 - **AND** 任务 MUST 记录扫描范围、触发原因、敏感词范围、批大小、限速配置和初始游标
 - **AND** HTTP 请求 MUST 在任务创建后返回，不等待全库扫描完成
 
 #### Scenario: 任务状态流转
+
 - **WHEN** worker 开始处理扫描任务
 - **THEN** 任务状态 MUST 从 `pending` 变为 `running`
 - **AND** worker MUST 在每批完成后更新游标、已扫描数量和命中数量
@@ -18,6 +20,7 @@
 - **AND** 任务失败时 MUST 标记为 `failed` 并保存错误信息
 
 #### Scenario: 暂停和恢复任务
+
 - **WHEN** 管理员暂停正在执行的扫描任务
 - **THEN** worker MUST 在当前批次结束后停止继续扫描
 - **AND** 任务 MUST 保留最后成功游标
@@ -29,18 +32,21 @@
 系统 MUST 按固定大小批次扫描话题和回复，避免单次任务加载大量数据或长时间占用数据库连接。
 
 #### Scenario: 按游标扫描话题
+
 - **WHEN** worker 扫描话题内容
 - **THEN** 每批 MUST 使用主键游标读取 `id > cursor` 的话题
 - **AND** 每批 MUST 只读取扫描所需字段
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 按游标扫描回复
+
 - **WHEN** worker 扫描回复内容
 - **THEN** 每批 MUST 使用主键游标读取 `id > cursor` 的回复
 - **AND** 每批 MUST 排除已删除回复
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 扫描限速
+
 - **WHEN** worker 完成一个扫描批次
 - **THEN** worker MUST 按任务配置或环境变量休眠指定时间
 - **AND** worker MUST 限制每轮处理批次数，避免长期占用 CPU 和数据库连接
@@ -50,12 +56,14 @@
 系统 MUST 支持定时创建增量巡检任务，用于检查最近新增或更新的已发布内容。
 
 #### Scenario: 定时任务触发
+
 - **WHEN** 到达配置的巡检周期
 - **THEN** worker MUST 创建或执行增量扫描任务
 - **AND** 任务 MUST 只扫描上次完成后新增或更新的内容
 - **AND** 若已有同类扫描任务未完成，系统 MUST 避免创建重复任务
 
 #### Scenario: 单实例执行
+
 - **WHEN** 多个 worker 进程同时运行
 - **THEN** 同一时间 MUST 只有一个 worker 执行同一个扫描任务
 - **AND** 锁失效或 worker 崩溃后，任务 MUST 能被后续 worker 接管
diff --git a/openspec/changes/archive/2026-07-27-add-topic-pin-management/proposal.md b/openspec/changes/archive/2026-07-27-add-topic-pin-management/proposal.md
index ae4363c..16746a9 100644
--- a/openspec/changes/archive/2026-07-27-add-topic-pin-management/proposal.md
+++ b/openspec/changes/archive/2026-07-27-add-topic-pin-management/proposal.md
@@ -13,9 +13,11 @@
 ## Capabilities
 
 ### New Capabilities
+
 - `topic-pin-management`: 管理员和版主在后台对话题执行置顶/取消置顶，并保证公开列表排序和状态展示与 legacy 行为一致。
 
 ### Modified Capabilities
+
 - `admin-dashboard`: 后台话题管理页的运营操作权限从仅 admin 扩展为 mod 和 admin 可执行置顶管理。
 
 ## Non-goals
diff --git a/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/admin-dashboard/spec.md
index 84e317f..4c8f976 100644
--- a/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/admin-dashboard/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 后台话题置顶管理权限
+
 系统 MUST 在后台话题管理中允许 `mod` 和 `admin` 执行置顶/取消置顶，并且不得因此扩大其他高风险话题管理动作的权限边界。
 
 #### Scenario: 版主访问话题管理置顶操作
+
 - **WHEN** `mod` 访问后台话题管理页
 - **THEN** 系统允许其查看话题列表中的置顶状态
 - **AND** 系统提供置顶切换操作入口
 
 #### Scenario: 管理员访问话题管理置顶操作
+
 - **WHEN** `admin` 访问后台话题管理页
 - **THEN** 系统允许其查看话题列表中的置顶状态
 - **AND** 系统提供置顶切换操作入口
 
 #### Scenario: 其他话题管理动作权限不被扩大
+
 - **WHEN** `mod` 在话题管理页执行非置顶的管理动作
 - **THEN** 系统 MUST 按该动作既有权限要求进行校验
 - **AND** 不得仅因为 `mod` 可置顶而允许其执行删除等 admin-only 操作
diff --git a/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/topic-pin-management/spec.md b/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/topic-pin-management/spec.md
index 372a070..c09ccf6 100644
--- a/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/topic-pin-management/spec.md
+++ b/openspec/changes/archive/2026-07-27-add-topic-pin-management/specs/topic-pin-management/spec.md
@@ -1,39 +1,47 @@
 ## ADDED Requirements
 
 ### Requirement: 后台置顶切换
+
 系统 SHALL 允许 `mod` 和 `admin` 在后台对一个或多个话题执行置顶切换操作，切换行为 MUST 与 legacy nodeclub 的 `POST /topic/:tid/top` 保持一致。
 
 #### Scenario: 版主置顶未置顶话题
+
 - **WHEN** `mod` 在后台话题管理页对未置顶话题执行置顶切换
 - **THEN** 系统将该话题 `top` 设置为 true
 - **AND** 返回操作成功
 - **AND** 后台话题列表显示该话题的“置顶”状态
 
 #### Scenario: 管理员取消已置顶话题
+
 - **WHEN** `admin` 在后台话题管理页对已置顶话题执行置顶切换
 - **THEN** 系统将该话题 `top` 设置为 false
 - **AND** 返回操作成功
 - **AND** 后台话题列表不再显示该话题的“置顶”状态
 
 #### Scenario: 批量切换置顶状态
+
 - **WHEN** `mod` 或 `admin` 选择多个话题并执行置顶切换
 - **THEN** 系统对每个选中话题分别翻转 `top` 状态
 - **AND** 操作不改变话题的 `good`、`lock`、`status`、`deleted`、`reply_count`、`visit_count`、`create_at` 或 `last_reply_at`
 
 #### Scenario: 普通用户不可置顶
+
 - **WHEN** 非 `mod` 且非 `admin` 的用户请求置顶切换接口
 - **THEN** 系统拒绝请求并返回权限错误
 - **AND** 目标话题的 `top` 状态保持不变
 
 ### Requirement: 置顶话题公开展示
+
 系统 MUST 在公开话题列表中优先展示置顶话题，并对置顶话题显示“置顶”标记。
 
 #### Scenario: 首页排序置顶优先
+
 - **WHEN** 用户访问公开话题列表
 - **THEN** `top=true` 的话题排在普通话题前面
 - **AND** 置顶话题之间按 `last_reply_at` 倒序排序
 - **AND** 普通话题之间仍按 `last_reply_at` 倒序排序
 
 #### Scenario: 置顶标记展示
+
 - **WHEN** 公开话题列表返回的话题 `top=true`
 - **THEN** Web 列表项显示“置顶”状态标记
diff --git a/openspec/changes/archive/2026-07-27-complete-nodeclub-online-replacement/legacy-web-url-parity.md b/openspec/changes/archive/2026-07-27-complete-nodeclub-online-replacement/legacy-web-url-parity.md
index e65c769..293f13c 100644
--- a/openspec/changes/archive/2026-07-27-complete-nodeclub-online-replacement/legacy-web-url-parity.md
+++ b/openspec/changes/archive/2026-07-27-complete-nodeclub-online-replacement/legacy-web-url-parity.md
@@ -2,52 +2,52 @@
 
 来源：`nodeclub/web_router.js`
 
-| URL | legacy 行为 | cnode-next 状态 |
-| --- | --- | --- |
-| `/` | 首页话题列表 | 已实现等价页面 |
-| `/sitemap.xml` | XML sitemap | 已实现 XML 响应 |
-| `/app/download` | 跳转移动端 README | 已实现兼容 redirect |
-| `/signup` | 注册页或 GitHub 跳转 | 已实现注册页 |
-| `/signin` | 登录页 | 已实现等价页面 |
-| `/active_account` | 账号激活 | 已实现页面和 API |
-| `/search_pass` | 找回密码 | 已实现页面和 API |
-| `/reset_pass` | 重置密码 | 已实现页面和 API |
-| `/user/:name` | 用户主页 | 已实现等价页面 |
-| `/setting` | 用户设置 | 已实现等价页面 |
-| `/stars` | 达人列表 | 已实现等价页面 |
-| `/users/top100` | 积分榜 | 已实现等价页面 |
-| `/user/:name/collections` | 用户收藏列表 | 已实现页面，分页在本 change 后续任务补齐 |
-| `/user/:name/topics` | 用户话题列表 | 已实现页面，分页在本 change 后续任务补齐 |
-| `/user/:name/replies` | 用户参与列表 | 已实现页面，分页在本 change 后续任务补齐 |
-| `/user/set_star` | 管理员设达人 | 已有 API |
-| `/user/cancel_star` | 管理员取消达人 | 已有 API |
-| `/user/:name/block` | 管理员禁言/解禁 | 已有 API |
-| `/user/:name/delete_all` | 管理员删除用户所有发言 | 已有 API |
-| `/user/refresh_token` | 刷新 accessToken | 已有 API |
-| `/my/messages` | 消息页 | 已实现页面，自动已读在本 change 后续任务补齐 |
-| `/topic/create` | 创建话题页 | 已实现页面 |
-| `/topic/:tid` | 话题详情 | 已实现页面 |
-| `/topic/:tid/top` | 管理员置顶 | 已有 API |
-| `/topic/:tid/good` | 管理员加精 | 已有 API |
-| `/topic/:tid/edit` | 编辑话题 | 已实现页面和 API |
-| `/topic/:tid/lock` | 管理员锁定 | 已有 API |
-| `/topic/:tid/delete` | 删除话题 | 已有 API |
-| `/topic/collect` | 收藏话题 | 已有等价 API |
-| `/topic/de_collect` | 取消收藏 | 已有等价 API |
-| `/:topic_id/reply` | 创建回复 | 已有等价 API/Web 行为 |
-| `/reply/:reply_id/edit` | 编辑回复 | 已实现页面和 API |
-| `/reply/:reply_id/delete` | 删除回复 | 本 change 后续任务补齐 |
-| `/reply/:reply_id/up` | 回复点赞 | 已有等价 API/Web 行为 |
-| `/upload` | 图片上传 | 已有等价 API/Web 行为 |
-| `/about` | 关于页面 | 已实现等价页面 |
-| `/faq` | FAQ 页面 | 已实现等价页面 |
-| `/getstart` | 新手入门 | 已实现等价页面 |
-| `/robots.txt` | robots 文本 | 已实现 text/plain 响应 |
-| `/api` | API 文档页面 | 已实现等价页面 |
-| `/rss` | RSS XML | 已实现 XML 响应 |
-| `/auth/github` | GitHub OAuth 发起 | 已实现入口 |
-| `/auth/github/callback` | GitHub OAuth 回调 | 已实现，关联老账号流程在本 change 后续任务补齐 |
-| `/auth/github/new` | GitHub 新用户选择页 | 本 change 后续任务补齐 |
-| `/auth/github/create` | GitHub 新用户创建/绑定 | 本 change 后续任务补齐 |
-| `/search` | 搜索 | 已实现页面 |
-| `/:name` | 生产用户短路径 | 已实现兼容 redirect |
+| URL                       | legacy 行为            | cnode-next 状态                                |
+| ------------------------- | ---------------------- | ---------------------------------------------- |
+| `/`                       | 首页话题列表           | 已实现等价页面                                 |
+| `/sitemap.xml`            | XML sitemap            | 已实现 XML 响应                                |
+| `/app/download`           | 跳转移动端 README      | 已实现兼容 redirect                            |
+| `/signup`                 | 注册页或 GitHub 跳转   | 已实现注册页                                   |
+| `/signin`                 | 登录页                 | 已实现等价页面                                 |
+| `/active_account`         | 账号激活               | 已实现页面和 API                               |
+| `/search_pass`            | 找回密码               | 已实现页面和 API                               |
+| `/reset_pass`             | 重置密码               | 已实现页面和 API                               |
+| `/user/:name`             | 用户主页               | 已实现等价页面                                 |
+| `/setting`                | 用户设置               | 已实现等价页面                                 |
+| `/stars`                  | 达人列表               | 已实现等价页面                                 |
+| `/users/top100`           | 积分榜                 | 已实现等价页面                                 |
+| `/user/:name/collections` | 用户收藏列表           | 已实现页面，分页在本 change 后续任务补齐       |
+| `/user/:name/topics`      | 用户话题列表           | 已实现页面，分页在本 change 后续任务补齐       |
+| `/user/:name/replies`     | 用户参与列表           | 已实现页面，分页在本 change 后续任务补齐       |
+| `/user/set_star`          | 管理员设达人           | 已有 API                                       |
+| `/user/cancel_star`       | 管理员取消达人         | 已有 API                                       |
+| `/user/:name/block`       | 管理员禁言/解禁        | 已有 API                                       |
+| `/user/:name/delete_all`  | 管理员删除用户所有发言 | 已有 API                                       |
+| `/user/refresh_token`     | 刷新 accessToken       | 已有 API                                       |
+| `/my/messages`            | 消息页                 | 已实现页面，自动已读在本 change 后续任务补齐   |
+| `/topic/create`           | 创建话题页             | 已实现页面                                     |
+| `/topic/:tid`             | 话题详情               | 已实现页面                                     |
+| `/topic/:tid/top`         | 管理员置顶             | 已有 API                                       |
+| `/topic/:tid/good`        | 管理员加精             | 已有 API                                       |
+| `/topic/:tid/edit`        | 编辑话题               | 已实现页面和 API                               |
+| `/topic/:tid/lock`        | 管理员锁定             | 已有 API                                       |
+| `/topic/:tid/delete`      | 删除话题               | 已有 API                                       |
+| `/topic/collect`          | 收藏话题               | 已有等价 API                                   |
+| `/topic/de_collect`       | 取消收藏               | 已有等价 API                                   |
+| `/:topic_id/reply`        | 创建回复               | 已有等价 API/Web 行为                          |
+| `/reply/:reply_id/edit`   | 编辑回复               | 已实现页面和 API                               |
+| `/reply/:reply_id/delete` | 删除回复               | 本 change 后续任务补齐                         |
+| `/reply/:reply_id/up`     | 回复点赞               | 已有等价 API/Web 行为                          |
+| `/upload`                 | 图片上传               | 已有等价 API/Web 行为                          |
+| `/about`                  | 关于页面               | 已实现等价页面                                 |
+| `/faq`                    | FAQ 页面               | 已实现等价页面                                 |
+| `/getstart`               | 新手入门               | 已实现等价页面                                 |
+| `/robots.txt`             | robots 文本            | 已实现 text/plain 响应                         |
+| `/api`                    | API 文档页面           | 已实现等价页面                                 |
+| `/rss`                    | RSS XML                | 已实现 XML 响应                                |
+| `/auth/github`            | GitHub OAuth 发起      | 已实现入口                                     |
+| `/auth/github/callback`   | GitHub OAuth 回调      | 已实现，关联老账号流程在本 change 后续任务补齐 |
+| `/auth/github/new`        | GitHub 新用户选择页    | 本 change 后续任务补齐                         |
+| `/auth/github/create`     | GitHub 新用户创建/绑定 | 本 change 后续任务补齐                         |
+| `/search`                 | 搜索                   | 已实现页面                                     |
+| `/:name`                  | 生产用户短路径         | 已实现兼容 redirect                            |
diff --git a/openspec/changes/archive/2026-07-27-implement-web-editor-preview-upload/specs/web-ui-markdown/spec.md b/openspec/changes/archive/2026-07-27-implement-web-editor-preview-upload/specs/web-ui-markdown/spec.md
index 655b8fd..452155a 100644
--- a/openspec/changes/archive/2026-07-27-implement-web-editor-preview-upload/specs/web-ui-markdown/spec.md
+++ b/openspec/changes/archive/2026-07-27-implement-web-editor-preview-upload/specs/web-ui-markdown/spec.md
@@ -5,21 +5,25 @@
 `MarkdownEditor` SHALL 支持 Markdown 编辑、预览、双栏编辑 + 预览三种视图模式。预览和双栏预览区域 MUST 复用 `MarkdownView` 渲染当前 Markdown 内容。
 
 #### Scenario: Markdown 编辑模式
+
 - **WHEN** 用户选择编辑模式
 - **THEN** 编辑器显示可输入 Markdown 的 textarea
 - **AND** textarea 的内容变化会同步到调用方传入的 `onChange`
 
 #### Scenario: 预览模式
+
 - **WHEN** 用户选择预览模式
 - **THEN** 编辑器隐藏 textarea 并使用 `MarkdownView` 渲染当前内容
 - **AND** 渲染结果与发布后话题或回复正文使用同一 Markdown pipeline
 
 #### Scenario: 双栏编辑预览模式
+
 - **WHEN** 用户在桌面端选择双栏模式
 - **THEN** 编辑器左侧显示 Markdown textarea，右侧显示 `MarkdownView` 预览
 - **AND** 用户输入时右侧预览实时更新
 
 #### Scenario: 移动端双栏降级
+
 - **WHEN** 用户在移动端 viewport 使用编辑器
 - **THEN** 双栏模式 MUST 降级为可用的编辑/预览切换布局
 - **AND** 不得出现 textarea 或预览区域被挤压到不可读的状态
@@ -29,18 +33,22 @@
 `MarkdownEditor` SHALL 支持通过工具栏选择图片、粘贴图片和拖拽图片上传。上传成功后 MUST 在当前光标位置插入 Markdown 图片语法 `![alt](url)`。
 
 #### Scenario: 工具栏选择图片上传
+
 - **WHEN** 登录用户点击图片按钮并选择合法图片文件
 - **THEN** 系统上传图片并在成功后插入 `![文件名](图片URL)`
 
 #### Scenario: 粘贴截图上传
+
 - **WHEN** 用户在编辑器中粘贴剪贴板图片
 - **THEN** 系统上传该图片并在当前光标位置插入对应 Markdown 图片语法
 
 #### Scenario: 拖拽图片上传
+
 - **WHEN** 用户将图片文件拖拽到编辑器输入区域
 - **THEN** 系统上传图片并将返回 URL 插入正文
 
 #### Scenario: 上传失败不污染正文
+
 - **WHEN** 图片上传失败或文件校验失败
 - **THEN** 编辑器显示错误反馈
 - **AND** 正文内容不插入损坏 URL 或占位 Markdown
@@ -50,16 +58,19 @@
 图片上传 API MUST 要求登录态，且 MUST 校验文件类型、扩展名和大小。非法文件 SHALL 被拒绝并返回可展示的错误信息。
 
 #### Scenario: 未登录用户上传图片
+
 - **WHEN** 未登录用户尝试从编辑器上传图片
 - **THEN** 上传请求被拒绝
 - **AND** 编辑器提示用户需要登录后上传
 
 #### Scenario: 非图片文件被拒绝
+
 - **WHEN** 用户选择非图片文件作为上传内容
 - **THEN** API 拒绝该文件
 - **AND** 编辑器展示文件类型不支持的错误
 
 #### Scenario: 超过大小限制的图片被拒绝
+
 - **WHEN** 用户选择超过允许大小的图片
 - **THEN** API 拒绝该文件
 - **AND** 编辑器展示文件过大的错误
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/admin-dashboard/spec.md
index de8792c..03ac420 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/admin-dashboard/spec.md
@@ -1,56 +1,68 @@
 ## ADDED Requirements
 
 ### Requirement: 后台管理列表必须处理极端字段长度
+
 后台管理页面 SHALL 为表格和卡片列表中的时间、操作、标识符、标题、描述、预览、错误信息和审计目标定义可读的宽度、截断和换行策略。
 
 #### Scenario: 审计日志长目标不挤压时间和操作
+
 - **WHEN** `/admin/audit` 渲染包含超长 topic title、批量 ID 或 JSON-like target 的审计记录
 - **THEN** 时间列 MUST 保持单行可读
 - **AND** 操作人、动作、结果列 MUST 保持可辨识
 - **AND** target 内容 MUST 截断、换行或进入详情展示，不得挤压整行导致操作不可读
 
 #### Scenario: 用户管理长邮箱和长用户名
+
 - **WHEN** `/admin/users` 渲染长邮箱或长用户名
 - **THEN** 邮箱和用户名 MUST 不撑破表格容器
 - **AND** 操作按钮 MUST 保持可点击，可通过换行或固定操作列宽度实现
 
 #### Scenario: 巡检长 preview 和错误信息
+
 - **WHEN** `/admin/moderation` 渲染长 preview、长敏感词或长错误信息
 - **THEN** 内容 MUST 在卡片内换行或折叠展示
 - **AND** 不得造成页面水平溢出到 viewport 外
 
 #### Scenario: 举报、封禁和敏感词长文本
+
 - **WHEN** `/admin/reports`、`/admin/bans` 或 `/admin/keywords` 渲染长描述、长原因、长 IP/CIDR 或长敏感词
 - **THEN** 长文本 MUST 在对应卡片或表格内换行、截断或横向滚动
 - **AND** 分页和主要操作按钮 MUST 保持可见
 
 ### Requirement: 系统设置必须被业务路径消费
+
 后台系统设置 SHALL 对应真实业务读取点；页面不得让管理员保存不会生效的运营策略。
 
 #### Scenario: 注册开关生效
+
 - **WHEN** admin 在 `/admin/settings` 关闭注册
 - **THEN** `/signup` 页面 MUST 不再展示本地注册表单
 - **AND** `POST /api/v1/auth/local/signup` MUST 返回 403
 
 #### Scenario: 新用户发帖门槛生效
+
 - **WHEN** admin 配置 `new_user_min_hours` 和 `new_user_min_replies`
 - **THEN** 创建话题路径 MUST 按该配置判断新用户是否可发帖
 - **AND** 不满足条件时 MUST 返回明确错误提示
 
 #### Scenario: 未接入的设置不得显示为可保存生效
+
 - **WHEN** 某个后台设置项没有任何业务读取点
 - **THEN** 页面 MUST 隐藏该设置项或标记为未接入不可保存
 - **AND** 不得显示保存成功让管理员误以为已生效
 
 ### Requirement: 管理概览指标必须来自真实查询
+
 管理概览页 SHALL 使用真实数据库或队列查询展示待处理运营指标，不得使用硬编码占位值。
 
 #### Scenario: 待审举报数真实展示
+
 - **WHEN** 管理员访问 `/admin`
 - **THEN** 待审举报数 MUST 来自 `reports.status=pending` 的真实计数
 - **AND** 不得硬编码为 0
 
 #### Scenario: 未实现指标不展示为真实数据
+
 - **WHEN** 自动封禁用户数、趋势图或最近审计操作尚未实现真实查询
 - **THEN** 页面 MUST 隐藏对应模块或明确标记未接入
 - **AND** 不得展示硬编码、空数组伪装成真实结果
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/anti-spam/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/anti-spam/spec.md
index 5251519..bd471c0 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/anti-spam/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/anti-spam/spec.md
@@ -1,72 +1,87 @@
 ## ADDED Requirements
 
 ### Requirement: 举报功能必须形成前后台闭环
+
 系统 SHALL 支持用户从公开内容页提交话题或回复举报，并在后台举报队列中展示可处理的目标摘要。
 
 #### Scenario: 用户举报话题
+
 - **WHEN** 登录用户在话题详情页举报当前话题
 - **THEN** 系统 MUST 创建 `target_type=topic`、`target_id=<topic id>` 的举报记录
 - **AND** 后台举报队列 MUST 展示目标话题标题、目标链接、举报类型、举报说明和举报人数量
 
 #### Scenario: 用户举报回复
+
 - **WHEN** 登录用户在回复项上举报该回复
 - **THEN** 系统 MUST 创建 `target_type=reply`、`target_id=<reply id>` 的举报记录
 - **AND** 后台举报队列 MUST 展示所属话题链接和回复目标摘要
 
 #### Scenario: 后台处理举报
+
 - **WHEN** 管理员或版主在 `/admin/reports` 确认或驳回举报
 - **THEN** 系统 MUST 更新举报状态
 - **AND** 后台列表 MUST 不出现空标题、`/topic/undefined` 链接或永远为 `0 人举报` 的错误字段
 - **AND** 系统 MUST 写入审计日志
 
 ### Requirement: IP 封禁必须支持 UI 操作和 CIDR 匹配
+
 系统 SHALL 允许管理员在后台新增和移除 IP 封禁规则，并在请求处理中支持单 IP 与 CIDR 网段匹配。
 
 #### Scenario: 管理员新增单 IP 封禁
+
 - **WHEN** admin 在 `/admin/bans` 添加单个 IP
 - **THEN** 系统 MUST 保存规则
 - **AND** 来自该 IP 的后续请求 MUST 返回 403
 
 #### Scenario: 管理员新增 CIDR 封禁
+
 - **WHEN** admin 在 `/admin/bans` 添加合法 CIDR 网段
 - **THEN** 系统 MUST 保存规则
 - **AND** 来自该网段内 IP 的后续请求 MUST 返回 403
 
 #### Scenario: 管理员移除 IP 封禁
+
 - **WHEN** admin 在 `/admin/bans` 移除某条 IP 或 CIDR 规则
 - **THEN** 系统 MUST 删除该规则
 - **AND** 后续请求 MUST 不再因该规则被拒绝
 
 #### Scenario: 拒绝无效 IP 规则
+
 - **WHEN** admin 提交无效 IP 或 CIDR 字符串
 - **THEN** 系统 MUST 返回错误
 - **AND** 不得保存无效封禁规则
 
 ### Requirement: 反垃圾承诺必须完整落地
+
 系统 SHALL 在本变更中实现已承诺的核心反垃圾能力，包括新用户发帖限制、Turnstile、人为举报自动隐藏和渐进封禁。
 
 #### Scenario: 新用户发帖限制落地
+
 - **WHEN** 当前 spec 声明新用户发帖限制为 MUST
 - **THEN** 创建话题路径 MUST 按配置的注册时长和回复数阈值进行限制
 - **AND** 未满足条件的新用户 MUST 无法发帖
 
 #### Scenario: 注册和找回密码触发 Turnstile
+
 - **WHEN** 用户提交注册或密码找回表单
 - **THEN** 页面 MUST 要求通过 Cloudflare Turnstile
 - **AND** 后端 MUST 调用 Turnstile siteverify 校验 token
 - **AND** 校验失败时 MUST 拒绝请求且不创建用户、不生成 retrieve key
 
 #### Scenario: 风险发帖或高频写入触发 Turnstile
+
 - **WHEN** 新用户发帖或用户短时间连续发帖/回复达到风险阈值
 - **THEN** 系统 MUST 要求 Turnstile token
 - **AND** 后端校验失败时 MUST 拒绝写入
 
 #### Scenario: 举报阈值自动隐藏
+
 - **WHEN** 同一话题或回复被达到配置阈值的不同用户举报
 - **THEN** 系统 MUST 自动隐藏目标内容或将其从公共入口移除
 - **AND** 系统 MUST 写入审计日志并保留后台复核入口
 
 #### Scenario: 渐进封禁
+
 - **WHEN** 用户的举报确认或巡检确认违规次数达到配置阈值
 - **THEN** 系统 MUST 按警告、临时禁言、永久 block/mute 的顺序执行渐进处罚
 - **AND** 临时禁言到期后 MUST 自动恢复新增内容能力，除非用户仍处于更高等级限制
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/api-contract/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/api-contract/spec.md
index b7297db..8710f20 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/api-contract/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/api-contract/spec.md
@@ -1,20 +1,24 @@
 ## ADDED Requirements
 
 ### Requirement: 搜索接口必须与页面声明和前端 DTO 对齐
+
 搜索 API SHALL 返回前端列表组件可消费的稳定 DTO，并且查询范围必须与搜索页文案一致。
 
 #### Scenario: 搜索标题和内容
+
 - **WHEN** 搜索页声明可搜索话题标题和内容
 - **THEN** `/api/v1/search?engine=local&q=<keyword>` MUST 查询公开可见话题的标题和内容
 - **AND** 已删除、内部 tab 或 block 作者内容 MUST 不出现在搜索结果中
 
 #### Scenario: 搜索返回 TopicDTO 兼容字段
+
 - **WHEN** 前端调用 local search API
 - **THEN** 返回的每条结果 MUST 包含 `id`、`title`、`tab`、`reply_count`、`visit_count`、`last_reply_at` 和 `author`
 - **AND** `author` MUST 包含 `loginname` 和 `avatar_url`
 - **AND** 前端不得依赖数据库 raw column 名称渲染搜索结果
 
 #### Scenario: 不支持内容搜索时文案必须降级
+
 - **WHEN** 系统暂不支持内容搜索
 - **THEN** 搜索页文案 MUST 明确只搜索标题
 - **AND** spec 不得声明内容搜索已完成
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/auth/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/auth/spec.md
index cfb1201..59402b6 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/auth/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/auth/spec.md
@@ -1,62 +1,75 @@
 ## ADDED Requirements
 
 ### Requirement: 邮件用户入口必须使用 Web 域名
+
 系统 SHALL 对需要用户点击并进入页面的账号邮件使用 Web 域名生成链接，API 域名只作为前端提交校验请求的服务端入口。
 
 #### Scenario: 密码找回邮件链接
+
 - **WHEN** 用户通过 `/api/v1/auth/local/search_pass` 发起密码找回
 - **THEN** 系统 MUST 持久化 `retrieve_key` 和 `retrieve_time`
 - **AND** 重置邮件中的链接 MUST 指向 `${APP_WEB_BASE_URL}/reset_pass?key=<retrieve_key>`
 - **AND** 链接 MUST NOT 指向 `${APP_API_BASE_URL}/reset_pass`
 
 #### Scenario: 账号激活邮件链接
+
 - **WHEN** 用户提交本地账号注册并需要激活邮箱
 - **THEN** 系统 MUST 持久化激活用 `retrieve_key` 和 `retrieve_time`
 - **AND** 激活邮件中的链接 MUST 指向 `${APP_WEB_BASE_URL}/active_account?key=<retrieve_key>`
 - **AND** Web 页面 MUST 调用 API 完成激活状态写入
 
 ### Requirement: 登录页必须提供找回密码入口
+
 本地账号登录页 SHALL 提供可发现的密码找回入口，连接到现有密码找回流程。
 
 #### Scenario: 登录页展示找回密码链接
+
 - **WHEN** 用户访问 `/signin`
 - **THEN** 页面 MUST 显示“忘记密码”或等价文案入口
 - **AND** 入口 MUST 跳转到 `/search_pass`
 
 #### Scenario: 找回密码入口不影响 GitHub 登录
+
 - **WHEN** 用户访问 `/signin`
 - **THEN** 页面 MUST 同时保留 GitHub 登录入口
 - **AND** 找回密码入口 MUST 只服务本地邮箱账号密码流程
 
 ### Requirement: GitHub OAuth state 必须校验
+
 系统 SHALL 在 GitHub OAuth 发起和回调之间持久化并校验 `state`，避免 callback 被伪造或串用。
 
 #### Scenario: state 校验通过
+
 - **WHEN** 用户从 `/auth/github` 发起 GitHub OAuth 并带着原始 `state` 返回 callback
 - **THEN** 系统 MUST 校验 `state` 与发起时保存的值一致
 - **AND** 校验通过后才交换 GitHub access token
 
 #### Scenario: state 缺失或不匹配
+
 - **WHEN** GitHub callback 缺少 `state` 或 `state` 与发起时保存的值不一致
 - **THEN** 系统 MUST 拒绝继续登录或绑定
 - **AND** 不得创建用户、绑定 GitHub 或设置 session cookie
 
 ### Requirement: 已登录用户可绑定 GitHub 到当前账号
+
 系统 SHALL 支持已登录用户从设置页发起 GitHub 绑定，并将授权得到的 GitHub identity 绑定到当前 session 用户。
 
 #### Scenario: 设置页展示 GitHub 绑定状态
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 展示当前账号是否已绑定 GitHub
 - **AND** 已绑定时 MUST 显示 GitHub 用户名或等价标识
 - **AND** 未绑定时 MUST 提供“绑定 GitHub”入口
 
 #### Scenario: 当前用户绑定 GitHub
+
 - **WHEN** 已登录用户从设置页发起 GitHub 绑定并完成 OAuth callback
 - **THEN** 系统 MUST 将 GitHub id、GitHub 用户名、GitHub access token 和头像信息写入当前 session 用户
 - **AND** MUST NOT 要求用户在 `/auth/github/new` 再次输入已有账号密码
 - **AND** 绑定成功后 MUST 返回设置页并显示成功反馈
 
 #### Scenario: GitHub 已绑定到其他账号
+
 - **WHEN** 当前用户尝试绑定的 GitHub id 已属于另一个 CNode 用户
 - **THEN** 系统 MUST 拒绝绑定
 - **AND** 当前用户原有账号状态 MUST 保持不变
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/content-moderation/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/content-moderation/spec.md
index 3921ae6..a4795ab 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/content-moderation/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/content-moderation/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 敏感词命中次数必须真实
+
 敏感词管理页 SHALL 只展示有真实更新来源的命中次数；若展示 `hit_count`，实时过滤和历史巡检都必须更新该指标。
 
 #### Scenario: 实时过滤更新命中次数
+
 - **WHEN** 用户发帖、编辑话题、回复或编辑回复时命中敏感词并被拒绝
 - **THEN** 系统 MUST 增加对应敏感词的命中次数
 - **AND** `/admin/keywords` 展示的命中次数 MUST 反映该变化
 
 #### Scenario: 历史巡检更新命中次数
+
 - **WHEN** 巡检任务扫描历史话题或回复并发现敏感词命中
 - **THEN** 系统 MUST 增加对应敏感词的命中次数或记录等价可展示统计
 - **AND** 后台展示的命中次数 MUST 不长期保持默认值
 
 #### Scenario: 无统计实现时不展示假指标
+
 - **WHEN** 系统没有实现敏感词命中次数统计
 - **THEN** `/admin/keywords` MUST 隐藏命中次数列或明确标记为未接入
 - **AND** 不得展示永远为 0 或空值的运营指标
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/layout-templates/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/layout-templates/spec.md
index 2834c51..24cbdbd 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/layout-templates/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/layout-templates/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: Admin 模板必须提供后台宽屏内容区
+
 Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据表格和运营工具，同时保留表单类内容的可读宽度。
 
 #### Scenario: 后台 shell 使用宽屏容器
+
 - **WHEN** 管理员在桌面端访问 `/admin/topics`、`/admin/users`、`/admin/audit` 或 `/admin/moderation`
 - **THEN** admin shell 的主内容容器 MUST 使用宽屏上限，例如 `max-w-screen-2xl` 或等价宽度
 - **AND** 左侧导航和主内容区域 MUST 保持 `min-w-0` 以允许内部滚动和截断生效
 
 #### Scenario: 表单类后台页面不过度拉宽
+
 - **WHEN** 管理员访问 `/admin/settings` 或其他表单为主的后台页面
 - **THEN** 页面 SHALL 仍使用 admin shell 对齐
 - **AND** 表单卡片内容 MUST 使用内部宽度或 grid 控制，避免输入框横跨整个宽屏容器
 
 #### Scenario: 表格横向滚动与列宽协同
+
 - **WHEN** 管理表格的内容总宽度超过主内容区域
 - **THEN** 表格容器 MUST 提供横向滚动
 - **AND** 页面 MUST 为关键列配置最小宽度或换行策略，避免浏览器无限压缩列宽
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/production-ops/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/production-ops/spec.md
index 9fc5229..d236b9c 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/production-ops/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/production-ops/spec.md
@@ -1,38 +1,46 @@
 ## ADDED Requirements
 
 ### Requirement: 生产邮件路径不得假成功
+
 生产环境中的账号激活、密码找回、回复通知和 @ 通知邮件 SHALL 在 SMTP 缺失或发送失败时可观测，并且关键账号邮件不得返回误导性的成功响应。
 
 #### Scenario: 生产缺少 SMTP 配置
+
 - **WHEN** 非 development 环境缺少 `SMTP_HOST`
 - **THEN** 账号激活和密码找回邮件发送 MUST 返回失败或阻止对应请求成功
 - **AND** 系统 MUST 记录可观测错误日志
 - **AND** 用户不得看到“邮件已发送”的假成功提示
 
 #### Scenario: SMTP 发送失败
+
 - **WHEN** SMTP 已配置但发送账号激活或密码找回邮件最终失败
 - **THEN** API MUST 返回失败响应
 - **AND** 用户资料和 retrieve key 状态 MUST 保持可重试或明确可恢复
 
 #### Scenario: development 允许跳过邮件
+
 - **WHEN** `APP_ENV=development` 且未配置 SMTP
 - **THEN** 系统 MAY 跳过真实发送
 - **AND** 必须在日志中明确标记邮件被跳过
 
 ### Requirement: Turnstile 生产配置必须完整
+
 生产环境 SHALL 配置 Cloudflare Turnstile 所需的站点 key 和 secret key，并确保 secret 不暴露到浏览器。
 
 #### Scenario: Turnstile site key 注入前端
+
 - **WHEN** Web 渲染注册、找回密码或高风险写入表单
 - **THEN** 页面 MUST 能读取公开的 Turnstile site key
 - **AND** site key MAY 暴露给浏览器
 
 #### Scenario: Turnstile secret 仅服务端使用
+
 - **WHEN** API 校验 Turnstile token
 - **THEN** API MUST 使用服务端环境变量中的 Turnstile secret 调用 siteverify
 - **AND** secret MUST NOT 注入到 Web HTML、前端 bundle 或公开配置
 
 #### Scenario: 缺少 Turnstile 配置时生产拒绝启动或拒绝风险请求
+
 - **WHEN** 非 development 环境缺少 Turnstile 必需配置
 - **THEN** 系统 MUST 拒绝依赖 Turnstile 的请求或在启动/健康检查中明确失败
 - **AND** 不得绕过人机验证继续接受高风险请求
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/rate-limiting/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/rate-limiting/spec.md
index a6bb7e3..b19fe44 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/rate-limiting/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/rate-limiting/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 后台限流配置必须被写入路径读取
+
 系统 SHALL 让后台系统设置中的发帖和回复限流配置影响对应写入路径，而不是只保存配置值。
 
 #### Scenario: 发帖限流读取后台配置
+
 - **WHEN** admin 在系统设置中修改 `rate_topic`
 - **THEN** 创建话题限流 MUST 使用最新配置值作为每日上限
 - **AND** 超过该上限时 MUST 返回 403 和 RateLimit headers
 
 #### Scenario: 回复限流读取后台配置
+
 - **WHEN** admin 在系统设置中修改 `rate_reply`
 - **THEN** 创建回复限流 MUST 使用最新配置值作为每日上限
 - **AND** 超过该上限时 MUST 返回 403 和 RateLimit headers
 
 #### Scenario: 配置缺失时使用安全默认值
+
 - **WHEN** `site_settings` 中不存在 `rate_topic` 或 `rate_reply`
 - **THEN** 系统 MUST 使用代码默认上限
 - **AND** 不得因为配置缺失导致写入路径报错
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/user-management/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/user-management/spec.md
index 780fb6a..f3852ab 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/user-management/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/user-management/spec.md
@@ -1,27 +1,32 @@
 ## ADDED Requirements
 
 ### Requirement: 管理员不得对自己执行限制或破坏性用户操作
+
 系统 SHALL 阻止管理员对当前登录账号执行会限制自身能力或破坏自身内容的高风险用户管理动作。
 
 #### Scenario: 管理员不能 block 自己
+
 - **WHEN** admin 调用用户 block 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_block` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能 mute 自己
+
 - **WHEN** admin 调用用户 mute 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_muted` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能删除自己所有发言
+
 - **WHEN** admin 调用删除用户所有发言接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的话题和回复删除状态 MUST 保持不变
 - **AND** 系统 MUST NOT 扣减当前 admin 的内容计数
 
 #### Scenario: 前端隐藏自操作入口
+
 - **WHEN** admin 在后台用户管理页或用户主页查看自己的账号
 - **THEN** 页面 MUST NOT 提供 block、mute 或删除所有发言的可执行入口
 - **AND** 直接调用后端接口仍 MUST 被拒绝
diff --git a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/web-ui-forms/spec.md b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/web-ui-forms/spec.md
index 3c48276..38de80f 100644
--- a/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/web-ui-forms/spec.md
+++ b/openspec/changes/archive/2026-07-28-fix-admin-account-integrity/specs/web-ui-forms/spec.md
@@ -1,24 +1,29 @@
 ## ADDED Requirements
 
 ### Requirement: 设置页必须展示账号身份信息
+
 用户设置页 SHALL 展示当前账号的只读身份信息，并区分可编辑个人资料和不可直接编辑的登录身份字段。
 
 #### Scenario: 设置页显示邮箱
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 显示当前账号邮箱
 - **AND** 邮箱 MUST 作为只读身份信息展示
 - **AND** 页面 MUST NOT 提供无验证的直接修改邮箱表单
 
 #### Scenario: 设置页显示 GitHub 绑定状态
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 显示当前 GitHub 绑定状态
 - **AND** 未绑定账号 MUST 显示绑定入口
 - **AND** 已绑定账号 MUST 显示绑定的 GitHub 用户名或等价标识
 
 ### Requirement: 设置页卡片内容间距必须一致
+
 设置页所有 Card body SHALL 使用一致的 padding 和文本间距，避免侧栏说明卡片内容贴边。
 
 #### Scenario: 通知说明卡片有 body padding
+
 - **WHEN** `/setting` 渲染通知说明卡片
 - **THEN** 卡片 header 与 body MUST 视觉分离
 - **AND** body 内容 MUST 有与 API Token 卡片一致的内边距
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/container-image-delivery/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/container-image-delivery/spec.md
index 2e70bd1..d19ac94 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/container-image-delivery/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/container-image-delivery/spec.md
@@ -5,18 +5,21 @@
 系统 MUST 使用 GitHub Actions 在 GitHub runner 上构建 cnode-next 生产容器镜像，并推送到 GitHub Container Registry。workflow MUST 在 release verification gate 通过后才构建和推送镜像，且不得执行部署。
 
 #### Scenario: API 镜像发布到 GHCR SHA tag
+
 - **WHEN** GitHub Actions 在主分支运行容器镜像发布 workflow
 - **THEN** workflow MUST 使用 `apps/api/Dockerfile` 构建 API 镜像
 - **AND** workflow MUST 推送 `ghcr.io/cnodejs/cnode-api:sha-<commit>` 或记录等价 image digest
 - **AND** workflow MUST NOT 在 release verification gate 失败时推送镜像
 
 #### Scenario: Web 镜像发布到 GHCR SHA tag
+
 - **WHEN** GitHub Actions 在主分支运行容器镜像发布 workflow
 - **THEN** workflow MUST 使用 `apps/web/Dockerfile` 构建 Web 镜像
 - **AND** workflow MUST 推送 `ghcr.io/cnodejs/cnode-web:sha-<commit>` 或记录等价 image digest
 - **AND** workflow MUST NOT 在 release verification gate 失败时推送镜像
 
 #### Scenario: Workflow 不执行部署
+
 - **WHEN** GitHub Actions 完成镜像推送
 - **THEN** workflow MUST NOT 管理部署凭据
 - **AND** workflow MUST NOT 执行 `docker compose pull` 或 `docker compose up`
@@ -26,11 +29,13 @@
 生产 docker-compose 编排 MUST 只引用已发布镜像，部署流程 MUST 通过 `pull` 和 `up --no-build` 启动服务，不得在部署过程中构建应用镜像。
 
 #### Scenario: Compose 不包含本地构建定义
+
 - **WHEN** 运维查看 `deployment/docker-compose.yml`
 - **THEN** `api`、`web`、`worker`、`migrate-schema`、`migrate-data`、`reconcile` 服务 MUST NOT 包含 `build:` 配置
 - **AND** 这些服务 MUST 使用 `image:` 引用 GHCR 镜像
 
 #### Scenario: 手动部署拉取指定镜像
+
 - **WHEN** 运维部署新版本
 - **THEN** 运维 MUST 设置 `CNODE_API_IMAGE` 和 `CNODE_WEB_IMAGE` 指向 SHA tag 或 digest
 - **AND** 运维 MUST 执行 `docker compose -f deployment/docker-compose.yml pull api web worker`
@@ -38,6 +43,7 @@
 - **AND** 该流程 MUST NOT 执行 Docker build
 
 #### Scenario: Migration 任务使用 API 镜像
+
 - **WHEN** 运维执行 `migrate-schema`、`migrate-data` 或 `reconcile`
 - **THEN** 这些一次性任务 MUST 使用 `CNODE_API_IMAGE` 指向的 API 镜像
 - **AND** 这些任务 MUST NOT 通过 compose build migration target
@@ -47,16 +53,19 @@
 Web 镜像 MUST 不依赖构建时 API base URL。SSR 侧和浏览器侧 API 请求都 MUST 根据运行时环境变量决定 API 地址。
 
 #### Scenario: SSR 使用内部 API 地址
+
 - **WHEN** React Router loader 在 Web 容器服务端执行 API 请求
 - **THEN** 系统 MUST 优先使用 `APP_API_INTERNAL_BASE_URL`
 - **AND** 在生产 compose 中该值 MUST 指向 `http://api:3001`
 
 #### Scenario: 浏览器使用公开 API 地址
+
 - **WHEN** 浏览器侧交互调用 `apiFetch` 或上传客户端请求 API
 - **THEN** 系统 MUST 使用运行时 `.env` 注入到页面的 `APP_API_BASE_URL`
 - **AND** 浏览器侧 MUST NOT 依赖 `VITE_APP_API_BASE_URL` 或其他构建时变量决定 API base URL
 
 #### Scenario: 同一 Web 镜像可复用到不同运行环境
+
 - **WHEN** 同一个 Web 镜像在不同运行环境启动
 - **THEN** 浏览器侧 API base MUST 随该环境的 `.env` 变化
 - **AND** 不得要求为不同 API 域名重新构建 Web 镜像
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/documentation-information-architecture/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/documentation-information-architecture/spec.md
index 20249d7..4a2922f 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/documentation-information-architecture/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/documentation-information-architecture/spec.md
@@ -1,53 +1,65 @@
 ## ADDED Requirements
 
 ### Requirement: 项目文档必须图优先
+
 项目文档 SHALL 以架构图、信息图、流程图、时序图、类图、脑图或关系图作为主要表达方式，使读者能快速理解项目能力、逻辑处理和关联关系。
 
 #### Scenario: 读者查看 README
+
 - **WHEN** 读者打开 `README.md`
 - **THEN** 文档 MUST 用简短说明和图示展示系统能力、主要应用、数据存储、发布链路和关键文档入口
 - **AND** README MUST NOT 使用长篇文字重复 `docs/` 中的细节
 
 #### Scenario: 读者查看架构文档
+
 - **WHEN** 读者打开架构文档
 - **THEN** 文档 MUST 包含系统架构图、请求流图、数据关系图和部署拓扑图
 - **AND** 每张图后只保留必要边界、约束和跳转链接
 
 ### Requirement: docs 目录必须简化和合并
+
 `docs/` SHALL 合并相近主题，保留少数稳定入口，避免同一概念在多个文档中重复和漂移。
 
 #### Scenario: 文档主题重复
+
 - **WHEN** 两个或多个 `docs/*.md` 描述同一部署、迁移、数据库或安全主题
 - **THEN** 它们 MUST 被合并或明确拆分职责
 - **AND** 旧入口 MUST 提供跳转或被删除，避免读者看到冲突说明
 
 #### Scenario: 文档索引更新
+
 - **WHEN** 文档结构调整完成
 - **THEN** README MUST 列出新的文档入口
 - **AND** 每个入口 MUST 用一句话说明适用读者和用途
 
 ### Requirement: AGENTS 必须保持执行型简洁
+
 `AGENTS.md` SHALL 只保留协作代理需要执行的项目事实、命令、目录边界和关键约束。
 
 #### Scenario: 代理读取 AGENTS
+
 - **WHEN** 代理开始在项目中工作
 - **THEN** `AGENTS.md` MUST 明确技术栈、PostgreSQL-only、legacy `../nodeclub/` 只读参考、常用命令和 OpenSpec 工作流
 - **AND** `AGENTS.md` MUST NOT 复制长篇架构、部署或 API 文档内容
 
 ### Requirement: 仓库治理文档必须齐备
+
 仓库 SHALL 提供贡献、许可证和安全入口，使外部协作者知道如何参与、如何使用代码以及如何报告安全问题。
 
 #### Scenario: 外部协作者查看贡献说明
+
 - **WHEN** 外部协作者准备提交 issue、PR 或本地验证
 - **THEN** 仓库 MUST 提供 `CONTRIBUTING.md` 或等价贡献文档
 - **AND** 文档 MUST 指向 `pnpm verify`、OpenSpec change 流程和 secret handling 规则
 
 #### Scenario: 外部读者查看许可证
+
 - **WHEN** 外部读者查看仓库根目录
 - **THEN** 仓库 MUST 提供 `LICENSE` 或明确说明许可证状态的文档
 - **AND** 许可证说明 MUST 不与 legacy `../nodeclub/` 参考代码混淆
 
 #### Scenario: 安全问题报告
+
 - **WHEN** 外部用户需要报告安全问题
 - **THEN** 仓库 MUST 提供 `SECURITY.md` 或在安全文档中提供清晰报告方式
 - **AND** 文档 MUST 提醒不要在公开 issue 中粘贴 secrets、tokens 或用户隐私数据
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/immutable-image-release/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/immutable-image-release/spec.md
index 06740ee..7b8bfaa 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/immutable-image-release/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/immutable-image-release/spec.md
@@ -1,40 +1,49 @@
 ## ADDED Requirements
 
 ### Requirement: 生产镜像必须以不可变标识发布
+
 CI SHALL 为 API 和 Web 生产镜像发布 commit SHA tag 或 digest，使每个生产部署都能精确追溯到源码提交。
 
 #### Scenario: API 镜像发布 SHA tag
+
 - **WHEN** main 分支通过发布验证并构建 API 镜像
 - **THEN** CI MUST 推送 `ghcr.io/cnodejs/cnode-api:sha-<commit>` 或记录等价 image digest
 - **AND** 该 tag 或 digest MUST 对应构建时的 Git commit
 
 #### Scenario: Web 镜像发布 SHA tag
+
 - **WHEN** main 分支通过发布验证并构建 Web 镜像
 - **THEN** CI MUST 推送 `ghcr.io/cnodejs/cnode-web:sha-<commit>` 或记录等价 image digest
 - **AND** 该 tag 或 digest MUST 对应构建时的 Git commit
 
 ### Requirement: 生产部署不得依赖唯一 latest tag
+
 生产 `api`、`web` 和 `worker` 服务 SHALL 使用显式 `CNODE_API_IMAGE` 与 `CNODE_WEB_IMAGE` 指向不可变发布物。
 
 #### Scenario: compose 要求显式生产镜像
+
 - **WHEN** 运维渲染生产 `deployment/docker-compose.yml`
 - **THEN** `api`、`worker`、`migrate-schema`、`migrate-data` 和 `reconcile` MUST 使用 `CNODE_API_IMAGE` 指向的不可变 API 镜像
 - **AND** `web` MUST 使用 `CNODE_WEB_IMAGE` 指向的不可变 Web 镜像
 
 #### Scenario: latest 仅作为便利标签
+
 - **WHEN** CI 额外推送 `latest`
 - **THEN** 生产部署文档 MUST 明确 `latest` 不可作为 D 级生产部署依据
 - **AND** 部署审计记录 MUST 使用 SHA tag 或 digest
 
 ### Requirement: 回滚必须使用已知旧发布物
+
 生产回滚 SHALL 使用上一次成功部署记录中的旧 SHA tag 或 digest，而不是重新解析 `latest`。
 
 #### Scenario: 部署前记录旧镜像
+
 - **WHEN** 运维开始部署新版本
 - **THEN** runbook MUST 要求记录当前运行的 API 和 Web image tag 或 digest
 - **AND** 该记录 MUST 可用于失败回滚
 
 #### Scenario: 新版本 smoke 失败后回滚
+
 - **WHEN** 新版本部署后 health 或 smoke 失败
 - **THEN** 运维 MUST 将 API/Web 镜像引用恢复到旧 SHA tag 或 digest
 - **AND** 回滚后 MUST 重新验证 health 和 smoke
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/postgres-first-dev-runtime/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/postgres-first-dev-runtime/spec.md
index 013b243..6cfabdc 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/postgres-first-dev-runtime/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/postgres-first-dev-runtime/spec.md
@@ -1,33 +1,41 @@
 ## MODIFIED Requirements
 
 ### Requirement: Development runtime SHALL use PostgreSQL as the default migration validation database
+
 The project MUST document PostgreSQL as the only supported database for current development, testing, migration validation, CI verification, and production runtime work.
 
 #### Scenario: Developer prepares a local runtime
+
 - **WHEN** a developer follows the development setup documentation
 - **THEN** the documented path MUST direct them to a PostgreSQL-backed runtime
 - **AND** the documented path MUST NOT offer SQLite as a fallback runtime
 
 #### Scenario: SQLite behavior is referenced
+
 - **WHEN** active code, scripts, docs, or specs mention SQLite
 - **THEN** the mention MUST be removed unless it is in archived historical change records or generic OpenSpec tooling instructions outside application scope
 
 #### Scenario: Runtime database client is created
+
 - **WHEN** API、worker、migration 或测试验证脚本创建数据库连接
 - **THEN** it MUST create a PostgreSQL-backed client
 - **AND** it MUST NOT branch on `DB_DIALECT` or import `better-sqlite3`
 
 ### Requirement: Developers SHALL provide PostgreSQL and Redis connection settings
+
 Developers MUST be able to run cnode-next against PostgreSQL/Redis by providing connection settings through the documented local environment contract.
 
 #### Scenario: Developer configures database/cache endpoints
+
 - **WHEN** a developer needs to run the project locally
 - **THEN** documentation MUST instruct them to provide PostgreSQL/Redis host, port, database, and credentials via local environment variables
 
 ### Requirement: Local secrets SHALL remain untracked
+
 Local database credentials MUST be stored outside tracked files.
 
 #### Scenario: Local override file is used
+
 - **WHEN** a developer stores local PostgreSQL connection values
 - **THEN** the values MUST be stored in an ignored `.env.local` file
 
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-deployment-governance/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-deployment-governance/spec.md
index 946de8a..6635e69 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-deployment-governance/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-deployment-governance/spec.md
@@ -1,39 +1,48 @@
 ## ADDED Requirements
 
 ### Requirement: 生产部署必须有标准 runbook
+
 项目 SHALL 提供标准生产部署 runbook，覆盖 preflight、migration、镜像拉取、服务启动、健康检查、smoke、回滚和审计记录。
 
 #### Scenario: 部署前 preflight
+
 - **WHEN** 运维准备生产部署
 - **THEN** runbook MUST 要求确认目标 commit、API/Web image tag 或 digest、当前生产镜像、数据库迁移策略和回滚点
 - **AND** runbook MUST 要求确认 `.env` 中不会打印或提交 secret
 
 #### Scenario: 部署后验证
+
 - **WHEN** 运维完成 `docker compose up -d --no-build`
 - **THEN** runbook MUST 要求验证 API `/health`
 - **AND** runbook MUST 要求运行公开 URL、API contract 和关键写入 smoke 中适用于本次发布的检查
 
 ### Requirement: migration 必须显式执行和审计
+
 生产 schema/data migration SHALL 作为显式步骤执行，不得在普通服务启动时隐式运行。
 
 #### Scenario: schema migration 显式执行
+
 - **WHEN** 发布包含 PostgreSQL schema 变更
 - **THEN** 运维 MUST 使用 runbook 中的 migrate profile 或等价显式命令执行 schema migration
 - **AND** migration 输出和结果 MUST 被记录
 
 #### Scenario: migration 失败阻断服务切换
+
 - **WHEN** migration 返回失败
 - **THEN** 运维 MUST 停止继续部署新应用镜像
 - **AND** runbook MUST 指向回滚或人工修复流程
 
 ### Requirement: 部署记录必须可审计
+
 每次生产部署 SHALL 留下可审计记录，能够回答谁在何时把哪个 commit/image 部署到了生产以及验证结果如何。
 
 #### Scenario: 成功部署记录
+
 - **WHEN** 生产部署成功完成
 - **THEN** 记录 MUST 包含时间、操作者、Git commit、API image、Web image、migration 结果、health 结果和 smoke 结果
 - **AND** 记录 MUST NOT 包含 secret、OAuth token、数据库密码或认证 header
 
 #### Scenario: 回滚记录
+
 - **WHEN** 生产部署触发回滚
 - **THEN** 记录 MUST 包含失败的新 image、恢复的旧 image、回滚原因和回滚后 health/smoke 结果
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-health-version/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-health-version/spec.md
index 1c2ae63..4753750 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-health-version/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/production-health-version/spec.md
@@ -1,41 +1,50 @@
 ## ADDED Requirements
 
 ### Requirement: API 必须提供生产健康端点
+
 API 服务 SHALL 提供 `GET /health` 作为生产健康检查入口，且该入口 MUST 不依赖认证。
 
 #### Scenario: 浅健康检查成功
+
 - **WHEN** 调用 `GET /health`
 - **THEN** API MUST 返回 2xx 响应
 - **AND** 响应 MUST 包含 `ok`、`service`、`version`、`commit` 和 `buildTime`
 - **AND** 响应 MUST NOT 包含环境变量、数据库地址、token、secret 或内部错误堆栈
 
 #### Scenario: compose 使用健康端点
+
 - **WHEN** 生产 `api` 容器执行 healthcheck
 - **THEN** healthcheck MUST 请求 API 专用 `/health` 端点
 - **AND** healthcheck MUST NOT 复用 `/api/v1/auth/config` 或其他业务接口
 
 ### Requirement: 构建版本信息必须可追溯
+
 API 和 Web 生产构建 SHALL 注入当前 commit 与 build time，使部署后的服务状态可反查到源码版本。
 
 #### Scenario: API 暴露构建版本
+
 - **WHEN** 运维查看 API `/health` 响应
 - **THEN** 响应中的 `commit` MUST 对应当前运行镜像构建时的 Git commit
 - **AND** `buildTime` MUST 对应镜像构建时间或发布流水线生成时间
 
 #### Scenario: Web 运行时可观测版本
+
 - **WHEN** 运维检查 Web 生产运行状态
 - **THEN** Web 服务 MUST 提供可观测的 commit 或 build metadata
 - **AND** 该 metadata MUST NOT 要求为了变更 API 域名而重新构建 Web 镜像
 
 ### Requirement: 健康检查必须区分进程可用与依赖状态
+
 健康能力 SHALL 明确区分服务进程可用和 PostgreSQL/Redis 等依赖检查，避免短暂依赖抖动导致容器被错误重启。
 
 #### Scenario: 默认健康检查不执行深度依赖检查
+
 - **WHEN** 容器运行默认 healthcheck
 - **THEN** API MUST 只验证进程和 HTTP 处理能力可用
 - **AND** PostgreSQL 或 Redis 深度检查 MUST NOT 成为默认容器重启条件，除非文档和 compose 明确选择深度模式
 
 #### Scenario: 深度健康检查可用于部署 smoke
+
 - **WHEN** 部署 runbook 需要验证 PostgreSQL 或 Redis 可用性
 - **THEN** 系统 MAY 提供单独的深度检查模式或 smoke 命令
 - **AND** 深度检查失败 MUST 返回可观测失败状态但不得泄漏 secret
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/public-api-documentation/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/public-api-documentation/spec.md
index 2e8730d..6526db7 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/public-api-documentation/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/public-api-documentation/spec.md
@@ -1,89 +1,109 @@
 ## ADDED Requirements
 
 ### Requirement: API 文档必须面向外部参考和学习
+
 项目 SHALL 提供完整的外部 API reference，使第三方开发者能理解如何调用 CNode API、如何认证、如何处理错误以及如何兼容 legacy nodeclub API v1。
 
 #### Scenario: 开发者首次阅读 API 文档
+
 - **WHEN** 外部开发者打开 API reference
 - **THEN** 文档 MUST 展示 base URL、版本策略、认证方式、通用响应结构、错误格式、分页语义和限流说明
 - **AND** 文档 MUST 标注哪些接口公开可读、哪些接口需要登录 session 或 access token
 
 #### Scenario: 开发者调用具体接口
+
 - **WHEN** 外部开发者查看某个 API endpoint
 - **THEN** 文档 MUST 提供 HTTP method、path、请求参数、请求示例、成功响应示例、失败响应示例和字段说明
 - **AND** 示例 MUST 使用可复制的 `curl` 或等价 HTTP 请求格式
 
 ### Requirement: API 契约必须提供 OAS 机器可读文档
+
 项目 SHALL 提供 OpenAPI Specification (OAS) 文档作为外部 API reference 和未来 smoke/contract 验证的机器可读来源。
 
 #### Scenario: OAS 文件存在
+
 - **WHEN** 外部开发者或验证脚本查找 API 契约
 - **THEN** 仓库 MUST 提供 `docs/openapi.yaml`、`docs/api/openapi.yaml` 或等价位置的 OAS 文件
 - **AND** README 或 API reference MUST 链接到该 OAS 文件
 
 #### Scenario: OAS 可被工具读取
+
 - **WHEN** 验证脚本或 OpenAPI 工具读取 OAS 文件
 - **THEN** OAS MUST 定义 `openapi` 版本、`info`、`servers`、`paths`、`components.schemas` 和认证方案
 - **AND** OAS MUST 不包含生产 secret、真实用户 token 或私有环境变量
 
 ### Requirement: OAS 接口必须按对外能力分组
+
 OAS SHALL 使用 tags 按外部能力分组，而不是按代码文件、数据库表或内部模块分组。
 
 #### Scenario: 核心接口分组
+
 - **WHEN** 外部开发者浏览 OAS tags
 - **THEN** tags MUST 至少覆盖帖子、回复、用户、收藏、消息、认证、搜索和系统配置
 - **AND** 帖子与回复能力 MUST 作为最核心分组出现在文档中
 
 #### Scenario: 管理和内部接口分组
+
 - **WHEN** OAS 包含后台管理、巡检或运维接口
 - **THEN** 这些接口 MUST 使用单独 tag 标记为管理或内部能力
 - **AND** 文档 MUST 明确它们不是普通外部客户端的主要集成入口
 
 ### Requirement: OAS 必须优先覆盖帖子和回复能力
+
 OAS SHALL 第一优先级覆盖对外展示和客户端高频使用的帖子、回复、用户、收藏和消息能力。
 
 #### Scenario: 帖子 API 覆盖
+
 - **WHEN** 外部开发者查看帖子能力
 - **THEN** OAS MUST 覆盖帖子列表、帖子详情、发帖、编辑帖子和相关参数
 - **AND** OAS MUST 展示成功响应、错误响应、分页和 `mdrender` 语义
 
 #### Scenario: 回复 API 覆盖
+
 - **WHEN** 外部开发者查看回复能力
 - **THEN** OAS MUST 覆盖回复列表或帖子回复、创建回复、编辑回复、删除回复、点赞和取消点赞
 - **AND** OAS MUST 展示回复作者、内容、时间、点赞状态和 legacy-compatible 字段
 
 #### Scenario: 用户、收藏和消息 API 覆盖
+
 - **WHEN** 外部开发者查看用户、收藏和消息能力
 - **THEN** OAS MUST 覆盖用户资料、用户话题、用户回复、收藏/取消收藏、消息列表和消息已读
 - **AND** OAS MUST 标注每个接口的认证要求
 
 ### Requirement: API 文档必须覆盖 nodeclub 兼容语义
+
 API reference SHALL 明确 `/api/v1/*` 与 legacy `../nodeclub/api_router_v1.js` 和 `../nodeclub/api/v1/` 的兼容关系。
 
 #### Scenario: 兼容字段说明
+
 - **WHEN** API 响应包含 legacy 字段名、嵌套结构或兼容行为
 - **THEN** 文档 MUST 标明字段含义和兼容原因
 - **AND** 文档 MUST 标明任何显式废弃、redirect 或不再支持的 legacy 行为
 
 #### Scenario: Markdown 内容渲染说明
+
 - **WHEN** API endpoint 返回 topic、reply 或 message content
 - **THEN** 文档 MUST 说明 `mdrender` 参数或默认渲染语义
 - **AND** 文档 MUST 给出原始 Markdown 与 HTML 渲染响应的示例
 
 ### Requirement: API 文档必须与发布验证关联
+
 API 文档 SHALL 作为 D 级 release readiness 的验收项，避免实现、OpenSpec 和外部文档长期漂移。
 
 #### Scenario: 发布前检查 API 文档
+
 - **WHEN** release readiness checklist 被执行
 - **THEN** checklist MUST 要求确认新增或变更 API 已更新 API reference
 - **AND** 若 API 行为发生变化但文档未更新，发布 MUST 被视为未达 D 级准入
 
 #### Scenario: API smoke 与文档示例一致
+
 - **WHEN** API smoke 或 contract verifier 覆盖某个公开 endpoint
 - **THEN** 文档中的示例响应 shape MUST 与 verifier 期望的核心字段一致
 - **AND** 文档不得展示已废弃或不可调用的示例作为推荐用法
 
 #### Scenario: OAS 被 smoke 或 contract 验证复用
+
 - **WHEN** 未来实现 API smoke 或 contract verifier
 - **THEN** verifier SHOULD 复用 OAS 中的 paths、methods、schemas 或 examples 作为检查来源
 - **AND** 若 verifier 暂未完全复用 OAS，release readiness checklist MUST 明确记录覆盖差距
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/release-verification-gates/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/release-verification-gates/spec.md
index 0e2965b..13d57ab 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/release-verification-gates/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/release-verification-gates/spec.md
@@ -5,29 +5,35 @@
 项目 SHALL 提供统一的 `pnpm verify` 命令作为本地、CI 和生产部署前的发布准入入口。
 
 #### Scenario: 本地运行发布验证
+
 - **WHEN** 开发者在仓库根目录运行 `pnpm verify`
 - **THEN** 命令 MUST 执行 lint、typecheck、test、build、OpenSpec strict validate 和 secret scan
 - **AND** 任一子命令失败时 `pnpm verify` MUST 以非零退出码失败
 
 #### Scenario: CI 复用同一验证入口
+
 - **WHEN** GitHub Actions 验证 PR 或 main 分支提交
 - **THEN** workflow MUST 运行与本地一致的 `pnpm verify`
 - **AND** workflow MUST NOT 使用少于本地发布验证的命令集合
 
 ### Requirement: 发布门禁必须阻断失败变更
+
 发布验证 gate SHALL 在代码质量、类型、测试、构建、OpenSpec 或 secret scan 任一项失败时阻断镜像发布。
 
 #### Scenario: lint 失败阻断发布
+
 - **WHEN** `pnpm lint` 返回非零退出码
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
 
 #### Scenario: OpenSpec strict validate 失败阻断发布
+
 - **WHEN** `openspec validate --all --strict` 返回非零退出码
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
 
 #### Scenario: secret scan 失败阻断发布
+
 - **WHEN** secret scan 发现未允许的 secret
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/secret-scanning/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/secret-scanning/spec.md
index 0d1b462..c801b26 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/secret-scanning/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/secret-scanning/spec.md
@@ -1,14 +1,17 @@
 ## ADDED Requirements
 
 ### Requirement: CI release gate 必须执行 secret scanning
+
 CI release verification gate SHALL 使用仓库根目录 `.gitleaks.toml` 执行 secret scan，并在发现未允许 secret 时阻断镜像发布。
 
 #### Scenario: CI secret scan 通过
+
 - **WHEN** GitHub Actions 运行 release verification gate 且未发现 secret
 - **THEN** secret scanning step MUST 成功
 - **AND** 后续验证步骤 MAY 继续执行
 
 #### Scenario: CI secret scan 失败
+
 - **WHEN** GitHub Actions 运行 release verification gate 且发现 `.gitleaks.toml` 规则识别出的 secret
 - **THEN** release verification gate MUST 失败
 - **AND** workflow MUST NOT 构建或推送生产镜像
diff --git a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/web-api-contract-integration/spec.md b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/web-api-contract-integration/spec.md
index b6dbea6..9e55f40 100644
--- a/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/web-api-contract-integration/spec.md
+++ b/openspec/changes/archive/2026-07-28-reach-production-grade-release-readiness/specs/web-api-contract-integration/spec.md
@@ -1,40 +1,49 @@
 ## ADDED Requirements
 
 ### Requirement: Web API 调用必须引用 OAS 契约
+
 `apps/web` SHALL 与 OAS API 契约建立持续校验关系，避免前端调用、后端实现和外部 API 文档漂移。
 
 #### Scenario: Web 使用 OAS 类型或校验
+
 - **WHEN** `apps/web` 调用 `/api/v1/*` 或其他公开 API
 - **THEN** 项目 MUST 提供从 OAS 生成的 TypeScript 类型、生成 API client、或验证脚本中的 OAS path/schema 校验
 - **AND** 该机制 MUST 被 `pnpm verify` 或 release readiness checklist 覆盖
 
 #### Scenario: Web 调用未记录 API
+
 - **WHEN** `apps/web` 新增对某个 API path 的调用
 - **THEN** OAS MUST 包含该 path、method、认证要求和核心响应 schema
 - **AND** 若 OAS 未覆盖该调用，验证 MUST 失败或 release readiness checklist MUST 标记为未达 D 级准入
 
 ### Requirement: OAS 更新必须能驱动 Web 契约同步
+
 当 OAS 中影响 Web 的 API path、method、request 或 response schema 发生变化时，项目 SHALL 提供机制提醒或阻断未同步的 Web 调用。
 
 #### Scenario: OAS 删除 Web 依赖接口
+
 - **WHEN** OAS 删除或重命名 `apps/web` 仍在调用的 API path
 - **THEN** 验证 MUST 失败或生成类型 MUST 导致 typecheck 失败
 - **AND** 开发者 MUST 同步更新 Web 调用或恢复 OAS 契约
 
 #### Scenario: OAS 修改核心响应字段
+
 - **WHEN** OAS 修改 Web loader、action 或组件依赖的核心响应字段
 - **THEN** 生成类型或契约验证 MUST 能提示 Web 代码需要同步
 - **AND** Web 不得继续依赖已从 OAS 移除的字段作为稳定契约
 
 ### Requirement: Web 契约集成必须优先覆盖核心外部能力
+
 Web 与 OAS 的持续集成 SHALL 优先覆盖帖子、回复、用户、收藏和消息相关 API。
 
 #### Scenario: 帖子和回复调用被覆盖
+
 - **WHEN** Web 加载首页、话题详情、发帖或回帖页面
 - **THEN** 相关 API paths MUST 在 OAS 中定义
 - **AND** Web 契约校验 MUST 覆盖这些 paths 的 method 和核心响应字段
 
 #### Scenario: 用户、收藏和消息调用被覆盖
+
 - **WHEN** Web 加载用户页、收藏状态或消息页
 - **THEN** 相关 API paths MUST 在 OAS 中定义
 - **AND** Web 契约校验 MUST 标注登录态或 access token 要求
diff --git a/openspec/changes/archive/2026-07-29-add-jobs-zone/design.md b/openspec/changes/archive/2026-07-29-add-jobs-zone/design.md
index 3a98c5d..be60406 100644
--- a/openspec/changes/archive/2026-07-29-add-jobs-zone/design.md
+++ b/openspec/changes/archive/2026-07-29-add-jobs-zone/design.md
@@ -7,6 +7,7 @@ cnode-next 现有内容模型：`topics` 表（`packages/db/src/schema/topic.ts:
 ## Goals / Non-Goals
 
 **Goals:**
+
 - 落地"topics 基础表 + 专用 meta 侧表"的专区扩展模式，验证其为后续专区（gallery/event）的模板
 - 招聘信息结构化：公司/职位/地点/远程/薪资/经验/技术栈/联系方式/logo 上传
 - 专区列表卡片化 + 顶条 facet 筛选，移动端适配
@@ -17,6 +18,7 @@ cnode-next 现有内容模型：`topics` 表（`packages/db/src/schema/topic.ts:
 - 管理后台新增专区管理、Tab 管理两个页面
 
 **Non-Goals:**
+
 - 不新建独立 `jobs` 内容类型表
 - 不做通用 facet 框架（每专区定制筛选器）
 - 不改变首页社区流形态（`TopicList` + `FeedGrid` 不动）
@@ -32,6 +34,7 @@ cnode-next 现有内容模型：`topics` 表（`packages/db/src/schema/topic.ts:
 **决策**：招聘不新建独立内容类型，复用 `topics` 表（`tab='job'`）+ 新增 `job_meta` 侧表（1:1 FK → `topics.id` ON DELETE CASCADE）。评论区复用现有 `reply` 表。
 
 **被否决的方案**：
+
 - **A. topics + JSON meta 列**：在 topics 加 `meta jsonb` 列。否决理由：字段类型安全弱（运行时 Zod 校验，无 Drizzle 强类型），跨专区查询会混入非该专区行。
 - **C. 独立 `jobs` 表**：完全独立内容类型 + 独立全栈代码。否决理由：公共字段（author_id/visit_count/status/create_at...）重复，评论区需 polymorphic reply（改 reply 表加 `target_type` 列，影响现有 reply 系统）。虽支持"每专区定制筛选器"，但互动复用要求与"独立表"天然冲突 —— 用户明确选择保留评论并复用 reply，B 方案使评论区零改动。
 
@@ -74,6 +77,7 @@ erDiagram
 ```
 
 **字段说明**：
+
 - `topic_id`：PK 同时是 FK → `topics.id`，`ON DELETE CASCADE`
 - `remote`：枚举值 `on-site` / `hybrid` / `remote`，用 text 存储（避免 enum 迁移复杂度，Zod 校验）
 - `salary_min/max`：整数（单位 K），便于范围筛选；`null` 表示面议
@@ -82,6 +86,7 @@ erDiagram
 - `company_logo`：OSS URL，复用 `uploadPrefix()` 前缀
 
 **被否决的方案**：
+
 - `salary_range` 用 range 类型：PG range 查询语法重，前端传参不便，拆成 min/max 更直观
 - `tech_tags` 关联表：标签数量有限（每帖 3-8 个），数组足够，避免 join 开销
 - `contact` 脱敏存储：v1 不做，保持简单，后续如需可在展示层脱敏
@@ -104,10 +109,12 @@ sequenceDiagram
 ```
 
 **校验规则**（在 Zod 层用 superRefine 实现）：
+
 - `tab !== "job"` 时 `job_meta` 必须为 `undefined`（传了报错）
 - `tab === "job"` 时 `job_meta` 必填且字段必填（company/position/location/contact 不可空，salary/experience 可选）
 
 **被否决的方案**：
+
 - 拆两次 API 调用（先建 topic 再补 meta）：否决理由：失败时需补偿事务回滚，复杂度高；用户明确选择单次提交
 - job_meta 独立 CRUD 端点：否决理由：job_meta 无独立生命周期，随 topic 走，独立端点制造"meta 可独立修改"的错误心智模型
 
@@ -124,6 +131,7 @@ flowchart LR
 ```
 
 **筛选维度与 facet 来源**：
+
 - `location`：从 `job_meta.location` 聚合 distinct 值
 - `remote`：固定枚举 on-site/hybrid/remote
 - `salary_min`：用户传入下限，`job_meta.salary_max >= :salary_min` 筛选
@@ -134,6 +142,7 @@ flowchart LR
 **移动端适配**：`JobFilterBar` 在 `<md` 折叠为"筛选"按钮触发的 Sheet（复用 `ui/sheet`），`JobCardGrid` 改为单列。
 
 **被否决的方案**：
+
 - 侧栏筛选面板（复用 `FeedGrid` 骨架）：否决理由：移动端需变抽屉，桌面端挤占卡片空间；用户明确选择顶条
 - 通用 facet 框架（schema 驱动）：否决理由：用户明确选择每专区定制筛选器，避免提前抽象
 
@@ -156,6 +165,7 @@ flowchart LR
 ```
 
 **被否决的方案**：
+
 - meta 卡片放 content 下方：否决理由：用户点进卡片主要看公司/薪资/投递方式，放下方要求先扫完 JD，效率低；用户明确选择上方
 - meta 信息嵌入 markdown 渲染：否决理由：侵入 MarkdownView 渲染器，复杂度高，且 meta 与 content 耦合不可控
 
@@ -163,10 +173,10 @@ flowchart LR
 
 **决策**：`contact` 字段值按形态分发 CTA 行为，v1 实施时按以下规则：
 
-| contact 形态 | CTA 行为 |
-|---|---|
-| 邮箱（含 @） | `mailto:` 链接 |
-| URL（http/https） | 跳转新窗口 |
+| contact 形态         | CTA 行为                             |
+| -------------------- | ------------------------------------ |
+| 邮箱（含 @）         | `mailto:` 链接                       |
+| URL（http/https）    | 跳转新窗口                           |
 | 其他（微信/QQ/电话） | 弹出 Sheet 显示联系方式 + "复制"按钮 |
 
 此决策标为"实施时最终确认"，提案不锁定具体组件。
@@ -189,17 +199,19 @@ flowchart TD
 
 **三层独立控制模型**：
 
-| 层 | 控制项 | 数据源 | 行为 |
-|---|---|---|---|
-| API 行为层 | `topic.ts:82` `excludeTabs: ["job"]` | 硬编码 | tab=job 永远不在首页列表 API 返回 |
-| UI tab 层 | 首页 tab 按钮可见性 | `tabs.visible` | 控制按钮渲染，不影响 API 返回 |
-| 导航层 | 专区入口可见性 | `zones.visible` | 控制导航栏专区下拉是否出现该专区 |
+| 层         | 控制项                               | 数据源          | 行为                              |
+| ---------- | ------------------------------------ | --------------- | --------------------------------- |
+| API 行为层 | `topic.ts:82` `excludeTabs: ["job"]` | 硬编码          | tab=job 永远不在首页列表 API 返回 |
+| UI tab 层  | 首页 tab 按钮可见性                  | `tabs.visible`  | 控制按钮渲染，不影响 API 返回     |
+| 导航层     | 专区入口可见性                       | `zones.visible` | 控制导航栏专区下拉是否出现该专区  |
 
 **migration/bootstrap 默认值**：
+
 - `tabs`：share/ask/job/good 全部 `visible=true`（保持现状）
 - `zones`：jobs `visible=false`（内测能力，暂不开放，需管理员主动开启）
 
 **数据库发布边界**：
+
 - 非临时数据库的 schema 变更 SHALL 通过 Drizzle migration 文件执行，不使用 `drizzle-kit push` 直接改当前连接库。
 - `tabs` 与 `zones` 的生产必需默认行 SHALL 作为 migration/bootstrap 数据幂等初始化，不能依赖 `pnpm db:seed`。
 - `pnpm db:seed` 只允许用于空库初始化或本地开发测试数据，MUST NOT 删除 `users` / `topics` / `replies` / `messages` / `topic_collects` 等业务表。
@@ -208,6 +220,7 @@ flowchart TD
 **指引合并形态**：v1 采用"单页 + 锚点"，`/help` 渲染合并后的内容，原有 `/getstart` `/about` `/faq` 路由保留（避免外链 404），但导航栏不再直接暴露。`/api` 因含 SwaggerUI 组件体量大，v1 保留独立路由 `/api`，在 `/help` 页面提供链接而非内嵌。
 
 **被否决的方案**：
+
 - 4 页全合并为单页内嵌 API 文档：否决理由：SwaggerUI 重，内嵌影响 `/help` 页性能
 - 删除原有路由强制迁移：否决理由：外链/书签 404 成本高，保留路由做软合并
 - 复用 `site_settings` KV 表存 tab/zone 配置：否决理由：site_settings 是扁平 KV，不支持排序字段、结构化配置；专用表更清晰
@@ -241,12 +254,14 @@ erDiagram
 ```
 
 **字段说明**：
+
 - `tabs.key`：与 `topics.tab` 字段值对应，UNIQUE 约束
 - `tabs.visible`：控制首页 tab 按钮渲染；`visible=false` 时首页不展示该按钮，但 `?tab=xxx` 直接访问仍可见（向后兼容）
 - `zones.slug`：与专区路由 `/zone/:slug` 对应，UNIQUE 约束
 - `zones.visible`：控制导航栏专区下拉是否展示该专区；`visible=false` 时专区路由仍可直接访问
 
 **被否决的方案**：
+
 - 合并为一张 `navigation_items` 通用表：否决理由：tab 与 zone 字段集不同（tab 有 key 对应 topics.tab，zone 有 slug 对应路由），强行合并会产生冗余字段
 - 复用 `site_settings` KV：否决理由：不支持 sort_order，结构化配置差
 
@@ -272,6 +287,7 @@ flowchart LR
 **管理后台 UI 形态**：列表表格 + 行内编辑，每行包含可见性 Checkbox 和排序输入，保存调用 PATCH 端点。不新增/删除 tab/zone（v1 只管理现有 migration/bootstrap 行的可见性与排序），加新区或新 tab 通过 migration/bootstrap 完成。
 
 **被否决的方案**：
+
 - 在现有 `admin/settings.tsx` 加 Tab：否决理由：settings 是系统级配置（注册/限流），tab/zone 是内容运营配置，职责不同
 - 完整 CRUD（新增/删除 tab/zone）：否决理由：tab/zone 与代码逻辑（专区组件、tab 枚举）强绑定，运行时新增无对应代码的 tab/zone 会产生悬空配置；v1 只做可见性与排序管理
 
diff --git a/openspec/changes/archive/2026-07-29-add-jobs-zone/proposal.md b/openspec/changes/archive/2026-07-29-add-jobs-zone/proposal.md
index 2121994..e7e1d0d 100644
--- a/openspec/changes/archive/2026-07-29-add-jobs-zone/proposal.md
+++ b/openspec/changes/archive/2026-07-29-add-jobs-zone/proposal.md
@@ -27,6 +27,7 @@ cnode-next 基础能力已完备，社区内容形态仍以"分享/问答"为主
 ## Capabilities
 
 ### New Capabilities
+
 - `jobs-zone`: 招聘专区展示与筛选能力 —— 卡片网格布局、顶条 facet 筛选、结构化字段筛选逻辑、专区路由与数据加载
 - `jobs-structured-fields`: 招聘结构化字段能力 —— job_meta 表、字段定义、发布/编辑表单、单次提交契约
 - `jobs-detail-card`: 招聘详情页 meta 卡片展示能力 —— content 上方插入 JobMetaCard、徽章渲染、CTA 投递入口
@@ -36,6 +37,7 @@ cnode-next 基础能力已完备，社区内容形态仍以"分享/问答"为主
 - `database-change-safety`: 数据库变更安全能力 —— Drizzle migration 流程、seed 边界、远程执行保护、备份与预检要求
 
 ### Modified Capabilities
+
 - `navigation-shell`: 导航栏新增"专区"下拉入口，指引类链接合并为单一入口
 - `topic-detail-experience`: 详情页在 `tab=job` 时于 content 上方渲染 meta 卡片
 - `web-ui-forms`: 发帖/编辑表单按 tab 条件渲染右侧 meta 字段面板
diff --git a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/documentation-information-architecture/spec.md b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/documentation-information-architecture/spec.md
index 31b4fce..f841e21 100644
--- a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/documentation-information-architecture/spec.md
+++ b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/documentation-information-architecture/spec.md
@@ -1,121 +1,147 @@
 ## MODIFIED Requirements
 
 ### Requirement: 项目文档必须任务导向并适度使用图形
+
 项目文档 SHALL 以读者任务为中心组织内容；当文档包含图形时，图形 MUST 用于解释结构、流程、状态或关系，并遵循“描述 → 图形 → 简约说明”的块结构。
 
 #### Scenario: 读者查看 README
+
 - **WHEN** 读者打开 `README.md`
 - **THEN** README MUST 以简短项目介绍、核心能力、技术栈、快速开始、文档入口、贡献、安全和许可证为主
 - **AND** README MUST NOT 以“重写版本”、legacy 迁移、生产上线验收或大量 Mermaid 图作为主要内容
 
 #### Scenario: 读者查看包含图形的文档
+
 - **WHEN** 文档包含 Mermaid 图、架构图、流程图、时序图或关系图
 - **THEN** 图形前 MUST 有 1-2 句描述说明图形要解决的读者问题
 - **AND** 图形后 MUST 使用表格或短列表给出必要说明
 - **AND** 图形后说明 MUST 保持简约，不得重复图形已经表达的内容
 
 #### Scenario: 读者查看架构文档
+
 - **WHEN** 读者打开架构文档
 - **THEN** 文档 MUST 使用图形说明系统拓扑、请求流或数据边界
 - **AND** 每张图后只保留必要边界、约束和跳转链接
 
 ### Requirement: docs 目录必须简化和合并
+
 `docs/` SHALL 按读者任务保留少数稳定入口，并提供项目文档规范和开发规范；`docs/`、`wiki/` 与 `deploy/` SHALL 作为同级内容域分别承接项目任务文档、知识沉淀和生产部署域，避免 `docs/` 变成历史材料或部署资产仓库。
 
 #### Scenario: 文档规范入口
+
 - **WHEN** 贡献者需要新增或修改文档
 - **THEN** `docs/` MUST 提供 `docs/conventions.md` 或等价规范入口
 - **AND** 该规范 MUST 覆盖文档结构、图形使用、表格优先、API 文档格式、`docs/`/`wiki/`/`deploy/` 目录边界、开发规范和 secret handling 链接
 
 #### Scenario: 文档主题重复
+
 - **WHEN** 两个或多个 `docs/*.md` 描述同一部署、迁移、数据库、安全或开发主题
 - **THEN** 它们 MUST 被合并或明确拆分职责
 - **AND** 旧入口 MUST 提供跳转、被归档或被删除，避免读者看到冲突说明
 
 #### Scenario: 一次性上线材料
+
 - **WHEN** 文档描述单次发布验收材料、内部评级、部署审计结果或历史验收记录
 - **THEN** 该内容 MUST NOT 作为长期主文档入口
 - **AND** 它 MUST 被删除、移到归档位置，或只保留在实际运维审计记录中
 
 #### Scenario: 迁移和业务知识沉淀
+
 - **WHEN** 文档描述 legacy `../nodeclub/` 迁移背景、历史兼容原因、社区规则或业务逻辑分析
 - **THEN** 该内容 MUST 放入 `wiki/` 或等价知识库目录
 - **AND** `docs/` 中只保留完成开发、运行、部署或调用任务所需的简短链接
 
 ### Requirement: wiki 知识库必须有独立写作规范
+
 `wiki/` SHALL 作为与 `docs/` 同级的知识库目录，承接迁移背景、业务逻辑和社区知识沉淀，并 MUST 有独立写作规范约束来源、事实边界、推断标记和 AI agent 行为。
 
 #### Scenario: wiki 文档包含来源和范围
+
 - **WHEN** 贡献者或 AI agent 新增 `wiki/` 文档
 - **THEN** 文档 MUST 标明信息来源，例如当前代码路径、legacy `../nodeclub/` 路径、线上行为观察、OpenSpec archive 或人工确认
 - **AND** 文档 MUST 标明适用范围和最后复核时间或复核状态
 
 #### Scenario: wiki 区分事实和推断
+
 - **WHEN** `wiki/` 文档包含从代码、历史行为或讨论中推导出的结论
 - **THEN** 文档 MUST 区分已确认事实、合理推断和待确认问题
 - **AND** AI agent MUST NOT 将未验证推断写成确定事实
 
 #### Scenario: wiki 避免无依据扩写
+
 - **WHEN** AI agent 缺少源码、legacy 路径、线上观察或用户确认作为依据
 - **THEN** AI agent MUST 将内容标记为待确认或不写入 wiki
 - **AND** 文档 MUST NOT 使用空泛、不可验证或营销式描述替代可追溯事实
 
 #### Scenario: wiki 与 docs 互相引用
+
 - **WHEN** `docs/` 需要引用迁移背景或业务逻辑知识
 - **THEN** `docs/` MUST 链接到 `wiki/` 对应页面
 - **AND** `docs/` MUST NOT 复制 wiki 中的长篇历史背景
 
 #### Scenario: wiki 与 docs 同级边界
+
 - **WHEN** 贡献者判断内容应放入 `docs/` 还是 `wiki/`
 - **THEN** 任务导向内容 MUST 放入 `docs/`
 - **AND** 历史、迁移、业务逻辑、社区规则和长期知识沉淀 MUST 放入 `wiki/`
 
 #### Scenario: deploy 与 docs/wiki 同级边界
+
 - **WHEN** 贡献者判断内容应放入 `docs/`、`wiki/` 还是 `deploy/`
 - **THEN** 可执行或可同步的部署资产 MUST 放入 `deploy/`
 - **AND** 生产部署 runbook SHOULD 放入 `deploy/` 并链接 `deploy/` 中的实际资产
 - **AND** 历史部署背景或运维知识沉淀 SHOULD 放入 `wiki/`
 
 #### Scenario: 文档索引更新
+
 - **WHEN** 文档结构调整完成
 - **THEN** README MUST 列出新的文档入口
 - **AND** 每个入口 MUST 用一句话说明适用读者和用途
 
 ### Requirement: 仓库根目录必须保持简约
+
 仓库根目录 SHALL 只保留开源项目入口和工具自动发现所必需的文件；部署编排、部署模板、SQL、启动脚本和运行环境相关材料 MUST 收敛到 `deploy/` 或等价部署资产目录。
 
 #### Scenario: 根目录文件复核
+
 - **WHEN** 读者查看仓库根目录
 - **THEN** 根目录 MUST 主要包含 `README.md`、`LICENSE`、`CONTRIBUTING.md`、`SECURITY.md`、package/workspace 配置、源码目录、`docs/`、`wiki/`、`deploy/` 和 OpenSpec 目录
 - **AND** 生产部署实现细节文件 MUST NOT 直接堆放在根目录
 
 #### Scenario: 部署文件组织
+
 - **WHEN** 仓库包含生产 Docker Compose、部署 SQL、启动脚本、部署模板、部署 helper 或部署环境示例
 - **THEN** 这些文件 MUST 放在 `deploy/` 或等价部署目录中
 - **AND** README、docs、CI 和运维命令 MUST 引用新路径
 
 ### Requirement: AGENTS 必须保持执行型简洁
+
 `AGENTS.md` SHALL 只保留协作代理需要执行的项目事实、命令、目录边界和关键约束。
 
 #### Scenario: 代理读取 AGENTS
+
 - **WHEN** 代理开始在项目中工作
 - **THEN** `AGENTS.md` MUST 明确技术栈、PostgreSQL-only、legacy `../nodeclub/` 只读参考、常用命令和 OpenSpec 工作流
 - **AND** `AGENTS.md` MUST NOT 复制长篇架构、部署或 API 文档内容
 
 ### Requirement: 仓库治理文档必须齐备
+
 仓库 SHALL 提供贡献、许可证和安全入口，使外部协作者知道如何参与、如何使用代码以及如何报告安全问题。
 
 #### Scenario: 外部协作者查看贡献说明
+
 - **WHEN** 外部协作者准备提交 issue、PR 或本地验证
 - **THEN** 仓库 MUST 提供 `CONTRIBUTING.md` 或等价贡献文档
 - **AND** 文档 MUST 指向 `pnpm verify`、OpenSpec change 流程、`docs/conventions.md` 和 secret handling 规则
 
 #### Scenario: 外部读者查看许可证
+
 - **WHEN** 外部读者查看仓库根目录
 - **THEN** 仓库 MUST 提供 MIT `LICENSE`
 - **AND** README MUST 使用确定语气链接许可证，不得使用“license status”这类内部状态描述
 
 #### Scenario: 安全问题报告
+
 - **WHEN** 外部用户需要报告安全问题
 - **THEN** 仓库 MUST 提供 `SECURITY.md` 或在安全文档中提供清晰报告方式
 - **AND** 文档 MUST 提醒不要在公开 issue 中粘贴 secrets、tokens 或用户隐私数据
diff --git a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/production-deployment-governance/spec.md b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/production-deployment-governance/spec.md
index 2523a4b..198e862 100644
--- a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/production-deployment-governance/spec.md
+++ b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/production-deployment-governance/spec.md
@@ -1,79 +1,95 @@
 ## ADDED Requirements
 
 ### Requirement: 生产部署资产必须集中管理
+
 生产部署 runbook、部署编排、部署模板、部署 SQL、启动脚本、dotenv 示例和部署辅助文件 SHALL 收敛到专门的 `deployment/` 部署域，避免仓库根目录或 `docs/` 堆放生产实现细节。
 
 #### Scenario: 生产 compose 文件位置
+
 - **WHEN** 仓库提供生产 Docker Compose 编排
 - **THEN** 该文件 MUST 位于 `deployment/` 或等价部署目录
 - **AND** 根目录 MUST NOT 直接放置生产编排文件
 
 #### Scenario: deploy 与 docs/wiki 同级
+
 - **WHEN** 仓库包含生产部署 runbook 或部署资产
 - **THEN** `deployment/` MUST 作为与 `docs/`、`wiki/` 同级的顶层目录存在
 - **AND** `deployment/` MUST 包含 README 或等价规范说明生产部署步骤和部署资产职责边界
 
 #### Scenario: 部署资产分类
+
 - **WHEN** 部署资产包含 compose、SQL、启动脚本或配置模板
 - **THEN** 这些文件 MUST 在 `deployment/` 内按用途清晰命名或分目录组织
 - **AND** `deployment/` 规范 MUST 说明 docker-compose 文件、SQL 文件、启动脚本和 dotenv 模板各自用途
 
 #### Scenario: 部署命令引用新路径
+
 - **WHEN** 文档、脚本或运维 runbook 引用生产 compose 文件
 - **THEN** 它们 MUST 使用新的部署目录路径，例如 `deployment/docker-compose.yml`
 - **AND** 旧路径 MUST 不再作为推荐命令出现
 
 #### Scenario: dotenv 示例按配置域分组
+
 - **WHEN** 仓库提供部署 dotenv 示例或模板
 - **THEN** 模板 MUST 使用注释或等价结构按配置域分组
 - **AND** 分组 SHOULD 覆盖应用 URL、数据库、Redis、认证、对象存储、Turnstile、邮件、观测/日志和迁移/运维开关
 - **AND** 模板 MUST 使用占位值，不得包含真实 secret、token、私有连接串或生产用户数据
 
 #### Scenario: 启动脚本和 SQL 可追溯
+
 - **WHEN** `deployment/` 包含启动脚本或 SQL 文件
 - **THEN** 文件名或相邻说明 MUST 表达执行时机和用途
 - **AND** 文档 MUST 说明这些资产是否可重复执行、是否会修改数据、以及执行前需要的环境变量
 
 ### Requirement: CI 必须避免一次性文件文本验收脚本
+
 CI 和 `pnpm verify` SHALL 使用长期可维护的通用质量门禁，避免依赖大量针对具体文件内容、具体文档句子或一次性上线验收目标的专项 verify 脚本。
 
 #### Scenario: 通用质量门禁
+
 - **WHEN** CI 执行发布或 PR 验证
 - **THEN** 它 SHOULD 运行 lint、typecheck、test、build、OpenSpec validate、secret scan 和 OpenAPI 契约检查这类通用检查
 - **AND** repository verification MUST NOT 在本地运行 Docker Compose；Compose validation MUST 属于部署 preflight
 - **AND** 这些检查 MUST NOT 依赖真实 `.env` secret 值
 
 #### Scenario: 专项 verify 脚本收敛
+
 - **WHEN** `scripts/` 中存在只验证当前文档文本、当前 compose 文本或当前 workflow 文本的 `verify-*` 脚本
 - **THEN** 该脚本 MUST 被删除、归档到一次性变更记录，或替换为更通用的契约/配置校验
 - **AND** `pnpm verify` MUST NOT 长期依赖这类一次性脚本
 
 #### Scenario: 文档结构由规范约束
+
 - **WHEN** 文档结构、目录职责或 README 信息架构需要约束
 - **THEN** 约束 SHOULD 写入 `docs/conventions.md`、OpenSpec 或 review checklist
 - **AND** CI MUST NOT 通过硬编码文档必须包含某几句固定文字来代替人工 review
 
 ### Requirement: GitHub Actions 必须按职责拆分
+
 GitHub Actions workflow SHALL 按 CI、镜像构建发布和生产部署入口分离职责，并使用最小权限。
 
 #### Scenario: PR 和分支 CI
+
 - **WHEN** pull request 或普通分支 push 触发验证
 - **THEN** `ci.yml` 或等价 CI workflow MUST 运行通用质量门禁
 - **AND** CI workflow MUST NOT 需要 `packages: write` 权限
 
 #### Scenario: 镜像构建发布
+
 - **WHEN** main、tag 或手动发布触发容器镜像构建
 - **THEN** 镜像 workflow MUST 与 PR CI 分离
 - **AND** 只有镜像 workflow SHOULD 使用 `packages: write` 权限推送 GHCR 镜像
 - **AND** 镜像 tag MUST 包含 commit SHA 或 digest 可追溯标识
 
 #### Scenario: 生产部署入口
+
 - **WHEN** 仓库提供 GitHub Actions 生产部署入口
 - **THEN** 部署 workflow MUST 与 CI 和镜像构建 workflow 分离
 - **AND** 部署 workflow MUST 使用手动触发、受保护 environment、最小权限 secret 和审计记录
 - **AND** 部署 workflow MUST NOT 在日志中打印 `.env`、tokens、私钥、数据库 URL 或用户数据
 
 #### Scenario: 当前无自动部署
+
 - **WHEN** 项目选择人工执行部署 runbook
 - **THEN** GitHub Actions MUST 只构建并发布镜像
 - **AND** 部署命令 MUST 保留在 `deployment/README.md` 或等价部署域说明中
diff --git a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/public-api-documentation/spec.md b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/public-api-documentation/spec.md
index 1492c6c..a9a4555 100644
--- a/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/public-api-documentation/spec.md
+++ b/openspec/changes/archive/2026-07-29-simplify-open-source-docs/specs/public-api-documentation/spec.md
@@ -1,15 +1,18 @@
 ## MODIFIED Requirements
 
 ### Requirement: API 文档必须面向外部参考和学习
+
 项目 SHALL 提供完整的外部 API reference，使第三方开发者能理解如何调用 CNode API、如何认证、如何处理错误以及如何兼容 legacy nodeclub API v1。API reference MUST 按社区接口手册习惯组织，避免混入本地开发说明。
 
 #### Scenario: 开发者首次阅读 API 文档
+
 - **WHEN** 外部开发者打开 API reference
 - **THEN** 文档 MUST 展示 base URL、版本策略、认证方式、通用响应结构、错误格式、分页语义和限流说明
 - **AND** 文档 MUST 标注哪些接口公开可读、哪些接口需要登录 session 或 access token
 - **AND** 文档 MUST NOT 将 `localhost` 或本地端口作为 API reference 的主要调用地址
 
 #### Scenario: 开发者调用具体接口
+
 - **WHEN** 外部开发者查看某个 API endpoint
 - **THEN** 文档 MUST 使用 HTTP method 和相对 path 作为接口标题或接口标识，例如 `GET /api/v1/topics`
 - **AND** 文档 MUST 对 path params、query、body 和 response fields 优先使用表格
@@ -17,28 +20,34 @@
 - **AND** 示例 MUST 使用可复制的 `curl` 或等价 HTTP 请求代码块
 
 #### Scenario: Base URL 与 endpoint path
+
 - **WHEN** API reference 展示接口列表或接口详情
 - **THEN** base URL MUST 只在总览中单独说明
 - **AND** endpoint 标题和接口表格 MUST 使用相对 path
 - **AND** curl 示例 MAY 使用完整生产 URL
 
 ### Requirement: OAS 接口必须按对外能力分组
+
 OAS SHALL 使用 tags 按外部能力分组，而不是按代码文件、数据库表或内部模块分组。
 
 #### Scenario: 核心接口分组
+
 - **WHEN** 外部开发者浏览 OAS tags
 - **THEN** tags MUST 至少覆盖帖子、回复、用户、收藏、消息、认证、搜索和系统配置
 - **AND** 帖子与回复能力 MUST 作为最核心分组出现在文档中
 
 #### Scenario: 管理和内部接口分组
+
 - **WHEN** OAS 包含后台管理、巡检或运维接口
 - **THEN** 这些接口 MUST 使用单独 tag 标记为管理或内部能力
 - **AND** 文档 MUST 明确它们不是普通外部客户端的主要集成入口
 
 ### Requirement: API reference 必须使用统一接口模板
+
 API reference SHALL 对每个核心公开接口使用一致的查阅模板，使读者能快速找到 method、path、认证、参数、请求体、响应字段、错误和示例。
 
 #### Scenario: 接口详情模板
+
 - **WHEN** 文档描述一个核心公开 API endpoint
 - **THEN** 文档 MUST 包含 method、relative path、认证要求和一句话 description
 - **AND** 文档 MUST 按需包含 `Path Params`、`Query`、`Body`、`Response`、`Errors` 和 `Example` 信息
@@ -46,42 +55,51 @@ API reference SHALL 对每个核心公开接口使用一致的查阅模板，使
 - **AND** 普通说明、错误摘要和示例 MUST NOT 被机械地全部表格化
 
 #### Scenario: 参数表格
+
 - **WHEN** endpoint 有 path params、query 或 body 字段
 - **THEN** 文档 MUST 使用 `Name`、`Type`、`Required`、`Default` 或 `Description` 等稳定列说明字段
 - **AND** 空 section MAY 省略以保持文档简洁
 
 #### Scenario: 响应和错误表格
+
 - **WHEN** endpoint 有成功响应或错误响应说明
 - **THEN** 文档 MUST 使用表格列出核心 response fields、类型和含义
 - **AND** 常见错误 MUST 使用 status、message/code 和 description 表格描述
 
 ### Requirement: API 文档必须覆盖 nodeclub 兼容语义
+
 API reference SHALL 明确 `/api/v1/*` 与 legacy `../nodeclub/api_router_v1.js` 和 `../nodeclub/api/v1/` 的兼容关系，但兼容背景 MUST 保持简洁并集中说明。
 
 #### Scenario: 兼容字段说明
+
 - **WHEN** API 响应包含 legacy 字段名、嵌套结构或兼容行为
 - **THEN** 文档 MUST 标明字段含义和兼容原因
 - **AND** 文档 MUST 标明任何显式废弃、redirect 或不再支持的 legacy 行为
 
 #### Scenario: Markdown 内容渲染说明
+
 - **WHEN** API endpoint 返回 topic、reply 或 message content
 - **THEN** 文档 MUST 说明 `mdrender` 参数或默认渲染语义
 - **AND** 文档 MUST 给出原始 Markdown 与 HTML 渲染响应的示例
 
 ### Requirement: API 文档必须与发布验证关联
+
 API 文档 SHALL 作为 release verification 的检查项，避免实现、OpenSpec 和外部文档长期漂移，但普通 API reference MUST NOT 使用内部评级语言作为读者主叙事。
 
 #### Scenario: 发布前检查 API 文档
+
 - **WHEN** release checklist 被执行
 - **THEN** checklist MUST 要求确认新增或变更 API 已更新 API reference
 - **AND** 若 API 行为发生变化但文档未更新，发布 MUST 被视为未满足发布准入
 
 #### Scenario: API smoke 与文档示例一致
+
 - **WHEN** API smoke 或 contract verifier 覆盖某个公开 endpoint
 - **THEN** 文档中的示例响应 shape MUST 与 verifier 期望的核心字段一致
 - **AND** 文档不得展示已废弃或不可调用的示例作为推荐用法
 
 #### Scenario: OAS 被 smoke 或 contract 验证复用
+
 - **WHEN** 未来实现 API smoke 或 contract verifier
 - **THEN** verifier SHOULD 复用 OAS 中的 paths、methods、schemas 或 examples 作为检查来源
 - **AND** 若 verifier 暂未完全复用 OAS，release checklist MUST 明确记录覆盖差距
diff --git a/openspec/changes/archive/2026-07-29-unify-api-contract-source/design.md b/openspec/changes/archive/2026-07-29-unify-api-contract-source/design.md
index f56181b..e69626c 100644
--- a/openspec/changes/archive/2026-07-29-unify-api-contract-source/design.md
+++ b/openspec/changes/archive/2026-07-29-unify-api-contract-source/design.md
@@ -38,6 +38,7 @@ cnode-next 的 API 契约目前有四份独立维护的"真理"：
 **理由**：`@hono/zod-openapi` 1.5.1 的 peerDep 是 `zod ^4.0.0` + `hono >=4.10.0`。项目当前是 `zod ^3.24.0` + `hono ^4.6.0`。zod 4 有破坏性变更（错误消息格式、`z.infer` 行为、`z.object().strict()` 等），但项目里只有 8 个文件 import zod，schema 定义集中在 `apps/api/routes/` 和 `packages/shared/schemas/`，可控。
 
 **被否决的方案**：
+
 - 用 `@hono/zod-openapi@0.18.2`（最后支持 zod 3 的版本）——避免升级，但锁定在旧版，未来 zod 4 迟早要升，只是把债推迟。
 - 分两个 change（先升 zod，再迁移 zod-openapi）——增加协调成本，且 zod 升级单独做没有直接收益。
 
@@ -48,6 +49,7 @@ cnode-next 的 API 契约目前有四份独立维护的"真理"：
 **理由**：`@hono/zod-openapi` 是 Hono 官方维护的中间件，与现有 `@hono/zod-validator` API 接近，迁移成本低。它内部用 `@asteasolutions/zod-to-openapi` 将 zod schema 转为 OAS schema，支持 `z.infer` 派生类型。
 
 **被否决的方案**：
+
 - 手写 `openapi.yaml` + `zod-validator` 双轨——当前状态，漂移无法消灭。
 - 用 `@asteasolutions/zod-to-openapi` 直接注册不走 hono 中间件——失去路由级声明和运行时校验的统一。
 
@@ -68,6 +70,7 @@ flowchart TD
 ```
 
 **被否决的方案**：
+
 - `openapi-typescript` 从 OAS codegen 类型——多一层 codegen，且 OAS→TS 会丢失 zod 富信息。类型和表单 zod 来源不同（类型从 OAS，表单 zod 从直接 import），链路分裂。
 - `openapi-fetch` / `orval` 生成 runtime client——改动 42 处 `apiFetch<T>` 调用点为 hooks 或 client 方法，侵入性过大，超出"只维护 OAS"的诉求。
 
@@ -80,6 +83,7 @@ flowchart TD
 OAS→zod codegen 工具链不成熟（`openapi-zod` 自述"use at your own risk, un-tested"，`openapi2zod` 低下载），且 OAS 天然表达不了 `.refine()`/`.extend()`，反向 codegen 必然有损。直接在 shared 定义 schema 是零损耗、零额外工具的唯一可靠路径。
 
 **被否决的方案**：
+
 - shared re-export from api——循环依赖（shared → api → shared），架构不合法。
 - OAS→zod codegen（`openapi-zod`/`openapi2zod`）——工具不稳，有损转换。
 - web 手写一份 zod schema——当前状态，漂移无法消灭。
@@ -103,6 +107,7 @@ OAS→zod codegen 工具链不成熟（`openapi-zod` 自述"use at your own risk
 **理由**：只迁移已覆盖的 42 个端点会让"唯一数据源"仍不完整，admin/user/message/community 的契约继续漂移。一次性迁移消灭所有盲区。
 
 **被否决的方案**：
+
 - 只迁移 OAS 已覆盖的 42 个端点——"唯一数据源"不唯一，admin 等继续手写。
 - 分两期（本期 42 个，下期 95 个）——协调成本高，且 42 个已覆盖端点的迁移方式会成为后续的参考，分批反而增加不确定性。
 
diff --git a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/api-contract/spec.md b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/api-contract/spec.md
index 787798d..6f5f33d 100644
--- a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/api-contract/spec.md
+++ b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/api-contract/spec.md
@@ -1,26 +1,31 @@
 ## MODIFIED Requirements
 
 ### Requirement: API 契约必须提供 OAS 机器可读文档
+
 项目 SHALL 提供 OpenAPI Specification (OAS) 文档作为外部 API reference 和未来 smoke/contract 验证的机器可读来源。OAS 文档 MUST 由 `apps/api` 路由内的 zod-openapi 声明自动生成，不得手写维护。
 
 #### Scenario: OAS 文件存在
+
 - **WHEN** 外部开发者或验证脚本查找 API 契约
 - **THEN** 仓库 MUST 提供由 `apps/api` 路由 zod-openapi 声明生成的 `api/openapi.json` 文件
 - **AND** README 或 API reference MUST 链接到该 OAS 文件
 - **AND** 项目 MUST NOT 保留手写的 `api/openapi.yaml` 或任何与路由声明脱节的手写 OAS 文件
 
 #### Scenario: OAS 从路由自动生成
+
 - **WHEN** 开发者修改 `apps/api/src/routes/*.ts` 中某个端点的 path、method、zod schema 或 OpenAPI metadata
 - **THEN** 运行 `pnpm gen:openapi` MUST 重新生成 `api/openapi.json` 反映该变更
 - **AND** `pnpm verify` 流程 MUST 在 `verify:openapi` 之前自动执行 `gen:openapi`
 - **AND** 生成的 `api/openapi.json` MUST 不包含 `x-contract-response-fields` 扩展——响应 schema 由完整 zod 定义描述
 
 #### Scenario: OAS 可被工具读取
+
 - **WHEN** 验证脚本或 OpenAPI 工具读取 OAS 文件
 - **THEN** OAS MUST 定义 `openapi` 版本、`info`、`servers`、`paths`、`components.schemas` 和认证方案
 - **AND** OAS MUST 不包含生产 secret、真实用户 token 或私有环境变量
 
 #### Scenario: OAS 覆盖全部路由端点
+
 - **WHEN** `apps/api/src/routes/*.ts` 中的任一路由文件新增端点
 - **THEN** 生成的 `api/openapi.json` MUST 包含该端点
 - **AND** 项目 MUST NOT 保留未在 OAS 中声明的 `/api/v1/*` 端点（除 `/health` 等内部端点外）
diff --git a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/public-api-documentation/spec.md b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/public-api-documentation/spec.md
index cbf531c..6a7a508 100644
--- a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/public-api-documentation/spec.md
+++ b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/public-api-documentation/spec.md
@@ -1,15 +1,18 @@
 ## MODIFIED Requirements
 
 ### Requirement: API 文档必须面向外部参考和学习
+
 项目 SHALL 提供完整的外部 API reference，使第三方开发者能理解如何调用 CNode API、如何认证、如何处理错误以及如何兼容 legacy nodeclub API v1。API reference MUST 由生成的 OAS 驱动渲染，不再手写端点表格。
 
 #### Scenario: 开发者首次阅读 API 文档
+
 - **WHEN** 外部开发者打开 API reference
 - **THEN** 文档 MUST 展示 base URL、版本策略、认证方式、通用响应结构、错误格式、分页语义和限流说明
 - **AND** 文档 MUST 标注哪些接口公开可读、哪些接口需要登录 session 或 access token
 - **AND** 文档 MUST NOT 将 `localhost` 或本地端口作为 API reference 的主要调用地址
 
 #### Scenario: 开发者调用具体接口
+
 - **WHEN** 外部开发者查看某个 API endpoint
 - **THEN** 文档 MUST 使用 HTTP method 和相对 path 作为接口标题或接口标识，例如 `GET /api/v1/topics`
 - **AND** 文档 MUST 对 path params、query、body 和 response fields 优先使用表格
@@ -17,21 +20,25 @@
 - **AND** 示例 MUST 使用可复制的 `curl` 或等价 HTTP 请求代码块
 
 #### Scenario: 文档由 OAS 自动渲染
+
 - **WHEN** 开发者访问 `apps/web` 的 API 文档页（`/api` 路由）
 - **THEN** 页面 MUST 使用 `swagger-ui-react` 从 `apps/web/public/openapi.json` 渲染文档
 - **AND** `apps/web/public/openapi.json` MUST 是 `api/openapi.json` 的副本
 - **AND** 项目 MUST NOT 保留手写硬编码的端点表格（`apps/web/app/routes/api.tsx` 中的 `endpoints` 数组）
 
 #### Scenario: Base URL 与 endpoint path
+
 - **WHEN** API reference 展示接口列表或接口详情
 - **THEN** base URL MUST 只在总览中单独说明
 - **AND** endpoint 标题和接口表格 MUST 使用相对 path
 - **AND** curl 示例 MAY 使用完整生产 URL
 
 ### Requirement: API reference 必须使用统一接口模板
+
 API reference SHALL 对每个核心公开接口使用一致的查阅模板，使读者能快速找到 method、path、认证、参数、请求体、响应字段、错误和示例。
 
 #### Scenario: 接口详情模板
+
 - **WHEN** 文档描述一个核心公开 API endpoint
 - **THEN** 文档 MUST 包含 method、relative path、认证要求和一句话 description
 - **AND** 文档 MUST 按需包含 `Path Params`、`Query`、`Body`、`Response`、`Errors` 和 `Example` 信息
@@ -39,93 +46,113 @@ API reference SHALL 对每个核心公开接口使用一致的查阅模板，使
 - **AND** 普通说明、错误摘要和示例 MUST NOT 被机械地全部表格化
 
 #### Scenario: 参数表格
+
 - **WHEN** endpoint 有 path params、query 或 body 字段
 - **THEN** 文档 MUST 使用 `Name`、`Type`、`Required`、`Default` 或 `Description` 等稳定列说明字段
 - **AND** 空 section MAY 省略以保持文档简洁
 
 #### Scenario: 响应和错误表格
+
 - **WHEN** endpoint 有成功响应或错误响应说明
 - **THEN** 文档 MUST 使用表格列出核心 response fields、类型和含义
 - **AND** 常见错误 MUST 使用 status、message/code 和 description 表格描述
 
 ### Requirement: API 契约必须提供 OAS 机器可读文档
+
 项目 SHALL 提供 OpenAPI Specification (OAS) 文档作为外部 API reference 和未来 smoke/contract 验证的机器可读来源。OAS 文档 MUST 由 `apps/api` 路由内的 zod-openapi 声明自动生成，不得手写维护。
 
 #### Scenario: OAS 文件存在
+
 - **WHEN** 外部开发者或验证脚本查找 API 契约
 - **THEN** 仓库 MUST 提供由 `apps/api` 路由 zod-openapi 声明生成的 `api/openapi.json` 文件
 - **AND** README 或 API reference MUST 链接到该 OAS 文件
 - **AND** 项目 MUST NOT 保留手写的 `api/openapi.yaml` 或任何与路由声明脱节的手写 OAS 文件
 
 #### Scenario: OAS 从路由自动生成
+
 - **WHEN** 开发者修改 `apps/api/src/routes/*.ts` 中某个端点的 path、method、zod schema 或 OpenAPI metadata
 - **THEN** 运行 `pnpm gen:openapi` MUST 重新生成 `api/openapi.json` 反映该变更
 - **AND** `pnpm verify` 流程 MUST 在 `verify:openapi` 之前自动执行 `gen:openapi`
 - **AND** 生成的 `api/openapi.json` MUST 不包含 `x-contract-response-fields` 扩展——响应 schema 由完整 zod 定义描述
 
 #### Scenario: OAS 可被工具读取
+
 - **WHEN** 验证脚本或 OpenAPI 工具读取 OAS 文件
 - **THEN** OAS MUST 定义 `openapi` 版本、`info`、`servers`、`paths`、`components.schemas` 和认证方案
 - **AND** OAS MUST 不包含生产 secret、真实用户 token 或私有环境变量
 
 ### Requirement: OAS 接口必须按对外能力分组
+
 OAS SHALL 使用 tags 按外部能力分组，而不是按代码文件、数据库表或内部模块分组。
 
 #### Scenario: 核心接口分组
+
 - **WHEN** 外部开发者浏览 OAS tags
 - **THEN** tags MUST 至少覆盖帖子、回复、用户、收藏、消息、认证、搜索和系统配置
 - **AND** 帖子与回复能力 MUST 作为最核心分组出现在文档中
 
 #### Scenario: 管理和内部接口分组
+
 - **WHEN** OAS 包含后台管理、巡检或运维接口
 - **THEN** 这些接口 MUST 使用单独 tag 标记为管理或内部能力
 - **AND** 文档 MUST 明确它们不是普通外部客户端的主要集成入口
 
 ### Requirement: OAS 必须优先覆盖帖子和回复能力
+
 OAS SHALL 第一优先级覆盖对外展示和客户端高频使用的帖子、回复、用户、收藏和消息能力。
 
 #### Scenario: 帖子 API 覆盖
+
 - **WHEN** 外部开发者查看帖子能力
 - **THEN** OAS MUST 覆盖帖子列表、帖子详情、发帖、编辑帖子和相关参数
 - **AND** OAS MUST 展示成功响应、错误响应、分页和 `mdrender` 语义
 
 #### Scenario: 回复 API 覆盖
+
 - **WHEN** 外部开发者查看回复能力
 - **THEN** OAS MUST 覆盖回复列表或帖子回复、创建回复、编辑回复、删除回复、点赞和取消点赞
 - **AND** OAS MUST 展示回复作者、内容、时间、点赞状态和 legacy-compatible 字段
 
 #### Scenario: 用户、收藏和消息 API 覆盖
+
 - **WHEN** 外部开发者查看用户、收藏和消息能力
 - **THEN** OAS MUST 覆盖用户资料、用户话题、用户回复、收藏/取消收藏、消息列表和消息已读
 - **AND** OAS MUST 标注每个接口的认证要求
 
 ### Requirement: API 文档必须覆盖 nodeclub 兼容语义
+
 API reference SHALL 明确 `/api/v1/*` 与 legacy `../nodeclub/api_router_v1.js` 和 `../nodeclub/api/v1/` 的兼容关系，但兼容背景 MUST 保持简洁并集中说明。
 
 #### Scenario: 兼容字段说明
+
 - **WHEN** API 响应包含 legacy 字段名、嵌套结构或兼容行为
 - **THEN** 文档 MUST 标明字段含义和兼容原因
 - **AND** 文档 MUST 标明任何显式废弃、redirect 或不再支持的 legacy 行为
 
 #### Scenario: Markdown 内容渲染说明
+
 - **WHEN** API endpoint 返回 topic、reply 或 message content
 - **THEN** 文档 MUST 说明 `mdrender` 参数或默认渲染语义
 - **AND** 文档 MUST 给出原始 Markdown 与 HTML 渲染响应的示例
 
 ### Requirement: API 文档必须与发布验证关联
+
 API 文档 SHALL 作为 release verification 的检查项，避免实现、OpenSpec 和外部文档长期漂移，但普通 API reference MUST NOT 使用内部评级语言作为读者主叙事。
 
 #### Scenario: 发布前检查 API 文档
+
 - **WHEN** release checklist 被执行
 - **THEN** checklist MUST 要求确认新增或变更 API 已更新 API reference
 - **AND** 若 API 行为发生变化但文档未更新，发布 MUST 被视为未满足发布准入
 
 #### Scenario: API smoke 与文档示例一致
+
 - **WHEN** API smoke 或 contract verifier 覆盖某个公开 endpoint
 - **THEN** 文档中的示例响应 shape MUST 与 verifier 期望的核心字段一致
 - **AND** 文档不得展示已废弃或不可调用的示例作为推荐用法
 
 #### Scenario: OAS 被 smoke 或 contract 验证复用
+
 - **WHEN** 未来实现 API smoke 或 contract verifier
 - **THEN** verifier SHOULD 复用 OAS 中的 paths、methods、schemas 或 examples 作为检查来源
 - **AND** 若 verifier 暂未完全复用 OAS，release checklist MUST 明确记录覆盖差距
@@ -133,9 +160,11 @@ API 文档 SHALL 作为 release verification 的检查项，避免实现、OpenS
 ## REMOVED Requirements
 
 ### Requirement: API reference 必须使用 redocly build-docs 产出静态 HTML
+
 **Reason**: API 文档改由 `swagger-ui-react` 在 `apps/web` 的 `/api` 路由直接渲染 OAS，不再需要 `redocly build-docs` 产出 `api/_generated/index.html` 静态文件。
 **Migration**: 删除 `pnpm build:api-docs` 脚本和 `api/_generated/` 目录。外部开发者通过 `apps/web` 的 `/api` 页面或直接读取 `api/openapi.json` 获取文档。
 
 ### Requirement: OAS 必须通过 redocly lint 校验
+
 **Reason**: OAS 改由 `@hono/zod-openapi` 从路由声明自动生成，合规性由生成器保证，不再需要 redocly lint 兜底手写 yaml 的规范错误。
 **Migration**: 删除 `@redocly/cli` 依赖、`redocly.yaml` 配置、`pnpm verify:openapi` 脚本。`pnpm verify` 的 OAS 环节由 `pnpm gen:openapi` 替代——生成成功即证明路由声明可产出合规 OAS。
diff --git a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/web-api-contract-integration/spec.md b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/web-api-contract-integration/spec.md
index f710df6..5e54d52 100644
--- a/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/web-api-contract-integration/spec.md
+++ b/openspec/changes/archive/2026-07-29-unify-api-contract-source/specs/web-api-contract-integration/spec.md
@@ -1,9 +1,11 @@
 ## MODIFIED Requirements
 
 ### Requirement: Web API 调用必须引用 OAS 契约
+
 `apps/web` SHALL 与 API 契约建立持续校验关系，避免前端调用、后端实现和外部 API 文档漂移。web 调用类型 MUST 从 API 路由的 zod-openapi 声明派生（通过 `z.infer`），不再手写 DTO 或维护独立的契约清单。
 
 #### Scenario: Web 使用从 API 派生的类型
+
 - **WHEN** `apps/web` 调用 `/api/v1/*` 或其他公开 API
 - **THEN** 调用方使用的 TypeScript 类型 MUST 通过 `z.infer<typeof schema>` 从 `packages/shared/schemas` re-export 的 zod schema 派生
 - **AND** 该 zod schema MUST 与 `apps/api/src/routes/*.ts` 中 zod-openapi 声明的 schema 为同一份源
@@ -11,33 +13,40 @@
 - **AND** 项目 MUST NOT 保留 `apps/web/api-contract.manifest.json` 手写契约清单
 
 #### Scenario: Web 调用未记录 API
+
 - **WHEN** `apps/web` 新增对某个 API path 的调用
 - **THEN** 对应端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** 该 schema MUST 通过 `packages/shared/schemas` 可被 web import
 - **AND** 若端点未声明，`pnpm gen:openapi` 产出的 OAS MUST 不包含该 path，从而阻断 web 类型派生
 
 ### Requirement: OAS 更新必须能驱动 Web 契约同步
+
 当 `apps/api` 路由中影响 Web 的 API path、method、request 或 response schema 发生变化时，项目 SHALL 提供机制提醒或阻断未同步的 Web 调用。
 
 #### Scenario: 路由删除 Web 依赖接口
+
 - **WHEN** `apps/api/src/routes/*.ts` 删除或重命名 `apps/web` 仍在调用的端点
 - **THEN** re-export 的 zod schema MUST 导致 web 端 typecheck 失败
 - **AND** 开发者 MUST 同步更新 Web 调用或恢复路由声明
 
 #### Scenario: 路由修改核心响应字段
+
 - **WHEN** `apps/api/src/routes/*.ts` 修改 Web loader、action 或组件依赖的核心响应字段
 - **THEN** `z.infer` 派生类型 MUST 反映该变更
 - **AND** Web 不得继续依赖已从 schema 移除的字段作为稳定契约
 
 ### Requirement: Web 契约集成必须优先覆盖核心外部能力
+
 Web 与 API 路由的持续集成 SHALL 优先覆盖帖子、回复、用户、收藏和消息相关 API。
 
 #### Scenario: 帖子和回复调用被覆盖
+
 - **WHEN** Web 加载首页、话题详情、发帖或回帖页面
 - **THEN** 相关端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** Web 调用 MUST 使用从该 schema 派生的类型
 
 #### Scenario: 用户、收藏和消息调用被覆盖
+
 - **WHEN** Web 加载用户页、收藏状态或消息页
 - **THEN** 相关端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** Web schema 派生 MUST 标注登录态或 access token 要求
@@ -45,9 +54,11 @@ Web 与 API 路由的持续集成 SHALL 优先覆盖帖子、回复、用户、
 ## ADDED Requirements
 
 ### Requirement: Web 表单校验 zod schema 必须从 shared 派生
+
 Web 表单运行时校验使用的 zod schema MUST 从 `packages/shared/schemas` import，该 schema 与 `apps/api` 路由的 zod-openapi 声明引用同一份源，不得在 web 端手写副本。
 
 #### Scenario: 表单 schema 来源唯一
+
 - **WHEN** `apps/web` 的 signup/signin/setting 等表单使用 `zodResolver` 进行运行时校验
 - **THEN** 传入 `zodResolver` 的 zod schema MUST 从 `packages/shared/schemas` import
 - **AND** `packages/shared/schemas` MUST 是 schema 的定义源头（不是从 api re-export）
@@ -55,6 +66,7 @@ Web 表单运行时校验使用的 zod schema MUST 从 `packages/shared/schemas`
 - **AND** Web MUST NOT 手写与 API 路由重复的表单 zod schema
 
 #### Scenario: 客户端扩展字段不污染契约源
+
 - **WHEN** Web 表单需要客户端独有字段（如 `confirmPass`）或跨字段校验（如两次密码一致）
 - **THEN** Web MUST 在 import 的 schema 基础上用 `.extend()` 或 `.refine()` 叠加客户端逻辑
 - **AND** 这些扩展 MUST NOT 回写到 `packages/shared/schemas` 的 schema 定义中
diff --git a/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/design.md b/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/design.md
index 3c620bd..bb775cc 100644
--- a/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/design.md
+++ b/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/design.md
@@ -47,12 +47,12 @@ flowchart LR
 
 ### 3. 测试分层命名
 
-| 层级 | 允许内容 | 禁止内容 |
-| --- | --- | --- |
-| Unit | 纯函数、权限判定、schema 解析 | DB 连接 |
-| Route | `app.request`、mock service/db 边界 | 真实 PostgreSQL |
-| Contract | OpenAPI 生成与静态校验 | 手写漂移契约 |
-| DB behavior | 暂不在本 change 建立 | SQLite、真实测试库 |
+| 层级        | 允许内容                            | 禁止内容           |
+| ----------- | ----------------------------------- | ------------------ |
+| Unit        | 纯函数、权限判定、schema 解析       | DB 连接            |
+| Route       | `app.request`、mock service/db 边界 | 真实 PostgreSQL    |
+| Contract    | OpenAPI 生成与静态校验              | 手写漂移契约       |
+| DB behavior | 暂不在本 change 建立                | SQLite、真实测试库 |
 
 ### 4. 不为了测试扩大生产 API 表面
 
diff --git a/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/specs/api-test-infrastructure/spec.md b/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/specs/api-test-infrastructure/spec.md
index 0b9a307..1c0fb8d 100644
--- a/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/specs/api-test-infrastructure/spec.md
+++ b/openspec/changes/archive/2026-07-30-add-api-vitest-test-infra/specs/api-test-infrastructure/spec.md
@@ -5,11 +5,13 @@
 `apps/api` SHALL 使用 Vitest 运行测试，并自动发现测试文件，避免新增测试因脚本手动枚举而漏跑。
 
 #### Scenario: 新测试文件被自动执行
+
 - **WHEN** 开发者在 `apps/api/test/` 新增匹配测试命名约定的测试文件
 - **THEN** `pnpm --filter @cnode/api test` MUST 自动执行该文件
 - **AND** 不需要手动把文件路径加入 `package.json` test 脚本
 
 #### Scenario: 现有测试迁移后继续运行
+
 - **WHEN** 迁移完成后运行 `pnpm --filter @cnode/api test`
 - **THEN** 现有 API 单元测试 MUST 在 Vitest 下通过
 - **AND** `pnpm test` 和 `pnpm verify` MUST 继续包含 API 测试
@@ -19,11 +21,13 @@
 `apps/api` 测试 SHALL 不连接真实 PostgreSQL，包括本地测试库、Docker 测试库或远程测试库。测试也 MUST NOT 引入 SQLite、PGlite、内存 SQL 数据库或 Drizzle 方言 fallback。
 
 #### Scenario: 测试运行不要求数据库环境变量
+
 - **WHEN** 开发者未配置 `DB_HOST`、`DB_USER`、`DB_PASSWORD` 或 `DB_NAME` 时运行 API 测试
 - **THEN** 测试 MUST 能运行不依赖数据库的用例
 - **AND** 测试基础设施 MUST NOT 为通过测试而提供 SQLite 或其他数据库 fallback
 
 #### Scenario: Route 测试使用 fake 边界
+
 - **WHEN** API route 测试需要覆盖依赖数据库的分支
 - **THEN** 测试 MUST 使用可注入依赖、mock service 或 fake query layer
 - **AND** 测试 MUST 明确只验证 route 行为和服务编排，不声称验证 PostgreSQL 查询语义
@@ -33,11 +37,13 @@
 测试基础设施变更 SHALL 更新长期维护文档，使开发者知道如何新增 API 测试以及数据库边界。
 
 #### Scenario: 文档说明测试运行器
+
 - **WHEN** Vitest 测试基础设施实现完成
 - **THEN** `docs/conventions.md` MUST 说明 `apps/api` 使用 Vitest 和自动测试发现
 - **AND** 文档 MUST 删除或替换手动枚举 API 测试文件的旧约定
 
 #### Scenario: 文档说明无真实数据库约束
+
 - **WHEN** 文档描述 API 测试分层
 - **THEN** 文档 MUST 明确 API 测试不连接真实 PostgreSQL 测试库
 - **AND** 文档 MUST 明确不得使用 SQLite 或方言 fallback 作为 release path
diff --git a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/design.md b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/design.md
index df0e8e1..d677891 100644
--- a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/design.md
+++ b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/design.md
@@ -56,13 +56,13 @@ flowchart TD
 
 权限边界：
 
-| 操作 | 作者 | moderator | admin | 说明 |
-| --- | --- | --- | --- | --- |
-| 前台删除自己的话题 | 允许 | 不适用 | 允许 | 现有软删除语义 |
-| 后台批量软删除话题 | 不允许 | 受限 | 允许 | 按既有后台权限校验 |
-| 巡检命中确认删除 | 不允许 | 不允许 | 允许 | 删除原始话题/回复，但仍为软删除 |
-| 巡检任务级批量确认删除 | 不允许 | 不允许 | 允许 | 高风险批量软删除 |
-| 后台话题真实删除 | 不允许 | 不允许 | 允许 | 独立入口，物理删除 |
+| 操作                   | 作者   | moderator | admin | 说明                            |
+| ---------------------- | ------ | --------- | ----- | ------------------------------- |
+| 前台删除自己的话题     | 允许   | 不适用    | 允许  | 现有软删除语义                  |
+| 后台批量软删除话题     | 不允许 | 受限      | 允许  | 按既有后台权限校验              |
+| 巡检命中确认删除       | 不允许 | 不允许    | 允许  | 删除原始话题/回复，但仍为软删除 |
+| 巡检任务级批量确认删除 | 不允许 | 不允许    | 允许  | 高风险批量软删除                |
+| 后台话题真实删除       | 不允许 | 不允许    | 允许  | 独立入口，物理删除              |
 
 ### 4. 真实删除由应用层按顺序清理依赖
 
diff --git a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/admin-dashboard/spec.md
index a9bdaf8..3ad61f4 100644
--- a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/admin-dashboard/spec.md
@@ -5,27 +5,32 @@
 后台话题管理 SHALL 允许管理员和版主按话题属性、状态、时间维度和排序方式查询话题，并且筛选结果 MUST 使用后端分页查询生成。
 
 #### Scenario: 按 tab 筛选话题
+
 - **WHEN** 管理员或版主在 `/admin/topics` 选择某个 tab
 - **THEN** 页面 MUST 只展示该 tab 下的话题
 - **AND** 分页 MUST 保留当前 tab 筛选条件
 
 #### Scenario: 按内容状态和运营标记筛选话题
+
 - **WHEN** 管理员或版主选择可见状态或运营标记筛选条件
 - **THEN** 系统 MUST 按正常、已隐藏、已删除、置顶、精华、锁定或归档等条件返回匹配话题
 - **AND** 后端 MUST 忽略非法枚举值或返回明确错误，不得拼接未校验的 SQL 片段
 
 #### Scenario: 按时间维度筛选话题
+
 - **WHEN** 管理员或版主选择创建时间、更新时间或最后回复时间并提交时间范围
 - **THEN** 系统 MUST 按所选时间字段过滤话题
 - **AND** 起止时间同时存在时 MUST 返回落在闭区间内的话题
 - **AND** 只提供起始或结束时间时 MUST 支持单边范围过滤
 
 #### Scenario: 按运营指标排序话题
+
 - **WHEN** 管理员或版主选择回复数、浏览数、收藏数、创建时间、更新时间或最后回复时间排序
 - **THEN** 系统 MUST 按所选排序返回分页结果
 - **AND** 未选择排序时 MUST 保持后台话题列表的默认稳定排序
 
 #### Scenario: 批量操作后保留筛选上下文
+
 - **WHEN** 管理员或版主在筛选后的话题列表执行批量置顶、加精、隐藏、软删除或真实删除后
 - **THEN** 页面 MUST 刷新当前筛选结果
 - **AND** URL 中的筛选、排序和分页参数 MUST 不丢失
@@ -35,16 +40,19 @@
 后台巡检结果页 SHALL 以巡检任务作为命中记录的组织入口，允许管理员查看指定任务产生的待处理命中并执行任务级批量处理。
 
 #### Scenario: 从任务查看巡检命中
+
 - **WHEN** 管理员在巡检任务列表点击查看某个任务的命中
 - **THEN** 系统 MUST 展示 `scan_job_id` 等于该任务 ID 的巡检命中列表
 - **AND** 列表 MUST 保留现有命中对象、命中词、预览、作者和扫描时间信息
 
 #### Scenario: 任务级批量确认删除入口
+
 - **WHEN** 管理员查看含有待处理命中的巡检任务
 - **THEN** 页面 MUST 提供批量确认删除该任务待处理命中的入口
 - **AND** 入口文案 MUST 明确说明将删除原始话题或回复，而不是仅清除巡检记录
 
 #### Scenario: 任务级批量确认删除需要二次确认
+
 - **WHEN** 管理员触发任务级批量确认删除
 - **THEN** 页面 MUST 展示二次确认对话框
 - **AND** 对话框 MUST 显示任务 ID 和预计处理的待处理命中数量
@@ -55,11 +63,13 @@
 后台内容治理行为变更 SHALL 同步到对应 `docs/` 和 `wiki/` 文档，避免管理员误解软删除、巡检确认删除和真实删除的差异。
 
 #### Scenario: 巡检治理文档同步
+
 - **WHEN** 巡检结果按任务查看和任务级批量确认删除实现完成
 - **THEN** `docs/content-moderation.md` MUST 说明按任务查看巡检命中和任务级批量确认删除流程
 - **AND** 文档 MUST 明确任务级批量确认删除会删除原始话题或回复，但仍沿用软删除生命周期
 
 #### Scenario: 真实删除业务规则同步
+
 - **WHEN** 后台话题真实删除实现完成
 - **THEN** `wiki/business-rules.md` MUST 记录真实删除是 admin-only 独立危险操作
 - **AND** wiki MUST 区分现有软删除、巡检确认删除和数据库物理删除
diff --git a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-lifecycle/spec.md b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-lifecycle/spec.md
index d5988c1..278b254 100644
--- a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-lifecycle/spec.md
+++ b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-lifecycle/spec.md
@@ -5,28 +5,33 @@
 系统 SHALL 在后台话题管理中提供 admin-only 的真实删除能力，用于从数据库中物理删除指定话题及其直接依赖数据。真实删除 MUST 与现有软删除操作分离，且不得改变普通删除按钮的软删除语义。
 
 #### Scenario: 管理员真实删除话题
+
 - **WHEN** admin 在后台话题管理中确认真实删除某个话题
 - **THEN** 系统 MUST 从数据库删除该话题记录
 - **AND** 系统 MUST 清理该话题的回复、收藏、招聘扩展、巡检命中和消息引用等直接依赖数据
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 真实删除需要明确确认
+
 - **WHEN** admin 触发真实删除入口
 - **THEN** 页面 MUST 展示二次确认
 - **AND** 文案 MUST 明确说明该操作会从数据库永久删除且不可通过系统自动恢复
 - **AND** admin 取消确认时 MUST 不删除任何数据
 
 #### Scenario: 非管理员不可真实删除话题
+
 - **WHEN** 非 admin 用户调用真实删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标话题及其依赖数据 MUST 保持不变
 
 #### Scenario: 软删除语义保持不变
+
 - **WHEN** 管理员或版主执行现有话题删除操作
 - **THEN** 系统 MUST 继续将话题标记为已删除
 - **AND** 系统 MUST NOT 因本变更把现有删除操作改为物理删除
 
 #### Scenario: 巡检确认删除不执行真实删除
+
 - **WHEN** 管理员对巡检命中执行确认删除或任务级批量确认删除
 - **THEN** 系统 MUST 沿用现有话题或回复删除生命周期
 - **AND** 系统 MUST NOT 从数据库物理删除命中的话题或回复
diff --git a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-moderation/spec.md b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-moderation/spec.md
index 433c315..7d60f96 100644
--- a/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-moderation/spec.md
+++ b/openspec/changes/archive/2026-07-30-enhance-admin-content-governance/specs/content-moderation/spec.md
@@ -5,11 +5,13 @@
 系统 SHALL 使用巡检命中记录上的任务关联，将后台巡检结果按巡检任务过滤和展示。
 
 #### Scenario: 查询指定任务的巡检命中
+
 - **WHEN** 管理员请求查看任务 `#11` 的巡检命中
 - **THEN** 系统 MUST 返回 `scan_job_id=11` 的命中记录
 - **AND** 系统 MUST 支持继续按待处理、已确认、误报或忽略状态筛选该任务下的命中
 
 #### Scenario: 重复命中不重复入队
+
 - **WHEN** 后续巡检任务再次扫描到同一对象、同一字段和同一组敏感词
 - **THEN** 系统 MUST 继续避免创建重复待处理命中记录
 - **AND** 该限制 MUST 不阻止管理员处理首次创建的待处理命中
@@ -19,22 +21,26 @@
 系统 SHALL 允许管理员对某个巡检任务下的待处理命中执行批量确认删除，确认删除的目标是命中的原始话题或回复。
 
 #### Scenario: 批量确认删除话题和回复命中
+
 - **WHEN** 管理员确认删除某巡检任务下的待处理命中
 - **THEN** 系统 MUST 对话题命中执行现有话题删除动作
 - **AND** 系统 MUST 对回复命中执行现有回复删除动作
 - **AND** 系统 MUST 将对应巡检命中标记为已确认处理
 
 #### Scenario: 批量确认删除只处理待处理命中
+
 - **WHEN** 巡检任务下同时存在 pending、confirmed、false_positive 或 ignored 命中
 - **THEN** 任务级批量确认删除 MUST 只处理 pending 命中
 - **AND** 已处理命中 MUST 不重复删除内容或重复处罚作者
 
 #### Scenario: 批量确认删除写入审计日志
+
 - **WHEN** 管理员完成任务级批量确认删除
 - **THEN** 系统 MUST 写入审计日志
 - **AND** 审计详情 MUST 包含任务 ID、操作类型和实际处理数量
 
 #### Scenario: 非管理员不可执行任务级批量确认删除
+
 - **WHEN** 非 admin 用户调用任务级批量确认删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 话题、回复和巡检命中状态 MUST 保持不变
diff --git a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/design.md b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/design.md
index 86a9754..5f8d3b4 100644
--- a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/design.md
+++ b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/design.md
@@ -86,11 +86,11 @@ RSS feed 语义为“全站公开内容订阅”，不是首页版面列表。
 
 `block` 的 UI 文案统一为“屏蔽用户内容 / 恢复用户内容”，状态 badge 使用“内容已屏蔽”。`mute` 继续表达为“禁言 / 解除禁言”。这让管理员能区分：
 
-| 操作 | 影响历史内容 | 影响未来发言 |
-| --- | --- | --- |
-| 屏蔽用户内容 | 是 | 不作为主要语义 |
-| 禁言 | 否 | 是 |
-| 删除所有发言 | 是，破坏性 | 否 |
+| 操作         | 影响历史内容 | 影响未来发言   |
+| ------------ | ------------ | -------------- |
+| 屏蔽用户内容 | 是           | 不作为主要语义 |
+| 禁言         | 否           | 是             |
+| 删除所有发言 | 是，破坏性   | 否             |
 
 替代方案：保留“隐藏/禁言”两个常用按钮，其他进更多。用户倾向安全审计优先，因此不采用。
 
@@ -110,23 +110,23 @@ RSS feed 语义为“全站公开内容订阅”，不是首页版面列表。
 
 示例分类：
 
-| Category | Actions |
-| --- | --- |
+| Category | Actions                                                                                                                 |
+| -------- | ----------------------------------------------------------------------------------------------------------------------- |
 | 内容治理 | `top`, `untop`, `good`, `ungood`, `lock`, `unlock`, `delete_topic`, `delete_reply`, `permanent_delete_topic`, `batch_*` |
-| 用户治理 | `block_user`, `unblock_user`, `mute_user`, `unmute_user`, `delete_all_user_content` |
-| 角色权限 | `grant_role`, `revoke_role` |
-| 账号安全 | `reset_password`, `github_bind`, `github_unbind` |
-| 安全策略 | `ban_ip`, `unban_ip` |
-| 举报巡检 | `report_*`, `moderation_*`, `moderation_scan_*` |
-| 系统设置 | `update_settings`, `update_zone`, `update_tab` |
+| 用户治理 | `block_user`, `unblock_user`, `mute_user`, `unmute_user`, `delete_all_user_content`                                     |
+| 角色权限 | `grant_role`, `revoke_role`                                                                                             |
+| 账号安全 | `reset_password`, `github_bind`, `github_unbind`                                                                        |
+| 安全策略 | `ban_ip`, `unban_ip`                                                                                                    |
+| 举报巡检 | `report_*`, `moderation_*`, `moderation_scan_*`                                                                         |
+| 系统设置 | `update_settings`, `update_zone`, `update_tab`                                                                          |
 
 风险等级建议：
 
-| Risk | Examples |
-| --- | --- |
-| low | `top`, `untop`, `good`, `ungood`, `update_zone`, `update_tab` |
-| medium | `lock`, `unlock`, `block_user`, `unblock_user`, `mute_user`, `unmute_user` |
-| high | `grant_role`, `revoke_role`, `reset_password`, `ban_ip`, `unban_ip` |
+| Risk     | Examples                                                                            |
+| -------- | ----------------------------------------------------------------------------------- |
+| low      | `top`, `untop`, `good`, `ungood`, `update_zone`, `update_tab`                       |
+| medium   | `lock`, `unlock`, `block_user`, `unblock_user`, `mute_user`, `unmute_user`          |
+| high     | `grant_role`, `revoke_role`, `reset_password`, `ban_ip`, `unban_ip`                 |
 | critical | `delete_topic`, `delete_reply`, `delete_all_user_content`, `permanent_delete_topic` |
 
 API 应返回当前筛选全集的 summary，而不是只让 Web 根据当前页计算，否则指标卡会误导。
diff --git a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/admin-dashboard/spec.md
index 062dccf..da5df74 100644
--- a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/admin-dashboard/spec.md
@@ -5,22 +5,26 @@
 管理后台导航 SHALL 按管理员运营任务组织，而不是按实现页面随意堆叠。系统设置入口 MUST 位于后台导航最后。
 
 #### Scenario: 后台导航分组顺序
+
 - **WHEN** admin 或 moderator 访问管理后台
 - **THEN** 导航分组 MUST 按总览、内容、用户、审计、系统的顺序展示可访问分组
 - **AND** 系统设置 MUST 位于系统分组内
 - **AND** 系统分组 MUST 是最后一个分组
 
 #### Scenario: 内容结构管理归入内容分组
+
 - **WHEN** admin 查看后台导航
 - **THEN** 专区管理和 Tab 管理 MUST 归入内容相关分组
 - **AND** 话题管理、巡检结果、举报队列、敏感词、专区管理和 Tab 管理 SHOULD 在同一内容运营分组中展示
 
 #### Scenario: 审计拥有独立导航入口
+
 - **WHEN** admin 查看后台导航
 - **THEN** 审计日志 MUST 位于独立审计分组或顶部审计入口下
 - **AND** 审计入口 MUST 不混在系统设置之前的无序系统杂项中
 
 #### Scenario: 顶部和移动端导航顺序一致
+
 - **WHEN** admin 在桌面或移动端访问后台
 - **THEN** 顶部导航、侧栏导航和移动端导航 SHOULD 使用一致的任务顺序
 - **AND** `/admin/zones`、`/admin/tabs`、`/admin/audit` 和 `/admin/settings` 的 active state MUST 匹配所属导航入口
@@ -30,30 +34,35 @@
 后台审计页面 SHALL 支持运营复盘、风险追踪和问责，而不是仅按时间罗列原始日志。
 
 #### Scenario: 审计中心摘要
+
 - **WHEN** admin 访问 `/admin/audit`
 - **THEN** 页面 MUST 展示当前筛选范围内的摘要指标
 - **AND** 摘要 SHOULD 至少包含高风险操作、内容删除、权限变更、账号安全和失败/异常数量
 - **AND** 摘要 MUST 基于当前筛选全集计算，不得只统计当前页数据
 
 #### Scenario: 审计事件分类和风险等级
+
 - **WHEN** 系统返回审计日志
 - **THEN** 每条日志 MUST 包含或可派生事件分类、风险等级和人类可读动作标签
 - **AND** 内容治理、用户治理、角色权限、账号安全、安全策略、举报巡检和系统设置 SHOULD 作为第一阶段分类
 - **AND** delete、reset password、role、ban 等敏感操作 MUST 具备高风险或极高风险视觉提示
 
 #### Scenario: 审计筛选
+
 - **WHEN** admin 在 `/admin/audit` 筛选审计事件
 - **THEN** 系统 MUST 支持按时间范围、事件分类、风险等级、操作人、目标类型、结果和关键词筛选
 - **AND** 筛选状态 MUST 体现在 URL 参数中
 - **AND** 分页、刷新和返回页面时 MUST 保留筛选上下文
 
 #### Scenario: 审计事件流展示
+
 - **WHEN** admin 查看审计事件列表
 - **THEN** 页面 MUST 使用事件流或等价卡片化列表展示审计记录
 - **AND** 每条事件 MUST 展示风险 badge、人类可读动作标题、操作人、时间、分类、目标和结果
 - **AND** 页面 MUST 不要求管理员直接理解原始 action 字符串才能判断事件含义
 
 #### Scenario: 审计详情展开
+
 - **WHEN** admin 展开某条审计事件
 - **THEN** 页面 MUST 展示原始 action、operator_id、operator_name、target_type、target_id、target_name、result、create_at 和 detail
 - **AND** detail 为 JSON 时 SHOULD 格式化展示
@@ -61,6 +70,7 @@
 - **AND** 系统 MUST 避免展示 secrets、token、明文密码或生产环境变量
 
 #### Scenario: 审计目标跳转
+
 - **WHEN** 审计事件目标可映射到现有后台或前台资源
 - **THEN** 页面 SHOULD 提供目标跳转入口
 - **AND** user 目标 SHOULD 可跳转到用户主页或后台用户搜索
@@ -68,6 +78,7 @@
 - **AND** report 或 scan_job 目标 SHOULD 可跳转到对应后台队列或巡检页面
 
 #### Scenario: 移动端审计展示
+
 - **WHEN** admin 在移动端访问 `/admin/audit`
 - **THEN** 页面 MUST 使用适合窄屏的卡片或事件流布局
 - **AND** 页面 MUST NOT 依赖横向滚动表格作为主要审计体验
diff --git a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/user-management/spec.md b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/user-management/spec.md
index 14e1863..33da600 100644
--- a/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/user-management/spec.md
+++ b/openspec/changes/archive/2026-07-30-improve-admin-operational-governance/specs/user-management/spec.md
@@ -55,24 +55,28 @@
 系统 SHALL 阻止管理员对当前登录账号执行会限制自身能力或破坏自身内容的高风险用户管理动作。
 
 #### Scenario: 管理员不能 block 自己
+
 - **WHEN** admin 调用用户 block 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_block` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能 mute 自己
+
 - **WHEN** admin 调用用户 mute 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_muted` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能删除自己所有发言
+
 - **WHEN** admin 调用删除用户所有发言接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的话题和回复删除状态 MUST 保持不变
 - **AND** 系统 MUST NOT 扣减当前 admin 的内容计数
 
 #### Scenario: 前端隐藏自操作入口
+
 - **WHEN** admin 在后台用户管理页或用户主页查看自己的账号
 - **THEN** 页面 MUST NOT 提供 block、mute 或删除所有发言的可执行入口
 - **AND** 后台用户管理菜单 MUST NOT 提供影响当前 admin 自身角色或自身能力的可执行入口
diff --git a/openspec/changes/archive/2026-07-30-strengthen-openspec-change-governance/specs/openspec-change-governance/spec.md b/openspec/changes/archive/2026-07-30-strengthen-openspec-change-governance/specs/openspec-change-governance/spec.md
index bbae4d1..39e0b4e 100644
--- a/openspec/changes/archive/2026-07-30-strengthen-openspec-change-governance/specs/openspec-change-governance/spec.md
+++ b/openspec/changes/archive/2026-07-30-strengthen-openspec-change-governance/specs/openspec-change-governance/spec.md
@@ -1,72 +1,91 @@
 ## ADDED Requirements
 
 ### Requirement: Change Scope Contract
+
 OpenSpec change proposals for behavior, product, API, migration, release, architecture, database, security, or data repair work SHALL define a change scope contract that states in-scope areas, out-of-scope areas, affected systems, unaffected systems when relevant, legacy reference boundaries, and high-risk categories.
 
 #### Scenario: Change proposal declares scope
+
 - **WHEN** a contributor creates an OpenSpec change for scoped project work
 - **THEN** the proposal SHALL state the intended改造范围 and明确不改造范围 before implementation tasks are started
 
 #### Scenario: High-risk categories are visible
+
 - **WHEN** a change affects database, security, permissions, public API contracts, data migration, deployment, or data repair
 - **THEN** the proposal SHALL mark those categories in its impact assessment
 
 ### Requirement: Documentation Impact Assessment
+
 Every OpenSpec change proposal SHALL include a documentation impact assessment covering both `docs/` and `wiki/`. The assessment MUST list target files when updates are required, explain why updates are not required, or identify the follow-up task/change when updates are deferred.
 
 #### Scenario: Stable documentation must change
+
 - **WHEN** a change modifies current development workflow, architecture, database behavior, API usage, security rules, deployment steps, or content moderation operation
 - **THEN** the proposal SHALL identify the affected `docs/` files to update
 
 #### Scenario: Knowledge base must change
+
 - **WHEN** a change modifies business rules, legacy compatibility understanding, migration background, community rules, or sourced historical context
 - **THEN** the proposal SHALL identify the affected `wiki/` files to update and preserve uncertainty using the wiki writing guidelines
 
 #### Scenario: Documentation not required
+
 - **WHEN** a change does not require updates to `docs/` or `wiki/`
 - **THEN** the proposal SHALL explicitly state why long-lived documentation is not affected
 
 ### Requirement: Diagram And Explanation Requirements
+
 OpenSpec design documents SHALL include Mermaid diagrams or concise matrices when a change affects architecture boundaries, request flows, data models, state transitions, permissions, or migration/release ordering. Designs MAY omit diagrams only when the change is small enough that relationships remain clear in prose, and the omission is explained.
 
 #### Scenario: Data model change needs visual explanation
+
 - **WHEN** a change adds or modifies tables, relationships, indexes, constraints, or durable data semantics
 - **THEN** the design SHALL include an ER diagram, data-flow diagram, or equivalent field/relationship table
 
 #### Scenario: Permission change needs boundary explanation
+
 - **WHEN** a change modifies admin, moderator, user, role, token, or capability boundaries
 - **THEN** the design SHALL include a permission matrix or flow diagram showing allowed and denied operations
 
 #### Scenario: Migration sequence needs ordering explanation
+
 - **WHEN** a change requires ordered rollout, data migration, backfill, compatibility window, or rollback planning
 - **THEN** the design SHALL include a flowchart or sequence description showing the required order
 
 ### Requirement: Database Change Audit
+
 OpenSpec design documents for database-related changes MUST include a `Database Change Audit`. Database-related changes include PostgreSQL schema changes, Drizzle migrations, seed/bootstrap changes, indexes, constraints, data backfills, data cleanup, data repair scripts, data retention rules, and field semantic changes.
 
 #### Scenario: Database change audit covers impact
+
 - **WHEN** a change affects PostgreSQL schema, data, migrations, or field semantics
 - **THEN** the design MUST identify affected tables, affected columns, expected existing-row impact, user-visible behavior impact, and related `docs/` or `wiki/` updates
 
 #### Scenario: Database change audit covers compatibility
+
 - **WHEN** a change affects database shape or durable data semantics
 - **THEN** the design MUST evaluate old code with new schema, new code with old data, shared/API schema compatibility, and required deploy ordering
 
 #### Scenario: Database change audit covers operational risk
+
 - **WHEN** a change includes migration, index, constraint, backfill, cleanup, or data repair work
 - **THEN** the design MUST evaluate online-safety, lock or full-scan risk, rollback reversibility, data-loss risk, integrity checks, and verification evidence
 
 ### Requirement: Tasks Include Knowledge And Audit Verification
+
 OpenSpec task lists SHALL include explicit tasks for documentation synchronization, diagram consistency, database audit verification when applicable, and final OpenSpec validation before archive.
 
 #### Scenario: Documentation tasks follow impact assessment
+
 - **WHEN** the proposal declares required `docs/` or `wiki/` updates
 - **THEN** `tasks.md` SHALL include checklist items to update those files and verify they describe current behavior rather than one-time implementation notes
 
 #### Scenario: Database tasks follow audit
+
 - **WHEN** the design contains a `Database Change Audit`
 - **THEN** `tasks.md` SHALL include verification tasks for migration execution, rollback or rollback rationale, data integrity checks, and relevant documentation updates
 
 #### Scenario: Archive readiness includes knowledge checks
+
 - **WHEN** a change is prepared for archive
 - **THEN** maintainers SHALL confirm implementation tasks, OpenSpec validation, documentation impact handling, diagram consistency, and database audit evidence where applicable
diff --git a/openspec/changes/archive/2026-07-30-web-loading-and-state/design.md b/openspec/changes/archive/2026-07-30-web-loading-and-state/design.md
index e1253c6..a7aa557 100644
--- a/openspec/changes/archive/2026-07-30-web-loading-and-state/design.md
+++ b/openspec/changes/archive/2026-07-30-web-loading-and-state/design.md
@@ -60,11 +60,11 @@ function useAsyncAction<TArgs extends unknown[], TResult>(
     errorMessage?: string | ((error: unknown) => string);
     onSuccess?: (result: TResult) => void;
     onError?: (error: unknown) => void;
-  }
+  },
 ): {
   run: (...args: TArgs) => void;
   pending: boolean;
-}
+};
 ```
 
 **设计要点**：
@@ -81,25 +81,25 @@ function useAsyncAction<TArgs extends unknown[], TResult>(
 
 **替换范围**（全量）：
 
-| 文件 | 当前模式 | 替换为 |
-|------|---------|--------|
-| `topic.create.tsx` | `saving` useState | `useAsyncAction` |
-| `topic.$tid.tsx` | `collecting`、`adminAction` useState | `useAsyncAction`（多个实例） |
-| `topic.$tid.edit.tsx` | `saving` useState | `useAsyncAction` |
-| `my.messages.tsx` | 无 pending 状态 | `useAsyncAction` |
-| `setting.tsx` | 多处手写 | `useAsyncAction` |
-| `reply.$id.edit.tsx` | `saving` useState | `useAsyncAction` |
-| `user.$name.tsx` | 手写 follow/unfollow | `useAsyncAction` |
-| `signin.tsx` / `signup.tsx` | 手写 | `useAsyncAction` |
-| `reset_pass.tsx` / `search_pass.tsx` | 手写 | `useAsyncAction` |
-| `auth.github.new.tsx` | 手写 | `useAsyncAction` |
-| `admin/mod.tsx` | 多处手写 | `useAsyncAction` |
-| `admin/bans.tsx` | 多处手写 | `useAsyncAction` |
-| `admin/keywords.tsx` | 多处手写 | `useAsyncAction` |
-| `admin/reports.tsx` | 手写 | `useAsyncAction` |
-| `admin/settings.tsx` | 手写 | `useAsyncAction` |
-| `admin/topics.tsx` | 手写 | `useAsyncAction` |
-| `admin/users.tsx` | 手写 | `useAsyncAction` |
+| 文件                                 | 当前模式                             | 替换为                       |
+| ------------------------------------ | ------------------------------------ | ---------------------------- |
+| `topic.create.tsx`                   | `saving` useState                    | `useAsyncAction`             |
+| `topic.$tid.tsx`                     | `collecting`、`adminAction` useState | `useAsyncAction`（多个实例） |
+| `topic.$tid.edit.tsx`                | `saving` useState                    | `useAsyncAction`             |
+| `my.messages.tsx`                    | 无 pending 状态                      | `useAsyncAction`             |
+| `setting.tsx`                        | 多处手写                             | `useAsyncAction`             |
+| `reply.$id.edit.tsx`                 | `saving` useState                    | `useAsyncAction`             |
+| `user.$name.tsx`                     | 手写 follow/unfollow                 | `useAsyncAction`             |
+| `signin.tsx` / `signup.tsx`          | 手写                                 | `useAsyncAction`             |
+| `reset_pass.tsx` / `search_pass.tsx` | 手写                                 | `useAsyncAction`             |
+| `auth.github.new.tsx`                | 手写                                 | `useAsyncAction`             |
+| `admin/mod.tsx`                      | 多处手写                             | `useAsyncAction`             |
+| `admin/bans.tsx`                     | 多处手写                             | `useAsyncAction`             |
+| `admin/keywords.tsx`                 | 多处手写                             | `useAsyncAction`             |
+| `admin/reports.tsx`                  | 手写                                 | `useAsyncAction`             |
+| `admin/settings.tsx`                 | 手写                                 | `useAsyncAction`             |
+| `admin/topics.tsx`                   | 手写                                 | `useAsyncAction`             |
+| `admin/users.tsx`                    | 手写                                 | `useAsyncAction`             |
 
 ### D3: apiFetch 错误处理修复
 
diff --git a/openspec/changes/archive/2026-07-30-web-loading-and-state/specs/web-async-action/spec.md b/openspec/changes/archive/2026-07-30-web-loading-and-state/specs/web-async-action/spec.md
index 11605e7..bbd1561 100644
--- a/openspec/changes/archive/2026-07-30-web-loading-and-state/specs/web-async-action/spec.md
+++ b/openspec/changes/archive/2026-07-30-web-loading-and-state/specs/web-async-action/spec.md
@@ -12,8 +12,8 @@ function useAsyncAction<TArgs extends unknown[], TResult>(
     errorMessage?: string | ((error: unknown) => string);
     onSuccess?: (result: TResult) => void;
     onError?: (error: unknown) => void;
-  }
-): { run: (...args: TArgs) => void; pending: boolean }
+  },
+): { run: (...args: TArgs) => void; pending: boolean };
 ```
 
 #### Scenario: 基本 pending 状态
diff --git a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/design.md b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/design.md
index 2be1fc6..3949843 100644
--- a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/design.md
+++ b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/design.md
@@ -41,9 +41,9 @@ flowchart LR
 
 替代方案：复用现有 `/user/:name/unmute` 和 `/user/:name/unblock` 在前端循环调用。拒绝原因是多个请求难以形成统一审计、部分失败反馈和 pending 状态，也会放大网络失败面。
 
-| Action | 更新字段 | 不改变字段 | 审计动作 |
-| ------ | -------- | ---------- | -------- |
-| `unmute` | `is_muted=false` | `is_block`、内容删除状态 | `bulk_unmute_user` |
+| Action    | 更新字段         | 不改变字段               | 审计动作            |
+| --------- | ---------------- | ------------------------ | ------------------- |
+| `unmute`  | `is_muted=false` | `is_block`、内容删除状态 | `bulk_unmute_user`  |
 | `unblock` | `is_block=false` | `is_muted`、内容删除状态 | `bulk_unblock_user` |
 
 ### 3. 批量操作跳过当前登录用户并返回 skipped
diff --git a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/admin-dashboard/spec.md b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/admin-dashboard/spec.md
index ec7f2c1..e75cad7 100644
--- a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/admin-dashboard/spec.md
+++ b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/admin-dashboard/spec.md
@@ -5,18 +5,21 @@
 后台封禁管理页 SHALL 按 `mute` 和 `block` 的业务语义展示用户治理状态。`mute` MUST 表达为禁言或解除禁言，`block` MUST 表达为屏蔽用户内容或恢复内容可见，页面 MUST NOT 将 `is_block` 用户单独展示为禁言用户。
 
 #### Scenario: 查看封禁管理用户治理状态
+
 - **WHEN** admin 访问 `/admin/bans` 的用户治理区域
 - **THEN** 页面 MUST 能识别处于 mute 状态的用户
 - **AND** 页面 MUST 能识别处于 block 状态的用户
 - **AND** 页面 MUST 使用不同文案展示禁言和内容屏蔽状态
 
 #### Scenario: 单个恢复内容可见
+
 - **WHEN** admin 在 `/admin/bans` 对 block 用户执行恢复内容可见
 - **THEN** 系统 MUST 取消目标用户的 block 状态
 - **AND** 页面 MUST 使用“恢复内容可见”或等价文案
 - **AND** 页面 MUST NOT 将该操作表达为解除禁言
 
 #### Scenario: 单个解除禁言
+
 - **WHEN** admin 在 `/admin/bans` 对 mute 用户执行解除禁言
 - **THEN** 系统 MUST 取消目标用户的 mute 状态
 - **AND** 页面 MUST 使用“解除禁言”或等价文案
@@ -27,11 +30,13 @@
 后台封禁管理页 SHALL 在用户治理批量操作后保留当前 tab、分页和筛选上下文，并通过局部重新加载展示操作后的状态。
 
 #### Scenario: 批量解除禁言后刷新当前上下文
+
 - **WHEN** admin 在封禁管理页批量解除禁言并成功
 - **THEN** 页面 MUST 重新加载当前 tab、分页和筛选上下文
 - **AND** 已解除禁言的用户 MUST 不再显示为禁言状态
 
 #### Scenario: 批量恢复内容可见后刷新当前上下文
+
 - **WHEN** admin 在封禁管理页批量恢复内容可见并成功
 - **THEN** 页面 MUST 重新加载当前 tab、分页和筛选上下文
 - **AND** 已恢复内容可见的用户 MUST 不再显示为内容已屏蔽状态
diff --git a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/user-management/spec.md b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/user-management/spec.md
index 6d76b29..fbd18b8 100644
--- a/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/user-management/spec.md
+++ b/openspec/changes/archive/2026-07-31-fix-admin-user-governance/specs/user-management/spec.md
@@ -5,17 +5,20 @@
 系统 SHALL 允许管理员在后台用户管理页按 loginname 或 email 搜索用户，搜索提交、翻页和管理操作后的重新校验结果 MUST 与当前 URL 查询参数一致。
 
 #### Scenario: 管理员搜索用户
+
 - **WHEN** 管理员在 `/admin/users` 输入搜索词并提交
 - **THEN** 页面 MUST 展示匹配当前搜索词的用户列表
 - **AND** 列表总数 MUST 反映匹配后的 total
 - **AND** 搜索框 MUST 保留当前搜索词
 
 #### Scenario: 搜索结果翻页
+
 - **WHEN** 管理员在带有搜索词的用户列表中翻页
 - **THEN** 页面 MUST 保留当前搜索词
 - **AND** 下一页数据 MUST 仍按当前搜索词过滤
 
 #### Scenario: 用户管理操作后保留搜索上下文
+
 - **WHEN** 管理员在搜索结果中执行 block、unblock、mute、unmute、角色变更、重置密码或删除所有发言并成功
 - **THEN** 页面 MUST 重新加载当前查询上下文的数据
 - **AND** MUST NOT 回退到未搜索的用户列表
@@ -25,18 +28,21 @@
 系统 SHALL 允许 admin 在后台用户治理入口中对多个处于 mute 状态的用户执行批量解除禁言。批量解除禁言 MUST 只取消目标用户的 `is_muted` 状态，不得因此取消 `is_block` 或恢复被删除内容。
 
 #### Scenario: 批量解除多个禁言用户
+
 - **WHEN** admin 选择多个处于 mute 状态的用户并确认批量解除禁言
 - **THEN** 系统 MUST 将这些用户的 `is_muted` 设置为 false
 - **AND** 每个不再受其他限制的用户 MUST 恢复新增话题和回复能力
 - **AND** 系统 MUST 写入审计日志，记录操作者、目标用户和处理数量
 
 #### Scenario: 批量解除禁言不恢复内容可见
+
 - **WHEN** admin 对同时处于 mute 和 block 状态的用户执行批量解除禁言
 - **THEN** 系统 MUST 取消目标用户的 `is_muted`
 - **AND** 系统 MUST 保留目标用户的 `is_block`
 - **AND** 目标用户历史内容仍按 block 规则在公共入口不可见
 
 #### Scenario: 批量解除禁言禁止自操作
+
 - **WHEN** admin 提交的批量解除禁言目标包含当前登录账号
 - **THEN** 系统 MUST 跳过或拒绝对当前登录账号执行限制状态变更
 - **AND** 当前登录账号的 `is_muted` 状态 MUST 保持不变
@@ -47,18 +53,21 @@
 系统 SHALL 允许 admin 在后台用户治理入口中对多个处于 block 状态的用户执行批量恢复内容可见。批量恢复内容可见 MUST 只取消目标用户的 `is_block` 状态，不得因此取消 `is_muted` 或恢复被删除内容。
 
 #### Scenario: 批量恢复多个用户内容可见
+
 - **WHEN** admin 选择多个处于 block 状态的用户并确认批量恢复内容可见
 - **THEN** 系统 MUST 将这些用户的 `is_block` 设置为 false
 - **AND** 目标用户未删除且符合公开规则的历史内容 MUST 恢复在公共入口可见
 - **AND** 系统 MUST 写入审计日志，记录操作者、目标用户和处理数量
 
 #### Scenario: 批量恢复内容可见不解除禁言
+
 - **WHEN** admin 对同时处于 block 和 mute 状态的用户执行批量恢复内容可见
 - **THEN** 系统 MUST 取消目标用户的 `is_block`
 - **AND** 系统 MUST 保留目标用户的 `is_muted`
 - **AND** 目标用户仍不可新增话题或回复，直到被单独或批量解除禁言
 
 #### Scenario: 批量恢复内容可见禁止自操作
+
 - **WHEN** admin 提交的批量恢复内容可见目标包含当前登录账号
 - **THEN** 系统 MUST 跳过或拒绝对当前登录账号执行限制状态变更
 - **AND** 当前登录账号的 `is_block` 状态 MUST 保持不变
diff --git a/openspec/changes/archive/2026-08-02-harden-web-ui-system/admin-mutation-matrix.md b/openspec/changes/archive/2026-08-02-harden-web-ui-system/admin-mutation-matrix.md
index 82b1fbe..1de7e3a 100644
--- a/openspec/changes/archive/2026-08-02-harden-web-ui-system/admin-mutation-matrix.md
+++ b/openspec/changes/archive/2026-08-02-harden-web-ui-system/admin-mutation-matrix.md
@@ -2,28 +2,28 @@
 
 No scoped action currently has a reliable timed undo. Actions marked `confirm` therefore require pre-action confirmation; a success toast is feedback, not undo.
 
-| Surface | Action | Risk | Policy | Confirmation target/impact |
-| --- | --- | --- | --- | --- |
-| topics | top/un-top, good/un-good | reversible | immediate | Pending and result feedback only |
-| topics | mute/unmute | high-impact | confirm | Topic count/title and public visibility impact |
-| topics | soft delete, single or bulk | destructive | confirm | Topic target/count; hidden from public views, distinguish from physical deletion |
-| topics | permanent delete, single or bulk | irreversible | confirm | Target/count and removal of replies, collections, job metadata, moderation hits, and message references |
-| moderation | false-positive, ignore | reversible workflow | immediate | Pending and result feedback only |
-| moderation | confirm violation, single/bulk/job scope | destructive | confirm | Hit target/count or scan job scope; matched content is deleted |
-| moderation | create/run/pause/resume scan job | reversible workflow | immediate | Pending and result feedback only |
-| moderation | cancel scan job | high-impact | confirm | Job id and remaining work that will not run |
-| keywords | add/import | additive | immediate | Pending and imported count feedback |
-| keywords | delete rule | destructive | confirm | Exact sensitive word; future matching stops, history is unchanged |
-| bans | mute/unmute user, single/bulk | high-impact | confirm | User/count; posting ability changes, existing content visibility does not |
-| bans | block/unblock user, single/bulk | high-impact | confirm | User/count; content visibility changes, posting ability does not |
-| bans | add IP rule | high-impact | confirm | IP/CIDR and reason; matching requests will be blocked |
-| bans | delete IP rule | destructive | confirm | Exact IP/CIDR; matching requests become eligible again |
-| reports | dismiss | reversible workflow | immediate | Pending and result feedback only |
-| reports | confirm violation | destructive | confirm | Report id and topic/reply target; violating content is deleted |
-| users | block/unblock | high-impact | confirm | User and content-visibility-only effect |
-| users | mute/unmute | high-impact | confirm | User and posting-ability-only effect |
-| users | grant/revoke role | high-impact | confirm | User, current role, resulting role, and management access impact |
-| users | reset password | irreversible security | confirm | User and invalidation/replacement of existing credentials |
-| users | delete all posts | irreversible | confirm | User and all topic/reply content; account remains |
+| Surface    | Action                                   | Risk                  | Policy    | Confirmation target/impact                                                                              |
+| ---------- | ---------------------------------------- | --------------------- | --------- | ------------------------------------------------------------------------------------------------------- |
+| topics     | top/un-top, good/un-good                 | reversible            | immediate | Pending and result feedback only                                                                        |
+| topics     | mute/unmute                              | high-impact           | confirm   | Topic count/title and public visibility impact                                                          |
+| topics     | soft delete, single or bulk              | destructive           | confirm   | Topic target/count; hidden from public views, distinguish from physical deletion                        |
+| topics     | permanent delete, single or bulk         | irreversible          | confirm   | Target/count and removal of replies, collections, job metadata, moderation hits, and message references |
+| moderation | false-positive, ignore                   | reversible workflow   | immediate | Pending and result feedback only                                                                        |
+| moderation | confirm violation, single/bulk/job scope | destructive           | confirm   | Hit target/count or scan job scope; matched content is deleted                                          |
+| moderation | create/run/pause/resume scan job         | reversible workflow   | immediate | Pending and result feedback only                                                                        |
+| moderation | cancel scan job                          | high-impact           | confirm   | Job id and remaining work that will not run                                                             |
+| keywords   | add/import                               | additive              | immediate | Pending and imported count feedback                                                                     |
+| keywords   | delete rule                              | destructive           | confirm   | Exact sensitive word; future matching stops, history is unchanged                                       |
+| bans       | mute/unmute user, single/bulk            | high-impact           | confirm   | User/count; posting ability changes, existing content visibility does not                               |
+| bans       | block/unblock user, single/bulk          | high-impact           | confirm   | User/count; content visibility changes, posting ability does not                                        |
+| bans       | add IP rule                              | high-impact           | confirm   | IP/CIDR and reason; matching requests will be blocked                                                   |
+| bans       | delete IP rule                           | destructive           | confirm   | Exact IP/CIDR; matching requests become eligible again                                                  |
+| reports    | dismiss                                  | reversible workflow   | immediate | Pending and result feedback only                                                                        |
+| reports    | confirm violation                        | destructive           | confirm   | Report id and topic/reply target; violating content is deleted                                          |
+| users      | block/unblock                            | high-impact           | confirm   | User and content-visibility-only effect                                                                 |
+| users      | mute/unmute                              | high-impact           | confirm   | User and posting-ability-only effect                                                                    |
+| users      | grant/revoke role                        | high-impact           | confirm   | User, current role, resulting role, and management access impact                                        |
+| users      | reset password                           | irreversible security | confirm   | User and invalidation/replacement of existing credentials                                               |
+| users      | delete all posts                         | irreversible          | confirm   | User and all topic/reply content; account remains                                                       |
 
 Settings, zone metadata, and tab label/order edits are ordinary configuration saves rather than governance actions in this matrix. They still require pending/error feedback, but are outside the destructive-confirmation scope.
diff --git a/openspec/changes/archive/2026-08-02-harden-web-ui-system/design.md b/openspec/changes/archive/2026-08-02-harden-web-ui-system/design.md
index 02d7921..970ad8e 100644
--- a/openspec/changes/archive/2026-08-02-harden-web-ui-system/design.md
+++ b/openspec/changes/archive/2026-08-02-harden-web-ui-system/design.md
@@ -108,15 +108,15 @@ Tailwind CSS v4 动画使用精确版本的 `tw-animate-css` CSS-first 支持，
 
 动作区始终优先展示主互动“收藏/取消收藏”和页内导航“查看回复”。普通用户动作与治理动作分开；所有治理动作收进单一“管理”菜单。作者对自己话题的“编辑话题”保持直接可见。管理员编辑他人话题放入“管理”菜单，避免与作者入口重复。版主不能仅凭版主身份编辑他人话题。角色可叠加：管理员或版主同时是作者时，保留作者的直接编辑入口，并额外展示其治理菜单。
 
-| 身份/关系 | 直接操作 | 次级区域 | “管理”菜单 |
-| --- | --- | --- | --- |
-| 匿名用户 | 查看回复；收藏入口引导登录 | 无举报 | 不展示 |
-| 普通登录用户，非作者 | 收藏/取消收藏、查看回复 | 举报话题 | 不展示 |
-| 作者，无治理角色 | 收藏/取消收藏、查看回复、编辑话题 | 不提供举报自己的话题 | 不展示 |
-| 版主，非作者 | 收藏/取消收藏、查看回复 | 举报不作为治理入口 | 置顶/取消置顶、高亮/取消高亮、删除帖子 |
-| 版主，同时为作者 | 收藏/取消收藏、查看回复、编辑话题 | 无 | 置顶/取消置顶、高亮/取消高亮、删除帖子 |
-| 管理员，非作者 | 收藏/取消收藏、查看回复 | 无 | 编辑话题、置顶/取消置顶、高亮/取消高亮、删除帖子 |
-| 管理员，同时为作者 | 收藏/取消收藏、查看回复、编辑话题 | 无 | 置顶/取消置顶、高亮/取消高亮、删除帖子 |
+| 身份/关系            | 直接操作                          | 次级区域             | “管理”菜单                                       |
+| -------------------- | --------------------------------- | -------------------- | ------------------------------------------------ |
+| 匿名用户             | 查看回复；收藏入口引导登录        | 无举报               | 不展示                                           |
+| 普通登录用户，非作者 | 收藏/取消收藏、查看回复           | 举报话题             | 不展示                                           |
+| 作者，无治理角色     | 收藏/取消收藏、查看回复、编辑话题 | 不提供举报自己的话题 | 不展示                                           |
+| 版主，非作者         | 收藏/取消收藏、查看回复           | 举报不作为治理入口   | 置顶/取消置顶、高亮/取消高亮、删除帖子           |
+| 版主，同时为作者     | 收藏/取消收藏、查看回复、编辑话题 | 无                   | 置顶/取消置顶、高亮/取消高亮、删除帖子           |
+| 管理员，非作者       | 收藏/取消收藏、查看回复           | 无                   | 编辑话题、置顶/取消置顶、高亮/取消高亮、删除帖子 |
+| 管理员，同时为作者   | 收藏/取消收藏、查看回复、编辑话题 | 无                   | 置顶/取消置顶、高亮/取消高亮、删除帖子           |
 
 “普通登录用户”在此指没有作者关系且没有治理能力的登录用户；身份组合按能力并集呈现，不通过互斥的角色优先级丢失作者入口。前端基于 SSR session/loader 已提供的 admin、moderator 与作者关系得到同一首屏结果，但每个 mutation 仍由现有 API 再次授权。
 
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/baseline-audit.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/baseline-audit.md
index 197e647..c8c7b00 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/baseline-audit.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/baseline-audit.md
@@ -9,13 +9,13 @@
 
 ## Captured Visual Baseline
 
-| Surface | Viewport | Theme | File |
-| --- | --- | --- | --- |
-| Feed/home | 1280px | light | `baseline-home-1280-light.png` |
-| Feed/home | 1280px | dark | `baseline-home-1280-dark.png` |
-| Feed/home | 375px | light | `baseline-home-375-light.png` |
-| Feed/home | 375px | dark | `baseline-home-375-dark.png` |
-| Account/sign-in | 1280px | dark | `baseline-account-1280-dark.png` |
+| Surface         | Viewport | Theme | File                             |
+| --------------- | -------- | ----- | -------------------------------- |
+| Feed/home       | 1280px   | light | `baseline-home-1280-light.png`   |
+| Feed/home       | 1280px   | dark  | `baseline-home-1280-dark.png`    |
+| Feed/home       | 375px    | light | `baseline-home-375-light.png`    |
+| Feed/home       | 375px    | dark  | `baseline-home-375-dark.png`     |
+| Account/sign-in | 1280px   | dark  | `baseline-account-1280-dark.png` |
 
 Anonymous navigation to `/admin` redirects to `/signin`, so an authenticated admin visual baseline remains part of the final browser audit. No credentials or production session material may be added to the repository to bypass that boundary.
 
@@ -31,33 +31,33 @@ The former `components/ui/form.tsx` wrapper now lives at the application layer a
 
 ## Blast Radius
 
-| Primitive/system | Current direct reach | Main risk |
-| --- | --- | --- |
-| Layout | 49 route callers | Header, footer, navigation and shell regressions |
-| AdminLayout | 25 route callers | Navigation, mobile behavior and admin width |
-| Button | 83 callers | Base Nova size changes and removed `inverse` variant |
-| Card | 49 callers | New spacing model and removal of page padding overrides |
-| Input | 38 callers | Base Nova control density and Field migration |
-| Table | 12 callers | Admin density, row states and horizontal overflow |
-| Sheet | 3 callers | Mobile navigation/filter/contact focus and safe-area |
-| MarkdownView | 5 callers through topic/reply/editor | Typeset affects all rendered Markdown |
+| Primitive/system | Current direct reach                 | Main risk                                               |
+| ---------------- | ------------------------------------ | ------------------------------------------------------- |
+| Layout           | 49 route callers                     | Header, footer, navigation and shell regressions        |
+| AdminLayout      | 25 route callers                     | Navigation, mobile behavior and admin width             |
+| Button           | 83 callers                           | Base Nova size changes and removed `inverse` variant    |
+| Card             | 49 callers                           | New spacing model and removal of page padding overrides |
+| Input            | 38 callers                           | Base Nova control density and Field migration           |
+| Table            | 12 callers                           | Admin density, row states and horizontal overflow       |
+| Sheet            | 3 callers                            | Mobile navigation/filter/contact focus and safe-area    |
+| MarkdownView     | 5 callers through topic/reply/editor | Typeset affects all rendered Markdown                   |
 
 Literal audit found more than 100 displayed matches for raw `cnode-*`/`surface-*`/`brand-*` utilities and more than 100 displayed primitive `className` overrides before result truncation. These are migration inputs, not patterns to preserve. Remaining `space-y-*` form/layout composition is also a migration target.
 
 ## Route Archetype Map
 
-| Archetype | Routes/surfaces |
-| --- | --- |
-| feed | `/`, `/search`, `/stars`, `/user/:name/topics`, `/user/:name/replies`, `/user/:name/collections`, `/my/messages` |
-| reading | `/topic/:tid` |
-| compose | `/topic/create`, `/topic/:tid/edit`, `/reply/:id/edit` |
-| account | `/signin`, `/signup`, `/setting`, `/search_pass`, `/reset_pass`, `/active_account`, GitHub auth result routes |
-| directory | `/user/:name`, `/users/top100`, `/zone/jobs` |
-| content | `/about`, `/api`, app download and shell footer content; implemented with the nearest public application blocks |
-| dashboard | `/admin` |
-| data-list | `/admin/users`, `/admin/bans`, `/admin/topics`, `/admin/tabs`, `/admin/zones`, `/admin/keywords`, `/admin/settings` |
-| workflow | `/admin/moderation`, `/admin/reports`, `/admin/audit` |
-| non-visual resource | RSS, robots, sitemap, OAuth callback and redirect-only routes; no page primitive migration |
+| Archetype           | Routes/surfaces                                                                                                     |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| feed                | `/`, `/search`, `/stars`, `/user/:name/topics`, `/user/:name/replies`, `/user/:name/collections`, `/my/messages`    |
+| reading             | `/topic/:tid`                                                                                                       |
+| compose             | `/topic/create`, `/topic/:tid/edit`, `/reply/:id/edit`                                                              |
+| account             | `/signin`, `/signup`, `/setting`, `/search_pass`, `/reset_pass`, `/active_account`, GitHub auth result routes       |
+| directory           | `/user/:name`, `/users/top100`, `/zone/jobs`                                                                        |
+| content             | `/about`, `/api`, app download and shell footer content; implemented with the nearest public application blocks     |
+| dashboard           | `/admin`                                                                                                            |
+| data-list           | `/admin/users`, `/admin/bans`, `/admin/topics`, `/admin/tabs`, `/admin/zones`, `/admin/keywords`, `/admin/settings` |
+| workflow            | `/admin/moderation`, `/admin/reports`, `/admin/audit`                                                               |
+| non-visual resource | RSS, robots, sitemap, OAuth callback and redirect-only routes; no page primitive migration                          |
 
 ## Locked Registry Baseline
 
@@ -96,12 +96,12 @@ pnpm --filter @cnode/web exec shadcn add <component> --diff <file>
 
 The migrated public shell was audited in light and dark mode at 375px, 768px, 1280px, and 1440px. Time-dependent animation was disabled before capture.
 
-| Viewport | Result |
-| --- | --- |
-| 375px | Header, mobile navigation Sheet, CommandPalette, main and footer visible; Sheet occupies the viewport width and respects the bottom edge |
-| 768px | Desktop navigation replaces the mobile trigger; CommandPalette remains within the viewport |
-| 1280px | Header, content measure, CommandPalette and footer remain bounded |
-| 1440px | Content keeps its maximum measure and does not stretch to the viewport edge |
+| Viewport | Result                                                                                                                                   |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| 375px    | Header, mobile navigation Sheet, CommandPalette, main and footer visible; Sheet occupies the viewport width and respects the bottom edge |
+| 768px    | Desktop navigation replaces the mobile trigger; CommandPalette remains within the viewport                                               |
+| 1280px   | Header, content measure, CommandPalette and footer remain bounded                                                                        |
+| 1440px   | Content keeps its maximum measure and does not stretch to the viewport edge                                                              |
 
 Every audited pair reported `documentElement.scrollWidth === clientWidth`. CommandPalette focused its search input after opening and closed with Escape. The 375px navigation Sheet opened and closed with Escape. No browser console errors remained after the final reload.
 
@@ -126,30 +126,30 @@ Existing topic `47408` is the fixed long-content reading fixture. The latest rea
 
 Each matrix cell is stored as `acceptance-{archetype}-{viewport}-{theme}.png` for all four viewports and both themes.
 
-| Archetype | Representative route | Design reason | Result |
-| --- | --- | --- | --- |
-| feed | `/` | Samples public header, filters, topic Items, rail and pagination | Pass |
-| reading | `/topic/47408` | Samples long Markdown, code, images, TOC, context and replies | Pass |
-| compose | `/topic/create` | Samples Field composition, editor mode switching, Turnstile and action footer | Pass |
-| account | `/signin` | Samples constrained account measure, autocomplete fields and helper navigation | Pass |
-| directory | `/users/top100` | Samples responsive identity Items and directory density | Pass |
-| dashboard | `/admin` | Samples authenticated Sidebar shell and real summary/list content | Pass |
-| data-list | `/admin/topics` | Samples dense filters, explicit table scrolling, status and actions | Pass |
-| workflow | `/admin/reports` | Samples queue summary and vertically readable actionable records | Pass |
+| Archetype | Representative route | Design reason                                                                  | Result |
+| --------- | -------------------- | ------------------------------------------------------------------------------ | ------ |
+| feed      | `/`                  | Samples public header, filters, topic Items, rail and pagination               | Pass   |
+| reading   | `/topic/47408`       | Samples long Markdown, code, images, TOC, context and replies                  | Pass   |
+| compose   | `/topic/create`      | Samples Field composition, editor mode switching, Turnstile and action footer  | Pass   |
+| account   | `/signin`            | Samples constrained account measure, autocomplete fields and helper navigation | Pass   |
+| directory | `/users/top100`      | Samples responsive identity Items and directory density                        | Pass   |
+| dashboard | `/admin`             | Samples authenticated Sidebar shell and real summary/list content              | Pass   |
+| data-list | `/admin/topics`      | Samples dense filters, explicit table scrolling, status and actions            | Pass   |
+| workflow  | `/admin/reports`     | Samples queue summary and vertically readable actionable records               | Pass   |
 
 The baseline update is intentional: primitives now match Base Nova, brand color is supplied by semantic tokens, routes share named application shells, and Markdown uses one Typeset preset. The screenshots must not be bulk-accepted for unrelated spacing, color, or hierarchy changes.
 
 ## State Evidence
 
-| State | Evidence | Check |
-| --- | --- | --- |
-| default and long content | archetype matrix | Shell, content rhythm, responsive density and bounded measure |
-| focus | `acceptance-state-focus.png` | 3px semantic focus ring and focused Command input |
-| selected and disabled | `acceptance-state-selected-disabled-375.png` | State remains distinguishable without raw brand classes |
-| pending | `acceptance-state-pending-375.png` | Pending control remains named and unavailable for repeat submission |
-| error | `acceptance-state-error-375.png` | Alert/Field error composition remains readable on mobile |
-| empty | `acceptance-state-empty-375.png` | Empty composition retains title, description and recovery action |
-| overlay | `acceptance-state-admin-sidebar-375.png`, `acceptance-state-admin-command-375.png` | Sheet/Dialog remain within safe-area and return final focus after Escape |
+| State                    | Evidence                                                                           | Check                                                                    |
+| ------------------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| default and long content | archetype matrix                                                                   | Shell, content rhythm, responsive density and bounded measure            |
+| focus                    | `acceptance-state-focus.png`                                                       | 3px semantic focus ring and focused Command input                        |
+| selected and disabled    | `acceptance-state-selected-disabled-375.png`                                       | State remains distinguishable without raw brand classes                  |
+| pending                  | `acceptance-state-pending-375.png`                                                 | Pending control remains named and unavailable for repeat submission      |
+| error                    | `acceptance-state-error-375.png`                                                   | Alert/Field error composition remains readable on mobile                 |
+| empty                    | `acceptance-state-empty-375.png`                                                   | Empty composition retains title, description and recovery action         |
+| overlay                  | `acceptance-state-admin-sidebar-375.png`, `acceptance-state-admin-command-375.png` | Sheet/Dialog remain within safe-area and return final focus after Escape |
 
 ## Overflow And Accessibility Audit
 
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/design.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/design.md
index 1126816..e06a18d 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/design.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/design.md
@@ -56,11 +56,11 @@ flowchart TD
 
 主题分三层，但 route 只能消费 semantic roles：
 
-| 层 | 内容 | 消费边界 |
-| --- | --- | --- |
-| Brand source | CNode green/ink 的 light/dark 色值 | 仅 theme 定义内部使用 |
-| Standard roles | core、sidebar、chart tokens | primitive、blocks、routes |
-| Exceptional brand roles | Logo/marketing 无法由标准角色表达的少量 token | 指定品牌 block |
+| 层                      | 内容                                          | 消费边界                  |
+| ----------------------- | --------------------------------------------- | ------------------------- |
+| Brand source            | CNode green/ink 的 light/dark 色值            | 仅 theme 定义内部使用     |
+| Standard roles          | core、sidebar、chart tokens                   | primitive、blocks、routes |
+| Exceptional brand roles | Logo/marketing 无法由标准角色表达的少量 token | 指定品牌 block            |
 
 `primary` 表达主操作与选中重点，`accent` 表达 hover/selected surface，`secondary` 表达次级状态，`muted` 表达弱层级，`foreground` 表达正文，`sidebar-*` 表达后台导航，`chart-*` 表达真实数据系列。删除 `@theme` 暴露的 `--color-cnode-*` 和通用 `surface-*` utilities；迁移时按用途分类，不进行字符串一对一替换。
 
@@ -68,15 +68,15 @@ Base Nova primitive 不增加 CNode class。主题校准覆盖 light/dark 文本
 
 用户提供的 Base theme 片段作为 token inventory 和明暗关系参考，而不是最终色值表。它确认本 change 必须完整提供 core、`chart-1` 至 `chart-5`、`radius` 和 `sidebar-*` roles，并可参考 dark theme 使用 alpha border/input 的层次策略。最终取值遵循以下映射：
 
-| Token group | 参考方式 | CNode 处理 |
-| --- | --- | --- |
-| background/card/popover | 保留 Base 的层级和 foreground 配对 | 可做极轻品牌色温调整，但不降低正文对比度 |
-| secondary/muted/border/input | 保留中性弱层级与 dark alpha 边界策略 | 不直接染成高饱和绿色 |
-| primary/accent/ring | 保留交互角色 | 映射到 CNode green family 并校验 foreground/focus 对比度 |
-| destructive | 保留标准危险语义 | 使用 Base 可访问 red，不品牌化 |
-| chart-1..5 | 保留标准 token 和系列用途 | 建立可区分的 CNode 协调色，不复制单色灰阶 |
-| sidebar-* | 保留独立 navigation roles | 移除示例中的无关蓝色，映射 CNode navigation theme |
-| radius | 采用锁定 Base Nova preset 默认值 | 不因旧页面或单独示例的 `0.45rem` 另建覆盖 |
+| Token group                  | 参考方式                             | CNode 处理                                               |
+| ---------------------------- | ------------------------------------ | -------------------------------------------------------- |
+| background/card/popover      | 保留 Base 的层级和 foreground 配对   | 可做极轻品牌色温调整，但不降低正文对比度                 |
+| secondary/muted/border/input | 保留中性弱层级与 dark alpha 边界策略 | 不直接染成高饱和绿色                                     |
+| primary/accent/ring          | 保留交互角色                         | 映射到 CNode green family 并校验 foreground/focus 对比度 |
+| destructive                  | 保留标准危险语义                     | 使用 Base 可访问 red，不品牌化                           |
+| chart-1..5                   | 保留标准 token 和系列用途            | 建立可区分的 CNode 协调色，不复制单色灰阶                |
+| sidebar-*                    | 保留独立 navigation roles            | 移除示例中的无关蓝色，映射 CNode navigation theme        |
+| radius                       | 采用锁定 Base Nova preset 默认值     | 不因旧页面或单独示例的 `0.45rem` 另建覆盖                |
 
 theme 值统一使用 OKLCH，便于在保持 lightness/contrast 的同时调整 CNode 色相和 chroma。最终值必须通过对比度和四 viewport 视觉矩阵确认后锁定，不能由 route 通过 Tailwind class补偿。
 
@@ -117,16 +117,16 @@ Card 使用当前标准 anatomy：Header 包含 Title、Description、Action，C
 
 ### 4. 页面按八个原型迁移
 
-| 原型 | 代表页面 | 标准结构 |
-| --- | --- | --- |
-| feed | `/`、search、collections | PageHeader/filters + feed + optional sidebar |
-| reading | topic detail | optional TOC + readable content + context rail + replies |
-| compose | create/edit topic/reply | PageHeader + FieldGroup + editor + action footer |
-| account | signin/signup/setting | account shell + FieldGroup + helper navigation |
-| directory | users/jobs/resources | PageHeader + filters + responsive Item/Card grid |
-| dashboard | `/admin` | simple page header + grouped summaries + real charts/lists |
-| data-list | admin users/topics/tabs/zones/keywords/bans | filters + toolbar + Table/Item + pagination |
-| workflow | moderation/reports/audit | queue summary + filters + actionable records |
+| 原型      | 代表页面                                    | 标准结构                                                   |
+| --------- | ------------------------------------------- | ---------------------------------------------------------- |
+| feed      | `/`、search、collections                    | PageHeader/filters + feed + optional sidebar               |
+| reading   | topic detail                                | optional TOC + readable content + context rail + replies   |
+| compose   | create/edit topic/reply                     | PageHeader + FieldGroup + editor + action footer           |
+| account   | signin/signup/setting                       | account shell + FieldGroup + helper navigation             |
+| directory | users/jobs/resources                        | PageHeader + filters + responsive Item/Card grid           |
+| dashboard | `/admin`                                    | simple page header + grouped summaries + real charts/lists |
+| data-list | admin users/topics/tabs/zones/keywords/bans | filters + toolbar + Table/Item + pagination                |
+| workflow  | moderation/reports/audit                    | queue summary + filters + actionable records               |
 
 后台保留已建立的全宽 Header 与容器内 desktop navigation Card，移动端使用 Base Nova Sheet；两者共享同一 navigation model。该结构避免全高 inset Sidebar 改变既有后台信息骨架。Desktop navigation Card 与右侧完整 PageHeader 使用同一顶部基线，不在左栏增加一层仅用于模拟 breadcrumb 高度的标签。Admin page header 使用 breadcrumb 加紧凑品牌 surface，与公共 Hero 共享颜色和 anatomy，但不使用营销尺度。Topic reading header 留在内容 Card 内，以保持 padding 的 Separator 分隔标题和 metadata。Chart 只用于已有真实时间序列；否则保持摘要和列表，不用装饰数据。
 
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/agent-owned-ui-acceptance/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/agent-owned-ui-acceptance/spec.md
index ac8679f..a693870 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/agent-owned-ui-acceptance/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/agent-owned-ui-acceptance/spec.md
@@ -5,6 +5,7 @@
 UI audit SHALL 按页面原型覆盖 375px、768px、1280px 和 1440px viewport，并 SHALL 保留约 390px 移动端与约 1280px 桌面端的代表性检查，在每类原型检查 light/dark theme。审计 MUST 覆盖默认、hover、focus、active/selected、disabled、pending、error、empty、长内容和 overlay 状态中适用于该原型的关键状态。
 
 #### Scenario: 响应式审计
+
 - **WHEN** 审计每个 route family
 - **THEN** agent 在四个标准 viewport 检查 shell、navigation、PageHeader、主要 blocks、forms、Table/Item、Markdown 和主要 actions
 - **AND** 约 390px 移动端和约 1280px 桌面端代表性检查 MUST 保持覆盖
@@ -15,6 +16,7 @@ UI audit SHALL 按页面原型覆盖 375px、768px、1280px 和 1440px viewport
 Audit SHALL 验证 Base Nova primitive 完整性、semantic theme 与品牌 token 使用、Header/Footer/Layout 一致性、命名页面原型、Card/Field/Item/Table composition、card/line/shadow 层级、spacing/size scale、hover/active/focus 状态、responsive behavior、有意义的 sidebars 和 Markdown Typeset；视觉通过不得只依据页面能够加载。
 
 #### Scenario: 模板一致性检查
+
 - **WHEN** route 被审计
 - **THEN** agent 确认它映射到正确页面原型并只使用允许的 application blocks
 - **AND** route 与 Header shell 或命名 reading shell 对齐，并保持 Header、Footer、Layout、sidebars 和交互状态一致
@@ -27,11 +29,13 @@ Audit SHALL 验证 Base Nova primitive 完整性、semantic theme 与品牌 toke
 代表性页面原型 SHALL 提供可重复的 light/dark viewport 截图或等价视觉回归证据，并 MUST 将动态时间、随机内容和动画稳定化后再比较。
 
 #### Scenario: 设计系统变更进入完成验收
+
 - **WHEN** primitive、theme、application block、layout 或 Typeset 发生变更
 - **THEN** 验收生成受影响页面原型的标准 viewport 视觉证据
 - **AND** baseline 更新 MUST 由明确设计决策解释，不得以批量接受截图掩盖漂移。
 
 #### Scenario: 行为测试与视觉测试分工
+
 - **WHEN** UI 既包含交互状态又包含视觉 composition
 - **THEN** Vitest/DOM 测试验证语义、状态与交互结果，浏览器验收验证布局、主题、响应式和像素级回归
 - **AND** 任一层失败均不得将 change 标记为完成。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/layout-templates/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/layout-templates/spec.md
index f469ea5..2a56341 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/layout-templates/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/layout-templates/spec.md
@@ -5,6 +5,7 @@
 所有 app routes SHALL 映射到由 application blocks 组成的命名页面原型。公共页面原型为 feed、reading、compose、account、directory；后台页面原型为 dashboard、data-list、workflow。每个原型 MUST 定义 shell 对齐、内容宽度、PageHeader、block spacing、主要操作位置和 responsive behavior，route 不得定义与原型无关的 standalone surface 或宽度。
 
 #### Scenario: Route 可映射到模板
+
 - **WHEN** 审计 `apps/web/app/routes` 中的任意 route
 - **THEN** route 可映射到一个命名页面原型并复用对应 blocks；原有 feed、reading/topic detail、content、form、search 和 admin 页面职责 MUST 由对应最终原型承接
 - **AND** 同类 route 不得通过独立 Hero、Card padding、圆角或最大宽度形成另一套模板。
@@ -14,11 +15,13 @@
 Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 desktop navigation Card 与 mobile Sheet，并按 dashboard、data-list 或 workflow 原型组合 page header、filters、toolbar、Card/Table/Item、pagination 和 actions。桌面、移动端导航 MUST 共享任务分组和 active state；desktop navigation Card MUST 与右侧完整 page header 使用同一顶部基线，不得增加仅用于补偿 breadcrumb 高度的左栏标签。后台 page header 使用 breadcrumb 与紧凑品牌 surface，不得扩展为宣传型 Hero。
 
 #### Scenario: Admin 页面共享布局
+
 - **WHEN** `/admin/topics`、`/admin/users` 和 `/admin/settings` 渲染
 - **THEN** 它们共享相同 shell、Sidebar/nav、内容宽度、page header、block spacing、Card/Table surface 和 active 导航行为
 - **AND** 数据列表与表单可使用不同原型，但不得重建独立 panel primitive。
 
 #### Scenario: Workflow filters 与 records 分组
+
 - **WHEN** 审计或治理 workflow 同时展示 filters 和 records
 - **THEN** toolbar、结构分隔与 records 之间保留标准 block gap
 - **AND** filter controls 不得与第一条记录共享边界或形成视觉叠压。
@@ -30,11 +33,13 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 公共入口和说明页面 SHALL 使用 marketing PageHeader；任务型页面 SHALL 使用 breadcrumb 加紧凑 PageHeader。两者 MUST 共享品牌 surface、标题层级、说明、圆角和 action 排布，只通过尺度与上下文区分，不得让任务页退化为无容器标题或局部分割线。
 
 #### Scenario: 任务型页面标题
+
 - **WHEN** 搜索、设置、发布编辑、消息、榜单或后台页面渲染
 - **THEN** breadcrumb 位于紧凑品牌 title surface 上方
 - **AND** title surface 与 marketing Hero 使用同一语义颜色，但保持更小 padding 和标题尺度。
 
 #### Scenario: Topic reading 标题
+
 - **WHEN** 话题详情渲染 breadcrumb、标题、状态和 metadata
 - **THEN** 标题保留在 reading CardHeader 而不是应用 PageHeader
 - **AND** Separator 在 Card 基础 padding 内铺满内容宽度，不触碰 Card 外框。
@@ -44,11 +49,13 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 后台 data-list 与 workflow SHALL 为窄屏定义核心字段、状态、主操作和次要详情的优先级；页面 MUST 明确选择响应式 record/item 或可横向滚动 Table，不得让关键操作只能在 viewport 外发现。
 
 #### Scenario: 响应式记录项
+
 - **WHEN** 数据可由身份/标题、状态、关键指标和主操作概括
 - **THEN** 窄屏使用 Item 或等价 record composition 将核心信息纵向排列
 - **AND** 次要字段可折叠、换行或进入详情。
 
 #### Scenario: 保留可滚动数据表
+
 - **WHEN** 任务需要跨多列比较且不适合转换为记录项
 - **THEN** Table 容器提供明确横向滚动并保留关键列宽和操作可达性
 - **AND** 页面不得同时维护行为不一致的桌面表格和移动端卡片。
@@ -58,6 +65,7 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 页面原型 SHALL 至少在 375px、768px、1280px 和 1440px viewport 下保持可用，并 SHALL 在较大 viewport 通过内容 measure 和最大宽度避免无边界拉伸。
 
 #### Scenario: 页面原型跨 viewport
+
 - **WHEN** 同一原型在四个标准 viewport 渲染
 - **THEN** 导航、标题、主要内容、主要操作和 overlay 均保持可见可达
 - **AND** 除明确的 Table 或 code scroll container 外不产生 viewport 水平溢出。
@@ -67,6 +75,7 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 除首页 feed MAY 使用简洁上一页/下一页模式外，公共列表与后台列表 SHALL 使用共享 numbered pagination，按上一页、最多五个连续页码、必要的首末页与省略号、下一页呈现。分页链接 MUST 保留当前有效筛选 query，route MUST NOT 自行建立不同分页 markup。
 
 #### Scenario: 非首页列表跨页
+
 - **WHEN** 用户在个人话题、招聘目录或后台筛选列表浏览多个结果页
 - **THEN** 页面显示一致的 numbered pagination，并以 `aria-current="page"` 标识当前页
 - **AND** 上一页、下一页和页码链接保留当前筛选条件。
@@ -76,6 +85,7 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 首页右侧 rail SHALL 优先展示补充 feed 的信息，不得重复 Hero 已表达的社区定位。社区合作展示位 MUST 明确为合作入口而非虚构广告；实时信息按最新回复、积分榜、无人回复话题排列。
 
 #### Scenario: 首页桌面 rail
+
 - **WHEN** 首页在显示右侧 rail 的 viewport 渲染
 - **THEN** 首卡为指向 About 合作说明的社区合作展示位
 - **AND** 积分榜紧邻最新回复并位于无人回复话题之前。
@@ -85,6 +95,7 @@ Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 de
 未从站点导航露出的第三方客户端下载 route SHALL 被移除，其仍有参考价值的项目链接与维护边界 SHALL 合并到 `/about`，不得让站内下载 URL 直接重定向到第三方内容。
 
 #### Scenario: 访问社区客户端说明
+
 - **WHEN** 用户在 About 查看客户端与社区项目章节
 - **THEN** 页面说明该客户端由社区开发者维护并提供原项目链接
 - **AND** route config 不再注册 `/app/download`。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-design-system-governance/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-design-system-governance/spec.md
index 892b9ee..1bf1ee7 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-design-system-governance/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-design-system-governance/spec.md
@@ -5,11 +5,13 @@
 Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/components/ui/` 的唯一 registry 基线；原子组件的结构、variant、尺寸、圆角、间距和状态样式 MUST 与锁定版本的 Base Nova 输出保持一致。
 
 #### Scenario: 审查原子组件来源
+
 - **WHEN** 开发者新增或更新 `components/ui/` 中的组件
 - **THEN** 变更 MUST 使用项目锁定的 shadcn CLI 对 `base-nova` 执行 dry-run 和 diff
 - **AND** 不得保留 legacy `new-york`、Radix wrapper 或项目专属视觉 variant。
 
 #### Scenario: CNode 品牌不进入 primitive 源码
+
 - **WHEN** 审查 Button、Card、Input、Table、Alert、Empty 或 overlay primitive
 - **THEN** primitive MUST 只消费 Base Nova 使用的 semantic tokens
 - **AND** primitive 源码 MUST NOT 包含 `cnode-*`、业务 route、权限或领域状态。
@@ -19,11 +21,13 @@ Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/c
 原子组件消费者 SHALL 只通过标准 props/variants 表达视觉和密度；`className` MUST 限于容器布局、响应式显隐、宽度约束或上游明确支持的 CSS variable，不得覆写 primitive 的颜色、高度、padding、圆角、阴影、字体或 icon 尺寸。
 
 #### Scenario: 页面需要紧凑 Card
+
 - **WHEN** 页面需要比默认 Card 更紧凑的内容块
 - **THEN** 页面 MUST 使用 `Card size="sm"` 或 Base Nova 支持的 `--card-spacing`
 - **AND** 不得分别在 CardHeader 与 CardContent 手写 padding 形成另一套密度。
 
 #### Scenario: 页面需要响应式按钮
+
 - **WHEN** Button 在移动端需要占满可用宽度或在断点隐藏
 - **THEN** 页面 MAY 使用 `w-full` 或响应式 display class
 - **AND** 不得通过 class 覆写 Button 高度、颜色、圆角或内部 icon 尺寸。
@@ -33,11 +37,13 @@ Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/c
 Web UI SHALL 在原子组件与 route 之间提供可复用 application blocks，并 SHALL 将公共和后台 route 映射到命名页面原型；blocks 负责稳定 composition，不得复制 primitive 实现。
 
 #### Scenario: 公共页面映射原型
+
 - **WHEN** 审计首页、话题详情、发布编辑、认证设置、用户或招聘页面
 - **THEN** 页面 MUST 分别映射到 feed、reading、compose、account 或 directory 原型
 - **AND** 同类页面 MUST 复用相同的 PageHeader、内容宽度、block spacing 和 responsive composition。
 
 #### Scenario: 后台页面映射原型
+
 - **WHEN** 审计后台概览、管理列表或治理队列
 - **THEN** 页面 MUST 分别映射到 dashboard、data-list 或 workflow 原型
 - **AND** 不得为每个后台 route 重建独立 panel、toolbar、filter 和 record spacing。
@@ -47,11 +53,13 @@ Web UI SHALL 在原子组件与 route 之间提供可复用 application blocks
 仓库 SHALL 提供稳定设计系统文档和可自动执行的治理检查，覆盖 primitive 基线、semantic theme、组件选择、spacing、页面原型、responsive、Markdown 和验收矩阵。
 
 #### Scenario: 新 UI 变更进入 review
+
 - **WHEN** PR 修改 primitive、theme、application block 或 route composition
 - **THEN** CI 或本地 release gate MUST 检查配置基线、禁止的 primitive 视觉覆写和原始品牌色使用
 - **AND** reviewer MUST 能从 `docs/design-system.md` 找到对应规则与验收页面原型。
 
 #### Scenario: 上游组件升级
+
 - **WHEN** 项目升级锁定的 shadcn 或 Base UI 版本
 - **THEN** 每个受影响 primitive MUST 单独审查 registry diff、API、ARIA、focus 和调用方 blast radius
 - **AND** 不得通过批量覆盖掩盖本地 application block 问题。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-components/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-components/spec.md
index 1e819bd..9775fe7 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-components/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-components/spec.md
@@ -5,37 +5,44 @@
 `apps/web/app/components/ui/` SHALL 包含仓库拥有源码的 shadcn `base-nova` 原子组件，并 SHALL 以 Base UI 作为交互 primitive 基础，覆盖 `button`、`input`、`label`、`card`、`badge`、`avatar`、`dropdown-menu`、`dialog`、`sheet`、`tabs`、`table`、`tooltip`、`skeleton`、`sonner`、`form`、`select`、`native-select`、`textarea`、`alert-dialog`、`alert`、`pagination`、`empty`、`command` 和 `radio-group`。组件 MUST 使用 `cn()` 和标准 semantic tokens，且其结构、默认 variant、尺寸、间距、圆角、颜色、focus、disabled 与状态样式 MUST 与项目锁定版本的 Base Nova registry 保持一致；Web 源码和直接依赖 MUST NOT 保留 Radix primitive、Slot 兼容层、legacy `new-york` 样式或 CNode 专属 primitive variant。
 
 #### Scenario: 新建页面使用原子组件
+
 - **WHEN** 开发者在 `routes/` 下新建页面
 - **THEN** 页面内已有 shadcn 对应物的按钮、输入、字段、卡片、列表、状态、菜单、overlay 和空状态 MUST 从 `~/components/ui/` 导入
 - **AND** 不得以裸元素和视觉 Tailwind 字符串重建相同 primitive
 - **AND** 键盘与辅助技术用户 MUST 能识别控件的名称、角色和当前状态。
 
 #### Scenario: 组件源码进仓库
+
 - **WHEN** 查看 `apps/web/app/components/ui/`
 - **THEN** 已安装组件 MUST 是完整的 Base Nova 组件源码而不是 npm re-export
 - **AND** `components.json` MUST 让 shadcn CLI 将项目识别为 Base Nova 而不是 Radix `new-york`。
 
 #### Scenario: 页面使用一致的语义组件
+
 - **WHEN** 页面渲染按钮、输入框、选择器、反馈、分页或空状态
 - **THEN** 用户看到的颜色、圆角、密度、焦点和禁用状态 MUST 与同类品牌组件一致
 - **AND** 键盘与辅助技术用户 MUST 能识别控件的名称、角色和当前状态。
 
 #### Scenario: 现有组件行为保持可用
+
 - **WHEN** 共享原子组件新增能力或样式更新
 - **THEN** 已使用该组件的页面 MUST 保持原有可执行动作和导航结果
 - **AND** 不得因 Base UI 或 Base Nova realignment 改变既有业务动作、导航结果或权限入口。
 
 #### Scenario: 组件组合使用 Base UI render
+
 - **WHEN** Button、Dialog trigger、Sheet trigger 或菜单项组合 React Router Link 或其他元素
 - **THEN** 组件 MUST 使用 Base UI `render` 或等价原生语义完成组合
 - **AND** DOM MUST NOT 产生嵌套 button、重复交互元素或长期 `asChild`/Radix Slot 兼容层。
 
 #### Scenario: Base UI 状态驱动样式
+
 - **WHEN** overlay 打开或关闭、Checkbox 选中、Tabs 激活或菜单高亮
 - **THEN** 样式 MUST 由对应 Base UI open/closed/checked/active/highlighted 状态属性驱动
 - **AND** 不得依赖已失效的 Radix `data-state` 或 `--radix-*` 变量。
 
 #### Scenario: 迁移完成后清理 Radix
+
 - **WHEN** Web primitive 与消费者迁移完成
 - **THEN** `apps/web` 源码 MUST 不再 import `@radix-ui/*` 或 `radix-ui`
 - **AND** Web package MUST 不再直接声明 Radix dependencies
@@ -46,11 +53,13 @@
 Button 组件 MUST 只提供锁定 Base Nova 版本定义的标准 variants 和 sizes，并 MUST 保持 `default`、`secondary`、`destructive`、`outline`、`ghost`、`link` variants 以及 `default`、`sm`、`lg`、`icon` sizes 的现有语义覆盖。主操作、次级操作、危险操作、链接与 icon-only 操作 SHALL 使用标准 prop 表达；页面 MUST NOT 新增 `inverse` 等项目专属 variant，或通过 `className` 重定义 Button 颜色、尺寸、padding、圆角和 icon 大小。
 
 #### Scenario: 主按钮替换
+
 - **WHEN** 渲染登录表单的提交按钮
 - **THEN** 使用 `<Button>` 默认 variant
 - **AND** CNode 主色由 `primary` token 提供，不在 Button 或 route 中写品牌颜色 class，也不保留裸 `<button className="bg-blue-600 ...">`。
 
 #### Scenario: 次级按钮替换
+
 - **WHEN** 渲染取消按钮
 - **THEN** 使用 `<Button variant="outline">` 或与动作层级匹配的标准 variant
 - **AND** 不得手写边框、背景和 hover 颜色，也不保留裸 `<button className="border border-gray-300 ...">`。
@@ -62,11 +71,13 @@ Button 组件 MUST 只提供锁定 Base Nova 版本定义的标准 variants 和
 页面 SHALL 优先使用 Base Nova Card、Field、Item、Sidebar、Table/Data Table、Badge、Alert、Empty、Separator、Toggle Group 和 Input Group 的标准 composition；只有包含稳定 CNode 领域结构时才能建立 application block。
 
 #### Scenario: 状态和空结果展示
+
 - **WHEN** 页面展示状态标签、错误说明或空结果
 - **THEN** 分别使用 Badge、Alert 或 Empty 的标准 composition
 - **AND** 不得手写具有相同角色的品牌色 span 或 surface div。
 
 #### Scenario: Card 含标题、说明和操作
+
 - **WHEN** Card 同时包含标题、说明和右侧操作
 - **THEN** 使用 CardHeader、CardTitle、CardDescription 和 CardAction
 - **AND** 不得以自定义 flex header 和独立 padding 模拟相同结构。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-forms/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-forms/spec.md
index 710b6d3..ea0ea83 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-forms/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-forms/spec.md
@@ -5,6 +5,7 @@
 表单字段 MUST 使用当前 Base Nova Field family（`FieldGroup`、`Field`、`FieldLabel`、`FieldDescription`、`FieldError`、适用时的 `FieldSet`/`FieldLegend`）组合 Input、Textarea、Select、NativeSelect、Checkbox、RadioGroup 或 Switch。React Hook Form SHALL 通过 Controller 与 Field composition 集成，resolver 或服务端字段错误 SHALL 由 `FieldError` 自动渲染；无效状态 MUST 同时在 Field 上使用 `data-invalid` 并在控件上使用 `aria-invalid`。页面 MUST NOT 使用裸 `div + Label`、`space-y-*`、手动管理的字段状态/错误元素或页面自定义控件间距替代 Field composition。
 
 #### Scenario: 字段错误自动显示
+
 - **WHEN** 用户提交登录表单且 `pass` 为空或密码字段无效
 - **THEN** FieldError 自动展示 shared schema 定义的“密码不能为空”或对应 schema/服务端字段错误，无需手写条件错误元素
 - **AND** Field、控件、说明和错误之间保持 Base Nova 定义的可访问关系与间距。
@@ -16,11 +17,13 @@
 公共表单、后台筛选和表格内联编辑 SHALL 使用 Base Nova 控件的标准 default/small size 与 Field orientation；页面不得通过高度、padding 或圆角 class 建立第三种密度。
 
 #### Scenario: 后台表格内联编辑
+
 - **WHEN** 后台 Table cell 渲染 Input 或 NativeSelect
 - **THEN** 控件使用标准 small size 或专门的紧凑 composition
 - **AND** 同一行的 Input、Select、Button 和状态控件 MUST 保持一致高度。
 
 #### Scenario: 移动端表单重排
+
 - **WHEN** horizontal 或 responsive Field 在窄屏渲染
 - **THEN** label、control、description 和 action MUST 按 Field 的 responsive orientation 自然堆叠
 - **AND** 不得发生水平溢出或操作被固定宽度遮挡。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-markdown/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-markdown/spec.md
index 521056d..787d9b9 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-markdown/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-markdown/spec.md
@@ -5,6 +5,7 @@
 `apps/web/app/components/MarkdownEditor.tsx` 的预览和双栏预览 MUST 直接渲染与发布后相同的 `MarkdownView`、Markdown pipeline 和 `.typeset-docs` preset；相同内容在相同可用宽度下 MUST 具有一致的标题、段落、列表、代码、表格与图片节奏。
 
 #### Scenario: 编辑器预览与最终渲染一致
+
 - **WHEN** 用户在编辑器点击“预览”或以双栏模式预览话题或回复 Markdown
 - **THEN** 预览和最终内容使用同一 Markdown pipeline 和 `.typeset-docs` preset，渲染效果与发布后内容一致
 - **AND** 不得由编辑器容器额外覆写正文颜色、列表 marker、字体大小或 block spacing。
@@ -14,26 +15,31 @@
 项目 SHALL 从 `https://ui.shadcn.com/typeset.css` 持有未定制的上游 Typeset stylesheet，并 SHALL 在 Tailwind import 后导入。全部 `MarkdownView` SHALL 使用 `typeset typeset-docs` 容器；`.typeset-docs` MUST 使用 Roboto Variable 作为 body、heading 和 mono font，并定义 `14px` size、`1.75` leading 与 `1.25em` flow。颜色、圆角与内容表面 MUST 消费 semantic theme tokens，dark mode 不得依赖独立 `prose-invert` palette。
 
 #### Scenario: Typeset stylesheet 和字体安装
+
 - **WHEN** 审查 Web 样式入口和依赖
 - **THEN** `typeset.css` 位于主 CSS 同目录并在 Tailwind 后导入，`@fontsource-variable/roboto` 已安装并导入
 - **AND** `--font-roboto` 与 `.typeset-docs` 的三个 font variables 使用 Roboto Variable。
 
 #### Scenario: 全部 MarkdownView 使用统一 surface
+
 - **WHEN** 话题、回复或 MarkdownEditor preview 渲染 MarkdownView
 - **THEN** renderer 根容器包含 `typeset typeset-docs`
 - **AND** 所有 surface 使用同一 rhythm，不保留 `.markdown-body` 或 route-specific typography class。
 
 #### Scenario: dark mode 下 Typeset 跟随
+
 - **WHEN** 用户切换到 dark mode
 - **THEN** Markdown 正文、链接、引用、列表、代码、表格和图片边界自动跟随 semantic tokens
 - **AND** 不需要 route 或 Markdown component 增加手工 dark color class。
 
 #### Scenario: dark mode 下 prose 跟随
+
 - **WHEN** 切到 dark mode
 - **THEN** Markdown 正文文字色、代码块背景色及其他 Typeset 内容跟随 semantic tokens 变化
 - **AND** 不写 `dark:prose-invert` 或其他手工 `dark:` 颜色变体。
 
 #### Scenario: Typeset 只影响 Markdown surface
+
 - **WHEN** 页面同时包含 Markdown 和嵌入式交互组件
 - **THEN** Typeset selector MUST 不影响容器外内容
 - **AND** 不应继承 Typeset 的嵌入组件使用 `not-typeset` 或 `data-not-typeset` 隔离。
@@ -45,16 +51,19 @@
 Markdown Typeset MUST 正确呈现无序列表、有序列表、嵌套列表、混合列表、任务列表、loose list 及列表内段落、引用和代码块；Tailwind reset MUST NOT 移除可见 marker、序号、缩进或层级关系。
 
 #### Scenario: 无序和有序列表
+
 - **WHEN** Markdown 包含 `- item` 或 `1. item`
 - **THEN** 无序列表显示项目 marker，有序列表显示稳定序号
 - **AND** marker、正文和嵌套内容在 light/dark 下均可辨识。
 
 #### Scenario: 嵌套和任务列表
+
 - **WHEN** Markdown 包含多层嵌套列表或 GFM task list
 - **THEN** 每层具有可辨识缩进和 marker 层级，checkbox 与标签正确对齐
 - **AND** 375px viewport 不产生正文级水平溢出。
 
 #### Scenario: 列表内复杂 block
+
 - **WHEN** list item 包含段落、引用或 fenced code block
 - **THEN** block spacing 保持所属列表层级
 - **AND** 代码区域可在自身边界内滚动而不撑破页面。
diff --git a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-theme/spec.md b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-theme/spec.md
index d8f3cf4..f845bf4 100644
--- a/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-theme/spec.md
+++ b/openspec/changes/archive/2026-08-02-realign-web-design-system/specs/web-ui-theme/spec.md
@@ -5,11 +5,13 @@
 `apps/web/app/styles/global.css` SHALL 用 Tailwind v4 CSS-first `@theme inline` 声明 Base Nova 所需的完整 core semantic tokens，至少涵盖 `background`/`foreground`、`primary`/`primary-foreground`、`secondary`/`secondary-foreground`、`muted`/`muted-foreground`、`accent`/`accent-foreground`、`destructive`/`destructive-foreground`、`border`、`input`、`ring`、`card`/`card-foreground`、`popover`/`popover-foreground` 和 `radius`，并 SHALL 为 light/dark 分别定义标准 sidebar 与 chart tokens。CNode 颜色 MUST 映射到 `primary`、`accent`、`secondary`、`muted`、`foreground`、`sidebar-*` 和 `chart-*` 等用途；只有 Logo 或品牌展示无法由标准角色表达时 MAY 增加少量 `brand-*` token。
 
 #### Scenario: 组件使用语义 class 而非字面量色值
+
 - **WHEN** 任意组件渲染卡片、控件、状态或导航背景
 - **THEN** 使用与用途匹配的标准 semantic class；Card 背景使用 `bg-card text-card-foreground`
 - **AND** 不出现十六进制色值、原始 CNode palette class 或手工 light/dark 颜色组合。
 
 #### Scenario: 切换 dark mode 不改组件代码
+
 - **WHEN** `<html>` 元素添加或移除 `dark` class
 - **THEN** 所有 semantic class 以及 core、sidebar、chart 和允许的 brand roles MUST 自动切换配色
 - **AND** primitive 与 route 无需增加 `dark:` 颜色变体。
@@ -19,11 +21,13 @@
 `styles/global.css` SHALL 作为 Tailwind、动画、Typeset 与主题 token 的入口，不得包含 route、领域 block 或 primitive 的补丁样式。Markdown Typeset、代码高亮等跨页面内容系统 MAY 使用独立 CSS 文件并由该入口导入。
 
 #### Scenario: 全局 CSS 边界
+
 - **WHEN** 查看 `styles/global.css` 及其导入
 - **THEN** global 入口只包含框架 imports、theme token、必要 base behavior 和独立内容系统 imports
 - **AND** 不得出现用于修复单一路由、Card、Button、Table 或 overlay 的 selector。
 
 #### Scenario: 全局 CSS 只剩 token
+
 - **WHEN** 查看 `styles/global.css`
 - **THEN** 除 Tailwind、动画与独立 Typeset/代码高亮内容系统 imports、`@theme inline`、`:root`、`.dark` 和必要 base behavior 外不包含其他规则
 - **AND** 不得包含业务样式、组件样式或 route-specific selector。
@@ -35,6 +39,7 @@
 业务页面和 application blocks MUST 按语义选择 theme role，不得直接使用 `cnode-green`、`cnode-soft`、`cnode-ink` 或等价 raw palette utility。
 
 #### Scenario: 同一浅绿色用于不同语义
+
 - **WHEN** 旧页面以同一 `bg-cnode-soft` 表达 selected、informational、muted surface 或 decoration
 - **THEN** 迁移后 MUST 根据用途分别选择 `accent`、`secondary`、`muted` 或允许的 brand role
 - **AND** 不得执行不区分用途的全局字符串替换。
@@ -44,16 +49,19 @@
 主题 SHALL 以 Base Nova 提供的 light/dark core、chart、radius 和 sidebar token 集合作为结构种子，并 SHALL 保持其 surface 层级、foreground 配对和透明 border/input 关系。CNode theme MUST 在这些标准角色内替换品牌相关色相，不得删除标准 token 或在页面建立平行 token 系统。
 
 #### Scenario: CNode 映射 Base theme
+
 - **WHEN** 从 Base Nova 中性 theme 生成 CNode light/dark theme
 - **THEN** background、card、popover、secondary、muted、border 和 input 保持可辨识的标准层级关系
 - **AND** primary、accent、sidebar-primary 和适用的 chart roles 使用经过对比度验证的 CNode 品牌色，而不是原样保留中性灰或无关蓝色。
 
 #### Scenario: Radius 遵循 preset 基线
+
 - **WHEN** Base Nova registry 定义默认 radius 与派生 radius
 - **THEN** theme MUST 采用该 preset 基线并让 primitive 通过标准 radius token 消费
 - **AND** 不得仅因旧页面外观或单独 theme 示例的 `0.45rem` 值在 route/primitive 建立不同圆角。
 
 #### Scenario: Chart token 具有可辨识系列
+
 - **WHEN** 后台真实数据 chart 使用 `chart-1` 至 `chart-5`
 - **THEN** light/dark 下相邻系列 MUST 可辨识并与 CNode theme 协调
 - **AND** 不得直接复制无法区分业务系列的单色灰阶或为装饰目的使用 chart token。
diff --git a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/design.md b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/design.md
index 2069356..daa8521 100644
--- a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/design.md
+++ b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/design.md
@@ -99,12 +99,12 @@ API、Web、worker 和运维 service 通过同一 `env_file` 接收运行时配
 
 ## Migration Plan
 
-| 阶段 | 仓库动作 | 真实环境动作 |
-| --- | --- | --- |
-| 1. 实现与验证 | 一次性替换 tracked code、模板、Compose、docs、specs；运行静态检查与测试 | 不读取或修改真实 dotenv |
-| 2. 部署准备 | 构建包含新契约的镜像，验证 Compose 模板 | 运维在维护窗口准备完整 `CNODE_*` secret |
-| 3. 原子切换 | 发布新镜像与新 Compose | 同时启用新变量并重建应用容器，不重建 PostgreSQL 数据卷 |
-| 4. 验证 | 检查 API health、worker 和只读数据库连通性 | 保留旧配置备份仅用于整套回滚，不供新代码 fallback |
+| 阶段          | 仓库动作                                                                | 真实环境动作                                           |
+| ------------- | ----------------------------------------------------------------------- | ------------------------------------------------------ |
+| 1. 实现与验证 | 一次性替换 tracked code、模板、Compose、docs、specs；运行静态检查与测试 | 不读取或修改真实 dotenv                                |
+| 2. 部署准备   | 构建包含新契约的镜像，验证 Compose 模板                                 | 运维在维护窗口准备完整 `CNODE_*` secret                |
+| 3. 原子切换   | 发布新镜像与新 Compose                                                  | 同时启用新变量并重建应用容器，不重建 PostgreSQL 数据卷 |
+| 4. 验证       | 检查 API health、worker 和只读数据库连通性                              | 保留旧配置备份仅用于整套回滚，不供新代码 fallback      |
 
 回滚采用整套回滚：恢复上一版本镜像、Compose 和旧环境变量名称。不得通过在新代码中恢复兼容读取完成回滚。
 
diff --git a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/explicit-migration-rehearsal-profile/spec.md b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/explicit-migration-rehearsal-profile/spec.md
index 3e98dbb..2803905 100644
--- a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/explicit-migration-rehearsal-profile/spec.md
+++ b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/explicit-migration-rehearsal-profile/spec.md
@@ -1,20 +1,24 @@
 ## MODIFIED Requirements
 
 ### Requirement: Migration rehearsal profiles SHALL be selected explicitly
+
 The migration rehearsal workflow MUST require an explicit env profile for non-default PostgreSQL targets, so default local development commands do not accidentally use other database credentials. The profile MUST use the namespaced PostgreSQL contract and remain human-managed.
 
 #### Scenario: Operator selects a rehearsal target
+
 - **WHEN** an operator runs a DB or migration command against a non-default PostgreSQL target
 - **THEN** the command MUST require an explicit `CNODE_ENV_FILE` selection or an equivalent documented mechanism
 - **AND** the selected profile MUST be an ignored local file or externally supplied environment, not a tracked file containing real credentials
 - **AND** the profile MUST provide `POSTGRES_*` variables rather than legacy `DB_*` variables
 
 #### Scenario: Default development startup
+
 - **WHEN** a developer runs `pnpm dev` without an explicit env profile
 - **THEN** Web and API MUST use the default root `.env` environment contract
 - **AND** they MUST NOT automatically load non-default dotenv profiles
 
 #### Scenario: Existing local profiles are present during repository migration
+
 - **WHEN** 真实 dotenv profiles 已存在
 - **THEN** 自动实施 MUST NOT 读取、打印、修改、覆盖、删除或迁移这些文件
 - **AND** profile 内容更新 MUST 等待后续明确授权的人工处理
diff --git a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/postgres-first-dev-runtime/spec.md b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/postgres-first-dev-runtime/spec.md
index b5f2228..be4cd5f 100644
--- a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/postgres-first-dev-runtime/spec.md
+++ b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/postgres-first-dev-runtime/spec.md
@@ -1,26 +1,31 @@
 ## MODIFIED Requirements
 
 ### Requirement: Developers SHALL provide PostgreSQL and Redis connection settings
+
 Developers MUST be able to run cnode-next against PostgreSQL/Redis by providing connection settings through the unified root `.env` contract. 应用配置 MUST 使用 `CNODE_*`，PostgreSQL 与 Redis MUST 分别使用 `POSTGRES_*` 与 `REDIS_*`，且不得接受旧变量 fallback。
 
 #### Scenario: Developer configures database/cache endpoints
+
 - **WHEN** a developer needs to run the project locally
 - **THEN** documentation MUST instruct them to provide PostgreSQL host, port, database, user and password via `POSTGRES_HOST`、`POSTGRES_PORT`、`POSTGRES_DB`、`POSTGRES_USER`、`POSTGRES_PASSWORD`
 - **AND** documentation MUST instruct them to provide Redis host, port, database index and optional password via `REDIS_HOST`、`REDIS_PORT`、`REDIS_DB`、`REDIS_PASSWORD`
 - **AND** `.env.local` or app-local dotenv files such as `apps/web/.env` or `apps/web/.env.local` MUST NOT be required for normal local startup
 
 #### Scenario: Workspace dev commands load environment consistently
+
 - **WHEN** a developer starts Web and API together with `pnpm dev`
 - **THEN** both applications MUST load local environment values from the same repository root contract
 - **AND** Web, API, and DB scripts MUST NOT depend on separate app-local dotenv files for shared values such as `CNODE_API_BASE_URL`, `POSTGRES_HOST`, `REDIS_HOST`, or auth cookie settings
 - **AND** runtime consumers MUST NOT fall back to `APP_*`、`DB_*` or `DATABASE_URL`
 
 #### Scenario: Package script invokes framework or database CLI
+
 - **WHEN** a package script invokes a CLI that needs application runtime environment, such as `react-router`, `drizzle-kit`, `tsx` application scripts, or API worker scripts
 - **THEN** the CLI MUST receive the repository root environment contract through its natural config file or script entrypoint
 - **AND** the default package script command shape MUST NOT be changed solely to wrap the CLI with an env launcher
 
 #### Scenario: Package script runs unrelated quality tooling
+
 - **WHEN** a package script runs tooling that does not need application runtime environment, such as lint, typecheck, format, secret scanning, or production compose template validation
 - **THEN** the script SHOULD NOT load local dotenv files
 - **AND** it MUST NOT require local secrets to succeed
diff --git a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/runtime-environment-contract/spec.md b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/runtime-environment-contract/spec.md
index fb4e45e..bb837b4 100644
--- a/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/runtime-environment-contract/spec.md
+++ b/openspec/changes/archive/2026-08-02-standardize-runtime-environment-contract/specs/runtime-environment-contract/spec.md
@@ -1,41 +1,50 @@
 ## ADDED Requirements
 
 ### Requirement: Runtime environment variables SHALL use semantic prefixes
+
 cnode-next 应用配置 MUST 将原 `APP_*` 前缀替换为 `CNODE_*`；PostgreSQL 与 Redis 配置 MUST 分别使用既有生态前缀 `POSTGRES_*` 与 `REDIS_*`，使变量名称明确表达配置归属和属性。
 
 #### Scenario: Maintainer adds a project runtime variable
+
 - **WHEN** 维护者为 cnode-next 增加新的应用运行时环境变量
 - **THEN** 变量名 MUST 以 `CNODE_` 开头
 - **AND** 名称 MUST 使用能够表达资源、能力和属性的完整单词
 - **AND** PostgreSQL 或 Redis 连接字段 MUST NOT 添加 `CNODE_` 前缀
 
 #### Scenario: Legacy application variable is supplied
+
 - **WHEN** 进程只提供 `APP_*` 应用配置
 - **THEN** 应用 MUST NOT 将其作为 `CNODE_*` 的 alias 或 fallback
 
 #### Scenario: Same contract is used in different environments
+
 - **WHEN** 本地、rehearsal、CI 或 production 为同一运行时能力提供不同配置值
 - **THEN** 各环境 MUST 使用相同变量名
 - **AND** 部署环境名称 MUST NOT 编码到变量名中
 
 ### Requirement: PostgreSQL connection SHALL use one CNODE contract
+
 所有 PostgreSQL 运行时消费者 MUST 只使用 `POSTGRES_HOST`、`POSTGRES_PORT`、`POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD`。
 
 #### Scenario: PostgreSQL config is parsed
+
 - **WHEN** API、worker、Drizzle、migration、seed 或运维脚本建立 PostgreSQL 连接
 - **THEN** `POSTGRES_HOST`、`POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD` MUST 为非空值
 - **AND** 未提供 `POSTGRES_PORT` 时 MUST 使用唯一默认值 `5432`
 - **AND** 无效端口 MUST 在建立连接前失败
 
 #### Scenario: Legacy PostgreSQL variable is supplied
+
 - **WHEN** 进程只提供 `DB_HOST`、`DB_PORT`、`DB_NAME`、`DB_USER`、`DB_PASSWORD` 或 `DATABASE_URL`
 - **THEN** PostgreSQL 配置解析 MUST 失败并指出缺少的新变量名
 - **AND** 系统 MUST NOT 将旧变量作为 alias 或 fallback
 
 ### Requirement: Redis connection SHALL use one CNODE contract
+
 所有真实 Redis 运行时消费者 MUST 只使用 `REDIS_HOST`、`REDIS_PORT`、`REDIS_DB` 和 `REDIS_PASSWORD`。
 
 #### Scenario: Redis config is parsed
+
 - **WHEN** API 或 worker 选择真实 Redis client
 - **THEN** `REDIS_HOST` MUST 为非空值
 - **AND** 未提供 `REDIS_PORT` 时 MUST 使用 `6379`
@@ -43,54 +52,66 @@ cnode-next 应用配置 MUST 将原 `APP_*` 前缀替换为 `CNODE_*`；PostgreS
 - **AND** port 与 database index MUST 在建立连接前验证为有效整数
 
 #### Scenario: Test does not use a real Redis service
+
 - **WHEN** 自动化测试通过 mock 或 fake 边界验证 API 行为
 - **THEN** 测试 MUST NOT 要求真实 `REDIS_*` 凭据
 - **AND** mock 选择 MUST NOT 由部分缺失的生产连接变量静默触发
 
 ### Requirement: Runtime resource config SHALL be parsed centrally
+
 PostgreSQL 与 Redis 配置的必填校验、类型转换和默认值 MUST 由共享的 typed parser 统一定义，消费者不得各自解释同一环境变量。
 
 #### Scenario: Multiple consumers create resource clients
+
 - **WHEN** API、worker、DB package、Drizzle config 或独立脚本读取同一资源配置
 - **THEN** 所有消费者 MUST 获得相同字段、默认值和验证结果
 - **AND** PostgreSQL consumer MUST 使用结构化连接字段而不是手工拼接连接 URL
 
 #### Scenario: Secret config is invalid
+
 - **WHEN** password 等 secret 变量缺失或无效
 - **THEN** 错误信息 MUST 只标识变量名和错误类型
 - **AND** 错误、日志和健康响应 MUST NOT 包含 secret 值
 
 ### Requirement: Compose SHALL inject the unified environment file directly
+
 Production Compose MUST use `env_file` to inject the unified runtime configuration and MUST NOT repeat the complete variable contract in each service.
 
 #### Scenario: Compose initializes PostgreSQL
+
 - **WHEN** production Compose 配置 PostgreSQL 官方镜像
 - **THEN** Compose MUST 通过 `env_file` 向运行时 service 注入统一配置
 - **AND** PostgreSQL 官方镜像 MUST 直接消费 `POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD`
 - **AND** operator MUST NOT 被要求为同一值维护第二套输入变量
 
 ### Requirement: Contract migration SHALL be an atomic hard cutover
+
 受版本控制的代码、模板、Compose、测试、活跃 specs 和文档 MUST 在同一个 change 中一次性切换到新契约，不得提供兼容窗口。
 
 #### Scenario: Repository is checked after migration
+
 - **WHEN** 实施完成后检查 shipped source 和活跃文档
 - **THEN** 不得存在旧 PostgreSQL 或 Redis 运行时变量引用
 - **AND** 不得存在新旧变量 alias、fallback 或 deprecated compatibility path
 
 #### Scenario: New required variables are absent
+
 - **WHEN** 运行时仍只配置旧变量
 - **THEN** 依赖该资源的进程 MUST 快速失败
 - **AND** 进程 MUST NOT 静默连接默认、旧或其他环境的资源
 
 ### Requirement: Real dotenv files SHALL remain human-managed and untouched
+
 自动实施与验证 MUST NOT 读取、打印、修改、覆盖、删除或自动迁移开发者真实 dotenv 文件。
 
 #### Scenario: Tracked templates are migrated
+
 - **WHEN** 实施者更新 `.env.example` 或 `deployment/.env.production.example`
 - **THEN** 只能写入新变量及非敏感占位值
 - **AND** 不得根据真实 dotenv 内容生成模板
 
 #### Scenario: Real dotenv files exist in the workspace
+
 - **WHEN** 实施或验证发现真实 dotenv 文件
 - **THEN** 必须保持文件及其内容不变
 - **AND** 真实配置迁移 MUST 留给后续明确授权的人工流程
diff --git a/openspec/changes/archive/2026-08-03-add-web-identity-metadata/design.md b/openspec/changes/archive/2026-08-03-add-web-identity-metadata/design.md
index 49663cf..77f5964 100644
--- a/openspec/changes/archive/2026-08-03-add-web-identity-metadata/design.md
+++ b/openspec/changes/archive/2026-08-03-add-web-identity-metadata/design.md
@@ -41,18 +41,18 @@ flowchart LR
 
 公开资源使用以下稳定路径：
 
-| 路径 | 用途 |
-| --- | --- |
-| `/cnode/logo.svg` | 完整深色 CNode 字标 |
-| `/cnode/logo-light.svg` | 完整浅色 CNode 字标 |
-| `/cnode/icon.svg` | 小尺寸 CNode 图标源文件 |
-| `/cnode/favicon.svg` | SVG favicon |
-| `/cnode/favicon.png` | PNG favicon，至少 48x48 |
-| `/cnode/favicon.ico` | 兼容浏览器默认探测 |
-| `/cnode/apple-touch-icon.png` | iOS bookmark 图标 |
-| `/cnode/icon-192.png` | manifest icon |
-| `/cnode/icon-512.png` | manifest icon |
-| `/cnode/og.png` | 默认社交分享图 |
+| 路径                          | 用途                    |
+| ----------------------------- | ----------------------- |
+| `/cnode/logo.svg`             | 完整深色 CNode 字标     |
+| `/cnode/logo-light.svg`       | 完整浅色 CNode 字标     |
+| `/cnode/icon.svg`             | 小尺寸 CNode 图标源文件 |
+| `/cnode/favicon.svg`          | SVG favicon             |
+| `/cnode/favicon.png`          | PNG favicon，至少 48x48 |
+| `/cnode/favicon.ico`          | 兼容浏览器默认探测      |
+| `/cnode/apple-touch-icon.png` | iOS bookmark 图标       |
+| `/cnode/icon-192.png`         | manifest icon           |
+| `/cnode/icon-512.png`         | manifest icon           |
+| `/cnode/og.png`               | 默认社交分享图          |
 
 根路径 `/favicon.ico`、`/favicon.png`、`/apple-touch-icon.png` 和 `/manifest.json` 继续存在，作为浏览器默认探测和旧链接兼容入口。
 
diff --git a/openspec/changes/archive/2026-08-05-fix-community-content-experience/design.md b/openspec/changes/archive/2026-08-05-fix-community-content-experience/design.md
index 864dfe3..3d55105 100644
--- a/openspec/changes/archive/2026-08-05-fix-community-content-experience/design.md
+++ b/openspec/changes/archive/2026-08-05-fix-community-content-experience/design.md
@@ -85,15 +85,15 @@ flowchart TD
 
 ## Database Change Audit
 
-| 项目 | 结论 |
-|---|---|
-| Schema / Drizzle migration | 不新增或修改字段；为有效回复聚合与稳定排序增加 reviewed partial index migration |
-| 字段语义 | `last_reply_id/at` 明确指向最后一条未删除回复；无有效回复时为 null |
-| 查询/index | 现有 schema 无回复 topic 索引；增加 `(topic_id, create_at, id) where deleted=false` partial index。部署前后仍需在真实 PostgreSQL 运行 `EXPLAIN` 核验 |
-| Backfill / repair | 新增幂等 PostgreSQL 修复脚本，回算 topic 回复聚合 |
-| Seed/bootstrap | 不修改 |
-| 数据清理/保留 | 不删除回复记录，仅修复聚合字段 |
-| 核验 | 修复前后统计不一致 topic 数，抽查 `49278` 类零回复记录与多回复回退记录 |
+| 项目                       | 结论                                                                                                                                                 |
+| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Schema / Drizzle migration | 不新增或修改字段；为有效回复聚合与稳定排序增加 reviewed partial index migration                                                                      |
+| 字段语义                   | `last_reply_id/at` 明确指向最后一条未删除回复；无有效回复时为 null                                                                                   |
+| 查询/index                 | 现有 schema 无回复 topic 索引；增加 `(topic_id, create_at, id) where deleted=false` partial index。部署前后仍需在真实 PostgreSQL 运行 `EXPLAIN` 核验 |
+| Backfill / repair          | 新增幂等 PostgreSQL 修复脚本，回算 topic 回复聚合                                                                                                    |
+| Seed/bootstrap             | 不修改                                                                                                                                               |
+| 数据清理/保留              | 不删除回复记录，仅修复聚合字段                                                                                                                       |
+| 核验                       | 修复前后统计不一致 topic 数，抽查 `49278` 类零回复记录与多回复回退记录                                                                               |
 
 隔离 PostgreSQL 18 克隆验证使用 231,109 条回复：索引前 count/latest 查询采用 Parallel Seq Scan，执行约 39–51ms；应用 `replies_active_topic_order_idx` 后采用 Index Only Scan，执行约 0.12–0.38ms。migration 重复执行安全，repair 首次修复 48,972 个 topic，随后 dry-run 与第二次 apply 均为 0；用户数量、总积分、用户回复数和回复删除状态计数保持不变。
 
diff --git a/openspec/changes/simplify-deployment-documentation/specs/container-image-delivery/spec.md b/openspec/changes/simplify-deployment-documentation/specs/container-image-delivery/spec.md
index 348d489..f6b544a 100644
--- a/openspec/changes/simplify-deployment-documentation/specs/container-image-delivery/spec.md
+++ b/openspec/changes/simplify-deployment-documentation/specs/container-image-delivery/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 镜像部署命令必须使用统一编排入口
+
 项目 SHALL 通过 `deployment/docker-compose.yml` 引用已发布的不可变镜像，并在部署过程中禁止本地镜像构建。
 
 #### Scenario: 拉取待部署镜像
+
 - **WHEN** 维护者准备部署指定版本
 - **THEN** `CNODE_API_IMAGE` 和 `CNODE_WEB_IMAGE` MUST 使用 SHA tag 或 digest
 - **AND** 拉取命令 MUST 使用 `docker compose -f deployment/docker-compose.yml pull`
 
 #### Scenario: 启动应用服务
+
 - **WHEN** 已发布镜像完成拉取
 - **THEN** 启动命令 MUST 使用 `docker compose -f deployment/docker-compose.yml up -d --no-build`
 - **AND** Compose 中的应用服务 MUST NOT 包含 `build:` 配置
 
 #### Scenario: 执行 reviewed migration
+
 - **WHEN** 发布包含已审查的 PostgreSQL migration
 - **THEN** migration MUST 作为显式的一次性任务使用已发布 API 镜像执行
 - **AND** 普通服务启动 MUST NOT 隐式执行 migration
diff --git a/openspec/changes/simplify-deployment-documentation/specs/documentation-information-architecture/spec.md b/openspec/changes/simplify-deployment-documentation/specs/documentation-information-architecture/spec.md
index f6d7d48..51d25c7 100644
--- a/openspec/changes/simplify-deployment-documentation/specs/documentation-information-architecture/spec.md
+++ b/openspec/changes/simplify-deployment-documentation/specs/documentation-information-architecture/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 部署信息必须提供唯一长期入口
+
 仓库 SHALL 使用 `deployment/README.md` 作为唯一的日常部署入口，并按文档生命周期分离数据库开发规则、历史迁移背景和 archived change 记录。
 
 #### Scenario: 维护者查找日常部署步骤
+
 - **WHEN** 维护者从根 README 或 `deployment/` 查找部署说明
 - **THEN** 文档 MUST 引导到 `deployment/README.md`
 - **AND** 该入口 MUST 只保留镜像更新、可选 reviewed migration、启动、验证和回滚步骤
 
 #### Scenario: 维护者查找数据库与迁移知识
+
 - **WHEN** 维护者查找数据库开发规则或已完成迁移的背景
 - **THEN** 数据库开发规则 MUST 位于 `docs/database.md`
 - **AND** 已完成迁移的背景 MUST 位于 `wiki/`，不得作为日常部署步骤重复维护
 
 #### Scenario: 历史材料包含短期执行信息
+
 - **WHEN** archived change 中存在环境特定路径、连接方式、拓扑或单次运行结果
 - **THEN** 当前树中的对应内容 MUST 被删除或改写为可复用的通用工程约束
 - **AND** 清理 MUST NOT 要求重写 Git 历史
diff --git a/openspec/changes/simplify-deployment-documentation/specs/production-deployment-governance/spec.md b/openspec/changes/simplify-deployment-documentation/specs/production-deployment-governance/spec.md
index 213ba72..cfa9fd5 100644
--- a/openspec/changes/simplify-deployment-documentation/specs/production-deployment-governance/spec.md
+++ b/openspec/changes/simplify-deployment-documentation/specs/production-deployment-governance/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 版本化部署资产必须保持通用
+
 仓库中的部署资产 SHALL 使用稳定的相对路径和占位配置，不得记录环境特定路径、连接方式、基础设施拓扑、凭据位置或运行数据。
 
 #### Scenario: 引用 Compose 编排
+
 - **WHEN** 文档、规格或脚本引用版本化 Compose 编排
 - **THEN** 引用 MUST 使用 `deployment/docker-compose.yml`
 - **AND** 旧文件名 MUST 不再作为当前推荐命令出现
 
 #### Scenario: 编写部署说明
+
 - **WHEN** 维护者更新 `deployment/README.md` 或部署模板
 - **THEN** 内容 MUST 使用仓库相对路径、变量和占位值
 - **AND** 内容 MUST NOT 包含仅适用于某个运行环境的信息
 
 #### Scenario: 保留长期安全约束
+
 - **WHEN** 精简或整理部署文档
 - **THEN** 文档 MUST 保留 reviewed migration、备份、健康检查和回滚约束
 - **AND** 文档 MUST NOT 通过复制一次性检查表扩展日常入口
diff --git a/openspec/changes/simplify-deployment-documentation/specs/production-ops/spec.md b/openspec/changes/simplify-deployment-documentation/specs/production-ops/spec.md
index f6d284b..86fa64b 100644
--- a/openspec/changes/simplify-deployment-documentation/specs/production-ops/spec.md
+++ b/openspec/changes/simplify-deployment-documentation/specs/production-ops/spec.md
@@ -1,19 +1,23 @@
 ## ADDED Requirements
 
 ### Requirement: 长期运维约束不得依赖单次运行记录
+
 项目 SHALL 以可重复验证的镜像、migration、健康检查和回滚约束描述生产运维，不得将单次发布观察或环境拓扑作为长期规范。
 
 #### Scenario: 验证部署资产
+
 - **WHEN** 维护者审查 `deployment/docker-compose.yml`
 - **THEN** API、Web 和 worker MUST 引用可追溯的已发布镜像
 - **AND** 这些服务 MUST NOT 定义本地镜像构建
 
 #### Scenario: 验证发布结果
+
 - **WHEN** 新版本完成启动
 - **THEN** 维护者 MUST 验证 API health 和本次发布适用的 smoke 检查
 - **AND** 验证说明 MUST 使用变量或通用端点，不得固化环境特定地址或运行结果
 
 #### Scenario: 记录历史决策
+
 - **WHEN** archived change 需要保留生产运维决策
 - **THEN** 记录 MUST 仅保留可复用的约束、取舍和验收标准
 - **AND** 记录 MUST 删除环境特定路径、连接方式、拓扑、凭据位置和单次运行数据
diff --git a/openspec/config.yaml b/openspec/config.yaml
index 6e14ba1..a2c2864 100644
--- a/openspec/config.yaml
+++ b/openspec/config.yaml
@@ -27,9 +27,9 @@ context: |
 rules:
   proposal:
     - "Keep proposals under 800 words"
-    - "Always include a \"Non-goals\" section"
+    - 'Always include a "Non-goals" section'
     - "Always define the change scope: in-scope areas, out-of-scope areas, affected systems, and high-risk categories"
-    - "Always include a \"Documentation Impact\" section covering docs/ and wiki/ updates, deferrals, or why they are not required"
+    - 'Always include a "Documentation Impact" section covering docs/ and wiki/ updates, deferrals, or why they are not required'
     - "Reference the legacy nodeclub/egg-cnode code by path when explaining what is being replaced"
   tasks:
     - Group tasks into phases (MVP first, then feature-complete)
diff --git a/openspec/specs/admin-dashboard/spec.md b/openspec/specs/admin-dashboard/spec.md
index abb0978..3aefc4f 100644
--- a/openspec/specs/admin-dashboard/spec.md
+++ b/openspec/specs/admin-dashboard/spec.md
@@ -1,8 +1,11 @@
 # admin-dashboard Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 管理概览页
 
 系统 MUST 提供管理概览页，展示社区运营数据和待处理事项。概览页顶部 SHALL 使用分组摘要，而不是展示 8 张同权重指标卡。
@@ -66,24 +69,28 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 管理后台 MUST 展示敏感词巡检命中队列，支持管理员对话题和回复命中进行复核处理。
 
 #### Scenario: 查看巡检命中
+
 - **WHEN** 管理员访问 `/admin/moderation`
 - **THEN** 系统 MUST 展示待处理巡检命中列表
 - **AND** 每条命中 MUST 显示目标类型、目标 ID、所属话题、作者、命中词、上下文预览和扫描时间
 - **AND** 管理员 MUST 能跳转查看原始话题或回复所在话题
 
 #### Scenario: 处理话题命中
+
 - **WHEN** 管理员确认话题命中违规
 - **THEN** 系统 MUST 执行话题删除或隐藏动作
 - **AND** 将命中记录标记为已处理
 - **AND** 写入审计日志
 
 #### Scenario: 处理回复命中
+
 - **WHEN** 管理员确认回复命中违规
 - **THEN** 系统 MUST 执行回复删除动作
 - **AND** 将命中记录标记为已处理
 - **AND** 写入审计日志
 
 #### Scenario: 标记误报或忽略
+
 - **WHEN** 管理员将巡检命中标记为误报或忽略
 - **THEN** 系统 MUST 保留原内容可见
 - **AND** 将命中记录从待处理队列移除
@@ -94,15 +101,18 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 管理后台 MUST 展示巡检扫描任务状态，并允许管理员对任务进行基础控制。
 
 #### Scenario: 查看扫描任务状态
+
 - **WHEN** 管理员查看巡检任务列表
 - **THEN** 系统 MUST 展示任务状态、扫描范围、触发原因、已扫描数量、命中数量、游标、开始时间、结束时间和错误信息
 
 #### Scenario: 手动创建扫描任务
+
 - **WHEN** 管理员手动发起全量或增量扫描
 - **THEN** 系统 MUST 创建扫描任务
 - **AND** 管理员 MUST 能选择扫描话题、回复或全部内容
 
 #### Scenario: 暂停和恢复扫描任务
+
 - **WHEN** 管理员暂停或恢复扫描任务
 - **THEN** 系统 MUST 更新任务状态
 - **AND** worker MUST 按更新后的状态继续或停止扫描
@@ -162,77 +172,93 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 在前台用户页、帖子详情页和回复项中向有权限的管理人员展示就地管理动作入口，并且所有动作必须通过后端管理 API 校验权限和写入审计日志。
 
 #### Scenario: 管理员在用户页看到用户管理入口
+
 - **WHEN** admin 访问任意用户主页
 - **THEN** 页面 MUST 显示 block 或 unblock 操作入口
 - **AND** 当前用户状态 MUST 决定显示封禁或解禁动作
 
 #### Scenario: 版主或管理员在帖子页看到内容管理入口
+
 - **WHEN** admin 或 mod 访问帖子详情页
 - **THEN** 页面 MUST 显示删除帖子、置顶切换和高亮切换入口
 - **AND** 普通登录用户和匿名用户 MUST NOT 看到这些管理入口
 
 #### Scenario: 版主或管理员在回复项看到删除入口
+
 - **WHEN** admin 或 mod 查看帖子详情页中的回复列表
 - **THEN** 每条未删除回复 MUST 提供删除回复入口
 - **AND** 删除回复入口 MUST 明确表示目标是回复而不是整帖
 
 #### Scenario: 管理动作反馈和审计
+
 - **WHEN** 管理人员执行任意前台管理动作
 - **THEN** 系统 MUST 显示成功或失败反馈
 - **AND** 成功后 MUST 刷新当前页面数据
 - **AND** 后端 MUST 写入包含操作人、动作和目标对象的审计日志
 
 ### Requirement: 后台管理列表必须处理极端字段长度
+
 后台管理页面 SHALL 为表格和卡片列表中的时间、操作、标识符、标题、描述、预览、错误信息和审计目标定义可读的宽度、截断和换行策略。
 
 #### Scenario: 审计日志长目标不挤压时间和操作
+
 - **WHEN** `/admin/audit` 渲染包含超长 topic title、批量 ID 或 JSON-like target 的审计记录
 - **THEN** 时间列 MUST 保持单行可读
 - **AND** 操作人、动作、结果列 MUST 保持可辨识
 - **AND** target 内容 MUST 截断、换行或进入详情展示，不得挤压整行导致操作不可读
 
 #### Scenario: 用户管理长邮箱和长用户名
+
 - **WHEN** `/admin/users` 渲染长邮箱或长用户名
 - **THEN** 邮箱和用户名 MUST 不撑破表格容器
 - **AND** 操作按钮 MUST 保持可点击，可通过换行或固定操作列宽度实现
 
 #### Scenario: 巡检长 preview 和错误信息
+
 - **WHEN** `/admin/moderation` 渲染长 preview、长敏感词或长错误信息
 - **THEN** 内容 MUST 在卡片内换行或折叠展示
 - **AND** 不得造成页面水平溢出到 viewport 外
 
 #### Scenario: 举报、封禁和敏感词长文本
+
 - **WHEN** `/admin/reports`、`/admin/bans` 或 `/admin/keywords` 渲染长描述、长原因、长 IP/CIDR 或长敏感词
 - **THEN** 长文本 MUST 在对应卡片或表格内换行、截断或横向滚动
 - **AND** 分页和主要操作按钮 MUST 保持可见
 
 ### Requirement: 系统设置必须被业务路径消费
+
 后台系统设置 SHALL 对应真实业务读取点；页面不得让管理员保存不会生效的运营策略。
 
 #### Scenario: 注册开关生效
+
 - **WHEN** admin 在 `/admin/settings` 关闭注册
 - **THEN** `/signup` 页面 MUST 不再展示本地注册表单
 - **AND** `POST /api/v1/auth/local/signup` MUST 返回 403
 
 #### Scenario: 新用户发帖门槛生效
+
 - **WHEN** admin 配置 `new_user_min_hours` 和 `new_user_min_replies`
 - **THEN** 创建话题路径 MUST 按该配置判断新用户是否可发帖
 - **AND** 不满足条件时 MUST 返回明确错误提示
 
 #### Scenario: 未接入的设置不得显示为可保存生效
+
 - **WHEN** 某个后台设置项没有任何业务读取点
 - **THEN** 页面 MUST 隐藏该设置项或标记为未接入不可保存
 - **AND** 不得显示保存成功让管理员误以为已生效
 
 ### Requirement: 管理概览指标必须来自真实查询
+
 管理概览页 SHALL 使用真实数据库或队列查询展示待处理运营指标，不得使用硬编码占位值。
 
 #### Scenario: 待审举报数真实展示
+
 - **WHEN** 管理员访问 `/admin`
 - **THEN** 待审举报数 MUST 来自 `reports.status=pending` 的真实计数
 - **AND** 不得硬编码为 0
 
 #### Scenario: 未实现指标不展示为真实数据
+
 - **WHEN** 自动封禁用户数、趋势图或最近审计操作尚未实现真实查询
 - **THEN** 页面 MUST 隐藏对应模块或明确标记未接入
 - **AND** 不得展示硬编码、空数组伪装成真实结果
@@ -242,22 +268,26 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 管理后台导航 SHALL 按管理员运营任务组织，而不是按实现页面随意堆叠。系统设置入口 MUST 位于后台导航最后。
 
 #### Scenario: 后台导航分组顺序
+
 - **WHEN** admin 或 moderator 访问管理后台
 - **THEN** 导航分组 MUST 按总览、内容、用户、审计、系统的顺序展示可访问分组
 - **AND** 系统设置 MUST 位于系统分组内
 - **AND** 系统分组 MUST 是最后一个分组
 
 #### Scenario: 内容结构管理归入内容分组
+
 - **WHEN** admin 查看后台导航
 - **THEN** 专区管理和 Tab 管理 MUST 归入内容相关分组
 - **AND** 话题管理、巡检结果、举报队列、敏感词、专区管理和 Tab 管理 SHOULD 在同一内容运营分组中展示
 
 #### Scenario: 审计拥有独立导航入口
+
 - **WHEN** admin 查看后台导航
 - **THEN** 审计日志 MUST 位于独立审计分组或顶部审计入口下
 - **AND** 审计入口 MUST 不混在系统设置之前的无序系统杂项中
 
 #### Scenario: 顶部和移动端导航顺序一致
+
 - **WHEN** admin 在桌面或移动端访问后台
 - **THEN** 顶部导航、侧栏导航和移动端导航 SHOULD 使用一致的任务顺序
 - **AND** `/admin/zones`、`/admin/tabs`、`/admin/audit` 和 `/admin/settings` 的 active state MUST 匹配所属导航入口
@@ -267,30 +297,35 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台审计页面 SHALL 支持运营复盘、风险追踪和问责，而不是仅按时间罗列原始日志。
 
 #### Scenario: 审计中心摘要
+
 - **WHEN** admin 访问 `/admin/audit`
 - **THEN** 页面 MUST 展示当前筛选范围内的摘要指标
 - **AND** 摘要 SHOULD 至少包含高风险操作、内容删除、权限变更、账号安全和失败/异常数量
 - **AND** 摘要 MUST 基于当前筛选全集计算，不得只统计当前页数据
 
 #### Scenario: 审计事件分类和风险等级
+
 - **WHEN** 系统返回审计日志
 - **THEN** 每条日志 MUST 包含或可派生事件分类、风险等级和人类可读动作标签
 - **AND** 内容治理、用户治理、角色权限、账号安全、安全策略、举报巡检和系统设置 SHOULD 作为第一阶段分类
 - **AND** delete、reset password、role、ban 等敏感操作 MUST 具备高风险或极高风险视觉提示
 
 #### Scenario: 审计筛选
+
 - **WHEN** admin 在 `/admin/audit` 筛选审计事件
 - **THEN** 系统 MUST 支持按时间范围、事件分类、风险等级、操作人、目标类型、结果和关键词筛选
 - **AND** 筛选状态 MUST 体现在 URL 参数中
 - **AND** 分页、刷新和返回页面时 MUST 保留筛选上下文
 
 #### Scenario: 审计事件流展示
+
 - **WHEN** admin 查看审计事件列表
 - **THEN** 页面 MUST 使用事件流或等价卡片化列表展示审计记录
 - **AND** 每条事件 MUST 展示风险 badge、人类可读动作标题、操作人、时间、分类、目标和结果
 - **AND** 页面 MUST 不要求管理员直接理解原始 action 字符串才能判断事件含义
 
 #### Scenario: 审计详情展开
+
 - **WHEN** admin 展开某条审计事件
 - **THEN** 页面 MUST 展示原始 action、operator_id、operator_name、target_type、target_id、target_name、result、create_at 和 detail
 - **AND** detail 为 JSON 时 SHOULD 格式化展示
@@ -298,6 +333,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 系统 MUST 避免展示 secrets、token、明文密码或生产环境变量
 
 #### Scenario: 审计目标跳转
+
 - **WHEN** 审计事件目标可映射到现有后台或前台资源
 - **THEN** 页面 SHOULD 提供目标跳转入口
 - **AND** user 目标 SHOULD 可跳转到用户主页或后台用户搜索
@@ -305,6 +341,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** report 或 scan_job 目标 SHOULD 可跳转到对应后台队列或巡检页面
 
 #### Scenario: 移动端审计展示
+
 - **WHEN** admin 在移动端访问 `/admin/audit`
 - **THEN** 页面 MUST 使用适合窄屏的卡片或事件流布局
 - **AND** 页面 MUST NOT 依赖横向滚动表格作为主要审计体验
@@ -314,27 +351,32 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台话题管理 SHALL 允许管理员和版主按话题属性、状态、时间维度和排序方式查询话题，并且筛选结果 MUST 使用后端分页查询生成。
 
 #### Scenario: 按 tab 筛选话题
+
 - **WHEN** 管理员或版主在 `/admin/topics` 选择某个 tab
 - **THEN** 页面 MUST 只展示该 tab 下的话题
 - **AND** 分页 MUST 保留当前 tab 筛选条件
 
 #### Scenario: 按内容状态和运营标记筛选话题
+
 - **WHEN** 管理员或版主选择可见状态或运营标记筛选条件
 - **THEN** 系统 MUST 按正常、已隐藏、已删除、置顶、精华、锁定或归档等条件返回匹配话题
 - **AND** 后端 MUST 忽略非法枚举值或返回明确错误，不得拼接未校验的 SQL 片段
 
 #### Scenario: 按时间维度筛选话题
+
 - **WHEN** 管理员或版主选择创建时间、更新时间或最后回复时间并提交时间范围
 - **THEN** 系统 MUST 按所选时间字段过滤话题
 - **AND** 起止时间同时存在时 MUST 返回落在闭区间内的话题
 - **AND** 只提供起始或结束时间时 MUST 支持单边范围过滤
 
 #### Scenario: 按运营指标排序话题
+
 - **WHEN** 管理员或版主选择回复数、浏览数、收藏数、创建时间、更新时间或最后回复时间排序
 - **THEN** 系统 MUST 按所选排序返回分页结果
 - **AND** 未选择排序时 MUST 保持后台话题列表的默认稳定排序
 
 #### Scenario: 批量操作后保留筛选上下文
+
 - **WHEN** 管理员或版主在筛选后的话题列表执行批量置顶、加精、隐藏、软删除或真实删除后
 - **THEN** 页面 MUST 刷新当前筛选结果
 - **AND** URL 中的筛选、排序和分页参数 MUST 不丢失
@@ -344,16 +386,19 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台巡检结果页 SHALL 以巡检任务作为命中记录的组织入口，允许管理员查看指定任务产生的待处理命中并执行任务级批量处理。
 
 #### Scenario: 从任务查看巡检命中
+
 - **WHEN** 管理员在巡检任务列表点击查看某个任务的命中
 - **THEN** 系统 MUST 展示 `scan_job_id` 等于该任务 ID 的巡检命中列表
 - **AND** 列表 MUST 保留现有命中对象、命中词、预览、作者和扫描时间信息
 
 #### Scenario: 任务级批量确认删除入口
+
 - **WHEN** 管理员查看含有待处理命中的巡检任务
 - **THEN** 页面 MUST 提供批量确认删除该任务待处理命中的入口
 - **AND** 入口文案 MUST 明确说明将删除原始话题或回复，而不是仅清除巡检记录
 
 #### Scenario: 任务级批量确认删除需要二次确认
+
 - **WHEN** 管理员触发任务级批量确认删除
 - **THEN** 页面 MUST 展示二次确认对话框
 - **AND** 对话框 MUST 显示任务 ID 和预计处理的待处理命中数量
@@ -364,11 +409,13 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台内容治理行为变更 SHALL 同步到对应 `docs/` 和 `wiki/` 文档，避免管理员误解软删除、巡检确认删除和真实删除的差异。
 
 #### Scenario: 巡检治理文档同步
+
 - **WHEN** 巡检结果按任务查看和任务级批量确认删除实现完成
 - **THEN** `docs/content-moderation.md` MUST 说明按任务查看巡检命中和任务级批量确认删除流程
 - **AND** 文档 MUST 明确任务级批量确认删除会删除原始话题或回复，但仍沿用软删除生命周期
 
 #### Scenario: 真实删除业务规则同步
+
 - **WHEN** 后台话题真实删除实现完成
 - **THEN** `wiki/business-rules.md` MUST 记录真实删除是 admin-only 独立危险操作
 - **AND** wiki MUST 区分现有软删除、巡检确认删除和数据库物理删除
@@ -378,18 +425,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台封禁管理页 SHALL 按 `mute` 和 `block` 的业务语义展示用户治理状态。`mute` MUST 表达为禁言或解除禁言，`block` MUST 表达为屏蔽用户内容或恢复内容可见，页面 MUST NOT 将 `is_block` 用户单独展示为禁言用户。
 
 #### Scenario: 查看封禁管理用户治理状态
+
 - **WHEN** admin 访问 `/admin/bans` 的用户治理区域
 - **THEN** 页面 MUST 能识别处于 mute 状态的用户
 - **AND** 页面 MUST 能识别处于 block 状态的用户
 - **AND** 页面 MUST 使用不同文案展示禁言和内容屏蔽状态
 
 #### Scenario: 单个恢复内容可见
+
 - **WHEN** admin 在 `/admin/bans` 对 block 用户执行恢复内容可见
 - **THEN** 系统 MUST 取消目标用户的 block 状态
 - **AND** 页面 MUST 使用“恢复内容可见”或等价文案
 - **AND** 页面 MUST NOT 将该操作表达为解除禁言
 
 #### Scenario: 单个解除禁言
+
 - **WHEN** admin 在 `/admin/bans` 对 mute 用户执行解除禁言
 - **THEN** 系统 MUST 取消目标用户的 mute 状态
 - **AND** 页面 MUST 使用“解除禁言”或等价文案
@@ -400,11 +450,13 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 后台封禁管理页 SHALL 在用户治理批量操作后保留当前 tab、分页和筛选上下文，并通过局部重新加载展示操作后的状态。
 
 #### Scenario: 批量解除禁言后刷新当前上下文
+
 - **WHEN** admin 在封禁管理页批量解除禁言并成功
 - **THEN** 页面 MUST 重新加载当前 tab、分页和筛选上下文
 - **AND** 已解除禁言的用户 MUST 不再显示为禁言状态
 
 #### Scenario: 批量恢复内容可见后刷新当前上下文
+
 - **WHEN** admin 在封禁管理页批量恢复内容可见并成功
 - **THEN** 页面 MUST 重新加载当前 tab、分页和筛选上下文
 - **AND** 已恢复内容可见的用户 MUST 不再显示为内容已屏蔽状态
@@ -489,4 +541,3 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **THEN** 页面 MUST 保留当前筛选和排序条件
 - **AND** 导航到最近的有效页或展示明确空状态
 - **AND** 不得显示空表格同时保留指向无效页码的 current page 状态。
-
diff --git a/openspec/specs/admin-list-pagination/spec.md b/openspec/specs/admin-list-pagination/spec.md
index 7b74c21..d07b3f5 100644
--- a/openspec/specs/admin-list-pagination/spec.md
+++ b/openspec/specs/admin-list-pagination/spec.md
@@ -3,52 +3,65 @@
 ## Purpose
 
 定义后台管理列表的统一分页 API 契约、Web 分页控件行为、筛选参数保留规则和适用列表范围，确保管理员能稳定访问完整运营数据。
+
 ## Requirements
+
 ### Requirement: 后台列表 API 分页契约
+
 后台管理列表 API SHALL 支持页码分页，并返回列表数据和总数信息。
 
 #### Scenario: 请求第一页后台列表
+
 - **WHEN** 管理员请求支持分页的后台列表接口且未提供 `page`
 - **THEN** 系统按 `page=1` 处理
 - **AND** 响应包含 `data`、`total`、`page`、`limit`
 
 #### Scenario: 请求指定页后台列表
+
 - **WHEN** 管理员请求支持分页的后台列表接口并提供 `page=3&limit=20`
 - **THEN** 系统返回第 3 页数据
 - **AND** `limit` 为 20
 - **AND** `total` 为符合当前筛选条件的总记录数
 
 #### Scenario: 限制过大 limit
+
 - **WHEN** 管理员请求支持分页的后台列表接口并提供超过最大值的 `limit`
 - **THEN** 系统使用允许的最大 `limit`
 - **AND** 响应中的 `limit` MUST 反映实际使用值
 
 #### Scenario: 空页返回稳定结构
+
 - **WHEN** 管理员请求超出数据范围的页码
 - **THEN** 系统返回空 `data` 数组
 - **AND** 仍返回正确的 `total`、`page`、`limit`
 
 ### Requirement: 后台分页页面体验
+
 后台管理页面 SHALL 使用分页控件访问完整列表，并在翻页时保留当前筛选和搜索条件。
 
 #### Scenario: 后台表格显示分页控件
+
 - **WHEN** 管理员访问支持分页的后台管理页面且总数超过每页数量
 - **THEN** 页面显示分页控件
 - **AND** 分页控件允许访问上一页、下一页和附近页码
 
 #### Scenario: 翻页保留搜索条件
+
 - **WHEN** 管理员在带搜索条件的后台列表中切换页码
 - **THEN** 新页面 URL 保留当前搜索或筛选参数
 - **AND** 后台接口按这些条件返回对应页数据
 
 ### Requirement: 分页覆盖的后台列表
+
 系统 MUST 为承载完整管理列表的后台接口和页面提供分页，摘要型最近 N 条接口不属于此范围。
 
 #### Scenario: 完整管理列表需要分页
+
 - **WHEN** 后台页面展示话题、用户、审计日志、举报、敏感词、用户封禁或 IP 封禁的完整管理列表
 - **THEN** 对应 API 和 Web 页面 MUST 支持分页
 
 #### Scenario: 概览摘要不分页
+
 - **WHEN** 管理员访问后台概览页的统计卡片或最近 N 条摘要模块
 - **THEN** 系统可以继续返回固定数量摘要数据
 - **AND** 不要求这些摘要接口返回 `total`
diff --git a/openspec/specs/admin-tab-management/spec.md b/openspec/specs/admin-tab-management/spec.md
index d3e2ab0..9e79282 100644
--- a/openspec/specs/admin-tab-management/spec.md
+++ b/openspec/specs/admin-tab-management/spec.md
@@ -1,8 +1,11 @@
 # admin-tab-management Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: tabs 注册表
 
 系统 SHALL 新增 `tabs` 表，存储首页 tab 按钮的 key、标签、可见性、排序和访问范围。`tabs.key` SHALL 与代码支持的 `topics.tab` 字段值对应，UNIQUE 约束。tab 的存在性 SHALL 由代码/migration/bootstrap 控制，管理后台 SHALL NOT 支持运行时新增或删除 tab。
diff --git a/openspec/specs/admin-zone-management/spec.md b/openspec/specs/admin-zone-management/spec.md
index 9f817ea..99f3fd0 100644
--- a/openspec/specs/admin-zone-management/spec.md
+++ b/openspec/specs/admin-zone-management/spec.md
@@ -1,8 +1,11 @@
 # admin-zone-management Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: zones 注册表
 
 系统 SHALL 新增 `zones` 表作为专区注册表，存储专区的 slug、名称、描述、图标、可见性、排序。`zones.slug` SHALL 与专区路由 `/zone/:slug` 对应，UNIQUE 约束。
diff --git a/openspec/specs/agent-owned-ui-acceptance/spec.md b/openspec/specs/agent-owned-ui-acceptance/spec.md
index 826900a..b6cea57 100644
--- a/openspec/specs/agent-owned-ui-acceptance/spec.md
+++ b/openspec/specs/agent-owned-ui-acceptance/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义由 agent 负责实现 UI 变更时必须完成的自验收范围、路由矩阵、桌面和移动端检查、视觉一致性、运行时错误和最终汇报要求。
+
 ## Requirements
+
 ### Requirement: Agent-owned UI acceptance
 
 实现 SHALL NOT 被视为完成，直到实施 agent 完成完整产品 UI 自验收，并在不依赖用户逐项发现问题的前提下解决关键不一致。
@@ -27,6 +29,7 @@ UI audit SHALL 覆盖 public、topic、user、search、message、auth、content
 UI audit SHALL 按页面原型覆盖 375px、768px、1280px 和 1440px viewport，并 SHALL 保留约 390px 移动端与约 1280px 桌面端的代表性检查，在每类原型检查 light/dark theme。审计 MUST 覆盖默认、hover、focus、active/selected、disabled、pending、error、empty、长内容和 overlay 状态中适用于该原型的关键状态。
 
 #### Scenario: 响应式审计
+
 - **WHEN** 审计每个 route family
 - **THEN** agent 在四个标准 viewport 检查 shell、navigation、PageHeader、主要 blocks、forms、Table/Item、Markdown 和主要 actions
 - **AND** 约 390px 移动端和约 1280px 桌面端代表性检查 MUST 保持覆盖
@@ -37,6 +40,7 @@ UI audit SHALL 按页面原型覆盖 375px、768px、1280px 和 1440px viewport
 Audit SHALL 验证 Base Nova primitive 完整性、semantic theme 与品牌 token 使用、Header/Footer/Layout 一致性、命名页面原型、Card/Field/Item/Table composition、card/line/shadow 层级、spacing/size scale、hover/active/focus 状态、responsive behavior、有意义的 sidebars 和 Markdown Typeset；视觉通过不得只依据页面能够加载。
 
 #### Scenario: 模板一致性检查
+
 - **WHEN** route 被审计
 - **THEN** agent 确认它映射到正确页面原型并只使用允许的 application blocks
 - **AND** route 与 Header shell 或命名 reading shell 对齐，并保持 Header、Footer、Layout、sidebars 和交互状态一致
@@ -66,11 +70,13 @@ Audit SHALL 验证 console errors、可检测的坏图、可聚焦控件、icon-
 代表性页面原型 SHALL 提供可重复的 light/dark viewport 截图或等价视觉回归证据，并 MUST 将动态时间、随机内容和动画稳定化后再比较。
 
 #### Scenario: 设计系统变更进入完成验收
+
 - **WHEN** primitive、theme、application block、layout 或 Typeset 发生变更
 - **THEN** 验收生成受影响页面原型的标准 viewport 视觉证据
 - **AND** baseline 更新 MUST 由明确设计决策解释，不得以批量接受截图掩盖漂移。
 
 #### Scenario: 行为测试与视觉测试分工
+
 - **WHEN** UI 既包含交互状态又包含视觉 composition
 - **THEN** Vitest/DOM 测试验证语义、状态与交互结果，浏览器验收验证布局、主题、响应式和像素级回归
 - **AND** 任一层失败均不得将 change 标记为完成。
diff --git a/openspec/specs/anti-spam/spec.md b/openspec/specs/anti-spam/spec.md
index 9826187..e1c9139 100644
--- a/openspec/specs/anti-spam/spec.md
+++ b/openspec/specs/anti-spam/spec.md
@@ -1,8 +1,11 @@
 # anti-spam Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 新用户发帖限制
 
 系统 MUST 限制新用户发帖,需满足条件后方可发帖,降低垃圾内容风险。
@@ -110,88 +113,106 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 记录管理员操作、系统巡检动作和关键用户行为，可查询追溯。
 
 #### Scenario: 审计日志记录
+
 - **WHEN** 管理员执行操作 (禁言/解禁/删除/置顶/加精/锁定/重置密码/巡检确认删除/巡检误报/巡检忽略/处理举报)
 - **OR** 用户举报/被举报
 - **OR** 系统创建巡检扫描任务、完成巡检扫描任务或自动隐藏内容
 - **THEN** 记录: 时间、操作人或系统标识、动作、目标、结果
 
 #### Scenario: 巡检处理审计
+
 - **WHEN** 管理员处理巡检命中
 - **THEN** 审计日志 MUST 记录命中 ID、目标类型、目标 ID、处理动作和处理结果
 - **AND** 对回复命中 MUST 记录所属话题 ID
 
 #### Scenario: 审计日志查询
+
 - **WHEN** 管理员访问审计日志面板
 - **THEN** 可按操作人/目标/时间范围/动作类型筛选
 - **AND** 日志至少保留 90 天
 
 ### Requirement: 举报功能必须形成前后台闭环
+
 系统 SHALL 支持用户从公开内容页提交话题或回复举报，并在后台举报队列中展示可处理的目标摘要。
 
 #### Scenario: 用户举报话题
+
 - **WHEN** 登录用户在话题详情页举报当前话题
 - **THEN** 系统 MUST 创建 `target_type=topic`、`target_id=<topic id>` 的举报记录
 - **AND** 后台举报队列 MUST 展示目标话题标题、目标链接、举报类型、举报说明和举报人数量
 
 #### Scenario: 用户举报回复
+
 - **WHEN** 登录用户在回复项上举报该回复
 - **THEN** 系统 MUST 创建 `target_type=reply`、`target_id=<reply id>` 的举报记录
 - **AND** 后台举报队列 MUST 展示所属话题链接和回复目标摘要
 
 #### Scenario: 后台处理举报
+
 - **WHEN** 管理员或版主在 `/admin/reports` 确认或驳回举报
 - **THEN** 系统 MUST 更新举报状态
 - **AND** 后台列表 MUST 不出现空标题、`/topic/undefined` 链接或永远为 `0 人举报` 的错误字段
 - **AND** 系统 MUST 写入审计日志
 
 ### Requirement: IP 封禁必须支持 UI 操作和 CIDR 匹配
+
 系统 SHALL 允许管理员在后台新增和移除 IP 封禁规则，并在请求处理中支持单 IP 与 CIDR 网段匹配。
 
 #### Scenario: 管理员新增单 IP 封禁
+
 - **WHEN** admin 在 `/admin/bans` 添加单个 IP
 - **THEN** 系统 MUST 保存规则
 - **AND** 来自该 IP 的后续请求 MUST 返回 403
 
 #### Scenario: 管理员新增 CIDR 封禁
+
 - **WHEN** admin 在 `/admin/bans` 添加合法 CIDR 网段
 - **THEN** 系统 MUST 保存规则
 - **AND** 来自该网段内 IP 的后续请求 MUST 返回 403
 
 #### Scenario: 管理员移除 IP 封禁
+
 - **WHEN** admin 在 `/admin/bans` 移除某条 IP 或 CIDR 规则
 - **THEN** 系统 MUST 删除该规则
 - **AND** 后续请求 MUST 不再因该规则被拒绝
 
 #### Scenario: 拒绝无效 IP 规则
+
 - **WHEN** admin 提交无效 IP 或 CIDR 字符串
 - **THEN** 系统 MUST 返回错误
 - **AND** 不得保存无效封禁规则
 
 ### Requirement: 反垃圾承诺必须完整落地
+
 系统 SHALL 在本变更中实现已承诺的核心反垃圾能力，包括新用户发帖限制、Turnstile、人为举报自动隐藏和渐进封禁。
 
 #### Scenario: 新用户发帖限制落地
+
 - **WHEN** 当前 spec 声明新用户发帖限制为 MUST
 - **THEN** 创建话题路径 MUST 按配置的注册时长和回复数阈值进行限制
 - **AND** 未满足条件的新用户 MUST 无法发帖
 
 #### Scenario: 注册和找回密码触发 Turnstile
+
 - **WHEN** 用户提交注册或密码找回表单
 - **THEN** 页面 MUST 要求通过 Cloudflare Turnstile
 - **AND** 后端 MUST 调用 Turnstile siteverify 校验 token
 - **AND** 校验失败时 MUST 拒绝请求且不创建用户、不生成 retrieve key
 
 #### Scenario: 风险发帖或高频写入触发 Turnstile
+
 - **WHEN** 新用户发帖或用户短时间连续发帖/回复达到风险阈值
 - **THEN** 系统 MUST 要求 Turnstile token
 - **AND** 后端校验失败时 MUST 拒绝写入
 
 #### Scenario: 举报阈值自动隐藏
+
 - **WHEN** 同一话题或回复被达到配置阈值的不同用户举报
 - **THEN** 系统 MUST 自动隐藏目标内容或将其从公共入口移除
 - **AND** 系统 MUST 写入审计日志并保留后台复核入口
 
 #### Scenario: 渐进封禁
+
 - **WHEN** 用户的举报确认或巡检确认违规次数达到配置阈值
 - **THEN** 系统 MUST 按警告、临时禁言、永久 block/mute 的顺序执行渐进处罚
 - **AND** 临时禁言到期后 MUST 自动恢复新增内容能力，除非用户仍处于更高等级限制
diff --git a/openspec/specs/api-contract/spec.md b/openspec/specs/api-contract/spec.md
index 3ddfc29..def10d0 100644
--- a/openspec/specs/api-contract/spec.md
+++ b/openspec/specs/api-contract/spec.md
@@ -1,8 +1,11 @@
 # api-contract Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: API 响应格式对齐
 
 API 端点 `/api/v1/*` 的核心响应结构 MUST 与 `../nodeclub/api_router_v1.js` 保持兼容。CNode Next MAY 为用户详情增加文档化的 additive 公开资料字段，但 MUST NOT 扩充被话题、回复和消息复用的轻量 `author` 摘要。
@@ -131,45 +134,54 @@ API 端点返回 topic、reply、message 中的 content 时，SHALL 按 nodeclub
 `/api/v1/*` 中面向公开客户端的话题列表、用户聚合和收藏查询 SHALL 排除不可公开话题。不可公开话题包括 `deleted=true`、`status='deleted'`、`tab` 为 `dev` 或 `test`、以及作者处于 block 状态的话题。mute 状态只限制写入，不影响已有内容公开可见性。
 
 #### Scenario: 获取公开话题列表排除内部和受限内容
+
 - **WHEN** 调用 `GET /api/v1/topics?page=1&limit=20&tab=all`
 - **THEN** 返回的话题 MUST 不包含 `tab=dev` 或 `tab=test` 的话题
 - **AND** MUST 不包含已删除话题
 - **AND** MUST 不包含作者已被 block 的话题
 
 #### Scenario: 获取公开话题列表按指定 tab 查询
+
 - **WHEN** 调用 `GET /api/v1/topics?tab=share` 或其他公开 tab
 - **THEN** 返回的话题 MUST 仍然排除已删除话题和作者已被 block 的话题
 - **AND** 当请求 `tab=dev` 或 `tab=test` 时，公共 API MUST 返回空列表或权限错误，而不是公开内部内容
 
 #### Scenario: 收藏 API 排除不可公开话题
+
 - **WHEN** 调用 `GET /api/v1/topic_collect/:loginname`
 - **THEN** 返回的话题 MUST 不包含已删除、内部 tab 或作者已被 block 的话题
 
 #### Scenario: 用户聚合 API 排除不可公开话题
+
 - **WHEN** 调用 `GET /api/v1/user/:loginname`
 - **THEN** `recent_topics` 和 `recent_replies` MUST 只包含公开可见话题
 - **AND** 回复聚合 MUST 排除所属话题不可公开的回复记录
 
 #### Scenario: mute 用户内容仍按普通公开规则展示
+
 - **WHEN** 某用户仅处于 mute 状态且未处于 block 状态
 - **THEN** 该用户已有话题 MUST 按 tab、deleted 和 status 等普通公开规则决定是否展示
 - **AND** 公共 API MUST NOT 仅因 mute 状态隐藏其已有话题
 
 ### Requirement: 搜索接口必须与页面声明和前端 DTO 对齐
+
 搜索 API SHALL 返回前端列表组件可消费的稳定 DTO，并且查询范围必须与搜索页文案一致。
 
 #### Scenario: 搜索标题和内容
+
 - **WHEN** 搜索页声明可搜索话题标题和内容
 - **THEN** `/api/v1/search?engine=local&q=<keyword>` MUST 查询公开可见话题的标题和内容
 - **AND** 已删除、内部 tab 或 block 作者内容 MUST 不出现在搜索结果中
 
 #### Scenario: 搜索返回 TopicDTO 兼容字段
+
 - **WHEN** 前端调用 local search API
 - **THEN** 返回的每条结果 MUST 包含 `id`、`title`、`tab`、`reply_count`、`visit_count`、`last_reply_at` 和 `author`
 - **AND** `author` MUST 包含 `loginname` 和 `avatar_url`
 - **AND** 前端不得依赖数据库 raw column 名称渲染搜索结果
 
 #### Scenario: 不支持内容搜索时文案必须降级
+
 - **WHEN** 系统暂不支持内容搜索
 - **THEN** 搜索页文案 MUST 明确只搜索标题
 - **AND** spec 不得声明内容搜索已完成
@@ -179,23 +191,27 @@ API 端点返回 topic、reply、message 中的 content 时，SHALL 按 nodeclub
 项目 SHALL 提供 OpenAPI Specification (OAS) 文档作为外部 API reference 和未来 smoke/contract 验证的机器可读来源。OAS 文档 MUST 由 `apps/api` 路由内的 zod-openapi 声明自动生成，不得手写维护。
 
 #### Scenario: OAS 文件存在
+
 - **WHEN** 外部开发者或验证脚本查找 API 契约
 - **THEN** 仓库 MUST 提供由 `apps/api` 路由 zod-openapi 声明生成的 `api/openapi.json` 文件
 - **AND** README 或 API reference MUST 链接到该 OAS 文件
 - **AND** 项目 MUST NOT 保留手写的 `api/openapi.yaml` 或任何与路由声明脱节的手写 OAS 文件
 
 #### Scenario: OAS 从路由自动生成
+
 - **WHEN** 开发者修改 `apps/api/src/routes/*.ts` 中某个端点的 path、method、zod schema 或 OpenAPI metadata
 - **THEN** 运行 `pnpm gen:openapi` MUST 重新生成 `api/openapi.json` 反映该变更
 - **AND** `pnpm verify` 流程 MUST 在 `verify:openapi` 之前自动执行 `gen:openapi`
 - **AND** 生成的 `api/openapi.json` MUST 不包含 `x-contract-response-fields` 扩展——响应 schema 由完整 zod 定义描述
 
 #### Scenario: OAS 可被工具读取
+
 - **WHEN** 验证脚本或 OpenAPI 工具读取 OAS 文件
 - **THEN** OAS MUST 定义 `openapi` 版本、`info`、`servers`、`paths`、`components.schemas` 和认证方案
 - **AND** OAS MUST 不包含生产 secret、真实用户 token 或私有环境变量
 
 #### Scenario: OAS 覆盖全部路由端点
+
 - **WHEN** `apps/api/src/routes/*.ts` 中的任一路由文件新增端点
 - **THEN** 生成的 `api/openapi.json` MUST 包含该端点
 - **AND** 项目 MUST NOT 保留未在 OAS 中声明的 `/api/v1/*` 端点（除 `/health` 等内部端点外）
diff --git a/openspec/specs/api-test-infrastructure/spec.md b/openspec/specs/api-test-infrastructure/spec.md
index 9403d75..14bc837 100644
--- a/openspec/specs/api-test-infrastructure/spec.md
+++ b/openspec/specs/api-test-infrastructure/spec.md
@@ -11,11 +11,13 @@ Define the API test infrastructure expectations for automatic Vitest discovery,
 `apps/api` SHALL 使用 Vitest 运行测试，并自动发现测试文件，避免新增测试因脚本手动枚举而漏跑。
 
 #### Scenario: 新测试文件被自动执行
+
 - **WHEN** 开发者在 `apps/api/test/` 新增匹配测试命名约定的测试文件
 - **THEN** `pnpm --filter @cnode/api test` MUST 自动执行该文件
 - **AND** 不需要手动把文件路径加入 `package.json` test 脚本
 
 #### Scenario: 现有测试迁移后继续运行
+
 - **WHEN** 迁移完成后运行 `pnpm --filter @cnode/api test`
 - **THEN** 现有 API 单元测试 MUST 在 Vitest 下通过
 - **AND** `pnpm test` 和 `pnpm verify` MUST 继续包含 API 测试
@@ -25,11 +27,13 @@ Define the API test infrastructure expectations for automatic Vitest discovery,
 `apps/api` 测试 SHALL 不连接任何真实 PostgreSQL 实例。测试也 MUST NOT 引入 SQLite、PGlite、内存 SQL 数据库或 Drizzle 方言 fallback。
 
 #### Scenario: 测试运行不要求数据库环境变量
+
 - **WHEN** 开发者未配置 `POSTGRES_HOST`、`POSTGRES_USER`、`POSTGRES_PASSWORD` 或 `POSTGRES_DB` 时运行 API 测试
 - **THEN** 测试 MUST 能运行不依赖数据库的用例
 - **AND** 测试基础设施 MUST NOT 为通过测试而提供 SQLite 或其他数据库 fallback
 
 #### Scenario: Route 测试使用 fake 边界
+
 - **WHEN** API route 测试需要覆盖依赖数据库的分支
 - **THEN** 测试 MUST 使用可注入依赖、mock service 或 fake query layer
 - **AND** 测试 MUST 明确只验证 route 行为和服务编排，不声称验证 PostgreSQL 查询语义
@@ -39,11 +43,13 @@ Define the API test infrastructure expectations for automatic Vitest discovery,
 测试基础设施变更 SHALL 更新长期维护文档，使开发者知道如何新增 API 测试以及数据库边界。
 
 #### Scenario: 文档说明测试运行器
+
 - **WHEN** Vitest 测试基础设施实现完成
 - **THEN** `docs/conventions.md` MUST 说明 `apps/api` 使用 Vitest 和自动测试发现
 - **AND** 文档 MUST 删除或替换手动枚举 API 测试文件的旧约定
 
 #### Scenario: 文档说明无真实数据库约束
+
 - **WHEN** 文档描述 API 测试分层
 - **THEN** 文档 MUST 明确 API 测试不连接真实 PostgreSQL 测试库
 - **AND** 文档 MUST 明确不得使用 SQLite 或方言 fallback 作为 release path
diff --git a/openspec/specs/at-mention/spec.md b/openspec/specs/at-mention/spec.md
index f5aebe6..d6b1b90 100644
--- a/openspec/specs/at-mention/spec.md
+++ b/openspec/specs/at-mention/spec.md
@@ -1,8 +1,11 @@
 # at-mention Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: @提及解析
 
 @提及解析和消息发送 MUST 与 nodeclub `common/at.js` 的行为对齐。系统 MUST 从文本中提取 @username,将它们链接化,并向被提及的用户发送通知消息。
@@ -41,4 +44,3 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 对每个被提及的用户发 type='at' 消息
 - **AND** 排除原作者 (防止 @帖主 时重复)
 - **AND** 如果用户设置了 receive_at_mail,发邮件通知
-
diff --git a/openspec/specs/auth/spec.md b/openspec/specs/auth/spec.md
index 42c02cf..fcc1f90 100644
--- a/openspec/specs/auth/spec.md
+++ b/openspec/specs/auth/spec.md
@@ -1,8 +1,11 @@
 # auth Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 本地账号注册流程
 
 系统 MUST 支持本地账号注册,包括密码 hash、激活邮件和密码找回流程。密码 hash MUST 使用 bcryptjs (cost=10),以兼容 nodeclub 迁移过来的老 hash。
@@ -254,62 +257,75 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 旧 token 不再可用于 API 认证
 
 ### Requirement: 邮件用户入口必须使用 Web 域名
+
 系统 SHALL 对需要用户点击并进入页面的账号邮件使用 Web 域名生成链接，API 域名只作为前端提交校验请求的服务端入口。
 
 #### Scenario: 密码找回邮件链接
+
 - **WHEN** 用户通过 `/api/v1/auth/local/search_pass` 发起密码找回
 - **THEN** 系统 MUST 持久化 `retrieve_key` 和 `retrieve_time`
 - **AND** 重置邮件中的链接 MUST 指向 `${CNODE_WEB_BASE_URL}/reset_pass?key=<retrieve_key>`
 - **AND** 链接 MUST NOT 指向 `${CNODE_API_BASE_URL}/reset_pass`
 
 #### Scenario: 账号激活邮件链接
+
 - **WHEN** 用户提交本地账号注册并需要激活邮箱
 - **THEN** 系统 MUST 持久化激活用 `retrieve_key` 和 `retrieve_time`
 - **AND** 激活邮件中的链接 MUST 指向 `${CNODE_WEB_BASE_URL}/active_account?key=<retrieve_key>`
 - **AND** Web 页面 MUST 调用 API 完成激活状态写入
 
 ### Requirement: 登录页必须提供找回密码入口
+
 本地账号登录页 SHALL 提供可发现的密码找回入口，连接到现有密码找回流程。
 
 #### Scenario: 登录页展示找回密码链接
+
 - **WHEN** 用户访问 `/signin`
 - **THEN** 页面 MUST 显示“忘记密码”或等价文案入口
 - **AND** 入口 MUST 跳转到 `/search_pass`
 
 #### Scenario: 找回密码入口不影响 GitHub 登录
+
 - **WHEN** 用户访问 `/signin`
 - **THEN** 页面 MUST 同时保留 GitHub 登录入口
 - **AND** 找回密码入口 MUST 只服务本地邮箱账号密码流程
 
 ### Requirement: GitHub OAuth state 必须校验
+
 系统 SHALL 在 GitHub OAuth 发起和回调之间持久化并校验 `state`，避免 callback 被伪造或串用。
 
 #### Scenario: state 校验通过
+
 - **WHEN** 用户从 `/auth/github` 发起 GitHub OAuth 并带着原始 `state` 返回 callback
 - **THEN** 系统 MUST 校验 `state` 与发起时保存的值一致
 - **AND** 校验通过后才交换 GitHub access token
 
 #### Scenario: state 缺失或不匹配
+
 - **WHEN** GitHub callback 缺少 `state` 或 `state` 与发起时保存的值不一致
 - **THEN** 系统 MUST 拒绝继续登录或绑定
 - **AND** 不得创建用户、绑定 GitHub 或设置 session cookie
 
 ### Requirement: 已登录用户可绑定 GitHub 到当前账号
+
 系统 SHALL 支持已登录用户从设置页发起 GitHub 绑定，并将授权得到的 GitHub identity 绑定到当前 session 用户。
 
 #### Scenario: 设置页展示 GitHub 绑定状态
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 展示当前账号是否已绑定 GitHub
 - **AND** 已绑定时 MUST 显示 GitHub 用户名或等价标识
 - **AND** 未绑定时 MUST 提供“绑定 GitHub”入口
 
 #### Scenario: 当前用户绑定 GitHub
+
 - **WHEN** 已登录用户从设置页发起 GitHub 绑定并完成 OAuth callback
 - **THEN** 系统 MUST 将 GitHub id、GitHub 用户名、GitHub access token 和头像信息写入当前 session 用户
 - **AND** MUST NOT 要求用户在 `/auth/github/new` 再次输入已有账号密码
 - **AND** 绑定成功后 MUST 返回设置页并显示成功反馈
 
 #### Scenario: GitHub 已绑定到其他账号
+
 - **WHEN** 当前用户尝试绑定的 GitHub id 已属于另一个 CNode 用户
 - **THEN** 系统 MUST 拒绝绑定
 - **AND** 当前用户原有账号状态 MUST 保持不变
diff --git a/openspec/specs/brand-identity/spec.md b/openspec/specs/brand-identity/spec.md
index 4a975ff..40fb2b4 100644
--- a/openspec/specs/brand-identity/spec.md
+++ b/openspec/specs/brand-identity/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义 CNode Web UI 的品牌锚点、官方 logo 使用、品牌绿色 token、surface 层级和交互状态要求，确保主站、后台和系统状态页面保持一致视觉身份。
+
 ## Requirements
+
 ### Requirement: 官方 CNode 品牌锚点
 
 Web UI SHALL 在主站、后台、footer、empty/error 等场景使用官方 CNode logo 与品牌绿 `#80bd01` 作为主要品牌锚点。
diff --git a/openspec/specs/comment-reply-experience/spec.md b/openspec/specs/comment-reply-experience/spec.md
index 4a74cac..5da487b 100644
--- a/openspec/specs/comment-reply-experience/spec.md
+++ b/openspec/specs/comment-reply-experience/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义话题详情页评论/回复体验的展示、引用、交互和可用性要求，确保评论流保持论坛式线性阅读、回复目标清晰、控件行为真实可用。
+
 ## Requirements
+
 ### Requirement: 评论头像归一化
 
 评论作者 SHALL 使用可工作的 avatar URL 或确定性的品牌 fallback，数据通过 API/data shaping 的统一 `avatar_url` 字段提供。
@@ -120,16 +122,19 @@
 系统 MUST 在回复项上为 admin 和 mod 提供删除回复入口，入口必须符合现有线性评论流体验，并且不得误导为删除整帖。
 
 #### Scenario: 回复项显示删除回复入口
+
 - **WHEN** admin 或 mod 查看帖子详情页回复列表
 - **THEN** 每条未删除回复 MUST 显示删除回复操作
 - **AND** 操作文案 MUST 明确目标为回复
 
 #### Scenario: 删除回复后刷新评论流
+
 - **WHEN** admin 或 mod 成功删除回复
 - **THEN** 页面 MUST 刷新评论流或移除该回复
 - **AND** 评论楼层或 anchor 展示不得出现坏链接或死控件
 
 #### Scenario: 普通用户不看到管理删除入口
+
 - **WHEN** 普通登录用户或匿名用户查看回复列表
 - **THEN** 页面 MUST NOT 显示管理删除回复入口
 
diff --git a/openspec/specs/compose-migration-operations/spec.md b/openspec/specs/compose-migration-operations/spec.md
index cae8ddb..0aec428 100644
--- a/openspec/specs/compose-migration-operations/spec.md
+++ b/openspec/specs/compose-migration-operations/spec.md
@@ -1,45 +1,59 @@
 # compose-migration-operations Specification
 
 ## Purpose
+
 TBD - created by archiving change staged-mongo-pg-cutover-runbook. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Schema initialization SHALL run inside compose network
+
 Database schema initialization for PostgreSQL MUST be executed from within the docker-compose network context.
 
 #### Scenario: Create tables in pre-cutover environment
+
 - **WHEN** operators initialize schema for migration rehearsal or cutover day
 - **THEN** they MUST run schema commands via compose-managed containers instead of direct database access
 
 #### Scenario: Environment consistency
+
 - **WHEN** schema commands are executed
 - **THEN** the command environment MUST resolve service names (for example postgres and redis) exactly as defined in compose
 
 #### Scenario: Local orchestration with compose target
+
 - **WHEN** operators start migration from a local machine for rehearsal
 - **THEN** compose tasks MUST still target the intended rehearsal PostgreSQL instance and MUST NOT require exposing production databases to public networks
 
 ### Requirement: Full migration runs SHALL be repeatable
+
 The migration workflow MUST support repeated full reruns that deterministically refresh target PostgreSQL data from MongoDB.
 
 #### Scenario: Daily rehearsal rerun
+
 - **WHEN** the team runs daily full migration during parallel validation
 - **THEN** the workflow MUST complete without manual table recreation steps
 
 #### Scenario: Final cutover rerun
+
 - **WHEN** cutover-day full migration is executed after write freeze
 - **THEN** the workflow MUST produce the same mapping rules and table semantics used in rehearsal runs
 
 #### Scenario: Source and target boundary
+
 - **WHEN** a full rerun is executed
 - **THEN** the workflow MUST read source data from legacy MongoDB and write only to designated target PostgreSQL, without cross-writing back to source
 
 ### Requirement: Reconciliation output SHALL be reviewable
+
 Each full migration run MUST produce a reviewable reconciliation result for operators.
 
 #### Scenario: Capture run evidence
+
 - **WHEN** a migration run completes
 - **THEN** operators MUST be able to review row-count comparisons and pass/fail status for required checks
 
 #### Scenario: Gate traffic switch
+
 - **WHEN** any required reconciliation check fails
 - **THEN** traffic switch MUST NOT proceed until issues are resolved and checks pass
diff --git a/openspec/specs/container-image-delivery/spec.md b/openspec/specs/container-image-delivery/spec.md
index 55c7086..ea0c369 100644
--- a/openspec/specs/container-image-delivery/spec.md
+++ b/openspec/specs/container-image-delivery/spec.md
@@ -1,25 +1,31 @@
 # container-image-delivery Specification
 
 ## Purpose
+
 定义生产容器镜像的 GitHub Actions 构建、验证门禁、GHCR 发布、不可变镜像标识、部署启动和 Web 运行时 API 配置要求。
+
 ## Requirements
+
 ### Requirement: GitHub Actions 构建并推送生产容器镜像
 
 系统 MUST 使用 GitHub Actions 在 GitHub runner 上构建 cnode-next 生产容器镜像，并推送到 GitHub Container Registry。workflow MUST 在 release verification gate 通过后才构建和推送镜像，且不得执行部署。
 
 #### Scenario: API 镜像发布到 GHCR SHA tag
+
 - **WHEN** GitHub Actions 在主分支运行容器镜像发布 workflow
 - **THEN** workflow MUST 使用 `apps/api/Dockerfile` 构建 API 镜像
 - **AND** workflow MUST 推送 `ghcr.io/cnodejs/cnode-api:sha-<commit>` 或记录等价 image digest
 - **AND** workflow MUST NOT 在 release verification gate 失败时推送镜像
 
 #### Scenario: Web 镜像发布到 GHCR SHA tag
+
 - **WHEN** GitHub Actions 在主分支运行容器镜像发布 workflow
 - **THEN** workflow MUST 使用 `apps/web/Dockerfile` 构建 Web 镜像
 - **AND** workflow MUST 推送 `ghcr.io/cnodejs/cnode-web:sha-<commit>` 或记录等价 image digest
 - **AND** workflow MUST NOT 在 release verification gate 失败时推送镜像
 
 #### Scenario: Workflow 不执行部署
+
 - **WHEN** GitHub Actions 完成镜像推送
 - **THEN** workflow MUST NOT 管理部署凭据
 - **AND** workflow MUST NOT 执行 `docker compose pull` 或 `docker compose up`
@@ -29,11 +35,13 @@
 生产 docker-compose 编排 MUST 只引用已发布镜像，部署流程 MUST 通过 `pull` 和 `up --no-build` 启动服务，不得在部署过程中构建应用镜像。
 
 #### Scenario: Compose 不包含本地构建定义
+
 - **WHEN** 运维查看 `deployment/docker-compose.yml`
 - **THEN** `api`、`web`、`worker`、`migrate-schema`、`migrate-data`、`reconcile` 服务 MUST NOT 包含 `build:` 配置
 - **AND** 这些服务 MUST 使用 `image:` 引用 GHCR 镜像
 
 #### Scenario: 手动部署拉取指定镜像
+
 - **WHEN** 运维部署新版本
 - **THEN** 运维 MUST 设置 `CNODE_API_IMAGE` 和 `CNODE_WEB_IMAGE` 指向 SHA tag 或 digest
 - **AND** 运维 MUST 执行 `docker compose -f deployment/docker-compose.yml pull api web worker`
@@ -41,6 +49,7 @@
 - **AND** 该流程 MUST NOT 执行 Docker build
 
 #### Scenario: Migration 任务使用 API 镜像
+
 - **WHEN** 运维执行 `migrate-schema`、`migrate-data` 或 `reconcile`
 - **THEN** 这些一次性任务 MUST 使用 `CNODE_API_IMAGE` 指向的 API 镜像
 - **AND** 这些任务 MUST NOT 通过 compose build migration target
@@ -50,16 +59,19 @@
 Web 镜像 MUST 不依赖构建时 API base URL。SSR 侧和浏览器侧 API 请求都 MUST 根据运行时环境变量决定 API 地址。
 
 #### Scenario: SSR 使用内部 API 地址
+
 - **WHEN** React Router loader 在 Web 容器服务端执行 API 请求
 - **THEN** 系统 MUST 优先使用 `CNODE_API_INTERNAL_BASE_URL`
 - **AND** 在生产 compose 中该值 MUST 指向 `http://api:3001`
 
 #### Scenario: 浏览器使用公开 API 地址
+
 - **WHEN** 浏览器侧交互调用 `apiFetch` 或上传客户端请求 API
 - **THEN** 系统 MUST 使用运行时 `.env` 注入到页面的 `CNODE_API_BASE_URL`
 - **AND** 浏览器侧 MUST NOT 依赖 `VITE_APP_API_BASE_URL` 或其他构建时变量决定 API base URL
 
 #### Scenario: 同一 Web 镜像可复用到不同运行环境
+
 - **WHEN** 同一个 Web 镜像在不同运行环境启动
 - **THEN** 浏览器侧 API base MUST 随该环境的 `.env` 变化
 - **AND** 不得要求为不同 API 域名重新构建 Web 镜像
diff --git a/openspec/specs/content-lifecycle/spec.md b/openspec/specs/content-lifecycle/spec.md
index 32848c5..c4c638d 100644
--- a/openspec/specs/content-lifecycle/spec.md
+++ b/openspec/specs/content-lifecycle/spec.md
@@ -1,8 +1,11 @@
 # content-lifecycle Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 话题状态
 
 系统 MUST 用 status 字段管理话题生命周期,替代单一 deleted 布尔值。
@@ -186,6 +189,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 允许 admin 和 mod 在帖子详情页执行内容删除动作，删除帖子和删除回复必须保持不同目标粒度，并且删除后公共列表与详情不再展示对应内容。
 
 #### Scenario: 版主或管理员删除帖子
+
 - **WHEN** admin 或 mod 在帖子详情页删除帖子
 - **THEN** 系统 MUST 将目标话题标记为已删除
 - **AND** 目标话题 MUST 不再出现在公开话题列表
@@ -193,6 +197,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 版主或管理员删除回复
+
 - **WHEN** admin 或 mod 在回复项上删除回复
 - **THEN** 系统 MUST 只将目标回复标记为已删除
 - **AND** 系统 MUST 维护回复作者积分、回复数和话题回复数
@@ -201,11 +206,13 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 删除动作目标粒度明确
+
 - **WHEN** 管理人员查看帖子详情页的删除按钮
 - **THEN** UI MUST 使用“删除帖子”和“删除回复”等明确文案
 - **AND** 不得用同一个模糊动作同时表示删除帖子和删除回复
 
 #### Scenario: 非管理人员不可执行前台内容删除
+
 - **WHEN** 非 admin 且非 mod 用户尝试调用前台内容管理删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标帖子或回复状态保持不变
@@ -215,25 +222,30 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 公共查询 SHALL 使用统一内容可见性规则：隐藏已删除话题、内部 tab 话题、被 block 用户创建的话题，以及所属话题不可见的回复聚合。mute 用户只受写入限制，不因 mute 自动隐藏历史内容。
 
 #### Scenario: 已删除话题不可公开
+
 - **WHEN** 话题 `deleted=true` 或 `status='deleted'`
 - **THEN** 该话题 MUST 不出现在任何公共列表、sidebar、用户聚合或收藏结果中
 - **AND** 普通用户访问详情 MUST 得到不存在或不可见响应
 
 #### Scenario: 内部 tab 话题不可公开
+
 - **WHEN** 话题 `tab=dev` 或 `tab=test`
 - **THEN** 该话题 MUST 不出现在首页 feed、最新回复、无人回复、用户话题、用户参与或用户收藏中
 
 #### Scenario: 被 block 用户创建的话题不可公开
+
 - **WHEN** 话题作者处于 block 状态
 - **THEN** 该话题 MUST 不出现在公共列表、sidebar、用户聚合或收藏结果中
 - **AND** 其他用户在该话题下的回复也 MUST 不通过最新回复或用户参与聚合曝光该话题
 
 #### Scenario: 被 mute 用户不能新增内容但历史内容不自动隐藏
+
 - **WHEN** 用户处于 mute 状态且未处于 block 状态
 - **THEN** 该用户 MUST 不能新增话题或回复
 - **AND** 该用户已有话题 MUST 不因 mute 状态被公共查询隐藏
 
 #### Scenario: 管理后台不受公共过滤影响
+
 - **WHEN** 管理员访问后台话题、用户、巡检或审计页面
 - **THEN** 系统 MAY 展示 dev/test、已删除或 block 用户内容用于运营处理
 - **AND** 这些后台入口 MUST 继续由后端权限校验保护
@@ -281,28 +293,33 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 在后台话题管理中提供 admin-only 的真实删除能力，用于从数据库中物理删除指定话题及其直接依赖数据。真实删除 MUST 与现有软删除操作分离，且不得改变普通删除按钮的软删除语义。
 
 #### Scenario: 管理员真实删除话题
+
 - **WHEN** admin 在后台话题管理中确认真实删除某个话题
 - **THEN** 系统 MUST 从数据库删除该话题记录
 - **AND** 系统 MUST 清理该话题的回复、收藏、招聘扩展、巡检命中和消息引用等直接依赖数据
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 真实删除需要明确确认
+
 - **WHEN** admin 触发真实删除入口
 - **THEN** 页面 MUST 展示二次确认
 - **AND** 文案 MUST 明确说明该操作会从数据库永久删除且不可通过系统自动恢复
 - **AND** admin 取消确认时 MUST 不删除任何数据
 
 #### Scenario: 非管理员不可真实删除话题
+
 - **WHEN** 非 admin 用户调用真实删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标话题及其依赖数据 MUST 保持不变
 
 #### Scenario: 软删除语义保持不变
+
 - **WHEN** 管理员或版主执行现有话题删除操作
 - **THEN** 系统 MUST 继续将话题标记为已删除
 - **AND** 系统 MUST NOT 因本变更把现有删除操作改为物理删除
 
 #### Scenario: 巡检确认删除不执行真实删除
+
 - **WHEN** 管理员对巡检命中执行确认删除或任务级批量确认删除
 - **THEN** 系统 MUST 沿用现有话题或回复删除生命周期
 - **AND** 系统 MUST NOT 从数据库物理删除命中的话题或回复
diff --git a/openspec/specs/content-moderation/spec.md b/openspec/specs/content-moderation/spec.md
index 2779320..e9178c0 100644
--- a/openspec/specs/content-moderation/spec.md
+++ b/openspec/specs/content-moderation/spec.md
@@ -1,8 +1,11 @@
 # content-moderation Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 关键字过滤
 
 系统 MUST 在发帖和回复提交时对标题和内容进行关键字过滤,阻止包含敏感词的内容发布。
@@ -47,6 +50,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 定期巡检已发布的内容，按低负载批处理方式检查话题和回复中的敏感词命中，并将命中内容记录到巡检队列供管理员复核。
 
 #### Scenario: 巡检任务执行
+
 - **WHEN** 定时任务触发
 - **THEN** 系统 MUST 扫描新增或更新的已发布话题和回复
 - **AND** 检测标题、话题内容和回复内容是否包含敏感词
@@ -54,18 +58,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 记录巡检任务日志，包括时间、扫描条目数、命中条目数和处理结果
 
 #### Scenario: 新增敏感词触发历史扫描
+
 - **WHEN** 管理员新增敏感词
 - **THEN** 系统 MUST 创建针对新增敏感词的历史扫描任务
 - **AND** 历史扫描任务 MUST 覆盖未删除的话题和回复
 - **AND** 新增敏感词请求 MUST 不等待历史扫描完成
 
 #### Scenario: 历史命中不默认隐藏
+
 - **WHEN** 历史扫描发现命中敏感词的话题或回复
 - **THEN** 系统 MUST 将命中记录标记为待复核
 - **AND** 系统 MUST NOT 默认删除或隐藏历史命中内容
 - **AND** 管理员确认违规后才执行删除或隐藏动作
 
 #### Scenario: 管理员可处理巡检命中
+
 - **WHEN** 管理员浏览巡检结果
 - **THEN** 系统 MUST 展示命中对象、命中敏感词、上下文预览、作者和扫描时间
 - **AND** 管理员 MUST 能够确认删除、标记误报或忽略命中
@@ -75,14 +82,17 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 为每个敏感词扫描命中保存可复核记录，覆盖话题和回复两类内容。
 
 #### Scenario: 记录话题命中
+
 - **WHEN** 扫描发现话题标题或内容命中敏感词
 - **THEN** 系统 MUST 保存命中记录，包含 `target_type=topic`、话题 ID、作者 ID、命中词、命中字段和上下文预览
 
 #### Scenario: 记录回复命中
+
 - **WHEN** 扫描发现回复内容命中敏感词
 - **THEN** 系统 MUST 保存命中记录，包含 `target_type=reply`、回复 ID、所属话题 ID、作者 ID、命中词和上下文预览
 
 #### Scenario: 避免重复命中记录
+
 - **WHEN** 同一任务或后续任务再次扫描到同一对象命中同一敏感词
 - **THEN** 系统 MUST 避免创建重复的待处理命中记录
 - **AND** 已处理为误报的命中 MUST NOT 被同一敏感词反复加入待处理队列
@@ -102,29 +112,35 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 巡检命中队列依赖扫描任务生成，系统 SHALL 提供管理员可操作的任务执行控制，避免任务因轮询间隔或误创建而长期堆积。
 
 #### Scenario: 管理员立即推进巡检队列
+
 - **WHEN** 管理员发现巡检任务处于 pending 或 paused
 - **THEN** 管理员 MUST 能触发立即执行
 - **AND** 系统 MUST 尽快开始或恢复扫描
 
 #### Scenario: 管理员取消误创建任务
+
 - **WHEN** 管理员发现巡检任务范围或触发原因错误
 - **THEN** 管理员 MUST 能取消未完成任务
 - **AND** 取消任务 MUST 不再继续产生命中记录
 
 ### Requirement: 敏感词命中次数必须真实
+
 敏感词管理页 SHALL 只展示有真实更新来源的命中次数；若展示 `hit_count`，实时过滤和历史巡检都必须更新该指标。
 
 #### Scenario: 实时过滤更新命中次数
+
 - **WHEN** 用户发帖、编辑话题、回复或编辑回复时命中敏感词并被拒绝
 - **THEN** 系统 MUST 增加对应敏感词的命中次数
 - **AND** `/admin/keywords` 展示的命中次数 MUST 反映该变化
 
 #### Scenario: 历史巡检更新命中次数
+
 - **WHEN** 巡检任务扫描历史话题或回复并发现敏感词命中
 - **THEN** 系统 MUST 增加对应敏感词的命中次数或记录等价可展示统计
 - **AND** 后台展示的命中次数 MUST 不长期保持默认值
 
 #### Scenario: 无统计实现时不展示假指标
+
 - **WHEN** 系统没有实现敏感词命中次数统计
 - **THEN** `/admin/keywords` MUST 隐藏命中次数列或明确标记为未接入
 - **AND** 不得展示永远为 0 或空值的运营指标
@@ -134,11 +150,13 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 使用巡检命中记录上的任务关联，将后台巡检结果按巡检任务过滤和展示。
 
 #### Scenario: 查询指定任务的巡检命中
+
 - **WHEN** 管理员请求查看任务 `#11` 的巡检命中
 - **THEN** 系统 MUST 返回 `scan_job_id=11` 的命中记录
 - **AND** 系统 MUST 支持继续按待处理、已确认、误报或忽略状态筛选该任务下的命中
 
 #### Scenario: 重复命中不重复入队
+
 - **WHEN** 后续巡检任务再次扫描到同一对象、同一字段和同一组敏感词
 - **THEN** 系统 MUST 继续避免创建重复待处理命中记录
 - **AND** 该限制 MUST 不阻止管理员处理首次创建的待处理命中
@@ -148,22 +166,26 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 允许管理员对某个巡检任务下的待处理命中执行批量确认删除，确认删除的目标是命中的原始话题或回复。
 
 #### Scenario: 批量确认删除话题和回复命中
+
 - **WHEN** 管理员确认删除某巡检任务下的待处理命中
 - **THEN** 系统 MUST 对话题命中执行现有话题删除动作
 - **AND** 系统 MUST 对回复命中执行现有回复删除动作
 - **AND** 系统 MUST 将对应巡检命中标记为已确认处理
 
 #### Scenario: 批量确认删除只处理待处理命中
+
 - **WHEN** 巡检任务下同时存在 pending、confirmed、false_positive 或 ignored 命中
 - **THEN** 任务级批量确认删除 MUST 只处理 pending 命中
 - **AND** 已处理命中 MUST 不重复删除内容或重复处罚作者
 
 #### Scenario: 批量确认删除写入审计日志
+
 - **WHEN** 管理员完成任务级批量确认删除
 - **THEN** 系统 MUST 写入审计日志
 - **AND** 审计详情 MUST 包含任务 ID、操作类型和实际处理数量
 
 #### Scenario: 非管理员不可执行任务级批量确认删除
+
 - **WHEN** 非 admin 用户调用任务级批量确认删除接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 话题、回复和巡检命中状态 MUST 保持不变
diff --git a/openspec/specs/database-change-safety/spec.md b/openspec/specs/database-change-safety/spec.md
index f89f145..8cf15eb 100644
--- a/openspec/specs/database-change-safety/spec.md
+++ b/openspec/specs/database-change-safety/spec.md
@@ -1,8 +1,11 @@
 # database-change-safety Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 非临时数据库只通过 Drizzle migration 发布
 
 非临时数据库的 schema 变更 SHALL 通过已生成、已 review 的 Drizzle migration 文件执行。`drizzle-kit push` SHALL 仅用于一次性本地开发库快速验证，不得作为发布路径。
diff --git a/openspec/specs/documentation-information-architecture/spec.md b/openspec/specs/documentation-information-architecture/spec.md
index b2227cd..d41aa2b 100644
--- a/openspec/specs/documentation-information-architecture/spec.md
+++ b/openspec/specs/documentation-information-architecture/spec.md
@@ -1,124 +1,153 @@
 # documentation-information-architecture Specification
 
 ## Purpose
+
 Define the public documentation information architecture for README, docs, wiki, deploy assets, and repository governance files.
+
 ## Requirements
+
 ### Requirement: 项目文档必须任务导向并适度使用图形
+
 项目文档 SHALL 以读者任务为中心组织内容；当文档包含图形时，图形 MUST 用于解释结构、流程、状态或关系，并遵循“描述 → 图形 → 简约说明”的块结构。
 
 #### Scenario: 读者查看 README
+
 - **WHEN** 读者打开 `README.md`
 - **THEN** README MUST 以简短项目介绍、核心能力、技术栈、快速开始、文档入口、贡献、安全和许可证为主
 - **AND** README MUST NOT 以“重写版本”、legacy 迁移、生产上线验收或大量 Mermaid 图作为主要内容
 
 #### Scenario: 读者查看包含图形的文档
+
 - **WHEN** 文档包含 Mermaid 图、架构图、流程图、时序图或关系图
 - **THEN** 图形前 MUST 有 1-2 句描述说明图形要解决的读者问题
 - **AND** 图形后 MUST 使用表格或短列表给出必要说明
 - **AND** 图形后说明 MUST 保持简约，不得重复图形已经表达的内容
 
 #### Scenario: 读者查看架构文档
+
 - **WHEN** 读者打开架构文档
 - **THEN** 文档 MUST 使用图形说明系统拓扑、请求流或数据边界
 - **AND** 每张图后只保留必要边界、约束和跳转链接
 
 ### Requirement: docs 目录必须简化和合并
+
 `docs/` SHALL 按读者任务保留少数稳定入口，并提供项目文档规范和开发规范；`docs/`、`wiki/` 与 `deploy/` SHALL 作为同级内容域分别承接项目任务文档、知识沉淀和生产部署域，避免 `docs/` 变成历史材料或部署资产仓库。
 
 #### Scenario: 文档规范入口
+
 - **WHEN** 贡献者需要新增或修改文档
 - **THEN** `docs/` MUST 提供 `docs/conventions.md` 或等价规范入口
 - **AND** 该规范 MUST 覆盖文档结构、图形使用、表格优先、API 文档格式、`docs/`/`wiki/`/`deploy/` 目录边界、开发规范和 secret handling 链接
 
 #### Scenario: 文档主题重复
+
 - **WHEN** 两个或多个 `docs/*.md` 描述同一部署、迁移、数据库、安全或开发主题
 - **THEN** 它们 MUST 被合并或明确拆分职责
 - **AND** 旧入口 MUST 提供跳转、被归档或被删除，避免读者看到冲突说明
 
 #### Scenario: 一次性上线材料
+
 - **WHEN** 文档描述单次发布验收材料、内部评级、部署审计结果或历史验收记录
 - **THEN** 该内容 MUST NOT 作为长期主文档入口
 - **AND** 它 MUST 被删除、移到归档位置，或只保留在实际运维审计记录中
 
 #### Scenario: 迁移和业务知识沉淀
+
 - **WHEN** 文档描述 legacy `../nodeclub/` 迁移背景、历史兼容原因、社区规则或业务逻辑分析
 - **THEN** 该内容 MUST 放入 `wiki/` 或等价知识库目录
 - **AND** `docs/` 中只保留完成开发、运行、部署或调用任务所需的简短链接
 
 ### Requirement: wiki 知识库必须有独立写作规范
+
 `wiki/` SHALL 作为与 `docs/` 同级的知识库目录，承接迁移背景、业务逻辑和社区知识沉淀，并 MUST 有独立写作规范约束来源、事实边界、推断标记和 AI agent 行为。
 
 #### Scenario: wiki 文档包含来源和范围
+
 - **WHEN** 贡献者或 AI agent 新增 `wiki/` 文档
 - **THEN** 文档 MUST 标明信息来源，例如当前代码路径、legacy `../nodeclub/` 路径、线上行为观察、OpenSpec archive 或人工确认
 - **AND** 文档 MUST 标明适用范围和最后复核时间或复核状态
 
 #### Scenario: wiki 区分事实和推断
+
 - **WHEN** `wiki/` 文档包含从代码、历史行为或讨论中推导出的结论
 - **THEN** 文档 MUST 区分已确认事实、合理推断和待确认问题
 - **AND** AI agent MUST NOT 将未验证推断写成确定事实
 
 #### Scenario: wiki 避免无依据扩写
+
 - **WHEN** AI agent 缺少源码、legacy 路径、线上观察或用户确认作为依据
 - **THEN** AI agent MUST 将内容标记为待确认或不写入 wiki
 - **AND** 文档 MUST NOT 使用空泛、不可验证或营销式描述替代可追溯事实
 
 #### Scenario: wiki 与 docs 互相引用
+
 - **WHEN** `docs/` 需要引用迁移背景或业务逻辑知识
 - **THEN** `docs/` MUST 链接到 `wiki/` 对应页面
 - **AND** `docs/` MUST NOT 复制 wiki 中的长篇历史背景
 
 #### Scenario: wiki 与 docs 同级边界
+
 - **WHEN** 贡献者判断内容应放入 `docs/` 还是 `wiki/`
 - **THEN** 任务导向内容 MUST 放入 `docs/`
 - **AND** 历史、迁移、业务逻辑、社区规则和长期知识沉淀 MUST 放入 `wiki/`
 
 #### Scenario: deploy 与 docs/wiki 同级边界
+
 - **WHEN** 贡献者判断内容应放入 `docs/`、`wiki/` 还是 `deploy/`
 - **THEN** 可执行或可同步的部署资产 MUST 放入 `deploy/`
 - **AND** 生产部署 runbook SHOULD 放入 `deploy/` 并链接 `deploy/` 中的实际资产
 - **AND** 历史部署背景或运维知识沉淀 SHOULD 放入 `wiki/`
 
 #### Scenario: 文档索引更新
+
 - **WHEN** 文档结构调整完成
 - **THEN** README MUST 列出新的文档入口
 - **AND** 每个入口 MUST 用一句话说明适用读者和用途
 
 ### Requirement: 仓库根目录必须保持简约
+
 仓库根目录 SHALL 只保留开源项目入口和工具自动发现所必需的文件；部署编排、部署模板、SQL、启动脚本和运行环境相关材料 MUST 收敛到 `deploy/` 或等价部署资产目录。
 
 #### Scenario: 根目录文件复核
+
 - **WHEN** 读者查看仓库根目录
 - **THEN** 根目录 MUST 主要包含 `README.md`、`LICENSE`、`CONTRIBUTING.md`、`SECURITY.md`、package/workspace 配置、源码目录、`docs/`、`wiki/`、`deploy/` 和 OpenSpec 目录
 - **AND** 生产部署实现细节文件 MUST NOT 直接堆放在根目录
 
 #### Scenario: 部署文件组织
+
 - **WHEN** 仓库包含生产 Docker Compose、部署 SQL、启动脚本、部署模板、部署 helper 或部署环境示例
 - **THEN** 这些文件 MUST 放在 `deploy/` 或等价部署目录中
 - **AND** README、docs、CI 和运维命令 MUST 引用新路径
 
 ### Requirement: AGENTS 必须保持执行型简洁
+
 `AGENTS.md` SHALL 只保留协作代理需要执行的项目事实、命令、目录边界和关键约束。
 
 #### Scenario: 代理读取 AGENTS
+
 - **WHEN** 代理开始在项目中工作
 - **THEN** `AGENTS.md` MUST 明确技术栈、PostgreSQL-only、legacy `../nodeclub/` 只读参考、常用命令和 OpenSpec 工作流
 - **AND** `AGENTS.md` MUST NOT 复制长篇架构、部署或 API 文档内容
 
 ### Requirement: 仓库治理文档必须齐备
+
 仓库 SHALL 提供贡献、许可证和安全入口，使外部协作者知道如何参与、如何使用代码以及如何报告安全问题。
 
 #### Scenario: 外部协作者查看贡献说明
+
 - **WHEN** 外部协作者准备提交 issue、PR 或本地验证
 - **THEN** 仓库 MUST 提供 `CONTRIBUTING.md` 或等价贡献文档
 - **AND** 文档 MUST 指向 `pnpm verify`、OpenSpec change 流程、`docs/conventions.md` 和 secret handling 规则
 
 #### Scenario: 外部读者查看许可证
+
 - **WHEN** 外部读者查看仓库根目录
 - **THEN** 仓库 MUST 提供 MIT `LICENSE`
 - **AND** README MUST 使用确定语气链接许可证，不得使用“license status”这类内部状态描述
 
 #### Scenario: 安全问题报告
+
 - **WHEN** 外部用户需要报告安全问题
 - **THEN** 仓库 MUST 提供 `SECURITY.md` 或在安全文档中提供清晰报告方式
 - **AND** 文档 MUST 提醒不要在公开 issue 中粘贴 secrets、tokens 或用户隐私数据
diff --git a/openspec/specs/explicit-migration-rehearsal-profile/spec.md b/openspec/specs/explicit-migration-rehearsal-profile/spec.md
index 670486e..561bf5b 100644
--- a/openspec/specs/explicit-migration-rehearsal-profile/spec.md
+++ b/openspec/specs/explicit-migration-rehearsal-profile/spec.md
@@ -1,35 +1,43 @@
 # explicit-migration-rehearsal-profile Specification
 
 ## Purpose
+
 定义非默认 migration rehearsal 配置的显式选择、只读来源和真实 dotenv 保护要求。
 
 ## Requirements
 
 ### Requirement: Migration rehearsal profiles SHALL be selected explicitly
+
 Migration rehearsal commands MUST require an explicit env profile for non-default PostgreSQL targets, so default development commands do not accidentally use other database credentials.
 
 #### Scenario: Operator selects a rehearsal target
+
 - **WHEN** an operator runs a DB or migration command against a non-default PostgreSQL target
 - **THEN** the command MUST require an explicit `CNODE_ENV_FILE` selection or equivalent mechanism
 - **AND** the selected profile MUST be ignored or externally supplied, not a tracked file containing real credentials
 
 #### Scenario: Default development startup
+
 - **WHEN** a developer runs `pnpm dev` without an explicit env profile
 - **THEN** Web and API MUST use the default root `.env` contract
 - **AND** they MUST NOT automatically load non-default dotenv profiles
 
 ### Requirement: Migration source access SHALL remain read-only
+
 Migration tooling SHALL read source data without modifying source systems and SHALL write only to the explicitly selected target.
 
 #### Scenario: Migration rehearsal executes
+
 - **WHEN** migration tooling reads legacy source data
 - **THEN** it MUST NOT require source writes or authentication changes
 - **AND** reconciliation evidence MUST record pass or fail without including connection details or user data
 
 ### Requirement: Real profiles SHALL remain untouched
+
 Automated implementation and validation SHALL NOT read, print, modify, overwrite, delete, or migrate real dotenv profiles.
 
 #### Scenario: Existing profiles are present
+
 - **WHEN** real dotenv profiles exist in the workspace
 - **THEN** automated steps MUST leave the files and their contents unchanged
 - **AND** tracked templates MUST contain placeholders only
diff --git a/openspec/specs/feedback-command-system/spec.md b/openspec/specs/feedback-command-system/spec.md
index 653a69a..ee7372c 100644
--- a/openspec/specs/feedback-command-system/spec.md
+++ b/openspec/specs/feedback-command-system/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义搜索/命令入口、消息通知入口、toast 反馈、loading/empty/error 状态和无效控件处理要求，确保用户操作能获得明确且一致的反馈。
+
 ## Requirements
+
 ### Requirement: Command/search palette
 
 应用 SHALL 提供具有可访问 command 语义的 command/search 入口，用于搜索或跳转到话题、用户、发布流程、消息、内容页和有权限访问的后台页面。Command palette MUST 支持键盘移动、选择、关闭和焦点恢复，并 MUST 向辅助技术表达当前输入、结果集合、活动项和空状态。
diff --git a/openspec/specs/home-sidebar-information/spec.md b/openspec/specs/home-sidebar-information/spec.md
index f316cb5..c6329e7 100644
--- a/openspec/specs/home-sidebar-information/spec.md
+++ b/openspec/specs/home-sidebar-information/spec.md
@@ -1,7 +1,9 @@
 ## Purpose
 
 定义首页 sidebar 展示的社区信息模块、服务端数据来源、外部链接安全要求，以及桌面和移动端的响应式呈现行为。
+
 ## Requirements
+
 ### Requirement: Sidebar 社区仪表盘
 
 首页 sidebar SHALL 作为社区仪表盘，包含参与入口、动态、榜单、合作伙伴和资源模块。
@@ -64,21 +66,25 @@ Sidebar SHALL 提供克制的合作品牌/赞助/广告位，并有清晰标签
 首页 sidebar 的最新回复和无人回复模块 SHALL 使用与首页公开 feed 一致的可见性规则，不能显示内部 tab、已删除内容或被 block 用户创建的话题。仅处于 mute 状态的用户内容不应因此被隐藏。
 
 #### Scenario: 最新回复排除内部话题
+
 - **WHEN** 首页 sidebar 加载最新回复
 - **THEN** 最新回复 MUST 不包含所属话题 `tab=dev` 或 `tab=test` 的回复
 - **AND** 点击最新回复不得进入内部话题详情
 
 #### Scenario: 最新回复排除受限话题
+
 - **WHEN** 最新回复属于已删除话题或作者已被 block 的话题
 - **THEN** 该回复 MUST 不出现在最新回复模块
 
 #### Scenario: 无人回复排除内部和受限话题
+
 - **WHEN** 首页 sidebar 加载无人回复话题
 - **THEN** 无人回复列表 MUST 不包含 `dev/test` 话题
 - **AND** MUST 不包含已删除话题
 - **AND** MUST 不包含作者已被 block 的话题
 
 #### Scenario: mute 用户内容不从 sidebar 自动隐藏
+
 - **WHEN** 话题作者仅处于 mute 状态且未处于 block 状态
 - **THEN** 最新回复和无人回复模块 MUST 按普通公开规则决定是否展示该话题
 
diff --git a/openspec/specs/immutable-image-release/spec.md b/openspec/specs/immutable-image-release/spec.md
index c44a703..8da1b29 100644
--- a/openspec/specs/immutable-image-release/spec.md
+++ b/openspec/specs/immutable-image-release/spec.md
@@ -1,43 +1,55 @@
 # immutable-image-release Specification
 
 ## Purpose
+
 TBD - created by archiving change reach-production-grade-release-readiness. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 生产镜像必须以不可变标识发布
+
 CI SHALL 为 API 和 Web 生产镜像发布 commit SHA tag 或 digest，使每个生产部署都能精确追溯到源码提交。
 
 #### Scenario: API 镜像发布 SHA tag
+
 - **WHEN** main 分支通过发布验证并构建 API 镜像
 - **THEN** CI MUST 推送 `ghcr.io/cnodejs/cnode-api:sha-<commit>` 或记录等价 image digest
 - **AND** 该 tag 或 digest MUST 对应构建时的 Git commit
 
 #### Scenario: Web 镜像发布 SHA tag
+
 - **WHEN** main 分支通过发布验证并构建 Web 镜像
 - **THEN** CI MUST 推送 `ghcr.io/cnodejs/cnode-web:sha-<commit>` 或记录等价 image digest
 - **AND** 该 tag 或 digest MUST 对应构建时的 Git commit
 
 ### Requirement: 生产部署不得依赖唯一 latest tag
+
 生产 `api`、`web` 和 `worker` 服务 SHALL 使用显式 `CNODE_API_IMAGE` 与 `CNODE_WEB_IMAGE` 指向不可变发布物。
 
 #### Scenario: compose 要求显式生产镜像
+
 - **WHEN** 运维渲染生产 `deployment/docker-compose.yml`
 - **THEN** `api`、`worker`、`migrate-schema`、`migrate-data` 和 `reconcile` MUST 使用 `CNODE_API_IMAGE` 指向的不可变 API 镜像
 - **AND** `web` MUST 使用 `CNODE_WEB_IMAGE` 指向的不可变 Web 镜像
 
 #### Scenario: latest 仅作为便利标签
+
 - **WHEN** CI 额外推送 `latest`
 - **THEN** 生产部署文档 MUST 明确 `latest` 不可作为生产部署依据
 - **AND** 部署审计记录 MUST 使用 SHA tag 或 digest
 
 ### Requirement: 回滚必须使用已知旧发布物
+
 生产回滚 SHALL 使用上一次成功部署记录中的旧 SHA tag 或 digest，而不是重新解析 `latest`。
 
 #### Scenario: 部署前记录旧镜像
+
 - **WHEN** 运维开始部署新版本
 - **THEN** runbook MUST 要求记录当前运行的 API 和 Web image tag 或 digest
 - **AND** 该记录 MUST 可用于失败回滚
 
 #### Scenario: 新版本 smoke 失败后回滚
+
 - **WHEN** 新版本部署后 health 或 smoke 失败
 - **THEN** 运维 MUST 将 API/Web 镜像引用恢复到旧 SHA tag 或 digest
 - **AND** 回滚后 MUST 重新验证 health 和 smoke
diff --git a/openspec/specs/jobs-detail-card/spec.md b/openspec/specs/jobs-detail-card/spec.md
index 9167812..6723d27 100644
--- a/openspec/specs/jobs-detail-card/spec.md
+++ b/openspec/specs/jobs-detail-card/spec.md
@@ -1,8 +1,11 @@
 # jobs-detail-card Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: JobMetaCard 位置在 content 上方
 
 详情页 `topic.$tid.tsx` 的 content `<Card>` 内部 SHALL 在 `<MarkdownView>` 上方插入 `<JobMetaCard>`，仅在 `tab='job'` 且 `job_meta` 非空时渲染。
diff --git a/openspec/specs/jobs-structured-fields/spec.md b/openspec/specs/jobs-structured-fields/spec.md
index 1e723ae..27947b3 100644
--- a/openspec/specs/jobs-structured-fields/spec.md
+++ b/openspec/specs/jobs-structured-fields/spec.md
@@ -1,8 +1,11 @@
 # jobs-structured-fields Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: job_meta 表定义
 
 系统 SHALL 新增 `job_meta` 表，1:1 关联 `topics.id`，存储招聘结构化字段。`job_meta.topic_id` SHALL 既是主键又是外键，`ON DELETE CASCADE` 跟随 topic 生命周期。
diff --git a/openspec/specs/jobs-zone/spec.md b/openspec/specs/jobs-zone/spec.md
index 1979010..a0ff4cb 100644
--- a/openspec/specs/jobs-zone/spec.md
+++ b/openspec/specs/jobs-zone/spec.md
@@ -1,8 +1,11 @@
 # jobs-zone Specification
 
 ## Purpose
+
 TBD - created by archiving change add-jobs-zone. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 专区路由独立全宽布局
 
 专区页 `/zone/jobs` SHALL 使用全宽布局展示卡片网格，不复用首页 `FeedGrid` 的主区+20rem 侧栏骨架。专区页 SHALL 只包含顶部筛选条和下方卡片网格两个区域。
diff --git a/openspec/specs/layout-templates/spec.md b/openspec/specs/layout-templates/spec.md
index 6bb0265..a206e03 100644
--- a/openspec/specs/layout-templates/spec.md
+++ b/openspec/specs/layout-templates/spec.md
@@ -3,12 +3,15 @@
 ## Purpose
 
 定义 Web 路由使用的页面模板、内容宽度、响应式重排、后台宽屏布局和表格溢出处理约束，确保不同页面类型在桌面与移动端保持一致且可读的结构。
+
 ## Requirements
+
 ### Requirement: 命名页面模板
 
 所有 app routes SHALL 映射到由 application blocks 组成的命名页面原型。公共页面原型为 feed、reading、compose、account、directory；后台页面原型为 dashboard、data-list、workflow。每个原型 MUST 定义 shell 对齐、内容宽度、PageHeader、block spacing、主要操作位置和 responsive behavior，route 不得定义与原型无关的 standalone surface 或宽度。
 
 #### Scenario: Route 可映射到模板
+
 - **WHEN** 审计 `apps/web/app/routes` 中的任意 route
 - **THEN** route 可映射到一个命名页面原型并复用对应 blocks；原有 feed、reading/topic detail、content、form、search 和 admin 页面职责 MUST 由对应最终原型承接
 - **AND** 同类 route 不得通过独立 Hero、Card padding、圆角或最大宽度形成另一套模板。
@@ -66,29 +69,35 @@ Auth、setting、create、edit 页面 SHALL 使用统一 form 模板，包括清
 Admin routes SHALL 使用标准 application shell、全宽 Header、容器内 desktop navigation Card 与 mobile Sheet，并按 dashboard、data-list 或 workflow 原型组合 page header、filters、toolbar、Card/Table/Item、pagination 和 actions。桌面、移动端导航 MUST 共享任务分组和 active state；desktop navigation Card MUST 与右侧完整 page header 使用同一顶部基线，不得增加仅用于补偿 breadcrumb 高度的左栏标签。后台 page header 使用 breadcrumb 与紧凑品牌 surface，不得扩展为宣传型 Hero。
 
 #### Scenario: Admin 页面共享布局
+
 - **WHEN** `/admin/topics`、`/admin/users` 和 `/admin/settings` 渲染
 - **THEN** 它们共享相同 shell、Sidebar/nav、内容宽度、page header、block spacing、Card/Table surface 和 active 导航行为
 - **AND** 数据列表与表单可使用不同原型，但不得重建独立 panel primitive。
 
 #### Scenario: Workflow filters 与 records 分组
+
 - **WHEN** 审计或治理 workflow 同时展示 filters 和 records
 - **THEN** toolbar、结构分隔与 records 之间保留标准 block gap
 - **AND** filter controls 不得与第一条记录共享边界或形成视觉叠压。
 
 ### Requirement: Admin 模板必须提供后台宽屏内容区
+
 Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据表格和运营工具，同时保留表单类内容的可读宽度。
 
 #### Scenario: 后台 shell 使用宽屏容器
+
 - **WHEN** 管理员在桌面端访问 `/admin/topics`、`/admin/users`、`/admin/audit` 或 `/admin/moderation`
 - **THEN** admin shell 的主内容容器 MUST 使用宽屏上限，例如 `max-w-screen-2xl` 或等价宽度
 - **AND** 左侧导航和主内容区域 MUST 保持 `min-w-0` 以允许内部滚动和截断生效
 
 #### Scenario: 表单类后台页面不过度拉宽
+
 - **WHEN** 管理员访问 `/admin/settings` 或其他表单为主的后台页面
 - **THEN** 页面 SHALL 仍使用 admin shell 对齐
 - **AND** 表单卡片内容 MUST 使用内部宽度或 grid 控制，避免输入框横跨整个宽屏容器
 
 #### Scenario: 表格横向滚动与列宽协同
+
 - **WHEN** 管理表格的内容总宽度超过主内容区域
 - **THEN** 表格容器 MUST 提供横向滚动
 - **AND** 页面 MUST 为关键列配置最小宽度或换行策略，避免浏览器无限压缩列宽
@@ -98,11 +107,13 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 公共入口和说明页面 SHALL 使用 marketing PageHeader；任务型页面 SHALL 使用 breadcrumb 加紧凑 PageHeader。两者 MUST 共享品牌 surface、标题层级、说明、圆角和 action 排布，只通过尺度与上下文区分，不得让任务页退化为无容器标题或局部分割线。
 
 #### Scenario: 任务型页面标题
+
 - **WHEN** 搜索、设置、发布编辑、消息、榜单或后台页面渲染
 - **THEN** breadcrumb 位于紧凑品牌 title surface 上方
 - **AND** title surface 与 marketing Hero 使用同一语义颜色，但保持更小 padding 和标题尺度。
 
 #### Scenario: Topic reading 标题
+
 - **WHEN** 话题详情渲染 breadcrumb、标题、状态和 metadata
 - **THEN** 标题保留在 reading CardHeader 而不是应用 PageHeader
 - **AND** Separator 在 Card 基础 padding 内铺满内容宽度，不触碰 Card 外框。
@@ -112,11 +123,13 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 后台 data-list 与 workflow SHALL 为窄屏定义核心字段、状态、主操作和次要详情的优先级；页面 MUST 明确选择响应式 record/item 或可横向滚动 Table，不得让关键操作只能在 viewport 外发现。
 
 #### Scenario: 响应式记录项
+
 - **WHEN** 数据可由身份/标题、状态、关键指标和主操作概括
 - **THEN** 窄屏使用 Item 或等价 record composition 将核心信息纵向排列
 - **AND** 次要字段可折叠、换行或进入详情。
 
 #### Scenario: 保留可滚动数据表
+
 - **WHEN** 任务需要跨多列比较且不适合转换为记录项
 - **THEN** Table 容器提供明确横向滚动并保留关键列宽和操作可达性
 - **AND** 页面不得同时维护行为不一致的桌面表格和移动端卡片。
@@ -126,6 +139,7 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 页面原型 SHALL 至少在 375px、768px、1280px 和 1440px viewport 下保持可用，并 SHALL 在较大 viewport 通过内容 measure 和最大宽度避免无边界拉伸。
 
 #### Scenario: 页面原型跨 viewport
+
 - **WHEN** 同一原型在四个标准 viewport 渲染
 - **THEN** 导航、标题、主要内容、主要操作和 overlay 均保持可见可达
 - **AND** 除明确的 Table 或 code scroll container 外不产生 viewport 水平溢出。
@@ -135,6 +149,7 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 除首页 feed MAY 使用简洁上一页/下一页模式外，公共列表与后台列表 SHALL 使用共享 numbered pagination，按上一页、最多五个连续页码、必要的首末页与省略号、下一页呈现。分页链接 MUST 保留当前有效筛选 query，route MUST NOT 自行建立不同分页 markup。
 
 #### Scenario: 非首页列表跨页
+
 - **WHEN** 用户在个人话题、招聘目录或后台筛选列表浏览多个结果页
 - **THEN** 页面显示一致的 numbered pagination，并以 `aria-current="page"` 标识当前页
 - **AND** 上一页、下一页和页码链接保留当前筛选条件。
@@ -144,6 +159,7 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 首页右侧 rail SHALL 优先展示补充 feed 的信息，不得重复 Hero 已表达的社区定位。社区合作展示位 MUST 明确为合作入口而非虚构广告；实时信息按最新回复、积分榜、无人回复话题排列。
 
 #### Scenario: 首页桌面 rail
+
 - **WHEN** 首页在显示右侧 rail 的 viewport 渲染
 - **THEN** 首卡为指向 About 合作说明的社区合作展示位
 - **AND** 积分榜紧邻最新回复并位于无人回复话题之前。
@@ -153,6 +169,7 @@ Admin routes SHALL 使用比前台 feed 更宽的后台 shell，以承载数据
 未从站点导航露出的第三方客户端下载 route SHALL 被移除，其仍有参考价值的项目链接与维护边界 SHALL 合并到 `/about`，不得让站内下载 URL 直接重定向到第三方内容。
 
 #### Scenario: 访问社区客户端说明
+
 - **WHEN** 用户在 About 查看客户端与社区项目章节
 - **THEN** 页面说明该客户端由社区开发者维护并提供原项目链接
 - **AND** route config 不再注册 `/app/download`。
diff --git a/openspec/specs/messaging/spec.md b/openspec/specs/messaging/spec.md
index d642a76..550564b 100644
--- a/openspec/specs/messaging/spec.md
+++ b/openspec/specs/messaging/spec.md
@@ -1,8 +1,11 @@
 # messaging Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 消息类型
 
 系统 MUST 支持以下消息类型:
diff --git a/openspec/specs/moderation-scan-jobs/spec.md b/openspec/specs/moderation-scan-jobs/spec.md
index 5a54d80..48f99e7 100644
--- a/openspec/specs/moderation-scan-jobs/spec.md
+++ b/openspec/specs/moderation-scan-jobs/spec.md
@@ -1,19 +1,24 @@
 # moderation-scan-jobs Specification
 
 ## Purpose
+
 TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 巡检扫描任务
 
 系统 MUST 使用持久化任务记录执行历史和定时内容巡检，任务状态、进度游标、扫描范围和资源限制必须可查询和恢复。任务被 worker 领取后 MUST 执行到 `done`、`failed` 或管理员暂停，不能因为达到单轮批次数限制永久停留在 `running`。
 
 #### Scenario: 创建历史扫描任务
+
 - **WHEN** 管理员新增敏感词或手动发起历史扫描
 - **THEN** 系统 MUST 创建巡检扫描任务
 - **AND** 任务 MUST 记录扫描范围、触发原因、敏感词范围、批大小、限速配置和初始游标
 - **AND** HTTP 请求 MUST 在任务创建后返回，不等待全库扫描完成
 
 #### Scenario: 任务状态流转
+
 - **WHEN** worker 开始处理扫描任务
 - **THEN** 任务状态 MUST 从 `pending` 变为 `running`
 - **AND** worker MUST 在每批完成后更新游标、已扫描数量和命中数量
@@ -22,6 +27,7 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 - **AND** worker 达到单轮批次数限制时 MUST 继续处理到完成，或将未完成任务恢复为后续 worker 可领取的状态
 
 #### Scenario: 暂停和恢复任务
+
 - **WHEN** 管理员暂停正在执行的扫描任务
 - **THEN** worker MUST 在当前批次结束后停止继续扫描
 - **AND** 任务 MUST 保留最后成功游标
@@ -29,6 +35,7 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 - **THEN** worker MUST 从最后成功游标继续扫描
 
 #### Scenario: 恢复悬挂任务
+
 - **WHEN** worker 重启或上一 worker 崩溃后存在未完成的 `running` 巡检任务
 - **THEN** 后续 worker MUST 能从最后成功游标继续执行该任务
 - **AND** 同一时间 MUST 只有一个 worker 继续执行该任务
@@ -38,6 +45,7 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 系统 MUST 按固定大小批次扫描话题和回复，避免单次数据库查询加载大量数据。批次限制和批间休眠 MUST 控制每批资源占用，但不能破坏巡检任务最终完成或可恢复的语义。
 
 #### Scenario: 按游标扫描话题
+
 - **WHEN** worker 扫描话题内容
 - **THEN** 增量任务每批 MUST 使用主键游标读取 `id > cursor` 的话题
 - **AND** 历史任务每批 MUST 从最新话题开始按 `id` 倒序扫描
@@ -45,6 +53,7 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 按游标扫描回复
+
 - **WHEN** worker 扫描回复内容
 - **THEN** 增量任务每批 MUST 使用主键游标读取 `id > cursor` 的回复
 - **AND** 历史任务每批 MUST 从最新回复开始按 `id` 倒序扫描
@@ -52,11 +61,13 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 - **AND** 每批处理完成后 MUST 立即写入命中结果并更新任务游标
 
 #### Scenario: 扫描限速
+
 - **WHEN** worker 完成一个扫描批次
 - **THEN** worker MUST 按任务配置或环境变量休眠指定时间
 - **AND** worker MUST 控制单批处理规模，避免一次性占用大量 CPU 和数据库连接
 
 #### Scenario: 超过单轮批次数的数据集
+
 - **WHEN** 巡检任务的数据量超过 `maxBatchesPerRun * batchSize`
 - **THEN** 系统 MUST 保留已完成批次的游标和计数
 - **AND** 任务 MUST 继续执行到 `done` 或保持后续 worker 可继续领取和执行
@@ -67,12 +78,14 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 系统 MUST 支持定时创建增量巡检任务，用于检查最近新增或更新的已发布内容。
 
 #### Scenario: 定时任务触发
+
 - **WHEN** 到达配置的巡检周期
 - **THEN** worker MUST 创建或执行增量扫描任务
 - **AND** 任务 MUST 只扫描上次完成后新增或更新的内容
 - **AND** 若已有同类扫描任务未完成，系统 MUST 避免创建重复任务
 
 #### Scenario: 单实例执行
+
 - **WHEN** 多个 worker 进程同时运行
 - **THEN** 同一时间 MUST 只有一个 worker 执行同一个扫描任务
 - **AND** 锁失效或 worker 崩溃后，任务 MUST 能被后续 worker 接管
@@ -82,17 +95,20 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 系统 MUST 允许 admin 对未完成的巡检任务执行立即执行操作，使任务不必等待 worker 的下一次固定轮询。
 
 #### Scenario: 立即执行 pending 任务
+
 - **WHEN** admin 对 pending 巡检任务点击立即执行
 - **THEN** 系统 MUST 触发 worker 尽快 claim 该任务
 - **AND** HTTP 请求 MUST 在触发成功后返回，不等待扫描完成
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 立即执行 paused 任务
+
 - **WHEN** admin 对 paused 巡检任务点击立即执行
 - **THEN** 系统 MUST 将任务恢复为可执行状态
 - **AND** worker MUST 从最后成功游标继续扫描
 
 #### Scenario: 立即执行 running 任务
+
 - **WHEN** admin 对 running 巡检任务点击立即执行
 - **THEN** 系统 MUST 不创建重复扫描实例
 - **AND** 若 worker 已在处理该任务，系统 MUST 返回成功或当前运行状态
@@ -102,18 +118,21 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 系统 MUST 允许 admin 取消 pending、paused 或 running 巡检任务。取消后的任务 MUST 进入 `cancelled` 终态，并且不得继续被 worker claim 或继续扫描。
 
 #### Scenario: 取消 pending 任务
+
 - **WHEN** admin 取消 pending 巡检任务
 - **THEN** 任务状态 MUST 变为 `cancelled`
 - **AND** worker MUST 不再 claim 该任务
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 取消 running 任务
+
 - **WHEN** admin 取消 running 巡检任务
 - **THEN** worker MUST 在当前 batch 结束后停止继续扫描
 - **AND** 任务状态 MUST 保持 `cancelled`
 - **AND** 取消后 MUST 不再新增该任务的扫描命中
 
 #### Scenario: 取消已完成任务
+
 - **WHEN** admin 尝试取消 done、failed 或 cancelled 任务
 - **THEN** 系统 MUST 返回失败或幂等响应
 - **AND** 不得改变任务终态和扫描结果
@@ -123,13 +142,14 @@ TBD - created by syncing change add-low-impact-moderation-scans. Update Purpose
 系统 SHALL 在后台任务列表展示立即执行和取消所需状态，并防止普通用户调用任务控制接口。
 
 #### Scenario: 任务列表展示操作按钮
+
 - **WHEN** admin 查看巡检任务列表
 - **THEN** pending、paused 和 running 任务 MUST 展示取消入口
 - **AND** pending 或 paused 任务 MUST 展示立即执行入口
 - **AND** done、failed、cancelled 任务 MUST NOT 展示会改变状态的执行入口
 
 #### Scenario: 非管理员不可控制任务
+
 - **WHEN** 非 admin 用户调用立即执行或取消接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标任务状态保持不变
-
diff --git a/openspec/specs/navigation-shell/spec.md b/openspec/specs/navigation-shell/spec.md
index cdc5729..eaaede4 100644
--- a/openspec/specs/navigation-shell/spec.md
+++ b/openspec/specs/navigation-shell/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义主站和后台导航 shell 的 header cluster 模型、logo 行为、搜索入口、发布 CTA、后台上下文和移动端优先级要求。
+
 ## Requirements
+
 ### Requirement: 主站 Header cluster 模型
 
 主站 Header SHALL 将官方 logo 与搜索/命令入口放在左侧 cluster，将专区入口、`API` 一级入口、`关于` 一级入口、主 CTA、消息/通知和 profile 放在右侧 cluster。
diff --git a/openspec/specs/openspec-change-governance/spec.md b/openspec/specs/openspec-change-governance/spec.md
index 6716d47..cb10e5f 100644
--- a/openspec/specs/openspec-change-governance/spec.md
+++ b/openspec/specs/openspec-change-governance/spec.md
@@ -7,72 +7,91 @@
 ## Requirements
 
 ### Requirement: Change Scope Contract
+
 OpenSpec change proposals for behavior, product, API, migration, release, architecture, database, security, or data repair work SHALL define a change scope contract that states in-scope areas, out-of-scope areas, affected systems, unaffected systems when relevant, legacy reference boundaries, and high-risk categories.
 
 #### Scenario: Change proposal declares scope
+
 - **WHEN** a contributor creates an OpenSpec change for scoped project work
 - **THEN** the proposal SHALL state the intended改造范围 and明确不改造范围 before implementation tasks are started
 
 #### Scenario: High-risk categories are visible
+
 - **WHEN** a change affects database, security, permissions, public API contracts, data migration, deployment, or data repair
 - **THEN** the proposal SHALL mark those categories in its impact assessment
 
 ### Requirement: Documentation Impact Assessment
+
 Every OpenSpec change proposal SHALL include a documentation impact assessment covering both `docs/` and `wiki/`. The assessment MUST list target files when updates are required, explain why updates are not required, or identify the follow-up task/change when updates are deferred.
 
 #### Scenario: Stable documentation must change
+
 - **WHEN** a change modifies current development workflow, architecture, database behavior, API usage, security rules, deployment steps, or content moderation operation
 - **THEN** the proposal SHALL identify the affected `docs/` files to update
 
 #### Scenario: Knowledge base must change
+
 - **WHEN** a change modifies business rules, legacy compatibility understanding, migration background, community rules, or sourced historical context
 - **THEN** the proposal SHALL identify the affected `wiki/` files to update and preserve uncertainty using the wiki writing guidelines
 
 #### Scenario: Documentation not required
+
 - **WHEN** a change does not require updates to `docs/` or `wiki/`
 - **THEN** the proposal SHALL explicitly state why long-lived documentation is not affected
 
 ### Requirement: Diagram And Explanation Requirements
+
 OpenSpec design documents SHALL include Mermaid diagrams or concise matrices when a change affects architecture boundaries, request flows, data models, state transitions, permissions, or migration/release ordering. Designs MAY omit diagrams only when the change is small enough that relationships remain clear in prose, and the omission is explained.
 
 #### Scenario: Data model change needs visual explanation
+
 - **WHEN** a change adds or modifies tables, relationships, indexes, constraints, or durable data semantics
 - **THEN** the design SHALL include an ER diagram, data-flow diagram, or equivalent field/relationship table
 
 #### Scenario: Permission change needs boundary explanation
+
 - **WHEN** a change modifies admin, moderator, user, role, token, or capability boundaries
 - **THEN** the design SHALL include a permission matrix or flow diagram showing allowed and denied operations
 
 #### Scenario: Migration sequence needs ordering explanation
+
 - **WHEN** a change requires ordered rollout, data migration, backfill, compatibility window, or rollback planning
 - **THEN** the design SHALL include a flowchart or sequence description showing the required order
 
 ### Requirement: Database Change Audit
+
 OpenSpec design documents for database-related changes MUST include a `Database Change Audit`. Database-related changes include PostgreSQL schema changes, Drizzle migrations, seed/bootstrap changes, indexes, constraints, data backfills, data cleanup, data repair scripts, data retention rules, and field semantic changes.
 
 #### Scenario: Database change audit covers impact
+
 - **WHEN** a change affects PostgreSQL schema, data, migrations, or field semantics
 - **THEN** the design MUST identify affected tables, affected columns, expected existing-row impact, user-visible behavior impact, and related `docs/` or `wiki/` updates
 
 #### Scenario: Database change audit covers compatibility
+
 - **WHEN** a change affects database shape or durable data semantics
 - **THEN** the design MUST evaluate old code with new schema, new code with old data, shared/API schema compatibility, and required deploy ordering
 
 #### Scenario: Database change audit covers operational risk
+
 - **WHEN** a change includes migration, index, constraint, backfill, cleanup, or data repair work
 - **THEN** the design MUST evaluate online-safety, lock or full-scan risk, rollback reversibility, data-loss risk, integrity checks, and verification evidence
 
 ### Requirement: Tasks Include Knowledge And Audit Verification
+
 OpenSpec task lists SHALL include explicit tasks for documentation synchronization, diagram consistency, database audit verification when applicable, and final OpenSpec validation before archive.
 
 #### Scenario: Documentation tasks follow impact assessment
+
 - **WHEN** the proposal declares required `docs/` or `wiki/` updates
 - **THEN** `tasks.md` SHALL include checklist items to update those files and verify they describe current behavior rather than one-time implementation notes
 
 #### Scenario: Database tasks follow audit
+
 - **WHEN** the design contains a `Database Change Audit`
 - **THEN** `tasks.md` SHALL include verification tasks for migration execution, rollback or rollback rationale, data integrity checks, and relevant documentation updates
 
 #### Scenario: Archive readiness includes knowledge checks
+
 - **WHEN** a change is prepared for archive
 - **THEN** maintainers SHALL confirm implementation tasks, OpenSpec validation, documentation impact handling, diagram consistency, and database audit evidence where applicable
diff --git a/openspec/specs/postgres-first-dev-runtime/spec.md b/openspec/specs/postgres-first-dev-runtime/spec.md
index 066f6c1..f54fef6 100644
--- a/openspec/specs/postgres-first-dev-runtime/spec.md
+++ b/openspec/specs/postgres-first-dev-runtime/spec.md
@@ -1,69 +1,86 @@
 # postgres-first-dev-runtime Specification
 
 ## Purpose
+
 定义 cnode-next 的数据库运行时策略、开发连接配置、本地 secret 边界和 PostgreSQL boolean 兼容要求；项目只允许 PostgreSQL 作为开发、测试、迁移验证、CI 和生产数据库。
+
 ## Requirements
+
 ### Requirement: Development runtime SHALL use PostgreSQL as the default migration validation database
+
 The project MUST document PostgreSQL as the only supported database for current development, testing, migration validation, CI verification, and production runtime work.
 
 #### Scenario: Developer prepares a local runtime
+
 - **WHEN** a developer follows the development setup documentation
 - **THEN** the documented path MUST direct them to a PostgreSQL-backed runtime
 - **AND** the documented path MUST NOT offer SQLite as a fallback runtime
 
 #### Scenario: SQLite behavior is referenced
+
 - **WHEN** active code, scripts, docs, or specs mention SQLite
 - **THEN** the mention MUST be removed unless it is in archived historical change records or generic OpenSpec tooling instructions outside application scope
 
 #### Scenario: Runtime database client is created
+
 - **WHEN** API、worker、migration 或测试验证脚本创建数据库连接
 - **THEN** it MUST create a PostgreSQL-backed client
 - **AND** it MUST NOT branch on `DB_DIALECT` or import `better-sqlite3`
 
 ### Requirement: Developers SHALL provide PostgreSQL and Redis connection settings
+
 Developers MUST be able to run cnode-next against PostgreSQL/Redis by providing connection settings through the unified root `.env` contract. 应用配置 MUST 使用 `CNODE_*`，PostgreSQL 与 Redis MUST 分别使用 `POSTGRES_*` 与 `REDIS_*`，且不得接受旧变量 fallback。
 
 #### Scenario: Developer configures database/cache endpoints
+
 - **WHEN** a developer needs to run the project locally
 - **THEN** documentation MUST instruct them to provide PostgreSQL host, port, database, user and password via `POSTGRES_HOST`、`POSTGRES_PORT`、`POSTGRES_DB`、`POSTGRES_USER`、`POSTGRES_PASSWORD`
 - **AND** documentation MUST instruct them to provide Redis host, port, database index and optional password via `REDIS_HOST`、`REDIS_PORT`、`REDIS_DB`、`REDIS_PASSWORD`
 - **AND** `.env.local` or app-local dotenv files such as `apps/web/.env` or `apps/web/.env.local` MUST NOT be required for normal local startup
 
 #### Scenario: Workspace dev commands load environment consistently
+
 - **WHEN** a developer starts Web and API together with `pnpm dev`
 - **THEN** both applications MUST load local environment values from the same repository root contract
 - **AND** Web, API, and DB scripts MUST NOT depend on separate app-local dotenv files for shared values such as `CNODE_API_BASE_URL`, `POSTGRES_HOST`, `REDIS_HOST`, or auth cookie settings
 - **AND** runtime consumers MUST NOT fall back to `APP_*`、`DB_*` or `DATABASE_URL`
 
 #### Scenario: Package script invokes framework or database CLI
+
 - **WHEN** a package script invokes a CLI that needs application runtime environment, such as `react-router`, `drizzle-kit`, `tsx` application scripts, or API worker scripts
 - **THEN** the CLI MUST receive the repository root environment contract through its natural config file or script entrypoint
 - **AND** the default package script command shape MUST NOT be changed solely to wrap the CLI with an env launcher
 
 #### Scenario: Package script runs unrelated quality tooling
+
 - **WHEN** a package script runs tooling that does not need application runtime environment, such as lint, typecheck, format, secret scanning, or production compose template validation
 - **THEN** the script SHOULD NOT load local dotenv files
 - **AND** it MUST NOT require local secrets to succeed
 
 ### Requirement: Local secrets SHALL remain untracked
+
 Local database credentials, auth secrets, OAuth secrets, SMTP secrets, OSS secrets, and other private runtime values MUST be stored outside tracked files and MUST NOT be printed, copied into scripts, or overwritten by automated migration steps.
 
 #### Scenario: Local override file is used
+
 - **WHEN** a developer stores local PostgreSQL connection values
 - **THEN** the values MUST be stored in an ignored `.env` file at the repository root
 - **AND** `.env.example` MUST remain a placeholder template without real secrets
 
 #### Scenario: Existing local dotenv files are present
+
 - **WHEN** `.env`, `.env.local`, `apps/web/.env`, `apps/web/.env.local`, or other ignored dotenv files already exist in a developer workspace
 - **THEN** implementation steps MUST NOT delete, overwrite, print, or commit their contents
 - **AND** any cleanup or migration of real local dotenv files MUST require explicit human confirmation outside automated implementation
 
 #### Scenario: Environment values are supplied externally
+
 - **WHEN** CI, shell, compose, or a hosting runtime has already supplied an environment variable
 - **THEN** local dotenv loading MUST NOT override that existing value
 - **AND** the externally supplied value MUST remain authoritative for that process
 
 #### Scenario: Deprecated local override file exists
+
 - **WHEN** repository root `.env.local` exists in a developer workspace
 - **THEN** default local loading MUST ignore it
 - **AND** implementation MUST NOT delete, overwrite, print, or migrate it without explicit human confirmation
diff --git a/openspec/specs/production-deployment-governance/spec.md b/openspec/specs/production-deployment-governance/spec.md
index d7ef2cf..128149e 100644
--- a/openspec/specs/production-deployment-governance/spec.md
+++ b/openspec/specs/production-deployment-governance/spec.md
@@ -1,120 +1,148 @@
 # production-deployment-governance Specification
 
 ## Purpose
+
 Define production deployment runbook, deploy asset organization, audit, CI gates, and workflow boundaries.
+
 ## Requirements
+
 ### Requirement: 生产部署必须有标准 runbook
+
 项目 SHALL 提供标准生产部署 runbook，覆盖 preflight、migration、镜像拉取、服务启动、健康检查、smoke、回滚和审计记录。
 
 #### Scenario: 部署前 preflight
+
 - **WHEN** 运维准备生产部署
 - **THEN** runbook MUST 要求确认目标 commit、API/Web image tag 或 digest、当前生产镜像、数据库迁移策略和回滚点
 - **AND** runbook MUST 要求确认 `.env` 中不会打印或提交 secret
 
 #### Scenario: 部署后验证
+
 - **WHEN** 运维完成 `docker compose up -d --no-build`
 - **THEN** runbook MUST 要求验证 API `/health`
 - **AND** runbook MUST 要求运行公开 URL、API contract 和关键写入 smoke 中适用于本次发布的检查
 
 ### Requirement: migration 必须显式执行和审计
+
 生产 schema/data migration SHALL 作为显式步骤执行，不得在普通服务启动时隐式运行。
 
 #### Scenario: schema migration 显式执行
+
 - **WHEN** 发布包含 PostgreSQL schema 变更
 - **THEN** 运维 MUST 使用 runbook 中的 migrate profile 或等价显式命令执行 schema migration
 - **AND** migration 输出和结果 MUST 被记录
 
 #### Scenario: migration 失败阻断服务切换
+
 - **WHEN** migration 返回失败
 - **THEN** 运维 MUST 停止继续部署新应用镜像
 - **AND** runbook MUST 指向回滚或人工修复流程
 
 ### Requirement: 部署记录必须可审计
+
 每次生产部署 SHALL 留下可审计记录，能够回答谁在何时把哪个 commit/image 部署到了生产以及验证结果如何。
 
 #### Scenario: 成功部署记录
+
 - **WHEN** 生产部署成功完成
 - **THEN** 记录 MUST 包含时间、操作者、Git commit、API image、Web image、migration 结果、health 结果和 smoke 结果
 - **AND** 记录 MUST NOT 包含 secret、OAuth token、数据库密码或认证 header
 
 #### Scenario: 回滚记录
+
 - **WHEN** 生产部署触发回滚
 - **THEN** 记录 MUST 包含失败的新 image、恢复的旧 image、回滚原因和回滚后 health/smoke 结果
 
 ### Requirement: 生产部署资产必须集中管理
+
 生产部署 runbook、部署编排、部署模板、部署 SQL、启动脚本、dotenv 示例和部署辅助文件 SHALL 收敛到专门的 `deployment/` 部署域，避免仓库根目录或 `docs/` 堆放生产实现细节。
 
 #### Scenario: 生产 compose 文件位置
+
 - **WHEN** 仓库提供生产 Docker Compose 编排
 - **THEN** 该文件 MUST 位于 `deployment/` 或等价部署目录
 - **AND** 根目录 MUST NOT 直接放置生产 `docker-compose.yml` 编排文件
 
 #### Scenario: deployment 与 docs/wiki 同级
+
 - **WHEN** 仓库包含生产部署 runbook 或部署资产
 - **THEN** `deployment/` MUST 作为与 `docs/`、`wiki/` 同级的顶层目录存在
 - **AND** `deployment/` MUST 包含 README 或等价规范说明生产部署步骤和部署资产职责边界
 
 #### Scenario: 部署资产分类
+
 - **WHEN** 部署资产包含 compose、SQL、启动脚本或配置模板
 - **THEN** 这些文件 MUST 在 `deployment/` 内按用途清晰命名或分目录组织
 - **AND** `deployment/` 规范 MUST 说明 docker-compose 文件、SQL 文件、启动脚本和 dotenv 模板各自用途
 
 #### Scenario: 部署命令引用新路径
+
 - **WHEN** 文档、脚本或运维 runbook 引用生产 compose 文件
 - **THEN** 它们 MUST 使用部署目录路径，例如 `deployment/docker-compose.yml`
 - **AND** 旧路径 MUST 不再作为推荐命令出现
 
 #### Scenario: dotenv 示例按配置域分组
+
 - **WHEN** 仓库提供部署 dotenv 示例或模板
 - **THEN** 模板 MUST 使用注释或等价结构按配置域分组
 - **AND** 分组 SHOULD 覆盖应用 URL、数据库、Redis、认证、对象存储、Turnstile、邮件、观测/日志和迁移/运维开关
 - **AND** 模板 MUST 使用占位值，不得包含真实 secret、token、私有连接串或生产用户数据
 
 #### Scenario: 启动脚本和 SQL 可追溯
+
 - **WHEN** `deployment/` 包含启动脚本或 SQL 文件
 - **THEN** 文件名或相邻说明 MUST 表达执行时机和用途
 - **AND** 文档 MUST 说明这些资产是否可重复执行、是否会修改数据、以及执行前需要的环境变量
 
 ### Requirement: CI 必须避免一次性文件文本验收脚本
+
 CI 和 `pnpm verify` SHALL 使用长期可维护的通用质量门禁，避免依赖大量针对具体文件内容、具体文档句子或一次性上线验收目标的专项 verify 脚本。
 
 #### Scenario: 通用质量门禁
+
 - **WHEN** CI 执行发布或 PR 验证
 - **THEN** 它 SHOULD 运行 lint、typecheck、test、build、OpenSpec validate、secret scan 和 OpenAPI 契约检查这类通用检查
 - **AND** repository verification MUST NOT 在本地运行 Docker Compose；Compose validation MUST 属于部署主机 preflight
 - **AND** 这些检查 MUST NOT 依赖真实 `.env` secret 值
 
 #### Scenario: 专项 verify 脚本收敛
+
 - **WHEN** `scripts/` 中存在只验证当前文档文本、当前 compose 文本或当前 workflow 文本的 `verify-*` 脚本
 - **THEN** 该脚本 MUST 被删除、归档到一次性变更记录，或替换为更通用的契约/配置校验
 - **AND** `pnpm verify` MUST NOT 长期依赖这类一次性脚本
 
 #### Scenario: 文档结构由规范约束
+
 - **WHEN** 文档结构、目录职责或 README 信息架构需要约束
 - **THEN** 约束 SHOULD 写入 `docs/conventions.md`、OpenSpec 或 review checklist
 - **AND** CI MUST NOT 通过硬编码文档必须包含某几句固定文字来代替人工 review
 
 ### Requirement: GitHub Actions 必须按职责拆分
+
 GitHub Actions workflow SHALL 按 CI、镜像构建发布和生产部署入口分离职责，并使用最小权限。
 
 #### Scenario: PR 和分支 CI
+
 - **WHEN** pull request 或普通分支 push 触发验证
 - **THEN** `ci.yml` 或等价 CI workflow MUST 运行通用质量门禁
 - **AND** CI workflow MUST NOT 需要 `packages: write` 权限
 
 #### Scenario: 镜像构建发布
+
 - **WHEN** main、tag 或手动发布触发容器镜像构建
 - **THEN** 镜像 workflow MUST 与 PR CI 分离
 - **AND** 只有镜像 workflow SHOULD 使用 `packages: write` 权限推送 GHCR 镜像
 - **AND** 镜像 tag MUST 包含 commit SHA 或 digest 可追溯标识
 
 #### Scenario: 生产部署入口
+
 - **WHEN** 仓库提供 GitHub Actions 生产部署入口
 - **THEN** 部署 workflow MUST 与 CI 和镜像构建 workflow 分离
 - **AND** 部署 workflow MUST 使用手动触发、受保护 environment、最小权限 secret 和审计记录
 - **AND** 部署 workflow MUST NOT 在日志中打印 `.env`、tokens、私钥、数据库 URL 或用户数据
 
 #### Scenario: 当前无自动部署
+
 - **WHEN** 项目选择人工执行部署 runbook
 - **THEN** GitHub Actions MUST 只构建并发布镜像
 - **AND** 部署命令 MUST 保留在 `deployment/README.md` 或等价部署域说明中
diff --git a/openspec/specs/production-health-version/spec.md b/openspec/specs/production-health-version/spec.md
index 5f01322..940562f 100644
--- a/openspec/specs/production-health-version/spec.md
+++ b/openspec/specs/production-health-version/spec.md
@@ -1,45 +1,56 @@
 # production-health-version Specification
 
 ## Purpose
+
 TBD - created by archiving change reach-production-grade-release-readiness. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: API 必须提供生产健康端点
+
 API 服务 SHALL 提供 `GET /health` 作为生产健康检查入口，且该入口 MUST 不依赖认证。
 
 #### Scenario: 浅健康检查成功
+
 - **WHEN** 调用 `GET /health`
 - **THEN** API MUST 返回 2xx 响应
 - **AND** 响应 MUST 包含 `ok`、`service`、`version`、`commit` 和 `buildTime`
 - **AND** 响应 MUST NOT 包含环境变量、数据库地址、token、secret 或内部错误堆栈
 
 #### Scenario: compose 使用健康端点
+
 - **WHEN** 生产 `api` 容器执行 healthcheck
 - **THEN** healthcheck MUST 请求 API 专用 `/health` 端点
 - **AND** healthcheck MUST NOT 复用 `/api/v1/auth/config` 或其他业务接口
 
 ### Requirement: 构建版本信息必须可追溯
+
 API 和 Web 生产构建 SHALL 注入当前 commit 与 build time，使部署后的服务状态可反查到源码版本。
 
 #### Scenario: API 暴露构建版本
+
 - **WHEN** 运维查看 API `/health` 响应
 - **THEN** 响应中的 `commit` MUST 对应当前运行镜像构建时的 Git commit
 - **AND** `buildTime` MUST 对应镜像构建时间或发布流水线生成时间
 
 #### Scenario: Web 运行时可观测版本
+
 - **WHEN** 运维检查 Web 生产运行状态
 - **THEN** Web 服务 MUST 提供可观测的 commit 或 build metadata
 - **AND** 该 metadata MUST NOT 要求为了变更 API 域名而重新构建 Web 镜像
 
 ### Requirement: 健康检查必须区分进程可用与依赖状态
+
 健康能力 SHALL 明确区分服务进程可用和 PostgreSQL/Redis 等依赖检查，避免短暂依赖抖动导致容器被错误重启。
 
 #### Scenario: 默认健康检查不执行深度依赖检查
+
 - **WHEN** 容器运行默认 healthcheck
 - **THEN** API MUST 只验证进程和 HTTP 处理能力可用
 - **AND** PostgreSQL 或 Redis 深度检查 MUST NOT 成为默认容器重启条件，除非文档和 compose 明确选择深度模式
 
 #### Scenario: 深度健康检查可用于部署 smoke
+
 - **WHEN** 部署 runbook 需要验证 PostgreSQL 或 Redis 可用性
 - **THEN** 系统 MAY 提供单独的深度检查模式或 smoke 命令
 - **AND** 深度检查失败 MUST 返回可观测失败状态但不得泄漏 secret
-
diff --git a/openspec/specs/production-ops/spec.md b/openspec/specs/production-ops/spec.md
index e28cf4b..26bfbd7 100644
--- a/openspec/specs/production-ops/spec.md
+++ b/openspec/specs/production-ops/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义 cnode-next 作为 nodeclub 线上行为完全替代品之前必须通过的 URL、API、写入副作用、生产 smoke、不可变镜像和发布准入验收矩阵。
+
 ## Requirements
+
 ### Requirement: nodeclub 线上替代验收矩阵
 
 系统 SHALL 在切换线上流量前通过 nodeclub online replacement 验收矩阵，证明公开 URL、API 契约、业务副作用、生产周边行为和容器运行方式均可替代旧站。生产验收 MUST 确认部署过程不会执行镜像构建，并且 API、Web 和 worker 必须来自已通过 release verification gate 的不可变镜像发布物。
@@ -51,51 +53,62 @@
 - **AND** Web 镜像 MUST NOT 因 API 域名变化而重新构建
 
 ### Requirement: 发布准入必须全绿
+
 生产部署 SHALL 只允许使用通过 release verification gate 的镜像发布物。
 
 #### Scenario: release gate 失败
+
 - **WHEN** lint、typecheck、test、build、OpenSpec strict validate 或 secret scan 任一项失败
 - **THEN** CI MUST NOT 发布生产镜像
 - **AND** 运维 MUST NOT 将该 commit 部署到生产
 
 #### Scenario: release gate 成功
+
 - **WHEN** release verification gate 全部通过
 - **THEN** CI MAY 发布 API 和 Web 生产镜像
 - **AND** 发布记录 MUST 绑定 Git commit、image tag 或 digest
 
 ### Requirement: 生产邮件路径不得假成功
+
 生产环境中的账号激活、密码找回、回复通知和 @ 通知邮件 SHALL 在 SMTP 缺失或发送失败时可观测，并且关键账号邮件不得返回误导性的成功响应。
 
 #### Scenario: 生产缺少 SMTP 配置
+
 - **WHEN** 非 development 环境缺少 `SMTP_HOST`
 - **THEN** 账号激活和密码找回邮件发送 MUST 返回失败或阻止对应请求成功
 - **AND** 系统 MUST 记录可观测错误日志
 - **AND** 用户不得看到“邮件已发送”的假成功提示
 
 #### Scenario: SMTP 发送失败
+
 - **WHEN** SMTP 已配置但发送账号激活或密码找回邮件最终失败
 - **THEN** API MUST 返回失败响应
 - **AND** 用户资料和 retrieve key 状态 MUST 保持可重试或明确可恢复
 
 #### Scenario: development 允许跳过邮件
+
 - **WHEN** `CNODE_ENV=development` 且未配置 SMTP
 - **THEN** 系统 MAY 跳过真实发送
 - **AND** 必须在日志中明确标记邮件被跳过
 
 ### Requirement: Turnstile 生产配置必须完整
+
 生产环境 SHALL 配置 Cloudflare Turnstile 所需的站点 key 和 secret key，并确保 secret 不暴露到浏览器。
 
 #### Scenario: Turnstile site key 注入前端
+
 - **WHEN** Web 渲染注册、找回密码或高风险写入表单
 - **THEN** 页面 MUST 能读取公开的 Turnstile site key
 - **AND** site key MAY 暴露给浏览器
 
 #### Scenario: Turnstile secret 仅服务端使用
+
 - **WHEN** API 校验 Turnstile token
 - **THEN** API MUST 使用服务端环境变量中的 Turnstile secret 调用 siteverify
 - **AND** secret MUST NOT 注入到 Web HTML、前端 bundle 或公开配置
 
 #### Scenario: 缺少 Turnstile 配置时生产拒绝启动或拒绝风险请求
+
 - **WHEN** 非 development 环境缺少 Turnstile 必需配置
 - **THEN** 系统 MUST 拒绝依赖 Turnstile 的请求或在启动/健康检查中明确失败
 - **AND** 不得绕过人机验证继续接受高风险请求
diff --git a/openspec/specs/public-api-documentation/spec.md b/openspec/specs/public-api-documentation/spec.md
index 6d3f034..aa2c1ce 100644
--- a/openspec/specs/public-api-documentation/spec.md
+++ b/openspec/specs/public-api-documentation/spec.md
@@ -1,18 +1,24 @@
 # public-api-documentation Specification
 
 ## Purpose
+
 TBD - created by archiving change reach-production-grade-release-readiness. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: API 文档必须面向外部参考和学习
+
 项目 SHALL 提供完整的外部 API reference，使第三方开发者能理解如何调用 CNode API、如何认证、如何处理错误以及如何兼容 legacy nodeclub API v1。API reference MUST 由生成的 OAS 驱动渲染，不再手写端点表格。
 
 #### Scenario: 开发者首次阅读 API 文档
+
 - **WHEN** 外部开发者打开 API reference
 - **THEN** 文档 MUST 展示 base URL、版本策略、认证方式、通用响应结构、错误格式、分页语义和限流说明
 - **AND** 文档 MUST 标注哪些接口公开可读、哪些接口需要登录 session 或 access token
 - **AND** 文档 MUST NOT 将 `localhost` 或本地端口作为 API reference 的主要调用地址
 
 #### Scenario: 开发者调用具体接口
+
 - **WHEN** 外部开发者查看某个 API endpoint
 - **THEN** 文档 MUST 使用 HTTP method 和相对 path 作为接口标题或接口标识，例如 `GET /api/v1/topics`
 - **AND** 文档 MUST 对 path params、query、body 和 response fields 优先使用表格
@@ -20,21 +26,25 @@ TBD - created by archiving change reach-production-grade-release-readiness. Upda
 - **AND** 示例 MUST 使用可复制的 `curl` 或等价 HTTP 请求代码块
 
 #### Scenario: 文档由 OAS 自动渲染
+
 - **WHEN** 开发者访问 `apps/web` 的 API 文档页（`/api` 路由）
 - **THEN** 页面 MUST 使用 `swagger-ui-react` 从 `apps/web/public/openapi.json` 渲染文档
 - **AND** `apps/web/public/openapi.json` MUST 是 `api/openapi.json` 的副本
 - **AND** 项目 MUST NOT 保留手写硬编码的端点表格（`apps/web/app/routes/api.tsx` 中的 `endpoints` 数组）
 
 #### Scenario: Base URL 与 endpoint path
+
 - **WHEN** API reference 展示接口列表或接口详情
 - **THEN** base URL MUST 只在总览中单独说明
 - **AND** endpoint 标题和接口表格 MUST 使用相对 path
 - **AND** curl 示例 MAY 使用完整生产 URL
 
 ### Requirement: API reference 必须使用统一接口模板
+
 API reference SHALL 对每个核心公开接口使用一致的查阅模板，使读者能快速找到 method、path、认证、参数、请求体、响应字段、错误和示例。
 
 #### Scenario: 接口详情模板
+
 - **WHEN** 文档描述一个核心公开 API endpoint
 - **THEN** 文档 MUST 包含 method、relative path、认证要求和一句话 description
 - **AND** 文档 MUST 按需包含 `Path Params`、`Query`、`Body`、`Response`、`Errors` 和 `Example` 信息
@@ -42,93 +52,113 @@ API reference SHALL 对每个核心公开接口使用一致的查阅模板，使
 - **AND** 普通说明、错误摘要和示例 MUST NOT 被机械地全部表格化
 
 #### Scenario: 参数表格
+
 - **WHEN** endpoint 有 path params、query 或 body 字段
 - **THEN** 文档 MUST 使用 `Name`、`Type`、`Required`、`Default` 或 `Description` 等稳定列说明字段
 - **AND** 空 section MAY 省略以保持文档简洁
 
 #### Scenario: 响应和错误表格
+
 - **WHEN** endpoint 有成功响应或错误响应说明
 - **THEN** 文档 MUST 使用表格列出核心 response fields、类型和含义
 - **AND** 常见错误 MUST 使用 status、message/code 和 description 表格描述
 
 ### Requirement: API 契约必须提供 OAS 机器可读文档
+
 项目 SHALL 提供 OpenAPI Specification (OAS) 文档作为外部 API reference 和未来 smoke/contract 验证的机器可读来源。OAS 文档 MUST 由 `apps/api` 路由内的 zod-openapi 声明自动生成，不得手写维护。
 
 #### Scenario: OAS 文件存在
+
 - **WHEN** 外部开发者或验证脚本查找 API 契约
 - **THEN** 仓库 MUST 提供由 `apps/api` 路由 zod-openapi 声明生成的 `api/openapi.json` 文件
 - **AND** README 或 API reference MUST 链接到该 OAS 文件
 - **AND** 项目 MUST NOT 保留手写的 `api/openapi.yaml` 或任何与路由声明脱节的手写 OAS 文件
 
 #### Scenario: OAS 从路由自动生成
+
 - **WHEN** 开发者修改 `apps/api/src/routes/*.ts` 中某个端点的 path、method、zod schema 或 OpenAPI metadata
 - **THEN** 运行 `pnpm gen:openapi` MUST 重新生成 `api/openapi.json` 反映该变更
 - **AND** `pnpm verify` 流程 MUST 在 `verify:openapi` 之前自动执行 `gen:openapi`
 - **AND** 生成的 `api/openapi.json` MUST 不包含 `x-contract-response-fields` 扩展——响应 schema 由完整 zod 定义描述
 
 #### Scenario: OAS 可被工具读取
+
 - **WHEN** 验证脚本或 OpenAPI 工具读取 OAS 文件
 - **THEN** OAS MUST 定义 `openapi` 版本、`info`、`servers`、`paths`、`components.schemas` 和认证方案
 - **AND** OAS MUST 不包含生产 secret、真实用户 token 或私有环境变量
 
 ### Requirement: OAS 接口必须按对外能力分组
+
 OAS SHALL 使用 tags 按外部能力分组，而不是按代码文件、数据库表或内部模块分组。
 
 #### Scenario: 核心接口分组
+
 - **WHEN** 外部开发者浏览 OAS tags
 - **THEN** tags MUST 至少覆盖帖子、回复、用户、收藏、消息、认证、搜索和系统配置
 - **AND** 帖子与回复能力 MUST 作为最核心分组出现在文档中
 
 #### Scenario: 管理和内部接口分组
+
 - **WHEN** OAS 包含后台管理、巡检或运维接口
 - **THEN** 这些接口 MUST 使用单独 tag 标记为管理或内部能力
 - **AND** 文档 MUST 明确它们不是普通外部客户端的主要集成入口
 
 ### Requirement: OAS 必须优先覆盖帖子和回复能力
+
 OAS SHALL 第一优先级覆盖对外展示和客户端高频使用的帖子、回复、用户、收藏和消息能力。
 
 #### Scenario: 帖子 API 覆盖
+
 - **WHEN** 外部开发者查看帖子能力
 - **THEN** OAS MUST 覆盖帖子列表、帖子详情、发帖、编辑帖子和相关参数
 - **AND** OAS MUST 展示成功响应、错误响应、分页和 `mdrender` 语义
 
 #### Scenario: 回复 API 覆盖
+
 - **WHEN** 外部开发者查看回复能力
 - **THEN** OAS MUST 覆盖回复列表或帖子回复、创建回复、编辑回复、删除回复、点赞和取消点赞
 - **AND** OAS MUST 展示回复作者、内容、时间、点赞状态和 legacy-compatible 字段
 
 #### Scenario: 用户、收藏和消息 API 覆盖
+
 - **WHEN** 外部开发者查看用户、收藏和消息能力
 - **THEN** OAS MUST 覆盖用户资料、用户话题、用户回复、收藏/取消收藏、消息列表和消息已读
 - **AND** OAS MUST 标注每个接口的认证要求
 
 ### Requirement: API 文档必须覆盖 nodeclub 兼容语义
+
 API reference SHALL 明确 `/api/v1/*` 与 legacy `../nodeclub/api_router_v1.js` 和 `../nodeclub/api/v1/` 的兼容关系，但兼容背景 MUST 保持简洁并集中说明。
 
 #### Scenario: 兼容字段说明
+
 - **WHEN** API 响应包含 legacy 字段名、嵌套结构或兼容行为
 - **THEN** 文档 MUST 标明字段含义和兼容原因
 - **AND** 文档 MUST 标明任何显式废弃、redirect 或不再支持的 legacy 行为
 
 #### Scenario: Markdown 内容渲染说明
+
 - **WHEN** API endpoint 返回 topic、reply 或 message content
 - **THEN** 文档 MUST 说明 `mdrender` 参数或默认渲染语义
 - **AND** 文档 MUST 给出原始 Markdown 与 HTML 渲染响应的示例
 
 ### Requirement: API 文档必须与发布验证关联
+
 API 文档 SHALL 作为 release verification 的检查项，避免实现、OpenSpec 和外部文档长期漂移，但普通 API reference MUST NOT 使用内部评级语言作为读者主叙事。
 
 #### Scenario: 发布前检查 API 文档
+
 - **WHEN** release checklist 被执行
 - **THEN** checklist MUST 要求确认新增或变更 API 已更新 API reference
 - **AND** 若 API 行为发生变化但文档未更新，发布 MUST 被视为未满足发布准入
 
 #### Scenario: API smoke 与文档示例一致
+
 - **WHEN** API smoke 或 contract verifier 覆盖某个公开 endpoint
 - **THEN** 文档中的示例响应 shape MUST 与 verifier 期望的核心字段一致
 - **AND** 文档不得展示已废弃或不可调用的示例作为推荐用法
 
 #### Scenario: OAS 被 smoke 或 contract 验证复用
+
 - **WHEN** 未来实现 API smoke 或 contract verifier
 - **THEN** verifier SHOULD 复用 OAS 中的 paths、methods、schemas 或 examples 作为检查来源
 - **AND** 若 verifier 暂未完全复用 OAS，release checklist MUST 明确记录覆盖差距
diff --git a/openspec/specs/rate-limiting/spec.md b/openspec/specs/rate-limiting/spec.md
index cbc8198..30adf87 100644
--- a/openspec/specs/rate-limiting/spec.md
+++ b/openspec/specs/rate-limiting/spec.md
@@ -1,8 +1,11 @@
 # rate-limiting Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 限流行为对齐
 
 限流 MUST 与 nodeclub `middlewares/limit.js` 的行为对齐。系统 MUST 通过 Redis INCR + EXPIRE 实现 peruserperday 和 peripperday 限流，将限流中间件挂载到 legacy 等价写入入口，并返回 X-RateLimit headers。
@@ -45,19 +48,23 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 不存在只定义 middleware 但未使用的限流路径
 
 ### Requirement: 后台限流配置必须被写入路径读取
+
 系统 SHALL 让后台系统设置中的发帖和回复限流配置影响对应写入路径，而不是只保存配置值。
 
 #### Scenario: 发帖限流读取后台配置
+
 - **WHEN** admin 在系统设置中修改 `rate_topic`
 - **THEN** 创建话题限流 MUST 使用最新配置值作为每日上限
 - **AND** 超过该上限时 MUST 返回 403 和 RateLimit headers
 
 #### Scenario: 回复限流读取后台配置
+
 - **WHEN** admin 在系统设置中修改 `rate_reply`
 - **THEN** 创建回复限流 MUST 使用最新配置值作为每日上限
 - **AND** 超过该上限时 MUST 返回 403 和 RateLimit headers
 
 #### Scenario: 配置缺失时使用安全默认值
+
 - **WHEN** `site_settings` 中不存在 `rate_topic` 或 `rate_reply`
 - **THEN** 系统 MUST 使用代码默认上限
 - **AND** 不得因为配置缺失导致写入路径报错
diff --git a/openspec/specs/release-verification-gates/spec.md b/openspec/specs/release-verification-gates/spec.md
index 4cd9276..9cbca64 100644
--- a/openspec/specs/release-verification-gates/spec.md
+++ b/openspec/specs/release-verification-gates/spec.md
@@ -1,37 +1,45 @@
 # release-verification-gates Specification
 
 ## Purpose
+
 TBD - created by archiving change reach-production-grade-release-readiness. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 发布验证入口必须统一
 
 项目 SHALL 提供统一的 `pnpm verify` 命令作为本地、CI 和生产部署前的发布准入入口。
 
 #### Scenario: 本地运行发布验证
+
 - **WHEN** 开发者在仓库根目录运行 `pnpm verify`
 - **THEN** 命令 MUST 执行 lint、typecheck、test、build、OpenSpec strict validate 和 secret scan
 - **AND** 任一子命令失败时 `pnpm verify` MUST 以非零退出码失败
 
 #### Scenario: CI 复用同一验证入口
+
 - **WHEN** GitHub Actions 验证 PR 或 main 分支提交
 - **THEN** workflow MUST 运行与本地一致的 `pnpm verify`
 - **AND** workflow MUST NOT 使用少于本地发布验证的命令集合
 
 ### Requirement: 发布门禁必须阻断失败变更
+
 发布验证 gate SHALL 在代码质量、类型、测试、构建、OpenSpec 或 secret scan 任一项失败时阻断镜像发布。
 
 #### Scenario: lint 失败阻断发布
+
 - **WHEN** `pnpm lint` 返回非零退出码
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
 
 #### Scenario: OpenSpec strict validate 失败阻断发布
+
 - **WHEN** `openspec validate --all --strict` 返回非零退出码
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
 
 #### Scenario: secret scan 失败阻断发布
+
 - **WHEN** secret scan 发现未允许的 secret
 - **THEN** `pnpm verify` MUST 失败
 - **AND** CI MUST NOT 构建或推送生产镜像
-
diff --git a/openspec/specs/runtime-environment-contract/spec.md b/openspec/specs/runtime-environment-contract/spec.md
index dc1bc8b..c829451 100644
--- a/openspec/specs/runtime-environment-contract/spec.md
+++ b/openspec/specs/runtime-environment-contract/spec.md
@@ -1,44 +1,56 @@
 # runtime-environment-contract Specification
 
 ## Purpose
+
 TBD - created by archiving change standardize-runtime-environment-contract. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Runtime environment variables SHALL use semantic prefixes
+
 cnode-next 应用配置 MUST 将原 `APP_*` 前缀替换为 `CNODE_*`；PostgreSQL 与 Redis 配置 MUST 分别使用既有生态前缀 `POSTGRES_*` 与 `REDIS_*`，使变量名称明确表达配置归属和属性。
 
 #### Scenario: Maintainer adds a project runtime variable
+
 - **WHEN** 维护者为 cnode-next 增加新的应用运行时环境变量
 - **THEN** 变量名 MUST 以 `CNODE_` 开头
 - **AND** 名称 MUST 使用能够表达资源、能力和属性的完整单词
 - **AND** PostgreSQL 或 Redis 连接字段 MUST NOT 添加 `CNODE_` 前缀
 
 #### Scenario: Legacy application variable is supplied
+
 - **WHEN** 进程只提供 `APP_*` 应用配置
 - **THEN** 应用 MUST NOT 将其作为 `CNODE_*` 的 alias 或 fallback
 
 #### Scenario: Same contract is used in different environments
+
 - **WHEN** 本地、rehearsal、CI 或 production 为同一运行时能力提供不同配置值
 - **THEN** 各环境 MUST 使用相同变量名
 - **AND** 部署环境名称 MUST NOT 编码到变量名中
 
 ### Requirement: PostgreSQL connection SHALL use one CNODE contract
+
 所有 PostgreSQL 运行时消费者 MUST 只使用 `POSTGRES_HOST`、`POSTGRES_PORT`、`POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD`。
 
 #### Scenario: PostgreSQL config is parsed
+
 - **WHEN** API、worker、Drizzle、migration、seed 或运维脚本建立 PostgreSQL 连接
 - **THEN** `POSTGRES_HOST`、`POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD` MUST 为非空值
 - **AND** 未提供 `POSTGRES_PORT` 时 MUST 使用唯一默认值 `5432`
 - **AND** 无效端口 MUST 在建立连接前失败
 
 #### Scenario: Legacy PostgreSQL variable is supplied
+
 - **WHEN** 进程只提供 `DB_HOST`、`DB_PORT`、`DB_NAME`、`DB_USER`、`DB_PASSWORD` 或 `DATABASE_URL`
 - **THEN** PostgreSQL 配置解析 MUST 失败并指出缺少的新变量名
 - **AND** 系统 MUST NOT 将旧变量作为 alias 或 fallback
 
 ### Requirement: Redis connection SHALL use one CNODE contract
+
 所有真实 Redis 运行时消费者 MUST 只使用 `REDIS_HOST`、`REDIS_PORT`、`REDIS_DB` 和 `REDIS_PASSWORD`。
 
 #### Scenario: Redis config is parsed
+
 - **WHEN** API 或 worker 选择真实 Redis client
 - **THEN** `REDIS_HOST` MUST 为非空值
 - **AND** 未提供 `REDIS_PORT` 时 MUST 使用 `6379`
@@ -46,54 +58,66 @@ cnode-next 应用配置 MUST 将原 `APP_*` 前缀替换为 `CNODE_*`；PostgreS
 - **AND** port 与 database index MUST 在建立连接前验证为有效整数
 
 #### Scenario: Test does not use a real Redis service
+
 - **WHEN** 自动化测试通过 mock 或 fake 边界验证 API 行为
 - **THEN** 测试 MUST NOT 要求真实 `REDIS_*` 凭据
 - **AND** mock 选择 MUST NOT 由部分缺失的生产连接变量静默触发
 
 ### Requirement: Runtime resource config SHALL be parsed centrally
+
 PostgreSQL 与 Redis 配置的必填校验、类型转换和默认值 MUST 由共享的 typed parser 统一定义，消费者不得各自解释同一环境变量。
 
 #### Scenario: Multiple consumers create resource clients
+
 - **WHEN** API、worker、DB package、Drizzle config 或独立脚本读取同一资源配置
 - **THEN** 所有消费者 MUST 获得相同字段、默认值和验证结果
 - **AND** PostgreSQL consumer MUST 使用结构化连接字段而不是手工拼接连接 URL
 
 #### Scenario: Secret config is invalid
+
 - **WHEN** password 等 secret 变量缺失或无效
 - **THEN** 错误信息 MUST 只标识变量名和错误类型
 - **AND** 错误、日志和健康响应 MUST NOT 包含 secret 值
 
 ### Requirement: Compose SHALL inject the unified environment file directly
+
 Production Compose MUST use `env_file` to inject the unified runtime configuration and MUST NOT repeat the complete variable contract in each service.
 
 #### Scenario: Compose initializes PostgreSQL
+
 - **WHEN** production Compose 配置 PostgreSQL 官方镜像
 - **THEN** Compose MUST 通过 `env_file` 向运行时 service 注入统一配置
 - **AND** PostgreSQL 官方镜像 MUST 直接消费 `POSTGRES_DB`、`POSTGRES_USER` 和 `POSTGRES_PASSWORD`
 - **AND** operator MUST NOT 被要求为同一值维护第二套输入变量
 
 ### Requirement: Contract migration SHALL be an atomic hard cutover
+
 受版本控制的代码、模板、Compose、测试、活跃 specs 和文档 MUST 在同一个 change 中一次性切换到新契约，不得提供兼容窗口。
 
 #### Scenario: Repository is checked after migration
+
 - **WHEN** 实施完成后检查 shipped source 和活跃文档
 - **THEN** 不得存在旧 PostgreSQL 或 Redis 运行时变量引用
 - **AND** 不得存在新旧变量 alias、fallback 或 deprecated compatibility path
 
 #### Scenario: New required variables are absent
+
 - **WHEN** 运行时仍只配置旧变量
 - **THEN** 依赖该资源的进程 MUST 快速失败
 - **AND** 进程 MUST NOT 静默连接默认、旧或其他环境的资源
 
 ### Requirement: Real dotenv files SHALL remain human-managed and untouched
+
 自动实施与验证 MUST NOT 读取、打印、修改、覆盖、删除或自动迁移开发者真实 dotenv 文件。
 
 #### Scenario: Tracked templates are migrated
+
 - **WHEN** 实施者更新 `.env.example` 或 `deployment/.env.production.example`
 - **THEN** 只能写入新变量及非敏感占位值
 - **AND** 不得根据真实 dotenv 内容生成模板
 
 #### Scenario: Real dotenv files exist in the workspace
+
 - **WHEN** 实施或验证发现真实 dotenv 文件
 - **THEN** 必须保持文件及其内容不变
 - **AND** 真实配置迁移 MUST 留给后续明确授权的人工流程
diff --git a/openspec/specs/scoring/spec.md b/openspec/specs/scoring/spec.md
index 75cb554..936ff70 100644
--- a/openspec/specs/scoring/spec.md
+++ b/openspec/specs/scoring/spec.md
@@ -1,8 +1,11 @@
 # scoring Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 积分和计数器行为对齐
 
 发帖、回复、删除等操作 MUST 正确修改对应的积分和计数器。egg-cnode 存在 bug:发帖时调用了 `incrementScoreAndReplyCount`(reply_count+1 而非 topic_count+1),新项目 MUST 修正。
@@ -54,4 +57,3 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 
 - **WHEN** 创建回复
 - **THEN** 调用的函数签名为 `incrementScoreAndReplyCount(userId, score, replyCount)`
-
diff --git a/openspec/specs/secret-scanning/spec.md b/openspec/specs/secret-scanning/spec.md
index 58d2cf4..82bab94 100644
--- a/openspec/specs/secret-scanning/spec.md
+++ b/openspec/specs/secret-scanning/spec.md
@@ -1,13 +1,17 @@
 # secret-scanning Specification
 
 ## Purpose
+
 定义仓库 secret scanning 的本地规则源、hook 安装方式、提交/推送阻断行为和开发者文档要求。
+
 ## Requirements
+
 ### Requirement: Gitleaks 配置作为唯一规则源
 
 仓库 SHALL 使用根目录 `.gitleaks.toml` 作为 secret scanning 的唯一规则源。所有本地命令、git hooks 和后续 CI 命令 MUST 显式使用该配置文件。
 
 #### Scenario: 手动运行全量扫描
+
 - **WHEN** 开发者运行项目定义的 secret scan 命令
 - **THEN** 命令使用 `.gitleaks.toml`
 - **AND** 输出不得展示完整 secret 值
@@ -17,6 +21,7 @@
 仓库 SHALL 提供一条项目命令安装本地 git hooks。安装命令 MUST 使用 Husky 安装仓库内版本化 hook。
 
 #### Scenario: 安装 hooks
+
 - **WHEN** 开发者运行 hooks 安装命令
 - **THEN** 当前仓库安装了 Husky 管理的本地 hooks
 - **AND** 不修改全局 git 配置
@@ -26,11 +31,13 @@
 本地 pre-commit hook MUST 在创建 commit 前扫描 staged changes。检测到 secret 时 MUST 阻断提交，并提示开发者修复内容或更新 allowlist。
 
 #### Scenario: staged secret 被阻断
+
 - **WHEN** staged changes 包含 `.gitleaks.toml` 规则识别出的 secret
 - **THEN** `git commit` 被阻断
 - **AND** 输出包含运行 gitleaks 的失败提示
 
 #### Scenario: staged changes 无 secret
+
 - **WHEN** staged changes 不包含 secret
 - **THEN** `git commit` 可以继续
 
@@ -39,6 +46,7 @@
 本地 pre-push hook MUST 扫描即将推送的 commit range。检测到 secret 时 MUST 阻断推送。
 
 #### Scenario: 推送范围内 secret 被阻断
+
 - **WHEN** 即将推送的 commit range 包含 secret
 - **THEN** `git push` 被阻断
 - **AND** 输出包含失败原因和手动复查命令
@@ -48,6 +56,7 @@
 本地 hooks MUST 在找不到 `gitleaks` 命令时失败，并提示安装方式或项目文档位置。hooks MUST NOT 静默跳过 secret scanning。
 
 #### Scenario: 未安装 gitleaks
+
 - **WHEN** 开发者运行 `git commit` 或 `git push` 且本机没有 `gitleaks`
 - **THEN** hook 阻断操作
 - **AND** 输出提示安装 gitleaks
@@ -57,18 +66,22 @@
 仓库 SHALL 文档化 secret scanning 的安装流程、手动扫描命令、误报处理方式和临时跳过方式。临时跳过方式 MUST 显式命名为风险操作。
 
 #### Scenario: 开发者查看文档
+
 - **WHEN** 开发者需要配置本地 secret scanning
 - **THEN** 文档提供安装命令、扫描命令、失败处理和跳过风险说明
 
 ### Requirement: CI release gate 必须执行 secret scanning
+
 CI release verification gate SHALL 使用仓库根目录 `.gitleaks.toml` 执行 secret scan，并在发现未允许 secret 时阻断镜像发布。
 
 #### Scenario: CI secret scan 通过
+
 - **WHEN** GitHub Actions 运行 release verification gate 且未发现 secret
 - **THEN** secret scanning step MUST 成功
 - **AND** 后续验证步骤 MAY 继续执行
 
 #### Scenario: CI secret scan 失败
+
 - **WHEN** GitHub Actions 运行 release verification gate 且发现 `.gitleaks.toml` 规则识别出的 secret
 - **THEN** release verification gate MUST 失败
 - **AND** workflow MUST NOT 构建或推送生产镜像
diff --git a/openspec/specs/seo/spec.md b/openspec/specs/seo/spec.md
index f5375e4..ac3ff5f 100644
--- a/openspec/specs/seo/spec.md
+++ b/openspec/specs/seo/spec.md
@@ -1,8 +1,11 @@
 # seo Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Open Graph 标签
 
 系统 MUST 在页面 head 中输出 Open Graph 和 Twitter Card 标签，使社交分享时显示预览卡片；所有公开可分享页面 MUST 提供站点名、页面标题、描述、绝对 URL 和图片，并在页面没有专属图片时使用 CNode 默认分享图。
@@ -103,4 +106,3 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **WHEN** 客户端读取 manifest icons
 - **THEN** icons SHALL 引用 `/cnode/icon-192.png` 和 `/cnode/icon-512.png`
 - **AND** 图标资源 SHALL 使用 CNode 自有品牌标识。
-
diff --git a/openspec/specs/session-management/spec.md b/openspec/specs/session-management/spec.md
index 96a80dd..54e0cae 100644
--- a/openspec/specs/session-management/spec.md
+++ b/openspec/specs/session-management/spec.md
@@ -1,8 +1,11 @@
 # session-management Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 密码强度校验
 
 系统 MUST 在注册和修改密码时校验密码强度。
@@ -40,4 +43,3 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **WHEN** 用户登录
 - **THEN** session 记录存入 Redis, key 包含 session_id + user_id
 - **AND** 每次请求更新最后活跃时间
-
diff --git a/openspec/specs/staged-mongo-pg-cutover/spec.md b/openspec/specs/staged-mongo-pg-cutover/spec.md
index 4759036..95a35b4 100644
--- a/openspec/specs/staged-mongo-pg-cutover/spec.md
+++ b/openspec/specs/staged-mongo-pg-cutover/spec.md
@@ -1,37 +1,49 @@
 # staged-mongo-pg-cutover Specification
 
 ## Purpose
+
 TBD - created by archiving change staged-mongo-pg-cutover-runbook. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Mongo SHALL be the single source of truth before cutover
+
 The migration process MUST treat MongoDB as the only authoritative data source until final cutover is completed.
 
 #### Scenario: Parallel validation window
+
 - **WHEN** cnode and cnode-next run in parallel before cutover
 - **THEN** all production data decisions MUST use MongoDB records as final truth
 
 #### Scenario: Test writes on new site
+
 - **WHEN** internal testers create or edit data on cnode-next during parallel validation
 - **THEN** those writes MUST be considered disposable and MAY be overwritten by the next full rerun
 
 ### Requirement: Final cutover SHALL require legacy write freeze
+
 The cutover process MUST freeze legacy writes before the final full migration run.
 
 #### Scenario: Enter maintenance mode
+
 - **WHEN** cutover starts
 - **THEN** legacy cnode MUST stop accepting write operations before final migration begins
 
 #### Scenario: Final full rerun after freeze
+
 - **WHEN** legacy writes are frozen
 - **THEN** migration tooling MUST execute one final full Mongo-to-PG load before traffic switch
 
 ### Requirement: Cutover SHALL be gated by reconciliation checks
+
 Traffic switch to cnode-next MUST occur only after required reconciliation checks pass.
 
 #### Scenario: Required count checks
+
 - **WHEN** final full rerun completes
 - **THEN** the process MUST verify user/topic/reply/message totals and reply_ups totals against migration expectations
 
 #### Scenario: Required smoke checks
+
 - **WHEN** count checks pass
 - **THEN** the process MUST run critical smoke flows (auth, topic read/write path, message visibility) before switching traffic
diff --git a/openspec/specs/topic-detail-experience/spec.md b/openspec/specs/topic-detail-experience/spec.md
index b2380da..9529b6b 100644
--- a/openspec/specs/topic-detail-experience/spec.md
+++ b/openspec/specs/topic-detail-experience/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义话题详情页的阅读布局、上下文信息、正文展示和状态处理要求，确保迁移后的话题内容在桌面和移动端都具备清晰层级、可读排版和可用交互。
+
 ## Requirements
+
 ### Requirement: Topic 详情 reading layout
 
 Topic 详情页 SHALL 根据 viewport 使用 reading layout，包含主 topic 内容和右侧上下文 rail。目录不得占用独立左侧 rail；主内容列在响应式断点前后 MUST 保持连续且可读的宽度变化。
diff --git a/openspec/specs/topic-pin-management/spec.md b/openspec/specs/topic-pin-management/spec.md
index 8da03bb..07e5855 100644
--- a/openspec/specs/topic-pin-management/spec.md
+++ b/openspec/specs/topic-pin-management/spec.md
@@ -3,42 +3,52 @@
 ## Purpose
 
 管理员和版主在后台对话题执行置顶/取消置顶，并保证公开列表排序和状态展示与 legacy 行为一致。
+
 ## Requirements
+
 ### Requirement: 后台置顶切换
+
 系统 SHALL 允许 `mod` 和 `admin` 在后台对一个或多个话题执行置顶切换操作，切换行为 MUST 与 legacy nodeclub 的 `POST /topic/:tid/top` 保持一致。
 
 #### Scenario: 版主置顶未置顶话题
+
 - **WHEN** `mod` 在后台话题管理页对未置顶话题执行置顶切换
 - **THEN** 系统将该话题 `top` 设置为 true
 - **AND** 返回操作成功
 - **AND** 后台话题列表显示该话题的“置顶”状态
 
 #### Scenario: 管理员取消已置顶话题
+
 - **WHEN** `admin` 在后台话题管理页对已置顶话题执行置顶切换
 - **THEN** 系统将该话题 `top` 设置为 false
 - **AND** 返回操作成功
 - **AND** 后台话题列表不再显示该话题的“置顶”状态
 
 #### Scenario: 批量切换置顶状态
+
 - **WHEN** `mod` 或 `admin` 选择多个话题并执行置顶切换
 - **THEN** 系统对每个选中话题分别翻转 `top` 状态
 - **AND** 操作不改变话题的 `good`、`lock`、`status`、`deleted`、`reply_count`、`visit_count`、`create_at` 或 `last_reply_at`
 
 #### Scenario: 普通用户不可置顶
+
 - **WHEN** 非 `mod` 且非 `admin` 的用户请求置顶切换接口
 - **THEN** 系统拒绝请求并返回权限错误
 - **AND** 目标话题的 `top` 状态保持不变
 
 ### Requirement: 置顶话题公开展示
+
 系统 MUST 在公开话题列表中优先展示置顶话题，并对置顶话题显示“置顶”标记。
 
 #### Scenario: 首页排序置顶优先
+
 - **WHEN** 用户访问公开话题列表
 - **THEN** `top=true` 的话题排在普通话题前面
 - **AND** 置顶话题之间按 `last_reply_at` 倒序排序
 - **AND** 普通话题之间仍按 `last_reply_at` 倒序排序
 
 #### Scenario: 置顶标记展示
+
 - **WHEN** 公开话题列表返回的话题 `top=true`
 - **THEN** Web 列表项显示“置顶”状态标记
 
@@ -47,26 +57,29 @@
 系统 MUST 允许 admin 和 mod 在帖子详情页对当前话题执行置顶/取消置顶和高亮/取消高亮，并保证公开展示状态与后台管理一致。
 
 #### Scenario: 帖子详情页置顶切换
+
 - **WHEN** admin 或 mod 在帖子详情页对未置顶话题执行置顶操作
 - **THEN** 系统 MUST 将目标话题 `top` 设置为 true
 - **AND** 公开话题列表 MUST 优先展示该话题并显示置顶状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页取消置顶
+
 - **WHEN** admin 或 mod 在帖子详情页对已置顶话题执行取消置顶操作
 - **THEN** 系统 MUST 将目标话题 `top` 设置为 false
 - **AND** 公开话题列表 MUST 不再显示该话题为置顶状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页高亮切换
+
 - **WHEN** admin 或 mod 在帖子详情页对普通话题执行高亮操作
 - **THEN** 系统 MUST 将目标话题 `good` 设置为 true
 - **AND** 话题详情和列表 MUST 展示高亮或精华状态
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 帖子详情页取消高亮
+
 - **WHEN** admin 或 mod 在帖子详情页对已高亮话题执行取消高亮操作
 - **THEN** 系统 MUST 将目标话题 `good` 设置为 false
 - **AND** 话题详情和列表 MUST 不再展示高亮或精华状态
 - **AND** 系统 MUST 写入审计日志
-
diff --git a/openspec/specs/user-management/spec.md b/openspec/specs/user-management/spec.md
index 1f32b6a..4378c65 100644
--- a/openspec/specs/user-management/spec.md
+++ b/openspec/specs/user-management/spec.md
@@ -1,8 +1,11 @@
 # user-management Specification
 
 ## Purpose
+
 TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 管理员重置用户密码
 
 系统 MUST 支持管理员快速重置任意用户的密码,无需知道原密码。
@@ -113,18 +116,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 MUST 允许 admin 在用户主页对目标用户执行 block/unblock 操作，操作效果必须与后台用户管理中的禁言/解禁一致。
 
 #### Scenario: 用户页封禁用户
+
 - **WHEN** admin 在用户主页点击封禁用户
 - **THEN** 系统 MUST 将目标用户 `is_block` 设置为 true
 - **AND** 目标用户 MUST 无法继续发帖、回复或点赞
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 用户页解禁用户
+
 - **WHEN** admin 在已封禁用户主页点击解禁用户
 - **THEN** 系统 MUST 将目标用户 `is_block` 设置为 false
 - **AND** 目标用户恢复普通用户可执行的发帖、回复和点赞能力
 - **AND** 系统 MUST 写入审计日志
 
 #### Scenario: 非管理员不可在用户页封禁或解禁
+
 - **WHEN** 非 admin 用户尝试调用用户页封禁或解禁接口
 - **THEN** 系统 MUST 返回权限错误
 - **AND** 目标用户 `is_block` 状态保持不变
@@ -134,18 +140,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 为 admin 提供 block/unblock 和 mute/unmute 两组独立用户操作。block 控制目标用户内容在公共接口和公共页面中的可见性；mute 控制目标用户继续新增话题和回复的能力。
 
 #### Scenario: 管理员 block 用户
+
 - **WHEN** admin 对目标用户执行 block
 - **THEN** 系统 MUST 将目标用户标记为 block 状态
 - **AND** 目标用户创建的话题 MUST 不再出现在公共列表、sidebar、用户聚合和收藏结果中
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 unblock 用户
+
 - **WHEN** admin 对处于 block 状态的目标用户执行 unblock
 - **THEN** 系统 MUST 取消目标用户 block 状态
 - **AND** 目标用户已有内容恢复按普通公开规则展示
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 mute 用户
+
 - **WHEN** admin 对目标用户执行 mute
 - **THEN** 系统 MUST 将目标用户标记为 mute 状态
 - **AND** 目标用户 MUST 无法新增话题或回复
@@ -153,12 +162,14 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 管理员 unmute 用户
+
 - **WHEN** admin 对处于 mute 状态的目标用户执行 unmute
 - **THEN** 系统 MUST 取消目标用户 mute 状态
 - **AND** 目标用户恢复新增话题和回复能力，除非仍受其他限制
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 历史禁言状态兼容
+
 - **WHEN** 系统部署 block/mute 双状态
 - **THEN** 现有 `is_block=true` 用户 MUST 不恢复新增话题或回复能力
 - **AND** 迁移或兼容逻辑 MUST 将这些用户视为已 mute，直到 admin 明确 unmute
@@ -168,6 +179,7 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 在用户主页为 admin 提供删除目标用户所有发言的入口，行为对齐 `nodeclub/web_router.js` 中 `POST /user/:name/delete_all` 的管理员操作。
 
 #### Scenario: 管理员在用户主页删除用户所有发言
+
 - **WHEN** admin 访问任意用户主页
 - **THEN** 页面 MUST 显示“删除该用户所有发言”或等价明确文案的操作入口
 - **AND** 操作前 MUST 要求确认目标用户和影响范围
@@ -175,38 +187,45 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 - **AND** 后端 MUST 写入审计日志
 
 #### Scenario: 非管理员不可批量删除用户发言
+
 - **WHEN** 非 admin 用户访问用户主页或直接调用批量删除接口
 - **THEN** 页面 MUST NOT 显示批量删除入口
 - **AND** 后端 MUST 返回权限错误
 - **AND** 目标用户内容状态保持不变
 
 #### Scenario: 批量删除后公开接口不可见
+
 - **WHEN** admin 成功删除某用户所有发言
 - **THEN** 该用户话题 MUST 不再出现在首页、用户话题、用户参与、用户收藏、最新回复和无人回复等公共入口
 - **AND** 该用户回复 MUST 不再出现在话题详情回复列表和最新回复模块
 
 ### Requirement: 管理员不得对自己执行限制或破坏性用户操作
+
 系统 SHALL 阻止管理员对当前登录账号执行会限制自身能力或破坏自身内容的高风险用户管理动作。
 
 #### Scenario: 管理员不能 block 自己
+
 - **WHEN** admin 调用用户 block 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_block` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能 mute 自己
+
 - **WHEN** admin 调用用户 mute 接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的 `is_muted` 状态 MUST 保持不变
 - **AND** 系统 MUST NOT 写入成功审计日志
 
 #### Scenario: 管理员不能删除自己所有发言
+
 - **WHEN** admin 调用删除用户所有发言接口且目标用户是当前登录 admin
 - **THEN** 系统 MUST 返回错误响应
 - **AND** 当前 admin 的话题和回复删除状态 MUST 保持不变
 - **AND** 系统 MUST NOT 扣减当前 admin 的内容计数
 
 #### Scenario: 前端隐藏自操作入口
+
 - **WHEN** admin 在后台用户管理页或用户主页查看自己的账号
 - **THEN** 页面 MUST NOT 提供 block、mute 或删除所有发言的可执行入口
 - **AND** 后台用户管理菜单 MUST NOT 提供影响当前 admin 自身角色或自身能力的可执行入口
@@ -217,17 +236,20 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 允许管理员在后台用户管理页按 loginname 或 email 搜索用户，搜索提交、翻页和管理操作后的重新校验结果 MUST 与当前 URL 查询参数一致。
 
 #### Scenario: 管理员搜索用户
+
 - **WHEN** 管理员在 `/admin/users` 输入搜索词并提交
 - **THEN** 页面 MUST 展示匹配当前搜索词的用户列表
 - **AND** 列表总数 MUST 反映匹配后的 total
 - **AND** 搜索框 MUST 保留当前搜索词
 
 #### Scenario: 搜索结果翻页
+
 - **WHEN** 管理员在带有搜索词的用户列表中翻页
 - **THEN** 页面 MUST 保留当前搜索词
 - **AND** 下一页数据 MUST 仍按当前搜索词过滤
 
 #### Scenario: 用户管理操作后保留搜索上下文
+
 - **WHEN** 管理员在搜索结果中执行 block、unblock、mute、unmute、角色变更、重置密码或删除所有发言并成功
 - **THEN** 页面 MUST 重新加载当前查询上下文的数据
 - **AND** MUST NOT 回退到未搜索的用户列表
@@ -237,18 +259,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 允许 admin 在后台用户治理入口中对多个处于 mute 状态的用户执行批量解除禁言。批量解除禁言 MUST 只取消目标用户的 `is_muted` 状态，不得因此取消 `is_block` 或恢复被删除内容。
 
 #### Scenario: 批量解除多个禁言用户
+
 - **WHEN** admin 选择多个处于 mute 状态的用户并确认批量解除禁言
 - **THEN** 系统 MUST 将这些用户的 `is_muted` 设置为 false
 - **AND** 每个不再受其他限制的用户 MUST 恢复新增话题和回复能力
 - **AND** 系统 MUST 写入审计日志，记录操作者、目标用户和处理数量
 
 #### Scenario: 批量解除禁言不恢复内容可见
+
 - **WHEN** admin 对同时处于 mute 和 block 状态的用户执行批量解除禁言
 - **THEN** 系统 MUST 取消目标用户的 `is_muted`
 - **AND** 系统 MUST 保留目标用户的 `is_block`
 - **AND** 目标用户历史内容仍按 block 规则在公共入口不可见
 
 #### Scenario: 批量解除禁言禁止自操作
+
 - **WHEN** admin 提交的批量解除禁言目标包含当前登录账号
 - **THEN** 系统 MUST 跳过或拒绝对当前登录账号执行限制状态变更
 - **AND** 当前登录账号的 `is_muted` 状态 MUST 保持不变
@@ -259,18 +284,21 @@ TBD - created by archiving change rewrite-to-cnode-next. Update Purpose after ar
 系统 SHALL 允许 admin 在后台用户治理入口中对多个处于 block 状态的用户执行批量恢复内容可见。批量恢复内容可见 MUST 只取消目标用户的 `is_block` 状态，不得因此取消 `is_muted` 或恢复被删除内容。
 
 #### Scenario: 批量恢复多个用户内容可见
+
 - **WHEN** admin 选择多个处于 block 状态的用户并确认批量恢复内容可见
 - **THEN** 系统 MUST 将这些用户的 `is_block` 设置为 false
 - **AND** 目标用户未删除且符合公开规则的历史内容 MUST 恢复在公共入口可见
 - **AND** 系统 MUST 写入审计日志，记录操作者、目标用户和处理数量
 
 #### Scenario: 批量恢复内容可见不解除禁言
+
 - **WHEN** admin 对同时处于 block 和 mute 状态的用户执行批量恢复内容可见
 - **THEN** 系统 MUST 取消目标用户的 `is_block`
 - **AND** 系统 MUST 保留目标用户的 `is_muted`
 - **AND** 目标用户仍不可新增话题或回复，直到被单独或批量解除禁言
 
 #### Scenario: 批量恢复内容可见禁止自操作
+
 - **WHEN** admin 提交的批量恢复内容可见目标包含当前登录账号
 - **THEN** 系统 MUST 跳过或拒绝对当前登录账号执行限制状态变更
 - **AND** 当前登录账号的 `is_block` 状态 MUST 保持不变
diff --git a/openspec/specs/user-profile-experience/spec.md b/openspec/specs/user-profile-experience/spec.md
index 3ceab65..d2e80e0 100644
--- a/openspec/specs/user-profile-experience/spec.md
+++ b/openspec/specs/user-profile-experience/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义用户主页及其话题、参与、收藏列表对齐 nodeclub 线上分页语义、公开可见性过滤规则和管理员治理入口的要求。
+
 ## Requirements
+
 ### Requirement: 用户内容列表必须支持 legacy 分页语义
 
 用户主页相关列表 SHALL 对齐 `nodeclub/controllers/user.js` 的分页行为，不能只展示 profile recent 数据。
@@ -34,6 +36,7 @@
 用户主页、用户话题、用户参与和用户收藏列表 SHALL 只展示公开可见内容，并保持分页 total 与过滤后的结果一致。block 用户内容不可公开；仅处于 mute 状态的用户内容不应因此被隐藏。
 
 #### Scenario: 用户话题列表过滤内部和受限内容
+
 - **WHEN** 用户访问 `/user/:name/topics?page=N`
 - **THEN** 列表 MUST 排除 `tab=dev` 或 `tab=test` 的话题
 - **AND** MUST 排除已删除话题
@@ -42,17 +45,20 @@
 - **AND** total MUST 按相同过滤条件计算
 
 #### Scenario: 用户参与列表过滤不可公开所属话题
+
 - **WHEN** 用户访问 `/user/:name/replies?page=N`
 - **THEN** 列表 MUST 排除已删除回复
 - **AND** MUST 排除所属话题为 dev/test、已删除或作者已被 block 的回复聚合
 - **AND** total MUST 按过滤后的去重话题计算
 
 #### Scenario: 用户收藏列表过滤不可公开话题
+
 - **WHEN** 用户访问 `/user/:name/collections?page=N`
 - **THEN** 列表 MUST 排除 dev/test、已删除或作者已被 block 的话题
 - **AND** total MUST 按过滤后的收藏话题计算
 
 #### Scenario: 用户主页 recent 数据过滤不可公开内容
+
 - **WHEN** 用户访问 `/user/:name`
 - **THEN** `recent_topics` 和 `recent_replies` MUST 只包含公开可见话题
 
diff --git a/openspec/specs/user-roles/spec.md b/openspec/specs/user-roles/spec.md
index fabdaca..78f9cf1 100644
--- a/openspec/specs/user-roles/spec.md
+++ b/openspec/specs/user-roles/spec.md
@@ -1,8 +1,11 @@
 # user-roles Specification
 
 ## Purpose
+
 TBD - created by archiving change add-user-roles-and-restricted-jobs. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: 用户角色分配表
 
 系统 SHALL 提供 DB-backed 用户角色分配能力，用于授予非 admin 的运营身份。首批 role key SHALL 固定为 `moderator` 和 `recruiter`，管理员身份 SHALL 继续由代码/env 级别判定，不依赖 `user_roles`。
diff --git a/openspec/specs/web-api-contract-integration/spec.md b/openspec/specs/web-api-contract-integration/spec.md
index d541182..db48297 100644
--- a/openspec/specs/web-api-contract-integration/spec.md
+++ b/openspec/specs/web-api-contract-integration/spec.md
@@ -1,12 +1,17 @@
 # web-api-contract-integration Specification
 
 ## Purpose
+
 TBD - created by archiving change reach-production-grade-release-readiness. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Web API 调用必须引用 OAS 契约
+
 `apps/web` SHALL 与 API 契约建立持续校验关系，避免前端调用、后端实现和外部 API 文档漂移。web 调用类型 MUST 从 API 路由的 zod-openapi 声明派生（通过 `z.infer`），不再手写 DTO 或维护独立的契约清单。
 
 #### Scenario: Web 使用从 API 派生的类型
+
 - **WHEN** `apps/web` 调用 `/api/v1/*` 或其他公开 API
 - **THEN** 调用方使用的 TypeScript 类型 MUST 通过 `z.infer<typeof schema>` 从 `packages/shared/schemas` re-export 的 zod schema 派生
 - **AND** 该 zod schema MUST 与 `apps/api/src/routes/*.ts` 中 zod-openapi 声明的 schema 为同一份源
@@ -14,41 +19,50 @@ TBD - created by archiving change reach-production-grade-release-readiness. Upda
 - **AND** 项目 MUST NOT 保留 `apps/web/api-contract.manifest.json` 手写契约清单
 
 #### Scenario: Web 调用未记录 API
+
 - **WHEN** `apps/web` 新增对某个 API path 的调用
 - **THEN** 对应端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** 该 schema MUST 通过 `packages/shared/schemas` 可被 web import
 - **AND** 若端点未声明，`pnpm gen:openapi` 产出的 OAS MUST 不包含该 path，从而阻断 web 类型派生
 
 ### Requirement: OAS 更新必须能驱动 Web 契约同步
+
 当 `apps/api` 路由中影响 Web 的 API path、method、request 或 response schema 发生变化时，项目 SHALL 提供机制提醒或阻断未同步的 Web 调用。
 
 #### Scenario: 路由删除 Web 依赖接口
+
 - **WHEN** `apps/api/src/routes/*.ts` 删除或重命名 `apps/web` 仍在调用的端点
 - **THEN** re-export 的 zod schema MUST 导致 web 端 typecheck 失败
 - **AND** 开发者 MUST 同步更新 Web 调用或恢复路由声明
 
 #### Scenario: 路由修改核心响应字段
+
 - **WHEN** `apps/api/src/routes/*.ts` 修改 Web loader、action 或组件依赖的核心响应字段
 - **THEN** `z.infer` 派生类型 MUST 反映该变更
 - **AND** Web 不得继续依赖已从 schema 移除的字段作为稳定契约
 
 ### Requirement: Web 契约集成必须优先覆盖核心外部能力
+
 Web 与 API 路由的持续集成 SHALL 优先覆盖帖子、回复、用户、收藏和消息相关 API。
 
 #### Scenario: 帖子和回复调用被覆盖
+
 - **WHEN** Web 加载首页、话题详情、发帖或回帖页面
 - **THEN** 相关端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** Web 调用 MUST 使用从该 schema 派生的类型
 
 #### Scenario: 用户、收藏和消息调用被覆盖
+
 - **WHEN** Web 加载用户页、收藏状态或消息页
 - **THEN** 相关端点 MUST 在 `apps/api/src/routes/*.ts` 中以 zod-openapi 声明
 - **AND** Web schema 派生 MUST 标注登录态或 access token 要求
 
 ### Requirement: Web 表单校验 zod schema 必须从 shared 派生
+
 Web 表单运行时校验使用的 zod schema MUST 从 `packages/shared/schemas` import，该 schema 与 `apps/api` 路由的 zod-openapi 声明引用同一份源，不得在 web 端手写副本。
 
 #### Scenario: 表单 schema 来源唯一
+
 - **WHEN** `apps/web` 的 signup/signin/setting 等表单使用 `zodResolver` 进行运行时校验
 - **THEN** 传入 `zodResolver` 的 zod schema MUST 从 `packages/shared/schemas` import
 - **AND** `packages/shared/schemas` MUST 是 schema 的定义源头（不是从 api re-export）
@@ -56,6 +70,7 @@ Web 表单运行时校验使用的 zod schema MUST 从 `packages/shared/schemas`
 - **AND** Web MUST NOT 手写与 API 路由重复的表单 zod schema
 
 #### Scenario: 客户端扩展字段不污染契约源
+
 - **WHEN** Web 表单需要客户端独有字段（如 `confirmPass`）或跨字段校验（如两次密码一致）
 - **THEN** Web MUST 在 import 的 schema 基础上用 `.extend()` 或 `.refine()` 叠加客户端逻辑
 - **AND** 这些扩展 MUST NOT 回写到 `packages/shared/schemas` 的 schema 定义中
diff --git a/openspec/specs/web-async-action/spec.md b/openspec/specs/web-async-action/spec.md
index 7e387c3..d82f93a 100644
--- a/openspec/specs/web-async-action/spec.md
+++ b/openspec/specs/web-async-action/spec.md
@@ -18,8 +18,8 @@ function useAsyncAction<TArgs extends unknown[], TResult>(
     errorMessage?: string | ((error: unknown) => string);
     onSuccess?: (result: TResult) => void;
     onError?: (error: unknown) => void;
-  }
-): { run: (...args: TArgs) => void; pending: boolean }
+  },
+): { run: (...args: TArgs) => void; pending: boolean };
 ```
 
 #### Scenario: 基本 pending 状态
diff --git a/openspec/specs/web-design-system-governance/spec.md b/openspec/specs/web-design-system-governance/spec.md
index e3544f4..635e4a1 100644
--- a/openspec/specs/web-design-system-governance/spec.md
+++ b/openspec/specs/web-design-system-governance/spec.md
@@ -1,18 +1,23 @@
 # web-design-system-governance Specification
 
 ## Purpose
+
 TBD - created by archiving change realign-web-design-system. Update Purpose after archive.
+
 ## Requirements
+
 ### Requirement: Base Nova 是唯一原子组件基线
 
 Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/components/ui/` 的唯一 registry 基线；原子组件的结构、variant、尺寸、圆角、间距和状态样式 MUST 与锁定版本的 Base Nova 输出保持一致。
 
 #### Scenario: 审查原子组件来源
+
 - **WHEN** 开发者新增或更新 `components/ui/` 中的组件
 - **THEN** 变更 MUST 使用项目锁定的 shadcn CLI 对 `base-nova` 执行 dry-run 和 diff
 - **AND** 不得保留 legacy `new-york`、Radix wrapper 或项目专属视觉 variant。
 
 #### Scenario: CNode 品牌不进入 primitive 源码
+
 - **WHEN** 审查 Button、Card、Input、Table、Alert、Empty 或 overlay primitive
 - **THEN** primitive MUST 只消费 Base Nova 使用的 semantic tokens
 - **AND** primitive 源码 MUST NOT 包含 `cnode-*`、业务 route、权限或领域状态。
@@ -22,11 +27,13 @@ Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/c
 原子组件消费者 SHALL 只通过标准 props/variants 表达视觉和密度；`className` MUST 限于容器布局、响应式显隐、宽度约束或上游明确支持的 CSS variable，不得覆写 primitive 的颜色、高度、padding、圆角、阴影、字体或 icon 尺寸。
 
 #### Scenario: 页面需要紧凑 Card
+
 - **WHEN** 页面需要比默认 Card 更紧凑的内容块
 - **THEN** 页面 MUST 使用 `Card size="sm"` 或 Base Nova 支持的 `--card-spacing`
 - **AND** 不得分别在 CardHeader 与 CardContent 手写 padding 形成另一套密度。
 
 #### Scenario: 页面需要响应式按钮
+
 - **WHEN** Button 在移动端需要占满可用宽度或在断点隐藏
 - **THEN** 页面 MAY 使用 `w-full` 或响应式 display class
 - **AND** 不得通过 class 覆写 Button 高度、颜色、圆角或内部 icon 尺寸。
@@ -36,11 +43,13 @@ Web UI SHALL 将 shadcn `base-nova` 作为 `components.json` 与 `apps/web/app/c
 Web UI SHALL 在原子组件与 route 之间提供可复用 application blocks，并 SHALL 将公共和后台 route 映射到命名页面原型；blocks 负责稳定 composition，不得复制 primitive 实现。
 
 #### Scenario: 公共页面映射原型
+
 - **WHEN** 审计首页、话题详情、发布编辑、认证设置、用户或招聘页面
 - **THEN** 页面 MUST 分别映射到 feed、reading、compose、account 或 directory 原型
 - **AND** 同类页面 MUST 复用相同的 PageHeader、内容宽度、block spacing 和 responsive composition。
 
 #### Scenario: 后台页面映射原型
+
 - **WHEN** 审计后台概览、管理列表或治理队列
 - **THEN** 页面 MUST 分别映射到 dashboard、data-list 或 workflow 原型
 - **AND** 不得为每个后台 route 重建独立 panel、toolbar、filter 和 record spacing。
@@ -50,11 +59,13 @@ Web UI SHALL 在原子组件与 route 之间提供可复用 application blocks
 仓库 SHALL 提供稳定设计系统文档和可自动执行的治理检查，覆盖 primitive 基线、semantic theme、组件选择、spacing、页面原型、responsive、Markdown 和验收矩阵。
 
 #### Scenario: 新 UI 变更进入 review
+
 - **WHEN** PR 修改 primitive、theme、application block 或 route composition
 - **THEN** CI 或本地 release gate MUST 检查配置基线、禁止的 primitive 视觉覆写和原始品牌色使用
 - **AND** reviewer MUST 能从 `docs/design-system.md` 找到对应规则与验收页面原型。
 
 #### Scenario: 上游组件升级
+
 - **WHEN** 项目升级锁定的 shadcn 或 Base UI 版本
 - **THEN** 每个受影响 primitive MUST 单独审查 registry diff、API、ARIA、focus 和调用方 blast radius
 - **AND** 不得通过批量覆盖掩盖本地 application block 问题。
diff --git a/openspec/specs/web-ui-components/spec.md b/openspec/specs/web-ui-components/spec.md
index a1ee44c..ce02b55 100644
--- a/openspec/specs/web-ui-components/spec.md
+++ b/openspec/specs/web-ui-components/spec.md
@@ -3,43 +3,52 @@
 ## Purpose
 
 定义 Web UI 原子组件、shadcn/ui 组件源码、按钮变体、菜单、Dialog、领域组件组合、图标和 toast 反馈的统一使用要求。
+
 ## Requirements
+
 ### Requirement: shadcn/ui 原子组件层
 
 `apps/web/app/components/ui/` SHALL 包含仓库拥有源码的 shadcn `base-nova` 原子组件，并 SHALL 以 Base UI 作为交互 primitive 基础，覆盖 `button`、`input`、`label`、`card`、`badge`、`avatar`、`dropdown-menu`、`dialog`、`sheet`、`tabs`、`table`、`tooltip`、`skeleton`、`sonner`、`form`、`select`、`native-select`、`textarea`、`alert-dialog`、`alert`、`pagination`、`empty`、`command` 和 `radio-group`。组件 MUST 使用 `cn()` 和标准 semantic tokens，且其结构、默认 variant、尺寸、间距、圆角、颜色、focus、disabled 与状态样式 MUST 与项目锁定版本的 Base Nova registry 保持一致；Web 源码和直接依赖 MUST NOT 保留 Radix primitive、Slot 兼容层、legacy `new-york` 样式或 CNode 专属 primitive variant。
 
 #### Scenario: 新建页面使用原子组件
+
 - **WHEN** 开发者在 `routes/` 下新建页面
 - **THEN** 页面内已有 shadcn 对应物的按钮、输入、字段、卡片、列表、状态、菜单、overlay 和空状态 MUST 从 `~/components/ui/` 导入
 - **AND** 不得以裸元素和视觉 Tailwind 字符串重建相同 primitive
 - **AND** 键盘与辅助技术用户 MUST 能识别控件的名称、角色和当前状态。
 
 #### Scenario: 组件源码进仓库
+
 - **WHEN** 查看 `apps/web/app/components/ui/`
 - **THEN** 已安装组件 MUST 是完整的 Base Nova 组件源码而不是 npm re-export
 - **AND** `components.json` MUST 让 shadcn CLI 将项目识别为 Base Nova 而不是 Radix `new-york`。
 
 #### Scenario: 页面使用一致的语义组件
+
 - **WHEN** 页面渲染按钮、输入框、选择器、反馈、分页或空状态
 - **THEN** 用户看到的颜色、圆角、密度、焦点和禁用状态 MUST 与同类品牌组件一致
 - **AND** 键盘与辅助技术用户 MUST 能识别控件的名称、角色和当前状态。
 
 #### Scenario: 现有组件行为保持可用
+
 - **WHEN** 共享原子组件新增能力或样式更新
 - **THEN** 已使用该组件的页面 MUST 保持原有可执行动作和导航结果
 - **AND** 不得因 Base UI 或 Base Nova realignment 改变既有业务动作、导航结果或权限入口。
 
 #### Scenario: 组件组合使用 Base UI render
+
 - **WHEN** Button、Dialog trigger、Sheet trigger 或菜单项组合 React Router Link 或其他元素
 - **THEN** 组件 MUST 使用 Base UI `render` 或等价原生语义完成组合
 - **AND** DOM MUST NOT 产生嵌套 button、重复交互元素或长期 `asChild`/Radix Slot 兼容层。
 
 #### Scenario: Base UI 状态驱动样式
+
 - **WHEN** overlay 打开或关闭、Checkbox 选中、Tabs 激活或菜单高亮
 - **THEN** 样式 MUST 由对应 Base UI open/closed/checked/active/highlighted 状态属性驱动
 - **AND** 不得依赖已失效的 Radix `data-state` 或 `--radix-*` 变量。
 
 #### Scenario: 迁移完成后清理 Radix
+
 - **WHEN** Web primitive 与消费者迁移完成
 - **THEN** `apps/web` 源码 MUST 不再 import `@radix-ui/*` 或 `radix-ui`
 - **AND** Web package MUST 不再直接声明 Radix dependencies
@@ -50,11 +59,13 @@
 Button 组件 MUST 只提供锁定 Base Nova 版本定义的标准 variants 和 sizes，并 MUST 保持 `default`、`secondary`、`destructive`、`outline`、`ghost`、`link` variants 以及 `default`、`sm`、`lg`、`icon` sizes 的现有语义覆盖。主操作、次级操作、危险操作、链接与 icon-only 操作 SHALL 使用标准 prop 表达；页面 MUST NOT 新增 `inverse` 等项目专属 variant，或通过 `className` 重定义 Button 颜色、尺寸、padding、圆角和 icon 大小。
 
 #### Scenario: 主按钮替换
+
 - **WHEN** 渲染登录表单的提交按钮
 - **THEN** 使用 `<Button>` 默认 variant
 - **AND** CNode 主色由 `primary` token 提供，不在 Button 或 route 中写品牌颜色 class，也不保留裸 `<button className="bg-blue-600 ...">`。
 
 #### Scenario: 次级按钮替换
+
 - **WHEN** 渲染取消按钮
 - **THEN** 使用 `<Button variant="outline">` 或与动作层级匹配的标准 variant
 - **AND** 不得手写边框、背景和 hover 颜色，也不保留裸 `<button className="border border-gray-300 ...">`。
@@ -260,11 +271,13 @@ Dialog、AlertDialog、Sheet、下拉菜单和 Command overlay SHALL 管理打
 页面 SHALL 优先使用 Base Nova Card、Field、Item、Sidebar、Table/Data Table、Badge、Alert、Empty、Separator、Toggle Group 和 Input Group 的标准 composition；只有包含稳定 CNode 领域结构时才能建立 application block。
 
 #### Scenario: 状态和空结果展示
+
 - **WHEN** 页面展示状态标签、错误说明或空结果
 - **THEN** 分别使用 Badge、Alert 或 Empty 的标准 composition
 - **AND** 不得手写具有相同角色的品牌色 span 或 surface div。
 
 #### Scenario: Card 含标题、说明和操作
+
 - **WHEN** Card 同时包含标题、说明和右侧操作
 - **THEN** 使用 CardHeader、CardTitle、CardDescription 和 CardAction
 - **AND** 不得以自定义 flex header 和独立 padding 模拟相同结构。
diff --git a/openspec/specs/web-ui-forms/spec.md b/openspec/specs/web-ui-forms/spec.md
index bdff4de..ca116a0 100644
--- a/openspec/specs/web-ui-forms/spec.md
+++ b/openspec/specs/web-ui-forms/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义 Web 表单的状态管理、共享校验、组件渲染、提交反馈、可访问性和设置页账号身份信息展示要求，确保用户输入流程一致、安全且可维护。
+
 ## Requirements
+
 ### Requirement: react-hook-form + zod 作为表单标准
 
 所有表单(登录、注册、发帖、回复编辑、设置、管理后台设置)SHALL 用 `react-hook-form` 管理状态,用 `@hookform/resolvers/zod` 接 zod resolver 做校验。MUST NOT 用 `useState` 管理表单字段值。
@@ -27,6 +29,7 @@
 表单字段 MUST 使用当前 Base Nova Field family（`FieldGroup`、`Field`、`FieldLabel`、`FieldDescription`、`FieldError`、适用时的 `FieldSet`/`FieldLegend`）组合 Input、Textarea、Select、NativeSelect、Checkbox、RadioGroup 或 Switch。React Hook Form SHALL 通过 Controller 与 Field composition 集成，resolver 或服务端字段错误 SHALL 由 `FieldError` 自动渲染；无效状态 MUST 同时在 Field 上使用 `data-invalid` 并在控件上使用 `aria-invalid`。页面 MUST NOT 使用裸 `div + Label`、`space-y-*`、手动管理的字段状态/错误元素或页面自定义控件间距替代 Field composition。
 
 #### Scenario: 字段错误自动显示
+
 - **WHEN** 用户提交登录表单且 `pass` 为空或密码字段无效
 - **THEN** FieldError 自动展示 shared schema 定义的“密码不能为空”或对应 schema/服务端字段错误，无需手写条件错误元素
 - **AND** Field、控件、说明和错误之间保持 Base Nova 定义的可访问关系与间距。
@@ -79,24 +82,29 @@
 - **AND** 提交时 job_meta 与 topic 主体在单次 PUT 一起提交
 
 ### Requirement: 设置页必须展示账号身份信息
+
 用户设置页 SHALL 展示当前账号的只读身份信息，并区分可编辑个人资料和不可直接编辑的登录身份字段。
 
 #### Scenario: 设置页显示邮箱
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 显示当前账号邮箱
 - **AND** 邮箱 MUST 作为只读身份信息展示
 - **AND** 页面 MUST NOT 提供无验证的直接修改邮箱表单
 
 #### Scenario: 设置页显示 GitHub 绑定状态
+
 - **WHEN** 登录用户访问 `/setting`
 - **THEN** 页面 MUST 显示当前 GitHub 绑定状态
 - **AND** 未绑定账号 MUST 显示绑定入口
 - **AND** 已绑定账号 MUST 显示绑定的 GitHub 用户名或等价标识
 
 ### Requirement: 设置页卡片内容间距必须一致
+
 设置页所有 Card body SHALL 使用一致的 padding 和文本间距，避免侧栏说明卡片内容贴边。
 
 #### Scenario: 通知说明卡片有 body padding
+
 - **WHEN** `/setting` 渲染通知说明卡片
 - **THEN** 卡片 header 与 body MUST 视觉分离
 - **AND** body 内容 MUST 有与 API Token 卡片一致的内边距
@@ -243,11 +251,13 @@ GitHub 解绑 SHALL 使用可访问的确认 Dialog，并以 `react-hook-form`
 公共表单、后台筛选和表格内联编辑 SHALL 使用 Base Nova 控件的标准 default/small size 与 Field orientation；页面不得通过高度、padding 或圆角 class 建立第三种密度。
 
 #### Scenario: 后台表格内联编辑
+
 - **WHEN** 后台 Table cell 渲染 Input 或 NativeSelect
 - **THEN** 控件使用标准 small size 或专门的紧凑 composition
 - **AND** 同一行的 Input、Select、Button 和状态控件 MUST 保持一致高度。
 
 #### Scenario: 移动端表单重排
+
 - **WHEN** horizontal 或 responsive Field 在窄屏渲染
 - **THEN** label、control、description 和 action MUST 按 Field 的 responsive orientation 自然堆叠
 - **AND** 不得发生水平溢出或操作被固定宽度遮挡。
diff --git a/openspec/specs/web-ui-markdown/spec.md b/openspec/specs/web-ui-markdown/spec.md
index cce788d..102615a 100644
--- a/openspec/specs/web-ui-markdown/spec.md
+++ b/openspec/specs/web-ui-markdown/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义 Web Markdown 渲染、GFM 支持、XSS 防护、代码高亮、编辑器预览和 prose token 样式要求，确保话题和回复内容安全且一致展示。
+
 ## Requirements
+
 ### Requirement: react-markdown 作为 Markdown 渲染器
 
 `apps/web/app/components/MarkdownView.tsx` MUST 用 `react-markdown` 渲染 Markdown 内容,替换现状(直接 `<div className="whitespace-pre-wrap">{content}</div>` 的 TODO 桩)。pipeline SHALL 为 `react-markdown` + `remark-gfm` + `rehype-sanitize` + `rehype-highlight`。
@@ -55,6 +57,7 @@
 `apps/web/app/components/MarkdownEditor.tsx` 的预览和双栏预览 MUST 直接渲染与发布后相同的 `MarkdownView`、Markdown pipeline 和 `.typeset-docs` preset；相同内容在相同可用宽度下 MUST 具有一致的标题、段落、列表、代码、表格与图片节奏。
 
 #### Scenario: 编辑器预览与最终渲染一致
+
 - **WHEN** 用户在编辑器点击“预览”或以双栏模式预览话题或回复 Markdown
 - **THEN** 预览和最终内容使用同一 Markdown pipeline 和 `.typeset-docs` preset，渲染效果与发布后内容一致
 - **AND** 不得由编辑器容器额外覆写正文颜色、列表 marker、字体大小或 block spacing。
@@ -64,26 +67,31 @@
 项目 SHALL 从 `https://ui.shadcn.com/typeset.css` 持有未定制的上游 Typeset stylesheet，并 SHALL 在 Tailwind import 后导入。全部 `MarkdownView` SHALL 使用 `typeset typeset-docs` 容器；`.typeset-docs` MUST 使用 Roboto Variable 作为 body、heading 和 mono font，并定义 `14px` size、`1.75` leading 与 `1.25em` flow。颜色、圆角与内容表面 MUST 消费 semantic theme tokens，dark mode 不得依赖独立 `prose-invert` palette。
 
 #### Scenario: Typeset stylesheet 和字体安装
+
 - **WHEN** 审查 Web 样式入口和依赖
 - **THEN** `typeset.css` 位于主 CSS 同目录并在 Tailwind 后导入，`@fontsource-variable/roboto` 已安装并导入
 - **AND** `--font-roboto` 与 `.typeset-docs` 的三个 font variables 使用 Roboto Variable。
 
 #### Scenario: 全部 MarkdownView 使用统一 surface
+
 - **WHEN** 话题、回复或 MarkdownEditor preview 渲染 MarkdownView
 - **THEN** renderer 根容器包含 `typeset typeset-docs`
 - **AND** 所有 surface 使用同一 rhythm，不保留 `.markdown-body` 或 route-specific typography class。
 
 #### Scenario: dark mode 下 Typeset 跟随
+
 - **WHEN** 用户切换到 dark mode
 - **THEN** Markdown 正文、链接、引用、列表、代码、表格和图片边界自动跟随 semantic tokens
 - **AND** 不需要 route 或 Markdown component 增加手工 dark color class。
 
 #### Scenario: dark mode 下 prose 跟随
+
 - **WHEN** 切到 dark mode
 - **THEN** Markdown 正文文字色、代码块背景色及其他 Typeset 内容跟随 semantic tokens 变化
 - **AND** 不写 `dark:prose-invert` 或其他手工 `dark:` 颜色变体。
 
 #### Scenario: Typeset 只影响 Markdown surface
+
 - **WHEN** 页面同时包含 Markdown 和嵌入式交互组件
 - **THEN** Typeset selector MUST 不影响容器外内容
 - **AND** 不应继承 Typeset 的嵌入组件使用 `not-typeset` 或 `data-not-typeset` 隔离。
@@ -190,16 +198,19 @@
 Markdown Typeset MUST 正确呈现无序列表、有序列表、嵌套列表、混合列表、任务列表、loose list 及列表内段落、引用和代码块；Tailwind reset MUST NOT 移除可见 marker、序号、缩进或层级关系。
 
 #### Scenario: 无序和有序列表
+
 - **WHEN** Markdown 包含 `- item` 或 `1. item`
 - **THEN** 无序列表显示项目 marker，有序列表显示稳定序号
 - **AND** marker、正文和嵌套内容在 light/dark 下均可辨识。
 
 #### Scenario: 嵌套和任务列表
+
 - **WHEN** Markdown 包含多层嵌套列表或 GFM task list
 - **THEN** 每层具有可辨识缩进和 marker 层级，checkbox 与标签正确对齐
 - **AND** 375px viewport 不产生正文级水平溢出。
 
 #### Scenario: 列表内复杂 block
+
 - **WHEN** list item 包含段落、引用或 fenced code block
 - **THEN** block spacing 保持所属列表层级
 - **AND** 代码区域可在自身边界内滚动而不撑破页面。
diff --git a/openspec/specs/web-ui-state/spec.md b/openspec/specs/web-ui-state/spec.md
index fcdc438..7f53eba 100644
--- a/openspec/specs/web-ui-state/spec.md
+++ b/openspec/specs/web-ui-state/spec.md
@@ -3,7 +3,9 @@
 ## Purpose
 
 定义 Web 前端全局客户端状态、主题状态、UI 开关、路由数据刷新和首屏数据归属要求，确保 React Router loader 与 zustand store 的职责边界清晰。
+
 ## Requirements
+
 ### Requirement: zustand 作为全局状态库
 
 `apps/web/app/lib/stores/` SHALL 包含两个 zustand store：`auth-store.ts`、`theme-store.ts`。`ui-store.ts` SHALL 被删除。store MUST 是无 Provider 的全局单例，直接 `import { useXStore } from "~/lib/stores/x-store"` 使用。
diff --git a/openspec/specs/web-ui-theme/spec.md b/openspec/specs/web-ui-theme/spec.md
index 057d771..0b261ae 100644
--- a/openspec/specs/web-ui-theme/spec.md
+++ b/openspec/specs/web-ui-theme/spec.md
@@ -3,17 +3,21 @@
 ## Purpose
 
 定义 Web 主题系统的语义 token、light/dark/system 三态切换、防 FOUC 初始化、字面量色值清理和全局 CSS 边界要求。
+
 ## Requirements
+
 ### Requirement: 语义 token 单一来源
 
 `apps/web/app/styles/global.css` SHALL 用 Tailwind v4 CSS-first `@theme inline` 声明 Base Nova 所需的完整 core semantic tokens，至少涵盖 `background`/`foreground`、`primary`/`primary-foreground`、`secondary`/`secondary-foreground`、`muted`/`muted-foreground`、`accent`/`accent-foreground`、`destructive`/`destructive-foreground`、`border`、`input`、`ring`、`card`/`card-foreground`、`popover`/`popover-foreground` 和 `radius`，并 SHALL 为 light/dark 分别定义标准 sidebar 与 chart tokens。CNode 颜色 MUST 映射到 `primary`、`accent`、`secondary`、`muted`、`foreground`、`sidebar-*` 和 `chart-*` 等用途；只有 Logo 或品牌展示无法由标准角色表达时 MAY 增加少量 `brand-*` token。
 
 #### Scenario: 组件使用语义 class 而非字面量色值
+
 - **WHEN** 任意组件渲染卡片、控件、状态或导航背景
 - **THEN** 使用与用途匹配的标准 semantic class；Card 背景使用 `bg-card text-card-foreground`
 - **AND** 不出现十六进制色值、原始 CNode palette class 或手工 light/dark 颜色组合。
 
 #### Scenario: 切换 dark mode 不改组件代码
+
 - **WHEN** `<html>` 元素添加或移除 `dark` class
 - **THEN** 所有 semantic class 以及 core、sidebar、chart 和允许的 brand roles MUST 自动切换配色
 - **AND** primitive 与 route 无需增加 `dark:` 颜色变体。
@@ -55,11 +59,13 @@
 `styles/global.css` SHALL 作为 Tailwind、动画、Typeset 与主题 token 的入口，不得包含 route、领域 block 或 primitive 的补丁样式。Markdown Typeset、代码高亮等跨页面内容系统 MAY 使用独立 CSS 文件并由该入口导入。
 
 #### Scenario: 全局 CSS 边界
+
 - **WHEN** 查看 `styles/global.css` 及其导入
 - **THEN** global 入口只包含框架 imports、theme token、必要 base behavior 和独立内容系统 imports
 - **AND** 不得出现用于修复单一路由、Card、Button、Table 或 overlay 的 selector。
 
 #### Scenario: 全局 CSS 只剩 token
+
 - **WHEN** 查看 `styles/global.css`
 - **THEN** 除 Tailwind、动画与独立 Typeset/代码高亮内容系统 imports、`@theme inline`、`:root`、`.dark` 和必要 base behavior 外不包含其他规则
 - **AND** 不得包含业务样式、组件样式或 route-specific selector。
@@ -129,6 +135,7 @@ light 与 dark 主题中的文本、链接、边框、焦点指示、状态提
 业务页面和 application blocks MUST 按语义选择 theme role，不得直接使用 `cnode-green`、`cnode-soft`、`cnode-ink` 或等价 raw palette utility。
 
 #### Scenario: 同一浅绿色用于不同语义
+
 - **WHEN** 旧页面以同一 `bg-cnode-soft` 表达 selected、informational、muted surface 或 decoration
 - **THEN** 迁移后 MUST 根据用途分别选择 `accent`、`secondary`、`muted` 或允许的 brand role
 - **AND** 不得执行不区分用途的全局字符串替换。
@@ -138,16 +145,19 @@ light 与 dark 主题中的文本、链接、边框、焦点指示、状态提
 主题 SHALL 以 Base Nova 提供的 light/dark core、chart、radius 和 sidebar token 集合作为结构种子，并 SHALL 保持其 surface 层级、foreground 配对和透明 border/input 关系。CNode theme MUST 在这些标准角色内替换品牌相关色相，不得删除标准 token 或在页面建立平行 token 系统。
 
 #### Scenario: CNode 映射 Base theme
+
 - **WHEN** 从 Base Nova 中性 theme 生成 CNode light/dark theme
 - **THEN** background、card、popover、secondary、muted、border 和 input 保持可辨识的标准层级关系
 - **AND** primary、accent、sidebar-primary 和适用的 chart roles 使用经过对比度验证的 CNode 品牌色，而不是原样保留中性灰或无关蓝色。
 
 #### Scenario: Radius 遵循 preset 基线
+
 - **WHEN** Base Nova registry 定义默认 radius 与派生 radius
 - **THEN** theme MUST 采用该 preset 基线并让 primitive 通过标准 radius token 消费
 - **AND** 不得仅因旧页面外观或单独 theme 示例的 `0.45rem` 值在 route/primitive 建立不同圆角。
 
 #### Scenario: Chart token 具有可辨识系列
+
 - **WHEN** 后台真实数据 chart 使用 `chart-1` 至 `chart-5`
 - **THEN** light/dark 下相邻系列 MUST 可辨识并与 CNode theme 协调
 - **AND** 不得直接复制无法区分业务系列的单色灰阶或为装饰目的使用 chart token。
diff --git a/package.json b/package.json
index ebb8607..cefebb6 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
     "dev": "concurrently -n web,api -c blue,green \"pnpm --filter @cnode/web dev\" \"pnpm --filter @cnode/api dev\"",
     "build": "pnpm -r build",
     "test": "pnpm -r test",
-    "lint": "oxlint .",
+    "lint": "vp lint .",
     "typecheck": "pnpm -r typecheck",
     "verify": "pnpm lint && pnpm typecheck && pnpm test && pnpm build && pnpm gen:openapi && openspec validate --all --strict && pnpm secrets:scan",
     "db:push": "pnpm --filter @cnode/db db:push",
@@ -22,11 +22,11 @@
     "smoke:api-contract": "tsx deployment/scripts/smoke-api-contract.ts",
     "gen:openapi": "pnpm --filter @cnode/api gen:openapi",
     "preflight:github-ids": "tsx deployment/scripts/preflight-github-id-uniqueness.ts",
-    "format": "oxfmt .",
+    "format": "vp fmt .",
     "secrets:scan": "gitleaks git --config .gitleaks.toml --redact --no-banner",
     "secrets:scan:staged": "gitleaks git --config .gitleaks.toml --redact --no-banner --pre-commit --staged",
-    "hooks:install": "husky",
-    "prepare": "husky"
+    "hooks:install": "vp config",
+    "prepare": "vp config"
   },
   "dependencies": {
     "@cnode/shared": "workspace:*",
@@ -37,11 +37,10 @@
     "@fission-ai/openspec": "1.6.0",
     "@types/pg": "^8.20.0",
     "concurrently": "^9.1.0",
-    "husky": "^9.1.7",
-    "oxfmt": "^0.60.0",
-    "oxlint": "^1.75.0",
     "tsx": "^4.23.1",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
   },
   "engines": {
     "node": ">=24.0.0"
diff --git a/packages/db/src/load-env.ts b/packages/db/src/load-env.ts
index 03a17ed..2acfe7b 100644
--- a/packages/db/src/load-env.ts
+++ b/packages/db/src/load-env.ts
@@ -23,7 +23,10 @@ function findWorkspaceRoot(cwd: string) {
 
 function parseValue(value: string) {
   const trimmed = value.trim();
-  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+  if (
+    (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+    (trimmed.startsWith("'") && trimmed.endsWith("'"))
+  ) {
     return trimmed.slice(1, -1);
   }
   return trimmed;
@@ -49,7 +52,9 @@ function loadEnvFile(path: string, protectedKeys: Set<string>, overrideLoaded: b
 
 export function loadRootEnv() {
   const root = findWorkspaceRoot(import.meta.dirname);
-  const protectedKeys = new Set(Object.keys(process.env).filter((key) => process.env[key] !== undefined));
+  const protectedKeys = new Set(
+    Object.keys(process.env).filter((key) => process.env[key] !== undefined),
+  );
 
   loadEnvFile(resolve(root, ".env"), protectedKeys, false);
 
diff --git a/packages/db/src/schema/moderation_scan.ts b/packages/db/src/schema/moderation_scan.ts
index 5606370..873f9e6 100644
--- a/packages/db/src/schema/moderation_scan.ts
+++ b/packages/db/src/schema/moderation_scan.ts
@@ -1,4 +1,13 @@
-import { index, integer, jsonb, pgTable, serial, text, timestamp, uniqueIndex } from "drizzle-orm/pg-core";
+import {
+  index,
+  integer,
+  jsonb,
+  pgTable,
+  serial,
+  text,
+  timestamp,
+  uniqueIndex,
+} from "drizzle-orm/pg-core";
 
 export const moderationScanJobs = pgTable(
   "moderation_scan_jobs",
@@ -25,7 +34,11 @@ export const moderationScanJobs = pgTable(
   },
   (table) => ({
     statusIdx: index("moderation_scan_jobs_status_idx").on(table.status),
-    scheduleIdx: index("moderation_scan_jobs_schedule_idx").on(table.mode, table.status, table.createAt),
+    scheduleIdx: index("moderation_scan_jobs_schedule_idx").on(
+      table.mode,
+      table.status,
+      table.createAt,
+    ),
   }),
 );
 
diff --git a/packages/db/src/seed.ts b/packages/db/src/seed.ts
index 0b6e890..ce56aca 100644
--- a/packages/db/src/seed.ts
+++ b/packages/db/src/seed.ts
@@ -118,7 +118,14 @@ async function seed() {
   await db
     .insert(zones)
     .values([
-      { slug: "jobs", name: "招聘", description: "Node.js 招聘信息专区", icon: "briefcase", visible: false, sortOrder: 1 },
+      {
+        slug: "jobs",
+        name: "招聘",
+        description: "Node.js 招聘信息专区",
+        icon: "briefcase",
+        visible: false,
+        sortOrder: 1,
+      },
     ])
     .onConflictDoUpdate({
       target: zones.slug,
diff --git a/packages/db/src/topic-reply-repair.ts b/packages/db/src/topic-reply-repair.ts
index 54a33d0..5963c32 100644
--- a/packages/db/src/topic-reply-repair.ts
+++ b/packages/db/src/topic-reply-repair.ts
@@ -1,5 +1,7 @@
 export interface TopicReplyRepairClient {
-  query(sql: string): Promise<{ rowCount?: number | null; rows?: Array<{ mismatch_count?: number | string }> }>;
+  query(
+    sql: string,
+  ): Promise<{ rowCount?: number | null; rows?: Array<{ mismatch_count?: number | string }> }>;
 }
 
 const expectedAggregatesSql = `
@@ -53,9 +55,17 @@ export const topicReplyRepairApplySql = `
 export async function repairTopicReplyAggregates(client: TopicReplyRepairClient, dryRun: boolean) {
   if (dryRun) {
     const result = await client.query(topicReplyRepairDryRunSql);
-    return { mode: "dry-run" as const, mismatchedTopics: Number(result.rows?.[0]?.mismatch_count || 0), repairedTopics: 0 };
+    return {
+      mode: "dry-run" as const,
+      mismatchedTopics: Number(result.rows?.[0]?.mismatch_count || 0),
+      repairedTopics: 0,
+    };
   }
 
   const result = await client.query(topicReplyRepairApplySql);
-  return { mode: "apply" as const, mismatchedTopics: result.rowCount || 0, repairedTopics: result.rowCount || 0 };
+  return {
+    mode: "apply" as const,
+    mismatchedTopics: result.rowCount || 0,
+    repairedTopics: result.rowCount || 0,
+  };
 }
diff --git a/packages/shared/src/message-summary.ts b/packages/shared/src/message-summary.ts
index b406b9f..249bc9b 100644
--- a/packages/shared/src/message-summary.ts
+++ b/packages/shared/src/message-summary.ts
@@ -15,7 +15,10 @@ function decodeHtmlEntities(value: string) {
   });
 }
 
-export function messageContentSummary(content: string | null | undefined, maxLength = DEFAULT_MESSAGE_SUMMARY_LENGTH) {
+export function messageContentSummary(
+  content: string | null | undefined,
+  maxLength = DEFAULT_MESSAGE_SUMMARY_LENGTH,
+) {
   if (!content || maxLength <= 0) return "";
 
   const plainText = decodeHtmlEntities(
diff --git a/packages/shared/src/runtime-config.ts b/packages/shared/src/runtime-config.ts
index 9c80ad5..3d8f27f 100644
--- a/packages/shared/src/runtime-config.ts
+++ b/packages/shared/src/runtime-config.ts
@@ -21,7 +21,13 @@ function required(env: RuntimeEnv, name: string): string {
   return value;
 }
 
-function integer(env: RuntimeEnv, name: string, fallback: number, minimum: number, maximum: number): number {
+function integer(
+  env: RuntimeEnv,
+  name: string,
+  fallback: number,
+  minimum: number,
+  maximum: number,
+): number {
   const raw = env[name];
   if (raw === undefined || raw === "") return fallback;
 
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index caf1b8d..3e69463 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -4,8 +4,16 @@ settings:
   autoInstallPeers: true
   excludeLinksFromLockfile: false
 
+catalogs:
+  default:
+    vite-plus:
+      specifier: 0.2.8
+      version: 0.2.8
+
 overrides:
   shadcn>zod: 3.25.76
+  vite: npm:@voidzero-dev/vite-plus-core@0.2.8
+  vitest: 4.1.10
 
 importers:
 
@@ -30,21 +38,18 @@ importers:
       concurrently:
         specifier: ^9.1.0
         version: 9.2.4
-      husky:
-        specifier: ^9.1.7
-        version: 9.1.7
-      oxfmt:
-        specifier: ^0.60.0
-        version: 0.60.0
-      oxlint:
-        specifier: ^1.75.0
-        version: 1.75.0
       tsx:
         specifier: ^4.23.1
         version: 4.23.1
       typescript:
         specifier: ^5.7.0
         version: 5.9.3
+      vite:
+        specifier: npm:@voidzero-dev/vite-plus-core@0.2.8
+        version: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
+      vite-plus:
+        specifier: 'catalog:'
+        version: 0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
 
   apps/api:
     dependencies:
@@ -139,9 +144,12 @@ importers:
       typescript:
         specifier: ^5.7.0
         version: 5.9.3
-      vitest:
-        specifier: ^4.1.10
-        version: 4.1.10(@types/node@22.20.1)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))
+      vite:
+        specifier: npm:@voidzero-dev/vite-plus-core@0.2.8
+        version: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
+      vite-plus:
+        specifier: 'catalog:'
+        version: 0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
 
   apps/web:
     dependencies:
@@ -150,7 +158,7 @@ importers:
         version: 1.6.0(@types/react@19.2.17)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
       '@cloudflare/vite-plugin':
         specifier: ^1.46.0
-        version: 1.46.0(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))(wrangler@4.113.0)
+        version: 1.46.0(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(wrangler@4.113.0)
       '@cnode/db':
         specifier: workspace:*
         version: link:../../packages/db
@@ -235,13 +243,13 @@ importers:
     devDependencies:
       '@react-router/dev':
         specifier: ^7.18.0
-        version: 7.18.1(@react-router/serve@7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3))(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))(wrangler@4.113.0)(yaml@2.9.0)
+        version: 7.18.1(@react-router/serve@7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3))(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(wrangler@4.113.0)(yaml@2.9.0)
       '@react-router/serve':
         specifier: ^7.18.0
         version: 7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3)
       '@tailwindcss/vite':
         specifier: ^4.0.0
-        version: 4.3.3(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))
+        version: 4.3.3(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))
       '@testing-library/jest-dom':
         specifier: ^7.0.0
         version: 7.0.0(@testing-library/dom@10.4.1)
@@ -250,7 +258,7 @@ importers:
         version: 16.3.2(@testing-library/dom@10.4.1)(@types/react-dom@19.2.4(@types/react@19.2.17))(@types/react@19.2.17)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
       '@testing-library/user-event':
         specifier: ^14.6.1
-        version: 14.6.1(@testing-library/dom@10.4.1)
+        version: 14.6.3(@testing-library/dom@10.4.1)
       '@types/react':
         specifier: ^19.1.0
         version: 19.2.17
@@ -276,11 +284,14 @@ importers:
         specifier: ^5.7.0
         version: 5.9.3
       vite:
-        specifier: 7.3.6
-        version: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+        specifier: npm:@voidzero-dev/vite-plus-core@0.2.8
+        version: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
+      vite-plus:
+        specifier: 'catalog:'
+        version: 0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
       vitest:
-        specifier: ^4.1.10
-        version: 4.1.10(@types/node@22.20.1)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))
+        specifier: 4.1.10
+        version: 4.1.10(@types/node@22.20.1)(@vitest/browser-preview@4.1.10)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
       wrangler:
         specifier: ^4.0.0
         version: 4.113.0
@@ -536,6 +547,9 @@ packages:
       '@types/react':
         optional: true
 
+  '@blazediff/core@1.9.1':
+    resolution: {integrity: sha512-ehg3jIkYKulZh+8om/O25vkvSsXXwC+skXmyA87FFx6A/45eqOkZsBltMw/TVteb0mloiGT8oGRTcjRAz66zaA==}
+
   '@bramus/specificity@2.4.2':
     resolution: {integrity: sha512-ctxtJ/eA+t+6q2++vj5j7FYX3nRu311q1wfYH3xjlLOsczhlhxAg2FWNUXhpGvAw3BWo1xBcvOV6/YLc2r5FJw==}
     hasBin: true
@@ -645,11 +659,11 @@ packages:
 
   '@esbuild-kit/core-utils@3.3.2':
     resolution: {integrity: sha512-sPRAnw9CdSsRmEtnsl2WXWdyquogVpB3yZ3dgwJfe8zrOzTsV7cJvmwrKVa+0ma5BoiGJ+BoqkMvawbayKUsqQ==}
-    deprecated: 'Merged into tsx: https://tsx.hirok.io'
+    deprecated: 'Merged into tsx: https://tsx.is'
 
   '@esbuild-kit/esm-loader@2.6.5':
     resolution: {integrity: sha512-FxEMIkJKnodyA1OaCUoEvbYRkoZlLZ4d/eXFu9Fh8CbBBgP5EmZxrfTRyN0qpXZ4vOvqnE5YdRdcrmUUXuU+dA==}
-    deprecated: 'Merged into tsx: https://tsx.hirok.io'
+    deprecated: 'Merged into tsx: https://tsx.is'
 
   '@esbuild/aix-ppc64@0.19.12':
     resolution: {integrity: sha512-bmoCYyWdEL3wDQIVbcyzRyeKLgk2WtWLTWz1ZIAZF/EGbNOwSA6ew3PftJ1PqMiOOGu0OyFMzG53L0zqIpPeNA==}
@@ -1600,253 +1614,297 @@ packages:
   '@open-draft/until@2.1.0':
     resolution: {integrity: sha512-U69T3ItWHvLwGg5eJ0n3I62nWuE6ilHlmz7zM0npLBRvPRd7e6NYmg54vvRtP5mZG7kZqZCFVdsTWo7BPtBujg==}
 
-  '@oxfmt/binding-android-arm-eabi@0.60.0':
-    resolution: {integrity: sha512-1q4q4Jc8FlOMVojEisyFAVyl8h1yawNv6phjgmhGVEDeyeOdsSnSr9x0+D4mOnEKvpO5L4mxKZ/DP9X6U3A/Mw==}
+  '@oxc-project/runtime@0.142.0':
+    resolution: {integrity: sha512-Dv3jRrcXFdvUBUEljUu9kusrEo9G0iiqZFZNg3yCg+mkET4DD4S2Ow6Q6shFWDJwPidSa980d6YVXBlErUGADw==}
+    engines: {node: ^20.19.0 || >=22.12.0}
+
+  '@oxc-project/types@0.142.0':
+    resolution: {integrity: sha512-7W+2q5AKQVU36fkaryontrHn3YDt1RyUYXatw9i5H8ocYe2sPKSFB6eS8WNPeRKiN1qAWWZUPm7gwFzJGrccqQ==}
+
+  '@oxfmt/binding-android-arm-eabi@0.61.0':
+    resolution: {integrity: sha512-BaS+1OVvg9sr+Xav0+KdWedQRcAzrdoEcwMZeqoc2F6ieC1s/t5eM35YQoRPQ7vAqkZ+p3tbQb1r9I9mrV5oGA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [android]
 
-  '@oxfmt/binding-android-arm64@0.60.0':
-    resolution: {integrity: sha512-tD41I6nCt9k8SQXft0CSjjU9jg6SwG7uMu7PxodSEHXl+GDW0868oy6tTtoJkyUze8YKFgTpz/k5LuPUnFiGLw==}
+  '@oxfmt/binding-android-arm64@0.61.0':
+    resolution: {integrity: sha512-of8atAV0M1egGcVOMbgZCvc10sFOP3ayQBNQV5h5G3fNq8gACdEswfFk9bzGrdbM23rtg0Coxi7np7oPLcueNw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [android]
 
-  '@oxfmt/binding-darwin-arm64@0.60.0':
-    resolution: {integrity: sha512-TTpzPug96Zxdyb46KvTyIUQDdsqbumXh2TKG9C23PCT0kF7JkW56Z/quPuG9rqOFKQIi1gpRNZ7DX18LwxXPnw==}
+  '@oxfmt/binding-darwin-arm64@0.61.0':
+    resolution: {integrity: sha512-7l8+5ov4BGwtAcmpzvEik/TG3bciwyw/S3e6j5GKH7pcQqcgCVxD3AuJeP6upto+SOTBKQ4wrrdbMt0gq8fHSQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [darwin]
 
-  '@oxfmt/binding-darwin-x64@0.60.0':
-    resolution: {integrity: sha512-CnOoWgQ7L+JL/YQaRJ+NyATciSfcftncm7y3kqyte1cGtFEGnStaCd1TAyrinkfQ7nRBfHrTs1/vTwUJr3WF2Q==}
+  '@oxfmt/binding-darwin-x64@0.61.0':
+    resolution: {integrity: sha512-Fnz4dDDXBb7udk+DmwelNjxbD6yptyxwCqwCH2ebo4RVLxVsRfFsn/AHJC49KIltPrVokamGv4SSOsiV50DTxQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [darwin]
 
-  '@oxfmt/binding-freebsd-x64@0.60.0':
-    resolution: {integrity: sha512-ychJo7S3hZxdO6eDZ9zM6F2lM9fpJS3EKS5CAUSWyprdLYxTu4gbaUKV/VBPTcMJwQa2Bpo+643y3OJ537pihA==}
+  '@oxfmt/binding-freebsd-x64@0.61.0':
+    resolution: {integrity: sha512-mddOebKNCP+AucmzfNsk3jgbr681qAUvgMqi865GW5gWLJ/AnzXbvjQRrny0e++NAN8aphav/aRSrfFxNsNjpA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [freebsd]
 
-  '@oxfmt/binding-linux-arm-gnueabihf@0.60.0':
-    resolution: {integrity: sha512-36IH5o55T2Fx7E0feDttt+mifxN6yk9pWv4KfhAIsP0dFnUq27331OwbpOsZdoXF9soOLWm7mQUz5+UUmyec4g==}
+  '@oxfmt/binding-linux-arm-gnueabihf@0.61.0':
+    resolution: {integrity: sha512-svx59iYL+DbaZGZUIoice4W0CjRXGExnbz7Re+awIb60rVxBS2KrU7Hnlx+nZYanLGLpjneUEgo/VFEKkSZAyQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
-  '@oxfmt/binding-linux-arm-musleabihf@0.60.0':
-    resolution: {integrity: sha512-G1Ve7lAa6sFBolVI2LWHfEAqy0YKh4vnioH8uYO9kAEdgM7mR40IksIx9/Zk4+vbYew/sGa4J9Q4tZ3n9gXDHA==}
+  '@oxfmt/binding-linux-arm-musleabihf@0.61.0':
+    resolution: {integrity: sha512-BYK9MPJPCf6d+fLKMTruThmEyCtHzQ1zLcsrTlUVkmnoXIaHAbfpeLYQwX1tkjs7W11dyzoi6HFvKcdnvX1zNg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
-  '@oxfmt/binding-linux-arm64-gnu@0.60.0':
-    resolution: {integrity: sha512-LTQdRBf6uzj/h7Xk6lKzbGD2hrF/fK4YI9LIN1c0509tPUn8wRa3mCmrFQpEWJPLYGFrLFFMTYW1Ljj6VqW2Hw==}
+  '@oxfmt/binding-linux-arm64-gnu@0.61.0':
+    resolution: {integrity: sha512-QUaCNLq2/EC6G5ljOuFanl9Lgw6ZWp4co7rs4+KOMUzbGfA4Lq58FHRjjF9sVIG+93XSbo343MxFATrOU1qctA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
     libc: [glibc]
 
-  '@oxfmt/binding-linux-arm64-musl@0.60.0':
-    resolution: {integrity: sha512-2JMo3XPxMPx3hiqddSZYyaH+fKJm6cz0u8n1naYjP/CdOQOZW34i8lKBUfmbWiuFvd6KoYXLmhAyBuvojsYS7Q==}
+  '@oxfmt/binding-linux-arm64-musl@0.61.0':
+    resolution: {integrity: sha512-S6uvJ6MXnRXl+zTs0CARNDvkE+cymj0EVWEKKsyKnlLlqTyQJBjw5s4D2pSIOZc+S46cy4STefzcr/sm0VzVPA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
     libc: [musl]
 
-  '@oxfmt/binding-linux-ppc64-gnu@0.60.0':
-    resolution: {integrity: sha512-L3C+nBD13lr306tr/PjM3RMll+BVqgFrIgUyoeHuai5oueJrRLgO3j+GO5/Cbhtkf5PSlHYTI1JY7iqBd1qa6A==}
+  '@oxfmt/binding-linux-ppc64-gnu@0.61.0':
+    resolution: {integrity: sha512-6VDlRcytvZG6UlSIdAFKDLbppo9tvPxrWzle6vHldYFMeuDPQEfMKrkwezp7FaBq1wik9ra554ZZeRPsyIkFpg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
     libc: [glibc]
 
-  '@oxfmt/binding-linux-riscv64-gnu@0.60.0':
-    resolution: {integrity: sha512-M4MsmvqlxFiPtSRGyBYQSZxchEf463AOyd+Dh4/9xDpjWBsRtDUTDMFN5EdHinjVK1/eDJQ8MLpcYjpYayaCnA==}
+  '@oxfmt/binding-linux-riscv64-gnu@0.61.0':
+    resolution: {integrity: sha512-KkBTYbzExpbmn15XjKPLu2fRV2PVlq+KWt+brad5rwIa03vdYoaDRWiS7raHII/dCTR6Ro4UpYUCH4t6lif4WQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
     libc: [glibc]
 
-  '@oxfmt/binding-linux-riscv64-musl@0.60.0':
-    resolution: {integrity: sha512-OH+9UskYuxRB+GxqdGkVN8f5UpwhqG8YscNo1wl8+KJ62cd7wZdGga6iGLJIf8kibF1WBwvlfDUx3cez/VXwFg==}
+  '@oxfmt/binding-linux-riscv64-musl@0.61.0':
+    resolution: {integrity: sha512-69tzIq7sJLVB9dxYYtvMzcSSsnZHSO+U2U19O2RqDqgj6+Q4O7HjSXdaszbcgqzhsUwzSH7z5kWvk8nmf6BHTg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
     libc: [musl]
 
-  '@oxfmt/binding-linux-s390x-gnu@0.60.0':
-    resolution: {integrity: sha512-y7AAFutt9wFWBFOAn6+BHaV39usZmcr3YYH2385f+NHgPNpIF9HpqKp0jgUxPaUOCyG3oaX5VhJduL1Nw164rw==}
+  '@oxfmt/binding-linux-s390x-gnu@0.61.0':
+    resolution: {integrity: sha512-Oqi/N0OvtOVXsPKAOOhKgGH3msRYF8BLJaNBbWiupRiKoKVyc8JRKPCfarkQJC+RgP9U8raUKLe+bNwd0HUMiA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
     libc: [glibc]
 
-  '@oxfmt/binding-linux-x64-gnu@0.60.0':
-    resolution: {integrity: sha512-yKZ9+CXAI+1RO5nH/4Z/9M6DAsfOzd5bw/gtWk81KB4mpalMaRRSXfouc5/tHxazDmBek55HNPepNYBgaCew0Q==}
+  '@oxfmt/binding-linux-x64-gnu@0.61.0':
+    resolution: {integrity: sha512-3TKwv/ed4uwJSemAA8P9XcoqETpjQI4waquF9UilhA9Mn/dhr1PdUEXWlL74mtc6ZNfmKPA9+NEJm01nRF8CVA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
     libc: [glibc]
 
-  '@oxfmt/binding-linux-x64-musl@0.60.0':
-    resolution: {integrity: sha512-bCUGaF6hJOYnQzLJdHLZbvGsOd5oSvGAyJhPAKum2uyLYUuXmP8vqg690DWi2hqcnIoYpqSqCrjzE5aiUAgwQg==}
+  '@oxfmt/binding-linux-x64-musl@0.61.0':
+    resolution: {integrity: sha512-uFso4u4nLkVSlMCpgjyvWV60Gt7GvDQHnk1mmRxHIkZTMB0ljpUKwCD9FYGgN9H97x2wYl0UwEjgRZaPIuhEhw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
     libc: [musl]
 
-  '@oxfmt/binding-openharmony-arm64@0.60.0':
-    resolution: {integrity: sha512-GrUeZOvzP30ExxfCuQiyofuUGI+OmvAgFwOO5w5p9mGPlxcyuqI+6Sy9fAKFFfLQrqKYWFgc5sYA2Unj/29nPg==}
+  '@oxfmt/binding-openharmony-arm64@0.61.0':
+    resolution: {integrity: sha512-keGLkzeOvkMpNmPp4hffXWpfoSsY6e1K8++KXD4mSSfxdvM8q9QUDsYY689TB1k6Co832DZn1MnaaVx6cIBMWQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [openharmony]
 
-  '@oxfmt/binding-win32-arm64-msvc@0.60.0':
-    resolution: {integrity: sha512-WD4Q954kUl2TDJV/6q7UnE2rlKk047kXLJsr4bJ2mXRaAqNXcmV3nwKUsGCc3mz/jYDBnXtJEaBErJEybK8iQQ==}
+  '@oxfmt/binding-win32-arm64-msvc@0.61.0':
+    resolution: {integrity: sha512-VzsAISkFxmNhJ5LBDEL9VuH6tJsVJMtqYit2LyIUf/HLnsCe4Pg9SMOjjVQzGWt0bnpyfJ94CrqTqcpNZzK+ug==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [win32]
 
-  '@oxfmt/binding-win32-ia32-msvc@0.60.0':
-    resolution: {integrity: sha512-HqDekjr8JXzVDUP1YthDZ1Y3CBEcuZT4WX3B+1kaxj8CvZA8Y2YhcEsXqoSop3tVsgjACxjnFQFDkBo0r/jq1Q==}
+  '@oxfmt/binding-win32-ia32-msvc@0.61.0':
+    resolution: {integrity: sha512-xv4t7yzwJoYaLB6Zv28B3W+j7brEjsyv50rLTAQgmxJzddce9fAMCxed8dSAkbWES0zz2J29nYK5FaTuD2YBHg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ia32]
     os: [win32]
 
-  '@oxfmt/binding-win32-x64-msvc@0.60.0':
-    resolution: {integrity: sha512-tz78yhmGPKboTMHCHSaUqXK8JrmoSejgDcWeqAtg2s07ZGKQ3rH5Jn8NuXPGNG33CDbY2e9NoQWXIVEmKO21Rw==}
+  '@oxfmt/binding-win32-x64-msvc@0.61.0':
+    resolution: {integrity: sha512-6EZXFkqOwxdDYjIn3TSNnPk3ST5E5GiYd4FiM6UF/mCL/LZSfr6D6UygTfW3R1PCQP2quCKpCEGRlij8E3VYbg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [win32]
 
-  '@oxlint/binding-android-arm-eabi@1.75.0':
-    resolution: {integrity: sha512-lutovtFzJqlRaqpZrCqSSGaHZzl9nIxxpjLzhSRLunN6dCLylj0uzlCyQGaQDIys7rrv8kVXiFO+R4Zpn0bX7g==}
+  '@oxlint-tsgolint/darwin-arm64@7.0.2001':
+    resolution: {integrity: sha512-CUJEdbSZ54+Xy9OXqOhWLTKZKV0BBiV7C2i/ygyVmXtkUNXx5YCzN8DpSSshTAKktoL7S+tnQ/ftFG/i7X896w==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@oxlint-tsgolint/darwin-x64@7.0.2001':
+    resolution: {integrity: sha512-pXfBb5BqONCcgrXQNUZWXgiYmRSWJzd97S8i41VVOh6ut0tyo+cJ5FKFpczDHxiVNfj/3e7c9B4MtztNdpIVCw==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@oxlint-tsgolint/linux-arm64@7.0.2001':
+    resolution: {integrity: sha512-roP7zujb/QDPzDwEKsFFpzNHHy91/Y7oX9vQXk78ekyZtcQj1QXDIMH33gjDdHBfRl4K9pZ36xhRgrP4Zr+R8A==}
+    cpu: [arm64]
+    os: [linux]
+
+  '@oxlint-tsgolint/linux-x64@7.0.2001':
+    resolution: {integrity: sha512-UDezNqdECVmngu2TPnjaS1YoAmcTaBoI5lV9vk3VahBxoi+I5r9k3iJTT7qZoYWOXTD/7T7bNcwRgrocR6BscQ==}
+    cpu: [x64]
+    os: [linux]
+
+  '@oxlint-tsgolint/win32-arm64@7.0.2001':
+    resolution: {integrity: sha512-uJZhqB6pdXLuN+AD1F5082byyQti/NPmJA77GtcFlmT2HzRelqbNls3SaIqxpjdFgvSBF9g0yOKGBkGFg7kX8Q==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@oxlint-tsgolint/win32-x64@7.0.2001':
+    resolution: {integrity: sha512-FkDRm8hx9OwzGQqyWG1tO5QrTLRApff9DzSgpz9QZau37BR8d1VYKOxMLGf6shPZntJFoTwIIJYT68VndYDCog==}
+    cpu: [x64]
+    os: [win32]
+
+  '@oxlint/binding-android-arm-eabi@1.76.0':
+    resolution: {integrity: sha512-ZHIE5Zt9AsPDcY4nOlofXt0YfneEeo+QrKMPcPzLf2Z6Q8VtV2W73d7SFJ920WUwyik783u/doKCs3KXdwG+7w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [android]
 
-  '@oxlint/binding-android-arm64@1.75.0':
-    resolution: {integrity: sha512-hXI0hDgHkw4w5nfru72aG7y+2iQJmC4waH/KV6H/hbgA6yAP5jYNx0P9yug15Hs0tWl/+mda3Jjn/2gmDT48tw==}
+  '@oxlint/binding-android-arm64@1.76.0':
+    resolution: {integrity: sha512-shm/ngQilHK6bs+ElJWa4oHfNj5vL1Gl/iVEJldTQjpr0/67oSgr0KUpbmcnLig5Fo0v/l6j2567A7TOL89ONA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [android]
 
-  '@oxlint/binding-darwin-arm64@1.75.0':
-    resolution: {integrity: sha512-D91BWbK/dMYfCcrghspPIuKs2D9LF4Z/OabVSQjw1AO6PWxArD7teDA48bm0ySFqWDaPVqmQRl5GMWNglTXyrQ==}
+  '@oxlint/binding-darwin-arm64@1.76.0':
+    resolution: {integrity: sha512-rvJmrAPKSQ9aWJ6wIS6CK2tJjwzfW0ApQH9qokq6sfDvmHwoyIHxHFMq7z7i7GiV6fdE6s8qvBqWKPTu8RmT6Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [darwin]
 
-  '@oxlint/binding-darwin-x64@1.75.0':
-    resolution: {integrity: sha512-02mpwzf12BonZ6PT0TuQoomvEh2kVl2WGBIKWezCyToIS+rYkQZ6GXnARBAl9A4Ovm2V+Xe7M4KretyqmmcnJQ==}
+  '@oxlint/binding-darwin-x64@1.76.0':
+    resolution: {integrity: sha512-U/zYdb7VYKGY6pA9Vd2rYl9O/HlCylcOlb5PGPvVLtg+oLGsk6H3XGKEMHKyqD3nmmtmlmwb/8SwU2vfSAtvMw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [darwin]
 
-  '@oxlint/binding-freebsd-x64@1.75.0':
-    resolution: {integrity: sha512-qZJgLnDaBsiL5YESx2t/TZ8eXkL9fEkKoXEdzegROhlz9A0lgyGnZ0dAzJrh7LJAHQl2K9RdRueN2s/9N7+odg==}
+  '@oxlint/binding-freebsd-x64@1.76.0':
+    resolution: {integrity: sha512-WvKG9CAriuo0XNiFzpXjDngUZcRGFNpaK2kLyMUsnJlShxkT96u+BpJQ3KqdQwGOrvI14L6V8bAwXwAYNNY6Jg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [freebsd]
 
-  '@oxlint/binding-linux-arm-gnueabihf@1.75.0':
-    resolution: {integrity: sha512-7XlaWA5BJD3XpCfrEqjEe6Zseeb14S7QGa304XfwKignRaKQ+eIj775BQ7nIslggWickl4IsPUFqJ+/gAyNHVg==}
+  '@oxlint/binding-linux-arm-gnueabihf@1.76.0':
+    resolution: {integrity: sha512-qJ5+RH99TqFRq3UCDxkW0zJJu9c+OAHFY72vGlxZLEpuO+MpKo3POgqb8sYipL9KYm8XY6ofb0HsOuvY6hQNqQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
-  '@oxlint/binding-linux-arm-musleabihf@1.75.0':
-    resolution: {integrity: sha512-av6Tpv8yrcMMMOadOqENBhlsLRcGFXXwoQ0hzHhsmS9FJ4Wioy8we427GbcMe2XTxmL2e60T67H1Dyr3up+tAA==}
+  '@oxlint/binding-linux-arm-musleabihf@1.76.0':
+    resolution: {integrity: sha512-PvPCVptkgVARsucgIqFQQcSmJ6xc6GtnVB5bRBekRahTc9eObMtjHfMjy5M+C2tHt5UCMttWM9RuSk/H9NqYeg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm]
     os: [linux]
 
-  '@oxlint/binding-linux-arm64-gnu@1.75.0':
-    resolution: {integrity: sha512-WcUhd8fHT5plrA14lANevl+hOl815mVI5t2hU21oFWrZKFXIVV/Sr4rWQV0NzSvzBupbMLNc5ErEA6Ehxh5jMg==}
+  '@oxlint/binding-linux-arm64-gnu@1.76.0':
+    resolution: {integrity: sha512-3KeFDx8Bu4HPAXbuHZOr/oHvN+QT+JQhMw/NYPz7Z071xLSsG27Jfh9PIQVEY7hk1I+jr43ExqRIeJ6VKk2yLw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
     libc: [glibc]
 
-  '@oxlint/binding-linux-arm64-musl@1.75.0':
-    resolution: {integrity: sha512-UWzp5wRHFe/ESO3+eEaxXsTkYTGLYjnTsi/I5neEacXSItQ6WNleapfOAeA4x2b8nyhJ4uQxqvtv9pHv8kWJtQ==}
+  '@oxlint/binding-linux-arm64-musl@1.76.0':
+    resolution: {integrity: sha512-oPFkkKTgl0K/EIg9fQ8oA3IGcI05/Mq1en04iFa41mmNPT+6KEiByVazTOZZJiHMBBrbsns1YJ2e1Scqwzesjw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
     libc: [musl]
 
-  '@oxlint/binding-linux-ppc64-gnu@1.75.0':
-    resolution: {integrity: sha512-XEVRwGMLKCUKrvhLAz4F6AIh8MJrQVdSZtAmPpRZt9tGPsUnamPOcl3dS/ZQzJnar/Ymgc//+xho0L60Emzuxg==}
+  '@oxlint/binding-linux-ppc64-gnu@1.76.0':
+    resolution: {integrity: sha512-gN7yZ0eqflA5Fhf1wvHxGUltIV3FsvmB1zhNMDEK9vSHhc7E6qg9CuPeBgPZab66Tjzq6w6kHAtNEvnTHf4cyw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
     libc: [glibc]
 
-  '@oxlint/binding-linux-riscv64-gnu@1.75.0':
-    resolution: {integrity: sha512-mAG4DUXqfLC8cTjMD2kt3jDmVzFREYtDyeLNdLdsCcBc4Zbl2EMuiFektGBilQwkNjYnMvCqJs55U+Hyb+b+jw==}
+  '@oxlint/binding-linux-riscv64-gnu@1.76.0':
+    resolution: {integrity: sha512-S/HqMbn22mQrjtErUxEoS/a55u8kIeXvreIxiJu5G7Le3UecEd6SQZxrDIpuhtgaFnsY/nVra3ytP+pRljDilA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
     libc: [glibc]
 
-  '@oxlint/binding-linux-riscv64-musl@1.75.0':
-    resolution: {integrity: sha512-95hrAvriAlI+pekSomTFIn0+bawMDlDwTNVmdjsFusTHyL2JWh7TWvRNG/Lkim72uN8OiCcO9wcaC6omLP5E3w==}
+  '@oxlint/binding-linux-riscv64-musl@1.76.0':
+    resolution: {integrity: sha512-ZIga3097VJZolGZk6SrIAUokIGfRkxRlhiHDUznZptGBfwrhD7pNfD1rzEzsCwvk/1DX0A1bLz+liuNh5QKIVQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
     libc: [musl]
 
-  '@oxlint/binding-linux-s390x-gnu@1.75.0':
-    resolution: {integrity: sha512-4b6f2+FrtruAESrCqIKcrarzfrSx+wk2QNcp+RT91/Prc+pMQMAfyZ1rG1c3tFQNl8Bc616tx40uNXyxNBRPbQ==}
+  '@oxlint/binding-linux-s390x-gnu@1.76.0':
+    resolution: {integrity: sha512-ZGiiA7pFzMJSyMWYZTVlPgbTsx+Vl8ihLGMIujPwaslUF7kIPPWAbVmAlTc+9lWDV+DCiB8Ikixu+lSHeOIIWQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
     libc: [glibc]
 
-  '@oxlint/binding-linux-x64-gnu@1.75.0':
-    resolution: {integrity: sha512-nshAhrUvXFUWOvqQ2soIw7HFNWvpvEV4o0cYSqPtzLiPF5gKyYTDOOTJ6Rn8g8K/iGvPIrbDA4v8+5MvnjJrrg==}
+  '@oxlint/binding-linux-x64-gnu@1.76.0':
+    resolution: {integrity: sha512-JLiy5WuvEBFTT6ErIFV35SLzi0R7Iri6MKU6dZbTxfIx8pndbbPs3Mj780nMipBFcPkti+okAPOJ9POKkHFEgg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
     libc: [glibc]
 
-  '@oxlint/binding-linux-x64-musl@1.75.0':
-    resolution: {integrity: sha512-e4jNxLKnxLC6sYBQRxrI2pgIIxnmMtF8U/VwNYcjTT/CLS+spH624cYVnj07bTKwaEWT37/e025isOs6j/0xqA==}
+  '@oxlint/binding-linux-x64-musl@1.76.0':
+    resolution: {integrity: sha512-z7lgKQtbo/I1NIe8G5NHLesxJDv0tRSUWTpXKb9Pm3E9nKFKfO4IOSDtFroKgXtOYb0jQbcdH+0wzTyMXVes+A==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
     libc: [musl]
 
-  '@oxlint/binding-openharmony-arm64@1.75.0':
-    resolution: {integrity: sha512-hZ2lH+1qLf/DiEP9UWuQTK2JWj/BgvMB4jhIV4SmNU1wfEiYYX4TynQyAZXx0j9X4qRYizAL042SKaV+8ynh4w==}
+  '@oxlint/binding-openharmony-arm64@1.76.0':
+    resolution: {integrity: sha512-JOjKymIpb9QcYfEhZsN6h4V9Ivd474W38cNIBRv6bg2TbIvogbMTH0Mg6YWW9TiRDqfcX+/Hyfsbo5vcSE5guQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [openharmony]
 
-  '@oxlint/binding-win32-arm64-msvc@1.75.0':
-    resolution: {integrity: sha512-Ilj6PNzGDS3bCU0MSJH7Msh0NhH+T/mRp2shwg+q+GHeVlPwP5LEboW96aW+3kVKFk6zYZy1Xi5pZkqZh6X8KQ==}
+  '@oxlint/binding-win32-arm64-msvc@1.76.0':
+    resolution: {integrity: sha512-pqDWZiwcmByWUEm1NFUBNiT6aentCcaoMWJv0HbXEmuYermJ4sg8ppVrshubYP2MZ6SHccJJcpr6x469PuDFIw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [win32]
 
-  '@oxlint/binding-win32-ia32-msvc@1.75.0':
-    resolution: {integrity: sha512-QVit2nOEOiPhkmsrksPSkoGCdnZRNkspt8fwoYyP09te1VEbnSj4LAxua4rc8FKTmWkySVe05j8iz9GXYfF1AQ==}
+  '@oxlint/binding-win32-ia32-msvc@1.76.0':
+    resolution: {integrity: sha512-Ba0O659kgMv6pwO3z9PdO+K3aMxQRaw9HnG+e6AtOfgwcKFvYilciQYBoUBmxfQvOCKZe1SwjMkuB542NkuDMQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ia32]
     os: [win32]
 
-  '@oxlint/binding-win32-x64-msvc@1.75.0':
-    resolution: {integrity: sha512-DSxnNkBUAYARPwJtR12Ig3deWr8w0H997xP6jy33i+e0SyYJw8FKuz4+cZtpmPEhQmvlPJE3X/2vNxDmLkd/rA==}
+  '@oxlint/binding-win32-x64-msvc@1.76.0':
+    resolution: {integrity: sha512-5qcirPHO8nKfkoowEVWtpAoVTcYDy6g0UT0NGic450Qv8J2NrOqg4uQ8QppRP4MDTC7Xx47lbZnmadTH03CGGA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [win32]
 
+  '@oxlint/plugins@1.73.0':
+    resolution: {integrity: sha512-OhgMQeMmZA0dcFcX4/priaJZWdFECxiClgq6mRX6aatZEcV9PbKC3P3/v8U1hVjviT1i5U+vR8lAtBV6m4FXAA==}
+    engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+
   '@petamoriken/float16@3.9.3':
     resolution: {integrity: sha512-8awtpHXCx/bNpFt4mt2xdkgtgVvKqty8VbjHI/WWWQuEw+KLzFot3f4+LkQY9YmOtq7A5GdOnqoIC8Pdygjk2g==}
 
+  '@polka/url@1.0.0-next.29':
+    resolution: {integrity: sha512-wwQAWhWSuHaag8c4q/KN/vCoeOJYshAIvMQwD4GpSb3OiZklFfvAgmj0VCBBImRpuF/aFgIRzllXlVX93Jevww==}
+
   '@poppinss/colors@4.1.6':
     resolution: {integrity: sha512-H9xkIdFswbS8n1d6vmRd8+c10t2Qe+rZITbbDHHkQixH5+2x1FDGmi/0K+WgWiqQFKPSlIYB7jlH6Kpfn6Fleg==}
 
@@ -2086,144 +2144,6 @@ packages:
   '@remix-run/node-fetch-server@0.13.3':
     resolution: {integrity: sha512-UfjOXed/DQteaM5VyTfqTeGpHwyL2J5aoRGY6cydip4tt1ehNNeSwuXCC7AEGE0RWBs/7bgKxYkL/B/+UDe4AA==}
 
-  '@rollup/rollup-android-arm-eabi@4.62.2':
-    resolution: {integrity: sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==}
-    cpu: [arm]
-    os: [android]
-
-  '@rollup/rollup-android-arm64@4.62.2':
-    resolution: {integrity: sha512-BaH7BllCACHoH1LguOU56UItGfUWjujlO65kS9LAodViaN4bwIKd7oeW/ZHJ/4ljr/7MIiENnNy3HJ0zXv8Zkw==}
-    cpu: [arm64]
-    os: [android]
-
-  '@rollup/rollup-darwin-arm64@4.62.2':
-    resolution: {integrity: sha512-v39RCCvj4He82I9sFmk+M1VZ0PLM9sfsLVikjfx2hYBNALhrrOR2D3JjQA6AhlaSOgcR+RzrKY7e1+bT6SUO/A==}
-    cpu: [arm64]
-    os: [darwin]
-
-  '@rollup/rollup-darwin-x64@4.62.2':
-    resolution: {integrity: sha512-yl0y2vq3S3lHeuXhEdss6TWfKW8vkujImO12tn4ZkG/4oghr09LvdYm2RElVjokTQiUvDUGXLGsYeLqUMCKpGA==}
-    cpu: [x64]
-    os: [darwin]
-
-  '@rollup/rollup-freebsd-arm64@4.62.2':
-    resolution: {integrity: sha512-tT4pvt4qXD+vEoezupCWi+a1F0vvDiksiHc+PxRlYTOH1I6/X4id9jPxTP+Fg+545euaFT1jJVs4CEdHZAU1vw==}
-    cpu: [arm64]
-    os: [freebsd]
-
-  '@rollup/rollup-freebsd-x64@4.62.2':
-    resolution: {integrity: sha512-6nU5F2wCW+qvCBhTn1pdIU3bzsIoF7EUwsCDRxilWGprQR6yd508YnH9+OKFCwpfS8pjZqDUmnCAr7exax0XCg==}
-    cpu: [x64]
-    os: [freebsd]
-
-  '@rollup/rollup-linux-arm-gnueabihf@4.62.2':
-    resolution: {integrity: sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==}
-    cpu: [arm]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-arm-musleabihf@4.62.2':
-    resolution: {integrity: sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==}
-    cpu: [arm]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-arm64-gnu@4.62.2':
-    resolution: {integrity: sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==}
-    cpu: [arm64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-arm64-musl@4.62.2':
-    resolution: {integrity: sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==}
-    cpu: [arm64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-loong64-gnu@4.62.2':
-    resolution: {integrity: sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==}
-    cpu: [loong64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-loong64-musl@4.62.2':
-    resolution: {integrity: sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==}
-    cpu: [loong64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-ppc64-gnu@4.62.2':
-    resolution: {integrity: sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==}
-    cpu: [ppc64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-ppc64-musl@4.62.2':
-    resolution: {integrity: sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==}
-    cpu: [ppc64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-riscv64-gnu@4.62.2':
-    resolution: {integrity: sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==}
-    cpu: [riscv64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-riscv64-musl@4.62.2':
-    resolution: {integrity: sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==}
-    cpu: [riscv64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-linux-s390x-gnu@4.62.2':
-    resolution: {integrity: sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==}
-    cpu: [s390x]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-x64-gnu@4.62.2':
-    resolution: {integrity: sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==}
-    cpu: [x64]
-    os: [linux]
-    libc: [glibc]
-
-  '@rollup/rollup-linux-x64-musl@4.62.2':
-    resolution: {integrity: sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==}
-    cpu: [x64]
-    os: [linux]
-    libc: [musl]
-
-  '@rollup/rollup-openbsd-x64@4.62.2':
-    resolution: {integrity: sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==}
-    cpu: [x64]
-    os: [openbsd]
-
-  '@rollup/rollup-openharmony-arm64@4.62.2':
-    resolution: {integrity: sha512-8hOJnxgbyObnCm5AlRA3A931xX19xq80RjVTKgJOvEKWqJruP/Uf12IbAOaDjjEXYRewwHLfmF0YRIdK3OwKWA==}
-    cpu: [arm64]
-    os: [openharmony]
-
-  '@rollup/rollup-win32-arm64-msvc@4.62.2':
-    resolution: {integrity: sha512-mmF4AY1i0hG/bLWUctUq59gtmgaSIRa3cu/A3JFRp/sCNEme2bgDEiDS22P9FbnJB8NJNF4jPJiSP5RHQpUTDg==}
-    cpu: [arm64]
-    os: [win32]
-
-  '@rollup/rollup-win32-ia32-msvc@4.62.2':
-    resolution: {integrity: sha512-DZgkknc6jhHrk46V25vbAM0zZkyP0nSDkJB8/dRkLTxv470dOmWDqGoEJl/9A0dFfS7yE3REOwNDxpHwSLSt0Q==}
-    cpu: [ia32]
-    os: [win32]
-
-  '@rollup/rollup-win32-x64-gnu@4.62.2':
-    resolution: {integrity: sha512-T6xr6ucWSFto+VGajA8YH26LdpHRuP4YLHEKAtCWvJDOlnmWcDZVCI2Jmjr+IFHDlt2zRaTAKE4tfjTaWLgJBg==}
-    cpu: [x64]
-    os: [win32]
-
-  '@rollup/rollup-win32-x64-msvc@4.62.2':
-    resolution: {integrity: sha512-BfzEnDJOt9T8M989/lA37EcJgat01wLRnoi5dQf3QzOH7jzpqTAzdDbVfRljVr5r+jzKqpbHeyOfAaXxAd0PAA==}
-    cpu: [x64]
-    os: [win32]
-
   '@scarf/scarf@1.4.0':
     resolution: {integrity: sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ==}
 
@@ -2488,8 +2408,8 @@ packages:
       '@types/react-dom':
         optional: true
 
-  '@testing-library/user-event@14.6.1':
-    resolution: {integrity: sha512-vq7fv0rnt+QTXgPxr5Hjc210p6YKq2kmdziLgnsZGgLJ9e6VAShx1pACLuRjd/AS/sr7phAR58OIIpf0LlmQNw==}
+  '@testing-library/user-event@14.6.3':
+    resolution: {integrity: sha512-6dBq67jT8lE+JTE8Exm02Kt6ze43hz1jdiSpSJwtTZiT1xQQ6b7nZYTTQ9njdArdU8XklOwaDp/AbT/eYSKF4g==}
     engines: {node: '>=12', npm: '>=6'}
     peerDependencies:
       '@testing-library/dom': '>=7.21.4'
@@ -2611,6 +2531,16 @@ packages:
   '@ungap/structured-clone@1.3.3':
     resolution: {integrity: sha512-60YRaenCQcVjYEKOcG824+DRGGIQ3VKErcBoAEDJZz5bKIs2ZG+X/H9Nk+Q6EVkwJk5QNApxbrc5QtBSwtrXAg==}
 
+  '@vitest/browser-preview@4.1.10':
+    resolution: {integrity: sha512-14MJrL59ZFkqXLjwfSk6RzTDy5Czf9UG4+8q8L6Gxjs2aPjEce/cVNYV14bXAc2BvMjUNu904+ZEZA1Xc1wtvQ==}
+    peerDependencies:
+      vitest: 4.1.10
+
+  '@vitest/browser@4.1.10':
+    resolution: {integrity: sha512-UDwuWGwXj646CBx/bQHOaJSX7np0I8JL/UKQYa1e4QrVHH8VdWtx8eaOuf8sy0ShwDgR6NjJAsp5eF6vjF6qng==}
+    peerDependencies:
+      vitest: 4.1.10
+
   '@vitest/expect@4.1.10':
     resolution: {integrity: sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==}
 
@@ -2640,6 +2570,240 @@ packages:
   '@vitest/utils@4.1.10':
     resolution: {integrity: sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==}
 
+  '@voidzero-dev/vite-plus-core@0.2.8':
+    resolution: {integrity: sha512-hqUJyozjE4HtJ3wwf2pOw6LnH/EF9W4+ys2s8arr/3fUdw64vzp/SfPFBVCxsGRv2UfjkIieOeZrQ1FH6Oa5Tw==}
+    engines: {node: ^20.19.0 || ^22.18.0 || >=24.11.0}
+    peerDependencies:
+      '@arethetypeswrong/core': ^0.18.1
+      '@types/node': ^20.19.0 || >=22.12.0
+      '@vitejs/devtools': ^0.4.0
+      esbuild: ^0.27.0 || ^0.28.0
+      jiti: '>=1.21.0'
+      less: ^4.0.0
+      publint: ^0.3.8
+      sass: ^1.70.0
+      sass-embedded: ^1.70.0
+      stylus: '>=0.54.8'
+      sugarss: ^5.0.0
+      terser: ^5.16.0
+      tsx: ^4.8.1
+      typescript: ^5.0.0 || ^6.0.0 || ^7.0.0
+      unplugin-unused: ^0.5.0
+      unrun: '*'
+      yaml: ^2.4.2
+    peerDependenciesMeta:
+      '@arethetypeswrong/core':
+        optional: true
+      '@types/node':
+        optional: true
+      '@vitejs/devtools':
+        optional: true
+      esbuild:
+        optional: true
+      jiti:
+        optional: true
+      less:
+        optional: true
+      publint:
+        optional: true
+      sass:
+        optional: true
+      sass-embedded:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+      tsx:
+        optional: true
+      typescript:
+        optional: true
+      unplugin-unused:
+        optional: true
+      unrun:
+        optional: true
+      yaml:
+        optional: true
+
+  '@voidzero-dev/vite-plus-darwin-arm64@0.2.8':
+    resolution: {integrity: sha512-zcGNhemAhux0/sGDZBK5sHvv5bPm9kj+NhDKs8MYfZMjc51kpzMOV3PWhtTOXjJYDiSxv+Ss4AFj2y2wvQDgWg==}
+    engines: {node: '>=20.0.0'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@voidzero-dev/vite-plus-darwin-x64@0.2.8':
+    resolution: {integrity: sha512-56vcDhYuHg1HSqQlFIEexs9WbDtvT2Z8QXq2pEUYVplmP55ekDGx8+Ibu69jBhk+lNwmLAonCW1alffQxMKirQ==}
+    engines: {node: '>=20.0.0'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@voidzero-dev/vite-plus-linux-arm64-gnu@0.2.8':
+    resolution: {integrity: sha512-EU9zlSieuouJlnLEkVNw9guig5rTQ5hfMeNH0AlRjb1C1xVpUQdf0uRjXg1PHP3os/WspyCPB46Q80lEaeRb0w==}
+    engines: {node: '>=20.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@voidzero-dev/vite-plus-linux-arm64-musl@0.2.8':
+    resolution: {integrity: sha512-VbWUwaSAw0Ndql5uYy/Gfqt7duSy1sxTacLngD5M5kF4ZK7yoKKcx8iFiA0il1Gf3J7OGojPonKi5b3NSn3K7A==}
+    engines: {node: '>=20.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@voidzero-dev/vite-plus-linux-x64-gnu@0.2.8':
+    resolution: {integrity: sha512-gZfnd3l9vNiP7QXQIEN9r2M9ZKCh8sg2vhBv04sZjMNAeQ05IXJMkWYkcfTUO7jhf8pdVt3VHQ4x6ULm0OnELg==}
+    engines: {node: '>=20.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@voidzero-dev/vite-plus-linux-x64-musl@0.2.8':
+    resolution: {integrity: sha512-5NtDUvjzF/HcjQraebpiVUgjX2CMKv2Jdmi5YpzHlt4g86sFA9M5a+OqBlgUctdzTeolnjxRsfurKiefG/hILA==}
+    engines: {node: '>=20.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@voidzero-dev/vite-plus-win32-arm64-msvc@0.2.8':
+    resolution: {integrity: sha512-Atjz6KsG42ntfQkM6Ks09Ifxm+ZIca2DnA31tO2FcPlHetBxYEGZwSNCOHAnoNnLrh2qNm+7aOC329a2ijhxLg==}
+    engines: {node: '>=20.0.0'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@voidzero-dev/vite-plus-win32-x64-msvc@0.2.8':
+    resolution: {integrity: sha512-VSpa+gK1MjOH7GeO6H5xtJLqisQOWVeRQIDQs9XKizXFX0R4NCrioYO6Rc31QLXfL0lPCkwsKhp/9M9gllImRg==}
+    engines: {node: '>=20.0.0'}
+    cpu: [x64]
+    os: [win32]
+
+  '@yuku-codegen/binding-darwin-arm64@0.5.48':
+    resolution: {integrity: sha512-yo96Oef12WzqnphInfz/eexVse3+kWgfGS5g2S3rFS3dcGn1ENW9xLFDZUP9rh+yP76DOq38wBoFi1+I9+6qBg==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@yuku-codegen/binding-darwin-x64@0.5.48':
+    resolution: {integrity: sha512-aRCTw0EZC4bVosmw//0OMYP5tGWFE0Cu5yUBFkUbhXx/iBzvORcJ2xPNlOp/vtCCo9Ys4vp8b0DigJV6uOVb2g==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@yuku-codegen/binding-freebsd-x64@0.5.48':
+    resolution: {integrity: sha512-CA0AQAEApDkbw51PdLWMtKPJ41/7rvXsS3SJs+phG7fHJI+MuFzWuLbkucZfZoEOiDscmcsfYIdgL8BsfuyKKQ==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@yuku-codegen/binding-linux-arm-gnu@0.5.48':
+    resolution: {integrity: sha512-DuSQlk8bH4gpmW3/00P0NLagAcMv8jOxjT40cQmxKRkktr+SUOALCfkT89tdDq3qtY95NR2GXOZ7AjNh7KKqCw==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-arm-musl@0.5.48':
+    resolution: {integrity: sha512-bxj4Ee+wlaJcWJwft2ReJXWw5sfl1qavDz6+dlRdU1xfTEtjPSNiAWhiCHnJR0R4Ygd57DnzSQmAVGvFv6RcGw==}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-linux-arm64-gnu@0.5.48':
+    resolution: {integrity: sha512-mk5JVWh+0JOe5ue8k17kbYX8uGBoKt3ZqoCyxNh4nYAAcX7+X1tFUiU7jbjctu4vHeejCBFSTdQ021+V31cUCQ==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-arm64-musl@0.5.48':
+    resolution: {integrity: sha512-4q3vkrNghbllyxOm2KesFLxCPKHF7r3JyQ7BWZccY1j2Y05yKoIFhoWCqIuQ2W/dpte9RI0+OVfwyxnrKg6fkA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-linux-x64-gnu@0.5.48':
+    resolution: {integrity: sha512-csd4M1EVrGaohM8acM6gq1zpUA/Rwe2ulUMBKUcwQXm/k6n7cq1A++qdew78SOVb4do3JH1WE+WFwoGQAcWc1w==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-codegen/binding-linux-x64-musl@0.5.48':
+    resolution: {integrity: sha512-KcDuEOT+GFoVKdvAWOv1v9iYjwnmvMZlO+j1Rw+5PYdeFLGWGzv/DD11y4SAAdwXIFcil4T0hibeIaF82WStMg==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-codegen/binding-win32-arm64@0.5.48':
+    resolution: {integrity: sha512-HI8qNrI8dWM5BuqIMKsqornRvTNFrE6sm5zToIJ9YIa9zt5+29P7fJ7Nr39EVf6dAWSb6q7JSpScJnRsQ+FgZA==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@yuku-codegen/binding-win32-x64@0.5.48':
+    resolution: {integrity: sha512-X5YWJLO6EfBZpeBqO0AYESnUizbpFDWArcvVD61w0PEWQ3CaFRLnbQXs+kpM4ZZfGMfIE22zfA08QSY67q7TNQ==}
+    cpu: [x64]
+    os: [win32]
+
+  '@yuku-parser/binding-darwin-arm64@0.5.48':
+    resolution: {integrity: sha512-If8mb7HH3vqghJ2NNZ8SuHfhsnjVzOxJpB8xcNOXS5WjYrs2mUhHIh5KOIvK13hDOzh0htGeGK3A6MsiEqE7HQ==}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@yuku-parser/binding-darwin-x64@0.5.48':
+    resolution: {integrity: sha512-EimvPXfspzxf1K11eB6tCW5oiQEXB8g84T2wP1TwzQagdDKo33bkmmVF0B32vTIpXnk/Ifu5IB61izZ1MylljA==}
+    cpu: [x64]
+    os: [darwin]
+
+  '@yuku-parser/binding-freebsd-x64@0.5.48':
+    resolution: {integrity: sha512-0GcUMrumLHheThY9r5Tp46gaZYzn0irWPS1Zba6WY+vVQfhUtzGiWgXxI6tuXX0N32kEaaEVRpkKctvo6Kx3aQ==}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@yuku-parser/binding-linux-arm-gnu@0.5.48':
+    resolution: {integrity: sha512-8S5T5wjCC73dmmpQeZ49aYsSunIUM3D4Fc6rdK96c+Ayg/p3FmeSPF3xuLZHejcTmqJIIvnbfPlUF+rB6DITjQ==}
+    cpu: [arm]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-arm-musl@0.5.48':
+    resolution: {integrity: sha512-tTmbxvnUHcK2/crS9547vk2SMmsajH1yqJ8ltXhIuHJgqR1v+d9n9KT+kSayo/5CS76LegeYxhMFjEivBH2hFA==}
+    cpu: [arm]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-linux-arm64-gnu@0.5.48':
+    resolution: {integrity: sha512-KGYCBMqI2zfwyhgq5tpPVNe7jpUeYTBm8DhjdS+zqWNumde/PEC170QE5RHxcOAlsirIDeIUk0jqx+r/axoFSw==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-arm64-musl@0.5.48':
+    resolution: {integrity: sha512-2wTSMsCSXLTc2lZUjMAuU5X4cje55u205WJqfV5NWNF6j9pW/tXyxr15dJeekj8ziLqBXzIsj4DbRh4sY/WcjA==}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-linux-x64-gnu@0.5.48':
+    resolution: {integrity: sha512-d/6v9UnGglVu1WC2JQyv/5aWSi5fXZeGSlidCfmHp4+N65N1GDKUnFtys5MK5eAPeAjTgSHGGtOc/yCcKTlv3A==}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
+  '@yuku-parser/binding-linux-x64-musl@0.5.48':
+    resolution: {integrity: sha512-gX19gw6u4ApPy7SYMPKfFlEkrtj6WlORvrTKK3sBQqjyV+8+mUAkQgxXNjHw4RnOiAmVYg7TOlZcg8d+Qqod9A==}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
+  '@yuku-parser/binding-win32-arm64@0.5.48':
+    resolution: {integrity: sha512-w6cQQLbqj3Jcom5Q7ifm103NUOQ9d+Cb4VU5lkrZDjMnwVJ9Hzzg1vCQR7miJuF44vhCXldbme5UryE3giEKlA==}
+    cpu: [arm64]
+    os: [win32]
+
+  '@yuku-parser/binding-win32-x64@0.5.48':
+    resolution: {integrity: sha512-4gO0HmG7fzFxrw1rs0dUdnnaY9YgennjETqDWrTSp7x9fmTUOAoN4VsMfP7YyliQeG1WJJHc55O+rOhmsLppow==}
+    cpu: [x64]
+    os: [win32]
+
+  '@yuku-toolchain/types@0.5.43':
+    resolution: {integrity: sha512-kSpvPntnXw5+lYjO71ffBEnQ5ycQ74KGIYknh0TS4xeyCuBkOqxyJumxZkMhLBBUCLjDAbx2+Icnr3Zh4ftjpQ==}
+
   accepts@1.3.8:
     resolution: {integrity: sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==}
     engines: {node: '>= 0.6'}
@@ -3790,11 +3954,6 @@ packages:
   humanize-ms@1.2.1:
     resolution: {integrity: sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ==}
 
-  husky@9.1.7:
-    resolution: {integrity: sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==}
-    engines: {node: '>=18'}
-    hasBin: true
-
   iconv-lite@0.4.24:
     resolution: {integrity: sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==}
     engines: {node: '>=0.10.0'}
@@ -4070,30 +4229,60 @@ packages:
     cpu: [arm64]
     os: [android]
 
+  lightningcss-android-arm64@1.33.0:
+    resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [android]
+
   lightningcss-darwin-arm64@1.32.0:
     resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==}
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [darwin]
 
+  lightningcss-darwin-arm64@1.33.0:
+    resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [darwin]
+
   lightningcss-darwin-x64@1.32.0:
     resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [darwin]
 
+  lightningcss-darwin-x64@1.33.0:
+    resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [darwin]
+
   lightningcss-freebsd-x64@1.32.0:
     resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [freebsd]
 
+  lightningcss-freebsd-x64@1.33.0:
+    resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [freebsd]
+
   lightningcss-linux-arm-gnueabihf@1.32.0:
     resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==}
     engines: {node: '>= 12.0.0'}
     cpu: [arm]
     os: [linux]
 
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm]
+    os: [linux]
+
   lightningcss-linux-arm64-gnu@1.32.0:
     resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==}
     engines: {node: '>= 12.0.0'}
@@ -4101,6 +4290,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  lightningcss-linux-arm64-gnu@1.33.0:
+    resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [glibc]
+
   lightningcss-linux-arm64-musl@1.32.0:
     resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
     engines: {node: '>= 12.0.0'}
@@ -4108,6 +4304,13 @@ packages:
     os: [linux]
     libc: [musl]
 
+  lightningcss-linux-arm64-musl@1.33.0:
+    resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [linux]
+    libc: [musl]
+
   lightningcss-linux-x64-gnu@1.32.0:
     resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
     engines: {node: '>= 12.0.0'}
@@ -4115,6 +4318,13 @@ packages:
     os: [linux]
     libc: [glibc]
 
+  lightningcss-linux-x64-gnu@1.33.0:
+    resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [glibc]
+
   lightningcss-linux-x64-musl@1.32.0:
     resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
     engines: {node: '>= 12.0.0'}
@@ -4122,22 +4332,45 @@ packages:
     os: [linux]
     libc: [musl]
 
+  lightningcss-linux-x64-musl@1.33.0:
+    resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [linux]
+    libc: [musl]
+
   lightningcss-win32-arm64-msvc@1.32.0:
     resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [win32]
 
+  lightningcss-win32-arm64-msvc@1.33.0:
+    resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [arm64]
+    os: [win32]
+
   lightningcss-win32-x64-msvc@1.32.0:
     resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [win32]
 
+  lightningcss-win32-x64-msvc@1.33.0:
+    resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==}
+    engines: {node: '>= 12.0.0'}
+    cpu: [x64]
+    os: [win32]
+
   lightningcss@1.32.0:
     resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==}
     engines: {node: '>= 12.0.0'}
 
+  lightningcss@1.33.0:
+    resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==}
+    engines: {node: '>= 12.0.0'}
+
   lines-and-columns@1.2.4:
     resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==}
 
@@ -4462,6 +4695,10 @@ packages:
     resolution: {integrity: sha512-zSkVu3t18r39pw4ixfBKvfZi3y2UOqr7d4WYwcj3m8nXpEQK4rPO6GLzs/CExoRgmX3y9EjmmcXqv6jq0SK46g==}
     engines: {node: '>= 0.8.0'}
 
+  mrmime@2.0.1:
+    resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==}
+    engines: {node: '>=10'}
+
   ms@2.0.0:
     resolution: {integrity: sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==}
 
@@ -4627,8 +4864,8 @@ packages:
   outvariant@1.4.3:
     resolution: {integrity: sha512-+Sl2UErvtsoajRDKCE5/dBz4DIvHXQQnAxtQTF04OJxY0+DyZXSo5P5Bb7XYWOh81syohlYL24hbDwxedPUJCA==}
 
-  oxfmt@0.60.0:
-    resolution: {integrity: sha512-fViX6i+gJuZWY+jI/fnR6WRbRj70GZ9RlCd30MygJrHTUNc4DxvKHWw8vBjMjffv3PgU5qWDR0AzmojQByqaZA==}
+  oxfmt@0.61.0:
+    resolution: {integrity: sha512-DxdHBEMYpcEnHoUHjjOigUqV2TYKsvxLwUPXnVYBjgFdqrcQ/91OtwubtZ2PUodCs3sStI8R5Qw3fKNGK4e8wQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
     peerDependencies:
@@ -4640,8 +4877,12 @@ packages:
       vite-plus:
         optional: true
 
-  oxlint@1.75.0:
-    resolution: {integrity: sha512-m9WzjRcRYA/uqIZDa9tclrieoPJ/ln1QYTKdFx6NUOs8uY5DiHlIwRQoCrHT6OM6O3ww3l2skY5gO7G7ZphE7g==}
+  oxlint-tsgolint@7.0.2001:
+    resolution: {integrity: sha512-KjK/XLcXr1DSyonKhsuFqJRiuKqcyG9j3LJ8nkOsrLzGvodBPqzHOKauy10asLMDI0sUpvb+1sxlzff3udZvfg==}
+    hasBin: true
+
+  oxlint@1.76.0:
+    resolution: {integrity: sha512-6QoFioEU4fNdiUx/2Eo6TRd6NG7H7njnRCz8rhB66cZmMHDTqcm1Rjvl8Wry+ZTQMBAmyb4Mlf62Mk5X+eHSOw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     hasBin: true
     peerDependencies:
@@ -4800,6 +5041,10 @@ packages:
   platform@1.3.6:
     resolution: {integrity: sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg==}
 
+  pngjs@7.0.0:
+    resolution: {integrity: sha512-LKWqWJRhstyYo9pGvgor/ivk2w94eSjE3RGVuzLGlr3NmD8bf7RcYGze1mNdEHRP6TRP6rMuDHk5t44hnTRyow==}
+    engines: {node: '>=14.19.0'}
+
   possible-typed-array-names@1.1.0:
     resolution: {integrity: sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg==}
     engines: {node: '>= 0.4'}
@@ -4812,6 +5057,10 @@ packages:
     resolution: {integrity: sha512-v4sDNP3fdNiWMfabO7OwOQdOX8TiQSztKyT1Wj0w+j7LDallJThJRBBBmzVGyYj0crMh7jlV4zepPkiNu9UwDQ==}
     engines: {node: ^10 || ^12 || >=14}
 
+  postcss@8.5.25:
+    resolution: {integrity: sha512-DTPx3RWSSnWyzLxQnlH0rJP+EW5ekl16ZU4/psbIhA0e53kJfdgaN5vKM+xP7yJtXVu+nfdVFmlgFDEKAe4Pyw==}
+    engines: {node: ^10 || ^12 || >=14}
+
   postgres-array@2.0.0:
     resolution: {integrity: sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==}
     engines: {node: '>=4'}
@@ -5156,11 +5405,6 @@ packages:
     resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
     engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
 
-  rollup@4.62.2:
-    resolution: {integrity: sha512-RFnrW4lhXA3s3eqHDZvN654g8OTjzRfqpIRJYczCGB6HzphckVAi/Qh4tbPUbRuDi7s1Llv8g/NspLkttY3gTA==}
-    engines: {node: '>=18.0.0', npm: '>=8.0.0'}
-    hasBin: true
-
   router@2.2.0:
     resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==}
     engines: {node: '>= 18'}
@@ -5307,6 +5551,10 @@ packages:
     resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
     engines: {node: '>=14'}
 
+  sirv@3.0.2:
+    resolution: {integrity: sha512-2wcC/oGxHis/BoHkkPwldgiPSYcpZK3JU28WoMVv55yHJgcZ8rlXvuG9iZggz+sU1d4bRgIGASwyWqjxu3FM0g==}
+    engines: {node: '>=18'}
+
   sisteransi@1.0.5:
     resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==}
 
@@ -5550,6 +5798,10 @@ packages:
     resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
     engines: {node: '>=0.6'}
 
+  totalist@3.0.1:
+    resolution: {integrity: sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ==}
+    engines: {node: '>=6'}
+
   tough-cookie@6.0.2:
     resolution: {integrity: sha512-exgYmnmL/sJpR3upZfXG5PoatXQii55xAiXGXzY+sROLZ/Y+SLcp9PgJNI9Vz37HpQ74WvDcLT8eqm+kV3FzrA==}
     engines: {node: '>=16'}
@@ -5776,55 +6028,28 @@ packages:
   vfile-location@5.0.3:
     resolution: {integrity: sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==}
 
-  vfile-message@4.0.3:
-    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
-
-  vfile@6.0.3:
-    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
-
-  vite-node@3.2.4:
-    resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==}
-    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
-    hasBin: true
-
-  vite@7.3.6:
-    resolution: {integrity: sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==}
-    engines: {node: ^20.19.0 || >=22.12.0}
-    hasBin: true
-    peerDependencies:
-      '@types/node': ^20.19.0 || >=22.12.0
-      jiti: '>=1.21.0'
-      less: ^4.0.0
-      lightningcss: ^1.21.0
-      sass: ^1.70.0
-      sass-embedded: ^1.70.0
-      stylus: '>=0.54.8'
-      sugarss: ^5.0.0
-      terser: ^5.16.0
-      tsx: ^4.8.1
-      yaml: ^2.4.2
-    peerDependenciesMeta:
-      '@types/node':
-        optional: true
-      jiti:
-        optional: true
-      less:
-        optional: true
-      lightningcss:
-        optional: true
-      sass:
-        optional: true
-      sass-embedded:
-        optional: true
-      stylus:
-        optional: true
-      sugarss:
-        optional: true
-      terser:
-        optional: true
-      tsx:
+  vfile-message@4.0.3:
+    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+  vfile@6.0.3:
+    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
+  vite-node@3.2.4:
+    resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+
+  vite-plus@0.2.8:
+    resolution: {integrity: sha512-JULDOsy7gxG0o2FuvnsWnzRjzD1x9WM9mya3MNMOJUqTsL2pqiN2nq+dzoQMw+FGCytRw7yG1/p5qNcmYMM5Fw==}
+    engines: {node: ^20.19.0 || ^22.18.0 || >=24.11.0}
+    hasBin: true
+    peerDependencies:
+      '@vitest/browser-playwright': 4.1.10
+      '@vitest/browser-webdriverio': 4.1.10
+    peerDependenciesMeta:
+      '@vitest/browser-playwright':
         optional: true
-      yaml:
+      '@vitest/browser-webdriverio':
         optional: true
 
   vitest@4.1.10:
@@ -6033,6 +6258,12 @@ packages:
   youch@4.1.0-beta.10:
     resolution: {integrity: sha512-rLfVLB4FgQneDr0dv1oddCVZmKjcJ6yX6mS4pU82Mq/Dt9a3cLZQ62pDBL4AUO+uVrCvtWz3ZFUL2HFAFJ/BXQ==}
 
+  yuku-codegen@0.5.48:
+    resolution: {integrity: sha512-p7HxD5Xl4jzDzqMrGePAOeSHmRY4g58h4HuGq15weQFPxuPWd/W6e7nqp/+Lea6JfpOdBwJOAyXFqIZ/J9Zfnw==}
+
+  yuku-parser@0.5.48:
+    resolution: {integrity: sha512-OWBfhrpgK9+/4+IXG9oT8Bao4AhViQA7vdyNNH7EUg8dQYgwa70XtIBWTpCEme1P1ECyoDNYkn0wT63f8XRcVA==}
+
   zenscroll@4.0.2:
     resolution: {integrity: sha512-jEA1znR7b4C/NnaycInCU6h/d15ZzCd1jmsruqOKnZP6WXQSMH3W2GL+OXbkruslU4h+Tzuos0HdswzRUk/Vgg==}
 
@@ -6328,6 +6559,8 @@ snapshots:
     optionalDependencies:
       '@types/react': 19.2.17
 
+  '@blazediff/core@1.9.1': {}
+
   '@bramus/specificity@2.4.2':
     dependencies:
       css-tree: 3.2.1
@@ -6340,12 +6573,12 @@ snapshots:
     optionalDependencies:
       workerd: 1.20260721.1
 
-  '@cloudflare/vite-plugin@1.46.0(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))(wrangler@4.113.0)':
+  '@cloudflare/vite-plugin@1.46.0(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(wrangler@4.113.0)':
     dependencies:
       '@cloudflare/unenv-preset': 2.16.1(unenv@2.0.0-rc.24)(workerd@1.20260721.1)
       miniflare: 4.20260721.0
       unenv: 2.0.0-rc.24
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
       workerd: 1.20260721.1
       wrangler: 4.113.0
       ws: 8.21.0
@@ -7062,122 +7295,148 @@ snapshots:
   '@open-draft/until@2.1.0':
     optional: true
 
-  '@oxfmt/binding-android-arm-eabi@0.60.0':
+  '@oxc-project/runtime@0.142.0': {}
+
+  '@oxc-project/types@0.142.0': {}
+
+  '@oxfmt/binding-android-arm-eabi@0.61.0':
+    optional: true
+
+  '@oxfmt/binding-android-arm64@0.61.0':
+    optional: true
+
+  '@oxfmt/binding-darwin-arm64@0.61.0':
+    optional: true
+
+  '@oxfmt/binding-darwin-x64@0.61.0':
+    optional: true
+
+  '@oxfmt/binding-freebsd-x64@0.61.0':
     optional: true
 
-  '@oxfmt/binding-android-arm64@0.60.0':
+  '@oxfmt/binding-linux-arm-gnueabihf@0.61.0':
     optional: true
 
-  '@oxfmt/binding-darwin-arm64@0.60.0':
+  '@oxfmt/binding-linux-arm-musleabihf@0.61.0':
     optional: true
 
-  '@oxfmt/binding-darwin-x64@0.60.0':
+  '@oxfmt/binding-linux-arm64-gnu@0.61.0':
     optional: true
 
-  '@oxfmt/binding-freebsd-x64@0.60.0':
+  '@oxfmt/binding-linux-arm64-musl@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-arm-gnueabihf@0.60.0':
+  '@oxfmt/binding-linux-ppc64-gnu@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-arm-musleabihf@0.60.0':
+  '@oxfmt/binding-linux-riscv64-gnu@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-arm64-gnu@0.60.0':
+  '@oxfmt/binding-linux-riscv64-musl@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-arm64-musl@0.60.0':
+  '@oxfmt/binding-linux-s390x-gnu@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-ppc64-gnu@0.60.0':
+  '@oxfmt/binding-linux-x64-gnu@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-riscv64-gnu@0.60.0':
+  '@oxfmt/binding-linux-x64-musl@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-riscv64-musl@0.60.0':
+  '@oxfmt/binding-openharmony-arm64@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-s390x-gnu@0.60.0':
+  '@oxfmt/binding-win32-arm64-msvc@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-x64-gnu@0.60.0':
+  '@oxfmt/binding-win32-ia32-msvc@0.61.0':
     optional: true
 
-  '@oxfmt/binding-linux-x64-musl@0.60.0':
+  '@oxfmt/binding-win32-x64-msvc@0.61.0':
     optional: true
 
-  '@oxfmt/binding-openharmony-arm64@0.60.0':
+  '@oxlint-tsgolint/darwin-arm64@7.0.2001':
     optional: true
 
-  '@oxfmt/binding-win32-arm64-msvc@0.60.0':
+  '@oxlint-tsgolint/darwin-x64@7.0.2001':
     optional: true
 
-  '@oxfmt/binding-win32-ia32-msvc@0.60.0':
+  '@oxlint-tsgolint/linux-arm64@7.0.2001':
     optional: true
 
-  '@oxfmt/binding-win32-x64-msvc@0.60.0':
+  '@oxlint-tsgolint/linux-x64@7.0.2001':
     optional: true
 
-  '@oxlint/binding-android-arm-eabi@1.75.0':
+  '@oxlint-tsgolint/win32-arm64@7.0.2001':
     optional: true
 
-  '@oxlint/binding-android-arm64@1.75.0':
+  '@oxlint-tsgolint/win32-x64@7.0.2001':
     optional: true
 
-  '@oxlint/binding-darwin-arm64@1.75.0':
+  '@oxlint/binding-android-arm-eabi@1.76.0':
     optional: true
 
-  '@oxlint/binding-darwin-x64@1.75.0':
+  '@oxlint/binding-android-arm64@1.76.0':
     optional: true
 
-  '@oxlint/binding-freebsd-x64@1.75.0':
+  '@oxlint/binding-darwin-arm64@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-arm-gnueabihf@1.75.0':
+  '@oxlint/binding-darwin-x64@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-arm-musleabihf@1.75.0':
+  '@oxlint/binding-freebsd-x64@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-arm64-gnu@1.75.0':
+  '@oxlint/binding-linux-arm-gnueabihf@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-arm64-musl@1.75.0':
+  '@oxlint/binding-linux-arm-musleabihf@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-ppc64-gnu@1.75.0':
+  '@oxlint/binding-linux-arm64-gnu@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-riscv64-gnu@1.75.0':
+  '@oxlint/binding-linux-arm64-musl@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-riscv64-musl@1.75.0':
+  '@oxlint/binding-linux-ppc64-gnu@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-s390x-gnu@1.75.0':
+  '@oxlint/binding-linux-riscv64-gnu@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-x64-gnu@1.75.0':
+  '@oxlint/binding-linux-riscv64-musl@1.76.0':
     optional: true
 
-  '@oxlint/binding-linux-x64-musl@1.75.0':
+  '@oxlint/binding-linux-s390x-gnu@1.76.0':
     optional: true
 
-  '@oxlint/binding-openharmony-arm64@1.75.0':
+  '@oxlint/binding-linux-x64-gnu@1.76.0':
     optional: true
 
-  '@oxlint/binding-win32-arm64-msvc@1.75.0':
+  '@oxlint/binding-linux-x64-musl@1.76.0':
     optional: true
 
-  '@oxlint/binding-win32-ia32-msvc@1.75.0':
+  '@oxlint/binding-openharmony-arm64@1.76.0':
     optional: true
 
-  '@oxlint/binding-win32-x64-msvc@1.75.0':
+  '@oxlint/binding-win32-arm64-msvc@1.76.0':
     optional: true
 
+  '@oxlint/binding-win32-ia32-msvc@1.76.0':
+    optional: true
+
+  '@oxlint/binding-win32-x64-msvc@1.76.0':
+    optional: true
+
+  '@oxlint/plugins@1.73.0': {}
+
   '@petamoriken/float16@3.9.3': {}
 
+  '@polka/url@1.0.0-next.29': {}
+
   '@poppinss/colors@4.1.6':
     dependencies:
       kleur: 4.1.5
@@ -7342,7 +7601,7 @@ snapshots:
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
 
-  '@react-router/dev@7.18.1(@react-router/serve@7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3))(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))(wrangler@4.113.0)(yaml@2.9.0)':
+  '@react-router/dev@7.18.1(@react-router/serve@7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3))(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(wrangler@4.113.0)(yaml@2.9.0)':
     dependencies:
       '@babel/core': 7.29.7(supports-color@10.2.2)
       '@babel/generator': 7.29.7
@@ -7372,18 +7631,21 @@ snapshots:
       semver: 7.8.5
       tinyglobby: 0.2.17
       valibot: 1.4.2(typescript@5.9.3)
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
-      vite-node: 3.2.4(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(supports-color@10.2.2)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
+      vite-node: 3.2.4(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
     optionalDependencies:
       '@react-router/serve': 7.18.1(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(supports-color@10.2.2)(typescript@5.9.3)
       typescript: 5.9.3
       wrangler: 4.113.0
     transitivePeerDependencies:
+      - '@arethetypeswrong/core'
       - '@types/node'
+      - '@vitejs/devtools'
       - babel-plugin-macros
+      - esbuild
       - jiti
       - less
-      - lightningcss
+      - publint
       - sass
       - sass-embedded
       - stylus
@@ -7391,6 +7653,8 @@ snapshots:
       - supports-color
       - terser
       - tsx
+      - unplugin-unused
+      - unrun
       - yaml
 
   '@react-router/express@7.18.1(express@4.22.2(supports-color@10.2.2))(react-router@7.18.1(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(typescript@5.9.3)':
@@ -7425,81 +7689,6 @@ snapshots:
 
   '@remix-run/node-fetch-server@0.13.3': {}
 
-  '@rollup/rollup-android-arm-eabi@4.62.2':
-    optional: true
-
-  '@rollup/rollup-android-arm64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-darwin-arm64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-darwin-x64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-freebsd-arm64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-freebsd-x64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-arm-gnueabihf@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-arm-musleabihf@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-arm64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-arm64-musl@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-loong64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-loong64-musl@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-ppc64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-ppc64-musl@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-riscv64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-riscv64-musl@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-s390x-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-x64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-linux-x64-musl@4.62.2':
-    optional: true
-
-  '@rollup/rollup-openbsd-x64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-openharmony-arm64@4.62.2':
-    optional: true
-
-  '@rollup/rollup-win32-arm64-msvc@4.62.2':
-    optional: true
-
-  '@rollup/rollup-win32-ia32-msvc@4.62.2':
-    optional: true
-
-  '@rollup/rollup-win32-x64-gnu@4.62.2':
-    optional: true
-
-  '@rollup/rollup-win32-x64-msvc@4.62.2':
-    optional: true
-
   '@scarf/scarf@1.4.0': {}
 
   '@sec-ant/readable-stream@0.4.1': {}
@@ -8015,12 +8204,12 @@ snapshots:
       '@tailwindcss/oxide-win32-arm64-msvc': 4.3.3
       '@tailwindcss/oxide-win32-x64-msvc': 4.3.3
 
-  '@tailwindcss/vite@4.3.3(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))':
+  '@tailwindcss/vite@4.3.3(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))':
     dependencies:
       '@tailwindcss/node': 4.3.3
       '@tailwindcss/oxide': 4.3.3
       tailwindcss: 4.3.3
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
 
   '@testing-library/dom@10.4.1':
     dependencies:
@@ -8053,7 +8242,7 @@ snapshots:
       '@types/react': 19.2.17
       '@types/react-dom': 19.2.4(@types/react@19.2.17)
 
-  '@testing-library/user-event@14.6.1(@testing-library/dom@10.4.1)':
+  '@testing-library/user-event@14.6.3(@testing-library/dom@10.4.1)':
     dependencies:
       '@testing-library/dom': 10.4.1
 
@@ -8182,6 +8371,35 @@ snapshots:
 
   '@ungap/structured-clone@1.3.3': {}
 
+  '@vitest/browser-preview@4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)':
+    dependencies:
+      '@testing-library/dom': 10.4.1
+      '@testing-library/user-event': 14.6.3(@testing-library/dom@10.4.1)
+      '@vitest/browser': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)
+      vitest: 4.1.10(@types/node@22.20.1)(@vitest/browser-preview@4.1.10)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
+    transitivePeerDependencies:
+      - bufferutil
+      - msw
+      - utf-8-validate
+      - vite
+
+  '@vitest/browser@4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)':
+    dependencies:
+      '@blazediff/core': 1.9.1
+      '@vitest/mocker': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
+      '@vitest/utils': 4.1.10
+      magic-string: 0.30.21
+      pngjs: 7.0.0
+      sirv: 3.0.2
+      tinyrainbow: 3.1.0
+      vitest: 4.1.10(@types/node@22.20.1)(@vitest/browser-preview@4.1.10)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
+      ws: 8.21.0
+    transitivePeerDependencies:
+      - bufferutil
+      - msw
+      - utf-8-validate
+      - vite
+
   '@vitest/expect@4.1.10':
     dependencies:
       '@standard-schema/spec': 1.1.0
@@ -8191,14 +8409,14 @@ snapshots:
       chai: 6.2.2
       tinyrainbow: 3.1.0
 
-  '@vitest/mocker@4.1.10(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))':
+  '@vitest/mocker@4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))':
     dependencies:
       '@vitest/spy': 4.1.10
       estree-walker: 3.0.3
       magic-string: 0.30.21
     optionalDependencies:
       msw: 2.15.0(@types/node@22.20.1)(typescript@5.9.3)
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
 
   '@vitest/pretty-format@4.1.10':
     dependencies:
@@ -8224,6 +8442,123 @@ snapshots:
       convert-source-map: 2.0.0
       tinyrainbow: 3.1.0
 
+  '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)':
+    dependencies:
+      '@oxc-project/runtime': 0.142.0
+      '@oxc-project/types': 0.142.0
+      lightningcss: 1.33.0
+      postcss: 8.5.25
+      yuku-codegen: 0.5.48
+      yuku-parser: 0.5.48
+    optionalDependencies:
+      '@types/node': 22.20.1
+      '@voidzero-dev/vite-plus-darwin-arm64': 0.2.8
+      '@voidzero-dev/vite-plus-darwin-x64': 0.2.8
+      '@voidzero-dev/vite-plus-linux-arm64-gnu': 0.2.8
+      '@voidzero-dev/vite-plus-linux-arm64-musl': 0.2.8
+      '@voidzero-dev/vite-plus-linux-x64-gnu': 0.2.8
+      '@voidzero-dev/vite-plus-linux-x64-musl': 0.2.8
+      '@voidzero-dev/vite-plus-win32-arm64-msvc': 0.2.8
+      '@voidzero-dev/vite-plus-win32-x64-msvc': 0.2.8
+      esbuild: 0.28.1
+      fsevents: 2.3.3
+      jiti: 2.7.0
+      tsx: 4.23.1
+      typescript: 5.9.3
+      yaml: 2.9.0
+
+  '@voidzero-dev/vite-plus-darwin-arm64@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-darwin-x64@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-linux-arm64-gnu@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-linux-arm64-musl@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-linux-x64-gnu@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-linux-x64-musl@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-win32-arm64-msvc@0.2.8':
+    optional: true
+
+  '@voidzero-dev/vite-plus-win32-x64-msvc@0.2.8':
+    optional: true
+
+  '@yuku-codegen/binding-darwin-arm64@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-darwin-x64@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-freebsd-x64@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm-gnu@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm-musl@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm64-gnu@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-arm64-musl@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-x64-gnu@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-linux-x64-musl@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-win32-arm64@0.5.48':
+    optional: true
+
+  '@yuku-codegen/binding-win32-x64@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-darwin-arm64@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-darwin-x64@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-freebsd-x64@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm-gnu@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm-musl@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm64-gnu@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-arm64-musl@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-x64-gnu@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-linux-x64-musl@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-win32-arm64@0.5.48':
+    optional: true
+
+  '@yuku-parser/binding-win32-x64@0.5.48':
+    optional: true
+
+  '@yuku-toolchain/types@0.5.43': {}
+
   accepts@1.3.8:
     dependencies:
       mime-types: 2.1.35
@@ -9496,8 +9831,6 @@ snapshots:
     dependencies:
       ms: 2.1.3
 
-  husky@9.1.7: {}
-
   iconv-lite@0.4.24:
     dependencies:
       safer-buffer: 2.1.2
@@ -9714,36 +10047,69 @@ snapshots:
   lightningcss-android-arm64@1.32.0:
     optional: true
 
+  lightningcss-android-arm64@1.33.0:
+    optional: true
+
   lightningcss-darwin-arm64@1.32.0:
     optional: true
 
+  lightningcss-darwin-arm64@1.33.0:
+    optional: true
+
   lightningcss-darwin-x64@1.32.0:
     optional: true
 
+  lightningcss-darwin-x64@1.33.0:
+    optional: true
+
   lightningcss-freebsd-x64@1.32.0:
     optional: true
 
+  lightningcss-freebsd-x64@1.33.0:
+    optional: true
+
   lightningcss-linux-arm-gnueabihf@1.32.0:
     optional: true
 
+  lightningcss-linux-arm-gnueabihf@1.33.0:
+    optional: true
+
   lightningcss-linux-arm64-gnu@1.32.0:
     optional: true
 
+  lightningcss-linux-arm64-gnu@1.33.0:
+    optional: true
+
   lightningcss-linux-arm64-musl@1.32.0:
     optional: true
 
+  lightningcss-linux-arm64-musl@1.33.0:
+    optional: true
+
   lightningcss-linux-x64-gnu@1.32.0:
     optional: true
 
+  lightningcss-linux-x64-gnu@1.33.0:
+    optional: true
+
   lightningcss-linux-x64-musl@1.32.0:
     optional: true
 
+  lightningcss-linux-x64-musl@1.33.0:
+    optional: true
+
   lightningcss-win32-arm64-msvc@1.32.0:
     optional: true
 
+  lightningcss-win32-arm64-msvc@1.33.0:
+    optional: true
+
   lightningcss-win32-x64-msvc@1.32.0:
     optional: true
 
+  lightningcss-win32-x64-msvc@1.33.0:
+    optional: true
+
   lightningcss@1.32.0:
     dependencies:
       detect-libc: 2.1.2
@@ -9760,6 +10126,22 @@ snapshots:
       lightningcss-win32-arm64-msvc: 1.32.0
       lightningcss-win32-x64-msvc: 1.32.0
 
+  lightningcss@1.33.0:
+    dependencies:
+      detect-libc: 2.1.2
+    optionalDependencies:
+      lightningcss-android-arm64: 1.33.0
+      lightningcss-darwin-arm64: 1.33.0
+      lightningcss-darwin-x64: 1.33.0
+      lightningcss-freebsd-x64: 1.33.0
+      lightningcss-linux-arm-gnueabihf: 1.33.0
+      lightningcss-linux-arm64-gnu: 1.33.0
+      lightningcss-linux-arm64-musl: 1.33.0
+      lightningcss-linux-x64-gnu: 1.33.0
+      lightningcss-linux-x64-musl: 1.33.0
+      lightningcss-win32-arm64-msvc: 1.33.0
+      lightningcss-win32-x64-msvc: 1.33.0
+
   lines-and-columns@1.2.4: {}
 
   locate-path@3.0.0:
@@ -10263,6 +10645,8 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  mrmime@2.0.1: {}
+
   ms@2.0.0: {}
 
   ms@2.1.3: {}
@@ -10427,51 +10811,63 @@ snapshots:
   outvariant@1.4.3:
     optional: true
 
-  oxfmt@0.60.0:
+  oxfmt@0.61.0(vite-plus@0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)):
     dependencies:
       tinypool: 2.1.0
     optionalDependencies:
-      '@oxfmt/binding-android-arm-eabi': 0.60.0
-      '@oxfmt/binding-android-arm64': 0.60.0
-      '@oxfmt/binding-darwin-arm64': 0.60.0
-      '@oxfmt/binding-darwin-x64': 0.60.0
-      '@oxfmt/binding-freebsd-x64': 0.60.0
-      '@oxfmt/binding-linux-arm-gnueabihf': 0.60.0
-      '@oxfmt/binding-linux-arm-musleabihf': 0.60.0
-      '@oxfmt/binding-linux-arm64-gnu': 0.60.0
-      '@oxfmt/binding-linux-arm64-musl': 0.60.0
-      '@oxfmt/binding-linux-ppc64-gnu': 0.60.0
-      '@oxfmt/binding-linux-riscv64-gnu': 0.60.0
-      '@oxfmt/binding-linux-riscv64-musl': 0.60.0
-      '@oxfmt/binding-linux-s390x-gnu': 0.60.0
-      '@oxfmt/binding-linux-x64-gnu': 0.60.0
-      '@oxfmt/binding-linux-x64-musl': 0.60.0
-      '@oxfmt/binding-openharmony-arm64': 0.60.0
-      '@oxfmt/binding-win32-arm64-msvc': 0.60.0
-      '@oxfmt/binding-win32-ia32-msvc': 0.60.0
-      '@oxfmt/binding-win32-x64-msvc': 0.60.0
-
-  oxlint@1.75.0:
+      '@oxfmt/binding-android-arm-eabi': 0.61.0
+      '@oxfmt/binding-android-arm64': 0.61.0
+      '@oxfmt/binding-darwin-arm64': 0.61.0
+      '@oxfmt/binding-darwin-x64': 0.61.0
+      '@oxfmt/binding-freebsd-x64': 0.61.0
+      '@oxfmt/binding-linux-arm-gnueabihf': 0.61.0
+      '@oxfmt/binding-linux-arm-musleabihf': 0.61.0
+      '@oxfmt/binding-linux-arm64-gnu': 0.61.0
+      '@oxfmt/binding-linux-arm64-musl': 0.61.0
+      '@oxfmt/binding-linux-ppc64-gnu': 0.61.0
+      '@oxfmt/binding-linux-riscv64-gnu': 0.61.0
+      '@oxfmt/binding-linux-riscv64-musl': 0.61.0
+      '@oxfmt/binding-linux-s390x-gnu': 0.61.0
+      '@oxfmt/binding-linux-x64-gnu': 0.61.0
+      '@oxfmt/binding-linux-x64-musl': 0.61.0
+      '@oxfmt/binding-openharmony-arm64': 0.61.0
+      '@oxfmt/binding-win32-arm64-msvc': 0.61.0
+      '@oxfmt/binding-win32-ia32-msvc': 0.61.0
+      '@oxfmt/binding-win32-x64-msvc': 0.61.0
+      vite-plus: 0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
+
+  oxlint-tsgolint@7.0.2001:
     optionalDependencies:
-      '@oxlint/binding-android-arm-eabi': 1.75.0
-      '@oxlint/binding-android-arm64': 1.75.0
-      '@oxlint/binding-darwin-arm64': 1.75.0
-      '@oxlint/binding-darwin-x64': 1.75.0
-      '@oxlint/binding-freebsd-x64': 1.75.0
-      '@oxlint/binding-linux-arm-gnueabihf': 1.75.0
-      '@oxlint/binding-linux-arm-musleabihf': 1.75.0
-      '@oxlint/binding-linux-arm64-gnu': 1.75.0
-      '@oxlint/binding-linux-arm64-musl': 1.75.0
-      '@oxlint/binding-linux-ppc64-gnu': 1.75.0
-      '@oxlint/binding-linux-riscv64-gnu': 1.75.0
-      '@oxlint/binding-linux-riscv64-musl': 1.75.0
-      '@oxlint/binding-linux-s390x-gnu': 1.75.0
-      '@oxlint/binding-linux-x64-gnu': 1.75.0
-      '@oxlint/binding-linux-x64-musl': 1.75.0
-      '@oxlint/binding-openharmony-arm64': 1.75.0
-      '@oxlint/binding-win32-arm64-msvc': 1.75.0
-      '@oxlint/binding-win32-ia32-msvc': 1.75.0
-      '@oxlint/binding-win32-x64-msvc': 1.75.0
+      '@oxlint-tsgolint/darwin-arm64': 7.0.2001
+      '@oxlint-tsgolint/darwin-x64': 7.0.2001
+      '@oxlint-tsgolint/linux-arm64': 7.0.2001
+      '@oxlint-tsgolint/linux-x64': 7.0.2001
+      '@oxlint-tsgolint/win32-arm64': 7.0.2001
+      '@oxlint-tsgolint/win32-x64': 7.0.2001
+
+  oxlint@1.76.0(oxlint-tsgolint@7.0.2001)(vite-plus@0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)):
+    optionalDependencies:
+      '@oxlint/binding-android-arm-eabi': 1.76.0
+      '@oxlint/binding-android-arm64': 1.76.0
+      '@oxlint/binding-darwin-arm64': 1.76.0
+      '@oxlint/binding-darwin-x64': 1.76.0
+      '@oxlint/binding-freebsd-x64': 1.76.0
+      '@oxlint/binding-linux-arm-gnueabihf': 1.76.0
+      '@oxlint/binding-linux-arm-musleabihf': 1.76.0
+      '@oxlint/binding-linux-arm64-gnu': 1.76.0
+      '@oxlint/binding-linux-arm64-musl': 1.76.0
+      '@oxlint/binding-linux-ppc64-gnu': 1.76.0
+      '@oxlint/binding-linux-riscv64-gnu': 1.76.0
+      '@oxlint/binding-linux-riscv64-musl': 1.76.0
+      '@oxlint/binding-linux-s390x-gnu': 1.76.0
+      '@oxlint/binding-linux-x64-gnu': 1.76.0
+      '@oxlint/binding-linux-x64-musl': 1.76.0
+      '@oxlint/binding-openharmony-arm64': 1.76.0
+      '@oxlint/binding-win32-arm64-msvc': 1.76.0
+      '@oxlint/binding-win32-ia32-msvc': 1.76.0
+      '@oxlint/binding-win32-x64-msvc': 1.76.0
+      oxlint-tsgolint: 7.0.2001
+      vite-plus: 0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
 
   p-limit@2.0.0:
     dependencies:
@@ -10609,6 +11005,8 @@ snapshots:
 
   platform@1.3.6: {}
 
+  pngjs@7.0.0: {}
+
   possible-typed-array-names@1.1.0: {}
 
   postcss-selector-parser@7.1.4:
@@ -10622,6 +11020,12 @@ snapshots:
       picocolors: 1.1.1
       source-map-js: 1.2.1
 
+  postcss@8.5.25:
+    dependencies:
+      nanoid: 3.3.16
+      picocolors: 1.1.1
+      source-map-js: 1.2.1
+
   postgres-array@2.0.0: {}
 
   postgres-bytea@1.0.1: {}
@@ -11007,37 +11411,6 @@ snapshots:
 
   reusify@1.1.0: {}
 
-  rollup@4.62.2:
-    dependencies:
-      '@types/estree': 1.0.9
-    optionalDependencies:
-      '@rollup/rollup-android-arm-eabi': 4.62.2
-      '@rollup/rollup-android-arm64': 4.62.2
-      '@rollup/rollup-darwin-arm64': 4.62.2
-      '@rollup/rollup-darwin-x64': 4.62.2
-      '@rollup/rollup-freebsd-arm64': 4.62.2
-      '@rollup/rollup-freebsd-x64': 4.62.2
-      '@rollup/rollup-linux-arm-gnueabihf': 4.62.2
-      '@rollup/rollup-linux-arm-musleabihf': 4.62.2
-      '@rollup/rollup-linux-arm64-gnu': 4.62.2
-      '@rollup/rollup-linux-arm64-musl': 4.62.2
-      '@rollup/rollup-linux-loong64-gnu': 4.62.2
-      '@rollup/rollup-linux-loong64-musl': 4.62.2
-      '@rollup/rollup-linux-ppc64-gnu': 4.62.2
-      '@rollup/rollup-linux-ppc64-musl': 4.62.2
-      '@rollup/rollup-linux-riscv64-gnu': 4.62.2
-      '@rollup/rollup-linux-riscv64-musl': 4.62.2
-      '@rollup/rollup-linux-s390x-gnu': 4.62.2
-      '@rollup/rollup-linux-x64-gnu': 4.62.2
-      '@rollup/rollup-linux-x64-musl': 4.62.2
-      '@rollup/rollup-openbsd-x64': 4.62.2
-      '@rollup/rollup-openharmony-arm64': 4.62.2
-      '@rollup/rollup-win32-arm64-msvc': 4.62.2
-      '@rollup/rollup-win32-ia32-msvc': 4.62.2
-      '@rollup/rollup-win32-x64-gnu': 4.62.2
-      '@rollup/rollup-win32-x64-msvc': 4.62.2
-      fsevents: 2.3.3
-
   router@2.2.0(supports-color@10.2.2):
     dependencies:
       debug: 4.4.3(supports-color@10.2.2)
@@ -11281,6 +11654,12 @@ snapshots:
 
   signal-exit@4.1.0: {}
 
+  sirv@3.0.2:
+    dependencies:
+      '@polka/url': 1.0.0-next.29
+      mrmime: 2.0.1
+      totalist: 3.0.1
+
   sisteransi@1.0.5: {}
 
   smart-buffer@4.2.0: {}
@@ -11589,6 +11968,8 @@ snapshots:
 
   toidentifier@1.0.1: {}
 
+  totalist@3.0.1: {}
+
   tough-cookie@6.0.2:
     dependencies:
       tldts: 7.4.9
@@ -11828,18 +12209,21 @@ snapshots:
       '@types/unist': 3.0.3
       vfile-message: 4.0.3
 
-  vite-node@3.2.4(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(supports-color@10.2.2)(tsx@4.23.1)(yaml@2.9.0):
+  vite-node@3.2.4(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(supports-color@10.2.2)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0):
     dependencies:
       cac: 6.7.14
       debug: 4.4.3(supports-color@10.2.2)
       es-module-lexer: 1.7.0
       pathe: 2.0.3
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
     transitivePeerDependencies:
+      - '@arethetypeswrong/core'
       - '@types/node'
+      - '@vitejs/devtools'
+      - esbuild
       - jiti
       - less
-      - lightningcss
+      - publint
       - sass
       - sass-embedded
       - stylus
@@ -11847,28 +12231,73 @@ snapshots:
       - supports-color
       - terser
       - tsx
+      - typescript
+      - unplugin-unused
+      - unrun
       - yaml
 
-  vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0):
+  vite-plus@0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0):
     dependencies:
-      esbuild: 0.28.1
-      fdir: 6.5.0(picomatch@4.0.5)
-      picomatch: 4.0.5
-      postcss: 8.5.21
-      rollup: 4.62.2
-      tinyglobby: 0.2.17
+      '@oxc-project/types': 0.142.0
+      '@oxlint/plugins': 1.73.0
+      '@vitest/browser': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)
+      '@vitest/browser-preview': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)
+      '@vitest/expect': 4.1.10
+      '@vitest/mocker': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
+      '@vitest/pretty-format': 4.1.10
+      '@vitest/runner': 4.1.10
+      '@vitest/snapshot': 4.1.10
+      '@vitest/spy': 4.1.10
+      '@vitest/utils': 4.1.10
+      '@voidzero-dev/vite-plus-core': 0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)
+      oxfmt: 0.61.0(vite-plus@0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))
+      oxlint: 1.76.0(oxlint-tsgolint@7.0.2001)(vite-plus@0.2.8(@types/node@22.20.1)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(esbuild@0.28.1)(jiti@2.7.0)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))
+      oxlint-tsgolint: 7.0.2001
+      vitest: 4.1.10(@types/node@22.20.1)(@vitest/browser-preview@4.1.10)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
     optionalDependencies:
-      '@types/node': 22.20.1
-      fsevents: 2.3.3
-      jiti: 2.7.0
-      lightningcss: 1.32.0
-      tsx: 4.23.1
-      yaml: 2.9.0
+      '@voidzero-dev/vite-plus-darwin-arm64': 0.2.8
+      '@voidzero-dev/vite-plus-darwin-x64': 0.2.8
+      '@voidzero-dev/vite-plus-linux-arm64-gnu': 0.2.8
+      '@voidzero-dev/vite-plus-linux-arm64-musl': 0.2.8
+      '@voidzero-dev/vite-plus-linux-x64-gnu': 0.2.8
+      '@voidzero-dev/vite-plus-linux-x64-musl': 0.2.8
+      '@voidzero-dev/vite-plus-win32-arm64-msvc': 0.2.8
+      '@voidzero-dev/vite-plus-win32-x64-msvc': 0.2.8
+    transitivePeerDependencies:
+      - '@arethetypeswrong/core'
+      - '@edge-runtime/vm'
+      - '@opentelemetry/api'
+      - '@types/node'
+      - '@vitejs/devtools'
+      - '@vitest/coverage-istanbul'
+      - '@vitest/coverage-v8'
+      - '@vitest/ui'
+      - bufferutil
+      - esbuild
+      - happy-dom
+      - jiti
+      - jsdom
+      - less
+      - msw
+      - publint
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - svelte
+      - terser
+      - tsx
+      - typescript
+      - unplugin-unused
+      - unrun
+      - utf-8-validate
+      - vite
+      - yaml
 
-  vitest@4.1.10(@types/node@22.20.1)(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)):
+  vitest@4.1.10(@types/node@22.20.1)(@vitest/browser-preview@4.1.10)(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(jsdom@29.1.1)(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3)):
     dependencies:
       '@vitest/expect': 4.1.10
-      '@vitest/mocker': 4.1.10(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vite@7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0))
+      '@vitest/mocker': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))
       '@vitest/pretty-format': 4.1.10
       '@vitest/runner': 4.1.10
       '@vitest/snapshot': 4.1.10
@@ -11885,10 +12314,11 @@ snapshots:
       tinyexec: 1.2.4
       tinyglobby: 0.2.17
       tinyrainbow: 3.1.0
-      vite: 7.3.6(@types/node@22.20.1)(jiti@2.7.0)(lightningcss@1.32.0)(tsx@4.23.1)(yaml@2.9.0)
+      vite: '@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0)'
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@types/node': 22.20.1
+      '@vitest/browser-preview': 4.1.10(@voidzero-dev/vite-plus-core@0.2.8(@types/node@22.20.1)(esbuild@0.28.1)(jiti@2.7.0)(tsx@4.23.1)(typescript@5.9.3)(yaml@2.9.0))(msw@2.15.0(@types/node@22.20.1)(typescript@5.9.3))(vitest@4.1.10)
       jsdom: 29.1.1
     transitivePeerDependencies:
       - msw
@@ -12064,6 +12494,38 @@ snapshots:
       cookie: 1.1.1
       youch-core: 0.3.3
 
+  yuku-codegen@0.5.48:
+    dependencies:
+      '@yuku-toolchain/types': 0.5.43
+    optionalDependencies:
+      '@yuku-codegen/binding-darwin-arm64': 0.5.48
+      '@yuku-codegen/binding-darwin-x64': 0.5.48
+      '@yuku-codegen/binding-freebsd-x64': 0.5.48
+      '@yuku-codegen/binding-linux-arm-gnu': 0.5.48
+      '@yuku-codegen/binding-linux-arm-musl': 0.5.48
+      '@yuku-codegen/binding-linux-arm64-gnu': 0.5.48
+      '@yuku-codegen/binding-linux-arm64-musl': 0.5.48
+      '@yuku-codegen/binding-linux-x64-gnu': 0.5.48
+      '@yuku-codegen/binding-linux-x64-musl': 0.5.48
+      '@yuku-codegen/binding-win32-arm64': 0.5.48
+      '@yuku-codegen/binding-win32-x64': 0.5.48
+
+  yuku-parser@0.5.48:
+    dependencies:
+      '@yuku-toolchain/types': 0.5.43
+    optionalDependencies:
+      '@yuku-parser/binding-darwin-arm64': 0.5.48
+      '@yuku-parser/binding-darwin-x64': 0.5.48
+      '@yuku-parser/binding-freebsd-x64': 0.5.48
+      '@yuku-parser/binding-linux-arm-gnu': 0.5.48
+      '@yuku-parser/binding-linux-arm-musl': 0.5.48
+      '@yuku-parser/binding-linux-arm64-gnu': 0.5.48
+      '@yuku-parser/binding-linux-arm64-musl': 0.5.48
+      '@yuku-parser/binding-linux-x64-gnu': 0.5.48
+      '@yuku-parser/binding-linux-x64-musl': 0.5.48
+      '@yuku-parser/binding-win32-arm64': 0.5.48
+      '@yuku-parser/binding-win32-x64': 0.5.48
+
   zenscroll@4.0.2: {}
 
   zod-to-json-schema@3.25.2(zod@3.25.76):
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 67742c3..144312c 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -3,10 +3,12 @@ packages:
   - "packages/*"
 overrides:
   "shadcn>zod": "3.25.76"
+  vite: "catalog:"
+  vitest: "catalog:"
 allowBuilds:
-  '@fission-ai/openspec': true
-  '@scarf/scarf': false
-  '@tree-sitter-grammars/tree-sitter-yaml': false
+  "@fission-ai/openspec": true
+  "@scarf/scarf": false
+  "@tree-sitter-grammars/tree-sitter-yaml": false
   core-js-pure: false
   esbuild: true
   msw: true
@@ -15,4 +17,25 @@ allowBuilds:
   tree-sitter-json: false
   workerd: true
 minimumReleaseAgeExclude:
-  - '@hookform/resolvers@5.7.1'
+  - "@hookform/resolvers@5.7.1"
+  - "@voidzero-dev/vite-plus-core@0.2.8"
+  - "@voidzero-dev/vite-plus-darwin-arm64@0.2.8"
+  - "@voidzero-dev/vite-plus-darwin-x64@0.2.8"
+  - "@voidzero-dev/vite-plus-linux-arm64-gnu@0.2.8"
+  - "@voidzero-dev/vite-plus-linux-arm64-musl@0.2.8"
+  - "@voidzero-dev/vite-plus-linux-x64-gnu@0.2.8"
+  - "@voidzero-dev/vite-plus-linux-x64-musl@0.2.8"
+  - "@voidzero-dev/vite-plus-win32-arm64-msvc@0.2.8"
+  - "@voidzero-dev/vite-plus-win32-x64-msvc@0.2.8"
+  - vite-plus@0.2.8
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@0.2.8
+  vitest: 4.1.10
+  vite-plus: 0.2.8
+peerDependencyRules:
+  allowAny:
+    - vite
+    - vitest
+  allowedVersions:
+    vite: "*"
+    vitest: "*"
diff --git a/scripts/env.test.ts b/scripts/env.test.ts
index 84d05bd..9827f25 100644
--- a/scripts/env.test.ts
+++ b/scripts/env.test.ts
@@ -38,7 +38,10 @@ test("explicit CNODE_ENV_FILE does not override shell environment", () => {
   const root = workspace();
   writeFileSync(join(root, ".env"), "POSTGRES_HOST=127.0.0.1\nPOSTGRES_PORT=5432\n");
   writeFileSync(join(root, ".env.remote.local"), "POSTGRES_HOST=remote\nPOSTGRES_PORT=15432\n");
-  const env: Record<string, string | undefined> = { CNODE_ENV_FILE: ".env.remote.local", POSTGRES_HOST: "from-shell" };
+  const env: Record<string, string | undefined> = {
+    CNODE_ENV_FILE: ".env.remote.local",
+    POSTGRES_HOST: "from-shell",
+  };
 
   loadRootEnv({ cwd: root, env });
 
@@ -62,7 +65,10 @@ test("throws when explicit CNODE_ENV_FILE is missing", () => {
   const root = workspace();
   writeFileSync(join(root, ".env"), "POSTGRES_HOST=127.0.0.1\n");
 
-  assert.throws(() => loadRootEnv({ cwd: root, env: { CNODE_ENV_FILE: ".env.missing.local" } }), /CNODE_ENV_FILE does not exist/);
+  assert.throws(
+    () => loadRootEnv({ cwd: root, env: { CNODE_ENV_FILE: ".env.missing.local" } }),
+    /CNODE_ENV_FILE does not exist/,
+  );
 });
 
 test("finds workspace root from nested package directory", () => {
diff --git a/scripts/env.ts b/scripts/env.ts
index 81373e8..70ea8c6 100644
--- a/scripts/env.ts
+++ b/scripts/env.ts
@@ -11,7 +11,10 @@ export interface LoadRootEnvOptions {
 
 function parseValue(value: string) {
   const trimmed = value.trim();
-  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+  if (
+    (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+    (trimmed.startsWith("'") && trimmed.endsWith("'"))
+  ) {
     return trimmed.slice(1, -1);
   }
   return trimmed;
diff --git a/scripts/migrate-mongo-to-pg.ts b/scripts/migrate-mongo-to-pg.ts
index b618620..4d7fbe0 100644
--- a/scripts/migrate-mongo-to-pg.ts
+++ b/scripts/migrate-mongo-to-pg.ts
@@ -45,7 +45,9 @@ function createReport(): MigrationReport {
   return {
     startedAt: new Date().toISOString(),
     source: {},
-    skipped: Object.fromEntries(skipKeys.map((key) => [key, { count: 0, samples: [] }])) as MigrationReport["skipped"],
+    skipped: Object.fromEntries(
+      skipKeys.map((key) => [key, { count: 0, samples: [] }]),
+    ) as MigrationReport["skipped"],
   };
 }
 
@@ -129,7 +131,11 @@ async function buildIdMap(client: MongoClient, collectionName: string | null): P
   return map;
 }
 
-async function forEachDoc(client: MongoClient, collectionName: string | null, handler: (doc: LegacyDoc) => Promise<void>) {
+async function forEachDoc(
+  client: MongoClient,
+  collectionName: string | null,
+  handler: (doc: LegacyDoc) => Promise<void>,
+) {
   if (!collectionName) return;
   const cursor = client
     .db(process.env.MONGO_DB || undefined)
@@ -159,14 +165,27 @@ async function resetTarget(pool: Pool) {
   );
 }
 
-async function insertUsers(client: MongoClient, pool: Pool, collectionName: string | null, userMap: IdMap) {
+async function insertUsers(
+  client: MongoClient,
+  pool: Pool,
+  collectionName: string | null,
+  userMap: IdMap,
+) {
   const loginNames = new Set<string>();
   const emails = new Set<string>();
   await forEachDoc(client, collectionName, async (user) => {
     const id = userMap.get(user._id.toHexString())!;
     const suffix = user._id.toHexString();
-    const loginname = uniqueValue(cleanText(user.loginname || user.name, `legacy_user_${id}`), loginNames, suffix);
-    const email = uniqueValue(cleanText(user.email, `${loginname}-${id}@legacy.invalid`), emails, suffix);
+    const loginname = uniqueValue(
+      cleanText(user.loginname || user.name, `legacy_user_${id}`),
+      loginNames,
+      suffix,
+    );
+    const email = uniqueValue(
+      cleanText(user.email, `${loginname}-${id}@legacy.invalid`),
+      emails,
+      suffix,
+    );
     await pool.query(
       `insert into users (
         id, loginname, pass, email, url, profile_image_url, location, signature, profile, weibo,
@@ -189,8 +208,12 @@ async function insertUsers(client: MongoClient, pool: Pool, collectionName: stri
         user.weibo ? cleanText(user.weibo) : null,
         user.avatar || user.avatar_url ? cleanText(user.avatar || user.avatar_url) : null,
         user.githubId || user.github_id ? cleanText(user.githubId || user.github_id) : null,
-        user.githubUsername || user.github_username ? cleanText(user.githubUsername || user.github_username) : null,
-        user.githubAccessToken || user.github_access_token ? cleanText(user.githubAccessToken || user.github_access_token) : null,
+        user.githubUsername || user.github_username
+          ? cleanText(user.githubUsername || user.github_username)
+          : null,
+        user.githubAccessToken || user.github_access_token
+          ? cleanText(user.githubAccessToken || user.github_access_token)
+          : null,
         toBool(user.is_block),
         Number(user.score || 0),
         Number(user.topic_count || 0),
@@ -199,7 +222,9 @@ async function insertUsers(client: MongoClient, pool: Pool, collectionName: stri
         user.is_star === null || user.is_star === undefined ? null : toBool(user.is_star),
         user.level ? cleanText(user.level) : null,
         toBool(user.active),
-        user.accessToken || user.access_token ? cleanText(user.accessToken || user.access_token) : null,
+        user.accessToken || user.access_token
+          ? cleanText(user.accessToken || user.access_token)
+          : null,
         toBool(user.receive_reply_mail),
         toBool(user.receive_at_mail),
         user.retrieve_key ? cleanText(user.retrieve_key) : null,
@@ -211,7 +236,15 @@ async function insertUsers(client: MongoClient, pool: Pool, collectionName: stri
   });
 }
 
-async function insertTopics(client: MongoClient, pool: Pool, collectionName: string | null, topicMap: IdMap, replyMap: IdMap, userMap: IdMap, report: MigrationReport) {
+async function insertTopics(
+  client: MongoClient,
+  pool: Pool,
+  collectionName: string | null,
+  topicMap: IdMap,
+  replyMap: IdMap,
+  userMap: IdMap,
+  report: MigrationReport,
+) {
   await forEachDoc(client, collectionName, async (topic) => {
     const id = topicMap.get(topic._id.toHexString())!;
     const authorId = mapId(userMap, topic.author_id);
@@ -248,7 +281,15 @@ async function insertTopics(client: MongoClient, pool: Pool, collectionName: str
   });
 }
 
-async function insertRepliesAndUps(client: MongoClient, pool: Pool, collectionName: string | null, replyMap: IdMap, topicMap: IdMap, userMap: IdMap, report: MigrationReport) {
+async function insertRepliesAndUps(
+  client: MongoClient,
+  pool: Pool,
+  collectionName: string | null,
+  replyMap: IdMap,
+  topicMap: IdMap,
+  userMap: IdMap,
+  report: MigrationReport,
+) {
   await forEachDoc(client, collectionName, async (reply) => {
     const id = replyMap.get(reply._id.toHexString())!;
     const topicId = mapId(topicMap, reply.topic_id);
@@ -291,7 +332,16 @@ async function insertRepliesAndUps(client: MongoClient, pool: Pool, collectionNa
   });
 }
 
-async function insertMessages(client: MongoClient, pool: Pool, collectionName: string | null, messageMap: IdMap, topicMap: IdMap, replyMap: IdMap, userMap: IdMap, report: MigrationReport) {
+async function insertMessages(
+  client: MongoClient,
+  pool: Pool,
+  collectionName: string | null,
+  messageMap: IdMap,
+  topicMap: IdMap,
+  replyMap: IdMap,
+  userMap: IdMap,
+  report: MigrationReport,
+) {
   await forEachDoc(client, collectionName, async (message) => {
     const id = messageMap.get(message._id.toHexString())!;
     const masterId = mapId(userMap, message.master_id);
@@ -321,7 +371,14 @@ async function insertMessages(client: MongoClient, pool: Pool, collectionName: s
   });
 }
 
-async function insertTopicCollects(client: MongoClient, pool: Pool, collectionName: string | null, topicMap: IdMap, userMap: IdMap, report: MigrationReport) {
+async function insertTopicCollects(
+  client: MongoClient,
+  pool: Pool,
+  collectionName: string | null,
+  topicMap: IdMap,
+  userMap: IdMap,
+  report: MigrationReport,
+) {
   await forEachDoc(client, collectionName, async (collect) => {
     const userId = mapId(userMap, collect.user_id);
     const topicId = mapId(topicMap, collect.topic_id);
@@ -342,7 +399,9 @@ async function insertTopicCollects(client: MongoClient, pool: Pool, collectionNa
 
 async function resetSequences(pool: Pool) {
   for (const table of ["users", "topics", "replies", "messages"]) {
-    await pool.query(`select setval(pg_get_serial_sequence('${table}', 'id'), coalesce((select max(id) from ${table}), 1))`);
+    await pool.query(
+      `select setval(pg_get_serial_sequence('${table}', 'id'), coalesce((select max(id) from ${table}), 1))`,
+    );
   }
 }
 
@@ -363,7 +422,12 @@ async function main() {
   const topicMap = await buildIdMap(mongo, topicsCollection);
   const replyMap = await buildIdMap(mongo, repliesCollection);
   const messageMap = await buildIdMap(mongo, messagesCollection);
-  report.source = { users: userMap.size, topics: topicMap.size, replies: replyMap.size, messages: messageMap.size };
+  report.source = {
+    users: userMap.size,
+    topics: topicMap.size,
+    replies: replyMap.size,
+    messages: messageMap.size,
+  };
 
   try {
     await resetTarget(pool);
@@ -374,7 +438,16 @@ async function main() {
     console.log(`migrating replies (${replyMap.size}) and reply_ups...`);
     await insertRepliesAndUps(mongo, pool, repliesCollection, replyMap, topicMap, userMap, report);
     console.log(`migrating messages (${messageMap.size})...`);
-    await insertMessages(mongo, pool, messagesCollection, messageMap, topicMap, replyMap, userMap, report);
+    await insertMessages(
+      mongo,
+      pool,
+      messagesCollection,
+      messageMap,
+      topicMap,
+      replyMap,
+      userMap,
+      report,
+    );
     console.log("migrating topic collects...");
     await insertTopicCollects(mongo, pool, collectsCollection, topicMap, userMap, report);
     await resetSequences(pool);
@@ -388,7 +461,18 @@ async function main() {
   const seconds = ((Date.now() - startedAt) / 1000).toFixed(1);
   console.log(`migration complete in ${seconds}s`);
   console.log(`migration report written to ${reportPath}`);
-  console.log(JSON.stringify({ users: userMap.size, topics: topicMap.size, replies: replyMap.size, messages: messageMap.size }, null, 2));
+  console.log(
+    JSON.stringify(
+      {
+        users: userMap.size,
+        topics: topicMap.size,
+        replies: replyMap.size,
+        messages: messageMap.size,
+      },
+      null,
+      2,
+    ),
+  );
 }
 
 main().catch((error) => {
diff --git a/scripts/reconcile-migration.ts b/scripts/reconcile-migration.ts
index dbc6fdf..397668c 100644
--- a/scripts/reconcile-migration.ts
+++ b/scripts/reconcile-migration.ts
@@ -34,7 +34,10 @@ async function mongoReplyUps(client: MongoClient) {
   if (!exists) return 0;
   const result = await db
     .collection("replies")
-    .aggregate([{ $project: { count: { $size: { $ifNull: ["$ups", []] } } } }, { $group: { _id: null, total: { $sum: "$count" } } }])
+    .aggregate([
+      { $project: { count: { $size: { $ifNull: ["$ups", []] } } } },
+      { $group: { _id: null, total: { $sum: "$count" } } },
+    ])
     .toArray();
   return Number(result[0]?.total || 0);
 }
@@ -79,10 +82,31 @@ async function main() {
 
   const checks = [
     ["users", await mongoCount(mongo, "users"), 0, await pgCount(pool, "users")],
-    ["topics", await mongoCount(mongo, "topics"), skipped(migrationReport, ["topicsMissingAuthor"]), await pgCount(pool, "topics")],
-    ["replies", await mongoCount(mongo, "replies"), skipped(migrationReport, ["repliesMissingTopic", "repliesMissingAuthor"]), await pgCount(pool, "replies")],
-    ["messages", await mongoCount(mongo, "messages"), skipped(migrationReport, ["messagesMissingMaster", "messagesMissingAuthor"]), await pgCount(pool, "messages")],
-    ["reply_ups", await mongoReplyUps(mongo), skipped(migrationReport, ["replyUpsMissingReply", "replyUpsMissingUser"]) + await mongoReplyUpDuplicates(mongo), await pgCount(pool, "reply_ups")],
+    [
+      "topics",
+      await mongoCount(mongo, "topics"),
+      skipped(migrationReport, ["topicsMissingAuthor"]),
+      await pgCount(pool, "topics"),
+    ],
+    [
+      "replies",
+      await mongoCount(mongo, "replies"),
+      skipped(migrationReport, ["repliesMissingTopic", "repliesMissingAuthor"]),
+      await pgCount(pool, "replies"),
+    ],
+    [
+      "messages",
+      await mongoCount(mongo, "messages"),
+      skipped(migrationReport, ["messagesMissingMaster", "messagesMissingAuthor"]),
+      await pgCount(pool, "messages"),
+    ],
+    [
+      "reply_ups",
+      await mongoReplyUps(mongo),
+      skipped(migrationReport, ["replyUpsMissingReply", "replyUpsMissingUser"]) +
+        (await mongoReplyUpDuplicates(mongo)),
+      await pgCount(pool, "reply_ups"),
+    ],
   ] as const;
 
   await mongo.close();
@@ -93,7 +117,11 @@ async function main() {
     return { name, source, skipped: skippedCount, expected, target, pass: expected === target };
   });
   const pass = rows.every((row) => row.pass);
-  const report = { pass, durationSeconds: Number(((Date.now() - startedAt) / 1000).toFixed(1)), checks: rows };
+  const report = {
+    pass,
+    durationSeconds: Number(((Date.now() - startedAt) / 1000).toFixed(1)),
+    checks: rows,
+  };
   console.log(JSON.stringify(report, null, 2));
   if (!pass) process.exit(1);
 }
diff --git a/scripts/repair-topic-reply-aggregates.ts b/scripts/repair-topic-reply-aggregates.ts
index ac2a4ff..70f6280 100644
--- a/scripts/repair-topic-reply-aggregates.ts
+++ b/scripts/repair-topic-reply-aggregates.ts
@@ -13,7 +13,7 @@ export function parseRepairMode(args: string[]) {
   if (args.some((arg) => arg !== "--dry-run" && arg !== "--apply")) {
     throw new Error("usage: pnpm repair:topic-replies [--dry-run|--apply]");
   }
-  return args.includes("--apply") ? "apply" as const : "dry-run" as const;
+  return args.includes("--apply") ? ("apply" as const) : ("dry-run" as const);
 }
 
 async function main() {
diff --git a/tsconfig.base.json b/tsconfig.base.json
index 51e2409..2221086 100644
--- a/tsconfig.base.json
+++ b/tsconfig.base.json
@@ -13,12 +13,11 @@
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
-    "baseUrl": ".",
     "paths": {
-      "@cnode/db": ["packages/db/src/index.ts"],
-      "@cnode/db/*": ["packages/db/src/*"],
-      "@cnode/shared": ["packages/shared/src/index.ts"],
-      "@cnode/shared/*": ["packages/shared/src/*"]
+      "@cnode/db": ["./packages/db/src/index.ts"],
+      "@cnode/db/*": ["./packages/db/src/*"],
+      "@cnode/shared": ["./packages/shared/src/index.ts"],
+      "@cnode/shared/*": ["./packages/shared/src/*"]
     }
   },
   "exclude": ["node_modules", "dist", "build"]
diff --git a/vite.config.ts b/vite.config.ts
new file mode 100644
index 0000000..e00353f
--- /dev/null
+++ b/vite.config.ts
@@ -0,0 +1,36 @@
+import { defineConfig } from "vite-plus";
+
+export default defineConfig({
+  staged: {
+    "*": "vp check --fix",
+  },
+  fmt: {},
+  lint: {
+    categories: {
+      correctness: "error",
+      suspicious: "off",
+      perf: "off",
+      style: "off",
+    },
+    rules: {
+      "no-unused-vars": "error",
+      "unicorn/no-useless-fallback-in-spread": "off",
+      "unicorn/no-useless-spread": "off",
+      "no-console": "off",
+      eqeqeq: "error",
+      "no-var": "error",
+      "prefer-const": "error",
+      "vite-plus/prefer-vite-plus-imports": "error",
+    },
+    ignorePatterns: ["node_modules", "dist", "build", ".vite", "pnpm-lock.yaml", "*.db"],
+    // Type-aware linting (options.typeAware/typeCheck) currently reports ~70
+    // pre-existing findings (mostly no-floating-promises) and requires rootDir
+    // restructuring in package tsconfigs; enable it after those are addressed.
+    jsPlugins: [
+      {
+        name: "vite-plus",
+        specifier: "vite-plus/oxlint-plugin",
+      },
+    ],
+  },
+});
diff --git a/wiki/README.md b/wiki/README.md
index 222bf19..d949b10 100644
--- a/wiki/README.md
+++ b/wiki/README.md
@@ -4,13 +4,13 @@ The wiki is the business knowledge base for CNode. It stores sourced background
 
 ## Pages
 
-| Page | Content |
-| ---- | ------- |
-| [writing-guidelines.md](writing-guidelines.md) | Required wiki writing standard and template. |
-| [business-rules.md](business-rules.md) | Scoring, topic/reply/collection/message rules, rate limiting, user status. |
+| Page                                               | Content                                                                       |
+| -------------------------------------------------- | ----------------------------------------------------------------------------- |
+| [writing-guidelines.md](writing-guidelines.md)     | Required wiki writing standard and template.                                  |
+| [business-rules.md](business-rules.md)             | Scoring, topic/reply/collection/message rules, rate limiting, user status.    |
 | [migration-background.md](migration-background.md) | Mongo-to-PostgreSQL field mapping, ID strategy, skip logic, report structure. |
-| [legacy-behavior.md](legacy-behavior.md) | Legacy behavior notes that inform compatibility decisions. |
-| [community-rules.md](community-rules.md) | Content moderation rules, sensitive words, scan jobs, reports, audit. |
+| [legacy-behavior.md](legacy-behavior.md)           | Legacy behavior notes that inform compatibility decisions.                    |
+| [community-rules.md](community-rules.md)           | Content moderation rules, sensitive words, scan jobs, reports, audit.         |
 
 ## Boundary
 
diff --git a/wiki/business-rules.md b/wiki/business-rules.md
index de7a81c..b7a66a1 100644
--- a/wiki/business-rules.md
+++ b/wiki/business-rules.md
@@ -18,181 +18,181 @@ CNode 社区的核心业务规则：积分、发帖、回复、收藏、消息
 
 ## Scoring
 
-| Action | ΔScore | Source |
-| ------ | ------ | ------ |
-| Create topic | +5 | `CREATE_TOPIC_SCORE = 5` in `topic.ts` |
-| Create reply | +5 | `CREATE_REPLY_SCORE = 5` in `reply.ts` |
-| Delete reply | -5 | `decrementScoreAndReplyCount(authorId, 5, 1)` in `reply.ts` |
-| Collect topic | (no score) | only `collectTopicCount` incremented |
-| Reply upvote | (no score) | toggle only, no score change |
+| Action        | ΔScore     | Source                                                      |
+| ------------- | ---------- | ----------------------------------------------------------- |
+| Create topic  | +5         | `CREATE_TOPIC_SCORE = 5` in `topic.ts`                      |
+| Create reply  | +5         | `CREATE_REPLY_SCORE = 5` in `reply.ts`                      |
+| Delete reply  | -5         | `decrementScoreAndReplyCount(authorId, 5, 1)` in `reply.ts` |
+| Collect topic | (no score) | only `collectTopicCount` incremented                        |
+| Reply upvote  | (no score) | toggle only, no score change                                |
 
 所有积分增减都带下限保护：`case when score - N < 0 then 0 else score - N end`，积分不会为负。
 
-| Counter | Increment | Decrement |
-| ------- | --------- | --------- |
-| `users.topicCount` | +1 on create topic | -1 on delete topic |
-| `users.replyCount` | +1 on create reply | -1 on delete reply |
-| `users.collectTopicCount` | +1 on collect | -1 on de-collect |
-| `topics.replyCount` | +1 via `updateLastReply` | -1 via `decrementReplyCount` |
-| `topics.visitCount` | +1 on topic detail view | (none) |
-| `topics.collectCount` | +1 on collect | -1 on de-collect |
+| Counter                   | Increment                | Decrement                    |
+| ------------------------- | ------------------------ | ---------------------------- |
+| `users.topicCount`        | +1 on create topic       | -1 on delete topic           |
+| `users.replyCount`        | +1 on create reply       | -1 on delete reply           |
+| `users.collectTopicCount` | +1 on collect            | -1 on de-collect             |
+| `topics.replyCount`       | +1 via `updateLastReply` | -1 via `decrementReplyCount` |
+| `topics.visitCount`       | +1 on topic detail view  | (none)                       |
+| `topics.collectCount`     | +1 on collect            | -1 on de-collect             |
 
 ## Topic Rules
 
 ### Creation
 
-| Rule | Value | Source |
-| ---- | ----- | ------ |
-| Score for creating | +5 | `CREATE_TOPIC_SCORE` |
-| Rate limit | 1000/user/day | `CREATE_TOPIC_PER_DAY` |
-| New user gate | 注册满 24h 且回复 ≥ 3 条 | `assertNewUserCanCreateTopic`，settings `new_user_min_hours`/`new_user_min_replies` |
-| Title length | ≥ 5, ≤ 100 | Zod schema |
-| Tab | `share` / `ask` / `job` | Zod enum |
-| Content | ≥ 5 chars | Zod schema |
-| Content check | 敏感词命中 → 422 | `checkContent` |
-| Turnstile | 启用时必传 `turnstileToken` | `verifyTurnstile` |
-| Mute/block | 禁言或封禁用户 → 403 | `ensureMuteNotExpired` |
-| Mention | `@loginname` → 发送 `at` 消息 | `sendMessageToMentionUsers` |
+| Rule               | Value                         | Source                                                                              |
+| ------------------ | ----------------------------- | ----------------------------------------------------------------------------------- |
+| Score for creating | +5                            | `CREATE_TOPIC_SCORE`                                                                |
+| Rate limit         | 1000/user/day                 | `CREATE_TOPIC_PER_DAY`                                                              |
+| New user gate      | 注册满 24h 且回复 ≥ 3 条      | `assertNewUserCanCreateTopic`，settings `new_user_min_hours`/`new_user_min_replies` |
+| Title length       | ≥ 5, ≤ 100                    | Zod schema                                                                          |
+| Tab                | `share` / `ask` / `job`       | Zod enum                                                                            |
+| Content            | ≥ 5 chars                     | Zod schema                                                                          |
+| Content check      | 敏感词命中 → 422              | `checkContent`                                                                      |
+| Turnstile          | 启用时必传 `turnstileToken`   | `verifyTurnstile`                                                                   |
+| Mute/block         | 禁言或封禁用户 → 403          | `ensureMuteNotExpired`                                                              |
+| Mention            | `@loginname` → 发送 `at` 消息 | `sendMessageToMentionUsers`                                                         |
 
 ### Editing
 
-| Rule | Value |
-| ---- | ----- |
-| Permission | 作者或 admin |
-| Lock check | `topic.lock === true` → 403 |
-| Content check | 敏感词命中 → 422 |
-| Mention | 重新解析 `@loginname` |
+| Rule          | Value                       |
+| ------------- | --------------------------- |
+| Permission    | 作者或 admin                |
+| Lock check    | `topic.lock === true` → 403 |
+| Content check | 敏感词命中 → 422            |
+| Mention       | 重新解析 `@loginname`       |
 
 ### Deletion
 
-| Rule | Value |
-| ---- | ----- |
-| Permission | 作者或 admin |
-| Soft delete | `deleted = true` |
-| Score | 作者 -5, `topicCount` -1 |
+| Rule        | Value                    |
+| ----------- | ------------------------ |
+| Permission  | 作者或 admin             |
+| Soft delete | `deleted = true`         |
+| Score       | 作者 -5, `topicCount` -1 |
 
 ### Admin Permanent Deletion
 
-| Rule | Value |
-| ---- | ----- |
-| Permission | admin only |
-| Entry point | 后台话题管理中的独立危险操作 |
-| Effect | 从 PostgreSQL 删除话题记录，并清理直接依赖数据 |
+| Rule         | Value                                                        |
+| ------------ | ------------------------------------------------------------ |
+| Permission   | admin only                                                   |
+| Entry point  | 后台话题管理中的独立危险操作                                 |
+| Effect       | 从 PostgreSQL 删除话题记录，并清理直接依赖数据               |
 | Dependencies | 回复、回复点赞、收藏、招聘扩展、巡检命中、消息引用和举报引用 |
-| Audit | 必须写入审计日志 |
+| Audit        | 必须写入审计日志                                             |
 
 永久删除不同于普通删除。普通删除和巡检确认删除都沿用软删除语义；巡检任务级批量确认删除会删除命中的原始话题或回复，但仍然只是软删除，不从数据库物理移除内容。
 
 ### Admin Actions
 
-| Action | Effect | Route |
-| ------ | ------ | ----- |
-| Top | toggle `topics.top` | `POST /topic/:tid/top` |
-| Good | toggle `topics.good` | `POST /topic/:tid/good` |
-| Lock | toggle `topics.lock` | `POST /topic/:tid/lock` |
-| Delete | soft delete | `POST /topic/:tid/delete` |
-| Permanent delete | physical delete, admin only | 后台管理 API |
+| Action           | Effect                      | Route                     |
+| ---------------- | --------------------------- | ------------------------- |
+| Top              | toggle `topics.top`         | `POST /topic/:tid/top`    |
+| Good             | toggle `topics.good`        | `POST /topic/:tid/good`   |
+| Lock             | toggle `topics.lock`        | `POST /topic/:tid/lock`   |
+| Delete           | soft delete                 | `POST /topic/:tid/delete` |
+| Permanent delete | physical delete, admin only | 后台管理 API              |
 
 ## Reply Rules
 
 ### Creation
 
-| Rule | Value | Source |
-| ---- | ----- | ------ |
-| Score for creating | +5 | `CREATE_REPLY_SCORE` |
-| Rate limit | 1000/user/day | `CREATE_REPLY_PER_DAY` |
-| Content | ≥ 1 char | Zod schema |
-| Content check | 敏感词命中 → 422 | `checkContent` |
-| Turnstile | 启用时必传 | `verifyTurnstile` |
-| Mute/block | 禁言或封禁 → 403 | `ensureMuteNotExpired` |
-| Lock check | `topic.lock === true` → 403 | |
-| Nested reply | `reply_id` 指向父回复 | `replyQueries.newAndSave(content, topicId, authorId, replyId)` |
+| Rule               | Value                       | Source                                                         |
+| ------------------ | --------------------------- | -------------------------------------------------------------- |
+| Score for creating | +5                          | `CREATE_REPLY_SCORE`                                           |
+| Rate limit         | 1000/user/day               | `CREATE_REPLY_PER_DAY`                                         |
+| Content            | ≥ 1 char                    | Zod schema                                                     |
+| Content check      | 敏感词命中 → 422            | `checkContent`                                                 |
+| Turnstile          | 启用时必传                  | `verifyTurnstile`                                              |
+| Mute/block         | 禁言或封禁 → 403            | `ensureMuteNotExpired`                                         |
+| Lock check         | `topic.lock === true` → 403 |                                                                |
+| Nested reply       | `reply_id` 指向父回复       | `replyQueries.newAndSave(content, topicId, authorId, replyId)` |
 
 ### Message Creation On Reply
 
-| Condition | Message type | Recipient |
-| --------- | ------------ | --------- |
-| 回复话题（作者不是自己） | `reply` | 话题作者 |
-| 回复别人的回复（父回复作者不是自己也不是话题作者） | `reply2` | 父回复作者 |
-| `@loginname`（被 @ 的人不是自己、不是话题作者、不是父回复作者） | `at` | 被 @ 的用户 |
+| Condition                                                       | Message type | Recipient   |
+| --------------------------------------------------------------- | ------------ | ----------- |
+| 回复话题（作者不是自己）                                        | `reply`      | 话题作者    |
+| 回复别人的回复（父回复作者不是自己也不是话题作者）              | `reply2`     | 父回复作者  |
+| `@loginname`（被 @ 的人不是自己、不是话题作者、不是父回复作者） | `at`         | 被 @ 的用户 |
 
 `sendReplyMessage` 和 `sendReply2Message` 都跳过 `masterId === authorId`。
 `@` 消息排除话题作者和父回复作者以避免重复通知。
 
 ### Editing
 
-| Rule | Value |
-| ---- | ----- |
-| Permission | 作者或 admin |
-| Content | ≥ 1 char |
-| Content check | 敏感词命中 → 422 |
-| Mention | 重新解析 `@loginname` |
+| Rule          | Value                 |
+| ------------- | --------------------- |
+| Permission    | 作者或 admin          |
+| Content       | ≥ 1 char              |
+| Content check | 敏感词命中 → 422      |
+| Mention       | 重新解析 `@loginname` |
 
 ### Deletion
 
-| Rule | Value |
-| ---- | ----- |
-| Permission | 作者或 mod |
-| Soft delete | `deleted = true` |
-| Score | 作者 -5, `replyCount` -1 |
-| Topic counter | `topics.replyCount` -1 |
+| Rule          | Value                    |
+| ------------- | ------------------------ |
+| Permission    | 作者或 mod               |
+| Soft delete   | `deleted = true`         |
+| Score         | 作者 -5, `replyCount` -1 |
+| Topic counter | `topics.replyCount` -1   |
 
 ### Upvote
 
-| Rule | Value |
-| ---- | ----- |
-| Toggle | push/splice `reply_ups` |
-| Self-upvote | 禁止 → 403 |
-| Response | `{ success, action: "up"\|"down" }` |
+| Rule        | Value                               |
+| ----------- | ----------------------------------- |
+| Toggle      | push/splice `reply_ups`             |
+| Self-upvote | 禁止 → 403                          |
+| Response    | `{ success, action: "up"\|"down" }` |
 
 ## Collection Rules
 
-| Rule | Value |
-| ---- | ----- |
-| Unique | `(userId, topicId)` primary key |
+| Rule              | Value                                                    |
+| ----------------- | -------------------------------------------------------- |
+| Unique            | `(userId, topicId)` primary key                          |
 | Public topic only | `isPublicTopic`: 非删除、非 `dev`/`test` tab、作者未封禁 |
-| Collect | `collectTopicCount` +1, `topics.collectCount` +1 |
-| De-collect | `collectTopicCount` -1, `topics.collectCount` -1 |
-| Duplicate | 已收藏 → `已经收藏过该主题` |
+| Collect           | `collectTopicCount` +1, `topics.collectCount` +1         |
+| De-collect        | `collectTopicCount` -1, `topics.collectCount` -1         |
+| Duplicate         | 已收藏 → `已经收藏过该主题`                              |
 
 ## Message Rules
 
 ### Types
 
-| Type | Trigger | Source |
-| ---- | ------- | ------ |
-| `reply` | 回复了你的话题 | `sendReplyMessage` |
-| `reply2` | 在话题中回复了你 | `sendReply2Message` |
-| `at` | @了你 | `sendAtMessage` |
-| `follow` | (not implemented) | — |
+| Type     | Trigger           | Source              |
+| -------- | ----------------- | ------------------- |
+| `reply`  | 回复了你的话题    | `sendReplyMessage`  |
+| `reply2` | 在话题中回复了你  | `sendReply2Message` |
+| `at`     | @了你             | `sendAtMessage`     |
+| `follow` | (not implemented) | —                   |
 
 ### Email Notification
 
-| Type | Condition | Source |
-| ---- | --------- | ------ |
-| reply | `master.receiveReplyMail === true` | `sendReplyNotifyMail` |
-| at | `master.receiveAtMail === true` | `sendAtNotifyMail` |
-| reply2 | (no email) | — |
+| Type   | Condition                          | Source                |
+| ------ | ---------------------------------- | --------------------- |
+| reply  | `master.receiveReplyMail === true` | `sendReplyNotifyMail` |
+| at     | `master.receiveAtMail === true`    | `sendAtNotifyMail`    |
+| reply2 | (no email)                         | —                     |
 
 ### Read State
 
-| Item | Value |
-| ---- | ----- |
-| `has_read` | Boolean, default false |
-| Mark all read | `POST /api/v1/message/mark_all` |
-| Mark one read | `POST /api/v1/message/mark_one/{msg_id}` |
-| Unread count | `GET /api/v1/message/count` |
-| Read list limit | 20 most recent |
+| Item            | Value                                    |
+| --------------- | ---------------------------------------- |
+| `has_read`      | Boolean, default false                   |
+| Mark all read   | `POST /api/v1/message/mark_all`          |
+| Mark one read   | `POST /api/v1/message/mark_one/{msg_id}` |
+| Unread count    | `GET /api/v1/message/count`              |
+| Read list limit | 20 most recent                           |
 
 ## User Status Rules
 
-| Status | Effect | Source |
-| ------ | ------ | ------ |
-| `isBlock` | 封禁，无法发帖/回复，话题对他人不可见 | `ensureMuteNotExpired`, `isPublicTopic` |
-| `isMuted` | 禁言，无法发帖/回复 | `ensureMuteNotExpired` |
-| `isStar` | 达人标记 | `isAdvanced` inference |
-| `active` | 账号激活状态，未激活无法登录 | `sign.ts` |
-| `retrieveKey`/`retrieveTime` | 密码重置令牌，24h 有效 | `sign.ts` |
+| Status                       | Effect                                | Source                                  |
+| ---------------------------- | ------------------------------------- | --------------------------------------- |
+| `isBlock`                    | 封禁，无法发帖/回复，话题对他人不可见 | `ensureMuteNotExpired`, `isPublicTopic` |
+| `isMuted`                    | 禁言，无法发帖/回复                   | `ensureMuteNotExpired`                  |
+| `isStar`                     | 达人标记                              | `isAdvanced` inference                  |
+| `active`                     | 账号激活状态，未激活无法登录          | `sign.ts`                               |
+| `retrieveKey`/`retrieveTime` | 密码重置令牌，24h 有效                | `sign.ts`                               |
 
 ### Advanced User
 
@@ -210,34 +210,34 @@ Legacy: `score > 700 || is_star` → `isAdvanced`。当前实现是否保留此
 
 公开 `/rss` 是唯一对外 RSS 订阅地址。RSS feed 表示全站公开内容订阅，不等同首页 `all` feed。
 
-| Rule | Value |
-| ---- | ----- |
-| Format | RSS 2.0 XML |
-| Source | API RSS source JSON + Web XML serialization |
-| Limit | 最多 50 条 |
-| Sort | `create_at desc` |
-| Include | 公开 `share` / `ask` / `job` 等话题 |
+| Rule    | Value                                                            |
+| ------- | ---------------------------------------------------------------- |
+| Format  | RSS 2.0 XML                                                      |
+| Source  | API RSS source JSON + Web XML serialization                      |
+| Limit   | 最多 50 条                                                       |
+| Sort    | `create_at desc`                                                 |
+| Include | 公开 `share` / `ask` / `job` 等话题                              |
 | Exclude | `dev` / `test`、`deleted=true`、`status=deleted`、block 作者内容 |
 
 ## Rate Limiting
 
-| Scope | Limit | Source |
-| ----- | ----- | ------ |
-| Create topic | 1000/user/day | `CREATE_TOPIC_PER_DAY` |
-| Create reply | 1000/user/day | `CREATE_REPLY_PER_DAY` |
-| Create account | 1000/ip/day | `CREATE_USER_PER_IP` (legacy) |
-| Rate settings | 可通过 `site_settings` 覆盖 | `perUserPerDaySetting` |
+| Scope          | Limit                       | Source                        |
+| -------------- | --------------------------- | ----------------------------- |
+| Create topic   | 1000/user/day               | `CREATE_TOPIC_PER_DAY`        |
+| Create reply   | 1000/user/day               | `CREATE_REPLY_PER_DAY`        |
+| Create account | 1000/ip/day                 | `CREATE_USER_PER_IP` (legacy) |
+| Rate settings  | 可通过 `site_settings` 覆盖 | `perUserPerDaySetting`        |
 
 ## Tabs
 
-| Tab | Display | Source |
-| --- | ------- | ------ |
-| `share` | 分享 | `config.tabs` |
-| `ask` | 问答 | `config.tabs` |
-| `job` | 招聘 | `config.tabs` |
-| `good` | 精华（显示用） | display-only |
-| `dev` | 内部（不公开） | `INTERNAL_TABS` |
-| `test` | 内部（不公开） | `INTERNAL_TABS` |
+| Tab     | Display        | Source          |
+| ------- | -------------- | --------------- |
+| `share` | 分享           | `config.tabs`   |
+| `ask`   | 问答           | `config.tabs`   |
+| `job`   | 招聘           | `config.tabs`   |
+| `good`  | 精华（显示用） | display-only    |
+| `dev`   | 内部（不公开） | `INTERNAL_TABS` |
+| `test`  | 内部（不公开） | `INTERNAL_TABS` |
 
 ## Inferences
 
diff --git a/wiki/community-rules.md b/wiki/community-rules.md
index 4667d4e..0f66c03 100644
--- a/wiki/community-rules.md
+++ b/wiki/community-rules.md
@@ -20,33 +20,33 @@ CNode 社区的内容审核规则、敏感词管理和用户举报处理。当
 
 ### Data Model
 
-| Field | Type | Description |
-| ----- | ---- | ----------- |
-| `id` | serial | PK |
-| `word` | text, unique | 敏感词，不区分大小写匹配 |
-| `category` | text, nullable | 分类标签 |
-| `hitCount` | integer, default 0 | 被命中次数 |
-| `createAt` | timestamp | 创建时间 |
+| Field      | Type               | Description              |
+| ---------- | ------------------ | ------------------------ |
+| `id`       | serial             | PK                       |
+| `word`     | text, unique       | 敏感词，不区分大小写匹配 |
+| `category` | text, nullable     | 分类标签                 |
+| `hitCount` | integer, default 0 | 被命中次数               |
+| `createAt` | timestamp          | 创建时间                 |
 
 ### Management
 
-| Action | Route | Effect |
-| ------ | ----- | ------ |
-| List | `GET /admin/keywords` | 返回所有敏感词，按创建时间倒序 |
-| Add | `POST /admin/keywords` | 添加单个敏感词，返回新记录 |
-| Bulk add | `POST /admin/keywords/bulk` | 批量添加，`on conflict do nothing` |
-| Remove | `DELETE /admin/keywords/:id` | 删除敏感词 |
+| Action   | Route                        | Effect                             |
+| -------- | ---------------------------- | ---------------------------------- |
+| List     | `GET /admin/keywords`        | 返回所有敏感词，按创建时间倒序     |
+| Add      | `POST /admin/keywords`       | 添加单个敏感词，返回新记录         |
+| Bulk add | `POST /admin/keywords/bulk`  | 批量添加，`on conflict do nothing` |
+| Remove   | `DELETE /admin/keywords/:id` | 删除敏感词                         |
 
 添加敏感词后调用 `invalidateWordCache()` 清除缓存，使新词立即生效。
 
 ### Matching
 
-| Item | Value |
-| ---- | ----- |
-| 算法 | case-insensitive substring |
-| 缓存 TTL | 60 秒 (`CACHE_TTL = 60000`) |
-| 缓存失效 | `invalidateWordCache()` |
-| 返回 | `ContentHit[]` with `word`, `keywordId`, `index` |
+| Item     | Value                                            |
+| -------- | ------------------------------------------------ |
+| 算法     | case-insensitive substring                       |
+| 缓存 TTL | 60 秒 (`CACHE_TTL = 60000`)                      |
+| 缓存失效 | `invalidateWordCache()`                          |
+| 返回     | `ContentHit[]` with `word`, `keywordId`, `index` |
 
 `matchContent(content, words)` 对每个敏感词做 `content.toLowerCase().indexOf(word.toLowerCase())`，命中返回 `ContentHit`。
 
@@ -65,19 +65,19 @@ CNode 社区的内容审核规则、敏感词管理和用户举报处理。当
 
 ### Data Model
 
-| Field | Type | Description |
-| ----- | ---- | ----------- |
-| `scope` | text | `topics` / `replies` / `all` |
-| `mode` | text | `historical` / `incremental` |
-| `reason` | text | `keyword_added` / `manual` / `scheduled` |
-| `status` | text | `pending` / `running` / `paused` / `done` / `failed` / `cancelled` |
-| `cursorTopicId` | integer | topic 批次游标 |
-| `cursorReplyId` | integer | reply 批次游标 |
-| `batchSize` | integer, default 200 | 每批扫描数量 |
-| `throttleMs` | integer, default 500 | 批间间隔 |
-| `maxBatchesPerRun` | integer, default 100 | 单次运行最大批次 |
-| `scannedCount` | integer | 已扫描总数 |
-| `hitCount` | integer | 命中总数 |
+| Field              | Type                 | Description                                                        |
+| ------------------ | -------------------- | ------------------------------------------------------------------ |
+| `scope`            | text                 | `topics` / `replies` / `all`                                       |
+| `mode`             | text                 | `historical` / `incremental`                                       |
+| `reason`           | text                 | `keyword_added` / `manual` / `scheduled`                           |
+| `status`           | text                 | `pending` / `running` / `paused` / `done` / `failed` / `cancelled` |
+| `cursorTopicId`    | integer              | topic 批次游标                                                     |
+| `cursorReplyId`    | integer              | reply 批次游标                                                     |
+| `batchSize`        | integer, default 200 | 每批扫描数量                                                       |
+| `throttleMs`       | integer, default 500 | 批间间隔                                                           |
+| `maxBatchesPerRun` | integer, default 100 | 单次运行最大批次                                                   |
+| `scannedCount`     | integer              | 已扫描总数                                                         |
+| `hitCount`         | integer              | 命中总数                                                           |
 
 ### Scan Flow
 
@@ -94,12 +94,12 @@ flowchart LR
 
 ### Batch Scanning
 
-| Step | Logic |
-| ---- | ----- |
+| Step        | Logic                                                                                     |
+| ----------- | ----------------------------------------------------------------------------------------- |
 | Topic batch | `WHERE deleted=false AND status!=draft`，historical 按 `id DESC`，incremental 按 `id ASC` |
-| Reply batch | `WHERE deleted=false`，同上游标策略 |
-| Field scan | topic: `title` + `content`；reply: `content` |
-| Hit insert | `onConflictDoNothing` by `dedupeKey` |
+| Reply batch | `WHERE deleted=false`，同上游标策略                                                       |
+| Field scan  | topic: `title` + `content`；reply: `content`                                              |
+| Hit insert  | `onConflictDoNothing` by `dedupeKey`                                                      |
 
 ### Hit Deduplication
 
@@ -115,48 +115,48 @@ flowchart LR
 
 ### Data Model
 
-| Field | Type | Description |
-| ----- | ---- | ----------- |
-| `scanJobId` | integer, FK | 关联扫描任务 |
-| `targetType` | text | `topic` / `reply` |
-| `targetId` | integer | 命中目标 ID |
-| `topicId` | integer, nullable | 关联话题 ID |
-| `authorId` | integer, nullable | 内容作者 ID |
-| `field` | text | 命中字段（`title` / `content`） |
-| `keywordIds` | jsonb | 命中的敏感词 ID 数组 |
-| `keywords` | jsonb | 命中的敏感词文本数组 |
-| `preview` | text | 命中上下文预览 |
-| `dedupeKey` | text, unique | 去重键 |
-| `status` | text, default `pending` | `pending` / `resolved` |
-| `action` | text, default `none` | `none` / `keep` / `mute` / `delete` / `restore` |
-| `handledBy` | integer, nullable | 处理人 ID |
-| `handledAt` | timestamp, nullable | 处理时间 |
+| Field        | Type                    | Description                                     |
+| ------------ | ----------------------- | ----------------------------------------------- |
+| `scanJobId`  | integer, FK             | 关联扫描任务                                    |
+| `targetType` | text                    | `topic` / `reply`                               |
+| `targetId`   | integer                 | 命中目标 ID                                     |
+| `topicId`    | integer, nullable       | 关联话题 ID                                     |
+| `authorId`   | integer, nullable       | 内容作者 ID                                     |
+| `field`      | text                    | 命中字段（`title` / `content`）                 |
+| `keywordIds` | jsonb                   | 命中的敏感词 ID 数组                            |
+| `keywords`   | jsonb                   | 命中的敏感词文本数组                            |
+| `preview`    | text                    | 命中上下文预览                                  |
+| `dedupeKey`  | text, unique            | 去重键                                          |
+| `status`     | text, default `pending` | `pending` / `resolved`                          |
+| `action`     | text, default `none`    | `none` / `keep` / `mute` / `delete` / `restore` |
+| `handledBy`  | integer, nullable       | 处理人 ID                                       |
+| `handledAt`  | timestamp, nullable     | 处理时间                                        |
 
 ### Admin Review
 
 管理员在 admin 面板查看 pending hits，执行操作：
 
-| Action | Effect |
-| ------ | ------ |
-| `keep` | 保留内容，标记为 resolved |
-| `mute` | 禁言作者（调用 `toggleBlock` 设置 `isMuted`） |
-| `delete` | 删除内容（topic 或 reply soft delete） |
-| `restore` | 恢复内容 |
+| Action    | Effect                                        |
+| --------- | --------------------------------------------- |
+| `keep`    | 保留内容，标记为 resolved                     |
+| `mute`    | 禁言作者（调用 `toggleBlock` 设置 `isMuted`） |
+| `delete`  | 删除内容（topic 或 reply soft delete）        |
+| `restore` | 恢复内容                                      |
 
 ## Reports
 
 ### Data Model
 
-| Field | Type | Description |
-| ----- | ---- | ----------- |
-| `targetType` | text | `topic` / `reply` |
-| `targetId` | integer | 举报目标 ID |
-| `reporterId` | integer | 举报人 ID |
-| `type` | text | 举报类型 |
-| `description` | text, nullable | 举报描述 |
-| `status` | text, default `pending` | `pending` / `confirmed` / `dismissed` |
-| `handlerId` | integer, nullable | 处理人 ID |
-| `handleAt` | timestamp, nullable | 处理时间 |
+| Field         | Type                    | Description                           |
+| ------------- | ----------------------- | ------------------------------------- |
+| `targetType`  | text                    | `topic` / `reply`                     |
+| `targetId`    | integer                 | 举报目标 ID                           |
+| `reporterId`  | integer                 | 举报人 ID                             |
+| `type`        | text                    | 举报类型                              |
+| `description` | text, nullable          | 举报描述                              |
+| `status`      | text, default `pending` | `pending` / `confirmed` / `dismissed` |
+| `handlerId`   | integer, nullable       | 处理人 ID                             |
+| `handleAt`    | timestamp, nullable     | 处理时间                              |
 
 ### Report Flow
 
@@ -172,29 +172,29 @@ flowchart LR
 
 ## Audit Log
 
-| Field | Type | Description |
-| ----- | ---- | ----------- |
-| `operatorId` | integer, nullable | 操作人 ID |
-| `operatorName` | text | 操作人名称 |
-| `action` | text | 操作类型 |
-| `targetType` | text, nullable | 目标类型 |
-| `targetId` | text, nullable | 目标 ID |
-| `targetName` | text, nullable | 目标名称 |
-| `result` | text | 操作结果 |
-| `detail` | text, nullable | 详细信息 |
-| `createAt` | timestamp | 操作时间 |
+| Field          | Type              | Description |
+| -------------- | ----------------- | ----------- |
+| `operatorId`   | integer, nullable | 操作人 ID   |
+| `operatorName` | text              | 操作人名称  |
+| `action`       | text              | 操作类型    |
+| `targetType`   | text, nullable    | 目标类型    |
+| `targetId`     | text, nullable    | 目标 ID     |
+| `targetName`   | text, nullable    | 目标名称    |
+| `result`       | text              | 操作结果    |
+| `detail`       | text, nullable    | 详细信息    |
+| `createAt`     | timestamp         | 操作时间    |
 
 所有 admin 操作都通过 `auditQueries.log()` 记录审计日志。
 
 ## Scheduled Scanning
 
-| Config | Env | Default |
-| ------ | --- | ------- |
-| Enabled | `MODERATION_SCHEDULE_ENABLED` | `0` (disabled) |
-| Interval | `MODERATION_SCHEDULE_INTERVAL_MS` | `3600000` (1h) |
-| Batch size | `MODERATION_SCAN_BATCH_SIZE` | `200` |
-| Throttle | `MODERATION_SCAN_THROTTLE_MS` | `500` |
-| Max batches/run | `MODERATION_SCAN_MAX_BATCHES_PER_RUN` | `100` |
+| Config          | Env                                   | Default        |
+| --------------- | ------------------------------------- | -------------- |
+| Enabled         | `MODERATION_SCHEDULE_ENABLED`         | `0` (disabled) |
+| Interval        | `MODERATION_SCHEDULE_INTERVAL_MS`     | `3600000` (1h) |
+| Batch size      | `MODERATION_SCAN_BATCH_SIZE`          | `200`          |
+| Throttle        | `MODERATION_SCAN_THROTTLE_MS`         | `500`          |
+| Max batches/run | `MODERATION_SCAN_MAX_BATCHES_PER_RUN` | `100`          |
 
 Worker 通过 `pnpm --filter @cnode/api worker:moderation` 启动，可与 API/Web 独立启停。
 
diff --git a/wiki/legacy-behavior.md b/wiki/legacy-behavior.md
index dc32786..3ac742b 100644
--- a/wiki/legacy-behavior.md
+++ b/wiki/legacy-behavior.md
@@ -19,71 +19,71 @@ CNode 社区源自 nodeclub，迁移到 cnode-next 后，API、数据结构和
 
 ### Session Cookie
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| Cookie name | `node_club` | `node_club` |
-| Signing | `session_secret` | `AUTH_SESSION_SECRET` |
-| Domain | `config.host` | `AUTH_COOKIE_DOMAIN` |
-| HttpOnly | yes | yes |
-| SameSite | (not set) | `Lax` |
+| Item        | Legacy           | Current               |
+| ----------- | ---------------- | --------------------- |
+| Cookie name | `node_club`      | `node_club`           |
+| Signing     | `session_secret` | `AUTH_SESSION_SECRET` |
+| Domain      | `config.host`    | `AUTH_COOKIE_DOMAIN`  |
+| HttpOnly    | yes              | yes                   |
+| SameSite    | (not set)        | `Lax`                 |
 
 ### GitHub OAuth
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| State cookie | session-based | `github_oauth_state` cookie (10 min, signed) |
-| Pending profile | session-based | `github_profile` cookie (10 min, signed) |
-| Bind decision | ad-hoc | `decideGithubBind` → `bind`/`refresh`/`reject-different`/`reject-occupied` |
-| Unique constraint | `githubId` index | `users_github_id_unique` |
-| Unbind | not implemented | `executeGithubUnbind`（验证密码 → 撤销 token → 清除 githubId） |
-| Token revoke | not implemented | `revokeGithubToken`（调用 GitHub `DELETE /applications/{id}/token`） |
+| Item              | Legacy           | Current                                                                    |
+| ----------------- | ---------------- | -------------------------------------------------------------------------- |
+| State cookie      | session-based    | `github_oauth_state` cookie (10 min, signed)                               |
+| Pending profile   | session-based    | `github_profile` cookie (10 min, signed)                                   |
+| Bind decision     | ad-hoc           | `decideGithubBind` → `bind`/`refresh`/`reject-different`/`reject-occupied` |
+| Unique constraint | `githubId` index | `users_github_id_unique`                                                   |
+| Unbind            | not implemented  | `executeGithubUnbind`（验证密码 → 撤销 token → 清除 githubId）             |
+| Token revoke      | not implemented  | `revokeGithubToken`（调用 GitHub `DELETE /applications/{id}/token`）       |
 
 ### Local Password Auth
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| Hash | bcrypt (`tools.bhash` / `tools.bcompare`) | bcrypt（`verifyPassword(password, hash)`） |
-| Activation | `active` flag + md5(email+passhash+secret) link | `active` flag + activation email |
-| Signup validation | loginname ≥ 5 chars, `validateId`, email, pass match | 同上 |
-| Password reset | `retrieve_key` + `retrieve_time` (24h) | `retrieve_key` + `retrieve_time` (24h) |
-| Login by email or loginname | yes | yes |
+| Item                        | Legacy                                               | Current                                    |
+| --------------------------- | ---------------------------------------------------- | ------------------------------------------ |
+| Hash                        | bcrypt (`tools.bhash` / `tools.bcompare`)            | bcrypt（`verifyPassword(password, hash)`） |
+| Activation                  | `active` flag + md5(email+passhash+secret) link      | `active` flag + activation email           |
+| Signup validation           | loginname ≥ 5 chars, `validateId`, email, pass match | 同上                                       |
+| Password reset              | `retrieve_key` + `retrieve_time` (24h)               | `retrieve_key` + `retrieve_time` (24h)     |
+| Login by email or loginname | yes                                                  | yes                                        |
 
 ### Access Token
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| Token storage | `users.accessToken` (plain string) | `users.accessToken` |
-| Auth via query | `?accesstoken=` | `?accesstoken=` |
-| Auth via body | `{ "accesstoken": "..." }` | `{ "accesstoken": "..." }` |
-| Validate endpoint | `POST /api/v1/accesstoken` | `POST /api/v1/accesstoken` |
-| Rotation | `POST /user/refresh_token` | `POST /api/v1/user/refresh_token` |
+| Item              | Legacy                             | Current                           |
+| ----------------- | ---------------------------------- | --------------------------------- |
+| Token storage     | `users.accessToken` (plain string) | `users.accessToken`               |
+| Auth via query    | `?accesstoken=`                    | `?accesstoken=`                   |
+| Auth via body     | `{ "accesstoken": "..." }`         | `{ "accesstoken": "..." }`        |
+| Validate endpoint | `POST /api/v1/accesstoken`         | `POST /api/v1/accesstoken`        |
+| Rotation          | `POST /user/refresh_token`         | `POST /api/v1/user/refresh_token` |
 
 ## Topic
 
 ### Lifecycle Fields
 
-| Field | Legacy | Current |
-| ----- | ------ | ------- |
-| `top` | Boolean, admin toggle | Boolean, admin toggle |
-| `good` | Boolean, admin toggle | Boolean, admin toggle |
-| `lock` | Boolean, admin toggle, 阻止回复 | Boolean, 阻止回复 |
-| `deleted` | soft delete | soft delete |
-| `tab` | `share` / `ask` / `job` | `share` / `ask` / `job` / `good` (display tab) |
-| `reply_count` | denormalized counter | denormalized counter |
-| `visit_count` | denormalized counter | denormalized counter |
-| `collect_count` | denormalized counter | denormalized counter |
-| `last_reply_at` | denormalized timestamp | denormalized timestamp |
-| `last_reply` | ObjectId ref reply | integer reply ID |
+| Field           | Legacy                          | Current                                        |
+| --------------- | ------------------------------- | ---------------------------------------------- |
+| `top`           | Boolean, admin toggle           | Boolean, admin toggle                          |
+| `good`          | Boolean, admin toggle           | Boolean, admin toggle                          |
+| `lock`          | Boolean, admin toggle, 阻止回复 | Boolean, 阻止回复                              |
+| `deleted`       | soft delete                     | soft delete                                    |
+| `tab`           | `share` / `ask` / `job`         | `share` / `ask` / `job` / `good` (display tab) |
+| `reply_count`   | denormalized counter            | denormalized counter                           |
+| `visit_count`   | denormalized counter            | denormalized counter                           |
+| `collect_count` | denormalized counter            | denormalized counter                           |
+| `last_reply_at` | denormalized timestamp          | denormalized timestamp                         |
+| `last_reply`    | ObjectId ref reply              | integer reply ID                               |
 
 ### Validation
 
-| Rule | Legacy | Current |
-| ---- | ------ | ------- |
-| Title length | 5–100 | 5–100 |
-| Tab | must be in `config.tabs` | `share` / `ask` / `job` |
-| Content | non-empty, ≥ 5 | non-empty, ≥ 5 |
-| Edit permission | author or admin | author or admin |
-| Rate limit | `create_post_per_day` = 1000 | per-user per-day rate limit |
+| Rule            | Legacy                       | Current                     |
+| --------------- | ---------------------------- | --------------------------- |
+| Title length    | 5–100                        | 5–100                       |
+| Tab             | must be in `config.tabs`     | `share` / `ask` / `job`     |
+| Content         | non-empty, ≥ 5               | non-empty, ≥ 5              |
+| Edit permission | author or admin              | author or admin             |
+| Rate limit      | `create_post_per_day` = 1000 | per-user per-day rate limit |
 
 ### Topic Detail Extras
 
@@ -94,128 +94,128 @@ CNode 社区源自 nodeclub，迁移到 cnode-next 后，API、数据结构和
 
 ### Fields
 
-| Field | Legacy | Current |
-| ----- | ------ | ------- |
-| `content` | Markdown string | Markdown string |
-| `topic_id` | ObjectId ref topic | integer topic ID |
-| `author_id` | ObjectId ref user | integer author ID |
-| `reply_id` | parent reply ObjectId (for nested) | integer parent reply ID |
-| `ups` | `[ObjectId]` array | `reply_ups` join table |
-| `deleted` | soft delete | soft delete |
-| `content_is_html` | Boolean | (not used; `mdrender` controls rendering) |
+| Field             | Legacy                             | Current                                   |
+| ----------------- | ---------------------------------- | ----------------------------------------- |
+| `content`         | Markdown string                    | Markdown string                           |
+| `topic_id`        | ObjectId ref topic                 | integer topic ID                          |
+| `author_id`       | ObjectId ref user                  | integer author ID                         |
+| `reply_id`        | parent reply ObjectId (for nested) | integer parent reply ID                   |
+| `ups`             | `[ObjectId]` array                 | `reply_ups` join table                    |
+| `deleted`         | soft delete                        | soft delete                               |
+| `content_is_html` | Boolean                            | (not used; `mdrender` controls rendering) |
 
 ### Reply Creation
 
-| Rule | Legacy | Current |
-| ---- | ------ | ------- |
-| Content | non-empty | non-empty |
-| Lock check | `topic.lock === true` → 403 | 同 |
-| Nested reply | `reply_id` 指向父回复 | 同 |
-| Rate limit | `create_reply_per_day` = 1000 | per-user per-day rate limit |
-| Mention | `@loginname` 解析 + 发送 `at` 消息 | 同 |
-| Reply to topic author | 发送 `reply` 消息 | 发送 `reply` 消息 |
-| Reply to other replyer | 发送 `reply2` 消息 | 待确认 |
+| Rule                   | Legacy                             | Current                     |
+| ---------------------- | ---------------------------------- | --------------------------- |
+| Content                | non-empty                          | non-empty                   |
+| Lock check             | `topic.lock === true` → 403        | 同                          |
+| Nested reply           | `reply_id` 指向父回复              | 同                          |
+| Rate limit             | `create_reply_per_day` = 1000      | per-user per-day rate limit |
+| Mention                | `@loginname` 解析 + 发送 `at` 消息 | 同                          |
+| Reply to topic author  | 发送 `reply` 消息                  | 发送 `reply` 消息           |
+| Reply to other replyer | 发送 `reply2` 消息                 | 待确认                      |
 
 ### Reply Upvote
 
-| Rule | Legacy | Current |
-| ---- | ------ | ------- |
-| Toggle | push/splice `ups[]` | `reply_ups` insert/delete |
-| Self-upvote | 禁止（非 debug） | 待确认 |
-| Response | `{ success, action: "up"\|"down" }` | 同 |
+| Rule        | Legacy                              | Current                   |
+| ----------- | ----------------------------------- | ------------------------- |
+| Toggle      | push/splice `ups[]`                 | `reply_ups` insert/delete |
+| Self-upvote | 禁止（非 debug）                    | 待确认                    |
+| Response    | `{ success, action: "up"\|"down" }` | 同                        |
 
 ## User
 
 ### Profile Fields
 
-| Field | Legacy | Current |
-| ----- | ------ | ------- |
-| `loginname` | unique, ≥ 5 chars, `validateId` | 同 |
-| `email` | unique, isEmail | 同 |
-| `pass` | bcrypt hash | bcrypt hash |
-| `avatar` / `avatar_url` | Gravatar / GitHub avatar | OSS or GitHub avatar |
-| `url` | homepage URL | homepage URL |
-| `location` | location string | location string |
-| `signature` | signature string | signature string |
-| `weibo` | weibo handle/URL | weibo handle/URL |
-| `score` | denormalized counter | denormalized counter |
-| `is_star` | 达人 flag | 达人 flag |
-| `is_block` | 禁言 flag | 禁言 / mute flag |
-| `level` | user level string | 待确认 |
-| `active` | account activated flag | account activated flag |
-| `receive_reply_mail` | reply email notification | reply email notification |
-| `receive_at_mail` | mention email notification | mention email notification |
+| Field                   | Legacy                          | Current                    |
+| ----------------------- | ------------------------------- | -------------------------- |
+| `loginname`             | unique, ≥ 5 chars, `validateId` | 同                         |
+| `email`                 | unique, isEmail                 | 同                         |
+| `pass`                  | bcrypt hash                     | bcrypt hash                |
+| `avatar` / `avatar_url` | Gravatar / GitHub avatar        | OSS or GitHub avatar       |
+| `url`                   | homepage URL                    | homepage URL               |
+| `location`              | location string                 | location string            |
+| `signature`             | signature string                | signature string           |
+| `weibo`                 | weibo handle/URL                | weibo handle/URL           |
+| `score`                 | denormalized counter            | denormalized counter       |
+| `is_star`               | 达人 flag                       | 达人 flag                  |
+| `is_block`              | 禁言 flag                       | 禁言 / mute flag           |
+| `level`                 | user level string               | 待确认                     |
+| `active`                | account activated flag          | account activated flag     |
+| `receive_reply_mail`    | reply email notification        | reply email notification   |
+| `receive_at_mail`       | mention email notification      | mention email notification |
 
 ### Scoring
 
-| Action | Legacy Δscore | Current |
-| ------ | ------------- | ------- |
-| Create topic | +5 | 待确认 |
-| Create reply | +5 | 待确认 |
-| Delete reply | -5 | 待确认 |
-| Reply upvote received | (none) | 待确认 |
-| Topic deleted | (none) | 待确认 |
+| Action                | Legacy Δscore | Current |
+| --------------------- | ------------- | ------- |
+| Create topic          | +5            | 待确认  |
+| Create reply          | +5            | 待确认  |
+| Delete reply          | -5            | 待确认  |
+| Reply upvote received | (none)        | 待确认  |
+| Topic deleted         | (none)        | 待确认  |
 
 ### Admin Actions
 
-| Action | Legacy | Current |
-| ------ | ------ | ------- |
-| Set star (达人) | `POST /user/set_star` | admin route |
-| Cancel star | `POST /user/cancel_star` | admin route |
-| Block user (禁言) | `POST /user/:name/block` | admin route |
+| Action                | Legacy                        | Current     |
+| --------------------- | ----------------------------- | ----------- |
+| Set star (达人)       | `POST /user/set_star`         | admin route |
+| Cancel star           | `POST /user/cancel_star`      | admin route |
+| Block user (禁言)     | `POST /user/:name/block`      | admin route |
 | Delete all user posts | `POST /user/:name/delete_all` | admin route |
-| Top topic | `POST /topic/:tid/top` | admin route |
-| Good topic | `POST /topic/:tid/good` | admin route |
-| Lock topic | `POST /topic/:tid/lock` | admin route |
+| Top topic             | `POST /topic/:tid/top`        | admin route |
+| Good topic            | `POST /topic/:tid/good`       | admin route |
+| Lock topic            | `POST /topic/:tid/lock`       | admin route |
 
 ## Message
 
 ### Message Types
 
-| Type | Legacy | Current |
-| ---- | ------ | ------- |
-| `reply` | 回复了你的话题 | 回复了你的话题 |
+| Type     | Legacy           | Current          |
+| -------- | ---------------- | ---------------- |
+| `reply`  | 回复了你的话题   | 回复了你的话题   |
 | `reply2` | 在话题中回复了你 | 在话题中回复了你 |
-| `at` | @了你 | @了你 |
-| `follow` | 关注了你 | 待确认 |
+| `at`     | @了你            | @了你            |
+| `follow` | 关注了你         | 待确认           |
 
 ### Message Read State
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| `has_read` | Boolean | Boolean |
-| Mark all read | `POST /message/mark_all` | `POST /api/v1/message/mark_all` |
+| Item          | Legacy                           | Current                                  |
+| ------------- | -------------------------------- | ---------------------------------------- |
+| `has_read`    | Boolean                          | Boolean                                  |
+| Mark all read | `POST /message/mark_all`         | `POST /api/v1/message/mark_all`          |
 | Mark one read | `POST /message/mark_one/:msg_id` | `POST /api/v1/message/mark_one/{msg_id}` |
-| Unread count | `GET /message/count` | `GET /api/v1/message/count` |
+| Unread count  | `GET /message/count`             | `GET /api/v1/message/count`              |
 
 ## Topic Collect
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| Unique | `(user_id, topic_id)` | `(user_id, topic_id)` |
-| Collect | `POST /topic/collect` | `POST /api/v1/topic_collect/collect` |
-| De-collect | `POST /topic/de_collect` | `POST /api/v1/topic_collect/de_collect` |
-| List by user | `GET /user/:name/collections` | `GET /api/v1/user/{loginname}/collections` |
-| List by loginname | `GET /topic_collect/:loginname` | `GET /api/v1/topic_collect/{loginname}` |
+| Item              | Legacy                          | Current                                    |
+| ----------------- | ------------------------------- | ------------------------------------------ |
+| Unique            | `(user_id, topic_id)`           | `(user_id, topic_id)`                      |
+| Collect           | `POST /topic/collect`           | `POST /api/v1/topic_collect/collect`       |
+| De-collect        | `POST /topic/de_collect`        | `POST /api/v1/topic_collect/de_collect`    |
+| List by user      | `GET /user/:name/collections`   | `GET /api/v1/user/{loginname}/collections` |
+| List by loginname | `GET /topic_collect/:loginname` | `GET /api/v1/topic_collect/{loginname}`    |
 
 ## Markdown Rendering
 
-| Item | Legacy | Current |
-| ---- | ------ | ------- |
-| Default render | HTML | HTML (`mdrender=true`) |
-| Raw markdown | (not supported) | `mdrender=false` |
-| User linking | `@loginname` → `<a href="/user/loginname">` | 同 |
-| Code blocks | fenced + inline | fenced + inline |
-| Mention parsing | regex with ignore patterns (code, email, links) | 同 |
+| Item            | Legacy                                          | Current                |
+| --------------- | ----------------------------------------------- | ---------------------- |
+| Default render  | HTML                                            | HTML (`mdrender=true`) |
+| Raw markdown    | (not supported)                                 | `mdrender=false`       |
+| User linking    | `@loginname` → `<a href="/user/loginname">`     | 同                     |
+| Code blocks     | fenced + inline                                 | fenced + inline        |
+| Mention parsing | regex with ignore patterns (code, email, links) | 同                     |
 
 ## Rate Limiting
 
-| Scope | Legacy | Current |
-| ----- | ------ | ------- |
-| Create topic | 1000/user/day | per-user per-day |
-| Create reply | 1000/user/day | per-user per-day |
-| Create account | 1000/ip/day | per-ip per-day |
-| Visit | 1000/ip/day | per-ip (待确认) |
+| Scope          | Legacy        | Current          |
+| -------------- | ------------- | ---------------- |
+| Create topic   | 1000/user/day | per-user per-day |
+| Create reply   | 1000/user/day | per-user per-day |
+| Create account | 1000/ip/day   | per-ip per-day   |
+| Visit          | 1000/ip/day   | per-ip (待确认)  |
 
 ## Inferences
 
diff --git a/wiki/migration-background.md b/wiki/migration-background.md
index 5da4fcb..0f63ad9 100644
--- a/wiki/migration-background.md
+++ b/wiki/migration-background.md
@@ -28,10 +28,10 @@ ID map 必须先于数据迁移构建，因为 topics 引用 users，replies 引
 
 ## ID Mapping Strategy
 
-| Source | Target | Strategy |
-| ------ | ------ | -------- |
+| Source           | Target                      | Strategy                   |
+| ---------------- | --------------------------- | -------------------------- |
 | Mongo `ObjectId` | PostgreSQL `serial` integer | 按 `_id` 升序从 1 递增分配 |
-| ID map | `Map<string, number>` | 全表扫描构建，内存保存 |
+| ID map           | `Map<string, number>`       | 全表扫描构建，内存保存     |
 
 `buildIdMap` 按 `_id` 升序遍历，分配 1, 2, 3...。`mapId` 通过 ObjectId hex string 查找对应整数。
 
@@ -39,116 +39,116 @@ ID map 必须先于数据迁移构建，因为 topics 引用 users，replies 引
 
 ### users
 
-| Mongo field | PG column | Transform |
-| ----------- | --------- | --------- |
-| `_id` | `id` | ObjectId → integer via map |
-| `loginname` / `name` | `loginname` | `cleanText`, fallback `legacy_user_{id}`, dedupe via suffix |
-| `pass` | `pass` | `cleanText`, null if missing |
-| `email` | `email` | `cleanText`, fallback `{loginname}-{id}@legacy.invalid`, dedupe |
-| `url` | `url` | `cleanText` |
-| `profile_image_url` | `profile_image_url` | `cleanText` |
-| `location` | `location` | `cleanText` |
-| `signature` | `signature` | `cleanText` |
-| `profile` | `profile` | `cleanText` |
-| `weibo` | `weibo` | `cleanText` |
-| `avatar` / `avatar_url` | `avatar` | `cleanText`, prefer `avatar` then `avatar_url` |
-| `githubId` / `github_id` | `github_id` | `cleanText`, prefer camelCase |
-| `githubUsername` / `github_username` | `github_username` | `cleanText`, prefer camelCase |
-| `githubAccessToken` / `github_access_token` | `github_access_token` | `cleanText`, prefer camelCase |
-| `is_block` | `is_block` | `toBool` |
-| `score` | `score` | `Number(… \|\| 0)` |
-| `topic_count` | `topic_count` | `Number(… \|\| 0)` |
-| `reply_count` | `reply_count` | `Number(… \|\| 0)` |
-| `collect_topic_count` | `collect_topic_count` | `Number(… \|\| 0)` |
-| `is_star` | `is_star` | `toBool`, null if missing |
-| `level` | `level` | `cleanText` |
-| `active` | `active` | `toBool` |
-| `accessToken` / `access_token` | `access_token` | `cleanText`, prefer camelCase |
-| `receive_reply_mail` | `receive_reply_mail` | `toBool` |
-| `receive_at_mail` | `receive_at_mail` | `toBool` |
-| `retrieve_key` | `retrieve_key` | `cleanText` |
-| `retrieve_time` | `retrieve_time` | passthrough |
-| `create_at` | `create_at` | `toDate`, fallback `new Date(0)` |
-| `update_at` | `update_at` | `toDate`, fallback `create_at` then `new Date(0)` |
+| Mongo field                                 | PG column             | Transform                                                       |
+| ------------------------------------------- | --------------------- | --------------------------------------------------------------- |
+| `_id`                                       | `id`                  | ObjectId → integer via map                                      |
+| `loginname` / `name`                        | `loginname`           | `cleanText`, fallback `legacy_user_{id}`, dedupe via suffix     |
+| `pass`                                      | `pass`                | `cleanText`, null if missing                                    |
+| `email`                                     | `email`               | `cleanText`, fallback `{loginname}-{id}@legacy.invalid`, dedupe |
+| `url`                                       | `url`                 | `cleanText`                                                     |
+| `profile_image_url`                         | `profile_image_url`   | `cleanText`                                                     |
+| `location`                                  | `location`            | `cleanText`                                                     |
+| `signature`                                 | `signature`           | `cleanText`                                                     |
+| `profile`                                   | `profile`             | `cleanText`                                                     |
+| `weibo`                                     | `weibo`               | `cleanText`                                                     |
+| `avatar` / `avatar_url`                     | `avatar`              | `cleanText`, prefer `avatar` then `avatar_url`                  |
+| `githubId` / `github_id`                    | `github_id`           | `cleanText`, prefer camelCase                                   |
+| `githubUsername` / `github_username`        | `github_username`     | `cleanText`, prefer camelCase                                   |
+| `githubAccessToken` / `github_access_token` | `github_access_token` | `cleanText`, prefer camelCase                                   |
+| `is_block`                                  | `is_block`            | `toBool`                                                        |
+| `score`                                     | `score`               | `Number(… \|\| 0)`                                              |
+| `topic_count`                               | `topic_count`         | `Number(… \|\| 0)`                                              |
+| `reply_count`                               | `reply_count`         | `Number(… \|\| 0)`                                              |
+| `collect_topic_count`                       | `collect_topic_count` | `Number(… \|\| 0)`                                              |
+| `is_star`                                   | `is_star`             | `toBool`, null if missing                                       |
+| `level`                                     | `level`               | `cleanText`                                                     |
+| `active`                                    | `active`              | `toBool`                                                        |
+| `accessToken` / `access_token`              | `access_token`        | `cleanText`, prefer camelCase                                   |
+| `receive_reply_mail`                        | `receive_reply_mail`  | `toBool`                                                        |
+| `receive_at_mail`                           | `receive_at_mail`     | `toBool`                                                        |
+| `retrieve_key`                              | `retrieve_key`        | `cleanText`                                                     |
+| `retrieve_time`                             | `retrieve_time`       | passthrough                                                     |
+| `create_at`                                 | `create_at`           | `toDate`, fallback `new Date(0)`                                |
+| `update_at`                                 | `update_at`           | `toDate`, fallback `create_at` then `new Date(0)`               |
 
 Login name 和 email dedupe：遇到重复时追加 `__legacy_{objectId}` 后缀。
 
 ### topics
 
-| Mongo field | PG column | Transform |
-| ----------- | --------- | --------- |
-| `_id` | `id` | map |
-| `title` | `title` | `cleanText` |
-| `content` | `content` | `cleanText` |
-| `author_id` | `author_id` | `mapId(userMap)`，缺失则 skip |
-| `tab` | `tab` | `cleanText` |
-| `top` | `top` | `toBool` |
-| `good` | `good` | `toBool` |
-| `lock` | `lock` | `toBool` |
-| (none) | `status` | default `published` |
-| `reply_count` | `reply_count` | `Number(… \|\| 0)` |
-| `visit_count` | `visit_count` | `Number(… \|\| 0)` |
-| `collect_count` | `collect_count` | `Number(… \|\| 0)` |
-| `last_reply` | `last_reply_id` | `mapId(replyMap)` |
-| `last_reply_at` | `last_reply_at` | `toDate` |
-| (none) | `archived` | `toBool` |
-| `deleted` | `deleted` | `toBool` |
-| `create_at` | `create_at` | `toDate`, fallback `new Date(0)` |
-| `update_at` | `update_at` | `toDate`, fallback chain |
+| Mongo field     | PG column       | Transform                        |
+| --------------- | --------------- | -------------------------------- |
+| `_id`           | `id`            | map                              |
+| `title`         | `title`         | `cleanText`                      |
+| `content`       | `content`       | `cleanText`                      |
+| `author_id`     | `author_id`     | `mapId(userMap)`，缺失则 skip    |
+| `tab`           | `tab`           | `cleanText`                      |
+| `top`           | `top`           | `toBool`                         |
+| `good`          | `good`          | `toBool`                         |
+| `lock`          | `lock`          | `toBool`                         |
+| (none)          | `status`        | default `published`              |
+| `reply_count`   | `reply_count`   | `Number(… \|\| 0)`               |
+| `visit_count`   | `visit_count`   | `Number(… \|\| 0)`               |
+| `collect_count` | `collect_count` | `Number(… \|\| 0)`               |
+| `last_reply`    | `last_reply_id` | `mapId(replyMap)`                |
+| `last_reply_at` | `last_reply_at` | `toDate`                         |
+| (none)          | `archived`      | `toBool`                         |
+| `deleted`       | `deleted`       | `toBool`                         |
+| `create_at`     | `create_at`     | `toDate`, fallback `new Date(0)` |
+| `update_at`     | `update_at`     | `toDate`, fallback chain         |
 
 `content_is_html` 字段不迁移——cnode-next 统一用 `mdrender` 参数控制渲染。
 
 ### replies + reply_ups
 
-| Mongo field | PG column | Transform |
-| ----------- | --------- | --------- |
-| `_id` | `id` | map |
-| `content` | `content` | `cleanText` |
-| `topic_id` | `topic_id` | `mapId(topicMap)`，缺失则 skip |
-| `author_id` | `author_id` | `mapId(userMap)`，缺失则 skip |
-| `reply_id` | `reply_id` | `mapId(replyMap)` |
-| `deleted` | `deleted` | `toBool` |
-| `create_at` | `create_at` | `toDate`, fallback `new Date(0)` |
-| `update_at` | `update_at` | `toDate`, fallback chain |
-| `ups[]` | `reply_ups` rows | 每个 ObjectId → `(reply_id, user_id)`，`on conflict do nothing` |
+| Mongo field | PG column        | Transform                                                       |
+| ----------- | ---------------- | --------------------------------------------------------------- |
+| `_id`       | `id`             | map                                                             |
+| `content`   | `content`        | `cleanText`                                                     |
+| `topic_id`  | `topic_id`       | `mapId(topicMap)`，缺失则 skip                                  |
+| `author_id` | `author_id`      | `mapId(userMap)`，缺失则 skip                                   |
+| `reply_id`  | `reply_id`       | `mapId(replyMap)`                                               |
+| `deleted`   | `deleted`        | `toBool`                                                        |
+| `create_at` | `create_at`      | `toDate`, fallback `new Date(0)`                                |
+| `update_at` | `update_at`      | `toDate`, fallback chain                                        |
+| `ups[]`     | `reply_ups` rows | 每个 ObjectId → `(reply_id, user_id)`，`on conflict do nothing` |
 
 `content_is_html` 不迁移。
 
 ### messages
 
-| Mongo field | PG column | Transform |
-| ----------- | --------- | --------- |
-| `_id` | `id` | map |
-| `type` | `type` | `cleanText` |
-| `master_id` | `master_id` | `mapId(userMap)`，缺失则 skip |
-| `author_id` | `author_id` | `mapId(userMap)`，缺失则 skip |
-| `topic_id` | `topic_id` | `mapId(topicMap)` |
-| `reply_id` | `reply_id` | `mapId(replyMap)` |
-| `has_read` | `has_read` | `toBool` |
+| Mongo field | PG column   | Transform                        |
+| ----------- | ----------- | -------------------------------- |
+| `_id`       | `id`        | map                              |
+| `type`      | `type`      | `cleanText`                      |
+| `master_id` | `master_id` | `mapId(userMap)`，缺失则 skip    |
+| `author_id` | `author_id` | `mapId(userMap)`，缺失则 skip    |
+| `topic_id`  | `topic_id`  | `mapId(topicMap)`                |
+| `reply_id`  | `reply_id`  | `mapId(replyMap)`                |
+| `has_read`  | `has_read`  | `toBool`                         |
 | `create_at` | `create_at` | `toDate`, fallback `new Date(0)` |
 
 ### topic_collects
 
-| Mongo field | PG column | Transform |
-| ----------- | --------- | --------- |
-| `user_id` | `user_id` | `mapId(userMap)`，缺失则 skip |
-| `topic_id` | `topic_id` | `mapId(topicMap)`，缺失则 skip |
+| Mongo field | PG column   | Transform                        |
+| ----------- | ----------- | -------------------------------- |
+| `user_id`   | `user_id`   | `mapId(userMap)`，缺失则 skip    |
+| `topic_id`  | `topic_id`  | `mapId(topicMap)`，缺失则 skip   |
 | `create_at` | `create_at` | `toDate`, fallback `new Date(0)` |
 
 Collection name 自动探测：`firstCollectionName(["topiccollects", "topic_collects"])`。
 
 ## Skip Logic
 
-| Skip key | Condition | Effect |
-| -------- | --------- | ------ |
-| `topicsMissingAuthor` | `author_id` 在 userMap 中找不到 | 跳过该 topic |
-| `repliesMissingTopic` | `topic_id` 找不到 | 跳过 reply + 其所有 ups |
-| `repliesMissingAuthor` | `author_id` 找不到 | 跳过 reply + 其所有 ups |
-| `messagesMissingMaster` | `master_id` 找不到 | 跳过 message |
-| `messagesMissingAuthor` | `author_id` 找不到 | 跳过 message |
-| `replyUpsMissingUser` | `ups[]` 中的 user 找不到 | 跳过该 up，保留 reply |
-| `topicCollectsMissingUser` | `user_id` 找不到 | 跳过 collect |
-| `topicCollectsMissingTopic` | `topic_id` 找不到 | 跳过 collect |
+| Skip key                    | Condition                       | Effect                  |
+| --------------------------- | ------------------------------- | ----------------------- |
+| `topicsMissingAuthor`       | `author_id` 在 userMap 中找不到 | 跳过该 topic            |
+| `repliesMissingTopic`       | `topic_id` 找不到               | 跳过 reply + 其所有 ups |
+| `repliesMissingAuthor`      | `author_id` 找不到              | 跳过 reply + 其所有 ups |
+| `messagesMissingMaster`     | `master_id` 找不到              | 跳过 message            |
+| `messagesMissingAuthor`     | `author_id` 找不到              | 跳过 message            |
+| `replyUpsMissingUser`       | `ups[]` 中的 user 找不到        | 跳过该 up，保留 reply   |
+| `topicCollectsMissingUser`  | `user_id` 找不到                | 跳过 collect            |
+| `topicCollectsMissingTopic` | `topic_id` 找不到               | 跳过 collect            |
 
 每个 skip 记录 count 和最多 20 个 sample ObjectId。
 
@@ -188,14 +188,14 @@ Report 写入 `MIGRATION_REPORT_PATH`（默认 `/app/migration-report.json`）
 
 ## Transform Functions
 
-| Function | Behavior |
-| -------- | -------- |
-| `toDate(value)` | Date passthrough, `new Date(string)` fallback, NaN → null |
-| `toBool(value)` | `true \|\| 1 \|\| "1"` → true, else false |
-| `cleanText(value, fallback)` | `String(value ?? fallback)`, 移除 `\0` |
-| `oid(value)` | ObjectId → hex string, else `String(value)` |
-| `mapId(map, value)` | oid → lookup in map → integer or null |
-| `uniqueValue(value, seen, suffix)` | dedupe with `__legacy_{suffix}` suffix |
+| Function                           | Behavior                                                  |
+| ---------------------------------- | --------------------------------------------------------- |
+| `toDate(value)`                    | Date passthrough, `new Date(string)` fallback, NaN → null |
+| `toBool(value)`                    | `true \|\| 1 \|\| "1"` → true, else false                 |
+| `cleanText(value, fallback)`       | `String(value ?? fallback)`, 移除 `\0`                    |
+| `oid(value)`                       | ObjectId → hex string, else `String(value)`               |
+| `mapId(map, value)`                | oid → lookup in map → integer or null                     |
+| `uniqueValue(value, seen, suffix)` | dedupe with `__legacy_{suffix}` suffix                    |
 
 ## Inferences