qsmm.org

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 视为算法合成系统的原型，可作为理解项目设计意图的补充材料。

源代码获取

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

当前版本 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 中对应小节及其示例，再考虑在邮件列表提问。

qsmm.org 是 QSMM 项目的官方网站。QSMM 是“QSMM State Machine Model”的递归缩写，定位为一个自适应状态模型开发框架，用于学习有限自动机，使其能与表现出确定性或随机行为的实体进行目标导向的交互。网站本身不提供在线服务或托管运行环境，主要承担项目说明、文档分发、源码获取入口和社区反馈渠道的功能。

网站提供哪些内容

首页按几个板块组织信息，各自对应不同的使用需求：

框架的定位与演变

根据首页说明，QSMM 的目标是学习执行目标导向交互的有限自动机，交互对象可以是确定性行为，也可以是随机行为。它实现了处理概率汇编程序的工具链雏形。近十年来，开发重心转向自适应解析，以及按模板学习上下文无关文法。手册中的 atd-parser 和 abu-parser 两节附有示例，是了解这一方向的具体入口。

首页还提到，Oleg Volkov 在 OSDN-UA-2013 会议的报告（俄语）中把 QSMM 视为算法合成系统的原型。这属于项目背景材料，不影响直接上手使用。

获取与使用源码的前提

当前版本为 1.19.4，发布日期标注为 2026-10-06。源码包可从 SourceForge.net 的项目文件页下载，也可以通过 Git 克隆：

git clone https://gitlab.com/omvolkov/qsmm qsmm

旧版 Subversion 仓库仍可访问：

svn checkout http://svn.code.sf.net/p/qsmm/code/trunk qsmm-code

需要注意两点：第一，网站只提供源码分发，没有提到预编译二进制包，因此使用前需要自行准备构建环境；第二，许可证是使用条件的一部分——源码采用 GNU GPL v3 或更高版本，程序员手册采用 GNU FDL v1.3 或更高版本。若计划把 QSMM 嵌入自有产品，应先核对 GPL 的传染性要求是否与你的分发方式相容。

文档与求助路径

程序员手册有多个格式版本，适合按需选择：通读概念时看引言部分（从“What Is Intelligence?”到“QSMM Components”），动手实践时直接跳到第 7 章 Tools 下的解析器示例。

遇到缺陷、技术问题或希望新增 API 功能，可通过 QSMM 用户邮件列表反馈。发帖前需要先订阅，这是使用该渠道的前置步骤。

什么情况下值得访问这个网站

如果你在做有限自动机学习、自适应解析或上下文无关文法模板学习相关的研究与开发，并且能接受从源码构建、遵守 GPL 条款，那么这个站点是获取权威文档和最新代码的起点。如果你只是想要一个开箱即用的状态机库，或者需要商业友好的宽松许可证，则要先评估构建成本和许可证约束，再决定是否深入。

atd-parser 和 abu-parser 是 QSMM 软件包中列在程序员手册第 7 章“Tools（工具）”下的两个命令行工具，手册分别为它们设置了“Examples（示例）”小节。QSMM 官方页面没有给出这两个工具的功能描述，只说明 QSMM 近十年的开发重心已转向“自适应解析”和“按模板学习上下文无关文法”。因此，要确认它们的具体作用，需要查阅程序员手册第 7.4、7.5 节及其示例。

已知信息与边界

从命名和章节位置可以做出有限推断：两者属于工具链中的解析类工具，服务于 QSMM 的自适应解析方向。但“atd”“abu”分别代表什么、输入输出格式如何，页面没有说明，不宜凭名称下结论。

如何确认它们的作用

1. 打开 QSMM 官网的 Documentation 部分，选择一种手册格式（页面说明手册有多种格式）。
2. 定位第 7 章“Tools”，先读 7.4 与 7.5 的正文，了解工具用途和调用方式。
3. 对照 7.4.1、7.5.1 的示例，观察示例的输入文件和预期输出，这是判断工具实际行为最直接的材料。
4. 如需结合整体设计理解，可先读第 1 章导论，其中 1.5 节介绍 QSMM 组件，有助于把工具放回框架中理解。

获取与反馈渠道

• 源码：当前版本 1.19.4（页面标注发布日期 2026-10-06），可从 SourceForge 项目文件页下载源码包，或用 git clone https://gitlab.com/omvolkov/qsmm qsmm 获取 Git 仓库。
• 许可：源码采用 GPLv3 或更高版本；程序员手册采用 GFDL 1.3 或更高版本。
• 提问：通过 QSMM 用户邮件列表反馈，发帖前需先订阅。

如果你的目标是直接使用这两个工具，建议先读示例小节再决定是否深入；如果只是想了解 QSMM 的解析能力，第 1 章导论加第 7 章概览已足够建立整体认识。

QSMM 的软件包源代码和程序员手册采用两套不同的许可证：软件包源代码使用 GNU General Public License（GPL）第 3 版或任何更高版本；程序员手册使用 GNU Free Documentation License（GFDL）第 1.3 版或任何更高版本。两者都由自由软件基金会（FSF）发布，且都允许“或更高版本”，意味着你可以按 GPL v3 或 GFDL 1.3 的条款使用，也可以选择后续版本。

两类许可证的适用对象

需要注意，这一区分来自 QSMM 官网的 Licenses 部分，它只覆盖“软件包源代码”和“程序员手册”两类材料。官网没有说明其他内容（如示例程序、报告材料）的许可条件，因此不要默认它们与上述两者相同。

使用和分发时的判断要点

• 修改并分发源代码：属于 GPL 的典型场景。GPL v3 要求分发修改后的源代码时，整体仍按 GPL v3（或更高版本）授权，并向接收者提供对应源代码。若只是内部使用、不对外分发，GPL 不强制公开修改。
• 引用或再分发手册：GFDL 1.3 针对文档，允许复制、分发和修改，但通常要求保留版权声明与许可声明，修改版需按同一许可证发布。具体义务以 GFDL 1.3 原文为准。
• “或更高版本”的含义：你可以选择遵守 GPL v3 或 FSF 日后发布的更高版本；如果项目方未来将代码切换到 GPL v4，你可以按 v4 条款使用该版本代码。若你不希望接受未来版本，需在具体使用场景中确认是否可行——这一点官网未作说明，属于需要自行核对许可证原文的事项。
• 商业或闭源集成：GPL v3 对分发有传染性要求，把 QSMM 代码嵌入闭源产品并对外分发，通常需要按 GPL 开放相应源代码。官网没有提供其他许可（如商业许可）的信息，因此不能假设存在替代授权渠道。

获取许可证原文与确认版本

官网 Licenses 部分只给出许可证名称和版本，未附全文。要核对具体条款，可查阅 FSF 发布的 GPL v3 和 GFDL 1.3 官方文本。若你使用的 QSMM 版本较新（官网当前版本为 1.19.4，发布于 2026-10-06），建议同时查看该版本发行包内附带的 LICENSE 或 COPYING 文件，以确认实际随包声明的许可证与官网描述一致。

常见卡点

• 把手册当成代码许可：手册是 GFDL，不是 GPL；复制手册章节到自己的文档时，应按 GFDL 处理，而不是 GPL。
• 忽略“或更高版本”：只按 GPL v3 理解可能遗漏后续版本带来的条款变化，分发前应明确自己接受哪个版本。
• 假设所有材料同一许可：官网只覆盖源代码和手册，其他材料（如会议报告）的许可需另行确认，不能直接套用。

QSMM（全称 “QSMM State Machine Model”，递归缩写）是一个自适应状态模型开发框架，核心用途是学习执行目标导向交互的有限自动机——这些自动机所交互的对象，可以是表现出确定性行为的实体，也可以是表现出随机行为的实体。如果你的任务是让程序在与环境或对手的反复交互中自动归纳出状态机行为，QSMM 属于可以直接考察的框架；如果你只是需要一个通用的状态机绘图或代码生成工具，它并不对口。

框架的定位与组成

根据项目主页的说明，QSMM 的定位可以拆成三层：

• 学习层：面向有限自动机的学习，自动机通过与环境交互达成目标，环境行为可以是确定性的，也可以是随机的。
• 工具链层：实现了处理概率汇编程序（probabilistic assembler programs）的工具链雏形。
• 解析层：近十年来开发重点转向自适应解析，以及按模板学习上下文无关文法。

主页把 QSMM 描述为“智能机器构建模块”的一部分，程序员手册的引言章节依次讨论智能的定义、刺激驱动行为、智能机器的构建模块、有生命力的机器（animate machines）以及 QSMM 组件，可以看出它更接近一种面向自适应行为的实验性/研究性框架，而不是开箱即用的应用软件。

近年重点：自适应解析与文法学习

如果只看“状态机”三个字，容易低估它当前的重心。主页明确写到，过去十年开发焦点已转向自适应解析和按模板学习上下文无关文法。配套工具中列有 atd-parser 和 abu-parser，手册第 7 章为它们分别提供了示例章节。这意味着：

• 想研究从样本中归纳文法结构、做自适应语法分析，QSMM 的相关工具值得先看示例再决定是否深入。
• 想研究概率汇编程序的表示与处理，框架提供了雏形级支持，但主页用词是“rudiments”（雏形），预期应放在探索性使用上。

可作为算法合成系统的原型

据 Oleg Volkov 在 OSDN-UA-2013 会议上的报告（俄文），QSMM 被视为算法合成系统的原型。这是一个定位性判断而非产品功能承诺：它说明框架的设计意图偏向“让机器自动生成/学习算法行为”这一研究方向。评估时可以把这条当作背景参考，具体能力仍以程序员手册和源码为准。

获取与使用条件

需要留意：GPL v3 意味着如果你分发基于它的衍生软件，通常需要以兼容方式开放源码；仅在内部研究使用则不受分发条款约束。主页未提及价格信息，是否收费、是否需要注册下载，应以 SourceForge 文件页的实际页面为准。

反馈与支持渠道

项目通过 QSMM 用户邮件列表接收反馈，包括缺陷报告（软件包与文档）、问题与技术支援请求、新功能请求（例如新增某个 API 函数）。向邮件列表发帖前需要先订阅。主页没有提供论坛、即时聊天或商业支持入口，遇到问题时邮件列表是主要路径。

适合与不适合的场景

适合：研究有限自动机学习、目标导向交互建模、概率汇编程序处理、自适应解析与上下文无关文法模板学习，或希望以源码为基础做算法合成原型实验的开发者与研究者。

不适合：需要图形化建模界面、需要商业技术支持、或只想快速生成状态机代码的工程团队——主页没有提供这类能力的迹象。

下一步建议：先读程序员手册的引言部分（1.1–1.5）建立概念框架，再直接跑第 7.4.1、7.5.1 节的解析器示例，用实际输出判断它是否匹配你的任务。