# 使用指南

## 安装与更新

从 [GitHub Releases](https://github.com/klarkxy/dsh-editor/releases) 下载。Windows 可运行便携版 EXE 或安装器；macOS 将 dmg / zip 中的应用拖入「应用程序」。便携版首次启动需要准备本地环境，可能稍慢。

应用未签名，Windows 可能提示未知发布者，macOS 首次可在访达中右键选择「打开」。只运行可信来源的文件。

更新前保存作品，在「设置 → 关于」检查和下载更新：

| 平台 | 下载完成后 |
| --- | --- |
| Windows 安装版 | 点「退出并安装」 |
| Windows 便携版 | 点「重启并替换」 |
| macOS | 打开下载文件夹，退出应用，用新版替换旧版 |

下载会核对发布页的 SHA-256；失败时可前往发布页手动下载。保留旧版安装包，以便关闭新版后回滚。

0.4.x 系列更新包含 DSH 运行时升级。更新前请备份作品文件夹和应用数据目录：Windows 为 `%USERPROFILE%\.dsh-editor`，macOS 为 `~/.dsh-editor`；若设置了 `DSH_HOME`，备份该目录。回退旧版时，先退出应用，再恢复更新前的应用数据备份；仅保留旧安装包不能还原已迁移的配置与会话。

## 打开作品

首页「新建」按作品名在「文档/dsh-editor」下建立文件夹；「打开作品」直接打开已有文件夹。同名目录不会被覆盖。

新作品从空白开始。在稿纸上点「写第一篇」，或在文件树中右键新建文件、文件夹。也可以先与搭档讨论人物、设定和大纲，采用提案后再写正文。目录按需创建，已有 Markdown / TXT 可直接使用。

顶部作品名菜单可切换最近作品、打开或新建作品、导出与返回首页。从最近列表移除入口不会删除作品。

## 写作与保存

中间是稿纸，左侧是文件树，右侧是写作搭档。顶栏可收起两侧栏或进入专注模式；宽屏下拖动分隔线调整栏宽。右键文件选「钉在旁边」可打开一份只读对照。

正文自动保存，`Ctrl+S` 可立即保存。切章或离开作品前会先保存；遇到失败、冲突或尚未保存的新输入时，先处理当前文档再继续。

文件被其他程序改过时，可重新载入磁盘版本，或先另存冲突副本。临时草稿可帮助恢复意外退出前的内容，但不能代替备份。

正文右键和标题栏「⋯」提供编辑、查找、补全与改写操作。「设置 → 写作」调整字体、字号、行距、纸宽、打字机滚动和段落聚焦。

稿纸菜单中的「选中当前段落」复用聚焦段落的空行分隔规则，仅改变可见稿纸中的选区，不改变文件内容，也不会选中隐藏的文件头。选中后可继续使用现有的复制或改写操作。它不是 Markdown 语法树选块，也不会给段落生成持久化 ID。

## 与搭档协作

在「设置 → 模型」配置接口和密钥，可分别选择对话、补全、改写模型。补全与改写留空时跟随当前对话；默认对话模型只影响新对话。

- **补全**：光标处选择「光标处补全」或按 `Ctrl+Enter` 手动补全（有改写预览时接受改写），`Tab` 接受、`Esc` 放弃；可停止生成或比较候选。「停顿后提示」在写作设置中开启，仅用于正文。
- **改写**：选中文字，选择「选段改写」并填写要求；预览后应用，可撤销。
- **文件提案**：正文与大纲的修改或新建先出可预览提案，点「应用」才写入。文件变化后，须基于最新内容重新提案。
- **规划**：大纲与章纲走提案、经作者采用后生效；人物卡与世界书是普通 Markdown，由搭档在协作中自动维护、写入即生效，历史可在记忆面板查看并撤销。没有强制的章节收尾步骤。

「新对话」可选择通用写作、小说创作、文章与自媒体、技术文档；模式创建后固定，模型可随时换。`Enter` 发送，`Shift+Enter` 换行。

对话菜单提供重命名、归档和恢复。归档可恢复，删除不可恢复；只剩一段对话时，须先新建另一段才能归档。

「设置 → 助手」中的作者约定适用于所有作品。本书独有的规则放在作品的 `AGENTS.md`、人物卡或世界书，由搭档在协作中自动维护，历史可在记忆面板查看并撤销；辅助规则文件在作者文件树中隐藏，可用外部编辑器维护。

## Fusion 协作

Fusion 协作随桌面版预装，默认关闭。在「设置 → 插件」开启「Fusion 协作」后，现有写作对话即可参与，不需要为每段对话单独开关。

开启后，写作搭档可把限定任务委派给一位持久的执笔搭档：主搭档负责讨论、规划与审阅，执笔搭档产出候选文本。审阅通过不等于写入——正文与大纲的候选仍需你在预览中点「采用」，应用核对来源版本和未保存草稿后才写入。文件内容变化后，旧候选保留但不能覆盖新正文，须让搭档基于当前内容重新修订。修订与后续任务沿用同一位执笔搭档；停止任务或关闭卡片不会撤销已采用的正文。

协作模型在首次配对时绑定，之后的模型设置改动只影响新配对。重启应用不会自动重发未决任务，需核对任务卡与执行记录后明确恢复。实现边界见 [Fusion 说明](https://github.com/klarkxy/dsh-plugins/tree/main/plugins/dsh-fusion/docs/README.zh-CN.md)。

## 管理作品

| 操作 | 入口与注意事项 |
| --- | --- |
| 查找替换 | 当前稿纸用 `Ctrl+F` / `Ctrl+H`；跨文件用 `Ctrl+Shift+F`。「全部替换」先预览再确认，已变化的文件会跳过，可重新搜索处理。 |
| 移动与重命名 | 文件树右键菜单；也可拖到目标目录。移动、重命名遇到同名会取消，复制会自动改名。 |
| 拆章与合章 | 正文 Markdown 的右键菜单。拆章锚点须唯一；合章会移出被并入的章节。两者先预览提案，再确认应用。 |
| 保存与回滚版本 | 文件栏「保存版本」「历史版本」。回滚前自动保存当前状态；快照只覆盖 Markdown / TXT，不包括图片和隐藏文件。 |
| 导出 | 作品菜单「导出稿件」，预检顺序、空文档和字数后选择 Markdown / TXT / DOCX / EPUB。 |
| 删除 | 文件树右键「删除」；永久删除，除非此前已保存到历史版本，否则无法恢复。没有文档归档入口。 |

备份或迁移作品时复制整个文件夹，包括隐藏的 `.dsh-editor/`。不要把正文只放在这个元数据目录中。

## 辅助功能与设置

「设置 → 插件」可开关辅助功能、管理社区插件。需求澄清、当前标题、回顾与自我改进只在此开关；记忆与网络搜索另有设置页。社区插件安装和卸载后需要重启；市场操作见[插件管理](../packages/dsh-editor-plugins/README.md)。

| 功能 | 入口与说明 |
| --- | --- |
| 文稿校对 | 侧栏「文稿校对」或 `Ctrl+Shift+L`；[检查范围与名单](../packages/dsh-editor-proofread-panel/README.md) |
| 文档概览 | `Ctrl+Shift+O`；[字数与写作曲线](../packages/dsh-editor-overview-panel/README.md) |
| 人物与世界书 | 文件树直接编辑；[可选卡片面板](../packages/dsh-editor-cards/README.md) |
| 写作记忆 | 按需开启；查看规则、人物卡与世界书的维护历史并撤销写入，[面板说明](../packages/dsh-editor-memory-panel/README.md) |
| 知乎资料 | 设置中配置；[使用与上传须知](https://github.com/klarkxy/dsh-plugins/blob/main/plugins/dsh-zhihu/docs/README.zh-CN.md) |
| 网络搜索 | 设置中选择后端；[配置与费用](https://github.com/klarkxy/dsh-plugins/tree/main/plugins/dsh-web-search-manager/docs/README.zh-CN.md) |

「通用设置」调整中英文、外观及搭档忙碌时的发送方式。「用量」显示本机模型调用记录，不是费用账单。

## 快捷键

以下按 Windows 标示；macOS 以命令面板显示为准。编辑命令需先聚焦稿纸。

| 按键 | 操作 |
| --- | --- |
| `Ctrl+S` | 保存 |
| `Ctrl+K` | 命令面板，查找其余命令与快捷键 |
| `Ctrl+,` | 设置 |
| `Ctrl+B` / `Ctrl+J` | 文件栏 / 搭档栏 |
| `Ctrl+L` | 聚焦搭档输入框 |
| `Ctrl+\` | 专注模式 |
| `Ctrl+F` / `Ctrl+H` | 稿内查找 / 替换 |
| `Ctrl+Shift+F` | 跨文件搜索 |
| `Ctrl+Enter` | 手动补全；有选段修改提案时接受提案 |

## 按词审稿与按需查资料

选段改写的预览会分别标出删除和新增的词语，中文按词比较，并保留原来的空白、标点和换行。超长或差异过多的文本会降级为较粗的对照，不影响稿纸输入。仍然整项「应用修改」或「放弃」，不支持逐词采纳；正文变化后，旧提案照常失效。差异结果仅用于展示，不参与拼接写入。

在稿纸选中一个名称，通过右键或顶栏更多菜单选择「查相关资料」，按需查询当前文件列表中的 `人物卡/` 与 `世界书/`。文件名和文件正文都可命中，同名但不同路径的资料分别显示。结果可「打开资料」或「钉在旁边」；打开时沿用既有的保存与版本检查，钉住时沿用只读资料栏。查询不需要开启人物卡面板，不自动建立索引、创建卡片、修改资料或注入模型上下文。搜索失败、跳过或截断会明确提示。

## 遇到问题

模型无法连接时，检查接口地址、密钥、额度和网络。提案失效时，让搭档根据最新文件重新提出；保存冲突先保留副本再重新载入。启动异常时保留诊断信息并联系开发者。