Czym jest hdev?

hdev to edytor kodu działający w terminalu (TUI — Terminal User Interface), zaprojektowany jako natywny edytor systemu HackerOS. Wzorowany na Visual Studio Code, oferuje zakładki plików, panel drzewa plików, pełne podświetlanie składni, zintegrowany terminal i rynek rozszerzeń — wszystko wewnątrz terminala, bez GUI.

Napisany w Rust z biblioteką Ratatui, co zapewnia maksymalną wydajność, małe zużycie pamięci i pełną kontrolę nad każdym pikselem renderowania.

Instalacja

Wymagania systemowe

Budowanie i instalacja

# 1. Zainstaluj Rust (jeśli brak)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 2. Pobierz hdev
git clone https://github.com/HackerOS-Linux-System/hdev
cd hdev

# 3. Zbuduj wersję release
cargo build --release

# 4. Zainstaluj globalnie
sudo cp target/release/hdev /usr/local/bin/

# 5. Sprawdź instalację
hdev --version
bash

HackerOS (paczka systemowa)

# W HackerOS hdev jest częścią systemu
hpkg install hdev         # przez menadżer pakietów HackerOS
hsh

Szybki start

# Otwórz hdev w bieżącym katalogu
hdev

# Otwórz konkretny plik
hdev src/main.rs

# Otwórz folder (ładuje drzewo plików)
hdev ~/projects/my-hackeros-app

# Wyjdź z hdev
Ctrl+Q
bash

Po uruchomieniu bez argumentu pojawia się Welcome Screen. Nawigujesz strzałkami ↑ ↓, wybierasz Enter:

Layout ekranu

Skróty klawiszowe

Globalne

Pliki i zakładki

Widok i panele

Nawigacja w edytorze

Edycja tekstu

Wyszukiwanie

Wyszukiwanie podświetla wszystkie wystąpienia frazy w pliku na żółto. Licznik pokazuje n/total w rogu paska.

Drzewo plików

Auto-pair

hdev automatycznie zamyka nawiasy i cudzysłowy:

Undo / Redo

Historia cofania jest przechowywana na stosie do 200 wpisów per bufor. Każda zmiana tekstu (znak, newline, tab, delete) tworzy wpis. Undo i Redo nie są kasowane przez nawigację kursora — tylko przez nowe zmiany po Undo.

Panel terminala

Naciśnięcie Ctrl+B otwiera panel terminala na dole ekranu — identycznie jak w Visual Studio Code. Ponowne Ctrl+B zamyka panel.

Integracja z hsh

Każda komenda wpisana w terminalu hdev jest wykonywana przez hsh (shell HackerOS). Jeśli hsh nie jest zainstalowany, hdev używa /bin/sh jako fallback.

# Sposób wywołania komendy:
hsh -c "twoja komenda tutaj"

# Przykłady działające w terminalu hdev:
hl skrypt.hl           # uruchom Hacker Lang
cargo build --release  # buduj Rust
python3 main.py        # uruchom Python
git status             # git
cd ../inny-projekt     # zmień katalog (wbudowane)
clear                  # wyczyść output
hsh

Obsługiwane języki

hdev rozpoznaje języki automatycznie na podstawie rozszerzenia pliku i podświetla składnię z użyciem wbudowanego silnika leksykalnego.

Formaty konfiguracyjne

Hacker Lang (.hl)

hdev ma wbudowaną pełną obsługę Hacker Lang v0.3 — natywnego języka skryptowego HackerOS. Silnik podświetlania rozpoznaje wszystkie operatory, zmienne, komentarze i słowa kluczowe.

;;; Przykład pełnego skryptu Hacker Lang

// curl

% target  = 192.168.1.1
% port    = 22
% debug   = true

: scan def
    ~> Skanowanie @target:@port...
    ::hr 40
    >> nmap -p @port @target

    ? ok
        ::green Port otwarty!
    done

    ? err
        ::red Błąd skanowania.
    done
done

-- scan
.hl

Hacker Lang++ (.hlpp) — BETA

Hacker Lang++ to rozszerzona wersja Hacker Lang, aktualnie w intensywnym rozwoju. hdev obsługuje pliki .hlpp i stosuje do nich te same reguły podświetlania co dla .hl, z dodatkowym oznaczeniem BETA na pasku statusu.

H# (.hs)

H# to kompilowany język programowania napisany w Rust, przeznaczony dla HackerOS. hdev rozpoznaje składnię H# v0.2 i podświetla:

// H# — przykład prostego programu

use std::net;

struct Scanner {
    target: String,
    port: u16,
}

impl Scanner {
    fn run(&self) -> bool {
        let result = net::connect(&self.target, self.port);
        match result {
            Ok(_) => true,
            Err(_) => false,
        }
    }
}

fn main() {
    let s = Scanner { target: "192.168.1.1".into(), port: 22 };
    println("Otwarty: {}", s.run());
}
.hs

Formaty konfiguracyjne

JSON

Klucze podświetlone na niebiesko, wartości na zielono, typy (true/false/null) na fioletowo.

{
  "name": "HackerOS",
  "version": 0.3,
  "debug": true,
  "plugins": ["hl-support", "git-panel"]
}
.json

YAML

Klucze na niebiesko, wartości na zielono, komentarze # na szaro, sekcje pogrubione.

# Konfiguracja serwera
server:
  host: 0.0.0.0
  port: 8080
  tls: true
database:
  url: postgres://localhost/hackeros
.yaml

TOML

# hdev config
[package]
name = "hdev"
version = "0.1.0"

[dependencies]
ratatui = "0.29"
crossterm = "0.28"
.toml

Format .hk (Plugin)

Pliki .hk to format pluginów hdev, parsowany przez hk-parser. hdev stosuje specjalne podświetlanie dedykowane dla tego formatu:

# Plugin hdev — przykład
[metadata]
name = "hl-enhanced"
version = "1.0.0"
author = "HackerOS Team"
description = "Enhanced Hacker Lang support"

[hooks]
on_file_open = "hl_check $FILE"
on_save      = "hl_lint $FILE"

[syntax]
extensions = ".hl .hlpp"
comment    = ";;"
.hk

Marketplace

Marketplace (Ctrl+M) to panel do przeglądania i instalowania rozszerzeń hdev. W wersji v0.1.0 pełna funkcjonalność jest placeholderem — interfejs jest gotowy, a backend do pobierania i instalowania pluginów jest planowany w przyszłych wersjach.

Kategorie pluginów

System pluginów (.hk)

Pluginy hdev są plikami w formacie .hk — parsowanymi przez bibliotekę hk-parser. Plik pluginu opisuje metadane, hooki i konfigurację rozszerzenia.

Instalacja pluginów

Pluginy instaluje się ręcznie (do momentu uruchomienia pełnego Marketplace):

# Folder pluginów hdev
~/.cache/HackerOS/hdev/plugins/

# Skopiuj plik .hk do folderu
cp mój-plugin.hk ~/.cache/HackerOS/hdev/plugins/

# Odśwież hdev (Ctrl+R lub restart)
bash

Tworzenie pluginu

# Minimalna struktura pliku .hk

[metadata]
name        = "mój-plugin"
version     = "0.1.0"
author      = "Twoje Imię"
description = "Krótki opis pluginu"
hdev_min    = "0.1.0"

[syntax]
extensions  = ".myext"
comment     = "#"
keywords    = "begin end if else"

[hooks]
on_save     = "mylinter $FILE"
on_open     = "echo 'otwarto plik'"
.hk

Konfiguracja (config.json)

Wszystkie ustawienia hdev są przechowywane w pliku JSON. Możesz je edytować przez panel Ustawień (Ctrl+,) lub bezpośrednio w pliku.

Ścieżki plików

Pełny plik config.json

{
  "theme":             "hacker-dark",
  "font_size":         14,
  "tab_size":          4,
  "auto_save":         true,
  "show_line_numbers": true,
  "show_file_tree":    true,
  "word_wrap":         false,
  "last_opened_path":  null,
  "recent_files":      ["~/projects/main.hl"],
  "installed_plugins": ["hl-support"],
  "marketplace_url":   "https://marketplace.hackeros.dev",
  "terminal_shell":    "hsh"
}
json

Sesja

Przy zamknięciu hdev zapisuje do session.json listę otwartych plików. Przy następnym uruchomieniu bez argumentów hdev nie przywraca automatycznie sesji — pliki są dostępne w sekcji Recent na Welcome Screen.

Budowanie ze źródeł

# Debug (szybki build, bez optymalizacji)
cargo build

# Release (pełna optymalizacja)
cargo build --release

# Uruchom bez instalacji
cargo run -- /ścieżka/do/pliku

# Sprawdź błędy (bez budowania)
cargo check

# Linter
cargo clippy
bash

Architektura

hdev używa modelu event loop opartego na crossterm — bez async/tokio, co zapewnia deterministyczne zachowanie i minimalny overhead.

Contributing

hdev jest częścią ekosystemu HackerOS. Wkład jest mile widziany przez pull requesty na GitHubie.

Jak dodać nowy język?

1. Dodaj wariant do enum Language w languages.rs
2. Dodaj rozszerzenie w Language::from_extension()
3. Uzupełnij display_name(), icon(), icon_color(), keywords(), comment_single()
4. Jeśli potrzebujesz specjalnego tokenizatora — dodaj funkcję w highlight.rs i wywołaj ją w Highlighter::highlight_line()
5. Przetestuj otwierając plik z nowym rozszerzeniem

hdev v0.1.0  ·  HackerOS Project  ·  Dokumentacja wygenerowana dla Hacker Lang, H#, i ekosystemu HackerOS  ·  hackeros website ↗