WorkGraph

WorkGraph индексирует выбранное пользователем рабочее пространство, не перемещая и не загружая его файлы. Он строит многоуровневый граф Портфель -> Область -> Проект -> Артефакт, предоставляет к нему доступ через локальный браузер, CLI и read-only MCP-сервер, а также может опционально генерировать навигационный слой для Obsidian.

Инструмент начинался как личный vibe-coded инструмент для навигации по большому смешанному исследовательскому и инженерному рабочему пространству. Публичная версия убирает машинно-специфичные допущения, сохраняя рабочий процесс, который сделал оригинал полезным: быстрый поиск по проектам, явное происхождение данных и строгое разделение между исходными файлами, пересобираемыми индексами и курируемой памятью.

Что он делает

• Детализированная карта: переход от всего портфеля к области, проекту, документу, концепции, инструменту или рабочему процессу.

• Локальный поиск: поиск SQLite FTS по метаданным проектов и выбранным текстовым файлам.

• Объяснимые связи: различие между явными ссылками на пути и предложениями с более низкой уверенностью, основанными на общих концепциях.

• Read-only MCP: позволяет Codex, Kimi, Reasonix или другому MCP-клиенту запрашивать контекст проекта и переиспользуемые наработки.

• Опциональный слой Obsidian: генерация навигационных страниц, индексов концепций, зеркал памяти и Canvas без копирования рабочего пространства.

• Контроль конфиденциальности: пометка целых областей верхнего уровня как metadata-only и редактирование типичных шаблонов учётных данных в индексируемом тексте.

• Без облачного сервиса: веб-интерфейс привязан к loopback и использует локальные фронтенд-ресурсы; индексация во время выполнения не требует сети или API моделей.

Related MCP server: ContextForge

Быстрый старт

Установщик для Windows

Загрузите последний исходный архив из Releases, распакуйте его, затем выполните:

.\scripts\Install-WorkGraph.ps1 -WorkRoot "D:\MyWorkspace" -Start

Опциональные интеграции подключаются явно:

.\scripts\Install-WorkGraph.ps1 `
  -WorkRoot "D:\MyWorkspace" `
  -ObsidianVault "$HOME\Documents\My Vault" `
  -SensitiveArea Personal,Finance `
  -ConfigureClients `
  -Start

Установщик создаёт локальный для проекта .venv, записывает config/workgraph.json, строит первый индекс и опционально регистрирует MCP-сервер. Существующие файлы клиента сохраняются в резервную копию перед изменением.

Ручная установка

uv venv .venv
uv pip install --python .\.venv\Scripts\python.exe -e .
.\.venv\Scripts\python.exe -m workgraph.cli init --work-root "D:\MyWorkspace"
.\.venv\Scripts\python.exe -m workgraph.cli refresh
.\.venv\Scripts\python.exe -m workgraph.cli serve

Откройте http://127.0.0.1:8765/. На macOS или Linux используйте .venv/bin/python с теми же командами модуля.

Модель рабочего пространства

Соглашение по умолчанию трактует первый уровень каталога как область, а второй — как проект:

MyWorkspace/
├── Research/
│   ├── ClimateModel/
│   └── KnowledgeGraph/
├── Engineering/
│   ├── RobotArm/
│   └── CFDStudy/
└── Writing/
    └── OpenSourceGuide/

Более глубокие или смешанные структуры можно описать с помощью project_layout.area_depths и project_layout.group_depths. См. config/workgraph.example.json и синтетический examples/demo-workspace.

Ежедневные команды

.\scripts\Refresh-WorkGraph.ps1
.\scripts\Start-WorkGraph.ps1 -Open
.\scripts\Status-WorkGraph.ps1
.\scripts\Stop-WorkGraph.ps1

.\.venv\Scripts\python.exe -m workgraph.cli search "finite element OCR"
.\.venv\Scripts\python.exe -m workgraph.cli context "ClimateModel"
.\.venv\Scripts\python.exe -m workgraph.cli related "KnowledgeGraph"
.\.venv\Scripts\python.exe -m workgraph.cli reuse "document rendering"

MCP-инструменты

work_map, project_context, related_projects, find_reuse, work_search и graph_stats доступны только для чтения. Автоматическая регистрация в настоящее время нацелена на Codex, Kimi Code/Kimi Work и Reasonix на Windows:

.\.venv\Scripts\python.exe -m workgraph.cli configure-clients

Для других клиентов зарегистрируйте эту stdio-команду:

<absolute path to python> -m workgraph.mcp --config <absolute path to workgraph.json>

Границы доверия

• Рабочее пространство остаётся источником истины; WorkGraph никогда не перемещает и не удаляет исходные файлы.

• База данных SQLite и сгенерированные страницы Obsidian — это одноразовые индексы.

• Чувствительные области раскрывают имена файлов и агрегированные метаданные, но их содержимое не индексируется.

• Сгенерированные папки, такие как .git, .venv, node_modules и кэши сборки, исключаются из семантического анализа.

• Бинарные офисные файлы, PDF-файлы, модели и медиа в v0.1 обрабатываются только как метаданные.

• Рёбра related_to — это подсказки для обнаружения, а не доказательства. Прежде чем полагаться на утверждение, проверяйте исходные пути.

Прочтите полную модель конфиденциальности перед индексацией конфиденциальных материалов.

Разработка

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe -m compileall -q src tests

WorkGraph использует только стандартную библиотеку времени выполнения. Cytoscape.js и Lucide включены локально для офлайн-интерфейса; их уведомления находятся в THIRD_PARTY_NOTICES.md.

Разработка ведётся под руководством человека с помощью ИИ. Мейнтейнер отвечает за архитектурные решения, границы конфиденциальности, проверку, релизы и все принятые изменения; сгенерированный код проходит ту же проверку и те же требования к тестированию, что и любой другой вклад.

Вклад приветствуется через сфокусированные issues и pull request'ы. См. CONTRIBUTING.md, SECURITY.md и дорожную карту.

Лицензия

Apache License 2.0. См. LICENSE.