# MOSS **Repository Path**: georgewangchn/MOSS ## Basic Information - **Project Name**: MOSS - **Description**: 治理驱动的企业决策运行时系统 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-16 - **Last Updated**: 2026-09-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# MOSS **ERP 管资源 · CRM 管客户 · OA 管流程 · MOSS 管决策** 基于 OWL 2 DL + HermiT 的决策治理运行时 · [OntologyOps](https://github.com/georgewangchn/OntologyOps) 方法论的参考实现 [![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/) [![Code: MIT](https://img.shields.io/badge/Code-MIT-22c55e?style=flat-square)](LICENSE) [![Protocol: CC BY 4.0](https://img.shields.io/badge/Protocol-CC_BY_4.0-3b82f6?style=flat-square)](src/moss/resources/ontology/LICENSE) [![Reasoner](https://img.shields.io/badge/Reasoner-OWL_2_DL_·_HermiT-8A2BE2?style=flat-square)](src/moss/resources/ontology/PROTOCOL.md) [![Methodology](https://img.shields.io/badge/Methodology-OntologyOps-6366f1?style=flat-square)](https://github.com/georgewangchn/OntologyOps) [![Status: Prototype](https://img.shields.io/badge/Status-Prototype-orange?style=flat-square)](#诚实定位) **本体即代码** · **LLM 只做提取** · **推理机做裁判** · **零侵入接入**
> **改名公告**：本项目由 `GovernanceOps` 更名为 `MOSS`。仓库迁移至 [`github.com/georgewangchn/MOSS`](https://github.com/georgewangchn/MOSS)，包名 `governanceops` → `moss`，CLI `govops` → `moss`，workspace `~/.governance-ops/` → `~/.moss/`，env `GOVOPS_*` → `MOSS_*`。历史提交完整保留。 --- ## 这是什么 企业软件三十年，管了资源、客户、流程，唯独没人管「决策」——会议结束，决策就消亡：没有追踪、没有问责、没有复盘。 MOSS 把决策变成**可追踪、可验证、可持续执行**的第一管理对象。底下是 OWL 2 DL 与 HermiT Tableau 推理算法，不是又一个待办清单。核心铁律： > **LLM 只做提取，推理机做裁判。LLM 永不进入推理链。** 优先级 P0–P4 由规则推断，不由人定；治理完备性由 OWL 等价类自动归类，零人工打标签。 --- ## 导航 [快速开始](#快速开始) · [DEMO](#demo-演示) · [为什么](#为什么需要-moss) · [特性](#核心特性) · [架构](#架构) · [Ontology Repo](#ontology-repo把本体当代码治理) · [Web 驾驶舱](#web-驾驶舱) · [命令](#命令清单) · [技术栈](#技术栈) · [开发](#开发) · [定位](#诚实定位) · [相关项目](#相关项目) --- ## 快速开始 > **前置**：Python 3.10+。可选：Java 11+（HermiT 推理）、Ollama 或 OpenAI 兼容 API（LLM 提取）。 ```bash git clone https://github.com/georgewangchn/MOSS.git cd MOSS python -m venv venv && source venv/bin/activate pip install -e ".[agent]" # 最小安装（无 LLM）: pip install -e . ``` 三步跑通： ```bash moss init # 交互式向导：配置工作目录、LLM、Java 检测 moss demo # 加载预置种子数据，立即体验完整治理流程 moss serve # 启动 Web 驾驶舱 → http://localhost:8000 ``` > 先跑通 demo、看懂代码例子，再去看 [OntologyOps](https://github.com/georgewangchn/OntologyOps) 理解方法论。先看能跑的，再看为什么。 --- ## DEMO 演示 虚构科技公司，**5 个部门、12 个决策、4 次周会**间的完整治理演进： ```bash bash demo/run.sh # 交互式演示（约 10 分钟，按回车推进） python demo/scenario.py all # 非交互：init → week1→4 → final 一键跑完 ``` | 周次 | 剧情 | 背后机制 | |:----:|------|----------| | 第 1 周 | 看似正常，但 3 个决策无负责人、1 个已超期 | `checkpoint` 心跳检测 | | 第 2 周 | 超期翻 3 倍、6 个停滞 | HermiT 分类 + `compile` 校验 | | 第 3 周 | 关键人员请假 → 超期 14 天 → **自动升级通知上级** | 人治断裂处系统自动补位 | | 第 4 周 | 月底复盘：量化「有 Ops vs 无 Ops」对比 | 规则驱动优先级 + 自动升级 | > 剧本在 [`demo/`](demo/) 中，用模拟时间线计算指标，**不依赖真实日期**，随时可复现。 --- ## 为什么需要 MOSS | 时代 | 管理对象 | 代表系统 | 决策？ | |:----:|:--------:|:--------:|:-----:| | 1990s | 📦 资源 | ERP | ✗ | | 2000s | 👥 客户 | CRM | ✗ | | 2010s | 🔄 流程 | OA/BPM | ✗ | | **现在** | 🎯 **决策** | **MOSS** | **✓** | 每个组织都遇到过： 1. **决策无法落地** — 会议有结论，但没有追踪机制，事项逐渐石沉大海 2. **责任靠人治** — 跨部门决策谁催办、何时做，全靠主动性和人情 3. **无法监督上级** — 系统只向下问责，上级该支持没支持，无人知晓 4. **治理效果不可量化** — 决策不是结构化对象，无法统计、预警、复盘 MOSS 的回答——**把决策变成可追踪、可验证、可持续执行的第一管理对象**，以机制代替人治： - 决策缺负责人或截止日期 → **ERROR，不可跳过** - 优先级 P0–P4 **完全由规则推断，不由人定** - 系统主动催办、超期告警、自动升级——**既向下问责，也向上追溯** --- ## 核心特性 | | 特性 | 做什么 | |:---:|---|---| | 🧬 | **本体即代码** | 声明式 DSL 为唯一事实源，`validate / build / diff / tag / rollback`，编译成 OWL 2 DL 交 HermiT 推理 | | 🧠 | **推理机裁判** | 「治理完备」被形式化为 OWL 等价类，HermiT 自动归类，零人工打标签 | | 🤖 | **LLM 只做提取** | LangGraph Agent 把周报/纪要/邮件抽成结构化决策，推理裁判权始终在推理机 | | 🔌 | **零侵入接入** | 邮件(IMAP) / 文档(Docx/PDF) / CLI / Web，不改造任何现有系统 | | 🛡️ | **开箱降级** | 无 Java、无 LLM 也能跑；推理降级由**同一份本体 DSL** 派生，不漂移 | | ⚖️ | **双向治理** | 既向下问责，也向上追溯——上级的支持责任同样超期告警、自动升级 | --- ## 架构 ```mermaid flowchart TD Input["📥 输入层（零侵入）
邮件 IMAP · 文档 Docx/PDF · CLI · Web"] Extract["🤖 Agent 提取流水线 · LangGraph StateGraph
chunker → section_extractor × N → merge → verify"] Runtime["⚙️ Governance Runtime · 治理运行时
Compiler 完备性 · Runtime 心跳/告警 · P0–P4 优先级"] Reason["🧠 HermiT 本体推理 · OWL 2 DL
Ontology Repo DSL 版本库 → 自动分类
GovernedDecision · HasOwner · Critical"] Fallback["🐍 纯 Python 等价规则
由同一份本体 DSL 派生"] Input --> Extract --> Runtime --> Reason Reason -. "无 Java 降级" .-> Fallback ```
ASCII 版本（终端用户） ``` ┌──────────────────────────────────────────────────┐ │ 📥 输入层（零侵入） │ │ 邮件(IMAP) · 文档(Docx/PDF) · CLI · Web │ └──────────────────────┬───────────────────────────┘ ▼ ┌──────────────────────────────────────────────────┐ │ 🤖 Agent 提取流水线 · LangGraph │ │ chunker → section_extractor × N → merge → verify │ │ HermiT 验证 ← 无 Java 时纯 Python 降级 │ └──────────────────────┬───────────────────────────┘ ▼ ┌──────────────────────────────────────────────────┐ │ ⚙️ Governance Runtime · 治理运行时 │ │ Compiler(完备性) · Runtime(心跳/告警) · P0–P4 │ └──────────────────────┬───────────────────────────┘ ▼ ┌──────────────────────────────────────────────────┐ │ 🧠 HermiT 本体推理 · OWL 2 DL │ │ ← Ontology Repo（DSL 版本库） │ │ 自动分类：GovernedDecision / HasOwner / Critical │ └──────────────────────────────────────────────────┘ ```
本体 + Agent 分工：LLM 永不进推理链 ```mermaid flowchart LR Agent["🤖 Agent · LangGraph + LLM
理解 → 提取 → 桥接 → 修正
❌ 不做：分类推理、规则验证"] Onto["🧠 Ontology · owlready2 + HermiT
分类 → 验证 → 约束 → 推理
❌ 不做：自然语言理解、文档分块"] Agent -- "GovernanceGraph" --> Onto ``` - **LLM 只做 NLU**：把周报 / 纪要 / 邮件抽成结构化决策，理解这一步允许有错 - **HermiT 只做推理**：谁是 `GovernedDecision`、谁该进 P0、谁缺负责人——由 OWL 2 DL 等价类自动归类，**零人工打标签、LLM 不参与裁判**
规则驱动优先级（P0–P4） 优先级从治理状态自动计算（`compute_priority`），不是人工设定字段——**消除「谁的嗓门大谁优先级高」的主观偏差**： | 级别 | 严重度 | 规则 | |:----:|:------:|------| | **P0** | 🔴 紧急 | `Governed`（owner + deadline + update）∧ 距截止 ≤ 7 天 ∧ risk=HIGH | | **P1** | 🟠 高 | `Governed`（治理完备，全部检查通过） | | **P2** | 🟡 中 | hasOwner + hasDeadline（缺进展更新） | | **P3** | 🟢 低 | hasOwner（缺截止日期） | | **P4** | ⚪ 待处理 | 无负责人（无人负责，优先级最低） |
OWL 定义类（HermiT 自动分类） 围绕 **Decision** 概念建立 `Update` 子节点，形成 **Governance Graph**（`hasUpdate` 关系边），由 OWL 本体定义 5 个 Defined Classes 交 HermiT 自动分类： ``` GovernedDecision ≡ Decision ⊓ ∃hasOwner ⊓ ∃hasDeadline ⊓ ∃hasUpdate HasOwnerDecision ≡ Decision ⊓ ∃hasOwner HasDeadlineDecision ≡ Decision ⊓ ∃hasDeadline CriticalDecision ≡ Decision ⊓ (hasPriority = "P0") HighPriorityDecision ≡ Decision ⊓ (hasPriority = "P1") ```
--- ## Ontology Repo：把本体当代码治理 OntologyOps 六大支柱之一在本项目的落地。本体不再硬编码在 Python，而是一份**声明式 DSL**（[`moss.onto.yaml`](src/moss/resources/ontology/moss.onto.yaml)）作为唯一事实源——标准 OWL 2 DL 的对 LLM 友好、对 diff 友好的语法，编译后交 HermiT 推理，并可导出标准 W3C Turtle。 ```bash moss onto validate # 校验 DSL（JSON Schema + 模型） moss onto show # 树形展示概念 / 属性 / 定义类 moss onto build [--commit -m …] # 编译成 OWL TBox，产出 moss.{owl,ttl,lock.json} moss onto log # 版本历史（HEAD → 根） moss onto diff [A] [B] # 语义级 Diff（标注是否 breaking） moss onto tag [ver] # 打版本标签 moss onto rollback # 回滚：还原工作区 DSL 并前移 HEAD moss onto conformance [--json] # 符合性自证报告 ``` > **为什么用 DSL 而非手写 `.owl`**：本体由 LLM 生成时，带空白节点的 Turtle 既易错又难 review；带 JSON Schema 的 DSL 在生成那一刻被约束，且天然可 diff、可 PR。版本化已实现（SQLite 内容寻址版本库），Branch / Merge 为下一增量。协议契约见 [`PROTOCOL.md`](src/moss/resources/ontology/PROTOCOL.md)。 --- ## Web 驾驶舱 `moss serve` 启动单页仪表盘，无需切换 Tab 即完成输入、看板、推理、告警、日志的联动： - **状态栏** — 决策总数 / 高危 / 超期 / 已完成 + 时钟 - **输入栏** — 自然语言输入 → IntentAgent 自动路由（`分配给王工` → AMEND、`检查` → CHECKPOINT、周报文本 → INGEST） - **看板 + 告警** — 决策列表（按优先级排序、风险指示）+ 编译错误 / 治理警告 / 活跃告警 - **本体面板** — HermiT 推理状态（治理完备 / 需关注 / 需处理）、P0–P4 优先级分布 - **日志** — 事件时间线，SSE 实时推送 + 历史回放，CLI / Web 操作实时同步
降级策略 | 组件 | 完整模式 | 降级模式 | |------|----------|----------| | LLM | 云端 API / 本地 Ollama | 无 LLM 模式（demo 用预置数据） | | 推理 | HermiT Tableau（需 Java 11+） | 纯 Python 等价规则（由**同一份本体 DSL** 派生） | | 提取 | LangGraph Agent 并行 | Extractor 单线程分段 | 降级后功能零损失，仅丢失形式化保证与并行加速。
--- ## 命令清单 | 命令 | 说明 | |------|------| | `moss init` · `demo` | 初始化工作区 / 加载演示数据 | | `moss ingest ` | 从文件提取决策（.txt/.md/.docx/.pdf），`-` 从 stdin | | `moss connect email` · `daemon` | 配置邮件接入（IMAP）/ 守护进程定时拉取 | | `moss compile` | 编译检查（决策完备性验证） | | `moss checkpoint` | 治理心跳（逾期 / 停滞 / 阻塞检测 + 自动升级） | | `moss hermit` | 展示 HermiT 本体分类结果 | | `moss status` · `graph` · `attention` · `brief` · `alert` | 状态 / 图 / 待办 / 简报 / 告警 | | `moss onto …` | Ontology Repo：validate / build / diff / tag / rollback / conformance | | `moss serve` | 启动 Web 驾驶舱 | | `moss reset` · `migrate` | 清空数据 / 从旧 JSON 迁移到 SQLite | > 完整清单以 `moss --help` 为准。 --- ## 技术栈 `owlready2 + HermiT`（OWL 2 DL Tableau） · `LangGraph`（多步 LLM 编排） · `FastAPI + SSE` · `Click + Rich`（CLI） · `Pydantic` · `SQLite`（WAL） · `rdflib`（Turtle 导出） 本体以声明式 DSL 为源、编译 owlready2 TBox、导出标准 Turtle；SQLite 同时承载运行时图与本体版本仓库。 --- ## 开发 ```bash git clone https://github.com/georgewangchn/MOSS.git cd MOSS python -m venv venv && source venv/bin/activate pip install -e ".[agent,dev]" pytest ``` 详见 [CONTRIBUTING.md](CONTRIBUTING.md)。 --- ## 诚实定位 > MOSS 是一个功能完整、可运行、可演示的**原型**，**不是**已服务大批客户的成熟产品。它证明的是「这套方法论能用开源工具链完整落地」，而非「已被市场规模验证」。这两件事必须分清。 --- ## 相关项目 - **[OntologyOps](https://github.com/georgewangchn/OntologyOps)** — 本项目所实现的方法论与协议，含方法论体系与博客系列 - [`PROTOCOL.md`](src/moss/resources/ontology/PROTOCOL.md) — Ontology Repo 支柱的协议契约（MOSS 为其参考实现） --- ## License 本仓库采用**分层许可**： | 资产类型 | 许可协议 | 覆盖范围 | 说明 | |---------|---------|---------|------| | **代码** | [MIT](LICENSE) | src/moss/ 代码、tests、demo | 自由使用、修改、商用 | | **协议规范** | [CC BY 4.0](src/moss/resources/ontology/LICENSE) | src/moss/resources/ontology/ | 署名 + 允许商业实现 | > `src/moss/resources/ontology/` 下的协议规范权威源在 [OntologyOps 仓库](https://github.com/georgewangchn/OntologyOps)，以 CC BY 4.0 发布。无论从哪个仓库获取，协议许可始终为 CC BY 4.0。 项目名称使用指引见 [TRADEMARK.md](TRADEMARK.md)。

Built with OWL 2 DL, HermiT & 一条不肯让 LLM 进推理链的铁律 · Code: MIT · Protocol: CC BY 4.0