@baishuyun/chat-backend 0.0.2

package/.env.example

@@ -0,0 +1,17 @@
+# agent bot api key
+BOT_API_KEY=xxxxx
+
+# agent host
+AGENT_HOST=47.99.202.157
+
+# api auth key
+COZE_API_KEY=xxxxx
+
+# app port
+PORT=3001
+
+# build bot id
+BUILD_BOT_ID=xxxxx
+
+# fill bot id
+FILL_BOT_ID=xxxxx

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @baishuyun/chat-backend
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @baishuyun/coze-provider@0.0.3
+  - @baishuyun/types@1.0.3

package/README.md

@@ -0,0 +1,8 @@
+```
+npm install
+npm run dev
+```
+
+```
+open http://localhost:3000
+```

package/config/default.ts

@@ -0,0 +1,35 @@
+import { asyncConfig } from "config/async.js";
+// load async configurations
+const fetchRemoteConfig = async () => {
+  return {
+    // mock remote config
+    foo: "bar",
+  };
+};
+
+export default {
+  app: {
+    port: process.env.PORT || 3001,
+    host: process.env.HOST || "localhost",
+  },
+  agent: {
+    host: process.env.AGENT_HOST || "47.99.202.157",
+
+    apiAuthKey: process.env.COZE_API_KEY,
+
+    form: {
+      build: {
+        botId: process.env.BUILD_BOT_ID || "7579927677256073216",
+        baseUrl: `http://${process.env.AGENT_HOST}/v3/`,
+        apiKey: process.env.BOT_API_KEY, // load from env
+      },
+
+      fill: {
+        botId: process.env.FILL_BOT_ID || "7586483957357608960",
+        baseUrl: `http://${process.env.AGENT_HOST}/v3/`,
+        apiKey: process.env.BOT_API_KEY, // load from env
+        ocrApiKey: process.env.OCR_API_KEY || "", // load from env
+      },
+    },
+  },
+};

package/config/index.ts

@@ -0,0 +1,14 @@
+import path from "path";
+import dotenv from "dotenv";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// export const parseConfig = () => {
+if (process.env.NODE_ENV !== "production") {
+  // 加载本地.env文件到process.env
+  dotenv.config({
+    path: path.resolve(__dirname, "../.env"),
+  });
+}

package/dist/config/default.js

@@ -0,0 +1,31 @@
+import { asyncConfig } from "config/async.js";
+// load async configurations
+const fetchRemoteConfig = async () => {
+    return {
+        // mock remote config
+        foo: "bar",
+    };
+};
+export default {
+    app: {
+        port: process.env.PORT || 3001,
+        host: process.env.HOST || "localhost",
+    },
+    agent: {
+        host: process.env.AGENT_HOST || "47.99.202.157",
+        apiAuthKey: process.env.COZE_API_KEY,
+        form: {
+            build: {
+                botId: process.env.BUILD_BOT_ID || "7579927677256073216",
+                baseUrl: `http://${process.env.AGENT_HOST}/v3/`,
+                apiKey: process.env.BOT_API_KEY, // load from env
+            },
+            fill: {
+                botId: process.env.FILL_BOT_ID || "7586483957357608960",
+                baseUrl: `http://${process.env.AGENT_HOST}/v3/`,
+                apiKey: process.env.BOT_API_KEY, // load from env
+                ocrApiKey: process.env.OCR_API_KEY || "", // load from env
+            },
+        },
+    },
+};

package/dist/config/development.js

@@ -0,0 +1 @@
+export {};

package/dist/config/index.js

@@ -0,0 +1,12 @@
+import path from "path";
+import dotenv from "dotenv";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// export const parseConfig = () => {
+if (process.env.NODE_ENV !== "production") {
+    // 加载本地.env文件到process.env
+    dotenv.config({
+        path: path.resolve(__dirname, "../.env"),
+    });
+}

package/dist/config/production.js

@@ -0,0 +1 @@
+export {};

package/dist/src/app/main.js

@@ -0,0 +1,13 @@
+/**
+ * 后端应用入口
+ */
+// 应用实例
+import app from '../config/hono.config.js';
+// 子路由
+import { createFormRouter } from '../routes/form/form.route.js';
+// 挂载子路由
+app.route('api/form', createFormRouter());
+// add test route
+app.get('/api/test', (c) => {
+    return c.json({ message: 'Test route is working!' });
+});

package/dist/src/config/hono.config.js

@@ -0,0 +1,34 @@
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import config from "config";
+import { cors } from "hono/cors";
+import { logMiddleware } from "../logger/log-middleware.js";
+import { logger } from "../logger/index.js";
+/**
+ * 公共配置层，跨域、日志等中间件配置
+ */
+const app = new Hono();
+// Enable CORS for all routes starting with /api/
+app.use("/api/*", cors());
+// Logging middleware
+app.use(logMiddleware);
+// 全局错误处理中间件（捕获所有路由/中间件异常）
+app.onError((err, c) => {
+    // 记录错误日志（error 级别，包含异常堆栈）
+    logger.error({
+        err: err, // 异常对象（自动包含 stack 堆栈信息）
+        method: c.req.method,
+        path: c.req.path,
+        status: 500, // 默认 500 错误
+    }, "Request failed with unhandled error"); // 错误描述
+    // 返回统一的 JSON 错误响应
+    return c.json({ message: "Internal Server Error" }, 500);
+});
+serve({
+    fetch: app.fetch,
+    hostname: config.get("app.host") || "",
+    port: config.get("app.port") || 3001,
+}, (info) => {
+    logger.info(`Server is running on http://localhost:${info.port}`);
+});
+export default app;

package/dist/src/controllers/form/attachment-upload.controller.js

@@ -0,0 +1,48 @@
+import {} from "hono";
+import config from "config";
+import { logger } from "../../logger/index.js";
+import { parseImg } from "./fill/utils.js";
+export const uploadAttachment = async (c) => {
+    const formData = await c.req.formData();
+    const file = formData.get("file"); // as FormData | null;
+    // 校验文件是否存在
+    if (!file || !(file instanceof Blob)) {
+        return c.json({ error: "请上传有效的文件" }, 400);
+    }
+    const forwardFormData = new FormData();
+    forwardFormData.append("file", file);
+    const apiKey = config.get("agent.apiAuthKey");
+    const host = config.get("agent.host");
+    const api = `http://${host}/v1/files/upload`;
+    logger.debug(c.body);
+    const response = await fetch(api, {
+        method: "POST",
+        body: formData,
+        headers: {
+            // Add any auth headers
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    if (!response.ok) {
+        const errorData = await response
+            .json()
+            .catch(() => ({ message: "上传失败" }));
+        return c.json({
+            error: `目标接口返回错误: ${errorData.message}`,
+            status: response.status,
+        });
+    }
+    const data = await response.json();
+    const { url, uri, ...rest } = data?.data || {};
+    const orcResult = await parseImg(file);
+    return c.json({
+        url,
+        name: uri,
+        contentType: file.type,
+        parsedData: orcResult,
+        uploadMetadata: {
+            ...rest,
+            orcResult,
+        },
+    });
+};

package/dist/src/controllers/form/build/build.controller.js

@@ -0,0 +1,33 @@
+import { convertToModelMessages, streamText } from "ai";
+import {} from "hono";
+import { createModel } from "./model.js";
+import { createFieldsJsonTransformStream, SuggestionTransformStream, } from "@baishuyun/coze-provider";
+/**
+ * 搭建表单
+ * @param c
+ * @returns
+ */
+export const buildForm = async (c) => {
+    let requestBody;
+    try {
+        const json = await c.req.json();
+        requestBody = json;
+    }
+    catch (_) {
+        return c.json({ error: "Invalid JSON" }, 400);
+    }
+    const isBuildStage = requestBody.stage === "build";
+    const stream = streamText({
+        model: createModel([
+            createFieldsJsonTransformStream(isBuildStage),
+            new SuggestionTransformStream(isBuildStage),
+        ]),
+        messages: convertToModelMessages(requestBody.messages),
+        includeRawChunks: true,
+        headers: {
+            "x-user-stage": requestBody.stage,
+            "x-user-id": Date.now().toString(),
+        },
+    });
+    return stream.toUIMessageStreamResponse();
+};

package/dist/src/controllers/form/build/model.js

@@ -0,0 +1,11 @@
+import { createCoze } from "@baishuyun/coze-provider";
+import config from "config";
+export const createModel = (extraStreamTransformers) => {
+    const coze = createCoze({
+        apiKey: config.get("agent.form.build.apiKey"),
+        baseURL: config.get("agent.form.build.baseUrl"),
+        botId: config.get("agent.form.build.botId"),
+        extraStreamTransformers,
+    });
+    return coze.chat("chat");
+};

package/dist/src/controllers/form/conversation/clear.controller.js

@@ -0,0 +1,22 @@
+import config from "config";
+export const clearConversation = async (c) => {
+    let requestBody;
+    const agentHost = config.get("agent.host");
+    const baseUrl = `http://${agentHost}/v1`;
+    const apiKey = config.get("agent.apiAuthKey");
+    try {
+        const json = await c.req.json();
+        requestBody = json;
+    }
+    catch (_) {
+        return c.json({ error: "Invalid JSON" }, 400);
+    }
+    const result = await fetch(`${baseUrl}/conversations/${requestBody.conversationId}/clear`, {
+        method: "POST",
+        headers: {
+            // Add any auth headers
+            Authorization: `Bearer ${apiKey}`,
+        },
+    });
+    return c.json(result);
+};

package/dist/src/controllers/form/fill/createFieldsFillingResultTransformStream.js

@@ -0,0 +1,110 @@
+import {} from '@ai-sdk/provider';
+import { JSONParser } from '@streamparser/json';
+import { createTextInfoEnqueuer } from '@baishuyun/coze-provider';
+import { getLastSubFormField } from './utils.js';
+import { logger } from '../../../logger/index.js';
+export const createFieldsFillingResultTransformer = (enableJsonParser) => {
+    let parser;
+    let id;
+    // 解析完成标记：用于等待解析器内部队列处理完毕
+    let parseCompleted;
+    let resolveParseCompleted;
+    const chunkGuard = (chunk) => {
+        if (!enableJsonParser) {
+            return false;
+        }
+        if (chunk.type !== 'text-delta' || !('delta' in chunk)) {
+            return false;
+        }
+        return true;
+    };
+    const transformer = {
+        flush: async (controller) => {
+            try {
+                if (parser) {
+                    await parseCompleted; // 等待闭包中的完成标记
+                    logger.debug('stop parser');
+                    // parser.end(); // 此时调用 end() 不会出现未完成 Token 异常
+                }
+                controller.terminate(); // 信号通知下游可读流已关闭
+            }
+            catch (e) {
+                controller.error('stop error' + e);
+                // controller.terminate(); // 信号通知下游可读流已关闭
+            }
+        },
+        transform: (chunk, controller) => {
+            if (!parser) {
+                logger.warn('json parser not init');
+                return;
+            }
+            try {
+                if (chunkGuard(chunk)) {
+                    if ('id' in chunk && 'delta' in chunk) {
+                        id = chunk.id;
+                        const regExp = /`?`?`?/;
+                        let delta = chunk.delta.replace(regExp, '');
+                        parser.write(delta.replace('json', ''));
+                    }
+                }
+                else {
+                    controller.enqueue(chunk);
+                }
+            }
+            catch (e) {
+                controller.error(e);
+            }
+        },
+        start: (controller) => {
+            parser = new JSONParser({
+                paths: ['$.*', '$.*.value.*.*'],
+            });
+            parseCompleted = new Promise((resolve) => {
+                resolveParseCompleted = resolve;
+            });
+            const enqueueTextDelta = enableJsonParser
+                ? createTextInfoEnqueuer(controller)
+                : (content) => { };
+            parser.onValue = (parsedInfo) => {
+                const value = parsedInfo.value;
+                const subFormField = getLastSubFormField(parsedInfo);
+                if (subFormField) {
+                    enqueueTextDelta(JSON.stringify(value), {
+                        type: 'mcp-fields-json',
+                        field: subFormField.value,
+                    });
+                    return;
+                }
+                if (value.fieldType === 'subform') {
+                    return;
+                }
+                enqueueTextDelta(JSON.stringify(value), {
+                    type: 'mcp-fields-json',
+                    field: value,
+                }, id);
+            };
+            let errorLogged = false;
+            parser.onError = (err) => {
+                // controller.enqueue({
+                //   type: "error",
+                //   error: "JsonWidgetStream: JSON Parsing Error:" + err.message,
+                // });
+                if (!errorLogged) {
+                    console.error('JsonWidgetStream: JSON Parsing Error:', err);
+                    errorLogged = true;
+                }
+                // close stream
+                logger.error('JsonStream: closing stream due to parsing error');
+                controller.terminate(); // 信号通知下游可读流已关闭
+            };
+            parser.onEnd = () => {
+                enqueueTextDelta(' ', JSON.stringify({
+                    appendConfirm: 'save-fields',
+                }));
+                logger.debug('mark as end');
+                resolveParseCompleted?.();
+            };
+        },
+    };
+    return new TransformStream(transformer);
+};

package/dist/src/controllers/form/fill/fill.controller.js

@@ -0,0 +1,41 @@
+import {} from 'hono';
+import { convertToModelMessages, streamText } from 'ai';
+import { logger } from '../../../logger/index.js';
+import { createFillingModel } from './model.js';
+/**
+ * 表单填写
+ * @param c
+ * @returns
+ */
+export const fillForm = async (c) => {
+    let requestBody;
+    try {
+        const json = await c.req.json();
+        requestBody = json;
+    }
+    catch (_) {
+        return c.json({ error: 'Invalid JSON' }, 400);
+    }
+    const formStructure = requestBody.formStructure;
+    if (formStructure) {
+        try {
+            let lastMsg = requestBody.messages[requestBody.messages.length - 1];
+            lastMsg.parts.push({
+                type: 'text',
+                text: JSON.stringify(formStructure),
+            });
+        }
+        catch (e) {
+            logger.error('Failed to append form structure');
+        }
+    }
+    const stream = streamText({
+        model: createFillingModel(),
+        messages: convertToModelMessages(requestBody.messages),
+        includeRawChunks: true,
+        headers: {
+            'x-user-stage': requestBody.stage,
+        },
+    });
+    return stream.toUIMessageStreamResponse();
+};

package/dist/src/controllers/form/fill/model.js

@@ -0,0 +1,13 @@
+import { createCoze } from '@baishuyun/coze-provider';
+import { createFieldsFillingResultTransformer } from './createFieldsFillingResultTransformStream.js';
+import config from 'config';
+export const createFillingModel = (enableParser = true) => {
+    const aiFormFilling = createCoze({
+        apiKey: config.get('agent.form.fill.apiKey'),
+        baseURL: config.get('agent.form.fill.baseUrl'),
+        botId: config.get('agent.form.fill.botId'),
+        extraStreamTransformers: [createFieldsFillingResultTransformer(enableParser)],
+    });
+    const formFillingModel = aiFormFilling.chat('chat');
+    return formFillingModel;
+};

package/dist/src/controllers/form/fill/utils.js

@@ -0,0 +1,56 @@
+import config from "config";
+import { logger } from "../../../logger/index.js";
+export const isSubFormField = (parsedInfo) => {
+    if (!parsedInfo || !parsedInfo.stack?.length) {
+        return false;
+    }
+    const lastStackItem = parsedInfo.stack[parsedInfo.stack.length - 1];
+    return lastStackItem?.key === "value";
+};
+export const getLastStackItem = (parsedInfo) => {
+    if (!parsedInfo || !parsedInfo.stack?.length) {
+        return null;
+    }
+    return parsedInfo.stack[parsedInfo.stack.length - 1];
+};
+export const getLastSubFormField = (parsedInfo) => {
+    if (!parsedInfo || !parsedInfo.stack?.length) {
+        return null;
+    }
+    const targetStackItem = parsedInfo.stack.findLast((s) => {
+        return s.value?.fieldType === "subform";
+    });
+    return targetStackItem;
+};
+export const parseImg = async (file) => {
+    const isImg = file.type.startsWith("image/");
+    if (!isImg) {
+        return null;
+    }
+    const ocrApiKey = config.get("agent.form.fill.ocrApiKey");
+    const ocrEndpoint = "https://api.ocr.space/parse/image";
+    const formData = new FormData();
+    formData.append("language", "chs");
+    formData.append("file", file);
+    const response = await fetch(ocrEndpoint, {
+        method: "POST",
+        body: formData,
+        headers: {
+            // Add any auth headers
+            apiKey: ocrApiKey,
+        },
+    });
+    const result = await response.json();
+    console.log(result);
+    if (result.IsErroredOnProcessing) {
+        logger.error("image ocr parse error");
+        return null;
+    }
+    if (!result.ParsedResults || !result.ParsedResults.length) {
+        logger.debug("image ocr parse no result");
+        return null;
+    }
+    // join all parsed text
+    const parsedTexts = result.ParsedResults.map((pr) => pr.ParsedText);
+    return parsedTexts.join("\n");
+};

package/dist/src/index.js

@@ -0,0 +1,2 @@
+import "../config/index.js";
+import("./app/main.js");

package/dist/src/logger/index.js

@@ -0,0 +1,46 @@
+import pino from "pino";
+import path from "path";
+import fs from "fs";
+import os from "os";
+import { fileURLToPath } from "url";
+const isDev = process.env.NODE_ENV === "development";
+const isProd = process.env.NODE_ENV === "production";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const logDir = path.join(__dirname, "logs");
+if (isProd && !fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true }); // 递归创建目录
+}
+// 3. 初始化 Pino 日志实例
+const logger = pino({
+    level: isDev ? "debug" : "info",
+    base: isDev
+        ? { pid: false, hostname: false }
+        : { pid: process.pid, hostname: os.hostname() },
+    timestamp: isProd,
+    transport: isDev
+        ? {
+            target: "pino-pretty", // 依赖 pino-pretty
+            options: {
+                colorize: true, // 彩色输出（更易阅读）
+                translateTime: "SYS:yyyy-mm-dd HH:MM:ss", // 时间格式转换
+                ignore: "pid,hostname", // 忽略无用字段
+                singleLine: true, // 单行会输出（简化日志体积）
+            },
+        }
+        : {
+            // 生产环境使用 pino/file 实现日志轮转（官方推荐）
+            target: "pino/file",
+            options: {
+                destination: path.join(logDir, "app.log"), // 基础日志文件路径
+                mkdir: true, // 自动创建日志目录（无需手动判断，可选增强）
+                // 轮转配置
+                rotate: {
+                    frequency: "daily", // 轮转频率：每日轮转（支持 hourly/weekly/monthly 等）
+                    maxSize: "10m", // 单个日志文件最大体积（支持 k/m/g 单位）
+                    maxFiles: 7, // 保留最近 7 个日志文件（自动删除更早的文件）
+                },
+            },
+        },
+}, isProd ? pino.destination(path.join(logDir, "app.log")) : undefined);
+export { logger };

package/dist/src/logger/log-middleware.js

@@ -0,0 +1,20 @@
+import {} from "hono";
+import { logger } from "./index.js";
+export const logMiddleware = async (c, next) => {
+    // 记录请求开始时间
+    const startTime = Date.now();
+    // 执行后续中间件/路由处理逻辑
+    await next();
+    // 计算响应时间
+    const responseTime = Date.now() - startTime;
+    // 记录访问日志（info 级别，核心请求信息）
+    logger.info({
+        method: c.req.method, // 请求方法 GET/POST 等
+        path: c.req.path, // 请求路径
+        status: c.res.status, // 响应状态码
+        responseTime: `${responseTime}ms`, // 响应时间
+        clientIp: c.req.header("x-forwarded-for") ||
+            c.req.header("remote-addr") ||
+            "unknown", // 客户端 IP
+    }, "Request processed"); // 日志描述信息
+};

package/dist/src/routes/form/form.route.js

@@ -0,0 +1,17 @@
+import { Hono } from "hono";
+import { fillForm } from "../../controllers/form/fill/fill.controller.js";
+import { clearConversation } from "../../controllers/form/conversation/clear.controller.js";
+import { buildForm } from "../../controllers/form/build/build.controller.js";
+import { uploadAttachment } from "../../controllers/form/attachment-upload.controller.js";
+export const createFormRouter = () => {
+    const formRouter = new Hono();
+    // 智能填数
+    formRouter.post("/fill", fillForm);
+    // 智能搭件
+    formRouter.post("/build", buildForm);
+    // 会话清除
+    formRouter.post("/conversation/clear", clearConversation);
+    // 附件上传
+    formRouter.post("/attachment/upload", uploadAttachment);
+    return formRouter;
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@baishuyun/chat-backend",
+  "version": "0.0.2",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ai-sdk/deepseek": "^1.0.29",
+    "@ai-sdk/mcp": "^0.0.11",
+    "@ai-sdk/provider": "^2.0.0",
+    "@ai-sdk/provider-utils": "^3.0.18",
+    "@coze/api": "^1.3.9",
+    "@hono/node-server": "^1.19.6",
+    "@hono/zod-validator": "^0.7.5",
+    "@streamparser/json": "^0.0.22",
+    "ai": "^5.0.101",
+    "axios": "^1.13.2",
+    "config": "^4.1.1",
+    "dotenv": "^17.2.3",
+    "hono": "^4.10.6",
+    "parse-sse": "^0.1.0",
+    "pino": "^10.1.0",
+    "zod": "^4.1.13",
+    "@baishuyun/coze-provider": "0.0.3",
+    "@baishuyun/types": "1.0.3"
+  },
+  "devDependencies": {
+    "@types/config": "^3.3.5",
+    "@types/dotenv": "^8.2.3",
+    "@types/node": "^20.11.17",
+    "cross-env": "^10.1.0",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.7.1",
+    "typescript": "^5.8.3",
+    "@baishuyun/typescript-config": "0.0.3"
+  },
+  "scripts": {
+    "dev": "cross-env NODE_ENV=development tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "cross-env NODE_ENV=production NODE_CONFIG_DIR=./dist/config node dist/src/index.js"
+  }
+}

package/src/app/main.ts

@@ -0,0 +1,17 @@
+/**
+ * 后端应用入口
+ */
+
+// 应用实例
+import app from '../config/hono.config.js';
+
+// 子路由
+import { createFormRouter } from '../routes/form/form.route.js';
+
+// 挂载子路由
+app.route('api/form', createFormRouter());
+
+// add test route
+app.get('/api/test', (c) => {
+  return c.json({ message: 'Test route is working!' });
+});

package/src/config/hono.config.ts

@@ -0,0 +1,47 @@
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import config from "config";
+import { cors } from "hono/cors";
+import { logMiddleware } from "../logger/log-middleware.js";
+import { logger } from "../logger/index.js";
+
+/**
+ * 公共配置层，跨域、日志等中间件配置
+ */
+const app = new Hono();
+
+// Enable CORS for all routes starting with /api/
+app.use("/api/*", cors());
+
+// Logging middleware
+app.use(logMiddleware);
+
+// 全局错误处理中间件（捕获所有路由/中间件异常）
+app.onError((err, c) => {
+  // 记录错误日志（error 级别，包含异常堆栈）
+  logger.error(
+    {
+      err: err, // 异常对象（自动包含 stack 堆栈信息）
+      method: c.req.method,
+      path: c.req.path,
+      status: 500, // 默认 500 错误
+    },
+    "Request failed with unhandled error",
+  ); // 错误描述
+
+  // 返回统一的 JSON 错误响应
+  return c.json({ message: "Internal Server Error" }, 500);
+});
+
+serve(
+  {
+    fetch: app.fetch,
+    hostname: config.get<string>("app.host") || "",
+    port: config.get<number>("app.port") || 3001,
+  },
+  (info) => {
+    logger.info(`Server is running on http://localhost:${info.port}`);
+  },
+);
+
+export default app;

package/src/controllers/form/attachment-upload.controller.ts

@@ -0,0 +1,57 @@
+import { type Context } from "hono";
+import config from "config";
+import { logger } from "../../logger/index.js";
+import { parseImg } from "./fill/utils.js";
+
+export const uploadAttachment = async (c: Context) => {
+  const formData = await c.req.formData();
+  const file = formData.get("file"); // as FormData | null;
+  // 校验文件是否存在
+  if (!file || !(file instanceof Blob)) {
+    return c.json({ error: "请上传有效的文件" }, 400);
+  }
+
+  const forwardFormData = new FormData();
+  forwardFormData.append("file", file);
+
+  const apiKey = config.get<string>("agent.apiAuthKey");
+  const host = config.get<string>("agent.host");
+  const api = `http://${host}/v1/files/upload`;
+
+  logger.debug(c.body);
+
+  const response = await fetch(api, {
+    method: "POST",
+    body: formData,
+    headers: {
+      // Add any auth headers
+      Authorization: `Bearer ${apiKey}`,
+    },
+  });
+
+  if (!response.ok) {
+    const errorData = await response
+      .json()
+      .catch(() => ({ message: "上传失败" }));
+    return c.json({
+      error: `目标接口返回错误: ${errorData.message}`,
+      status: response.status,
+    });
+  }
+
+  const data = await response.json();
+  const { url, uri, ...rest } = data?.data || {};
+
+  const orcResult = await parseImg(file);
+
+  return c.json({
+    url,
+    name: uri,
+    contentType: file.type,
+    parsedData: orcResult,
+    uploadMetadata: {
+      ...rest,
+      orcResult,
+    },
+  });
+};

package/src/controllers/form/build/build.controller.ts

@@ -0,0 +1,40 @@
+import { convertToModelMessages, streamText } from "ai";
+import { type Context } from "hono";
+import { createModel } from "./model.js";
+import {
+  createFieldsJsonTransformStream,
+  SuggestionTransformStream,
+} from "@baishuyun/coze-provider";
+
+/**
+ * 搭建表单
+ * @param c
+ * @returns
+ */
+export const buildForm = async (c: Context) => {
+  let requestBody;
+
+  try {
+    const json = await c.req.json();
+    requestBody = json;
+  } catch (_) {
+    return c.json({ error: "Invalid JSON" }, 400);
+  }
+
+  const isBuildStage = requestBody.stage === "build";
+
+  const stream = streamText({
+    model: createModel([
+      createFieldsJsonTransformStream(isBuildStage),
+      new SuggestionTransformStream(isBuildStage),
+    ]),
+    messages: convertToModelMessages(requestBody.messages),
+    includeRawChunks: true,
+    headers: {
+      "x-user-stage": requestBody.stage,
+      "x-user-id": Date.now().toString(),
+    },
+  });
+
+  return stream.toUIMessageStreamResponse();
+};

package/src/controllers/form/build/model.ts

@@ -0,0 +1,16 @@
+import type { LanguageModelV2StreamPart } from "@ai-sdk/provider";
+import { createCoze } from "@baishuyun/coze-provider";
+import config from "config";
+
+export const createModel = (
+  extraStreamTransformers: TransformStream<LanguageModelV2StreamPart, any>[],
+) => {
+  const coze = createCoze({
+    apiKey: config.get<string>("agent.form.build.apiKey"),
+    baseURL: config.get<string>("agent.form.build.baseUrl"),
+    botId: config.get<string>("agent.form.build.botId"),
+    extraStreamTransformers,
+  });
+
+  return coze.chat("chat");
+};

package/src/controllers/form/conversation/clear.controller.ts

@@ -0,0 +1,31 @@
+import type { Context } from "hono";
+import config from "config";
+
+export const clearConversation = async (c: Context) => {
+  let requestBody;
+
+  const agentHost = config.get<string>("agent.host");
+
+  const baseUrl = `http://${agentHost}/v1`;
+  const apiKey = config.get<string>("agent.apiAuthKey");
+
+  try {
+    const json = await c.req.json();
+    requestBody = json;
+  } catch (_) {
+    return c.json({ error: "Invalid JSON" }, 400);
+  }
+
+  const result = await fetch(
+    `${baseUrl}/conversations/${requestBody.conversationId}/clear`,
+    {
+      method: "POST",
+      headers: {
+        // Add any auth headers
+        Authorization: `Bearer ${apiKey}`,
+      },
+    },
+  );
+
+  return c.json(result);
+};

package/src/controllers/form/fill/createFieldsFillingResultTransformStream.ts

@@ -0,0 +1,138 @@
+import { type LanguageModelV2StreamPart } from '@ai-sdk/provider';
+import { JSONParser } from '@streamparser/json';
+import { createTextInfoEnqueuer } from '@baishuyun/coze-provider';
+import { getLastSubFormField } from './utils.js';
+import { logger } from '../../../logger/index.js';
+
+export const createFieldsFillingResultTransformer = (enableJsonParser: boolean) => {
+  let parser: JSONParser;
+  let id: string;
+  // 解析完成标记：用于等待解析器内部队列处理完毕
+  let parseCompleted: Promise<void>;
+  let resolveParseCompleted: () => void;
+
+  const chunkGuard = (chunk: LanguageModelV2StreamPart): boolean => {
+    if (!enableJsonParser) {
+      return false;
+    }
+
+    if (chunk.type !== 'text-delta' || !('delta' in chunk)) {
+      return false;
+    }
+
+    return true;
+  };
+
+  const transformer = {
+    flush: async (controller: TransformStreamDefaultController<any>) => {
+      try {
+        if (parser) {
+          await parseCompleted; // 等待闭包中的完成标记
+          logger.debug('stop parser');
+          // parser.end(); // 此时调用 end() 不会出现未完成 Token 异常
+        }
+        controller.terminate(); // 信号通知下游可读流已关闭
+      } catch (e) {
+        controller.error('stop error' + e);
+        // controller.terminate(); // 信号通知下游可读流已关闭
+      }
+    },
+
+    transform: (
+      chunk: LanguageModelV2StreamPart,
+      controller: TransformStreamDefaultController<LanguageModelV2StreamPart>
+    ) => {
+      if (!parser) {
+        logger.warn('json parser not init');
+        return;
+      }
+
+      try {
+        if (chunkGuard(chunk)) {
+          if ('id' in chunk && 'delta' in chunk) {
+            id = chunk.id;
+
+            const regExp = /`?`?`?/;
+
+            let delta = chunk.delta.replace(regExp, '');
+            parser.write(delta.replace('json', ''));
+          }
+        } else {
+          controller.enqueue(chunk);
+        }
+      } catch (e) {
+        controller.error(e);
+      }
+    },
+    start: (controller: TransformStreamDefaultController<any>) => {
+      parser = new JSONParser({
+        paths: ['$.*', '$.*.value.*.*'],
+      });
+
+      parseCompleted = new Promise((resolve) => {
+        resolveParseCompleted = resolve;
+      });
+
+      const enqueueTextDelta = enableJsonParser
+        ? createTextInfoEnqueuer(controller)
+        : (content: string) => {};
+
+      parser.onValue = (parsedInfo: any) => {
+        const value = parsedInfo.value;
+
+        const subFormField = getLastSubFormField(parsedInfo);
+        if (subFormField) {
+          enqueueTextDelta(JSON.stringify(value), {
+            type: 'mcp-fields-json',
+            field: subFormField.value,
+          });
+
+          return;
+        }
+
+        if (value.fieldType === 'subform') {
+          return;
+        }
+
+        enqueueTextDelta(
+          JSON.stringify(value),
+          {
+            type: 'mcp-fields-json',
+            field: value,
+          },
+          id
+        );
+      };
+
+      let errorLogged = false;
+      parser.onError = (err: any) => {
+        // controller.enqueue({
+        //   type: "error",
+        //   error: "JsonWidgetStream: JSON Parsing Error:" + err.message,
+        // });
+        if (!errorLogged) {
+          console.error('JsonWidgetStream: JSON Parsing Error:', err);
+          errorLogged = true;
+        }
+
+        // close stream
+        logger.error('JsonStream: closing stream due to parsing error');
+        controller.terminate(); // 信号通知下游可读流已关闭
+      };
+
+      parser.onEnd = () => {
+        enqueueTextDelta(
+          ' ',
+          JSON.stringify({
+            appendConfirm: 'save-fields',
+          })
+        );
+
+        logger.debug('mark as end');
+        resolveParseCompleted?.();
+      };
+    },
+  };
+
+  return new TransformStream<LanguageModelV2StreamPart, any>(transformer);
+};

package/src/controllers/form/fill/fill.controller.ts

@@ -0,0 +1,45 @@
+import { type Context } from 'hono';
+import { convertToModelMessages, streamText } from 'ai';
+import { logger } from '../../../logger/index.js';
+import { createFillingModel } from './model.js';
+
+/**
+ * 表单填写
+ * @param c
+ * @returns
+ */
+export const fillForm = async (c: Context) => {
+  let requestBody;
+
+  try {
+    const json = await c.req.json();
+    requestBody = json;
+  } catch (_) {
+    return c.json({ error: 'Invalid JSON' }, 400);
+  }
+
+  const formStructure = requestBody.formStructure;
+  if (formStructure) {
+    try {
+      let lastMsg = requestBody.messages[requestBody.messages.length - 1];
+
+      lastMsg.parts.push({
+        type: 'text',
+        text: JSON.stringify(formStructure),
+      });
+    } catch (e) {
+      logger.error('Failed to append form structure');
+    }
+  }
+
+  const stream = streamText({
+    model: createFillingModel(),
+    messages: convertToModelMessages(requestBody.messages),
+    includeRawChunks: true,
+    headers: {
+      'x-user-stage': requestBody.stage,
+    },
+  });
+
+  return stream.toUIMessageStreamResponse();
+};

package/src/controllers/form/fill/model.ts

@@ -0,0 +1,17 @@
+import { createCoze } from '@baishuyun/coze-provider';
+import { createFieldsFillingResultTransformer } from './createFieldsFillingResultTransformStream.js';
+
+import config from 'config';
+
+export const createFillingModel = (enableParser: boolean = true) => {
+  const aiFormFilling = createCoze({
+    apiKey: config.get<string>('agent.form.fill.apiKey'),
+    baseURL: config.get<string>('agent.form.fill.baseUrl'),
+    botId: config.get<string>('agent.form.fill.botId'),
+    extraStreamTransformers: [createFieldsFillingResultTransformer(enableParser)],
+  });
+
+  const formFillingModel = aiFormFilling.chat('chat');
+
+  return formFillingModel;
+};

package/src/controllers/form/fill/utils.ts

@@ -0,0 +1,75 @@
+import type { JSONObject } from "@ai-sdk/provider";
+import config from "config";
+import type { ParsedElementInfo } from "@streamparser/json/utils/types/parsedElementInfo.js";
+import { logger } from "../../../logger/index.js";
+
+export const isSubFormField = (parsedInfo: ParsedElementInfo) => {
+  if (!parsedInfo || !parsedInfo.stack?.length) {
+    return false;
+  }
+
+  const lastStackItem = parsedInfo.stack[parsedInfo.stack.length - 1];
+  return lastStackItem?.key === "value";
+};
+
+export const getLastStackItem = (parsedInfo: ParsedElementInfo) => {
+  if (!parsedInfo || !parsedInfo.stack?.length) {
+    return null;
+  }
+
+  return parsedInfo.stack[parsedInfo.stack.length - 1];
+};
+
+export const getLastSubFormField = (parsedInfo: ParsedElementInfo) => {
+  if (!parsedInfo || !parsedInfo.stack?.length) {
+    return null;
+  }
+
+  const targetStackItem = parsedInfo.stack.findLast((s) => {
+    return (s.value as JSONObject)?.fieldType === "subform";
+  });
+
+  return targetStackItem;
+};
+
+export const parseImg = async (file: File) => {
+  const isImg = file.type.startsWith("image/");
+  if (!isImg) {
+    return null;
+  }
+
+  const ocrApiKey = config.get<string>("agent.form.fill.ocrApiKey");
+  const ocrEndpoint = "https://api.ocr.space/parse/image";
+
+  const formData = new FormData();
+
+  formData.append("language", "chs");
+  formData.append("file", file);
+
+  const response = await fetch(ocrEndpoint, {
+    method: "POST",
+    body: formData,
+    headers: {
+      // Add any auth headers
+      apiKey: ocrApiKey,
+    },
+  });
+
+  const result = await response.json();
+  console.log(result);
+
+  if (result.IsErroredOnProcessing) {
+    logger.error("image ocr parse error");
+    return null;
+  }
+
+  if (!result.ParsedResults || !result.ParsedResults.length) {
+    logger.debug("image ocr parse no result");
+    return null;
+  }
+
+  // join all parsed text
+  const parsedTexts = result.ParsedResults.map((pr: any) => pr.ParsedText);
+
+  return parsedTexts.join("\n");
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+import "../config/index.js";
+import("./app/main.js");

package/src/logger/index.ts

@@ -0,0 +1,54 @@
+import pino from "pino";
+import path from "path";
+import fs from "fs";
+import os from "os";
+import { fileURLToPath } from "url";
+
+const isDev = process.env.NODE_ENV === "development";
+const isProd = process.env.NODE_ENV === "production";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const logDir = path.join(__dirname, "logs");
+if (isProd && !fs.existsSync(logDir)) {
+  fs.mkdirSync(logDir, { recursive: true }); // 递归创建目录
+}
+
+// 3. 初始化 Pino 日志实例
+const logger = pino(
+  {
+    level: isDev ? "debug" : "info",
+    base: isDev
+      ? { pid: false, hostname: false }
+      : { pid: process.pid, hostname: os.hostname() },
+    timestamp: isProd,
+    transport: isDev
+      ? {
+          target: "pino-pretty", // 依赖 pino-pretty
+          options: {
+            colorize: true, // 彩色输出（更易阅读）
+            translateTime: "SYS:yyyy-mm-dd HH:MM:ss", // 时间格式转换
+            ignore: "pid,hostname", // 忽略无用字段
+            singleLine: true, // 单行会输出（简化日志体积）
+          },
+        }
+      : {
+          // 生产环境使用 pino/file 实现日志轮转（官方推荐）
+          target: "pino/file",
+          options: {
+            destination: path.join(logDir, "app.log"), // 基础日志文件路径
+            mkdir: true, // 自动创建日志目录（无需手动判断，可选增强）
+            // 轮转配置
+            rotate: {
+              frequency: "daily", // 轮转频率：每日轮转（支持 hourly/weekly/monthly 等）
+              maxSize: "10m", // 单个日志文件最大体积（支持 k/m/g 单位）
+              maxFiles: 7, // 保留最近 7 个日志文件（自动删除更早的文件）
+            },
+          },
+        },
+  },
+  isProd ? pino.destination(path.join(logDir, "app.log")) : undefined,
+);
+
+export { logger };

package/src/logger/log-middleware.ts

@@ -0,0 +1,25 @@
+import { type Context, type Next } from "hono";
+import { logger } from "./index.js";
+
+export const logMiddleware = async (c: Context, next: Next) => {
+  // 记录请求开始时间
+  const startTime = Date.now();
+  // 执行后续中间件/路由处理逻辑
+  await next();
+  // 计算响应时间
+  const responseTime = Date.now() - startTime;
+  // 记录访问日志（info 级别，核心请求信息）
+  logger.info(
+    {
+      method: c.req.method, // 请求方法 GET/POST 等
+      path: c.req.path, // 请求路径
+      status: c.res.status, // 响应状态码
+      responseTime: `${responseTime}ms`, // 响应时间
+      clientIp:
+        c.req.header("x-forwarded-for") ||
+        c.req.header("remote-addr") ||
+        "unknown", // 客户端 IP
+    },
+    "Request processed",
+  ); // 日志描述信息
+};

package/src/routes/form/form.route.ts

@@ -0,0 +1,23 @@
+import { Hono } from "hono";
+import { fillForm } from "../../controllers/form/fill/fill.controller.js";
+import { clearConversation } from "../../controllers/form/conversation/clear.controller.js";
+import { buildForm } from "../../controllers/form/build/build.controller.js";
+import { uploadAttachment } from "../../controllers/form/attachment-upload.controller.js";
+
+export const createFormRouter = () => {
+  const formRouter = new Hono();
+
+  // 智能填数
+  formRouter.post("/fill", fillForm);
+
+  // 智能搭件
+  formRouter.post("/build", buildForm);
+
+  // 会话清除
+  formRouter.post("/conversation/clear", clearConversation);
+
+  // 附件上传
+  formRouter.post("/attachment/upload", uploadAttachment);
+
+  return formRouter;
+};

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@baishuyun/typescript-config/ts-node.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "outDir": "./dist",
+    "jsxImportSource": "hono/jsx"
+  },
+  "exclude": ["node_modules", "dist"],
+  "include": ["config/**/*", "src/**/*"]
+}