@fias/arche-sdk

中文文档
2.35.0发布于 2026/11/14MITTypeScriptESM + CJS零依赖近 30 天下载 3746

用于构建 FIAS 平台插件拱门的 SDK

中文使用文档
文档目录5 节
  1. 快速启动
  2. 完全开发者指南
  3. 保持现有项目的当前状态
  4. 相关文件
  5. 许可证

@fias/arche-sdk (英语)

FIAS平台上用于构建插件拱的运行时间SDK. 提供回放钩,一个沙盒式的iframe桥,以及应用中购买 / Vault / 资产库 / 图像生成在运行时会浮出一个插件需要.

快速启动

脚手架新插件 :

npx create-fias-plugin my-plugin
cd my-plugin
npm install
npm start

将您的应用程序包入 <FiasProvider>数字 :

import { FiasProvider, useFiasTheme } from '@fias/arche-sdk';

function App() {
  const theme = useFiasTheme();
  if (!theme) return null;
  return <div style={{ color: theme.colors.text }}>Hello, plugin!</div>;
}

ReactDOM.createRoot(document.getElementById('root')!).render(
  <FiasProvider>
    <App />
  </FiasProvider>,
);

完全开发者指南

完整的插件开发参考——每个钩子,显示的图案,IAP,Vault,资产库,许可范围,沙盒限制,以及提交工作流程——拥有此包的船舶在:

./templates/default/CLAUDE.md

此文件是可读的 Canonic AI 插件导览, 与该插件完全相同 CLAUDE.md 编号 : AGENTS.md 写入新脚手架项目。 打开它 node_modules/@fias/arche-sdk/templates/default/CLAUDE.md 安装后.

保持现有项目的当前状态

npx fias-dev sync

更新 CLAUDE.md, (中文(简体) ), AGENTS.md, (中文(简体) ), .cursorrules,以及 .github/copilot-instructions.md 在您最近的 SDK 模板中的项目中。 永远不要碰 package.json, (中文(简体) ), fias-plugin.json,或 src/。 。 。 .

许可证

麻省理工学院

版本与发布记录

@fias/arche-sdk 共发布 69 个版本,首次发布于 2026/02/22;过去 12 个月发布了 69 个版本。

版本发布日期距今
2.35.0latest2026/11/14今天
2.34.02026/11/095 天前
2.33.02026/10/3114 天前
2.32.02026/10/2916 天前
2.31.02026/10/2817 天前
2.30.02026/10/2619 天前

关于 @fias/arche-sdk 的常见问题

@fias/arche-sdk 是什么?

用于构建 FIAS 平台插件拱门的 SDK

如何安装 @fias/arche-sdk?

在项目目录运行 npm install @fias/arche-sdk,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 create-fias-plugin,可以用 npx create-fias-plugin 直接运行。

@fias/arche-sdk 支持 TypeScript 吗?

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

@fias/arche-sdk 支持 ESM 还是 CommonJS?

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

@fias/arche-sdk 可以商用吗?

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

@fias/arche-sdk 的下载量有多少?

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

@fias/arche-sdk 还在维护吗?

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