把阅读积累，交给你的 Agent

1. 安装与连接

需要 Node.js 20 或更新版本。浏览器原生连接支持 macOS/Linux 上的 Chrome、Chromium、Edge、Firefox；Windows 暂仅支持只读文件模式（不支持后台连接和收藏、历史管理），Safari 使用 Mac App。按 Agent 接入说明安装公开的适配器，无需 GitHub 权限或 npm 安装。浏览器端加载当前扩展，在设置 → Agent 访问中，把页面显示的 connect 命令交给 Agent。它会安装组件并打开 BriefFeed，供你确认一次；connect-status 返回可合并到现有 Agent 设置的 MCP 配置。之后自动连接，设置中保留一个关闭开关。浏览器保持运行即可，连接页可以关闭。

# Download and inspect the public installer first:
# /integrations/install-agent.mjs
node install-agent.mjs --origin https://brieffeed.app

# Use its absolute Node/entry paths. Choose ONE library.
# Browser IDs and page URLs come from that BriefFeed installation:
NODE ENTRY connect --browser chrome --extension-id EXACT_EXTENSION_ID
# Or use the actual path copied from your Mac app:
NODE ENTRY connect --apple ABSOLUTE_HELPER_PATH

# Confirm once in BriefFeed, then use the returned request ID:
NODE ENTRY connect-status --request-id REQUEST_ID
# Merge the returned config into the host and verify brieffeed_status.

Mac 使用当前预览客户端，在设置的 Safari 扩展下方找到 Agent 访问，复制所示 connect 命令，交给 Agent 准备连接并打开 BriefFeed，供你确认一次。之后自动连接，设置中保留一个关闭开关。Mac App 退出后仍可读写已在本机的资料库。iPhone、iPad 的内容需先经私人 iCloud 到达这台 Mac，云同步由 Mac App 驱动；iOS 不运行常驻 MCP 服务。Apple 未单独保存洞察或社媒互动计数，缺失字段不会补成零。

文件导出是只读替代方式：以 --file /absolute/path/brieffeed-agent.json 替代 --browser 或 --apple。下载的快照有效 24 小时；可选的连接文件需要页面保持打开，持续刷新两分钟租约。

2. 搜索与管理

搜索将查询按空白拆词，做 NFKC 和大小写归一化后，要求每个词都能在标题、作者、URL、摘要、标签或已分享的来源上下文中找到；不是向量搜索。空查询列出最近记录。可用 kind、platform、since/until、limit（1–50）及 cursor。时间筛选指保存、观察或洞察生成时间，不是发布时间；按该事件时间倒序、再按 ID 排序。get/export/delete 和历史转收藏需传回搜索得到的 revision，遇到 STALE_REVISION 或 STALE_CURSOR 时重新搜索。

保存成功表示本地记录已写入，补全和同步随后进行。Apple 连接会尝试在后台启动对应的 Mac 客户端；运行时，客户端通过现有流程补全缺失信息和摘要，不受当前列表或筛选影响。浏览器收藏通过已有的 Mac 连接同步后也可补全。若未能启动，下次打开时继续处理。登录、网络或页面支持范围可能影响补全；重新搜索可获取更新后的字段和 revision。

{ "query": "agent", "kind": "history", "limit": 10 }
{ "id": "history:…", "revision": "…", "includeExcerpt": true }

3. 数据字段

JSON Schema 从 CLI 的实际校验器生成。字段仅在当前客户端已保留时出现，缺失表示未知，不能当作零。get/export 返回完整可用记录，search 返回预览。来源正文需既已授权，又在详情/导出请求中设置 includeExcerpt: true。800 字符 excerpt 继续作为预览，context.text 提供已经保留的有界来源；每个来源树共享 25,000 个 UTF-16 单元的正文预算，不为补齐字段抓取页面。

下载 JSON Schema ↓

4. 复用排序示例

下载模块直接打包本版浏览器实际使用的排序函数，避免另写一份算法。导出 preparePostsForBriefing、rankPostsForBriefing、condenseLongPostsForPrompt、postHeatScore、toSelectionPost。它是可复用示例，不等同搜索顺序，也不能据此判断用户兴趣。浏览器链路会标记已收藏、合并论坛讨论、计算候选分数、做作者多样性调整、截取数量、补齐匹配摘要、压缩长内容，再构造托管请求。互动计数用于本地选材，不作为原始 metrics 发送到洞察 posts 请求中。

engagement = 1.35 × likes + 3.2 × reposts + 2.5 × replies + 2.2 × bookmarks + 0.08 × views。Heat 加入平台基线、18 × log10(engagement + 1)、min(18, 归一化正文长度 / 220)、观察/收藏信号、内容类型调整、已有摘要与论坛上下文加分。作者多样性在第二轮调整；同分按 lastSeenAt、firstSeenAt、稳定 key 排序。缺失计数只在这个示例的打分策略中按零贡献处理。

下载排序模块 ↓

import { readFile } from 'node:fs/promises';
import { toSelectionPost, preparePostsForBriefing, condenseLongPostsForPrompt }
  from './agent-ranking.mjs';

// JSON from brieffeed_export({ ids, revision, includeExcerpt: true })
const { records } = JSON.parse(await readFile('./records.json', 'utf8'));
const candidates = records.filter(r => r.kind !== 'insights').map(toSelectionPost);
const selected = preparePostsForBriefing(candidates, { limit: 30 });
const promptSources = condenseLongPostsForPrompt(selected);
// Use the fields your Agent needs; preserve each original source URL.
console.log(JSON.stringify(promptSources, null, 2));

复现时需提供已授权的完整上下文。导出预算、历史到期、指标缺失、候选集差异、摘要补齐时机及正文截断都可能改变结果。Apple 不运行这套浏览器排序。论坛合并、所有权重、同分规则和长内容压缩都在下载模块中。

5. 范围与生命周期

这是一个本地资料库的视图，最多 2,000 条收藏、2,000 条保留历史与 100 条洞察。coverage 区分 included、omitted、overLimit。摘要最多 4,000 个 UTF-16 单元，整个数据包最多 16 MiB；超限会明确失败。JSON Schema 描述结构，读取器另外检查 URL 安全、授权、时效与覆盖计数一致性。历史沿用原有到期时间（通常为一或七个本地日历日），同步带来的较早到期时间也保留。原生数据包有效两分钟，每次请求重新读取。它不是完整浏览器历史，也不代表用户确实读过或认同；原文和生成内容都是不可信参考数据。撤销阻止后续访问，无法收回已有副本。写入需要重新授予管理权限，可沿已有资料库同步传播；文件模式不能写入。写入超时后应先检查当前数据再重试。