gabrielgadea/touring

# 导览 []() []() []() []() Touring 是面向下一代代码生成 Agent 的**开源、代码原生、Agent 优先的基础设施**。 它是一个 Cargo workspace（`crates/*`），包含 **42 个 crate**，接入到： - **218 个生命周期钩子**（PreToolUse / PostToolUse / Session* / Task* / Hook* / CLI* / Neural* / RL*） - **120 个 CLI 命令** + **88 个 MCP 工具** + 1 个二进制文件 - **5 个 RFC** + 作为主契约的 **Constitution v8.0** - **许可证层级模型**：`free → standard → premium → enterprise`（叠加模式） - **7 道质量门禁**：cargo check + clippy + test + e2e + cycles + orphans + TDG - **9 种 P3-NO-OP 审计模式**已于 2026-06 关闭；树处于和谐状态 ## 快速开始（5 分钟） ``` # 1. 安装 (Linux x86_64 / aarch64, macOS, Windows 通过 WSL2) curl -fsSL https://touring.dev/install.sh | sh # 2. 验证 touring --version touring doctor # 6/6 OK expected touring index rebuild # one-time index build for current project # 3. 首次查询 touring ast overview src/main.rs touring status -j # composite health score visible ``` ## Touring 是什么 | 你想要 | Touring 为你提供 | |----------|-------------------| | 大规模代码智能 | `touring ast`、`touring wiring`、`touring tantivy`（Tantivy v5 schema） | | Claude Code 的 Agent 框架 | 218 个钩子 + CEG X0..X9 沙箱 + 5 个 RFC | | 代码生成 | 通过 `touring-generator` 实现 36 种类型（VGP pipeline） | | 多语言（Rust/Python/TS/Go/...） | `touring-code::polyglot`（通过 tree-sitter 支持 14 种语言） | | 推理沙箱 | `inferlets`（WASM，11 种 runtime） + 用于证明的 Z3 SMT 求解器 | | 强化学习/学习型路由 | `touring-intelligence::rl`（LinUCB + 8 个分支 + 25 个维度） | | 按项目部署 | `touring-foundation::bin::resource-monitor` (W12) | | 商业层级 | `touring-license`（Free / Standard / Premium / Enterprise） | ## Touring 不是什么 - **不是编辑器。** Touring 是基础架构设施；请将其与你的编辑器配合使用。 - **不是每种语言对应一个单独的二进制文件。** Touring 是一个 Rust 二进制文件 + 88 个 MCP 工具 + Claude Code MCP server。 - **不是托管服务。** Touring 是本地优先的；支持按项目或全系统部署。 - **不是代码生成产品。** Touring 是代码生成产品的*底座*。 ## 架构（4 层，1 条视线） ``` +================================================================+ | L4 SURFACE — CLI · MCP · hooks · dashboards | +================================================================+ ↓ +================================================================+ | L3 ORCHESTRATION — workflows · agents · tasks · RL routing | +================================================================+ ↓ +================================================================+ | L2 INTELLIGENCE — code · storage · reasoning · learning | +================================================================+ ↓ +================================================================+ | L1 INFRASTRUCTURE — types · error · alloc · config · ids | +================================================================+ ``` **无环。** 没有后向边。13 个目标生产级 crate（foundation、code、 storage、intelligence、bindings、hooks、hooks-shared、hooks-prediction、 server、server-reasoning、server-session、server-visual、orchestration） + 11 个辅助 crate + 12 个兼容垫片。有关完整的架构，请参阅 `plan.md` 第 I 节。 ## 接下来去哪里 - 📘 **[入门指南](docs/landing/index.md)** — 5 分钟安装 + 首次查询 - 🏛️ **[Constitution v8.0](docs/CONSTITUTION-v8.md)** — 主契约 - 📐 **[RFC](docs/)** — 5 个基础 RFC（activity、PARCER、boundaries、identity、validation） - 📊 **[高级重构计划](docs/plans/touring-premium-refactor-2026/00-INDEX.md)** — 16 波路线图 - 🛡️ **[安全模型](docs/explanation/architecture.md)** — CEG + Landlock + rlimit + cgroup - 🍳 **[指南](docs/how-to/)** — 常见任务方案 ## 稳定性与许可证 | 分类 | 稳定性 | 层级 | 示例 | |--------|-----------|------|----------| | 核心库 | 🔒 已锁定 (3) | free | foundation、code、storage、intelligence、hooks、server | | 内部库 | ✅ 稳定 (2) | free | simd、rkyv、analysis、cortex、assists、offensive | | 实验性 | 🧪 实验性 (1) | free | cognitive、learning、antt、ast、ast-polyglot | | 兼容垫片 | ✅ 稳定 (2) | free | python、wasm、capnp-server、web、web-server | | 辅助库 | ✅ 稳定 (2) | free | loom-proofs、integration-tests | **许可证层级**（通过 `touring-license` 实现叠加优先级）： | 层级 | 费用 | 支持 | 能力 | |------|------|---------|--------------| | **Free** | $0 | 社区（尽力而为） | 所有公开 API | | **Standard** | $99/座席/年 | Discord + 邮件（48 小时 SLA） | + `jwt-verify`，+ `tier-standard` 特性 | | **Premium** | $499/座席/年 | 私有 Slack + 每月审查（24 小时 SLA） | + `tier-premium` 特性（MCTS 门控，共形路由） | | **Enterprise** | 定制 | 专属工程师 + 99.9% SLA（4小时，24/7） | + `tier-enterprise` 特性（多租户，私有化部署） |

标签：AI智能体开发框架, MCP协议, Rust, SOC Prime, 代码智能, 代码生成, 可视化界面, 开发工具, 渗透测试工具, 网络流量审计, 通知系统