ylib-syim 0.0.1

package/scripts/example-iflow-agent.ts

@@ -0,0 +1,117 @@
+/**
+ * 示例：用 iflow 接口作为 Agent，所有 IM 消息对接该 agent
+ *
+ * 使用方式：
+ *   export IFLOW_API_KEY=sk-xxx
+ *   # 可选：export IFLOW_BASE_URL=http://92.113.117.22:10068/proxy/iflow
+ *   pnpm run example:iflow-agent
+ *
+ * 钉钉回发需同时设置 DINGTALK_CLIENT_ID、DINGTALK_CLIENT_SECRET。
+ * 测试：curl -X POST http://localhost:3100/inbound -H "Content-Type: application/json" -d '{"provider":"dingtalk","peer":{"kind":"direct","id":"YOUR_STAFF_ID"},"sender":{"id":"YOUR_STAFF_ID","name":"测试"},"messageId":"test-1","timestamp":1700000000000,"text":"你好"}'
+ */
+
+import http from "node:http";
+import {
+  createHubFromConfig,
+  createIflowAgent,
+  createDingTalkAdapter,
+  createInMemorySessionStore,
+  type InboundMessage,
+} from "../src/index.js";
+
+const PORT = Number(process.env.PORT) || 3100;
+
+if (!process.env.IFLOW_API_KEY) {
+  console.error("请设置环境变量 IFLOW_API_KEY");
+  process.exit(1);
+}
+
+const clientId = process.env.DINGTALK_CLIENT_ID;
+const clientSecret = process.env.DINGTALK_CLIENT_SECRET;
+
+const adapters: ReturnType<typeof createDingTalkAdapter>[] = [];
+if (clientId && clientSecret) {
+  adapters.push(createDingTalkAdapter({ config: { clientId, clientSecret } }));
+} else {
+  console.warn("未设置钉钉 clientId/secret，回复仅打印到控制台");
+  adapters.push({
+    provider: "dingtalk",
+    async send({ to, message }) {
+      console.log("[Mock] 回复:", message.text?.slice(0, 120));
+    },
+  });
+}
+
+const hub = createHubFromConfig({
+  defaultAgentId: "main",
+  agents: [
+    createIflowAgent({
+      id: "main",
+      systemPrompt: "你是助手。回复简洁友好。",
+      historyLimit: 20,
+    }),
+  ],
+  adapters,
+  bindings: [{ agentId: "main", match: { channel: "dingtalk" } }],
+  sessions: createInMemorySessionStore(),
+});
+
+function parseBody(req: http.IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    req.on("error", reject);
+  });
+}
+
+const server = http.createServer(async (req, res) => {
+  res.setHeader("Content-Type", "application/json; charset=utf-8");
+  if (req.method === "GET" && (req.url === "/" || req.url === "/health")) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ ok: true, agent: "iflow", port: PORT }));
+    return;
+  }
+  if (req.method === "POST" && req.url === "/inbound") {
+    let raw: string;
+    try {
+      raw = await parseBody(req);
+    } catch {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "Failed to read body" }));
+      return;
+    }
+    let input: InboundMessage;
+    try {
+      input = JSON.parse(raw) as InboundMessage;
+    } catch {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "Invalid JSON" }));
+      return;
+    }
+    if (!input.provider || !input.peer || input.text === undefined) {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "Missing provider, peer or text" }));
+      return;
+    }
+    try {
+      await hub.handleInbound(input);
+      res.writeHead(200);
+      res.end(JSON.stringify({ ok: true, text: input.text }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error("[example-iflow-agent] error:", err);
+      res.writeHead(500);
+      res.end(JSON.stringify({ error: msg }));
+    }
+    return;
+  }
+  res.writeHead(404);
+  res.end(JSON.stringify({ error: "Not found" }));
+});
+
+server.listen(PORT, () => {
+  console.log(`example-iflow-agent: http://localhost:${PORT}`);
+  console.log("  IFLOW_API_KEY 已设置，baseUrl 默认: " + (process.env.IFLOW_BASE_URL || "http://92.113.117.22:10068/proxy/iflow"));
+  console.log("  POST /inbound 测试，配置钉钉后回复会发到钉钉");
+});

package/scripts/example-single-agent.ts

@@ -0,0 +1,151 @@
+/**
+ * 示例：一个简单 agent 接收 im-agent-hub 中所有 IM 消息（钉钉 / 飞书等均路由到该 agent）
+ *
+ * 用于验证：createHubFromConfig + bindings 下，所有 channel 消息是否都能对接同一 agent。
+ *
+ * 使用方式：
+ *   1. 仅 HTTP 测试（不连真实钉钉）：不设 DINGTALK_*，会提示缺少配置但仍启动 HTTP，可用 mock adapter 或跳过 send。
+ *   2. 钉钉回发：设置 DINGTALK_CLIENT_ID、DINGTALK_CLIENT_SECRET 后启动，POST /inbound 的回复会发到钉钉。
+ *
+ * 启动：
+ *   cd packages/im-agent-hub
+ *   DINGTALK_CLIENT_ID=xxx DINGTALK_CLIENT_SECRET=yyy pnpm run example:single-agent
+ *
+ * 测试（替换 YOUR_STAFF_ID）：
+ *   curl -X POST http://localhost:3100/inbound -H "Content-Type: application/json" -d '{
+ *     "provider": "dingtalk",
+ *     "peer": { "kind": "direct", "id": "YOUR_STAFF_ID" },
+ *     "sender": { "id": "YOUR_STAFF_ID", "name": "测试" },
+ *     "messageId": "test-1",
+ *     "timestamp": 1700000000000,
+ *     "text": "你好"
+ *   }'
+ */
+
+import http from "node:http";
+import {
+  createHubFromConfig,
+  createDingTalkAdapter,
+  createInMemorySessionStore,
+  createLangChainLikeAgent,
+  type InboundMessage,
+} from "../src/index.js";
+
+const PORT = Number(process.env.PORT) || 3100;
+
+const clientId = process.env.DINGTALK_CLIENT_ID;
+const clientSecret = process.env.DINGTALK_CLIENT_SECRET;
+
+// 简单 agent：所有 IM 消息都走这个 agent
+const simpleAgent = createLangChainLikeAgent({
+  id: "main",
+  systemPrompt: "你是测试助手。所有 IM（钉钉、飞书等）的消息都会发到你这里，请简短回复。",
+  historyLimit: 20,
+  runnable: async ({ messages }) => {
+    const last = messages[messages.length - 1];
+    const content = last?.content ?? "";
+    return { content: `[测试 agent] 收到：${content}` };
+  },
+});
+
+const adapters: ReturnType<typeof createDingTalkAdapter>[] = [];
+if (clientId && clientSecret) {
+  adapters.push(createDingTalkAdapter({ config: { clientId, clientSecret } }));
+} else {
+  console.warn("未设置 DINGTALK_CLIENT_ID / DINGTALK_CLIENT_SECRET，仅能通过 HTTP /inbound 测试，回复不会发到钉钉。");
+  // 没有 adapter 时 hub 会报错「未找到 provider」。用占位 adapter：只打日志不真实发送。
+  adapters.push({
+    provider: "dingtalk",
+    async send({ to, message }) {
+      console.log("[Mock 钉钉] 若已配置真实 clientId/secret 会发到钉钉，当前仅打印:", to, message.text?.slice(0, 60));
+    },
+  });
+}
+
+// 所有 channel 的消息都路由到 main：用 bindings 显式写 dingtalk/feishu 均走 main
+const hub = createHubFromConfig({
+  defaultAgentId: "main",
+  agents: [simpleAgent],
+  adapters,
+  bindings: [
+    { agentId: "main", match: { channel: "dingtalk" } },
+    { agentId: "main", match: { channel: "feishu" } },
+  ],
+  sessions: createInMemorySessionStore(),
+});
+
+function parseBody(req: http.IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    req.on("error", reject);
+  });
+}
+
+const server = http.createServer(async (req, res) => {
+  res.setHeader("Content-Type", "application/json; charset=utf-8");
+
+  if (req.method === "GET" && (req.url === "/" || req.url === "/health")) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ ok: true, example: "single-agent", port: PORT }));
+    return;
+  }
+
+  if (req.method === "POST" && req.url === "/inbound") {
+    let raw: string;
+    try {
+      raw = await parseBody(req);
+    } catch {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "Failed to read body" }));
+      return;
+    }
+    let input: InboundMessage;
+    try {
+      input = JSON.parse(raw) as InboundMessage;
+    } catch {
+      res.writeHead(400);
+      res.end(JSON.stringify({ error: "Invalid JSON body" }));
+      return;
+    }
+    if (!input.provider || !input.peer || input.text === undefined) {
+      res.writeHead(400);
+      res.end(
+        JSON.stringify({
+          error: "Missing required fields: provider, peer, text",
+          example: {
+            provider: "dingtalk",
+            peer: { kind: "direct", id: "YOUR_STAFF_ID" },
+            sender: { id: "YOUR_STAFF_ID", name: "测试" },
+            messageId: "test-1",
+            timestamp: Date.now(),
+            text: "你好",
+          },
+        }),
+      );
+      return;
+    }
+    try {
+      await hub.handleInbound(input);
+      res.writeHead(200);
+      res.end(JSON.stringify({ ok: true, text: input.text, agentId: "main" }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error("[example-single-agent] handleInbound error:", err);
+      res.writeHead(500);
+      res.end(JSON.stringify({ error: msg }));
+    }
+    return;
+  }
+
+  res.writeHead(404);
+  res.end(JSON.stringify({ error: "Not found" }));
+});
+
+server.listen(PORT, () => {
+  console.log(`example-single-agent: http://localhost:${PORT}`);
+  console.log("  GET  /health  -> 健康检查");
+  console.log("  POST /inbound -> 发送 InboundMessage，所有消息由同一 agent 处理");
+  console.log("  设置 DINGTALK_CLIENT_ID / DINGTALK_CLIENT_SECRET 后，钉钉消息会真实回发");
+});

package/scripts/feishu-yuce-bridge.ts

@@ -0,0 +1,226 @@
+/**
+ * 飞书 → yuce-gpt 桥接（瘦进程，对齐 dingtalk-stdio-bridge「远端大脑」思路）
+ *
+ * - 收飞书 HTTP 事件：POST /webhook/feishu（URL 校验 + im.message.receive_v1 文本）
+ * - 调 yuce：POST /v1/chat/completions，body.user 为飞书专用稳定键（与钉钉 dingtalk: 前缀分离、互不撞车）+ ext.feishu（与 yuce connector_channels 一致）
+ * - 回消息：直接调飞书 **open-apis/im/v1/messages**（与 OpenClaw 官方插件底层同一 HTTP，不依赖 npm 包 @openclaw/feishu——该包在独立安装时会缺 openclaw/plugin-sdk）
+ *
+ * 与完整 OpenClaw（Gateway + models.providers → yuce）相比：本桥不实现 bot.ts 级策略/话题/卡片；仅适合「HTTP 订阅 + 文本闭环」。
+ *
+ * 环境变量：
+ *   PORT=3210
+ *   FEISHU_APP_ID / FEISHU_APP_SECRET
+ *   YUCE_CHAT_COMPLETIONS_URL  默认 http://127.0.0.1:4999/v1/chat/completions
+ *   OPENCLAW_GATEWAY_API_KEY 或 GATEWAY_TOKEN
+ */
+
+import http from "node:http";
+import type { InboundMessage } from "../src/types.js";
+import { parseFeishuWebhookBodyWithVerification } from "../src/providers/feishu.js";
+
+const PORT = Number(process.env.PORT) || 3210;
+const APP_ID = (process.env.FEISHU_APP_ID || "").trim();
+const APP_SECRET = (process.env.FEISHU_APP_SECRET || "").trim();
+const YUCE_URL = (
+  process.env.YUCE_CHAT_COMPLETIONS_URL ||
+  process.env.FEISHU_YUCE_URL ||
+  "http://127.0.0.1:4999/v1/chat/completions"
+).trim();
+const GATEWAY_TOKEN = (
+  process.env.OPENCLAW_GATEWAY_API_KEY ||
+  process.env.GATEWAY_TOKEN ||
+  process.env.OPENCLAW_GATEWAY_TOKEN ||
+  ""
+).trim();
+
+const TOKEN_URL = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal";
+const MSG_URL = "https://open.feishu.cn/open-apis/im/v1/messages";
+
+let cachedToken = "";
+let cachedExpire = 0;
+
+async function getTenantToken(): Promise<string> {
+  const now = Date.now() / 1000;
+  if (cachedToken && cachedExpire > now + 60) return cachedToken;
+  const res = await fetch(TOKEN_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ app_id: APP_ID, app_secret: APP_SECRET }),
+  });
+  const data = (await res.json()) as { code?: number; tenant_access_token?: string; expire?: number };
+  if (data.code !== 0 || !data.tenant_access_token) {
+    throw new Error(`feishu token: ${JSON.stringify(data)}`);
+  }
+  cachedToken = data.tenant_access_token;
+  cachedExpire = now + (data.expire ?? 7200);
+  return cachedToken;
+}
+
+/** 与 yuce channel_feishu_views 一致：receive_id_type=chat_id */
+async function sendFeishuChatText(chatId: string, text: string): Promise<void> {
+  const token = await getTenantToken();
+  const url = `${MSG_URL}?receive_id_type=chat_id`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json; charset=utf-8",
+    },
+    body: JSON.stringify({
+      receive_id: chatId,
+      msg_type: "text",
+      content: JSON.stringify({ text }),
+    }),
+  });
+  const data = (await res.json()) as { code?: number; msg?: string };
+  if (data.code !== 0) {
+    throw new Error(`feishu send: ${JSON.stringify(data)}`);
+  }
+}
+
+function isFeishuAppSender(raw: string): boolean {
+  try {
+    const body = JSON.parse(raw) as { event?: { sender?: { sender_type?: string } } };
+    return (body.event?.sender?.sender_type || "").toLowerCase() === "app";
+  } catch {
+    return false;
+  }
+}
+
+function readBody(req: http.IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+    req.on("error", reject);
+  });
+}
+
+function buildYuceBody(inbound: InboundMessage): Record<string, unknown> {
+  const { peer, sender, text, messageId } = inbound;
+  /** 飞书专用会话键（与钉钉 dingtalk: 分离）：应用 + 会话维度 + 发送者，多应用部署时不串号 */
+  const appScope = APP_ID || "unknown_app";
+  const user = `feishu:${appScope}:${peer.kind}:${peer.id}:${sender.id}`;
+  const extFeishu = {
+    appId: appScope,
+    chatId: peer.id,
+    chatType: peer.kind === "direct" ? "p2p" : "group",
+    senderOpenId: sender.id,
+    messageId: messageId || undefined,
+    peerKind: peer.kind,
+    peerId: peer.id,
+  };
+  return {
+    model: "main",
+    stream: false,
+    user,
+    messages: [{ role: "user", content: text }],
+    ext: {
+      channel: "feishu",
+      feishu: extFeishu,
+    },
+  };
+}
+
+async function postYuce(body: Record<string, unknown>): Promise<string> {
+  const headers: Record<string, string> = { "Content-Type": "application/json" };
+  if (GATEWAY_TOKEN) headers.Authorization = `Bearer ${GATEWAY_TOKEN}`;
+  const res = await fetch(YUCE_URL, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body),
+  });
+  const data = (await res.json()) as {
+    choices?: Array<{ message?: { content?: string } }>;
+    error?: { message?: string };
+  };
+  if (!res.ok) {
+    throw new Error(data.error?.message || `yuce HTTP ${res.status}`);
+  }
+  const content = data.choices?.[0]?.message?.content;
+  return typeof content === "string" ? content : "";
+}
+
+const server = http.createServer(async (req, res) => {
+  const path = req.url?.split("?")[0] ?? "";
+
+  if (req.method === "GET" && (path === "/health" || path === "/")) {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ ok: true, service: "feishu-yuce-bridge" }));
+    return;
+  }
+
+  if (req.method !== "POST" || path !== "/webhook/feishu") {
+    res.writeHead(404);
+    res.end();
+    return;
+  }
+
+  if (!APP_ID || !APP_SECRET) {
+    res.writeHead(500, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ error: "FEISHU_APP_ID / FEISHU_APP_SECRET required" }));
+    return;
+  }
+
+  let raw: string;
+  try {
+    raw = await readBody(req);
+  } catch {
+    res.writeHead(400);
+    res.end();
+    return;
+  }
+
+  const parsed = parseFeishuWebhookBodyWithVerification(raw);
+  res.setHeader("Content-Type", "application/json; charset=utf-8");
+
+  if (parsed && typeof parsed === "object" && "challenge" in parsed) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ challenge: (parsed as { challenge: string }).challenge }));
+    return;
+  }
+
+  if (!parsed) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ msg: "ok" }));
+    return;
+  }
+
+  if (isFeishuAppSender(raw)) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ msg: "ok", skip: "app_sender" }));
+    return;
+  }
+
+  const inbound = parsed as InboundMessage;
+  if (!(inbound.text || "").trim()) {
+    res.writeHead(200);
+    res.end(JSON.stringify({ msg: "ok", skip: "empty_text" }));
+    return;
+  }
+
+  if (!GATEWAY_TOKEN) {
+    res.writeHead(500);
+    res.end(JSON.stringify({ error: "OPENCLAW_GATEWAY_API_KEY or GATEWAY_TOKEN required for yuce" }));
+    return;
+  }
+
+  try {
+    const yuceBody = buildYuceBody(inbound);
+    const reply = await postYuce(yuceBody);
+    const out = (reply || "").trim() || "（暂无回复）";
+    await sendFeishuChatText(inbound.peer.id, out);
+    res.writeHead(200);
+    res.end(JSON.stringify({ msg: "ok" }));
+  } catch (e) {
+    console.error("[feishu-yuce-bridge]", e);
+    res.writeHead(200);
+    res.end(JSON.stringify({ msg: "error", error: String((e as Error).message) }));
+  }
+});
+
+server.listen(PORT, () => {
+  console.error(`[feishu-yuce-bridge] listening http://0.0.0.0:${PORT}`);
+  console.error(`[feishu-yuce-bridge] POST /webhook/feishu  ->  yuce ${YUCE_URL}`);
+  console.error(`[feishu-yuce-bridge] outbound: Feishu im/v1/messages (chat_id), same API as official plugin`);
+});

package/scripts/install/README.md

@@ -0,0 +1,98 @@
+# 钉钉桥接安装说明（独立 im-agent-hub）
+
+本仓库已从 OpenClaw monorepo 拆出，安装脚本使用 **npm**，不再依赖 `pnpm-workspace`。
+
+## 前置
+
+- `package.json` 中 `@dingtalk-real-ai/dingtalk-connector` 若为 `file:../dingtalk-openclaw-connector`，请保证该目录与当前仓库相对位置正确，否则先改为已发布的 npm 版本再安装。
+- 交互式终端（安装时需输入配置）。
+
+## 安装
+
+在 **本仓库根目录** 的上一级执行（或先 `cd` 到仓库根）：
+
+```bash
+cd /path/to/im-agent-hub
+export USE_CN_MIRROR=1   # 可选：npm 使用 npmmirror
+bash scripts/install/install-dingtalk-bridge.sh
+```
+
+会把你输入的 **钉钉插件**（`channels.dingtalk-connector`）参数写入根目录 `openclaw.json`。
+
+- **精简结构**：可与仓库默认一致，仅包含 `channels`（可选 `gatewayPort`，若 Gateway URL 中带端口会自动写入）。
+- **合并规则**：已存在文件时只合并 `channels.dingtalk-connector`，其它顶级键（若你以后扩展）保留。
+- **不写入** `bindings`（由你自行维护或不需要）。
+
+随后执行 `npm install`、安装 `~/.local/bin/im-agent-hub-ctl`。
+
+## 运行（与本地调试一致）
+
+```bash
+npx tsx scripts/dingtalk-stdio-bridge.ts
+```
+
+打包成单文件 JS（仍需系统已装 Node，分发时只需带 `dist/*.mjs` + `openclaw.json`）：
+
+```bash
+npm run build:bridge
+node dist/dingtalk-stdio-bridge.cjs
+```
+
+`build:bridge` 默认外置重型依赖并 **minify**，cjs 约 **200KB+**（可读调试用 `npm run build:bridge:debug`）。全量打入：`npm run build:bridge:all`。
+
+详见 **[docs/packaging-二进制与分发.md](../docs/packaging-二进制与分发.md)**。`im-agent-hub-ctl start` 若发现 `dist/dingtalk-stdio-bridge.cjs`（或旧版 `.mjs`）会优先用它。
+
+后台：
+
+```bash
+im-agent-hub-ctl start
+```
+
+## 更新
+
+**推荐**（从 `manifest.env` 读取项目路径，先停服务、再拉代码、装依赖、再启动）：
+
+```bash
+im-agent-hub-ctl update
+```
+
+查看当前安装目录、包版本、git 提交与上次更新时间：
+
+```bash
+im-agent-hub-ctl version
+```
+
+说明与故障处理：
+
+```bash
+im-agent-hub-ctl update-help
+```
+
+手动等价步骤（无 ctl 或仅想手工执行时）：
+
+```bash
+cd /path/to/im-agent-hub && git pull && npm install
+im-agent-hub-ctl restart
+```
+
+`update` 默认会在项目根目录备份一份 `openclaw.json.bak.<时间戳>`；不需要备份时设 `IM_AGENT_HUB_NO_BACKUP=1`。国内 npm 镜像：`USE_CN_MIRROR=1 im-agent-hub-ctl update`。
+
+## 卸载（不删 Node）
+
+移除 **`im-agent-hub-ctl`**、**`~/.im-agent-hub/`**（manifest、日志、pid），并尝试停止桥接进程。
+
+**不会**删除：本机 **Node / nvm**、项目里的 **`node_modules`**、**`openclaw.json`**、**`dist/`**。
+
+```bash
+bash scripts/install/uninstall-im-agent-hub.sh
+# 或跳过确认：
+bash scripts/install/uninstall-im-agent-hub.sh -y
+```
+
+若数据目录不在默认路径，安装时曾设置 `IM_AGENT_HUB_HOME`，卸载时请同样导出该变量。
+
+重新安装后 `manifest.env` 会包含 `IM_AGENT_HUB_CTL_PATH`，便于准确删除 ctl；旧安装仍会通过常见路径与脚本内容特征尝试删除。
+
+## systemd（可选）
+
+见 `systemd/im-agent-hub-dingtalk.service.example`（把路径改成你的 `im-agent-hub` 绝对路径）。