chenxin
3fbcd0437c
- Makefile：统一命令入口（backend/engine/docker/openapi/generate，含 make help） - backend：FastAPI + uv 最小工程，统一错误体（契约第 7 节）、ADR-015 平台 ID 生成与校验（uuid-utils）；pytest 7 项、ruff、mypy strict、启动冒烟全部通过 - engine：灵台引擎 C++23/CMake 骨架，按 Lingtai C ABI 契约实现 lingtai.h（13 个 HjStatus、版本协商、句柄表防二次释放、线程局部错误上下文）；doctest 5 用例通过，nm 验证仅导出 hj_* 符号 - openapi：OpenAPI 3.1 单一真源初始版（错误体/分页/Money/首批平台 ID/ContentBlock 全 21 类型/流事件 envelope），Redocly lint 0 错误、bundle 通过 - frontend：Next.js 最小骨架，openapi-typescript 生成 API 类型并通过 strict tsc - docker：hunjing-postgres（pgvector:17）compose；.env.example 与 config 示例 - ADR-025：登记测试与契约工具链（doctest/libFuzzer/Redocly/openapi-typescript/uuid-utils） - desktop：Tauri v2 占位与初始化说明（WP-10 启动）
Hunjing
Hunjing 是面向个人用户与创作者的长期 AI 角色、Agent 与创作社区平台。它支持角色连续身份、分支对话、可治理记忆、多 Agent、插件、语音、多语言、多模态、Live2D、3D、跨端感知、社区协作和真实交易。
当前仓库处于设计阶段，尚无可运行实现。文档描述完整 1.0 目标，不代表功能已经完成。
1.0 范围
Hunjing 1.0 是一次整体交付，必须同时包含：
- 角色创建、导入、版本、谱系、记忆、关系和可携导出；
- 多模态分支对话、实时语音、图像和多语言；
- Live2D 以及 VRM/glTF 3D 导入、编辑、运行和导出；
- 角色 Agent、任务 Agent、协调 Agent和受控多 Agent 并行；
- Web、Tauri 桌面端、Tauri iOS/Android 与文件/相机/麦克风/屏幕/位置感知；
- 双轨插件生态、开发 SDK、注册、审核、安装、升级、回滚和插件市场；
- 完整社区、角色社区、多人协作空间、搜索、推荐和内容治理；
- 商品、订单、真实支付、退款、平台分成、创作者结算、对账和争议处理；
- 模型/工具调用的 token、Prompt Cache、成本、时延、错误、重试和受保护诊断；
- 官方部署与完整自托管闭环。
所有工作包可以内部并行，但全部 TODO 和发布门完成前不得称为正式 1.0。
架构原则
- 可扩展能力皆插件；认证、授权、数据隔离、审批、审计、交易账、事务和隔离执行内核不可插件化。
- 声明式/远程插件默认受限运行；部署者明确信任的本地代码插件进入独立进程或容器。
- 性能与安全敏感的确定性核心（内容规范化、流式、策略校验、端侧离线检索）以 C++ 灵台引擎实现：可经稳定 C ABI 进程内嵌入 Python/Rust/Go 宿主，也可作为部署内部的 gRPC 独立服务运行；引擎无权威状态，数据事实源仍在数据库。
- 每个 Run 持久化 Turn、模型 attempt、工具调用、token、缓存、费用和错误。
- 详细诊断必须同时持有登录态和短期、限范围的诊断授权。
- 技术按能力、规模与安全需要采用，不以堆满技术栈作为完成标准。
- 产品界面使用“中国古代神话/道家文化名 · 直白解释”的双层语言；稳定 API、数据库、事件和日志使用中性英文工程标识。
- Native Message、社区内容和 Agent 输出使用统一类型化 ContentBlock，支持 Markdown、代码、数学公式、Mermaid、图片、视频、音频、文件、工具状态和产物的安全分级实时渲染。
2.0 已确认范围
- Blender 级完整 3D 建模器；
- 基于开源建模项目完善网格、雕刻、拓扑、绑定和专业动画工具；
- LLM 直接、可验证地修改完整 3D 几何与绑定；
- IoT、机器人和物理动作控制。
文档入口
从 docs/README.md 开始，完整范围见 完整 1.0 范围与发布门。