ym-hermes-desktop 1.0.0 → 1.0.2

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,25 @@ npm start          # 交互模式：直接输入问题，Hermes 执行并回答
 npm run ask "帮我查一下今天杭州天气"   # 单次提问
 ```
 
-交互模式内可用 `/models`、`/check`、`/help`、`/exit`。
+交互模式内可用 `/models`、`/check`、`/help`、`/exit`，以及 `/dispatch <任务名> <任务内容...>`（立即返回「任务名 已下达」，后台执行完自动上报）。
+
+## 异步下发（下发即确认，完成后自动上报）
+
+```js
+import { dispatch } from './src/hermes.js';
+
+// 调用后立即返回确认，不等任务执行完
+const ack = dispatch({
+  taskName: '周报生成',
+  content: '请总结今天的工作生成周报',
+  reportUrl: 'http://你的接口/report',   // 可选；不传则用 .env 的 REPORT_URL
+});
+// ack = { task_name: '周报生成', status: '已下达', received_at: '2026-09-12 22:52:21' }
+```
+
+后台执行流程：异步调 Hermes 完成任务 → 组装 `{ task_name, summary, executed_at(YYYY-MM-DD HH:mm:ss), duration_seconds }` → POST 到 `reportUrl`（或 `.env` 的 `REPORT_URL`）。
+
+配合独立上报工具 `ym-hermes-task`（注册进 Hermes 的 MCP 工具 `report_task`）可双保险：客户端上报 + Hermes 任务结束主动上报。
 
 ## 作为模块接入你自己的 AI 工具
 
@@ -88,7 +107,7 @@ const r = await chat({ messages: [{ role: 'user', content: '你好' }] });
   "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",

package/package.json

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

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,60 @@ export function summarizeChoice(choice) {
   if (lines.length === 0) lines.push('(无文本输出)');
   return lines.join('\n');
 }
+
+/** 秒级耗时 */
+function durationSeconds(ms) {
+  return Math.round(ms / 10) / 100;
+}
+
+/**
+ * 异步下发任务：立即返回「任务名 已下达」，后台执行 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 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 {
+    console.log(`[dispatch:${taskName}] 完成（未配置 REPORT_URL，跳过上报）`);
+  }
+
+  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);