@nextclaw/ui 0.15.4 → 0.15.6

package/src/features/settings/utils/__tests__/provider-form-support.utils.test.ts

@@ -22,10 +22,9 @@ describe('provider form model defaults', () => {
   });
 
   it('serializes local model ids with the providerId prefix', () => {
-    expect(serializeModelsForSave(['gpt-5.5', 'openai-work/gpt-5.4'], 'openai-work')).toEqual([
-      'openai-work/gpt-5.5',
-      'openai-work/gpt-5.4'
-    ]);
+    expect(
+      serializeModelsForSave(['gpt-5.5', 'openai-work/gpt-5.4', 'bedrock/claude-fable-5'], 'openai-work')
+    ).toEqual(['openai-work/gpt-5.5', 'openai-work/gpt-5.4', 'openai-work/bedrock/claude-fable-5']);
   });
 
   it('builds a minimal save payload from changed provider fields', () => {
@@ -57,15 +56,14 @@ describe('provider form model defaults', () => {
     });
   });
 
-  it('adds local model drafts without accepting provider prefixes', () => {
+  it('adds provider-local model ids with nested namespace segments', () => {
     expect(addProviderLocalModel([], ' gpt-5.5 ', ['openai-work'])).toEqual({
       models: ['gpt-5.5'],
       draft: ''
     });
-    expect(addProviderLocalModel([], ' other/gpt-5.5 ', ['openai-work'])).toEqual({
-      models: [],
-      draft: ' other/gpt-5.5 ',
-      errorKey: 'providerModelInvalidProviderPrefix'
+    expect(addProviderLocalModel([], ' bedrock/claude-fable-5 ', ['openrouter'])).toEqual({
+      models: ['bedrock/claude-fable-5'],
+      draft: ''
     });
   });
 

package/src/features/settings/utils/provider-form-model.utils.ts

@@ -8,7 +8,6 @@ import {
 type AddProviderModelResult = {
   models: string[];
   draft: string;
-  errorKey?: 'providerModelInvalidProviderPrefix';
 };
 
 export function addProviderLocalModel(models: string[], draft: string, aliases: string[]): AddProviderModelResult {
@@ -16,9 +15,6 @@ export function addProviderLocalModel(models: string[], draft: string, aliases:
   if (!next) {
     return { models, draft };
   }
-  if (next.includes('/')) {
-    return { models, draft, errorKey: 'providerModelInvalidProviderPrefix' };
-  }
   if (models.includes(next)) {
     return { models, draft: '' };
   }

package/src/features/system-status/hooks/use-current-version-release-notes-link.ts

@@ -0,0 +1,33 @@
+import { useQuery } from '@tanstack/react-query';
+import { getLanguage } from '@/shared/lib/i18n';
+import {
+  fetchReleaseNotesData,
+  resolveReleaseNotesHtmlUrl,
+  resolveVersionReleaseNotesDataUrl,
+  type ReleaseNotesLink,
+  type ReleaseNotesLocale
+} from '@/features/system-status/utils/update-release-notes.utils';
+
+function getReleaseNotesLocale(): ReleaseNotesLocale {
+  return getLanguage() === 'zh' ? 'zh-CN' : 'en-US';
+}
+
+export function useCurrentVersionReleaseNotesLink(productVersion: string | undefined): ReleaseNotesLink | null {
+  const dataUrl = resolveVersionReleaseNotesDataUrl(productVersion);
+  const locale = getReleaseNotesLocale();
+  const releaseNotesQuery = useQuery({
+    queryKey: ['current-release-notes', dataUrl],
+    queryFn: async () => await fetchReleaseNotesData(dataUrl ?? ''),
+    enabled: Boolean(dataUrl),
+    retry: false,
+    staleTime: 5 * 60 * 1000
+  });
+  const url = resolveReleaseNotesHtmlUrl(releaseNotesQuery.data, locale);
+  const version = productVersion?.trim();
+  return url && version
+    ? {
+        url,
+        versionLabel: `v${version}`
+      }
+    : null;
+}

package/src/features/system-status/index.ts

@@ -2,7 +2,16 @@ export { useRuntimeControlPanelView, useRuntimeStatusBadgeView, useSystemStatus,
 export { systemStatusManager } from './managers/system-status.manager';
 export { isTransientRuntimeConnectionErrorMessage } from '@/shared/lib/transport';
 export { runtimeUpdateManager } from './managers/runtime-update.manager';
+export { useCurrentVersionReleaseNotesLink } from './hooks/use-current-version-release-notes-link';
+export {
+  fetchReleaseNotesData,
+  resolveReleaseNotesHtmlUrl,
+  resolveUpdateReleaseNotesLink,
+  resolveVersionReleaseNotesDataUrl,
+} from './utils/update-release-notes.utils';
 export type { SystemStatusState, SystemStatusView } from './types/system-status.types';
 export { useSystemStatusStore } from './stores/system-status.store';
 export { useRuntimeUpdateStore } from './stores/runtime-update.store';
+export type { RuntimeUpdateBusyAction } from './stores/runtime-update.store';
+export type { ReleaseNotesLink, ReleaseNotesLocale } from './utils/update-release-notes.utils';
 export { SecurityConfig } from './components/security-config';

package/src/features/system-status/utils/update-release-notes.utils.ts

@@ -4,11 +4,20 @@ export type ReleaseNotesLocale = 'zh-CN' | 'en-US';
 
 export type ReleaseNotesText = Partial<Record<ReleaseNotesLocale, string>>;
 
+export type ReleaseNotesLink = {
+  url: string;
+  versionLabel: string;
+};
+
 export type ReleaseNotesItem = {
   title: ReleaseNotesText;
   body?: ReleaseNotesText;
 };
 
+export type ReleaseNotesLinks = {
+  html?: ReleaseNotesText;
+};
+
 export type ReleaseNotesSection = {
   kind: string;
   title?: ReleaseNotesText;
@@ -18,9 +27,12 @@ export type ReleaseNotesSection = {
 export type ReleaseNotesPayload = {
   title?: ReleaseNotesText;
   summary?: ReleaseNotesText;
+  links?: ReleaseNotesLinks;
   sections: ReleaseNotesSection[];
 };
 
+const DEFAULT_RELEASE_NOTES_BASE_URL = 'https://docs.nextclaw.io/';
+
 export function readReleaseNotesText(
   value: ReleaseNotesText | undefined,
   locale: ReleaseNotesLocale
@@ -33,17 +45,40 @@ export function readReleaseNotesText(
 export function resolveReleaseNotesDataUrl(snapshot: UpdateSnapshot): string | null {
   const releaseNotesUrl = snapshot.releaseNotesUrl?.trim();
   const version = (snapshot.availableVersion ?? snapshot.downloadedVersion)?.trim();
-  if (!releaseNotesUrl || !version || !/^[0-9A-Za-z.-]+$/.test(version)) {
+  if (!releaseNotesUrl) {
     return null;
   }
+  return resolveVersionReleaseNotesDataUrl(version, releaseNotesUrl);
+}
 
+export function resolveVersionReleaseNotesDataUrl(version: string | null | undefined, baseUrl = DEFAULT_RELEASE_NOTES_BASE_URL): string | null {
+  const normalizedVersion = version?.trim();
+  if (!normalizedVersion || !/^[0-9A-Za-z.-]+$/.test(normalizedVersion)) {
+    return null;
+  }
   try {
-    return new URL(`/release-notes/nextclaw-v${version}.json`, releaseNotesUrl).toString();
+    return new URL(`/release-notes/nextclaw-v${normalizedVersion}.json`, baseUrl).toString();
   } catch {
     return null;
   }
 }
 
+export function resolveReleaseNotesHtmlUrl(payload: ReleaseNotesPayload | undefined, locale: ReleaseNotesLocale): string | null {
+  return readReleaseNotesText(payload?.links?.html, locale);
+}
+
+export function resolveUpdateReleaseNotesLink(snapshot: UpdateSnapshot): ReleaseNotesLink | null {
+  const url = snapshot.releaseNotesUrl?.trim();
+  const version = (snapshot.downloadedVersion ?? snapshot.availableVersion)?.trim();
+  if (!url || !version) {
+    return null;
+  }
+  return {
+    url,
+    versionLabel: `v${version}`
+  };
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
@@ -70,12 +105,18 @@ function isReleaseNotesSection(value: unknown): value is ReleaseNotesSection {
     && (value.title === undefined || isReleaseNotesText(value.title));
 }
 
+function isReleaseNotesLinks(value: unknown): value is ReleaseNotesLinks {
+  return isRecord(value)
+    && (value.html === undefined || isReleaseNotesText(value.html));
+}
+
 function isReleaseNotesPayload(value: unknown): value is ReleaseNotesPayload {
   return isRecord(value)
     && Array.isArray(value.sections)
     && value.sections.every(isReleaseNotesSection)
     && (value.title === undefined || isReleaseNotesText(value.title))
-    && (value.summary === undefined || isReleaseNotesText(value.summary));
+    && (value.summary === undefined || isReleaseNotesText(value.summary))
+    && (value.links === undefined || isReleaseNotesLinks(value.links));
 }
 
 export async function fetchReleaseNotesData(url: string): Promise<ReleaseNotesPayload> {

package/src/index.css

@@ -719,8 +719,9 @@
   --md-table-head-bg: hsl(var(--muted) / 0.84);
 }
 
+/* The root flow owns external spacing; individual blocks only own their surface. */
 .chat-markdown > * + * {
-  margin-top: 0.72rem;
+  margin-block-start: 0.75rem;
 }
 
 .chat-markdown p,
@@ -729,21 +730,19 @@
   color: var(--md-text);
 }
 
-.chat-markdown h1,
-.chat-markdown h2,
-.chat-markdown h3,
-.chat-markdown h4,
-.chat-markdown h5,
-.chat-markdown h6 {
-  margin: 0.2rem 0 0;
-  padding-bottom: 0.5em;
+.chat-markdown :is(h1, h2, h3, h4, h5, h6) {
+  margin: 0;
   font-weight: 700;
   line-height: 1.35;
   letter-spacing: -0.01em;
 }
 
-.chat-markdown :is(h1, h2, h3, h4, h5, h6) + * {
-  margin-top: 0;
+.chat-markdown > :is(h1, h2, h3, h4, h5, h6):not(:first-child) {
+  margin-block-start: 1.25rem;
+}
+
+.chat-markdown > :is(h1, h2, h3, h4, h5, h6) + * {
+  margin-block-start: 0.5rem;
 }
 
 .chat-markdown h1 {
@@ -766,7 +765,6 @@
 
 .chat-markdown ul,
 .chat-markdown ol {
-  margin: 0.35rem 0;
   padding-left: 1.5rem;
   list-style-position: outside;
 }
@@ -839,7 +837,6 @@
 .chat-markdown hr {
   border: 0;
   border-top: 1px solid var(--md-border);
-  margin: 0.92rem 0;
 }
 
 .chat-markdown a {
@@ -874,7 +871,6 @@
 }
 
 .chat-codeblock {
-  margin: 0.2rem 0 0.1rem;
   border: 1px solid var(--md-code-toolbar-border);
   border-radius: 0.5rem;
   overflow: hidden;
@@ -1299,7 +1295,6 @@
 }
 
 .chat-table-wrap {
-  margin: 0.15rem 0;
   border: 1px solid var(--md-border);
   border-radius: 0.72rem;
   overflow-x: auto;
@@ -1378,7 +1373,6 @@
 }
 
 .chat-markdown blockquote {
-  margin: 0.2rem 0;
   border-left: 3px solid var(--md-blockquote-border);
   border-radius: 0 0.55rem 0.55rem 0;
   padding: 0.45rem 0.72rem;

package/src/shared/components/common/__tests__/brand-header.test.tsx

@@ -10,7 +10,9 @@ import { setLanguage } from '@/shared/lib/i18n';
 
 const mocks = vi.hoisted(() => ({
   applyDownloadedUpdate: vi.fn(),
-  downloadUpdate: vi.fn()
+  downloadUpdate: vi.fn(),
+  fetchReleaseNotes: vi.fn(),
+  openExternalUrl: vi.fn()
 }));
 
 vi.mock('@/features/system-status', async () => {
@@ -25,7 +27,30 @@ vi.mock('@/features/system-status', async () => {
   };
 });
 
-function renderBrandHeader() {
+vi.mock('@/shared/lib/host-capabilities', () => ({
+  hostCapabilityManager: {
+    openExternalUrl: mocks.openExternalUrl,
+  },
+}));
+
+function createReleaseNotesResponse(urls?: { zh?: string; en?: string }): Response {
+  return new Response(JSON.stringify({
+    links: urls
+      ? {
+          html: {
+            ...(urls.zh ? { 'zh-CN': urls.zh } : {}),
+            ...(urls.en ? { 'en-US': urls.en } : {})
+          }
+        }
+      : undefined,
+    sections: []
+  }), {
+    headers: { 'content-type': 'application/json' },
+    status: 200
+  });
+}
+
+function renderBrandHeader(options: { productVersion?: string } = {}) {
   const queryClient = new QueryClient({
     defaultOptions: {
       queries: {
@@ -35,7 +60,7 @@ function renderBrandHeader() {
   });
   queryClient.setQueryData(['app-meta'], {
     name: 'NextClaw',
-    productVersion: '0.18.11'
+    productVersion: options.productVersion ?? '0.18.11'
   });
   return render(
     <QueryClientProvider client={queryClient}>
@@ -57,6 +82,10 @@ describe('BrandHeader', () => {
     });
     mocks.applyDownloadedUpdate.mockReset();
     mocks.downloadUpdate.mockReset();
+    mocks.fetchReleaseNotes.mockReset();
+    mocks.fetchReleaseNotes.mockResolvedValue(createReleaseNotesResponse());
+    mocks.openExternalUrl.mockReset();
+    vi.stubGlobal('fetch', mocks.fetchReleaseNotes);
   });
 
   it('shows update progress next to the product version', async () => {
@@ -100,11 +129,89 @@ describe('BrandHeader', () => {
     expect(version).toBeTruthy();
     expect(screen.getAllByText('v0.18.11')).toHaveLength(1);
     await user.hover(version);
-    expect(await screen.findAllByText('v0.18.11')).toHaveLength(2);
+    expect((await screen.findByRole('tooltip')).textContent).toBe('v0.18.11');
     expect(screen.getByText('下载 50%')).toBeTruthy();
     expect(screen.queryByRole('button', { name: '更新' })).toBeNull();
   });
 
+  it('opens release notes from the current version tooltip when that version has docs notes', async () => {
+    const user = userEvent.setup();
+    mocks.fetchReleaseNotes.mockResolvedValueOnce(createReleaseNotesResponse({
+      zh: 'https://docs.nextclaw.io/zh/notes/2026-07-15-nextclaw-v0-23-0',
+      en: 'https://docs.nextclaw.io/en/notes/2026-07-15-nextclaw-v0-23-0'
+    }));
+
+    renderBrandHeader({ productVersion: '0.23.0' });
+
+    const version = await screen.findByRole('button', {
+      name: '当前版本 v0.23.0，查看 v0.23.0 更新说明'
+    });
+
+    await user.hover(version);
+    expect((await screen.findByRole('tooltip')).textContent).toContain('点击查看 v0.23.0 更新说明');
+
+    await user.click(version);
+
+    expect(mocks.fetchReleaseNotes).toHaveBeenCalledWith(
+      'https://docs.nextclaw.io/release-notes/nextclaw-v0.23.0.json',
+      expect.objectContaining({ cache: 'no-store' })
+    );
+    expect(mocks.openExternalUrl).toHaveBeenCalledWith('https://docs.nextclaw.io/zh/notes/2026-07-15-nextclaw-v0-23-0');
+  });
+
+  it('keeps update target release notes available without replacing the current version link', async () => {
+    const user = userEvent.setup();
+    mocks.fetchReleaseNotes.mockResolvedValueOnce(createReleaseNotesResponse({
+      zh: 'https://docs.nextclaw.io/zh/notes/2026-07-14-nextclaw-v0-18-11'
+    }));
+    useRuntimeUpdateStore.setState({
+      supported: true,
+      initialized: true,
+      busyAction: null,
+      snapshot: {
+        status: 'update-available',
+        installationKind: 'npm-runtime-bundle',
+        channel: 'stable',
+        hostVersion: '0.18.11',
+        currentVersion: '0.18.11',
+        availableVersion: '0.18.12',
+        downloadedVersion: null,
+        minimumHostVersion: null,
+        releaseNotesUrl: 'https://docs.nextclaw.io/zh/notes/2026-07-15-nextclaw-v0-18-12',
+        lastCheckedAt: null,
+        progress: null,
+        canAutoDownload: true,
+        canApplyInApp: false,
+        requiresRestart: false,
+        blockReason: null,
+        recoveryCommand: null,
+        errorMessage: null,
+        preferences: {
+          automaticChecks: true,
+          autoDownload: true
+        }
+      }
+    });
+
+    renderBrandHeader();
+
+    const currentVersion = await screen.findByRole('button', {
+      name: '当前版本 v0.18.11，查看 v0.18.11 更新说明'
+    });
+    await user.click(currentVersion);
+    expect(mocks.openExternalUrl).toHaveBeenCalledWith('https://docs.nextclaw.io/zh/notes/2026-07-14-nextclaw-v0-18-11');
+
+    await user.click(screen.getByRole('button', { name: '下载' }));
+    expect(mocks.downloadUpdate).toHaveBeenCalledTimes(1);
+
+    const updateReleaseNotes = screen.getByRole('button', { name: '查看 v0.18.12 更新说明' });
+    await user.hover(updateReleaseNotes);
+    expect((await screen.findByRole('tooltip')).textContent).toBe('查看 v0.18.12 更新说明');
+
+    await user.click(updateReleaseNotes);
+    expect(mocks.openExternalUrl).toHaveBeenCalledWith('https://docs.nextclaw.io/zh/notes/2026-07-15-nextclaw-v0-18-12');
+  });
+
   it('applies the downloaded update from the version-adjacent update button', async () => {
     const user = userEvent.setup();
     useRuntimeUpdateStore.setState({
@@ -145,6 +252,7 @@ describe('BrandHeader', () => {
   });
 
   it('shows a warning icon with the blocked update reason instead of a visible failure label', async () => {
+    const user = userEvent.setup();
     useRuntimeUpdateStore.setState({
       supported: true,
       initialized: true,
@@ -180,13 +288,19 @@ describe('BrandHeader', () => {
     const issueIcon = screen.getByLabelText('更新被阻塞');
 
     expect(issueIcon.textContent).toBe('!');
-    expect(issueIcon.getAttribute('title')).toContain('更新被阻塞');
-    expect(issueIcon.getAttribute('title')).toContain('根因：缺少更新签名公钥，无法验证更新包来源');
-    expect(issueIcon.getAttribute('title')).toContain('Runtime bundle updates require a configured update public key.');
-    expect(issueIcon.getAttribute('title')).toContain('Set NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY');
+    expect(issueIcon.hasAttribute('title')).toBe(false);
+
+    await user.hover(issueIcon);
+
+    const tooltip = await screen.findByRole('tooltip');
+    expect(tooltip.textContent).toContain('更新被阻塞');
+    expect(tooltip.textContent).toContain('根因：缺少更新签名公钥，无法验证更新包来源');
+    expect(tooltip.textContent).toContain('Runtime bundle updates require a configured update public key.');
+    expect(tooltip.textContent).toContain('Set NEXTCLAW_UPDATE_BUNDLE_PUBLIC_KEY');
   });
 
   it('uses the failed update wording only for failed snapshots', async () => {
+    const user = userEvent.setup();
     useRuntimeUpdateStore.setState({
       supported: true,
       initialized: true,
@@ -221,8 +335,11 @@ describe('BrandHeader', () => {
     const issueIcon = screen.getByLabelText('更新失败');
 
     expect(issueIcon.textContent).toBe('!');
-    expect(issueIcon.getAttribute('title')).toContain('更新失败');
-    expect(issueIcon.getAttribute('title')).toContain('runtime bundle sha256 mismatch');
+    await user.hover(issueIcon);
+
+    const tooltip = await screen.findByRole('tooltip');
+    expect(tooltip.textContent).toContain('更新失败');
+    expect(tooltip.textContent).toContain('runtime bundle sha256 mismatch');
     expect(screen.queryByText('更新被阻塞')).toBeNull();
   });
 });