企业官网建设流程全解析

1. 从「收藏夹黑洞」到可检索的第二大脑

SuperMemory 是一个把 Chrome 书签、推文、网页内容抓取下来，再用 AI 做语义检索的开源项目。它的定位不是又一个稍后读工具，而是「私人智能书签助手」——你保存过的内容，能在需要的时候被对话式地重新找回来。技术栈上，它用 Nextjs 14 做 Web UI，React 写前端交互，Drizzle ORM 接 Cloudflare D1，Chrome 扩展负责采集，AI 后端负责向量化和问答。整个仓库由 turborepo 管理，分成 web、extension、ai 三个模块。

我最初用官方托管版试的时候，遇到一个典型问题：添加 spring.io 首页后问 Spring Kafka 相关问题，它直接拒答；补上具体文档页地址后能答了，但内容很浅，参考价值有限。后来换成自己部署 + 统一 Key 接入，把模型换成可配置的推理端点，检索质量才稳定下来。这篇就聚焦 Chrome 插件场景下的落地配置：怎么用 TaoToken 统一 Key 打通 AI 后端，怎么让插件加载、书签写入、检索回读形成闭环。适合已经在用 Nextjs/React 做个人知识库、想给书签加一层语义检索的开发者。

核心检索词先明确：SuperMemory 是什么——一个 AIGC 驱动的私人智能书签助手；能做什么——采集网页/推文、向量化存储、对话式检索；适合谁——有本地部署能力、想统一管理模型 Key 的 Nextjs/React 开发者。

2. TaoToken 前置：统一 Key 解决多模型切换

SuperMemory 的 AI 后端默认走单一模型端点，但实际使用中你会遇到：嵌入模型和对话模型可能不是同一家，本地调试想换模型要改多处配置，Key 散落在.env里容易泄漏。TaoToken 的作用是把这些模型调用收敛到一个统一 Key 和统一 Base URL 上，SuperMemory 的 AI 模块只需要认一个OPENAI_API_KEY和OPENAI_BASE_URL，换模型时改配置不改代码。

你需要先拿到 Key。访问控制台创建 API Key，地址是 https://taotoken.net/api-keys ，这一步只做一次。拿到sk-开头的 Key 后，AI 后端的.env里这样填：

# apps/ai/.env OPENAI_API_KEY=sk-你的TaoTokenKey OPENAI_BASE_URL=https://taotoken.net/api

注意 Base URL 不要带 UTM 参数，API 调用地址就是https://taotoken.net/api。模型名按你实际要用的填，比如对话用gpt-4o-mini，嵌入用text-embedding-3-small，具体可用模型在模型对话页能查到： https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=supermemory_chrome&utm_campaign=rewrite 。如果你打算长期跑编码类 Agent 或批量处理书签，Coding Plan 会更划算，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=supermemory_chrome&utm_campaign=rewrite 。

提示：TaoToken 在这里的角色是模型调用的统一入口，不是替代 SuperMemory 本身。SuperMemory 负责采集、存储、检索逻辑，TaoToken 负责把模型请求稳定地送出去。

3. 可复制配置：settings.json 与 config.toml 骨架

SuperMemory 的 Chrome 扩展和 AI 后端各有一份配置。扩展侧用settings.json控制采集行为和 API 地址，AI 后端用config.toml控制模型参数和检索策略。下面两份骨架可以直接复制后改字段。

先看扩展侧的settings.json，放在apps/extension/public/下：

{ "apiBaseUrl": "http://localhost:3000", "aiBaseUrl": "https://taotoken.net/api", "collect": { "autoCapture": true, "captureOnBookmark": true, "excludeDomains": ["localhost", "127.0.0.1"], "maxContentLength": 8000 }, "auth": { "provider": "next-auth", "sessionCookie": "supermemory.session-token" }, "ui": { "defaultView": "chat", "showSourceBadge": true } }

关键字段说明：aiBaseUrl指向 TaoToken 的 API 地址，扩展在调用 AI 后端时会把请求转发到这里；captureOnBookmark设为 true 后，你在 Chrome 里点收藏，插件会自动抓取页面正文并写入知识库；maxContentLength控制单页抓取上限，太大影响嵌入速度，太小会丢上下文，8000 字符是个平衡点。

再看 AI 后端的config.toml，放在apps/ai/下：

[server] host = "0.0.0.0" port = 8000 [model] provider = "openai-compatible" base_url = "https://taotoken.net/api" chat_model = "gpt-4o-mini" embedding_model = "text-embedding-3-small" max_tokens = 2048 temperature = 0.3 [retrieval] top_k = 6 similarity_threshold = 0.72 chunk_size = 512 chunk_overlap = 64 [database] driver = "d1" binding = "DB"

provider写openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式，SuperMemory 的 AI 模块不用改调用逻辑。similarity_threshold设 0.72 是实测下来比较稳的值，太低会召回无关书签，太高会漏掉相关但表述不同的内容。chunk_size和chunk_overlap决定文本切分粒度，512/64 适合网页正文，如果你主要存推文，可以降到 256/32。

两份配置改完后，AI 后端的.env和config.toml里的base_url要保持一致，否则扩展转发和后端直连会走两个地址，排查起来很麻烦。

4. 验证请求：插件加载、书签写入与检索回读

配置写完不算完，要跑通三个动作才算闭环。我按顺序说。

第一步，启动 AI 后端并验证模型连通。在apps/ai/下执行：

pnpm install pnpm dev

然后用 curl 打一次对话接口，确认 TaoToken 的 Key 生效：

curl -X POST https://taotoken.net/api/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "用一句话说明什么是向量检索"}] }'

返回里有choices[0].message.content就说明 Key 和 Base URL 都对。如果返回 401，检查 Key 是否复制完整；返回 404，检查 Base URL 是不是写成了带路径的地址。

第二步，加载 Chrome 扩展。打开chrome://extensions/，开启开发者模式，点「加载已解压的扩展程序」，选apps/extension/dist目录。加载成功后，扩展图标出现在工具栏，点开应该能看到对话界面。如果界面空白，打开扩展的 Service Worker 控制台看报错，常见的是apiBaseUrl指向的 Nextjs 服务没启动。

第三步，写入书签并回读。在 Chrome 里随便打开一篇技术文章，点收藏，等几秒让插件抓取。然后回到扩展对话界面，问一个只有那篇文章里才有的细节，比如「那篇文章里提到的 chunk_overlap 默认值是多少」。如果检索链路通了，它会带着来源引用回答你。这一步能过，说明采集、嵌入、检索、生成四个环节都串起来了。

注意：首次写入书签后，嵌入是异步的，别马上提问，等 5 到 10 秒。如果一直检索不到，去 AI 后端日志里看有没有 embedding 请求失败。

5. 本篇常见错排查

报错一：Error: 401 Unauthorized出现在 AI 后端日志。原因是.env里的OPENAI_API_KEY没被读到，或者config.toml里的base_url写成了https://taotoken.net（少了/api）。检查顺序：先确认.env在apps/ai/根目录，再确认base_url完整。

报错二：扩展加载后对话界面一直转圈。多半是settings.json里的apiBaseUrl指向了http://localhost:3000，但 Nextjs 服务没起。SuperMemory 的 web 模块和 ai 模块是两个进程，web 负责 UI 和 auth，ai 负责模型调用，两个都要跑。启动命令在根目录用pnpm dev会同时拉起。

报错三：书签写入了但检索不到。先看similarity_threshold是不是设太高，0.72 以上容易漏召回，临时降到 0.6 试试。再看chunk_size，如果文章很长而 chunk 太小，关键信息可能被切散。最后确认嵌入模型和对话模型是不是同一个 provider，混用会导致向量空间不一致。

报错四：D1 binding not found。这是 Cloudflare D1 的绑定问题，本地开发时wrangler.toml里要有[[d1_databases]]段，且binding名字和config.toml里的binding一致。如果你不想用 D1，可以把driver改成sqlite走本地文件，适合纯本地调试。

报错五：插件采集到的正文是乱码或空。有些站点用 JS 动态渲染，插件抓的是初始 HTML。这种情况在excludeDomains里加规则跳过，或者手动复制正文到 SuperMemory 的 Markdown 编辑器里录入。官方插件在这块确实有 UI bug，我试过几个新闻站都抓不全，手动录入反而更稳。

6. 把 Key 收口，让书签真正可检索

SuperMemory 的价值不在于「存了多少」，而在于「能不能在需要的时候被找回来」。官方托管版模型能力有限，自己部署 + TaoToken 统一 Key 之后，你可以按书签类型切换模型：技术文档用便宜的小模型做嵌入，对话用推理强一点的模型，成本和质量都能控。

接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=supermemory_chrome&utm_campaign=rewrite ，里面有 OpenAI 兼容接口的完整参数说明。如果你只是想把 SuperMemory 跑起来验证效果，先去模型对话页拿一个可用模型名，填进config.toml就能跑通。长期用的话，Coding Plan 适合把书签处理、批量嵌入、Agent 检索这些任务打包跑，比按次调用省心。

最后留一个我踩过的坑：config.toml改完一定要重启 AI 后端，SuperMemory 的配置是启动时加载的，热更新不生效。改完不重启，你会以为配置没起作用，其实是旧进程还在跑。