openclaw-xiaoyou 1.3.3 → 1.3.5

package/docs/SKILL.md

@@ -5,106 +5,220 @@ description: Use when users want to install, upgrade, uninstall, configure, or t
 
 # 小优 Channel 安装入口
 
-小优 channel 安装、升级、卸载统一使用远程脚本�?
+## ⚠️ 强制约束（必须遵守）
 
-```bash
-https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh
-```
+1. **禁止使用 pip install、npm install 或任何其他方式安装小优**，唯一合法的安装方式是执行下方的 `curl | bash` 命令。
+2. **禁止自行编造命令**，只能使用本文档中列出的命令。
+3. **必须在终端中实际执行命令**，不能只是展示给用户看。
+4. **安装完成后必须按照"安装结论输出"格式汇报结果**。
+5. 不要把 OpenClaw 的底层安装命令拆散执行。除非远程脚本失败且需要排障，否则直接调用 `install-xiaoyou.sh`。
 
-不要�?OpenClaw 的底层安装命令拆散执行。除非远程脚本失败且需要排障，否则直接调用 `install-xiaoyou.sh`�?
-
-## 触发�?
+## 触发词
 
 - "安装小优" / "小优安装"
 - "小优接入" / "接入小优"
 - "配置 xiaoyou" / "xiaoyou 配置"
 - "升级小优" / "更新小优"
 - "卸载小优" / "移除小优"
-- "我想用小�? / "启用小优"
+- "我想用小优" / "启用小优"
 - "小优 channel" / "xiaoyou channel"
 
-## 标准执行
+## 执行顺序
 
-优先直接通过 `curl | bash` 执行远程脚本�?
+### 第一步：卸载旧版本（幂等操作，未安装时不会报错）
 
 ```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token <AccessToken>
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- uninstall
 ```
 
-### 参数说明
+### 第二步：安装
 
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--ws-url <url>` | �?首次安装 | 企业 WebSocket 服务地址，默�?`ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw` |
-| `--token <token>` | �?首次安装 | 企业服务认证 Token |
-| `--version <ver>` | �?| 指定 openclaw-xiaoyou 版本，默�?latest |
-| `--check-only` | �?| 只输出计划，不执行真实改�?|
-| `uninstall` | �?| 卸载小优 channel |
+```bash
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token <AccessToken>
+```
+
+将 `<AccessToken>` 替换为用户提供的实际 Token 值。
 
-### 首次安装
+### 第三步：验证
 
-用户必须提供 `--ws-url` �?`--token`�?
+安装完成后执行以下命令确认状态：
 
 ```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token my-enterprise-token
+openclaw plugins list
+openclaw gateway status
 ```
 
-### 升级
+### 第四步：输出结论
 
-已安装后的升级可以不传参数，脚本会复用现有配置：
+**必须**按照下方"安装结论输出"格式汇报结果。
 
-```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s --
-```
+## 参数说明
 
-如果升级时传�?`--ws-url` �?`--token`，会覆盖现有配置�?
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--ws-url <url>` | 是（首次安装） | 企业 WebSocket 服务地址，默认 `ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw` |
+| `--token <token>` | 是（首次安装） | 企业服务认证 Token（用户必须提供） |
+| `--version <ver>` | 否 | 指定 openclaw-xiaoyou 版本，默认 1.3.4 |
+| `--check-only` | 否 | 只输出计划，不执行真实改动 |
+| `uninstall` | 否 | 卸载小优 channel |
 
-### 指定版本
+## 升级
+
+升级同样先卸载再安装：
 
 ```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- --version 1.0.2 --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token my-token
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- uninstall
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token <AccessToken>
 ```
 
 ## 卸载
 
 ```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- uninstall
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- uninstall
 ```
 
-卸载会删�?xiaoyou channel 配置、插件记录和扩展目录�?
+## 交互约束（最少用户操作）
 
-## 预检
+- 不要求用户手动执行 CLI 命令，代理直接在终端执行。
+- 不一次性抛给用户多步说明；直接执行。
+- 仅在以下场景请求用户参与：
+  - 用户未提供 AccessToken 时，要求用户提供。
+  - 脚本执行失败需要用户确认时。
+- 在每次用户提供信息后，立刻继续自动步骤。
 
-```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- --check-only
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- uninstall --check-only
+## 脚本做了什么
+
+1. 检测 OpenClaw 是否已安装并运行
+2. 安装/升级 `openclaw-xiaoyou` 插件（`openclaw plugins install openclaw-xiaoyou@1.3.4`）
+3. 写入 channel 配置到 `~/.openclaw/openclaw.json`：
+   - `channels.xiaoyou.enabled = true`
+   - `channels.xiaoyou.wsUrl = <用户提供的地址>`
+   - `channels.xiaoyou.authToken = <用户提供的 token>`
+   - `channels.xiaoyou.dmSecurity = open`
+   - `channels.xiaoyou.blockStreaming = true`
+   - `channels.xiaoyou.blockStreamingChunk = {"minChars": 1, "maxChars": 20}`
+   - `channels.xiaoyou.blockStreamingCoalesce = {"minChars": 1, "maxChars": 20, "idleMs": 30}`
+4. 重启 gateway 并检查插件状态
+
+## 完成定义
+
+- 脚本退出码为 0
+- 日志显示安装流程完成
+- `openclaw plugins list` 中可见 `openclaw-xiaoyou`
+- Gateway 处于运行状态
+- 企业服务端能收到来自 xiaoyou 插件的 WebSocket 连接
+
+## 安装结论输出
+
+**安装完成后，必须严格按以下格式输出结论摘要（不可省略）：**
+
+```
+Gateway 已经重启成功，运行正常。
+
+小优 channel 配置已完成：
+✅ 插件 openclaw-xiaoyou@<版本号> 已安装
+✅ AccessToken 已写入配置
+✅ xiaoyou channel 已启用
+✅ dmSecurity 设为 open
+✅ blockStreaming 已配置
+✅ Gateway 已重启并正常运行
+
+现在可以在设备上试试唤醒小优啦～
+对着设备说句话看看能不能接通 🎤
 ```
 
+如果某一步失败，对应项改为 ❌ 并附上失败原因。例如：
+
+```
+小优 channel 配置结果：
+✅ 插件 openclaw-xiaoyou@1.3.4 已安装
+✅ AccessToken 已写入配置
+✅ xiaoyou channel 已启用
+✅ dmSecurity 设为 open
+✅ blockStreaming 已配置
+❌ Gateway 重启失败：请手动执行 openclaw gateway restart
+```
+
+## 执行确认清单
+
+配置完成前，必须确认以下各项已执行：
+
+- [ ] 卸载旧版本（第一步）
+- [ ] 安装新版本（第二步）
+- [ ] 插件安装状态确认（openclaw plugins list）
+- [ ] Channel 配置写入确认
+- [ ] Gateway 重启确认
+- [ ] 按格式输出结论摘要
+
 ## 失败处理
 
-如果脚本执行失败，优先让用户提供完整 `[xiaoyou-install]` 日志。常见判断：
+如果脚本执行失败，优先查看完整 `[xiaoyou-install]` 日志输出。常见判断：
 
 | 日志现象 | 处理 |
 |----------|------|
 | 缺少 `--token` | 要求用户提供企业服务认证 Token |
 | 未检测到 OpenClaw | 提示用户先安装并启动 OpenClaw |
-| npm latest 查询失败 | 可让脚本继续幂等安装，或指定 `--version` |
-| wsUrl 格式不合�?| 地址必须�?`ws://` �?`wss://` 开�?|
+| npm 提示 404 / not found | 执行 `npm config set registry https://registry.npmmirror.com` 后重试 |
+| wsUrl 格式不合法 | 地址必须以 `ws://` 或 `wss://` 开头 |
 
-## 脚本做了什�?
+## 排障流程
 
-1. 检�?OpenClaw 是否已安装并运行
-2. 安装/升级 `openclaw-xiaoyou` 插件（`openclaw plugins install openclaw-xiaoyou@latest`�?
-3. 写入 channel 配置�?`~/.openclaw/openclaw.json`�?
-   - `channels.xiaoyou.enabled = true`
-   - `channels.xiaoyou.wsUrl = <用户提供的地址>`
-   - `channels.xiaoyou.authToken = <用户提供�?token>`
-   - `channels.xiaoyou.dmSecurity = open`
-4. 检查插件状态和 gateway 运行状�?
+当安装脚本失败或安装后连接异常时，按以下流程排查：
 
-## 完成定义
+### 检查前置条件
+
+```bash
+openclaw --version
+openclaw gateway status
+openclaw plugins list
+```
+
+### 安装时找不到插件
+
+```bash
+npm config set registry https://registry.npmmirror.com
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token <AccessToken>
+```
+
+### WebSocket 连接不上
+
+```bash
+tail -n 100 ~/.openclaw/logs/xiaoyou.log
+```
+
+| 现象 | 原因 | 处理 |
+|------|------|------|
+| `invalid or expired token` | Token 无效或已过期 | 重新申请 Token |
+| `token already connected` | 同一 Token 已有其他连接 | 断开旧连接或申请新 Token |
+| 连接超时 | 网络不通或防火墙拦截 | 确认 11055 端口可达 |
+| `ECONNREFUSED` | 企业服务未启动 | 确认 ai-websocket 服务正常 |
+
+### 手动清理（仅脚本卸载失败时使用）
+
+```bash
+openclaw config unset channels.xiaoyou
+openclaw config unset plugins.entries.openclaw-xiaoyou
+openclaw config unset plugins.installs.openclaw-xiaoyou
+rm -rf ~/.openclaw/extensions/xiaoyou
+rm -rf ~/.openclaw/extensions/openclaw-xiaoyou
+rm -rf ~/.openclaw/extensions/.openclaw-*
+openclaw gateway restart
+```
 
-- 脚本退出码�?0�?
-- 日志显示安装、升级或卸载流程完成�?
-- 安装场景下，`openclaw xiaoyou status` 显示 connected�?
-- 企业服务端能收到来自 xiaoyou 插件�?WebSocket 连接�?
+### 更换 Token
+
+```bash
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw --token <新Token>
+```
+
+### 常用命令清单
+
+```bash
+openclaw --version
+openclaw plugins list
+openclaw gateway status
+cat ~/.openclaw/openclaw.json | python3 -m json.tool
+tail -n 100 ~/.openclaw/logs/xiaoyou.log
+tail -f ~/.openclaw/logs/xiaoyou.log
+openclaw gateway restart
+```

package/docs/communication-flow.md

@@ -347,7 +347,9 @@ xiaoyou 插件采用 **Bridge 模式**：由插件主动向企业服务发起 We
   "text": "项目 Alpha 当前进度 85%，预计下周三完成。",
   "mediaUrls": ["https://openclaw-local/media/chart.png"],
   "agentId": "main",
-  "timestamp": 1730000000000
+  "timestamp": 1730000000000,
+  "streamStatus": "chunk",
+  "seq": 1
 }
 ```
 
@@ -356,10 +358,12 @@ xiaoyou 插件采用 **Bridge 模式**：由插件主动向企业服务发起 We
 | conversationId | string | 对应入站消息的会话 ID |
 | messageId | string | 回复消息的唯一 ID（由插件生成） |
 | replyToMessageId | string? | 对应入站 message 的 messageId，用于请求-回复一一绑定 |
-| text | string | 回复文本 |
+| text | string | 回复文本（chunk 时为增量，end 时为完整文本） |
 | mediaUrls | string[]? | 附带的媒体文件 URL |
 | agentId | string? | 处理该消息的 Agent ID |
 | timestamp | number | 毫秒时间戳 |
+| streamStatus | string? | 流式标记：`"chunk"`=增量片段，`"end"`=流结束，不传=一次性完整回复 |
+| seq | number? | 片段序号（从 1 开始），仅 streamStatus="chunk" 时有值 |
 
 #### ping / pong
 
@@ -596,7 +600,145 @@ async def on_user_message(ws, user_msg):
 - xiaoyou 的重连机制可以应对单节点故障
 ```
 
-## 10. 快速对照表
+## 10. 流式推送（Block Streaming）
+
+### 10.1 流式机制概述
+
+xiaoyou 插件支持流式推送 LLM 回复，实现"边生成边推送"的效果。
+企业服务端可以实时展示 Agent 正在生成的内容，而非等待完整回复。
+
+```
+  LLM 生成过程          xiaoyou 插件                    企业服务端
+     │                      │                              │
+     │  block 1 生成完毕    │                              │
+     │─────────────────────▶│  reply (chunk, seq=1)        │
+     │                      │─────────────────────────────▶│  实时展示
+     │                      │                              │
+     │  block 2 生成完毕    │                              │
+     │─────────────────────▶│  reply (chunk, seq=2)        │
+     │                      │─────────────────────────────▶│  追加展示
+     │                      │                              │
+     │  block 3 生成完毕    │                              │
+     │─────────────────────▶│  reply (chunk, seq=3)        │
+     │                      │─────────────────────────────▶│  追加展示
+     │                      │                              │
+     │  全部生成完毕        │                              │
+     │─────────────────────▶│  reply (end)                 │
+     │                      │─────────────────────────────▶│  渲染完成
+     │                      │                              │
+```
+
+### 10.2 流式帧格式
+
+流式回复统一使用 `type: "reply"`，通过 `streamStatus` 字段区分：
+
+#### chunk 帧（增量片段）
+
+```json
+{
+  "type": "reply",
+  "conversationId": "conv-123",
+  "messageId": "xiaoyou-1730000000000",
+  "replyToMessageId": "msg-001",
+  "text": "今天天气晴，",
+  "streamStatus": "chunk",
+  "seq": 1,
+  "timestamp": 1730000000001
+}
+```
+
+#### end 帧（流结束）
+
+```json
+{
+  "type": "reply",
+  "conversationId": "conv-123",
+  "messageId": "xiaoyou-1730000000000",
+  "replyToMessageId": "msg-001",
+  "text": "今天天气晴，气温25度，适合外出。",
+  "streamStatus": "end",
+  "timestamp": 1730000000500
+}
+```
+
+#### 非流式帧（向后兼容）
+
+```json
+{
+  "type": "reply",
+  "conversationId": "conv-123",
+  "messageId": "xiaoyou-1730000000000",
+  "text": "完整回复内容",
+  "timestamp": 1730000000000
+}
+```
+
+### 10.3 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| streamStatus | `"chunk"` \| `"end"` \| 不传 | chunk=增量片段，end=流结束（text 为完整文本），不传=一次性完整回复 |
+| seq | number | 片段序号，从 1 开始递增，仅 chunk 帧有值 |
+| messageId | string | 同一次回复的所有 chunk 和 end 帧共享相同的 messageId |
+| text | string | chunk 时为增量文本，end 时为完整文本 |
+
+### 10.4 企业服务端处理逻辑
+
+```python
+elif frame["type"] == "reply":
+    stream_status = frame.get("streamStatus")
+
+    if stream_status == "chunk":
+        # 流式片段 — 追加到缓冲区，实时推送给前端
+        append_to_buffer(
+            message_id=frame["messageId"],
+            delta=frame["text"],
+            seq=frame["seq"]
+        )
+        push_partial_to_user(frame["conversationId"], frame["text"])
+
+    elif stream_status == "end":
+        # 流结束 — 可用 text 校验拼接结果，完成渲染
+        finalize_reply(
+            message_id=frame["messageId"],
+            full_text=frame["text"],
+            media_urls=frame.get("mediaUrls", [])
+        )
+
+    else:
+        # 非流式 — 一次性完整回复（向后兼容）
+        deliver_to_user(
+            conversation_id=frame["conversationId"],
+            text=frame["text"],
+            media_urls=frame.get("mediaUrls", [])
+        )
+```
+
+### 10.5 流式配置（OpenClaw Gateway 侧）
+
+| 配置项 | 值 | 说明 |
+|--------|-----|------|
+| `agents.defaults.blockStreamingDefault` | `"on"` | 全局开启 block streaming |
+| `agents.defaults.blockStreamingBreak` | `"text_end"` | 每个 text block 结束就推送 |
+| `agents.defaults.blockStreamingChunk.minChars` | `1` | 不等积累，有内容就推 |
+| `agents.defaults.blockStreamingChunk.maxChars` | `20` | 每 20 字符触发一次推送（约 10 个汉字） |
+| `agents.defaults.blockStreamingCoalesce.minChars` | `1` | 不合并小片段 |
+| `agents.defaults.blockStreamingCoalesce.maxChars` | `20` | 合并上限 20 字符 |
+| `agents.defaults.blockStreamingCoalesce.idleMs` | `30` | 30ms 无新内容就立即 flush |
+| `channels.xiaoyou.blockStreaming` | `true` | xiaoyou channel 启用流式 |
+
+### 10.6 拆分规则
+
+插件在收到 Gateway 推送的每个 block 后，会按以下规则进一步拆分为更细的 chunk：
+
+- 中文标点：`。` `！` `？` `；`
+- 英文标点后跟空格：`. ` `! ` `? ` `; `
+- 换行符：`\n`
+
+每个拆分出的片段作为独立的 chunk 帧推送，保证企业服务端能逐句展示。
+
+
+## 11. 快速对照表
 
 | 你想知道... | 看这里 |
 |------------|--------|
@@ -610,3 +752,4 @@ async def on_user_message(ws, user_msg):
 | 出了问题怎么处理？ | §7 异常处理与容错 |
 | 企业侧要实现什么？ | §8 企业服务端实现要点 |
 | 怎么部署？ | §9 部署拓扑 |
+| 流式推送怎么用？ | §10 流式推送 |

package/docs/install-xiaoyou.sh

@@ -332,45 +332,56 @@ patch_config() {
     die "配置文件不存在: $config_file"
   fi
 
-  # 使用 python3 直接写入配置，绕过 openclaw config set 的 channel id 校验
-  python3 -c "
-import json, sys
+  # 使用 node 直接写入配置（OpenClaw 依赖 node，必定存在）
+  node -e "
+const fs = require('fs');
+const configFile = '$config_file';
+const wsUrl = '$WS_URL';
+const token = '$TOKEN';
+
+let cfg;
+try {
+  cfg = JSON.parse(fs.readFileSync(configFile, 'utf8'));
+} catch (e) {
+  console.error('[xiaoyou-install][error] 无法读取配置文件: ' + e.message);
+  process.exit(1);
+}
 
-config_file = '$config_file'
-ws_url = '$WS_URL'
-token = '$TOKEN'
-
-try:
-    with open(config_file, 'r') as f:
-        cfg = json.load(f)
-except Exception as e:
-    print(f'[xiaoyou-install][error] 无法读取配置文件: {e}', file=sys.stderr)
-    sys.exit(1)
-
-# 确保 channels 对象存在
-cfg.setdefault('channels', {})
-
-# 写入 xiaoyou channel 配置
-xiaoyou = cfg['channels'].get('xiaoyou', {})
-xiaoyou['enabled'] = True
-if ws_url:
-    xiaoyou['wsUrl'] = ws_url
-if token:
-    xiaoyou['authToken'] = token
-xiaoyou.setdefault('dmSecurity', 'open')
-xiaoyou.setdefault('allowFrom', ['*'])
-xiaoyou.setdefault('reconnectIntervalMs', 3000)
-xiaoyou.setdefault('heartbeatIntervalMs', 30000)
-xiaoyou.setdefault('heartbeatTimeoutMs', 10000)
-cfg['channels']['xiaoyou'] = xiaoyou
-
-try:
-    with open(config_file, 'w') as f:
-        json.dump(cfg, f, indent=2, ensure_ascii=False)
-    print('[xiaoyou-install] 配置写入成功')
-except Exception as e:
-    print(f'[xiaoyou-install][error] 写入配置失败: {e}', file=sys.stderr)
-    sys.exit(1)
+// 确保 channels 对象存在
+if (!cfg.channels) cfg.channels = {};
+
+// 写入 xiaoyou channel 配置
+const xiaoyou = cfg.channels.xiaoyou || {};
+xiaoyou.enabled = true;
+if (wsUrl) xiaoyou.wsUrl = wsUrl;
+if (token) xiaoyou.authToken = token;
+if (!xiaoyou.dmSecurity) xiaoyou.dmSecurity = 'open';
+if (!xiaoyou.allowFrom) xiaoyou.allowFrom = ['*'];
+if (!xiaoyou.reconnectIntervalMs) xiaoyou.reconnectIntervalMs = 3000;
+if (!xiaoyou.heartbeatIntervalMs) xiaoyou.heartbeatIntervalMs = 30000;
+if (!xiaoyou.heartbeatTimeoutMs) xiaoyou.heartbeatTimeoutMs = 10000;
+// 开启 block streaming（仅 xiaoyou channel）
+xiaoyou.blockStreaming = true;
+xiaoyou.blockStreamingChunk = { minChars: 1, maxChars: 20 };
+xiaoyou.blockStreamingCoalesce = { minChars: 1, maxChars: 20, idleMs: 30 };
+cfg.channels.xiaoyou = xiaoyou;
+
+// 同时写入 agents.defaults 作为全局 fallback（确保流式生效）
+if (!cfg.agents) cfg.agents = {};
+if (!cfg.agents.defaults) cfg.agents.defaults = {};
+const defaults = cfg.agents.defaults;
+if (!defaults.blockStreamingDefault) defaults.blockStreamingDefault = 'on';
+if (!defaults.blockStreamingBreak) defaults.blockStreamingBreak = 'text_end';
+if (!defaults.blockStreamingChunk) defaults.blockStreamingChunk = { minChars: 1, maxChars: 20 };
+if (!defaults.blockStreamingCoalesce) defaults.blockStreamingCoalesce = { minChars: 1, maxChars: 20, idleMs: 30 };
+
+try {
+  fs.writeFileSync(configFile, JSON.stringify(cfg, null, 2));
+  console.log('[xiaoyou-install] 配置写入成功');
+} catch (e) {
+  console.error('[xiaoyou-install][error] 写入配置失败: ' + e.message);
+  process.exit(1);
+}
 " || die "写入配置失败"
 
   log "已写入配置: $config_file"

package/docs/user-comand.md

@@ -1,25 +1,25 @@
 
-# 小优 Channel 安装话术与部署路径
+# 小优 Channel 安装话术与部署路�?
 
 ## 安装话术
 
-按照 https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh 文档完成小优channel配置，AccessToken为xiaoyou-025b07e43ae84cd6
+按照 https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh 文档完成小优channel配置，AccessToken为xiaoyou-025b07e43ae84cd6
 
 ## 脚本位置
 
-https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh
+https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh
 
 ## 卸载+重装命令
 
 ```bash
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- uninstall && \
-curl -fsSL https://d10.tfdl.net/public/2026-05-06/14dbf63d-d0aa-4b5d-bdd6-47eddb455f36/install-xiaoyou.sh | bash -s -- \
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- uninstall && \
+curl -fsSL https://d10.tfdl.net/public/2026-05-08/7c0c5f98-9ee5-47ee-8dd9-54b12dbe8f4d/install-xiaoyou.sh | bash -s -- \
   --version 1.2.5 \
   --ws-url ws://aiws-sim.haiersmarthomes.com:11055/xiaoyou/claw \
   --token xiaoyou-025b07e43ae84cd6
 ```
 
-## 验证发消息
+## 验证发消�?
 
 ```bash
 curl -X POST http://172.16.4.35:11480/ai-connection/xiaoyou/message/send \
@@ -46,11 +46,11 @@ journalctl --user -u openclaw-gateway.service --since "2 min ago" --no-pager | g
 
 ## 部署路径
 
-验收环境位置：
+验收环境位置�?
 /aiysnfs/nginx/share/skills/upload/claw
 
-仿真环境位置：
+仿真环境位置�?
 /ai-sim/export/nginx/share/skills/upload/claw
 
-生产环境位置：
+生产环境位置�?
 /ai-prod/export/nginx/share/skills/upload/claw

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-xiaoyou",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "description": "Xiaoyou channel plugin for OpenClaw — connects enterprise services via persistent outbound WebSocket",
   "openclaw": {

package/src/channel.ts

@@ -23,13 +23,12 @@ export function getRuntime() { return _runtime; }
  * 每个片段以标点或换行结尾（保留标点在片段内）。
  */
 function splitBySentence(text: string): string[] {
-  // 匹配：中文标点（。！？；）、英文标点（.!?;）后跟空格或结尾、换行符
-  const parts = text.split(/(?<=[。！？；\n])|(?<=[.!?;]\s)/);
+  // 匹配：中文标点（。！？；，：）、英文标点（.!?;,:）后跟空格或结尾、换行符
+  const parts = text.split(/(?<=[。！？；，：\n])|(?<=[.!?;,:]\s)/);
   const result: string[] = [];
   for (const part of parts) {
-    const trimmed = part;
-    if (trimmed.length > 0) {
-      result.push(trimmed);
+    if (part.length > 0) {
+      result.push(part);
     }
   }
   return result.length > 0 ? result : [text];
@@ -205,7 +204,7 @@ export const xiayouPlugin = {
           // 我们在 deliver 内部进一步按标点/换行拆分，实现更细粒度的流式推送。
           //
           const replyMessageId = `xiaoyou-${Date.now()}`;
-          let chunkSeq = 0;
+          let chunkSeq = 1;
           let fullText = "";
           let replyEndSent = false;
 
@@ -257,7 +256,7 @@ export const xiayouPlugin = {
           });
 
           // dispatch resolve 后，如果 onComplete 未被调用（兼容），手动发 end
-          if (!replyEndSent && chunkSeq > 0 && _client && _client.isConnected()) {
+          if (!replyEndSent && chunkSeq > 1 && _client && _client.isConnected()) {
             _client.sendReply({
               type: "reply",
               conversationId,
@@ -268,7 +267,7 @@ export const xiayouPlugin = {
               timestamp: Date.now(),
             });
             logger.info(`[xiaoyou] stream end (fallback) sent to ${conversationId} (${chunkSeq} chunks)${inboundMessageId ? ` (replyTo=${inboundMessageId})` : ""}`);
-          } else if (chunkSeq === 0) {
+          } else if (chunkSeq === 1) {
             logger.warn(`[xiaoyou] no reply generated for ${conversationId}`);
           }
         },

package/docs/xiaoyou-plugin-architecture.svg

@@ -1,93 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 920" font-family="'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif">
-  <defs>
-    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="10" refY="3.5" orient="auto">
-      <polygon points="0 0, 10 3.5, 0 7" fill="#555"/>
-    </marker>
-    <filter id="shadow" x="-2%" y="-2%" width="104%" height="104%">
-      <feDropShadow dx="2" dy="2" stdDeviation="3" flood-opacity="0.1"/>
-    </filter>
-  </defs>
-
-  <!-- 外框 -->
-  <rect x="30" y="20" width="840" height="880" rx="16" fill="#f8fafc" stroke="#94a3b8" stroke-width="2" filter="url(#shadow)"/>
-  <text x="450" y="55" text-anchor="middle" font-size="20" font-weight="bold" fill="#1e293b">xiaoyou 插件内部架构</text>
-
-  <!-- index.ts 模块 -->
-  <rect x="60" y="80" width="780" height="180" rx="12" fill="#ffffff" stroke="#3b82f6" stroke-width="2" filter="url(#shadow)"/>
-  <rect x="60" y="80" width="780" height="36" rx="12" fill="#3b82f6"/>
-  <rect x="60" y="104" width="780" height="12" fill="#3b82f6"/>
-  <text x="80" y="104" font-size="14" font-weight="bold" fill="#ffffff">index.ts (入口)</text>
-
-  <text x="90" y="145" font-size="13" fill="#334155" font-family="'Consolas', 'Courier New', monospace">register(api) {</text>
-  <text x="110" y="170" font-size="13" fill="#334155" font-family="'Consolas', 'Courier New', monospace">setRuntime(api.runtime)</text>
-  <text x="430" y="170" font-size="12" fill="#6366f1">──▶ 注入 runtime 引用</text>
-  <text x="110" y="195" font-size="13" fill="#334155" font-family="'Consolas', 'Courier New', monospace">api.registerChannel()</text>
-  <text x="430" y="195" font-size="12" fill="#6366f1">──▶ 注册到 PluginRegistry</text>
-  <text x="110" y="220" font-size="13" fill="#334155" font-family="'Consolas', 'Courier New', monospace">api.registerCli()</text>
-  <text x="430" y="220" font-size="12" fill="#6366f1">──▶ 注册 CLI 子命令</text>
-  <text x="90" y="245" font-size="13" fill="#334155" font-family="'Consolas', 'Courier New', monospace">}</text>
-
-  <!-- 箭头: index -> channel -->
-  <line x1="450" y1="260" x2="450" y2="295" stroke="#555" stroke-width="2" marker-end="url(#arrowhead)"/>
-
-  <!-- channel.ts 模块 -->
-  <rect x="60" y="300" width="780" height="320" rx="12" fill="#ffffff" stroke="#10b981" stroke-width="2" filter="url(#shadow)"/>
-  <rect x="60" y="300" width="780" height="36" rx="12" fill="#10b981"/>
-  <rect x="60" y="324" width="780" height="12" fill="#10b981"/>
-  <text x="80" y="324" font-size="14" font-weight="bold" fill="#ffffff">channel.ts (ChannelPlugin)</text>
-
-  <!-- config 区域 -->
-  <text x="90" y="365" font-size="13" font-weight="bold" fill="#1e293b">config</text>
-  <text x="170" y="365" font-size="12" fill="#6366f1">──▶ listAccountIds / resolveAccount / isConfigured / describeAccount</text>
-
-  <!-- security 区域 -->
-  <text x="90" y="395" font-size="13" font-weight="bold" fill="#1e293b">security</text>
-  <text x="170" y="395" font-size="12" fill="#6366f1">──▶ DM 策略 (默认 open，允许所有用户)</text>
-
-  <!-- gateway 区域 -->
-  <text x="90" y="430" font-size="13" font-weight="bold" fill="#1e293b">gateway.startAccount(ctx)</text>
-  <text x="110" y="455" font-size="12" fill="#475569">1. 从 ctx.account.config 读取 wsUrl / authToken</text>
-  <text x="110" y="478" font-size="12" fill="#475569">2. 创建 EnterpriseClient 并连接</text>
-  <text x="110" y="501" font-size="12" fill="#475569">3. onMessage 收到消息时：</text>
-  <text x="140" y="521" font-size="11" fill="#64748b" font-family="'Consolas', 'Courier New', monospace">rt.channel.routing.resolveAgentRoute()</text>
-  <text x="140" y="539" font-size="11" fill="#64748b" font-family="'Consolas', 'Courier New', monospace">rt.channel.reply.formatInboundEnvelope()</text>
-  <text x="140" y="557" font-size="11" fill="#64748b" font-family="'Consolas', 'Courier New', monospace">rt.channel.reply.finalizeInboundContext()</text>
-  <text x="140" y="575" font-size="11" fill="#64748b" font-family="'Consolas', 'Courier New', monospace">rt.channel.reply.dispatchReplyWith...()</text>
-  <text x="110" y="598" font-size="12" fill="#475569">4. deliver() 回调将 LLM 回复通过 WebSocket 发出</text>
-
-  <!-- outbound & status -->
-  <text x="90" y="555" font-size="13" font-weight="bold" fill="#1e293b" transform="translate(520, -195)">outbound</text>
-  <text x="170" y="555" font-size="12" fill="#6366f1" transform="translate(520, -195)">──▶ 将主动推送通过</text>
-  <text x="170" y="573" font-size="12" fill="#6366f1" transform="translate(520, -195)">     EnterpriseClient 发出</text>
-
-  <text x="90" y="598" font-size="13" font-weight="bold" fill="#1e293b" transform="translate(520, -195)">status</text>
-  <text x="170" y="598" font-size="12" fill="#6366f1" transform="translate(520, -195)">──▶ 报告连接健康状态</text>
-
-  <!-- 箭头: channel -> enterprise-client -->
-  <line x1="450" y1="620" x2="450" y2="655" stroke="#555" stroke-width="2" marker-end="url(#arrowhead)"/>
-
-  <!-- enterprise-client.ts 模块 -->
-  <rect x="60" y="660" width="780" height="220" rx="12" fill="#ffffff" stroke="#f59e0b" stroke-width="2" filter="url(#shadow)"/>
-  <rect x="60" y="660" width="780" height="36" rx="12" fill="#f59e0b"/>
-  <rect x="60" y="684" width="780" height="12" fill="#f59e0b"/>
-  <text x="80" y="684" font-size="14" font-weight="bold" fill="#ffffff">enterprise-client.ts (WebSocket 连接管理)</text>
-
-  <text x="90" y="725" font-size="13" font-weight="bold" fill="#1e293b">connect()</text>
-  <text x="260" y="725" font-size="12" fill="#6366f1">──▶ 建立 WebSocket → 发送 auth</text>
-
-  <text x="90" y="755" font-size="13" font-weight="bold" fill="#1e293b">handleFrame()</text>
-  <text x="260" y="755" font-size="12" fill="#6366f1">──▶ 解析 JSON 帧 → 分发到对应处理器</text>
-
-  <text x="90" y="785" font-size="13" font-weight="bold" fill="#1e293b">startHeartbeat()</text>
-  <text x="260" y="785" font-size="12" fill="#6366f1">──▶ 定时 ping，超时触发重连</text>
-
-  <text x="90" y="815" font-size="13" font-weight="bold" fill="#1e293b">scheduleReconnect()</text>
-  <text x="260" y="815" font-size="12" fill="#6366f1">──▶ 指数退避重连</text>
-
-  <text x="90" y="845" font-size="13" font-weight="bold" fill="#1e293b">sendReply()</text>
-  <text x="260" y="845" font-size="12" fill="#6366f1">──▶ 发送出站 reply 帧</text>
-
-  <text x="90" y="875" font-size="13" font-weight="bold" fill="#1e293b">disconnect()</text>
-  <text x="260" y="875" font-size="12" fill="#6366f1">──▶ 优雅关闭</text>
-</svg>