开发者

源代码公开,独立软件包可自由使用。

服务、网站、账户页面、设计文档和 API 定义都在同一个公开代码库中。平台采用 AGPL-3.0 许可证;Wiki 工具包和文档格式软件包采用 Apache-2.0 许可证,不依赖 REZICS 服务。

许可证

两种许可证

  • AGPL-3.0

    平台本身:服务、网站、账户页面和文档。

    services/ · apps/ · generated/ · docs/

  • Apache-2.0

    独立软件包:@rezics/wiki-toolkit 和 @rezics/document,无需 REZICS 账户。

    packages/wiki-toolkit/ · packages/document/

代码库

代码库中有什么

  • services/

    后端服务。Main 提供 API 和 MCP 服务器,Account 负责登录和 OAuth 授权。

    AGPL-3.0

  • apps/web/

    REZICS 网站。它和你的程序一样,只通过 API 获取数据。

    AGPL-3.0

  • apps/web/zones/official/

    官方 Zone 的展示代码,每个软件包对应一个文件夹。

    AGPL-3.0

  • apps/accounts/

    账户页面:登录、安全和已连接应用。

    AGPL-3.0

  • packages/wiki-toolkit/

    本地 Wiki 工具包及其协议和 Skill。

    Apache-2.0

  • packages/document/

    REZICS 文档格式,通过 JSON 结构定义文本和区块。

    Apache-2.0

  • generated/openapi/

    根据路由声明生成的 OpenAPI 文档。

    AGPL-3.0

  • docs/

    设计决策、契约和运维流程,并记录原因。

    AGPL-3.0

运行

在自己的电脑上运行

安装固定版本的工具链和容器运行环境后,运行三条命令就能启动 API、账户服务、网站和账户页面,并列出它们的网址。

task toolchain:install
task dev
task urls
摘自代码库中的说明文档。
import {
  fromPlainText, parseDocument,
  serializeDocument,
} from '@rezics/document';

const snapshot = fromPlainText(
  '漢字\nSecond paragraph',
);
parseDocument(snapshot);
const stored =
  serializeDocument(snapshot);
@rezics/document 无需 REZICS 账户、服务或数据库。示例摘自它的说明文档。

把规则写进代码,把理由写进文档。

能用类型、测试和检查表达的规则,就写进程序;记录决定的原因时,要在文档中附上日期和理由。

用同一套 API,打造自己的工具。

让自己的程序读写作品、书架和社区数据。每次操作都遵循 REZICS 的身份与授权规则。