@limina_ai/node-client 2.0.106 → 2.0.108

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/README.md ADDED
@@ -0,0 +1,78 @@
1
+ # LIMINA 节点客户端
2
+
3
+ 将你的电脑或服务器连接到 [LIMINA](https://www.limina.cc/),为 AI 会话提供工具执行、文件同步和预览转发能力。
4
+
5
+ ## 环境要求
6
+
7
+ - Node.js **24 或更新版本**,以及 npm。
8
+ - Windows、macOS 或 Linux。
9
+ - 可以连接 LIMINA 平台和 npm 仓库的网络环境。
10
+
11
+ ## 安装
12
+
13
+ ```sh
14
+ npm install -g @limina_ai/node-client
15
+ ```
16
+
17
+ ## 连接节点
18
+
19
+ 1. 登录 [LIMINA](https://www.limina.cc/),进入节点页面并创建节点。
20
+ 2. 复制该节点专属的启动命令,在准备连接的电脑或服务器上执行。
21
+ 3. 节点上线后,即可在会话中选择它执行任务。
22
+
23
+ 首次配置后,可以使用以下命令再次启动节点:
24
+
25
+ ```sh
26
+ limina-node
27
+ ```
28
+
29
+ 查看命令帮助:
30
+
31
+ ```sh
32
+ limina-node --help
33
+ ```
34
+
35
+ ## 更新
36
+
37
+ ```sh
38
+ npm update -g @limina_ai/node-client
39
+ ```
40
+
41
+ 查看已安装版本:
42
+
43
+ ```sh
44
+ npm list -g @limina_ai/node-client --depth=0
45
+ ```
46
+
47
+ 运行中的节点支持自动更新:校验发布包,在空闲时切换版本,启动失败时自动回退。使用 npm 手动更新后,重新启动节点即可使用新版启动器。
48
+
49
+ ## 更新记录
50
+
51
+ ### 2.0.108
52
+
53
+ - 修复损坏的节点发布缓存和安装记录导致启动、升级无法自行恢复的问题,保留节点绑定与项目文件。
54
+ - 桌面客户端或随包更新器升级后,重新尝试此前失败的节点版本;同一客户端仍保留失败回滚保护。
55
+ - 修复更新状态内容异常及旧节点确认空闲后未退出时,升级流程无法继续的问题。
56
+ - 修复桌面节点首次下载安装失败后不再重试的问题,恢复联网后自动重试,主动停止后保持停用。
57
+ - 新节点确认期间因断网未就绪时回滚并重试,避免网络故障被永久记为坏版本。
58
+ - 更新状态按顺序落盘并在退出前完成写入,避免进度记录与最终结果互相覆盖。
59
+ - npm 包补齐使用说明和发布信息,更新记录自动合入 README;缺少当前版本说明时阻止打包。
60
+
61
+ ### 2.0.106
62
+
63
+ - 优化项目文件扫描,减少大型项目首次扫描及后续增量扫描的耗时。
64
+ - 审阅扫描不再阻塞会话操作,修复大型项目中发送消息、停止和结束任务长时间等待的问题。
65
+ - 通过 npm 分发节点安装与自动更新,保留发布包校验、空闲切换和失败回滚。
66
+
67
+ ## 项目主页与许可
68
+
69
+ - 主页与使用入口:[www.limina.cc](https://www.limina.cc/)
70
+ - 软件许可:**UNLICENSED**。此包用于分发 LIMINA 客户端,未授予开放源代码许可。第三方依赖遵循各自的许可证。
71
+
72
+ ## English
73
+
74
+ LIMINA Node Client connects a computer or server to LIMINA, providing tool execution, file synchronization and preview forwarding for AI sessions.
75
+
76
+ Requires **Node.js 24+** and npm. Install with `npm install -g @limina_ai/node-client`, create a node on [LIMINA](https://www.limina.cc/), and run the startup command shown for that node. Use `limina-node --help` for command help and `npm update -g @limina_ai/node-client` to update.
77
+
78
+ License: **UNLICENSED**. No open-source license is granted for this client. Third-party dependencies retain their respective licenses.
package/archive.js CHANGED
@@ -6,7 +6,6 @@ import fs from 'node:fs'
6
6
  import path from 'node:path'
7
7
  import zlib from 'node:zlib'
8
8
 
9
- // Parse metadata before inflating; never extract links or paths outside the staging directory.
10
9
  /* 中文:校验并解压发布 ZIP 到暂存目录:先解析元数据,拒绝链接与越界路径,并限制条目数与总体积。
11
10
  * English: Validates and extracts a release ZIP into a staging dir, parsing metadata first and rejecting links, out-of-dir paths and excessive entry counts or sizes. */
12
11
  export function extractRelease(archive, destination, maxExpanded = 384 * 1024 * 1024) {
@@ -18,7 +17,8 @@ export function extractRelease(archive, destination, maxExpanded = 384 * 1024 *
18
17
  throw new Error(message)
19
18
  }
20
19
 
21
- // EOCD 最多位于文件尾部 65535 字节注释之前。引导包不接受多卷或 ZIP64,发布包远小于其上限。
20
+ // 中文:EOCD 最多位于文件尾部 65535 字节注释之前;引导包不接受多卷或 ZIP64,因为发布包远小于其上限。
21
+ // English: The EOCD sits at most 65535 bytes of trailing comment from the end; bootstrap packages reject multi-disk and ZIP64 because releases are far below that limit.
22
22
  let eocd = -1
23
23
  for (
24
24
  let offset = archive.length - 22, floor = Math.max(0, archive.length - 22 - 65535);
@@ -173,11 +173,13 @@ export function readPackageFiles(tarball, wanted, maxExpanded = 256 * 1024 * 102
173
173
  let name = longName ?? (prefix ? prefix + '/' : '') + text(0, 100)
174
174
  longName = null
175
175
  if (type === 'x') {
176
- // PAX 扩展头只关心 path,其他属性(mtime 等)对读取无影响。
176
+ // 中文:PAX 扩展头只需读取 path,其他属性(mtime 等)不影响解包结果。
177
+ // English: Only the path matters in a PAX extended header; other attributes such as mtime do not affect extraction.
177
178
  const pax = tar.subarray(dataStart, dataEnd).toString('utf8')
178
179
  longName = /(?:^|\n)\d+ path=([^\n]*)\n/.exec(pax)?.[1] ?? null
179
180
  } else if (type === '0') {
180
- // npm pack 统一以 package/ 为根目录。
181
+ // 中文:npm pack 产出的包统一以 package/ 为根目录,因此直接剥掉该前缀。
182
+ // English: npm pack archives are always rooted at package/, so strip that prefix.
181
183
  const relative = name.replace(/^package\//, '')
182
184
  if (wanted.includes(relative)) {
183
185
  if (found.has(relative)) throw Error('npm 包包含重复文件:' + relative)
package/node-version.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
- "version": "v2.0.106",
3
- "program_version": "v2.0.106",
2
+ "version": "v2.0.108",
3
+ "program_version": "v2.0.108",
4
4
  "protocol": "limina-node",
5
5
  "data_version": 9,
6
6
  "protocols": [
7
7
  "rpc"
8
8
  ],
9
9
  "execution_protocol": "rpc",
10
- "file": "limina-node-v2.0.106.zip",
11
- "sha256": "29a63262bb9a002ba1960c8b0b73b2f9c34a198530ce6c405de9c4b34fbafe99",
12
- "size": 467677,
10
+ "file": "limina-node-v2.0.108.zip",
11
+ "sha256": "0868f23f35076041b0ae48e0678e83c5252161aded7bc0f2dbd56976f61e9985",
12
+ "size": 483142,
13
13
  "platform": "any",
14
14
  "arch": "any",
15
15
  "runtime": "node-source",
package/package.json CHANGED
@@ -1,11 +1,30 @@
1
1
  {
2
2
  "name": "@limina_ai/node-client",
3
- "version": "2.0.106",
4
- "description": "Limina Node.js 执行节点",
3
+ "version": "2.0.108",
4
+ "description": "LIMINA execution node client for AI agents, tools and file synchronization",
5
5
  "engines": {
6
6
  "node": ">=24"
7
7
  },
8
8
  "type": "module",
9
+ "homepage": "https://www.limina.cc/",
10
+ "author": "LIMINA",
11
+ "license": "UNLICENSED",
12
+ "keywords": [
13
+ "limina",
14
+ "ai-agent",
15
+ "node-client",
16
+ "automation",
17
+ "remote-execution",
18
+ "file-sync",
19
+ "mcp"
20
+ ],
21
+ "files": [
22
+ "cli.mjs",
23
+ "archive.js",
24
+ "release.zip",
25
+ "node-version.json",
26
+ "README.md"
27
+ ],
9
28
  "bin": {
10
29
  "limina-node": "./cli.mjs"
11
30
  },
@@ -13,17 +32,17 @@
13
32
  "access": "public"
14
33
  },
15
34
  "limina": {
16
- "version": "v2.0.106",
17
- "program_version": "v2.0.106",
35
+ "version": "v2.0.108",
36
+ "program_version": "v2.0.108",
18
37
  "protocol": "limina-node",
19
38
  "data_version": 9,
20
39
  "protocols": [
21
40
  "rpc"
22
41
  ],
23
42
  "execution_protocol": "rpc",
24
- "file": "limina-node-v2.0.106.zip",
25
- "sha256": "29a63262bb9a002ba1960c8b0b73b2f9c34a198530ce6c405de9c4b34fbafe99",
26
- "size": 467677,
43
+ "file": "limina-node-v2.0.108.zip",
44
+ "sha256": "0868f23f35076041b0ae48e0678e83c5252161aded7bc0f2dbd56976f61e9985",
45
+ "size": 483142,
27
46
  "platform": "any",
28
47
  "arch": "any",
29
48
  "runtime": "node-source",
package/release.zip CHANGED
Binary file