dsh-plugin-effort-declare 0.1.0

package/lib/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * dsh-plugin-effort-declare — host half.
+ * v1 contributes no host services, adapters, or events. The cordis row still
+ * has to exist so a later `dsh plugin add` can load the bundle.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "dsh-plugin-effort-declare";
+/** Host apply is intentionally empty in v1. */
+export declare function apply(_ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAE/C,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAG"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "dsh-plugin-effort-declare",
+  "description": "Settings page to declare per-model reasoningEfforts and openai-completions compat on hand-declared llm-pi-ai routes. Writes the official namespace; does not intercept llm/stream or replace the Models page.",
+  "version": "0.1.0",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zimodzh/dsh-plugin-effort-declare.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zimodzh/dsh-plugin-effort-declare/issues"
+  },
+  "homepage": "https://github.com/zimodzh/dsh-plugin-effort-declare#readme",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "lightningcss": "^1.32.0",
+    "react": "^18.3.1",
+    "tsdown": "0.22.2",
+    "typescript": "~5.7.2",
+    "vitest": "^4.1.8"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/*.js.map",
+    "lib/types/**/*.d.ts",
+    "lib/types/**/*.d.ts.map",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "INSTALL.md",
+    "INSTALL.en.md",
+    "CONTRIBUTING.md",
+    "CONTRIBUTING.en.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b && tsdown",
+    "watch": "tsdown --watch",
+    "test": "vitest run",
+    "typecheck": "tsc -b --pretty false"
+  }
+}

package/src/README.en.md

@@ -0,0 +1,23 @@
+# src/
+
+<p align="center">
+  <samp>
+    <a href="./README.md">中文</a> ·
+    <strong>English</strong>
+  </samp>
+</p>
+
+TypeScript sources for the plugin. The host (Node) and the browser must be separate TypeScript programs: their `Context` merges cannot share one `ts.Program`.
+
+Install: [INSTALL.en.md](../INSTALL.en.md). Usage: root [README.en.md](../README.en.md). Contributing: [CONTRIBUTING.en.md](../CONTRIBUTING.en.md).
+
+## What's in this directory
+
+| Path | Role |
+| --- | --- |
+| [`index.ts`](./index.ts) | Host entry. Exports `name` and `apply`. v1 registers no host services or adapters; the bundle still needs this entry so `dsh plugin add` can load the package. |
+| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
+| [`client/`](./client/) | Browser half: locale, settings page, `settings.mutate` against `llm-pi-ai`. |
+| [`css-modules.d.ts`](./css-modules.d.ts) | Types for `*.module.css` (class map plus `cssText` / `cssTagId`). |
+
+`tsconfig.host.json` compiles host + `core`; `tsconfig.client.json` compiles `client` + `core`. Build output lives in [`lib/`](../lib/).

package/src/README.md

@@ -0,0 +1,23 @@
+# src/
+
+<p align="center">
+  <samp>
+    <strong>中文</strong> ·
+    <a href="./README.en.md">English</a>
+  </samp>
+</p>
+
+插件 TypeScript 源码。Host（Node）与浏览器必须分成两个 TypeScript Program：两边对 `Context` 的 merge 不能共处同一份 `ts.Program`。
+
+安装见 [INSTALL.md](../INSTALL.md)，使用见仓库根 [README.md](../README.md)，贡献见 [CONTRIBUTING.md](../CONTRIBUTING.md)。
+
+## 这个目录里有什么
+
+| 路径 | 说明 |
+| --- | --- |
+| [`index.ts`](./index.ts) | Host 入口。导出 `name` 与 `apply`。v1 不注册 host 服务、不挂适配器；组合包仍需要这一入口才能被 `dsh plugin add` 加载。 |
+| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
+| [`client/`](./client/) | 浏览器半区：locale、设置页、对 `llm-pi-ai` 的 `settings.mutate`。 |
+| [`css-modules.d.ts`](./css-modules.d.ts) | `*.module.css` 模块类型（class map + `cssText` / `cssTagId`）。 |
+
+`tsconfig.host.json` 编译 host + `core`；`tsconfig.client.json` 编译 `client` + `core`。构建产物在 [`lib/`](../lib/)。

package/src/client/EffortDeclareSection.tsx

@@ -0,0 +1,496 @@
+/**
+ * Settings section: per-model reasoningEfforts + openai-completions compat
+ * for hand-declared llm-pi-ai routes.
+ */
+import { useCallback, useEffect, useRef, useState, type ReactNode } from 'react'
+import type { IApiClient } from '@deepseek-ai/dsh-api-remotes/client'
+import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client'
+import { LLM_PI_AI_NS, THINKING_LEVELS_WITHOUT_OFF } from '../core/catalog.ts'
+import {
+  alignDraft,
+  applySaveSuccess,
+  draftDirty,
+  generationIsCurrent,
+  mergeLoadedDrafts,
+  nextGeneration,
+  thinkingFormatChoices,
+  type RouteDraft,
+} from '../core/drafts.ts'
+import {
+  hasLevel,
+  readEfforts,
+  readOff,
+  setWireSpelling,
+  toggleLevel,
+  writeEfforts,
+  writeOff,
+  clearReasoningEfforts,
+} from '../core/efforts.ts'
+import { applyPresetCompat, applyPresetEfforts, PRESETS, type PresetId } from '../core/presets.ts'
+import { buildSaveOps } from '../core/path-ops.ts'
+import { cloneModels, cloneObject } from '../core/paths.ts'
+import { modelEffortError } from '../core/validate.ts'
+import { loadDrafts } from './load-drafts.ts'
+import type { SchemaOps } from './schema-ops.ts'
+import type { EffortDeclareKey } from './locales.ts'
+import css from './effort-declare.module.css'
+
+export type InvalidationSource = 'settings' | 'directory'
+
+export interface EffortDeclareSectionInjected {
+  api: Pick<IApiClient, 'settings' | 'llm'>
+  describe: SettingsDescribeFace
+  schema: SchemaOps
+  t: (key: EffortDeclareKey) => string
+  subscribeInvalidate: (listener: (source: InvalidationSource) => void) => () => void
+}
+
+export interface EffortDeclareSectionProps extends Partial<EffortDeclareSectionInjected> {
+  t: (key: EffortDeclareKey) => string
+  close: () => void
+}
+
+export { loadDrafts } from './load-drafts.ts'
+
+type CardNotice = { kind: 'saved' | 'conflict' | 'error'; text: string }
+
+function compatSummary(compat: Record<string, unknown>): string {
+  const parts: string[] = []
+  if (typeof compat.thinkingFormat === 'string') parts.push(`thinkingFormat=${compat.thinkingFormat}`)
+  if (compat.supportsDeveloperRole === false) parts.push('supportsDeveloperRole=false')
+  if (compat.supportsReasoningEffort === false) parts.push('supportsReasoningEffort=false')
+  return parts.join(' · ')
+}
+
+function errorText(code: ReturnType<typeof modelEffortError>, t: (key: EffortDeclareKey) => string): string | undefined {
+  if (code === 'empty') return t('errorEmpty')
+  if (code === 'off-only') return t('errorOffOnly')
+  if (code === 'bad-wire') return t('errorBadWire')
+  return undefined
+}
+
+function ModelRowEditor(props: {
+  row: Record<string, unknown>
+  index: number
+  radioName: string
+  disabled: boolean
+  t: (key: EffortDeclareKey) => string
+  onChange: (row: Record<string, unknown>) => void
+}): ReactNode {
+  const { row, disabled, t, onChange } = props
+  const efforts = readEfforts(row) ?? {}
+  const off = readOff(readEfforts(row))
+  const id = typeof row.id === 'string' ? row.id : ''
+  const name = typeof row.name === 'string' ? row.name : ''
+
+  const patchEfforts = (next: typeof efforts): void => {
+    onChange(writeEfforts(row, Object.keys(next).length === 0 ? undefined : next))
+  }
+
+  return (
+    <div className={css.modelEntry}>
+      <div className={css.modelHead}>
+        <span className={css.modelId}>{id || t('model')}</span>
+        {name !== '' && name !== id ? <span className={css.modelName}>{name}</span> : null}
+        <button
+          type="button"
+          className={css.linkButton}
+          disabled={disabled || !('reasoningEfforts' in row)}
+          onClick={() => { onChange(clearReasoningEfforts(row)) }}
+        >
+          {t('clear')}
+        </button>
+      </div>
+      <span className={css.fieldLabel}>{t('levels')}</span>
+      <div className={css.levels}>
+        {THINKING_LEVELS_WITHOUT_OFF.map((level) => (
+          <label key={level} className={css.level}>
+            <input
+              type="checkbox"
+              checked={hasLevel(efforts, level)}
+              disabled={disabled}
+              onChange={(event) => { patchEfforts(toggleLevel(efforts, level, event.target.checked)) }}
+            />
+            {level}
+          </label>
+        ))}
+      </div>
+      <div className={css.wireRow}>
+        <span className={css.fieldLabel}>{t('wire')}</span>
+        {THINKING_LEVELS_WITHOUT_OFF.filter(level => hasLevel(efforts, level)).map((level) => (
+          <label key={level} className={css.level}>
+            {level}
+            <input
+              className={`${css.input} ${css.wireInput}`}
+              type="text"
+              value={efforts[level] ?? level}
+              disabled={disabled}
+              aria-label={`${t('wire')} ${level}`}
+              onChange={(event) => { patchEfforts(setWireSpelling(efforts, level, event.target.value)) }}
+            />
+          </label>
+        ))}
+      </div>
+      <div className={css.offGroup}>
+        <span className={css.fieldLabel}>{t('offMode')}</span>
+        {(['absent', 'empty', 'value'] as const).map((mode) => (
+          <label key={mode} className={css.level}>
+            <input
+              type="radio"
+              name={props.radioName}
+              checked={off.mode === mode}
+              disabled={disabled}
+              onChange={() => { patchEfforts(writeOff(efforts, mode, off.value)) }}
+            />
+            {mode === 'absent' ? t('offAbsent') : mode === 'empty' ? t('offEmpty') : t('offValue')}
+          </label>
+        ))}
+        {off.mode === 'value'
+          ? (
+            <input
+              className={`${css.input} ${css.wireInput}`}
+              type="text"
+              value={off.value}
+              placeholder={t('offValuePlaceholder')}
+              disabled={disabled}
+              onChange={(event) => { patchEfforts(writeOff(efforts, 'value', event.target.value)) }}
+            />
+          )
+          : null}
+      </div>
+    </div>
+  )
+}
+
+function RouteCard(props: {
+  draft: RouteDraft
+  formats: readonly string[]
+  writable: boolean
+  busy: boolean
+  reloading: boolean
+  notice: CardNotice | undefined
+  t: (key: EffortDeclareKey) => string
+  onChange: (draft: RouteDraft) => void
+  onSave: (draft: RouteDraft) => void
+  onCancel: (draft: RouteDraft) => void
+}): ReactNode {
+  const { draft, writable, busy, reloading, t, onChange } = props
+  const noModels = draft.models.length === 0
+  const editDisabled = !writable || busy || noModels
+  const saveLocked = editDisabled || reloading
+  const formats = thinkingFormatChoices(props.formats, draft.compat.thinkingFormat)
+  const summary = compatSummary(draft.compat)
+  const sameWire = draft.compat.supportsReasoningEffort === false
+  const clientError = draft.models
+    .map(row => errorText(modelEffortError(row), t))
+    .find(text => text !== undefined)
+  const dirty = draftDirty(draft)
+
+  const applyPreset = (id: PresetId): void => {
+    const preset = PRESETS[id]
+    onChange({
+      ...draft,
+      models: applyPresetEfforts(draft.models, preset),
+      compat: applyPresetCompat(draft.compat, preset),
+    })
+  }
+
+  return (
+    <li className={css.rowCard}>
+      <div className={css.rowHead}>
+        <span className={css.rowName}>{draft.displayName}</span>
+        <span className={css.rowTag}>{draft.provider}</span>
+      </div>
+      <p className={css.compatSummary}>
+        {t('compatSummary')}
+        {summary === '' ? '' : `: ${summary}`}
+      </p>
+      <div className={css.presetRow}>
+        <span className={css.fieldLabel}>{t('presets')}</span>
+        <button type="button" className={css.secondaryButton} disabled={editDisabled} onClick={() => { applyPreset('deepseek') }}>
+          {t('presetDeepSeek')}
+        </button>
+        <button type="button" className={css.secondaryButton} disabled={editDisabled} onClick={() => { applyPreset('openai') }}>
+          {t('presetOpenAI')}
+        </button>
+        <button type="button" className={css.secondaryButton} disabled={editDisabled} onClick={() => { applyPreset('toggle') }}>
+          {t('presetToggle')}
+        </button>
+      </div>
+      {sameWire ? <p className={css.notice}>{t('presetToggleWarn')}</p> : null}
+      {noModels ? <p className={css.notice}>{t('noModels')}</p> : null}
+      {draft.models.map((row, index) => (
+        <ModelRowEditor
+          key={`${String(row.id)}-${String(index)}`}
+          row={row}
+          index={index}
+          radioName={`off-${draft.provider}-${String(index)}`}
+          disabled={editDisabled}
+          t={t}
+          onChange={(next) => {
+            const models = draft.models.map((candidate, at) => at === index ? next : candidate)
+            onChange({ ...draft, models })
+          }}
+        />
+      ))}
+      <details className={css.advanced}>
+        <summary>{t('advanced')}</summary>
+        <div className={css.advancedBody}>
+          <label className={css.fieldLabel}>
+            {t('thinkingFormat')}
+            <select
+              className={`${css.input} ${css.selectInput}`}
+              value={typeof draft.compat.thinkingFormat === 'string' ? draft.compat.thinkingFormat : ''}
+              disabled={editDisabled}
+              onChange={(event) => {
+                const compat = { ...draft.compat }
+                if (event.target.value === '') delete compat.thinkingFormat
+                else compat.thinkingFormat = event.target.value
+                onChange({ ...draft, compat })
+              }}
+            >
+              <option value="">{t('thinkingFormatDefault')}</option>
+              {formats.map(format => <option key={format} value={format}>{format}</option>)}
+            </select>
+          </label>
+          {draft.compat.supportsDeveloperRole === true
+            ? <p className={css.notice}>{t('developerTrueHint')}</p>
+            : null}
+          <label className={css.check}>
+            <input
+              type="checkbox"
+              checked={draft.compat.supportsDeveloperRole === false}
+              disabled={editDisabled}
+              onChange={(event) => {
+                const compat = { ...draft.compat }
+                if (event.target.checked) compat.supportsDeveloperRole = false
+                else delete compat.supportsDeveloperRole
+                onChange({ ...draft, compat })
+              }}
+            />
+            {t('supportsDeveloperRole')}
+          </label>
+          <label className={css.check}>
+            <input
+              type="checkbox"
+              checked={draft.compat.supportsReasoningEffort === false}
+              disabled={editDisabled}
+              onChange={(event) => {
+                const compat = { ...draft.compat }
+                if (event.target.checked) compat.supportsReasoningEffort = false
+                else delete compat.supportsReasoningEffort
+                onChange({ ...draft, compat })
+              }}
+            />
+            {t('supportsReasoningEffort')}
+          </label>
+        </div>
+      </details>
+      {clientError !== undefined ? <p className={css.error}>{clientError}</p> : null}
+      {props.notice?.kind === 'saved' ? <p className={css.savedNotice}>{props.notice.text}</p> : null}
+      {props.notice?.kind === 'conflict' || props.notice?.kind === 'error'
+        ? <p className={css.error}>{props.notice.text}</p>
+        : null}
+      <div className={css.actions}>
+        <button
+          type="button"
+          className={css.secondaryButton}
+          disabled={busy || !dirty}
+          onClick={() => { props.onCancel(draft) }}
+        >
+          {t('cancel')}
+        </button>
+        <button
+          type="button"
+          className={css.primaryButton}
+          disabled={saveLocked || !dirty || clientError !== undefined}
+          onClick={() => { props.onSave(draft) }}
+        >
+          {busy ? t('saving') : t('save')}
+        </button>
+      </div>
+    </li>
+  )
+}
+
+export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNode {
+  const t = props.t
+  const api = props.api
+  const describe = props.describe
+  const schema = props.schema
+  const [status, setStatus] = useState<'loading' | 'ready' | 'error'>('loading')
+  const [error, setError] = useState('')
+  const [writable, setWritable] = useState(false)
+  const [formats, setFormats] = useState<string[]>([])
+  const [drafts, setDrafts] = useState<RouteDraft[]>([])
+  const [busyRoute, setBusyRoute] = useState<string | null>(null)
+  const [notices, setNotices] = useState<Record<string, CardNotice>>({})
+  const generationRef = useRef(0)
+  const draftsRef = useRef(drafts)
+  draftsRef.current = drafts
+
+  const reload = useCallback((preserveDirty: boolean): void => {
+    if (api === undefined || describe === undefined || schema === undefined) {
+      setStatus('error')
+      setError(t('loadError'))
+      return
+    }
+    const generation = nextGeneration(generationRef)
+    setStatus('loading')
+    setError('')
+    void loadDrafts(api, describe, schema).then((result) => {
+      if (!generationIsCurrent(generationRef, generation)) return
+      setWritable(result.writable)
+      if (result.formats.length > 0) setFormats(result.formats)
+      if (result.error !== undefined) {
+        setStatus('error')
+        setError(result.error)
+        return
+      }
+      const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty })
+      setDrafts(merged.drafts)
+      if (merged.conflicted.length > 0) {
+        setNotices(Object.fromEntries(
+          merged.conflicted.map(provider => [provider, { kind: 'conflict' as const, text: t('dirtyConflict') }]),
+        ))
+      }
+      setStatus('ready')
+    }, (failure: unknown) => {
+      if (!generationIsCurrent(generationRef, generation)) return
+      setStatus('error')
+      setError(failure instanceof Error ? failure.message : t('loadError'))
+    })
+  }, [api, describe, schema, t])
+
+  useEffect(() => { reload(false) }, [reload])
+
+  useEffect(() => {
+    if (props.subscribeInvalidate === undefined) return undefined
+    return props.subscribeInvalidate(() => { reload(true) })
+  }, [props.subscribeInvalidate, reload])
+
+  const save = async (draft: RouteDraft): Promise<void> => {
+    if (api === undefined || describe === undefined) return
+    if (status === 'loading' || busyRoute !== null) return
+    const blocking = draft.models
+      .map(row => errorText(modelEffortError(row), t))
+      .find(text => text !== undefined)
+    if (blocking !== undefined) {
+      setNotices({ [draft.provider]: { kind: 'error', text: blocking } })
+      return
+    }
+    setBusyRoute(draft.provider)
+    setNotices({})
+    try {
+      const ops = buildSaveOps({
+        settingsPath: draft.settingsPath,
+        beforeModels: draft.originalModels,
+        afterModels: draft.models,
+        beforeCompat: draft.compatPresent ? draft.originalCompat : undefined,
+        afterCompat: draft.compat,
+      })
+      if (ops.length === 0) {
+        setDrafts(current => current.map(row => row.provider === draft.provider ? alignDraft(row) : row))
+        return
+      }
+      const response = await api.settings.mutate({
+        ns: LLM_PI_AI_NS,
+        ops,
+        expectedRevision: draft.revision,
+      })
+      if (!response.result.ok) {
+        setNotices({
+          [draft.provider]: {
+            kind: 'error',
+            text: response.result.error.code === 'settings-conflict' ? t('conflict') : response.result.error.message,
+          },
+        })
+        return
+      }
+      const view = response.result.value
+      describe.acceptView(view)
+      setDrafts(current => applySaveSuccess(current, draft.provider, {
+        user: view.user ?? {},
+        revision: view.revision,
+      }))
+      setNotices({ [draft.provider]: { kind: 'saved', text: t('saved') } })
+    } catch (failure) {
+      setNotices({
+        [draft.provider]: {
+          kind: 'error',
+          text: failure instanceof Error ? failure.message : t('loadError'),
+        },
+      })
+    } finally {
+      setBusyRoute(null)
+    }
+  }
+
+  const showLoading = status === 'loading' && drafts.length === 0
+  const showEmpty = status === 'ready' && drafts.length === 0
+  const showList = drafts.length > 0
+
+  return (
+    <div className={css.section}>
+      <h2 className={css.title}>{t('title')}</h2>
+      <p className={css.intro}>{t('intro')}</p>
+      {!writable && status === 'ready' ? <p className={css.notice}>{t('readOnly')}</p> : null}
+      {showLoading ? <p className={css.intro}>{t('loading')}</p> : null}
+      {status === 'error' ? <p className={css.error}>{error}</p> : null}
+      {status === 'error'
+        ? (
+          <button type="button" className={css.secondaryButton} onClick={() => { reload(true) }}>{t('reload')}</button>
+        )
+        : null}
+      {showEmpty
+        ? (
+          <>
+            <p className={css.notice}>{t('empty')}</p>
+            <p className={css.intro}>{t('emptyHint')}</p>
+          </>
+        )
+        : null}
+      {showList
+        ? (
+          <ul className={css.rows}>
+            {drafts.map(draft => (
+              <RouteCard
+                key={draft.provider}
+                draft={draft}
+                formats={formats.length > 0 ? formats : []}
+                writable={writable}
+                busy={busyRoute === draft.provider}
+                reloading={status === 'loading'}
+                notice={notices[draft.provider]}
+                t={t}
+                onChange={(next) => {
+                  setNotices(current => {
+                    const copy = { ...current }
+                    delete copy[next.provider]
+                    return copy
+                  })
+                  setDrafts(current => current.map(row => row.provider === next.provider ? next : row))
+                }}
+                onSave={(next) => { void save(next) }}
+                onCancel={(next) => {
+                  setNotices(current => {
+                    const copy = { ...current }
+                    delete copy[next.provider]
+                    return copy
+                  })
+                  setDrafts(current => current.map(row => row.provider === next.provider
+                    ? {
+                        ...row,
+                        models: cloneModels(row.originalModels),
+                        compat: cloneObject(row.originalCompat),
+                      }
+                    : row))
+                }}
+              />
+            ))}
+          </ul>
+        )
+        : null}
+    </div>
+  )
+}

package/src/client/README.en.md

@@ -0,0 +1,27 @@
+# src/client/
+
+<p align="center">
+  <samp>
+    <a href="./README.md">中文</a> ·
+    <strong>English</strong>
+  </samp>
+</p>
+
+Browser half: registers **Reasoning efforts** in the Web UI settings panel and writes `llm-pi-ai` through the official settings RPC.
+
+Wiring failures in `apply` throw, same as the official Models page. Do not swallow `apply` with a blanket `try/catch`. Locale, CSS, and event subscriptions are cleaned up through `ctx.effect` on unload.
+
+Cross-plugin work uses Cordis services only (`connection`, `settingsScope`, `settingsSchema`, `slots`, `locale`, `remote`). Do not value-import `@deepseek-ai/dsh-client-ui-settings-models`: the client bundle purity rule forbids inlining other `@deepseek-ai/*` packages except platform modules in the shell’s frozen table.
+
+## What's in this directory
+
+| File | Role |
+| --- | --- |
+| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 15). Subscribes in `apply` to `settings/document-updated` (`llm-pi-ai` only), `llm/adapters-updated`, and `connection/reset`. |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. |
+| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. |
+| [`locales.ts`](./locales.ts) | Copy namespace `plugin-effort-declare`. |
+| [`effort-declare.module.css`](./effort-declare.module.css) | `--dsw-alias-*` tokens only, so dark theme stays correct. |
+| [`schema-ops.ts`](./schema-ops.ts) | Binds `settingsSchema` as plain callbacks so the service identity is not passed into React. |
+
+Visual language follows the official Models page, not `--ds-*` variables with light-mode fallbacks.