<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[键盘采样：让盒子认识你那把键盘]]></title><description><![CDATA[<p dir="auto">盒子夹在电脑和键盘之间：电脑看到的是盒子，你的按键要先经过盒子转一手才能到电脑。这一手能不能转对，取决于盒子知不知道你这把键盘的报文长什么样。</p>
<p dir="auto">多数键盘用标准格式，盒子自带的那套就够。但另一类键盘不一样：全键无冲用位图、把修饰键和键码拆成两个 report、自己加了 report ID、或者把功能键丢在另一个用途页里。碰上这类键盘，默认格式对不上，键就转不过去。</p>
<p dir="auto">键盘采样就是给这类键盘用的：采一次，盒子以后按你这把键盘的格式来。</p>
<h2>能解决什么问题</h2>
<p dir="auto">出现下面这些症状，先试采样：</p>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>症状</th>
<th>具体表现</th>
</tr>
</thead>
<tbody>
<tr>
<td>某些键完全不认</td>
<td>按了电脑没反应，别的键都正常</td>
</tr>
<tr>
<td>按住不放变成连击</td>
<td>按住 Shift 走出来一串 Shift，按住方向键光标乱跳</td>
</tr>
<tr>
<td>组合键只过去一半</td>
<td>Ctrl+C 到电脑只剩 C，Ctrl+Shift+Esc 只出一个键</td>
</tr>
<tr>
<td>功能键、多媒体键失效</td>
<td>主键区正常，上面一排或者侧键不通</td>
</tr>
<tr>
<td>换了键盘就出问题</td>
<td>上一把键盘好好的，换这一把就不对</td>
</tr>
</tbody>
</table>
<p dir="auto">如果整把键盘都不工作、设备根本识别不到，那不是采样的范围，见<a href="/topic/66">《设备识别、固件更新与恢复》</a>。</p>
<h2>做完之后是什么效果</h2>
<ul>
<li><strong>盒子换成你这把键盘的身份</strong>：VID/PID、报文格式都跟着它走，电脑那边认到的就是这把键盘。</li>
<li><strong>状态行显示 <code>Mode: 透传</code></strong> 表示生效了。显示「固定」说明连的还是盒子自己的身份，采样没起作用。</li>
<li><strong>宏不用改。</strong> 脚本里的 <code>KeyTap("a")</code> 还是 <code>KeyTap("a")</code>，变的是这一下按键最终以什么格式发出去，采完不用回去改脚本。</li>
<li><strong>可以存下来复用。</strong> 采样结果能导出成 <code>.kmps</code>，换机器、恢复出厂之后导回去，不用重采。</li>
<li>采样只读键盘自报的身份信息，<strong>不记录你按过的任何键</strong>。</li>
</ul>
<h2>操作前先确认</h2>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>条件</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>设备要支持</td>
<td>仅新设备具备这个能力，老设备点了不会有回应</td>
</tr>
<tr>
<td>设备已激活</td>
<td>未激活的设备不执行采样，直接回错误码 -8</td>
</tr>
<tr>
<td>键盘插在盒子上</td>
<td>采样时盒子要能枚举到它，插在电脑上采不到</td>
</tr>
<tr>
<td>用键鼠透传程序</td>
<td>采样按钮在<strong>键鼠透传</strong>里，不在键鼠助手主程序里；两个程序装在同一目录</td>
</tr>
</tbody>
</table>
<blockquote>
<p dir="auto">之前手填过 VID/PID（见<a href="/topic/67">《USB 协议自定义》</a>）的，采样之后以采样结果为准，手填的那两个值会被覆盖。</p>
</blockquote>
<h2>操作步骤</h2>
<ol>
<li><strong>打开键鼠透传。</strong> 与键鼠助手同目录的另一个程序。</li>
<li><strong>按压按键</strong>。保持按压状态把键鼠透传设备插入电脑。</li>
<li><strong>连接设备。</strong> 第一次连<strong>不要</strong>勾「仅连接」——此时盒子还是它自己的身份，全枚举就能找到。</li>
<li><strong>点底部的「KM 采样」。</strong> 按钮变成「采样已发出」，等回包。</li>
<li><strong>看结果。</strong> 成功时会提示 <code>采样设备: VID xxxx / PID xxxx</code>，同时这对 ID 自动填进连接条的 VID/PID 框，并自动勾上「仅连接」——设备重启后已经换了身份，不点名就找不到了。(部分设备不会填入VID/PID，可以忽略这个，不影响纯硬件宏使用，只是无法通过软件API调用键鼠事件)。如果没有弹出VID/PID框，也不需要上位机调用，如果想再试连接，重复第2步。如果需要上位机调用，可以换个其它的键鼠设备尝试一下，一般支持板载宏的键鼠都支持，但是并不代表不支持板载宏的键鼠就不支持，只是概率会小很多。</li>
<li><strong>手动点一次「连接」。</strong> 采样成功后设备会重启，此时链路是断的。</li>
<li><strong>确认模式。</strong> 连接条状态行显示 <code>Mode: 透传</code> 才算成了。显示「固定」说明这次连的还是设备自己的身份。</li>
</ol>
<blockquote>
<p dir="auto">采样命令发出去后 6 秒没有回应，程序会提示「设备没有回应采样命令」。常见原因：设备没激活、固件太旧不支持、链路已断。</p>
</blockquote>
<h2>备份与迁移</h2>
<p dir="auto">采样结果能取出来，也能写回去：</p>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>按钮</th>
<th>作用</th>
</tr>
</thead>
<tbody>
<tr>
<td>导出</td>
<td>把设备里的采样镜像读出来，存成 <code>.kmps</code> 文件</td>
</tr>
<tr>
<td>导入</td>
<td>把 <code>.kmps</code> 写进设备，写完设备自动重启</td>
</tr>
</tbody>
</table>
<p dir="auto">两种用途：同一型号的键盘有好几把，采一次导出、其余几台导入；或者设备要升级固件、恢复出厂之前先把镜像存一份。</p>
<blockquote>
<p dir="auto"><code>.kmps</code> 里装的是<strong>某个键盘型号的 USB 身份</strong>。导入来源不明的文件，等于让盒子冒充你没见过的设备。要恢复就换回自己那份，别拿别人给的当通用备份。</p>
</blockquote>
<h2>遇到问题如何处理</h2>
<h3>采样失败，弹了错误码</h3>
<p dir="auto">提示格式是「采样失败（错误码 N）：说明」：</p>
<table class="table table-bordered table-striped">
<thead>
<tr>
<th>码</th>
<th>含义</th>
<th>一般怎么处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>-1</td>
<td>没有找到兼容的 USB 设备</td>
<td>键盘没插在盒子上，或插了但不兼容</td>
</tr>
<tr>
<td>-2</td>
<td>读设备描述符失败</td>
<td>换线、换口再试</td>
</tr>
<tr>
<td>-3</td>
<td>读配置描述符失败</td>
<td>同上</td>
</tr>
<tr>
<td>-4</td>
<td>读 HID 报文描述符失败</td>
<td>复合设备容易卡在这步，换口重试</td>
</tr>
<tr>
<td>-5</td>
<td>采样数据写入设备失败</td>
<td>设备存储异常，重试；仍失败联系售后</td>
</tr>
<tr>
<td>-6</td>
<td>采样数据超出存储上限</td>
<td>描述符太大，多见于 report 很多的自定义键盘</td>
</tr>
<tr>
<td>-7</td>
<td>采样超时</td>
<td>键盘响应慢或中途掉了，重插再采</td>
</tr>
<tr>
<td>-8</td>
<td>设备未激活</td>
<td>先激活</td>
</tr>
<tr>
<td>-9</td>
<td>设备没有回传 VID/PID</td>
<td>固件过旧，见<a href="/topic/66">《设备识别、固件更新与恢复》</a></td>
</tr>
</tbody>
</table>
<h3>提示采样成功，但连不上设备</h3>
<p dir="auto">设备重启成新身份，而程序的自动重连还在用旧 VID/PID，必然连不上。这不是坏了，手动点一次「连接」。</p>
<h3>采完个别键还是不对</h3>
<p dir="auto">按顺序核两件事：键盘是不是插在<strong>盒子</strong>上采的；连接后状态行是不是 <code>Mode: 透传</code>。两步都对仍有键不对，说明这把键盘的报文里有盒子没覆盖的字段——带上键盘型号和当时的错误码发帖，比只说「有个键按不出来」有用得多。</p>
<h3>换了一把键盘，之前采的还能用吗</h3>
<p dir="auto">不能。采样绑的是那一把键盘，换一把报文格式不同的要重采。</p>
<h3>什么时候该重新采样</h3>
<p dir="auto">换键盘、键盘换了 USB 口之后行为变了、或者升级固件后提醒重采——这几种情况重新采一次。日常换机器、重装程序不用重采，把 <code>.kmps</code> 导回去就行。</p>
<h2>相关</h2>
<ul>
<li>盒子的身份是怎么被系统识别的：见<a href="/topic/67">《USB 协议自定义：VID/PID 与字符串描述符》</a>；</li>
<li>版本信息、固件更新与恢复：见<a href="/topic/66">《设备识别、固件更新与恢复》</a>。</li>
</ul>
]]></description><link>https://www.byteohm.com/topic/76/键盘采样-让盒子认识你那把键盘</link><generator>RSS for Node</generator><lastBuildDate>Thu, 19 Nov 2026 05:41:44 GMT</lastBuildDate><atom:link href="https://www.byteohm.com/topic/76.rss" rel="self" type="application/rss+xml"/><pubDate>Thu, 05 Nov 2026 17:06:32 GMT</pubDate><ttl>60</ttl></channel></rss>