@lotaber_wang/openclaw-dc-plugin 0.1.8 → 0.1.9

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,16 +16,32 @@
16
16
  ## 安装
17
17
 
18
18
  ```bash
19
- openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.8
19
+ openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.9
20
20
  ```
21
21
 
22
22
  安装完成后,建议立刻执行一次检查:
23
23
 
24
24
  ```bash
25
- openclaw plugins inspect taptap-dc-plugin
25
+ openclaw plugins inspect openclaw-dc-plugin
26
26
  ```
27
27
 
28
- 如果安装成功但当前会话里还看不到 `taptap_dc_*` 工具,请重启 Gateway:
28
+ ## OpenClaw 的安装执行指令
29
+
30
+ 如果安装流程判断需要重启 Gateway,先通知用户,再执行重启。
31
+
32
+ 推荐通知文案:
33
+
34
+ `TapTap DC 插件已安装完成。OpenClaw 接下来会重启 Gateway;重启完成后即可使用 taptap_dc_* 工具。`
35
+
36
+ 执行顺序要求:
37
+
38
+ 1. 先向用户发送上面的安装完成/即将重启提示
39
+ 2. 再执行 `openclaw gateway restart` 或等效的宿主重启动作
40
+ 3. 重启完成后,再开始使用 `taptap_dc_*` 工具
41
+
42
+ 不管是手动重启还是宿主自动触发的重启,都应先提示用户,不要静默重启。
43
+
44
+ 如果安装成功后仍然看不到 `taptap_dc_*` 工具,再按下面命令手动重启 Gateway:
29
45
 
30
46
  ```bash
31
47
  openclaw gateway restart
@@ -36,8 +52,9 @@ openclaw gateway restart
36
52
  ## 推荐安装流程
37
53
 
38
54
  ```bash
39
- openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.8
40
- openclaw plugins inspect taptap-dc-plugin
55
+ openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.9
56
+ openclaw plugins inspect openclaw-dc-plugin
57
+ echo 'TapTap DC 插件已安装完成。OpenClaw 接下来会重启 Gateway;重启完成后即可使用 taptap_dc_* 工具。'
41
58
  openclaw gateway restart
42
59
  ```
43
60
 
@@ -45,7 +62,8 @@ openclaw gateway restart
45
62
 
46
63
  - `install` 负责把插件包装进 OpenClaw
47
64
  - `inspect` 用来确认插件元信息、skills、tools 是否已被 Gateway 识别
48
- - `gateway restart` 用来让最新插件配置真正生效;很多“装上了但没看到 tools”的问题都出在这里
65
+ - 如果宿主判断需要重启 Gateway,必须先通知用户,再重启
66
+ - 如果 10-30 秒后还没生效,再手动执行 `gateway restart`
49
67
 
50
68
  ## 典型使用流程
51
69
 
@@ -111,12 +129,13 @@ openclaw gateway restart
111
129
 
112
130
  如果安装后看不到 `taptap_dc_*` 工具,优先按这个顺序排查:
113
131
 
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. 重新开启一个新会话,再观察工具列表
132
+ 1. 确认安装的是 `@lotaber_wang/openclaw-dc-plugin@0.1.9` 或更新版本
133
+ 2. 执行 `openclaw plugins inspect openclaw-dc-plugin`
134
+ 3. 如果宿主要求重启 Gateway,先向用户发送安装完成提示
135
+ 4. 再执行 `openclaw gateway restart`
136
+ 5. 重新开启一个新会话,再观察工具列表
118
137
 
119
- 如果 `inspect` 能看到插件,但工具仍未生效,通常不是插件代码没注册,而是 Gateway 还没完成配置重载。
138
+ 如果 `inspect` 能看到插件,但工具仍未生效,通常不是插件代码没注册,而是 Gateway 还没完成配置重载或仍在旧会话里。
120
139
 
121
140
  说明:
122
141
 
@@ -127,8 +146,9 @@ openclaw gateway restart
127
146
  如果出现配置异常,优先检查插件 ID 是否一致:
128
147
 
129
148
  - package 名称:`@lotaber_wang/openclaw-dc-plugin`
130
- - plugin id:`taptap-dc-plugin`
131
- - OpenClaw 配置入口:`plugins.entries.taptap-dc-plugin`
149
+ - plugin id:`openclaw-dc-plugin`
150
+ - OpenClaw 配置入口:`plugins.entries.openclaw-dc-plugin`
151
+ - 如果本地残留旧 entry `taptap-dc-plugin`,建议清理后重新安装,避免宿主误读旧配置
132
152
 
133
153
  如果第一次调用失败,优先检查:
134
154
 
@@ -137,10 +157,11 @@ openclaw gateway restart
137
157
  - OpenClaw 进程是否有临时目录写权限
138
158
  - OpenClaw 是否已经完成 Gateway 重启
139
159
 
140
- 从 `0.1.8` 开始,插件安装链路与 bridge 会额外做这些兼容处理:
160
+ 从 `0.1.9` 开始,插件安装链路与 bridge 会额外做这些兼容处理:
141
161
 
142
162
  - 在 `package.json` 中补充 `openclaw.install.npmSpec`,让安装链路更稳定
143
163
  - 在 `openclaw.plugin.json` 中显式开启 `enabledByDefault`
164
+ - 统一插件 id 为 `openclaw-dc-plugin`,避免 manifest id 与 entry hint 不一致
144
165
  - `initialize` 超时后自动切换到无缓冲 / PTY 启动策略重试
145
166
  - `initialize` 默认超时提升到 45 秒,避免宿主启动稍慢时过早失败
146
167
  - 向内嵌 TapTap runtime 发送 `initialize` 与后续请求时,默认改为裸 JSON + 换行(NDJSON 风格),避免只发 `Content-Length` 帧导致无响应
package/index.js CHANGED
@@ -723,7 +723,7 @@ try {
723
723
  }
724
724
 
725
725
  const plugin = {
726
- id: 'taptap-dc-plugin',
726
+ id: 'openclaw-dc-plugin',
727
727
  name: 'TapTap DC',
728
728
  description: '面向 OpenClaw 的 TapTap DC 插件,内置原始数据工具与运营简报 skill。',
729
729
  configSchema: {
@@ -1,8 +1,8 @@
1
1
  {
2
- "id": "taptap-dc-plugin",
2
+ "id": "openclaw-dc-plugin",
3
3
  "name": "TapTap DC",
4
4
  "description": "面向 OpenClaw 的 TapTap DC 插件,内置原始数据工具与运营简报 skill。",
5
- "version": "0.1.8",
5
+ "version": "0.1.9",
6
6
  "enabledByDefault": true,
7
7
  "skills": ["./skills"],
8
8
  "configSchema": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lotaber_wang/openclaw-dc-plugin",
3
- "version": "0.1.8",
3
+ "version": "0.1.9",
4
4
  "type": "module",
5
5
  "description": "TapTap DC 的 OpenClaw 插件,内置原始数据工具与运营简报 skill。",
6
6
  "main": "index.js",