SuperAPI AI 工具集

neutralinojs

编程与开发

查看项目

更新于 10-16 03:59

技能介绍

用途

Neutralino.js Platform Skill 是面向使用 Neutralino.js 构建跨平台桌面应用的整合技能文档。它通过决策树帮助使用者找到合适的 API 与配置选项,再加载对应的详细参考文件。适用场景包括:构建带文件系统操作的桌面工具、执行系统命令或管理进程、创建带托盘图标/通知/剪贴板集成的应用、访问系统信息(CPU、内存、显示器)等。

主要能力(按 API 命名空间)

文档按 ./references/api/ 组织,包含以下命名空间参考:app(应用生命周期、配置、广播)、window(窗口创建、管理、托盘)、filesystem(文件操作、监听器、路径)、os(操作系统操作、环境变量、进程派生)、storage(基于 SQLite 的键值存储)、clipboard(系统剪贴板访问)、computer(系统信息,如内存、操作系统版本)、events(事件系统 on/off/dispatch/broadcast)、extensions(扩展通信)、custom(自定义方法执行)、resources(打包资源访问)、server(服务器信息与配置)、updater(自动更新)、init(初始化)、error-codes(错误码)、global-variables(预定义全局变量)。

CLI 参考位于 ./references/cli/,包括 neu-cli.md(create、run、build、update 等命令)与 internal-cli-arguments.md(框架二进制 CLI 参数)。配置参考位于 ./references/configuration/,包括 neutralino.config.json.md、modes.md(window、browser、cloud、chrome 模式)、project-structure.md。入门参考包括 introduction.md 与 using-frontend-libraries.md(React、Vue、Angular 集成)。How-To 包括 extensions-overview.md 与 auto-updater.md。分发参考位于 distribution/overview.md。

使用方式

文档建议的阅读顺序为:先阅读 getting-started/introduction.md 获取概览,然后按任务选择,例如创建新应用读 cli/neu-cli.md(neu create),使用原生 API 读 api/overview.md 加具体命名空间,窗口管理读 api/window.md 加 configuration/modes.md,文件操作读 api/filesystem.md,配置读 configuration/neutralino.config.json.md,构建扩展读 how-to/extensions-overview.md,自动更新读 how-to/auto-updater.md,前端集成读 getting-started/using-frontend-libraries.md,分发读 distribution/overview.md。

文档给出的关键规则包括:新项目始终使用 neu create <path>,除非明确要求从零开始;前端框架(React、Vue 等)应导入 @neutralinojs/lib,而不是直接引入 neutralino.js;暴露原生 API 时不要使用 tokenSecurity: none,应使用 one-time(默认)以保障安全;配置 nativeAllowList 和 nativeBlockList 限制 API 访问;使用任何原生 API 方法前先调用 Neutralino.init();使用 events.on('windowClose') 妥善处理窗口关闭事件,不要仅依赖关闭按钮。

文档还提供了常见模式示例,包括文件读写与二进制文件操作、文件统计与存在性检查、通过 execCommand 执行命令、通过 spawnProcess 派生后台进程并监听 spawnedProcess 事件(stdOut、stdErr、exit)、向派生进程发送输入、系统托盘菜单设置与 trayMenuItemClicked 事件处理、剪贴板文本与 HTML 读写、CPU 与显示器信息获取、通知(INFO、WARNING、ERROR、QUESTION 图标类型)等。

适用场景

适合需要在 JavaScript/HTML/CSS 技术栈下构建轻量级跨平台桌面应用的开发者,尤其是需要文件系统、进程、系统托盘、剪贴板、系统信息等原生能力的桌面工具类应用,以及需要与 React/Vue/Angular 前端框架集成、构建扩展或实现自动更新的项目。

限制

资料仅提供技能文档的导航与参考结构,未提供具体价格、收费、平台支持清单或性能效果数据,这些内容暂未提供。实际使用需以 Neutralino.js 官方仓库与文档为准:https://github.com/neutralinojs/neutralinojs、https://neutralino.js.org。