@waterwx/dsh-novel-forge 1.7.3 → 1.9.0

package/src/protocol.ts

@@ -64,6 +64,18 @@ export const NOVEL_API = {
   storyboardPrompts: '/api/dsh-novel-forge/storyboard/prompts',
   /** 生图接口连通性测试（设置页每个模型条目用）。 */
   imageTest: '/api/dsh-novel-forge/image-test',
+  /** LLM 模型连通性测试：真实最小调用，验证 Key / 端点 / 模型可用。 */
+  llmTest: '/api/dsh-novel-forge/llm-test',
+  /** 添加模型：厂商直填 key 或自定义路由，写进 DSH 凭据与 llm-pi-ai 路由。 */
+  addModel: '/api/dsh-novel-forge/llm-add',
+  /** 运行时厂商目录（DSH pi-ai 可配置提供方 + 内置适配器）。 */
+  llmVendors: '/api/dsh-novel-forge/llm-vendors',
+  /** 查询某个 provider 当前可用的模型（添加成功后可即时刷新）。 */
+  llmModels: '/api/dsh-novel-forge/llm-models',
+  /** 已注册的提供方路由列表（提供方管理）。 */
+  llmProviders: '/api/dsh-novel-forge/llm-providers',
+  /** 移除一个提供方。 */
+  llmRemove: '/api/dsh-novel-forge/llm-remove',
   /** 重置项目（可选携带新大纲）：清空设定/卷/章节/伏笔/资产/事实库。 */
   reset: '/api/dsh-novel-forge/reset',
   /** 全书一致性质检：LLM 扫描已生成章节，输出矛盾问题清单。 */
@@ -113,6 +125,24 @@ export const NOVEL_API = {
   runStatus: '/api/dsh-novel-forge/run/status',
   config: '/api/dsh-novel-forge/config',
   openFolder: '/api/dsh-novel-forge/open-folder',
+  /** 作者资产库/总数据：读取个人跨书资产（笔法/红线/套路/角色模板/世界观模板）。 */
+  authorAssets: '/api/dsh-novel-forge/author-assets',
+  /** 作者资产库：新增/更新一条资产（upsert by id）。 */
+  authorAssetsUpsert: '/api/dsh-novel-forge/author-assets/upsert',
+  /** 作者资产库：删除一条资产。 */
+  authorAssetsRemove: '/api/dsh-novel-forge/author-assets/remove',
+  /** 作者资产库：导入默认（书架书的写作资产/角色 + 内置全局库）批量沉淀。 */
+  authorAssetsImportDefault: '/api/dsh-novel-forge/author-assets/import-default',
+  /** 改编模式：上传全文 → 分析 → 原文设定卡片/可改范围矩阵。 */
+  adaptAnalyze: '/api/dsh-novel-forge/adapt/analyze',
+  /** 改编模式：确认要改的维度 → 生成映射表/改编规则/联动影响清单。 */
+  adaptPropose: '/api/dsh-novel-forge/adapt/propose',
+  /** 改编模式：执行术语替换（全局替换 + 命中统计 + 改编文本预览）。 */
+  adaptExecute: '/api/dsh-novel-forge/adapt/execute',
+  /** 主题自定义背景：上传图片（POST，存盘并返回服务端 URL）。 */
+  themeBackgroundUpload: '/api/dsh-novel-forge/theme/background',
+  /** 主题自定义背景：读取已上传文件（GET prefix，/theme/background/<name>）。 */
+  themeBackgroundGet: '/api/dsh-novel-forge/theme/background',
 } as const
 
 /** 书架：一本书的条目。 */
@@ -1039,6 +1069,23 @@ export interface ImageTestResponse {
   modelFound?: boolean
 }
 
+/** POST /llm-test 请求：对选中的提供商/模型发一次最小真实调用。 */
+export interface LlmTestRequest {
+  provider: string
+  model: string
+}
+
+/** POST /llm-test 响应。 */
+export interface LlmTestResponse {
+  ok: boolean
+  /** 连通延迟（毫秒）。 */
+  ms?: number
+  /** 失败原因（已映射为人话）。 */
+  message?: string
+  /** 稳定错误码（LlmError code），便于排查。 */
+  code?: string
+}
+
 /** POST /roles 响应。 */
 export interface RolesResponse {
   roles: RoleRecord[]
@@ -1217,6 +1264,133 @@ export interface ImageModelConfig {
 }
 
 /** Runtime config surface exposed to the panel (subset of plugin Config). */
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
+export interface SavedModel {
+  /** 唯一 id（前端生成的短 id）。 */
+  id: string
+  /** 展示名（可为空，回退到 model）。 */
+  name: string
+  /** DSH 提供商路由（如 zai-coding-cn）。 */
+  provider: string
+  /** 模型 id（如 glm-5.3-flash）。 */
+  model: string
+}
+
+/** DSH 模型添加：厂商预设（选择厂商，直接填 API Key）。 */
+export interface LlmVendor {
+  id: string
+  name: string
+  /** 该厂商对应的 provider 路由。 */
+  route: string
+  /** DSH 凭据引用名（写入 .credentials.yaml 的 refs）。 */
+  apiKeyEnv: string
+  /** 默认模型 id。 */
+  defaultModel: string
+  /** 建议可选模型 id 列表（下拉 data-list 用）。 */
+  models: string[]
+  /** 内置适配器（如 deepseek-official），无需注册 pi-ai 路由。 */
+  builtin?: boolean
+}
+
+/** 预置的常见厂商（id=provider 路由；添加模型下拉兜底用，其余厂商由运行时目录动态补充）。 */
+export const LLM_VENDORS: LlmVendor[] = [
+  { id: 'deepseek-official', name: 'DeepSeek', route: 'deepseek-official', apiKeyEnv: 'DEEPSEEK_API_KEY', defaultModel: 'deepseek-v4-flash', models: ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-chat', 'deepseek-reasoner'], builtin: true },
+  { id: 'zai-coding-cn', name: '智谱 GLM', route: 'zai-coding-cn', apiKeyEnv: 'ZAI_CODING_CN_API_KEY', defaultModel: 'glm-5.3-flash', models: ['glm-4.5-air', 'glm-4.7', 'glm-5-turbo', 'glm-5.1', 'glm-5.2', 'glm-5.3', 'glm-5.3-flash', 'glm-5v-turbo'] },
+  { id: 'qwen-token-plan-cn', name: '千问百炼', route: 'qwen-token-plan-cn', apiKeyEnv: 'QWEN_TOKEN_PLAN_CN_API_KEY', defaultModel: 'qwen3.7-max', models: ['qwen3.6-flash', 'qwen3.6-plus', 'qwen3.7-max', 'qwen3.7-plus', 'qwen3.8-max', 'qwen3.8-max-preview'] },
+  { id: 'openrouter', name: 'OpenRouter', route: 'openrouter', apiKeyEnv: 'OPENROUTER_API_KEY', defaultModel: 'z-ai/glm-5.3-flash', models: ['z-ai/glm-4.6', 'z-ai/glm-4.7', 'z-ai/glm-5', 'z-ai/glm-5-turbo', 'z-ai/glm-5.1', 'z-ai/glm-5.2', 'z-ai/glm-5.3-flash', 'auto', 'deepseek/deepseek-v4-flash', 'anthropic/claude-sonnet-4.6'] },
+]
+
+/** 运行时厂商目录的一项（添加到模型下拉；由 DSH 的 pi-ai 可配置提供方动态生成）。 */
+export interface LlmVendorOption {
+  /** provider 路由 id（也是厂商下拉的值）。 */
+  id: string
+  /** 展示名。 */
+  name: string
+  /** 建议模型 id（可为空，用户手填）。 */
+  models: string[]
+  /** 已知 DSH 凭据引用名；为空时 host 生成 `PI_AI_<ID>_API_KEY`。 */
+  apiKeyEnv?: string
+  /** 内置适配器（只写凭据，不注册 pi-ai 路由）。 */
+  builtin?: boolean
+}
+
+/** GET /llm-vendors 响应。 */
+export interface LlmVendorsResponse {
+  vendors: LlmVendorOption[]
+}
+
+/** /llm-models 里的一条模型。 */
+export interface LlmModelOption { id: string; name: string }
+
+/** GET /llm-models?provider=x 响应。 */
+export interface LlmModelsResponse {
+  models: LlmModelOption[]
+}
+
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+  providers: { id: string; name: string }[]
+}
+
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+  provider: string
+  /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+  apiKeyEnv?: string
+}
+
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+  ok: boolean
+  message?: string
+}
+
+/** GET /llm-providers 响应：当前已注册的提供方路由。 */
+export interface LlmProvidersResponse {
+  providers: { id: string; name: string }[]
+}
+
+/** POST /llm-remove 请求：移除一个提供方（unset key + 移除 llm-pi-ai 路由）。 */
+export interface RemoveProviderRequest {
+  provider: string
+  /** 该提供方对应的 DSH 凭据引用名（用于 unset）。 */
+  apiKeyEnv?: string
+}
+
+/** POST /llm-remove 响应。 */
+export interface RemoveProviderResponse {
+  ok: boolean
+  message?: string
+}
+
+/** POST /llm-add 请求：添加一个模型（厂商直填 key，或自定义路由）。 */
+export interface AddModelRequest {
+  mode: 'vendor' | 'custom'
+  /** 厂商模式用：provider 路由 id（来自 /llm-vendors）。 */
+  vendor?: string
+  /** 厂商已知的 DSH 凭据引用名（可选；为空时 host 生成）。 */
+  apiKeyEnv?: string
+  /** 自定义模式用：provider 路由 id。 */
+  provider?: string
+  /** 模型 id。 */
+  model: string
+  /** API Key。 */
+  apiKey: string
+  /** 展示名（可选）。 */
+  name?: string
+  /** 自定义模式用：OpenAI 兼容 base URL。 */
+  baseURL?: string
+}
+
+/** POST /llm-add 响应。 */
+export interface AddModelResponse {
+  ok: boolean
+  saved: SavedModel
+  provider: string
+  message?: string
+}
+
+/** 手动添加的模型库条目（只存插件内，不改 DSH 全局）。 */
 export interface NovelConfig {
   /** Absolute path of the default docx outline to load. */
   outlinePath: string
@@ -1252,6 +1426,16 @@ export interface NovelConfig {
   imageApiModel?: string
   /** 是否启用生图（= 存在启用条目）。 */
   imageApiEnabled?: boolean
+  /** 自定义背景图（URL 或 dataURL 或服务端路径引用；空 = 使用主题默认背景）。 */
+  themeBackground?: string
+  /** 自定义背景遮罩/模糊强度 0-80（0 = 不遮罩）。 */
+  themeBackgroundBlur?: number
+  /** 玻璃透明度 0-100（100=当前原样，越小越透，新拟态/黏土可见背景图）。 */
+  themeOpacity?: number
+  /** 是否启用改编模式（默认关闭；发布后开启）。 */
+  enableAdaptMode?: boolean
+  /** 手动添加的模型库（「我的模型」条目；只存插件内）。 */
+  savedModels?: SavedModel[]
 }
 
 /** GET /status response. */
@@ -1468,8 +1652,17 @@ export interface ConfigPatch {
   imageApiKey?: string
   imageApiModel?: string
   imageApiEnabled?: boolean
+  /** 自定义背景图（URL / dataURL / 服务端路径引用）。 */
+  themeBackground?: string
+  /** 自定义背景遮罩/模糊强度 0-80。 */
+  themeBackgroundBlur?: number
+  /** 玻璃透明度 0-100（100=当前原样）。 */
+  themeOpacity?: number
+  enableAdaptMode?: boolean
   /** 生图模型库（完整替换保存）。 */
   imageModels?: ImageModelConfig[]
+  /** 手动添加的模型库（完整替换保存）。 */
+  savedModels?: SavedModel[]
 }
 
 // ------------------------------------------------------------ assistant
@@ -1633,3 +1826,166 @@ export interface StyleEngineRequest {
   /** 资产名（可选，默认「风格资产 N」）。 */
   name?: string
 }
+
+// ---------------------------------------------------------- author assets (总数据)
+
+/** 作者资产库中一条可跨书复用的资产（笔法/红线/套路/角色模板/世界观模板等）。 */
+export interface AuthorStyleAsset {
+  /** 稳定 id（本地唯一）。 */
+  id: string
+  /** 资产名（如「短句快节奏爽文风」「林越式痞坏角色」）。 */
+  name: string
+  /** 资产类型。 */
+  kind: 'style' | 'antiAi' | 'progression' | 'genre' | 'roleTemplate' | 'worldTemplate' | 'custom'
+  /** 一句话摘要。 */
+  summary: string
+  /** 资产正文内容（按 kind 约定解读的文本/JSON 描述）。 */
+  content: string
+  /** 结构化载荷（角色模板/世界观模板等可结构化字段；缺省为 null）。 */
+  structured?: Record<string, unknown>
+  /** 来源书名（哪本书提炼/收藏而来）。 */
+  sourceBooks: string[]
+  /** 标签。 */
+  tags: string[]
+  /** 来源样本文本（可选）。 */
+  sourceText?: string
+  /** 创建时间。 */
+  createdAt: string
+  /** 更新时间。 */
+  updatedAt: string
+}
+
+/** 作者资产库（跨书总数据）：按作者维度聚合的可复用资产。 */
+export interface AuthorAssetLibrary {
+  /** 货架版本，便于未来迁移。 */
+  version: 1
+  items: AuthorStyleAsset[]
+}
+
+/** GET /author-assets 响应。 */
+export interface AuthorAssetsResponse {
+  assets: AuthorAssetLibrary
+}
+
+/** POST /author-assets/upsert 请求：新增或按 id 更新一条资产。 */
+export interface AuthorAssetUpsertRequest {
+  asset: AuthorStyleAsset
+}
+
+/** POST /author-assets/remove 请求：删除一条资产。 */
+export interface AuthorAssetRemoveRequest {
+  id: string
+}
+
+// ---------------------------------------------------------- adaptation (改编模式)
+
+/** 改编可改范围的单个维度（矩阵的一行）。 */
+export interface AdaptationDimension {
+  /** 维度 key（如 realm/name/goldenFinger…）。 */
+  key: string
+  /** 维度名（如「大世界」「修为体系」「主角名」「金手指」）。 */
+  title: string
+  /** 可改度：保留 / 可改影响大 / 可改影响小 / 可自由改 / 仅视觉包装。 */
+  mutability: 'locked' | 'big' | 'small' | 'free' | 'visual'
+  /** 原文当前值（从正文提炼，附证据）。 */
+  current: string
+  /** 该值在正文中的出现证据（章节/频次，可空）。 */
+  evidence?: string
+  /** AI 建议的候选新值（可空）。 */
+  candidates?: string[]
+  /** 联动影响说明（改了会影响哪些章节/角色/伏笔/术语）。 */
+  impact: string
+  /** 风险评级。 */
+  risk: 'high' | 'medium' | 'low'
+}
+
+/** POST /adapt/analyze 请求：上传全文做改编分析。 */
+export interface AdaptAnalyzeRequest {
+  /** 全文文本（优先）。 */
+  text: string
+  /** 或服务器端全文文件路径。 */
+  filePath?: string
+}
+
+/** POST /adapt/analyze 响应。 */
+export interface AdaptAnalyzeResponse {
+  /** 识别书名（文件名推断或正文首行）。 */
+  bookName: string
+  /** 拆出的章节数。 */
+  chapters: number
+  /** 反推的初始大纲（可空）。 */
+  outline?: string
+  /** 可改范围矩阵。 */
+  dimensions: AdaptationDimension[]
+  /** 分析消耗说明。 */
+  note?: string
+}
+
+/** 一条改编映射（原值 → 新值）。 */
+export interface AdaptationMapping {
+  /** 原值（如「林尘」「练气」「青云宗」）。 */
+  source: string
+  /** 新值（如「楚风」「凝元」「天渊阁」）。 */
+  target: string
+  /** 适用范围。 */
+  scope: 'name' | 'realm' | 'faction' | 'term' | 'other'
+  /** 说明（可空）。 */
+  note?: string
+}
+
+/** 改编规则：哪些必须保留、哪些允许改、一致性约束。 */
+export interface AdaptationRules {
+  /** 必须保留的要素（骨架/人物动机/伏笔逻辑/爽点结构…）。 */
+  preserve: string[]
+  /** 允许改变的要素。 */
+  change: string[]
+  /** 改编红线/一致性要求。 */
+  constraints: string[]
+}
+
+/** 一组改编方案（映射表 + 规则 + 联动影响清单）。 */
+export interface AdaptationProposal {
+  /** 映射表（原→新）。 */
+  mappings: AdaptationMapping[]
+  /** 改编规则。 */
+  rules: AdaptationRules
+  /** 联动影响清单。 */
+  impacts: Array<{ item: string; detail: string; risk: 'high' | 'medium' | 'low'; chapters?: number[] }>
+}
+
+/** POST /adapt/propose 请求：由用户勾选的维度 + 新值生成改编方案。 */
+export interface AdaptProposeRequest {
+  /** 原文全文（复用，便于 LLM 核对联动影响）。 */
+  text: string
+  /** 用户确认要改的维度（含原值与新值）。 */
+  selections: Array<{ key: string; title: string; current: string; target: string; mutability: string }>
+  /** 若已分析过，可携带完整矩阵作为上下文。 */
+  dimensions?: AdaptationDimension[]
+}
+
+/** POST /adapt/propose 响应。 */
+export interface AdaptProposeResponse {
+  proposal: AdaptationProposal
+}
+
+/** POST /adapt/execute 请求：执行改编（首版为术语替换）。 */
+export interface AdaptExecuteRequest {
+  /** 原文全文。 */
+  text: string
+  /** 改编映射表。 */
+  mappings: AdaptationMapping[]
+  /** 改编规则（可选，后续逐章改写使用；替换模式暂不依赖）。 */
+  rules?: AdaptationRules
+  /** 执行模式：首版仅 replace（术语替换）。 */
+  mode?: 'replace' | 'rewrite'
+}
+
+/** POST /adapt/execute 响应。 */
+export interface AdaptExecuteResponse {
+  /** 改编后的全文。 */
+  adaptedText: string
+  /** 执行的映射数。 */
+  mappings: number
+  /** 命中统计：每条映射的替换次数。 */
+  hits: Array<{ source: string; target: string; count: number }>
+}