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

package/src/author-assets.ts

@@ -1,147 +1,131 @@
-/**
- * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
- * 与书架同惯例持久化到 ~/.dsh/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, GenreNode, AntiAiRule, StyleTemplate, ProgressionMode } from './protocol.ts'
-
-import { loadBookshelf } from './bookshelf.ts'
-import { loadProject } from './engine.ts'
-
-/** 作者资产库配置文件路径。 */
-export function authorAssetsFile(): string {
-  return join(homedir(), '.dsh', 'dsh-novel-forge-author-assets.json')
-}
-
-/** 默认空资产库。 */
-function defaultLibrary(): AuthorAssetLibrary {
-  return { version: 1, items: [] }
-}
-
-/** 读取作者资产库（不存在/损坏则返回空库，不抛错）。 */
-export function loadAuthorAssets(): AuthorAssetLibrary {
-  const file = authorAssetsFile()
-  if (!existsSync(file)) return defaultLibrary()
-  try {
-    let raw = readFileSync(file, 'utf8')
-    if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1)
-    const parsed = JSON.parse(raw) as Partial<AuthorAssetLibrary>
-    if (!Array.isArray(parsed.items)) return defaultLibrary()
-    return { version: 1, items: parsed.items }
-  } catch {
-    return defaultLibrary()
-  }
-}
-
-/** 持久化作者资产库。 */
-export function saveAuthorAssets(library: AuthorAssetLibrary): void {
-  const file = authorAssetsFile()
-  mkdirSync(join(homedir(), '.dsh'), { 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()
-  const idx = library.items.findIndex(a => a.id === input.id)
-  const now = new Date().toISOString()
-  if (idx >= 0) {
-    const prev = library.items[idx]
-    if (prev !== undefined) {
-      library.items[idx] = {
-        ...prev,
-        ...input,
-        id: prev.id,
-        createdAt: prev.createdAt,
-        updatedAt: now,
-      }
-    }
-  } else {
-    library.items.push({ ...input, createdAt: input.createdAt !== '' ? input.createdAt : now, updatedAt: now })
-  }
-  saveAuthorAssets(library)
-  return library
-}
-
-/** 删除一条资产；返回更新后的资产库。 */
-export function removeAuthorAsset(id: string): AuthorAssetLibrary {
-  const library = loadAuthorAssets()
-  library.items = library.items.filter(a => a.id !== id)
-  saveAuthorAssets(library)
-  return library
-}
-
-/**
- * 导入默认：把书架所有书的写作资产/角色 + 内置全局库批量沉淀到作者资产库。
- * 按 `kind:name` 去重（已存在则跳过），不覆盖用户已有条目。
- * @returns 更新后的资产库。
- */
-export function importDefaultAuthorAssets(): AuthorAssetLibrary {
-  const library = loadAuthorAssets()
-  const seen = new Set(library.items.map(a => a.kind + ':' + a.name))
-  const now = new Date().toISOString()
-  const push = (kind: AuthorStyleAsset['kind'], name: string, summary: string, content: string, tags: string[], sourceBooks: string[], structured?: Record<string, unknown>): void => {
-    const key = kind + ':' + name.trim()
-    if (name.trim() === '' || seen.has(key)) return
-    seen.add(key)
-    library.items.push({
-      id: 'aa-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex'),
-      kind, name: name.trim(), summary: summary.trim(), content: content.trim(),
-      sourceBooks, tags, structured, createdAt: now, updatedAt: now,
-    });
-  };
-
-  // 1) 清理内置公共库重复沉淀：作者库只保留个人沉淀，不再收录内置公共资产。
-  const builtinKinds = new Set<AuthorStyleAsset['kind']>(['genre', 'antiAi', 'progression', 'style', 'plotBeat'])
-  library.items = library.items.filter(a => !(a.tags.includes('内置') && builtinKinds.has(a.kind) && (a.sourceBooks ?? []).length === 0))
-
-  // 2) 书架里的书：写作资产 + 角色模板
-  const shelf = loadBookshelf()
-  for (const book of shelf.books) {
-    const project = loadProject(book.outputDir)
-    if (project === undefined) continue
-    const src = [project.bookName]
-    const assets = project.assets
-    if (assets !== undefined) {
-      if (assets.genre !== undefined) push('genre', assets.genre.name, assets.genre.description, assets.genre.description, ['书', '题材'], src, { description: assets.genre.description });
-      if (assets.primaryProgression !== undefined) push('progression', assets.primaryProgression.name, assets.primaryProgression.driver, '驱动：' + assets.primaryProgression.driver + '\n期待：' + assets.primaryProgression.readerExpectation, src, [], { driver: assets.primaryProgression.driver, primary: true });
-      for (const p of assets.auxiliaryProgressions ?? []) push('progression', p.name, p.driver, '驱动：' + p.driver + '\n期待：' + p.readerExpectation, src, [], { driver: p.driver, primary: false });
-      for (const r of assets.antiAiRules ?? []) push('antiAi', r.name, r.avoid, '避免：' + r.avoid + '\n修正：' + r.fix, src, [], { avoid: r.avoid, fix: r.fix, detectPatterns: r.detectPatterns });
-      for (const s of assets.styleAssets ?? []) push('style', s.name, s.proseRules.join('；'), 
-        '叙述：' + s.proseRules.join('；') + '\n台词：' + s.dialogueRules.join('；') + '\n描写：' + s.descriptionRules.join('；') + '\n边界：' + s.boundaries.join('；'), src, [], { sourceText: s.sourceText });
-    }
-    // 作者库角色模板只收男主/女主（可复用原型），其余角色/路人不入库，避免刷屏。
-    for (const role of project.roles ?? []) {
-      if (role.roleLabel !== 'protagonist' && role.roleLabel !== 'female_lead') continue
-      const persona = ('定位：' + role.roleLabel + '\n身份：' + role.identity + '\n性格：' + role.traits.join('、') + '\n目标：' + role.goals + '\n关系：' + role.relations.join('、') + '\n成长线：' + (role.arc.length > 0 ? role.arc.join(' > ') : '—') + '\n知情度：' + role.knowledge.join('、')).trim();
-      push('roleTemplate', role.name, role.identity, persona, src, [], { roleLabel: role.roleLabel, traits: role.traits, relations: role.relations, arc: role.arc, knowledge: role.knowledge });
-    }
-  }
-
-  saveAuthorAssets(library)
-  return library
-}
-
+/**
+ * 作者资产库/总数据（跨书）— 按作者维度聚合的可复用资产。
+ * 与书架同惯例持久化到 <DSH_HOME>/dsh-novel-forge-author-assets.json。
+ * 提供读取/持久化/新增或更新/删除，以及「导入默认」：把书架书的写作资产/角色 + 
+ * 内置全局库（题材/反AI规则/风格模板/推进模式）批量沉淀成资产条目（默认库）。
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+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 dshHomePath('dsh-novel-forge-author-assets.json')
+}
+
+/** 默认空资产库。 */
+function defaultLibrary(): AuthorAssetLibrary {
+  return { version: 1, items: [] }
+}
+
+/** 读取作者资产库（不存在/损坏则返回空库，不抛错）。 */
+export function loadAuthorAssets(): AuthorAssetLibrary {
+  const file = authorAssetsFile()
+  if (!existsSync(file)) return defaultLibrary()
+  try {
+    let raw = readFileSync(file, 'utf8')
+    if (raw.charCodeAt(0) === 0xFEFF) raw = raw.slice(1)
+    const parsed = JSON.parse(raw) as Partial<AuthorAssetLibrary>
+    if (!Array.isArray(parsed.items)) return defaultLibrary()
+    return { version: 1, items: parsed.items }
+  } catch (error) {
+    // 资产库损坏回退默认值会遮蔽数据丢失，留痕到服务端日志。
+    console.error(`[novel-forge] author assets file unreadable/corrupt: ${file} — ${(error as Error).message}`)
+    return defaultLibrary()
+  }
+}
+
+/** 持久化作者资产库。 */
+export function saveAuthorAssets(library: AuthorAssetLibrary): void {
+  const file = authorAssetsFile()
+  mkdirSync(dshHome(), { recursive: true })
+  writeFileSync(file, JSON.stringify(library, null, 2), 'utf8')
+}
+
+/** 按 id 更新一条资产；不存在则追加。 */
+export function upsertAuthorAsset(input: AuthorStyleAsset): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  const idx = library.items.findIndex(a => a.id === input.id)
+  const now = new Date().toISOString()
+  if (idx >= 0) {
+    const prev = library.items[idx]
+    if (prev !== undefined) {
+      library.items[idx] = {
+        ...prev,
+        ...input,
+        id: prev.id,
+        createdAt: prev.createdAt,
+        updatedAt: now,
+      }
+    }
+  } else {
+    library.items.push({ ...input, createdAt: input.createdAt !== '' ? input.createdAt : now, updatedAt: now })
+  }
+  saveAuthorAssets(library)
+  return library
+}
+
+/** 删除一条资产；返回更新后的资产库。 */
+export function removeAuthorAsset(id: string): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  library.items = library.items.filter(a => a.id !== id)
+  saveAuthorAssets(library)
+  return library
+}
+
+/**
+ * 导入默认：把书架所有书的写作资产/角色 + 内置全局库批量沉淀到作者资产库。
+ * 按 `kind:name` 去重（已存在则跳过），不覆盖用户已有条目。
+ * @returns 更新后的资产库。
+ */
+export function importDefaultAuthorAssets(): AuthorAssetLibrary {
+  const library = loadAuthorAssets()
+  const seen = new Set(library.items.map(a => a.kind + ':' + a.name))
+  const now = new Date().toISOString()
+  const push = (kind: AuthorStyleAsset['kind'], name: string, summary: string, content: string, tags: string[], sourceBooks: string[], structured?: Record<string, unknown>): void => {
+    const key = kind + ':' + name.trim()
+    if (name.trim() === '' || seen.has(key)) return
+    seen.add(key)
+    library.items.push({
+      id: 'aa-' + Date.now().toString(36) + '-' + randomBytes(3).toString('hex'),
+      kind, name: name.trim(), summary: summary.trim(), content: content.trim(),
+      sourceBooks, tags, structured, createdAt: now, updatedAt: now,
+    });
+  };
+
+  // 1) 清理内置公共库重复沉淀：作者库只保留个人沉淀，不再收录内置公共资产。
+  const builtinKinds = new Set<AuthorStyleAsset['kind']>(['genre', 'antiAi', 'progression', 'style', 'plotBeat'])
+  library.items = library.items.filter(a => !(a.tags.includes('内置') && builtinKinds.has(a.kind) && (a.sourceBooks ?? []).length === 0))
+
+  // 2) 书架里的书：写作资产 + 角色模板
+  const shelf = loadBookshelf()
+  for (const book of shelf.books) {
+    const project = loadProject(book.outputDir)
+    if (project === undefined) continue
+    const src = [project.bookName]
+    const assets = project.assets
+    if (assets !== undefined) {
+      if (assets.genre !== undefined) push('genre', assets.genre.name, assets.genre.description, assets.genre.description, ['书', '题材'], src, { description: assets.genre.description });
+      if (assets.primaryProgression !== undefined) push('progression', assets.primaryProgression.name, assets.primaryProgression.driver, '驱动：' + assets.primaryProgression.driver + '\n期待：' + assets.primaryProgression.readerExpectation, src, [], { driver: assets.primaryProgression.driver, primary: true });
+      for (const p of assets.auxiliaryProgressions ?? []) push('progression', p.name, p.driver, '驱动：' + p.driver + '\n期待：' + p.readerExpectation, src, [], { driver: p.driver, primary: false });
+      for (const r of assets.antiAiRules ?? []) push('antiAi', r.name, r.avoid, '避免：' + r.avoid + '\n修正：' + r.fix, src, [], { avoid: r.avoid, fix: r.fix, detectPatterns: r.detectPatterns });
+      for (const s of assets.styleAssets ?? []) push('style', s.name, s.proseRules.join('；'), 
+        '叙述：' + s.proseRules.join('；') + '\n台词：' + s.dialogueRules.join('；') + '\n描写：' + s.descriptionRules.join('；') + '\n边界：' + s.boundaries.join('；'), src, [], { sourceText: s.sourceText });
+    }
+    // 作者库角色模板只收男主/女主（可复用原型），其余角色/路人不入库，避免刷屏。
+    for (const role of project.roles ?? []) {
+      if (role.roleLabel !== 'protagonist' && role.roleLabel !== 'female_lead') continue
+      const persona = ('定位：' + role.roleLabel + '\n身份：' + role.identity + '\n性格：' + role.traits.join('、') + '\n目标：' + role.goals + '\n关系：' + role.relations.join('、') + '\n成长线：' + (role.arc.length > 0 ? role.arc.join(' > ') : '—') + '\n知情度：' + role.knowledge.join('、')).trim();
+      push('roleTemplate', role.name, role.identity, persona, src, [], { roleLabel: role.roleLabel, traits: role.traits, relations: role.relations, arc: role.arc, knowledge: role.knowledge });
+    }
+  }
+
+  saveAuthorAssets(library)
+  return library
+}
+