# @clisbot/channels-zalouser 中文文档

规范地址：https://npmcn.com/package/%40clisbot/channels-zalouser/

版本：2\.2\.3
npm 元数据更新时间：2026-11-05T01:29:24.636Z
中文译文更新时间：2026-11-10T02:21:46.511Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：502 kB，145 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-10-10T10:32:54.904Z
- 最新版本发布：2026-11-05T01:29:24.469Z
- 近 30 天下载量：3389（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

扎洛个人(`zalouser`(b) 垂直信道(目标分类账切片17)。 由扩展/zalouser/src@5d8067a4483:zca-js客户端边界,QR登录状态机,证书/会话关闭,标定文本风格编译器,发送

## 安装

```sh
npm install @clisbot/channels-zalouser
```

也可以使用：`pnpm add @clisbot/channels-zalouser`、`yarn add @clisbot/channels-zalouser`、`bun add @clisbot/channels-zalouser`

## README

# `@clisbot/channels-zalouser`

内幕 **扎洛个人** 垂直通道(目标分类账切片 17),从 `extensions/zalouser/src` 时间 `5d8067a4483`接通了接通的接通部分; [HUB-WIRING.MD (英语)](https://npmcn.com/package/%40clisbot/channels-zalouser/HUB-WIRING.md) 是它创建和保存的交接文档 赫伯一方拥有的纪录.

Zalo个人不是机器人。 它驱动一个 **真实的个人Zalo账户** 结束 `zca-js`,社区客户端,账户通过扫描一个QR代码链接 用电话。 这个单一的事实决定了整个垂直:

-   没有符号可以粘贴——登机是一种活的多步QR流;
-   证书是会话(`imei` + cookie 罐子 + 用户代理),必须是 储存、更新和撤销,而不是静态秘密;
-   进入是推出WebSocket **没有相机和光标**,所以一个信息 如果进程丢弃, 服务器被推走;
-   账户所能做的, 一个人可以做的,这是 最高信任频道在目录.

## 版式

| 路径 | 什麽 |
| --- | --- |
| `src/zca-client.ts` | 这个 `zca-js` 边框; SDK 懒散地加载, 因此元数据可以在没有它的套接字树的情况下被读取 |
| `src/zalo-js.ts` | 端口客户端关闭:QR 登录、会话权限、听众、发送、目录 |
| `src/session-state.ts` | 证书记录及其存储密钥 |
| `src/fusion/session-store.ts` | 这个 `ZalouserSessionStore` 端口+该 `HostRuntime` 密钥存储执行 |
| `src/fusion/qr-setup.ts` | 五个QR动词"Hub"驱动器:启动,民意调查,取消,再链接,登录 |
| `src/fusion/listener-session.ts` | L2会话:在留言被放开前承认 |
| `src/fusion/admission.ts` | 永久进入 Hub 入侵队列 |
| `src/fusion/inbound-adapter.ts` | 本地信息 – 共享 `ChannelInboundEvent` (单位:千美元)`kind` + 键 `facts`(中文(简体) ) |
| `src/text-styles*.ts` | 记分- Zalo 风格- 范围编译器( Zalo 没有记分; 它需要样式范围) |
| `src/lifecycle/start-account.ts` | L4: 安装会话存储, 探测, 注册输入, 运行收听器 |
| `src/tool.ts`, (中文(简体) ), `src/fusion/tools.ts` | 这个 `zalouser` 代理工具及其中心登记员 |

偏离、遗漏及其原因 [`upstream-sync.json`](https://npmcn.com/package/%40clisbot/channels-zalouser/upstream-sync.json) - 这儿不是传教区 以 :

```bash
node scripts/channel-upstream-sync.mjs check --pkg zalouser
```

## 何谓有效

-   **QR 登录** 开始 QR PNG(数据 URL + 私人临时文件) 民意调查 – 民意调查 – 链接, 与再链接( 强制执行新的 QR, 丢弃存储会话) , 取消 和登录。 报告为过期和下降,而不是吞咽.
-   **持续会期** - QR证书到注入会话的商店, 在下一个账户启动时恢复,刷新为 `zca-js` 旋转 饼干,在登录时留下一个持久的吊销标记,这样就难懂了 不能使他们复活.
-   **入境** ——直接和分组消息,发件人标签,组名,引文 (所引用的身体和主人旅行作为事实),明确而隐含地提到, 和领先者 `/verb` 作为 `command` 活动。 每条消息都是经久不衰的 在收听者前进前,请先到 Hub 队列.
-   **出境** - 带有Zalo本土风格的文本 范围从马克下调, 2000- 字符块, 样式按块切开, 本地文件上传 (音频成为语音信息),链接,以及打字/交付/见原始.
-   **信件工具** 一个动作, `react`结束 `msgId` + 键 `cliMsgId`。 。 。 .
-   **代理工具** —— 说 `zalouser` 与上游的7个行动`send`, (中文(简体) ), `image`, (中文(简体) ), `link`, (中文(简体) ), `friends`, (中文(简体) ), `groups`, (中文(简体) ), `me`, (中文(简体) ), `status`) (中文(简体) ).
-   **目录** ——朋友和团体按姓名或身份查询,团体成员.

## 不予支持

-   **丝线.** Zalo个人没有;上游针头 `replyToMode: "off"`。 。 。 . 外出回复是谈话中一个简单的信息.
-   **入网媒体下载.** 附件作为信件内容到达 上游监视器将它们变成代理附属物 由Hub拥有而不是 携带`upstream-sync.json` 省略: `monitor.ts`) (中文(简体) ).
-   **打字/送出/见出.** 连接客户端( W)`send.ts`)但没有驱动 ——Hub的流媒体制作人尚不知道这个频道.
-   **平按:"素问"作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作平作.** 平台没有他们的API.
-   **管理部/组访问策略,对齐,允许列表名称解析.** 枢纽拥有 (目标分类账23)。 团体范围帮助人被携带,政策没有.

## 现场测试

生活E2E需要一个 **有电话的人**: QR 代码必须被 Zalo 扫描 在测试中, 没有办法绕过。 一个人的计划,不是 证书.

环境可变名称( 数值位于 root) `.env`,这个 软件包从不直接读取,并且不能执行:

| 变量 | 作用 |
| --- | --- |
| `ZALO_PERSONAL_TEST_CLISBOT_USER_ID` | 正在测试的个人账户的 Zalo 用户 ID |
| `ZALO_PERSONAL_TEST_LONG_USER_ID` | 发送标记的人司机的Zalo用户ID |
| `ZALOUSER_PROFILE` 编号 : `ZCA_PROFILE` | 会话的证书配置文件存储在( 上游的自定义内存名称 ) |
| `ZALOUSER_TMP_DIR` | QR PNG 写入时的可选更改 |

循环 :

1.  启动账户; 它以“ 不链接” 快速失败, 直到会话存在 .
2.  调用 QR 启动动词, 打开返回的 PNG 从签名的电话扫描 作为 `ZALO_PERSONAL_TEST_CLISBOT_USER_ID`。 。 。 .
3.  投票直到 `linked`; 确认报告 `user.userId` 和那个身份相符.
4.  从驱动程序账户( F)`ZALO_PERSONAL_TEST_LONG_USER_ID`),DM 链接 账户为标记.
5.  把经纪人的回复读回来 **在同一个谈话中** 与 返回消息 id —— 不读回的发件不是经过验证的发件.

有两个活的风险值得说明 在任何人运行之前:

-   个人账户客户不是受制裁的API. 使用测试账户.
-   存储的会话是该账户的完整证书. 这一定是 由会话商店的后置内容加密(HUB-WIRING.md §6).

## 测试

```bash
npx vitest run packages/channels/zalouser/src/<file>.test.ts --maxWorkers=1 --no-file-parallelism
```

港口的上游测试保留他们的名字;聚变自主测试坐在接缝旁边 它们涵盖(`src/fusion/*.test.ts`) (中文(简体) ).

## 常见问题

### @clisbot/channels-zalouser 是什么？

扎洛个人\(zalouser\(b\) 垂直信道\(目标分类账切片17\)。 由扩展/zalouser/src@5d8067a4483:zca-js客户端边界,QR登录状态机,证书/会话关闭,标定文本风格编译器,发送

### 如何安装 @clisbot/channels-zalouser？

在项目目录运行 npm install @clisbot/channels-zalouser，或使用 pnpm add / yarn add / bun add。

### @clisbot/channels-zalouser 支持 TypeScript 吗？

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

### @clisbot/channels-zalouser 支持 ESM 还是 CommonJS？

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

### @clisbot/channels-zalouser 可以商用吗？

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

### @clisbot/channels-zalouser 的下载量有多少？

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

### @clisbot/channels-zalouser 还在维护吗？

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