蓁蓁工坊 · 详细使用指南

本地版 v0.13.1 · 官方入口核对：2026-10-02 · 20 个章节 / 8 家模型平台

01 · 第一次使用：完成一集

适用于蓁蓁工坊 v0.13.1。指南按当前本地版功能编写；官方平台入口核对于 2026 年 10 月 2 日。平台菜单、模型权限与计费可能调整，以账户控制台为准。

先准备三样东西

  • 一个故事想法：谁想得到什么、遇到什么阻碍、失败要付出什么代价。
  • 一个可用的文本模型 API Key。手工写作、查看已有文稿不需要密钥；AI 生成、对话与分析需要联网。
  • 平台账户可用额度，以及对应模型的调用权限。

第一次从小项目开始

  1. 打开「模型设置」，填写一个提供商的密钥，选择该账户可用的测试模型，点击测试连接。
  2. 在下方「创作阶段分配」中，把需要的阶段都设成已配置密钥的提供商和模型，最后点「保存设置」。只改测试模型不会改变各阶段分配。
  3. 点击「新建项目」，填写剧名、题材、故事想法、目标集数和每集字数。先用较少集数跑通流程，再开展长篇项目。
  4. 依次完成故事策划、人物小篆、冲突矩阵、分集大纲、剧情总览。生成后检查内容；手动调整后点击保存。
  5. 进入正式剧本，选择第 1 集，点击「生成初稿」。查看生成记录和校对结果，再进入下一集。
  6. 保存修改，在「文稿库」查看版本，最后导出 Word 或 Markdown。
成功标志：模型测试返回文本、某个阶段出现已保存版本、文稿库中能打开这份文稿。没有密钥时仍可手工写作。

02 · API、模型与费用

API 是工坊向模型平台发送写作请求的接口；API Key 是你在平台上的调用凭证。费用计入密钥所属平台的账户。

项目如何理解
提供商密钥由谁签发，就选谁。例如在硅基流动申请密钥，即使使用智谱 GLM，也应选「硅基流动」。
模型名称与 ID下拉框展示便于阅读的名称，后台使用完整 ID；自定义时要复制平台完整 ID，不能只输入宣传名称。
Base URL平台接口地址。本版已内置固定地址，没有自定义 Base URL 输入框。换地域或使用专用套餐接口，不能只换密钥。
Token模型计量输入、输出的单位，不等于中文字数。长上下文、长输出、多轮对话与多次调用都会影响费用。

OpenAI 官方明确：ChatGPT 与 API 分别计费，聊天订阅不会自动变成 API 余额。其他平台也应核对所购产品是否包含标准 API 调用，而非仅网页聊天或编程套餐。OpenAI 计费说明

新手的配置方式

先只配置一个平台，给所有写作阶段分配一个已测试的文本模型。熟悉流程后再按自己的样稿比较模型：策划看因果和结构，人物看动机和细节，正文看场景与对白，评审看能否引用原文并给出可执行意见。

不要把“最贵”“最新”直接等同于最适合写作。模型清单不是实时账户权限清单；价格、上下文长度、速率和可用模型请查看官方控制台。本指南不承诺免费额度或固定价格。

API · DeepSeek

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 打开 DeepSeek 开放平台，用自己的账户注册或登录。
  2. 进入 API keys 页面，新建密钥并复制；把用途命名为“蓁蓁工坊”方便日后识别。
  3. 在平台账户中检查余额、可调用模型与使用限制，按需要开通计费。
  4. 回到工坊选择 DeepSeek，粘贴密钥，选择控制台支持的文本模型，测试连接；分配创作阶段后保存。
DeepSeek 网页聊天入口不是密钥管理入口。模型 ID 以开放平台文档为准；若预设已调整，可使用自定义模型 ID。

工坊提供商：DeepSeek

本版实际请求地址（无需手动填写）：https://api.deepseek.com/chat/completions

API · Kimi / Moonshot

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 进入 Kimi API 开放平台并登录；旧 Moonshot 文档入口目前会转到新的 Kimi 平台。
  2. 在 API Keys 页面创建并复制标准 API 密钥。
  3. 查看账户计费、模型可用性与速率限制，确认该密钥可调用对应模型。
  4. 在工坊选择 Kimi，填写密钥和可用模型，测试后分配阶段并保存。
本版调用 moonshot.cn 接口。不要把 Kimi Code 等专用服务的凭证当作此处的标准 API Key；遇到 404 先核对模型 ID、权限和接口，而不是只重复换密钥。

工坊提供商：Kimi

本版实际请求地址（无需手动填写）：https://api.moonshot.cn/v1/chat/completions

API · 通义千问 / 阿里云百炼

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 登录阿里云百炼控制台，按平台提示完成开通。
  2. 选择与本版接口一致的华北 2（北京）地域，进入 API Key 管理。
  3. 创建 API Key，选择归属账户和业务空间，复制密钥；子账户无权限时请联系管理员。
  4. 检查该地域下的模型权限与额度；在工坊选择通义千问，测试、分配阶段并保存。
各地域的 API Key、模型清单和接入域名不能混用。本版不是新加坡等海外地域接口，也不是 Coding Plan / Token Plan 专用接口。

工坊提供商：通义千问

本版实际请求地址（无需手动填写）：https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

API · 硅基流动：中国站

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 登录硅基流动中国站控制台，进入 API 密钥，点击新建 API 密钥并复制。
  2. 在模型广场选择支持文本对话的模型，查看价格、速率及账户可用性。
  3. 回到工坊选择硅基流动并填写该平台密钥。调用 GLM、Qwen 或 DeepSeek 系列也仍然选硅基流动。
  4. 若下拉列表没有该模型，选择自定义模型 ID，完整复制模型广场的 ID（保留 Pro/、组织名等前缀）；测试后分配阶段并保存。
不要填写智谱、DeepSeek 等其他平台签发的密钥。模型广场中的图片、视频、语音、向量或重排模型不能直接用于本应用写作流程。

工坊提供商：硅基流动

本版实际请求地址（无需手动填写）：https://api.siliconflow.cn/v1/chat/completions

API · 智谱开放平台

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 进入智谱开放平台，完成注册或登录。
  2. 在个人中心找到 API Keys，创建新密钥并复制。
  3. 确认标准按量模型的额度与权限，查看要调用的文本模型 ID。
  4. 在工坊选择智谱，输入密钥，选择或自定义模型，测试后分配阶段并保存。
本版使用标准按量接口。GLM Coding Plan 使用专属端点，不能把该套餐当作工坊已支持的按量接口。硅基流动购买的 GLM 应在工坊选硅基流动。

工坊提供商：智谱

本版实际请求地址（无需手动填写）：https://open.bigmodel.cn/api/paas/v4/chat/completions

API · 豆包 / 火山方舟

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 登录火山引擎，进入火山方舟控制台，按提示开通需要的模型服务。
  2. 确认项目空间，在 API Key 管理中创建并复制密钥。
  3. 从控制台获取可用的模型 ID；如果使用自定义推理接入点，获取同一项目空间下的 ep- 接入点 ID。
  4. 在工坊选择豆包。需要 ep- ID 时选自定义模型 ID 填入，测试后分配阶段并保存。
这里使用方舟 API Key，不是火山引擎通用 Access Key / Secret Key。密钥和接入点需匹配项目空间；本版接口固定为北京地域。

工坊提供商：豆包

本版实际请求地址（无需手动填写）：https://ark.cn-beijing.volces.com/api/v3/chat/completions

API · OpenAI API 平台

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 登录 OpenAI API 平台，选择你有权限使用的组织和项目。
  2. 在 API keys 页面创建密钥，创建时保存完整值；遗失完整密钥时重新创建。
  3. 在 API 平台 Billing 中单独配置计费，核对项目模型权限、额度和可用地区。
  4. 工坊选择 OpenAI；选择支持 Chat Completions 的文本模型，测试后分配阶段并保存。
ChatGPT Plus/Pro 等订阅不等于 API 额度。本版使用 Chat Completions，不代表所有只支持其他接口的模型均可使用。不要把聊天登录信息当作 API Key。

工坊提供商：OpenAI

本版实际请求地址（无需手动填写）：https://api.openai.com/v1/chat/completions

API · Gemini / Google AI Studio

打开官方控制台 / 密钥入口 · 查看官方获取指南

  1. 使用 Google 账户登录 AI Studio，打开 API Keys 页面。
  2. 选择或创建关联的 Google Cloud 项目，在该项目内创建密钥；必要时先导入已有项目。
  3. 核对项目权限、服务可用地区、模型额度及计费状态。创建按钮不可用时需要项目管理员授权。
  4. 在工坊选择 Gemini，输入 AI Studio 密钥，选择可用文本模型，测试后分配阶段并保存。
本版使用 Gemini 的 OpenAI 兼容接口，不是 Vertex AI 服务账号文件。若旧密钥被标记受限或阻止，请按官方密钥文档处理；模型网页能打开不保证 API 请求一定可达。

工坊提供商：Gemini

本版实际请求地址（无需手动填写）：https://generativelanguage.googleapis.com/v1beta/openai/chat/completions

03 · 模型设置：从测试到真正生成

  1. 填写密钥：顶部选择提供商，在对应 API Key 框粘贴完整密钥。不要添加引号、空行或“Bearer ”前缀。
  2. 测试单个模型：选择「测试模型」，点击测试连接。这会发起真实模型调用，可能计费。返回文本表示本次短请求成功。
  3. 分配阶段：在下方为故事策划、人物设定、冲突矩阵、分集大纲、剧情总览、正式剧本、默认润色、剧本医生分别选择提供商和模型。设置页的“人物设定”对应编辑流程中的“人物小篆”。
  4. 保存：点击「保存设置」。直接关闭弹窗会丢弃未保存的设置。每个所选提供商都必须有自己的可用密钥。
  5. 实际验证：用简短项目生成故事策划；看状态、文稿内容和保存版本。长文请求可能比连接测试耗时更长。

常见配置例子

你只有硅基流动密钥：把所有阶段的提供商都选为硅基流动，再分别选可用模型。不要只改顶部的提供商，下方仍保留未配置的 Kimi 或 DeepSeek。

换提供商时模型会切到该提供商默认项，请再次确认；旧模型名不能直接跨平台复用。自定义 ID 只改变模型参数，不会改变后台接口地址。

04 · 每个创作阶段怎样使用

阶段目标与检查重点
故事策划背景、核心设定、主题、主线和结局方向。先检查主人公目标、阻碍、行动与代价，避免只写气氛或设定堆砌。
人物小篆人物定位、外貌特征、背景前史、性格特质、欲望与恐惧、人物弧光、关系和语言特点。输出应是人物材料，不应直接变成第一集正文。
冲突矩阵谁和谁争什么、各自筹码、隐藏信息、升级方式及选择代价。检查冲突是否来自行动，而不只是性格不同。
分集大纲逐集目标、事件推进、转折及集尾悬念。长项目会分批处理，查看进度，不要因未立刻出全文而连续重试。
剧情总览整季因果链、人物变化、伏笔与回收。用于核对各集是否构成完整故事。
正式剧本按当前选中的集数创作。检查可拍摄动作、场景衔接、对白、信息揭示顺序与前集连续性。
剧本医生对已有材料做诊断与建议；诊断不等于自动改完全部正文，需要查看证据并决定是否修改。

题材与篇幅

新建项目支持分组题材和自定义组合，例如“民国探案＋轻喜剧”。故事想法尽量包含核心人物、目标、阻碍和结局倾向。每集字数是生成目标，不是严格排版页数，也不是 API 的 Token 上限。

生成后的正确顺序

读文稿 → 修改关键设定 → 保存 → 再进入下一阶段。修改上游材料后，通过创作检查查看下游待复查内容；保存时间检测不会自动判断所有故事矛盾。

每次生成面向当前步骤或当前集。最小化可继续运行；关闭程序会中断任务。不要把运行中的窗口关闭后当作后台持续生产服务。

05 · 编辑、排版与对话修改

编辑器

正文在编辑区域内部滚动。浮动工具栏提供正文、标题 1/2/3、引用、加粗、斜体、分隔线及撤销/重做。对选区应用加粗等格式；段落标题作用于所在段落。手工修改后点击保存；撤销未保存修改会回到最近保存稿。

右侧写作面板可切换阅读模式、字体、字号、行距和格式，并查看统计。排版预览用于阅读检查；纸张模式和主题模式影响展示。Word 导出保留文稿结构，但不要假定所有界面纹理、字体或纸张效果都会原样嵌入文档。

把一段话交给助手

  1. 在编辑器选中要修改的段落。
  2. 点击选区旁的「引用到助手」按钮，助手里出现引用卡片。只是选中文字不会自动提交。
  3. 写清希望改变什么、必须保留什么，例如：“保留事件顺序，把这段解释改成可拍摄动作；先给两个方案。”
  4. 需要时展开更换模型，选择已配置密钥的提供商和模型。
  5. 点击发送。先阅读建议和修改稿，确认后再应用；原稿保留在历史版本中。

如果只想讨论，直接说“先分析，不改正文”。如果要局部修改，说“只改引用段落，保留其他内容”。长篇讨论不是无限记忆，关键结论应记入已确认设定。

润色与对话的区别

「润色」对当前已有保存稿做整体处理，可以选择模型；「对话修改」适合逐点讨论和局部修改。按钮灰色时先检查是否有已保存正文、是否存在未保存修改、是否有生成任务正在运行。

06 · 文稿库与 v1 / v2 / v3

  1. 从侧栏或编辑页打开「文稿库」。
  2. 选择项目，再选择故事策划、人物小篆等阶段，或某一集正式剧本。
  3. 通过「文稿版本」下拉框查看 v1、v2、v3 等已有版本；每份阶段文稿与每一集分别记录自己的版本。
  4. 选择历史版本可只预览；点击「载入此版本编辑」后仍需保存，保存会形成新的当前版本，不会把历史编号倒回去。
  5. 在已有文稿的编辑页，还可把库中文稿引用到当前对话，作为讨论材料。

版本数量取决于真实保存和应用记录，并不是每次敲字都生成一个版本。遇到错误修改，先停止再次覆盖，打开文稿库核对时间与版本再恢复。

位置保存的是什么
文稿库各项目各阶段正文及可查阅的历史版本。
生成记录任务的成功、失败、处理进度与提示，不是正文版本库。
创作助手讨论与修改建议；未确认的建议不代表已保存到正文。
剧本资料库生成文稿的归档材料及外部导入资料，用于分类、分析和选作参考。

07 · 自动校对与创作检查

编辑页勾选「生成后自动校对一轮」后，生成流程会增加一次模型校对。正文原稿先保存，确认可安全应用的修正会形成新版本。若校对失败，原稿仍保留，应查看提示，不要误以为正文生成完全失败。

哪些可以自动处理

程序只自动接受有限范围内的安全修正，例如规则允许的错字、标点空格及部分场次编号问题。涉及人物、事实、情节、对白意图等修改需要人工判断；有风险或无法精确定位的建议不能当作已经自动改好。

创作检查里的三个用途

  • 修改影响：上游文稿更新后，标记可能需要复查的下游稿。点击对话复查会打开助手并填入请求，点击发送才调用模型；已实际核对后可标记无需调整。
  • 已确认设定：记录“女主从第一集就知情”等稳定决定，供后续生成和对话参考；不会自动批量改写旧稿。
  • 短剧检查：检查材料和篇幅，或通过模型讨论人物动机、钩子及前后连续性。未提供的内容不能宣称已经检查。

开启自动校对时，普通阶段通常在生成之外增加一轮；正式剧本还包含分场设计。分集大纲可能有多批调用。具体费用与实际请求次数、输入输出长度有关。

08 · 剧本资料库：导入、分类、参考

  1. 打开「剧本资料库」，展开导入，填写标题与作者/来源。
  2. 选择 TXT、Markdown、DOCX 或带文本层的 PDF，也可粘贴文本。单文件上限 10 MB，正文不超过 50 万字符；扫描图片 PDF 需先自行转成可提取文字的文件。
  3. 导入先做本地存储与基础题材归类。“导入后发送样本给模型分析”默认关闭；打开它或点击分析写法，会联网并可能计费。
  4. 查看模型给出的类型、风格、手法、证据片段，修正不准确标签后确认，资料才可用于后续参考。
  5. 进入具体项目的资料库设置，开启本项目参考，勾选已确认的资料（最多 8 份），按需设置题材、风格、手法及参考强度，保存。
  6. 查看实际匹配的参考列表，再生成或发送对话。筛选条件同时生效，选中了资料但标签不匹配，也可能没有资料被带入。

已生成并保存的阶段文稿会归档；原文更新后相关分析和确认需要重新处理，避免旧分析继续代表新版本。资料库检索只截取相关片段，并不是把所有剧本全文都塞进每次请求。

它如何“学习”

当前实现是本地存储、标签、方法总结与生成时检索参考，不是 LoRA 微调，不改变模型权重。可以学习“限制视角”“动作表达情绪”“悬念逐步揭示”等可描述方法；不要把复述大段原文当作风格学习。

原稿保存在本机，但一旦点击云端分析或把资料用于生成/对话，相关样本或片段会发给当前模型提供商。只导入你有权使用的资料。

09 · 创作记忆与实际写作例子

创作记忆保存可以反复利用的偏好、项目设定和范本。待确认内容需确认启用，停用后后续请求不再引用。项目规则优先于通用偏好；上下文有条数和长度限制，并非每次带入全部资料。

适合记住的内容

  • “女主第一集已知父亲失踪原因，后续不能再写成完全不知情。”
  • “对白少用解释性独白；重要情绪优先用动作和选择体现。”
  • “本项目发生在民国小镇，不出现手机和现代支付工具。”

一次完整的修改示例

  1. 在人物小篆选中男主背景，引用到助手：“保留职业和年龄，为他隐瞒真相补充能说服观众的动机，先讨论。”
  2. 确认方向后说：“采用第二个方案，只改背景前史和欲望与恐惧，其他字段保留。”
  3. 检查修改稿并应用，在文稿库确认出现新版本。
  4. 把已经决定的动机记入项目设定。
  5. 打开创作检查，逐一复查受影响的大纲、总览及已写剧集。

引用记录表示内容已提交给模型，不保证模型完全遵守。重要人物事实、因果链与结局仍应由创作者核对。

10 · 连接和生成问题排查

现象按顺序检查
401 / 无效密钥完整复制 → 提供商是否匹配 → 是否被撤销 → 是否用了专用套餐密钥。不要公开完整密钥。
403 / 无权限账户开通状态、实名认证要求、模型授权、项目空间、地域及密钥权限。
404 / 模型不存在完整模型 ID → 当前平台是否提供 → 账户是否有权限 → 接口/地域是否正确。404 不等于一定没余额。
400 / 参数或格式错误模型是否支持当前接口；自定义 ID 是否正确；文稿或消息是否过长。自然语言可以使用，不需要自己写 JSON。
429 / 限流停止连续重试，等待后再试；查看平台速率和额度限制，必要时改用可用模型。
余额不足或额度耗尽查看密钥所属平台的 API 账单和额度；聊天会员、不同平台及不同套餐额度通常不能直接代用。
5xx / 平台异常查看官方服务状态，稍后重试；不要立刻大幅重写提示词。
测试成功，生成失败先查该阶段分配的模型是不是测试过的同一个，再查长文上下文、输出长度、限流与超时。
模型响应超时查看生成记录是否有进度；当前长文请求设有连续无活动和总时长限制。缩短不必要资料、减少同时任务或换可用模型。失败后先查文稿库是否已有原稿或分批结果。
生成了错误阶段确认当前选中的阶段，检查上游材料是否混入“请写第一集”等指令，用对话明确本阶段目标。不要直接覆盖满意的旧版本。
按钮不能点是否有已保存正文、未保存修改、正在处理的任务、缺少密钥；先看旁边提示。
白屏 / 窗口异常记录发生前的操作和版本号，停止反复点击；有运行中任务时不要随意强退。重新启动后检查保存稿；保留脱敏错误信息反馈，不要删除数据库尝试修复。

测试连接本身可能计费。提供排查信息时只需版本号、提供商、模型名、阶段、错误码和时间；密钥必须打码，正文可换成简短复现示例。

11 · 导出、备份与换电脑

导出作品

先保存修改，再点击项目右上角的「导出 Word」或「导出 Markdown」。打开导出文件检查段落、标题、特殊字符与集数。Word / Markdown 是文稿交付，不包含完整聊天、版本历史、资料库、记忆和所有应用设置。

备份全部本地资料

Windows 的应用数据位于 %APPDATA%\DeepWhiteScriptFactory。可按 Win + R，粘贴这个路径打开。里面的 local-data 保存数据库和配置。macOS 测试环境通常位于 ~/Library/Application Support/DeepWhiteScriptFactory；隔离测试窗口另用临时数据。

  1. 保存文稿，等待生成结束，正常关闭程序。
  2. 复制整个 DeepWhiteScriptFactory 数据文件夹到你选择的备份盘，按日期保留多个副本。不要只复制正在运行中的 stories.sqlite 文件。
  3. 升级前先保留备份；应用内升级流程也会生成本地数据库快照，但这不能替代异地备份。
  4. 换电脑时先安装兼容版本、退出程序，再在保留目标机旧资料备份的前提下迁移数据。不要把两个数据库直接合并或覆盖而不留副本。
  5. 密钥受操作系统加密保护，跨电脑后可能不能解密，需要重新输入各平台 API Key。不要把密钥配置公开发送。

安装包升级与数据目录是两件事；换主题不会删除项目。不要通过删除数据目录来“重置外观”。资料库不是云盘，本版不提供多电脑自动同步。

12 · 外观、窗口与日常习惯

「外观主题」可切换暖纸书房、星际机甲、灌篮高手和 BLEACH。暖纸书房首页显示最近更新的项目，点击继续创作即可进入；作品书架支持按剧名、题材或故事描述搜索。

高分辨率电脑上如果界面太小，使用顶栏「界面」缩放选择合适比例；Ctrl / ⌘ 加 + 或 - 调整，Ctrl / ⌘ 加 0 回到自动。正文字号与整个界面缩放是两项不同设置。

创作助手可拖动标题区移动，可收起或放大。只收起助手不会清空正文。发送前确认当前阶段、引用段落及所选模型，避免把上一轮的引用误用于新的问题。

每次写作结束前

  • 保存当前稿，在文稿库确认版本与内容。
  • 把真正定下的设定记住，未决定的方案留在讨论里。
  • 查看生成记录、校对提示与待复查项。
  • 重要节点导出 Word / Markdown，并定期备份本地资料。

应用负责组织材料和辅助写作，创作者负责最终判断：人物选择是否可信、场景能否拍摄、故事是否有感染力。