@waterwx/dsh-novel-forge 0.1.0 → 1.1.0

package/src/client/locales.ts

@@ -5,7 +5,7 @@
 /** zh dictionary. */
 export const zh = {
   'entry.label': '小说工坊',
-  'entry.tooltip': 'AI 编译小说工作台：大纲 → 设定圣经 → 卷计划 → 章节计划 → 逐章生成+审稿',
+  'entry.tooltip': 'AI 编译小说工作台：总纲 → 道藏 → 卷计划 → 章节计划 → 逐章生成+审稿',
   'panel.title': '小说工坊',
   'common.close': '关闭',
   'common.loading': '加载中…',
@@ -15,36 +15,36 @@ export const zh = {
   'common.generating': '生成中…',
   'common.chars': '字',
   'tab.workflow': '工作流',
-  'tab.overview': '大纲',
+  'tab.overview': '总纲',
   'tab.plan': '章节',
-  'tab.bible': '设定库',
-  'tab.foreshadow': '伏笔',
+  'tab.bible': '道藏',
+  'tab.foreshadow': '暗线',
   'tab.assistant': 'AI 助手',
   'tab.settings': '设置',
   'workflow.title': '创作工作流',
-  'workflow.step1': '① 加载大纲',
-  'workflow.step2': '② 提炼设定圣经',
+  'workflow.step1': '① 加载总纲',
+  'workflow.step2': '② 提炼道藏',
   'workflow.step3': '③ 规划卷',
   'workflow.step4': '④ 生成章节计划',
   'workflow.step5': '⑤ 逐章写作 + AI 审稿',
   'workflow.step6': '⑥ 润色 / 导出',
-  'workflow.loadOutline': '读取大纲',
-  'workflow.genBible': '提炼设定圣经',
+  'workflow.loadOutline': '读取总纲',
+  'workflow.genBible': '提炼道藏',
   'workflow.genVolumes': '生成卷计划',
   'workflow.genPlan': '生成章节计划',
   'workflow.done': '已完成',
   'workflow.todo': '待办',
-  'workflow.bibleDone': '设定圣经已生成（{n} 条规则 / {c} 个角色 / {r} 条红线）',
+  'workflow.bibleDone': '道藏已生成（{n} 条规则 / {c} 个人物 / {r} 条红线）',
   'workflow.volumesDone': '卷计划已生成（{n} 卷）',
   'workflow.planDone': '章节计划已生成（{n} 章）',
-  'workflow.progress': '进度：大纲 ✓ · 设定 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章',
-  'overview.loadDocx': '从 docx 读取大纲',
-  'overview.loadDocxDefault': '读取默认大纲',
+  'workflow.progress': '进度：总纲 ✓ · 道藏 {bible} · 卷 {volumes} · 计划 {plan} · 已完成 {done}/{total} 章',
+  'overview.loadDocx': '从 docx 读取总纲',
+  'overview.loadDocxDefault': '读取默认总纲',
   'overview.loadingOutline': '正在解析 docx…',
-  'overview.outlineHint': '大纲文本（可编辑）',
-  'overview.outlineChars': '大纲字数',
-  'overview.saveOutline': '保存大纲',
-  'overview.saved': '大纲已保存',
+  'overview.outlineHint': '总纲文本（可编辑）',
+  'overview.outlineChars': '总纲字数',
+  'overview.saveOutline': '保存总纲',
+  'overview.saved': '总纲已保存',
   'overview.bookName': '书名',
   'overview.loadCustom': '指定 docx 路径',
   'overview.loadCustomHint': '绝对路径，留空使用默认',
@@ -79,17 +79,17 @@ export const zh = {
   'plan.summary': '章节摘要',
   'plan.volumes': '卷',
   'plan.noVolume': '未分卷',
-  'bible.title': '设定圣经',
-  'bible.gen': 'AI 提炼设定圣经',
+  'bible.title': '道藏',
+  'bible.gen': 'AI 提炼道藏',
   'bible.genre': '题材基调',
   'bible.worldRules': '世界规则',
-  'bible.characters': '角色卡',
+  'bible.characters': '人物志',
   'bible.redLines': '写作红线',
   'bible.style': '风格要求',
-  'bible.none': '尚未生成设定圣经。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。',
-  'foreshadow.title': '伏笔管理',
-  'foreshadow.suggest': 'AI 建议伏笔',
-  'foreshadow.none': '暂无伏笔',
+  'bible.none': '尚未生成道藏。生成后写作会严格遵守人设与金手指规则，审稿也会按红线检查。',
+  'foreshadow.title': '暗线管理',
+  'foreshadow.suggest': 'AI 建议暗线',
+  'foreshadow.none': '暂无暗线',
   'foreshadow.status': '状态',
   'foreshadow.planned': '计划中',
   'foreshadow.planted': '已埋设',
@@ -123,7 +123,7 @@ export const zh = {
   'progress.rewriting': '正在修订第 {no} 章…',
   'progress.polishing': '正在润色第 {no} 章…',
   'progress.empty': '生成/审稿进度将显示在这里',
-  'assistant.hint': '和 AI 编辑讨论剧情、人设、伏笔；达成一致后可让它直接修改大纲、设定圣经、章节内容。',
+  'assistant.hint': '和 AI 编辑讨论剧情、人设、暗线；达成一致后可让它直接修改总纲、道藏、章节内容。',
   'assistant.placeholder': '例如：我想让第 2 章结尾加一个悬念——墟境里传来爷爷的声音…',
   'assistant.send': '发送',
   'assistant.toolStart': '⚙ 执行操作：{name}…',

package/src/client/panel/AssetsTab.tsx

@@ -11,6 +11,8 @@ import css from './panel.module.css'
 /** Props. */
 export interface AssetsTabProps {
   api: NovelApi
+  /** 初始子页（左侧导航直达对应资产分类）。 */
+  initialTab?: AssetSubTab
 }
 
 /** 渲染题材树（带勾选当前题材）。 */
@@ -21,7 +23,14 @@ function GenreTree({ node, selected, onSelect }: { node: GenreNode; selected: st
         <input type="radio" name="genre" checked={selected === node.name} onChange={() => { onSelect(node) }} />
         <span>
           <b>{node.name}</b>
-          {node.description !== '' && <span className={css.meta}> — {node.description}</span>}
+          {node.description !== '' && (
+            <span
+              className={`${css.meta} ${css.genreDesc}`}
+              title={node.description}
+            >
+              — {node.description}
+            </span>
+          )}
         </span>
       </label>
       {node.children.length > 0 && (
@@ -42,14 +51,14 @@ type AssetSubTab = 'genre' | 'progression' | 'templates' | 'rules' | 'style'
 const SUB_TABS: ReadonlyArray<{ id: AssetSubTab; label: string }> = [
   { id: 'genre', label: '题材基底' },
   { id: 'progression', label: '推进模式' },
-  { id: 'templates', label: '预置写法' },
-  { id: 'rules', label: '反 AI 规则' },
-  { id: 'style', label: '自定义写法' },
+  { id: 'templates', label: '笔法帖' },
+  { id: 'rules', label: '文戒' },
+  { id: 'style', label: '心法' },
 ]
 
 /** 写作资产页签。 */
-export function AssetsTab({ api }: AssetsTabProps) {
-  const [assetTab, setAssetTab] = useState<AssetSubTab>('genre')
+export function AssetsTab({ api, initialTab = 'genre' }: AssetsTabProps) {
+  const [assetTab, setAssetTab] = useState<AssetSubTab>(initialTab)
   const [data, setData] = useState<AssetsResponse | null>(null)
   const [busy, setBusy] = useState(false)
   const [error, setError] = useState('')
@@ -58,6 +67,8 @@ export function AssetsTab({ api }: AssetsTabProps) {
   const [styleName, setStyleName] = useState('')
   const [newRule, setNewRule] = useState('')
   const [newProgression, setNewProgression] = useState('')
+  /** 正在行内编辑的自定义反 AI 规则（下标 + 草稿字段）。 */
+  const [editingRule, setEditingRule] = useState<{ index: number; name: string; avoid: string; fix: string } | null>(null)
   const loadId = useRef(0)
 
   /** Load assets (or reset from a new call). */
@@ -135,6 +146,39 @@ export function AssetsTab({ api }: AssetsTabProps) {
     setNewRule('')
   }
 
+  /** 保存行内编辑的自定义规则。 */
+  const handleSaveRuleEdit = async (): Promise<void> => {
+    if (editingRule === null) return
+    const rules = [...(data?.projectAssets.antiAiRules ?? [])]
+    if (editingRule.index < 0 || editingRule.index >= rules.length) return
+    const name = editingRule.name.trim() || rules[editingRule.index]!.name
+    if (editingRule.avoid.trim() === '' && editingRule.fix.trim() === '') return
+    rules[editingRule.index] = { name, avoid: editingRule.avoid.trim(), fix: editingRule.fix.trim() }
+    await patch({ antiAiRules: rules })
+    setEditingRule(null)
+  }
+
+  /** 删除一条自定义规则。 */
+  const handleRemoveRule = async (index: number): Promise<void> => {
+    const rules = [...(data?.projectAssets.antiAiRules ?? [])]
+    rules.splice(index, 1)
+    setEditingRule(null)
+    await patch({ antiAiRules: rules })
+  }
+
+  /** 把内置规则复制为自定义副本（同名覆盖生效），并打开行内编辑。 */
+  const handleOverrideBuiltin = (rule: AntiAiRule): void => {
+    const rules = data?.projectAssets.antiAiRules ?? []
+    const existing = rules.findIndex(r => r.name === rule.name)
+    if (existing >= 0) {
+      setEditingRule({ index: existing, name: rules[existing]!.name, avoid: rules[existing]!.avoid, fix: rules[existing]!.fix ?? '' })
+    } else {
+      const next = [...rules, { ...rule, fix: rule.fix ?? '' }]
+      setEditingRule({ index: next.length - 1, name: rule.name, avoid: rule.avoid, fix: rule.fix ?? '' })
+      void patch({ antiAiRules: next })
+    }
+  }
+
   /** 设置题材。 */
   const handleSelectGenre = (node: GenreNode): void => {
     void patch({ genre: node })
@@ -165,21 +209,30 @@ export function AssetsTab({ api }: AssetsTabProps) {
       {error !== '' && <div className={css.card} style={{ borderColor: 'var(--nf-error)' }}><span style={{ color: 'var(--nf-error)' }}>{tt('common.error')}: {error}</span></div>}
       {notice !== '' && <div className={css.card}><span style={{ color: 'var(--nf-success)' }}>{notice}</span></div>}
 
-      {/* 子页签栏 */}
-      <div className={css.tabBar} role="tablist" style={{ padding: '0 0 8px', borderBottom: '1px solid var(--nf-border)' }}>
-        {SUB_TABS.map(tab => (
-          <button
-            key={tab.id}
-            type="button"
-            role="tab"
-            aria-selected={assetTab === tab.id}
-            data-active={assetTab === tab.id ? '' : undefined}
-            className={css.tab}
-            onClick={() => { setAssetTab(tab.id) }}
-          >
-            {tab.label}
-          </button>
-        ))}
+      {/* 资产状态总览（参照 AI-Novel-Writing-Assistant 状态网格） */}
+      <div className={css.assetGrid}>
+        <div className={css.assetStat}>
+          <span className={css.assetStatLabel}>当前题材</span>
+          <span className={css.assetStatValue}>{assets.genre?.name ?? '未设置'}</span>
+          {assets.genre !== undefined && <span className={css.assetStatDetail} title={assets.genre.description}>{assets.genre.description}</span>}
+        </div>
+        <div className={css.assetStat}>
+          <span className={css.assetStatLabel}>主推进模式</span>
+          <span className={css.assetStatValue}>{assets.primaryProgression?.name ?? '未设置'}</span>
+          {assets.primaryProgression !== undefined && <span className={css.assetStatDetail} title={assets.primaryProgression.driver}>{assets.primaryProgression.driver}</span>}
+        </div>
+        <div className={css.assetStat}>
+          <span className={css.assetStatLabel}>已绑定写法</span>
+          <span className={css.assetStatValue}>{assets.styleAssets?.length ?? 0} 套</span>
+          <span className={css.assetStatDetail} title={(assets.styleAssets ?? []).map(s => s.name).join('、')}>
+            {(assets.styleAssets ?? []).map(s => s.name).join('、') || '未绑定（可在「笔法帖」一键选用）'}
+          </span>
+        </div>
+        <div className={css.assetStat}>
+          <span className={css.assetStatLabel}>文戒</span>
+          <span className={css.assetStatValue}>{builtinRules.length} 内置 + {(assets.antiAiRules ?? []).length} 自定义</span>
+          <span className={css.assetStatDetail}>全部生效于生成与审稿提示词</span>
+        </div>
       </div>
 
       {/* 题材基底库 */}
@@ -192,7 +245,8 @@ export function AssetsTab({ api }: AssetsTabProps) {
               <b>当前题材：{assets.genre.name}</b> — {assets.genre.description}
             </div>
           )}
-          <div style={{ display: 'flex', flexDirection: 'column', gap: 8, maxHeight: 340, overflowY: 'auto' }}>
+          {/* 题材基底库：自然展开，不套内部滚动条（描述两行截断，悬停看全文） */}
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
             {genreLibrary.map(root => <GenreTree key={root.name} node={root} selected={assets.genre?.name ?? ''} onSelect={handleSelectGenre} />)}
           </div>
         </div>
@@ -229,10 +283,10 @@ export function AssetsTab({ api }: AssetsTabProps) {
         </div>
       )}
 
-      {/* 预置写法模板（一键绑定） */}
+      {/* 笔法帖（一键绑定） */}
       {assetTab === 'templates' && (
         <div className={css.card}>
-          <span className={css.cardTitle}>预置写法模板</span>
+          <span className={css.cardTitle}>笔法帖</span>
           <span className={css.meta}>从内置 8 套叙事风格模板中一键选用（来自 AI-Novel-Writing-Assistant 写法引擎），无需样本文本；绑定后生成与润色都遵循该风格。</span>
           <div style={{ display: 'flex', flexDirection: 'column', gap: 8, maxHeight: 420, overflowY: 'auto' }}>
             {data.styleTemplates.map(template => {
@@ -269,24 +323,68 @@ export function AssetsTab({ api }: AssetsTabProps) {
         </div>
       )}
 
-      {/* 反 AI 规则 */}
+      {/* 文戒 */}
       {assetTab === 'rules' && (
         <div className={css.card}>
-        <span className={css.cardTitle}>反 AI 规则</span>
-        <span className={css.meta}>写作时必须遵守的表达边界（内置全局 + 项目自定义），生成与审稿都会检查。</span>
+        <span className={css.cardTitle}>文戒</span>
+        <span className={css.meta}>写作时必须遵守的表达边界（内置全局 + 项目自定义），生成与审稿都会检查。内置规则可用「覆盖编辑」复制为自定义版本调整。</span>
         <div style={{ display: 'flex', flexDirection: 'column', gap: 6, maxHeight: 280, overflowY: 'auto' }}>
-          {builtinRules.map(rule => (
-            <div key={rule.name} style={{ border: '1px solid var(--nf-border)', borderRadius: 6, padding: '6px 10px', fontSize: 12 }}>
-              <b>{rule.name}</b> <span className={css.badge} style={{ borderColor: 'var(--nf-text-3)', color: 'var(--nf-text-3)' }}>内置</span>
-              <div className={css.meta}>避免：{rule.avoid}</div>
-              <div className={css.meta}>修正：{rule.fix}</div>
-            </div>
-          ))}
-          {customRules.map(rule => (
-            <div key={rule.name} style={{ border: '1px solid var(--nf-accent)', borderRadius: 6, padding: '6px 10px', fontSize: 12 }}>
-              <b>{rule.name}</b> <span className={css.badge} style={{ borderColor: 'var(--nf-accent)', color: 'var(--nf-accent)' }}>自定义</span>
-              <div className={css.meta}>避免：{rule.avoid}</div>
-              {rule.fix !== '' && <div className={css.meta}>修正：{rule.fix}</div>}
+          {builtinRules.map(rule => {
+            const overridden = customRules.some(r => r.name === rule.name)
+            return (
+              <div key={rule.name} style={{ border: '1px solid var(--nf-border)', borderRadius: 6, padding: '6px 10px', fontSize: 12 }}>
+                <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 8 }}>
+                  <span>
+                    <b>{rule.name}</b>{' '}
+                    <span className={css.badge} style={{ borderColor: overridden ? 'var(--nf-accent)' : 'var(--nf-text-3)', color: overridden ? 'var(--nf-accent)' : 'var(--nf-text-3)' }}>
+                      {overridden ? '自定义覆盖中' : '内置'}
+                    </span>
+                  </span>
+                  <button className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={() => { handleOverrideBuiltin(rule) }}>
+                    {overridden ? '✎ 编辑覆盖' : '＋ 覆盖编辑'}
+                  </button>
+                </div>
+                <div className={css.meta}>避免：{rule.avoid}</div>
+                <div className={css.meta}>修正：{rule.fix}</div>
+              </div>
+            )
+          })}
+          {customRules.map((rule, index) => (
+            <div key={`${rule.name}-${index}`} style={{ border: '1px solid var(--nf-accent)', borderRadius: 6, padding: '6px 10px', fontSize: 12 }}>
+              <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 8 }}>
+                <span>
+                  <b>{rule.name}</b>{' '}
+                  <span className={css.badge} style={{ borderColor: 'var(--nf-accent)', color: 'var(--nf-accent)' }}>自定义</span>
+                </span>
+                <span style={{ display: 'flex', gap: 6 }}>
+                  <button className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={() => { setEditingRule({ index, name: rule.name, avoid: rule.avoid, fix: rule.fix ?? '' }) }}>
+                    编辑
+                  </button>
+                  <button className={`${css.button} ${css.buttonSmall}`} disabled={busy} onClick={() => { void handleRemoveRule(index) }}>
+                    删除
+                  </button>
+                </span>
+              </div>
+              {editingRule !== null && editingRule.index === index ? (
+                <div style={{ display: 'flex', flexDirection: 'column', gap: 6, marginTop: 6 }}>
+                  <input className={css.input} placeholder="规则名" value={editingRule.name} onChange={e => { setEditingRule({ ...editingRule, name: e.target.value }) }} />
+                  <input className={css.input} placeholder="避免（要杜绝的表达）" value={editingRule.avoid} onChange={e => { setEditingRule({ ...editingRule, avoid: e.target.value }) }} />
+                  <input className={css.input} placeholder="修正（改写方向，可留空）" value={editingRule.fix} onChange={e => { setEditingRule({ ...editingRule, fix: e.target.value }) }} />
+                  <div className={css.row}>
+                    <button className={`${css.button} ${css.buttonSmall} ${css.buttonPrimary}`} disabled={busy || (editingRule.avoid.trim() === '' && editingRule.fix.trim() === '')} onClick={() => { void handleSaveRuleEdit() }}>
+                      保存
+                    </button>
+                    <button className={`${css.button} ${css.buttonSmall}`} onClick={() => { setEditingRule(null) }}>
+                      取消
+                    </button>
+                  </div>
+                </div>
+              ) : (
+                <>
+                  <div className={css.meta}>避免：{rule.avoid}</div>
+                  {rule.fix !== '' && <div className={css.meta}>修正：{rule.fix}</div>}
+                </>
+              )}
             </div>
           ))}
         </div>
@@ -303,10 +401,10 @@ export function AssetsTab({ api }: AssetsTabProps) {
       </div>
       )}
 
-      {/* 自定义写法引擎 */}
+      {/* 心法（自定义写法引擎） */}
       {assetTab === 'style' && (
         <div className={css.card}>
-          <span className={css.cardTitle}>自定义写法引擎</span>
+          <span className={css.cardTitle}>心法</span>
           <span className={css.meta}>粘贴一段你喜欢的样本文本，AI 提取叙事风格规则并绑定到本书，后续章节保持同一味道。</span>
           {assets.styleAssets.map(style => (
             <div key={style.name} style={{ border: '1px solid var(--nf-border)', borderRadius: 6, padding: '6px 10px', fontSize: 12 }}>

package/src/client/panel/AssistantTab.tsx

@@ -1,6 +1,7 @@
 /**
- * AI 助手页签：与 AI 编辑对话讨论剧情，助手可通过动作指令直接修改
- * 大纲 / 设定圣经 / 章节。流式渲染回复，工具调用以事件行展示。
+ * AI 助手（编辑老师）：与 AI 编辑对话讨论剧情，助手通过动作指令直接修改
+ * 大纲 / 设定圣经 / 章节。流式渲染回复；工具调用显示为步骤卡片（中文名 +
+ * 状态 + 耗时），顶部状态条展示当前在做什么；支持清空对话记录。
  */
 import { useCallback, useEffect, useRef, useState } from 'react'
 import type { NovelApi } from '../api.ts'
@@ -8,13 +9,35 @@ import { tt } from './helpers.ts'
 import type { AssistantFrame, AssistantMessage } from '../../protocol.ts'
 import css from './panel.module.css'
 
+/** 工具中文名 + 图标映射（作者看得懂）。 */
+const TOOL_LABELS: Record<string, { icon: string; label: string }> = {
+  book_overview: { icon: '📖', label: '读取全书上下文' },
+  impact_analysis: { icon: '🔗', label: '影响分析' },
+  outline_text: { icon: '📄', label: '读取大纲' },
+  outline_replace: { icon: '📝', label: '修改大纲' },
+  bible_set_rule: { icon: '📖', label: '修改设定规则' },
+  bible_set_redline: { icon: '🚫', label: '修改写作红线' },
+  chapter_text: { icon: '📄', label: '读取章节' },
+  chapter_rewrite: { icon: '✏️', label: '修订章节' },
+  chapter_generate: { icon: '✨', label: '生成章节' },
+  chapter_review: { icon: '🔍', label: 'AI 审稿' },
+  foreshadow_add: { icon: '🪤', label: '新增伏笔' },
+  foreshadow_update: { icon: '🪤', label: '更新伏笔' },
+  export_txt: { icon: '📦', label: '导出 TXT' },
+  assets_status: { icon: '🎨', label: '查看写作资产' },
+  assets_set_genre: { icon: '🏷️', label: '设置题材' },
+  assets_set_progression: { icon: '📈', label: '设置推进模式' },
+  assets_add_rule: { icon: '🚫', label: '新增反AI规则' },
+  error: { icon: '⚠️', label: '出错了' },
+}
+
 /** One chat bubble (either side). */
 interface ChatLine {
   id: number
   role: 'user' | 'assistant'
   text: string
-  /** Tool events interleaved with the assistant reply. */
-  tools: Array<{ name: string; status: 'start' | 'done' | 'error'; detail?: string }>
+  /** Tool steps interleaved with the assistant reply. */
+  tools: Array<{ name: string; status: 'start' | 'done' | 'error'; detail?: string; startedAt?: number; elapsedMs?: number }>
   /** Live output while a tool runs (generated text streamed into the bubble). */
   live?: string
 }
@@ -30,9 +53,25 @@ export function AssistantTab({ api }: AssistantTabProps) {
   const [input, setInput] = useState('')
   const [busy, setBusy] = useState(false)
   const [error, setError] = useState('')
+  const [notice, setNotice] = useState('')
+  /** 思考耗时（秒，busy 时每秒刷新）。 */
+  const [thinkSeconds, setThinkSeconds] = useState(0)
   const idRef = useRef(0)
   const scrollRef = useRef<HTMLDivElement | null>(null)
 
+  /** busy 计时：显示"已思考 Xs"，让作者知道在干活。 */
+  useEffect(() => {
+    if (!busy) {
+      setThinkSeconds(0)
+      return
+    }
+    const started = Date.now()
+    const timer = window.setInterval(() => {
+      setThinkSeconds(Math.floor((Date.now() - started) / 1000))
+    }, 1000)
+    return () => { window.clearInterval(timer) }
+  }, [busy])
+
   /** Append a bubble (or extend the current assistant bubble). */
   const pushLine = useCallback((line: Omit<ChatLine, 'id'>) => {
     setLines(prev => {
@@ -45,14 +84,37 @@ export function AssistantTab({ api }: AssistantTabProps) {
     })
   }, [])
 
-  /** Push a tool event onto the current assistant bubble. */
+  /** Push a tool event: start 创建步骤，done/error 更新同名步骤（含耗时）。 */
   const pushTool = useCallback((tool: ChatLine['tools'][number]) => {
     setLines(prev => {
       const last = prev[prev.length - 1]
       if (last === undefined || last.role !== 'assistant') {
-        return [...prev, { id: idRef.current++, role: 'assistant', text: '', tools: [tool] }]
+        return [...prev, {
+          id: idRef.current++,
+          role: 'assistant',
+          text: '',
+          tools: [{ ...tool, startedAt: tool.status === 'start' ? Date.now() : undefined }],
+        }]
       }
-      return [...prev.slice(0, -1), { ...last, tools: [...last.tools, tool], live: undefined }]
+      const tools = [...last.tools]
+      if (tool.status === 'start') {
+        tools.push({ ...tool, startedAt: Date.now() })
+      } else {
+        // 找到同名未完成的步骤，更新状态与耗时。
+        for (let i = tools.length - 1; i >= 0; i--) {
+          const step = tools[i]!
+          if (step.name === tool.name && step.status === 'start') {
+            tools[i] = {
+              ...step,
+              status: tool.status,
+              detail: tool.detail,
+              elapsedMs: Date.now() - (step.startedAt ?? Date.now()),
+            }
+            break
+          }
+        }
+      }
+      return [...prev.slice(0, -1), { ...last, tools, live: undefined }]
     })
   }, [])
 
@@ -65,6 +127,19 @@ export function AssistantTab({ api }: AssistantTabProps) {
     })
   }, [])
 
+  /** 当前进行中的工具（状态条显示）。 */
+  const activeTool = (() => {
+    if (!busy) return null
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const line = lines[i]!
+      if (line.role !== 'assistant') continue
+      for (let j = line.tools.length - 1; j >= 0; j--) {
+        if (line.tools[j]!.status === 'start') return line.tools[j]!
+      }
+    }
+    return null
+  })()
+
   /** Load persisted history on mount. */
   useEffect(() => {
     let cancelled = false
@@ -78,11 +153,6 @@ export function AssistantTab({ api }: AssistantTabProps) {
             restored.push({ id: idRef.current++, role: 'user', text: entry.content, tools: [] })
           } else if (entry.role === 'assistant') {
             restored.push({ id: idRef.current++, role: 'assistant', text: entry.content, tools: [] })
-          } else if (entry.role === 'tool') {
-            const last = restored[restored.length - 1]
-            if (last !== undefined && last.role === 'assistant') {
-              last.tools.push({ name: entry.tool ?? 'tool', status: 'done', detail: entry.content.slice(0, 120) })
-            }
           }
         }
         setLines(restored)
@@ -98,12 +168,29 @@ export function AssistantTab({ api }: AssistantTabProps) {
     scrollRef.current?.scrollTo({ top: scrollRef.current.scrollHeight })
   }, [lines])
 
+  /** 清空对话记录（服务端删除历史 + 本地清空）。 */
+  const handleClear = async (): Promise<void> => {
+    if (!window.confirm('清空全部聊天记录？此操作不可恢复（不影响大纲/设定/章节）。')) return
+    setBusy(true)
+    setError('')
+    try {
+      await api.assistantClear()
+      setLines([])
+      setNotice('对话已清空，编辑老师会重新了解项目')
+    } catch (err) {
+      setError((err as Error).message)
+    } finally {
+      setBusy(false)
+    }
+  }
+
   /** Send one message. */
   const handleSend = async (): Promise<void> => {
     const message = input.trim()
     if (message === '' || busy) return
     setInput('')
     setError('')
+    setNotice('')
     pushLine({ role: 'user', text: message, tools: [] })
     // Start an empty assistant bubble.
     setLines(prev => [...prev, { id: idRef.current++, role: 'assistant', text: '', tools: [] }])
@@ -133,9 +220,21 @@ export function AssistantTab({ api }: AssistantTabProps) {
 
   return (
     <div className={css.card} style={{ flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }}>
-      <span className={css.cardTitle}>{tt('tab.assistant')}</span>
+      <div className={css.row} style={{ justifyContent: 'space-between' }}>
+        <span className={css.cardTitle}>{tt('tab.assistant')}</span>
+        <button type="button" className={css.iconButton} title="清空聊天记录" aria-label="清空聊天记录" onClick={() => { void handleClear() }}>
+          🗑️
+        </button>
+      </div>
       <span className={css.meta}>{tt('assistant.hint')}</span>
+      {notice !== '' && <span style={{ color: 'var(--nf-success)', fontSize: 12 }}>{notice}</span>}
       {error !== '' && <span style={{ color: 'var(--nf-error)', fontSize: 12 }}>{tt('common.error')}: {error}</span>}
+      {/* 状态条：编辑老师正在做什么 */}
+      <div className={`${css.assistantStatus} ${busy ? css.assistantStatusBusy : ''}`}>
+        {busy
+          ? `🤖 编辑老师 · ${activeTool !== null ? `正在「${TOOL_LABELS[activeTool.name]?.label ?? activeTool.name}」` : `正在思考…（已 ${thinkSeconds}s）`}`
+          : '💬 编辑老师 · 等你开口'}
+      </div>
       <div
         ref={scrollRef}
         className={css.chatScroll}
@@ -148,17 +247,31 @@ export function AssistantTab({ api }: AssistantTabProps) {
             {line.live !== undefined && line.live !== '' && (
               <div className={css.toolLive}>{line.live}</div>
             )}
+            {/* 步骤卡片 */}
             {line.tools.length > 0 && (
-              <div style={{ display: 'flex', flexDirection: 'column', gap: 2, marginTop: 4, fontSize: 11 }}>
-                {line.tools.map((tool, i) => (
-                  <span key={i} style={{ color: tool.status === 'error' ? 'var(--nf-error)' : tool.status === 'start' ? 'var(--nf-accent)' : 'var(--nf-success)' }}>
-                    {tool.status === 'start'
-                      ? tt('assistant.toolStart', { name: tool.name })
-                      : tool.status === 'done'
-                        ? tt('assistant.toolDone', { name: tool.name, detail: tool.detail ?? '' })
-                        : tt('assistant.toolError', { name: tool.name, detail: tool.detail ?? '' })}
-                  </span>
-                ))}
+              <div className={css.toolSteps}>
+                {line.tools.map((tool, i) => {
+                  const meta = TOOL_LABELS[tool.name] ?? { icon: '⚙️', label: tool.name }
+                  return (
+                    <div
+                      key={i}
+                      className={`${css.toolStep} ${tool.status === 'error' ? css.toolStepError : tool.status === 'start' ? css.toolStepActive : ''}`}
+                    >
+                      <span className={css.toolStepIcon}>{meta.icon}</span>
+                      <span className={css.toolStepName}>{meta.label}</span>
+                      <span className={css.toolStepStatus}>
+                        {tool.status === 'start'
+                          ? '⏳ 进行中'
+                          : tool.status === 'done'
+                            ? `✓ ${tool.elapsedMs !== undefined ? `${(tool.elapsedMs / 1000).toFixed(1)}s` : ''}`
+                            : '✗ 失败'}
+                      </span>
+                      {tool.status === 'error' && tool.detail !== undefined && (
+                        <span className={css.toolStepDetail}>{tool.detail}</span>
+                      )}
+                    </div>
+                  )
+                })}
               </div>
             )}
           </div>