HEXT-AI/hxt-spec
GitHub: HEXT-AI/hxt-spec
HEXT 是一项开放标准，通过定义不可变、加密可验证的语义对象图来解决人类、AI agent 和运行时系统之间确定性知识交换的问题。
Stars: 1 | Forks: 0
# HEXT 标准
**语义对象图标准**
[](SPECIFICATION.md)
[](SPECIFICATION.md)
[](SPECIFICATION.md#intellectual-property--licensing)
**HEXT** 的权威规范仓库 —— 一项开放、中立的标准，用于在人类、AI agent 和 runtime 系统之间进行确定性、可验证的知识交换。
由 [HEXT-AI 组织](https://github.com/HEXT-AI) 治理。
参考实现由 [Gemmina Intelligence LLC](https://acta-aiie.org/) 提供。
## 当前稳定版本
| 字段 | 值 |
|---|---|
| **标准** | HEXT Standard 1.0 |
| **版本** | 1.0.0 |
| **发布日期** | 2026年7月7日 |
| **状态** | 稳定 |
| **规范文档** | [SPECIFICATION.md](SPECIFICATION.md) |
本仓库是 HEXT 标准的**权威主页**。它不是一个 RFC 仓库。
## 什么是 HEXT？
HEXT 将知识定义为不可变、加密可验证的**语义对象图**（Semantic Object Graph），并使用**语义 XML**（Semantic XML）作为其规范序列化格式。
```
Semantic Object Graph ← Canonical Model
│
▼
Semantic XML ← Canonical Serialization
│
┌──────┼──────────────┬───────────────┐
▼ ▼ ▼ ▼
HTML JSON Binary Markdown
Render Transport Encoding Authoring
```
RFC 描述了标准演进的**原因**。
HEXT Standard 1.0 定义了实现**必须**遵循的**内容**。
## 快速开始
```
git clone https://github.com/HEXT-AI/hxt-spec
```
| 步骤 | 资源 |
|---|---|
| 1. 阅读标准 | [SPECIFICATION.md](SPECIFICATION.md) |
| 2. 审查 schema | [schemas/hext-core.xsd](schemas/hext-core.xsd) |
| 3. 研究示例 | [examples/](examples/) |
| 4. 检查一致性 | [§6 一致性](SPECIFICATION.md#6-conformance--compliance-levels) |
## 规范
规范性（Normative）规范是 **[SPECIFICATION.md](SPECIFICATION.md)** (HEXT Standard 1.0)。
支持性文档：
| 文档 | 作用 |
|---|---|
| [docs/object-graph.md](docs/object-graph.md) | 对象图模型（参考性） |
| [docs/serialization.md](docs/serialization.md) | 序列化架构（参考性） |
| [docs/canonicalization.md](docs/canonicalization.md) | 哈希与 C14N 规则（参考性） |
| [json/mapping.md](json/mapping.md) | JSON 传输映射（参考性） |
参考性文档是对规范性规范的补充，但不能替代规范性规范。
## Schema
规范性 XML Schema 定义：
| Schema | 用途 | 状态 |
|---|---|---|
| [hext-core.xsd](schemas/hext-core.xsd) | 核心文档结构 | 规范性 |
| [hext-rfc.xsd](schemas/hext-rfc.xsd) | RFC 文档扩展 | 保留 |
| [hext-experiment.xsd](schemas/hext-experiment.xsd) | 实验记录扩展 | 保留 |
Namespace：`urn:gmm:hext:core:1`
Schema 奉献给公共领域（[CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)）。
## 示例
规范语义 XML 示例：
| 示例 | 描述 |
|---|---|
| [minimal.hext.xml](examples/minimal.hext.xml) | 最小有效 HEXT 文档 |
| [rfc.hext.xml](examples/rfc.hext.xml) | 带有完整元数据的 RFC 类文档 |
| [experiment.hext.xml](examples/experiment.hext.xml) | 带有扩展模块的实验记录 |
旧版基于 Markdown 托管的格式（v0.1.0，遗留兼容）：
| 示例 | 描述 |
|---|---|
| [sample.hxt](examples/sample.hxt) | 有效的验证示例 |
| [invalid.hxt](examples/invalid.hxt) | 被篡改的文档（应验证失败） |
```
python3 hxt.py verify examples/sample.hxt
python3 tools/validator/validate.py examples/minimal.hext.xml
```
## 一致性
HEXT Standard 1.0 定义了四个合规级别。请参阅 [SPECIFICATION.md §6](SPECIFICATION.md#6-conformance--compliance-levels)。
| 级别 | 概要 |
|---|---|
| **核心合规** | 对象图、规范 XML、身份、账本、出处 |
| **MCP 合规** | 核心 + Model Context Protocol 服务 |
| **注册表合规** | 核心 + 对象寻址与 schema 注册表 |
| **验证器合规** | 核心 + XSD 验证与错误停止 |
实现仓库：
| 组件 | 仓库 |
|---|---|
| 验证器 | [hext-validator](https://github.com/HEXT-AI/hext-validator) |
| MCP Server | [hext-mcp](https://github.com/HEXT-AI/hext-mcp) |
| 注册表 | [hext-registry](https://github.com/HEXT-AI/hext-registry) |
| SDK | [hext-sdk-*](https://github.com/HEXT-AI/hext-sdk-js) |
## 设计历史
RFC 和先前的草案是**设计历史**，而非现行标准。
| 资源 | 描述 |
|---|---|
| [history/README.md](history/README.md) | 归档索引 |
| [history/DESIGN-HISTORY.md](history/DESIGN-HISTORY.md) | RFC 归档与演进 |
| [history/RFC-NVS20_v2_2_0-source.md](history/RFC-NVS20_v2_2_0-source.md) | RFC-NVS20 源文档 |
| [history/SPECIFICATION-v2.2.0-draft.md](history/SPECIFICATION-v2.2.0-draft.md) | 1.0 前的草案规范 |
| [MIGRATION.md](MIGRATION.md) | 从 RFC 时代迁移至 Standard 1.0 |
## 仓库导航
```
hxt-spec/
├── SPECIFICATION.md ★ HEXT Standard 1.0 (normative)
├── schemas/ ★ XSD schemas
├── examples/ ★ Canonical XML + legacy examples
├── docs/ Informative architecture docs
├── json/ JSON mapping (informative)
├── history/ Design history & RFC archive
├── tools/validator/ Conformance tooling (in progress)
├── CHANGELOG.md
├── ROADMAP.md
├── MIGRATION.md
└── RELEASE-1.0.0.md Release notes
```
## 相关资源
| 资源 | URL |
|---|---|
| 官方网站 | [hextai.com](https://hextai.com) |
| 组织 | [HEXT-AI](https://github.com/HEXT-AI) |
| 治理 | [HEXT-AI/.github](https://github.com/HEXT-AI/.github) |
| 贡献 | [CONTRIBUTING.md](CONTRIBUTING.md) |
| 路线图 | [ROADMAP.md](ROADMAP.md) |
## 许可证
| 产物 | 许可证 |
|---|---|
| 规范（[SPECIFICATION.md](SPECIFICATION.md)） | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
| Schema、示例、注册表元数据 | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
| 参考实现（`hxt.py`、`hxt.js`） | Apache 2.0（计划过渡）/ MIT（当前） |
HEXT Standard 1.0 · HEXT-AI 组织 · 2026年7月7日
标签：Homebrew安装, Markdown, 人工智能, 数据可视化, 数据标准, 用户模式Hook绕过, 自动化治理, 语义网, 逆向工具, 防御加固