Skip to content

Ontexus v0.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@jingw2 jingw2 released this 08 Sep 13:59
· 68 commits to master since this release
v0.2
dd7645a

License updated (2026-09-10): Ontexus is now licensed under PolyForm Noncommercial 1.0.0 — free for personal, research, education, and nonprofit/government use; commercial use requires a separate license from the copyright holder. Previous references to "MIT" in this repo were incorrect (no LICENSE file existed until now).

Ontexus v0.2

nano-ontoprompt 正式更名为 Ontexus。 Ontexus = Ontology + Nexus —— 以 Ontology 为核心，把企业的数据、关系、上下文、逻辑、Action 和 Agent 连接起来的语义枢纽（Data / Knowledge → Ontology → Context → Logic / Actions → Agent）。详见 README.md 的品牌说明。

自 v0.1 以来累计 570+ 次提交，新增了一个完整的 Agent Runtime 执行层，并对治理、安全与数据集成能力做了大量强化。

核心新增：Agent Runtime（Agent 执行引擎）

v0.1 的 Ontology 构建能力之上，现在可以让 Agent 基于已发布的 Ontology 真正执行任务：

  • 会话式 Agent 应用 — 持久会话、可靠 SSE 流式回复（断线重连/事件重放）、澄清追问、动作审批流程；会话标题根据首条提问自动生成
  • 治理化工具网关（Tool Gateway） — Agent 对 Ontology 的每一次读取都经过发布索引、run/data 授权校验，产出可观测的引用溯源（不暴露思维链）
  • 外部工具绑定 — 治理化 Web Search 适配器（SSRF 安全防护、跨域重定向脱敏、响应体硬上限）、URL 与标题净化
  • Agent 记忆 — 短期/长期记忆抽取与向量化召回，按 Agent 独立配置
  • 执行调和（Reconciliation） — 当一次工具/动作执行结果未知（丢失结果、丢失 fence、结果不确定）时，由管理员基于证据确认外部副作用为成功/未执行/需重试；系统绝不自动重放。详见 Agent Reconciliation Guide
  • 心跳保活 — 长时间运行的真实模型调用期间，后台心跳线程持续续约；主 session 不可用时用新 session 兜底标记失败，避免任务永久卡在 running

Business Journeys：真实模型治理验收

新增一套面向企业客户的端到端验收框架，覆盖供应链、财务、信贷三大业务域：

  • 真实 DeepSeek 模型调用（非 mock）+ 真实浏览器驱动的 Agent 创建与对话流程
  • 完整证据链：Preparation → 三次真实模型调用（ontology / agent_initial / agent_final）→ 高风险动作审批（approved / rejected / expired 三分支，均含真实哈希与回执）→ 只读验证
  • 专用网关身份（gate identity）强制隔离：仅限配置的专用账号可写入/读取准备证据，普通用户即使猜中 run_id 也无法读取他人证据（本轮修复的一个真实越权问题）
  • 一键跑通：bash scripts/run_business_journey_gate.sh（需要 DEEPSEEK_API_KEY）

治理与安全强化

  • Ontology 发布生命周期 — draft → created → published 三态流转，发布产出不可变 release；已发布本体支持"发布新版本"
  • 数据保留与法定保全（Retention & Legal Hold） — 按策略版本 + CAS 并发控制自动清理，法定保全期内的数据强制豁免；保全范围覆盖 session/turn 及其脱敏/删除步骤，而非仅 Turn 本身
  • 账号与会话安全 — 账号吊销、浏览器 refresh token 家族轮换、API 安全响应头加固
  • Ontology 写路径收口 — 所有本体写操作切至治理化路径，直接 SQLAlchemy 写入入口全部关闭
  • 原始 Logic/Action 定义编辑 — 支持直接 PATCH 修改规则与动作定义

数据集成增强

  • 增量刷新管道 — 独立的调度/轮询/事件/重放四类 Celery worker，签名 webhook、幂等收件箱、可取消安全点
  • 跨数据集关系推断增强 — 备用键匹配（如文档中提到的公司名直接连到 Supplier 实体）、EntityInstance 概念/实例分离（Entity 表仅存概念元数据，关系在概念级连接，行级实例单独建模）

技术栈更新

新增: Celery 多队列 worker 拓扑（agent / refresh / housekeeping 等独立 profile）
      OAuth 2.0 + PKCE（Agent 委托凭证）
沿用: FastAPI + SQLAlchemy + Alembic · PostgreSQL + MinIO + Neo4j + ChromaDB
      React + Vite + Tailwind CSS + Cytoscape.js

所有新增外部依赖（Neo4j/MinIO/ChromaDB/Redis）继续保持可选、优雅降级。

快速开始

git clone https://github.com/jingw2/ontexus.git
cd ontexus
cp .env.example .env
docker compose -f docker-compose.v2.yml up --build

详见 README.md / README_zh.md。

Assets 2
Loading