# @eka-care/medical-records-ui 中文文档

规范地址：https://npmcn.com/package/%40eka-care/medical-records-ui/

版本：1\.2\.44
npm 元数据更新时间：2026-11-13T09:47:17.336Z
中文译文更新时间：2026-11-13T11:45:36.599Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40eka-care/medical-records-ui
原文对照：https://npmcn.com/package/%40eka-care/medical-records-ui/?lang=original

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

- 包体积（解压后）：3.2 MB，66 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：9 个
- peer 依赖：react \>=18，zustand \>=4，react-dom \>=18，react-pdf \>=9，pdfjs-dist \>=4，lucide-react \>=0\.300
- 首次发布：2026-06-08T12:08:08.299Z
- 最新版本发布：2026-11-13T09:47:17.090Z
- 近 30 天下载量：4078（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 69 个）

## 中文简介

Eka Care医疗记录功能的框架不可知反应SDK。 将其丢入任何 React app (Next.js, Vite, Electron) ,以获得完整的记录列表,过滤器,上传流和文档预览.

## 安装

```sh
npm install @eka-care/medical-records-ui
```

也可以使用：`pnpm add @eka-care/medical-records-ui`、`yarn add @eka-care/medical-records-ui`、`bun add @eka-care/medical-records-ui`

## README

# @eka-care/医疗记录-ui

Eka Care医疗记录功能的框架不可知反应SDK。 将其丢入任何 React app (Next.js, Vite, Electron) ,以获得完整的记录列表,过滤器,上传流和文档预览.

## 安装

```bash
npm install @eka-care/medical-records-ui
```

### 同伴依赖关系

确保安装在您的主机应用程序中 :

```bash
npm install react react-dom zustand lucide-react
```

## 设置

### 1\. 导入样式

在您的应用程序的切入点( 如 . `_app.tsx`, (中文(简体) ), `main.tsx`:

```ts
import '@eka-care/medical-records-ui/styles';
```

### 2\. 与 `SdkProvider`

```tsx
import { SdkProvider } from '@eka-care/medical-records-ui';

<SdkProvider
  config={{ environment: 'prod' }}
  bid="YOUR_BID"
  patientId="YOUR_PATIENT_ID"
>
  {/* your app or the RecordsView */}
</SdkProvider>
```

若为 `bid` 或者说 `patientId` 尚未提供(例如没有选定病人), `SdkProvider` 自动使一个占位符——不需要额外处理.

### 3\. 提供记录视图

```tsx
import { SdkProvider, RecordsView } from '@eka-care/medical-records-ui';

export function MedicalRecordsPanel({ bid, patientId }) {
  return (
    <SdkProvider
      config={{ environment: 'prod' }}
      bid={bid}
      patientId={patientId}
    >
      <RecordsView />
    </SdkProvider>
  );
}
```

## `SdkProvider` 道具

| Prop | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `config` | `SdkConfig` | 对 | SDK配置(见下文) |
| `bid` | `string` | 没有 | 企业/诊所身份证。 缺席时显示占位符. |
| `patientId` | `string` | 没有 | 患者身份证. 缺席时显示占位符. |
| `documentTypes` | `DocumentTypeConfig[]` | 没有 | 文档类型标签来自您的登入配置 。 倒回内置标签. |

### `SdkConfig`

| 外地 | 类型 | 说明 |
| --- | --- | --- |
| `environment` | `'prod' | 'staging'` | API 环境 |
| `baseUrl` | `string` | 覆盖 API 基础 URL( 用于代理) |
| `accessToken` | `string` | 认证标志。 如果使用基于 cookie 的认证,则不需要 . |
| `onUnauthorized` | `() => void` | 调用于 401 — 用于刷新符号或重定向以登录 |
| `defaultHeaders` | `Record<string, string>` | 每个请求都添加了额外的信头 |

## `RecordsView` 道具

| Prop | 类型 | 说明 |
| --- | --- | --- |
| `allowUpload` | `boolean` | 显示/ 隐藏上传按钮 。 默认 : `true` |
| `attachedIds` | `string[]` | 已经附于当前会话背景的记录ID |
| `maxAttachable` | `number` | 可同时附加最大记录 |
| `onAttachToContext` | `(records) => void` | 当用户向会话上下文添加记录时调用 |
| `onRemoveAttachment` | `(documentId) => void` | 当用户从上下文中删除记录时调用 |
| `onCopyToNote` | `(text, anchor?) => void` | 当用户复制智能报告到注释时调用 |
| `onToast` | `(message, type?) => void` | 进入主机应用程序的土司/通知系统 |

## 认证

SDK在和Eka Care后端相同的域上运行时会自动使用基于cookie的auth. 对于基于符号的认证密码 `accessToken` 配置和提供 `onUnauthorized` 用于处理符号刷新 :

```tsx
<SdkProvider
  config={{
    environment: 'prod',
    accessToken: yourToken,
    onUnauthorized: refreshToken,
  }}
  bid={bid}
  patientId={patientId}
>
```

## PDF 支持

不需要设置。 PDF预览在盒外工作——SDK自动从CDN装入pdfjs工人.

## 下一个.js

没有多余的网络包配置. `react-pdf` 财务报告和审定财务报表 `pdfjs-dist` 是同位素依赖性 — 在您的应用程序中安装 :

```bash
npm install react-pdf pdfjs-dist
```

## 发展

```bash
# Start the dev playground at https://test.1.eka.care:4443
npm run dev

# Build the SDK
npm run build

# Run tests
npm test
```

### 设计游戏场

游乐场开着 `https://test.1.eka.care:4443` 所以Eka Care后端的Auth cookie可以使用.

1.  添加为 `/etc/hosts`数字 :
    
    ```
    127.0.0.1  test.1.eka.care
    ```
    
2.  生成本地证书 :
    
    ```bash
    cd certificates && mkcert test.1.eka.care
    ```
    
3.  登录 Eka 护理应用程序 `test.1.eka.care` 因此,auth cookie是设置.
    
4.  运行 `npm run dev` 打开 `https://test.1.eka.care:4443`。 。 。 .

## 常见问题

### @eka-care/medical-records-ui 是什么？

Eka Care医疗记录功能的框架不可知反应SDK。 将其丢入任何 React app \(Next\.js, Vite, Electron\) ,以获得完整的记录列表,过滤器,上传流和文档预览\.

### 如何安装 @eka-care/medical-records-ui？

在项目目录运行 npm install @eka-care/medical-records-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18）、zustand（\>=4）、react-dom（\>=18）、react-pdf（\>=9）、pdfjs-dist（\>=4）、lucide-react（\>=0\.300）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @eka-care/medical-records-ui 支持 TypeScript 吗？

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

### @eka-care/medical-records-ui 支持 ESM 还是 CommonJS？

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

### @eka-care/medical-records-ui 可以商用吗？

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

### @eka-care/medical-records-ui 的下载量有多少？

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

### @eka-care/medical-records-ui 还在维护吗？

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