dsh-diary-memory 0.1.0 → 0.1.2

package/package.json

@@ -1,15 +1,41 @@
 {
   "name": "dsh-diary-memory",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "为 DSH 的陪伴与个人数字分身提供有温度、可演化的日记记忆、百炼检索和安全压缩。",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "license": "MIT",
-  "engines": { "node": ">=22.15", "dsh": "0.2.1-rc.3" },
-  "files": ["lib", "src", "locale", "icon.svg", "cordis.patch.yml", "README.md", "LICENSE"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyhddyx/dsh-diary-memory.git"
+  },
+  "homepage": "https://github.com/cyhddyx/dsh-diary-memory#readme",
+  "bugs": {
+    "url": "https://github.com/cyhddyx/dsh-diary-memory/issues"
+  },
+  "engines": {
+    "node": ">=22.15",
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "files": [
+    "lib",
+    "src",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
   "exports": {
-    ".": { "types": "./lib/index.d.ts", "default": "./lib/index.js" },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
     "./compaction": "./lib/orchestrator.js",
     "./compaction/locale/*.json": "./locale/compaction/*.json",
     "./compaction/icon": "./icon.svg",
@@ -23,51 +49,139 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "tsc -p tsconfig.json && node --test test/*.test.mjs",
+    "test": "npm run build && node --test test/*.test.mjs",
     "prepack": "npm run build"
   },
-  "dependencies": { "better-sqlite3": "^12.4.1", "zod": "4.4.3" },
+  "dependencies": {
+    "zod": "4.4.3"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-agent": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-compaction": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-compaction-basic": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-session": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-session-projection": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2 <0.3.0",
     "@deepseek-ai/schemastery": "~3.18.5",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-compaction": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-compaction-basic": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.3",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.3"
+    "better-sqlite3": "^12.4.1",
+    "@deepseek-ai/dsh-agent-preset-registry": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-scope": ">=0.2.1-rc.2 <0.3.0"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/schemastery": { "optional": true },
-    "@deepseek-ai/dsh-agent": { "optional": true },
-    "@deepseek-ai/dsh-compaction": { "optional": true },
-    "@deepseek-ai/dsh-compaction-basic": { "optional": true },
-    "@deepseek-ai/dsh-llm": { "optional": true },
-    "@deepseek-ai/dsh-session": { "optional": true },
-    "@deepseek-ai/dsh-session-projection": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-compaction": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-compaction-basic": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-projection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-preset-registry": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5",
-    "@deepseek-ai/schemastery": "3.18.5",
+    "@deepseek-ai/cosmokit": "1.8.6",
     "@deepseek-ai/dsh-agent": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-agent-preset": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.3",
     "@deepseek-ai/dsh-compaction": "0.2.1-rc.3",
     "@deepseek-ai/dsh-compaction-basic": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-config-editor": "0.2.1-rc.3",
     "@deepseek-ai/dsh-llm": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.3",
     "@deepseek-ai/dsh-session": "0.2.1-rc.3",
     "@deepseek-ai/dsh-session-projection": "0.2.1-rc.3",
+    "@deepseek-ai/dsh-settings": "0.2.1-rc.3",
     "@deepseek-ai/dsh-token-meter": "0.2.1-rc.3",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
+    "@deepseek-ai/schemastery": "3.18.5",
+    "@shikijs/langs": "4.4.3",
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^24.0.0",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.7",
+    "anser": "2.3.5",
+    "clsx": "2.1.1",
+    "diff": "9.0.0",
+    "esbuild": "0.28.2",
+    "immer": "10.2.0",
+    "katex": "0.18.7",
+    "mdast-util-from-markdown": "2.1.0",
+    "mdast-util-gfm": "3.1.0",
+    "mdast-util-math": "3.0.0",
+    "micromark-core-commonmark": "2.0.4",
+    "micromark-extension-gfm": "3.0.0",
+    "micromark-extension-math": "3.1.0",
+    "micromark-factory-space": "2.1.0",
+    "micromark-util-character": "2.1.1",
+    "micromark-util-classify-character": "2.0.1",
+    "micromark-util-sanitize-uri": "2.0.1",
+    "micromark-util-symbol": "2.0.1",
+    "micromark-util-types": "2.0.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "semver": "7.8.5",
+    "shiki": "4.4.3",
+    "simple-icons": "16.31.0",
     "typescript": "^5.9.3",
-    "yaml": "^2.8.1"
+    "yaml": "^2.8.1",
+    "zustand": "5.0.16",
+    "better-sqlite3": "^12.4.1"
   },
   "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" }
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
   }
 }

package/src/bailian-client.ts

@@ -1,5 +1,6 @@
 import { setTimeout as delay } from 'node:timers/promises'
 import type { ResolvedConfig } from './config.js'
+import { stableParameters } from './model-parameters.js'
 
 interface BailianFailure {
   status?: number
@@ -38,7 +39,10 @@ export class BailianClient {
     this.fetch = fetchImpl
     this.signal = signal
     // Model names alone do not identify the vector space across endpoints/dimensions.
-    this.embeddingKey = JSON.stringify([config.baseUrl, config.embeddingModel, config.embeddingDimensions])
+    const space: unknown[] = [config.baseUrl, config.embeddingModel, config.embeddingDimensions]
+    // Keep the original vector-space key when no extra parameters were chosen.
+    if (Object.keys(config.embeddingParameters).length) space.push(stableParameters(config.embeddingParameters))
+    this.embeddingKey = JSON.stringify(space)
   }
 
   async request(path: string, body: unknown, callerSignal?: AbortSignal): Promise<unknown> {
@@ -95,7 +99,7 @@ export class BailianClient {
     const output = await this.request('/api/v1/services/embeddings/text-embedding/text-embedding', {
       model: embeddingModel,
       input: { texts: [text] },
-      parameters: { text_type: textType, dimension: embeddingDimensions },
+      parameters: { ...this.config.embeddingParameters, text_type: textType, dimension: embeddingDimensions },
     }, signal) as { embeddings?: { text_index?: unknown; embedding?: unknown }[] }
     if (output.embeddings?.length !== 1 || output.embeddings[0].text_index !== 0) throw new BailianError('百炼 embedding 的 text_index 无效')
     return validateVector(output.embeddings[0].embedding, embeddingDimensions)
@@ -108,7 +112,7 @@ export class BailianClient {
     const output = await this.request('/api/v1/services/rerank/text-rerank/text-rerank', {
       model: this.config.rerankModel,
       input: { query, documents },
-      parameters: { top_n: topN, return_documents: false },
+      parameters: { return_documents: false, ...this.config.rerankParameters, top_n: topN },
     }, signal) as { results?: RerankResult[] }
     if (!Array.isArray(output.results) || output.results.length !== topN) throw new BailianError('百炼 rerank 结果数量无效')
     const seen = new Set()

package/src/client/choices.ts

@@ -0,0 +1,66 @@
+import { createSnapshotStore } from '@deepseek-ai/dsh-client-store'
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store'
+
+export interface SessionChoice { id: string; title: string }
+export interface WriterChoice { provider: string; model: string; label: string }
+export interface ChoicesState {
+  sessions: SessionChoice[]
+  sessionsReady: boolean
+  writers: WriterChoice[]
+  modelsStatus: 'loading' | 'ready' | 'error'
+}
+export interface SessionCatalog {
+  phase: string
+  ids: readonly string[]
+  byId: Record<string, { id: string; displayTitle: string; origin?: string }>
+}
+export interface ModelCatalogResult {
+  ok: boolean
+  value?: { groups: readonly { id: string; name: string; models: readonly { id: string; name: string }[] }[] }
+}
+
+/** Read only the native metadata catalog; never open or upload conversation bodies. */
+export class DiaryChoices {
+  readonly store = createSnapshotStore<ChoicesState>({ sessions: [], sessionsReady: false, writers: [], modelsStatus: 'loading' })
+  private readonly unsubscribe?: () => void
+  private generation = 0
+  private disposed = false
+
+  constructor(private readonly catalog?: ObservableSnapshot<SessionCatalog>, private readonly loadModels?: () => Promise<ModelCatalogResult>, private readonly refreshSessions?: () => Promise<void>) {
+    this.unsubscribe = catalog?.subscribe(() => this.readSessions())
+    this.readSessions()
+    void this.refreshModels()
+  }
+
+  private readSessions(): void {
+    const value = this.catalog?.getSnapshot()
+    this.store.update(state => {
+      state.sessionsReady = value?.phase === 'ready'
+      state.sessions = value ? value.ids.flatMap(id => {
+        const row = value.byId[id]
+        return row && row.origin !== 'subagent' ? [{ id, title: row.displayTitle }] : []
+      }) : []
+    })
+  }
+
+  async refreshModels(): Promise<void> {
+    const generation = ++this.generation
+    this.store.update(state => { state.modelsStatus = 'loading' })
+    try {
+      const response = await this.loadModels?.()
+      if (this.disposed || generation !== this.generation) return
+      this.store.update(state => {
+        state.writers = response?.ok && response.value ? response.value.groups.flatMap(group => group.models.map(model => ({ provider: group.id, model: model.id, label: `${group.name} / ${model.name}` }))) : []
+        state.modelsStatus = response?.ok ? 'ready' : 'error'
+      })
+    } catch {
+      if (!this.disposed && generation === this.generation) this.store.update(state => { state.modelsStatus = 'error' })
+    }
+  }
+
+  async refresh(): Promise<void> {
+    await Promise.allSettled([this.refreshSessions?.(), this.refreshModels()])
+  }
+
+  dispose(): void { this.disposed = true; this.generation++; this.unsubscribe?.() }
+}

package/src/client/controller.ts

@@ -0,0 +1,108 @@
+import { SettingsFormModel, settingsTextField } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { SettingsFieldSpec, SettingsFieldState, SettingsFormScope, SettingsFormShell } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store'
+import type { DiaryConfig } from '../config.js'
+import { validateModelParameters } from '../model-parameters.js'
+import { validateSessionIds } from '../session-selection.js'
+import { DiaryChoices } from './choices.js'
+import type { ChoicesState } from './choices.js'
+
+export const editableFields = ['apiKey', 'baseUrl', 'embeddingModel', 'embeddingDimensions', 'embeddingParameters', 'rerankModel', 'rerankParameters', 'candidateCount', 'recallCount', 'compressionRounds', 'retainRounds', 'autoRecall', 'sessionIds', 'diaryProvider', 'diaryModel'] as const
+export type EditableField = typeof editableFields[number]
+export type FormValues = Partial<Pick<DiaryConfig, EditableField>>
+export interface DiarySettingsState extends SettingsFormShell, ChoicesState {
+  fields: Record<EditableField, SettingsFieldState>
+  keyConfigured: boolean
+  error: string | null
+  selectedSessions: string[]
+}
+
+function numberField(field: string, min: number, max: number): SettingsFieldSpec {
+  return {
+    field, format: value => typeof value === 'number' ? String(value) : '',
+    parse: text => !text.trim() ? { kind: 'clear' }
+      : Number.isSafeInteger(Number(text)) && Number(text) >= min && Number(text) <= max ? { kind: 'set', value: Number(text) } : undefined,
+  }
+}
+function parametersField(field: string, kind: 'embedding' | 'rerank'): SettingsFieldSpec {
+  return {
+    field, format: value => value && typeof value === 'object' ? JSON.stringify(value, null, 2) : '{}',
+    parse: text => {
+      if (!text.trim()) return { kind: 'clear' }
+      try { return { kind: 'set', value: validateModelParameters(JSON.parse(text), kind) } } catch { return undefined }
+    },
+  }
+}
+const specs: SettingsFieldSpec[] = [
+  ...['apiKey', 'baseUrl', 'embeddingModel', 'rerankModel', 'diaryProvider', 'diaryModel'].map(settingsTextField),
+  { field: 'sessionIds', format: value => JSON.stringify(value ?? []), parse: text => {
+    try { return { kind: 'set', value: validateSessionIds(JSON.parse(text || '[]')) } } catch { return undefined }
+  } },
+  numberField('embeddingDimensions', 1, 4096), numberField('candidateCount', 1, 100), numberField('recallCount', 1, 100),
+  numberField('compressionRounds', 2, 1000000), numberField('retainRounds', 1, 1000000),
+  parametersField('embeddingParameters', 'embedding'), parametersField('rerankParameters', 'rerank'),
+  { field: 'autoRecall', format: value => String(value ?? true), parse: text => text === 'true' || text === 'false' ? { kind: 'set', value: text === 'true' } : undefined },
+]
+
+/** Native staged form: only edited paths are sent, preserving undisclosed secrets. */
+export class DiarySettingsController {
+  readonly form: SettingsFormModel<FormValues>
+  readonly store: SnapshotStore<DiarySettingsState>
+  private readonly unsubscribeChoices: () => void
+
+  constructor(private readonly scope: SettingsFormScope<FormValues>, private readonly keyConfigured: () => boolean = () => false, readonly choices = new DiaryChoices()) {
+    this.form = new SettingsFormModel(scope, specs)
+    this.store = this.form.bind(() => this.projection())
+    this.unsubscribeChoices = choices.store.subscribe(() => this.store.set(this.projection()))
+  }
+
+  private projection(): DiarySettingsState {
+    const fields = Object.fromEntries(editableFields.map(field => [field, this.form.field(field)])) as DiarySettingsState['fields']
+    const base = this.scope.getSnapshot().base as FormValues | undefined
+    const number = (field: 'compressionRounds' | 'retainRounds' | 'recallCount' | 'candidateCount', fallback: number) => fields[field].text.trim() ? Number(fields[field].text) : base?.[field] ?? fallback
+    let error: string | null = null
+    let selectedSessions: string[] = []
+    try { selectedSessions = validateSessionIds(JSON.parse(fields.sessionIds.text || '[]')) } catch (failure) { error = (failure as Error).message }
+    const writerProvider = fields.diaryProvider.text.trim()
+    const writerModel = fields.diaryModel.text.trim()
+    if (Boolean(writerProvider) !== Boolean(writerModel)) error = '写日记的模型提供方与模型名必须同时填写，或同时留空跟随聊天模型。'
+    if (writerProvider.length > 200 || writerModel.length > 200) error = '写日记的提供方与模型名不能超过 200 字符。'
+    if (number('compressionRounds', 20) <= number('retainRounds', 2)) error = '压缩轮次必须大于保留轮次。'
+    if (number('recallCount', 6) > number('candidateCount', 30)) error = '召回条数不能大于候选数量。'
+    for (const kind of ['embedding', 'rerank'] as const) {
+      const text = fields[`${kind}Parameters`].text.trim()
+      try { validateModelParameters(JSON.parse(text || '{}'), kind) }
+      catch (failure) { error = failure instanceof SyntaxError ? `${kind} 参数需要合法的 JSON 对象。` : (failure as Error).message }
+    }
+    const endpoint = fields.baseUrl.text.trim()
+    try {
+      if (endpoint) {
+        const url = new URL(endpoint)
+        if (url.username || url.password || url.search || url.hash || url.pathname !== '/' || url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))) throw new Error()
+      }
+    } catch { fields.baseUrl.invalid = true; error = '百炼端点需要 HTTPS origin，例如 https://dashscope.aliyuncs.com。' }
+    for (const field of ['embeddingModel', 'rerankModel'] as const) {
+      if (fields[field].text.trim().length > 200) { fields[field].invalid = true; error = '模型名不能超过 200 字符。' }
+    }
+    const shell = this.form.shell()
+    return { ...shell, ...this.choices.store.getSnapshot(), selectedSessions, invalid: shell.invalid || Boolean(error) || !shell.writable, fields, keyConfigured: this.keyConfigured(), error }
+  }
+
+  async save(): Promise<void> { if (!this.projection().invalid) await this.form.save() }
+  inject() {
+    return {
+      hooks: { diarySettings: this.store }, ...this.form.actions(), save: () => { void this.save() },
+      toggleSession: (id: string, enabled: boolean) => {
+        const ids = this.projection().selectedSessions
+        this.form.actions().edit('sessionIds', JSON.stringify(enabled ? validateSessionIds([...ids, id]) : ids.filter(item => item !== id)))
+      },
+      chooseWriter: (selection: string) => {
+        const [provider, model] = selection ? JSON.parse(selection) as [string, string] : ['', '']
+        this.form.actions().edit('diaryProvider', provider)
+        this.form.actions().edit('diaryModel', model)
+      },
+      refreshChoices: () => { void this.choices.refresh() },
+    }
+  }
+  dispose(): void { this.unsubscribeChoices(); this.choices.dispose(); this.form.dispose() }
+}

package/src/client/index.ts

@@ -0,0 +1,26 @@
+import type { Context } from '@deepseek-ai/cordis'
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+import { DiarySettingsController } from './controller.js'
+import type { FormValues } from './controller.js'
+import { DiarySettingsPage } from './page.js'
+import { DiaryChoices } from './choices.js'
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'
+import type {} from '@deepseek-ai/dsh-api-remotes/client'
+
+export { DiarySettingsController } from './controller.js'
+export { DiarySettingsPage } from './page.js'
+export const inject = ['slots', 'configForms', 'sessions', 'remote', 'remote.session']
+
+export function apply(ctx: Context): void {
+  const sessions = ctx.get('sessions') as unknown as ISessions
+  const choices = new DiaryChoices(sessions.list, () => ctx.remote.session.modelCatalog(), () => sessions.refresh())
+  const controller = new DiarySettingsController(ctx.configForms.get<FormValues>('diary-memory'), () => {
+    const entry = ctx.configForms.describe().getSnapshot().view?.namespaces.find(item => item.ns === 'diary-memory')
+    return entry?.secrets?.some(item => item.path.length === 1 && item.path[0] === 'apiKey' && item.set) ?? false
+  }, choices)
+  ctx.effect(() => () => controller.dispose(), 'diary-memory: settings form')
+  ctx.effect(() => ctx.configForms.whileServed(['diary-memory'], () => ctx.slots.inject('settings.section', () => ctx.slots.register({
+    name: 'settings.section', id: 'diary-memory', order: 65, label: '陪伴日记', inject: () => controller.inject(),
+  }, DiarySettingsPage))), 'diary-memory: settings page')
+}

package/src/client/page.tsx

@@ -0,0 +1,100 @@
+import { SettingsForm, SettingsSecretField, SettingsValueField, Switch } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { CSSProperties, ReactNode } from 'react'
+import { useState } from 'react'
+import type { InjectFace } from '@deepseek-ai/dsh-client-ui-slots'
+import type { DiarySettingsController, EditableField } from './controller.js'
+
+type PageProps = InjectFace<ReturnType<DiarySettingsController['inject']>>
+const card: CSSProperties = { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 14, padding: '16px 20px', marginTop: 16, minWidth: 0 }
+const hint: CSSProperties = { fontSize: 12, lineHeight: 1.6, color: 'var(--dsw-alias-label-tertiary)', margin: '8px 0 0' }
+const textarea: CSSProperties = { display: 'block', width: '100%', boxSizing: 'border-box', minHeight: 110, padding: 12, borderRadius: 8, border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-layer-3)', color: 'var(--dsw-alias-label-primary)', fontFamily: 'var(--dsw-font-mono, monospace)', fontSize: 12, lineHeight: 1.6, resize: 'vertical' }
+
+function Group({ title, children }: { title: string; children: ReactNode }) {
+  return <section aria-label={title} style={card}><h3 style={{ fontSize: 14, margin: '0 0 8px' }}>{title}</h3>{children}</section>
+}
+
+export function DiarySettingsPage(props: PageProps) {
+  const state = props.useDiarySettings(value => value)
+  const disabled = !state.writable || state.saving
+  const [sessionFilter, setSessionFilter] = useState('')
+  const sessions = [...state.sessions, ...state.selectedSessions.filter(id => !state.sessions.some(item => item.id === id)).map(id => ({ id, title: '已选会话（不在当前列表）' }))]
+    .filter(item => `${item.title}\n${item.id}`.toLowerCase().includes(sessionFilter.toLowerCase()))
+  const writer = state.fields.diaryProvider.text && state.fields.diaryModel.text ? JSON.stringify([state.fields.diaryProvider.text, state.fields.diaryModel.text]) : ''
+  const valueField = (field: EditableField, label: string, description: string, numeric = false) => <SettingsValueField
+    key={field} id={`diary-${field}`} label={label} hint={description} numeric={numeric}
+    {...state.fields[field]} disabled={disabled} overriddenLabel="已自定义" resetLabel="恢复默认"
+    invalidLabel={numeric ? '请填写范围内的整数。' : '请检查填写的内容。'}
+    onEdit={text => props.edit(field, text)} onReset={() => props.resetField(field)}
+  />
+  const parameters = (field: 'embeddingParameters' | 'rerankParameters', description: string) => <div style={{ padding: '12px 0' }}>
+    <label htmlFor={`diary-${field}`} style={{ display: 'block', fontSize: 13, fontWeight: 500, marginBottom: 8 }}>额外参数（JSON）</label>
+    <textarea id={`diary-${field}`} aria-describedby={`diary-${field}-hint`} aria-invalid={state.fields[field].invalid || undefined}
+      value={state.fields[field].text} onChange={event => props.edit(field, event.target.value)} disabled={disabled}
+      spellCheck={false} rows={5} style={textarea} />
+    <p id={`diary-${field}-hint`} style={hint}>{description}</p>
+  </div>
+  return <div data-diary-settings style={{ color: 'var(--dsw-alias-label-primary)', paddingBottom: 16 }}>
+    <h2 style={{ fontSize: 18, margin: '0 0 8px' }}>陪伴日记</h2>
+    <p style={hint}>设置百炼连接、回忆模型与日记压缩方式。填写后点击保存。</p>
+    <SettingsForm state={state} onSave={props.save} onDiscard={props.discard} labels={{
+      unavailable: '正在加载配置；若持续不可用，请检查陪伴日记插件是否已启用。', readOnly: '当前配置只读。',
+      saveFailed: '保存失败或配置已在其他窗口修改。输入已保留，请检查后重试。', save: '保存配置', saving: '正在保存…',
+    }}>
+      <Group title="指定已有会话">
+        <p style={hint}>勾选后保存，在原会话继续聊天即可。保留原人设、模型与工具；未选会话保持原来的压缩方式。“陪伴日记”预设本身已启用记忆。</p>
+        <label htmlFor="diary-session-filter" style={{ display: 'block', fontSize: 13, marginTop: 12 }}>查找会话</label>
+        <input id="diary-session-filter" type="search" value={sessionFilter} onChange={event => setSessionFilter(event.target.value)}
+          placeholder="按会话标题或 ID 搜索" style={{ ...textarea, minHeight: 0, height: 36, marginTop: 6 }} />
+        <div aria-label="已有会话列表" style={{ maxHeight: 300, overflowY: 'auto', marginTop: 10 }}>
+          {sessions.map(item => <div key={item.id} style={{ display: 'flex', gap: 12, alignItems: 'center', padding: '10px 0', borderBottom: '1px solid var(--dsw-alias-border-l2)' }}>
+            <div style={{ minWidth: 0, flex: 1 }}><div style={{ fontSize: 13, overflowWrap: 'anywhere' }}>{item.title}</div><div style={{ ...hint, margin: 0, overflowWrap: 'anywhere' }}>{item.id}</div></div>
+            <Switch label={`为 ${item.title} 启用记忆`} checked={state.selectedSessions.includes(item.id)} disabled={disabled} onChange={value => props.toggleSession(item.id, value)} />
+          </div>)}
+          {!sessions.length ? <p style={hint}>{state.sessionsReady ? '没有匹配的会话。' : '正在读取会话列表…'}</p> : null}
+        </div>
+        <p style={hint}>已选 {state.selectedSessions.length} 个会话。同一记忆空间中的已选会话共享日记；取消勾选不会删除已保存的记忆。</p>
+        <button type="button" onClick={props.refreshChoices} disabled={state.saving} style={{ marginTop: 10 }}>刷新会话与模型列表</button>
+      </Group>
+      <Group title="专用写日记模型">
+        <label htmlFor="diary-writer" style={{ display: 'block', fontSize: 13, marginBottom: 6 }}>选择已配置的 DSH 模型</label>
+        <select id="diary-writer" value={writer} disabled={disabled} onChange={event => props.chooseWriter(event.target.value)} style={{ ...textarea, minHeight: 0, height: 40, padding: '0 10px', fontFamily: 'inherit' }}>
+          <option value="">跟随当前会话的聊天模型</option>
+          {writer && !state.writers.some(item => JSON.stringify([item.provider, item.model]) === writer) ? <option value={writer}>当前手填模型：{state.fields.diaryProvider.text} / {state.fields.diaryModel.text}</option> : null}
+          {state.writers.map(item => <option key={JSON.stringify([item.provider, item.model])} value={JSON.stringify([item.provider, item.model])}>{item.label}</option>)}
+        </select>
+        <p style={hint}>专用模型只负责写日记，不改变聊天模型。先在 DSH 的模型设置里配置提供方，也可以在下面手填其路由名与模型名。</p>
+        {state.modelsStatus === 'error' ? <p style={hint}>模型列表暂不可用，已保存的模型仍保留，可手填或刷新重试。</p> : null}
+        {valueField('diaryProvider', '写日记的模型提供方', '填写 DSH 已注册的 provider 路由名；与模型名同时留空则跟随聊天模型。')}
+        {valueField('diaryModel', '写日记的模型名', '填写该提供方支持的生成模型。这里只设置模型，不增加生成参数。')}
+      </Group>
+      <Group title="百炼连接">
+        <SettingsSecretField id="diary-apiKey" label="百炼 API Key" hint="密钥不会回显；留空保留已保存的 Key。也可通过 DSH 的环境变量提供。"
+          text={state.fields.apiKey.text} configured={state.keyConfigured} stateLabel={state.keyConfigured ? '已保存（不回显）' : '尚未保存'}
+          disabled={disabled} onEdit={text => props.edit('apiKey', text)} />
+        {valueField('baseUrl', '百炼 API 地址', '需要与 API Key 的地域一致，例如 https://dashscope.aliyuncs.com。')}
+      </Group>
+      <Group title="Embedding · 向量召回">
+        {valueField('embeddingModel', 'Embedding 模型名', '可手动填写百炼支持的文本向量模型，例如 text-embedding-v4。')}
+        {valueField('embeddingDimensions', '向量维度', '1–4096；请填写所选模型支持的维度。', true)}
+        {parameters('embeddingParameters', '填写该模型支持的 parameters，例如 {"output_type":"dense"}。dimension 在上方填写，text_type 由入库与召回自动设置。')}
+        <p style={hint}>更改 Embedding 模型、维度或参数后，旧向量不会参与新配置的检索。</p>
+      </Group>
+      <Group title="Rerank · 回忆排序">
+        {valueField('rerankModel', 'Rerank 模型名', '可手动填写百炼支持的重排模型，例如 gte-rerank-v2。')}
+        {valueField('candidateCount', '候选数量', '1–100；先由向量检索选出这些日记交给 Rerank。', true)}
+        {valueField('recallCount', '召回条数（top_n）', '1–100，且不大于候选数量。', true)}
+        {parameters('rerankParameters', '填写该模型支持的 parameters，例如 {"return_documents":false}。top_n 由上方的召回条数设置。')}
+      </Group>
+      <Group title="日记与陪伴">
+        {valueField('compressionRounds', '触发压缩的轮次', '完成多少轮后保存日记并安全压缩；须大于保留轮次。', true)}
+        {valueField('retainRounds', '保留最近轮次', '至少保留最近多少个用户输入及后续消息。', true)}
+        <div style={{ display: 'flex', gap: 10, justifyContent: 'space-between', alignItems: 'center', padding: '12px 0', fontSize: 13 }}>
+          <span>自动回想相关日记</span>
+          <Switch label="自动回想相关日记" checked={state.fields.autoRecall.text === 'true'} disabled={disabled}
+            onChange={value => props.edit('autoRecall', String(value))} />
+        </div>
+      </Group>
+      {state.error ? <p role="alert" style={{ ...hint, color: 'var(--dsw-alias-label-error)' }}>{state.error}</p> : null}
+    </SettingsForm>
+  </div>
+}