@linkdesk/plugin-docs 0.1.29 → 0.1.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -169,6 +169,8 @@ useEffect(() => {
169
169
 
170
170
  **❌ 反模式(红字):** `document.addEventListener("keydown", ...)` / `window.addEventListener("keydown", ...)` = **全局劫持**——绕过分区前提,插件有活动会话时劫持全池同键(串口 F2 曾劫持文件树 F2)。**`tabIndex` + 容器 `onKeyDown` 才是焦点分区正解**;非焦点元素不触发,可加 `tabIndex={0}` 承接。
171
171
 
172
+ 🔴 **这条反模式有腿了(2026-09-20,SDK 0.1.46 起)**:`linkdesk-plugin-sdk lint` 的 `linkdesk/no-global-key-listener` 腿机械拦截 window/document 的 keydown/keyup **字面量**监听,报错文案直接给正解与豁免写法。确需全局抓键的正当形态(如快捷键录制器要 capture 抓原始键)走标准 disable 注释+理由——判据本身无白名单。
173
+
172
174
  **注意:** 轨道二键**不进快捷键设置面板**——面板只显示 KeybindingRegistry 绑定(轨道一)。这是设计取舍(注册即吞池,见 4.1),不是 bug。
173
175
 
174
176
  ### 4.3 剪贴板三选一通道表
@@ -532,6 +534,8 @@ monaco 当前背景不透明、只二态跟随(亮/暗)是**过渡态绕开
532
534
  (`@linkdesk/ui`)的样式、以及**所有已加载插件**的样式——**类名是全局标识符**。你写下一个类名,
533
535
  就等于占用了这个名字;别人也用这个名字,两边的样式就会落到同一个元素上。
534
536
 
537
+ 🔴 **引用侧也有腿了(2026-09-20,SDK 0.1.46 起)**:TSX `className` **字面量**里引用的本插件前缀类名,必须能在本仓 CSS(含 scoped 规则)里找到定义——`linkdesk/no-reserved-class-name` 家族新判据机械把关。头号根因 = CSS 块注释里写 `--text-*/` 这类文本:`*/` 把注释**提前闭合**,残渣黏住下一条规则把它整条吞掉(生态首例,样式静默丢失零报错);文案列三种常见根因(拼错/漏 import/注释吞规则)。动态拼接(模板插值 / clsx / 变量)跳过并计数。
538
+
535
539
  **三条纪律:**
536
540
 
537
541
  1. **给自己的元素起的类名,必须以 `pluginId` 加连字符开头**——`settings-*`、`editor-*`、`file-tree-*`……
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-docs",
3
- "version": "0.1.29",
3
+ "version": "0.1.30",
4
4
  "description": "LinkDesk 插件作者文档(离线包)——`docs/03-插件制造` 的发布产物:从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
5
  "type": "module",
6
6
  "files": [