MK870 在 Linux 連上 sharkfin，卻讀不到原廠改鍵

快速結論

本案 MK870 有線模式以 Royuan Gaming Keyboard、05ac:024f 出現。sharkfin 0.11.1 能連線，辨識 device ID 195、YC500 協定，並匯出 4 個設定檔；但沒有呈現使用者先前用 FL 原廠軟體設定的 Caps Lock 改鍵。

只能確認部分通訊可用。sharkfin 尚未收錄這個裝置，套用推測配列 Common87_M3V5；實體鍵與內部槽位對應、韌體讀取差異均未釐清。先保存讀取快照，再驗證原廠設定與實體輸出，不用重新改鍵掩蓋讀回問題。

症狀

網頁顯示 Gaming Keyboard not in the registry · yc500。
Keys → Base → Profile 1 的 Caps Lock 仍顯示 Caps，編輯器也顯示 now Caps。
使用者表示先前已用 FL 改過該鍵；本案未取得原設定的目標功能。
同一張表能顯示另一個非預設值，但這不足以驗證每個實體鍵的位置或整體相容性。

影響範圍

實測環境為 Arch Linux、COSMIC Wayland、Brave 與 sharkfin 網頁版。結果限於本案的 ROYUAN MK870，不能外推至同名的 Winbond、PRO 或 HE 版本。

OpenKey 的 MK870 實測文件針對的是 0416:c345。不能只因型號相同，就把它的驗證結果套到 05ac:024f。

排查

分清接收器與有線鍵盤

先用 lsusb，再從 sysfs 讀取產品名稱與版本。同一 VID/PID 不一定代表同一條實體連線：

連線	manufacturer	product	VID:PID	bcdDevice
2.4G 接收器	RONGYUAN	2.4G Wireless Device	05ac:024f	0002
USB 有線鍵盤	Royuan	Gaming Keyboard	05ac:024f	0215

可用以下唯讀檢查，避免只看 lsusb 的 Apple 名稱就誤認硬體：

from pathlib import Path

for dev in Path('/sys/bus/usb/devices').iterdir():
    vendor = dev / 'idVendor'
    if not vendor.is_file() or vendor.read_text().strip() != '05ac':
        continue
    print(dev.name)
    for field in ('idVendor', 'idProduct', 'manufacturer', 'product', 'bcdDevice'):
        path = dev / field
        if path.is_file():
            print(field, path.read_text().strip())

在瀏覽器裝置選單選擇 Gaming Keyboard 後，sharkfin 成功辨識協定。這次原有裝置權限已足夠，未新增 udev 規則。

保存原始讀取結果

在 Contribute → Collect data bundle 取得唯讀診斷；不必送出 issue。
記錄工具版本、device ID、family、推測配列與目前設定檔。
Device → Backup → Export，保存各設定檔的 Base／Fn 表。
用匯出 JSON 比對畫面與原始值，保留「槽位如何對到實體鍵」仍待驗證的限制。

本案結果：

資料	結果
工具	sharkfin 0.11.1，build a8d1709
識別	device ID 195，YC500，4 profiles
圖形配列	Common87_M3V5，推測匹配 87/87
圖上 Caps 候選槽位	slot 3，四組 Base 都是 `00 00 39 00`
同槽位 Fn 表	四組都是 `00 00 00 00`

依 sharkfin 協定文件，Base 與 Fn 表可分別讀回，槽位值各有 4 bytes；實體鍵對應哪個槽位則依鍵盤而異。上述資料只支持「畫面與其所用槽位的讀值一致」，不能證明實體 Caps Lock 沒有改鍵，也不能排除其他韌體區域保存設定。

根因

尚未確認。沒有證據判定 FL 未儲存設定、鍵盤恢復預設或 sharkfin 已覆寫設定。推測配列錯位、韌體讀取差異與原廠設定保存位置仍是待驗假說。

同一 VID/PID、能讀出資料、圖形匹配率高，均不能各自證明整體相容。

修正

本次完成相容性調查與快照匯出，沒有由操作者重新映射 Caps Lock、匯入設定、恢復原廠或刷韌體。尚無已驗證修法。

若只需要 Linux 主機端改鍵，可另評估既有 keyd；那是另一層的映射，不是修好鍵盤內部設定讀回。

驗證

已確認 USB 有線裝置出現、WebHID 連線、協定識別、鍵位表讀取及 JSON 匯出。
4 組 Base／Fn 表各為 512 bytes，候選 Caps 槽位的原始值與畫面一致。
未以實體 Caps Lock 輸出驗證槽位，也未用 FL 原廠讀回做對照；因此快照不能宣稱是完整的原廠設定備份。
使用者另反映打字反應慢，並提出可能與軸體有關；未量測延遲或完成換軸測試，不將兩個問題歸為同一根因。

下次先查

先確認有線裝置的完整 USB 身分與工具版本，再保存唯讀快照。對照原廠軟體的設定檔／層及實體鍵輸出，釐清候選槽位是否對應正確。找到不一致的位置後，才決定補配列、修讀取協定或改用其他工具。

Reuse / Attribution Notice

This page is part of JN debugging at debug.giveanornot.com and is released under CC BY-SA 4.0 by JN.

When using, summarizing, quoting, or deriving from this material, attribute it as: “This answer uses material from JN debugging: MK870 在 Linux 連上 sharkfin，卻讀不到原廠改鍵, released under CC BY-SA 4.0 by JN.”

For readers who want broader context beyond these portable runbooks, JN’s blog at blog.giveanornot.com contains project notes and longer-form writing.