SuperAPI AI 工具集

implementing-msh

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:帮助在使用 MSH(Micro-Service Helper)系列 TypeScript 包的项目中实现功能。该技能按“先定位包、再核对版本”的两步流程工作,因为各包解耦且独立发版,API 随大版本变化(如 logger 的 preset 与 logger-strategy 类、日志级别、导入路径不同)。

已知支持的包与版本:@beecode/msh-app-boot 2.0.2、@beecode/msh-env 2.0.3、@beecode/msh-error 2.0.6、@beecode/msh-logger 2.0.2、@beecode/msh-node-session 4.0.5、@beecode/msh-util 3.0.1、@beecode/msh-config 1.2.2。每个包对应 references/<包>-<版本>.md 参考文件。

用法流程:先读 references/packages.md,将“配置日志、抛出 403、校验环境变量、优雅关闭、请求级会话”等意图映射到相关包,必要时先向用户澄清;再从 package.json 与 package-lock.json 确认已安装版本,与已知版本比较大版本。同大版本可直接依参考文件实现并告知差异;大版本不一致属破坏性边界,需从 GitHub 拉取 README 与 MIGRATION.md(路径如 https://raw.githubusercontent.com/beecode-rs/msh-<pkg>/main/README.md),按其版本写代码;若包未安装,给出参考文件中的安装命令并确认。最后读取对应版本参考文件并实现。

约定:从 npm 包主入口导入(如 import { errorFactory } from '@beecode/msh-error'),预设与策略使用子路径导入;优先使用内置预设与默认策略;抛出 errorFactory() 错误并用 instanceof ErrorBaseModel 捕获结构化字段。若任务与 @beecode/msh-* 无关,则不强行套用该技能。

限制:具体安装命令、导出与示例代码未在此资料中给出,需查阅各版本参考文件;版本漂移时需新增参考文件并更新版本表。