<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>参考 on Capslock</title><link>https://caps.pgsty.com/zh/docs/reference/</link><description>Recent content in 参考 on Capslock</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 06 Nov 2026 19:02:03 +0800</lastBuildDate><atom:link href="https://caps.pgsty.com/zh/docs/reference/index.xml" rel="self" type="application/rss+xml"/><item><title>配置文件</title><link>https://caps.pgsty.com/zh/docs/reference/configuration/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://caps.pgsty.com/zh/docs/reference/configuration/</guid><description>&lt;p&gt;你不必手工编辑这些文件，这里的一切都可以在应用中修改。它们是普通的 YAML，方便你阅读、纳入版本管理，或通过「导出」和「导入」迁移到另一台 Mac。&lt;/p&gt;</description></item><item><title>诊断与恢复</title><link>https://caps.pgsty.com/zh/docs/reference/diagnostics/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://caps.pgsty.com/zh/docs/reference/diagnostics/</guid><description>&lt;p&gt;「诊断」页运行一组检查，并为每一项失败的检查给出编号的修复步骤，大多数修复就是同一行上的一个按钮。「刷新」会重新运行所有检查。&lt;/p&gt;&#10;&lt;h2 id="checks"&gt;检查项&#10;&lt;/h2&gt;&#10;&lt;div class="td-table-scroll td-table-scroll--static"&gt;&#10;&lt;table&gt;&#10; &lt;thead&gt;&#10; &lt;tr&gt;&#10; &lt;th scope="col"&gt;检查&lt;/th&gt;&#10; &lt;th scope="col"&gt;正常&lt;/th&gt;&#10; &lt;th scope="col"&gt;失败时&lt;/th&gt;&#10; &lt;/tr&gt;&#10; &lt;/thead&gt;&#10; &lt;tbody&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;Caps Lock 映射&lt;/td&gt;&#10; &lt;td&gt;Caps Lock 已就绪&lt;/td&gt;&#10; &lt;td&gt;未设置、被其他工具占用或无法读取。点「重新启用」或「恢复 Caps Lock」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;F18&lt;/td&gt;&#10; &lt;td&gt;F18 空闲&lt;/td&gt;&#10; &lt;td&gt;其他工具在使用 F18。移除那条改键后点「重新启用」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;Karabiner-Elements&lt;/td&gt;&#10; &lt;td&gt;未检测到，或无冲突&lt;/td&gt;&#10; &lt;td&gt;有规则使用 Caps Lock 或 F18，见 &lt;a href="https://caps.pgsty.com/zh/docs/start/karabiner/#resolve"&gt;Karabiner&lt;/a&gt;。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;崩溃恢复&lt;/td&gt;&#10; &lt;td&gt;无需恢复&lt;/td&gt;&#10; &lt;td&gt;上次没有正常退出，已在启动时清理；或另一个 Capslock 正在运行。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;辅助功能&lt;/td&gt;&#10; &lt;td&gt;已授权&lt;/td&gt;&#10; &lt;td&gt;点「打开辅助功能设置」「重新检查」或「重置并重新请求」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;发送按键&lt;/td&gt;&#10; &lt;td&gt;已允许&lt;/td&gt;&#10; &lt;td&gt;随辅助功能权限一并授予。点「请求权限」「重新检查」或「重置并重新请求」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;读取键盘&lt;/td&gt;&#10; &lt;td&gt;正在读取键盘&lt;/td&gt;&#10; &lt;td&gt;macOS 停止了事件钩子。点「重新启用」或「全部松开」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;安全输入&lt;/td&gt;&#10; &lt;td&gt;关闭&lt;/td&gt;&#10; &lt;td&gt;密码输入框或终端的「安全键盘输入」会对所有应用隐藏按键。Capslock 从不关闭它；请关闭该输入框或选项。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;Caps Lock 按键&lt;/td&gt;&#10; &lt;td&gt;已收到&lt;/td&gt;&#10; &lt;td&gt;按一次 Caps Lock，然后点「刷新」。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;配置&lt;/td&gt;&#10; &lt;td&gt;有效&lt;/td&gt;&#10; &lt;td&gt;文件无法读取。点「显示配置文件夹」，修复或替换它。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;签名&lt;/td&gt;&#10; &lt;td&gt;有效&lt;/td&gt;&#10; &lt;td&gt;开发版本。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;tr&gt;&#10; &lt;td&gt;更新&lt;/td&gt;&#10; &lt;td&gt;已启用&lt;/td&gt;&#10; &lt;td&gt;此版本不会自动更新，请从官网下载新版本。&lt;/td&gt;&#10; &lt;/tr&gt;&#10; &lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&#10;&lt;p&gt;「重置并重新请求」会清除 Capslock 的辅助功能和发送按键授权记录并重新请求。当系统设置显示&#10;Capslock 已获授权、检查却仍然失败时使用它；用不同的构建替换应用后可能出现这种情况。&lt;/p&gt;</description></item><item><title>卸载</title><link>https://caps.pgsty.com/zh/docs/reference/uninstall/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://caps.pgsty.com/zh/docs/reference/uninstall/</guid><description>&lt;p&gt;Capslock 没有安装程序，除了辅助功能授权记录外，不会在你的用户目录之外留下任何东西。&lt;/p&gt;&#10;&lt;ol class="steps"&gt;&#10;&lt;li&gt;从菜单栏图标或用 ⌘Q &lt;strong&gt;退出 Capslock&lt;/strong&gt;，让它归还 Caps Lock。如果它曾被强制退出、Caps Lock&#10;仍不正常，请在删除应用之前运行&lt;a href="https://caps.pgsty.com/zh/docs/reference/diagnostics/#cli"&gt;恢复命令&lt;/a&gt;。&lt;/li&gt;&#10;&lt;li&gt;如果你打开过「登录时打开」，在「设置 › 通用」中关闭它。&lt;/li&gt;&#10;&lt;li&gt;把 &lt;code&gt;/Applications/Capslock.app&lt;/code&gt; 移到废纸篓。&lt;/li&gt;&#10;&lt;li&gt;如果还要删除数据，删除以下内容：&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;~/Library/Application Support/com.vonng.capslock&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;~/Library/Preferences/com.vonng.capslock.plist&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;~/Library/Caches/com.vonng.capslock&lt;/code&gt;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;在「系统设置 › 隐私与安全性 › 辅助功能」中选中 Capslock，点击「−」。&lt;/li&gt;&#10;&lt;li&gt;如果用过剪贴板槽位，在「钥匙串访问」中删除名为 &lt;code&gt;com.vonng.capslock.clipboard-slots&lt;/code&gt; 的项目。&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;重启 Mac 也会清除 Caps Lock 映射，macOS 不会在重启后保留它。&lt;/p&gt;</description></item><item><title>隐私</title><link>https://caps.pgsty.com/zh/docs/reference/privacy/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://caps.pgsty.com/zh/docs/reference/privacy/</guid><description>&lt;p&gt;Capslock 在本机处理键盘与指针事件，以执行你选择的映射。它不包含任何行为分析或广告&#10;SDK，不发送任何映射、按键、剪贴板、Shell、应用历史或使用数据。&lt;/p&gt;</description></item><item><title>常见问题</title><link>https://caps.pgsty.com/zh/docs/reference/faq/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://caps.pgsty.com/zh/docs/reference/faq/</guid><description>&lt;h3 id="karabiner"&gt;需要 Karabiner-Elements 吗？&#10;&lt;/h3&gt;&#10;&lt;p&gt;不需要。Capslock 是独立应用，整套布局都已内置。如果你还用 Karabiner-Elements 管理其他按键，&#10;只要没有 Karabiner 规则作用于 Caps Lock 或 F18 就没问题。见&lt;a href="https://caps.pgsty.com/zh/docs/start/karabiner/"&gt;与 Karabiner-Elements 共存&lt;/a&gt;。&lt;/p&gt;</description></item></channel></rss>