Lilith-shell 项目说明

简介

Lilith-shell 是一个功能强大的工具，允许在 Claude Desktop 中通过自定义的 shell 环境执行命令。它是 Pandora-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 以用户的权限执行命令。为了安全起见，请遵循以下建议：

1. 仅在受信任的环境中使用：

   • 使用虚拟机（VM）或一次性开发环境。
   • 禁止在生产系统或存储敏感数据的设备上使用。

2. 实施命令限制：

   • 配置白名单策略，允许特定命令的执行。
   • 定期审查和更新允许的命令列表。

3. 监控系统活动：

   • 使用系统监控工具跟踪用户活动。
   • 定期审计日志文件以检测异常行为。

4. 数据备份：

   • 定期备份重要数据，以防万一发生意外情况。

故障排除

服务启动失败

1. 检查是否有其他进程占用相同的端口。
2. 查看错误日志以获取更多信息：

   tail -f logs/error.log
   

网络连接问题

1. 确保防火墙规则允许相关端口的通信。
2. 检查网络配置，确保服务可以访问互联网。

致谢与参考文献

• Pandora-shell：Lilith-shell 的基础项目，提供了许多核心功能和代码实现。
• Python 官方文档：用于理解虚拟环境和依赖管理的相关知识。
• 社区和技术论坛：感谢开源社区的技术支持和讨论。

通过以上步骤，你可以顺利地使用 Lilith-shell 项目，并根据具体需求进行定制和扩展。如有任何问题或建议，请随时联系项目维护人员。