@templmf/temp-solf-lmf 0.0.43 → 0.0.45

package/ai-gateway/src/utils/sessionManager.js

@@ -0,0 +1,159 @@
+/**
+ * 会话上下文管理器
+ *
+ * 支持多轮对话的服务端会话存储。
+ * 客户端通过 session_id 关联多次请求，网关自动拼接历史消息。
+ *
+ * 存储结构（内存 Map，生产环境替换为 Redis）：
+ *   sessionId -> {
+ *     messages: [...],      完整对话历史
+ *     createdAt: number,
+ *     updatedAt: number,
+ *     clientId: string,
+ *     metadata: {}          业务元数据（如 ticket 草稿）
+ *   }
+ */
+
+import { v4 as uuidv4 } from "uuid";
+import { logger } from "../utils/logger.js";
+
+const SESSION_TTL_MS = parseInt(process.env.SESSION_TTL_MS || String(24 * 60 * 60 * 1000)); // 默认 24h
+const MAX_HISTORY_MESSAGES = parseInt(process.env.MAX_HISTORY_MESSAGES || "50");
+
+// 内存会话存储
+const sessions = new Map();
+
+// 定期清理过期会话
+setInterval(() => {
+  const now = Date.now();
+  let cleaned = 0;
+  for (const [id, session] of sessions.entries()) {
+    if (now - session.updatedAt > SESSION_TTL_MS) {
+      sessions.delete(id);
+      cleaned++;
+    }
+  }
+  if (cleaned > 0) {
+    logger.info(`Session GC: cleaned ${cleaned} expired sessions`);
+  }
+}, 5 * 60 * 1000); // 每 5 分钟清理一次
+
+// ─────────────────────────────────────────────────────
+// 创建新会话
+// ─────────────────────────────────────────────────────
+export function createSession(clientId, metadata = {}) {
+  const sessionId = uuidv4();
+  const now = Date.now();
+  sessions.set(sessionId, {
+    messages: [],
+    createdAt: now,
+    updatedAt: now,
+    clientId,
+    metadata
+  });
+  return sessionId;
+}
+
+// ─────────────────────────────────────────────────────
+// 获取会话
+// ─────────────────────────────────────────────────────
+export function getSession(sessionId) {
+  const session = sessions.get(sessionId);
+  if (!session) return null;
+
+  // 检查是否过期
+  if (Date.now() - session.updatedAt > SESSION_TTL_MS) {
+    sessions.delete(sessionId);
+    return null;
+  }
+
+  return session;
+}
+
+// ─────────────────────────────────────────────────────
+// 追加消息到会话历史
+// ─────────────────────────────────────────────────────
+export function appendMessages(sessionId, messages) {
+  const session = sessions.get(sessionId);
+  if (!session) return false;
+
+  session.messages.push(...messages);
+  session.updatedAt = Date.now();
+
+  // 超过最大历史消息数时，保留最近的（保留偶数条以维持 user/assistant 交替）
+  if (session.messages.length > MAX_HISTORY_MESSAGES) {
+    const overflow = session.messages.length - MAX_HISTORY_MESSAGES;
+    session.messages = session.messages.slice(overflow);
+  }
+
+  return true;
+}
+
+// ─────────────────────────────────────────────────────
+// 更新会话元数据（用于提单草稿等业务状态）
+// ─────────────────────────────────────────────────────
+export function updateSessionMetadata(sessionId, metadata) {
+  const session = sessions.get(sessionId);
+  if (!session) return false;
+  session.metadata = { ...session.metadata, ...metadata };
+  session.updatedAt = Date.now();
+  return true;
+}
+
+// ─────────────────────────────────────────────────────
+// 获取会话的完整消息历史（用于拼入上游请求）
+// ─────────────────────────────────────────────────────
+export function getSessionMessages(sessionId) {
+  const session = getSession(sessionId);
+  return session ? session.messages : [];
+}
+
+// ─────────────────────────────────────────────────────
+// 上下文压缩：当 token 估算超阈值时，保留首条 + 最近 N 条
+// 简单估算：1 token ≈ 4 字符
+// ─────────────────────────────────────────────────────
+export function compressIfNeeded(messages, maxTokenEstimate = 6000) {
+  const totalChars = messages.reduce((sum, m) => {
+    const content = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+    return sum + content.length;
+  }, 0);
+
+  const estimatedTokens = Math.ceil(totalChars / 4);
+  if (estimatedTokens <= maxTokenEstimate) {
+    return { messages, compressed: false };
+  }
+
+  // 保留首条用户消息（通常包含最重要的背景） + 最近 10 条
+  const recent = messages.slice(-10);
+  const first = messages[0];
+
+  const compressed = [first, ...recent].filter(
+    (m, i, arr) => arr.indexOf(m) === i  // 去重（避免 first 和 recent 重叠）
+  );
+
+  logger.info("Context compressed", {
+    originalMessages: messages.length,
+    compressedMessages: compressed.length,
+    estimatedTokens
+  });
+
+  return { messages: compressed, compressed: true };
+}
+
+// ─────────────────────────────────────────────────────
+// 删除会话
+// ─────────────────────────────────────────────────────
+export function deleteSession(sessionId) {
+  return sessions.delete(sessionId);
+}
+
+// ─────────────────────────────────────────────────────
+// 统计（用于健康检查）
+// ─────────────────────────────────────────────────────
+export function getSessionStats() {
+  return {
+    activeSessions: sessions.size,
+    ttlMs: SESSION_TTL_MS,
+    maxHistoryMessages: MAX_HISTORY_MESSAGES
+  };
+}

package/ai-gateway/src/utils/structuredResponse.js

@@ -0,0 +1,144 @@
+/**
+ * 结构化响应协议处理器
+ *
+ * 客户端可在请求中通过 `x-response-format` header 或 `response_format` 字段
+ * 指定期望的结构化输出类型，网关负责注入对应 prompt 并解析/校验响应。
+ *
+ * 支持的格式：
+ *   - json_object     通用 JSON 对象
+ *   - json_schema     按指定 Schema 返回 JSON
+ *   - markdown        Markdown 文档
+ *   - html            HTML 片段或完整页面
+ *   - ticket_form     提单助手专用：动态表单草稿 + 缺失字段
+ */
+
+// ─────────────────────────────────────────────────────
+// 根据 response_format 注入 system prompt 片段
+// ─────────────────────────────────────────────────────
+export function buildResponseFormatPrompt(responseFormat) {
+  if (!responseFormat) return "";
+
+  const type = responseFormat.type || responseFormat;
+
+  switch (type) {
+
+    case "json_object":
+      return `\n\n【输出格式要求】只返回合法的 JSON 对象，不要有任何 Markdown 代码块包裹，不要有解释文字。`;
+
+    case "json_schema": {
+      const schema = responseFormat.schema || responseFormat.json_schema?.schema;
+      if (!schema) return buildResponseFormatPrompt("json_object");
+      return `\n\n【输出格式要求】严格按照以下 JSON Schema 返回，不要有任何多余内容：
+\`\`\`json
+${JSON.stringify(schema, null, 2)}
+\`\`\`
+直接输出符合 Schema 的 JSON，不要包裹在代码块中。`;
+    }
+
+    case "markdown":
+      return `\n\n【输出格式要求】使用标准 Markdown 格式输出，支持 GFM（表格、代码块、任务列表），不要输出 HTML 标签。`;
+
+    case "html":
+      return `\n\n【输出格式要求】输出完整可渲染的 HTML 片段。要求：
+- 使用语义化标签
+- 内联 CSS 样式（不依赖外部文件）
+- 禁止包含 <script> 标签
+- 直接输出 HTML，不要用代码块包裹`;
+
+    case "ticket_form":
+      return `\n\n【输出格式要求】你是一个提单助手。每次回复必须严格返回如下 JSON 结构，不要有任何额外文字：
+{
+  "reply": "对用户说的话（追问缺失字段或确认完成）",
+  "form_draft": { /* 当前已收集到的字段 key-value */ },
+  "missing_fields": ["字段名1", "字段名2"],
+  "is_complete": false
+}
+当所有必填字段都已收集完毕时，将 is_complete 设为 true，并在 reply 中请用户确认。`;
+
+    case "react_component":
+      return `\n\n【输出格式要求】返回一个完整可运行的 React 函数式组件，格式如下：
+\`\`\`jsx
+// 直接输出 JSX 代码，不要 import React（已全局注入）
+// 使用 Hooks、Tailwind className
+export default function Component() {
+  return ( /* JSX */ );
+}
+\`\`\``;
+
+    case "vue_component":
+      return `\n\n【输出格式要求】返回一个完整的 Vue 3 单文件组件（SFC），格式：
+\`\`\`vue
+<template>...</template>
+<script setup>...</script>
+<style scoped>...</style>
+\`\`\``;
+
+    default:
+      return "";
+  }
+}
+
+// ─────────────────────────────────────────────────────
+// 解析并校验模型返回内容
+// ─────────────────────────────────────────────────────
+export function parseStructuredResponse(content, responseFormat) {
+  if (!responseFormat) return { success: true, data: content };
+
+  const type = responseFormat.type || responseFormat;
+
+  // Markdown / HTML / 组件代码：直接返回原始文本
+  if (["markdown", "html", "react_component", "vue_component"].includes(type)) {
+    return { success: true, data: content };
+  }
+
+  // JSON 类格式：解析并校验
+  if (["json_object", "json_schema", "ticket_form"].includes(type)) {
+    try {
+      // 尝试直接解析
+      const parsed = JSON.parse(content.trim());
+      return { success: true, data: parsed };
+    } catch {
+      // 尝试从 Markdown 代码块中提取
+      const match = content.match(/```(?:json)?\s*([\s\S]*?)\s*```/);
+      if (match) {
+        try {
+          const parsed = JSON.parse(match[1].trim());
+          return { success: true, data: parsed };
+        } catch {
+          // 提取失败
+        }
+      }
+      // 解析失败：返回原始文本，标记失败
+      return {
+        success: false,
+        data: content,
+        error: "响应不是合法 JSON，已返回原始文本"
+      };
+    }
+  }
+
+  return { success: true, data: content };
+}
+
+// ─────────────────────────────────────────────────────
+// 将解析结果包装为统一的响应 choice 格式
+// ─────────────────────────────────────────────────────
+export function wrapStructuredChoice(choice, parseResult, responseFormat) {
+  if (!responseFormat) return choice;
+
+  const type = responseFormat.type || responseFormat;
+  const isJsonType = ["json_object", "json_schema", "ticket_form"].includes(type);
+
+  return {
+    ...choice,
+    message: {
+      ...choice.message,
+      content: isJsonType && parseResult.success
+        ? JSON.stringify(parseResult.data)  // 序列化回字符串，保持 OpenAI 格式兼容
+        : choice.message.content,
+      // 额外字段：方便客户端直接使用
+      parsed: parseResult.success ? parseResult.data : undefined,
+      parse_error: parseResult.error
+    }
+  };
+}

package/ai-gateway/src/utils/toolAdapter.js

@@ -0,0 +1,151 @@
+/**
+ * Tool Use 适配层
+ *
+ * 不同模型对 function calling / tool_use 的支持程度不同：
+ *  - qwen3-coder：支持 tool_call，但部分版本需要特殊处理
+ *  - qwen2.5 系列：标准 OpenAI function calling 格式
+ *  - 不支持 tool 的模型：fallback 到 JSON mode prompt 工程
+ */
+
+// ─────────────────────────────────────────────────────
+// 模型能力配置表
+// ─────────────────────────────────────────────────────
+const MODEL_CAPABILITIES = {
+  // Qwen3-Coder 系列：支持 tool_call，需要设置 tool_choice
+  "qwen3-coder": {
+    toolSupport: "native",
+    toolChoiceFormat: "openai",    // {type: "function", function: {name}}
+    requiresThinkingBlock: true,   // qwen3 有 thinking 模式
+    maxTokens: 32768
+  },
+  "qwen3-coder-plus": {
+    toolSupport: "native",
+    toolChoiceFormat: "openai",
+    requiresThinkingBlock: true,
+    maxTokens: 32768
+  },
+  // Qwen2.5 系列：标准 OpenAI 格式
+  "qwen2.5-72b-instruct": {
+    toolSupport: "native",
+    toolChoiceFormat: "openai",
+    requiresThinkingBlock: false,
+    maxTokens: 8192
+  },
+  "qwen2.5-7b-instruct": {
+    toolSupport: "native",
+    toolChoiceFormat: "openai",
+    requiresThinkingBlock: false,
+    maxTokens: 8192
+  },
+  // 通用兜底：不确定能力时用 prompt 工程模拟
+  "default": {
+    toolSupport: "prompt",         // 降级：通过 prompt 要求返回 JSON
+    toolChoiceFormat: null,
+    requiresThinkingBlock: false,
+    maxTokens: 4096
+  }
+};
+
+// ─────────────────────────────────────────────────────
+// 获取模型能力配置（前缀匹配）
+// ─────────────────────────────────────────────────────
+export function getModelCapabilities(modelName) {
+  if (!modelName) return MODEL_CAPABILITIES["default"];
+
+  const lower = modelName.toLowerCase();
+
+  // 精确匹配
+  if (MODEL_CAPABILITIES[lower]) return MODEL_CAPABILITIES[lower];
+
+  // 前缀匹配：qwen3-coder-xxx → qwen3-coder
+  for (const [key, caps] of Object.entries(MODEL_CAPABILITIES)) {
+    if (key !== "default" && lower.startsWith(key)) return caps;
+  }
+
+  return MODEL_CAPABILITIES["default"];
+}
+
+// ─────────────────────────────────────────────────────
+// 将客户端传入的 tools 转换为目标模型格式
+// ─────────────────────────────────────────────────────
+export function adaptTools(tools, modelName) {
+  const caps = getModelCapabilities(modelName);
+
+  if (!tools || tools.length === 0) return { tools: undefined, toolChoice: undefined };
+
+  if (caps.toolSupport === "native") {
+    // 原样透传（已经是 OpenAI 格式）
+    return { tools, toolChoice: undefined };
+  }
+
+  // toolSupport === "prompt"：模型不支持 native tool，转为 prompt 工程
+  // 把 tools schema 注入 system prompt，要求返回 JSON
+  return {
+    tools: undefined,
+    toolChoice: undefined,
+    toolFallbackPrompt: buildToolFallbackPrompt(tools)
+  };
+}
+
+// ─────────────────────────────────────────────────────
+// 降级时用 prompt 模拟 tool_use
+// ─────────────────────────────────────────────────────
+function buildToolFallbackPrompt(tools) {
+  const toolDescriptions = tools.map(t => {
+    const fn = t.function || t;
+    return `### ${fn.name}\n描述：${fn.description}\n参数 Schema：\n\`\`\`json\n${JSON.stringify(fn.parameters, null, 2)}\n\`\`\``;
+  }).join("\n\n");
+
+  return `\n\n你必须通过调用以下工具来完成任务。请严格按照 JSON 格式返回，不要有任何多余文字：
+\`\`\`json
+{
+  "tool_call": {
+    "name": "<工具名>",
+    "arguments": { <参数> }
+  }
+}
+\`\`\`
+
+可用工具：\n${toolDescriptions}`;
+}
+
+// ─────────────────────────────────────────────────────
+// 解析降级模式下模型返回的 JSON tool call
+// ─────────────────────────────────────────────────────
+export function parseToolFallbackResponse(content) {
+  try {
+    const jsonMatch = content.match(/```json\s*([\s\S]*?)\s*```/);
+    const jsonStr = jsonMatch ? jsonMatch[1] : content;
+    const parsed = JSON.parse(jsonStr.trim());
+
+    if (parsed.tool_call) {
+      return {
+        role: "assistant",
+        content: null,
+        tool_calls: [{
+          id: `call_${Date.now()}`,
+          type: "function",
+          function: {
+            name: parsed.tool_call.name,
+            arguments: JSON.stringify(parsed.tool_call.arguments)
+          }
+        }]
+      };
+    }
+  } catch {
+    // 解析失败返回原始内容
+  }
+  return null;
+}
+
+// ─────────────────────────────────────────────────────
+// Qwen3-Coder 的 thinking block 处理
+// 模型返回 <think>...</think> 块，需要决定是否透传给客户端
+// ─────────────────────────────────────────────────────
+export function stripThinkingBlock(content, keepThinking = false) {
+  if (!content || typeof content !== "string") return content;
+  if (keepThinking) return content;
+
+  // 移除 <think>...</think> 块（qwen3 系列的 CoT 思考过程）
+  return content.replace(/<think>[\s\S]*?<\/think>/g, "").trim();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@templmf/temp-solf-lmf",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "description": "",
   "main": "index.js",
   "scripts": {

package/skill-mcp/README.md

@@ -1,74 +0,0 @@
-# Skills MCP
-
-让 Roo Code 通过 MCP 工具管理和读取 Skills，彻底解决 Windows 路径环境变量问题。
-
-## 安装
-
-```bash
-# 1. 进入项目目录
-cd skills-mcp
-
-# 2. 安装依赖
-npm install
-
-# 3. 编译 TypeScript
-npm run build
-```
-
-## 配置到 Roo Code
-
-在 Roo Code 的 MCP 配置文件中添加（`%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json`）：
-
-```json
-{
-  "mcpServers": {
-    "skills-mcp": {
-      "command": "node",
-      "args": ["C:\\path\\to\\skills-mcp\\dist\\index.js"],
-      "env": {
-        "SKILLS_EXTRA_DIRS": "C:\\Users\\你的用户名\\.roo\\skills"
-      }
-    }
-  }
-}
-```
-
-> `SKILLS_EXTRA_DIRS` 是可选的，用于追加额外的 Skills 目录，多个目录用分号 `;` 分隔。
-
-## 可用工具
-
-| 工具名 | 说明 | 参数 |
-|--------|------|------|
-| `list_skills` | 列出所有可用 Skills | 无 |
-| `read_skill` | 读取指定 Skill 的完整内容 | `name`: skill名称 |
-| `search_skills` | 模糊搜索 Skills（匹配名称或描述） | `query`: 搜索词 |
-| `list_skill_files` | 列出 Skill 目录下的所有附属文件 | `name`: skill名称 |
-
-## Skills 路径查找顺序
-
-1. `%USERPROFILE%\.roo\skills\`（全局，自动解析，不再依赖环境变量字面量）
-2. `<当前工作目录>\.roo\skills\`（项目级，优先级更高，会覆盖同名全局 Skill）
-3. `SKILLS_EXTRA_DIRS` 环境变量中指定的路径（补充）
-
-## 与 Slash Commands 配合使用
-
-在 `.roo\commands\skill.md` 中：
-
-```markdown
----
-description: 调用指定 Skill 的指引来完成任务
-argument-hint: <skill-name>
----
-
-请使用 MCP 工具 read_skill 读取名为 {参数} 的 Skill 内容，然后按其指引执行任务。
-```
-
-在 `.roo\commands\skills.md` 中：
-
-```markdown
----
-description: 列出所有可用的 Skills
----
-
-请使用 MCP 工具 list_skills 列出所有可用的 Skills。
-```