Open and pair#
facetmark serveVisit http://127.0.0.1:8787/app on the service machine for automatic pairing. From another device or hostname, enter the token printed by facetmark token on the server.
First run#
- Import: select browser-exported HTML or Chromium Bookmarks JSON. The file is sent to the facetmark service you are connected to.
- Models: choose Set up the model, fill in the endpoint and models, then use Test connection to check chat and embeddings separately. Click Save afterwards. You can begin with lexical search.
- Index: return to First run and choose Build the index. Check text coverage and vector counts afterwards. If it fails, note the error, correct the configuration and retry.
When connecting remotely
Paired remote connections can search the library. Import, configuration and indexing administration require loopback access or an SSH tunnel.
Choose a task#
| View | Use it to |
|---|---|
| Search | Find pages by words or a description; adjust modes in Search options and narrow by save date. |
| Ask | Build an answer from retrieved, stored summaries or snippets and check the numbered sources. |
| Library | Browse save activity and inspect text and vector coverage. |
| Sessions | Find bookmarks saved together and recover your reading context. |
| System | Inspect service status, fetch queues and link health. |
| Settings | Manage models and indexing over loopback or SSH forwarding. |
Read a search result#
Open the original page from its title, or inspect its summary, topics and related pages in details. Badge colours identify retrieval sources consistently; a high rank is not a fact check.
- Content: matched by an embedding of stored text, which can include a title-derived summary.
- Intent: matches a model-generated candidate question, not your past searches.
- Words / substrings: literal matches, useful for terms, URLs and Chinese phrases.
- Cooled: ranked lower but retained. Related results are separate for further exploration.
Shortcuts and reading preferences#
| Action | Result |
|---|---|
| / | Focus search when you are not typing in another field. |
| ↑ / ↓ | Select suggestions when open, otherwise move through results. IME candidate keys are left alone. |
| Enter | Submit Search or Ask, or accept the selected suggestion. Confirming IME text does not submit. |
| Esc | Close suggestions or details first; with neither open on Search, clear the query. |
| Language / theme | Choose Chinese or English. The app cycles through light, dark and system themes; the button describes its next action. |
No results or unavailable settings#
Check that Library contains bookmarks, then inspect text and vector coverage separately. A completed index does not mean every website allowed fetching. If Settings reports restricted access, use the loopback or SSH address it describes.