@goodandready/dsh-goal 0.1.9 → 0.2.0

package/lib/index.js

@@ -43,6 +43,8 @@ export const Config = z.object({
   autoDrive: z.boolean().default(true).description('Automatically continue the loop after each turn'),
   enableSound: z.boolean().default(true).description('Play synthesized audio chime on goal completion or failure'),
   showQuickLaunchButton: z.boolean().default(true).description('Show quick launch goal button above composer dock'),
+  consecutiveToolFailureLimit: z.number().default(3).description('Auto-pause goal if N consecutive turns encounter tool execution errors (0 to disable)'),
+  enableBrowserNotifications: z.boolean().default(true).description('Show desktop notifications on goal completion or failure'),
   storagePath: z.string().default('').description('Custom filesystem path for persistent state storage'),
 });
 
@@ -61,6 +63,8 @@ export function apply(ctx, config = {}) {
     autoDrive: config?.autoDrive ?? true,
     enableSound: config?.enableSound ?? true,
     showQuickLaunchButton: config?.showQuickLaunchButton ?? true,
+    consecutiveToolFailureLimit: config?.consecutiveToolFailureLimit ?? 3,
+    enableBrowserNotifications: config?.enableBrowserNotifications ?? true,
     storagePath: config?.storagePath,
   };
 
@@ -74,6 +78,7 @@ export function apply(ctx, config = {}) {
     autoDrive: currentSettings.autoDrive,
     enableSound: currentSettings.enableSound,
     showQuickLaunchButton: currentSettings.showQuickLaunchButton,
+    consecutiveToolFailureLimit: currentSettings.consecutiveToolFailureLimit,
     storagePath,
   });
 
@@ -222,6 +227,8 @@ export function apply(ctx, config = {}) {
               autoDrive: typeof live.autoDrive === 'boolean' ? live.autoDrive : currentSettings.autoDrive,
               enableSound: typeof live.enableSound === 'boolean' ? live.enableSound : currentSettings.enableSound,
               showQuickLaunchButton: typeof live.showQuickLaunchButton === 'boolean' ? live.showQuickLaunchButton : currentSettings.showQuickLaunchButton,
+              consecutiveToolFailureLimit: typeof live.consecutiveToolFailureLimit === 'number' ? live.consecutiveToolFailureLimit : currentSettings.consecutiveToolFailureLimit,
+              enableBrowserNotifications: typeof live.enableBrowserNotifications === 'boolean' ? live.enableBrowserNotifications : currentSettings.enableBrowserNotifications,
               storagePath: typeof live.storagePath === 'string' ? live.storagePath : currentSettings.storagePath,
             };
           }
@@ -249,6 +256,7 @@ export function apply(ctx, config = {}) {
       autoDrive: live.autoDrive,
       enableSound: live.enableSound,
       showQuickLaunchButton: live.showQuickLaunchButton,
+      consecutiveToolFailureLimit: live.consecutiveToolFailureLimit,
     });
   };
 
@@ -309,9 +317,15 @@ export function apply(ctx, config = {}) {
   ctx.inject(['systemPrompt'], (pctx) => {
     try {
       if (typeof pctx.systemPrompt?.section === 'function') {
+        // Clear conflicting core tool:goal prompt section if present
+        const globalSections = pctx.systemPrompt.layers?.global?.sections;
+        if (globalSections?.data instanceof Map && globalSections.data.has('tool:goal')) {
+          globalSections.data.delete('tool:goal');
+        }
+
         const order = typeof pctx.systemPrompt.getSectionOrder === 'function'
-          ? (pctx.systemPrompt.getSectionOrder('TOOL_GOAL') || 600)
-          : 600;
+          ? (pctx.systemPrompt.getSectionOrder('TOOL_GOAL') || 2400)
+          : 2400;
 
         const unregisterSection = pctx.systemPrompt.section({
           name: 'tool:dsh-goal',
@@ -335,8 +349,198 @@ export function apply(ctx, config = {}) {
   ctx.inject(['tools'], (tctx) => {
     if (!tctx.tools?.register) return;
 
-    // Инструмент 1: Декомпозиция цели на вехи
-    tctx.tools.register({
+    // Helper: Safely replace or register tool in ToolRuntime
+    const safeRegister = (definition) => {
+      try {
+        const name = definition.name;
+        const globalTools = tctx.tools.layers?.global?.tools;
+        if (globalTools?.data instanceof Map && globalTools.data.has(name)) {
+          globalTools.data.delete(name);
+        }
+        const unregister = tctx.tools.register(definition);
+        if (typeof unregister === 'function') {
+          tctx.effect(() => () => unregister(), `dsh-goal: tool ${name}`);
+        }
+      } catch (err) {
+        console.warn(`[dsh-goal] Tool ${definition.name} registration skipped:`, err.message);
+      }
+    };
+
+    const JSON_OUTPUT = {
+      schema: { type: 'object', additionalProperties: true },
+      render: (_args, val) => [{ type: 'text', text: JSON.stringify(val) }],
+    };
+
+    function formatGoalValue(snap) {
+      if (!snap || !snap.hasActiveGoal) {
+        return { goal: null };
+      }
+      let phase = 'active';
+      if (snap.state === GoalState.PAUSED) phase = 'paused';
+      else if (snap.state === GoalState.COMPLETED) phase = 'complete';
+
+      const roundsStarted = Number.isInteger(snap.iterations) ? snap.iterations : 0;
+      const maxGoalRounds = Number.isInteger(snap.maxIterations) ? snap.maxIterations : 25;
+
+      return {
+        goal: {
+          id: snap.id || 'goal-active',
+          revision: 1,
+          objective: snap.title || 'Goal',
+          phase,
+          roundsStarted,
+          maxGoalRounds,
+        },
+        activation: snap.state === GoalState.RUNNING ? 'armed' : 'disarmed',
+      };
+    }
+
+    // Совместимый инструмент 1: get_goal
+    const handleGetGoal = async (_args, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const snap = engine.getSnapshot(sid);
+      return formatGoalValue(snap);
+    };
+
+    safeRegister({
+      name: 'get_goal',
+      description: 'Read the current same-session goal, including objective, phase, and round limits.',
+      parameters: { type: 'object', properties: {} },
+      output: JSON_OUTPUT,
+      execute: handleGetGoal,
+      handler: handleGetGoal,
+    });
+
+    // Совместимый инструмент 2: create_goal
+    const handleCreateGoal = async (args, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const maxIterations = Number(args.max_goal_rounds) || 25;
+      const snap = engine.startGoal(args.objective, { maxIterations }, sid);
+      return formatGoalValue(snap);
+    };
+
+    safeRegister({
+      name: 'create_goal',
+      description: 'Create one persisted same-session completion goal for long-running autonomous work.',
+      parameters: {
+        type: 'object',
+        properties: {
+          objective: {
+            type: 'string',
+            description: 'The concrete completion objective.',
+          },
+          max_goal_rounds: {
+            type: 'number',
+            description: 'Optional positive integer limit on automatic continuation rounds.',
+          },
+        },
+        required: ['objective'],
+      },
+      output: JSON_OUTPUT,
+      execute: handleCreateGoal,
+      handler: handleCreateGoal,
+    });
+
+    // Совместимый инструмент 3: update_goal (перехватчик authority checks и роутер в GoalEngine)
+    const handleUpdateGoal = async (args, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const action = args.action;
+
+      if (action === 'complete') {
+        const summary = args.blocked_reason || args.objective || 'Goal marked complete';
+        const snap = engine.completeGoal(summary, sid);
+        if (toolCtx?.deferContext) {
+          try {
+            toolCtx.deferContext({
+              type: 'text',
+              text: `<goal_complete>\nObjective: ${JSON.stringify(snap.title || summary)}\nThe goal is marked complete. Summarize what was accomplished for the user.\n</goal_complete>`,
+            });
+          } catch (_) {}
+        }
+        return formatGoalValue(snap);
+      }
+
+      if (action === 'pause') {
+        const reason = args.blocked_reason || 'Paused by model';
+        const snap = engine.pause(reason, sid);
+        return formatGoalValue(snap);
+      }
+
+      if (action === 'resume') {
+        const snap = engine.resume(sid);
+        resumeActiveAgent(undefined, sid);
+        return formatGoalValue(snap);
+      }
+
+      if (action === 'edit') {
+        const snap = engine.getSnapshot(sid);
+        if (args.objective) snap.title = args.objective;
+        if (args.max_goal_rounds) snap.maxIterations = Number(args.max_goal_rounds);
+        engine.emit(sid, true);
+        return formatGoalValue(snap);
+      }
+
+      if (action === 'blocked') {
+        const reason = args.blocked_reason || 'Goal blocked';
+        const snap = engine.pause('Blocked: ' + reason, sid);
+        if (toolCtx?.deferContext) {
+          try {
+            toolCtx.deferContext({
+              type: 'text',
+              text: `<goal_blocked>\nObjective: ${JSON.stringify(snap.title || 'Goal')}\nBlocked: ${JSON.stringify(reason)}\nExplain to the user what blocked progress.\n</goal_blocked>`,
+            });
+          } catch (_) {}
+        }
+        const res = formatGoalValue(snap);
+        if (res.goal) {
+          res.goal.phase = 'blocked';
+          res.goal.blockedReason = { code: 'model-reported', message: reason };
+        }
+        return res;
+      }
+
+      return formatGoalValue(engine.getSnapshot(sid));
+    };
+
+    safeRegister({
+      name: 'update_goal',
+      description: 'Update the active goal: complete, pause, resume, edit, or report blocked.',
+      parameters: {
+        type: 'object',
+        properties: {
+          goal_id: { type: 'string', description: 'Exact id returned by get_goal.' },
+          revision: { type: 'number', description: 'Exact positive revision returned by get_goal.' },
+          action: {
+            type: 'string',
+            enum: ['edit', 'pause', 'resume', 'complete', 'blocked'],
+            description: 'edit | pause | resume | complete | blocked',
+          },
+          objective: { type: 'string', description: 'Replacement objective; valid with action edit.' },
+          max_goal_rounds: { type: 'number', description: 'Replacement cap; valid with action edit.' },
+          blocked_reason: { type: 'string', description: 'Concrete blocking condition; required with action blocked.' },
+        },
+        required: ['action'],
+      },
+      output: JSON_OUTPUT,
+      execute: handleUpdateGoal,
+      handler: handleUpdateGoal,
+    });
+
+    // Инструмент 4: Декомпозиция цели на вехи
+    const handleSetMilestones = async ({ milestones }, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const snap = engine.getSnapshot(sid);
+      if (!snap.hasActiveGoal) {
+        return { error: 'No active goal currently set. Start a goal first.' };
+      }
+      engine.addMilestones(milestones, true, sid);
+      return {
+        success: true,
+        milestones: engine.getSnapshot(sid).milestones,
+      };
+    };
+
+    safeRegister({
       name: 'goal_set_milestones',
       description: 'Break down the current active goal into a sequence of concrete milestones/sub-tasks.',
       parameters: {
@@ -350,22 +554,25 @@ export function apply(ctx, config = {}) {
         },
         required: ['milestones'],
       },
-      handler: async ({ milestones }, toolCtx) => {
-        const sid = sessionIdOf(toolCtx, 'default');
-        const snap = engine.getSnapshot(sid);
-        if (!snap.hasActiveGoal) {
-          return { error: 'No active goal currently set. Start a goal first.' };
-        }
-        engine.addMilestones(milestones, true, sid);
-        return {
-          success: true,
-          milestones: engine.getSnapshot(sid).milestones,
-        };
-      },
+      output: JSON_OUTPUT,
+      execute: handleSetMilestones,
+      handler: handleSetMilestones,
     });
 
-    // Инструмент 2: Обновление статуса вехи
-    tctx.tools.register({
+    // Инструмент 5: Обновление статуса вехи
+    const handleUpdateProgress = async ({ milestone_id, status, notes }, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const ok = engine.updateMilestone(milestone_id, status, notes, sid);
+      if (!ok) {
+        return { error: `Milestone ${milestone_id} not found or no active goal.` };
+      }
+      return {
+        success: true,
+        snapshot: engine.getSnapshot(sid),
+      };
+    };
+
+    safeRegister({
       name: 'goal_update_progress',
       description: 'Update the status of a specific goal milestone and optionally log progress notes.',
       parameters: {
@@ -387,21 +594,23 @@ export function apply(ctx, config = {}) {
         },
         required: ['milestone_id', 'status'],
       },
-      handler: async ({ milestone_id, status, notes }, toolCtx) => {
-        const sid = sessionIdOf(toolCtx, 'default');
-        const ok = engine.updateMilestone(milestone_id, status, notes, sid);
-        if (!ok) {
-          return { error: `Milestone ${milestone_id} not found or no active goal.` };
-        }
-        return {
-          success: true,
-          snapshot: engine.getSnapshot(sid),
-        };
-      },
+      output: JSON_OUTPUT,
+      execute: handleUpdateProgress,
+      handler: handleUpdateProgress,
     });
 
-    // Инструмент 3: Успешное завершение цели
-    tctx.tools.register({
+    // Инструмент 6: Успешное завершение цели
+    const handleGoalFinish = async ({ summary }, toolCtx) => {
+      const sid = sessionIdOf(toolCtx, 'default');
+      const snap = engine.completeGoal(summary, sid);
+      return {
+        success: true,
+        completed: true,
+        summary,
+      };
+    };
+
+    safeRegister({
       name: 'goal_finish',
       description: 'Conclude the active goal successfully with a final summary and achievements.',
       parameters: {
@@ -414,15 +623,9 @@ export function apply(ctx, config = {}) {
         },
         required: ['summary'],
       },
-      handler: async ({ summary }, toolCtx) => {
-        const sid = sessionIdOf(toolCtx, 'default');
-        const snap = engine.completeGoal(summary, sid);
-        return {
-          success: true,
-          completed: true,
-          summary,
-        };
-      },
+      output: JSON_OUTPUT,
+      execute: handleGoalFinish,
+      handler: handleGoalFinish,
     });
   });
 
@@ -553,6 +756,20 @@ export function apply(ctx, config = {}) {
                   resumeActiveAgent(startPrompt, sid);
                   break;
                 }
+                case 'nudge': {
+                  const text = (typeof data.text === 'string' ? data.text : (data.notes || data.nudge || '')).trim();
+                  if (!text) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'Nudge text cannot be empty' }));
+                  }
+                  result = engine.nudge(text, sid);
+                  if (data.resume) {
+                    engine.resume(sid);
+                    const prompt = engine.getStatePromptInjection(sid);
+                    resumeActiveAgent(prompt, sid);
+                  }
+                  break;
+                }
                 case 'pause':
                   result = engine.pause(reason || 'Пауза по кнопке интерфейса', sid);
                   stopRunningAgents(sid);
@@ -639,6 +856,29 @@ export function apply(ctx, config = {}) {
 
       const snap = engine.getSnapshot(sid);
       if (snap.hasActiveGoal && snap.state === GoalState.RUNNING) {
+        // Tool-Failure Breaker: отслеживание повторяющихся ошибок инструментов
+        const steps = turn?.steps || turn?.turn?.steps || [];
+        const hasStepError = Array.isArray(steps) && steps.some((s) => {
+          return s?.status === 'error' || s?.error || s?.toolResult?.isError;
+        });
+        const hasTurnError = Boolean(turn?.error || turn?.reason?.kind === 'error');
+        const isToolFailure = hasStepError || hasTurnError;
+
+        if (isToolFailure) {
+          const failCount = engine.incrementToolFailureCount(sid);
+          const limit = liveConfig.consecutiveToolFailureLimit;
+          if (limit > 0 && failCount >= limit) {
+            const lang = snap.lang || (snap.title ? detectLanguage(snap.title) : 'en');
+            const pauseReason = lang === 'ru'
+              ? `Повторяющаяся ошибка инструментов (${failCount} подряд) — цель приостановлена для защиты от зацикливания`
+              : `Repeated tool failure (${failCount} consecutive) — goal paused to prevent token burn`;
+            engine.pause(pauseReason, sid);
+            return;
+          }
+        } else {
+          engine.resetToolFailureCount(sid);
+        }
+
         // Проверяем причину завершения хода
         if (turn?.reason?.kind === 'aborted' || turn?.reason?.kind === 'error' || turn?.error) {
           return;
@@ -663,9 +903,18 @@ export function apply(ctx, config = {}) {
           const currentSnap = engine.getSnapshot(sid);
           if (currentSnap.hasActiveGoal && currentSnap.state === GoalState.RUNNING) {
             const currentLang = currentSnap.lang || (currentSnap.title ? detectLanguage(currentSnap.title) : 'en');
-            const promptText = currentLang === 'ru'
+            let promptText = currentLang === 'ru'
               ? 'Продолжай автономное выполнение цели согласно плану работ. Отмечай каждый выполненный шаг через goal_update_progress, а по завершении всех задач вызови goal_finish.'
               : 'Continue autonomous goal execution according to the work plan. Mark each completed step via goal_update_progress, and when all tasks are complete, call goal_finish.';
+
+            if (currentSnap.pendingNudge) {
+              const userNudge = engine.consumePendingNudge(sid);
+              if (userNudge) {
+                promptText = (currentLang === 'ru'
+                  ? `🚨 СРОЧНОЕ УТОЧНЕНИЕ / НАПРАВЛЕНИЕ ОТ ПОЛЬЗОВАТЕЛЯ:\n"${userNudge}"\nСкорректируй выполнение с учётом этого замечания.\n\n`
+                  : `🚨 URGENT USER CLARIFICATION / STEERING:\n"${userNudge}"\nAdjust execution adhering to this feedback.\n\n`) + promptText;
+              }
+            }
             const promptMsg = createGoalUserMessage(promptText);
             let target = sessionAgents.get(sid);
             if (!target && lastActiveAgent && typeof lastActiveAgent.followup === 'function') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-goal",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Autonomous Goal Execution & Multi-Turn Task Tracking Engine with Sticky Header for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",
@@ -14,10 +14,14 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "docs/",
+    "README.ru.md",
+    "README.zh.md",
     "LICENSE",
-    "README.zh.md"
+    "docs/design/DESIGN.md"
   ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -55,8 +59,5 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
-  },
-  "scripts": {
-    "test": "node --test test/*.test.mjs"
   }
-}
+}

package/docs/README.zh.md

@@ -1,143 +0,0 @@
-# 📦 @goodandready/dsh-goal
-
-<div align="center">
-
-<h3>面向 DeepSeek Harness 的自主目标执行、任务里程碑分解与顶部常驻状态条引擎</h3>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-goal"><img src="https://img.shields.io/npm/v/@goodandready/dsh-goal.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>
-  <a href="../LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-goal.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
-  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
-</p>
-
-<!-- 作者所有项目展示页面链接 -->
-<p align="center">
-  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者所有开源项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="所有项目"></a>
-</p>
-
-<p align="center">
-  <a href="../README.md"><b>🇬🇧 English</b></a> •
-  <a href="README.ru.md"><b>🇷🇺 Русский</b></a> •
-  <a href="README.zh.md"><b>🇨🇳 中文说明</b></a>
-</p>
-
-</div>
-
----
-
-## ⚡ 概述与核心解决痛点
-
-复杂的软件工程任务往往需要多步骤的自主循环：将宏观目标分解为里程碑子任务、多轮自动连续推进而无需用户反复手动下发指令，以及对执行过程保持清晰的可视化监控。
-
-**`@goodandready/dsh-goal`** 通过 `/goal` 指令为 DeepSeek Harness 带来原生的目标自主执行系统：
-* 🎯 **顶部常驻状态条**：固定在聊天窗口顶部的状态横幅，显示实时运行计时器（`• 2s`, `• 1m 45s`）、当前目标标题与控制按钮。
-* ⏸️ **自主循环控制 (Play / Pause / Cancel)**：可随时暂停智能体自主多轮循环，或根据需要一键恢复。
-* 📋 **里程碑任务抽屉**：交互式子任务清单，展示完成百分比进度条与执行日志。
-* 🤖 **智能体原生工具**：提供 `goal_set_milestones`, `goal_update_progress`, `goal_finish` 工具。
-* 🛡️ **安全防护机制**：支持配置 `maxIterations` 最大循环轮次，杜绝死循环消耗。
-
----
-
-## 🏛️ 架构设计
-
-```mermaid
-graph TD
-    subgraph Input ["用户交互与输入"]
-        Cmd["聊天斜杠指令: /goal &lt;目标描述&gt;"]
-        API["REST API 路由: POST /dsh-goal/action"]
-    end
-
-    subgraph GoalEngine ["目标生命周期引擎 (lib/index.js)"]
-        State["状态机 (IDLE, RUNNING, PAUSED, COMPLETED)"]
-        Milestones["里程碑分解与进度追踪器"]
-        Disk["状态持久化存储 (~/.dsh/goal-state.json)"]
-    end
-
-    subgraph AgentLoop ["智能体自主执行驱动"]
-        ToolSet["goal_set_milestones"]
-        ToolProgress["goal_update_progress"]
-        ToolFinish["goal_finish"]
-        LimitGuard{"maxIterations 熔断防护"}
-    end
-
-    subgraph UI ["DSH Web 前端界面"]
-        Banner["顶部常驻状态横幅"]
-        Timer["实时执行计时器"]
-        Drawer["里程碑清单详情模态框"]
-        Settings["设置面板卡片 (Schemastery)"]
-    end
-
-    Cmd --> GoalEngine
-    API --> GoalEngine
-    GoalEngine --> State
-    State --> Disk
-    State --> Banner
-    State --> Drawer
-    GoalEngine --> AgentLoop
-    AgentLoop --> LimitGuard
-    ToolSet --> GoalEngine
-    ToolProgress --> GoalEngine
-    ToolFinish --> GoalEngine
-```
-
----
-
-## 📦 快速安装
-
-```bash
-dsh plugin --profile web add @goodandready/dsh-goal
-```
-
-重启 DeepSeek Harness 实例并刷新浏览器页面。
-
----
-
-## 💬 快速上手
-
-在聊天框中直接启动自主目标：
-
-```text
-/goal 重构身份验证中间件并编写端到端集成测试
-```
-
-或通过 REST 接口调用：
-
-```bash
-curl -X POST http://localhost:3080/dsh-goal/action \
-  -H "Content-Type: application/json" \
-  -d '{"action":"start","title":"优化数据库查询性能"}'
-```
-
----
-
-## ⚙️ 配置参数参考 (`settings.yaml`)
-
-```yaml
-dsh-goal:
-  maxIterations: 25
-  autoDrive: true
-  enableSound: true
-```
-
-| 参数项 | 类型 | 默认值 | 说明 |
-|:---|:---|:---|:---|
-| `maxIterations` | `number` | `25` | 安全熔断阈值：单目标允许的最大自主轮次 |
-| `autoDrive` | `boolean` | `true` | 是否在轮次结束后自动驱动智能体继续推进 |
-| `enableSound` | `boolean` | `true` | 目标完成时是否播放提示音效 |
-
----
-
-## 🧪 自动化测试
-
-运行自动化测试套件：
-
-```bash
-npm test
-```
-
----
-
-## 📄 许可证
-
-MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)