@lotaber_wang/openclaw-dc-plugin 0.1.7 → 0.1.9

package/README.md

@@ -16,9 +16,55 @@
 ## 安装
 
 ```bash
-openclaw plugins install @lotaber_wang/openclaw-dc-plugin
+openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.9
 ```
 
+安装完成后，建议立刻执行一次检查：
+
+```bash
+openclaw plugins inspect openclaw-dc-plugin
+```
+
+## 给 OpenClaw 的安装执行指令
+
+如果安装流程判断需要重启 Gateway，先通知用户，再执行重启。
+
+推荐通知文案：
+
+`TapTap DC 插件已安装完成。OpenClaw 接下来会重启 Gateway；重启完成后即可使用 taptap_dc_* 工具。`
+
+执行顺序要求：
+
+1. 先向用户发送上面的安装完成/即将重启提示
+2. 再执行 `openclaw gateway restart` 或等效的宿主重启动作
+3. 重启完成后，再开始使用 `taptap_dc_*` 工具
+
+不管是手动重启还是宿主自动触发的重启，都应先提示用户，不要静默重启。
+
+如果安装成功后仍然看不到 `taptap_dc_*` 工具，再按下面命令手动重启 Gateway：
+
+```bash
+openclaw gateway restart
+```
+
+如果你的环境没有 `openclaw gateway restart`，就直接完整重启 OpenClaw / 宿主应用。
+
+## 推荐安装流程
+
+```bash
+openclaw plugins install @lotaber_wang/openclaw-dc-plugin@0.1.9
+openclaw plugins inspect openclaw-dc-plugin
+echo 'TapTap DC 插件已安装完成。OpenClaw 接下来会重启 Gateway；重启完成后即可使用 taptap_dc_* 工具。'
+openclaw gateway restart
+```
+
+说明：
+
+- `install` 负责把插件包装进 OpenClaw
+- `inspect` 用来确认插件元信息、skills、tools 是否已被 Gateway 识别
+- 如果宿主判断需要重启 Gateway，必须先通知用户，再重启
+- 如果 10-30 秒后还没生效，再手动执行 `gateway restart`
+
 ## 典型使用流程
 
 优先推荐直接使用：
@@ -81,14 +127,41 @@ openclaw plugins install @lotaber_wang/openclaw-dc-plugin
 
 如果 OpenClaw 能安装插件，但第一次调用工具仍然偏慢，通常是在启动内嵌 TapTap 运行时，而不是在现场重新下载依赖。
 
+如果安装后看不到 `taptap_dc_*` 工具，优先按这个顺序排查：
+
+1. 确认安装的是 `@lotaber_wang/openclaw-dc-plugin@0.1.9` 或更新版本
+2. 执行 `openclaw plugins inspect openclaw-dc-plugin`
+3. 如果宿主要求重启 Gateway，先向用户发送安装完成提示
+4. 再执行 `openclaw gateway restart`
+5. 重新开启一个新会话，再观察工具列表
+
+如果 `inspect` 能看到插件，但工具仍未生效，通常不是插件代码没注册，而是 Gateway 还没完成配置重载或仍在旧会话里。
+
+说明：
+
+- 本插件的 `taptap_dc_*` 工具由插件入口代码动态注册
+- `openclaw.plugin.json` 主要承担插件元信息、默认启用和配置校验职责
+- 所以“装完看不到 tool”时，优先怀疑安装状态、Gateway 重启和会话刷新，而不是去手改 manifest 里的 `tools` 字段
+
+如果出现配置异常，优先检查插件 ID 是否一致：
+
+- package 名称：`@lotaber_wang/openclaw-dc-plugin`
+- plugin id：`openclaw-dc-plugin`
+- OpenClaw 配置入口：`plugins.entries.openclaw-dc-plugin`
+- 如果本地残留旧 entry `taptap-dc-plugin`，建议清理后重新安装，避免宿主误读旧配置
+
 如果第一次调用失败，优先检查：
 
 - 当前环境是否能访问 npm registry
 - 本机 Node 版本是否 >= 18.14.1
 - OpenClaw 进程是否有临时目录写权限
+- OpenClaw 是否已经完成 Gateway 重启
 
-从 `0.1.7` 开始，插件 bridge 会额外做这些兼容处理：
+从 `0.1.9` 开始，插件安装链路与 bridge 会额外做这些兼容处理：
 
+- 在 `package.json` 中补充 `openclaw.install.npmSpec`，让安装链路更稳定
+- 在 `openclaw.plugin.json` 中显式开启 `enabledByDefault`
+- 统一插件 id 为 `openclaw-dc-plugin`，避免 manifest id 与 entry hint 不一致
 - `initialize` 超时后自动切换到无缓冲 / PTY 启动策略重试
 - `initialize` 默认超时提升到 45 秒，避免宿主启动稍慢时过早失败
 - 向内嵌 TapTap runtime 发送 `initialize` 与后续请求时，默认改为裸 JSON + 换行（NDJSON 风格），避免只发 `Content-Length` 帧导致无响应

package/index.js

@@ -723,7 +723,7 @@ try {
 }
 
 const plugin = {
-  id: 'taptap-dc-plugin',
+  id: 'openclaw-dc-plugin',
   name: 'TapTap DC',
   description: '面向 OpenClaw 的 TapTap DC 插件，内置原始数据工具与运营简报 skill。',
   configSchema: {

package/openclaw.plugin.json

@@ -1,8 +1,9 @@
 {
-  "id": "taptap-dc-plugin",
+  "id": "openclaw-dc-plugin",
   "name": "TapTap DC",
   "description": "面向 OpenClaw 的 TapTap DC 插件，内置原始数据工具与运营简报 skill。",
-  "version": "0.1.7",
+  "version": "0.1.9",
+  "enabledByDefault": true,
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@lotaber_wang/openclaw-dc-plugin",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "TapTap DC 的 OpenClaw 插件，内置原始数据工具与运营简报 skill。",
   "main": "index.js",
   "openclaw": {
     "extensions": [
       "./index.js"
-    ]
+    ],
+    "install": {
+      "npmSpec": "@lotaber_wang/openclaw-dc-plugin"
+    }
   },
   "exports": {
     ".": "./index.js",