# @feedmepos/mf-common 中文文档

规范地址：https://npmcn.com/package/%40feedmepos/mf-common/

版本：1\.29\.40
npm 元数据更新时间：2026-11-05T11:39:28.515Z
中文译文更新时间：2026-11-14T13:18:23.330Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40feedmepos/mf-common
原文对照：https://npmcn.com/package/%40feedmepos/mf-common/?lang=original

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

- 包体积（解压后）：7.8 MB，155 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：20 个
- 首次发布：2023-10-24T23:40:23.585Z
- 最新版本发布：2026-11-05T11:39:28.300Z
- 近 30 天下载量：2356（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：256（近 12 个月 47 个）

## 中文简介

本套件提供:

## 安装

```sh
npm install @feedmepos/mf-common
```

也可以使用：`pnpm add @feedmepos/mf-common`、`yarn add @feedmepos/mf-common`、`bun add @feedmepos/mf-common`

## README

# @ feedmepos/ mf- 常见

本套件提供:

-   共享门户 shell 组件
    
-   共享核心Store pinia 商店
    
-   其他共享公用事业,如:i18n、国家等
    

## 更改日志

见 [变动情况](https://npmcn.com/package/%40feedmepos/mf-common/CHANGELOG.md) 关于每个版本的修改细节.

* * *

# Remy 融合指南

## 概览

通用软件包为将Remy AI助手整合到微前端提供了简化的界面. 共同一揽子计划的责任只是:

1.  点击 Remy 图标时注册回调
2.  基于召回注册显示/隐藏 Remy 图标
3.  单击图标时触发回调

## 使用量

### 1\. 登记Remy回电

在您的微前端( 例如 ), `mf-menu`),记录在点击Remy图标时将触发的回调:

```typescript
import { useCoreStore } from '@feedmepos/common'

const coreStore = useCoreStore()

// Register your callback
coreStore.registerOnRemyClicked(() => {
  // Your Remy logic here
  // For example: open Remy dialog, activate Remy session, etc.
  console.log('Remy icon clicked!')
})
```

### 2\. 自动图标显示

注册回调时:

-   这个 `publicSetting.aiSettings.remy.enable` 将自动设定为 `true`
-   Remy 图标将出现在桌面、 移动和平板视图
-   图标是显示雷米动画的视频元素

### 3\. 图标点击行为

当用户点击Remy图标时:

-   将触发已注册的回调
-   您控制接下来会发生什么( 打开对话框、 启动会话等 )

## 执行细节

### 桌面 (Portal-Desktop.vue)

-   图标出现在用户信息旁边的标题中
-   在调试和存储前键之前的位置

### 移动( Portal Mobile.vue) :

-   图标出现在页脚导航中
-   位于菜单按钮旁边

### 平板电脑( PortalTablet.vue)

-   图标出现在页眉中
-   类似桌面视图的位置

## 示例:全面整合

```typescript
// In your microfrontend's main component or setup
import { onMounted } from 'vue'
import { useCoreStore } from '@feedmepos/common'

onMounted(async () => {
  const coreStore = useCoreStore()
})
```

## 福利

1.  **脱钩**:常见的套件不需要知道雷米的落实细节
2.  **弹性**: 每个微前端可以执行自己的Remy行为
3.  **简单 API**: 只有一种登记方法,图标可见度是自动的
4.  **一致的 UX**: 图标在所有视图中在同一位置出现

## 常见问题

### @feedmepos/mf-common 是什么？

本套件提供:

### 如何安装 @feedmepos/mf-common？

在项目目录运行 npm install @feedmepos/mf-common，或使用 pnpm add / yarn add / bun add。

### @feedmepos/mf-common 支持 TypeScript 吗？

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

### @feedmepos/mf-common 支持 ESM 还是 CommonJS？

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

### @feedmepos/mf-common 可以商用吗？

@feedmepos/mf-common 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @feedmepos/mf-common 的下载量有多少？

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

### @feedmepos/mf-common 还在维护吗？

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

