# @cacic-fct/account-manager-privacy 中文文档

规范地址：https://npmcn.com/package/%40cacic-fct/account-manager-privacy/

版本：0\.1\.9
npm 元数据更新时间：2026-10-24T22:17:12.126Z
中文译文更新时间：2026-11-08T23:15:33.852Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40cacic-fct/account-manager-privacy
原文对照：https://npmcn.com/package/%40cacic-fct/account-manager-privacy/?lang=original
项目主页：https://github.com/cacic-fct/account-manager#readme
源码仓库：https://github.com/cacic-fct/account-manager

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

- 包体积（解压后）：32.4 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：rxjs ^7\.8\.0，@angular/core \>=19，@angular/common \>=19
- 首次发布：2026-06-24T20:24:37.268Z
- 最新版本发布：2026-10-24T22:17:11.771Z
- 近 30 天下载量：3744（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

CACiC账户隐私偏好角客户端.

## 安装

```sh
npm install @cacic-fct/account-manager-privacy
```

也可以使用：`pnpm add @cacic-fct/account-manager-privacy`、`yarn add @cacic-fct/account-manager-privacy`、`bun add @cacic-fct/account-manager-privacy`

## README

# @cacic-fct/ 账户管理者- 隐私

从账户 API 读取 CACiC 账户隐私偏好时的角客户端.

## 安装

从公共 npm 注册处安装 Bun :

```bash
bun add @cacic-fct/account-manager-privacy
```

## 使用

```ts
import { CacicAccountPrivacyService, provideCacicAccountPrivacy } from '@cacic-fct/account-manager-privacy';
```

当账户 API 基础 URL 与默认不同时, 将提供者添加到应用程序配置中 :

```ts
providers: [
  provideCacicAccountPrivacy({
    apiBaseUrl: 'https://account.cacic.com.br/api',
  }),
];
```

弹出 `CacicAccountPrivacyService` 读取诸如 `analyticsEnabled`, (中文(简体) ), `errorDebuggingEnabled`, (中文(简体) ), `performanceMonitoringEnabled`,以及 `cookieBannerAccepted`。 。 。 .

使用 `refreshTrackingCookies()` 在登录/ 会话刷新后要求账户管理器刷新共享的 CACiC 分析 cookie 。 使用 `clearTrackingCookies()` 在双胞胎应用程序中登出时,然后重新定向.

## Umami 跟踪助手

静态站点可以使用浏览器帮助在加载 Umami 之前尊重账户管理器隐私设置 :

```ts
import { initCacicUmamiTracking } from '@cacic-fct/account-manager-privacy/umami-tracking';

await initCacicUmamiTracking({
  websiteId: 'your-umami-website-id',
  domains: ['cacic.com.br'],
});
```

帮助者刷新 `/api/tracking/session`,读取共享的 CACiC 饼干,当账户管理器拥有时加载 Umami `analytics_tracking` 启用和调用 `umami.identify()` 与 `cacic-analytics-id` 饼干作为美美的区别ID。 匿名访客没有被跟踪 `identify()` 除非一个同意饼干明确禁止分析。 Cookie横幅接受情况在识别有效载荷中单独报告。 它不会发送电子邮件、名称或配置字段,除非呼叫者明确通过 `identifyData`。 。 。 .

通过只制作的脚本标记配置分析器的站点可以使用当前标注的靴子:

```ts
import { startCacicUmamiTrackingFromCurrentScript } from '@cacic-fct/account-manager-privacy/umami-tracking';

startCacicUmamiTrackingFromCurrentScript({
  identifyData: {
    source: window.location.hostname,
  },
});
```

## 出版

这个包具有独立的放出周期. 更新情况 `libs/account-privacy` 触发软件包的发布工作流程,从而撞出这个软件包自己的 `version` 在合并应公布的更改之前. CI 工作流程通过 Trusted Publishing 发布此软件包至 npm.

## 常见问题

### @cacic-fct/account-manager-privacy 是什么？

CACiC账户隐私偏好角客户端\.

### 如何安装 @cacic-fct/account-manager-privacy？

在项目目录运行 npm install @cacic-fct/account-manager-privacy，或使用 pnpm add / yarn add / bun add。

### @cacic-fct/account-manager-privacy 支持 TypeScript 吗？

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

### @cacic-fct/account-manager-privacy 支持 ESM 还是 CommonJS？

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

### @cacic-fct/account-manager-privacy 可以商用吗？

@cacic-fct/account-manager-privacy 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @cacic-fct/account-manager-privacy 的下载量有多少？

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

### @cacic-fct/account-manager-privacy 还在维护吗？

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