# @agent-native/creative-context 中文文档

规范地址：https://npmcn.com/package/%40agent-native/creative-context/

版本：0\.8\.68
npm 元数据更新时间：2026-11-06T18:58:42.810Z
中文译文更新时间：2026-11-06T19:00:43.591Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agent-native/creative-context
原文对照：https://npmcn.com/package/%40agent-native/creative-context/?lang=original
项目主页：https://github.com/BuilderIO/agent-native#readme
源码仓库：https://github.com/BuilderIO/agent-native

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.5 MB，729 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：react \>=19\.2\.7，react-dom \>=19\.2\.7，drizzle-orm \>=0\.45，@agent-native/core \>=0\.226\.0-0，@tabler/icons-react \>=3\.41\.1，@agent-native/toolkit \>=0\.1\.0，@tanstack/react-query \>=5\.101\.4
- 首次发布：2026-07-16T22:04:00.045Z
- 最新版本发布：2026-11-06T18:58:42.293Z
- 近 30 天下载量：11016（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：358（近 12 个月 358 个）

## 中文简介

共享的创意上下文摄取,版本化,搜索,品牌DNA,以及用于代理本地应用的上下文包装原始.

## 安装

```sh
npm install @agent-native/creative-context
```

也可以使用：`pnpm add @agent-native/creative-context`、`yarn add @agent-native/creative-context`、`bun add @agent-native/creative-context`

## README

# @ agent- intative/ creative- context

共享创意-图书馆摄取,管理可重复使用的背景,不可改变 证据、混合检索、品牌背景和生成来源 原生创意应用.

创意背景是一个工具包能力模块,应请求安装。 它活着 在它自己的 npm 软件包中,所以应用程序只接收被管理的实体,检索,UI,以及 他们需要生命周期元数据.

软件包将 Google 幻灯片、图片、图片、网站和上传 PPTX/DOCX/PDF/PNG/JPEG/WebP/GIF/safe-SVG文件被改编为版本的SQLector. 二进制原作, 局部视觉 倒计时, 并绑定的 UI 缩略图生活在私人 blob 存储; 完全滑行 和全帧源是临时的质量保证投入,被丢弃。 文本仍可直接调取到 SQL; PostgreSQL 部署添加全文候选人和 pgvector 视觉 类似 `DATABASE_URL` 数据库.

## 安装

```bash
pnpm add @agent-native/creative-context
```

每个应用程序添加服务器插件一次 :

```ts
// server/plugins/creative-context.ts
import { setupCreativeContext } from "@agent-native/creative-context/server";

export default setupCreativeContext({ appId: "slides" });
```

在应用程序的现有代理页面上挂载共享库标签 :

```tsx
import { AgentTabsPage } from "@agent-native/toolkit/app/agent-page";
import { createCreativeContextAgentTab } from "@agent-native/creative-context/client";

export default function AgentPage() {
  return <AgentTabsPage extraTabFactories={[createCreativeContextAgentTab]} />;
}
```

导入 `./server` 通过框架登记一揽子行动 成套行动登记册、适用添加剂转移、登记册 共享来源/简介/文稿/包装,开始可回收的进口加工, 并有条件地为代理提示提供已公布的品牌上下文. 每个 拥有应用程序也会注册服务器侧本地捕获适配器, 所以它的共享 popover 可以通过资源 id 提交甲板、 设计、 文档、 资产或仪表板 而不通过一般操作发送本地有效载荷。 及时 当应用程序状态包含时,会从结构上省略贡献 `{ contextMode: "off" }`。 。 。 .

## 管理上下文

品牌简介包含批准的身份和DNA. 创意背景是: 长期、可分享的募捐者(例如默认、营销、, 产品,或销售)。 上下文包是不可更改的准确版本收件 一辈人.

-   每个个人或组织的范围都有一个不可存档的默认上下文.
-   请求使用默认加最多一个特殊上下文 。 明确选择 胜出; 应用程序绑定或语义匹配提供自动特长.
-   `open` 上下文立即发布编辑稿. `review` 财务报告和审定财务报表 `admins-only` 上下文对其提交者保密 上下文管理员直到批准.
-   目前核准的快照仍在使用,而更新版本是 待定。 删除会立即影响新检索而无需重写旧文件 包装.
-   更广义的出版需要源管理许可 明确确认。 接受书写不可改变的上下文自有副本; 它永远不会改变原始资源共享.

标准 UI 是框架的上下文标签 上下文第一库。 图书馆铁路选择默认或专业及其 项目、来源、批准和设置视图仅显示安全、有界限的预览 : 幻灯片胶片、设计框架、 文档结构、访问范围 和包含合成预览数据的仪表板.

精确的app-native数据是一个单独的私人blob能力. 通用列表, 物品、包装、状况、媒体和搜索回复从未暴露这种能力. 只有拥有的应用程序的已打入的克隆动作才能解决它,验证存储的散列 并创建新的可编辑资源 常规持久路径。 继续导入 Google 幻灯片和相片 使用更严格的可信编译器和本地重装路径.

## 检索行为

-   语法搜索使用规范化的 grep 模式 (`allTerms`, (中文(简体) ), `anyTerm`, (中文(简体) ), `phrase`, (中文(简体) ), `regex`)和加权头衔/摘要/身体评分.
-   PostgreSQL 添加一个 `tsvector`/GIN 候选车道和一个已配置的多式车道 在同一数据库中嵌入由 pgvector 支撑的家庭 .
-   PGlite只保留词汇和词典/标题搜索。 视觉查询失败 明确的 PostgreSQL+pgvector 要求; 软件包从不创建另一个 PGlite或矢量数据库.
-   每个上下文支持的生成 解决默认加零或一个特长, 应用特长排名助推,快照精确 `(itemId, itemVersionId)` 证据、分数、选择理由和上下文 身份标识为不可改变的上下文包.

背景包是有意拥有的,可以独立分享,而不是 继承广泛的源可见度。 一包记录一代人的要求, 选定的证据,以及影响分数,可以揭示私人工作意图 即使每个来源都是组织可见的 只有创造者才能 见一新包;合作者通过一明确包份额获得. 普通来源证据仍受当前来源访问和 撤销。 背景自有的已出版的快照仍可重放于被封存的快照上 用于取消会员资格后授权的包式取景器的版本.

## 孤立部署

一个工作空间中的 Apps 默认使用共享数据库进行中. 如果一个应用 在一个单独的数据库中部署 `CREATIVE_CONTEXT_A2A_URL` 页:1 拥有程序并配置共享的应用程序 `A2A_SECRET` 两者 部署或匹配的曲线范围d `CREATIVE_CONTEXT_A2A_KEY`倒计时 仅转发有界限的解析、验证、生成记录读取,以及 通过认证的 A2A 协议生成记录写入操作. 呼叫者身份由接收者签名并重新解决,所有请求和 反应形状得到严格验证,且反应格式不当或超时 明显失败,而不是回到未跟踪的背景。 可选 `CREATIVE_CONTEXT_A2A_TIMEOUT_MS` 被夹到1-60秒,默认值为30秒 秒数。 不要将这些值放在客户端代码或应用程序状态中 .

`CREATIVE_CONTEXT_A2A_URL` 是选择入:没有它,就不会发生A2A请求。 A 类 保存或一代 `contextMode: "off"` 结构抑制 远程路径 .

## 信任和生命周期

被导入的文字是证据,不是指示. 只有人类出版,验证 结构化品牌字段可以输入已键入 `<brand-context>` 快速块. 限制上游项目默认审查和排除。 组织印本 要求一个组织管理或经核实的集装箱所有人加上确认 准确的容器和物品数量。 断开或删除源 墓碑同步取出 所以立即停止取出 私人墓穴是 同步清理 本地上下文文件使用相同的已关闭 私人小块规则 永远不要回到 SQL 有效载荷存储.

## 出口

| 子路径 | 目的 |
| --- | --- |
| `.` | 共享类型和生成文本助手 |
| `./actions` | 已注册的行动地图 |
| `./client` | 库面板、代理标签、上下文芯片、状态钩 |
| `./connectors` | 连接器注册加公共幻灯片/图像本地编译器 |
| `./embeddings` | 多式联运家庭适应器和烘焙投入 |
| `./eval` | 检索、质量和硬门评价帮助者 |
| `./jobs` | 持久的进口、浓缩、清洗和重建工人 |
| `./messages` | 共享本地化的库 UI 消息 |
| `./schema` | Drizzleure计划与迁移 |
| `./server` | 设置插件、 动作注册、 即时/ 资源线条 |
| `./store` | 查阅范围保修用品 |
| `./vector` | PostgreSQL/ pgvector 适配器和故障清晰后卫 |

## 常见问题

### @agent-native/creative-context 是什么？

共享的创意上下文摄取,版本化,搜索,品牌DNA,以及用于代理本地应用的上下文包装原始\.

### 如何安装 @agent-native/creative-context？

在项目目录运行 npm install @agent-native/creative-context，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：drizzle-orm（\>=0\.45）、@agent-native/core（\>=0\.226\.0-0）、@tanstack/react-query（\>=5\.101\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agent-native/creative-context 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agent-native\_\_creative-context 是否存在。

### @agent-native/creative-context 支持 ESM 还是 CommonJS？

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

### @agent-native/creative-context 可以商用吗？

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

### @agent-native/creative-context 的下载量有多少？

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

### @agent-native/creative-context 还在维护吗？

最新版本 0\.8\.68 发布于 2026/11/07（1 天前）；至今共发布 358 个版本，其中过去 12 个月发布了 358 个；首次发布于 2026/07/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。