安装、启动与目录

1. 解压完整发行包

把完整目录放到你有写入权限、准备长期保留的位置，例如 D:\Tools\Diatom。先解压再运行，不要在压缩软件中直接打开 exe。

运行目录通常包含：

text

<Diatom>\
├─ diatom.exe
├─ conf.toml
├─ AutoHotkey.exe
├─ AutoHotkey.dll             按发行包配置保留
├─ AutoHotkey.ahk             如随包提供则保留
├─ conf\base\                配套基础脚本
├─ conf\dll\                 基础脚本依赖的原生组件
├─ conf\default\             输入配置、命名、手势数据
├─ lib\                      配套脚本库
└─ src\                      可编辑命令

不同发行包可能还有运行时和资源 DLL。按原目录保留它们。普通用户不需要 Cargo、Visual Studio 或 Rust 源码。

2. 启动并确认

双击 diatom.exe。程序主要在后台工作，没有弹出主界面并不表示启动失败。按十分钟上手使用入门命令确认。

如果窗口一闪而过，先检查是否解压完整、conf.toml 是否存在、CPU 是否满足发行说明。出现错误报告时保留完整文字，按排查指南处理。

3. 退出与重载

安装了入门命令后，Ctrl+Alt+F12 请求退出 Diatom。遇到命令不可用时，可按 Ctrl+Shift+Esc 打开任务管理器，在“详细信息”中结束 diatom.exe。

编辑命令或配置后，再次运行 diatom.exe 会替换旧实例并重新加载。正在执行的工作应先结束；独立脚本进程可能继续存在。

4. 认识几个目录

位置	你通常会做什么
`src\user\`	放自己的命令，目录可自行创建
`conf.toml`	修改全局设置
`conf\default\naming.toml`	为软件分组
`conf\default\mouse.toml`	控制哪些鼠标键在哪些软件中作为触发键
`conf\default\data\`、`gs.ini`、`view\`	手势样本与展示数据，整体备份
`disk` 或配置的 `disk` 目录	日志与运行临时数据

src_dir 如果指向自定义位置，应在那个命令目录编辑，不能只凭文件夹名判断。

5. 更新、备份与卸载

更新前退出程序并备份整个运行目录。至少保留 conf.toml、pc_*.toml、命令库、修改过的基础库，以及整个 conf\default。先在新目录验证新版，再合并个人配置；不要直接覆盖旧的 src。

停止使用时退出程序，移除自己建立的登录启动项，再删除运行目录。另行安装的驱动、外部运行时和独立脚本有各自的生命周期。

6. 随 Windows 登录启动

确认普通启动正常后，按 Win+R 输入 shell:startup，把指向 diatom.exe 的快捷方式放进去即可。若需要仅开机时运行的命令，在快捷方式“目标”路径之后添加 boot：

text

"D:\Tools\Diatom\diatom.exe" boot

boot 会额外启用 [boot] 项；[dog] 仍然执行。它是约定的启动参数，不会检测电脑是否刚开机。只保留一处登录启动项。