@flun/flun 8.0.4 → 8.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -7
- package/LICENSE +33 -33
- package/README.md +13 -16
- package/{cli.js → bin/cli.js} +21 -18
- package/package.json +6 -6
- package/packages.json +12 -12
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# 更新日志
|
|
2
2
|
|
|
3
|
+
## [8.1.0] - 2026-11-05 10:51
|
|
4
|
+
### 变更
|
|
5
|
+
- 命令行入口由根目录 `cli.js` 迁至 `bin/cli.js`;`bin` 字段同步更新;`npx @flun/flun` 与 `flun` 的调用方式不变,
|
|
6
|
+
仅硬编码 `node node_modules/@flun/flun/cli.js` 的脚本需改路径;
|
|
7
|
+
|
|
8
|
+
### 优化
|
|
9
|
+
- 帮助文本改为分组结构,按「命令」「选项」分节;各条目的参数示例写入说明,如 `search <keyword>`;
|
|
10
|
+
- 帮助与运行输出统一使用 chalk 按语义着色:`用法:` 用 `blueBright`,分组名用 `cyan`,
|
|
11
|
+
命令名用 `cyanBright`,说明用 `gray`;
|
|
12
|
+
- 移除输出中的 emoji 前缀,改为 `·`/`⚠` 加语义色;
|
|
13
|
+
|
|
14
|
+
### 文档
|
|
15
|
+
- README 目录结构按文件类型分组,与 `package.json` 的 `files` 字段顺序一致,并补 `bin/`;
|
|
16
|
+
|
|
3
17
|
## [8.0.4] - 2026-11-01 16:22
|
|
4
18
|
### 优化
|
|
5
19
|
- 单包详情页的"安装"行按标签与值分级着色,标签与"版本"行一致;
|
|
@@ -7,10 +21,4 @@
|
|
|
7
21
|
|
|
8
22
|
## [8.0.3] - 2026-11-01 15:59
|
|
9
23
|
### 优化
|
|
10
|
-
- 优化了指向本工具更新容易引起误会的说辞:"当前包有新版...",直接改成"@flun/flun有新版...";
|
|
11
|
-
|
|
12
|
-
## [8.0.2] - 2026-11-01 15:39
|
|
13
|
-
### 变更
|
|
14
|
-
- 调整列表配色,提升状态辨识度:分组标题已装为青色、未装为深蓝色;
|
|
15
|
-
版本号未安装或低于 npm 最新为深蓝色,已装且无需更新为青色,可升级的目标版本为绿色;
|
|
16
|
-
- 包简介改用暗灰色,与版本状态、安装命令等前景信息区分;
|
|
24
|
+
- 优化了指向本工具更新容易引起误会的说辞:"当前包有新版...",直接改成"@flun/flun有新版...";
|
package/LICENSE
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
ISC 许可证 (ISC License)
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026, flun <open@flun.top>
|
|
4
|
-
|
|
5
|
-
特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
|
|
6
|
-
包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
|
|
7
|
-
并允许向其提供本软件的人这样做,但须满足以下条件:
|
|
8
|
-
|
|
9
|
-
上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
|
|
10
|
-
|
|
11
|
-
本软件按"原样"提供,不作任何形式的明示或暗示的保证,
|
|
12
|
-
包括但不限于适销性、特定用途的适用性和不侵权的保证;
|
|
13
|
-
在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
|
|
14
|
-
任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
英文原文 (English Version)
|
|
19
|
-
|
|
20
|
-
ISC License
|
|
21
|
-
|
|
22
|
-
Copyright (c) 2026, flun <open@flun.top>
|
|
23
|
-
|
|
24
|
-
Permission to use, copy, modify, and/or distribute this software for any
|
|
25
|
-
purpose with or without fee is hereby granted, provided that the above
|
|
26
|
-
copyright notice and this permission notice appear in all copies.
|
|
27
|
-
|
|
28
|
-
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
29
|
-
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
30
|
-
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
31
|
-
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
32
|
-
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
33
|
-
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
1
|
+
ISC 许可证 (ISC License)
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026, flun <open@flun.top>
|
|
4
|
+
|
|
5
|
+
特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
|
|
6
|
+
包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
|
|
7
|
+
并允许向其提供本软件的人这样做,但须满足以下条件:
|
|
8
|
+
|
|
9
|
+
上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
|
|
10
|
+
|
|
11
|
+
本软件按"原样"提供,不作任何形式的明示或暗示的保证,
|
|
12
|
+
包括但不限于适销性、特定用途的适用性和不侵权的保证;
|
|
13
|
+
在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
|
|
14
|
+
任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
英文原文 (English Version)
|
|
19
|
+
|
|
20
|
+
ISC License
|
|
21
|
+
|
|
22
|
+
Copyright (c) 2026, flun <open@flun.top>
|
|
23
|
+
|
|
24
|
+
Permission to use, copy, modify, and/or distribute this software for any
|
|
25
|
+
purpose with or without fee is hereby granted, provided that the above
|
|
26
|
+
copyright notice and this permission notice appear in all copies.
|
|
27
|
+
|
|
28
|
+
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
29
|
+
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
30
|
+
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
31
|
+
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
32
|
+
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
33
|
+
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
34
34
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
package/README.md
CHANGED
|
@@ -28,16 +28,17 @@ Flun 生态包索引:列出全部官方包、查看用途与安装命令、一
|
|
|
28
28
|
|
|
29
29
|
```
|
|
30
30
|
@flun/flun/
|
|
31
|
-
├──
|
|
32
|
-
|
|
33
|
-
├── flun.js
|
|
34
|
-
├── index.
|
|
35
|
-
├──
|
|
36
|
-
├──
|
|
37
|
-
├──
|
|
38
|
-
├──
|
|
39
|
-
├──
|
|
40
|
-
|
|
31
|
+
├── bin/
|
|
32
|
+
│ └── cli.js 命令行入口(bin: flun)
|
|
33
|
+
├── flun.js list / info / search / stats 四个函数
|
|
34
|
+
├── index.js 库入口,转发 flun.js 的导出
|
|
35
|
+
├── net.js 联网查询最新版本与本地缓存
|
|
36
|
+
├── index.d.ts 类型声明
|
|
37
|
+
├── packages.json 包清单数据
|
|
38
|
+
├── CHANGELOG.md 更新日志
|
|
39
|
+
├── README.md 本文件
|
|
40
|
+
├── package.json 包配置
|
|
41
|
+
└── LICENSE 许可
|
|
41
42
|
```
|
|
42
43
|
|
|
43
44
|
---
|
|
@@ -63,14 +64,10 @@ Flun 生态包索引:列出全部官方包、查看用途与安装命令、一
|
|
|
63
64
|
|
|
64
65
|
## 安装
|
|
65
66
|
|
|
66
|
-
项目内安装(作为开发工具):
|
|
67
67
|
```sh
|
|
68
|
-
npm i -D @flun/flun
|
|
69
|
-
```
|
|
68
|
+
npm i -D @flun/flun # 项目内安装(作为开发工具)
|
|
70
69
|
|
|
71
|
-
全局安装(建议)
|
|
72
|
-
```sh
|
|
73
|
-
npm i -g @flun/flun # 之后使用 `flun` 查看用法
|
|
70
|
+
npm i -g @flun/flun # 全局安装(建议);之后使用 `flun` 查看用法
|
|
74
71
|
|
|
75
72
|
```
|
|
76
73
|
|
package/{cli.js → bin/cli.js}
RENAMED
|
@@ -3,8 +3,8 @@ import fs from 'fs';
|
|
|
3
3
|
import path from 'path';
|
|
4
4
|
import { execSync } from 'child_process';
|
|
5
5
|
import chalk from 'chalk';
|
|
6
|
-
import { list, info, search, stats } from '
|
|
7
|
-
import { resolveLatest } from '
|
|
6
|
+
import { list, info, search, stats } from '../index.js';
|
|
7
|
+
import { resolveLatest } from '../net.js';
|
|
8
8
|
|
|
9
9
|
const GOLD = '#B8860B',
|
|
10
10
|
dispWidth = s => {
|
|
@@ -61,29 +61,32 @@ const GOLD = '#B8860B',
|
|
|
61
61
|
if (dir) {
|
|
62
62
|
const readme = path.join(dir, 'README.md');
|
|
63
63
|
if (fs.existsSync(readme)) {
|
|
64
|
-
console.log(chalk.cyan('
|
|
64
|
+
console.log(chalk.cyan('打开本地文档: ') + chalk.gray(readme));
|
|
65
65
|
execSync(`start "" "${readme}"`, { shell: true, stdio: 'ignore' });
|
|
66
66
|
return;
|
|
67
67
|
}
|
|
68
|
-
return console.log(chalk.yellow(
|
|
68
|
+
return console.log(chalk.yellow('⚠ ') + ` 已安装但缺少 README.md`);
|
|
69
69
|
}
|
|
70
70
|
const url = `https://www.npmjs.com/package/${name}`;
|
|
71
|
-
console.log(chalk.yellow(
|
|
71
|
+
console.log(chalk.yellow('· ') + ` 未安装`), console.log(chalk.gray(` 安装: ${pkg.install}`));
|
|
72
72
|
console.log(chalk.gray(` 在线文档: ${url}`));
|
|
73
73
|
execSync(`start "" "${url}"`, { shell: true, stdio: 'ignore' });
|
|
74
74
|
},
|
|
75
|
-
printHelp = () =>
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
75
|
+
printHelp = () => {
|
|
76
|
+
const cmd = (name, desc) => ` ${chalk.cyanBright(name.padEnd(20))}${chalk.gray(desc)}`,
|
|
77
|
+
grp = name => ` ${chalk.cyan(name)}`;
|
|
78
|
+
console.log([
|
|
79
|
+
` ${chalk.blueBright('用法:')} flun <命令> [选项]`, '',
|
|
80
|
+
grp('命令'),
|
|
81
|
+
cmd('pkgs', '列出全部包,按已装与未装分组'),
|
|
82
|
+
cmd('search <keyword>', '按包名或描述中的关键字搜索'),
|
|
83
|
+
cmd('info <name>', '查看单包详情;已装打开本地 README,未装打开 npm 页面'),
|
|
84
|
+
cmd('stats', '输出收录包时间、数量与最高版本'), '',
|
|
85
|
+
grp('选项'),
|
|
86
|
+
cmd('-r', '重新查询 npm 最新版本,忽略 1 小时缓存;仅对 pkgs 与 info 生效;完整写法 --refresh'), '',
|
|
87
|
+
` ${chalk.gray('无参数、help、-h、--help 输出本帮助;')}`
|
|
88
|
+
].join('\n'));
|
|
89
|
+
},
|
|
87
90
|
printList = async refresh => {
|
|
88
91
|
const rows = list(), { data: latest, online } = await resolveLatest(rows.map(r => r.name), refresh),
|
|
89
92
|
width = Math.max(...rows.map(r => r.name.length)), groups = [[], []];
|
|
@@ -132,7 +135,7 @@ const GOLD = '#B8860B',
|
|
|
132
135
|
},
|
|
133
136
|
checkSelfUpdate = async refresh => {
|
|
134
137
|
try {
|
|
135
|
-
const self = JSON.parse(fs.readFileSync(new URL('
|
|
138
|
+
const self = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version,
|
|
136
139
|
M = '@flun/flun', { data, online } = await resolveLatest([M], refresh), latest = data[M];
|
|
137
140
|
if (!online || !latest || latest === self) return;
|
|
138
141
|
const x = latest.split('.').map(Number), y = self.split('.').map(Number);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@flun/flun",
|
|
3
|
-
"version": "8.0
|
|
3
|
+
"version": "8.1.0",
|
|
4
4
|
"description": "Flun 生态包索引:列出全部官方包、查看用途与用法、一键打开文档;",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "index.d.ts",
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
},
|
|
10
10
|
"main": "index.js",
|
|
11
11
|
"bin": {
|
|
12
|
-
"flun": "cli.js"
|
|
12
|
+
"flun": "bin/cli.js"
|
|
13
13
|
},
|
|
14
14
|
"scripts": {
|
|
15
15
|
"build:index": "node scripts/build-index.js"
|
|
@@ -25,15 +25,15 @@
|
|
|
25
25
|
"cli"
|
|
26
26
|
],
|
|
27
27
|
"files": [
|
|
28
|
-
"
|
|
28
|
+
"bin/",
|
|
29
29
|
"flun.js",
|
|
30
|
-
"index.d.ts",
|
|
31
30
|
"index.js",
|
|
32
31
|
"net.js",
|
|
33
|
-
"
|
|
32
|
+
"index.d.ts",
|
|
34
33
|
"packages.json",
|
|
35
34
|
"CHANGELOG.md",
|
|
36
|
-
"README.md"
|
|
35
|
+
"README.md",
|
|
36
|
+
"LICENSE"
|
|
37
37
|
],
|
|
38
38
|
"author": "flun <open@flun.top>",
|
|
39
39
|
"dependencies": {
|
package/packages.json
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
{
|
|
2
2
|
"_stats": {
|
|
3
|
-
"generatedAt": "2026-11-
|
|
4
|
-
"ecosystemMax": "6.
|
|
3
|
+
"generatedAt": "2026-11-05T02:52:32.013Z",
|
|
4
|
+
"ecosystemMax": "6.5.1",
|
|
5
5
|
"packageCount": 13
|
|
6
6
|
},
|
|
7
7
|
"@flun/desktop-builder": {
|
|
8
|
-
"version": "6.
|
|
8
|
+
"version": "6.5.1",
|
|
9
9
|
"desc": "将任意 Node.js 网站一键打包为当前桌面应用('win', 'mac', 'linux')(基于 Electron),支持高度自定义配置;",
|
|
10
10
|
"install": "npm i @flun/desktop-builder"
|
|
11
11
|
},
|
|
12
12
|
"@flun/dns-auto-ssl": {
|
|
13
|
-
"version": "2.0.
|
|
13
|
+
"version": "2.0.2",
|
|
14
14
|
"desc": "自动通过 DNS API 申请 SSL 证书并配置自动续期 (基于 lego v5)",
|
|
15
15
|
"install": "npm i @flun/dns-auto-ssl"
|
|
16
16
|
},
|
|
17
17
|
"@flun/env": {
|
|
18
|
-
"version": "3.2.
|
|
19
|
-
"desc": "
|
|
18
|
+
"version": "3.2.2",
|
|
19
|
+
"desc": "一个用于读取 .env 环境文件的简单包",
|
|
20
20
|
"install": "npm i @flun/env"
|
|
21
21
|
},
|
|
22
22
|
"@flun/html-template": {
|
|
23
|
-
"version": "
|
|
24
|
-
"desc": "一个HTML
|
|
23
|
+
"version": "6.0.0",
|
|
24
|
+
"desc": "一个HTML模板工具包,提供开发服务器和模板编译功能,支持自定义标签、快捷输入、变量、包含文件,模块化处理HTML;",
|
|
25
25
|
"install": "npm i @flun/html-template"
|
|
26
26
|
},
|
|
27
27
|
"@flun/mailer": {
|
|
@@ -30,17 +30,17 @@
|
|
|
30
30
|
"install": "npm i @flun/mailer"
|
|
31
31
|
},
|
|
32
32
|
"@flun/node-mobile-app": {
|
|
33
|
-
"version": "4.0.
|
|
33
|
+
"version": "4.0.9",
|
|
34
34
|
"desc": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供;",
|
|
35
35
|
"install": "npm i @flun/node-mobile-app"
|
|
36
36
|
},
|
|
37
37
|
"@flun/nodejs-mobile-gyp": {
|
|
38
|
-
"version": "1.
|
|
38
|
+
"version": "1.2.0",
|
|
39
39
|
"desc": "Node.js for Mobile Apps native addon build tool (flun fork)",
|
|
40
40
|
"install": "npm i @flun/nodejs-mobile-gyp"
|
|
41
41
|
},
|
|
42
42
|
"@flun/nodejs-mobile-react-native": {
|
|
43
|
-
"version": "2.1.
|
|
43
|
+
"version": "2.1.2",
|
|
44
44
|
"desc": "Node.js for Mobile Apps React Native plugin (flun fork, based on nodejs-mobile-react-native)",
|
|
45
45
|
"install": "npm i @flun/nodejs-mobile-react-native"
|
|
46
46
|
},
|
|
@@ -65,7 +65,7 @@
|
|
|
65
65
|
"install": "npm i @flun/webauthn-server"
|
|
66
66
|
},
|
|
67
67
|
"@flun/windows": {
|
|
68
|
-
"version": "
|
|
68
|
+
"version": "4.0.0",
|
|
69
69
|
"desc": "支持 Windows 服务、事件日志、UAC 以及多种与操作系统交互的辅助方法",
|
|
70
70
|
"install": "npm i @flun/windows"
|
|
71
71
|
}
|