📚 Khy-OS 文档索引#

本索引为文档总入口，按「阶段 → 类型 → 序号」归类，命名格式 [阶段-类型-序号] 中文名（更新于 2026-06-13）。
各阶段目录另设 00_INDEX_* 分类索引作为该目录的就近导航入口。

阶段总览#

序号	阶段目录	文档数
01	`01_INIT_立项/`	2
03	`03_DESIGN_设计/`	66
04	`04_IMPL_实现/`	30
05	`05_TEST_测试/`	9
06	`06_DEPLOY_部署/`	18
07	`07_OPS_运维/`	68
08	`08_MGMT_项目管理/`	34
—	`AI协作预设包/`（跨阶段·分「给人看/给AI看」两线 + 可安装 skills/）	11 文档 + 8 skill

🧭 换任何 AI 接手先看：AI协作预设包/ — 严格区分给人看（怎么用/排错/选活/保命）与给AI看（可直接粘贴的开场白/铁律/错误自查/任务卡）；含两份总说明（人的一页速览 + AI 的一次读懂全局）；并附一套可 khy skill import 的 skills/（8 个指导弱模型现场使用 khy 的 skill）。适用于「只能用弱模型 / 陌生大模型、且靠 pip 分发」的维护场景。

📖 想按「从启动到愿景」的认知顺序读懂架构：[DESIGN-ARCH-063] 对照《Claude Code 架构》一书读懂 Khy-OS — 借一本讲 Claude Code 架构的书的目录当骨架，逐章把「书里的 CC 概念」对齐到「khy 此刻真实的实现（文件:行）」，并如实标注相同/khy 特有/未做之处。它与本索引的生命周期分类法互补：本索引答「一个功能怎么落地」，那篇答「按认知顺序从启动一路读到 Agent-as-OS 愿景」。

🐣 完全新手从这里开始（概念入门 + 修仙故事）#

如果你没有编程/AI 基础，别从上面的架构文档入手，先读这两套面向小白的材料：

📗 概念入门总览 — 用生活比喻把 AI 助手背后的 13 个核心概念讲透：Agent、工具调用（Tool Calling）、工具循环（Tool Loop）、MCP、Skill（基础五篇）＋ LLM 大模型、Prompt、上下文与令牌、Embedding 向量、向量数据库、RAG、机器学习、深度学习（进阶八篇）。每篇都有比喻、图表、常见误区、动手小实验。
📖 《算道天书》：修仙学 AI — 一部 14 章的修仙长篇小说，主人公孔浩原从山村药童修炼成 AI 大师，每个境界对应一个上面的概念，章末「凡人笔记」翻译回真实术语。当爽文看会上头，当教材看会开窍。

01_INIT_立项#

03_DESIGN_设计#

DESIGN-ARCH-001 khy-移动智能体协议
DESIGN-ARCH-002 Khyos-CB-SSP-数学建模与实现映射
DESIGN-ARCH-003 Khyos-数学重塑-受约束随机最短路径
DESIGN-ARCH-004 _cbssp_progress
DESIGN-ARCH-005 agentfs-智能体文件系统
DESIGN-ARCH-006 ai-gateway-适配器协议架构
DESIGN-ARCH-007 m1-微内核-ipc-moonbit
DESIGN-ARCH-008 moonbit-系统边界
DESIGN-ARCH-009 可视化拖拽工作流编辑器-2026-06-09
DESIGN-ARCH-010 核心架构
DESIGN-ARCH-011 应用接入标准
DESIGN-ARCH-012 工具延迟加载
DESIGN-ARCH-013 弱模型兼容
DESIGN-ARCH-014 模式图谱
DESIGN-ARCH-015 编码规范
DESIGN-ARCH-016 AI_Agent显示规范
DESIGN-ARCH-017 元工具系统设计
DESIGN-ARCH-018 Agent提示词复用机制
DESIGN-ARCH-019 用户输入预处理规范
DESIGN-ARCH-020 架构债治理报告
DESIGN-ARCH-021 巨型环反转设计
DESIGN-ARCH-022 khyos多实例并发文件控制规范
DESIGN-ARCH-023 khyos文档排版与格式控制规范
DESIGN-ARCH-024 khyos元帅双模式任命与约束规范（已归档·孤儿引擎）
DESIGN-ARCH-025 khyos元规划协议与动态约束注入规范
DESIGN-ARCH-026 khyos系统级服务调用审批网关规范
DESIGN-ARCH-027 Agent依赖自愈机制规范
DESIGN-ARCH-028 Agent通信防御-零静默失败与精准归因
DESIGN-ARCH-029 Agent有限窗口降级与强制兜底执行协议
DESIGN-ARCH-030 源端构建-目标机自愈运行
DESIGN-ARCH-031 网关日志租界隔离-按需可见与净味翻译
DESIGN-ARCH-032 内嵌MD工作台与跨平台右键集成
DESIGN-ARCH-033 模型自适应与双轨热插拔架构（已归档·孤儿引擎）
DESIGN-ARCH-034 动态自适应约束求解引擎
DESIGN-ARCH-035 上下文永续与认知压缩引擎（已归档·孤儿引擎）
DESIGN-ARCH-036 万物结构化熔炉引擎
DESIGN-ARCH-037 Khyos自举创世-需求内源发生器与闭环自愈引擎
DESIGN-ARCH-038 Khyos双轨淬火-确定性保底与模型辅助增强的Bug升维引擎（已归档·孤儿引擎）
DESIGN-ARCH-039 Khyos环境共生-环境感知与原生亲和架构（已归档·孤儿引擎）
DESIGN-ARCH-040 Khyos数据主权与极权路由-数据主权绝对论与单一权威注入网关（已归档·孤儿引擎）
DESIGN-ARCH-041 Khyos意图精准裁决-意图光谱解析与动态提权网关
DESIGN-ARCH-042 Khyos自持基建-契约即文档与影响面评估与行为守卫（已归档·孤儿引擎）
DESIGN-ARCH-043 khy-agent-sdk-Claude对齐与D1-D6融合规范
DESIGN-ARCH-044 Agent自愈微循环-诊断修复重试
DESIGN-ARCH-045 非活跃通道生命周期治理-僵尸后台收回与日志越权阻断
DESIGN-ARCH-046 聊天状态污染与回复截断治理-原子轮提交与空结果重试与截断信号保真
DESIGN-ARCH-047 轨迹溯源标准-溯源信封与防篡改链与注入隔离
DESIGN-ARCH-048 khyos轨迹回放与确定性复现
DESIGN-ARCH-049 轨迹即教材-AI引导回放
DESIGN-ARCH-050 项目整体意识与自驱收尾保障
DESIGN-ARCH-051 单人维护者健康驾驶舱
DESIGN-ARCH-052 任务驱动读取与搜索范围规划-精准而非全知
DESIGN-ARCH-053 命令与第三方应用输出折叠-几行预览与Ctrl+O展开
DESIGN-ARCH-054 AI逆向工程-从产物还原与自验软件
DESIGN-ARCH-055 对抗式训练-极端环境抗压自检与加固
DESIGN-ARCH-056 khyos桌面操控-眼耳嘴与模拟操作
DESIGN-ARCH-058 细粒度权限策略与记忆主动化引擎
DESIGN-ARCH-059 能力即代码
DESIGN-ARCH-060 khy 功能接线与编排总图
DESIGN-ARCH-061 更新包学习-取其精华弃其糟粕
DESIGN-ARCH-062 khyos 后台常驻与按需加载生命周期边界
DESIGN-ARCH-063 对照《Claude Code 架构》一书读懂 Khy-OS（书序架构阅读主线）
DESIGN-OTHER-001 Khyos-数学重塑-实施提示词链
DESIGN-OTHER-002 _cbssp_分阶段防闪退提示词
DESIGN-OTHER-003 khy-系统提示词结构图
DESIGN-OTHER-004 特性访问-提示词胶囊-2026-06-01

04_IMPL_实现#

05_TEST_测试#

06_DEPLOY_部署#

07_OPS_运维#

📦 pip 安装从这里开始：OPS-MAN-027 快速开始 → OPS-MAN-043 从0到高手 ⭐ → OPS-MAN-023 完整功能清单 → OPS-MAN-024 按需配置体验；门槛与还原见 OPS-MAN-028 环境要求 / OPS-MAN-037 完整还原。

08_MGMT_项目管理#

AI协作预设包（跨阶段 · 分「给人看 / 给AI看」两线）#

用途：在「只能用弱模型/陌生大模型、且靠 pip 分发」的场景下继续维护本项目。
严格区分受众：给人看/ 是你自己的操作与决策；给AI看/ 是可直接整段粘贴给 AI 的内容。

总入口

🚀 先看两份总说明（最快掌握）

🧑 总说明-一页速览（给人） — 你自己 30 秒看懂全局
🤖 总说明-一次读懂全局（给AI） — 整段发给 AI 即读懂全貌

🧑 给人看/（你先从这里开始）

🤖 给AI看/（复制里面内容发给 AI）

🧩 skills/（装进 khy 指导弱模型现场执行）

skills 集合总说明 — 8 个可安装 skill：onboarding / safe-change / weak-model-guardrails / pick-task / troubleshoot / gateway-fix / release-safety / honest-closure。装法：khy skill import <目录> 或放 ~/.khy/skills/。