@linkdesk/plugin-docs 0.1.38 → 0.1.39
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.
|
@@ -116,6 +116,17 @@ useEffect(() => {
|
|
|
116
116
|
|
|
117
117
|
---
|
|
118
118
|
|
|
119
|
+
## 七、常驻纪律(2026-09-29 立 · `AI#49`)
|
|
120
|
+
|
|
121
|
+
- 🔴 **这不是一次性交付**:此后**每个新功能 / 新插件**都必须满足「**① 每个用户动作至少一条非鼠标路径;② 业务动作注册为命令,且注册 meta 带 `description` + `params`**」——壳侧的同一句话已进**壳仓库的硬约束 26**(内部工程规范,此处不指向)。理由:**破洞会随迭代重生**(AI 友好化系列的缘起,就是一个老功能里的隐藏门控卡住了 AI)。
|
|
122
|
+
- **机械自查两条**(写完跑一遍,⛔ 别肉眼过):`npm run audit:plugin-commands`(**只报不拦**——报「有视图声明却零命令」与「整批缺 description」)· `npm run manual:build`(宿主命令手册索引的逐字节漂移门禁;插件命令**不需要**进它,运行期 `getCommands()` 查得到即可)。
|
|
123
|
+
- **验收同样与物理指针无关**:测命令走命令 / API(或 CLI / MCP),⛔ 不拿「截图 → 猜坐标点击」当验证手段;**只出现在指针下的面**(悬停按钮那类)用「**先取元素、再落到元素自身**」的元素锚定方式验——⛔ 不按窗口位置推算坐标(推算出来的坐标换个窗口设置就错位)。
|
|
124
|
+
- ⚠️ **两条实录坑**(2026-09-29 会话 13 验收踩到,写在这省后人一轮):
|
|
125
|
+
1. **注册时机**——在**视图组件挂载时**才 `registerCommand` 的插件,**没开过视图时外部 AI 在命令清单里看不到你的命令**(调了报 `EUNKNOWN`)⇒ 能在 activate 期注册就别拖到 mount(账 = 生长格 `AI#54`)。
|
|
126
|
+
2. **参数形状**——`params` 是**具名**的,执行面却按**位置**透传 ⇒ 调用方照「具名对象」调会**静默无效**(`ok=true` 却没做事);今天的正解 = 调用方按 `params` **顺序平铺**传参,壳侧兼容在账(生长格 `AI#52`)。
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
119
130
|
**相关:** [03-插件contributes规范](03-插件contributes规范.md) §3.1(`contributes.commands` 全字段)·
|
|
120
131
|
[07-插件间通信](07-插件间通信.md)(命令调用另一只插件的命令)·
|
|
121
132
|
[14-数据管道命令约定](14-数据管道命令约定.md)(数据管道命令的命名约定)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@linkdesk/plugin-docs",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.39",
|
|
4
4
|
"description": "LinkDesk 插件作者文档(离线包)——作者面文档树的发布产物(英文 `docs/03-plugin-authoring` 在包根、中文 `docs/03-插件制造` 在 `zh/`):从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|