mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-17 04:23:16 +08:00
统一技能安装与 Skills 市场接入链路。
新增公开安装工具与多来源 provider 支持,补齐管理端与目录加载逻辑,并同步更新相关测试与文档以保证可见性和路径安全。 Made-with: Cursor
This commit is contained in:
parent
d5e30542aa
commit
4d9232f3b3
66 changed files with 7369 additions and 1099 deletions
61
runtime/skills/xlsx-pro/README.md
Normal file
61
runtime/skills/xlsx-pro/README.md
Normal file
|
|
@ -0,0 +1,61 @@
|
|||
# XLSX Pro
|
||||
|
||||
 
|
||||
|
||||
Un skill **Clawdbot / OpenClawd** pour générer et modifier des fichiers Excel **propres** (XLSX / XLSM / CSV / TSV) avec :
|
||||
- formatage “pro”
|
||||
- **formules Excel** (au lieu de valeurs hardcodées)
|
||||
- recalcul optionnel des formules via **LibreOffice headless**
|
||||
- contrôle qualité : détection des erreurs Excel (`#REF!`, `#DIV/0!`, `#VALUE!`, `#N/A`, `#NAME?`, …)
|
||||
|
||||
## Pourquoi ce skill ?
|
||||
|
||||
`openpyxl` sait **écrire** des formules, mais ne sait pas **calculer** leurs résultats. En production, ça crée des fichiers où les formules ne sont pas évaluées et où les erreurs ne sont pas détectées.
|
||||
|
||||
`XLSX Pro` ajoute une étape serveur fiable : **recalcul via LibreOffice** + scan d’erreurs.
|
||||
|
||||
## Prérequis
|
||||
|
||||
### Python
|
||||
```bash
|
||||
pip install openpyxl pandas xlrd xlwt
|
||||
```
|
||||
|
||||
### LibreOffice (uniquement si tu veux recalculer les formules)
|
||||
Ubuntu/Debian :
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y libreoffice-calc libreoffice-common
|
||||
```
|
||||
|
||||
## Quickstart
|
||||
|
||||
### 1) Générer un fichier Excel (avec openpyxl)
|
||||
Tu peux créer ton `.xlsx` comme d’habitude en Python, en mettant des **formules** dans les cellules.
|
||||
|
||||
### 2) Recalculer + valider
|
||||
```bash
|
||||
python scripts/recalc.py ton_fichier.xlsx 60
|
||||
```
|
||||
|
||||
Sortie JSON :
|
||||
- `status: success | errors_found`
|
||||
- `total_errors`
|
||||
- `error_summary` (types + emplacements)
|
||||
- `total_formulas`
|
||||
|
||||
## Bonnes pratiques (résumé)
|
||||
- **Préférer les formules Excel** plutôt que calculer en Python puis écrire des valeurs.
|
||||
- **Zéro erreur de formule** dans le livrable.
|
||||
- Si tu modifies un template existant : **respecte exactement** les styles/conventions.
|
||||
|
||||
## Troubleshooting
|
||||
- Si `soffice` est introuvable : installe LibreOffice (voir Prérequis).
|
||||
- Si le recalcul “timeout” : augmente le timeout (2e argument) et/ou teste sur un fichier plus petit.
|
||||
- Si erreur du type "macro mal configurée" / "macro not configured" : supprime le fichier de macro puis relance :
|
||||
- Linux : `~/.config/libreoffice/4/user/basic/Standard/Module1.xba`
|
||||
- macOS : `~/Library/Application Support/LibreOffice/4/user/basic/Standard/Module1.xba`
|
||||
- En conteneur (Docker) : ajoute la variable d'env `SAL_USE_VCLPLUGIN=svp` (ça évite des soucis d'UI en headless).
|
||||
|
||||
## Licence
|
||||
MIT (à ajuster si tu veux une autre licence).
|
||||
Loading…
Add table
Add a link
Reference in a new issue