20 articles tagués avec « release »

import { Configuration, Inject } from '@midwayjs/core';
import * as oneShot from '@midwayjs/one-shot';
import { Framework } from '@midwayjs/one-shot';
import { SyncUserScript } from './script/syncUser';

@Configuration({
  imports: [oneShot],
})
export class MainConfiguration {
  @Inject()
  framework: Framework;

  async onServerReady() {
    await this.framework.runScript(SyncUserScript, { id: 42 });
  }
}

更多说明请参考单次执行组件文档。

Commander 命令行组件

新增 @midwayjs/commander 命令行组件，提供命令注册、参数解析、上下文创建与中间件链支持，并内置基于 enquirer 的交互式提问能力。

示例：

import { Command, CommandRunner } from '@midwayjs/commander';

@Command({ name: 'hello', arguments: '<name>' })
export class HelloCommand implements CommandRunner {
  async run([name]: string[]) {
    return `hello ${name}`;
  }
}

更多说明请参考 Commander 组件文档。

🐛 修复与改进

文档更新：validation 组件升级说明、one-shot 组件文档、commander 目录结构示例

Release 4.0.0-beta.9

January 3, 2026 · 2 minute read

Harry Chen

Maintainer of Midway

这是 Midway 4.0 的第九个 beta 版本。

在这个版本中，我们新增了基于 piscina 的后台任务组件，支持 CPU 密集型任务的处理，同时升级 Zod 至 v4 版本，并修复了 Swagger UI 等问题。

🚀 主要新增功能

Background Task (Piscina) 支持

我们新增了 @midwayjs/piscina 组件，基于 piscina 封装，提供了多线程后台任务处理能力。这使得 Midway 应用可以轻松处理 CPU 密集型任务，而不会阻塞主线程。

你可以使用装饰器快速定义一个后台任务：

import { IPiscinaTask, PiscinaTask } from '@midwayjs/piscina';

/**
 * 计算任务
 */
@PiscinaTask('calculate')
export class CalculateTask implements IPiscinaTask {
  async execute(payload: { a: number; b: number; operation: 'multiply' | 'add' }) {
    const { a = 0, b = 0, operation = 'multiply' } = payload || {};
    
    if (operation === 'multiply') {
      return a * b;
    } else {
      return a + b;
    }
  }
}

并在服务中调用它：

@Inject()
piscinaFramework: PiscinaFramework;

// ...
const result = await this.piscinaFramework.runTask('calculate', {
  a: 10,
  b: 20,
  operation: 'add'
});

更多详细用法请参考 Piscina 组件文档。

Zod v4 支持

我们升级了验证组件以支持 Zod v4 版本，现在你可以使用 Zod v4 的新特性来进行参数校验。

🐛 修复与改进

修复了 Swagger UI displayOptions 渲染字符串的问题
修复了 View 组件中异步渲染触发时机的问题
修复了 Busboy 和 Upload 组件的校验逻辑
新增了服务发现 (Service Discovery) 的文档说明
依赖更新：
- 更新 bullmq 至 v5.66.4
- 更新 express 至 v4.22.1
- 更新 grpc-js 至 v1.14.3

Release 4.0.0-beta.2

October 5, 2025 · 2 minute read

Harry Chen

Maintainer of Midway

这是全新的 Midway 4.0 的第二个 beta 版本。

在这个版本中，我们带来了一些重要的新功能和改进，主要包括 MCP 组件的全面支持以及 mock 组件的测试体验优化。

🚀 主要新增功能

MCP (Model Context Protocol) 支持

我们正式加入了对 MCP 的完整支持。MCP 是由 Anthropic 开发的开放标准协议，用于将 AI 模型与外部数据源和工具安全连接。

Midway 现在提供了：

完整的 MCP 服务器框架封装
支持多种传输方式：stdio、stream-http、sse
基于装饰器的开发体验
与现有 HTTP 框架（Express、Koa、Egg.js）的无缝集成

使用 Midway 可以快速创建 MCP 服务，为 AI 应用程序提供标准化的数据访问和工具调用接口。

import { Tool, IMcpTool } from '@midwayjs/mcp';
import { z } from 'zod';

@Tool('databaes-tool', {
  description: 'A tool to query user information from the database',
  inputSchema: {
    name: z.string().describe('name to query'),
  }
})
export class DatabaseTool implements IMcpTool  {
  async execute(args: { name: string }) {
    // 模拟数据库查询
    return {
      content: [{
        type: 'text',
        text: [{ id: 1, name: args.name }]
      }],
    }
  }
}

更多关于 MCP 的详细使用方法和配置选项，请参考 MCP 组件文档。

Mock 组件测试改进

针对开发者测试体验的优化，我们为 mock 组件的 createApp 方法增加了完整的生命周期支持：

新增 onReady、onStop、onConfigLoad、onServerReady、onHealthCheck 等生命周期钩子

这些改进让测试代码能够更准确地反映真实运行环境的行为，提升测试的可靠性。

const app = await createApp(join(__dirname, 'fixtures', 'base-app'), {
  onReady: async () => {
    console.log('应用准备就绪');
  },
  onStop: async () => {
    console.log('应用停止');
  }
});

Release 4.0.0-beta.1

August 29, 2025 · 4 minute read

Harry Chen

Maintainer of Midway

这是全新的 Midway 4.0 的变化，这是一个非常重大的版本。

全局变化
- 框架支持从 Node.js >=20 开始
- 默认开启 asyncLocalStorage
编程范式
- 不再以黑盒方式提供框架启动时的目录文件扫描自动绑定能力，改为显式声明，每个组件都可以有自己的绑定和加载方式
- 组件包查找规范变化，现在会查找 index.ts，configuration.ts，以及 package.json 中 main 定义的路径
- 统一规范函数式的导出路径，为组件包下的 functional 路径，如 @midwayjs/core/functional
【core】
- 通用能力
  - 由于使用率较低且影响依赖注入容器逻辑，移除了流程控制 Pipeline 相关的能力
  - 移除之前版本中框架启动时的目录文件扫描自动绑定能力，现在需要显式增加一个 file detector，可以自由配置其需要扫描和忽略的目录或者文件
  - 移除了会和 validate 的转换产生歧义的请求参数自动 DTO 转换功能，现在自动转换仅在 validate 或者 validation 组件开启时生效
  - onReady 等生命周期现在增加了超时机制，默认 30s
- 函数式编程
  - 提供与 @Configuration 同样功能的 defineConfiguration 方法
  - 提供内置的 hooks 方法，如 useContext, useLogger, useInject, useConfig, useApp, useMainApp 等
  - 提供了函数式方法的导出规范，新开发的 hooks 放在 functional 目录中，使用子模块方式导出
- 装饰器部分
  - 为了更好的管理元数据，重构了 DecoratorManager，增加新的 MetadataManager，增加了更加方便的聚合和拷贝元数据的能力
  - 明确各种装饰器继承的情况，默认情况下，类装饰器和参数装饰器不继承，属性装饰器和方法装饰器继承
  - 使用 @MainApp() 代替 @App() 空参数
  - 使用 @Config(ALL) 替换为更为明确的 @AllConfig() 装饰器
  - 移除 @Configuration 中的 conflictCheck 和 detectorOptions, 这些配置将移动到 detector 中
  - DecoratorManager 中的 listPrelaodModules 调整为 listPreStartModule，savePreloadModule 调整为 savePreStartModule ，使其语义更加明确
- 依赖注入
  - 移除了 container.get 和 container.getAsync 的一部分无用的参数
  - 优化了循环依赖时展示的依赖链路信息以及 definition 未找到时的输出信息
  - 单例对象现在和 registerObject 的对象存储的位置一致了
  - 增加了一个动态依赖注入容器，用于在开发期动态替换实例，支持 HMR 功能
- 框架机制
  - BaseFramework 移除了令人疑惑的 container 相关 hook 方法，现在都统一使用 applicationInitialize
  - 移除框架的 MidwayFrameworkType，以及对应的 getFrameworkType() 方法
  - 移除了特定框架下令人疑惑的 contextLoggerApplyLogger 和 contextLoggerFormat 配置，现在如果要配置框架特定的 logger，使用 setFrameworkLoggerName 方法
  - ServiceFactory 和 DataSourceManager 现在启动可以通过 initClients 的参数 concurrent 支持并发，由组件自行控制是否支持
  - DataSourceManager 原有的 cacheInstance 和 validateConnection 选项废弃
  - MidwayConfigServce 在获取配置时可以增加默认值
  - 增加服务发现基础功能，增加了 consul 、redis 、etcd 的实现
【decorator】移除，API 都移动到 @midwayjs/core，不再单独提供 4.x 版本
【async-hooks-context-manager】现在默认开启 async_local_storage，代码合并至 core 模块中
【axios】移除了废弃的 axios 导出
【socketio】移除了内置的 socket.io-redis
【validate】
- 由于固化了 Joi 作为验证器，不再更新
- 移除 @Rule 作为类装饰器的功能
- 移除属性 @Rule 参数传递类本身的功能
【validation】新增组件，替代原有 validate 组件
- 支持多种验证器，如 Joi, zod, class-validator，提供内置的 i18n 支持
- 可自定义扩展验证器
【mock】
- 由于移除了框架启动的扫描能力，如果有大量历史测试不方便修改，可以使用提供的 createLegacyApp，createLegacyLightApp，createLegacyFunctionApp ，对应之前的 createApp，createLightApp, createFunctionApp
- 移除了 createApp，createLightApp, createFunctionApp 方法的最后一个参数，现在额外指定组件可以写到 options.imports 中
【sequelize】
- 移除老版本配置的兼容代码，以及历史装饰器导出，如 @BaseTable
- 移除默认启动时数据源连接校验 validateConnection，如有需求，可以在配置中单独开启
【tags】移除，不再提供 4.x 版本
【processAgent】移除，不再提供 4.x 版本
【event-emitter] 新增组件，提供事件触发和监听能力支持

🚀 主要新增功能​

单次执行组件（One-shot）​

Commander 命令行组件​

🐛 修复与改进​

🚀 主要新增功能​

Background Task (Piscina) 支持​

Zod v4 支持​

🐛 修复与改进​

🚀 主要新增功能​

MCP (Model Context Protocol) 支持​

Mock 组件测试改进​

🚀 主要新增功能

单次执行组件（One-shot）

Commander 命令行组件

🐛 修复与改进

🚀 主要新增功能

Background Task (Piscina) 支持

Zod v4 支持

🐛 修复与改进

🚀 主要新增功能

MCP (Model Context Protocol) 支持

Mock 组件测试改进