@flun/flun 0.0.0-stage → 7.0.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 +36 -0
- package/LICENSE +34 -0
- package/README.md +142 -2
- package/cli.js +160 -0
- package/flun.js +46 -0
- package/index.d.ts +17 -0
- package/index.js +1 -0
- package/net.js +44 -0
- package/package.json +56 -3
- package/packages.json +77 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# 更新日志
|
|
2
|
+
|
|
3
|
+
## [7.0.0] - 2026-10-31 21:32
|
|
4
|
+
### 新增
|
|
5
|
+
- 新增 `pkg` 子命令,列出全部包并按已装/未装分组;
|
|
6
|
+
- 新增 `search` 子命令,按包名、描述中的关键字搜索;
|
|
7
|
+
- 新增 `info` 子命令,查看单包详情并打开文档;
|
|
8
|
+
- 新增 `stats` 子命令,输出收录包时间、收录包数量与收录最高版本;
|
|
9
|
+
- 新增 `-r` 作为 `--refresh` 的简写;
|
|
10
|
+
### 变更
|
|
11
|
+
- 包名由 `@flun/help` 改为 `@flun/flun`,导入路径同步变更;
|
|
12
|
+
- 无参数、`help`、`-h`、`--help` 改为输出帮助;列包需使用 `pkg`;
|
|
13
|
+
- 单包详情由 `flun <包名>` 改为 `flun info <包名>`;
|
|
14
|
+
- 搜索由 `--search`、`-s` 选项改为 `search` 子命令;
|
|
15
|
+
- 库函数 `meta` 更名为 `stats`,返回字段含义不变;
|
|
16
|
+
- `packages.json` 中的 `_meta` 键更名为 `_stats`;
|
|
17
|
+
- 版本查询缓存文件由 `~/.flun-help-cache.json` 改为 `~/.flun-cache.json`,旧文件不再读取,可手动删除;
|
|
18
|
+
- 颜色按语义调整:列表、收录、搜索结果标题改为绿色,分组标题改为亮青色,新版本号统一使用金色;
|
|
19
|
+
### 修复
|
|
20
|
+
- 修复本地版本高于 npm 最新版本时仍显示升级箭头的问题,现直接显示本地版本;
|
|
21
|
+
- 修复未知命令不打印帮助的问题,现提示未知命令并输出帮助后以非零码退出;
|
|
22
|
+
- 修复 `info`、`search` 缺少参数时的提示与退出码;
|
|
23
|
+
- 统一文件换行为 LF,去除多余空行与缺失的章节分隔线;
|
|
24
|
+
|
|
25
|
+
## [6.2.3] - 2026-10-28 20:37
|
|
26
|
+
### 优化
|
|
27
|
+
- 优化了"package.json"关键字内容;
|
|
28
|
+
|
|
29
|
+
## [6.2.2] - 2026-10-28 16:39
|
|
30
|
+
### 优化
|
|
31
|
+
- 一些内部细节优化;
|
|
32
|
+
|
|
33
|
+
## [6.2.1] - 2026-10-28 16:29
|
|
34
|
+
### 变更
|
|
35
|
+
- 主标题(包列表、包详情、搜索结果、新版本提示)改用亮蓝色,分组标题与属性标签保持青色;
|
|
36
|
+
- 新版本提示行缩进 2,与终端提示符区分;
|
package/LICENSE
ADDED
|
@@ -0,0 +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
|
|
34
|
+
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,143 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @flun/flun
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
## 简介
|
|
4
|
+
|
|
5
|
+
Flun 生态包索引:列出全部官方包、查看用途与安装命令、一键打开文档;
|
|
6
|
+
|
|
7
|
+
收录清单见包内 `packages.json`;命令行运行 `npx @flun/flun pkg` 可查看全部包及安装状态;
|
|
8
|
+
|
|
9
|
+
具体 API 与用法见各包自身文档,本包不重新导出子包功能;
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 特性
|
|
14
|
+
|
|
15
|
+
- 列出全部官方包,按已装/未装分组,显示描述与安装状态;
|
|
16
|
+
- 单包详情显示描述、安装命令与版本,已装包打开本地 `README.md`,未装包打开 npm 页面;
|
|
17
|
+
- `search` 子命令按包名、描述中的关键字搜索;
|
|
18
|
+
- 版本双轨显示:本地已装版本与 npm 最新版本对比,可升级项标为 `旧 → 新 (最新)`;
|
|
19
|
+
- 联网失败或超时时降级为清单记录的版本,不中断使用;
|
|
20
|
+
- npm 版本查询缓存 1 小时,`-r` 或 `--refresh` 可重新查询最新版本;
|
|
21
|
+
- 执行任意命令后检查本包自身是否有新版,有则提示更新命令,避免全局安装长期滞后;
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 包目录结构
|
|
26
|
+
|
|
27
|
+
随包发布的文件:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
@flun/flun/
|
|
31
|
+
├── CHANGELOG.md 更新日志
|
|
32
|
+
├── cli.js 命令行入口(bin: flun)
|
|
33
|
+
├── flun.js list / info / search / stats 四个函数
|
|
34
|
+
├── index.d.ts 类型声明
|
|
35
|
+
├── index.js 库入口,转发 flun.js 的导出
|
|
36
|
+
├── LICENSE 许可
|
|
37
|
+
├── net.js 联网查询最新版本与本地缓存
|
|
38
|
+
├── package.json 包配置
|
|
39
|
+
├── packages.json 包清单数据
|
|
40
|
+
└── README.md 本文件
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 安装前准备
|
|
46
|
+
|
|
47
|
+
### 允许安装脚本执行
|
|
48
|
+
|
|
49
|
+
本包在安装时可能触发某些依赖包的自动脚本(如 `postinstall` 等);如果你的 npm 全局配置或项目配置禁止了脚本执行(例如设置了
|
|
50
|
+
`ignore-scripts=true`),可能会导致安装不完整或运行时异常;
|
|
51
|
+
|
|
52
|
+
推荐在项目根目录的 `package.json` 中添加 `allowScripts` 字段,显式放行本包及其依赖的脚本:
|
|
53
|
+
|
|
54
|
+
```json
|
|
55
|
+
{
|
|
56
|
+
"allowScripts": {
|
|
57
|
+
"@flun/flun": true
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 安装
|
|
65
|
+
|
|
66
|
+
项目内安装(作为开发工具):
|
|
67
|
+
```sh
|
|
68
|
+
npm i -D @flun/flun
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
全局安装(建议):
|
|
72
|
+
```sh
|
|
73
|
+
npm i -g @flun/flun # 之后使用 `flun` 查看用法
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 命令行
|
|
80
|
+
|
|
81
|
+
### 快速开始
|
|
82
|
+
|
|
83
|
+
```sh
|
|
84
|
+
npx @flun/flun pkg
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 子命令
|
|
88
|
+
|
|
89
|
+
| 参数 | 作用 |
|
|
90
|
+
| ----------------- | -------------------------------------------------- |
|
|
91
|
+
| `pkg` | 列出全部包,按已装/未装分组 |
|
|
92
|
+
| `search <关键字>` | 按包名、描述中的关键字搜索 |
|
|
93
|
+
| `info <包名>` | 查看单包详情;已装打开本地 README,未装打开 npm 页面 |
|
|
94
|
+
| `stats` | 输出收录包时间、数量与最高版本 |
|
|
95
|
+
|
|
96
|
+
### 选项
|
|
97
|
+
|
|
98
|
+
| 参数 | 作用 |
|
|
99
|
+
| ----------------- | --------------------------------------------------------------- |
|
|
100
|
+
| `-r`, `--refresh` | 重新查询 npm 最新版本,忽略 1 小时缓存;仅对 `pkg` 与 `info` 生效 |
|
|
101
|
+
|
|
102
|
+
无参数、`help`、`-h`、`--help` 输出帮助;全局安装后把 `npx @flun/flun` 换成 `flun`;
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 函数方式
|
|
107
|
+
|
|
108
|
+
导入 `list`、`info`、`search`、`stats` 四个函数:
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
import { list, info, search, stats } from '@flun/flun';
|
|
112
|
+
|
|
113
|
+
list(); // 全部包的元数据数组
|
|
114
|
+
info('@flun/mailer'); // 单包详情,不存在返回 null
|
|
115
|
+
search('ssl'); // 按关键字搜索,返回匹配的包列表;
|
|
116
|
+
stats(); // 返回收录包时间、收录包数量与收录最高版本;
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
四个库函数只读取包内 `packages.json`,不联网;CLI 会查询 npm registry 显示最新版本,带 1 小时缓存,
|
|
120
|
+
联网失败或单次请求超时(5 秒)时降级为本地版本并标注 `(离线)`;
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 清单维护
|
|
125
|
+
|
|
126
|
+
`packages.json` 由 `scripts/build-index.js` 生成,从本地各包的 `package.json` 抽取描述;
|
|
127
|
+
|
|
128
|
+
执行 `npm run build:index` 重新生成;脚本逐包比对,无变化时不写文件,有新包或描述变更时才更新;
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 许可证
|
|
133
|
+
|
|
134
|
+
ISC
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## 贡献
|
|
139
|
+
|
|
140
|
+
- 主页:[npm 包页面](https://www.npmjs.com/package/@flun/flun#readme)
|
|
141
|
+
- 源码:[GitHub](https://github.com/OpenFlun/flun)
|
|
142
|
+
- 中国:[gitee](https://gitee.com/OpenFlun/flun.git)
|
|
143
|
+
- 问题反馈:[Issues](https://github.com/OpenFlun/flun/issues)
|
package/cli.js
ADDED
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'fs';
|
|
3
|
+
import path from 'path';
|
|
4
|
+
import { execSync } from 'child_process';
|
|
5
|
+
import chalk from 'chalk';
|
|
6
|
+
import { list, info, search, stats } from './index.js';
|
|
7
|
+
import { resolveLatest } from './net.js';
|
|
8
|
+
|
|
9
|
+
const GOLD = '#B8860B',
|
|
10
|
+
dispWidth = s => {
|
|
11
|
+
let w = 0;
|
|
12
|
+
for (const ch of s) w += ch.codePointAt(0) > 127 ? 2 : 1;
|
|
13
|
+
return w;
|
|
14
|
+
},
|
|
15
|
+
padWidth = (s, w) => {
|
|
16
|
+
const cur = dispWidth(s);
|
|
17
|
+
return cur >= w ? s : s + ' '.repeat(w - cur);
|
|
18
|
+
},
|
|
19
|
+
styleVer = ver => {
|
|
20
|
+
const [l, r] = ver.split(' → ');
|
|
21
|
+
return r ? chalk.gray(`${l} → `) + chalk.hex(GOLD)(r) + chalk.greenBright(' (最新)') : chalk.cyan(ver);
|
|
22
|
+
},
|
|
23
|
+
findLocal = name => {
|
|
24
|
+
let dir = process.cwd();
|
|
25
|
+
while (true) {
|
|
26
|
+
const target = path.join(dir, 'node_modules', ...name.split('/'));
|
|
27
|
+
if (fs.existsSync(path.join(target, 'package.json'))) return target;
|
|
28
|
+
const parent = path.dirname(dir);
|
|
29
|
+
if (parent === dir) return null;
|
|
30
|
+
dir = parent;
|
|
31
|
+
}
|
|
32
|
+
},
|
|
33
|
+
readLocalVersion = name => {
|
|
34
|
+
const dir = findLocal(name);
|
|
35
|
+
if (!dir) return null;
|
|
36
|
+
try {
|
|
37
|
+
return JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')).version || null;
|
|
38
|
+
} catch { return null; }
|
|
39
|
+
},
|
|
40
|
+
formatVer = (local, latest, indexVer, online) => {
|
|
41
|
+
if (online) {
|
|
42
|
+
if (!local) return `未安装 → ${latest}`;
|
|
43
|
+
if (!latest || latest === local) return local;
|
|
44
|
+
const a = local.split('.').map(Number), b = latest.split('.').map(Number);
|
|
45
|
+
for (let i = 0; i < 3; i++) {
|
|
46
|
+
if ((a[i] || 0) !== (b[i] || 0)) return (a[i] || 0) > (b[i] || 0) ? local : `${local} → ${latest}`;
|
|
47
|
+
}
|
|
48
|
+
return local;
|
|
49
|
+
}
|
|
50
|
+
if (!local) return indexVer ? `未安装 (内部记录版本: ${indexVer})` : '未安装';
|
|
51
|
+
if (!indexVer || indexVer === local) return local;
|
|
52
|
+
const cmp = local.split('.').map(Number), ref = indexVer.split('.').map(Number);
|
|
53
|
+
for (let i = 0; i < 3; i++) {
|
|
54
|
+
if ((cmp[i] || 0) !== (ref[i] || 0))
|
|
55
|
+
return (cmp[i] || 0) > (ref[i] || 0) ? local : `${local} (内部记录版本: ${indexVer})`;
|
|
56
|
+
}
|
|
57
|
+
return local;
|
|
58
|
+
},
|
|
59
|
+
openReadme = (name, pkg) => {
|
|
60
|
+
const dir = findLocal(name);
|
|
61
|
+
if (dir) {
|
|
62
|
+
const readme = path.join(dir, 'README.md');
|
|
63
|
+
if (fs.existsSync(readme)) {
|
|
64
|
+
console.log(chalk.cyan('📖 打开本地文档: ') + chalk.gray(readme));
|
|
65
|
+
execSync(`start "" "${readme}"`, { shell: true, stdio: 'ignore' });
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
return console.log(chalk.yellow(`⚠️ ${name} 已安装但缺少 README.md`));
|
|
69
|
+
}
|
|
70
|
+
const url = `https://www.npmjs.com/package/${name}`;
|
|
71
|
+
console.log(chalk.yellow(`📦 ${name} 未安装`)), console.log(chalk.gray(` 安装: ${pkg.install}`));
|
|
72
|
+
console.log(chalk.gray(` 在线文档: ${url}`));
|
|
73
|
+
execSync(`start "" "${url}"`, { shell: true, stdio: 'ignore' });
|
|
74
|
+
},
|
|
75
|
+
printHelp = () => console.log(`用法: flun <命令> [选项]
|
|
76
|
+
|
|
77
|
+
命令:
|
|
78
|
+
pkg 列出全部包,按已装/未装分组
|
|
79
|
+
search <关键字> 按包名、描述中的关键字搜索
|
|
80
|
+
info <包名> 查看单包详情;已装打开本地 README,未装打开 npm 页面
|
|
81
|
+
stats 输出收录包时间、数量与最高版本
|
|
82
|
+
|
|
83
|
+
选项:
|
|
84
|
+
-r, --refresh 重新查询 npm 最新版本,忽略 1 小时缓存;仅对 pkg 与 info 生效
|
|
85
|
+
|
|
86
|
+
无参数、help、-h、--help 输出本帮助;`),
|
|
87
|
+
printList = async refresh => {
|
|
88
|
+
const rows = list(), { data: latest, online } = await resolveLatest(rows.map(r => r.name), refresh),
|
|
89
|
+
width = Math.max(...rows.map(r => r.name.length)), groups = [[], []];
|
|
90
|
+
|
|
91
|
+
for (const r of rows) groups[findLocal(r.name) ? 0 : 1].push(r);
|
|
92
|
+
console.log(chalk.green(`\n@flun 官方包列表${online ? '' : ' (离线)'}:\n`));
|
|
93
|
+
for (const [i, title] of [[0, '已装'], [1, '未装']]) {
|
|
94
|
+
if (!groups[i].length) continue;
|
|
95
|
+
console.log(chalk.cyanBright(` ${title} (${groups[i].length}):`));
|
|
96
|
+
for (const r of groups[i]) {
|
|
97
|
+
const ver = formatVer(readLocalVersion(r.name), latest[r.name], r.version, online);
|
|
98
|
+
console.log(` ${chalk.cyanBright(padWidth(r.name, width))} ${styleVer(ver)}`);
|
|
99
|
+
console.log(' ' + chalk.gray(r.desc || '(无描述)'));
|
|
100
|
+
}
|
|
101
|
+
console.log('');
|
|
102
|
+
}
|
|
103
|
+
console.log(chalk.green(`共 ${rows.length} 个包`) + chalk.gray(';查看详情: flun info <包名>\n'));
|
|
104
|
+
},
|
|
105
|
+
printInfo = async (name, refresh) => {
|
|
106
|
+
const pkg = info(name);
|
|
107
|
+
if (!pkg) console.error(chalk.yellow('✗ 未找到相关包,如果你想查看所有包,请运行 flun pkg\n')), process.exit(1);
|
|
108
|
+
|
|
109
|
+
const { data: latest, online } = await resolveLatest([name], refresh),
|
|
110
|
+
ver = formatVer(readLocalVersion(name), latest[name], pkg.version, online);
|
|
111
|
+
|
|
112
|
+
console.log(chalk.blueBright(`\n${pkg.name}`)), console.log(chalk.gray(` ${pkg.desc || '(无描述)'}`));
|
|
113
|
+
console.log(chalk.gray(` 安装: ${pkg.install}`)), console.log(chalk.cyan(' 版本: ') + styleVer(ver));
|
|
114
|
+
console.log(''), openReadme(name, pkg);
|
|
115
|
+
},
|
|
116
|
+
printStats = () => {
|
|
117
|
+
const m = stats();
|
|
118
|
+
if (!m) return console.error(chalk.yellow('收录信息缺失,请重新生成 packages.json')), process.exit(1);
|
|
119
|
+
console.log(chalk.green('\n收录信息:\n'));
|
|
120
|
+
console.log(chalk.cyan(' 收录包时间: ') + chalk.gray(String(m.generatedAt || '').slice(0, 10)));
|
|
121
|
+
console.log(chalk.cyan(' 收录包数量: ') + chalk.greenBright(String(m.packageCount ?? '未知')));
|
|
122
|
+
console.log(chalk.cyan(' 收录最高版本: ') + chalk.hex(GOLD)(String(m.ecosystemMax ?? '未知')));
|
|
123
|
+
console.log('');
|
|
124
|
+
},
|
|
125
|
+
printSearch = kw => {
|
|
126
|
+
const rows = search(kw);
|
|
127
|
+
if (!rows.length) return console.log(chalk.yellow(`未找到匹配 "${kw}" 的包`));
|
|
128
|
+
console.log(chalk.green(`\n匹配 "${kw}" 的包:\n`));
|
|
129
|
+
for (const r of rows) console.log(` ${chalk.cyanBright(r.name)} ${chalk.gray(r.desc || '')}`);
|
|
130
|
+
console.log('');
|
|
131
|
+
},
|
|
132
|
+
checkSelfUpdate = async refresh => {
|
|
133
|
+
try {
|
|
134
|
+
const self = JSON.parse(fs.readFileSync(new URL('./package.json', import.meta.url), 'utf8')).version,
|
|
135
|
+
{ data, online } = await resolveLatest(['@flun/flun'], refresh), latest = data['@flun/flun'];
|
|
136
|
+
if (!online || !latest || latest === self) return;
|
|
137
|
+
const x = latest.split('.').map(Number), y = self.split('.').map(Number);
|
|
138
|
+
for (let i = 0; i < 3; i++) {
|
|
139
|
+
if ((x[i] || 0) !== (y[i] || 0)) {
|
|
140
|
+
if ((x[i] || 0) > (y[i] || 0)) console.log('\n ' + chalk.blueBright('当前包有新版:') + chalk.hex(GOLD)(latest)
|
|
141
|
+
+ chalk.gray(',更新: npm i -g @flun/flun'));
|
|
142
|
+
return;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
} catch { }
|
|
146
|
+
}, raw = process.argv.slice(2), refresh = raw.some(a => a === '--refresh' || a === '-r'),
|
|
147
|
+
rest = raw.filter(a => a !== '--refresh' && a !== '-r'), [cmd, ...args] = rest;
|
|
148
|
+
|
|
149
|
+
if (!cmd || cmd === 'help' || cmd === '-h' || cmd === '--help') printHelp(), process.exit(0);
|
|
150
|
+
else if (cmd === 'pkg') await printList(refresh);
|
|
151
|
+
else if (cmd === 'search') {
|
|
152
|
+
if (!args.length) { console.error(chalk.cyan('用法: flun search <关键字>')), process.exit(1); }
|
|
153
|
+
printSearch(args.join(' '));
|
|
154
|
+
} else if (cmd === 'info') {
|
|
155
|
+
if (!args.length) { console.error(chalk.cyan('用法: flun info <包名>')), process.exit(1); }
|
|
156
|
+
await printInfo(args[0], refresh);
|
|
157
|
+
} else if (cmd === 'stats') printStats();
|
|
158
|
+
else console.error(chalk.yellow(`✗ 未知命令: ${cmd}\n`)), printHelp(), process.exit(1);
|
|
159
|
+
|
|
160
|
+
await checkSelfUpdate(refresh);
|
package/flun.js
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { fileURLToPath } from 'url';
|
|
4
|
+
|
|
5
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url)),
|
|
6
|
+
index = JSON.parse(fs.readFileSync(path.join(__dirname, 'packages.json'), 'utf8'));
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* 列出全部包的元数据
|
|
10
|
+
* >查看定义:@see {@link list}
|
|
11
|
+
* @returns {Array<{name: string, version: string, desc: string, install: string}>}
|
|
12
|
+
*/
|
|
13
|
+
const list = () => Object.entries(index).filter(([name]) => !name.startsWith('_'))
|
|
14
|
+
.map(([name, entry]) => ({ name, ...entry }));
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* 查询单个包详情
|
|
18
|
+
* >查看定义:@see {@link info}
|
|
19
|
+
* @param {string} name 包名
|
|
20
|
+
* @returns {object|null} 存在时返回包信息,不存在返回 null
|
|
21
|
+
*/
|
|
22
|
+
const info = name => {
|
|
23
|
+
if (!name || name.startsWith('_')) return null;
|
|
24
|
+
const entry = index[name];
|
|
25
|
+
return entry ? { name, ...entry } : null;
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 按关键字搜索包名与描述
|
|
30
|
+
* >查看定义:@see {@link search}
|
|
31
|
+
* @param {string} keyword 关键字
|
|
32
|
+
* @returns {Array<object>} 匹配的包列表
|
|
33
|
+
*/
|
|
34
|
+
const search = keyword => {
|
|
35
|
+
const kw = keyword.toLowerCase();
|
|
36
|
+
return list().filter(item => item.name.toLowerCase().includes(kw) || (item.desc || '').toLowerCase().includes(kw));
|
|
37
|
+
};
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 清单元信息
|
|
41
|
+
* >查看定义:@see {@link stats}
|
|
42
|
+
* @returns {{generatedAt: string, ecosystemMax: string, packageCount: number}|null}
|
|
43
|
+
*/
|
|
44
|
+
const stats = () => index._stats || null;
|
|
45
|
+
|
|
46
|
+
export { list, info, search, stats };
|
package/index.d.ts
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { list, info, search, stats } from './flun.js';
|
|
2
|
+
|
|
3
|
+
// =================================== index.js ===================================
|
|
4
|
+
/**
|
|
5
|
+
* @flun/flun - Flun 生态包索引
|
|
6
|
+
* ```js
|
|
7
|
+
* // 文件导出内容
|
|
8
|
+
* list() // 列出全部包;
|
|
9
|
+
* info(name) // 查询单个包详情;
|
|
10
|
+
* search(kw) // 按关键字搜索;
|
|
11
|
+
* stats() // 收录包时间、数量与最高版本;
|
|
12
|
+
* ```
|
|
13
|
+
* >查看定义:@see {@link list}、{@link info}、{@link search}、{@link stats}
|
|
14
|
+
*/
|
|
15
|
+
declare module './index.js' {
|
|
16
|
+
export * from './index.js';
|
|
17
|
+
}
|
package/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export * from './flun.js';
|
package/net.js
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import os from 'os';
|
|
3
|
+
import path from 'path';
|
|
4
|
+
|
|
5
|
+
const CACHE_FILE = path.join(os.homedir(), '.flun-cache.json'), CACHE_TTL = 3600 * 1000,
|
|
6
|
+
readCache = () => {
|
|
7
|
+
try {
|
|
8
|
+
const raw = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
|
|
9
|
+
return Date.now() - raw.ts > CACHE_TTL ? {} : (raw.data || {});
|
|
10
|
+
} catch { return {}; }
|
|
11
|
+
},
|
|
12
|
+
writeCache = data => {
|
|
13
|
+
try {
|
|
14
|
+
fs.writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), data }));
|
|
15
|
+
} catch { }
|
|
16
|
+
},
|
|
17
|
+
fetchLatest = async name => {
|
|
18
|
+
try {
|
|
19
|
+
const url = `https://registry.npmjs.org/${name.replace('/', '%2f')}/latest`,
|
|
20
|
+
res = await fetch(url, { signal: AbortSignal.timeout(5000) });
|
|
21
|
+
if (!res.ok) return null;
|
|
22
|
+
return (await res.json()).version || null;
|
|
23
|
+
} catch { return null; }
|
|
24
|
+
};
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* 批量查询各包在 npm registry 上的最新版本
|
|
28
|
+
* >查看定义:@see {@link resolveLatest}
|
|
29
|
+
* @param {string[]} names 包名数组
|
|
30
|
+
* @param {boolean} refresh 是否跳过缓存强制刷新
|
|
31
|
+
* @returns {Promise<{data: object, online: boolean}>} 版本映射与是否联网成功
|
|
32
|
+
*/
|
|
33
|
+
const resolveLatest = async (names, refresh) => {
|
|
34
|
+
const cached = refresh ? {} : readCache(), missing = names.filter(n => !cached[n]);
|
|
35
|
+
if (!missing.length) return { data: cached, online: true };
|
|
36
|
+
|
|
37
|
+
const pairs = await Promise.all(missing.map(async n => [n, await fetchLatest(n)])), data = { ...cached };
|
|
38
|
+
let ok = 0;
|
|
39
|
+
for (const [n, v] of pairs) if (v) data[n] = v, ok++;
|
|
40
|
+
if (ok) writeCache(data);
|
|
41
|
+
return { data, online: ok > 0 };
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
export { resolveLatest };
|
package/package.json
CHANGED
|
@@ -1,6 +1,59 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@flun/flun",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "7.0.0",
|
|
4
|
+
"description": "Flun 生态包索引:列出全部官方包、查看用途与用法、一键打开文档;",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"types": "index.d.ts",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": "./index.js"
|
|
9
|
+
},
|
|
10
|
+
"main": "index.js",
|
|
11
|
+
"bin": {
|
|
12
|
+
"flun": "cli.js"
|
|
13
|
+
},
|
|
14
|
+
"scripts": {
|
|
15
|
+
"build:index": "node scripts/build-index.js"
|
|
16
|
+
},
|
|
17
|
+
"keywords": [
|
|
18
|
+
"flun",
|
|
19
|
+
"flun-ecosystem",
|
|
20
|
+
"flun-cli",
|
|
21
|
+
"flun help",
|
|
22
|
+
"ecosystem-index",
|
|
23
|
+
"package-index",
|
|
24
|
+
"package-list",
|
|
25
|
+
"cli"
|
|
26
|
+
],
|
|
27
|
+
"files": [
|
|
28
|
+
"cli.js",
|
|
29
|
+
"flun.js",
|
|
30
|
+
"index.d.ts",
|
|
31
|
+
"index.js",
|
|
32
|
+
"net.js",
|
|
33
|
+
"LICENSE",
|
|
34
|
+
"packages.json",
|
|
35
|
+
"CHANGELOG.md",
|
|
36
|
+
"README.md"
|
|
37
|
+
],
|
|
38
|
+
"author": "flun <open@flun.top>",
|
|
39
|
+
"dependencies": {
|
|
40
|
+
"chalk": "^6.0.1"
|
|
41
|
+
},
|
|
42
|
+
"engines": {
|
|
43
|
+
"node": ">=22.12.0",
|
|
44
|
+
"npm": ">=10.0.0"
|
|
45
|
+
},
|
|
46
|
+
"license": "ISC",
|
|
47
|
+
"publishConfig": {
|
|
48
|
+
"access": "public"
|
|
49
|
+
},
|
|
50
|
+
"repository": {
|
|
51
|
+
"type": "git",
|
|
52
|
+
"url": "git+https://github.com/OpenFlun/flun.git"
|
|
53
|
+
},
|
|
54
|
+
"gitee": "https://gitee.com/OpenFlun/flun.git",
|
|
55
|
+
"homepage": "https://github.com/OpenFlun/flun#readme",
|
|
56
|
+
"bugs": {
|
|
57
|
+
"url": "https://github.com/OpenFlun/flun/issues"
|
|
58
|
+
}
|
|
6
59
|
}
|
package/packages.json
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_stats": {
|
|
3
|
+
"generatedAt": "2026-10-31T14:14:08.630Z",
|
|
4
|
+
"ecosystemMax": "6.4.2",
|
|
5
|
+
"packageCount": 14
|
|
6
|
+
},
|
|
7
|
+
"@flun/desktop-builder": {
|
|
8
|
+
"version": "6.4.2",
|
|
9
|
+
"desc": "将任意 Node.js 网站一键打包为当前桌面应用('win', 'mac', 'linux')(基于 Electron),支持高度自定义配置;",
|
|
10
|
+
"install": "npm i @flun/desktop-builder"
|
|
11
|
+
},
|
|
12
|
+
"@flun/dns-auto-ssl": {
|
|
13
|
+
"version": "2.0.0",
|
|
14
|
+
"desc": "自动通过 DNS API 申请 SSL 证书并配置自动续期 (基于 lego v5)",
|
|
15
|
+
"install": "npm i @flun/dns-auto-ssl"
|
|
16
|
+
},
|
|
17
|
+
"@flun/env": {
|
|
18
|
+
"version": "3.2.0",
|
|
19
|
+
"desc": "A simple package to read .env environment files",
|
|
20
|
+
"install": "npm i @flun/env"
|
|
21
|
+
},
|
|
22
|
+
"@flun/flun": {
|
|
23
|
+
"version": "6.2.3",
|
|
24
|
+
"desc": "Flun 生态包索引:列出全部官方包、查看用途与用法、一键打开文档;",
|
|
25
|
+
"install": "npm i @flun/flun"
|
|
26
|
+
},
|
|
27
|
+
"@flun/html-template": {
|
|
28
|
+
"version": "5.1.14",
|
|
29
|
+
"desc": "一个HTML模板工具包,提供开发服务器和模板编译功能,支持自定义标签和快捷输入,变量定义,包含文件引用,帮助开发者模块化处理HTML;",
|
|
30
|
+
"install": "npm i @flun/html-template"
|
|
31
|
+
},
|
|
32
|
+
"@flun/mailer": {
|
|
33
|
+
"version": "2.1.25",
|
|
34
|
+
"desc": "Node.js 邮件发送库;支持 SMTP、SMTP Pool、Sendmail、Stream、JSON、SES 多种传输;",
|
|
35
|
+
"install": "npm i @flun/mailer"
|
|
36
|
+
},
|
|
37
|
+
"@flun/node-mobile-app": {
|
|
38
|
+
"version": "4.0.8",
|
|
39
|
+
"desc": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供;",
|
|
40
|
+
"install": "npm i @flun/node-mobile-app"
|
|
41
|
+
},
|
|
42
|
+
"@flun/nodejs-mobile-gyp": {
|
|
43
|
+
"version": "1.1.4",
|
|
44
|
+
"desc": "Node.js for Mobile Apps native addon build tool (flun fork)",
|
|
45
|
+
"install": "npm i @flun/nodejs-mobile-gyp"
|
|
46
|
+
},
|
|
47
|
+
"@flun/nodejs-mobile-react-native": {
|
|
48
|
+
"version": "2.1.1",
|
|
49
|
+
"desc": "Node.js for Mobile Apps React Native plugin (flun fork, based on nodejs-mobile-react-native)",
|
|
50
|
+
"install": "npm i @flun/nodejs-mobile-react-native"
|
|
51
|
+
},
|
|
52
|
+
"@flun/passport-desktop-win32-ia32-msvc": {
|
|
53
|
+
"version": "1.0.8",
|
|
54
|
+
"desc": "passport-desktop 的 Windows 32 位平台二进制包(win32-ia32-msvc);",
|
|
55
|
+
"install": "npm i @flun/passport-desktop-win32-ia32-msvc"
|
|
56
|
+
},
|
|
57
|
+
"@flun/passport-desktop-win32-x64-msvc": {
|
|
58
|
+
"version": "1.0.8",
|
|
59
|
+
"desc": "passport-desktop 的 Windows 64 位平台二进制包(win32-x64-msvc);",
|
|
60
|
+
"install": "npm i @flun/passport-desktop-win32-x64-msvc"
|
|
61
|
+
},
|
|
62
|
+
"@flun/webauthn-browser": {
|
|
63
|
+
"version": "2.1.10",
|
|
64
|
+
"desc": "WebAuthn 前端库,提供简单易用的接口来处理 WebAuthn 认证流程,支持 Passkeys 和 FIDO2 标准;",
|
|
65
|
+
"install": "npm i @flun/webauthn-browser"
|
|
66
|
+
},
|
|
67
|
+
"@flun/webauthn-server": {
|
|
68
|
+
"version": "2.1.10",
|
|
69
|
+
"desc": "Node.js 端 WebAuthn/Passkey 服务端库;提供 TypeScript 实现与证书、密钥、CBOR 编码处理;",
|
|
70
|
+
"install": "npm i @flun/webauthn-server"
|
|
71
|
+
},
|
|
72
|
+
"@flun/windows": {
|
|
73
|
+
"version": "3.0.11",
|
|
74
|
+
"desc": "支持 Windows 服务、事件日志、UAC 以及多种与操作系统交互的辅助方法",
|
|
75
|
+
"install": "npm i @flun/windows"
|
|
76
|
+
}
|
|
77
|
+
}
|