Crowntime WeCom Archive 正式开源：完整的企业微信会话存档系统，支持 Docker Compose 自部署

[zuohaisu]

English version → Introducing Crowntime WeCom Archive

---

Crowntime WeCom Archive 正式开源

2026 年 10 月 9 日，康冠时代（深圳康冠时代科技有限公司）将内部已实际运行数月的「会话存档」系统以 AGPL-3.0 许可证正式开源，首个公开版本为 v1.1.0。

• GitHub 主仓库：https://github.com/zuohaisu/wecom-archive
• Gitee 镜像：https://gitee.com/zuohaisu/wecom-archive
• 官方网站：https://www.crowntime.cn/

为什么做这个项目

起点是我们自己的真实业务需求：团队沟通发生在企业微信里，当需要查找过去的消息、确认沟通过程或处理争议时，需要一个能持续保存、检索和审阅记录的后台。

当时接触的一些 SaaS 方案按座席起售，而小团队的实际使用人数可能只有一两个，年费相对负担不轻。于是我们选择自研：从接入会话存档 API，到做出真正在用的系统，再到今天决定开源——让遇到同样问题的中小团队多一个选择：自己部署，数据在自己的基础设施里。

完整的来龙去脉（包括当初的 15 天倒计时和 7 天 MVP 经历）记录在 Wiki 的产品演化史。

企业微信会话存档的真实工程量

腾讯为企业微信提供了会话存档能力，但官方交付的只是一份 C 语言 SDK（libWeWorkFinanceSdk_C.so）和一组 API。要真正用起来，以下这些都必须自己实现：

• 消息拉取、解密与格式归一化
• 消息与媒体文件的持久化存储
• 多租户数据隔离
• 管理员身份认证与角色权限
• 会话审阅界面与消息检索
• 导出审批与操作审计
• 部署、升级、监控与故障排查

对多数团队而言，真正的成本不在「调通 SDK」，而在这一整套应用工程。这个项目把上面这些做成一个完整应用，而不是一个 SDK 封装。

核心功能

v1.1.0 提供的能力：

• 消息同步、解密、标准化及历史记录处理
• 文本、图片、语音、视频和文件的媒体存档
• 会话审阅、消息搜索与联系人管理
• 多租户隔离、身份认证与角色权限
• 媒体管理、数据导出审批与操作审计
• 运行状态监控、健康诊断与管理后台

架构上，应用由 FastAPI（Web 控制台 + Worker）和 PostgreSQL 组成，媒体支持本地文件系统或对象存储后端。

Docker Compose 自部署

项目提供基于 Docker Compose 的自部署方案，包含 PostgreSQL 16、自动数据库迁移、Web 管理控制台和会话存档/媒体处理 Worker。流程概要：

1. cp .env.example .env，设置数据库密码，并生成两个 Fernet 加密密钥（FIELD_ENCRYPTION_KEY、SETTINGS_ENCRYPTION_KEY）；
2. 从腾讯获取 SDK，放置到 backend/vendor/wecom_sdk/；
3. docker compose up -d --build 启动整套服务；
4. 打开 http://127.0.0.1:8035/admin/settings/init 初始化管理员账号；
5. 在设置向导中录入并测试企业微信会话存档凭据，然后运行首次同步 worker。

完整步骤见 README Quickstart 与 Wiki 安装指南。

自部署版本是完整可用版本，不需要购买或订阅康冠时代云服务，也不会因订阅到期而停用。 数据库与媒体数据都在你自己的服务器上。

腾讯官方 SDK 与企业微信权限要求

• 消息拉取与解密依赖腾讯官方 C SDK。SDK 是腾讯的专有软件，不随本项目或其镜像分发，需部署者按腾讯的条款自行获取。
• 需要一个已开通会话存档功能的企业微信组织，以及相应的企业微信凭据（企业 ID、Secret 等）。
• 生产环境的消息回调需要公网 HTTPS 入口；反向代理与 TLS 证书由部署者自行配置，Compose 默认只绑定本机地址。

AGPL-3.0 许可证与贡献机制

• 项目以 AGPL-3.0 开源：自部署与云托管相关代码使用同一代码库、同一许可证，云版源码不从仓库中排除。
• 贡献采用 DCO（Developer Certificate of Origin，Signed-off-by），不要求 CLA。流程见 CONTRIBUTING.md。

Self-hosted 与 Cloud 的关系

	Self-hosted 自部署	Cloud 云托管
部署位置	你自己的服务器	康冠时代托管
费用	免费，无需订阅	商业订阅
适用	愿意自己运维、要求数据自有	希望省去部署与运维

云托管是面向不想自行运维的企业的可选服务，不是使用开源版的前提；自部署版也不是功能受限的试用版。两者来自同一代码库。

相关入口

• GitHub 主仓库：https://github.com/zuohaisu/wecom-archive （唯一代码主仓库；Issue 与 Pull Request 请统一提交到这里）
• Gitee 镜像：https://gitee.com/zuohaisu/wecom-archive （GitHub 的单向同步镜像，便于国内访问；不在镜像上开发）
• GitHub Release v1.1.0：https://github.com/zuohaisu/wecom-archive/releases/tag/v1.1.0
• 文档（Wiki）：https://github.com/zuohaisu/wecom-archive/wiki （安装、配置、FAQ、架构与 API 参考）
• 贡献指南：https://github.com/zuohaisu/wecom-archive/blob/main/CONTRIBUTING.md
• 问题反馈：https://github.com/zuohaisu/wecom-archive/issues

声明

「WeCom」与「企业微信」是腾讯的商标。本项目是独立的开源项目，与腾讯没有隶属关系，也未获得腾讯的官方支持或背书。本公告不构成任何合规性、数据安全或性能方面的承诺；部署前请自行评估并在你的权限范围内使用。