codev / docs /README.md
chenbhao's picture
chore: rename VersperClaw to Codev, update org to chenbhao
96f34e3
|
Raw
History Blame Contribute Delete
4.53 kB

Codev 文档

Codev — 基于 Anthropic Claude Code 的增强型 AI CLI 代理,集成 VRM 桌面伴侣、多 Provider、语音对话和自动化模式。

目录

架构

文档 说明
项目架构概览 技术栈、入口流程、模块职责、架构亮点
核心数据流 5 大核心数据流:用户输入、语音捕获、远程桥接、Friend 表情、Provider 代理
Agent 循环深度解析 663 行
设计哲学与架构原则 329 行
安全与权限系统 867 行
Provider 多厂商认证 646 行
跨切面关注点 254 行

CLI 与工具

文档 说明
CLI 命令系统 命令注册、Slash 命令大全 (~75+)、Skill/工作流系统
构建系统与功能标记 676 行
调试系统 /debug v2.0 DEBUG PROBE 工作流、会话调试日志
AI 工具系统 buildTool 框架、执行流程、权限系统、关键工具详解(含 Tavily/SearXNG)
工具参考大全 所有 ~60+ AI 工具的完整参考表

Friend VRM 伴侣

文档 说明
系统总览 定位、组件、交互模式、架构图
系统架构 FriendService、SSE、HTTP 服务器、TTS/STT/VAD 详细分析
数据流 文字对话/F2 语音/情绪表情/SSE 事件 四种流
情绪→3D 表情映射 13 种情绪的 blend shape 组合、动作映射
前端 3D 渲染 Three.js、EmoteController、MotionController、LipSync、TextBubble
语音捕获与 VAD Silero VAD 状态机、STT 提供者链、静音系统

语音

文档 说明
语音系统总览 STT/TTS 提供者、Voice Stream 协议

Ink 终端 UI

文档 说明
Ink UI 框架 自定义 Fork 的渲染管线、组件库、事件系统

桌面服务器

文档 说明
HTTP/WS 服务器 Bun.serve()、REST API、WebSocket、服务层
Computer Use 系统 Python Runtime 辅助脚本架构、跨平台设计、JSON 通信协议
Provider 代理 Anthropic ↔ OpenAI 协议转换、多提供商支持

后端服务

文档 说明
服务总览 MCP、上下文压缩、Auto Dream、飞书/Telegram
飞书集成 飞书/Lark 机器人架构、访问控制、语音回复、配置
上下文压缩深度解析 906 行

协调与自动化

文档 说明
目标与自动模式 Goal 系统、Auto Mode、查询循环、Task 系统
多代理协调 Coordinator 模式、Worker 派发、Agent Teams Swarm、Fork Subagent

远程桥接

文档 说明
远程桥接总览 Bridge 模式、传输协议、认证机制

记忆与上下文

文档 说明
自动记忆系统 Memdir、4 种记忆类型、生命周期
上下文管理 系统/用户上下文构建、压缩策略、React Contexts

面试准备

文档 说明
面试准备指南 714 行