khy-os 0.1.93

Khy OS — AI platform operating system with an extensible default app runtime

Khy OS

Khy OS is an AI platform CLI and runtime. The default built-in app is khyquant.

Positioning

• khy is the primary Khy OS command (platform shell + app runtime).
• khyquant is the default upper-layer app/plugin compatibility command.
• AI lite mode is explicit: use khy ai ... (or khy --lite ...).

Release Notes (0.1.3)

This release focuses on vision/multimodal adapter compatibility and packaging consistency.

Highlights

• Unified image normalization for gateway adapters:
  • added shared image compatibility layer for base64/data-url/url payloads
  • mapped unified image input to adapter-specific formats (Codex/Claude/Ollama/OpenAI-compatible IDE adapters)
• Removed forced image routing to Claude by default:
  • image requests now keep the selected adapter first
  • gateway fallback remains enabled when a channel actually fails
• Improved local/IDE multimodal behavior:
  • Codex direct mode accepts normalized images
  • Ollama adapter accepts normalized image payloads for multimodal models
  • Trae/Windsurf adapters accept OpenAI-compatible vision message blocks
• Packaging/release consistency:
  • synchronized package version metadata for khy-os==0.1.3
  • fixed release path to avoid mixed/legacy install metadata

Upgrade

python3 -m pip install -U khy-os==0.1.3
khy --version

---

Release Notes (0.1.2)

This release focuses on production stability, multi-adapter robustness, and clearer operator experience.

Highlights

• Improved AI request stability for long-running tasks:
  • task-scale-aware retry/timeout strategy
  • transient error recovery across gateway and tool loop layers
  • safer adapter failover behavior when preferred channels are unstable
• Better context-window safety:
  • dynamic context budget handling
  • stronger compaction path for oversized histories
• Better terminal UX:
  • improved status signaling and de-duplication
  • stronger recovery for interactive input states
• Packaging/version sync:
  • synchronized version bump across Python + Node entry metadata
• release artifacts generated for khy-os==0.1.2

Upgrade

python3 -m pip install -U khy-os==0.1.2
khy --version

Compatibility

• Python: >=3.8
• Node.js: >=18
• OS: Linux / macOS / Windows

Directory Structure

Khy-OS/
├─ platform/                       # Platform layer (Python launcher + shared JS)
│  ├─ khy_platform/                # Python launcher package (PyPI entrypoint)
│  │  ├─ cli.py                    # Main Python CLI bridge
│  │  └─ _bootstrap.py             # Runtime bootstrap checks/fixes
│  ├─ khy_os/                      # Bundled runtime payload (pip distribution)
│  └─ packages/shared/             # Shared JS modules (backend/frontend)
│
├─ services/                       # Backend services (Node.js)
│  ├─ backend/                     # Node.js core runtime
│  │  ├─ bin/khy.js                # Node CLI entrypoint
│  │  ├─ server.js                 # API server entrypoint
│  │  └─ src/
│  │     ├─ cli/                   # REPL/router/handlers
│  │     ├─ routes/                # HTTP routes
│  │     ├─ services/              # Gateway, adapters, tools, orchestration
│  │     ├─ tools/                 # Tool implementations
│  │     ├─ models/                # Data models
│  │     └─ middleware/            # Auth/rate-limit/error middleware
│  └─ ai-backend/                  # AI management backend (API + gateway admin)
│
├─ apps/                           # Upper-layer apps
│  └─ ai-frontend/                 # Vue management UI (components/views/stores/api)
│
├─ software/khyquant/                 # Default built-in app
├─ kernel/                         # OS build tree (alpine/boot/iso/moonbit/src)
├─ extensions/                     # Optional extensions
├─ docs/                           # 架构、指南、验证文档
├─ scripts/                        # Build/install/release scripts
├─ tests/                          # Test suites
├─ pyproject.toml                  # Python package metadata
└─ services/backend/package.json   # Node backend metadata

Quick Start

python3 -m pip install -U khy-os
khy --help
khy doctor
khy app list

Development install:

python3 -m pip install -e .

Core Commands

khy app list
khy gateway status
khy linux status
khy server start

Explicit AI Lite Mode

khy ai "summarize this project status"
khy ai -p "only output JSON"
khy ai run qwen3.5:4b "hello"

# compatibility alias (kept for older scripts)
khy run qwen3.5:4b "hello"

OS Build Entry

bash scripts/build-khy-os.sh

Windows (Docker Desktop + PowerShell):

khy iso build --output dist/khy-os.iso
# equivalent source script:
# powershell -ExecutionPolicy Bypass -File scripts/alpine/build-iso-windows.ps1

VMware usage:

1. On Windows, the recommended flow is pip install khy-os -> khy iso build -> attach dist/khy-os.iso in VMware.
2. If you need a VMware disk image (.raw / .vmdk) instead of an ISO, use the Linux source-tree workflow with scripts/khytogo/make-khytogo.sh --mode vmware-plan|vmware-create.
3. Full guide: docs/指南/windows-vmware-清单.md

Component mode:

bash scripts/build-khy-os.sh --component core --component vmware-plan
bash scripts/build-khy-os.sh --component moonbit --strict

WASM App Runtime

khy app register math --runtime wasm --wasm /abs/path/math.wasm --abi numeric-v1 --export add
khy app run math add 1 2

khy app register echo --runtime wasm --wasm /abs/path/echo.wasm --abi string-v2 --export run
khy app exports echo
khy app run echo hello khy os

khy app register score --runtime wasm --wasm /abs/path/score.wasm --abi json-v2 --export run
khy app run score --json '{"symbol":"AAPL","price":192.3,"rsi":63.2}'

# M1 IPC simulation (loopback netd/fsd/wmd)
khy app register weather --runtime wasm --wasm /abs/path/weather.wasm --abi json-v2 --export run --caps ipc,net
khy app ipc weather net http_get --json '{"city":"shanghai"}'

Required Environment

• Python >= 3.8
• Node.js >= 18
• Linux/macOS/Windows

Pip Distribution Boundary

• Prebuilt ISO/model artifacts are intentionally excluded from pip packages.
• You can build ISO locally after installation (khy iso build ...).
• You can download and register models on demand:

khy models pull qwen3.5:4b
khy models list
khy gateway model

See:

• docs/架构/核心架构.md
• docs/指南/环境要求.md
• docs/修复记录/特性访问与代理解耦-2026-06-01.md
• docs/维护者/特性访问-维护速查-2026-06-01.md
• docs/模板/特性访问-提示词胶囊-2026-06-01.md