multi-tasks 3.1.8 → 3.1.9

package/README.md

@@ -10,6 +10,31 @@ Multi-tasks is a toolkit to manage long-term and large-scale parallel computing
 npm install multi-tasks
 ```
 
+## 🎉 What's New — Real-Time Monitoring Has Arrived! 🎉
+
+**1. Install** the monitor:
+
+```bash
+npm install multi-tasks-monitor
+```
+
+**2. Start your multi-tasks run first** — the monitor reads the task folder, which only exists once your run has started. Then either:
+
+- Easiest (multi-tasks 3.1.9+): your startup log prints the complete command — full task folder path included. Copy it into another terminal and run:
+
+```text
+****************************************************************
+[Master]: monitor this task with:
+    npx multi-tasks-monitor --task-dir "D:\tasks\multitasks20260806..." --port 3777
+****************************************************************
+```
+
+- Or just run `npx multi-tasks-monitor` and pick the task folder on the page with "Select Directory".
+
+**3. Watch the monitor page.** The live dashboard opens in your browser automatically — and you can revisit http://localhost:3777 anytime. 🚀
+
+Running multi-tasks older than 3.1.9, or want the full command-line options? See the [multi-tasks-monitor](https://www.npmjs.com/package/multi-tasks-monitor) page.
+
 ### API:
 
 The API has three parts: the entry functions, the config options, and the `helper` object injected into `processTask`.
@@ -272,6 +297,7 @@ Unlike `retry_fails` (which re-runs only the failed tasks), `restart` re-runs **
 
 ### Changelog:
 
+- 3.1.9 Print the multi-tasks-monitor command on startup
 - 3.1.8 Small refinements
 - 3.1.7 onFinish: iterate all succ/failed results via helper.foreachSuccResult/foreachErrorResult
 - 3.1.6 Fix silent task loss under heavy load with maxTaskRetries

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-tasks",
-  "version": "3.1.8",
+  "version": "3.1.9",
   "description": "Multi-process task scheduling based on Node.js cluster, with crash resume and failed-task restart support",
   "main": "index.js",
   "files": [

package/workers/Multithread.js

@@ -225,6 +225,11 @@ const start = (config)=>{
         initPromise.then((updated_config)=>{
             console.log(`  new tasks=${TaskMgr.getTasks('new').length}`);
             config = updated_config;
+            console.log('');//以下: 配套监控工程命令提示, 仅 master 打印一次, 星号边框突出显示
+            console.log('****************************************************************');
+            console.log('[Master]: monitor this task with:');
+            console.log(`    npx multi-tasks-monitor --task-dir "${config.taskFolder}" --port 3777`);
+            console.log('****************************************************************');
             for (let i = 0; i < numOfWorkers; i++) {
                 let worker = cluster.fork();
                 initWorker(worker);