35 lines
2.0 KiB
Markdown
35 lines
2.0 KiB
Markdown
# Модуль: Рабочая область VS Code
|
|
|
|
**Ответственность**: синхронизирует воспроизводимую среду автора и предоставляет три понятные задачи.
|
|
**Расположение**: `.vscode/`, `.template/development/tools/`
|
|
|
|
## Публичный интерфейс
|
|
|
|
| Файл или задача | Назначение |
|
|
|-----------------|------------|
|
|
| `extensions.json` | Десять согласованных recommendations |
|
|
| `settings.json` | Auto Save, spellcheck, TODO, скрытие служебных каталогов |
|
|
| `Scientia: собрать PDF` | Компиляция текущего `main.typ` |
|
|
| `Scientia: выбрать тип документа` | Backup и установка public example |
|
|
| `Scientia: собрать учебный пример` | Компиляция выбранного исходника из `docs/examples/` |
|
|
|
|
## Инварианты
|
|
|
|
- `.vscode/` включён в Git, но скрыт в Explorer.
|
|
- `docs/` никогда не скрыт.
|
|
- Typewriter navigator содержит только `main.typ`.
|
|
- Автосохранение не создаёт commit и не выполняет push.
|
|
- Tasks не хранят приватные значения в tracked settings.
|
|
- Одна build task собирает и public-, и private-режим согласно `main.typ`.
|
|
- Внутренние VSIX не входят в репозиторий.
|
|
|
|
## Намеренно НЕ обрабатывает
|
|
|
|
- Установку VS Code, Git и Typst.
|
|
- Авторизацию на Git-сервере.
|
|
- Публикацию внутренних VSIX.
|
|
|
|
## Заметки для агента
|
|
|
|
> Не добавляйте отдельную build task для каждого режима: пользователь меняет `document-mode` в `main.typ`. Новая задача должна либо быть частой, либо существенно снижать риск потери данных.
|