@waterwx/dsh-novel-forge 1.3.2-alpha → 1.3.3-alpha

package/lib/types/stage-contract.d.ts

@@ -12,9 +12,7 @@
  * 阶段强约束只在作者没有指定具体对象（通用续写）时生效。
  */
 import type { ChapterPlan, ProjectState, StageInfo } from './protocol.ts';
-/** 创作阶段标识（线上形状见 protocol.ts 的 StageInfo）。 */
-export type BookStageId = StageInfo['id'];
-/** 一个阶段契约。 */
+/** 一个阶段契约（assistant 侧需要作为类型使用）。 */
 export type BookStage = StageInfo;
 /**
  * 作者这一轮是否只说了「继续/下一步」这类没有具体对象的指令。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译纯文本小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan volumes & chapters with LLM, generate chapter by chapter (3000-4000 chars each), auto AI review & book audit, and export the full book as Markdown/TXT into your chosen output folder.",
-  "version": "1.3.2-alpha",
+  "version": "1.3.3-alpha",
   "type": "module",
   "author": "waterwx",
   "repository": {
@@ -62,16 +62,16 @@
     "schemastery": "^3.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-skill": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.3",
-    "@deepseek-ai/dsh-tools": "0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-skill": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
@@ -114,6 +114,8 @@
     "typecheck": "tsc --noEmit",
     "check:styles": "node scripts/check-theme-sizes.mjs",
     "check:third-party": "node scripts/check-third-party.mjs",
+    "check:contrast": "node scripts/audit-contrast.mjs",
+    "check:third-party:list": "node scripts/check-third-party.mjs --list",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
     "test": "vitest run"

package/src/ai-scan.ts

@@ -153,27 +153,3 @@ function countOccurrences(text: string, word: string): number {
   }
   return count
 }
-
-/** 扫描前后对比（润色时用） */
-export function compareAiScan(before: AiScanResult, after: AiScanResult): {
-  improved: boolean
-  deltaScore: number
-  details: string[]
-} {
-  const deltaScore = before.aiScore - after.aiScore
-  const details: string[] = []
-  if (deltaScore > 0) details.push(`AI 味指数下降 ${deltaScore} 分（${before.aiScore} → ${after.aiScore}）`)
-  else if (deltaScore < 0) details.push(`AI 味指数上升 ${-deltaScore} 分（${before.aiScore} → ${after.aiScore}），需检查`)
-  else details.push(`AI 味指数持平（${before.aiScore}）`)
-
-  const beforeCliches = before.clicheHits.reduce((a, b) => a + b.count, 0)
-  const afterCliches = after.clicheHits.reduce((a, b) => a + b.count, 0)
-  if (afterCliches < beforeCliches) details.push(`套话减少 ${beforeCliches - afterCliches} 处`)
-  else if (afterCliches > beforeCliches) details.push(`套话增加 ${afterCliches - beforeCliches} 处`)
-
-  return {
-    improved: deltaScore > 0,
-    deltaScore,
-    details,
-  }
-}

package/src/assets.ts

@@ -1554,11 +1554,6 @@ export function effectiveAntiAiRules(assets: ProjectAssets | undefined): AntiAiR
   return [...BUILTIN_ANTI_AI_RULES.filter(r => !customKeys.has(keyOf(r))), ...custom]
 }
 
-/** 安定 key：内置规则全局基线（globalBaselineEnabled）在新书/旧书一律生效。 */
-export function ensureGlobalBaseline(assets: ProjectAssets | undefined): ProjectAssets {
-  return ensureBuiltinAssets(assets, 'missing_only')
-}
-
 /** 内置库种子化 upsert（对齐上游 SystemResourceBootstrapService 精神）。
  *  missing_only 仅补齐缺失的全局基线规则；sync_existing 还会按 key 刷新已内置规则的结构化字段。 */
 export function ensureBuiltinAssets(assets: ProjectAssets | undefined, mode: 'missing_only' | 'sync_existing' = 'missing_only'): ProjectAssets {

package/src/author-assets.ts

@@ -1,22 +1,21 @@
 /**
  * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
- * 与书架同惯例持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+ * 与书架同惯例持久化到 <DSH_HOME>/dsh-novel-forge-author-assets.json。
  * 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 + 
  * 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
 import { randomBytes } from 'node:crypto'
 import type { AuthorAssetLibrary, AuthorStyleAsset } from './protocol.ts'
 
 import { loadBookshelf } from './bookshelf.ts'
 import { loadProject } from './engine.ts'
+import { dshHome, dshHomePath } from './home.ts'
 
 /** 作者资产库配置文件路径。 */
 export function authorAssetsFile(): string {
-  return join(homedir(), '.dsh', 'dsh-novel-forge-author-assets.json')
+  return dshHomePath('dsh-novel-forge-author-assets.json')
 }
 
 /** 默认空资产库。 */
@@ -44,27 +43,10 @@ export function loadAuthorAssets(): AuthorAssetLibrary {
 /** 持久化作者资产库。 */
 export function saveAuthorAssets(library: AuthorAssetLibrary): void {
   const file = authorAssetsFile()
-  mkdirSync(join(homedir(), '.dsh'), { recursive: true })
+  mkdirSync(dshHome(), { recursive: true })
   writeFileSync(file, JSON.stringify(library, null, 2), 'utf8')
 }
 
-/** 新建一条资产（自动生成 id 与时间戳）。 */
-export function createAuthorAsset(input: Omit<AuthorStyleAsset, 'id' | 'createdAt' | 'updatedAt'>): AuthorStyleAsset {
-  const now = new Date().toISOString()
-  const asset: AuthorStyleAsset = {
-    ...input,
-    id: 'aa-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex'),
-    sourceBooks: input.sourceBooks ?? [],
-    tags: input.tags ?? [],
-    createdAt: now,
-    updatedAt: now,
-  }
-  const library = loadAuthorAssets()
-  library.items.push(asset)
-  saveAuthorAssets(library)
-  return asset
-}
-
 /** 按 id 更新一条资产；不存在则追加。 */
 export function upsertAuthorAsset(input: AuthorStyleAsset): AuthorAssetLibrary {
   const library = loadAuthorAssets()

package/src/bookshelf.ts

@@ -1,18 +1,18 @@
 /**
  * 书架（Bookshelf）— 多书管理：一本书记录一个独立输出目录。
- * 状态持久化到 ~/.dsh/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
+ * 状态持久化到 <DSH_HOME>/dsh-novel-forge-bookshelf.json（跟随 dsh 配置惯例）。
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { randomBytes } from 'node:crypto'
 import type { BookEntry, BookshelfSnapshot } from './protocol.ts'
 import { loadProject } from './engine.ts'
+import { dshHome, dshHomePath } from './home.ts'
 
 /** 书架配置文件路径。 */
 export function bookshelfFile(): string {
-  return join(homedir(), '.dsh', 'dsh-novel-forge-bookshelf.json')
+  return dshHomePath('dsh-novel-forge-bookshelf.json')
 }
 
 interface BookshelfStore {
@@ -44,7 +44,7 @@ export function loadBookshelf(): BookshelfStore {
 /** 持久化书架。 */
 function saveBookshelf(store: BookshelfStore): void {
   const file = bookshelfFile()
-  mkdirSync(join(homedir(), '.dsh'), { recursive: true })
+  mkdirSync(dshHome(), { recursive: true })
   writeFileSync(file, JSON.stringify(store, null, 2), 'utf8')
 }
 
@@ -180,8 +180,14 @@ export function repointBookDirs(from: string, to: string): number {
   return count
 }
 
-/** 默认输出目录推断：~/.dsh/novels/书名。 */
-export function defaultOutputDirFor(bookName: string): string {
+/**
+ * 新书默认输出目录：`<配置的输出目录>/书名`；未配置时回退 `<DSH_HOME>/novels/书名`。
+ * @param bookName - 书名（剔除文件系统非法字符并截断到 40 字）。
+ * @param baseDir - settings 里配置的输出目录（未经激活书合并的原始值）。
+ * @returns 该书应写入的绝对目录。
+ */
+export function defaultOutputDirFor(bookName: string, baseDir?: string): string {
   const clean = bookName.replace(/[\\/:*?"<>|]/g, '').trim().slice(0, 40) || '未命名小说'
-  return join(homedir(), '.dsh', 'novels', clean)
+  const base = baseDir !== undefined && baseDir.trim() !== '' ? baseDir.trim() : dshHomePath('novels')
+  return join(base, clean)
 }

package/src/client/api.ts

@@ -180,8 +180,8 @@ export class NovelApi {
     return postJson<import('../protocol.ts').ChapterSaveResponse>(NOVEL_API.chapterSave, { chapterNo: no, text, report })
   }
 
-  async patchConfig(patch: ConfigPatch): Promise<{ config: NovelConfig }> {
-    return postJson<{ config: NovelConfig }>(NOVEL_API.config, patch)
+  async patchConfig(patch: ConfigPatch): Promise<{ config: NovelConfig; settingsWarning?: string }> {
+    return postJson<{ config: NovelConfig; settingsWarning?: string }>(NOVEL_API.config, patch)
   }
 
   /** 输出目录迁移：dryRun=true 仅预览目录内容；确认时传 to 搬迁。 */

package/src/client/docx.ts

@@ -30,8 +30,3 @@ export function extractDocxTextFromBuffer(buffer: ArrayBuffer | Uint8Array): str
   }
   return extractDocxTextFromXml(strFromU8(document))
 }
-
-/** Read a File as ArrayBuffer. */
-export function readFileAsArrayBuffer(file: File): Promise<ArrayBuffer> {
-  return file.arrayBuffer()
-}

package/src/client/locales.ts

@@ -136,6 +136,7 @@ export const zh = {
   'settings.autoReviewAfterReviseHint': '按意见修订/润色产出草稿后自动附带一次 AI 审查，直接显示新稿评分与剩余问题（每章约 2-3k token，可关）',
   'settings.save': '保存设置',
   'settings.saved': '设置已保存',
+  'settings.savedUnpersisted': '设置已生效，但未能持久化（宿主未登记本插件的配置段），重启后会回到原值。',
   'settings.openFolder': '打开输出文件夹',
   'settings.exportTxt': '导出 TXT',
   'settings.exportMd': '导出 Markdown',

package/src/client/mount.tsx

@@ -10,7 +10,7 @@ import { NovelPanel } from './panel/NovelPanel.tsx'
 import css from './panel/panel.module.css'
 
 /** The injected panel container. */
-export const PANEL_VIEW_SELECTOR = '[data-dsh-novelforge-view]'
+const PANEL_VIEW_SELECTOR = '[data-dsh-novelforge-view]'
 
 const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"], [class*="centerCol"]'
 const ACTIVE_ATTR = 'data-dsh-novelforge-active'
@@ -44,7 +44,8 @@ export function mountPanel(controller: PanelController, api: NovelApi): () => vo
     const column = conversationColumn()
     if (column === undefined) return
     container = document.createElement('div')
-    container.dataset.dshNovelforgeView = 'true'
+    // 归属标记只在这里落地；取值与 PANEL_VIEW_SELECTOR 同源，字符串不写第二遍。
+    container.setAttribute(PANEL_VIEW_SELECTOR.slice(1, -1), 'true')
     container.className = css.view
     column.appendChild(container)
     root = createRoot(container)

package/src/client/panel/AuthorAssetsView.tsx

@@ -1,6 +1,6 @@
 /**
  * 作者资产库/总数据页：跨书可复用的笔法/红线/套路/角色模板/世界观模板。
- * 支持 新增 / 编辑 / 删除；数据持久化到 ~/.dsh/dsh-novel-forge-author-assets.json。
+ * 支持 新增 / 编辑 / 删除；数据持久化到 Harness 数据目录（`$DSH_HOME`，未设时 ~/.dsh）。
  */
 import { useEffect, useMemo, useState } from 'react'
 import { Plus, Trash2, Pencil } from 'lucide-react'

package/src/client/panel/ImportModal.tsx

@@ -222,7 +222,7 @@ export function ImportModal({
 
               {/* 输出目录 + 高级路径选项 */}
               <label className={css.importField}>
-                <span>输出目录（可选，默认 ~/.dsh/novels/书名）</span>
+                <span>输出目录（可选，默认「输出目录」设置下的书名子目录）</span>
                 <input
                   className={css.input}
                   type="text"

package/src/client/panel/MarketRadarView.tsx

@@ -1,11 +1,18 @@
 /**
- * 「热门题材雷达」：对齐上游市场雷达页（真实榜单扫榜 → 候选勾选 → 分析 → 信号卡片 → 影响模式 → 用信号创作）。
+ * 「热门题材雷达」：真实榜单扫榜 → 候选勾选 → AI 分析 → 信号卡片 → 影响模式 → 用信号创作。
+ *
+ * 界面状态规则见 `market-radar-state.ts`（其中写明了 R1-R4 四条验收条件）：
+ *  - 扫榜**不销毁**已完成的产物：上一份分析与创意简报在新分析产出前继续可用，
+ *    作者不必为了改选范围而重扫一遍；
+ *  - 信号勾选只在**换了报告**时重置，重渲染不得冲掉手选；
+ *  - 三个入口的可用性统一由一个纯函数判定，避免多处各写一份条件而漂移。
  */
-import { useMemo, useState } from 'react'
+import { useMemo, useRef, useState } from 'react'
 import type { NovelApi } from '../api.ts'
 import type { MarketRadarResult, MarketCreativeBrief, IdeaInspirationResult } from '../../protocol.ts'
 import css from './panel.module.css'
 import { SubPage } from './SubPage.tsx'
+import { isDifferentReport, radarControls } from './market-radar-state.ts'
 
 const PLATFORMS = ['fanqie', 'qidian', 'jinjiang']
 const PLATFORM_LABELS: Record<string, string> = { fanqie: '番茄小说', qidian: '起点中文网', jinjiang: '晋江文学城' }
@@ -43,6 +50,22 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
   const [applied, setApplied] = useState('')
   const [syncBusy, setSyncBusy] = useState(false)
   const [syncedMsg, setSyncedMsg] = useState('')
+  /**
+   * 已应用报告 id。用 ref 而不是 state：它只用于「要不要复位勾选」的判断，
+   * 放进 state 会让每次分析都多一次重渲染，且可能触发不必要的复位。
+   */
+  const appliedReportId = useRef('')
+
+  /** 三个入口的可用性统一由纯函数判定，避免多处条件漂移。 */
+  const controls = useMemo(
+    () => radarControls({
+      scanning,
+      analyzing,
+      pickedCount: selectedCandidates.size,
+      hasReport: result !== null,
+    }),
+    [scanning, analyzing, selectedCandidates, result],
+  )
 
   const candKey = (g: ScanGroup, item: ScanItem): string => `${g.platform}:${g.listKey}:${item.rank}`
   const togglePlatform = (p: string): void => {
@@ -56,15 +79,14 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
   const scan = async (): Promise<void> => {
     setScanning(true)
     setError('')
-    setResult(null)
-    setBrief(null)
     try {
       const r = await api.marketRadarScan({ platforms })
       const groups = r.result.groups
       setScanGroups(groups)
       const firstP = PLATFORMS.find(p => groups.some(g => g.platform === p))
       if (firstP !== undefined) setViewPlatform(firstP)
-      // 默认不自动全选，交给用户手动勾选或用「全选」按钮。
+      // 勾选在扫榜后清空（换了候选范围），但**已完成的 AI 分析与创意简报保留**：
+      // 作者改选范围时不必丢掉上一份结论重新分析一次。
       setSelectedCandidates(new Set())
     } catch (err) {
       setError((err as Error).message)
@@ -104,12 +126,19 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
     for (const g of scanGroups) if (g.status === 'ok') for (const it of g.items) if (selectedCandidates.has(candKey(g, it))) candidates.push({ title: it.title, author: it.author, tags: it.tags, synopsis: it.synopsis, category: it.category })
     setAnalyzing(true)
     setError('')
-    setBrief(null)
     try {
       const r = await api.marketRadar({ candidates, feedText: feedText.trim() })
-      setResult(r.result)
-      const rec = r.result.signals.filter(s => s.recommended === true).map(s => s.id)
-      setSelectedIds(new Set(rec.slice(0, MAX_SIGNALS)))
+      const nextResult = r.result
+      // 只有换了报告才重置信号勾选：重渲染/重复分析不得冲掉作者手选。
+      if (isDifferentReport(appliedReportId.current, nextResult.reportId ?? '')) {
+        appliedReportId.current = nextResult.reportId ?? ''
+        const rec = nextResult.signals.filter(s => s.recommended === true).map(s => s.id)
+        setSelectedIds(new Set(rec.slice(0, MAX_SIGNALS)))
+      }
+      setResult(nextResult)
+      // 简报是绑定旧报告结论的产物，报告一换即失效（避免与信号不匹配）。
+      setBrief(null)
+      setIdeas(null)
     } catch (err) {
       setError((err as Error).message)
     } finally {
@@ -211,16 +240,25 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
           <textarea className={css.input} style={{ minHeight: 90, resize: 'vertical' }} value={feedText} onChange={e => setFeedText(e.target.value)} placeholder="粘贴一份公开榜单文本…" />
         </div>
         <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
-          <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={scanning} onClick={() => { void scan() }}>
+          <button type="button" className={`${css.button} ${css.buttonPrimary}`} disabled={!controls.canScan} onClick={() => { void scan() }}>
             {scanning ? '正在扫榜…' : '扫榜'}
           </button>
           {scanning && <span style={{ fontSize: 12, color: 'var(--nf-text-2)' }}>正在抓取公开榜单（{platforms.map(p => PLATFORM_LABELS[p]).join('、')}），多平台并行，约 10–30 秒…</span>}
           {scanGroups !== null && (
-            <button type="button" className={css.button} style={{ marginLeft: 8 }} disabled={analyzing || selectedCandidates.size === 0} onClick={() => { void analyze() }}>
-              {analyzing ? '分析中…' : `开始 分析（${selectedCandidates.size} 本）`}
+            <button type="button" className={css.button} style={{ marginLeft: 8 }} disabled={!controls.canAnalyze} onClick={() => { void analyze() }}>
+              {analyzing
+                ? '分析中…'
+                : controls.analyzeLabel === 'again'
+                  ? `生成新分析（${selectedCandidates.size} 本）`
+                  : `开始 分析（${selectedCandidates.size} 本）`}
             </button>
           )}
         </div>
+        {scanGroups !== null && controls.analyzeLabel === 'pick' && (
+          <span style={{ fontSize: 12, color: 'var(--nf-text-2)' }}>
+            {result !== null ? '上一份分析仍在下方可查看；改选作品后可生成新的分析（无需重新扫榜）。' : '请先勾选要分析的作品。'}
+          </span>
+        )}
       </div>
 
       {error !== '' && <div style={{ color: 'var(--nf-error)', fontSize: 13 }}> {error}</div>}
@@ -241,8 +279,8 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
             })}
           </div>
           <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
-            <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={selectAll}>全选当前平台</button>
-            <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={clearSelection}>清空</button>
+            <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={!controls.canSelectCandidates} onClick={selectAll}>全选当前平台</button>
+            <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={!controls.canSelectCandidates} onClick={clearSelection}>清空</button>
             <span style={{ fontSize: 11, color: 'var(--nf-text-2)' }}>已选 {selectedCandidates.size} 条</span>
           </div>
           <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(340px, 1fr))', gap: 'var(--nf-space-10)' }}>
@@ -251,7 +289,7 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
                 <div style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13, fontWeight: 600 }}>
                   {g.listLabel}
                   <span style={{ fontSize: 10, padding: '1px 6px', borderRadius: 99, color: g.status === 'ok' ? 'var(--nf-success)' : 'var(--nf-error)', background: g.status === 'ok' ? 'rgba(79,191,139,0.14)' : 'rgba(212,99,79,0.16)' }}>{g.status === 'ok' ? `${g.items.length} 条` : '读取失败'}</span>
-                  {g.status === 'ok' && <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => selectGroup(g)}>全选本榜</button>}
+                  {g.status === 'ok' && <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={!controls.canSelectCandidates} onClick={() => selectGroup(g)}>全选本榜</button>}
                 </div>
                 {g.status === 'error' && <div style={{ fontSize: 11, color: 'var(--nf-error)', marginTop: 4 }}>{g.error}</div>}
                 {g.status === 'ok' && (
@@ -260,8 +298,8 @@ export default function MarketRadarView({ api, bookId }: { api: NovelApi; bookId
                       const key = candKey(g, it)
                       const sel = selectedCandidates.has(key)
                       return (
-                        <label key={key} onClick={e => { if ((e.target as HTMLElement).tagName !== 'INPUT') toggleCandidate(key) }} style={{ display: 'flex', alignItems: 'flex-start', gap: 7, padding: '5px 2px', fontSize: 13.5, cursor: 'pointer' }}>
-                          <input type="checkbox" checked={sel} onChange={() => toggleCandidate(key)} onClick={e => e.stopPropagation()} style={{ marginTop: 3 }} />
+                        <label key={key} onClick={e => { if (!controls.canSelectCandidates) return; if ((e.target as HTMLElement).tagName !== 'INPUT') toggleCandidate(key) }} style={{ display: 'flex', alignItems: 'flex-start', gap: 7, padding: '5px 2px', fontSize: 13.5, cursor: controls.canSelectCandidates ? 'pointer' : 'not-allowed', opacity: controls.canSelectCandidates ? 1 : 0.6 }}>
+                          <input type="checkbox" checked={sel} disabled={!controls.canSelectCandidates} onChange={() => toggleCandidate(key)} onClick={e => e.stopPropagation()} style={{ marginTop: 3 }} />
                           <span style={{ lineHeight: 1.5 }}>
                             <b style={{ fontSize: 14 }}>{it.rank}. {it.title}</b>
                             {it.author !== undefined && it.author !== '' ? <span style={{ color: 'var(--nf-text-2)', fontSize: 12.5 }}>（{it.author}）</span> : null}

package/src/client/panel/SettingsView.tsx

@@ -124,7 +124,8 @@ export function SettingsView({ api, variant = 'page', onSettingsTab, onEditorFon
       });
       setConfig(result.config);
       setConfigDraft(result.config);
-      setNotice(tt('settings.saved'));
+      // 未持久化时如实告知：改动只在本进程内生效，不能让作者以为已经存住了。
+      setNotice(result.settingsWarning === undefined ? tt('settings.saved') : tt('settings.savedUnpersisted'));
     } catch (err) { setError((err as Error).message) } finally { setBusy(false) }
   };
 

package/src/client/panel/market-radar-state.ts

@@ -0,0 +1,79 @@
+/**
+ * 热门题材雷达的界面状态规则。
+ *
+ * 职责边界：本文件只回答「界面上此刻能不能点」，不持有任何数据。抽成纯函数的
+ * 理由是它可以离线测——组件渲染不好测，判定逻辑好测。
+ *
+ * 下面先用**独立表述的验收条件**写清楚要什么，再由两个函数实现；这样即使日后
+ * 需求变化，改动方向也是照着条件走，而不是照着某个外部实现的形状走。
+ *
+ *  R1 扫榜或分析进行中，不得改动作品勾选（否则分析输入与界面不一致）；
+ *  R2 未勾选任何作品时不能开始分析；
+ *  R3 已经有报告之后，仍允许改选作品并**再次**分析 —— 不得退化成"只能查看"；
+ *  R4 信号勾选只在确实换了一份报告时复位；同一份报告的重渲染不得冲掉作者手选。
+ */
+
+/** 雷达三个入口此刻的可用性，以及分析按钮该显示哪种文案。 */
+export interface RadarControls {
+  /** 扫榜按钮是否可点。 */
+  canScan: boolean
+  /** 作品勾选（含全选 / 清空）是否可改。 */
+  canSelectCandidates: boolean
+  /** 分析按钮是否可点。 */
+  canAnalyze: boolean
+  /**
+   * 分析按钮的文案标识：
+   *  - `wait`：还在扫榜，先等榜单；
+   *  - `pick`：还没勾选作品；
+   *  - `first`：首次分析；
+   *  - `again`：已有报告，这次是再出一份。
+   */
+  analyzeLabel: 'wait' | 'pick' | 'first' | 'again'
+}
+
+/**
+ * 实现 R1-R3：判定三个入口的可用性。
+ * @param state - 当前界面状态。
+ * @returns 各入口可用性与分析按钮文案标识。
+ */
+export function radarControls(state: {
+  /** 正在抓榜单。 */
+  scanning: boolean
+  /** 正在做 AI 分析。 */
+  analyzing: boolean
+  /** 已勾选的作品数。 */
+  pickedCount: number
+  /** 界面上是否已有可查看的报告。 */
+  hasReport: boolean
+}): RadarControls {
+  if (state.analyzing) {
+    // 分析中：三个入口都锁住（R1），按钮文案沿用上一次的状态不必区分。
+    return { canScan: false, canSelectCandidates: false, canAnalyze: false, analyzeLabel: 'first' }
+  }
+  if (state.scanning) {
+    return { canScan: false, canSelectCandidates: false, canAnalyze: false, analyzeLabel: 'wait' }
+  }
+  if (state.pickedCount === 0) {
+    return { canScan: true, canSelectCandidates: true, canAnalyze: false, analyzeLabel: 'pick' }
+  }
+  return {
+    canScan: true,
+    canSelectCandidates: true,
+    canAnalyze: true,
+    // R3：有报告也只是换个文案，**不禁用**再分析。
+    analyzeLabel: state.hasReport ? 'again' : 'first',
+  }
+}
+
+/**
+ * 实现 R4：本次报告是否**不是**勾选当前所依据的那一份。
+ *
+ * 传入的是上一次已经据以复位过的报告标识：相同 → 不动作者勾选；不同 → 勾选所依据
+ * 的信号集合已经变了，需要按新报告重新给出推荐勾选。
+ * @param selectionBasis - 勾选当前依据的报告标识（空串表示尚未复位过）。
+ * @param incoming - 本次拿到的报告标识（空串表示旧版产物没有该标识）。
+ * @returns 需要按新报告重置勾选时为 true。
+ */
+export function isDifferentReport(selectionBasis: string, incoming: string): boolean {
+  return selectionBasis !== incoming
+}

package/src/client/panel/panel.module.css

@@ -212,7 +212,7 @@ body[data-ds-dark-theme] .entry {
   --nf-text: #26221b;
   --nf-text-2: #6f665a;
   --nf-text-2-alpha: rgba(111, 102, 90, 0.7);
-  --nf-text-3: #9c9284;
+  --nf-text-3: #8f8679;
   --nf-accent: #a63e2a;
   --nf-accent-hover: #8c3321;
   --nf-accent-soft: rgba(166, 62, 42, 0.12);
@@ -293,11 +293,11 @@ body[data-ds-dark-theme] .view:not(:has(> .panel[data-nf-mode='light'])) {
   --nf-text-2: #b3a78f;
   --nf-text-2-alpha: rgba(179, 167, 143, 0.7);
   --nf-text-3: #8a7f6c;
-  --nf-accent: #c14a2e;
+  --nf-accent: #c0492d;
   --nf-accent-hover: #d95a3a;
   --nf-accent-soft: rgba(193, 74, 46, 0.14);
   --nf-accent-fg: #fdf3ee;
-  --nf-seal: #c14a2e;
+  --nf-seal: #c0492d;
   --nf-seal-soft: rgba(193, 74, 46, 0.14);
   --nf-ai-soft: rgba(217, 138, 43, 0.12);
   --nf-human-soft: rgba(74, 163, 217, 0.12);
@@ -2703,7 +2703,7 @@ select.input {
   --nf-text: #26221b;
   --nf-text-2: #6f665a;
   --nf-text-2-alpha: rgba(111, 102, 90, 0.72);
-  --nf-text-3: #9c9284;
+  --nf-text-3: #8f8679;
   --nf-accent: #a63e2a;
   --nf-accent-hover: #8c3321;
   --nf-accent-soft: rgba(166, 62, 42, 0.14);

package/src/client/panel/views.tsx

@@ -4,7 +4,7 @@
  */
 import { useCallback, useEffect, useRef, useState } from 'react'
 import type { ReactElement } from 'react'
-import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts'
+import type { Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts'
 import { tt, ROLE_LABELS, roleColor, kindLabel, plotlineStatusLabel, plotlineStatusColor } from './helpers.ts'
 import css from './panel.module.css'
 
@@ -62,75 +62,6 @@ export function SlideNav<T extends string>(props: {
   )
 }
 
-/** 统计格：状态摘要条 / 资产健康通用。 */
-export function StatCell(props: {
-  label: string
-  value: string
-  detail: string
-  /** 值颜色（可选）。 */
-  valueColor?: string
-  /** 值字号覆盖（如长文本用 13）。 */
-  valueFontSize?: number
-  /** detail 悬浮提示（可选）。 */
-  detailTitle?: string
-}): ReactElement {
-  return (
-    <div className={css.assetStat}>
-      <span className={css.assetStatLabel}>{props.label}</span>
-      <span className={css.assetStatValue} style={{ color: props.valueColor, fontSize: props.valueFontSize }}>
-        {props.value}
-      </span>
-      <span className={css.assetStatDetail} title={props.detailTitle}>{props.detail}</span>
-    </div>
-  )
-}
-
-/** 待办队列行。 */
-export function TodoRow(props: {
-  tone: 'danger' | 'warning' | 'info' | 'success'
-  title: string
-  description: string
-  actionLabel: string
-  disabled: boolean
-  onAction: () => void
-}): ReactElement {
-  return (
-    <div className={`${css.todoItem} ${props.tone === 'danger' ? css.todoDanger : props.tone === 'warning' ? css.todoWarning : css.todoInfo}`}>
-      <span className={css.todoText}>
-        {props.title}
-        {props.description !== '' && <span className={css.meta}> — {props.description}</span>}
-      </span>
-      <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={props.disabled} onClick={props.onAction}>
-        {props.actionLabel}
-      </button>
-    </div>
-  )
-}
-
-/** 全书质检问题行。 */
-export function AuditIssueRow(props: {
-  issue: AuditIssue
-  disabled: boolean
-  onFix: () => void
-}): ReactElement {
-  const { issue } = props
-  return (
-    <div className={`${css.todoItem} ${issue.severity === 'high' ? css.todoDanger : issue.severity === 'medium' ? css.todoWarning : css.todoInfo}`}>
-      <span className={css.todoText}>
-        <span>
-          {issue.chapterNo > 0 ? `第 ${issue.chapterNo} 章` : '未定位章节'} · [{issue.severity}] {issue.item}
-        </span>
-        {issue.suggestion !== '' && <span className={css.meta}>建议：{issue.suggestion}</span>}
-      </span>
-      {issue.chapterNo > 0 && (
-        <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={props.disabled} onClick={props.onFix}>
-          去修订
-        </button>
-      )}
-    </div>
-  )
-}
-
 /** 剧情线卡片（列表主体）。 */
 export function PlotlineCard(props: {
   line: Plotline
@@ -383,19 +314,3 @@ export function EmptyState(props: {
     </div>
   )
 }
-
-/** 骨架屏基元：rows 条微光占位行；widths 指定各行宽度档位，循环取用。 */
-export function SkeletonLines(props: {
-  rows?: number
-  widths?: Array<'full' | 'wide' | 'half'>
-}): ReactElement {
-  const rows = props.rows ?? 3
-  const widths = props.widths ?? ['full', 'wide', 'half']
-  return (
-    <div className={css.skeletonLines} aria-hidden="true">
-      {Array.from({ length: rows }, (_, i) => (
-        <span key={i} className={css.skeletonLine} data-w={widths[i % widths.length]} />
-      ))}
-    </div>
-  )
-}