1creader

Read-only чтение конфигураций 1С из файловой ИБ
без платформы 1С · без XML-дампа · карты для Obsidian и ИИ-агентов

Python 3.10+ 1CD 8.3.8 MCP License

Быстрый старт · Для чего · Obsidian · ИИ-агенты · CLI

Зачем

У вас есть файловая ИБ 1С (1Cv8.1CD), но нет удобного способа исследовать конфигурацию: где какой модуль, как связаны документы и регистры, что лежит в справочниках.

1creader читает ИБ напрямую и строит навигационную карту — для вас, для Obsidian и для ИИ-агента в Cursor, Claude Code или Codex.
Инструмент не пишет в базу: только чтение и экспорт.

flowchart LR
  IB["📁 1Cv8.1CD"] --> R["onecreader"]
  R --> MAP["MAP.md"]
  R --> V["vault/ Obsidian"]
  R --> D["developer/"]
  R --> AI["ai/"]
  R --> MCP["MCP"]
  MCP --> C["Cursor"]
  MCP --> CL["Claude Code"]
  MCP --> CX["Codex"]

Для чего

Сценарий Что даёт 1creader
Разобраться в чужой конфигурации Дерево подсистем, карточки объектов, связи между справочниками и документами
Найти код и процедуру Поиск по модулям BSL, быстрый доступ к тексту через CLI или MCP
Показать структуру коллеге Obsidian vault с mind maps: подсистемы, связи, движения документов
Спросить ИИ про конфигурацию MCP подключает агента к вашей ИБ: схемы, модули, данные справочников
Понять данные в БД Чтение справочников и регистров, обзор DBSCHEMA и ReferenceN
Задокументировать legacy Экспорт схем в developer/ и заметок в vault/ без выгрузки в XML

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

git clone https://github.com/vengeoff/1creader.git
cd 1creader
python3 -m venv .venv && .venv/bin/pip install -e .

Положите свою файловую ИБ в workspace (папка с 1Cv8.1CD):

onecreader init ./моя-иб --index

Артефакты появятся в моя-иб/.onecreader/:

Файл / папка Содержимое
MAP.md Компактная карта для ИИ-агента
vault/00-Index.md Панель навигации в Obsidian
vault/Types/ Каталоги объектов по типам
vault/Subsystems/ Дерево подсистем конфигуратора
vault/Graphs/*.mmd Mind maps
developer/ Полные схемы и тексты модулей
ai/retrieval.json Чанки для RAG / embedding

Обновить после изменений в конфигураторе:

onecreader -b ./моя-иб index --force

Obsidian vault

Структура без повторов: главная — сводка и ссылки, списки объектов — в своих разделах.

vault/
├── 00-Index.md          ← панель (статистика + куда идти)
├── Configuration.md     ← платформа и режим совместимости
├── Types/
│   ├── Catalogs.md      ← таблица всех справочников
│   └── Documents.md
├── Subsystems/
│   ├── 00-Tree.md       ← дерево интерфейса
│   └── БухгалтерскийУчет.md
├── Objects/
│   └── Catalogs/Сотрудники.md
└── Graphs/
    ├── subsystems.mmd
    ├── relations.mmd
    └── document-movements.mmd

Откройте vault/ как vault в Obsidian. На карточке объекта — подсистемы, связи, движения по регистрам, ссылка на полную схему.

Подключение ИИ-агентов

Один MCP-сервер, три редактора. После pip install -e . конфиги уже в репозитории.

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "1creader": {
      "command": "bash",
      "args": ["scripts/run-mcp.sh"]
    }
  }
}

Скилл агента: .cursor/skills/1c-config/SKILL.md

Claude Code

.mcp.json в корне (project scope — общий для команды):

{
  "mcpServers": {
    "1creader": {
      "type": "stdio",
      "command": "bash",
      "args": ["${CLAUDE_PROJECT_DIR}/scripts/run-mcp.sh"]
    }
  }
}

Инструкции агента: AGENTS.md, CLAUDE.md. Проверка: /mcp.

Или через CLI:

claude mcp add 1creader --scope project -- bash scripts/run-mcp.sh

Codex

.codex/config.toml в корне (для trusted-проектов):

[mcp_servers.onecreader]
command = "bash"
args = ["scripts/run-mcp.sh"]
enabled = true

Инструкции: AGENTS.md. Проверка: /mcp в сессии Codex.

Или через CLI:

codex mcp add 1creader -- bash scripts/run-mcp.sh

Инструменты MCP

Инструмент Назначение
config_init / config_index Привязка ИБ и полный экспорт
config_get_index / config_find Кэш индекса, поиск
config_get_object / config_get_module Схема и код
config_get_vault_note Obsidian-заметка по ref
config_export Пути к vault / developer / ai
config_search_code Поиск по модулям
config_catalog_data Данные справочника из БД

CLI

onecreader -b ./моя-иб info
onecreader -b ./моя-иб ls -t Справочник
onecreader -b ./моя-иб obj Справочник.Номенклатура
onecreader -b ./моя-иб module Справочник.Номенклатура
onecreader -b ./моя-иб search "ПолучитьКонстанту"
onecreader -b ./моя-иб form Документ.Заказ --form ФормаДокумента
onecreader -b ./моя-иб catalog-data Справочник.Контрагенты
onecreader -b ./моя-иб db-overview
onecreader -b ./моя-иб find Номенклатура
onecreader -b ./моя-иб export

Что читается

  • Справочники, документы, регистры, перечисления, константы
  • Реквизиты, табличные части, формы, макеты
  • Общие модули, роли, подсистемы
  • Тексты модулей (BSL) и поиск по коду
  • Данные справочников и регистров из таблиц БД
  • DBSCHEMA, соответствие ReferenceN

Ограничения

  • Формат 1CD 8.3.8 (платформа 8.3.8+)
  • Только чтение — запись в ИБ не поддерживается
  • ИБ должна быть доступна как файл; конфигуратор может держать блокировки

Сделано, чтобы работать с 1С удобнее — через Obsidian и ИИ-агентов

github.com/vengeoff/1creader