@aparte/core

中文文档
0.32.1发布于 2026/11/02MITTypeScriptES Module构建来源已验证近 30 天下载 1.1万

AI聊天和代理 UI 组件作为 Web 组件, 代理循环在内部—— 零第三方依赖

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 节点/安全部门改革
  4. 里面有什么东西
  5. 文档
  6. 许可证

@ aparte/ 核心

Published on webcomponents.org

AI 聊天和代理 UI 组件为 香草 Web 组件, 内部有代理环 —— 说 无第三方依赖性,仅限无害环境管理,可在任何框架中使用或不可用.

谈话、信息、推理、工具 呼唤人类认可、质询 询问、 作曲者、 聊天周围的布局( app shell、 侧边栏、 谈话列表) 和 a 其余应用的UI工具箱——每个 显示其变体的活性, (中文(简体) ), 并组装成 模板 你可以复制.

贝塔. 在npm, 释放在锁步 与所有其他 @aparte/* 软件包—— 版本编号为平原 0.x,而宣布的表面是 自0.17.0起冻结: 它只离开 通过通知释放。 部分 独立 单曲; 变化时间 partejs.dev/ changelog 数据。 。 。 .

安装

npm install @aparte/core

快开始

import '@aparte/core';               // registers the <aparte-*> custom elements
import '@aparte/core/styles.css';    // theme variables + component styles
import { aparteGlobalConfig, AparteClient } from '@aparte/core';

// Drop the shell in your HTML:  <aparte-chat placeholder="Ask anything…"></aparte-chat>

// Give it a provider + transport (see the docs), then construct the client and call
// .start() — it echoes your user message, streams the reply into the conversation,
// and listens for retry/edit. (Without .start(), nothing listens and nothing streams;
// a host that appends its own user bubble passes `echoUserMessage: false`.)
new AparteClient().start();

// The retry / edit buttons only do something with a host like the client above, so
// core ships them off. One line turns them on:
aparteGlobalConfig.setBubbleActions({ retry: true, edit: true });

还没有钥匙吗? npm i @aparte/provider-scenario 和登记 createScenarioProvider({ scenarios: showcase }) 作为上面的提供者: 真实的流线 回答——打分,推理,工具回回行——没有后端和网络. 没错 这个寄存器所运行的例子, 和docs的活框的答案. 情景提供者。 。 。 .

内置的分块渲染器 首次安装一个分块需要,所以 没有什么可以要求文本、代码或思维块出现。 通话 registerDefaultRenderers() 你仍然在工作 并明确时刻.

节点/安全部门改革

@aparte/core 在服务器上干净导入。 A 类 node 导出条件解决为 a DOM免费输入,所以 import '@aparte/core' 在节点工作,一个电子 主要 进程, 或 SSR 通行证(Next / Nuxt / SvelteKit / Angular Universal),没有DOM shim:

// Node — same specifier, DOM-free entry
const { AparteClient, createAparteChatHandler, contentToText } = await import('@aparte/core');

你留着 客户端、聊天主机、传输+ createAparteChatHandler,则 对话/消息运行时间、配置、解析器和各种类型. 你输了 习惯 要素本身——它们延伸 HTMLElement,所以它们只是浏览器,和 registerAllComponents() 这是安全的,没有.

阅读 src/index.ts 这有点误导: 浏览器 条目( 它定义 ,而工作空间首先通过设计解决。 合同是 由 pnpm check:node-import,以真实的节点导入已建软件包 每一个CI运行.

里面有什么东西

  • <aparte-chat> ——一滴入壳(viewport +作曲),或作作原作 自己来<aparte-chat-viewport>, (中文(简体) ), <aparte-composer>, (中文(简体) ), <aparte-chat-bubble>(中文(简体) ).
  • AparteClient ——可选驱动器,将作曲事件变成流回回, 和使重试 / 编辑按钮真实化的主机: 将对话重试为 分支 (内置) ‹ 1/2 › picker),编辑重写所处信件. 两者 按钮是 默认关闭 没有东道主,他们不会对任何人负责,所以切换 在客户端旁边: aparteGlobalConfig.setBubbleActions({ retry: true, edit: true })。 。 。 .
  • 运输 —— 说 AparteDirectTransport (浏览器-提供者,BYOK/当地模式)或 AparteBackendTransport (浏览器 ~ 您的端点, API 密钥保持服务器侧).
  • 他们 - 把所有东西都重塑 --aparte-* CSS变量(Light DOM,无叉).
  • 自定义 图标、制取钩子和通过区域动作注册 aparteGlobalConfig。 。 。 .

零第三方依赖性(代理循环, @aparte/engine,是第一方依赖: 标记下,语法突出等 选入 供养者,你注射. 仅限无害环境管理(CJS用户使用) await import()) (中文(简体) ).

文档

完整的指南和生成的 API 参考文件已存在 萨德瓦 开始 主题 定制, 附件、 对话和分支、 工具、 后端传输、 带回自己的回路, 代理引擎 和麻烦解决。 来源 apps/docs。 。 。 .

两个最需要的网页,直接:

  • 自定义 - 每一出戏 钩,动作注册,作曲工具栏.
  • CSS 变量 - 满分 符号目录, GENERTED 从样式表, 所以它不能漂移 从它.

(本套件用于携带 CUSTOMIZATION.md 财务报告和审定财务报表 THEMING.md 与这些. 从未出版过 files 实值 dist, (中文(简体) ), README.md, (中文(简体) ), LICENSE 没什么 他们彼此相通,彼此相通 registerBubbleAction 没错 不存在, 其他列出的六 --aparte-bubble-* 样式表的变量 从未定义 。 一个错误的孤儿,一个编码代理 找到的reppo是更糟糕的 绝不是孤儿,所以他们已回避两次了

许可证

麻省理工学院

版本与发布记录

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

版本发布日期距今
0.32.1latest2026/11/024 天前
0.32.02026/11/024 天前
0.31.02026/11/024 天前
0.30.12026/11/014 天前
0.30.02026/11/014 天前
0.29.42026/11/015 天前

其他发布通道:alpha → 0.17.0。

关于 @aparte/core 的常见问题

@aparte/core 是什么?

AI聊天和代理 UI 组件作为 Web 组件, 代理循环在内部—— 零第三方依赖

如何安装 @aparte/core?

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

@aparte/core 支持 TypeScript 吗?

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

@aparte/core 支持 ESM 还是 CommonJS?

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

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

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

@aparte/core 可以商用吗?

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

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

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

@aparte/core 还在维护吗?

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