1.1 下载和解压

1. 从写吗官网或官方网盘下载主程序压缩包；
2. 把压缩包完整解压到固定目录，不要直接在压缩包里双击运行；
3. 不要只复制 写吗.exe，旁边的 DLL、Config、Resources 等文件也必须保留；
4. 双击 写吗.exe；
5. Windows 显示安全提示时，先确认文件来自官方渠道，再选择继续运行。

推荐放置位置：

D:\写吗\
├─ 写吗.exe
├─ Config\
├─ Resources\
├─ Plugins\       ← 安装插件后可能出现
├─ Components\    ← 安装组件后可能出现
└─ Runtime\       ← 使用便携本地 AI 时可能出现

1.2 第一次联网设置怎么选

• 只写作、管理项目，暂时不使用在线功能：可选择完全离线；
• 使用本机 Ollama、局域网协作：至少允许本机与局域网；
• 使用 DeepSeek 等在线 API、在线模型目录或网络插件：需要允许相应互联网访问；
• 以后随时可以在设置中修改。

1.3 新建第一个项目

1. 点击工具栏的项目或文件夹入口；
2. 选择一个真实存在、空间充足的本地目录；
3. 为小说、论文、网站、研究课题分别建立项目；
4. 在文件树中建立“正文、资料、设定、图片”等目录；
5. 新建 .md、.mdx、.txt、.html、.py 等文件开始工作。

我的小说/
├─ 正文/
├─ 人物设定/
├─ 世界观/
├─ 时间线/
├─ 参考资料/
└─ 图片/

2.1 成对符号、选区包裹与智能回车

输入左括号、引号或反引号时，编辑器会根据光标位置自动补全右侧符号：

( )    [ ]    { }    " "    ' '    ` `

• 没有选区时，输入左符号会补出右符号，并把光标放在中间；
• 已经选中文字时，输入左括号或引号会把选区包裹起来，不会直接覆盖选中文字；
• 光标位于自动补出的右符号前时，再输入该右符号会直接越过，避免重复；
• 按退格键删除空的成对符号时，左右符号会一起删除。

在代码块、对象、数组或函数体的成对括号中按 Enter，会插入新行并计算缩进：

function test() {|}

按回车后：

function test() {
    |
}

如果已经选中了两个匹配符号之间的全部内容，再按回车，编辑器会删除选中内容，在两个符号之间插入空行并自动缩进，适合快速清空函数体、对象或数组。

2.2 行注释与块注释

切换行注释：Ctrl+/

• 没有选区时，注释或取消注释当前行；
• 选中多行时，一次处理所有覆盖行；
• 再次按同一快捷键会取消注释；
• 编辑器会根据文件类型选择注释符号。

切换块注释：Shift+Alt+A

选中一段代码后按 Shift+Alt+A，会用该语言的块注释符号包裹选区；再次执行可取消。若当前语言没有块注释规则，命令会保持不可用或给出提示。

2.3 整行复制、移动、删除和插入

这些操作不要求精确选中整行。没有选区时处理当前行；有选区时处理选区覆盖的完整行块。

所有这些操作都会进入编辑器撤销栈，可以用 Ctrl+Z 撤销、Ctrl+Y 重做。

2.4 多光标、相同内容选择与批量改名

• Ctrl+单击：在鼠标位置追加一个光标；
• Ctrl+拖动：追加一个选区；
• Ctrl+D：选择下一个与当前选区相同的文本，并追加光标；
• Ctrl+Shift+L：选择当前文件中全部相同文本；
• 多光标状态下，输入、退格、删除、回车、Tab、粘贴会同时作用于所有位置；
• 按 Esc 或普通单击退出多光标。

典型用法：先双击选中变量名，再连续按 Ctrl+D 选择需要修改的几处，直接输入新名称。只想改当前文件中的所有同名文本时，可用 Ctrl+Shift+L；需要跨文件修改时，应使用工作区搜索并逐项确认。

2.5 查找、替换、快速打开与跳转

2.6 代码补全、代码片段与占位符跳转

• Ctrl+Space：主动显示补全候选；
• ↑ / ↓：切换候选；
• Enter 或 Tab：插入候选；
• Esc：关闭候选；
• 插入带多个填写位置的代码片段后，按 Tab 跳到下一处，Shift+Tab 返回上一处。

候选来源包括内置词库、当前文件中的类/函数/变量、当前项目代码符号、HTML 的 class 与 id、CSS 属性、JavaScript 点号成员、PHP 的 -> 和 :: 成员等。

2.7 HTML 快速完成（Emmet 风格）

在 HTML、Vue、Svelte，以及 PHP 文件的 HTML 区域输入缩写后按 Tab：

2.8 Markdown / MDX 输入辅助

• 无序列表、有序列表和任务列表在行尾按 Enter 会自动续写；
• 空列表项再次按 Enter 会退出列表；
• Tab 增加列表层级，Shift+Tab 减少层级；
• Ctrl+Shift+C 插入三反引号代码块；
• Ctrl+Shift+= 计算当前行算式；
• 预览编辑中可以直接修改文字；MDX 组件可用 Ctrl+单击 重新打开设置；
• 编辑与预览模式支持双向滚动定位，长文建议配合文档地图使用。

2.9 文件、标签与 Windows 拖放

• 把编辑标签拖到文件树目录：普通拖动为移动，按住 Ctrl 拖动为复制；
• 移动后，已经打开的标签会更新到新路径；
• 把资源管理器中的文本或代码文件拖入编辑区：在新标签中打开；
• 图片交给图片查看器；EXE、DLL、BIN、DAT 等交给十六进制编辑器插件；
• 拖入 EXE 只会查看内容，不会自动执行；
• 文件树支持 Ctrl+X / Ctrl+C / Ctrl+V，可以在不同项目目录或 Windows 资源管理器之间移动、复制。

2.10 默认快捷键完整表

文件、项目和历史

编辑和选择

AI、视图和运行

3.1 普通保存不等于保存历史

Ctrl+S 只把当前内容写入磁盘。普通保存、自动保存、AI 修改、网页可视编辑、插件同步和局域网协作写入都不会自动建立历史节点。

历史节点只有在用户主动点击“保存历史”或按 Ctrl+Shift+S 时才创建。

3.2 节点标题是什么

工具栏“历史”旁边的“节点标题”输入框，用于给这次历史取一个容易识别的阶段名称。标题可以不填，但长期项目强烈建议填写。

好的节点标题应说明“完成了什么”或“接下来准备改什么”：

第一章初稿完成
人物关系调整前
第三轮校对完成
客户反馈修改前
网页首页布局完成
发布前最终版本
AI 整章改写前

不推荐长期只使用“保存1、保存2、最新版”这类无法回忆内容的标题。

3.3 什么时候保存历史

• 开始大改之前；
• 使用 AI 改写整章之前；
• 批量替换之前；
• 完成一章、一个页面或一个交付阶段之后；
• 合并他人修改之前；
• 发布、打印、提交客户之前；
• 发现当前状态值得保留时。

推荐流程：

写作中不断 Ctrl+S
→ 到达关键阶段
→ 填写节点标题
→ Ctrl+Shift+S 保存历史
→ 继续下一轮修改

3.4 历史版本下拉列表能做什么

工具栏中的版本下拉列表显示当前文件已经保存的历史节点。选择一个节点后，可以：

• 把它设为当前比较基准；
• 点击“查看”打开只读版本预览；
• 在审查模式中查看当前内容与该节点的差异；
• 进入“历史实况”，直接把正文切换到该旧版本浏览。

3.5 “完整历史”窗口能做什么

点击工具栏的时钟图标，或“查看 → 查看完整历史”，会打开完整历史窗口：

• 左侧：历史版本列表和节点标题；
• 右侧：所选历史与当前正文的修改块；
• 红色区域：历史中存在、当前被删除或替换的内容；
• 绿色或强调色区域：当前新增或修改后的内容；
• “只恢复这一处”：只把一个修改块恢复成旧内容，其他地方不变；
• “恢复整个版本”：把全文恢复成所选历史，并建立恢复记录，不会删除原有历史。

“只恢复这一处”只是修改当前编辑区，之后仍要按需要 Ctrl+S，并在重要阶段主动保存新的历史节点。

3.6 审查模式和鼠标悬停对比

在“查看 → 切换审查模式”中开启审查后，编辑器会把当前正文与选择的历史基准比较：

• 新增、删除、修改会显示不同的历史标记和颜色；
• 鼠标停在有改动的文字或删除标记附近，会弹出“旧 / 新”对比；
• 左侧历史标记上悬停会显示节点标题和改动类型；
• 单击历史标记可以打开该处的详细变化，并可恢复这一处；
• 文档地图也能帮助快速找到整篇长文中的变化位置。

审查模式适合校对、检查 AI 改写结果、核对客户修改和确认发布前差异。它不会自动保存文件，也不会替你创建历史。

3.7 历史实况是什么意思

“历史实况”不是一个单独弹窗，而是把当前编辑器直接切换到所选历史版本：

1. 在版本下拉列表中选择旧节点；
2. 点击“历史实况”；
3. 编辑区切换为该节点的真实全文；
4. 当前处于只读状态，避免无意修改旧版本；
5. 切换版本下拉列表，可以连续浏览不同历史；
6. 点击“退出实况”，回到最新历史节点。

如果当前正文与最新历史不同，进入实况前程序会提醒：

• 是：先把当前正文保存成历史，再进入；
• 否：不建立历史，直接进入；
• 取消：保持当前正文不变。

在历史实况中点击“保存历史”，可以把当前旧版本复制成一个新的历史分支节点，然后继续编辑。适合“从旧方案重新发展”，而不是覆盖后面的历史。

3.8 单文件历史、项目快照和 Git 的区别

三者可以同时使用，并不冲突。

4.1 怎样建立资料库

1. 在项目中建立一个清晰的资料目录；
2. 把人物、设定、术语、规范、产品资料、研究文献摘要等分文件保存；
3. 在文件树中右键该目录，选择“设为当前项目资料库”；
4. 也可以到“设置 → AI 助手”中选择项目资料库；
5. 首次使用或资料大量变化后，可点击“刷新资料库索引”。

资料库最好使用小而清楚的文本文件，不要把所有内容塞进一个数十万字的大文件。

4.2 不同行业可以放什么

4.3 哪些功能会读取资料库

资料库不是全局强制读取。是否读取由具体任务决定：

• 写作助手“会话”页：勾选“检索项目资料库”时读取；
• “快捷”页选择来源为“项目资料库”时读取；
• AI 预制命令：该命令勾选资料库检索时读取；
• 输入辅助和边写提示：由被设为默认模板的预制命令决定；
• 只做错别字、格式检查时，通常不需要资料库；
• 核对人物、术语、项目规范、时间线时，建议启用。

资料库中没有明确内容时，AI 应说明资料不足，而不是自行编造。

5.1 会话：连续讨论和修改正文

“会话”适合需要多轮问答的工作：

• 针对已加载页面提问；
• 讨论人物动机、文章结构、技术方案；
• 让 AI 解释某段内容或提出多个修改方向；
• 新建多个互不干扰的会话，例如“剧情讨论”“校对”“客户版本”；
• 控制发送给模型的历史轮数；
• 选择本地、云端或自动通道；
• 勾选“检索项目资料库”后，结合长期资料回答；
• 对回复执行“复制”“重发”“替换选区”“插入回复”。

不同会话的消息历史互相独立。长期项目不要把所有问题都塞进一个会话。

5.2 罗列：把长内容变成可定位的结构清单

“罗列”适合从一个或多个已加载页面中提取结构：

罗列所有人物及首次出现位置
按层级列出本文核心观点
列出全部待办、风险和负责人
提取章节标题和关键事件
按时间顺序罗列事件
列出所有产品参数和限制条件

结果以带层级的 Markdown 清单显示。点击任意条目可以跳回原文；同名条目可重复点击循环定位下一处。

它与普通摘要不同：摘要偏向压缩内容，罗列偏向建立“可点击的目录、清单和定位结果”。

5.3 任务：把细纲或验收要求变成检查表

“任务”页适合管理本章、本页或本次交付要求：

1. 在“本章目标与验收要求”中粘贴细纲、写作目标、产品要求或客户标准；
2. 点击“生成检查项”；
3. AI 将要求拆成分组和子任务；
4. 完成正文后点击“检查是否完成”；
5. AI 根据上方已加载页面更新完成状态；
6. 可以手动修改任务文字，但完成勾选由检查结果更新。

示例：

本章必须出现：主角发现钥匙、两人第一次争执、埋下失踪线索；
不能直接揭露反派身份；结尾保留悬念。

任务页能帮助你确认“有没有做到”，但不能代替最终人工检查。

5.4 快捷：快速提取一组可编辑、可插入的结果

“快捷”适合一次性提取明确项目：

• 人物名称；
• 地点；
• 组织；
• 产品参数；
• 术语；
• 风险点；
• 引用；
• 待办；
• 文章标题候选。

可以选择来源：当前加载范围或项目资料库。结果支持逐项编辑、删除，双击任意项目可插入当前编辑器光标位置。

“快捷”与“罗列”的区别：

6.1 MDX 可以做什么

• 彩色文字、背景标记、局部字号、渐变文字；
• 鼠标悬停批注；
• 首行缩进、行距、两端对齐；
• 一栏、两栏、三栏布局；
• 提示卡、折叠区、投票、日期、分隔线、资料来源；
• 图片、音频、视频及尺寸、比例、对齐、圆角；
• MDX 表格及行列、合并、宽度设置；
• Mermaid 流程图、时序图、思维结构图、类图、状态图、Git 图等；
• 编辑与预览并排、直接在预览中修改。

示例：

:::callout type=info title="提示"
这里是需要读者注意的内容。
:::

:::columns count=2
左栏内容

---column---

右栏内容
:::

6.2 源码编辑方式

打开 .mdx 后，编辑器顶部会出现 MDX 快捷工具。可以选择文字后执行：

• 字号、文字色、背景色、渐变文字；
• 批注；
• 一栏、两栏、三栏；
• 折叠、提示和更多组件；
• 插入图片、媒体、表格和 Mermaid 图表。

在组件开始行或结束行上按程序提示操作，可重新打开组件设置并保留原源码。

6.3 预览中的图形化操作

1. 选择“编辑与预览”或“仅预览”；
2. 点击预览工具栏的“编辑”；
3. 在渲染后的内容中选择文字或放置光标；
4. 使用标题、粗体、斜体、标记、列表、表格、对齐等按钮；
5. MDX 文件还会显示字号、颜色、渐变、批注、分栏、折叠、提示和“更多”；
6. 可以直接插入图片、音频、视频和图表；
7. 修改会写回 MDX 源码，重要修改前请先保存历史。

6.4 图片和媒体拖放

把图片、音频或视频拖入 MDX 编辑框，程序会询问或按规则生成媒体组件。可控制：

• 固定宽度或百分比宽度；
• 自适应或固定宽高比；
• contain / cover；
• 左、中、右对齐；
• 圆角；
• 图片说明和替代文字。

6.5 Mermaid 图表

在 Markdown 和 MDX 中均可插入 Mermaid。MDX 图表窗口可选择模板，也可直接输入语法。常用类型包括流程图、时序图、类图、状态图、实体关系图和 Git 图。

flowchart LR
    A[收集资料] --> B[建立大纲]
    B --> C[撰写正文]
    C --> D[审查与保存历史]

图表较宽时可在图表区域内部滚动；语法错误只影响当前图表，不会破坏整篇预览。

7.1 基本使用

1. 打开一个代码文件，例如 test.py；
2. 第一次使用时打开“运行 → 运行环境设置”；
3. 让程序自动检测，或手动选择 Python、Node.js、PHP、Java、.NET 等路径；
4. 按 F5；
5. 底部运行面板实时显示输出、错误、运行时间和退出代码；
6. 需要输入时，在运行面板发送程序输入；
7. Shift+F5 停止运行；
8. Ctrl+F5 重新运行上一次文件。

7.2 当前适合运行的文件

• Python：.py、.pyw；
• JavaScript：.js、.mjs、.cjs；
• TypeScript：需要 tsx 或 ts-node；
• PHP；
• PowerShell、CMD、BAT、Shell；
• C# / .NET 项目；
• Java、Go、Ruby、Lua、Dart；
• Rust / Cargo 项目。

C/C++ 单文件通常还需要编译任务链，当前不应把 F5 当作完整 C/C++ IDE。

7.3 Python 用户最常见的设置

程序会优先查找项目中的：

.venv\Scripts\python.exe
venv\Scripts\python.exe
env\Scripts\python.exe

也可以在运行环境设置中手动指定 Python。报错中带文件和行号时，双击输出位置可跳转到源码。

7.4 F5 不是完整断点调试

当前是“运行中心”，可以运行、输入、停止、查看输出和跳转错误。断点、单步执行、变量、调用栈等属于后续完整调试能力。

8.1 第一次使用

1. 在“设置 → 组件与插件”安装并启用“网页开发与可视设计”；
2. 打开 HTML 或 PHP 入口文件；
3. 点击“开启/刷新 Web 实时预览”；
4. HTML/CSS/JS 静态页面可以直接预览；
5. PHP 项目需要设置 phpStudy、Apache、Nginx 或其他本地服务器的地址与路径映射；
6. 修改代码后，自动刷新或手动“应用并刷新”。

8.2 静态页面和服务器页面

• 静态 HTML：程序直接加载本地文件，并联动本地 CSS、JS、图片；
• PHP：浏览器需要访问服务器 URL，程序通过本地目录与网址的映射找到对应文件；
• Vite 等开发服务器：填写实际预览地址，插件监听源码或构建输出；
• 桌面、平板和手机尺寸可用于响应式检查；
• 需要排查网页错误时可打开 Edge 开发者工具。

8.3 可视设计

1. 开启预览后点击“可视设计”；
2. 在右侧页面中点击元素；
3. 蓝色边框表示当前选中元素；
4. 元素默认锁定，点击“移动缩放”后才允许拖动和八方向缩放；
5. 使用“文字色、背景色、参数”修改字号、圆角、边距、宽高等；
6. 点击“改文字”后可在页面中直接输入，Ctrl+Enter 完成，Esc 取消；
7. 点击“代码”或“来源”定位 HTML 标签或实际 CSS 规则；
8. 点击“应用代码”结束编辑但不强制刷新；
9. 点击“应用并刷新”写入并重新加载最终页面。

进入改文字、改颜色、移动或缩放后，自动刷新会临时暂停，避免页面在操作中途重载。

8.4 CSS 会写到哪里

插件会优先更新元素已经命中的：

1. 行内 style；
2. 当前页面已有 <style> 规则；
3. 本地外链 CSS 中的真实选择器；
4. 找不到安全唯一规则时，再建立普通 CSS 规则。

它不会把 CSS 随意追加到 </html> 后面。同一元素的后续修改会尽量更新同一规则。

8.5 元素与源码双向定位

• 在预览中点击元素，左侧编辑器定位到对应标签；
• 点击浮动工具中的“代码”，再次定位源码；
• 点击“来源”，查看颜色、字号、边距等来自哪个 CSS 文件和选择器；
• CSS 文件可以按选择器定位；
• JavaScript 动态生成的元素可能只能近似定位。

8.6 使用网页功能时的历史建议

网页可视操作不会自动建立历史。开始大改前：

填写节点标题“首页可视布局调整前”
→ 保存历史
→ 开始移动、改文字、改颜色
→ 应用并刷新
→ 检查源码与页面
→ 再保存“首页布局完成”历史

9.1 先分清三个东西

安装 Ollama 不等于已经有模型；下载模型后也要在写吗中选择或连接。

9.2 官方 Ollama 安装方式

普通用户优先使用 Ollama 官方 Windows 安装程序：

1. 打开 https://ollama.com/download/windows；
2. 下载并安装 Windows 版；
3. 安装后 Ollama 通常在后台运行；
4. 在 PowerShell 中输入 ollama -v 检查；
5. 写吗中选择“自动选择”或“外部 Ollama”；
6. 外部地址通常为 http://127.0.0.1:11434。

Ollama 官方也提供独立 ZIP。只有需要便携运行或明确知道怎样启动 ollama serve 时才使用独立包。

9.3 写吗所说的“内置 Ollama”

“内置”是指完整运行文件被放在：

写吗程序目录\Runtime\Ollama\ollama.exe

写吗会使用独立地址，例如：

http://127.0.0.1:21434

如果官方网盘没有提供便携 Ollama 包，用户直接安装 Ollama 官方版即可，不需要等待网盘补包。

9.4 下载模型的三种方式

方式 A：写吗模型库

1. 打开设置中的模型库；
2. 选择适合电脑的模型；
3. 点击下载；
4. 到“下载任务”查看速度、暂停、继续、失败重试；
5. 下载完成后点击“使用此模型”。

方式 B：手动下载 GGUF

1. 从可信模型发布页选择 GGUF；
2. 初次建议 Q4 量化；
3. 分卷模型的全部分卷放在同一目录；
4. 复制到写吗设置中显示的模型目录；
5. 重新扫描并选择模型；
6. 不要只改扩展名，也不要把普通模型文件假装成 GGUF。

方式 C：Ollama 模型库

在 PowerShell 中：

ollama pull 模型名
ollama list

然后在写吗的模型连接中填写相同模型名。

9.5 模型大小怎么选

实际占用还受上下文长度、显卡、CPU、模型架构和其他程序影响。新手先用较小的 Q4 模型测试稳定性。

10.1 DeepSeek 示例

1. 到 DeepSeek API 平台注册并创建 API Key；
2. 确保账户有可用余额；
3. 打开“设置 → 模型连接”；
4. 选择 DeepSeek 或兼容的自定义平台；
5. 填写服务地址、模型名和 API Key；
6. 保存并启用云端模型通道；
7. 到输入辅助中把需要的功能设为“云端”或“自动”；
8. 先选中一小段文字测试摘要或润色。

当前官方 OpenAI 兼容 Base URL 为：

https://api.deepseek.com

对话接口通常为：

https://api.deepseek.com/chat/completions

截至 2026 年 7 月 31 日，官方模型 ID 包括：

deepseek-v4-flash
deepseek-v4-pro

在线模型会更新，最终以服务商后台和官方文档为准。

10.2 其他 OpenAI 兼容服务

填写服务商提供的：

服务地址：完整的 chat/completions 地址或程序要求的 Base URL
模型名称：服务商公布的模型 ID
访问密钥：你自己的 API Key

不要照抄其他人的密钥，也不要把密钥放进正文、截图、公开仓库或网盘。

10.3 常见错误

在线 API 可能接收当前选区、正文、助手规则和检索到的资料。敏感内容优先使用本地模型，或先确认服务商的数据政策。

11.1 推荐：在程序中安装

1. 从官方网盘、官网或可信来源下载插件包；
2. 打开“设置 → 组件与插件”；
3. 点击“安装本地插件”；
4. 选择 .zip 或 .wspkg；
5. 查看插件名称、版本、权限和适用等级；
6. 安装完成后启用插件；
7. 如未出现入口，点击“重新扫描插件”。

程序安装的用户插件通常放在：

%LOCALAPPDATA%\写吗\Plugins

11.2 包内已有 Plugins 目录时

某些官方合集包已经包含完整目录：

插件包.zip
└─ Plugins\
   └─ WritingSystem.Plugin.某插件\
      ├─ plugin.json
      ├─ 插件入口.dll
      └─ 依赖文件

手动安装：

1. 完全退出写吗；
2. 解压插件包；
3. 把包内的 Plugins 目录复制到写吗程序根目录；
4. 合并目录，不要再多套一层压缩包名称；
5. 启动写吗，重新扫描并启用。

正确结果：

写吗\Plugins\插件ID\plugin.json

常见错误：

写吗\Plugins\某插件包\Plugins\插件ID\plugin.json  ← 多套一层
写吗\Plugins\plugin.json                             ← 少了插件目录
只复制一个 DLL                                           ← 缺少 plugin.json 和依赖

11.3 Components 组件包

背景音乐等组件可能使用 Components 目录：

写吗\
├─ 写吗.exe
└─ Components\
   └─ Music\
      └─ WritingSystem.Component.Music.dll

把包内 Components 复制到程序根目录，然后到组件与插件页启用。

11.4 行业助手包

行业助手是规则、提示词和资料配置，不包含大模型。通常按包内说明安装，可能包含：

某行业助手.aiassistant.json
安装助手包.cmd
安装说明.txt

这类 安装助手包.cmd 是成品包内给用户使用的安装工具，与开发者构建脚本不是一回事。运行后到“设置 → AI 助手”重新加载扩展并选择助手。

11.5 更新插件

• 更新前退出写吗；
• 优先用“安装本地插件”选择新包；
• 手动更新时覆盖整个插件目录，不要只替换单个 DLL；
• 启动后重新扫描，检查版本和启用状态；
• 收费插件文件可以安装，但仍需许可证包含对应权限。

12.1 Git 项目助手：个人使用

Git 插件把常见命令翻译成中文：

首次使用需安装 Git for Windows。推荐流程：

1. 打开 Git 工作台，选择当前项目；
2. 项目还没有 Git 时，点击启用或初始化；
3. 修改文件；
4. 在修改列表查看“尚未加入、已加入、未跟踪、冲突”；
5. 点击文件查看中文差异；
6. 填写版本说明，例如“完成第一章初稿”；
7. 简单使用可直接“保存全部修改为版本”；
8. 需要精确控制时，只把选中的文件“加入本次版本”；
9. 保存版本后，可在最近版本中查看详情。

初始化 Git 不会自动上传文件。本地 Git 在离线状态也能正常使用。

12.2 Git 团队使用

团队推荐约定：

1. 每个人先“获取云端更新”；
2. 修改自己负责的文件；
3. 保存写吗历史节点，保留本地阶段；
4. 在 Git 工作台检查差异；
5. 填写清楚的版本说明并保存版本；
6. 再次获取云端更新；
7. 没有冲突后上传；
8. 大功能使用独立分支，完成后由团队约定方式合并。

不要多人同时长期修改同一大文件。小说团队可以按章节分文件，网站团队可以按页面或模块分工。

12.3 Git 冲突怎么处理

当本地和云端对同一位置作了不同修改，会显示冲突。当前插件能识别冲突，但没有三栏可视合并器。

安全处理步骤：

1. 不要立刻“放弃修改”；
2. 打开冲突文件；
3. 搜索 Git 冲突标记：

<<<<<<<
=======
>>>>>>>

4. 对照双方内容，保留正确部分并删除标记；
5. 保存文件；
6. 在写吗中保存一个历史节点，例如“解决云端冲突后”；
7. 回到 Git 工作台，把文件“加入本次版本”；
8. 保存冲突解决版本；
9. 再上传。

不确定时，先复制冲突文件或创建项目快照。未跟踪文件使用“放弃修改”可能被永久删除，必须看清确认提示。

12.4 项目快照

适合在大改、发布、重构、批量移动文件前保存整个项目：

1. 先保存全部打开文档；
2. 打开左侧“快照”工作台；
3. 选择项目；
4. 输入快照名称和备注；
5. 创建快照；
6. 之后可比较新增、修改、删除；
7. “安全恢复”会保留快照之外的额外文件；
8. “精确恢复”会恢复为快照的文件集合，使用前务必确认；
9. 可导出普通 ZIP 长期归档。

12.5 项目进度

用于统计：

• 项目总有效字数、文档数量；
• 今日新增、删除、净增；
• 中文字符、英文单词、数字词组；
• 项目目标、每日目标和截止日期；
• 最近 90 天变化；
• 字数最多的文件。

多项目用户先在“统计项目”中选择正确项目。插件只保存统计和指纹，不保存正文内容。

12.6 术语表与角色设定

适合管理人物、地点、组织、产品、专业术语：

• 名称、别名、分类、标签；
• 简介和详细说明；
• 角色定位、外貌、性格、人物关系；
• 搜索和分类筛选；
• 插入名称、[[双向链接]]、Markdown 简介或完整设定卡片。

小说可建立人物卡；企业项目可建立产品、部门、政策和缩写；研究项目可建立概念、作者和方法术语。

12.7 局域网协作

以完整项目目录协作，每台电脑保存自己的本地副本：

1. 发起方选择要共享的项目；
2. 设置参与者和文件权限；
3. 其他电脑加入共享项目；
4. 在线时同步正文和目录变化；
5. 断线时继续编辑本地副本；
6. 重连后重放操作并合并文本；
7. 权限变化、远端删除等未发布内容进入冲突中心；
8. 每个人在关键阶段主动保存自己的写吗历史。

协作操作日志用于断线同步，不等于历史节点。发起方结束会话后，各参与者仍保留自己的本地副本。

12.8 十六进制编辑器

用于查看 EXE、DLL、BIN、DAT 等二进制文件：

• 默认只读；
• HEX 和文本双栏；
• 搜索十六进制、ASCII、UTF-8、UTF-16；
• 跳转偏移；
• 修改先保存在内存补丁中；
• 保存副本，或确认后覆盖原文件并建立 .bak；
• 修改 EXE/DLL 可能导致签名失效，普通用户不要随意覆盖原文件。

12.9 中译英变量词典

面向代码命名的离线工具：

当前用户 → currentUser
错误信息 → errorMessage
用户列表 → userList
是否启用 → isEnabled

有选区时转换选区；无选区时只读取光标前连续中文。可在插件旁的键盘入口添加快捷键，并在设置中显示编辑器快捷按钮。

12.10 RSS、FTP、邮箱、数据库、图片与音乐

只安装真正需要的插件。插件未启用时，不应持续占用工作区或运行无关后台任务。

{
  "sessionId": "mini-program-10086",
  "nickname": "张先生",
  "avatar": "https://example.com/avatar/10086.png"
}

13.1 ComfyUI AI 媒体工作台：从正文到插图、分镜和短视频

它与 ComfyUI 的分工

因此，普通用户面对的是“为选区配图”“为章节生成分镜”“做角色立绘”，而不是手动修改节点编号。

使用前准备

1. 单独安装并启动 ComfyUI。插件不捆绑 ComfyUI、模型、自定义节点或 FFmpeg。
2. 确认浏览器能打开 ComfyUI 服务，默认地址通常是 http://127.0.0.1:8188。
3. 至少准备一个可正常出图的 Checkpoint；需要 LoRA、ControlNet 或视频工作流时，先在 ComfyUI 中把对应节点和模型安装完整。
4. 在“设置 → 插件设置 → AI 媒体工作台”填写 ComfyUI 地址，并点击“测试连接”。
5. 填写默认 Checkpoint 文件名、默认图片尺寸、步数、CFG、采样器、调度器和负向提示词。
6. 视频生成必须选择与本机节点、模型匹配的 API 格式 JSON 工作流，不能把普通界面工作流 JSON 当作 API 工作流使用。
7. 需要输出完整 MP4 时，在设置中选择 ffmpeg.exe；只生成图片或单段视频时可暂时留空。

第一次生成图片：最稳妥的步骤

1. 先在 ComfyUI 自己的界面中运行一次基础工作流，确认模型和节点没有缺失；
2. 回到写吗，打开一个已经保存到项目中的 Markdown 或 MDX 文件；
3. 选中一段适合画面的正文，例如环境描写、人物出场或产品卖点；
4. 右键编辑器，或打开“扩展 → AI 媒体 → 根据选中文字生成图片”；
5. 检查“正文来源”，选择任务模板、宽高和视觉档案；
6. 点击分析，让写吗 AI 或本地规则生成正向、负向提示词；
7. 人工检查提示词，尤其是人物数量、服装、时间、地点、镜头和禁止元素；
8. 提交生成，等待队列完成；
9. 预览结果，选择“插入当前文档”“打开文件”“打开所在目录”或继续生成新版本；
10. 满意后标记为“采用版本”，避免以后混淆。

创作页中的主要任务

视觉资料库：让人物和画风保持一致

视觉资料可建立“角色、场景、风格、道具”等档案。每个档案可以保存：

• 名称、说明、标签；
• 正向提示词和负向提示词；
• 项目内参考图片；
• 固定 Seed；
• Checkpoint、LoRA 名称与权重；
• 该角色或风格专用的 ComfyUI API 工作流。

参考图会复制到 <项目>/.xiema/ai-media/references，索引使用项目相对路径。整个项目移动到另一块硬盘或另一台电脑时，只要项目结构完整，资料仍可解析。

分镜与短视频完整流程

1. 打开章节，选择“根据当前文档生成分镜”；
2. 设置镜头数量。插件会优先调用写吗现有 AI 分析章节，AI 不可用时使用本地规则回退；
3. 逐镜头检查标题、正文片段、提示词、负向提示词、镜头语言、人物和时长；
4. 先生成关键帧，确认人物和场景一致；
5. 对满意的关键帧生成镜头视频；
6. 填写或修改旁白文稿，导出 SRT 字幕；
7. 可用 Windows 已安装语音离线生成 WAV 旁白，也可导入其他 TTS 音频；
8. 导入背景音乐；
9. 设置统一画幅后，用 FFmpeg 拼接镜头、混合旁白和音乐，输出 MP4；
10. 最终成片会进入媒体索引和版本历史。

媒体版本与正文一致性

• 每次生成都保存正文路径、正文范围、正文哈希、提示词、模型、工作流、LoRA、Seed 和输出信息；
• 同一任务的候选结果按版本组显示，同组只标记一个采用版本；
• 正文保存后，可以自动检查关联媒体是否过期；
• 角色参考图、模型、LoRA、风格或固定 Seed 改变时，也会提示一致性风险；
• 可继承原参数重新生成，不必从头填写。

项目数据位置：

<项目>/.xiema/ai-media/
├─ visual-library.json
├─ media-index.json
├─ references/
└─ storyboards/

<项目>/assets/generated/<年月>/
├─ images/
├─ videos/
├─ covers/
├─ characters/
├─ scenes/
├─ storyboards/
└─ movies/

常见错误排查

隐私与联网说明

• 插件本身不读取你的在线 AI API Key；文本规划复用写吗统一 AI 服务、联网策略和请求日志；
• 启用“使用写吗现有 AI 助手规划”时，正文是否离开本机取决于你选择的是本地模型还是在线模型；
• ComfyUI 在本机运行时，图片生成请求通常只发往本机地址；
• 参考图、媒体索引和输出文件保存在项目目录；
• 第三方模型和工作流可能有各自许可证，商用前应确认授权。

13.2 AI 工作流应用平台：把节点工作流变成普通表单

AI 媒体工作台服务于文章、角色和分镜；AI 工作流应用平台则把任意 ComfyUI API 工作流包装成可安装的 .xmwf 应用，例如批量商品图、照片修复、证件照、统一风格封面或图片放大。

普通用户使用步骤

1. 启动 ComfyUI CMD 服务，不必打开节点网页；
2. 在写吗中安装并启用“AI 工作流应用平台”；
3. 安装本地 .xmwf，或从在线目录选择可信作者的应用；
4. 安装前查看作者、版本、价格、购买页、最低宿主版本、依赖、SHA-256 和签名状态；
5. 填写作者公开的提示词、图片、数值、选项和目录；未公开节点保持作者原值；
6. 点击依赖预检，确认节点、模型和输入文件齐全；
7. 批处理时先运行“首件”，确认效果后再继续全部；
8. 查看实时节点进度、失败原因和输出来源；任务中断后使用“继续未完成”；
9. 输出旁会保存 .xmwf-result.json，记录来源应用和参数。

第三方作者制作应用

1. 在 ComfyUI 中把工作流调试成功并导出 API 格式；
2. 导入写吗作者工具；
3. 选择允许普通用户修改的节点输入；
4. 为字段设置中文名称、说明、控件类型、默认值、普通/高级分组和联动条件；
5. 配置输出目录、依赖和锁定参数；
6. 导出公开包，或使用 AES-256-GCM 导出保护包；
7. 使用 RSA-PSS 作者签名，减少篡改和冒名更新；
8. 填写授权协议、作者页和购买页后发布。

工作流包安全边界

• 安装器检查 SHA-256、签名、ZIP 路径越界、重复路径、非法文件名和解压大小；
• 首次安装已签名应用后，会记住工作流 ID 对应的发布者公钥指纹；换密钥或从已签名降级为未签名会被拒绝；
• 保护包可以阻止普通解压复制，但工作流最终必须在用户电脑内解密并提交给本机 ComfyUI，因此不是绝对不可提取的 DRM；
• 只安装可信来源工作流。依赖预检通过不代表第三方自定义节点没有安全风险。

13.3 移动创作伴侣：手机访问电脑项目

电脑端开启

1. 安装并启用“移动创作伴侣”；
2. 从活动栏打开移动工作台，或右键项目目录选择在手机上浏览/编辑；
3. 确认开放根目录，第一次测试建议只读；
4. 按需开启编辑、创建、上传和删除权限；
5. 启动服务，用手机扫描当前二维码；
6. 长期使用可启用长期二维码；自动启动需要单独开启。

手机端可做什么

• 浏览安全白名单中的文本、Markdown 和 MDX；
• 编辑当前文档、新建 Markdown、MDX、目录和灵感文件；
• 上传图片或视频，并插入项目相对引用；
• 选择文字后调用电脑端 AI，候选稿可替换、插入、追加或复制；
• WebSocket 实时接收文件变化、项目树变化和在线设备数量；
• 发生版本冲突时返回 409 并保护冲突副本，不无提示覆盖。

安全边界

• 默认只在同一 Wi-Fi / 局域网使用，不依赖云端中转；
• 使用随机令牌、到期时间和固定时间比较；
• 路径被限制在用户主动开放的根目录内；
• 禁止访问 .xiema、.git、.vs、隐藏目录和目录联接；
• 不能删除开放根目录，也不执行任意 HTML、JavaScript 或 JSX；
• 当前同步是整篇文档版本同步与冲突保护，不是字符级 CRDT，不应当作公网多人实时协作系统。

13.4 PDF 工作台：阅读、页面整理与覆盖式内容修改

双击项目中的 PDF 后，会在标签中打开 PDF 工作台。先选择“阅读”“页面编辑”或“内容编辑”模式。

阅读模式

• 翻页、页码跳转、缩放、搜索和打印；
• 加密 PDF 会先要求密码并读取权限；
• 如果文件只允许阅读，页面和内容编辑会保持禁用。

页面编辑模式

• 左转、右转；
• 页面前移、后移、删除；
• 提取当前页为新 PDF；
• 插入另一个 PDF；
• 添加水印。

内容编辑模式

• 按页面与 PDF 坐标添加文字；
• 用白色遮盖原区域，再绘制新文字；
• 添加图片、透明背景签名和批注；
• 72 PDF 点约等于 1 英寸。

保存策略

1. 修改先进入临时工作副本；
2. 可撤销和重做；
3. 点击“保存”才替换原文件；
4. 重要合同、证明或扫描件优先“另存为”，确认后再覆盖。

13.5 AI 客服与人工坐席：功能、敏感词、安全和部署

这是独立可选插件。未启用时，宿主只读取插件清单，不加载客服 DLL、不监听 28681、不创建数据库，也不启动客服后台任务。启用插件后，仍可在设置页单独关闭 Web 服务。

三个入口与角色

首次启用与本机测试

1. 在“设置 → 组件与插件”启用“AI 客服与人工坐席”；
2. 进入插件设置，确认监听地址和端口。默认端口为 28681；
3. 首次安装会生成随机客服密码和管理员密码。立即保存，并把两种密码分开；
4. 需要 AI 接待时，开启写吗 JSON AI API，默认客服调用 http://127.0.0.1:28680/api/v1/chat；
5. 开启客服服务；
6. 分别打开访客、客服和管理员入口；
7. 访客先发送普通问题，确认 AI 回复；
8. 输入“人工客服”或点击人工客服快捷命令；
9. 客服在公共队列中接入访客，测试发送文字、图片、转接、退回公共区、结束人工和彻底结束会话；
10. 管理员检查完整消息、操作审计和统计。

访客端功能

• AI 自动回答常见问题；请求人工后停止自动回复；
• 顶部快捷命令，例如“关于公司”“联系我们”“最新产品”“人工客服”；
• 文字、图片和可选表情；
• 显示等待、已接入、客服断线和结束状态；
• 刷新或短暂离线后，根据浏览器本地身份恢复原会话与历史；
• 网站、小程序或 APP 可传入外部 sessionId、昵称和头像，用于关联会员、订单和售后；
• 外部会话 ID 只用于业务关联，不是认证凭证。

{
  "sessionId": "order-after-sale-10086",
  "nickname": "张先生",
  "avatar": "https://example.com/avatar/10086.png"
}

人工客服工作台功能

• 多个客服使用不同客服名称登录；当前版本可配置共用密码；
• 查看公共等待队列和访客进入人工前的 AI 对话、留言和外部会话信息；
• 原子接入：多客服同时抢同一会话时，只允许一个客服成功；
• 接入、转接给其他客服、退回公共区、结束人工服务、彻底结束会话；
• 每个客服可设置最大同时接待数量，默认上限为 5；
• 同一客服名称默认只允许一个有效工作台，新窗口登录会使旧窗口失效；
• 客服页面通过心跳维持在线，默认 10 秒；超过断线保护时间仍未恢复，会话可自动退回公共区；
• 发送文字、图片、表情和快捷回复；图片由会话权限保护。

老板 / 管理员中心

• 查看新增、等待、服务中和已结束会话；
• 按昵称、外部会话 ID、客服和状态查询；
• 查看文字、图片、AI/访客/客服消息数量；
• 查看接入、转接、释放、结束、登录和失败登录审计；
• 查看禁用词、IP 拒绝和限流记录；
• 查看平均等待时间、首次客服回复时间、客服接待量、发送量、结束量、转接量和每日趋势；
• 查看当前连接、连接峰值、累计请求、平均耗时、AI 请求、AI 失败、AI 排队和工作线程；
• 查看当前存储后端、协调后端及是否启用分布式协调。

快捷命令与转人工关键词

“快捷命令”显示为访客页面按钮；“人工客服关键词”用于识别用户主动转人工。默认关键词包括：

人工客服
转人工
找客服
真人客服
我要人工
联系工作人员

建议保留一个专用“人工客服”命令类型，不要只依赖自然语言完全匹配。业务快捷命令可以设置为“订单查询”“退款规则”“营业时间”“下载地址”等。

敏感词 / 禁用词到底怎样工作

• 默认列表为空。插件不会自带一套适用于所有行业的禁用词，需要运营者根据业务配置；
• 每行填写一项，也可以用分号或逗号分隔；
• 访客和客服发送的文字都会在服务端检查，修改浏览器脚本不能绕过；
• 当前版本采用不区分英文大小写的连续子串匹配；
• 多个词同时命中时会全部记录，较长词优先处理；
• 处理方式可以选择“拒绝发送”或“替换为星号”；
• 星号模式保存的是替换后的正文，命中事件仍进入管理员审计；
• 当前不是 AI 语义审核，也不是正则表达式，不会自动识别拆字、空格、同音字、拼音、繁简体或图片中的文字。需要把常见变体分别配置。

建议按业务建立的敏感词分类

推荐维护方式：先用“星号替换 + 审计”观察一段时间，按误报和漏报调整；确认高风险词后再改为“拒绝发送”。每次修改保留日期、负责人、原因和测试记录。

表情控制

• 总开关关闭后，网页隐藏表情按钮，服务端也会拒绝手工输入或粘贴的常见 Emoji；
• “可选表情”只决定面板显示哪些表情；总开关开启时，服务端仍允许其他 Emoji；
• 关闭表情适合严肃政务、企业内部支持或需要纯文本归档的场景。

安全设置逐项说明

默认限流和容量起点

以下是当前配置默认值或默认上限起点，不代表服务器一定能承受对应在线人数，正式上线必须压测：

AI 接待的可靠性

• AI 请求进入有界后台队列，不占住访客 HTTP 请求；
• 默认 AI 并发任务数为 4、等待队列容量为 500，可按机器和模型速度调整；
• 同一会话固定进入同一分区队列，并按服务器消息序号绑定回复，减少连续提问乱序；
• 队列满时消息仍保存，并提示转人工或稍后重试；
• 每条消息有服务器递增序号、服务器时间和客户端消息 ID，网络重试时自动去重。

数据库、Redis、备份和保留期限

Redis 只负责登录状态、客服在线、分布式限流、会话锁和事件广播，不保存正式聊天记录。数据目录默认为：

%LocalAppData%\写吗\PluginData\WritingSystem.Plugin.CustomerService

• 包含 SQLite 数据库、附件和运行数据；
• 备份前建议停止客服服务，确保数据库和附件一致；
• 更新插件 DLL 时不要删除数据目录；
• 记录保留天数可配置，自动清理只处理已经结束的会话；
• 卸载插件但想保留历史时，只删除插件目录，不删除该数据目录。

公网部署安全清单

1. 不要让用户直接访问明文 http://公网IP:28681；
2. 使用域名 + HTTPS + Nginx/Caddy/云负载均衡；
3. 同机代理时让插件监听 127.0.0.1:28681；
4. 开启“信任指定反向代理”和“非本机必须经过 HTTPS 代理”；
5. 后台设置独立 IP 白名单；
6. 更换高强度客服和管理员密码；
7. 开启限流、单客服单窗口、黑名单和审计；
8. 限制防火墙/云安全组，只允许反向代理访问 28681；
9. 使用测试数据验证禁用词、图片、断线、转接、备份和恢复；
10. 按真实图片流量、AI 延迟和数据库配置进行压力测试。

长文写作

打开项目
→ 打开今天的章节
→ 必要时保存“修改前”历史
→ 写作并不断 Ctrl+S
→ 使用资料库和写作助手核对设定
→ 开启审查模式检查变化
→ 完成阶段后保存带标题的历史节点

网页开发

打开 HTML/PHP 入口
→ 保存“页面调整前”历史
→ 开启 Web 预览
→ 设置服务器地址或路径映射
→ 可视设计或编辑源码
→ 应用并刷新
→ 检查 CSS 来源和最终页面
→ F5 运行需要的脚本
→ 保存“页面完成”历史或项目快照

团队 Git

获取云端更新
→ 修改自己的文件
→ 保存本地历史节点
→ 检查 Git 差异
→ 保存 Git 版本
→ 再次获取更新
→ 解决冲突
→ 上传到云端

保存了文件，为什么历史列表没有新增？

普通保存不会建立历史。填写节点标题后点击“保存历史”，或按 Ctrl+Shift+S。

进入历史实况后为什么不能编辑？

历史实况是只读浏览。需要从旧版本继续写时，在实况中点击“保存历史”，从该旧版本建立新的节点并继续编辑。

鼠标悬停为什么没有旧 / 新对比？

确认已经有历史节点，并在“查看”菜单开启审查模式；选择正确的历史基准。当前正文与基准完全一致时不会显示差异。

资料库已经绑定，为什么 AI 没有使用？

资料库不是全局强制读取。会话需要勾选“检索项目资料库”；快捷页要选择资料库来源；预制命令也需要单独启用资料检索。

罗列和快捷有什么区别？

罗列保留层级和原文位置，点击结果可定位；快捷生成独立可编辑条目，双击可插入正文。

F5 没有反应或提示找不到环境？

打开“运行 → 运行环境设置”，重新检测或手动选择解释器。Python 项目建议使用 .venv，TypeScript 需要安装 tsx 或 ts-node。

PHP 页面只显示源码或无法运行？

PHP 必须通过本地服务器访问。设置 phpStudy/Apache/Nginx 的网址和本地目录映射，不要把 PHP 当作普通静态 HTML 打开。

AI 客服插件为什么没有出现在“组件与插件”？

确认插件已经安装到 %LOCALAPPDATA%\写吗\Plugins\WritingSystem.Plugin.CustomerService，然后重启写吗并点击“重新扫描”。源码开发版应使用“构建含AI客服插件开发版.cmd”，普通日常构建不会自动编译该可选插件。

客服密码为什么不是 agent123？

新版首次安装会自动生成随机客服密码和管理员密码。请到“设置 → AI 客服与人工坐席”查看或重新设置，修改后退出旧工作台并重新登录。

插件安装后没有入口？

重新扫描插件，确认已经启用、版本兼容、目录层级正确；收费插件还需许可证包含对应权限。

Git 上传前出现冲突怎么办？

先打开冲突文件手动合并并删除冲突标记，再加入本次版本、保存版本和上传。不要在未理解提示时放弃修改。

Ollama 安装了，为什么没有模型？

Ollama 只是运行环境。还需通过模型库、手动 GGUF 或 ollama pull 安装模型，并在写吗中选择它。