Skip to content

Commit 973f411

Browse files
wehosHongzhi Wen
andauthored
[codex] Refresh README feature copy (#1142)
* Refresh README feature copy * Polish README hero translations * Update README Steam and proactive copy * Update README community and provider copy * Clarify README memory tree examples --------- Co-authored-by: Hongzhi Wen <cartabio.coder1@gmail.com>
1 parent d6c75f9 commit 973f411

4 files changed

Lines changed: 52 additions & 76 deletions

File tree

README.MD

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
![Logo](assets/neko_logo.jpg)
44

55
[English](docs/README_en.md) | [日本語](docs/README_ja.md) | [Русский](docs/README_ru.md)
6-
# Project N.E.K.O. :kissing_cat: <br>**主动式AI伙伴——具备24/7环境感知、自主执行力与具身情感引擎**
6+
# Project N.E.K.O. :kissing_cat: <br>**主动式 AI 伙伴——听见你的心情,看见你的世界,陪你发现更多喜欢**
77

88
> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism (网络型情感知性生命体)
99
>
@@ -13,14 +13,14 @@
1313
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
1414
[![Commit](https://img.shields.io/github/last-commit/wehos/N.E.K.O?color=green)](https://github.com/Project-N-E-K-O/N.E.K.O/commits)
1515
[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/5kgHfepNJr)
16-
[![QQ群](https://custom-icon-badges.demolab.com/badge/QQ群-1022939659-00BFFF?style=flat&logo=tencent-qq)](https://qm.qq.com/q/hN82yFONJQ)
16+
![QQ群](https://custom-icon-badges.demolab.com/badge/QQ群-995414391-00BFFF?style=flat&logo=tencent-qq)
1717
[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/)
1818

1919
[![Docs](https://img.shields.io/badge/📖_开发者文档-project--neko.online-40C5F1?style=for-the-badge)](https://project-neko.online)
2020

21-
**:older_woman: 零配置开箱即用,我奶奶都能玩转的赛博猫娘**
21+
**:older_woman: 零配置开箱即用,我奶奶也能轻松唤醒的赛博猫娘**
2222

23-
:newspaper: **[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/)已上架!UI完全改版、并添加开箱即用的专属免费模型(感谢阶跃星辰赞助)。快点加入愿望单吧~**
23+
:newspaper: **[Steam](https://store.steampowered.com/app/4099310/__NEKO/)已免费上架!喜欢的话,欢迎喜加一,顺手给个好评~**
2424

2525
*Project N.E.K.O.,喵宇宙!*
2626

@@ -32,15 +32,15 @@
3232

3333
<table>
3434
<tr>
35-
<td align="center" width="25%">🎙️<br><b>全模态对话</b><br>语音实时对话 (Realtime API) + 文字对话 (ChatCompletion),支持实时视觉理解</td>
36-
<td align="center" width="25%">🧠<br><b>三层记忆系统</b><br>事实记忆 / 反思记忆 / 人格记忆,她真的会"记住"你</td>
37-
<td align="center" width="25%">🤖<br><b>Agent 智能体</b><br>浏览器操控、键鼠操控、OpenClaw A2A调用,她能帮你干活</td>
35+
<td align="center" width="25%">💬<br><b>主动陪伴</b><br>屏幕理解、社交媒体热搜、个人动态、音乐梗图,她会主动找你聊天,分享你喜欢的新鲜事</td>
36+
<td align="center" width="25%">🎙️<br><b>实时语音、文字与视觉理解</b><br>语音实时对话 (Realtime API) + 文字对话 (ChatCompletion),支持实时视觉理解</td>
37+
<td align="center" width="25%">🧠<br><b>五维记忆系统</b><br>工作记忆 / 近期记忆 / 事实记忆 / 反思记忆 / 人格记忆,让她越聊越懂你</td>
3838
<td align="center" width="25%">🎭<br><b>多形态 Avatar</b><br>Live2D / VRM / MMD 三种形态,支持动作捕捉与全屏追踪</td>
3939
</tr>
4040
<tr>
41-
<td align="center">🔌<br><b>插件生态</b><br>完整的插件 SDK 与商城,支持自定义扩展功能,可陪玩MC/杀戮尖塔/嘎啦给木</td>
41+
<td align="center">🤖<br><b>Agent 工具执行</b><br>可操作浏览器与电脑,调用 CUA / OpenClaw A2A / 插件完成任务</td>
42+
<td align="center">🔌<br><b>插件生态</b><br>SDK + 插件商城,支持联机游戏陪玩、社交媒体互动、直播互动、智能家居等扩展场景</td>
4243
<td align="center">🌐<br><b>14+ AI 服务商</b><br>OpenAI / Gemini / Qwen / DeepSeek 等,含免费模型开箱即用</td>
43-
<td align="center">💬<br><b>主动对话</b><br>24/7环境感知:屏幕理解、社交媒体热搜、个人动态、音乐梗图,她会主动找你聊天</td>
4444
<td align="center">🏪<br><b>UGC 创意工坊</b><br>Steam 创意工坊上传分享自定义角色、模型、语音包</td>
4545
</tr>
4646
</table>
@@ -68,7 +68,7 @@
6868
* **创作者:** 画师、Live2D/3D建模师、配音演员、文案写手——你们赋予"她"灵魂。
6969
* **梦想家:** 你的反馈和传播也是宝贵的贡献。
7070

71-
**QQ群**[1022939659](https://qm.qq.com/q/HxeaMdSkQW) | **Discord**[加入我们](https://discord.gg/5kgHfepNJr)
71+
**QQ群**995414391 | **Discord**[加入我们](https://discord.gg/5kgHfepNJr)
7272

7373
## 快速开始
7474

@@ -466,7 +466,7 @@ uv run python agent_server.py
466466
# 5. 访问 http://localhost:48911 配置 API Key 并开始使用
467467
```
468468

469-
开发者建议加入企鹅群 1022939659 交流。
469+
开发者建议加入企鹅群 995414391 交流。
470470

471471
</details>
472472

@@ -478,7 +478,7 @@ uv run python agent_server.py
478478

479479
当你想要通过配置自己的API来获得额外功能时,您可以配置第三方AI服务。
480480

481-
- **核心 API**(实时语音对话):必须支持 Realtime API。推荐使用 *阶跃星辰**阿里云*
481+
- **核心 API**(实时语音对话):必须支持 Realtime API。推荐使用 *阿里云*
482482
- **辅助 API**(记忆/情感/视觉等):支持标准 ChatCompletion 接口。支持 14+ 服务商。
483483

484484
通过访问`http://localhost:48911/api_key`可以在Web界面中直接配置。
@@ -532,7 +532,7 @@ N.E.K.O/
532532
│ ├── omni_offline_client.py # 文本API客户端(ChatCompletion)
533533
│ └── tts_client.py # 🔊 TTS引擎适配器
534534
├── 📁 main_routers/ # 🌐 API路由模块(14个路由)
535-
├── 📁 memory/ # 🧠 三层记忆系统
535+
├── 📁 memory/ # 🧠 五维记忆系统(部分示例)
536536
│ ├── facts/ # 事实记忆
537537
│ ├── reflection/ # 反思记忆
538538
│ └── persona/ # 人格记忆

docs/README_en.md

Lines changed: 13 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[中文](https://github.com/Project-N-E-K-O/N.E.K.O/blob/main/README.MD) | [日本語](README_ja.md) | [Русский](README_ru.md)
66

7-
# Project N.E.K.O. :kissing_cat: <br>**A proactive, native omni-modal AI companion featuring 24/7 ambient awareness, agent capability and an embodied emotional engine.**
7+
# Project N.E.K.O. :kissing_cat: <br>**A proactive AI companion — listening to your feelings, seeing your world, and discovering more to love with you.**
88

99
> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism
1010
>
@@ -14,42 +14,34 @@
1414
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/Project-N-E-K-O/N.E.K.O/blob/main/LICENSE)
1515
[![Commit](https://img.shields.io/github/last-commit/wehos/N.E.K.O?color=green)](https://github.com/Project-N-E-K-O/N.E.K.O/commits)
1616
[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/5kgHfepNJr)
17-
[![QQ Group](https://custom-icon-badges.demolab.com/badge/QQ群-1022939659-00BFFF?style=flat&logo=tencent-qq)](https://qm.qq.com/q/hN82yFONJQ)
17+
![QQ Group](https://custom-icon-badges.demolab.com/badge/QQ群-995414391-00BFFF?style=flat&logo=tencent-qq)
1818
[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/)
1919

2020
[![Docs](https://img.shields.io/badge/📖_Developer_Docs-project--neko.online-40C5F1?style=for-the-badge)](https://project-neko.online)
2121

22-
**:older_woman: Zero-configuration, ready-to-use cyber catgirl that even my grandma can master!**
22+
**:older_woman: Zero-configuration and ready to use — a cyber catgirl even my grandma can wake up with ease!**
2323

24-
:newspaper: **[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/) version has been released! Complete UI overhaul and added out-of-the-box exclusive free model (thanks to StepFun for sponsoring this project). Add it to your wishlist now~**
24+
:newspaper: **The [Steam version](https://store.steampowered.com/app/4099310/__NEKO/) is available for free! If you like her, add her to your library and leave a kind review~**
2525

2626
*Project N.E.K.O., NekoVerse!*
2727

2828
</div>
2929

30-
<div align="center">
31-
32-
#### Feature Demo (Full version on Bilibili) [![Bilibili](https://img.shields.io/badge/Bilibili-Tutorial-blue)](https://www.bilibili.com/video/BV1mM32zXE46/)
33-
34-
https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
35-
36-
</div>
37-
3830
---
3931

4032
## Core Features
4133

4234
<table>
4335
<tr>
44-
<td align="center" width="25%">🎙️<br><b>Omni-Modal Dialogue</b><br>Real-time voice (Realtime API) + text chat (ChatCompletion) with visual understanding</td>
45-
<td align="center" width="25%">🧠<br><b>Three-Tier Memory</b><br>Facts / Reflection / Persona — she truly "remembers" you</td>
46-
<td align="center" width="25%">🤖<br><b>Agent Capabilities</b><br>Browser control (CUA), computer use, OpenClaw A2A calling — she can get work done for you</td>
36+
<td align="center" width="25%">💬<br><b>Proactive Companion</b><br>Screen understanding, social trends, personal updates, music and memes — she starts conversations and shares fresh things you love</td>
37+
<td align="center" width="25%">🎙️<br><b>Real-Time Voice, Text & Vision</b><br>Real-time voice (Realtime API) + text chat (ChatCompletion) with live visual understanding</td>
38+
<td align="center" width="25%">🧠<br><b>Five-Dimensional Memory</b><br>Working / Recent / Facts / Reflection / Persona memory, so she understands you better over time</td>
4739
<td align="center" width="25%">🎭<br><b>Multi-Form Avatar</b><br>Live2D / VRM / MMD with motion capture and full-screen tracking support</td>
4840
</tr>
4941
<tr>
50-
<td align="center">🔌<br><b>Plugin Ecosystem</b><br>Full plugin SDK & marketplace for custom extensions</td>
42+
<td align="center">🤖<br><b>Agent Tool Execution</b><br>Controls browsers and computers, calling CUA / OpenClaw A2A / plugins to complete tasks</td>
43+
<td align="center">🔌<br><b>Plugin Ecosystem</b><br>SDK + plugin marketplace for online game companionship, social media interaction, livestream interaction, and smart home integrations</td>
5144
<td align="center">🌐<br><b>14+ AI Providers</b><br>OpenAI / Gemini / Qwen / DeepSeek and more, with free models out of the box</td>
52-
<td align="center">💬<br><b>Proactive Chat</b><br>24/7 ambient awareness: screen understanding, social media trends, personal feeds, music & memes — she initiates conversations with you</td>
5345
<td align="center">🏪<br><b>UGC Workshop</b><br>Upload and share custom characters, models, and voice packs via Steam Workshop</td>
5446
</tr>
5547
</table>
@@ -77,7 +69,7 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
7769
* **Creators:** Artists, Live2D/3D modelers, voice actors, writers — you give "her" a soul.
7870
* **Dreamers:** Your feedback and advocacy are invaluable contributions.
7971

80-
**Discord**: [Join Us](https://discord.gg/5kgHfepNJr) | **QQ Group**: [1022939659](https://qm.qq.com/q/HxeaMdSkQW)
72+
**Discord**: [Join Us](https://discord.gg/5kgHfepNJr) | **QQ Group**: 995414391
8173

8274
## Quick Start
8375

@@ -417,7 +409,7 @@ uv run python agent_server.py
417409
# 5. Visit http://localhost:48911 to configure API Key and start using
418410
```
419411

420-
Developers are encouraged to join QQ group 1022939659.
412+
Developers are encouraged to join QQ group 995414391.
421413

422414
</details>
423415

@@ -429,7 +421,7 @@ Developers are encouraged to join QQ group 1022939659.
429421

430422
Configure third-party AI services for additional features:
431423

432-
- **Core API** (real-time voice conversation): Must support Realtime API. Recommended: *Gemini*, *OpenAI*, *StepFun* or *Alibaba Cloud*.
424+
- **Core API** (real-time voice conversation): Must support Realtime API. Recommended: *Alibaba Cloud*.
433425
- **Assist API** (memory/emotion/vision): Supports standard ChatCompletion interface. 14+ providers available.
434426

435427
Visit `http://localhost:48911/api_key` to configure directly through the Web interface.
@@ -483,7 +475,7 @@ N.E.K.O/
483475
│ ├── omni_offline_client.py # Text API client (ChatCompletion)
484476
│ └── tts_client.py # 🔊 TTS engine adapter
485477
├── 📁 main_routers/ # 🌐 API routers (14 routes)
486-
├── 📁 memory/ # 🧠 Three-tier memory system
478+
├── 📁 memory/ # 🧠 Five-dimensional memory system (partial examples)
487479
│ ├── facts/ # Fact memory
488480
│ ├── reflection/ # Reflection memory
489481
│ └── persona/ # Persona memory

docs/README_ja.md

Lines changed: 13 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[中文](https://github.com/Project-N-E-K-O/N.E.K.O/blob/main/README.MD) | [English](README_en.md) | [Русский](README_ru.md)
66

7-
# Project N.E.K.O. :kissing_cat: <br>**プロアクティブでネイティブなオムニモーダルAIコンパニオン——24/7環境認識、エージェント能力、そして具現化された感情エンジンを搭載**
7+
# Project N.E.K.O. :kissing_cat: <br>**プロアクティブAIパートナー——あなたの気持ちに耳を傾け、あなたの世界を見つめ、もっと「好き」を一緒に見つけます**
88

99
> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism(ネットワーク型感情知性生命体)
1010
>
@@ -14,42 +14,34 @@
1414
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/Project-N-E-K-O/N.E.K.O/blob/main/LICENSE)
1515
[![Commit](https://img.shields.io/github/last-commit/wehos/N.E.K.O?color=green)](https://github.com/Project-N-E-K-O/N.E.K.O/commits)
1616
[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/5kgHfepNJr)
17-
[![QQグループ](https://custom-icon-badges.demolab.com/badge/QQ群-1022939659-00BFFF?style=flat&logo=tencent-qq)](https://qm.qq.com/q/hN82yFONJQ)
17+
![QQグループ](https://custom-icon-badges.demolab.com/badge/QQ群-995414391-00BFFF?style=flat&logo=tencent-qq)
1818
[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/)
1919

2020
[![Docs](https://img.shields.io/badge/📖_開発者ドキュメント-project--neko.online-40C5F1?style=for-the-badge)](https://project-neko.online)
2121

22-
**:older_woman: ゼロコンフィグで即座に使える、おばあちゃんでも使いこなせるサイバー猫娘**
22+
**:older_woman: ゼロコンフィグですぐ使える、おばあちゃんでも気軽に目覚めさせられるサイバー猫娘**
2323

24-
:newspaper: **[![Steam](https://img.shields.io/badge/Steam-%23000000.svg?logo=steam&logoColor=white)](https://store.steampowered.com/app/4099310/__NEKO/)版がリリースされました!UI完全刷新、専用無料モデルを標準搭載(StepFunの提供に感謝)。今すぐウィッシュリストに追加してください~**
24+
:newspaper: **[Steam版](https://store.steampowered.com/app/4099310/__NEKO/)は無料で配信中!気に入ったらライブラリに追加して、よければレビューもお願いします~**
2525

2626
*Project N.E.K.O.、ニャー宇宙!*
2727

2828
</div>
2929

30-
<div align="center">
31-
32-
#### 機能デモ(完全版はBilibiliで) [![Bilibili](https://img.shields.io/badge/Bilibili-チュートリアル-blue)](https://www.bilibili.com/video/BV1mM32zXE46/)
33-
34-
https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
35-
36-
</div>
37-
3830
---
3931

4032
## コア機能
4133

4234
<table>
4335
<tr>
44-
<td align="center" width="25%">🎙️<br><b>オムニモーダル対話</b><br>リアルタイム音声 (Realtime API) + テキストチャット (ChatCompletion)、視覚理解対応</td>
45-
<td align="center" width="25%">🧠<br><b>三層記憶システム</b><br>事実記憶 / 反省記憶 / 人格記憶——彼女は本当にあなたを「覚えて」います</td>
46-
<td align="center" width="25%">🤖<br><b>エージェント能力</b><br>ブラウザ操作 (CUA)、PC操作、OpenClaw A2A呼び出し——彼女があなたの仕事を手伝います</td>
36+
<td align="center" width="25%">💬<br><b>プロアクティブな伴走</b><br>画面理解、SNSトレンド、個人フィード、音楽やミームから話題を見つけ、彼女から話しかけ、あなたの好きな新しい話題を届けます</td>
37+
<td align="center" width="25%">🎙️<br><b>リアルタイム音声・テキスト・視覚理解</b><br>リアルタイム音声 (Realtime API) + テキストチャット (ChatCompletion)、リアルタイム視覚理解に対応</td>
38+
<td align="center" width="25%">🧠<br><b>五次元メモリシステム</b><br>作業記憶 / 直近記憶 / 事実記憶 / 反省記憶 / 人格記憶で、使うほどあなたを理解していきます</td>
4739
<td align="center" width="25%">🎭<br><b>マルチフォームAvatar</b><br>Live2D / VRM / MMD の3形態、モーションキャプチャとフルスクリーン追跡対応</td>
4840
</tr>
4941
<tr>
50-
<td align="center">🔌<br><b>プラグインエコシステム</b><br>完全なプラグインSDKとマーケットプレイスでカスタム拡張が可能</td>
42+
<td align="center">🤖<br><b>エージェントツール実行</b><br>ブラウザやPCを操作し、CUA / OpenClaw A2A / プラグインを呼び出してタスクを実行</td>
43+
<td align="center">🔌<br><b>プラグインエコシステム</b><br>SDK + プラグインマーケットプレイスで、オンラインゲームで一緒に遊ぶ機能、SNS連携、配信連動、スマートホーム連携まで拡張可能</td>
5144
<td align="center">🌐<br><b>14以上のAIプロバイダー</b><br>OpenAI / Gemini / Qwen / DeepSeek等、無料モデルも即座に利用可能</td>
52-
<td align="center">💬<br><b>プロアクティブチャット</b><br>24/7環境認識:画面理解、SNSトレンド、個人フィード、音楽やミーム——彼女から話しかけてきます</td>
5345
<td align="center">🏪<br><b>UGCワークショップ</b><br>Steam Workshop経由でカスタムキャラクター、モデル、ボイスパックをアップロード・共有</td>
5446
</tr>
5547
</table>
@@ -77,7 +69,7 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
7769
* **クリエイター:** アーティスト、Live2D/3Dモデラー、声優、ライター——「彼女」に魂を与えます。
7870
* **ドリーマー:** あなたのフィードバックと支持は貴重な貢献です。
7971

80-
**Discord**[参加する](https://discord.gg/5kgHfepNJr) | **QQグループ**[1022939659](https://qm.qq.com/q/HxeaMdSkQW)
72+
**Discord**[参加する](https://discord.gg/5kgHfepNJr) | **QQグループ**995414391
8173

8274
## クイックスタート
8375

@@ -409,7 +401,7 @@ uv run python agent_server.py
409401
# 5. http://localhost:48911 にアクセスしてAPI Keyを設定し、使用開始
410402
```
411403

412-
開発者はQQグループ 1022939659 への参加をお勧めします。
404+
開発者はQQグループ 995414391 への参加をお勧めします。
413405

414406
</details>
415407

@@ -421,7 +413,7 @@ uv run python agent_server.py
421413

422414
追加機能のためにサードパーティAIサービスを設定できます:
423415

424-
- **コアAPI**(リアルタイム音声会話):Realtime APIに対応している必要があります。推奨:*Gemini**OpenAI**StepFun*、または*Alibaba Cloud*
416+
- **コアAPI**(リアルタイム音声会話):Realtime APIに対応している必要があります。推奨:*Alibaba Cloud*
425417
- **アシストAPI**(記憶/感情/視覚等):標準ChatCompletionインターフェースに対応。14以上のプロバイダーが利用可能。
426418

427419
`http://localhost:48911/api_key`にアクセスして、Web画面から直接設定できます。
@@ -475,7 +467,7 @@ N.E.K.O/
475467
│ ├── omni_offline_client.py # テキストAPIクライアント(ChatCompletion)
476468
│ └── tts_client.py # 🔊 TTSエンジンアダプター
477469
├── 📁 main_routers/ # 🌐 APIルーター(14ルート)
478-
├── 📁 memory/ # 🧠 三層記憶システム
470+
├── 📁 memory/ # 🧠 五次元メモリシステム(一部例)
479471
│ ├── facts/ # 事実記憶
480472
│ ├── reflection/ # 反省記憶
481473
│ └── persona/ # 人格記憶

0 commit comments

Comments
 (0)