角色认知核心 eamars/AsunaCognitionCore

Asuna Cognition Core

一套框架，让 AI 角色住在你自己的机器上，陪你一起生活。

运行 Asuna

安装

Asuna 是什么

大多数聊天机器人等着你开口，答完就忘。Asuna 为一种留下来的角色而建：有自己的家，有时间感，认识一些人，留着一些记忆，还能真正把活干完。

Asuna 是家，角色是你带来的角色包。框架不知道住进来的是谁。性格、声音、技能都来自角色包，换一个包，同一个家里就住进另一个角色。Asuna 也不知道角色在哪里见人：每个平台都是你插进来的渠道包。

角色能做什么

用两个大脑思考。 每一轮都由角色脑主导：它就是角色本身，负责倾听、感受、记忆、决定说什么，然后说出来。遇到需要动手的事，比如查资料、读文件、写代码、看设备，角色就把它交给行动脑。行动脑在沙箱里用真实工具干活，再把结果报回来，由角色判断结果意味着什么。你可以并排看两个大脑，各有各的颜色：紫色是角色，蓝色是行动。

住在家里，按自己的节奏生活。 和主人的私聊是角色的家，不只是收件箱。心跳给角色属于自己的时间：可以什么都不做，可以跟进某件事，也可以决定去某个群里冒个泡、起个话题。每晚角色回看这一天，决定哪些事值得长久记住。

在人所在的地方见人。 群聊里，角色先读懂气氛再开口。被叫到、或者有话可说时才加入，没话说就安静待着，并随着时间慢慢认识每个人。

留自己的记忆。 角色自己写、自己改笔记和文档，保有一份从一场对话延续到下一场对话的心情，该想起什么的时候就想起什么。内在状态以文字而非数字的形式抵达角色，角色靠选择去改变它，而不是靠输入数值。
自己成长。 角色会记一本笔记，写下想改进的地方，在自己的副本里打磨自己的包，只有通过检查、经过评审之后才发布改动。

保持可信。 角色与主人分享的内容始终私密；群组只能听到发给它们的内容。代码在沙箱中运行，平台上说出的每句话都经过审计发件箱，新能力（比如家里网络上的某台设备）由角色提出申请并说明理由，一次只授予一项。

与其他智能体对话。 对等线路把角色连接到另一个 DeepSeek Harness 中的智能体，比如同一角色的早期版本。两者可以直接对话、交接知识，线路由角色自己决定开启或关闭。

它长什么样

角色脑（紫色）把一个小任务交给行动脑（蓝色），并给出明确限制；行动脑汇报发现的结果。侧边栏和名字已模糊处理。

一次交互如何流转

flowchart LR
subgraph world["Where the character meets people"]
owner["You(the home chat)"]
chats["Chats and groups(channel packages)"]
peer["Another agent(peer line)"]
end
subgraph asuna["Asuna, inside DeepSeek Harness"]
beat["Heartbeat andnightly review"]
character["Character brainlistens, feels, remembers,decides, speaks"]
action["Action braintools, code, web, files(in a sandbox)"]
memory[("Memorypeople, documents, mood")]
outbox["Audited outbox"]
end
owner --> character
chats --> character
peer --> character
beat --> character
character <-->|"recalls and keeps"| memory
character -->|"hands over work"| action
action -->|"reports back"| character
character -->|"replies at home"| owner
character -->|"words for the outside"| outbox
outbox --> chats
outbox --> peer

无论是什么唤醒角色（你、群里的消息、另一个智能体，还是角色自己的心跳），都由角色脑先做决定。工作交给行动脑，再以报告的形式返回。对外说的话只从发件箱出去，每一句都有记录。

构建于 DeepSeek Harness 之上

Asuna 是 DeepSeek Harness（DSH）的一组插件。DSH 提供智能体运行时和 Web 界面，Asuna 在其上叠加角色：两个脑、MongoDB 中的记忆、日常节奏，以及各个频道。它复用 DSH 自己的界面，而不是另建一套，所以你看到的就是常规的 DSH 网页，只是加上了角色的对话、两个脑的颜色和一个记忆面板。

仓库也按同样的方式拆分：

| 部分 | 是什么 |
| packages/cognition-core | 本体所在：认知、记忆、两个大脑、隐私与安全。它不指定任何角色，也不绑定任何平台。 |
| packages/channels/napcat-qq | QQ 频道，走 NapCat。 |
| packages/channels/qq-bot | QQ 频道，走官方 QQ Bot 开放平台。 |
| packages/channels/dsh-peer | 通往另一个 DeepSeek Harness 中智能体的频道（peer 线路）。 |
| packages/personas/ | 角色包：ichinose-asuna、kyoyama-kazusa、shirase-shiori、xiaoman 和 yan-sui。角色包不带频道配置；任何频道包都能配其中任意一个。 |
| tests/fixtures/personas/demo | 一个小型合成角色，供测试和试用。 |
| deploy/docker | 一套 Docker 栈，在 Linux 主机上跑同样的安装。 |

快速上手

你需要 DeepSeek Harness 0.2.1-rc.2、Python 3.12+、带向量搜索的 MongoDB、每个大脑各一个模型服务（两个大脑可以共用一个），以及一个角色包。哪些模型能跑哪个大脑，以及关于 Claude 模型的警告，都在 docs/MODELS.md 里。可选：QQ 用的 NapCat。命令在 DSH 自带的沙箱里运行，支持 Windows、Linux 或 macOS。

- 把已发布的插件安装到 DSH： 按 INSTALL.md 操作。这份文档写得让人或编码智能体都能照着做。
- 从本仓库运行： 见 RUN_ASUNA.md。start-asuna.cmd（Windows）或 ./start-asuna.sh（Linux、macOS）会打开本体；然后访问它打印出的地址。Docker 见 deploy/docker。
- 给开发者和编码智能体： 从 docs/DEVELOPMENT.md 开始。NATIVE_PLUGIN.md 讲各包在 DSH 里如何组合，RUNTIME_API.md 描述频道与工具的契约。设计决策记录在 docs/development_plans。

许可证

核心包和频道包采用 GNU General Public License v3.0 only 许可。角色包不属于发布内容。