npm - ddchat - Versions diffs - 0.1.0 - Mend

ddchat 0.1.0

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.

Files changed (23) hide show

package/task/TODO.md ADDED Viewed

@@ -0,0 +1,10 @@
+# TODO
+- [ ] Finalize plugin skeleton (`package.json`, `openclaw.plugin.json`, `index.ts`, `setup-entry.ts`)
+- [ ] Implement Feishu-style multi-account config (`channels.ddchat.accounts.*`)
+- [ ] Implement websocket inbound loop (webhook reserved only)
+- [ ] Implement inbound routing for `group` (groupId) and `direct` (userId)
+- [ ] Implement inbound text + file/image handling (base64/url -> saveMediaBuffer)
+- [ ] Implement chunk-level streaming push; keep token-level mode as reserved option
+- [ ] Add compatibility notes for future plugin rename
+- [ ] Add minimal tests for route/media parsing and duplicate suppression

package/test/README.md ADDED Viewed

@@ -0,0 +1,48 @@
+# DDChat Local Mock IM
+Local WebSocket IM simulator for testing the `ddchat` plugin.
+## Start
+From repo root:
+```bash
+node ddchat/test/server.mjs
+```
+Then open:
+- UI: `http://127.0.0.1:9020`
+- WS endpoint for plugin: `ws://127.0.0.1:9001` (override plugin `constants.ts` for local dev, or run against your mock URL)
+## Plugin config example
+```json
+{
+  "channels": {
+    "ddchat": {
+      "defaultAccount": "xkx",
+      "accounts": {
+        "xkx": {
+          "enabled": true,
+          "token": "your-plugin-token",
+          "connectionMode": "websocket",
+          "wsUrl": "ws://127.0.0.1:9001",
+          "dmPolicy": "open",
+          "groupPolicy": "open",
+          "requireMention": false,
+          "streaming": true,
+          "streamingMode": "chunk"
+        }
+      }
+    }
+  }
+}
+```
+## Features
+- Send direct/group inbound message payloads.
+- Upload files/images from browser (sent as base64 in `files[]`).
+- Optional URL-based file input.
+- View stream chunks (`stream_chunk`) and final outbound messages.

package/test/chat.html ADDED Viewed

@@ -0,0 +1,304 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>DDChat Mock IM Chat</title>
+    <style>
+      body {
+        font-family: Consolas, Menlo, monospace;
+        background: #0b1020;
+        color: #d4ddff;
+        margin: 0;
+      }
+      .wrap {
+        max-width: 1080px;
+        margin: 24px auto;
+        padding: 0 16px;
+      }
+      h1 {
+        font-size: 18px;
+        margin: 0 0 12px;
+      }
+      .panel {
+        background: #121a33;
+        border: 1px solid #24315f;
+        border-radius: 10px;
+        padding: 12px;
+        margin-bottom: 12px;
+      }
+      label {
+        font-size: 12px;
+        color: #9fb1f1;
+        display: block;
+        margin-bottom: 4px;
+      }
+      input,
+      textarea,
+      button,
+      select {
+        width: 100%;
+        box-sizing: border-box;
+        border-radius: 8px;
+        border: 1px solid #2f3e74;
+        background: #0f1630;
+        color: #d4ddff;
+        padding: 8px;
+      }
+      textarea {
+        min-height: 80px;
+      }
+      .row {
+        display: grid;
+        gap: 8px;
+        grid-template-columns: repeat(4, 1fr);
+      }
+      .row-3 {
+        display: grid;
+        gap: 8px;
+        grid-template-columns: repeat(3, 1fr);
+      }
+      .log {
+        height: 220px;
+        overflow: auto;
+        background: #090e1f;
+        border: 1px solid #24315f;
+        border-radius: 8px;
+        padding: 8px;
+        white-space: pre-wrap;
+        line-height: 1.35;
+      }
+      .btn {
+        background: #2442ad;
+        cursor: pointer;
+      }
+      .chat {
+        height: 320px;
+        overflow: auto;
+        background: #090e1f;
+        border: 1px solid #24315f;
+        border-radius: 8px;
+        padding: 10px;
+        margin-bottom: 12px;
+      }
+      .msg {
+        margin: 8px 0;
+        padding: 8px 10px;
+        border-radius: 10px;
+        max-width: 86%;
+        white-space: pre-wrap;
+      }
+      .msg.user {
+        margin-left: auto;
+        background: #1e3b87;
+      }
+      .msg.assistant {
+        margin-right: auto;
+        background: #1e2750;
+      }
+      .msg.done {
+        border: 1px solid #3954b3;
+      }
+      .meta {
+        margin-top: 6px;
+        font-size: 12px;
+        color: #9fb1f1;
+      }
+      .preview {
+        margin-top: 8px;
+        border: 1px solid #2f3e74;
+        border-radius: 8px;
+        padding: 8px;
+        background: #0f1630;
+      }
+      .preview img {
+        max-width: 280px;
+        max-height: 220px;
+        border-radius: 6px;
+        display: block;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="wrap">
+      <h1>DDChat Mock IM (WebSocket)</h1>
+      <div class="panel row">
+        <div>
+          <label>Account ID</label>
+          <input id="accountId" value="xkx" />
+        </div>
+        <div>
+          <label>Chat Type</label>
+          <select id="chatType">
+            <option value="direct">direct</option>
+            <option value="group">group</option>
+          </select>
+        </div>
+        <div>
+          <label>User ID</label>
+          <input id="userId" value="u-1001" />
+        </div>
+        <div>
+          <label>Group ID (group 模式必填)</label>
+          <input id="groupId" value="g-1001" />
+        </div>
+      </div>
+      <div class="panel row-3">
+        <div>
+          <label>Message ID</label>
+          <input id="messageId" value="" placeholder="默认自动生成" />
+        </div>
+        <div>
+          <label>文件上传（支持多选）</label>
+          <input id="fileInput" type="file" multiple />
+        </div>
+        <div>
+          <label>或填远程文件 URL（可选）</label>
+          <input id="mediaUrl" placeholder="https://example.com/photo.png" />
+        </div>
+      </div>
+      <div class="panel">
+        <label>Text</label>
+        <textarea id="text">请介绍一下你自己，并分三段回答。</textarea>
+        <button class="btn" id="sendBtn">Send inbound_message</button>
+      </div>
+      <div class="panel">
+        <div id="status">Connecting to ws://127.0.0.1:9001 ...</div>
+        <div class="chat" id="chat"></div>
+        <div class="log" id="log"></div>
+      </div>
+    </div>
+    <script>
+      const ws = new WebSocket("ws://127.0.0.1:9001/?role=ui");
+      const log = document.getElementById("log");
+      const chat = document.getElementById("chat");
+      const status = document.getElementById("status");
+      const streamMap = new Map();
+      const append = (line) => {
+        const now = new Date().toISOString();
+        log.textContent += `[${now}] ${line}\n`;
+        log.scrollTop = log.scrollHeight;
+      };
+      const addUserMessage = (payload) => {
+        const div = document.createElement("div");
+        div.className = "msg user";
+        div.textContent = payload.text || "(empty text)";
+        const meta = document.createElement("div");
+        meta.className = "meta";
+        meta.textContent = `account=${payload.accountId} | ${payload.chatType}:${payload.chatType === "group" ? payload.groupId : payload.userId} | files=${payload.files?.length || 0}`;
+        div.appendChild(meta);
+        chat.appendChild(div);
+        chat.scrollTop = chat.scrollHeight;
+      };
+      const addAssistantMessage = (payload) => {
+        const div = document.createElement("div");
+        div.className = "msg assistant";
+        const text = payload.text || "(no text)";
+        div.textContent = text;
+        if (payload.mediaUrl) {
+          const preview = document.createElement("div");
+          preview.className = "preview";
+          const link = document.createElement("a");
+          link.href = payload.mediaUrl;
+          link.target = "_blank";
+          link.rel = "noreferrer";
+          link.textContent = `media: ${payload.mediaUrl}`;
+          link.style.color = "#9bc4ff";
+          preview.appendChild(link);
+          div.appendChild(preview);
+        }
+        chat.appendChild(div);
+        chat.scrollTop = chat.scrollHeight;
+      };
+      const upsertAssistantStream = (payload) => {
+        const key = payload.streamId || `stream-${Date.now()}`;
+        let node = streamMap.get(key);
+        if (!node) {
+          node = document.createElement("div");
+          node.className = "msg assistant";
+          node.textContent = "";
+          chat.appendChild(node);
+          streamMap.set(key, node);
+        }
+        node.textContent = payload.fullText || node.textContent + (payload.delta || "");
+        if (payload.done) {
+          node.classList.add("done");
+          const meta = document.createElement("div");
+          meta.className = "meta";
+          meta.textContent = `stream done | mode=${payload.mode || "chunk"}`;
+          node.appendChild(meta);
+        }
+        chat.scrollTop = chat.scrollHeight;
+      };
+      ws.addEventListener("open", () => {
+        status.textContent = "Connected";
+        append("connected");
+      });
+      ws.addEventListener("close", () => {
+        status.textContent = "Disconnected";
+        append("disconnected");
+      });
+      ws.addEventListener("message", (ev) => {
+        append(`recv: ${ev.data}`);
+        try {
+          const data = JSON.parse(ev.data);
+          const payload = data?.payload || data;
+          if (payload?.type === "stream_chunk") {
+            upsertAssistantStream(payload);
+          }
+          if (payload?.type === "outbound_message") {
+            addAssistantMessage(payload);
+          }
+        } catch {}
+      });
+      async function fileToBase64(file) {
+        const buf = await file.arrayBuffer();
+        let binary = "";
+        const bytes = new Uint8Array(buf);
+        const chunkSize = 0x8000;
+        for (let i = 0; i < bytes.length; i += chunkSize) {
+          binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
+        }
+        return btoa(binary);
+      }
+      document.getElementById("sendBtn").addEventListener("click", async () => {
+        const fileInput = document.getElementById("fileInput");
+        const files = [];
+        for (const file of Array.from(fileInput.files || [])) {
+          files.push({
+            name: file.name,
+            type: file.type || "application/octet-stream",
+            base64: await fileToBase64(file),
+          });
+        }
+        const mediaUrl = document.getElementById("mediaUrl").value || "";
+        if (mediaUrl.trim()) {
+          files.push({
+            name: undefined,
+            type: undefined,
+            url: mediaUrl.trim(),
+          });
+        }
+        const payload = {
+          type: "inbound_message",
+          accountId: document.getElementById("accountId").value || "xkx",
+          chatType: document.getElementById("chatType").value === "group" ? "group" : "direct",
+          userId: document.getElementById("userId").value || "u-1001",
+          groupId: document.getElementById("groupId").value || undefined,
+          messageId: document.getElementById("messageId").value || `m-${Date.now()}`,
+          text: document.getElementById("text").value || "",
+          files: files.length > 0 ? files : undefined,
+        };
+        if (payload.chatType === "direct") {
+          delete payload.groupId;
+        }
+        addUserMessage(payload);
+        ws.send(JSON.stringify(payload));
+        append(`send: ${JSON.stringify({ ...payload, files: payload.files ? `[${payload.files.length} file(s)]` : undefined })}`);
+      });
+    </script>
+  </body>
+</html>

package/test/server.mjs ADDED Viewed

@@ -0,0 +1,143 @@
+import http from "node:http";
+import { readFile } from "node:fs/promises";
+import { WebSocketServer } from "ws";
+const HTTP_PORT = Number(process.env.DDCHAT_MOCK_HTTP_PORT ?? 9020);
+const WS_PORT = Number(process.env.DDCHAT_MOCK_WS_PORT ?? 9001);
+const clients = new Set();
+const uiClients = new Set();
+let pluginClient = null;
+const history = [];
+const server = http.createServer(async (req, res) => {
+  if (!req.url || req.url === "/") {
+    try {
+      const html = await readFile(new URL("./chat.html", import.meta.url), "utf-8");
+      res.statusCode = 200;
+      res.setHeader("Content-Type", "text/html; charset=utf-8");
+      res.end(html);
+      return;
+    } catch (error) {
+      res.statusCode = 500;
+      res.end(String(error));
+      return;
+    }
+  }
+  if (req.url === "/history") {
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "application/json; charset=utf-8");
+    res.end(JSON.stringify(history.slice(-300)));
+    return;
+  }
+  res.statusCode = 404;
+  res.end("not found");
+});
+server.listen(HTTP_PORT, () => {
+  console.log(`[ddchat-mock] ui: http://127.0.0.1:${HTTP_PORT}`);
+});
+const wss = new WebSocketServer({ port: WS_PORT });
+wss.on("connection", (ws, req) => {
+  clients.add(ws);
+  const role = new URL(req.url ?? "/", "http://localhost").searchParams.get("role");
+  const isUi = role === "ui";
+  if (isUi) {
+    uiClients.add(ws);
+    console.log("[ddchat-mock] ui connected");
+  } else {
+    pluginClient = ws;
+    console.log("[ddchat-mock] ddchat plugin connected");
+  }
+  ws.send(
+    JSON.stringify({
+      type: "hello",
+      role: "ddchat-mock",
+      ts: Date.now(),
+      peerRole: isUi ? "ui" : "plugin",
+    }),
+  );
+  ws.on("close", () => {
+    clients.delete(ws);
+    uiClients.delete(ws);
+    if (pluginClient === ws) {
+      pluginClient = null;
+      console.log("[ddchat-mock] ddchat plugin disconnected");
+    }
+  });
+  ws.on("message", (buf) => {
+    const text = buf.toString("utf-8");
+    let payload;
+    try {
+      payload = JSON.parse(text);
+    } catch {
+      payload = { type: "raw", text };
+    }
+    if (uiClients.has(ws)) {
+      history.push({ direction: "to_plugin", payload, ts: Date.now() });
+      if (pluginClient && pluginClient.readyState === 1) {
+        pluginClient.send(JSON.stringify(payload));
+      }
+      broadcastToUi({
+        type: "event",
+        event: "to_plugin",
+        payload,
+        ts: Date.now(),
+      });
+      return;
+    }
+    history.push({ direction: "from_plugin", payload, ts: Date.now() });
+    broadcastToUi({
+      type: "event",
+      event: "from_plugin",
+      payload,
+      ts: Date.now(),
+    });
+  });
+});
+console.log(`[ddchat-mock] websocket: ws://127.0.0.1:${WS_PORT}`);
+function broadcastToUi(data) {
+  const text = JSON.stringify(data);
+  for (const ws of uiClients) {
+    try {
+      ws.send(text);
+    } catch {}
+  }
+}
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+  const text = chunk.trim();
+  if (!text) return;
+  if (text === "help") {
+    console.log(
+      'stdin example: {"accountId":"xkx","chatType":"direct","userId":"u-1001","messageId":"m-1","text":"hello"}',
+    );
+    return;
+  }
+  try {
+    const payload = JSON.parse(text);
+    const message = {
+      type: "inbound_message",
+      accountId: payload.accountId ?? "xkx",
+      messageId: payload.messageId ?? `m-${Date.now()}`,
+      chatType: payload.chatType === "group" ? "group" : "direct",
+      userId: payload.userId ?? "u-1001",
+      groupId: payload.groupId,
+      text: payload.text ?? "",
+      files: Array.isArray(payload.files) ? payload.files : undefined,
+      ts: Date.now(),
+    };
+    history.push({ direction: "to_plugin", payload: message, ts: Date.now() });
+    broadcastToUi({ type: "event", event: "to_plugin", payload: message, ts: Date.now() });
+    if (pluginClient && pluginClient.readyState === 1) {
+      pluginClient.send(JSON.stringify(message));
+    }
+    console.log("[ddchat-mock] sent inbound_message");
+  } catch (error) {
+    console.error("[ddchat-mock] invalid json:", error);
+  }
+});