@haikit/core

中文文档
0.35.2发布于 2026/11/07MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 4837

Haikit合同层:声明一次UI表面,在服务器和浏览器上执行. 无常态,零运行时间依赖.

中文使用文档

@ haikit/ 核心

合同层. 零运行时间依赖性——由 服务器运行时间,浏览器客户端,每个适配器,以及两个应用程序的一半.

import { defineSurface, resolve, query } from "@haikit/core";

export const picker = defineSurface({
  name: "flight_table",
  version: 1,
  props: z.object({ flights: z.array(Flight) }),
  actions: { select: resolve(z.string()) },
  queries: { filter: query(FilterArgs) },
});

石刻已被接受 结构 - 任何与一个 .parse() 方法有效, 所以zod是你的选择 而不是这个包的依赖.

四项保证

在类型体系中强制执行 test/types/guarantees.ts数字 :

表面不存在 digest,或者没有通知 model 文本两个字段都需要
查询的结果只能由 cap()Capped 没有其他构造器
mode: "elicit" 需要一个 resolve 动作否则拨打时不打字
不存在未申报的行动合同 实值 许可列表

表面也可以声明 staleAfterMs,其数据可在多大程度上采取行动: 毫秒,或 "never",这是默认值。 一次任何表面在一个 谈话已经过窗了 谈话结束.

通知,宣布日期: defineNotice,是服务器告诉一个 任何请求之外的对话。 其有效载荷去浏览器 及其 model 在下一个用户信息中向模型提供文本; model 返回时 null 当模型不需要听到它. hai.notify 键入 合同。 宣布的通知 kind: "wake" 也开始转弯,所以 model 必须返回文本 : null 是一个编译错误.

一个信号,以 defineSignal,是对每个开放浏览器的广播, 比如网上有多少人 它属于没有对话,从来没有 到达模型,所以没有服务器的一半: hai.signal 类型有效载荷 单从合同.

npm run typetest 在 repo 根上, 将这些测试汇编两次—— 一次与它们的 @ts-expect-error 指令(必须是干净的),一旦剥去 线条必须出错。 保证无声停止工作会失败.

版本与发布记录

@haikit/core 共发布 48 个版本,首次发布于 2026/09/23;过去 12 个月发布了 48 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.35.2latest2026/11/0710 天前
0.35.12026/11/0611 天前
0.35.02026/11/0611 天前
0.34.02026/11/0512 天前
0.33.02026/11/0512 天前
0.32.02026/11/0314 天前

关于 @haikit/core 的常见问题

@haikit/core 是什么?

Haikit合同层:声明一次UI表面,在服务器和浏览器上执行. 无常态,零运行时间依赖.

如何安装 @haikit/core?

在项目目录运行 npm install @haikit/core,或使用 pnpm add / yarn add / bun add。

@haikit/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haikit/core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@haikit/core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haikit/core 可以商用吗?

@haikit/core 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@haikit/core 的下载量有多少?

根据 npm 官方下载统计,@haikit/core 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,837 次,日均约 161 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haikit/core 还在维护吗?

最新版本 0.35.2 发布于 2026/11/07(10 天前);至今共发布 48 个版本,其中过去 12 个月发布了 48 个;首次发布于 2026/09/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。