fdnext 是一个面向存储芯片的高性能一站式解析引擎。它为料号 (PN) 解码、NAND Flash ID 检查以及跨厂商、跨存储技术的数据库搜索提供全面支持。
FlashMaster 是 fdnext 引擎的旗舰实现——一个专为工程师设计的存储芯片智能平台。
fdnext 被设计为存储芯片智能平台的核心基石。它将复杂的厂商数据归一化为结构化、可操作的信息，并结合本地资源进行丰富，同时通过严格的结果 contract 验证。
- 料号解析: 即时解析 Raw NAND, eMMC, UFS, DRAM 等复杂料号。
- Flash ID 解析: 通过 typed identifier API 对 NAND Flash ID 进行深度检查。
- 智能资源流: 内置
fdb、mdb、语言包，并支持 Micron FBGA 代码反查。 - 通用调度: 为 Node.js HTTP 和 Cloudflare Workers 提供共享 runtime 层。
- 数据维护: 提供用于 FDB/MDB 生成、爬取、DecodePack 管理以及证据元数据审计的 CLI 工具。
fdnext 采用严格的 TypeScript monorepo 组织。主包已经内置规则、资源和共享 runtime，平台包只保留薄适配器。
- 核心 (
@itxtech/fdnext-core): 引擎、DecodePack 规则 / 编译器、内置资源、result contract 和共享 runtime。 - 适配器: 原生支持 Node.js HTTP 和 Cloudflare Workers。
- 数据工具 (
@itxtech/fdbgen): 提供 FDB 数据库生成、MDB 爬虫及资源聚合等工具。 - 测试与契约 (
@itxtech/fdnext-contract-test): 结果 schema 及行为 contract 验证。 - 旧接口兼容:
@itxtech/fd-server为 FlashMaster Classic 迁移部署提供旧 FlashDetector / FDWebServer HTTP API，并以 Cloudflare Workers 作为首选部署方式。
本项目使用 pnpm 进行工作区管理。
- Node.js 24+
- pnpm 11+
# 安装依赖
pnpm install
# 构建所有包
pnpm build
# 运行测试套件
pnpm test| 命令 | 描述 |
|---|---|
pnpm build |
构建工作区中的所有包 |
pnpm test |
运行所有单元测试和集成测试 |
pnpm typecheck |
在整个仓库运行 TypeScript 类型检查 |
pnpm contract:check |
验证结果 schema 和行为 contract |
pnpm check:decodepack |
检查 DecodePack 结构与维护策略 |
pnpm check:static |
运行 TypeScript 与 DecodePack 静态检查 |
pnpm check |
运行轻量静态检查与 DecodePack 规则门禁 |
pnpm check:pr |
只构建一次并运行完整源码与发布包 contract 门禁 |
pnpm lint |
pnpm check:static 的兼容别名 |
pnpm cli |
运行核心 CLI 工具（DecodePack 管理等） |
pnpm fdbgen:generate |
生成 FDB 数据库 |
| 范围 | 产品族 | 当前覆盖厂商 |
|---|---|---|
| NAND PN | Raw NAND, eMMC, UFS, eMCP/uMCP, E2NAND | Samsung, SK hynix, SanDisk/WD, KIOXIA, Micron, YMTC, Kingston, Longsys, BIWIN, Silicon Motion, ESMT, Macronix, Spectek, Intel |
| DRAM PN | DDR, LPDDR (容量, 代际, 封装, 速度等) | Micron, Crucial, SK hynix, Samsung, Nanya, Elpida, CXMT, GigaDevice, ISSI, Winbond, ESMT, Etron, Spectek, BIWIN, Longsys |
统一文档索引位于 docs/README.md。
- 集成指南：SDK、HTTP 服务和部署说明。
- Server 接口文档：路由、参数和响应 contract。
- FlashDetector 兼容服务：面向 FlashMaster Classic 客户端的
fd-server部署说明，包含 Cloudflare Workers 和 Node.js 方案。 - DecodePack 规范：编写 PN 和 identifier 规则。
- FDBGen 文档：数据库生成和爬取。
- 术语表：规范字段 key 和命名约定。
版权所有 (c) 2019-2026 iTX Technologies
本项目基于 GNU Affero General Public License v3.0 开源。详见 LICENSE 文件。