28.0 KB · updated 2026-07-06 · md

feature-map.ru.md

docs/i18n/feature-map.ru.md

Карта функций

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Этот документ кратко описывает функции, которые сейчас реализованы в Tesserae, с их статусом, исходными файлами и местом в документации.

Tesserae — это контекстный движок, работающий на трёх столпах: (1) мониторинг сессий, (2) автономное проактивное усвоение знаний и (3) документы/контекст по запросу. Типизированный граф, хранилище (vault) и статический сайт — проекции базы знаний. Функции ниже сгруппированы по столпу, которому они служат; веха v0.5.0 (июнь 2026) выпустила хребет движка и флагманскую функцию Столпа 3 — контекстный компилятор по запросу.

Легенда статуса: ✅ поставлено · ⚠ в работе / частично.

Контекстный движок — v0.5.0 (июнь 2026)

Хребет движка, приводящий в действие три столпа. Карту модулей хребта движка, sidecar памяти самоулучшения и поток данных контекстного компилятора см. в MD0.

Хребет движка (столпы 1 & 2)

ФункцияСтатусИсточникПримечания
Pipeline — переиспользуемая цепочка обновления, возвращающая List[StepResult]MD0Один исполнитель шагов, вызываемый CLI, демоном и MCP. Ловит Exception на каждом шаге; останавливается на первом сбое.
Daemon — asyncio-супервизор с единственным владельцемMD0Следит за источниками + хранилищем + каталогом сессий harness; дебаунс «отмена-и-перепланирование» сворачивает серию в один Pipeline.run(). pidfile; переживает исключения в полёте.
engineMD0--interval, --debounce, --once. daemon — псевдоним engine.
project refresh — прозаическая цепочка (усвоение → компиляция → проекция)cli.py + MD1--changed-only (опциональная инкрементальность), --skip-sessions.
Живой мониторинг сессий → находкиharness_sessions.py + модули графа сессийИмпортированные сессии питают граф; fresh_insights / find_session_findings выводят их на поверхность.

Память самоулучшения (столп 2)

ФункцияСтатусИсточникПримечания
sidecar node_memory SQLite (затухание / уверенность / вытеснено)MD0NodeMemoryRow + независимые от хранилища аксессоры; только изменяемое состояние. Первое появление — в отдельном sidecar node_provenance.
Оценка затухания ЭббингаузаMD0Ранжирует находки сессий по новизне + частоте доступа (питает fresh_insights).
Проход вытеснения (по умолчанию ВКЛ)MD0Детерминированный вердикт помечает более старый почти-дубликат инсайта как вытесненный более новым; добавляет ребро supersedes.
Связь инсайт → кодовый символMD0Рёбра discusses от инсайтов сессий к упоминаемым символам.
Проходы подкрепления + противоречийMD0, MD1Подкрепление доступа + обнаружение противоречий над тем же sidecar.
Числовая уверенность повторяемости в выводеMD0Временные факты проставляют confidence из NodeMemoryRow.confidence, иначе откат к infer_confidence.

Поиск + эмбеддинги (столпы 2 & 3)

ФункцияСтатусИсточникПримечания
Гибридный ретривер (BM25 + лексика + эмбеддинги, RRF k=60)MD0Локально-ориентированный, полностью детерминирован.
Персонализированный PageRank (HippoRAG-2)MD0Многопрыжковое расширение семян; подграф с ограничением глубины.
Реальные эмбеддинги по умолчанию (Track B, Фаза 6)retrieval/hybrid.pyПо умолчанию = детерминированный псевдо-эмбеддинг на хэш-бакетах (без зависимостей); sentence-transformers (all-MiniLM-L6-v2) предпочтителен при установке, грузится лениво. MCP-инструмент embedding_status сообщает активный бэкенд.

Контекстный компилятор по запросу (Столп 3 — флагман)

ФункцияСтатусИсточникПримечания
compile_contextContextBundle в памяти со ссылкамиMD0Разрешение семян → расширение PPR → выбор с ограничением бюджета → markdown со ссылками → опциональный LLM-синтез. Детерминирован, если не synthesize=true. Ничего не пишет на диск.
CLI project contextcli.py[query], --seeds, --depth (2), --budget (32000; ≤0 = без ограничения), --synthesize, --output.
MCP-инструмент compile_contextMD0Тот же конвейер через MCP; budget=0 = без ограничения.
Срезы экспорта в рамках темыMD0 slice_export_context_for_topicllms.txt в рамках темы + render_harness_context через compile_context.

Инкрементальная компиляция (Фаза 4 — экспериментально)

ФункцияСтатусИсточникПримечания
sidecar происхождения (node_provenance, первое появление)MD0Основа для удаления изменённого; пишется всегда.
Поверхность удаления GraphStoreMD0delete_node, delete_nodes_by_source (удаляет узлы, чьё множество происхождения опустевает; межфайловые концепции выживают).
Диспетчеризация хранилища url_resolver во время выполненияMD0sqlite:///… / hypepaper-postgres://…GraphStore.
Флаг incremental_compileMD0По умолчанию OFF / экспериментально. Байт-паритет доказан для нескольких форм правок, но остаются пробелы с несколькими владельцами/жизненным циклом продюсеров; полная компиляция остаётся по умолчанию.

Редизайн фронтенда — апрель 2026

Иерархическая wiki, ориентированная на документы, заменяет прежний дамп графа. См. MD0 для обзора по маршрутам и MD1 для трехслойной модели.

Wiki-слой (L2 markdown)

ФункцияСтатусИсточникЯкорь документации
WikiPageStore (идемпотентные записи body-hash, парсер frontmatter)MD0architecture.md § Карта модулей
WikiLayerProjector — одна md-страница на узел wiki-слояMD0architecture.md § Pipeline
Страницы sources/wiki_projector.pyfrontend-redesign.md § Sources
Страницы concepts/wiki_projector.pyfrontend-redesign.md § Concepts
Страницы entities/wiki_projector.pyfrontend-redesign.md § Entities
Страницы papers/wiki_projector.pyfrontend-redesign.md § Papers
Страницы repos/wiki_projector.pyfrontend-redesign.md § Repos
Страницы topics/wiki_projector.pyfrontend-redesign.md § Topics
Страницы questions/ (открытые вопросы)wiki_projector.pyfrontend-redesign.md § Questions
Страницы syntheses/MD0frontend-redesign.md § Syntheses

Виды синтеза (L2 → производные)

SynthesisProjector создает семь детерминированных шаблонов и добавляет узлы Synthesis плюс ребра synthesizes / summarizes обратно в граф.

ВидСтатусИсточникПримечания
pulse (один глобальный, питает /)synthesis.pyПересобирается при каждом compile.
daily_digestsynthesis.pyОдин на data/research/daily/<date>/.
weeklysynthesis.pyОдин на data/research/weekly/<iso-week>/.
topicsynthesis.pyОдин на кластер ResearchTopic / ApproachFamily с ≥ 3 papers.
comparisonsynthesis.pyОдин на пару ApproachFamily, конкурирующих в одной задаче.
field_overviewsynthesis.pyОдин на ResearchField.
Сводки, улучшенные LLM (через env-флаг)только hookЭвристическая базовая версия поставляется; hook TESSERAE_SYNTHESIS_LLM=1 оставлен как stub.

Маршруты статического сайта

МаршрутСтатусИсточникПримечания
/ (главная, hero pulse)MD0 render_homeСтрока статистики + отобранные точки входа + недавняя активность.
/sources/, /sources/<slug>.htmlpages.py::render_sources_index, render_source_detail
/concepts/, /concepts/<slug>.htmlpages.py::render_concepts_index, render_concept_detail
/entities/, /entities/<slug>.htmlpages.py::render_entities_index, render_entity_detail
/papers/, /papers/<slug>.htmlpages.py::render_papers_index, render_paper_detail
/repos/, /repos/<slug>.htmlpages.py::render_repos_index, render_repo_detail
/topics/, /topics/<slug>.htmlpages.py::render_topics_index, render_topic_detail
/syntheses/, /syntheses/<slug>.htmlpages.py::render_syntheses_index, render_synthesis_detail
/questions/, /questions/<slug>.htmlpages.py::render_questions_index, render_question_detail
/timeline/pages.py::render_timelineТепловая карта + список дней + рельс synthesis.
/timeline/<YYYY-MM-DD>.html (детали по дню)пока n/aЯчейки тепловой карты временно ведут на исходную страницу digest.md соответствующего дня. Subagent P подключает дневные detail-страницы через StaticSiteBuilder.
/graph/ (интерактивные 2D + 3D)pages.py::render_graph_view + js.py3d-force-graph + Three.js, подсказки при наведении, подписи ребер, zoom с привязкой к курсору.
/about.htmlpages.py::render_aboutSchema, информация о сборке.

Экспорты, удобные для ИИ

АртефактСтатусИсточникНазначение
Соседний файл <page>.txt для каждой страницыMD0 write_siblingsТекстовый вид одной страницы (без навигации и стилей).
Соседний файл <page>.json для каждой страницыexports.py::write_siblings{title, kind, body, body_text, links, source_path, frontmatter}.
llms.txtexports.py::render_llms_txtКороткий индекс llmstxt.org.
llms-full.txtexports.py::render_llms_full_txtТело всех страниц, ограничено 5 MB.
graph.jsonldexports.py::render_graph_jsonldschema.org Dataset, только узлы wiki-слоя.
graph.json__init__.py::write_siteПолный payload графа (вкл. code nodes для tooling).
search-index.jsonMD0Палитра + поиск страниц; только типы wiki-слоя.
sitemap.xmlexports.py::render_sitemap_xmlВсе выпущенные маршруты, lastmod из frontmatter.
rss.xmlexports.py::render_rss_xmlПоследние 30 syntheses.
robots.txtexports.py::render_robots_txtРазрешительный — crawl + index.
ai-readme.mdexports.py::render_ai_readmeМашиночитаемая карта сайта.
manifest.json__init__.py::_manifestsha256 + размер для каждого выпущенного файла (harness идемпотентности).

Визуальный дизайн + UX

ФункцияСтатусИсточникПримечания
Design tokens (светлая + темная темы, терракотовый акцент)MD0Один CSS bundle в assets/style.css.
Переключатель темы (сохраняется, без вспышки)MD0data-theme="dark" в localStorage, применяется до отрисовки.
Поисковая палитра (cmd+k / ctrl+k / /)js.pyНечеткое совпадение по search-index.json; список недавних страниц.
Липкий правый TOCpages.py + tokens.pyТолько desktop; mobile drawer через <details>.
Тепловая карта активности с метками месяцев + дней неделиcomponents.py::heatmap_svgSVG на 26 недель, ячейки ведут на дневной digest.md.
Sparkline (по concept/entity)components.py::sparkline_svgНедельные счетчики упоминаний, последние 12 недель.
Mobile shell (drawer rail, bottom nav, fluid type)tokens.py + pages.pyСенсорные цели ≥ 44 px.
Переходы страниц (opacity 120 ms, prefers-reduced-motion)tokens.py
3D + 2D вид графа (hover, подписи ребер, zoom с привязкой к курсору)pages.py::render_graph_view + js.py3d-force-graph + Three.js, vendored как CDN snapshot.
Footer AI-соседей на страницеcomponents.py::ai_siblings_footerInline-ссылки на .txt и .json текущей страницы.
Страницы истории сессий harnessMD0 + MD1Явный импорт Claude Code/Codex; индекс /sessions/ и detail-страницы с markdown turns, левым turn rail, свернутым tool use и search entries.

Pipeline + CLI

ФункцияСтатусИсточникПримечания
project compile вызывает synthesis + wiki + site по порядкуMD0Фаза 3 плана редизайна.
project build-site standaloneproject.py + MD1Читает wiki/ + graph.json, пишет site/.
project serve локальный HTTPcli.pyПростой stdlib server.
export site --deploy → GitHub PagesMD0Worktree push в gh-pages; опциональный --enable-pages через gh CLI. --build, --dry-run, --branch, --remote, --force.
project sessions discover/import/listMD0 + cli.pyВходящая история сессий для Claude Code/Codex; обнаружение явное и ограничено рабочим каталогом проекта.
export site --watch пересборка-при-измененииMD0 + MD1Автономный опрашивающий watcher: --interval, --debounce, --once, --paths, --quiet. Многоисточниковый супервизор — в project engine/daemon (см. Контекстный движок).
project context — компиляция документа контекста со ссылкамиcli.py + MD1Флагман Столпа 3; см. раздел Контекстный движок.
project refresh / enginecli.py + MD1Прозаическая цепочка обновления + цикл супервизора; см. раздел Контекстный движок.

Ранее существовавшие функции (перенесены без изменений)

CLI и установка

  • ✅ Устанавливаемый Python package через pyproject.toml.
  • ✅ Console commands: tesserae, tesserae, tesserae_mcp.
  • scripts/install.sh для установки curl | bash.
  • ✅ Editable installs по умолчанию для быстрой локальной разработки.

Извлечение

  • ✅ Детерминированный extractor исследовательских заметок с контролируемыми словарями nodes/edges.
  • ✅ Claude CLI/OAuth extractor для более качественного структурированного извлечения без API keys.
  • ✅ Выборочная маршрутизация Claude по glob и budget limit.
  • ✅ Детерминированный extractor development-code для Python проектов.
  • ✅ Batch ingest с content hashing и поддержкой --changed-only.
  • ✅ Чтение источников с терпимостью к некорректному UTF-8.

Управление графом

  • ✅ Контролируемый список ResearchNodeType — теперь включает SYNTHESIS.
  • ✅ Контролируемый whitelist edge types — теперь включает synthesizes, summarizes.
  • ✅ Валидация для отклонения schema drift.
  • ✅ Каноникализация alias.
  • ✅ Review queue для неоднозначных почти-дубликатов nodes.
  • ✅ Шаблон review decisions и workflow merge/keep-separate.
  • ✅ Сводка трендов корпуса из графов по файлам.

Персистентность и отчеты

  • ✅ Экспорт Graph JSON.
  • ✅ SQLite graph store.
  • ✅ Опциональный Kuzu graph store.
  • ✅ Graph report с counts, evidence coverage, orphan nodes, date buckets, alias-heavy nodes.
  • ✅ Competitive report с описанием идей, заимствованных из MegaMem, Graphiti/Zep, MCP graph servers, agentic RAG.

Project-local workflow

  • tesserae init --bare
  • tesserae compile <paths>
  • tesserae compile
  • tesserae projects mcp-config
  • tesserae export site
  • tesserae serve
  • tesserae export site --deploy (GitHub Pages)
  • tesserae sessions discover/import/list (явный импорт локальной agent-history)
  • tesserae export site --watch (автономный опрашивающий watcher)
  • tesserae engine (цикл супервизора — v0.5.0)
  • tesserae refresh (прозаическая цепочка усвоение → компиляция → проекция — v0.5.0)
  • tesserae context (контекстный компилятор по запросу — v0.5.0)
  • tesserae export harness
  • tesserae vault export
  • tesserae export graphiti
  • tesserae export graphiti --sync

Obsidian

  • ✅ Готовый к открытию vault export.
  • .obsidian/app.json и настройки графа.
  • ✅ Markdown projection.
  • ✅ Структура raw/assets/.
  • _meta/dashboard.md с Dataview query.

Agent harnesses

Создаваемые target files для:

  • ✅ Claude Code: CLAUDE.md, .claude/settings.json
  • ✅ Codex: AGENTS.md, mcp.toml
  • ✅ Gemini: GEMINI.md, .gemini/settings.json
  • ✅ Kiro: steering and MCP settings
  • ✅ Cursor: project rules and MCP config
  • ✅ OpenCode: AGENTS.md, opencode.json

Graphiti / temporal facts

  • ✅ Проекция temporal facts с полями provenance, currentness, confidence и invalidation.
  • ✅ Dependency-free экспорт Graphiti episode JSONL.
  • ✅ Smoke sync-graphiti --dry-run без установленного Graphiti.
  • ✅ Опциональная live sync с graphiti_core и Neo4j.

Cognee

  • ✅ Cognee JSONL bundle (nodes.jsonl, edges.jsonl, manifest.json).
  • ✅ Опциональный add-only direct import.
  • ✅ Опциональный Cognee cognify adapter на базе Codex CLI/OAuth.
  • ✅ Детерминированный и Ollama embedding adapter paths для no-API-key smoke/quality workflows.

MCP server

  • tesserae_mcp / python3 -m tesserae.mcp_server поверх stdio JSON-RPC.
  • ✅ Инструменты поиска/графа: schema, graph_summary, search_nodes, node_contextuse_ppr), search_facts, timeline, graph_ppr, wiki_page, raw_source, lint_report.
  • ✅ Инструменты контекстного движка (v0.5.0): compile_context, embedding_status, fresh_insights (ранжирование по затуханию), list_communities, find_session_findings, find_code_symbol_mentions, ask.
  • ✅ Инструменты настройки: tesserae_setup_plan, tesserae_setup_apply.
  • ✅ Реестр нескольких проектов: list_projects, register_project, activate_project, unregister_project, list_sessions. Диспетчеризация URL хранилища через url_resolver.

Тесты

Текущий набор покрывает:

  • ✅ ontology guardrails (вкл. новый узел Synthesis + ребра synthesizes / summarizes);
  • ✅ deterministic extraction;
  • ✅ parsing/validation обертки Claude CLI;
  • ✅ selective Claude routing;
  • ✅ workflow canonicalization/review;
  • ✅ batch ingest;
  • ✅ reports;
  • ✅ SQLite/Kuzu persistence;
  • ✅ Cognee bundles/import patches;
  • ✅ Graphiti export/sync dry-run;
  • ✅ project CLI workflow;
  • ✅ agent harness export;
  • ✅ Obsidian export;
  • ✅ frontend generation + link integrity (без nodes/codeclass-*.html);
  • ✅ wiki store idempotence;
  • ✅ synthesis projector golden + idempotence;
  • ✅ site components, pages, exports, relevance;
  • ✅ форма AI-sibling (.txt + .json на страницу);
  • ✅ end-to-end compile-twice idempotence;
  • ✅ хребет движка: конвейер, цепочка обновления, ядро демона + источники, CLI project engine;
  • ✅ память самоулучшения: sidecar, затухание/вытеснение, подавление вытеснения (вкл. MCP), подкрепление/противоречия;
  • ✅ поиск + эмбеддинги: гибридный поиск, PPR, реальные эмбеддинги по умолчанию (Фаза 6);
  • ✅ контекстный компилятор: форма/целостность ссылок/детерминизм/бюджет/откат PPR, CLI project context, MCP compile_context;
  • ✅ инкрементальная компиляция (экспериментально): диффер, проверки паритета, готовность происхождения, происхождение SQLite;
  • ✅ package install и installer contract.