Lilith Shell

🚀 Lilith-shell 項目

Lilith-shell 是一款功能強大的工具，它允許用戶在 Claude Desktop 中藉助自定義的 shell 環境執行命令。此項目是 Pandora-shell 的分支版本，在安全性、測試性和功能性等方面進行了顯著增強。

🚀 快速開始

Lilith-shell 能讓你在 Claude Desktop 中通過自定義 shell 環境執行命令。以下是使用前的準備步驟。

📦 安裝指南

項目克隆與依賴安裝

1. 克隆項目倉庫：

   git clone https://github.com/yourusername/Lilith-Shell.git
   cd Lilith-Shell
   

2. 創建並激活虛擬環境（推薦）：
   • 對於 macOS/Linux 系統：

     python -m venv venv
     source venv/bin/activate
     

   • 對於 Windows 系統：

     python -m venv venv
     .\venv\Scripts\activate
     

3. 安裝依賴項：

   pip install -r requirements.txt
   

📚 詳細文檔

配置指南

項目路徑設置

要確保將 Lilith-Shell 項目的完整路徑添加到系統的環境變量中。

環境變量配置

根據你的操作系統，編輯或創建以下文件：

• Windows 系統
  1. 打開 System Environment Variables。
  2. 添加或修改以下變量：
     • Path：將 %APPDATA%\Lilith-Shell\bin 添加到系統路徑中。
• macOS/Linux 系統
  1. 打開終端並編輯 .bashrc 或 .zshrc 文件：

     nano ~/.bashrc
     

  2. 在文件末尾添加以下內容：

     export PATH=$PATH:/path/to/Lilith-Shell/bin
     

  3. 保存並退出，然後運行 source ~/.bashrc 使配置生效。

使用指南

啟動服務

在項目的根目錄中啟動 Lilith-shell 服務：

# 對於 macOS/Linux 系統：
python src/lilith_shell/executor.py

# 對於 Windows 系統：
.\venv\Scripts\python.exe src\lilith_shell\executor.py

示例命令

1. 查詢當前工作目錄：

   Can you run 'pwd' and tell me what directory we're in?
   

2. 列出用戶主目錄中的文件，並篩選出大於 200 MB 的文件：

   Can you list the files in my home directory? Which of them are larger than 200 MB?
   

安全注意事項

Lilith-shell 以用戶的權限執行命令。為保障安全，請遵循以下建議：

⚠️ 重要提示

• 僅在受信任的環境中使用，比如使用虛擬機（VM）或一次性開發環境，禁止在生產系統或存儲敏感數據的設備上使用。
• 實施命令限制，配置白名單策略以允許特定命令執行，並定期審查和更新允許的命令列表。
• 監控系統活動，使用系統監控工具跟蹤用戶活動，定期審計日誌文件以檢測異常行為。
• 定期備份重要數據，以防發生意外情況。

故障排除

服務啟動失敗

1. 檢查是否有其他進程佔用相同的端口。
2. 查看錯誤日誌以獲取更多信息：

   tail -f logs/error.log
   

網絡連接問題

1. 確保防火牆規則允許相關端口的通信。
2. 檢查網絡配置，確保服務可以訪問互聯網。

致謝與參考文獻

• Pandora-shell：Lilith-shell 的基礎項目，提供了許多核心功能和代碼實現。
• Python 官方文檔：用於理解虛擬環境和依賴管理的相關知識。
• 社區和技術論壇：感謝開源社區的技術支持和討論。

通過以上步驟，你可以順利使用 Lilith-shell 項目，並根據具體需求進行定製和擴展。如有任何問題或建議，請隨時聯繫項目維護人員。