README_TW.md

CodeNest

用於管理本機與遠端開發專案的桌面應用程式

English · 简体中文 · 繁體中文

CodeNest 用於集中記錄分散在磁碟、遠端 SSH 主機或不同工作區中的開發專案。你可以為專案維護群組、類型、來源儲存庫、預設編輯器、語言和授權資訊，並從首頁開啟專案或定位到專案路徑。

功能

• 記錄本機專案和遠端 SSH 專案，維護群組、專案類型、來源儲存庫、預設編輯器、授權和語言資訊。
• 設定專案根目錄，或從部分編輯器和 CLI 工具的最近專案記錄中匯入專案。
• 分析專案語言組成，讀取授權片段，並在專案列表和編輯頁中顯示相關資訊。
• 使用多款編輯器和 CLI 工具的啟動設定，也可以自訂開啟命令。
• 從專案列表開啟專案、在檔案管理器中顯示、在終端機中開啟、複製專案路徑，或開啟來源儲存庫連結。
• 手動上傳或下載專案資料到 WebDAV 伺服器；下載前會建立本機備份。

安裝

從 Releases 頁面下載適合你系統的安裝套件。

_{⚠️ macOS 如果提示「檔案已損毀，無法開啟」，請將應用程式拖入「應用程式」後執行：sudo xattr -rd com.apple.quarantine /Applications/CodeNest.app。}

作業系統	最低版本	架構	安裝套件格式
Windows	Windows 10	x64	MSI
macOS	macOS 11 (Big Sur)	Intel / Apple Silicon	DMG
Linux	Ubuntu 20.04 / Fedora 36	x64	AppImage / deb / rpm

快速開始

新增專案

點選「新增專案」按鈕，選擇專案目錄。新增後可以分析語言並讀取授權片段，也可以手動設定專案類型、來源儲存庫和預設編輯器。

批次匯入

進入「設定 > 掃描器」，設定要掃描的目錄或啟用 IDE 歷史匯入，返回首頁點選掃描按鈕即可批次新增專案。

開啟專案

點選專案項目，或使用操作列中的按鈕：

• 在指定 IDE 中開啟
• 在檔案管理器中顯示
• 在終端機中開啟
• 複製專案路徑

資料同步

在「設定 > 資料」中設定 WebDAV 伺服器資訊，可手動上傳或下載專案列表和設定。

開發

環境需求

• Node.js 20+
• Rust stable
• pnpm 11+

快速開始

# 安裝依賴
pnpm install

# 啟動開發伺服器
pnpm dev

# 執行所有檢查
pnpm check

# 建置應用程式
pnpm build:exe    # 僅可執行檔
pnpm build        # 包含安裝套件

專案結構

codenest/
├── src/              # Vue 前端
│   ├── views/        # 頁面元件
│   ├── stores/       # Pinia 狀態
│   ├── components/   # 可重用元件
│   ├── services/     # 業務邏輯
│   └── **/*.test.ts  # 與原始碼共置的前端單元測試
├── src-tauri/        # Rust 後端
│   └── src/          # Tauri 命令

更多開發指南請參考 CLAUDE.md 和 CONTRIBUTING.md。

回饋與貢獻

歡迎透過 GitHub Issues 回報問題或提出建議。

如果你想貢獻程式碼，請先閱讀 貢獻指南。

授權

MIT License © 2024 MidnightCrowing

致謝

本專案使用了以下優秀的開源專案：

• Tauri - 跨平台桌面應用程式框架
• Vue - 漸進式 JavaScript 框架
• Reka UI - 無樣式元件庫
• UnoCSS - 即時按需原子化 CSS 引擎
• Lucide - 開源圖示庫

以及 JetBrains、Microsoft、Anthropic 等公司提供的編輯器圖示資源。

友情連結

• LINUX DO