v0.1.0 First Release

twNetMap v0.1.0 Release Notes

We are excited to announce the release of twNetMap v0.1.0, an AI-powered network discovery tool that automatically generates network maps from scanned network data.

Here is a summary of what's new in this release:

🚀 Key Features

• AI-Powered Topology Inference: Automatically classifies device types (router, switch, wifi, mobile, pc, server, printer, etc.) and reconstructs device links using LLMs (Ollama, OpenAI, Google Gemini). Features a feedback loop that saves manual editing history to improve future AI inferences.
• Active & Passive Network Scanning: Supports multiple IP ranges, UDP ping fallback, SNMP query (v2c/v3) for LLDP neighbors, ARP table extraction (including cross-segment nodes), and banner grabbing.
• Port Scan Modes: Added port scan modes (OFF / Safe / Fast) to minimize firewall blocking by throttling connections or relying on SNMP.
• Interactive Visualizations: Interactive map rendering using vis-network. Supports dragging, adding, editing, and deleting nodes/links, with a new Shift + Click shortcut to quickly connect nodes.
• Flexible Layout Modes: Dynamic switching between Hierarchical 🌲, Force-Directed ⚛️, and Static 📌 layout modes, with node spacing adjustments.
• Rich Data Export: Export maps to PNG, SVG, PDF, Draw.io (.drawio), Map JSON, Raw Scan JSON, CSV Node Lists, and Excel (.xlsx).
• Localization: Added full multi-language support (English and Japanese) with a quick switcher in the header.
• Security: AES-256-GCM encryption for API keys and SNMP credentials.

🔧 Improvements & Bug Fixes

• OS-specific Enhancements:
  • Windows: Executes native ping and arp commands silently without spawning console windows.
  • Linux: Fixed dropdown combobox rendering issues and improved UI visibility.
• Build & CI: Upgraded to Node.js v22 and Go 1.26.5. Resolved CI build issues by using relative paths in wails.json. Added GitHub Pages configuration.
• UI/UX Polishing: Relocated and redesigned navigation buttons, fixed text clipping, and added custom connection style/label settings.
• Data Persistence: Scan results and user-edited layouts are now persistent. The data storage directory can now be customized via startup parameters.

📚 Documentation

• Added detailed installation guides for macOS (signed PKG), Windows (unblocking guide), and Linux (portable tar.gz setup).
• Upgraded development setup documentation to use mise.
• Added feature infographics in both English and Japanese.

twNetMap v0.1.0 リリースノート

スキャンしたデータからネットワークマップを自動生成する、AI搭載ネットワーク検出ツール twNetMap v0.1.0 をリリースしました！

本リリースに含まれる主な新機能と変更点は以下の通りです。

🚀 主な機能

• AI駆動のトポロジー推論: 各種LLM（Ollama、OpenAI、Google Gemini）と連携し、デバイス種別（ルーター、スイッチ、PC、サーバー、プリンターなど）を自動分類。手動による編集履歴（ノード修正、リンク削除など）を学習データとして記憶し、次回の推論に反映するフィードバックループを搭載。
• アクティブ＆パッシブネットワークスキャン: 複数IPレンジ指定、UDP pingのフォールバック対応、SNMP (v2c/v3) によるLLDPネイバーおよび別セグメントのARPテーブル/物理MACの取得に対応。
• ポートスキャンモードの調整: ファイアウォールにブロックされにくい「OFF（SNMP優先・バナー取得のみ）」「安全性重視（同時接続数制限とウェイト）」「高速」の3モードからスキャン挙動を選択可能。
• インタラクティブなマップ表示: vis-network を用いた動的描画。Shift + クリックによるノードのクイック接続、手動での接続追加・編集・削除（ラベルや表示スタイルのカスタマイズ可能）。
• 柔軟な配置（レイアウト）モード: ネットワーク構造を把握しやすい「階層型（🌲）」、物理的につながりが見やすい「力学モデル（⚛️）」、手動配置を維持する「固定配置（📌）」のリアルタイム切り替えとノード間隔調整に対応。
• 多彩なデータエクスポート: PNG、SVG、PDF、Draw.io形式（.drawio）、マップJSON、スキャン生データJSON、ノード一覧（CSV）、Excelドキュメント（.xlsx）でのエクスポートをサポート。
• 多言語（英語・日本語）対応: フロントエンドの完全多言語化と、トップ画面（ヘッダー）からの瞬時の言語切り替え。
• セキュリティ強化: APIキーやSNMP認証情報の保存時に AES-256-GCM 暗号化を適用。

🔧 改善とバグ修正

• OS固有の改善:
  • Windows: ping や arp などのOSコマンドを実行する際、コンソールウィンドウがポップアップしないよう修正。
  • Linux: コンボボックス（プルダウン）の表示崩れを解消し、ダークテーマ時の視認性を改善。
• ビルド・インフラ環境:
  • Go 1.26.5 および Node.js v22 へのアップグレード。
  • wails.json の相対パス指定によるCIビルドエラーの解消。GitHub Pages 向け設定の追加。
• UI/UXのブラッシュアップ: ナビゲーションボタンの位置・カラーを改善。テキストのクリッピング（見切れ）を修正。
• データの永続化と設定: スキャン結果とレイアウトの保存に対応。起動引数によってデータの保存場所を変更できる機能を追加。

📚 ドキュメンテーション

• 各OS向け（macOS用署名・公証済みPKG、Windows用ブロック解除手順、Linux用tar.gz展開手順）のインストールガイドを整備。
• 開発環境の構築手順を mise を用いた構成にアップデート。
• マスコットキャラクターが登場するわかりやすい日本語・英語のインフォグラフィックをREADMEに追加。