@clisbot/channels-zalouser

中文文档
2.2.3发布于 2026/11/05TypeScriptES Module近 30 天下载 3389

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

中文使用文档
文档目录5 节
  1. 版式
  2. 何谓有效
  3. 不予支持
  4. 现场测试
  5. 测试

@clisbot/channels-zalouser

内幕 扎洛个人 垂直通道(目标分类账切片 17),从 extensions/zalouser/src 时间 5d8067a4483接通了接通的接通部分; 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.tsL2会话:在留言被放开前承认
src/fusion/admission.ts永久进入 Hub 入侵队列
src/fusion/inbound-adapter.ts本地信息 – 共享 ChannelInboundEvent (单位:千美元)kind + 键 facts(中文(简体) )
src/text-styles*.ts记分- Zalo 风格- 范围编译器( Zalo 没有记分; 它需要样式范围)
src/lifecycle/start-account.tsL4: 安装会话存储, 探测, 注册输入, 运行收听器
src/tool.ts, (中文(简体) ), src/fusion/tools.ts这个 zalouser 代理工具及其中心登记员

偏离、遗漏及其原因 upstream-sync.json - 这儿不是传教区 以 :

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_DIRQR 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).

测试

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

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

版本与发布记录

@clisbot/channels-zalouser 共发布 18 个版本,首次发布于 2026/10/10;过去 12 个月发布了 18 个版本。

版本发布日期距今
2.2.3latest2026/11/055 天前
2.2.22026/11/037 天前
2.2.12026/11/019 天前
2.2.02026/10/2714 天前
2.1.82026/10/2218 天前
2.1.72026/10/2219 天前

关于 @clisbot/channels-zalouser 的常见问题

@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 和提交记录判断。