Проверка скриптов для Microsoft 365

Текст

---
name: verify
description: Проверяет изменения в административных скриптах и командах claude-for-msft-365-install, запуская их в изолированном фиктивном $HOME.
---

Проверка claude-for-msft-365-install

Этот плагин — административный инструмент командной строки, а не приложение. Собирать нечего, запускать сервер не нужно. Работа идёт в терминале: scripts/*.sh на macOS, scripts/*.ps1 на Windows.

Линтер-проверка

python3 scripts/check.py           # from the REPO ROOT, not the plugin dir
bash -n claude-for-msft-365-install/scripts/<script>.sh

check.py проверяет линтером каждый манифест и сам устанавливает хук pre-commit, который повышает патч-версию в .claude-plugin/plugin.json. Запускай перед коммитом.

Запускай скрипты в фиктивном $HOME

Каждый скрипт для macOS берёт пути Office из $HOME, поэтому подмена этой переменной даёт одноразовую песочницу: можно прогонять разрушительные ветки --apply, не трогая настоящие данные Office.

S=<scratchpad>/sandbox
for app in Excel Word Powerpoint; do
  mkdir -p "$S/Library/Containers/com.microsoft.$app/Data/Documents/wef"
done
printf '<x/>' > "$S/Library/Containers/com.microsoft.Excel/Data/Documents/wef/aaaaaaaa-1111-1111-1111-111111111111.manifest-a.xml"

HOME=$S ./scripts/clear-addin-cache.sh                      # list
HOME=$S ./scripts/clear-addin-cache.sh --id <GUID>          # dry-run
HOME=$S ./scripts/clear-addin-cache.sh --id <GUID> --apply  # destructive

Заложи как минимум два идентификатора в двух приложениях, с буквами в разном регистре. Оба условия уже выявляли настоящие ошибки: затрагивание чужого приложения и чувствительный к регистру шаблон имён, который сообщал «уже чисто» и отправлял администраторов стирать всю папку целиком.

Докажи, что хранилище сохраняется

Главное обещание этого плагина: очистка манифеста никогда не затрагивает историю чатов пользователя. Проверь это сравнением снимков обоих деревьев до и после операции, на настоящем $HOME:

snap() {
  for app in Excel Word Powerpoint; do
    find "$HOME/Library/Containers/com.microsoft.$app/Data/Library/WebKit/WebsiteData" \
         -type f -exec stat -f '%N %z %m' {} \; 2>/dev/null
    find "$HOME/Library/Containers/com.microsoft.$app/Data/Documents/wef" \
         -type f -exec stat -f 'WEF %N %z' {} \; 2>/dev/null
  done | sort
}
snap > before.txt;  <run the script>;  snap > after.txt;  diff before.txt after.txt

Манифесты лежат в Data/Documents/wef, хранилище — в Data/Library/WebKit/WebsiteData. Это разные поддеревья, поэтому diff должен показать только удалённый тобой манифест. Верни все подложенные файлы на место и снова сравни: убедись, что оставил машину в том виде, в каком её нашёл.

Подводные камни

• Инструмент Bash запускает zsh. Скрипты написаны под #!/usr/bin/env bash; поведение, свойственное только bash (shopt, правила подстановки шаблонов), проверяй внутри bash <<'EOF' … EOF, а не прямо в строке.
• **PRAGMA integrity_check и SELECT count(*) не работают на выгруженных файлах IndexedDB** и выдают no such collation sequence: IDBKEY. Это особая сортировка WebKit, а не повреждение: на исходном файле происходит то же самое. Полноту проверяй запросом SELECT sum(length(value)) FROM Records; с обеих сторон.
• **Никогда не утверждай, что скрипты .ps1 работают, если не запускал их на Windows.** В macOS нет PowerShell, поэтому изменение в .ps1, проверенное только здесь, считается непроверенным. Запускай его на настоящем компьютере с Windows в Windows PowerShell 5.1 и всегда выполняй проверку разбора до проверок поведения:

``powershell $e = $null [System.Management.Automation.PSParser]::Tokenize( (Get-Content -Raw .\clear-addin-cache.ps1), [ref]$e) | Out-Null if ($e.Count) { $e | ForEach-Object { $_.Message } } else { 'parse ok' } ``

Файл может прекрасно работать на macOS и полностью не разбираться в Windows (см. замечание про ASCII ниже), поэтому в первую очередь нужно убедиться, что разбор проходит.

• **Файлы .ps1 должны состоять только из ASCII** (проверяется в scripts/check.py). Windows PowerShell 5.1 читает .ps1 без BOM как ANSI, поэтому длинное тире превращается в «кракозябры» с символом ", который закрывает строку и ломает разбор. clear-addin-cache.ps1 вышел сломанным именно так, и ни одна проверка на macOS этого не поймала.
• Проверяй разбор аргументов. Если --flag стоит последним аргументом, shift 2 падает при set -e и скрипт завершается с кодом 1 без вывода; каждому флагу нужна защита [ $# -ge 2 ].

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/financial-services/tree/main/claude-for-msft-365-install/.claude/skills/verify, лицензия Apache-2.0. Изменения: перевод на русский язык.