ym-hermes-desktop 1.0.2 → 1.0.4

package/README.md

@@ -42,6 +42,8 @@ npm run ask "帮我查一下今天杭州天气"   # 单次提问
 
 ## 异步下发（下发即确认，完成后自动上报）
 
+`hermes_chat` MCP 工具与库函数 `dispatch` 均为异步模式：**调用后立即返回「任务名 已下达」**，任务后台执行；完成后自动上报到 `REPORT_URL`（接口约定：raw JSON，上报体 `{ title(标题), content(提纯汇报内容), datetime(完成后+5秒, YYYY-MM-DD HH:mm:ss) }`）。
+
 ```js
 import { dispatch } from './src/hermes.js';
 
@@ -49,12 +51,20 @@ import { dispatch } from './src/hermes.js';
 const ack = dispatch({
   taskName: '周报生成',
   content: '请总结今天的工作生成周报',
-  reportUrl: 'http://你的接口/report',   // 可选；不传则用 .env 的 REPORT_URL
+  reportUrl: 'http://127.0.0.1:3780/api/mcp/yunxiangji',   // 可选；不传则用 .env 的 REPORT_URL
 });
-// ack = { task_name: '周报生成', status: '已下达', received_at: '2026-09-12 22:52:21' }
+// ack = { task_name: '周报生成', status: '已下达', received_at: '2026-09-13 05:38:48' }
 ```
 
-后台执行流程：异步调 Hermes 完成任务 → 组装 `{ task_name, summary, executed_at(YYYY-MM-DD HH:mm:ss), duration_seconds }` → POST 到 `reportUrl`（或 `.env` 的 `REPORT_URL`）。
+上报 JSON 示例：
+
+```json
+{
+  "title": "周报生成",
+  "content": "今天完成了……",
+  "datetime": "2026-09-13 05:38:54"
+}
+```
 
 配合独立上报工具 `ym-hermes-task`（注册进 Hermes 的 MCP 工具 `report_task`）可双保险：客户端上报 + Hermes 任务结束主动上报。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ym-hermes-desktop",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Hermes Agent 接入点客户端与 MCP server：把 Hermes（含其 MCP 工具）通过 OpenAI 兼容 API / MCP stdio 协议暴露给任意 AI 工具。",
   "type": "module",
   "main": "./src/hermes.js",

package/src/hermes.js

@@ -71,6 +71,42 @@ function durationSeconds(ms) {
   return Math.round(ms / 10) / 100;
 }
 
+/** 上报时间相对当前延后 5 秒（接口约定：完成后增加 5 秒） */
+const REPORT_DELAY_MS = 5000;
+
+/**
+ * 组装任务完成上报体（raw JSON）：
+ *   title    标题（任务名）
+ *   content  提纯汇报内容（完成概要）
+ *   datetime 完成后 +5 秒，格式 YYYY-MM-DD HH:mm:ss
+ */
+export function buildReportPayload({ title, content } = {}, now = new Date()) {
+  return {
+    title: String(title ?? ''),
+    content: String(content ?? ''),
+    datetime: nowString(new Date(now.getTime() + REPORT_DELAY_MS)),
+  };
+}
+
+/**
+ * 上报任务完成到 REPORT_URL（.env 配置或参数传入）。
+ * @returns {{ok:boolean, skipped?:boolean, status?:number, payload:object}}
+ */
+export async function reportTaskResult({ title, content, reportUrl } = {}) {
+  const url = reportUrl || loadEnv().reportUrl;
+  const payload = buildReportPayload({ title, content });
+  if (!url) return { ok: false, skipped: true, payload, reason: '未配置 REPORT_URL' };
+  const resp = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  });
+  if (!resp.ok) {
+    throw new Error(`上报失败 HTTP ${resp.status}: ${(await resp.text()).slice(0, 300)}`);
+  }
+  return { ok: true, status: resp.status, payload };
+}
+
 /**
  * 异步下发任务：立即返回「任务名 已下达」，后台执行 Hermes，完成后自动上报。
  *
@@ -93,32 +129,17 @@ export function dispatch({ taskName, content, reportUrl, onDone } = {}) {
 }
 
 async function runTaskAsync({ taskName, content, reportUrl, onDone }) {
-  const startedMs = Date.now();
   const result = await chat({ messages: [{ role: 'user', content }] });
   const summary = result?.choices?.[0]?.message?.content || '(无文本结果)';
 
-  const payload = {
-    task_name: taskName,
-    summary,
-    executed_at: nowString(),
-    duration_seconds: durationSeconds(Date.now() - startedMs),
-  };
-
-  const url = reportUrl || loadEnv().reportUrl;
-  if (url) {
-    const resp = await fetch(url, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    });
-    if (!resp.ok) {
-      throw new Error(`上报失败 HTTP ${resp.status}: ${(await resp.text()).slice(0, 300)}`);
-    }
-    console.log(`[dispatch:${taskName}] 完成并已上报 (HTTP ${resp.status})`);
-  } else {
+  const r = await reportTaskResult({ title: taskName, content: summary, reportUrl });
+  if (r.skipped) {
     console.log(`[dispatch:${taskName}] 完成（未配置 REPORT_URL，跳过上报）`);
+  } else {
+    console.log(`[dispatch:${taskName}] 完成并已上报 (HTTP ${r.status})`);
   }
 
+  const payload = r.payload;
   if (onDone) onDone(payload);
   return payload;
 }

package/src/mcp-server.js

@@ -2,19 +2,22 @@
 /**
  * mcp-server.js — 把 Hermes 能力暴露为 MCP server（stdio 传输）
  *
- * 任何 MCP 客户端（Cursor / Claude Desktop / Cherry Studio 等）连接本 server 后，
- * 可通过 hermes_chat 工具让 Hermes 执行任务（Hermes 会自行调度其注册的工具/MCP）。
+ * hermes_chat 工具为「异步下发」模式：
+ *   调用后立即返回「任务名 已下达」，后台执行 Hermes；任务完成后自动上报到
+ *   REPORT_URL（接口约定：上报体 { executed_at(当前时间+8秒), summary }）。
+ *   因此调用方不会因 Hermes 长任务而超时。
  *
  * 客户端配置：
  * {
  *   "mcpServers": {
  *     "ym-hermes": {
  *       "command": "npx",
- *       "args": ["-y", "ym-hermes-desktop", "ym-hermes-mcp"],
+ *       "args": ["-y", "ym-hermes-desktop"],
  *       "env": {
  *         "HERMES_API_ENDPOINT": "http://127.0.0.1:8642/v1",
  *         "HERMES_API_KEY": "你的 Bearer token",
- *         "HERMES_MODEL": "hermes-agent"
+ *         "HERMES_MODEL": "hermes-agent",
+ *         "REPORT_URL": "http://127.0.0.1:3780/yunxiangji/CreateTask"
  *       }
  *     }
  *   }
@@ -26,11 +29,11 @@ import {
   ListToolsRequestSchema,
   CallToolRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { chat } from './hermes.js';
+import { chat, reportTaskResult, nowString } from './hermes.js';
 import { loadEnv } from './config.js';
 
 const server = new Server(
-  { name: 'ym-hermes-desktop', version: '1.0.0' },
+  { name: 'ym-hermes-desktop', version: '1.0.2' },
   { capabilities: { tools: {} } }
 );
 
@@ -38,7 +41,7 @@ const TOOLS = [
   {
     name: 'hermes_chat',
     description:
-      '向 Hermes Agent 发送对话并获取回复。Hermes 会自动执行它已注册的工具（含 MCP 工具）来完成你的请求。',
+      '下发任务给 Hermes Agent：调用后立即返回「任务名 已下达」，任务在后台异步执行（Hermes 会自行调度它已注册的 MCP 工具）；任务完成后自动上报到 REPORT_URL（上报内容：executed_at 当前时间延后8秒 + summary）。',
     inputSchema: {
       type: 'object',
       properties: {
@@ -57,6 +60,10 @@ const TOOLS = [
             },
           },
         },
+        task_name: {
+          type: 'string',
+          description: '可选，任务名称；不传则取 question 前 20 字',
+        },
       },
     },
   },
@@ -64,6 +71,24 @@ const TOOLS = [
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 
+/** 后台执行 Hermes 任务，完成后自动上报（不阻塞调用方） */
+function runTaskInBackground(taskName, messages) {
+  (async () => {
+    try {
+      const result = await chat({ messages });
+      const summary = result?.choices?.[0]?.message?.content || '(无文本结果)';
+      const r = await reportTaskResult({ title: taskName, content: summary });
+      process.stderr.write(
+        r.skipped
+          ? `[ym-hermes] 任务「${taskName}」完成（未配置 REPORT_URL，未上报）\n`
+          : `[ym-hermes] 任务「${taskName}」完成并已上报 HTTP ${r.status}（${r.payload.executed_at}）\n`
+      );
+    } catch (err) {
+      process.stderr.write(`[ym-hermes] 任务「${taskName}」失败: ${err.message}\n`);
+    }
+  })();
+}
+
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
   if (name !== 'hermes_chat') {
@@ -74,10 +99,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   if (!messages) {
     throw new Error('缺少参数：请提供 question 或 messages');
   }
-  const result = await chat({ messages });
-  const content =
-    result?.choices?.[0]?.message?.content ?? JSON.stringify(result ?? '');
-  return { content: [{ type: 'text', text: String(content) }] };
+  const taskName =
+    String(args.task_name || '').trim() ||
+    String(args.question || 'Hermes 任务').slice(0, 20);
+
+  // 立即返回确认，后台异步执行
+  runTaskInBackground(taskName, messages);
+  return {
+    content: [
+      { type: 'text', text: `「${taskName}」已下达（${nowString()}），后台执行中，完成后自动上报` },
+    ],
+  };
 });
 
 // 启动前给出接入点检查提示（缺失配置时输出到 stderr，不干扰 MCP 协议）