AI Character Studio · Soul Distillation · Visual Companion · Desktop Stage
项目介绍 · 桌面端部署 · 功能清单 · 产品截图 · English
Third Kind Contact / 第三类接触（英灵殿）是一款 MIT 开源的桌面端 AI 角色复刻工作室。你可以输入一句话、人物资料或自定义语料，让它提炼角色的性格、语言、思维方式与视觉形象，并把角色召唤成可聊天、可生成形象、可停留在桌面的 AI 伴侣。
它不是一个普通聊天壳，而是一套完整的角色生成流程：从英灵选择、召唤向导、语料补全、灵魂蒸馏，到头像/形象生成、桌面陪伴和小舞台展示。
这是 Tauri 桌面应用。Vite/React 只是桌面端内部的前端构建层，本项目不作为静态网页部署；请不要直接打开
dist/index.html。
| 人群 | 可以用它做什么 |
|---|---|
| 创作者 | 为小说、剧本、游戏和视觉企划建立稳定角色人格与语言风格 |
| AI 角色玩家 | 把喜欢的历史人物、虚构角色或原创设定复刻成可互动角色 |
| 开发者 | 研究角色智能体、人格建模、桌面伴侣和 Tauri 应用形态 |
| 个人用户 | 构建本地优先、自带模型 Key、可长期使用的 AI 角色工作台 |
完整部署说明见 DEPLOYMENT.md。
| 组件 | 推荐版本 | 用途 |
|---|---|---|
| Node.js | 18+ | 安装前端依赖，供 Tauri 调用前端构建层 |
| npm | 9+ | 包管理 |
| Rust | stable | 编译 Tauri 桌面端后端 |
| WebView2 | Windows 10/11 通常已内置 | Windows 桌面窗口运行环境 |
| Git | 现代版本 | 拉取源码 |
git clone https://github.com/zhangtianruiwork-droid/Third-Kind-Contact.git
cd Third-Kind-Contact
npm install
npm run desktop也可以使用：
npm run tauri:devnpm run desktop:build构建产物会输出到 src-tauri/target/release/bundle/。
| 命令 | 说明 |
|---|---|
npm run desktop |
启动完整 Tauri 桌面端 |
npm run dev |
同样启动桌面端，保留给开发习惯 |
npm run tauri:dev |
明确启动 Tauri 开发模式 |
npm run desktop:build |
构建桌面端安装包 |
npm run build |
同样构建桌面端安装包 |
npm run desktop:check |
检查 Rust/Tauri 后端能否编译 |
npm run frontend:dev |
Tauri 内部前端开发服务，不是产品运行入口 |
npm run frontend:build |
Tauri 内部前端构建，不是网页部署命令 |
如果你看到有人打开 dist/index.html 得到空白页或浏览器翻译提示，那是运行方式错误。请使用 npm run desktop 启动桌面客户端。
| 功能模块 | 描述 | 状态 |
|---|---|---|
| 英灵选择殿 | 管理、选择、导出角色档案，展示头像、标签、身份和配置状态 | 已实现 |
| 召唤向导 | 通过名称、时代、简介和语料创建新角色 | 已实现 |
| 灵魂蒸馏 | 自动提炼核心性格、语言风格、心智模型和互动方式 | 已实现 |
| 角色对话 | 与召唤后的角色持续对话，并保留本地会话记录 | 已实现 |
| API 设置 | 支持 DeepSeek-compatible、OpenAI-compatible、Ark / Seedance 等接口配置 | 已实现 |
| 形象生成 | 支持头像、像素形象和角色视觉资产生成 | 已实现 |
| 桌面伴侣 | 将角色以桌面陪伴形式运行，增强沉浸感 | 已实现 |
| 小舞台工具 | 支持单张参考图生成小舞台动作视频，并用于桌面陪伴状态切换 | 已实现 |
| 本地存储 | 角色、设置、会话、形象和场景默认保存到本机 | 已实现 |
| 导入导出 | 支持角色数据导出，便于备份和迁移 | 已实现 |
管理你创建的角色，查看身份、标签、形象和配置状态。
将输入语料转化为结构化人格：核心性格、语言风格、心智模型与互动方式。
从基础信息到语料补全，再到灵魂蒸馏和确认召唤，完整生成一个可使用的角色。
打开应用右上角设置面板，填入你自己的模型 Key。
| Provider | 用途 | 是否必需 |
|---|---|---|
| DeepSeek-compatible API | 灵魂蒸馏与角色对话 | 推荐 |
| OpenAI-compatible Image API | 头像 / 像素形象生成 | 可选 |
| OpenAI-compatible Search API | 可选检索增强 | 可选 |
| Volcengine Ark / Seedance | 可选桌面舞台视频生成 | 可选 |
应用不托管你的 API Key，也不提供任何第三方模型服务担保。请自行选择服务商，并遵守其服务条款。
src/
SelectionApp.tsx 英灵选择殿
PetApp.tsx 桌面伴侣模式
pages/SummonPage.tsx 召唤向导
pages/SpriteGenPage.tsx 像素形象生成
pages/SceneGenPage.tsx 小舞台视频工具
lib/ API、存储、导入导出逻辑
src-tauri/
src/lib.rs Tauri 后端命令
tauri.conf.json 桌面端窗口与构建配置
docs/screenshots/ README 展示素材
docs/diagrams/ 架构与流程图
角色档案、设置、形象、场景和聊天记录默认保存在本机。只有当你主动触发需要模型能力的功能时，应用才会调用外部 API。
Third Kind Contact is an MIT-licensed desktop AI character studio built with Tauri and React. Give it a short prompt or source material, and it helps you turn a character into a structured AI persona with personality, speech style, mental models, visual identity, and optional desktop companion behavior.
This repository is for the desktop app. React/Vite is only the internal frontend layer used by Tauri; the project is not meant to be deployed by opening dist/index.html.
git clone https://github.com/zhangtianruiwork-droid/Third-Kind-Contact.git
cd Third-Kind-Contact
npm install
npm run desktopBuild the desktop installer:
npm run desktop:buildRead DEPLOYMENT.md for the full setup and troubleshooting guide.
- Herald Registry for character profile management.
- Summoning wizard for creating new personas.
- Soul distillation for traits, speech style, mental models, and interaction rules.
- Local conversation history.
- Avatar and pixel companion generation.
- Single-reference-image desktop stage video workflow.
- Desktop companion runtime powered by Tauri.
- Bring-your-own compatible model APIs.
- MIT open-source license.
Third Kind Contact is open source under the MIT License. See LICENSE.