@lotaber_wang/openclaw-dc-plugin 0.1.7 → 0.1.8

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.
package/README.md CHANGED
@@ -16,9 +16,37 @@
16
16
  ## 安装
17
17
 
18
18
  ```bash
19
- openclaw plugins install @lotaber_wang/openclaw-dc-plugin
19
+ openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.8
20
20
  ```
21
21
 
22
+ 安装完成后,建议立刻执行一次检查:
23
+
24
+ ```bash
25
+ openclaw plugins inspect taptap-dc-plugin
26
+ ```
27
+
28
+ 如果安装成功但当前会话里还看不到 `taptap_dc_*` 工具,请重启 Gateway:
29
+
30
+ ```bash
31
+ openclaw gateway restart
32
+ ```
33
+
34
+ 如果你的环境没有 `openclaw gateway restart`,就直接完整重启 OpenClaw / 宿主应用。
35
+
36
+ ## 推荐安装流程
37
+
38
+ ```bash
39
+ openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.8
40
+ openclaw plugins inspect taptap-dc-plugin
41
+ openclaw gateway restart
42
+ ```
43
+
44
+ 说明:
45
+
46
+ - `install` 负责把插件包装进 OpenClaw
47
+ - `inspect` 用来确认插件元信息、skills、tools 是否已被 Gateway 识别
48
+ - `gateway restart` 用来让最新插件配置真正生效;很多“装上了但没看到 tools”的问题都出在这里
49
+
22
50
  ## 典型使用流程
23
51
 
24
52
  优先推荐直接使用:
@@ -81,14 +109,38 @@ openclaw plugins install @lotaber_wang/openclaw-dc-plugin
81
109
 
82
110
  如果 OpenClaw 能安装插件,但第一次调用工具仍然偏慢,通常是在启动内嵌 TapTap 运行时,而不是在现场重新下载依赖。
83
111
 
112
+ 如果安装后看不到 `taptap_dc_*` 工具,优先按这个顺序排查:
113
+
114
+ 1. 确认安装的是 `@lotaber_wang/openclaw-dc-plugin@0.1.8` 或更新版本
115
+ 2. 执行 `openclaw plugins inspect taptap-dc-plugin`
116
+ 3. 执行 `openclaw gateway restart`
117
+ 4. 重新开启一个新会话,再观察工具列表
118
+
119
+ 如果 `inspect` 能看到插件,但工具仍未生效,通常不是插件代码没注册,而是 Gateway 还没完成配置重载。
120
+
121
+ 说明:
122
+
123
+ - 本插件的 `taptap_dc_*` 工具由插件入口代码动态注册
124
+ - `openclaw.plugin.json` 主要承担插件元信息、默认启用和配置校验职责
125
+ - 所以“装完看不到 tool”时,优先怀疑安装状态、Gateway 重启和会话刷新,而不是去手改 manifest 里的 `tools` 字段
126
+
127
+ 如果出现配置异常,优先检查插件 ID 是否一致:
128
+
129
+ - package 名称:`@lotaber_wang/openclaw-dc-plugin`
130
+ - plugin id:`taptap-dc-plugin`
131
+ - OpenClaw 配置入口:`plugins.entries.taptap-dc-plugin`
132
+
84
133
  如果第一次调用失败,优先检查:
85
134
 
86
135
  - 当前环境是否能访问 npm registry
87
136
  - 本机 Node 版本是否 >= 18.14.1
88
137
  - OpenClaw 进程是否有临时目录写权限
138
+ - OpenClaw 是否已经完成 Gateway 重启
89
139
 
90
- 从 `0.1.7` 开始,插件 bridge 会额外做这些兼容处理:
140
+ 从 `0.1.8` 开始,插件安装链路与 bridge 会额外做这些兼容处理:
91
141
 
142
+ - 在 `package.json` 中补充 `openclaw.install.npmSpec`,让安装链路更稳定
143
+ - 在 `openclaw.plugin.json` 中显式开启 `enabledByDefault`
92
144
  - `initialize` 超时后自动切换到无缓冲 / PTY 启动策略重试
93
145
  - `initialize` 默认超时提升到 45 秒,避免宿主启动稍慢时过早失败
94
146
  - 向内嵌 TapTap runtime 发送 `initialize` 与后续请求时,默认改为裸 JSON + 换行(NDJSON 风格),避免只发 `Content-Length` 帧导致无响应
@@ -2,7 +2,8 @@
2
2
  "id": "taptap-dc-plugin",
3
3
  "name": "TapTap DC",
4
4
  "description": "面向 OpenClaw 的 TapTap DC 插件,内置原始数据工具与运营简报 skill。",
5
- "version": "0.1.7",
5
+ "version": "0.1.8",
6
+ "enabledByDefault": true,
6
7
  "skills": ["./skills"],
7
8
  "configSchema": {
8
9
  "type": "object",
package/package.json CHANGED
@@ -1,13 +1,16 @@
1
1
  {
2
2
  "name": "@lotaber_wang/openclaw-dc-plugin",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "type": "module",
5
5
  "description": "TapTap DC 的 OpenClaw 插件,内置原始数据工具与运营简报 skill。",
6
6
  "main": "index.js",
7
7
  "openclaw": {
8
8
  "extensions": [
9
9
  "./index.js"
10
- ]
10
+ ],
11
+ "install": {
12
+ "npmSpec": "@lotaber_wang/openclaw-dc-plugin"
13
+ }
11
14
  },
12
15
  "exports": {
13
16
  ".": "./index.js",