Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

brain4agent

/brain4agent

Przechowuje i odczytuje długoterminową pamięć roboczą agenta: kontekst projektu, decyzje i błędy, w jednym pliku SQLite.

Repozytorium
Brain4Agent ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Przechowuje i odczytuje długoterminową pamięć roboczą agenta: kontekst projektu, decyzje i błędy, w jednym pliku SQLite.

Oryginalny opis (EN)

存取 agent 的长期工作记忆——项目上下文、决策、踩过的坑。用户问「之前/上次/记得/为什么这么定」类问题,或要求记住某个结论时使用。中文优先、零模型、单文件 SQLite。不用于通用知识问答,不联网检索。

Jak działa

  1. 何时用
  2. 先确认可用
  3. 命令
  4. 读结果:corpusmissing 比分数重要
  5. 它的边界(实测过,别指望更多)
  6. 供 agent 直接调用(MCP)
  7. 回答用户时
Sekcje z nagłówków SKILL.md, w oryginale · 111 linii, 254 słów
Podgląd SKILL.md
---
name: brain4agent
description: 存取 agent 的长期工作记忆——项目上下文、决策、踩过的坑。用户问「之前/上次/记得/为什么这么定」类问题,或要求记住某个结论时使用。中文优先、零模型、单文件 SQLite。不用于通用知识问答,不联网检索。
---

# Brain4Agent 长期记忆

一个本地记忆库:把对话轮次存进单个 SQLite 文件,按会话检索。检索走 BM25,
核心路径**不调用任何模型**,因此没有 API key、没有冷启动、单次查询毫秒级。

## 何时用

- 用户问「之前那个 bug」「上次说的部署目录是什么」——**先查记忆再回答**。
- **动手改一个文件、或开始一个新任务之前**——先查一次这个目录/模块的历史,
  很多「为什么这么写」的答案在里面,而用户不会主动问。
- 用户说「记住这个」「记一下」——存进去。
- 用户问「为什么当初这么决定」——查记忆里的决策记录。

**不要**用它存通用知识、网页内容、或者用户没提过的东西。它只记这台机器上
发生过的事。

## 先确认可用

```sh
python -c "import brain4agent; print(brain4agent.__version__)"
```

导入失败说明没装。从仓库根目录装:

```sh
pip install -e ".[precise]"
```

`precise` extra 会带上 jieba 词典,检索 hit@1 从 0.825 提到 0.925。
不装也能用,只是精度低一些。

## 命令

数据库路径由 `BRAIN4AGENT_DB` 或 `--db` 指定;**同一次任务里要保持一致**,
用同一个文件。

```sh
# 存一问一答(存成一个会话)
brain4agent --db <db> exchange "用户问的" "assistant 答的"

# 存单条
brain4agent --db <db> add "内容" --session <id> --role user

# 检索(-k 返回几个会话)
brain4agent --db <db> search "查询" -k 3

# 主动回忆:读 stdin 的提示词,输出可直接注入上下文的相关记忆
# 没有相关内容时**什么都不输出**——这是常态,不要把它当失败
brain4agent --db <db> recall-context -k 3 < prompt.txt

# 统计 / 列出会话 / 删会话 / 只留最近 N 个
brain4agent --db <db> stats
brain4agent --db <db> sessions
brain4agent --db <db> forget <session_id>
brain4agent --db <db> prune --keep 100

# 批量导入 JSONL(每行一个对象,content 必填)
brain4agent --db <db> import conversations.jsonl
```

`python -m brain4agent ...` 与上面的 `brain4agent ...` 等价。

## 读结果:`corpus_missing` 比分数重要

`search` 输出里的两个缺失信号含义不同,**不要混用**:

- **`corpus has no:`** —— 问题里的词,整份语料都没有。这是**事实**,
  不是猜测。看到它基本可以判断「没记过这件事」。
- **`this session lacks:`** —— 这条会话没有这个词。只说明这条不匹配,
  **不代表**没记过。

```
1 sessions for '杭州测试机上装的是什么数据库'
  corpus has no: 数据库, 机上          <- 整个库里没有「数据库」这个词
  [ 4.81 cov=0.28] c060a5294037  session lacks: 数据库, 机上
```

`coverage` 是这条会话覆盖了问题多少内容,只用来排序,**不要**当置信度阈值。

## 它的边界(实测过,别指望更多)

- **同主题、不同事实的会话无法区分。** 库里如果有三段「根因在 X 文件」的对话,
  问「根因在哪」,它分不清你指哪个。这类问题要靠上下文说明具体是哪次,
  比如「keywords.py 那次」。
- **答案里没有具体值的题,检索帮不上忙。** 问「当时怎么处理的」,答案是
  「改了一行」这种,词面上区分不出来。
- **所以:返回多个结果时,读前三个,不要只看第一个。**

这些限制的完整数据在仓库的 `docs/decisions.md`,D-020 与 D-021。

## 供 agent 直接调用(MCP)

不需要 CLI 时可以配成 MCP server,工具名为 `b4a_remember` / `b4a_recall` /
`b4a_session` / `b4a_stats`:

```json
{"mcpServers": {"brain4agent": {
    "command": "python",
    "args": ["-m", "brain4agent.mcp_server"],
    "env": {"BRAIN4AGENT_DB": "/path/to/brain.db"}
}}}
```

`b4a_` 前缀是刻意的:`remember`、`recall` 这类名字会和别的记忆服务撞车。

## 回答用户时

查到东西就**引用具体内容**,别只说「我记得有这件事」。查到 `corpus has no`
就直说「没有记录过 X」,不要把「没找到」说成「没有」——这两者对用户是不同的。

Wersje

W bazie nie ma innych skilli o nazwie brain4agent.

Migawka bazy z 13.11.2026 · wersja paczki 8809c2a74c94 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95paxm
    Przechowuje i przywołuje pamięć agenta Codex, czyli wcześniejsze decyzje, kontekst projektu i preferencje użytkownika.
  • 100memory
    Przechowuje i przywołuje pamięć długoterminową: zapisuje fakty poznane w rozmowach oraz wiedzę o projektach i preferencjach.
  • 100xwiki
    Odczytuje i uzupełnia wiki projektu weryfikacji chipów: środowisko, interfejsy, sekwencje, pokrycie i punkty wejścia do debugowania.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.