@fencyai/react

中文文档
0.1.227发布于 2026/10/28MITTypeScriptES Module零依赖近 30 天下载 2293

Fency AI 平台的响应组件和钩

中文使用文档

@fencyai/react

官方反应 SDK 为 (法语)。 。 。 .

详情请访问 (原始内容存档于2018-03-21) (英语). docs.gency.ai。 。 。 .

设置

挂载 FencyProvider 一次在应用根。 每个 useAgentTasks 钩子和 它的每一个代理任务 共享相同的流。 不增加每名提供者 页面、组件、钩子或任务.

import { loadFency } from '@fencyai/js'
import { FencyProvider, useAgentTasks } from '@fencyai/react'

const fency = loadFency({ publishableKey: 'pk_your_publishable_key' })

export default function App() {
  return (
    <FencyProvider
      fency={fency}
      fetchCreateStreamClientToken={async () => {
        const res = await fetch('/api/stream-client-token', { method: 'POST' })
        return res.json()
      }}
    >
      <Chat />
      <Search />
    </FencyProvider>
  )
}

function Chat() {
  const { createAgentTask } = useAgentTasks({
    fetchCreateAgentTaskClientToken: fetchChatToken,
  })
  return null
}

function Search() {
  const { createAgentTask } = useAgentTasks({
    fetchCreateAgentTaskClientToken: fetchSearchToken,
  })
  return null
}

fetchCreateStreamClientToken 不是每个任务的名称。 提供者重复使用 a 5分钟左右,然后薄荷一个新的。 你的后端应该 POST /v1/sessions 与 { createStream: {} } 返回时 { clientToken }。 。 。 .

版本与发布记录

@fencyai/react 共发布 223 个版本,首次发布于 2025/07/05;过去 12 个月发布了 158 个版本。

版本发布日期距今
0.1.227latest2026/10/2817 天前
0.1.2262026/10/2025 天前
0.1.2252026/09/251 个月前
0.1.2242026/09/122 个月前
0.1.2232026/09/082 个月前
0.1.2222026/09/042 个月前

关于 @fencyai/react 的常见问题

@fencyai/react 是什么?

Fency AI 平台的响应组件和钩

如何安装 @fencyai/react?

在项目目录运行 npm install @fencyai/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.8.0)、motion(^11.15.0 || ^12.0.0)、remark-gfm(^4.0.1)、@fencyai/js(^0.1.227)、react-markdown(^10.1.0)、react-syntax-highlighter(^16.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fencyai/react 支持 TypeScript 吗?

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

@fencyai/react 支持 ESM 还是 CommonJS?

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

@fencyai/react 可以商用吗?

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

@fencyai/react 的下载量有多少?

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

@fencyai/react 还在维护吗?

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