核心功能

一处看清你的 Agent 全貌

Berth 把 AI Agent 背后的纯文本文件和本地数据库，变成结构化、可浏览的对象。这里说明应用视图、扫描引擎和 adapter 模型。

Overview

总览仪表盘

资产数量、最近会话、本周花费与健康检查，一屏掌握。

  • 资产清点
  • 最近活动
  • 成本与健康检查
Sessions

会话浏览

按项目或时间浏览历史会话，查看加载的 Skill、连接的 MCP、触发的 Hook 与产物。

  • 按项目或时间分组
  • 每个会话的加载资产
  • 工具时间线
Configuration

盘点你的装备

Instructions 与 Capabilities 两栏，跨 user / project / enterprise 作用域合并展示，标注来源路径、作用域与冲突。

  • Instructions 与 Capabilities
  • 作用域合并
  • 冲突检测
Usage

用量与成本

按模型、按项目、按天的花费与 Token 走势。Berth 展示本地估算, 不把它伪装成 provider 官方账单。

  • 按模型 / 项目 / 天
  • Token 拆解
  • 本地估算
Scan Engine

看见索引器本身

Settings 里可以看到扫描引擎版本、状态、已索引资产数、已索引文件数、错误、调度状态, 以及可编辑的 watcher 时序参数。

  • 引擎版本
  • 已索引文件
  • 可编辑控制项
扫描引擎

可见的索引器, 不是藏在后台的任务

Berth 的数据层是独立包 @berth/scan-engine。桌面应用通过 worker-backed runtime 使用它, 这个包也提供 CLI 和 adapter API, 方便独立维护 agent 集成。

Package
@berth/scan-engine

scanner、adapter registry、共享资产模型和 CLI 都在 Electron UI 外的包边界里。

Adapter API
./adapter-api

adapter 定义包含 source policy、permissions、evidence URLs、sensitivity 与 version probe。

Cache mode
SQLite SWR

应用会先恢复上次本地索引, 再在后台刷新。

Worker mode
one-shot

重扫描在 renderer 之外执行, 支持 project scope 排队刷新和文件变更更新。

Settings 暴露的控制面

手动刷新

立刻运行扫描器, 并观察 runtime 状态从 scanning 回到 ready。

Watcher debounce

调整文件变更后 Berth 等多久再安排刷新。

最小刷新间隔

避免噪声较多的文件监听反复重建同一个项目索引。

调度状态

查看 scheduled 和 queued refresh 的原因。pause 与 cancel 不可用时会如实显示 unsupported。

Adapter 覆盖

独立 agent adapter, 统一资产模型

每个 adapter 管自己的扫描根和 source policy。AGENTS.md 这类共享兼容文件可以算作 source coverage, 但不会把未安装的 agent 误标为已安装。

Claude Code

core

从 Claude 专属目录读取 instructions、skills、subagents、MCP servers、hooks、sessions 与 usage metadata。

Codex

core

从 Codex homes 和项目中读取 config、AGENTS.md、hooks、skills、sessions 与 rollout metadata。

Gemini CLI

adapter v1

从 user 和 project roots 读取 settings、GEMINI.md context files、extensions 与 session metadata。

GitHub Copilot CLI

adapter v1

读取 Copilot instructions、agents、skills、hooks、MCP/LSP config、plugins, 以及 metadata-only session sources。

Cursor

adapter v1

从 project 和 config roots 读取 rules、MCP config、hooks、permissions、skills、agents 与 plugins。

OpenCode

adapter v1

读取 opencode config、agents、commands、skills、plugins、auth presence、logs 和 session database metadata。

OpenClaw

adapter v1

读取 workspace guidance、skills、extensions、plugins、session indexes、credentials presence 和 debug summaries。

Hermes Agent

adapter v1

读取 config、profiles、identity files、memories、skills、plugins、hooks 与 project context files。

安全边界

能读取, 不等于会写入

  • Berth 只扫描已知本地 roots, 并展示 source paths, 让你能核对每个资产从哪里来。
  • 凭证和 token 只按 presence 或 metadata 处理; secret 值不会展示。
  • 本地 SQLite 索引和扫描设置留在这台机器上, 只供 Berth 使用。
  • 无遥测、无账号、无云同步。外链只指向 GitHub releases 或被引用的文档。
进入知识库