---
type: howto
titre: "Installation des Office Add-ins maison OLYMPUS"
dossier: 03_HOWTO
etage: long
source: true        # SOURCE (autorite) - les projections (Chroma/graphe) en derivent
maj: 2026-05-20
hash: ba18e850
---

# Installation des Office Add-ins maison OLYMPUS

> Mission INSTALL-003 — Phase 5 · 2026-05-01

## Vue d'ensemble

Trois add-ins Microsoft Office "taskpane" maison qui parlent à NEXUS :10001 :

| App | Manifest | Taskpane | Scope NEXUS |
|---|---|---|---|
| Word | `C:\OLYMPUS\AGORA\office_addins\word_addin\manifest.xml` | `taskpane.html` | `/api/office/word/*` + `/api/llm/litellm/complete` |
| Excel | `C:\OLYMPUS\AGORA\office_addins\excel_addin\manifest.xml` | `taskpane.html` | `/api/llm/litellm/complete` (insert formule, analyse cellules) |
| PowerPoint | `C:\OLYMPUS\AGORA\office_addins\powerpoint_addin\manifest.xml` | `taskpane.html` | `/api/office/pptx/add_slide` + LLM |

Chaque add-in expose un panneau latéral dans Office avec :
- Une zone de texte pour la demande utilisateur
- Boutons d'action : "Ask Claude (insert)" + endpoint NEXUS spécifique app
- Mini-log live des requêtes

## Pré-requis

1. NEXUS doit tourner : `http://127.0.0.1:10001` (CERBER doit être up)
2. Les fichiers `taskpane.html` doivent être servis statiquement par NEXUS sous `/statique/office_addins/<app>/taskpane.html` — vérifier que le dossier est dans la liste de mounts statiques NEXUS, ou copier les fichiers dans `C:\OLYMPUS\01_SERVEUR\NEXUS\statique\office_addins\<app>\`
3. Microsoft Office (Word, Excel, PowerPoint) en version récente (2019 minimum, 365 idéal)

## Sideloading manifest (méthode 1 — réseau partagé)

Procédure officielle Microsoft "shared folder catalog" :

1. **Créer un dossier réseau partagé** ex `\\PC-VIVIEN\OfficeAddins` (ou un partage local "Microsoft network sharing")
2. **Copier les 3 manifest.xml** dedans :
   ```powershell
   $share = "\\$env:COMPUTERNAME\OfficeAddins"
   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\OfficeAddinsShare"
   Copy-Item "C:\OLYMPUS\AGORA\office_addins\word_addin\manifest.xml" "$env:USERPROFILE\OfficeAddinsShare\OLYMPUS_Word.xml"
   Copy-Item "C:\OLYMPUS\AGORA\office_addins\excel_addin\manifest.xml" "$env:USERPROFILE\OfficeAddinsShare\OLYMPUS_Excel.xml"
   Copy-Item "C:\OLYMPUS\AGORA\office_addins\powerpoint_addin\manifest.xml" "$env:USERPROFILE\OfficeAddinsShare\OLYMPUS_Pptx.xml"
   ```
3. **Partager le dossier** : clic droit → Properties → Sharing → Advanced Sharing → Share this folder
4. **Dans Word/Excel/PowerPoint** :
   - File → Options → Trust Center → Trust Center Settings → Trusted Add-in Catalogs
   - URL = `\\PC-VIVIEN\OfficeAddins` (le chemin UNC)
   - Catalog Name = `OLYMPUS`
   - Cocher "Show in Menu"
   - OK → redémarrer Office
5. **Charger l'add-in** : Insert → My Add-ins → Shared Folder → choisir l'add-in OLYMPUS

## Sideloading manifest (méthode 2 — Microsoft 365 Admin)

Si compte Microsoft 365 entreprise : Admin Center → Settings → Integrated apps → Upload custom apps. Hors-scope si compte perso.

## Vérification post-install

Une fois chargé, tu vois un panneau latéral avec :
- Le titre `🛡️ OLYMPUS · <App> Assistant`
- Une zone de texte
- 2-3 boutons

Test rapide :
1. Tape "Bonjour Claude" dans la zone de texte
2. Clique "Ask Claude (insert at cursor)"
3. La réponse de Claude s'insère dans le doc

Si erreur dans le log :
- "Error: Failed to fetch" → NEXUS down (lance CERBER)
- "Error: CORS" → ajouter Access-Control-Allow-Origin sur les routes /api/llm/litellm/complete
- "InvalidArgs" → l'endpoint /api/office/* attend un payload différent → vérifier les routes existantes

## Sécurité

⚠️ Le manifest autorise `AppDomain = http://127.0.0.1:10001` uniquement. Aucun fetch vers Internet sans modifier le manifest. C'est volontaire pour rester dans l'écosystème OLYMPUS local.

⚠️ `Permissions = ReadWriteDocument` : l'add-in peut lire/modifier le doc actif. Il NE peut pas accéder aux autres docs ou au système.

## Dépannage

| Symptôme | Cause probable | Fix |
|---|---|---|
| Add-in introuvable | Catalog mal configuré | Vérifier UNC path + redémarrer Office |
| Panneau blanc | NEXUS ne sert pas /statique/office_addins/ | Mount statique manquant côté NEXUS |
| Boutons sans effet | CORS bloqué | Logs console F12 dans le panneau |
| "Insertion failed" | Doc en lecture seule | Désactiver protection Office |

## Sideloading manifest (méthode 3 — RAPIDE recommandée pour Office 365 Desktop)

> Ajouté FINALIZE-001 (01/05/2026). Cette méthode contourne le partage UNC et
> charge un add-in privé directement depuis le disque local.

### Pré-requis (mis à jour FINALIZE-001) :
- ✅ NEXUS sert `/statique/office_addins/<app>/taskpane.html` (copié dans `Cockpit/statique/office_addins/`)
- ✅ NEXUS sert `/statique/img/olympus-32.png` et `/statique/img/olympus-80.png` (icônes générées)

### Procédure 3 étapes (Word, Excel, PowerPoint identique)

1. **Word** → onglet **Insertion** → bouton **Mes compléments** (dans certaines versions : "Compléments Office") → cliquer **Gérer mes compléments** → dans le panneau qui s'ouvre, cliquer **Importer un complément privé**.
2. **Pointer vers le manifest** :
   - Word : `C:\OLYMPUS\AGORA\office_addins\word_addin\manifest.xml`
   - Excel : `C:\OLYMPUS\AGORA\office_addins\excel_addin\manifest.xml`
   - PowerPoint : `C:\OLYMPUS\AGORA\office_addins\powerpoint_addin\manifest.xml`
3. Le bouton **Ask Claude** apparaît dans le ruban Office. Cliquer pour ouvrir le taskpane OLYMPUS.

> NB : si la version d'Office ne propose pas l'import privé direct, basculer sur la méthode 1 (shared folder UNC).

## Prochaines étapes (EN_CHANTIER)

- Bouton "Capture screenshot et l'envoyer à Claude vision"
- Mémoriser les conversations dans `/api/memory/mem0`
- Synchronisation automatique des taskpanes : un script `sync_office_addins.py` qui copie depuis `AGORA/office_addins/` vers `Cockpit/statique/office_addins/` au démarrage NEXUS

## Référence

- [Office Add-ins manifest XML](https://learn.microsoft.com/en-us/office/dev/add-ins/develop/add-in-manifests)
- [Sideload via shared folder](https://learn.microsoft.com/en-us/office/dev/add-ins/testing/create-a-network-shared-folder-catalog-for-task-pane-and-content-add-ins)
- INSTALL-003.lock + RAPPORT_INSTALL_003.md

---
_Migre F:->C: par docs_portability_light 2026-05-10_