操作文档

01安装与启动#

DCX 是便携应用：从 官网下载页 或 GitHub Releases 获取压缩包，解压、运行，没有安装器，也不需要写入系统目录。设置与索引全部保存在 %LOCALAPPDATA%\dcx\。

启动方式

分发包内容

首次运行

首次运行可能被 SmartScreen 提示，因为构建与发布包都没有签名。选择「更多信息 → 仍要运行」即可。请只从官网下载页或本仓库的 Releases 下载，并用 SHA256SUMS.txt 校验：

Get-FileHash .\DCX-v0.1.2-win64.zip -Algorithm SHA256

系统要求是 Windows 11 x64。32 位进程不会加载 64 位引擎，但任务栏本身是 64 位 Explorer，不受影响。

02托盘与设置中心#

宿主启动后会在通知区放一个图标。左键单击打开设置窗口，右键才弹菜单（设置 / 桌面整理 / 退出并恢复任务栏 / 退出）。设置窗口已经打开时，再次左键只会把它提到前台，不会开第二个。

设置中心结构

左侧导航固定五项，右侧是页标题与卡片。所有改动改完即生效：防抖 220 ms 后原子写入，引擎约 1 秒内热重载，没有「保存」按钮。

状态行

窗口底部如实显示三种状态：

• 已写入 · 引擎约 1 秒内重载 —— 引擎已注入，改动会生效。
• 已写入配置 · 引擎未注入 —— 文件写成功，但任务栏还没被接管；点「重新应用」补注入。
• 失败原因 —— 写入失败或注入失败，最常见的是宿主目录里没有 wh_injector.exe。

关闭窗口 ≠ 退出程序

点右上角 × 只关闭设置窗口：宿主、托盘、看门狗与已注入的引擎都还在，任务栏保持当前外观。要真正退出并恢复任务栏，用托盘菜单的「退出并恢复任务栏」，或设置 → 关于 → 退出。

03任务栏主题#

dcx_engine.dll 注入 explorer.exe，把主题规则写进任务栏 XAML。设置中心写 settings.toml，引擎每秒轮询修改时间并重建规则——不需要重启 Explorer。

可调项

为什么改了没反应

1. 看设置窗口底部状态行：如果是「引擎未注入」，点「重新应用」。它会先重写 settings.toml（内容没变也会刷新修改时间），再跑一次注入扫描。
2. 确认 wh_injector.exe 与 dcx_engine.dll 都在 dcx-host.exe 同目录；开发环境可用 DCX_INJECTOR / DCX_ENGINE_DLL 指到别处。
3. Explorer 重启后主题会丢，这是正常的——宿主看门狗会在约 5 秒内重新注入。

引擎只处理主任务栏。多任务栏与第三方任务栏壳没有适配；Windows 大版本更新后，XAML 视觉树可能变化，需要重新核对元素路径。

04桌面收纳盒#

收纳是物理移动文件，不是隐藏图标。桌面仍由 Explorer 原生管理；文件被收进盒子时，它从桌面移到收纳库（默认 文档\dcx收纳），桌面图标随之消失，文件本身不删除。

打开与收起

• 全局热键 Alt + D 唤出 / 收起。热键可在「设置 → 桌面整理」修改或关闭。
• 任务栏上的收纳盒按钮是独立窗口，点一下打开弹层。
• 底部的「收纳」按钮：单击复制收纳库路径，双击打开收纳库文件夹。

收纳与放回

1. 把桌面文件拖进盒子窗口，或拖到信息岛胶囊上，文件会被移动到收纳库。
2. 在盒子里把文件拖回桌面，即恢复到桌面根目录。
3. 整个过程不修改文件属性，也不绘制桌面层；没有「幽灵图标」需要额外清理。

分类

分类是收纳库内的虚拟元数据，不改变文件内容：

• 扩展名规则自动归类为文档、图片、压缩包、媒体、应用、其他。
• 手动拖拽或右键菜单可以覆盖自动分类，结果写入 organizer.toml 的 overrides。
• 支持列表 / 网格视图、排序、搜索、文件夹展开、拖放、右键菜单、新建文件夹、重命名与回收站删除。

更换收纳库目录

「设置 → 桌面整理 → 收纳库目录 → 更改…」。确认后会迁移已有文件并重建根目录，手动分类记录会跟随迁移。收纳库是普通目录，可以放到其他磁盘。

05文件检索#

独立进程 dcx-search.exe，默认关闭：不随平台自启、不常驻、不预建索引。按 Alt + S 时宿主才拉起它，索引在后台建立，结果边建边出；关闭窗口进程即退出。

三种状态

界面

• 路径：桌面、此电脑、各固定卷；「自定义路径」需要写进 search.toml 的 scope.custom_roots，重启后出现在下拉里。
• 模式：文件名（内存索引）或内容（在候选集上流式扫描）。切换不会重建索引。
• 分类：文件、图片、压缩包、应用程序、视频、音频、其他，与模式正交。
• 结果：名称、路径、大小、修改时间；名称或路径被截断时，悬停显示完整文本。

查询语法

内容检索

候选集由名称索引先按作用域、分类、扩展名与大小筛出，再逐个文件流式扫描。默认单文件上限 2 MiB、最多 2000 条结果、8 秒时间预算；超限结果会标记为部分结果，可以按 Esc 立即取消。二进制与大文件默认跳过，UTF-8 / UTF-16 BOM / GB18030 会按配置尝试。

快捷键

06桌面信息岛#

独立进程 dcx-island.exe，默认关闭。在「设置 → 桌面信息岛」打开主开关后，屏幕顶部居中显示常驻胶囊；它不占任务栏槽位，也不依赖引擎的槽位预留协议。

胶囊与面板是同一张卡

• 紧凑态显示时间 / 星期 / 日期、性能指标与未读角标；播放媒体且没有提醒、没有活跃卡片时显示曲名。
• 点击胶囊或按 Alt + I 展开。胶囊那一行就是面板的标题栏，展开后点它不会收起。
• 收起用右上角 ✕ 或 Esc；窗口尺寸随同一段缓动一起变化。

六个页签

提醒：重复与间隔是两个维度

重复决定哪几天存在（不重复 / 每天 / 工作日 / 每周），间隔决定一天里提醒几次（单次 / 15 分 / 30 分 / 1 时 / 2 时）。时间框接受 09:00 或 09:00-18:00；写了区间就表示起止。

到点时铃铛摆动、标题轻摆、accent 底色脉冲，配一声双句提示音，持续 12 秒，不自动弹出面板。全屏时可以暂缓，退出全屏后按过期规则补发。

通知渠道

出站只有两条：企业微信群机器人 webhook 与 SMTP。QQ / 微信个人号没有官方出站接口，因此不支持发送。

剪贴板、媒体与收纳联动

• 剪贴板保存图文历史，可搜索、收藏、加备注、回写剪贴板，或直接「存入收纳盒」。
• 文件直接拖到胶囊上即收纳，搬运在工作线程进行，不卡窗口。
• 媒体读取系统媒体会话（GSMTC）：封面、标题、艺术家与上一首 / 播放暂停 / 下一首，进度本地插值；没有会话时整行消失。

凭据与隐私

授权码、SMTP 密码、Webhook Key 只存 Windows 凭据管理器（DCX/island/<key>），不写 TOML、不写日志。剪贴板与通知内容全部本地保存。唯一的例外是推送 API 令牌：它需要被脚本一行读到，因此放在 %LOCALAPPDATA%\dcx\island_api_token.txt，只授予「往岛上推卡片」这一项能力。

07快捷键#

三个热键都由常驻的宿主监听，可以在设置中心修改或关闭。文件检索不依赖检索进程是否已启动；信息岛额外要求 island.toml 与 apps.toml 都为开启，避免一个已关闭的应用被键盘复活。

热键被其他程序占用时，注册会失败并写 box_hotkey_error.txt / search_hotkey_error.txt / island_hotkey_error.txt，设置页对应位置会提示改键。前台是管理员权限窗口或全屏独占应用时，热键可能不到达；宿主未运行时热键无效。

08配置文件#

运行时文件全部在 %LOCALAPPDATA%\dcx\。仓库里没有这些文件，只有源码与生成脚本。

示例：settings.toml

# %LOCALAPPDATA%\dcx\settings.toml
taskbar_shape = "Capsule"      # Capsule | Card
icon_scale = 100             # 50..125（百分比）
icon_spacing = { between = 0 } # -6..6 px
hover_effect = "Dock"        # Background | Dock
taskbar_height = 40          # 30..44 DIP
ui_theme = "Light"          # 只影响设置窗口本身

写入协议

五个 TOML 与两个 JSON 都是多进程读写，因此写入遵循同一套规则（实现见 dcx-win32/src/config_file.rs）：

• 跨进程互斥：按文件全路径派生的命名互斥体保护整个「读—改—写」，宿主、收纳盒、检索、信息岛不会互相覆盖。
• 原子替换：先写带 PID 与序号的临时文件并落盘，再用 ReplaceFileW / MoveFileExW 换入；没有「rename 失败就直接覆盖」的回退分支。
• 损坏即只读：文件存在但解析失败时，进程只使用内存默认值，并拒绝把默认值写回磁盘；修好或删除该文件后自动恢复可写。

09故障排查#

日志

升级引擎

dcx_engine.dll 被 Explorer 映射时不能直接覆盖。请用发布包内的 update-engine.bat：它先移动旧文件再复制新文件。替换后可以确认产物确实带槽位协议：

grep -a "box_slot.txt" "D:/dcx-dist/dcx_engine.dll"

然后重算 SHA256SUMS.txt。注意该文件要用 LF 行尾，写成 CRLF 会让 sha256sum -c 把 \r 当成文件名的一部分。

10卸载与恢复#

1. 恢复任务栏：托盘右键 →「退出并恢复任务栏」，或在设置 → 关于里点两次确认。它会暂停看门狗、结束 Explorer、等 shell 自启后退出宿主。
2. 关闭开机自启：如果开过「开机自启」，先在设置里关掉，或删除注册表 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 下的 DCX 值。
3. 删除程序目录：直接删掉解压出来的 DCX 文件夹。没有安装器，也没有卸载项。
4. 清理本地数据（可选）：删除 %LOCALAPPDATA%\dcx\ 会同时删除设置、任务、剪贴板历史与检索索引。
5. 处理收纳库：文档\dcx收纳 是你自己的文件，删不删由你决定；删除不可恢复。