PsychonautWiki Journal Substance Database

一个开放的精神活性物质信息数据库，包含给药途径、剂量、持续时间、相互作用、耐受性及安全使用说明，以单一substances.json文件形式打包。An open-access informational database of psychoactive substances, covering administration routes, dosages, effect durations, interactions, tolerance profiles, and safety usage instructions, is packaged as a single substances.json file.

原始信息汇总

journal-data 数据集详情

journal-data 是一个开放、可版本归档的精神活性物质信息数据库，以单个 substances.json 文件形式打包发布，涵盖给药途径、剂量、持续时间、相互作用、耐受性及安全使用说明等数据。该数据集是 PsychonautWiki Journal 应用及其兼容客户端所嵌入的共享数据源，并设计为可被社区扩展和修正的开放数据资源。

仓库结构

路径	内容说明
working/substances.json	维护中的主数据库文件，客户端嵌入此文件
vendor/	各上游应用发布的原始数据快照（如 v15.5.json），用于归档和差异对比
vendor/BASELINE	当前 working/ 所基于的上游版本标识
tools/	用于提取、更新、嵌入数据的脚本，以及 v11 → v15 日志导出转换器
samples/	小型合成日志导出文件，用作模式参考和测试样本
docs/	格式参考文档，其中 v15-export-schema.md 记录了日志导出格式

数据格式

substances.json 包含两个顶层数组，均按 name 字段字母顺序排序：

• substances：每种物质一个对象，包含给药途径、剂量范围、持续时间、耐受性、交叉耐受性和相互作用列表
• categories：物质类别（如兴奋剂、苯二氮卓类）的描述及参考链接

环境要求

• Python 3 和 git（供应商合并依赖 git merge-file）
• 提供 Nix 开发环境支持（nix develop 命令）

参与贡献

• 直接编辑 working/substances.json（为纯 JSON 格式，按物质名称字母排序）
• 可添加缺失的给药途径、修正剂量范围、更正相互作用、补充耐受性时间或添加全新物质
• 提交变更并附带简短说明，然后发起拉取请求
• 所有更改均可通过 git 历史追踪

与上游同步

• 新版本应用的物质数据更新通过 tools/ 脚本进行三方合并，保留社区编辑的同时整合上游变更
• 使用 python3 update_vendor.py --apk /path/to/Journal.apk --version 15.6（或 --ipa）导入新版本
• 合并过程：仅社区修改的字段保留、仅上游修改的字段更新、双方均修改的字段产生 git 冲突标记需手工解决
• 排序机制使每次更新呈现清晰的差异行，保证三方合并的可靠性

应用集成

tools/inject.py 可将 working/substances.json 复制进客户端的构建目录，支持：

• Compose Multiplatform 应用
• Android（apktool 反编译树）
• iOS（解压的 IPA 载荷，同时更新应用及其小部件扩展）

日志导出转换（v11 → v15）

• tools/convert_v11_to_v15.py 可将 PsychonautWiki Journal v11.x 导出（含使用相同 v11 模式的 PsyLog 导出）升级为 v15 导入格式
• v11 → v15 变化为纯增量式：v15 在体验和摄入记录上新增字段，并增加了顶层 exportSource 和 customUnits
• v15 解析器要求新字段，原始 v11 文件会被拒绝；该脚本以真实 v15 导出中的默认值填充这些字段
• 已知限制：v15 格式不包含 customSubstances 字段，脚本会丢弃这些定义并报告丢弃情况；引用这些物质的摄入记录仍可正常导入，仅丢失独立的定义（单位和描述）

工具参考

脚本	用途
extract.py	从 APK 或 IPA 中提取并规范化 substances.json
update_vendor.py	归档新版本并合并至 working/
inject.py	将 working/substances.json 复制到客户端构建目录
convert_v11_to_v15.py	将 v11.x / PsyLog 日志导出转换为 v15 导入格式

许可说明

物质数据源自 PsychonautWiki Journal 项目，底层数据的许可信息请参见该项目。

搜集汇总

数据集介绍

构建方式

PsychonautWiki Journal Substance Database 是一个开放且版本归档的精神活性物质信息数据集，其核心构建方式为将丰富的物质数据整合为单一的 `substances.json` 文件。该文件以 JSON 格式存储，按物质名称字母顺序排列，包含两个顶层数组：`substances` 和 `categories`，分别记录物质的给药途径、剂量范围、持续时间、耐受性、相互作用等细节，以及物质类别的描述与参考链接。数据来源于上游 PsychonautWiki Journal 应用各版本的原始快照（存放于 `vendor/` 目录），并通过 `tools/` 下的脚本进行提取、规范化和更新。社区成员可直接编辑 `working/substances.json` 以补充或修正数据，所有变更经由 git 追踪，确保历史的透明性和可追溯性。

特点

该数据集的设计极具特色，兼具开放性与协作性。其核心特征在于版本归档与三向合并机制：新版本上游数据通过 `update_vendor.py` 归档并与社区编辑内容进行自动合并，仅当双方同时修改同一字段时才会产生冲突，且通过排序规范化（按字母排序）保证了每次更新的 diff 简洁清晰，便于审查。此外，数据集提供了完整的工具链，包括从 APK/IPA 提取数据、注入客户端构建树，以及将 v11 日志导出转换为 v15 格式的脚本，彰显其工程化思维。数据内容涵盖物质安全使用笔记，为精神活性物质研究提供了结构化参考。

使用方法

使用该数据集十分便捷：数据以标准 JSON 格式提供，可直接嵌入各类应用或进行二次开发。对于开发者，`tools/inject.py` 支持将数据集复制到 Compose Multiplatform、Android 反编译树或 iOS Payload 中，实现无缝集成。对于数据维护者，可通过编辑 `working/substances.json` 添加或修正物质信息，并以 pull request 方式提交，借助 git 的冲突标记解决可能的合并问题。此外，`tools/convert_v11_to_v15.py` 可帮助用户升级旧版日志导出文件，使其符合 v15 导入格式，而 `samples/` 中的示例文件则作为模式参考，便于理解数据结构。整个流程设计为开箱即用，只需 Python 3 和 git 环境即可运行全部工具。

背景与挑战

背景概述

PsychonautWiki Journal Substance Database 是一个开放、版本归档的精神活性物质信息数据库，由 PsychonautWiki Journal 项目团队创建，旨在为药物使用相关研究提供系统化、可扩展的数据基础。该数据库整合了给药途径、剂量范围、作用持续时间、相互作用、耐受性及安全使用注意事项等关键信息，并以单一的 `substances.json` 文件形式发布，便于嵌入各类客户端应用。其研究核心在于解决精神活性物质数据分散、不统一的问题，为科研人员、医疗从业者及公众提供可靠的数据源。通过社区协作与工具化更新机制，该数据库已成为该领域数据共享与维护的重要参考，对推动药物安全研究及信息透明化具有显著影响力。

当前挑战

该数据库面临的挑战主要体现在数据准确性与完整性维护的复杂性上。精神活性物质的数据涉及多维度变量（如剂量、时效、交互作用），且随新研究进展需持续更新，这对社区驱动的编辑机制提出了高要求。构建过程中的技术挑战包括：上游版本更新时需通过三方合并保留社区编辑，但冲突处理（如字段同时被修改）需人工介入，增加了维护负担。此外，数据格式的演进（如 v11 至 v15 的转换）中，旧版字段（如 `customSubstances`）的兼容性问题可能导致数据丢失，需在转换工具中特别处理。这些难点考验着数据治理的鲁棒性，也促使项目不断优化工具链以降低协作门槛。

常用场景

经典使用场景

PsychonautWiki Journal Substance Database 作为精神活性物质信息的开源版本化数据库，其核心场景是为移动应用提供嵌入式数据源。该数据集将给药途径、剂量范围、作用持续时间、耐受性及相互作用等关键参数统一封装为结构化的 JSON 文件，便于客户端直接集成。其典型应用模式包括通过 `inject.py` 工具将数据注入 Android、iOS 或 Compose 跨平台应用，从而为使用者提供即时可查的药物安全参考。此外，其版本归档机制（`vendor/` 目录）支持历史数据对比与审计，适合用于研究物质信息随时间演化的趋势分析。

衍生相关工作

基于该数据集，已衍生出多项关联工作，例如 v11 至 v15 的日志导出格式转换工具 `convert_v11_to_v15.py`，用于处理心理活性物质使用日志的兼容性迁移；`update_vendor.py` 则实现了上游应用发布与社区编辑的自动合并，提升了数据维护效率。此外，文档 `docs/v15-export-schema.md` 详细说明了导出模式，为其他开发者实现了数据互操作性参考。这些工作共同构成了一个活跃的工具链，支持数据集的持续演进，并促进了跨平台应用间的数据互通，推动了精神活性物质信息领域的开放科学实践。

数据集最近研究

最新研究方向

该数据集聚焦于精神活性物质信息的开放、版本化存档与社区协作更新，其前沿研究方向体现在构建可溯源、可验证的药物知识图谱，以支持精准剂量学、药物相互作用预警及成瘾风险量化评估。随着全球精神健康议题升温及药物政策松动，如部分国家大麻合法化，此类数据成为药物流行病学、临床毒理学及数字健康干预的重要基础。其版本化归档机制与三路合并算法保障了数据演化的透明性与可靠性，为跨学科研究提供了动态更新的基准数据集，推动了药物安全监测从静态指南向实时、个性化建议的范式转变。