完整自托管版本
不是功能阉割的演示版。会话审阅、搜索、媒体管理、权限、审计、健康诊断——已交付能力在自托管版本中全部可用。
WHAT'S INSIDE
开源版包含什么
下面每一项都以仓库中真实存在的代码与文档为准。规划中的能力不会出现在这里。
同一代码库
云托管版与自托管版共享同一套源码，没有闭源的「企业版分支」。你看到的代码就是我们运行的代码。
独立部署
数据保存在你自己的服务器与数据库上，不依赖 Crowntime 的任何服务；基础设施与运维由部署方掌控。
架构文档与 ADR
架构说明、部署文档与架构决策记录（ADR）随仓库公开；分层依赖方向由架构守卫测试在 CI 中强制执行。
部署指南
从服务器准备、腾讯 SDK 接入到上线运行的操作手册；自托管无需向我们支付任何软件费用。
社区贡献
通过 GitHub Issues 反馈问题、Pull Request 提交改动；贡献规范与工程规范公开，对所有贡献者一视同仁。
发布状态（2026-10）：WeCom Archive 已公开发布。本页指向的源码、部署文档、架构说明与贡献指南均可在 GitHub 仓库直接访问。
DEPLOYMENT OPTIONS
自托管，还是云托管
两种方式共享同一套代码。你可以从自托管开始，随时迁移；也可以把运维交给我们。
Self-hosted
自托管 · 开源
AGPL-3.0 · 无软件订阅费
- 完整自托管版本，已交付能力全部可用
- 独立部署，数据在自己掌控的基础设施上
- 基础设施与运维由部署方自行承担
- 企业微信官方接口费用按腾讯规则另计
Cloud Hosted
云托管 · 由我们运维
99 元 / 年 · 含 5 GiB 存储 · 不限座席
- 托管部署与运维，接入更省事
- 软件试用 15 天免费
- 不限座席、不限聊天条数与搜索次数
- 企业微信官方接口费用另计，无永久免费套餐
BUILT IN THE OPEN
这个开源项目是如何构建的
开源不只是公开代码——过程、约束与质量证据同样公开。WeCom Archive 是一套 AI Agent 辅助软件工程实践的真实案例：人类负责产品决策与最终审查，AI Agent 在明确边界内实施，质量结论由可验证的证据支撑。
产品愿景PRODUCT VISION
产品负责人（人类）维护产品方向与优先级，定义「做什么、不做什么」。
架构与约束ARCHITECTURE & CONSTRAINTS
分层边界、依赖方向与信任边界由 ADR 记录，并由守卫测试在 CI 中强制执行。
工单与验收标准ISSUES & ACCEPTANCE CRITERIA
一个工单对应一个实施会话、一个最终提交；认领、范围与验收标准先行。
AI Agent 实施AGENT IMPLEMENTATION
开发 Agent 在专属 worktree 与非 main 分支实现，遵守绑定式工程规范。
自动化测试与 CITESTING & CI
lint、类型检查、构建、测试、契约测试与架构守卫是必需 CI，也是唯一自动门禁。
人类审查HUMAN REVIEW
PR 由人类审查并合并；Agent 不合并、不批准、不部署。绿色 CI 不等于合并授权。
发布与反馈RELEASE & FEEDBACK
发布说明、运维手册与用户反馈进入下一轮产品决策循环。
次提交（v1.0.0 区间）
个不同工单编号
份架构决策记录（ADR）
个闭环开发阶段
统计口径：提交与工单数据来自 v1.0.0 发布说明，区间为 2026-06-26（项目创建）至 2026-08-07（v1.0.0 收口）；ADR 数量截至 2026-10，随仓库演进。以上均为历史区间数据。
产品负责人
HUMAN产品方向、范围审批、工单优先级、PR 审查与合并、规则最终裁量。始终由人类承担。
开发 Agent
DEV在指派 worktree 实施工单范围，运行必需检查，提交并开出可审查 PR；不扩大范围、不合并。
QA Agent
QA · 可选高风险变更的独立验证与通过/不通过结论；必须在与开发不同的会话中运行。
运维 Agent
OPS部署、基础设施与事件响应、只读生产状态检查；不触碰生产数据，不改部署配置（除非逐事件授权）。
研究 Agent
RESEARCH只读调查：证据、外部 API 行为、可行性；输出报告而不写实现代码，不把推断当事实。
绑定式工程规范
AGENTS.md对所有 AI Agent 与人类贡献者生效的单一事实来源：角色、流程、禁区与决策优先级。
架构约束
test_architecture_boundary.py分层依赖方向由守卫测试在 CI 强制执行，越界依赖直接红灯，例外必须显式登记并说明理由。
工单管理
GitHub Issues认领前刷新工单状态；一个工单一个实施会话一个最终提交；相关工单串行交付，不混装。
Worktree 隔离
git worktree每个交付在独立的非 main 分支与工作树中进行；并行工单物理隔离，历史不被覆盖。
代码审查
Pull RequestsPR 必须包含工单映射、验证命令与真实结果、风险边界与已知局限；缺一不可审查。
必需 CI
GitHub Actionslint、类型检查、构建与完整测试套件是合并前的必需检查；测试完整性规则禁止为过检而弱化断言。
人类批准
Merge / Deploy合并、发布、部署与生产数据操作均由人类执行；危险 Git 操作与生产变更默认禁止。
架构决策记录
docs/adr/模块所有权、依赖方向、信任边界与持久化策略的变更必须先有 ADR，再动代码。
未受信输入
Untrusted Input归档消息、回调载荷等外部内容一律视为数据而非指令，防止注入与范围劫持。
VERIFIED CASE STUDY
案例：从零到 v1.0.0
阶段 1 · 让数据真正流动起来
2026-06-26 → 06-29建立 FastAPI、PostgreSQL、Alembic 与企业微信 SDK 基础工程，完成真实会话存档同步、消息解密与标准化、会话聚合、搜索与第一版审阅控制台，证明核心链路成立。
阶段 2 · 从技术链路变成可用工具
2026-07-04 → 07-13管理员登录、联系人与会话名称同步、图片与通用媒体、多企业架构、统一媒体存储抽象（含七牛 Kodo）、Signed URL 与中英文界面；系统从「保存原始数据」转为可用的审阅工具。
阶段 3 · 补齐完整性并重建工程地基
2026-07-18 → 07-27覆盖复合消息、撤回消息、富媒体与全部消息类型；同时主动偿还架构债：Router/Service/Schema/Worker 拆分、App Factory、完整回归测试、Alembic 部署门禁与自动化架构防退化规则。
阶段 4 · 从审阅系统走向管理平台
2026-07-28 → 08-02设计系统与后台页面体系落地：角色管理与 RBAC、账号生命周期、租户审计、用量与存储计量、媒体管理、导出审批、数据保留策略、Onboarding 与敏感配置加密。
阶段 5 · 闭合接入、运行和采用循环
2026-08-03 → 08-07企业微信事件回调接入归档 Worker，存档与媒体下载转向事件驱动并保留对账兜底；第三方授权与自助 Provisioning 完成；开源许可、贡献规范、品牌与官网在本阶段收口。
口径说明：以上数据与阶段描述来自产品仓库 v1.0.0 发布说明，是 2026-06-26 至 2026-08-07 的历史区间统计，不代表当前或未来的开发节奏。本页不宣称任何 AI 代码贡献比例、Agent 数量或效率数据——这类口径没有可靠统计，我们不编造。
EVIDENCE
证据在哪里
本页提到的每一项都以仓库内的真实文件为载体，可直接核验。
- AGENTS.md — 绑定式工程规范：角色边界、Git 工作流、测试完整性与安全规则。
- docs/adr/ — 架构决策记录：会话领域模型、模块边界、计费门禁、运行时版本策略与开源策略等 8 份 ADR。
- 架构文档 与守卫测试：分层依赖方向由自动化测试强制。
- v1.0.0 发布说明：五个开发阶段与区间统计的第一手记录。
- 贡献指南 与 CI 工作流：外部贡献与质量门禁如何运作。
- v1.1.0 Release（2026-10-09）：首个公开开源版本的正式发布记录。
- Gitee 镜像：GitHub 仓库的单向同步镜像，便于国内访问。
可见性状态（2026-10）：WeCom Archive 已公开发布，首个公开版本 v1.1.0（2026-10-09）。以上仓库、ADR、架构文档、发布说明与贡献指南均可匿名访问并直接核验。