AMBER ICI v5

AMBER ICI（AMBER 调查指挥界面）是一个本地优先的浏览器界面，用于由本地 Ollama 服务器驱动的调查与分析工作流。

它包含：

• 单模型分析师控制台与多模型并行执行
• 由主终端的 SEND 按钮驱动的用户自定义智能体链
• 用户可控制运行哪些智能体、运行多少个、循环多少次，以及每个智能体使用哪个本地模型
• 由本地模型根据自然语言目标生成智能体配置
• 由 Ollama 嵌入支持的持久化语义归档
• 用于活动文件上下文的斐波那契分形检索
• 文件上传、只读链接目录访问、文本提取和 OCR
• 可选的由 Playwright 支持的网页抓取和公开记录搜索，由单一总开关控制
• 独立的实体图、时间线和向量存储视图
• 在可用时提供本地令牌速率、会话、GPU/VRAM 和温度遥测

Ollama 推理在 UI 中被限制为回环端点（127.0.0.1、localhost 或 ::1）。AMBER 不包含云端推理或应用遥测，且没有任何功能需要登录、API 密钥或账户。WEB 胶囊按钮是所有互联网访问的总开关：当它处于 OFF 状态时，AMBER 不会发出任何类型的出站请求。

v5 亮点

• 本地案件工作区，具有案件范围内的证据和归档检索
• 流式 SHA-256 工件身份、摄取溯源、重复检测和来源引用
• 确定性关键词检索与现有语义归档结果融合
• 显式、有界的记忆，范围限定于会话、调查员、案件、智能体或推理任务
• 操作员选择的调查角色模板，使用已安装的本地 Ollama 模型
• 从主终端执行智能体，支持每个智能体的模型、限制、格式、交接和循环控制
• Playwright WEB 预检、可见的执行诊断、直接抓取回退和一小时本地缓存
• 缓存的硬件检测，支持 Metal、CUDA、ROCm、统一内存、利用率和温度报告
• 合并的流式更新，实现响应迅速的长篇输出
• 有界持久化元数据、转义生成的 UI 内容、可复现的 Node 依赖以及扩展的敏感运行时排除项

当前功能集

分析师控制台

• 与一个选定的 Ollama 模型流式对话
• 支持系统提示、JSON 输出模式、种子、温度和 CTX 大小
• 注入活动文件、可选网页和保留的对话上下文
• 使用 STOP 或 Esc 停止活动工作

控制台胶囊栏承载执行控制：

胶囊	值	用途
TEMP / CTX / MEM / FMT / STREAM / SEED / SYS	—	分析师模式推理设置
WEB	OFF（默认）/ ON	所有互联网访问的总开关
EXEC	ANALYST（默认）/ AGENTS	SEND 运行的内容：单个活动模型，或智能体链
AGN	0 = 全部	链运行多少个智能体，按卡片顺序选取
LOOPS	1+	链重复多少次；与智能体面板的 LOOPS 字段同步

并行

• 对同一提示针对所有已勾选的模型运行
• 独立地流式传输和跟踪每个响应
• 应用与分析师控制台相同的 CTX 和活动文件控制

智能体 — 执行链

智能体由用户定义，是主要的执行路径。没有内置或固定的智能体列表；智能体面板初始为空，你可以通过两种方式填充它：

• + CREATE AGENT — 手动定义一个
• GENERATE FROM PROMPT — 描述一个目标，选定的本地规划模型会为你编写智能体集

每个智能体存储自己的运行时配置：

字段	默认值	说明
智能体名称	—	必填
智能体用途	—	以 [AGENT PURPOSE] 注入
智能体系统提示词	—	智能体的角色指令
首选本地模型	—	必填；必须已在 Ollama 中安装
温度	0.35	每个智能体独立设置，与控制台的 TEMP 胶囊按钮无关
最大输出 token 数	0（自动）	0 表示使用 AMBER 的长度启发式
循环次数	1	该智能体在每次链循环中执行的轮数，每轮都会基于自身上一轮输出进行优化
输出格式	纯文本	JSON 会启用 Ollama 的 JSON 模式并跳过长度扩展
交接说明	—	作为 [HANDOFF FROM PREVIOUS AGENT] 传递给下一个顺序执行的智能体
执行模式	sequential	sequential、parallel 或 gated
输出目标、记忆范围、角色、工具访问、启用、备注	—	位于 ADVANCED 下

运行链。 将 EXEC 设为 AGENTS，在主终端中输入提示词，然后按 SEND。AMBER 会读取所选模式、已启用的智能体、每个智能体的本地模型、AGN 数量以及 LOOPS 数量，然后执行：parallel 智能体并发执行，随后按卡片顺序执行 sequential 智能体，每轮循环执行一次。每个顺序执行的智能体都会收到上一个智能体的输出作为 [UPSTREAM OUTPUT]，以及该智能体的交接说明。进度和每个智能体的流式输出都会打印到主终端，最终答案会保留在对话历史中。Agents 面板的 RUN 按钮使用面板自身的 LOOPS 字段执行相同的操作。

在 AGENTS 模式下，SEND 不要求 Models 面板中存在活动模型，因为每个智能体都自带模型。gated 智能体不包含在链中——请使用其卡片上的 RUN 按钮单独运行它们。

缺失的模型绝不会被替换。 保存智能体或启动链时，如果 Ollama 中没有所请求的模型，终端会打印一个可操作的提示块，其中列出所请求的模型、实际已安装的模型以及所需的 ollama pull <model> 命令，并且运行不会启动。

已保存的智能体集可以从 Agents 面板按名称存储和恢复。

早期的 PIPELINE / CHAIN 步骤序列模式已从界面中移除。其引擎和 state/pipeline_state.json 为向后兼容而保留，但它不再是可选模式；智能体即为执行链。

归档与记忆

• 使用 embeddinggemma:latest 对排队文件进行分块和嵌入
• 通过余弦相似度搜索本地归档
• 导入和导出归档 JSON
• 将最近的助手输出直接添加到归档
• 在浏览器中构建斐波那契分形索引，用于文件源检索
• 提供 FAST、HYBRID 和 DEEP 检索配置

案件情报

归档现在包含可选的案件边界，同时不替换其现有的全归档工作流：

• NEW CASE 创建本地案件元数据。
• ADD ACTIVE TO CASE 将所选文件记录为证据，保留现有的原始上传，计算流式 SHA-256 标识，并记录摄取来源。
• 在选中案件时索引的归档向量会携带该案件 ID。案件搜索在两者都可用时，会将这些语义结果与确定性关键词回退进行融合。
• REMEMBER LAST 明确将最新的助手输出保存为带标签的案件记忆。模型输出绝不会被静默提升为证据或记忆。
• ADD INVESTIGATION ROLES 将可选的 Director、Researcher、Investigator、Analyst、Documenter 和 Critic 模板添加到现有的用户自定义智能体注册表中。它们使用操作员选择的本地模型，并且不会自动运行。

案件情报以原子方式存储在一个带版本的标准库 JSON 存储中，并使用 AMBER 现有的 Ollama 客户端。

独立视图

页眉会在单独的标签页中打开这些工具：

• 实体溯源图：http://127.0.0.1:8765/amber_graph.html
• 时间线：http://127.0.0.1:8765/amber_timeline.html
• 向量存储管理器：http://127.0.0.1:8765/amber_vectorstore.html

要求

核心运行时：

• Python 3.10 或更高版本；启动器和核心后端仅使用标准库，因此运行 AMBER 无需 pip install
• 已安装 Ollama 并在本地运行
• 至少一个 Ollama 生成模型
• 用于 Archive 索引和语义搜索的 embeddinggemma:latest

可选功能：

• Node.js 18+ 和 npm，以及项目依赖，用于 JavaScript 渲染的网页抓取和记录搜索
• 用于这些浏览器支持功能的 Playwright Chromium 浏览器
• 用于 PDF OCR 的 ocrmypdf 和 Tesseract
• 用于图像 OCR 的 Tesseract
• 当 Tesseract 无法直接读取 WebP 图像时，用于在 OCR 前转换 WebP 图像的 Pillow
• 用于额外系统指标的 psutil、nvidia-smi 或 osx-cpu-temp；不可用的读数将保持空白

以上所有内容均为本地运行。任何组件都不需要账户、API 密钥或云服务。

安装与运行

1. 克隆仓库

git clone https://github.com/gs-ai/AMBER-ICI.git
cd AMBER-ICI

2. 启动 Ollama

在另一个终端中：

ollama serve

拉取所需的嵌入模型和至少一个生成模型：

ollama pull embeddinggemma:latest
ollama pull qwen2.5-coder:7b

生成模型只是一个示例；AMBER 会从 Ollama 中发现本地已安装的模型。

3. 创建 Python 环境

核心后端仅导入 Python 标准库，因此直接启动时虚拟环境是可选的。不过，如果你希望使用 npm 脚本（这些脚本会调用 venv/bin/python3）或可选的 Pillow 支持，仍然可以创建一个：

python3 -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
python3 -m pip install --upgrade pip

没有 requirements.txt，因为不需要任何依赖。仅当你需要可选附加组件时，才将它们安装到该环境中：

python3 -m pip install Pillow     # optional: WebP conversion before OCR

使用 deactivate 停用。如果之前的 AMBER 版本在 venv/ 中留下了未使用的包（例如 camoufox），当前代码不会导入它们，可以忽略或删除。

4. 启动核心应用程序

python3 files/launch_amber_ici_gui.py

AMBER 会自动打开浏览器。若要在不打开标签页的情况下启动：

python3 files/launch_amber_ici_gui.py --no-browser

然后打开 http://127.0.0.1:8765/amber_ui.html。

5. 安装可选的浏览器支持的 Web 功能

仅当你打算开启 WEB 胶囊按钮时才需要：

npm install                       # playwright, playwright-extra, stealth plugin
npx playwright install chromium   # the browser binary itself

验证辅助程序是否可运行——在 AMBER 运行的情况下，这会报告辅助程序路径、解析后的 node 二进制文件以及任何缺失的包：

curl -s http://127.0.0.1:8765/api/web/status

AMBER 对 JavaScript 渲染页面使用 Node/Chromium 辅助程序，并以纯 Python HTTP 抓取作为直接 URL 的回退方案。records-search 辅助程序需要 Node.js、npm 依赖项和 Chromium；它没有纯 HTTP 回退方案。

6. 安装可选的 OCR 支持

使用 Homebrew 的 macOS：

brew install ocrmypdf tesseract
python3 -m pip install Pillow

Ubuntu/Debian：

sudo apt-get update
sudo apt-get install -y ocrmypdf tesseract-ocr
python3 -m pip install Pillow

Pillow 仅在需要先转换图像格式才能由 Tesseract 处理的图像格式中才需要。当任何可选的 OCR 依赖缺失时，AMBER 仍可继续运行。

npm 便捷脚本

提供的 npm 脚本使用 venv/bin/python3 启动 AMBER，因此请先创建该环境（第 3 步）：

npm start                 # 127.0.0.1:8765, no browser tab
npm run start:browser     # same, and opens the browser

直接通过 python3 启动是最具可移植性的选项。

完整安装流程，从开始到结束

git clone https://github.com/gs-ai/AMBER-ICI.git
cd AMBER-ICI
python3 -m venv venv                       # for the npm scripts
npm install                                # optional: WEB features
npx playwright install chromium            # optional: WEB features
ollama serve &                             # in its own terminal
ollama pull embeddinggemma:latest          # required for Archive
ollama pull qwen2.5-coder:7b               # any generation model
npm start                                  # → http://127.0.0.1:8765/amber_ui.html

启动器选项

python3 files/launch_amber_ici_gui.py --help

参数	默认值	用途
--host HOST	127.0.0.1	AMBER HTTP 服务器监听的地址
--port PORT	8765	AMBER HTTP 服务器端口
--no-browser	关闭	不打开默认浏览器
--gui PATH	自动检测	提供指定的 GUI HTML 文件
--version	—	打印 AMBER ICI 发布版本并退出

即使 AMBER 服务器绑定到其他网络接口，浏览器 UI 也仅接受回环 Ollama URL。

首次运行工作流

1. 确认右上角的 Ollama 端点地址为 http://127.0.0.1:11434。
2. 点击 PING 加载本地已安装的模型。
3. 在 Models 面板中选择一个模型。
4. 在 Analyst Console 中输入提示词并点击 SEND。
5. 可选：上传文件或链接目录，然后激活文件以将其纳入上下文。
6. 在 Archive 中索引文件之前，先拉取 embeddinggemma:latest。

若要改为运行智能体链：

1. 打开左侧面板中的 AGENTS 标签页。
2. 使用 + CREATE AGENT 创建智能体，或在 GENERATE FROM PROMPT 下描述目标。
3. 在控制台胶囊栏中将 EXEC 设置为 AGENTS。
4. 设置 AGN（智能体数量；0 = 全部）和 LOOPS（执行轮数）。
5. 在主终端中输入提示词并按 SEND。

若要允许 AMBER 读取互联网，请先将 WEB 胶囊设置为 ON；默认值为 OFF。

文件摄取

每个文件的上传大小限制为 100 MiB。文件选择器和拖放路径目前接受：