使用手册 / 第 05 章
设置与维护
在应用侧栏打开「设置」,用「搜索设置」按名称找面板。工作区若有「模块设置」,也可从那里直接跳转。
偏好设置
外观、启动和终端
- 外观:「明暗」选跟随系统、浅色或深色;「强调色」可选预设,也可输入六位
#RRGGBB。 - 常规:用「启动时打开」指定工作区,或选「上次停留」(不记住设置页本身)。建议保留默认开启的「危险操作前确认」;关闭会使部分操作(如缓存清理)直接执行,但这个开关并不控制所有确认。
- 终端:设字号、回看行数、光标闪烁和配色模板,本地和服务器终端共用这些偏好。Windows 当前不支持应用内本机 PTY,但可以连接远程 SSH;不要将两个能力混为一谈。
按模块调整
常见模块偏好改动后逐项保存;「恢复默认」重置当前模块的偏好,不是恢复文件或备份。AI 服务商配置和清理规则有各自的保存按钮。
- Hosts:写入系统 Hosts 前可启用自动备份,并设置保留份数、写后刷新 DNS、公网查询线路、记录类型和超时。关闭「记住管理员密码」不会删除已存密码,请在「已记住的密码」另点「清除」。系统写入可能需要 macOS 管理员授权或 Windows UAC。
- 开发环境、Node / npm、配套组件:可设默认工具、是否显示外部安装和安装位置;隐藏外部安装不会卸载。Node / npm 的「自定义源」每行填「名称 地址」,对照「识别结果」,再按需调安装、更新、卸载或检查超时。配套组件可选下载源或 GitHub 镜像前缀;适用范围不同,jsDelivr 仅用于 OCR 数据,MongoDB 仍用官方源,镜像不改变固定版本或校验。
- 环境变量、代码仓库:前者设默认范围、敏感值遮盖及关键词和按路径拆分的变量;后者设默认标签页、每次加载提交数及贡献统计范围。遮盖只是显示保护,不会更改变量本身。
- 数据库、服务器:数据库可调新连接和查询超时、预览行数、查询返回上限及 SQL 模板默认 LIMIT;查询超时会断开连接。服务器可调 SSH 超时、心跳、空闲断开、信息刷新和终端字体,也可限 AI 单条命令超时或 Agent 步数。
- 凭据管理:调整「显示后自动隐藏」和「复制后清空剪贴板」。
0表示关闭对应计时;如果剪贴板已被其他内容替换,应用不会按原计时清空它。 - 进程、定时任务:进程可调采样、曲线保留、默认时间范围和列表自动刷新。定时任务可调默认分组、系统任务显示、刷新间隔和单任务日志上限;隐藏不等于停用任务。
- 文本工具、屏幕截图、二维码工具:可调整文本工具起始页、JSON 缩进和示例;设置截图延时、隐藏窗口、自动入库、OCR、标注、撤销和导出;设置二维码起始类型、下载尺寸、批量上限、历史和摄像头。
AI 模型
- 打开「AI 模型 → 服务商配置」,选择 Ollama(本地)、DeepSeek、通义千问、Kimi、智谱 GLM、OpenAI、OpenRouter 或「自定义」。填写兼容 OpenAI 格式的「接口地址」(通常以
/v1结尾)及所需「API Key」。远程接口优先使用可信的 HTTPS 地址。 - 设置「文字模型」,要处理图片则设「看图模型」。「读取模型列表」可查接口提供的模型,不保证每个模型都支持图片;「测试连接」检查当前草稿。这两步都不保存配置。
- 点「保存配置」,再另选「默认服务商」;保存并不会自动切换。回到AI 助手用一条不含敏感信息的问题确认能收到结果。微信模式要求明确设置文字和看图模型。
API Key 存在系统凭据库中。「发送前脱敏」是各服务商共用的设置,但不能替代人工检查,也不会遮挡图像里的数据。请求仍会送到所配置的接口,请先核对文字、日志和图片。
数据目录、迁移与备份
「设置 → 数据目录」可打开当前业务数据、截图图库和配置目录。业务数据默认在用户主目录的 ~/.dockyard,实际位置以应用显示为准。
- 准备空间足够的空目录,不要选链接目录,也不要选与源目录相同、互相包含的路径。先保存工作并结束终端和数据库会话。
- 点「迁移到…」选目标,确认「重启后离线迁移」,选择「重启并迁移」或「稍后重启」。稍后重启前仍使用原目录;下次启动会复制并逐文件校验,通过后才切换。
- 若失败,应用继续用原目录;目标可能残留部分文件,不会自动清除或复用。检查残留后另选空目录重试。若成功,先确认连接记录、截图和其他文件可用,再选「保留旧目录」或「删除旧目录」。前者不删文件,后者有独立确认且不可撤销。
为什么迁移不是完整备份
- 截图图库随业务数据迁移,独立配置目录、系统凭据库以及保存在其他位置的导出文件不随迁。本机用量等 WebView 存储也不随业务目录自动迁移。
- macOS 使用钥匙串,Windows 使用凭据管理器。数据库和 SSH 连接文件还依赖系统凭据库中的加密密钥;换电脑或系统账户时,仅复制业务目录无法保证解密或恢复连接。可在「关于 → 运行环境」确认当前凭据后端。
- 当前没有整应用备份恢复入口。重要文件请单独备份;不要假定截图、日志、历史或导出文件经过应用加密。Hosts 工作区可在「备份」中单独创建或导入 JSON;导入会替换本地分组,另点保存才写入系统 Hosts。导入前先保留现有分组。
缓存、空间清理与运行日志
- 缓存:先点「重新统计」查看实际占用,展开类别检查文件和保护状态,再点「清理缓存」。它只删除符合条件的缓存和临时文件,保留受保护项,不清除连接、分组、设置和密码;完成后核对释放空间及失败项目。重新生成缓存时,页面或 OCR 首次运行可能变慢。
- 空间清理:在设置的「空间清理」调整自动发现、大小阈值或增改扫描规则,保存后对下次扫描生效。删除规则不删磁盘文件;实际清理在空间清理工作区执行,确认前核对命中路径和文件用途。
- 运行日志:可调展示条数、补读间隔和默认自动滚动。「存储与保留 → 保留时长」可选 7、14、30 或 90 天,恢复默认会回到 7 天。运行日志会按期限清理,部分旧模块记录只显示期限内的条目;不清除连接、分组和备份。排查前先记下操作时间和模块,再到「系统 → 运行日志」查错误。
检查更新
- 打开「设置 → 检查更新」。默认启用「启动时检查」,它只静默检查,不会自动安装;也可手动点「检查更新」。
- 发现新版本后,可查看更新内容,选「立即更新」「稍后」或「跳过这个版本」。跳过只抑制该版的静默提示,手动仍能查到。已发布版本的说明可在「更新日志」点开阅读。
- 先保存工作,再开始更新。可用「查看更新进度」跟踪同一次下载和安装任务。下载 100% 不等于装好,还需通过签名校验并完成安装;成功后应用会自动重启。失败时可按提示重试。
发布页提供 macOS 和 Windows 安装包,架构以下载页为准。源码中的 Linux 分支不代表当前有 Linux 安装包或功能对等。
问题反馈与诊断
- 在「关于」查看版本、平台、路径和凭据后端;需要时点「复制版本号」或「复制诊断信息」,也可打开配置目录或数据目录。
- 到「问题反馈」,选「问题」或「建议」及优先级,填写操作步骤、期望与实际结果、版本和错误提示。内容必填,最多 2,000 字,联系方式选填;最多加 8 个附件,每个不超过界面标示的 20 MB。
- 「附上诊断信息」默认开启,请先读预览。诊断含系统、设置和本机路径,不读取密码或连接内容;正文、联系方式和附件不会自动脱敏。提交前遮掉用户名、主机名、令牌和截图里的私人信息,不想发送诊断可关掉开关。
- 「提交反馈」会上传附件并在 CNB 发布仓库创建议题,不是私密工单。「复制反馈」只复制文本和附件名,不上传文件。「查看已提交」显示仓库议题,不仅是本机提交,可按「开启中/已关闭」查看并在浏览器打开。