任务文件浏览器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install task-files-explorer
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 task-files-explorer。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

任务文件浏览器是一个 Openclaw Skills 工作流，用于将平台的“任务中的所有文件”预览体验替换为自定义的持久化 HTML 文件仪表板。它在 127.0.0.1:3000 上运行零依赖的 Python 标准库服务器，并通过平台预览入口公开界面。

应用场景

替换会在不需要的浏览器标签页中打开文件的“任务中的所有文件”弹窗。

工作原理

平台预览 URL 通过端口 81 上的入口转发到容器的 127.0.0.1:3000 上游。

配置指南

新容器

数据架构

运行时文件和职责

高级特性

setsid
和 PPID 1 行为实现双重 fork 孤儿守护进程化，以便在工具调用完成后继续运行。

name: task-files-explorer description: MANDATORY when the user wants to replace, bypass, or stop relying on the platform "All files in task" preview popup; when they want a custom HTML page (index.html) served on the platform preview URL; when they want a persistent file dashboard/explorer for download/ and archive/ served by a custom dev.sh; or when they ask how to make scripts survive container restarts via the /start.sh boot hook. Deploys a zero-dependency Python explorer to 127.0.0.1:3000 (the upstream of the preview ingress) with search, type filters, sorting, inline preview (md, images, pdf, json, text) and per-task grouping parsed automatically from worklog.md. Auto-starts on every container boot, self-heals every 30 seconds via watcher. NOT for Next.js/web-app projects - the web dev server always owns port 3000.

Task Files Explorer — Pengganti Fungsional Popup "All files in task" 0. Kapan Skill Ini Dipakai / When to Use

Gunakan skill ini bila user (ID/EN):

kesal dengan popup preview "All files in task" yang membuka semua tab sendiri, dan ingin penggantinya;
meminta halaman web / index.html custom yang tampil di preview URL platform;
ingin dashboard file persisten (download/ + archive/) yang hidup otomatis tiap boot;
bertanya cara membuat skrip bertahan lintas restart container (via hook /start.sh).

Jangan pakai bila proyeknya aplikasi web interaktif (Next.js dsb.) — server web proyek selalu lebih berhak atas port 3000; explorer otomatis berdiri down (guard ada di explorer.sh).

1. Arsitektur (Diverifikasi Empiris) preview-.space-z.ai (frontend platform — popup tinggal diabaikan) -> ingress platform :81 (reverse-proxy milik root, env FC_CUSTOM_LISTEN_PORT) -> 127.0.0.1:3000 (upstream — SISI KITA) -> explorer.py (server stdlib Python, UI kreatif explorer-ui/index.html)

Fakta kunci yang membuat ini bisa bekerja:

Port 81 di container adalah ingress preview; saat upstream 3000 kosong ia menjawab 502 halaman placeholder — begitu ada server di 3000, seluruh preview URL menampilkan server itu.
Popup "All files in task" adalah frontend browser platform — TIDAK bisa dimatikan dari container; yang bisa diganti adalah ISI preview URL. Strategi: popup diabaikan, explorer menjadi tujuan utama.
Proses biasa mati saat tool call selesai (platform membunuh pohon turunan PPID); satu-satunya cara daemon hidup terus = double-fork orphan (PPID=1 + setsid). 2. Langkah Deploy Kasus A — container baru (belum ada .zscripts/dev.sh)
Salin assets ke lokasi aktif: mkdir -p ~/.zscripts/explorer-ui (root proyek: /home/z/my-project) cp assets/explorer.py assets/explorer.sh
/.zscripts/ cp assets/explorer-ui/index.html
/.zscripts/explorer-ui/ cp assets/dev.sh.template
/.zscripts/dev.sh && chmod +x
/.zscripts/dev.sh
Jalankan sekali: bash
/.zscripts/explorer.sh --ensure
Mulai sekarang setiap boot container, /start.sh menjalankan dev.sh yang menghidupkan explorer + watcher (auto-heal) secara otomatis.
Kasus B — dev.sh sudah ada (jangan ditimpa!)
Salin explorer.py, explorer.sh, explorer-ui/ seperti di atas.
Tambahkan blok berikut di akhir dev.sh (sebelum baris log terakhir):

if [ -f "$PROJECT/.zscripts/explorer.sh" ]; then

bash "$PROJECT/.zscripts/explorer.sh" --ensure >> "$BOOTLOG" 2>&1 || log "WARN: explorer gagal"

fi

(Opsional tapi disarankan) tambahkan health-check 30 dtk di loop watcher — salin pola dari assets/dev.sh.template seksi 3-4.
Jalankan bash .zscripts/explorer.sh --ensure. 3. Aturan Konflik Port (WAJIB dihormati) package.json ada di root proyek -> Next.js pemilik :3000 -> explorer STAND-DOWN.
Port 3000 dipakai proses lain yang bukan explorer -> explorer menolak start (log saja).
Explorer bind 127.0.0.1 saja — tidak pernah expose langsung ke luar; akses luar selalu lewat ingress platform. 4. Lapisan Persistensi (kenapa tahan platform reset) repo.tar pre-stop — platform mem-pack volume persisten sebelum stop; .zscripts/ ikut ter-backup (terverifikasi: entri .zscripts ada di dalam tar).
Hook /start.sh — setiap boot menjalankan .zscripts/dev.sh bila ada.
dev.sh v1.2 — memanggil explorer.sh --ensure + watcher.sh --ensure.
watcher 30 dtk — auto-heal bila explorer mati (terverifikasi empiris: kill -9 -> hidup lagi dalam