NODEDC_1C/llm_normalizer

NDC AI First Layer (LLM Normalizer Playground)

Локальный модуль front + back для нормализации бухгалтерских запросов через OpenAI token.

Ключевые свойства:

• русифицированный GUI (терминология NDC);
• backend-proxy (ключ не уходит во фронт);
• Responses API + structured JSON schema normalized_query_v1 / normalized_query_v2 / normalized_query_v2_0_1;
• trace/history/eval;
• совместимый accounting-agent namespace для будущей интеграции в dc_node.

Быстрый запуск (Windows)

1. Опционально: отдельная среда Miniconda

conda create -n ndc-gui nodejs=22 -y
conda activate ndc-gui

2. Backend

cd X:\1C\NDC_1C\llm_normalizer\backend
npm install
npm run dev

3. Frontend (в новом терминале)

cd X:\1C\NDC_1C\llm_normalizer\frontend
npm install
npm run dev

4. Открыть GUI

• http://localhost:5174

Backend по умолчанию:

• http://localhost:8787

Чтобы включить live-probe в 1С через MCP (для hybrid_store_plus_live и live_mcp_drilldown), задайте переменные перед запуском backend:

$env:FEATURE_ASSISTANT_MCP_RUNTIME_V1='1'
$env:ASSISTANT_MCP_PROXY_URL='http://127.0.0.1:6003'
$env:ASSISTANT_MCP_CHANNEL='default'

Запуск из одной папки (VS Code)

Открой в VS Code папку:

• X:\1C\NDC_1C\llm_normalizer

Дальше 2 варианта:

1. Через Tasks:

• Terminal -> Run Task -> NDC: Install All (первый раз)
• Terminal -> Run Task -> NDC: Dev All (Backend + Frontend)

2. Через одну команду в терминале:

cd X:\1C\NDC_1C\llm_normalizer
start-dev.cmd

С live-MCP (прокси 1С на 127.0.0.1:6003):

cd X:\1C\NDC_1C\llm_normalizer
start-dev-mcp.cmd

Или:

cd X:\1C\NDC_1C\llm_normalizer
npm.cmd run dev:all

Основные endpoint-ы

• POST /api/openai/test-connection
• POST /api/normalize
• POST /api/eval/run
• GET /api/history
• GET /api/history/:trace_id
• POST /api/presets/save
• GET /api/presets
• GET /api/health
• GET /api/accounting-agent/v1/health

Где хранятся данные

• traces: llm_normalizer/data/traces
• presets: llm_normalizer/data/presets
• eval cases/reports: llm_normalizer/data/eval_cases

Для POST /api/eval/run поддержан batch-ввод через rawQuestions (разделитель ; или пустая строка).

Тесты backend

cd X:\1C\NDC_1C\llm_normalizer\backend
npm test