@waterwx/dsh-novel-forge 2.0.0-alpha.1 → 2.0.0

package/src/client/panel/WorldTab.tsx

@@ -1,202 +1,202 @@
-/**
- * 大世界页签：境界体系 / 地理区域 / 势力分布 的结构化编辑 + AI 提炼。
- * 数据注入每章生成与审稿提示词（renderWorld），保证设定不写飞。
- */
-import { useEffect, useState } from 'react'
-import type { NovelApi } from '../api.ts'
-import type { WorldFaction, WorldRealm, WorldRegion, WorldState } from '../../protocol.ts'
-import css from './panel.module.css'
-
-const EMPTY: WorldState = { realms: [], regions: [], factions: [] }
-
-/** 一个可编辑条目行。 */
-function EditableRow({
-  name,
-  detail,
-  onName,
-  onDetail,
-  onRemove,
-  namePlaceholder,
-  detailPlaceholder,
-}: {
-  name: string
-  detail: string
-  onName: (v: string) => void
-  onDetail: (v: string) => void
-  onRemove: () => void
-  namePlaceholder: string
-  detailPlaceholder: string
-}) {
-  return (
-    <div style={{ display: 'flex', gap: 'var(--nf-space-6)', alignItems: 'flex-start' }}>
-      <input className={css.input} style={{ flex: 2, minWidth: 0 }} placeholder={namePlaceholder} value={name} onChange={e => { onName(e.target.value) }} />
-      <input className={css.input} style={{ flex: 3, minWidth: 0 }} placeholder={detailPlaceholder} value={detail} onChange={e => { onDetail(e.target.value) }} />
-      <button type="button" className={`${css.button} ${css.buttonSmall}`} title="删除" onClick={onRemove}>×</button>
-    </div>
-  )
-}
-
-/** 大世界页签。 */
-export function WorldTab({
-  api,
-  world,
-  onChanged,
-}: {
-  api: NovelApi
-  /** 当前项目的大世界数据（可能为空）。 */
-  world: WorldState | undefined
-  /** 保存/提炼成功后由父组件刷新项目状态。 */
-  onChanged: (world: WorldState) => void
-}) {
-  const [draft, setDraft] = useState<WorldState>(() => world ?? EMPTY)
-  const [busy, setBusy] = useState(false)
-  const [error, setError] = useState('')
-
-  // 外部数据变化时同步草稿（提炼/保存/切换书后）。
-  useEffect(() => {
-    setDraft(world ?? EMPTY)
-  }, [world])
-
-  const handleGenerate = async (): Promise<void> => {
-    setBusy(true)
-    setError('')
-    try {
-      const result = await api.world('generate')
-      setDraft(result.world)
-      onChanged(result.world)
-    } catch (err) {
-      setError((err as Error).message)
-    } finally {
-      setBusy(false)
-    }
-  }
-
-  const handleSave = async (): Promise<void> => {
-    setBusy(true)
-    setError('')
-    try {
-      const result = await api.world('save', draft)
-      onChanged(result.world)
-    } catch (err) {
-      setError((err as Error).message)
-    } finally {
-      setBusy(false)
-    }
-  }
-
-  const setRealms = (realms: WorldRealm[]): void => setDraft(prev => ({ ...prev, realms }))
-  const setRegions = (regions: WorldRegion[]): void => setDraft(prev => ({ ...prev, regions }))
-  const setFactions = (factions: WorldFaction[]): void => setDraft(prev => ({ ...prev, factions }))
-
-  return (
-    <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-12)' }}>
-      {error !== '' && <div className={css.card} style={{ borderColor: 'var(--nf-error)' }}><span style={{ color: 'var(--nf-error)' }}>{error}</span></div>}
-
-      <div className={css.card}>
-        <div className={css.row} style={{ justifyContent: 'space-between' }}>
-          <span className={css.cardTitle}>大世界</span>
-          <div className={css.row}>
-            <button type="button" className={`${css.button} ${css.buttonSmall} ${css.buttonPrimary}`} disabled={busy} onClick={() => { void handleGenerate() }}>
-              ✨ AI 提炼
-            </button>
-            <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={() => { void handleSave() }}>
-              💾 保存
-            </button>
-          </div>
-        </div>
-        <span className={css.meta}>
-          境界体系按由低到高排序注入章节生成提示词，模型不得随意跳级或自创境界；区域与势力约束地理/势力设定。AI 提炼不满意可逐条编辑后保存。
-        </span>
-      </div>
-
-      {/* 境界体系 */}
-      <div className={css.card}>
-        <div className={css.row} style={{ justifyContent: 'space-between' }}>
-          <span className={css.cardTitle}>境界体系（{draft.realms.length}）</span>
-          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setRealms([...draft.realms, { name: '', description: '' }]) }}>
-            ＋ 新增境界
-          </button>
-        </div>
-        {draft.realms.length === 0 ? (
-          <span className={css.meta}>暂无境界体系 — 点击 ✨AI 提炼 或手动添加（由低到高）。</span>
-        ) : (
-          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
-            {draft.realms.map((realm, i) => (
-              <EditableRow
-                key={i}
-                name={realm.name}
-                detail={realm.description}
-                onName={v => { const next = [...draft.realms]; next[i] = { ...next[i]!, name: v }; setRealms(next) }}
-                onDetail={v => { const next = [...draft.realms]; next[i] = { ...next[i]!, description: v }; setRealms(next) }}
-                onRemove={() => { setRealms(draft.realms.filter((_, idx) => idx !== i)) }}
-                namePlaceholder={`第 ${i + 1} 阶境界名`}
-                detailPlaceholder="突破条件 / 寿命 / 标志…"
-              />
-            ))}
-          </div>
-        )}
-      </div>
-
-      {/* 地理区域 */}
-      <div className={css.card}>
-        <div className={css.row} style={{ justifyContent: 'space-between' }}>
-          <span className={css.cardTitle}>地理区域（{draft.regions.length}）</span>
-          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setRegions([...draft.regions, { name: '', description: '' }]) }}>
-            ＋ 新增区域
-          </button>
-        </div>
-        {draft.regions.length === 0 ? (
-          <span className={css.meta}>暂无地理区域 — 大陆 / 海域 / 秘境 / 遗迹…</span>
-        ) : (
-          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
-            {draft.regions.map((region, i) => (
-              <EditableRow
-                key={i}
-                name={region.name}
-                detail={region.description}
-                onName={v => { const next = [...draft.regions]; next[i] = { ...next[i]!, name: v }; setRegions(next) }}
-                onDetail={v => { const next = [...draft.regions]; next[i] = { ...next[i]!, description: v }; setRegions(next) }}
-                onRemove={() => { setRegions(draft.regions.filter((_, idx) => idx !== i)) }}
-                namePlaceholder="区域名（如大荒 / 青云山脉）"
-                detailPlaceholder="描述…"
-              />
-            ))}
-          </div>
-        )}
-      </div>
-
-      {/* 势力分布 */}
-      <div className={css.card}>
-        <div className={css.row} style={{ justifyContent: 'space-between' }}>
-          <span className={css.cardTitle}>势力分布（{draft.factions.length}）</span>
-          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setFactions([...draft.factions, { name: '', kind: '宗门', description: '' }]) }}>
-            ＋ 新增势力
-          </button>
-        </div>
-        {draft.factions.length === 0 ? (
-          <span className={css.meta}>暂无势力 — 宗门 / 家族 / 王朝 / 组织…</span>
-        ) : (
-          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
-            {draft.factions.map((faction, i) => (
-              <EditableRow
-                key={i}
-                name={`${faction.name}（${faction.kind}）`}
-                detail={faction.description}
-                onName={v => {
-                  const next = [...draft.factions]
-                  const match = /^(.*)（(.*)）$/.exec(v)
-                  next[i] = { ...next[i]!, name: (match?.[1] ?? v).trim(), kind: (match?.[2] ?? next[i]!.kind).trim() || '宗门' }
-                  setFactions(next)
-                }}
-                onDetail={v => { const next = [...draft.factions]; next[i] = { ...next[i]!, description: v }; setFactions(next) }}
-                onRemove={() => { setFactions(draft.factions.filter((_, idx) => idx !== i)) }}
-                namePlaceholder="势力名（类型）如：青云宗（宗门）"
-                detailPlaceholder="描述…"
-              />
-            ))}
-          </div>
-        )}
-      </div>
-    </div>
-  )
-}
+/**
+ * 大世界页签：境界体系 / 地理区域 / 势力分布 的结构化编辑 + 提炼。
+ * 数据注入每章生成与审稿提示词（renderWorld），保证设定不写飞。
+ */
+import { useEffect, useState } from 'react'
+import type { NovelApi } from '../api.ts'
+import type { WorldFaction, WorldRealm, WorldRegion, WorldState } from '../../protocol.ts'
+import css from './panel.module.css'
+
+const EMPTY: WorldState = { realms: [], regions: [], factions: [] }
+
+/** 一个可编辑条目行。 */
+function EditableRow({
+  name,
+  detail,
+  onName,
+  onDetail,
+  onRemove,
+  namePlaceholder,
+  detailPlaceholder,
+}: {
+  name: string
+  detail: string
+  onName: (v: string) => void
+  onDetail: (v: string) => void
+  onRemove: () => void
+  namePlaceholder: string
+  detailPlaceholder: string
+}) {
+  return (
+    <div style={{ display: 'flex', gap: 'var(--nf-space-6)', alignItems: 'flex-start' }}>
+      <input className={css.input} style={{ flex: 2, minWidth: 0 }} placeholder={namePlaceholder} value={name} onChange={e => { onName(e.target.value) }} />
+      <input className={css.input} style={{ flex: 3, minWidth: 0 }} placeholder={detailPlaceholder} value={detail} onChange={e => { onDetail(e.target.value) }} />
+      <button type="button" className={`${css.button} ${css.buttonSmall}`} title="删除" onClick={onRemove}>×</button>
+    </div>
+  )
+}
+
+/** 大世界页签。 */
+export function WorldTab({
+  api,
+  world,
+  onChanged,
+}: {
+  api: NovelApi
+  /** 当前项目的大世界数据（可能为空）。 */
+  world: WorldState | undefined
+  /** 保存/提炼成功后由父组件刷新项目状态。 */
+  onChanged: (world: WorldState) => void
+}) {
+  const [draft, setDraft] = useState<WorldState>(() => world ?? EMPTY)
+  const [busy, setBusy] = useState(false)
+  const [error, setError] = useState('')
+
+  // 外部数据变化时同步草稿（提炼/保存/切换书后）。
+  useEffect(() => {
+    setDraft(world ?? EMPTY)
+  }, [world])
+
+  const handleGenerate = async (): Promise<void> => {
+    setBusy(true)
+    setError('')
+    try {
+      const result = await api.world('generate')
+      setDraft(result.world)
+      onChanged(result.world)
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const handleSave = async (): Promise<void> => {
+    setBusy(true)
+    setError('')
+    try {
+      const result = await api.world('save', draft)
+      onChanged(result.world)
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  const setRealms = (realms: WorldRealm[]): void => setDraft(prev => ({ ...prev, realms }))
+  const setRegions = (regions: WorldRegion[]): void => setDraft(prev => ({ ...prev, regions }))
+  const setFactions = (factions: WorldFaction[]): void => setDraft(prev => ({ ...prev, factions }))
+
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-12)' }}>
+      {error !== '' && <div className={css.card} style={{ borderColor: 'var(--nf-error)' }}><span style={{ color: 'var(--nf-error)' }}>{error}</span></div>}
+
+      <div className={css.card}>
+        <div className={css.row} style={{ justifyContent: 'space-between' }}>
+          <span className={css.cardTitle}>大世界</span>
+          <div className={css.row}>
+            <button type="button" className={`${css.button} ${css.buttonSmall} ${css.buttonPrimary}`} disabled={busy} onClick={() => { void handleGenerate() }}>
+               提炼
+            </button>
+            <button type="button" className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={() => { void handleSave() }}>
+               保存
+            </button>
+          </div>
+        </div>
+        <span className={css.meta}>
+          境界体系按由低到高排序注入章节生成提示词，模型不得随意跳级或自创境界；区域与势力约束地理/势力设定。提炼不满意可逐条编辑后保存。
+        </span>
+      </div>
+
+      {/* 境界体系 */}
+      <div className={css.card}>
+        <div className={css.row} style={{ justifyContent: 'space-between' }}>
+          <span className={css.cardTitle}>境界体系（{draft.realms.length}）</span>
+          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setRealms([...draft.realms, { name: '', description: '' }]) }}>
+            ＋ 新增境界
+          </button>
+        </div>
+        {draft.realms.length === 0 ? (
+          <span className={css.meta}>暂无境界体系 — 点击 提炼 或手动添加（由低到高）。</span>
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
+            {draft.realms.map((realm, i) => (
+              <EditableRow
+                key={i}
+                name={realm.name}
+                detail={realm.description}
+                onName={v => { const next = [...draft.realms]; next[i] = { ...next[i]!, name: v }; setRealms(next) }}
+                onDetail={v => { const next = [...draft.realms]; next[i] = { ...next[i]!, description: v }; setRealms(next) }}
+                onRemove={() => { setRealms(draft.realms.filter((_, idx) => idx !== i)) }}
+                namePlaceholder={`第 ${i + 1} 阶境界名`}
+                detailPlaceholder="突破条件 / 寿命 / 标志…"
+              />
+            ))}
+          </div>
+        )}
+      </div>
+
+      {/* 地理区域 */}
+      <div className={css.card}>
+        <div className={css.row} style={{ justifyContent: 'space-between' }}>
+          <span className={css.cardTitle}>地理区域（{draft.regions.length}）</span>
+          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setRegions([...draft.regions, { name: '', description: '' }]) }}>
+            ＋ 新增区域
+          </button>
+        </div>
+        {draft.regions.length === 0 ? (
+          <span className={css.meta}>暂无地理区域 — 大陆 / 海域 / 秘境 / 遗迹…</span>
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
+            {draft.regions.map((region, i) => (
+              <EditableRow
+                key={i}
+                name={region.name}
+                detail={region.description}
+                onName={v => { const next = [...draft.regions]; next[i] = { ...next[i]!, name: v }; setRegions(next) }}
+                onDetail={v => { const next = [...draft.regions]; next[i] = { ...next[i]!, description: v }; setRegions(next) }}
+                onRemove={() => { setRegions(draft.regions.filter((_, idx) => idx !== i)) }}
+                namePlaceholder="区域名（如大荒 / 青云山脉）"
+                detailPlaceholder="描述…"
+              />
+            ))}
+          </div>
+        )}
+      </div>
+
+      {/* 势力分布 */}
+      <div className={css.card}>
+        <div className={css.row} style={{ justifyContent: 'space-between' }}>
+          <span className={css.cardTitle}>势力分布（{draft.factions.length}）</span>
+          <button type="button" className={`${css.button} ${css.buttonSmall}`} onClick={() => { setFactions([...draft.factions, { name: '', kind: '宗门', description: '' }]) }}>
+            ＋ 新增势力
+          </button>
+        </div>
+        {draft.factions.length === 0 ? (
+          <span className={css.meta}>暂无势力 — 宗门 / 家族 / 王朝 / 组织…</span>
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-6)' }}>
+            {draft.factions.map((faction, i) => (
+              <EditableRow
+                key={i}
+                name={`${faction.name}（${faction.kind}）`}
+                detail={faction.description}
+                onName={v => {
+                  const next = [...draft.factions]
+                  const match = /^(.*)（(.*)）$/.exec(v)
+                  next[i] = { ...next[i]!, name: (match?.[1] ?? v).trim(), kind: (match?.[2] ?? next[i]!.kind).trim() || '宗门' }
+                  setFactions(next)
+                }}
+                onDetail={v => { const next = [...draft.factions]; next[i] = { ...next[i]!, description: v }; setFactions(next) }}
+                onRemove={() => { setFactions(draft.factions.filter((_, idx) => idx !== i)) }}
+                namePlaceholder="势力名（类型）如：青云宗（宗门）"
+                detailPlaceholder="描述…"
+              />
+            ))}
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}

package/src/client/panel/helpers.ts

@@ -1,13 +1,15 @@
 /**
- * Tiny translation helper for the panel: reads the zh dict with the en dict
- * as fallback (the family plugins use a full locale registry; the panel keeps
- * a dependency-free helper so the client bundle stays self-contained).
+ * Tiny translation helper for the panel.
+ *
+ * 面板是中文单语界面：文案只在 `locales.ts` 定义一次，这里按类型化键位取值
+ * （键位不匹配会在编译期报错），保持客户端 bundle 自包含、不引入运行时语言服务。
+ * 需要多语言时再接入 DSH 的 locale 服务，届时只需替换本函数实现。
  */
-import { zh, en, type NovelKey } from '../locales.ts'
+import { zh, type NovelKey } from '../locales.ts'
 
 /** Translate one key with optional {placeholder} substitution. */
 export function tt(key: NovelKey, params?: Record<string, string | number>): string {
-  let text: string = zh[key] ?? en[key] ?? key
+  let text: string = zh[key] ?? key
   if (params !== undefined) {
     for (const [name, value] of Object.entries(params)) {
       text = text.replaceAll(`{${name}}`, String(value))

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
+}