aleph

.. epigraph::

真理无法渗透封闭的心灵。如果宇宙中所有的地方都在阿莱夫里，那么所有的星星、所有的灯、所有的光源也都在这其中。

-- 《阿莱夫》（http://www.phinnweb.org/links/literature/borges/aleph.html）， 豪尔赫·路易斯·博尔赫斯

⚠️ 项目状态：即将停止维护 ⚠️ 我们对此开源项目的参与正在逐步终止。此版本的维护将在2025年12月后正式结束。

为什么？

这一决定标志着我们战略上的重大转变。在过去一年中，我们的团队已从头完全重写 Aleph 代码库，并推出了 Aleph Pro。随着我们向这一新的受支持平台过渡，我们将把所有资源集中在 Aleph Pro 上，以确保全球调查工作的持续运转。

有关此决定及其未来影响的更多详情，请阅读我们的 官方常见问题解答 <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__。

时间线与支持

• 我们将继续为这个仓库提供维护，直到2025年12月31日。此日期之后，核心团队将不再提供任何更新、错误修复或支持。
• 如有关于过渡或遗留软件的任何问题，请通过我们的 Discourse 社区 <https://aleph.discourse.group//>__ 联系我们。
• 对于当前自行托管 Aleph 实例的用户，我们将很快与您联系，讨论过渡事宜。
• 希望合作的组织和个人可发送邮件至 [email protected]。

感谢！ 我们为我们迄今所取得的成就感到无比自豪。感谢所有为这个项目做出贡献并相信我们使命的贡献者和社区成员。

关于本软件

Aleph 是一个用于索引大量文档（PDF、Word、HTML）和结构化数据（CSV、XLS、SQL）的工具，以便于浏览和搜索。它以调查报道为主要用例而构建。Aleph 允许对已知实体（如人员和公司）的提及与观察列表（例如来自先前研究或公共数据集）进行交叉引用。

有关本软件的更多详情、使用方法、安装步骤或数据导入管理，请查阅文档：

• https://docs.aleph.occrp.org
• 安装指南：https://docs.aleph.occrp.org/developers/installation

支持

Aleph 由多个组织和感兴趣的个人使用和开发。如果您有兴趣参与其中，请阅读支持政策（SUPPORT.md）、贡献规则（CONTRIBUTING.md）和行为准则（CODE_OF_CONDUCT.md），然后与我们取得联系：

• https://docs.aleph.occrp.org/get-in-touch

Aleph 开发

如果您希望参与 Aleph 的开发，请查看 CONTRIBUTING.md 文件以获取入门详情。

⚠️ 重要 ⚠️ 本 GitHub 仓库的默认分支是 develop。develop 分支包含未发布的、不稳定的代码。如需稳定版本，请查看 版本列表 <https://github.com/alephdata/aleph/releases>_ 或切换到 main 分支 <https://github.com/alephdata/aleph/tree/main>_。

发布流程

如果您有兴趣或受命发布新版本的 Aleph，请遵循以下步骤：

概述

发布 Aleph 的基本流程如下：

1. 检查内部库的更新并进行合并。按以下顺序发布内部库：
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. 确保所有用于发布的库在 aleph 中都是最新的，并且已合并到 develop 分支。
7. 确保所有功能、错误修复已合并到 develop，并且所有构建均通过。
8. 确保 CHANGELOG.md 文件在 develop 分支上保持最新。根据需要添加信息。
9. 创建 Aleph 的 RC 版本。
10. 测试并验证 RC 版本。根据需要发布更多 RC 版本。
11. 将所有更改合并到 main 分支。
12. 创建 Aleph 的最终版本。

在确定发布类型时，应尽可能应用语义化版本控制规则。

技术流程

RC 版本

如果您需要执行 Aleph 的 RC 版本发布，请遵循以下步骤：

1. 确保 CHANGELOG 在 develop 分支上是最新的，并且所有未解决的 PR 已合并。
2. 在 develop 分支上运行 bump2version（major、minor、patch），这将创建 x.x.x-rc1 版本的 aleph。
3. 使用 git push --tags 将标签推送到远程。
4. 使用 git push 推送版本号提升。
5. 如果 RC 版本存在问题，您可以修复这些问题，并使用 bump2version build 生成新的 RC 版本。

主版本、次版本、补丁版本

1. 切换到 main 并从远程拉取。
2. 如果尚未完成，将 develop 合并到 main。
3. 使用 make translate 更新翻译。
4. 如果遇到 npm 错误，请进入 ui 文件夹并运行 npm install。
5. 将翻译提交到 main 并推送到远程。
6. 运行 bump2version --verbose --sign-tags release。注意：bump2version 在修改时不会显示更改，但会生效（可通过 git log 查看）。
7. 使用 git push --tags 将标签推送到远程。
8. 使用 git push 将版本号提升推送到远程。
9. 将 main 合并回 develop。虽然这与发布流程关系不大，但这是执行此操作的好时机，以便新版本号也出现在 develop 中。