ym-hermes-desktop 1.0.1 → 1.0.3

package/README.md

@@ -27,6 +27,7 @@ HERMES_MODEL=hermes-agent
 - `HERMES_API_ENDPOINT`：Hermes API server 地址（默认本地 8642）
 - `HERMES_API_KEY`：Hermes 的 `API_SERVER_KEY`（与 `~/.hermes/.env` 一致）
 - `HERMES_MODEL`：`/v1/models` 返回的模型 id（默认 `hermes-agent`）
+- `REPORT_URL`：可选。任务完成上报接口（POST），配置后 `dispatch` 异步任务执行完自动上报
 
 ## 使用
 
@@ -37,7 +38,34 @@ npm start          # 交互模式：直接输入问题，Hermes 执行并回答
 npm run ask "帮我查一下今天杭州天气"   # 单次提问
 ```
 
-交互模式内可用 `/models`、`/check`、`/help`、`/exit`。
+交互模式内可用 `/models`、`/check`、`/help`、`/exit`，以及 `/dispatch <任务名> <任务内容...>`（立即返回「任务名 已下达」，后台执行完自动上报）。
+
+## 异步下发（下发即确认，完成后自动上报）
+
+`hermes_chat` MCP 工具与库函数 `dispatch` 均为异步模式：**调用后立即返回「任务名 已下达」**，任务后台执行；完成后自动上报到 `REPORT_URL`（接口约定：上报体 `{ executed_at(当前时间延后8秒，精确到年月日时分秒), summary }`）。
+
+```js
+import { dispatch } from './src/hermes.js';
+
+// 调用后立即返回确认，不等任务执行完
+const ack = dispatch({
+  taskName: '周报生成',
+  content: '请总结今天的工作生成周报',
+  reportUrl: 'http://127.0.0.1:3780/yunxiangji/CreateTask',   // 可选；不传则用 .env 的 REPORT_URL
+});
+// ack = { task_name: '周报生成', status: '已下达', received_at: '2026-09-12 22:52:21' }
+```
+
+上报 JSON 示例：
+
+```json
+{
+  "executed_at": "2026-09-12 23:14:58",
+  "summary": "今天是 2026 年 9 月 12 日，星期六。"
+}
+```
+
+配合独立上报工具 `ym-hermes-task`（注册进 Hermes 的 MCP 工具 `report_task`）可双保险：客户端上报 + Hermes 任务结束主动上报。
 
 ## 作为模块接入你自己的 AI 工具
 

package/package.json

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

package/src/config.js

@@ -40,5 +40,6 @@ export function loadEnv() {
     endpoint: (process.env.HERMES_API_ENDPOINT || dot.HERMES_API_ENDPOINT || '').replace(/\/+$/, ''),
     apiKey: process.env.HERMES_API_KEY || dot.HERMES_API_KEY || '',
     model: process.env.HERMES_MODEL || dot.HERMES_MODEL || 'hermes-agent',
+    reportUrl: (process.env.REPORT_URL || dot.REPORT_URL || '').replace(/\/+$/, ''),
   };
 }

package/src/hermes.js

@@ -8,6 +8,12 @@ import { loadEnv } from './config.js';
 
 const { endpoint, apiKey, model } = loadEnv();
 
+/** 当前时间，格式 YYYY-MM-DD HH:mm:ss（本地时区，精确到秒） */
+export function nowString(date = new Date()) {
+  const p = (n) => String(n).padStart(2, '0');
+  return `${date.getFullYear()}-${p(date.getMonth() + 1)}-${p(date.getDate())} ${p(date.getHours())}:${p(date.getMinutes())}:${p(date.getSeconds())}`;
+}
+
 /** 发起一次 chat 请求（非流式） */
 export async function chat({ messages, tools = [], toolChoice = undefined, temperature = undefined }) {
   if (!endpoint || !apiKey) {
@@ -59,3 +65,77 @@ export function summarizeChoice(choice) {
   if (lines.length === 0) lines.push('(无文本输出)');
   return lines.join('\n');
 }
+
+/** 秒级耗时 */
+function durationSeconds(ms) {
+  return Math.round(ms / 10) / 100;
+}
+
+/** 上报时间相对当前延后 8 秒（接口约定） */
+const REPORT_DELAY_MS = 8000;
+
+/**
+ * 组装任务完成上报体：只含 executed_at（当前时间 +8 秒，精确到年月日时分秒）与 summary
+ */
+export function buildReportPayload(summary, now = new Date()) {
+  return {
+    executed_at: nowString(new Date(now.getTime() + REPORT_DELAY_MS)),
+    summary: String(summary ?? ''),
+  };
+}
+
+/**
+ * 上报任务完成到 REPORT_URL（.env 配置或参数传入）。
+ * @returns {{ok:boolean, skipped?:boolean, status?:number, payload:object}}
+ */
+export async function reportTaskResult({ summary, reportUrl, taskName = '' } = {}) {
+  const url = reportUrl || loadEnv().reportUrl;
+  if (!url) return { ok: false, skipped: true, payload: buildReportPayload(summary), reason: '未配置 REPORT_URL' };
+  const payload = buildReportPayload(summary);
+  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，完成后自动上报。
+ *
+ * @param {object} opts
+ * @param {string} opts.taskName     任务名称（会出现在确认与上报中）
+ * @param {string} opts.content      要 Hermes 执行的任务内容
+ * @param {string} [opts.reportUrl]  上报接口 URL（默认取 .env 的 REPORT_URL）
+ * @param {Function} [opts.onDone]   可选回调 (payload) => void，任务完成上报后调用
+ * @returns {{task_name:string, status:string, received_at:string}} 立即返回的确认
+ */
+export function dispatch({ taskName, content, reportUrl, onDone } = {}) {
+  if (!taskName || !content) throw new Error('dispatch 需要 taskName 和 content');
+  const ack = { task_name: taskName, status: '已下达', received_at: nowString() };
+
+  runTaskAsync({ taskName, content, reportUrl, onDone }).catch((err) => {
+    console.error(`[dispatch:${taskName}] 任务执行/上报失败: ${err.message}`);
+  });
+
+  return ack;
+}
+
+async function runTaskAsync({ taskName, content, reportUrl, onDone }) {
+  const result = await chat({ messages: [{ role: 'user', content }] });
+  const summary = result?.choices?.[0]?.message?.content || '(无文本结果)';
+
+  const r = await reportTaskResult({ summary, reportUrl, taskName });
+  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/index.js

@@ -12,7 +12,7 @@
  * 你自己的 AI 工具可直接 import src/hermes.js 使用。
  */
 import readline from 'node:readline';
-import { chat, listModels, summarizeChoice } from './hermes.js';
+import { chat, listModels, summarizeChoice, dispatch } from './hermes.js';
 import { loadEnv } from './config.js';
 
 function printHelp() {
@@ -99,6 +99,21 @@ async function main() {
           }
         } else if (input === '/check') {
           await checkHealth();
+        } else if (input.startsWith('dispatch ')) {
+          // dispatch <任务名> <任务内容...>
+          const parts = input.slice('dispatch '.length).split(/\s+/);
+          const taskName = parts.shift();
+          const content = parts.join(' ');
+          if (!taskName || !content) {
+            console.log('用法: dispatch <任务名> <任务内容...>');
+          } else {
+            try {
+              const ack = dispatch({ taskName, content });
+              console.log(`✓ ${ack.task_name} ${ack.status}（${ack.received_at}），后台执行中，完成后自动上报`);
+            } catch (err) {
+              console.log(`✗ ${err.message}`);
+            }
+          }
         } else {
           try {
             await askOnce(input);

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({ summary, taskName });
+      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 协议）