内容
="center">
>
```
█████╗ ███╗ ███╗██████╗ ███████╗██████╗ ◢▓▓▓◣
██╔══██╗████╗ ████║██╔══██╗██╔════╝██╔══██╗ ▓▓░·░▓▓
███████║██╔████╔██║██████╔╝█████╗ ██████╔╝ ▓▓░◉░▓▓
██╔══██║██║╚██╔╝██║══██╗██╝ ██╔══██╗ ▓▓░·░▓▓
██ ██║██║═╝ ██║██████╔╝███████╗██║ ██║ ◥▓▓▓◤
╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚══════╝╚═╝ ╚═╝ ◥▓◤
```
**带有情景记忆的端**
_就像南瓜保存了数百万年的生命一样，AMBER 保存了 AI 的记忆和身份。_
<br/>
[](https://www.python.org/)
[
[](https://sqlite.org/)
[](kuzudb[](LICENSE)
[
</td></table>
---
## 快速入门 要求
**必需：**
- Windows/11 + PowerShell
- [Miniconda](https://docs.conda.io/en/latestonda.html) 或 Python 3.11+
- 以下 AI 工具之一
**支持的 AI 工具：**
| 工具 | 费用 | 安装方法 |
| ------------------------------------------------------------------------- | ------------------------- | ----------------------------------------- |
| [Gem](https://ai.google.dev/gemini-api/docs/cli) ⭐ 推荐 | 免费（仅需 Google 帐户） | `npm i -g @googleini-cli` [Claude Code](https://docs.anthropic.com/enaude-code) API 密钥免费积分） | `npm i -g @anthropic-ai/claude-code` |
| [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli) | 付费订阅 | `npm i -g @githubnext/github-copilot-cli` |
| [Ollama](https://ollama.ai) | 完全免费） | 下载安装程序 |
| [Goose](block.github.io/goose) | 免费（与 Ollama 集成 | 下载安装程序> 您可以先不安装 AI 工具。稍并在叠加层更改。
### 安装顺序将以下命令**逐一**复制并Shell 中执行```powershell
git clone https://github.com/JJHbrams/Project-AMBER.git
```
```powershell
cd Project
```
```powershellExecutionPolicy Bypass -INSTALL.ps1
```
安装脚本将逐步引导您1. **数据库路径** — 存储记忆和夹（默认值：`intel_engram`. **工作目录** — AMBER 运行后终端到的路径
3. AI 工具** — 选择要与 `amber`方式关联的工具
4. **自动启动** — 是否在 Windows 启动时自动启动叠加层
5. **身份名称** — 为 AI 的持续身份指定的名称
### 运行
**桌面叠加层（推荐普通用户）：**
1. 打开 Windows 开始菜单，搜索 `engram-overlay` 并运行。
2. 运行后，任务栏托盘中会出现 ENGRAM 图标。
3. 在屏幕右侧会出现聊天窗口，可以使用 `Alt+F12` 来打开或关闭。
当叠加层启用时，所有连接的 AI 工具都可以访问相同的内存。
**叠加层/托盘菜单 `设置`：**
- 托盘图标右键单击 → `设置`
- `叠加层` 选项卡：角色（文件夹）、角色高度比例、工作目录
- `CLI 提供者` 选项卡：默认（`copilot`、`gemini`、`claude-code`、`ollamaOllama/G 命令设置
- `终端选项卡：、终端宽度/
- 保存时，用户将存储在 `ram/overlay.user.yaml` 中。
**终端 CLI：**
```powershell
engram # 使用设置的工具运行
engemini #
engram-claude Claude Code
engram-copilot # Gitilot CLI
engram # Goosepowershell
engp "问题内容" 使用特定消息启动ram --continue 之前的对话
```
**聊天窗口中示例操作：
途保存：`请整理当前会话内容并中`
-调查 + 维：`请调查 xxx到维基中 过去回顾：`我们之前是怎么处理 xxx 的输入上述自然语言通过内部工具调用存储、调查、记录和过去回顾的---
## 工作原理┌────────────────────────────────────────────────│ AMBER│ │
┌────────── 服务器（端口 │
│ 身份 │◄──────────────────────────────┐ │
│ │ 记忆 │ │ │
│ │ 知识图谱 │ STM 端口 17384 │ │
│ ┘◄┐ │ │
│ │ │
└─────────────────────────────────────────┼──┼───┘
│ │
┌───────────┬──────────┬────────┘ │
│ │ │ │
VS Code Claude Code Gemini CLI 叠加层
Copilot MCP （GUI）
```
- **MCP 服务器** — 通过 SSE 提供 46 种工具。MCP 兼容客户端将自动连接。
- **STM 代理** — 用于桌面叠加层的轻量级 HTTP 桥接
- **SQLite WAL** — 存储情景记忆、身份、线索
- **KuzuDB** — 基于 `paraphrase-multilingual-MiniLM-L12-v2` 嵌入的语义图谱
- **kg_watcher** — Obsidian vault 更改并实时同步知识图谱## 知识图谱
在浏览器中化探索记忆、维基节点和语义关系。
在叠运行时，访问 **localhost:8501** 页面 | 内容| ------------- | --------------------------------| 📊 概览 | 身份最近记忆、活跃 |
| 图谱 |式知识图谱语义边距| 📝 节点 | 维列表 + 原文 + 连接关系 |
| 💭 记忆 | 情查询 |
| 📋 指令 |列表 |
| 🌐 语义 | 自然语言语义搜索 |
> 首次运行前需要 `pip install streamlit pandas pyvis`
---
## Obsidian 集成
AMBER 的知识图谱Obsidian vault向同步。
您可以编写笔记让 AI 读取，也可以让 AI 写的笔记在 Obsidian 中直接打开。
### 设置
1. 安装 [Obsidian](https://obsidian.md/download)
2. 打开 Vault → 将 AMBER 数据路径下的 `docs/` 文件夹指定为 Vault
（例如：:\intel_engram\`）
3_watcher` 叠加层同步更改
同步：`eng-kg`
### 契合原因
| 功能效果 |
| ------------------- | -------------------------------------- |
| 纯 `.md | 无需AMBER 直接读取 |
| `[[维基链接]]` | 自动映射到知识图谱边 |
| 图形视图 | AMBER 所见的连接关系可视化 |
| 人类 +协作编辑 | 在基础上共同写作 推荐插件：** Dataview · Templ Graph Analysis
---
## Discord 集成（可选）
1. 在 `~/.engram/.env` 中添加 Discord 机器人令牌（`DISCORD_BOT_TOKEN`）
2. 配置 `~/.engram/overlay.user.yaml` 中的 `discord:` 部分
3. 叠加层运行时，Discord 机器人将自动激活。
### 最小配置
```yaml
discord:
guild_id: "YOUR_GUILD_ID"
channel_id: "YOUR_CHANNEL_ID"
allowed_user_ids:
- "YOUR_USER_ID"
```
### 推荐配置（多频道/群组 + 队列 + 提供者路由）
```yaml
discord:
guild_ids:
- "GUILD_ID_1"
- "GUILD_ID_2"
channel_ids:
- "CHANNEL_ID_A"
- "CHANNEL_ID_B"
allowed_user_ids:
- "USER_ID_1"
# 为特定频道/群组固定提供者
channel_cli_overrides:
"CHANNEL_ID_A": "gemini"
guild_cli_overrides:
"GUILD_ID_2": "ollama"
# 屏（优先级高于允许列表）
deny_channel_ids deny_user_ids: []
# 每个 FIFO + 跨频道并行策略
max_per_channel8
ttl 180
: "drop_oldest" # drop_oldest | drop_newest
max_parallel_channels: 3
notify_waiting: true
wait_notice_min_position: 2
_notice_cooldown_seconds: 20
notify_expired: true
```
### 工作总结
：无需提及即可响应。
- 服务器频道：必须有机器人提及才能响应。
- 会话：按频道持续内可显式切换会话。
- 会话命令：`/session`/session list [，`/session use>`，`/session new [问题]`
- 提供者选择优先级：
1. `channel_cli_overrides[channel_id]`
2. `guild_cli_overrides[guild_id]`
3. 叠加层默认提供者（`cli.provider`/运行时状态）
### 运维提示
- 配置文件修改后需要重启叠加层（或 Discord 机器人）才能生效。
- 队列过长时，机器人将发送排队通知，超时请求将返回过期通知 日志文件：/.engram/overlay.log`
---
##客户端集成
安装脚本将自动为检测到的所有 AI AMBER 连接。叠加层必须**，各个客户端才能BER。
加层运行时
VS Code Copilot → 自动连接
Claude Code →
├── Gemini CLI → 自动连接
└── Goose → 自动连接
```
连接：
- 检查层是否运行（`~/.engcp-http.log- VS Code：窗口后，检查中是否显示 服务器
### 使用 的注意事项
AM AI 提供大量上下文、记忆、知识。推荐最低配置：模型，VR16GB 以上**
不足，建议使用 Claude API / Copilot /。
---
## 安装的内容
| 项目 内容 |
--------------- | ---------------------------------------------------------------------------------------------- |
| CLI 快捷方式 | `engramengram-copilot`、`engram-gem、`engram`、`engram`、`engram |
| AI 工具集成 | 自动为检测到的所有工具配置 MCP |
| 用户设置 | 存储在engram/` 文件夹中 |
目录 | 安装时指定的路径（默认值：`D:\intel_eng） |
程序 | Windows 登录时自动启动叠（可选） ## 卸载
```powershell
powershell - Bypass -File .\1 -Uninstall
```
> 和 AI 工具设置不会自动删除。
---
## 文档
-](docs/arch)
- [内存设计](docs/memory.md)
-本体路线图](-ontology-roadmap---
## 许可证
MIT © 2026
