安装与环境

Python 支持 3.12 和 3.13（>=3.12,<3.14）。已有本地 wheel 时无需源码。Windows 可使用下方命令；Linux 的进程清理与结果发布还要求本页列出的系统能力，不能仅凭 Python 版本或 wheel 的 any 标签判断可用。

Python、依赖和平台条件

正常安装由包元数据选择依赖，不需要分别手动安装 CAN 库。

源码的 requirements/ 保存 Windows x86_64 下 Python 3.12.4、3.13.17 的四个依赖环境快照，分别采用本轮最低与候选最高组合。它们用于复现已选环境；允许范围不等于所有中间版本和交叉组合都经过测试。使用 wheel 时以该 wheel 的安装元数据为准，不能把新源码说明当作旧发行包已经具备的能力。

实际启动受管工作进程时，Linux 的进程管理需要 Python 提供 pidfd_open、pidfd_send_signal，且内核接受 Linux 6.9 引入的 PIDFD_SIGNAL_PROCESS_GROUP。不覆盖发布需要 libc 提供 renameat2，目标文件系统实际支持 RENAME_NOREPLACE，且临时文件与目标位于同一文件系统。缺少这些能力时程序明确拒绝相应操作，不退回可能覆盖旧文件的发布方式。pidfd要求不适用于仅做静态validate/explain或未启动受管工作进程的内联计算；独立批量任务即使进程上限为1也可能启动工作进程。

本轮 Linux 核验环境是 x86_64 Docker 容器、WSL2 内核 6.18.54.1-microsoft-standard-WSL2、glibc 2.41、Python 3.12.15，测试目录位于 overlayfs。其他文件系统（包括 NFS、SMB、FUSE）、CPU 架构、原生 Linux 宿主发行版及 macOS 未由这一环境的结果覆盖。Linux 6.9 或更新内核只是所需能力的一部分，不代表所有这种系统均已验收。

从 PyPI 安装

本手册对应 0.1.0.dev4 开发预览版。指定版本号安装，避免使用其他版本的配置说明：

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "chronaxis==0.1.0.dev4"
.\.venv\Scripts\python.exe -m pip check
.\.venv\Scripts\python.exe -m chronaxis guide

安装时会自动取得运行依赖；guide 显示随包指南的 README 路径，可直接打开阅读。已有同版 wheel 或需要离线安装时，使用下一节。

使用本地安装包

本手册对应 0.1.0.dev4。取得同版 wheel 后，在 Windows PowerShell 中创建独立环境，并把下列 wheel 路径替换为实际文件路径。普通安装包含信号表分析、CAN 日志和 DBC 解码的运行依赖；离线安装需事先备齐依赖包。

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install ".\chronaxis-0.1.0.dev4-py3-none-any.whl"
.\.venv\Scripts\python.exe -m chronaxis guide

后续命令使用同一个虚拟环境中的 Python。

直接打开命令显示的README路径即可阅读，无需导出或解压；没有运行环境时，可以打开离线手册附带的指南。手册 ZIP 是说明和教学数据，不是 Python 安装包。以下为拥有源码时的安装路径。

从同版源码安装

取得 0.1.0.dev4 源码后，在包含 pyproject.toml 的仓库根目录执行以下 Windows PowerShell 命令。显式调用虚拟环境中的 Python，无需修改脚本执行策略或依赖终端激活状态。

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e "."
.\.venv\Scripts\python.exe -m chronaxis --help

pip install -e "."安装当前源码目录和CAN依赖，可以直接运行本手册的BLF／ASC示例。它根据pyproject.toml安装NumPy、YAML解析及CAN依赖；首次安装需要可用的软件源或本地安装包。编辑安装仍依赖原源码目录，移动仓库后应在新位置重新安装。

CAN输入与导出

上面的普通安装已包含BLF、ASC、原始CAN CSV、DBC解码和CAN报文导出的依赖。python-can==4.6.1、cantools>=39.4.3,<46、natsort==8.4.0 由 wheel 元数据统一约束；精确复现时使用与 Python 版本匹配的 constraints 文件。

普通CSV任务不需要DBC；已安装的CAN库只在实际需要时导入。若旧环境缺少依赖，使用当前完整wheel在同一环境重新安装；不要单独安装任意最新版cantools后视为已验证环境。

检查安装与首次运行

只有wheel和离线手册时，先激活已安装Chronaxis的环境，再在手册解压根目录（直接包含examples）运行：

python -m chronaxis validate examples/analysis.yaml
python -m chronaxis run examples/analysis.yaml --output first-result

如果使用源码仓库，则在含pyproject.toml的仓库根目录执行：

.\.venv\Scripts\python.exe -m chronaxis validate Docs/Current/examples/analysis.yaml
.\.venv\Scripts\python.exe -m chronaxis run Docs/Current/examples/analysis.yaml --output first-result

first-result可以复用，每次结果使用时间文件名。然后按BLF／ASC快速开始核对会话结果_<运行时间>.csv中的38J、6W和38/6W。手册后续使用简写chronaxis；虚拟环境未激活时，始终可用.\.venv\Scripts\python.exe -m chronaxis替代它。

离线HTML附带的examples目录可整体复制；使用已安装Chronaxis的Python执行其中api_example.py。HTML阅读本身不需要Python，运行分析才需要环境。

安装失败时

完整错误处理见故障排查。源码安装以仓库pyproject.toml为依赖和版本依据；使用wheel时以该安装包的元数据为准。