stas130286-blip/dsh-brainagent

🧠 面向 DeepSeek Harness 的 BrainAgent

BrainAgent

release topic license

作为插件的认知架构：为你的 dsh 代理提供记忆、情感、动机、学习与自主性。

英文版见下方

这是什么

BrainAgent 是 DeepSeek Harness (dsh) 的一个插件，它把标准代理从一次性任务的执行者转变为长期存在的个人助理，并配备了一套按照大脑工作原理建模的内部认知系统。

约 60 个模块、6 个与平台的集成点、918 个单元测试，全部运行在 dsh 的标准钩子之上，没有任何例外：目标轮次的反垃圾节奏控制内置于插件本身，无需修补宿主。安装只需一条命令，无需构建，也无需脚本权限。

功能

💾 记忆
- 情景记忆——带有情感和重要性的对话事件
- 语义记忆——带有修订历史的稳定事实
- 程序性记忆——习得的行动脚本（“如何回应 / 如何做事”）
- 回忆时强化（赫布规则），不相关内容衰减
- 本地磁盘存储——你的数据不会离开你的机器

🎭 情感与共情
- 杏仁核对话语的情感色彩进行分类
- 镜像神经元构建对话者的模型（情绪、风格、专业水平）
- 情感记忆保存鲜明时刻（“闪光灯记忆”）

📚 学习
- 每一轮对话都以一个学习循环结束
- 多巴胺系统强化成功的策略
- 基底神经节形成带有成功率评估的习惯

⚡ 自主性
- 四种驱动力：社交、认知、创造、精通
- Vital Impulse——当有内容可说时（目标、洞察、愿望），代理会主动给你发消息
- Goal Stack 管理长期目标，Curiosity Drive 发现知识空白
- DMN“在后台思考”，Autonomous Research 自行搜索信息
- 内置保险机制：主动消息之间至少间隔 10 分钟，循环断路器

🌙 自我调节
- 昼夜节律与 Dream Mode——夜间代理“睡眠”并巩固记忆
- Attention Gate 按相关性过滤上下文（节省 token）
- Token Economy 与丘脑门控让简单消息无需昂贵的 LLM 调用即可通过
- Metabolic Budget 监控模块的资源消耗

🪞 人格
- Agent Identity：自传体记忆、经验教训、能力画像
- Qualia Simulator：当前的主观状态
- Temporal Binding：时间连续性的感受

安装

方案 1：作为 dsh 包（推荐）

一条命令——插件会直接从 GitHub 下载：

markdown
npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent

然后启动 Web UI：
sh
npx @deepseek-ai/dsh web

该包包含已构建好的模块（lib/index.js），并且不包含 install 脚本。

⚠️ 关于 pnpm ≥ 10：根据 pnpm 的安全策略，默认会阻止任何 git 包，因此你可能会看到 ERR_PNPM_IGNORED_BUILDS，而不是干净地完成。这是 pnpm 对所有 dsh git 插件通用的策略（参见讨论 #2230），并非安装错误：插件文件已经部署完成，npx @deepseek-ai/dsh web 可以正常工作。

若要让安装过程无警告地完成，请将错误文本中的准确键复制到 ~/.dsh/profiles/web/pnpm-workspace.yaml，然后重新执行命令：

yaml
allowBuilds:
dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/: true

该授权是安全的：此包没有脚本，因此该授权不会让它执行任何操作。

方案 2：从本地副本安装（用于开发）
sh
git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent
npx @deepseek-ai/dsh web

或者通过 overlay 接入源码（使用 --patch 启动）：
yaml
- insert:
- id: brainagent
name: file:///绝对/路径/到/dsh-brainagent/src/index.ts
config: {}

使用

与智能体对话——BrainAgent 会自动启用。聊天中可使用以下命令：

| 命令 | 作用 |
|---|---|
| /brain status | 所有系统状态的完整报告 |
| /brain memory  | 搜索记忆 |
| /brain goals | 当前目标 |
| /brain neuro | 神经调质（多巴胺等） |
| /brain habits | 已习得的习惯 |
| /brain learning | 学习循环与洞察 |
| /brain circadian | 昼夜节律与睡眠 |
| /brain dream | 触发记忆巩固 |

……以及其他命令：predict、pathways、personality、metabolic、emergent。

所有模块都通过 Config 模式配置（39 个标志）——任何组件都可以禁用：
yaml
- id: brainagent
name: dsh-brainagent
config:
autonomousMinGapMs: 1800000   # 主动消息之间的间隔（30 分钟）
modules:
actionDispatcher: false     # 例如，禁用自主性

测试
sh
pnpm install        # 从 dsh monorepo 根目录
pnpm vitest run     # 64 个文件，918 个测试

在 monorepo 之外独立运行：
sh
npm install --legacy-peer-deps   # peer 依赖由 dsh 宿主提供，而 wildcard 依赖
会拉取不一致的 rc 版本——因此采用宽松安装
npm test                         # vitest：64 个文件，918 个测试
npm run typecheck                # tsc --noEmit
npm run build                    # esbuild → lib/index.js

除了模块的单元测试外，还有集成 eval 测试框架（src/eval/）：
插件完全运行在模拟的 dsh 上下文上（隔离的
dataDir、诚实的 effect 清理），并运行 golden 场景——
通过完整流水线的“实时”对话、基于真实总线事件的 reward-ledger →
strategy-bandit 学习循环、自主性（投递、
工具门控、loop-breaker），以及 recall 回归“在这种
记忆状态下 recall 返回这个”。这是为未来
重构提供的保险：流水线行为的变化会立刻显现。
第一个发现（v0.5.1）：主动投递的框架
未被识别为自主循环——检测已统一并修复。

架构

处理后的 dsh message 经过流水线：

Thalamus (分类) → Amygdala (情绪) → Hippocampus (记忆提取)
→ Prefrontal Cortex (决策, fast/slow path) → 上下文注入 (pre-step)
→ Cerebellum (响应后质量评估) → 学习循环

所有模块通过内部 event bus
(Corpus Callosum) 交换类型化信号，自主定时器通过 ctx.effect 工作。

插件代码按层拆分：src/index.ts——仅负责组合（模块初始化、
dsh 钩子、cleanup），所有逻辑都在 src/plugin/ 中（config.ts——配置的 schema 与
merge，autonomy.ts——主动投递与意图解析器，
cycles.ts——循环生命周期，context.ts——为 agent/pre-step 组装上下文）。

实际上底层是什么

诚实地说，不用隐喻。BrainAgent 是启发式过滤器流水线 +
统计存储 + 上下文注入：

1. 过滤器和分类器——每个模块按自己的启发式规则判断
传入消息中什么是重要的：领域、情绪、优先级、意图。
2. 统计存储——.brainagent/ 中的 JSON 文件：情景
记忆和语义记忆、习惯、预测、知识空白、奖励
日志。插件内部没有神经网络和可训练权重。
3. 上下文注入——在调用模型之前，模块会组装紧凑的
文本块（“回忆起了”、“习惯”、“预测”）并将它们添加到
消息中。真正的“认知性”发生在主 LLM 中，而不是插件中。

模块名称（海马体、多巴胺、DMN……）——是为了可读性而使用的隐喻：
它们描述模块在流水线中的角色，而不是实现机制。这不是
大脑模拟，插件也不承诺这一点。

唯一带策略的显式学习循环——learningLoop：
奖励日志（reward-ledger）将所有来源的评分汇总到统一的
日志中，而多臂老虎机（strategy-bandit，UCB1）根据累积奖励
决定提供哪些上下文块。策略存储在表格中，
而不是权重中——无需 GPU 的强化学习。各个模块
（基底神经节、预测引擎、镜像神经元）也会
进行统计自适应——但没有显式的选择策略。

要求

- 支持 Cordis 插件的 DeepSeek Harness (dsh)
- Node.js 22+

许可证

BrainAgent Noncommercial License——所有人均可自由用于非商业用途；
商业使用需与作者达成协议。详见 LICENSE。

英语

BrainAgent 是 DeepSeek Harness (dsh) 的一个插件，它将原生 agent 转变为一个具有类脑认知系统的长期个人助手。

约 60 个模块，6 个平台集成点，918 个单元测试，完全运行在原生 dsh 钩子上——零核心改动。

亮点

- 记忆——情景记忆、语义记忆和程序性记忆；赫布式强化、衰减、仅本地存储
- 情绪与共情——杏仁核分类、镜像神经元用户建模、闪光灯记忆
- 学习——每轮学习循环、多巴胺强化、习惯养成
- 自主性——四种驱动力、主动消息（生命冲动）及防循环保护、目标栈、好奇心、后台 DMN 洞察
- 自我调节——昼夜节律、梦境模式整合、注意力门控 token 预算、Token 经济
- 人格——Agent 身份、感质模拟器、时间绑定

安装——一条命令，直接从 GitHub 获取：

npx @deepseek-ai/dsh plugin --profile web add github:stas130286-blip/dsh-brainagent
npx @deepseek-ai/dsh web

或从本地克隆安装：

git clone https://github.com/stas130286-blip/dsh-brainagent.git
npx @deepseek-ai/dsh plugin --profile web add ./dsh-brainagent

附带预构建包（lib/index.js），且不包含任何安装脚本。

⚠️ 关于 pnpm ≥ 10：pnpm 的安全策略默认会阻止任何托管在 git 上的包，因此你可能会看到 ERR_PNPM_IGNORED_BUILDS，而不是干净退出。这是 pnpm 对所有通过 git 安装的 dsh 插件通用的策略（参见讨论 #2230），并非安装失败——插件文件已经就位，npx @deepseek-ai/dsh web 可以正常工作。

若要无警告安装，请将错误消息中的确切键复制到 ~/.dsh/profiles/web/pnpm-workspace.yaml，然后重新运行命令：

allowBuilds:
dsh-brainagent@https://codeload.github.com/stas130286-blip/dsh-brainagent/tar.gz/: true

批准是安全的：该包没有任何脚本会用到此权限。

命令：/brain status、/brain memory 、/brain goals、/brain neuro、/brain habits、/brain learning、/brain circadian、/brain dream 等

测试：pnpm vitest run——64 个文件，918 个测试

许可证：BrainAgent 非商业许可证——所有人均可免费非商业使用；商业使用需与作者达成协议。详见 LICENSE。