@farm.js/devtools

中文文档
0.1.48发布于 2026/11/01MITTypeScriptES Module

用于Farm.js路由、运行时和浏览器模块的开发工作区检查器

中文使用文档

@farm.js / devtools

Farm的官方DevTools:一个仅用于Farm.js路由、api、集成的开发工作区。 运行时诊断和浏览器模块。它取代了已弃用的内置仪表板。使用Farm徽标、捆绑的Geist字体、浅色/深色主题和语法高亮显示 源代码和JSON与安全复制控制。

import { defineConfig } from "@farm.js/core";
import { devtools } from "@farm.js/devtools";

export default defineConfig({ plugins: [devtools()] });

安装与 pnpm add -D @farm.js/devtools. 打开左下角的启动器或按 Command/Ctrl + Shift + . 在 farm dev. UI只在打开时加载。插件是 从生产配置中删除,没有生产客户机或服务器端点。

选项: launcher?: boolean, shortcut?: string | false, inspect?: boolean. 登记 是选择加入;没有 enabled 选择。没有插件,应用程序就会退回到 已弃用内置仪表板。不要把它和 devtools: false.

插件按插件管理器的执行顺序(pre, normal, post)列出活跃的Farm插件。 带有版本和声明的服务器/客户端钩子名称。它包括声明的遗留钩子名。 这是注册元数据,而不是呼叫跟踪;平行钩可以以不同的顺序完成。 插件配置、公共数据、钩子源和私有状态永远不会序列化。

Inspect将当前应用程序源与Vite缓存的浏览器输出进行比较,而不是单独比较 插件阶段。只有已转换的项目内浏览器源才符合条件;虚拟/服务器仅 模块、依赖项、隐藏路径和外部项目符号链接被排除在外。限制:500个 模块,每个源/输出1 MiB,显示1500行。副本包括完整的有界文本。 当Inspect打开时,所选模块在Vite完成HMR更新后刷新。等待 更新、失败和断开连接将以前显示的代码标记为过时。这重用了应用程序的 Vite连接,不轮询或第二个套接字。其他视图保留了它们的过滤器和选择; 对它们的最新快照使用Refresh。重新加载整个页面会关闭应用程序的面板。

DevTools是只读的,不是公共开发服务器的身份验证边界。环境 快照中没有值;客户端源中的文字不会被编辑。保持发展 私人服务器。资产和高亮显示是本地的,没有CDN调用。

完整的文档: https://farmjs.dev/docs/plugins/devtools

这个包是独立的版本,由工作空间build, test, packing, 以及发布脚本。不会自动添加启动器依赖项。

版本与发布记录

@farm.js/devtools 共发布 58 个版本,首次发布于 2026/09/15;过去 12 个月发布了 58 个版本。

版本发布日期距今
0.1.48latest2026/11/012 天前
0.1.472026/10/313 天前
0.1.462026/10/313 天前
0.1.452026/10/313 天前
0.1.442026/10/313 天前
0.1.432026/10/304 天前

其他发布通道:beta → 0.1.3-beta.0。

关于 @farm.js/devtools 的常见问题

@farm.js/devtools 是什么?

用于Farm.js路由、运行时和浏览器模块的开发工作区检查器

如何安装 @farm.js/devtools?

在项目目录运行 npm install @farm.js/devtools,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@farm.js/core(>=0.1.28 <0.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@farm.js/devtools 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@farm.js/devtools 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@farm.js/devtools 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@farm.js/devtools 可以商用吗?

@farm.js/devtools 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@farm.js/devtools 还在维护吗?

最新版本 0.1.48 发布于 2026/11/01(2 天前);至今共发布 58 个版本,其中过去 12 个月发布了 58 个;首次发布于 2026/09/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。