769 字
2 分钟
Spak:我把 Node 运行时拆成了一堆包
2026-11-18

做了个东西,叫 Spak。

一句话:一个啥都是插件化,但是又标记严格的 Node.js 项目,发在 npm 的 @starpak/* 下。

starpak
/
spak
Waiting for api.gitee.com...
00K
0K
0K
Waiting...

它由什么组成

按现在来看,有16个组成:

  • 入口:starpak、spm、cli
  • 运行时:core、loader、config、log、error
  • 工具:util、lang、mods
  • 扩展:os、iwant、apps、node-b、ssetps

内核、CLI、桌面壳、应用、模组——全是包,装什么是什么,换什么也行。

拆包全是坑

拆包的理由很简单:想让每一层都能单独换掉,也想让 @starpak/core 这种包能被别的项目单拎出去用。

但拆多了就发现麻烦。最早的工具包叫 usefor,名字看不出是干嘛的,新人打开 package.json 一脸问号,后来改成 util。ccmd 和 cpc 也拆出去过(69 行和 393 行),后来发现只有自己在用,又合并回 cli/src/commands/。

这里简直是地狱!

依赖方向也写死了:

util → core → log / config / loader → cli → spm → starpak

任何 @starpak/* 包都不许反向 import 门面。util 零副作用,core 不碰 fs、path。这是给自己立的铁律,省得以后手滑加出循环依赖。

依赖乱到极致,诗人?

连桌面壳都算包

spm os 起的是一个叫 Spak OS 的桌面壳,跑在 8008 端口。应用打成 .app 容器:

apps/hello/spak.app.json
{
"id": "hello",
"name": "Hello",
"version": "1.0.0",
"entry": "index.ts",
"permissions": { "fs": "none", "network": "none", "childProcess": false }
}

Emm,看起来也是非常”简单”好吧…

模组用的不是 JS

模组装的是 .spk,自己写的门语言。mods/http/index.spk 里大概长这样:

mods/http/index.spk
export async fn apply(host, cfg)
state.handle = await host.api.listenHttp(host.modToken, {
host = (cfg ?? {}).host ?? "127.0.0.1",
port = (cfg ?? {}).port ?? 0,
}, fn(req) return dispatch(host, req) end)
host.logger.info(f"http 模组监听 {state.handle.url}(模组前端端口)")
end

fn ... end、类型标注、f"" 插值,有点 Lua 和 TypeScript 杂交的意思。旁边配个 mod.json 声明权限和依赖。

自己造语言风险不小,语法文档写了四篇,勉强算想清楚了。

我只能说 Dsh还是泰豪用辣!

自己审自己

2026-11-01 给自己做了次全量审查,只读、不跑构建,把能挑的毛病都挑了一遍。

结果挺难看,P0 有八条,比如:

P0 摘录
  • 安全机制(防火墙、沙箱、权限)在真实启动路径上没接线,文档和启动横幅却写着已启用;
  • CI 里调用的 spm.js 在根目录不存在,验收脚本必挂;
  • spm test 固定打印「0/0 项测试通过」还不设退出码,假绿;
  • Spak OS 的清单字段直接进 innerHTML,装个恶意应用就能接管桌面壳。

结论一句话:文档写得比代码跑得快。这话不好听,但比让用户自己踩出来强。

骗你的,其实也是 dsh 蹬出来的!

现在到哪了

简称:一坨屎 大型shift work代码说是

  • spm setup && spm start 能跑,build 有 node / server / app 三个 target;

先到这

项目还在磨,离「装完就能用」还有距离。

得先把那些 P0 收拾干净,再谈别的。

(名字真的不考虑改一下?每次都被人当 spark。骗你的,不带改的)

awa

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

作者
AroCobo
发布于
2026-11-18
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时

目录