log
檢視持久化的操作與稽核日誌，用於除錯與合規。
skillshare log # 互動式 TUI（TTY 上預設啟用）
skillshare log --audit # 只顯示稽核日誌
skillshare log --tail 50 # 顯示最後 50 筆
skillshare log --cmd sync # 只顯示 sync 相關項目
skillshare log --status error # 只顯示錯誤
skillshare log --since 2d # 最近 2 天的項目
skillshare log --stats # 顯示摘要統計
skillshare log --json # 以 JSONL 輸出
skillshare log --no-tui # 純文字輸出
skillshare log --clear # 清除操作日誌
skillshare log -p # Project 的操作 + 稽核日誌
何時使用
- 互動式瀏覽並篩選日誌項目
- 除錯失敗操作的發生原因
- 檢視稽核軌跡以進行合規或疑難排解
- 依指令、狀態或時間範圍篩選日誌以進行調查
互動式 TUI
在 TTY 上，skillshare log 會啟動一個互動式終端機 UI，具備：
- 模糊篩選——輸入文字以依時間戳、指令、狀態、來源或詳細內容篩選
- 鍵盤導覽——方向鍵瀏覽，
q離開 - 詳細面板——顯示所選項目的完整時間戳、指令、狀態、持續時間、來源及結構化參數
- 統計頁尾——始終可見的精簡摘要：操作數、成功率、最後一次操作
- 統計面板——按
s切換依指令分類的完整成功/失敗次數統計 - 合併檢視——同時檢視兩者時，操作與稽核項目會合併並依時間排序
使用 --no-tui 跳過 TUI，改印出純文字：
skillshare log --no-tui # 純文字輸出
skillshare log --no-tui | less # 手動接到 pager
記錄了什麼
每個會變更狀態的 CLI 與 Web UI 操作，都會被記錄為一筆 JSONL 項目，包含時間戳、指令、狀態、持續時間及情境參數。
| 指令 | 日誌檔案 |
|---|---|
install, uninstall, sync, push, pull, collect, backup, restore, update, target, trash, config, check, diff, init, upgrade | operations.log |
audit | audit.log |
呼叫這些 API 的 Web UI 動作，記錄方式與 CLI 操作相同。
日誌類型
預設檢視
在一次輸出中顯示兩個區段：
- Operations 日誌
- Audit 日誌
skillshare log
僅稽核檢視
將安全稽核掃描與一般操作分開記錄。
skillshare log --audit
篩選
依指令、狀態或時間範圍縮小結果範圍。當 --cmd 指定的指令只出現在特定日誌中時（例如 --cmd audit 只會出現在 audit.log 中），不相關的區段會自動跳過。
skillshare log --cmd install # 只顯示 install 項目
skillshare log --status error # 只顯示錯誤
skillshare log --since 1h # 最近一小時（也支援：30m, 2d, 1w）
skillshare log --since 2026-01-15 # 自特定日期起
skillshare log --cmd sync --status error # 合併多個篩選條件
JSON 輸出
輸出原始 JSONL，供腳本與自動化使用：
skillshare log --json # 所有項目以 JSONL 輸出
skillshare log --json --cmd sync # 篩選後的 JSONL
範例輸出（純文字）
使用 --no-tui 或在非 TTY 環境中：
┌─ skillshare log ────────────────────────────────────┐
│ Operations (last 2) │
│ mode: global │
│ file: ~/.local/state/skillshare/logs/operations.log │
└─────────────────────────────────────────────────────┘
TIME | CMD | STATUS | DUR
-----------------+-----------+---------+--------
2026-02-10 14:31 | SYNC | error | 0.8s
targets: 3
failed: 1
scope: global
2026-02-10 14:35 | SYNC | ok | 0.3s
targets: 3
scope: global
┌─ skillshare log ────────────────────────────────────┐
│ Audit (last 1) │
│ mode: global │
│ file: ~/.local/state/skillshare/logs/audit.log │
└─────────────────────────────────────────────────────┘
TIME | CMD | STATUS | DUR
-----------------+-----------+---------+--------
2026-02-10 14:36 | AUDIT | blocked | 1.1s
scope: all-skills
scanned: 12
passed: 11
failed: 1
failed skills:
- prompt-injection-skill
- data-exfil-skill
日誌格式
項目以 JSONL 格式儲存（每行一個 JSON 物件）：
{"ts":"2026-02-10T14:30:00Z","cmd":"install","args":{"source":"anthropics/skills/pdf"},"status":"ok","ms":1200}
| 欄位 | 說明 |
|---|---|
ts | ISO 8601 時間戳 |
cmd | 指令名稱 |
args | 指令特定情境（source、name、target 等） |
status | ok、error、partial 或 blocked |
msg | 錯誤訊息（當 status 不是 ok 時） |
ms | 持續時間（毫秒） |
日誌位置
~/.local/state/skillshare/logs/operations.log # Global operations
~/.local/state/skillshare/logs/audit.log # Global audit
<project>/.skillshare/logs/operations.log # Project operations
<project>/.skillshare/logs/audit.log # Project audit
在 Git 中追蹤日誌（Project Mode）
Project mode 預設會忽略 .skillshare/logs/，以避免產生雜訊過多的 commits。
如果你的團隊想要對日誌檔案進行版本控制，請在 .skillshare/.gitignore 的受管理區塊之後，加入這些使用者覆寫規則：
# User override: track logs
!logs/
!logs/*.log
如果你的 repository 根目錄的 .gitignore 也忽略了 .skillshare/，請在那裡一併加入對應的取消忽略規則。
選項
| Flag | 說明 |
|---|---|
-a, --audit | 只顯示稽核日誌 |
-t, --tail <N> | 顯示最後 N 筆項目（預設：20） |
--cmd <name> | 依指令名稱篩選（例如 sync、install、audit） |
--status <status> | 依狀態篩選（ok、error、partial、blocked） |
--since <dur|date> | 依時間篩選（30m、2h、2d、1w，或 2006-01-02） |
--stats | 顯示摘要統計（總數、成功率、依指令細分） |
--json | 輸出原始 JSONL（每行一個 JSON 物件） |
--no-tui | 停用互動式 TUI，改用純文字輸出 |
-c, --clear | 清除選定的日誌檔案（預設為 operations，加 --audit 則為 audit） |
-p, --project | 使用 project 層級日誌 |
-g, --global | 使用 global 層級日誌 |
-h, --help | 顯示說明 |
Web UI
日誌也可以在 Web dashboard 的 /log 頁面中檢視：
skillshare ui
# 導覽至 Log 頁面
Log 頁面提供：
All、Operations與Audit分頁- 依指令、狀態與時間範圍（1h、24h、7d、30d）篩選
- 含時間、指令、詳情、狀態與持續時間的表格檢視
- 有失敗/警告 skill 名稱時顯示的稽核詳細列
- 清除與重新整理控制項
統計檢視
CLI
skillshare log --stats # 所有操作的摘要
skillshare log --stats --cmd sync # 只顯示 sync 的統計
skillshare log --stats --since 7d # 最近 7 天的統計
TUI
在 TUI 中按 s 切換統計面板，顯示：
- 總操作數與依指令細分的水平長條圖
- 每個指令的成功/失敗次數（顏色標示）
- 整體成功率與視覺化進度條
- 最後一次操作的時間戳
頁尾列會始終顯示精簡摘要：20 ops | ✓ 92.3% | last: sync 2h ago
詳細面板捲動
當日誌項目的詳細內容很長時（例如包含許多 skills 的稽核結果），使用 j/k 上下捲動詳細面板。
日誌保留
日誌會自動截斷以避免無限成長。預設限制為每個日誌檔案 1000 筆項目（每次 CLI 或 Web UI 操作 = 1 筆項目）。operations.log 與 audit.log 分別追蹤。
若要覆寫預設值，請在 config.yaml 中加入：
log:
max_entries: 500 # entries per file; 0 = unlimited (default: 1000)