在哪里获取 QSMM 的文档、源代码和技术支持?

更新时间

QSMM（QSMM State Machine Model）的文档、源码和反馈渠道都集中在 qsmm.org 上：程序员手册提供多种格式，源码包可从 SourceForge.net 项目文件页下载，也可通过 GitLab 或旧 Subversion 仓库获取；当前版本为 1.19.4，发布于 2026-10-06；缺陷报告、技术提问和功能请求通过 QSMM 用户邮件列表提交，发帖前需先订阅。

先确认这是不是你需要的项目

QSMM 是一个用于学习有限自动机的框架，目标是让自动机与表现出确定性或随机行为的实体进行目标导向的交互。它实现了处理概率汇编程序的基础工具链；近十年来，开发重点转向自适应解析和按模板学习上下文无关文法。如果你要找的是状态机建模、自适应解析或文法学习相关的工具，这个站点就是入口；如果只是需要一个通用的状态机绘图或代码生成工具，QSMM 的定位可能并不匹配。

文档入口

程序员手册是主要文档，站点说明其提供多种格式，可按阅读习惯选择。手册中与上手最相关的章节包括：

  • 第 1 章 Introduction：从“什么是智能”“刺激驱动行为”讲到 QSMM 组件，适合先建立概念框架。
  • 第 7 章 Tools：介绍 atd-parser 和 abu-parser 两个工具，并各附示例，适合直接看用法。

此外，Oleg Volkov 在 OSDN-UA-2013 会议上的报告（俄语）把 QSMM 视为算法合成系统的原型，可作为理解项目设计意图的补充材料。

源代码获取

源码有三种获取方式，按使用场景选择：

方式 地址或命令 适用场景
发布包下载 SourceForge.net 项目文件页 想获取对应版本 1.19.4 的完整发行包
Git 仓库 git clone https://gitlab.com/omvolkov/qsmm qsmm 需要跟踪最新提交或参与开发
旧 Subversion 仓库 svn checkout http://svn.code.sf.net/p/qsmm/code/trunk qsmm-code 维护旧环境或查阅历史代码

当前版本 1.19.4 发布于 2026-10-06，站点提供变更记录入口，升级前可先核对改动。

许可条件

使用前需注意两类许可：

  • 包源代码采用 GNU General Public License 第 3 版或任何更新版本。
  • 程序员手册采用 GNU Free Documentation License 第 1.3 版或任何更新版本。

如果计划把 QSMM 集成进闭源产品或再分发文档，需要先按上述许可条款评估合规性。

反馈与技术支持

项目反馈统一走 QSMM 用户邮件列表，可提交的内容包括：包及文档中的缺陷报告、问题与技术支援请求、功能请求（例如希望新增某个 API 函数）。注意：在邮件列表发帖前必须先订阅。

常见卡点

  • 直接给邮件列表发信被拒：多半是未订阅，先完成订阅再发帖。
  • 下载到的源码与文档版本不一致：以发布页标注的 1.19.4 为准，Git 仓库为开发中代码，行为可能有差异。
  • 找不到某个工具的用法：先查手册第 7 章 Tools 中对应小节及其示例，再考虑在邮件列表提问。