打开与配对#
facetmark serve在服务所在电脑访问 http://127.0.0.1:8787/app，通常自动配对。通过域名或其他设备访问时，填写服务端 facetmark token 输出的令牌。
首次设置#
- 导入：选择浏览器导出的 HTML 或 Chromium Bookmarks JSON。文件发送到当前连接的 facetmark 服务。
- 模型：点击“去配置模型”，填写接口和模型，点击“测试连接”分别检查对话与向量，再点击“保存”。也可以先用词面搜索。
- 索引：回到首次设置页点击“开始建索引”，完成后检查正文覆盖与向量数量。失败时记录错误，修正配置后重试。
远程访问的区别
日常搜索可以通过已配对的远程连接使用。导入、配置和索引管理要求本机连接，或通过 SSH 转发访问。
选择要做的事#
| 入口 | 适合做什么 |
|---|---|
| 搜索 | 按词语或内容描述找页面；搜索选项里调整模式，按保存日期缩小范围。 |
| 综述 | 根据检索到的已存摘要或片段整理答案，沿编号引用核对来源。 |
| 书签库 | 看收藏时间线、正文与向量覆盖，判断还缺哪些内容。 |
| 浏览批次 | 找同一时间段保存的书签，恢复当时的阅读线索。 |
| 系统 | 查看服务状态、抓取队列和链接健康，排查数据问题。 |
| 设置 | 管理模型与索引；仅限本机连接或 SSH 转发。 |
读懂一条搜索结果#
标题打开原始网页；详情入口展示摘要、主题和相关页面。彩色徽章表示检索来源，同一种来源保持同一种颜色。排名高低不代表内容已经核实。
- 内容相关：由内容向量命中，可能来自正文或标题推断的摘要。
- 提问方式：匹配的是模型生成的候选问题，不是你的历史查询。
- 词语 / 子串：按字面匹配，适合明确的术语、网址和中文短语。
- 已冷却：排序降低但书签保留。关联结果单列，便于继续探索。
快捷键与阅读偏好#
| 操作 | 效果 |
|---|---|
| / | 聚焦搜索框（不在其他输入框内时）。 |
| ↑ / ↓ | 建议列表打开时选择建议，否则在搜索结果间移动；选字期间不干扰输入法。 |
| Enter | 提交搜索或综述；有选中建议时采用该建议。确认中文选字不会提交。 |
| Esc | 先关闭建议或详情；搜索页没有弹层时清空查询。 |
| 语言 / 主题 | 支持中英文；应用主题依次切换为浅色、深色、跟随系统，按钮提示下一步操作。 |
没有结果或无法管理#
先在书签库确认有书签，再分别检查正文和向量覆盖。索引完成并不意味着每个网站都允许抓取。设置页提示访问受限时，按提示使用本机或 SSH 入口。