Windows + кириллица в имени пользователя

Симптомы

• При попытке запустить любую задачу — красная плашка «Unexpected server error».
• В DevTools (если вы их откроете через Ctrl+Shift+I) — сотни запросов на http://127.0.0.1:.../workspace/... с кодом 500 Internal Server Error.
• Кнопка «Запустить задачу» серая или нажимается, но ничего не происходит.

Причина

Это происходит, если ваше имя пользователя Windows содержит кириллические буквы: например, Алиссина, Сергей, Ольга. В Windows домашняя папка такого пользователя — C:\Users\Алиссина\.

Локальный движок tirCoWork (он работает «внутри» приложения) хранит свои рабочие файлы в этой папке. К сожалению, некоторые библиотеки Node.js на Windows плохо работают с кириллицей в путях — в результате движок «видит» свои файлы, но не может их прочитать или записать.

Что мы уже сделали

Начиная с версии 0.14.0-rc.11 (и выше) tirCoWork автоматически определяет такую ситуацию и переключается на «короткое» 8.3-имя папки (C:\Users\АЛИССИ~1\). Это специальный Windows-механизм, который заменяет кириллические буквы на ASCII.

В большинстве случаев это полностью решает проблему — задачи начинают работать как обычно. Никаких настроек делать не нужно.

Если всё ещё не работает

Если вы обновились на rc.11+ и проблема осталась — есть три варианта.

1. Создать новый Windows-аккаунт с латинским именем

Это самое надёжное решение.

1. Откройте Параметры Windows → Учётные записи → Семья и другие пользователи.
2. Нажмите «Добавить пользователя для этого компьютера».
3. Введите имя латинскими буквами — например Tirco или Work.
4. Дайте этому пользователю права администратора (там же в его настройках).
5. Перелогиньтесь в новый аккаунт.
6. Установите tirCoWork заново — теперь он будет работать в папке C:\Users\Tirco\ без кириллицы.

Файлы клиентов можно держать где угодно — например, в C:\Документы\Ромашка\ или на рабочем столе. Главное — чтобы домашняя папка пользователя была без кириллицы.

2. Поменять имя текущего аккаунта

Это сложнее и менее надёжно — переименование C:\Users\<имя>\ в Windows официально не поддерживается. Но если очень хочется — гуглите «как переименовать папку пользователя Windows 11» (требует правки реестра, риск сломать систему).

Мы не рекомендуем этот путь. Создать новый аккаунт быстрее и безопаснее.

3. Прислать нам отчёт

Если ни один способ не помог:

1. Откройте DevTools в tirCoWork: Ctrl+Shift+I.
2. Переключитесь на вкладку Console.
3. Сделайте скриншот ошибок (красные строки).
4. Напишите нам на support@tircowork.ru с прикреплённым скриншотом и кратким описанием.

Мы добавляем исправления в каждом обновлении.

Почему так получилось

Это известная проблема многих программ, разработанных на основе Node.js (Electron-приложения, VS Code, Discord и др.) — некоторые встроенные библиотеки Node когда-то были написаны с предположением, что пути состоят только из ASCII-символов.

Лучшее долгосрочное решение — создание Windows-аккаунта с латинским именем; такой подход рекомендуют и другие крупные программы.