秋月不会解梦的头像 秋月不会解梦

PROJECT KOKONA · AI-NATIVE VIRTUAL LIFE SIM

Project Kokona

心夏计划 · 心之所向,夏之所在

以《卡拉彼丘》心夏为核心的 AI-native 虚拟生活模拟世界。 自研 Rust 运行时,世界模拟与画面表现分离, 支持 Living / Away 双模式与 Headless 后台常驻。

① 自研运行时,不套引擎

winit + wgpu + 自研零依赖 ECS。世界、表现、AI 三层解耦——同一份世界逻辑既能上屏渲染,也能在没有 GPU 的机器上跑后台循环。

② 是长期陪伴,不是一局游戏

目标是会挂在桌面几小时的陪伴型应用。默认跟随显示器刷新率、帧率上限可配——性能余量用来保证不卡,不是用来烧电。

RUNTIME 自研 Rust 运行时 PKR · pkr-* 组件
RENDER wgpu + winit 二次元着色 · 四档画质
MODES Living · Away 双模式 + Headless
AI LLM + 长期记忆 对话 · 事件 · 语音
STAGE Phase 0 · 进行中 技术验证 · 未发布

长线计划

NINE STAGES · PHASE 0 → FUTURE

  1. PHASE 0 进行中

    技术验证与基础设施

    确定技术路线,验证模型、骨骼、渲染与性能上限。选定自研 Rust Runtime,确立 glTF 统一资产管线与画面分档策略。

  2. PHASE 1 基础已落地

    核心 Runtime

    Core(生命周期 / 系统调度 / 资源与配置)、World(ECS / 实体 / 世界状态)、Presentation(渲染 / 相机 / UI / 音频)、AI 四大模块分层建立。

  3. PHASE 2 部分落地

    角色与动画系统

    让心夏能在世界里自然活动:统一骨骼映射、基础动作库、程序化动画(呼吸 / 眨眼 / 视线)、动画状态机与视图切换。

  4. PHASE 3 推进中

    世界与生活模拟

    世界时钟、自由行为、事件与剧情系统。空间从宿舍 803 起步,按生活场景逐步扩展,不照搬竞技地图。

  5. PHASE 4 接口已通

    AI 与记忆系统

    LLM 对话与人格上下文、短期对话 / 长期记忆 / 共同经历的分层记忆、关键词检索与阶段总结,Agent 调度与外部 Bot 协作。

  6. PHASE 5 接口完成

    QQ 与 TTS 系统

    外部消息接入与角色语音表达。消息进入世界层并转化为可验证的世界事件,TTS 为自由合成,不锁死语音库。

  7. PHASE 6 架构预留

    双模式与后台运行

    Living 第一人称直接互动、Away 第三人称自主生活,模式切换由完整演出完成;Headless 在无 GPU 时低功耗常驻。

  8. PHASE 7 清单已定

    MVP 整合与验收

    23 项 MVP 验收清单逐项核对,端到端联调与性能基线实测。放行不等于完成,有字段不等于已实现——以代码与实跑为准。

  9. FUTURE 预留

    存档、世界扩展与高级功能

    存档与回档、世界规模扩展、高级角色能力、剧情分支与换装系统,按主线稳定度择机推进。

已经跑通的部分

PHASE 0 · LOCAL BUILD

01 — 渲染

画面与性能分档

自研 wgpu 管线,二次元轻二分着色 + 皮肤路径 + 接触阴影,昼夜色温、雾化与光照齐备。

  • 四档画质:渲染倍率 / MSAA / shadow map / 色彩分级 / Bloom / SSAO 均可调
  • 帧时间分位数与 1% low 统计常开,作为回归基线
  • 1080p 本机基线 1200+ FPS,余量用来换稳定而不是默认跑满
02 — 角色

模型、骨骼与待机

PMX → GLB 资产管线落地,含 46 个表情;统一骨骼映射在单测里做到 2304 通道零漏映射。

  • 骨骼蒙皮 + 运行时姿态调整
  • 程序化待机:呼吸、头部微动、眨眼、疲惫姿态
  • 动画状态机与第一 / 第三人称视图混合已接线
03 — 世界

时钟、行为与事件

世界时钟驱动日程与精力,自由行为系统按状态与权重选择动作,事件定义走独立数据文件而非硬编码。

  • 宿舍 803 原创 3D 场景:119 对象、9 个交互点
  • 事件定义层 + 物件状态存档,触发条件与冷却独立
  • Headless 无 GPU 世界循环可独立验证
04 — AI

对话与记忆

LLM 通道已真打通,思考模型的推理段与正文分离处理;记忆按短期上下文 / 长期记忆 / 共同经历分层。

  • OpenAI 兼容与 Anthropic 两套适配
  • 阶段总结 + 关键词检索,跨轮上下文可续
  • 玩家名可运行时修改,记忆同步回刷,不硬编码身份
05 — 存档与后台

能存、能读、能后台跑

存档 v3 含长期记忆与世界物件状态,旧档平滑回落;无 GPU 环境下可跑纯世界循环。

  • Headless 低功耗后台 + 遮挡暂停渲染
  • 本地 IPC 事件注入,便于外部驱动与调试
  • Kira 音频后端与 TTS 接口,语音库兜底
06 — 工程

可验证优先

性能、内存、画质持久化都有离屏脚本与自检,产物留档;基线只认本机实测,不用别人的数字冒充。

  • 内存长跑 350s / 35 样本,斜率 0.16 MB·min⁻¹
  • 画质档位重启保持:四档各一次跨进程验证
  • 离屏基线 ≠ 真机 60fps,口径分开写

运行时架构

WORLD / PRESENTATION / AI 三层解耦

CRATES

一个 workspace,六个组件

Project-Kokona/
  crates/
    pkr-core      时钟、错误、运行时生命周期、资源配置
    pkr-world     ECS、实体与物件状态、行为、日程、事件、存档
    pkr-render    wgpu 渲染、相机、模型、着色器、资源流式加载
    pkr-ai        对话、LLM 提供方适配(OpenAI 兼容 / Anthropic)
    pkr-audio     Kira 后端、TTS 接口、语音库
    pkr-app       组装与入口(二进制 kokona)

  docs/           计划、上下文、技术决策记录
  assets/         运行时资产(模型 / 语音不入库)
  stories/data/   事件定义(独立 JSON,运行时可加载)

命名约定:项目 Project Kokona、引擎 PKE、运行时 PKR; 运行时组件统一 pkr-<组件>。

设计原则

RULES THAT DO NOT BEND

优化优先于堆砌

画质可以提、可以分档,但任何档位都不允许靠硬件硬扛。60fps 是舒适基线,稳定比峰值重要,关键时刻不允许卡顿。

世界与表现分离

世界模拟不依赖渲染。同一份世界逻辑,既能带画面跑,也能在 Headless 下只跑模拟——后台常驻与低功耗由此成立。

AI 决策,运行时验证

AI 负责理解、决策和表达,游戏运行时负责验证并执行世界行为。模型给出的意图要落到可校验的世界状态上。

玩家身份不写死

玩家名、称呼、人称都是运行时配置,不硬编码进代码或人设文本。改名后,历史记忆与语音表达同步改用新称呼。

当前状态:Phase 0 技术验证与基础设施推进中,版本 v0.0.0,尚未对外发布。 运行时以 cargo run 本地构建运行,Windows 优先,架构兼容 Linux / macOS。