@waterwx/dsh-novel-forge 1.7.2 → 1.8.0

package/src/client/panel/StoryboardTab.tsx

@@ -5,8 +5,25 @@
 import { useEffect, useMemo, useRef, useState } from 'react'
 import type { NovelApi } from '../api.ts'
 import type { ChapterPlan, ProjectState, StoryboardPrompt, StoryboardSkeleton, StoryboardTable } from '../../protocol.ts'
+import {
+  sizeZh, cameraZh, compoZh, lightZh,
+  normalizeShotSize, normalizeCameras, normalizeComposition, normalizeLightings,
+} from '../../shot-language.ts'
+import { functionZh, emotionZh, normalizeStoryFunction, normalizeEmotions } from '../../story-beat-language.ts'
+import type { StoryboardShot } from '../../protocol.ts'
 import css from './panel.module.css'
 
+/** 归一化旧分镜数据：把自由文本 shot/camera/light/composition 转成词库枚举。 */
+function normalizeStoryboardShot(s: StoryboardShot): StoryboardShot {
+  return {
+    ...s,
+    shot: normalizeShotSize(typeof s.shot === 'string' ? s.shot : undefined),
+    camera: normalizeCameras(typeof s.camera === 'string' ? s.camera : undefined),
+    composition: typeof s.composition === 'string' ? normalizeComposition(s.composition) : s.composition,
+    light: normalizeLightings(typeof s.light === 'string' ? s.light : undefined),
+  }
+}
+
 export function StoryboardTab({
   api,
   project,
@@ -76,8 +93,23 @@ export function StoryboardTab({
     if (chapterNo === null) return
     if (suppressRestoreRef.current === true) return
     const entry = (project?.storyboards ?? []).find(e => e.chapterNo === chapterNo)
-    setSkeleton(prev => prev ?? entry?.skeleton ?? null)
-    setTable(prev => prev ?? entry?.table ?? null)
+    setSkeleton(prev => {
+      if (prev !== null) return prev
+      if (entry?.skeleton === undefined) return null
+      return {
+        ...entry.skeleton,
+        beats: (entry.skeleton.beats ?? []).map(b => ({
+          ...b,
+          function: normalizeStoryFunction(typeof b.function === 'string' ? b.function : undefined),
+          emotion: normalizeEmotions(typeof b.emotion === 'string' ? b.emotion : b.emotion?.join('→')),
+        })),
+      }
+    })
+    setTable(prev => {
+      if (prev !== null) return prev
+      if (entry?.table === undefined) return null
+      return { ...entry.table, shots: (entry.table.shots ?? []).map(normalizeStoryboardShot) }
+    })
     setPrompts(prev => prev ?? entry?.prompts ?? null)
   }, [chapterNo, project?.storyboards])
 
@@ -268,8 +300,8 @@ export function StoryboardTab({
             <div key={b.id} style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-4)', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-10)', padding: 'var(--nf-space-8) var(--nf-space-10)' }}>
               <div className={css.row} style={{ flexWrap: 'wrap' }}>
                 <b>节拍 {i + 1}</b>
-                <span className={`${css.badge} ${b.function === '高潮' ? css.badgeDone : b.function === '转折' ? css.badgeWritten : css.badgePending}`}>{b.function}</span>
-                <span className={css.meta}>{b.emotion}</span>
+                <span className={`${css.badge} ${b.function === 'climax' ? css.badgeDone : b.function === 'turn' ? css.badgeWritten : css.badgePending}`}>{functionZh(b.function)}</span>
+                <span className={css.meta}>💭 {emotionZh(b.emotion)}</span>
               </div>
               <span>{b.event}</span>
               {b.cause !== undefined && <span className={css.meta}>承接：{b.cause}</span>}
@@ -280,7 +312,7 @@ export function StoryboardTab({
               type="button"
               className={`${css.button} ${css.buttonSmall}`}
               onClick={() => {
-                const text = `第${skeleton.chapterNo}章 弧线：${skeleton.arc}\n出场角色：${skeleton.characters !== undefined && skeleton.characters.length > 0 ? skeleton.characters.join('、') : '（未标注）'}\n\n` + skeleton.beats.map((b, i) => `${i + 1}. [${b.function}] ${b.event}（情绪：${b.emotion}）${b.cause !== undefined ? `［承接：${b.cause}］` : ''}`).join('\n')
+                const text = `第${skeleton.chapterNo}章 弧线：${skeleton.arc}\n出场角色：${skeleton.characters !== undefined && skeleton.characters.length > 0 ? skeleton.characters.join('、') : '（未标注）'}\n\n` + skeleton.beats.map((b, i) => `${i + 1}. [${functionZh(b.function)}] ${b.event}（情绪：${emotionZh(b.emotion)}）${b.cause !== undefined ? `［承接：${b.cause}］` : ''}`).join('\n')
                 void navigator.clipboard?.writeText(text)
               }}
             >
@@ -318,7 +350,7 @@ export function StoryboardTab({
               onClick={() => {
                 const text = table.shots.map(s => {
                   const beat = skeleton?.beats.find(b => b.id === s.beatId)
-                  return `镜头 ${s.id}（节拍 ${beat?.id ?? s.beatId} · ${s.shot} · ${s.camera} · ${s.duration}s）\n出场：${s.characters !== undefined && s.characters.length > 0 ? s.characters.join('、') : '（未标注）'}\n定妆：${s.mangaRoleIds !== undefined && s.mangaRoleIds.length > 0 ? bindingNames(s.mangaRoleIds) : '（未绑定漫剧卡）'}\n画面：${s.visual}\n台词：${s.line !== '' ? s.line : '（无）'}\n音效：${s.sound !== '' ? s.sound : '（无）'}\n光效：${s.light !== '' ? s.light : '（无）'}\n承接：${s.prevState} → ${s.nextState}`
+                  return `镜头 ${s.id}（节拍 ${beat?.id ?? s.beatId} · ${sizeZh(s.shot)} · ${cameraZh(s.camera)} · ${s.duration}s）\n出场：${s.characters !== undefined && s.characters.length > 0 ? s.characters.join('、') : '（未标注）'}\n定妆：${s.mangaRoleIds !== undefined && s.mangaRoleIds.length > 0 ? bindingNames(s.mangaRoleIds) : '（未绑定漫剧卡）'}\n画面：${s.visual}\n台词：${s.line !== '' ? s.line : '（无）'}\n音效：${s.sound !== '' ? s.sound : '（无）'}\n光效：${lightZh(s.light) !== '' ? lightZh(s.light) : '（无）'}\n承接：${s.prevState} → ${s.nextState}`
                 }).join('\n\n')
                 void navigator.clipboard?.writeText(`第${table.chapterNo}章分镜表\n\n` + text)
               }}
@@ -357,9 +389,9 @@ export function StoryboardTab({
               <div key={s.id} style={{ display: 'flex', flexDirection: 'column', gap: 'var(--nf-space-4)', border: '1px solid var(--nf-border)', borderRadius: 'var(--nf-radius-10)', padding: 'var(--nf-space-8) var(--nf-space-10)' }}>
                 <div className={css.row} style={{ flexWrap: 'wrap' }}>
                   <b>镜头 {s.id}</b>
-                  <span className={css.badge}>{s.shot}</span>
-                  <span className={css.meta}>{s.camera} · {s.duration}s</span>
-                  {beat !== undefined && <span className={css.meta}>节拍 {beat.id}「{beat.function}」</span>}
+                  <span className={css.badge}>{sizeZh(s.shot)}</span>
+                  <span className={css.meta}>{cameraZh(s.camera)}{compoZh(s.composition) !== '' ? ' · ' + compoZh(s.composition) : ''} · {s.duration}s</span>
+                  {beat !== undefined && <span className={css.meta}>节拍 {beat.id}「{functionZh(beat.function)}」</span>}
                   {s.characters !== undefined && s.characters.length > 0 && (
                     <span className={css.meta}>👥 {s.characters.join('、')}</span>
                   )}
@@ -371,7 +403,7 @@ export function StoryboardTab({
                 <div className={css.row} style={{ flexWrap: 'wrap' }}>
                   <span className={css.meta}>💬 {s.line !== '' ? s.line : '（无台词）'}</span>
                   <span className={css.meta}>🔊 {s.sound !== '' ? s.sound : '（无音效）'}</span>
-                  <span className={css.meta}>💡 {s.light !== '' ? s.light : '（无光效）'}</span>
+                  <span className={css.meta}>💡 {lightZh(s.light) !== '' ? lightZh(s.light) : '（无光效）'}</span>
                 </div>
                 <span className={css.meta}>承接：{s.prevState} → {s.nextState}</span>
               </div>

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

@@ -41,6 +41,8 @@ body[data-ds-dark-theme] .entry {
   align-items: center;
   justify-content: center;
   flex-shrink: 0;
+  width: 20px;
+  height: 20px;
 }
 
 .entryLabel {
@@ -658,6 +660,7 @@ body[data-ds-dark-theme] .panel[data-nf-theme='neumorph'] .buttonPrimary {
   z-index: 0;
   pointer-events: none;
   background:
+    linear-gradient(rgba(0, 0, 0, calc(var(--nf-glass-bg-dim, 0) / 100)), rgba(0, 0, 0, calc(var(--nf-glass-bg-dim, 0) / 100))),
     var(--nf-glass-bg-image, none) center / cover no-repeat,
     radial-gradient(46% 36% at 18% 12%, var(--nf-glass-orb-a), transparent 70%),
     radial-gradient(52% 42% at 88% 22%, var(--nf-glass-orb-b), transparent 72%),
@@ -981,6 +984,10 @@ body[data-ds-dark-theme] .panel[data-nf-theme='neumorph'] .buttonPrimary {
 .navTabIcon {
   flex: none;
   width: 22px;
+  height: 22px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
   text-align: center;
   font-size: var(--nf-fs-16, 17px);
   line-height: 1;
@@ -2079,6 +2086,28 @@ select.input {
   gap: var(--nf-space-10, 10px);
 }
 
+/* 按分类分组的资产列表 */
+.assetGroups {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-14, 14px);
+}
+.assetGroup {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-10, 10px);
+}
+.assetGroupHeader {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--nf-accent);
+  padding-bottom: 2px;
+  border-bottom: 1px solid var(--nf-glass-border);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
 .assetStat {
   border: 1px solid var(--nf-glass-border);
   border-radius: var(--nf-radius-14, 14px);
@@ -2498,6 +2527,279 @@ select.input {
   gap: var(--nf-container-gap, 14px);
 }
 
+/* ---- 作者级首页（书架左侧导航 + 内容区） ---- */
+.authorHome {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  overflow: hidden;
+  position: relative;
+  z-index: 1;
+}
+.authorRail {
+  width: 180px;
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px 10px;
+  border-right: 1px solid var(--nf-glass-border);
+  background: var(--nf-glass-face);
+}
+.authorRailTitle {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-weight: 600;
+  padding: 4px 8px 12px;
+  color: var(--nf-accent);
+}
+.authorRailBtn {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 12px;
+  border-radius: 10px;
+  background: transparent;
+  border: 1px solid transparent;
+  color: var(--nf-text);
+  cursor: pointer;
+  text-align: left;
+  width: 100%;
+  font-size: 14px;
+}
+.authorRailBtn:hover { background: color-mix(in srgb, var(--nf-accent) 12%, transparent); color: var(--nf-text); }
+.authorRailBtnActive {
+  background: color-mix(in srgb, var(--nf-accent) 16%, var(--nf-glass-face));
+  border-color: var(--nf-accent);
+  color: var(--nf-accent);
+  font-weight: 600;
+  box-shadow: inset 0 0 0 1px var(--nf-accent);
+}
+.authorRailAbout { padding: 8px 12px; }
+.authorContent { flex: 1; min-width: 0; display: flex; flex-direction: column; overflow: hidden; }
+
+/* ---- 作者级页面通用 ---- */
+.authorPageBody {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: var(--nf-container-pad, 20px 22px);
+  overflow: auto;
+  flex: 1;
+  min-height: 0;
+}
+.authorPageHeader {
+  display: flex;
+  align-items: flex-end;
+  justify-content: space-between;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.authorPageHero {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nf-space-12, 12px);
+  padding: var(--nf-card-pad, 20px 22px);
+  border: 1px solid var(--nf-glass-border);
+  border-radius: var(--nf-radius-22, 22px);
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1.5px 0 var(--nf-glass-sheen);
+  -webkit-backdrop-filter: blur(26px) saturate(175%);
+  backdrop-filter: blur(26px) saturate(175%);
+}
+.noticeError {
+  padding: 10px 14px;
+  border-radius: 10px;
+  background: color-mix(in srgb, var(--nf-error) 14%, transparent);
+  color: var(--nf-error);
+  border: 1px solid var(--nf-error);
+}
+.rowEnd { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+
+/* ---- 作者资产库 ---- */
+.assetFilterBar { display: flex; flex-wrap: wrap; gap: 8px; }
+.assetFilterChip {
+  padding: 4px 10px;
+  border-radius: 999px;
+  border: 1px solid var(--nf-glass-border);
+  background: transparent;
+  color: var(--nf-text);
+  cursor: pointer;
+}
+.assetFilterChipActive { background: var(--nf-accent); color: #fff; border-color: transparent; }
+.assetEditor {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 16px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.assetEditorRow { display: flex; gap: 12px; flex-wrap: wrap; }
+.assetLabel {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--nf-muted);
+  flex: 1;
+  min-width: 180px;
+}
+.assetTextarea { min-height: 160px; resize: vertical; font-family: inherit; }
+.assetGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  gap: 14px;
+}
+.assetCard {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1px 0 var(--nf-glass-sheen);
+}
+.assetCardTop { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
+.assetKind { font-size: 12px; font-weight: 600; }
+.assetCardName { font-weight: 600; }
+.assetCardContent { white-space: pre-wrap; font-size: 13px; color: var(--nf-text); max-height: 150px; overflow: auto; }
+.assetCardFooter { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
+.iconBtn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 4px;
+  border: 1px solid transparent;
+  background: transparent;
+  border-radius: 8px;
+  color: var(--nf-text);
+  cursor: pointer;
+}
+.iconBtn:hover { background: rgba(0,0,0,0.06); }
+
+/* ---- 改编模式 ---- */
+.adaptInputCard {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 16px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.adaptTextarea { min-height: 220px; resize: vertical; }
+.adaptResult { display: flex; flex-direction: column; gap: 14px; }
+.adaptOutline {
+  padding: 10px 14px;
+  border-radius: 12px;
+  background: var(--nf-glass-face);
+  border: 1px solid var(--nf-glass-border);
+}
+.adaptMatrix {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+  gap: 12px;
+}
+.dimCard {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.dimCardHead { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+.dimTitle { font-weight: 600; }
+.dimCurrent { font-size: 13px; white-space: pre-wrap; }
+.dimCardSelected { border-color: var(--nf-accent); box-shadow: 0 0 0 1px var(--nf-accent); }
+.dimEdit { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
+.adaptOutlinePre { white-space: pre-wrap; font-size: 13px; max-height: 260px; overflow: auto; margin: 0; font-family: inherit; }
+.adaptProposal {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.adaptTable { width: 100%; border-collapse: collapse; font-size: 13px; }
+.adaptTable th, .adaptTable td { border: 1px solid var(--nf-glass-border); padding: 6px 8px; text-align: left; }
+.adaptImpacts { display: flex; flex-direction: column; gap: 4px; }
+.adaptImpact { font-size: 13px; }
+
+/* ---- 首页 AI 进度 ---- */
+.progressOverview {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: 12px;
+}
+.progressOverviewCard {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+  box-shadow: var(--nf-shadow), inset 0 1px 0 var(--nf-glass-sheen);
+}
+.progressOverviewNum {
+  font-size: 24px;
+  font-weight: 700;
+  color: var(--nf-accent);
+}
+.progressTotalBar {
+  position: relative;
+  height: 14px;
+  border-radius: 999px;
+  background: var(--nf-glass-face);
+  border: 1px solid var(--nf-glass-border);
+  overflow: hidden;
+}
+.progressTotalFill {
+  position: absolute;
+  inset: 0 auto 0 0;
+  height: 100%;
+  background: linear-gradient(90deg, var(--nf-accent), var(--nf-info));
+  border-radius: 999px;
+}
+.progressTotalBar .meta {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--nf-text);
+}
+.progressBookList {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.progressBook {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border: 1px solid var(--nf-glass-border);
+  border-radius: 14px;
+  background: var(--nf-glass-face);
+}
+.progressBookActive { border-color: var(--nf-accent); box-shadow: 0 0 0 1px var(--nf-accent); }
+.progressBookHead { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+.progressBookName { font-weight: 600; }
+.progressLive { color: var(--nf-accent); font-weight: 600; }
+.progressBookBar { height: 8px; border-radius: 999px; background: var(--nf-glass-face-hover, rgba(0,0,0,0.05)); overflow: hidden; }
+.progressBookFill { height: 100%; background: var(--nf-accent); border-radius: 999px; }
+
 .shelfHeader {
   display: flex;
   flex-direction: column;
@@ -3847,3 +4149,26 @@ select.input {
 .switchOn .switchKnob {
   transform: translateX(18px);
 }
+
+/* ---- 玻璃透明度滑块：实色主题（新拟态/黏土）调低时变透，透出背景图 ---- */
+/* 默认 --nf-glass-opacity=100%，color-mix 透明 0% → 与主题原值一致，不改动现有效果。 */
+.panel[data-nf-theme='neumorph']:not([data-nf-mode='dark']),
+body:not([data-ds-dark-theme]) .panel[data-nf-theme='neumorph'][data-nf-mode='light'] {
+  --nf-glass-face: color-mix(in srgb, #e4e9f2, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #e4e9f2, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-mode='dark'][data-nf-theme='neumorph'],
+body[data-ds-dark-theme] .panel[data-nf-theme='neumorph']:not([data-nf-mode]) {
+  --nf-glass-face: color-mix(in srgb, #2b2f36, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #2b2f36, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-theme='clay']:not([data-nf-mode='dark']),
+body:not([data-ds-dark-theme]) .panel[data-nf-theme='clay'][data-nf-mode='light'] {
+  --nf-glass-face: color-mix(in srgb, #efe4d6, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #efe4d6, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}
+.panel[data-nf-mode='dark'][data-nf-theme='clay'],
+body[data-ds-dark-theme] .panel[data-nf-theme='clay']:not([data-nf-mode]) {
+  --nf-glass-face: color-mix(in srgb, #37302b, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+  --nf-bg-raise: color-mix(in srgb, #37302b, transparent calc(100% - var(--nf-glass-opacity, 100%)));
+}

package/src/client/sidebar-entry.ts

@@ -11,7 +11,7 @@ import css from './panel/panel.module.css'
 export const ENTRY_SELECTOR = '[data-dsh-novelforge-entry]'
 
 /** Inline icon: an open book / writing glyph. */
-const ICON = '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 3.5h4a2 2 0 0 1 2 2v7a2 2 0 0 0-2-2h-4z"/><path d="M13.5 3.5h-4a2 2 0 0 0-2 2v7a2 2 0 0 1 2-2h4z"/><path d="M8 5.5v7"/></svg>'
+const ICON = '<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12.67 19a2 2 0 0 0 1.416-.588l6.154-6.172a6 6 0 0 0-8.49-8.49L5.586 9.914A2 2 0 0 0 5 11.328V18a1 1 0 0 0 1 1z"/><path d="M16 8 2 22"/><path d="M17.5 15H9"/></svg>'
 
 /** Find the sidebar shell root element. */
 function sidebarRoot(): HTMLElement | undefined {

package/src/client/text.ts

@@ -0,0 +1,28 @@
+/**
+ * 客户端文件文本智能解码：兼容 UTF-8 BOM / UTF-16 / UTF-8 / GB18030(GBK)。
+ * 浏览器 File.text() 固定按 UTF-8 解码，GBK 中文网文 txt 会乱码，这里兜底。
+ */
+
+/**
+ * 读取一个 File 的文本，按编码探测兜底解码。
+ * @returns 解码后的文本。
+ */
+export async function readFileTextSmart(file: File): Promise<string> {
+  const buf = await file.arrayBuffer()
+  const u8 = new Uint8Array(buf)
+  // UTF-8 BOM
+  if (u8.length >= 3 && u8[0] === 0xEF && u8[1] === 0xBB && u8[2] === 0xBF) {
+    return new TextDecoder('utf-8').decode(u8.subarray(3))
+  }
+  // UTF-16 LE / BE
+  if (u8.length >= 2 && u8[0] === 0xFF && u8[1] === 0xFE) return new TextDecoder('utf-16le').decode(u8.subarray(2))
+  if (u8.length >= 2 && u8[0] === 0xFE && u8[1] === 0xFF) return new TextDecoder('utf-16be').decode(u8.subarray(2))
+  // UTF-8（宽松），含替换符则回退 GB18030
+  const utf8 = new TextDecoder('utf-8', { fatal: false }).decode(u8)
+  if (!utf8.includes('\uFFFD')) return utf8
+  try {
+    return new TextDecoder('gb18030').decode(u8)
+  } catch {
+    return utf8
+  }
+}