<!-- 文档分类: INIT-PRD-002 | 阶段: 立项 | 原路径: docs/项目-定位.md -->
# KHY OS — 项目定位

> 状态: **草案** (2026-05-30) — 方向已确定，尚未最终敲定。

## KHY 是什么？

KHY OS 是一个 AI 原生操作系统项目。从自研 x86_64 混合微内核，到 AI 驱动的终端、WASM 应用运行时、多通道 AI 网关——作为一个垂直整合的平台统一起来。

与跑在现有操作系统之上的 AI 编程工具不同，KHY 将 AI 视为系统级能力——从内核的 IPC 和系统调用层到交互式终端，AI 都是原生的。

## 架构栈

```
┌─────────────────────────────────────────────────┐
│  KHY 应用层                                      │
│  ┌───────────┐  ┌───────────┐  ┌─────────────┐  │
│  │ khyquant  │  │ WASM 应用 │  │ 用户插件    │  │
│  │ (量化交易)│  │ (沙箱运行)│  │ (CLI/Web    │  │
│  │           │  │           │  │  扩展)      │  │
│  └───────────┘  └───────────┘  └─────────────┘  │
├─────────────────────────────────────────────────┤
│  KHY Shell — AI 原生终端                         │
│  100+ 命令 · 工具调用 · 目标模式                   │
│  上下文管理 · 会话持久化                           │
├─────────────────────────────────────────────────┤
│  KHY Gateway — 多通道 AI 路由器                    │
│  16 适配器 · 优先级级联 · 速率限制                   │
│  协议转换 · OAuth · 健康广播                       │
├─────────────────────────────────────────────────┤
│  KHY Runtime — 平台服务                           │
│  应用注册 · WASM 沙箱 (M1 风格 IPC)                │
│  本地大脑 · MCP 服务器 · 插件加载器                  │
├─────────────────────────────────────────────────┤
│  KHY Kernel — x86_64 混合微内核                    │
│  PMM/VMM · 调度器 · IPC (端口式)                   │
│  VFS · ELF+PE 加载器 · 窗口管理器                   │
│  能力模型 · 系统调用 · MoonBit 桥接                  │
└─────────────────────────────────────────────────┘
```

## 分层详解

### KHY Kernel（内核层）

真实可启动的 x86_64 混合微内核，C 语言编写，汇编启动链。不是模拟器或封装——通过 GRUB 启动，管理物理/虚拟内存，运行协作式调度器，提供端口式 IPC。

核心能力：
- 4 级 x86_64 分页，每进程独立地址空间
- 端口式同步 IPC（32 端口，能力控制）
- ELF 和 PE 双格式加载器（同时运行 Linux 和 Windows 可执行文件）
- 内核级 VFS + RAMFS
- 帧缓冲窗口管理器（16 窗口，Z 序排列）
- MoonBit 语言集成（编译为 C，链接入内核）
- 构建为可启动 GRUB ISO，可在 QEMU 中运行

### KHY Shell（终端层）

AI 原生终端，取代传统 shell 体验。这是当前主要的用户交互界面。

核心能力：
- 100+ 命令，中文/英文/拼音别名
- AI 编程助手，完整工具调用（文件操作、git、shell、搜索等）
- 目标模式（Goal Mode）— 自主多步骤任务执行
- 上下文管理，支持压缩与会话持久化
- 继续回忆 — "继续" 自动重新注入原始任务上下文
- 本地大脑服务 — 确定性操作零 token 消耗

### KHY Gateway（网关层）

多通道 AI 路由器，消除供应商锁定。

核心能力：
- 16 个适配器：Claude、Codex、Kiro、Trae、Windsurf、Cursor、Ollama、本地 LLM、中继 API 等
- 优先级级联 + 断路器 + 自动冷却
- 协议转换（Anthropic / OpenAI / Gemini / Grok / Codex 格式）
- 速率限制（Redis 支持）、OAuth 管理、密钥轮换
- 跨所有连接通道的模型发现

### KHY Apps（应用层）

平台级应用运行时。

核心能力：
- WASM 沙箱，M1 风格微内核 IPC 模拟
- 三种 ABI 模式：numeric-v1、string-v2、json-v2
- 基于能力的访问控制（IPC、NET、FS_READ、FS_WRITE、WINDOW、SHM）
- 应用注册、生命周期管理、自动启动
- 插件/扩展生态

### khyquant（旗舰应用）

AI 驱动的量化交易平台——KHY OS 上构建的第一个应用。展示平台处理真实工作负载的能力。

- 多 Agent 分析：6 个分析师角色 + 多空研究员 + 交易执行者
- 回测引擎：权益曲线、夏普比率、回撤分析
- ML 推理（XGBoost/LightGBM）本地模型分析
- A 股市场数据，多数据源（AKShare、TuShare、efinance、iFind）
- 通达信公式解释器，兼容已有策略

## KHY 与现有工具的区别

|              | Claude Code / Cursor | KHY OS                          |
|--------------|----------------------|---------------------------------|
| 本质         | 终端工具             | 操作系统                         |
| 模型支持     | 单一供应商           | 任意模型、任意通道                |
| 底层基础     | 运行在宿主 OS 上     | 拥有自己的内核                    |
| 功能范围     | 代码编辑             | 平台级——编程、量化、更多           |
| AI 集成深度  | 应用层               | 系统级（内核到终端）               |
| 应用生态     | 无                   | WASM 沙箱 + 插件运行时            |

## 当前成熟度

| 层          | 成熟度                                         |
|-------------|------------------------------------------------|
| 内核        | 可演示 — 可启动、运行进程、IPC 工作。早期阶段      |
| Shell (CLI) | 生产可用 — 日常用于开发                          |
| 网关        | 生产可用 — 16 适配器，级联路由                    |
| 应用运行时  | 可演示 — WASM 沙箱、IPC 模拟可用                  |
| khyquant    | 功能完整 — 多 Agent、回测、多数据源                |
| Web 前端    | 可用 — 交易仪表盘 + AI 管理面板                   |

## 安装

```bash
pip install khy-os
khy --version
khy doctor
```

环境要求：Python >= 3.8，Node.js >= 18。支持：Linux / macOS / Windows。

## 链接

- PyPI: `khy-os`
- 架构: [核心架构](../03_DESIGN_设计/%5BDESIGN-ARCH-010%5D%20核心架构.md)
- 内核 IPC: [M1 微内核 IPC MoonBit](../03_DESIGN_设计/%5BDESIGN-ARCH-007%5D%20m1-微内核-ipc-moonbit.md)
- 智能体路线图: [智能体操作系统路线图](../08_MGMT_项目管理/%5BMGMT-PLAN-006%5D%20智能体-操作系统-路线图.md)
