@ai-matrx/applets

中文文档
0.19.15发布于 2026/10/30MITTypeScriptESM + CJS近 30 天下载 4.8万

AI Matrx Applets: 合同类型和 AppletHost 门路,用于测试和开发的内置主机, React 帧钩 Applet 代码导入(使用Rows, 使用Job, 使用Value, 使用Action, Pages, Applet, Kind),和 MountApplet, 用于编译存储的多

中文使用文档

@ai- matrx/ 应用程序

Applet是自定义接口,一个代理基于一个人自己的数据和平台 特性。 这个包是Applet和任何主机之间的出入口.

条目这是什么
@ai-matrx/applets合同类型和 AppletHost 接口。 没有反应.
@ai-matrx/applets/hostcreateMemoryHost(spec) ——用于测试和开发的内存宿主.
@ai-matrx/applets/reactApplet 代码导入内容 : useRows, (中文(简体) ), useJob, (中文(简体) ), useConversation, (中文(简体) ), WritingBox, (中文(简体) ), useValue, (中文(简体) ), useAction, (中文(简体) ), Pages,, , , , , , , ,
@ai-matrx/applets/platformcreatePlatformHost(opts) ——直播平台上真正的主机;每个客户端都注入.
@ai-matrx/applets/framemountApplet(record, host, scope) ——编译被存储的Applet并渲染出.
import { createMemoryHost } from "@ai-matrx/applets/host";
import { mountApplet } from "@ai-matrx/applets/frame";

const host = createMemoryHost({ record, tables: { posts: { columns, rows } } });
const mounted = mountApplet(record, host, { entries: [], shadowDangerousGlobals: true });
if (mounted.ok) root.render(<mounted.Component />);

在一个小程序内 :

import { useRows, useJob, JobOutput, Pages } from "@ai-matrx/applets/react";

export default function Posts() {
  const { rows, update, error } = useRows("posts");          // optimistic, versioned writes
  const draft = useJob("draft");                              // a declared job, by alias
  return (
    <>
      <button onClick={() => draft.run({ topic: "launch" })}>Draft</button>
      <JobOutput job={draft} label="Drafting" />               {/* the run streams here */}
      <ul>{rows.map((r) => <li key={r._id}>{String(r.title)}</li>)}</ul>
    </>
  );
}

工作总是能顺利完成 <JobOutput job={…} /> 从来没有 job.text 在某一段中, 从来没有一个"忙"的标签,而它的工作,从来没有 <Kind> 打开 job.result 在结尾。 由主机制作 运行于其一个运行中的管道(流出文本、部分类型、工具步骤、装载和出错, 最终类型)通过 renderRun。如果没有空间流入内线,请使用 <JobOutput job={…} mode="window" /> (每次运行在主机浮动运行窗口打开一次)或呼叫 job.open() 从按钮。 主机供应 renderRun 编号 : openRun 改为 mountApplet 编号 : AppletFrame。 。 。 .

在跑步之前 跑步从未成功过. 一个标题,如"Content ready for 上文“出版物” <JobOutput> 仅在 job.status === "done"; 工作或失败后 (单位:千美元)job.status === "error"),说到底发生了什么或什么都没有. job.error.message 永远是句句 供访客使用forVisitor;服务器自己的单词去主机的错误检查器,从不去页面.

一个人写的盒子 <WritingBox value={text} onValueChange={setText} /> 从来没有 Textarea。 。 。 . 它使主机的写入框(renderWritingBox),搭载平台的麦克风(起诉书)和 读-声; <ConversationComposer> 写过它.

一个谈话是 useConversation(alias) ——与一个申报的工作进行多回合聊天. 第一个 send(text, variables?) 以后再开始 send 继续同样的谈话, stop() 停下来 轮到飞行。 把它给 <ConversationOutput conversation={…} />: 每个答题流经 东道主的同一条直播管道, 从未手动交付.

const chat = useConversation("assistant");
<ConversationOutput conversation={chat} label="Answering" />
<button onClick={() => chat.send(draftText)}>Send</button>

虎克从不掷出:每个答案一个 status 还有一个 error 带有系统本身的句子。 打开 useRows 编号 : useRow, (中文(简体) ), error 表示无法读取数据; 拒绝保存的存储是 writeError (它的句子) - 显示在旁边 保存的控件,从不替换列表. React和React DOM是同级依赖关系. 这份合同是 common-docs/projects/applets/CONTRACTS.md (v2) (中文(简体) ).

版本与发布记录

@ai-matrx/applets 共发布 129 个版本,首次发布于 2026/10/07;过去 12 个月发布了 129 个版本。

版本发布日期距今
0.19.15latest2026/10/306 天前
0.19.142026/10/288 天前
0.19.132026/10/2412 天前
0.19.122026/10/2313 天前
0.19.112026/10/2314 天前
0.19.102026/10/2314 天前

关于 @ai-matrx/applets 的常见问题

@ai-matrx/applets 是什么?

AI Matrx Applets: 合同类型和 AppletHost 门路,用于测试和开发的内置主机, React 帧钩 Applet 代码导入(使用Rows, 使用Job, 使用Value, 使用Action, Pages, Applet, Kind),和 MountApplet, 用于编译存储的多

如何安装 @ai-matrx/applets?

在项目目录运行 npm install @ai-matrx/applets,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18.0.0)、react-dom(>=18.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ai-matrx/applets 支持 TypeScript 吗?

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

@ai-matrx/applets 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ai-matrx/applets 需要什么版本的 Node.js?

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

@ai-matrx/applets 可以商用吗?

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

@ai-matrx/applets 的下载量有多少?

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

@ai-matrx/applets 还在维护吗?

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