﻿dCell — что это, где лежит и как удалить
=======================================

ЧТО ЭТО

dCell — надстройка Excel для работы с ИИ-чатом прямо в книге. После установки на ленте Excel
появляется вкладка dCell с кнопкой «Открыть dCell».

КУДА УСТАНОВИЛОСЬ

Программа живёт в одной папке — «доме программы». По умолчанию это C:\dCell:

    <дом>\
      app\     код надстройки (dCell.xll, dCell.config.json, icons\, ribbon.default.json)
      data\    ВСЁ, что создаёт программа: state\ (токен, настройки), backups\ (копии книг),
               logs\ (журналы, в том числе install.log), tmp\, cache\, icons\, work\
      update\  сюда кладутся скачанные обновления
      install.bat, uninstall.bat, uninstall.ps1, README.txt и прочие файлы установщика

Точный дом этой установки написан в начале файла <дом>\data\logs\install.log и в реестре:
HKEY_CURRENT_USER\Software\dCell (значение InstallDir).

Данные отделены от кода нарочно: обновление заменяет папку app\ целиком и НИКОГДА не трогает
data\. Бэкапы книг, введённый токен и настройки при обновлении остаются на месте.

ЧТО СДЕЛАЛ УСТАНОВЩИК

1. разложил app\ и data\, снял с файлов метку «скачано из интернета» (без этого Excel молча
   не загружает надстройку);
2. подключил надстройку к Excel: записал ОДНО значение автозагрузки (OPEN или OPEN<номер>) в
   HKEY_CURRENT_USER\Software\Microsoft\Office\<версия>\Excel\Options. Чужие надстройки не
   тронуты — правится ровно своё значение;
3. проверил установку запуском Excel: заглянул в журнал <дом>\data\logs\dCell.debug.log и
   убедился, что вкладка построена. Проверка идёт в «тихом режиме» (переменная окружения
   DCELL_QUIET_CHECK=1 у процесса Excel): надстройка строит вкладку и НЕ обращается к серверу,
   поэтому лишних окон и запросов при установке не бывает;
   если Excel был запущен до установки — проверка ПРОПУСКАЕТСЯ (запускать второй Excel и
   закрывать ваш открытый Excel установщик не имеет права);
4. записал итог в <дом>\data\logs\install.log — там же построчно видно каждое изменение реестра
   («было → стало»). Если что-то пошло не так, смотрите сначала этот файл.

ЕСЛИ ВКЛАДКИ dCell НЕТ

Проверьте в Excel: Файл → Параметры → Надстройки → внизу «Управление: Надстройки Excel» →
Перейти. В списке должна быть dCell. Если её нет — включите галочку или подключите вручную:
Обзор → <дом>\app\dCell.xll.

САМОЕ ЧАСТОЕ, ЧТО МЕШАЕТ: Центр управления безопасностью Office

Если вкладка не появляется или надстройка отключается сама, посмотрите: Файл → Параметры →
Центр управления безопасностью → Параметры центра управления безопасностью → Надстройки.
Пункт «Требовать подпись надстроек, полученных с веб-сайта» мешает неподписанной надстройке
(подписи у сборки пока нет — это отдельная задача). Установщик этот параметр НЕ меняет: это
настройка безопасности Office, её человек меняет сам и осознанно. Изменение затрагивает Office
целиком, поэтому решение — за вами.

ВТОРАЯ ЧАСТОТАЯ ПРИЧИНА: разрядность Excel

В архиве лежат две сборки: для 64-разрядного (dCell-x64.xll) и для 32-разрядного Excel
(dCell-x86.xll). Установщик сам определяет разрядность Excel и кладёт в app\ ровно одну
сборку — dCell.xll. АРХИВ ОДИН и несёт обе сборки, поэтому «архив под свою разрядность» искать
не нужно: если надстройка не загрузилась, скачайте ТОТ ЖЕ архив dCell-<версия>.zip и запустите
install.bat снова — установщик сам берёт нужную разрядность, найдёт установку и обновит её на
месте, данные не тронув.

ОБНОВЛЕНИЕ

* из нового архива: распакуйте и запустите install.bat — установка будет найдена, обновится
  только app\, папка data\ останется как была;
* из чата (когда доступно): надстройка скачает архив в <дом>\update и применит его при
  закрытом Excel (этим занимается apply-update.cmd).

КАК УДАЛИТЬ

    <дом>\uninstall.bat      ← двойной клик по этому файлу (он лежит рядом с install.bat)

Командную строку вводить не нужно: uninstall.bat сам обходит политику PowerShell и зовёт
uninstall.ps1, а окно оставляет открытым, чтобы вы видели итог и ответили на вопрос о данных.
Если окно закрылось раньше — удаление всё равно сделано или сорвалось; причина написана в
журнале установки (см. «СЛУЖЕБНОЕ» в конце).

Что будет удалено: подключение к Excel (ровно наша запись), указатель HKCU\Software\dCell,
маркер установки, папки app\ и update\.
Папка data\ (бэкапы книг, журналы, токен, свои иконки) удаляется ТОЛЬКО если вы явно ответите
«да» на вопрос об удалении данных. Оставить её без вопроса можно ключом -KeepData:

    <дом>\uninstall.bat -KeepData

Прямой запуск скрипта (как раньше) тоже работает — uninstall.bat лишь зовёт его:

    powershell -ExecutionPolicy Bypass -File "<дом>\uninstall.ps1"

Удаление перед этим закройте Excel: пока он открыт, файлы app\ заняты.

ЧЕГО УСТАНОВЩИК НЕ ДЕЛАЕТ

* не просит прав администратора и ничего не пишет в Program Files (всё — в вашей папке и HKCU);
* не трогает Центр управления безопасностью Office и не включает «доверять надстройкам»;
* не подписывает файлы;
* не закрывает чужой Excel и не удаляет ваши данные без явного ответа.

СЛУЖЕБНОЕ

* журнал установки: <дом>\data\logs\install.log
* журнал надстройки: <дом>\data\logs\dCell.debug.log
* если папку дома удалить не удалось (журнал установщика недоступен) — откат: %TEMP%\dCell-install.log
