loushang

环境要求

• Python 环境（项目为 Python 编写，版本要求 README 未明确）
• uv 包管理工具（用于创建虚拟环境和安装依赖）
• git（用于克隆仓库）
• 项目处于早期开发阶段，官方推荐从源码运行

安装与启动步骤

1. 1克隆仓库

   从 GitHub 拉取 loushang 源码，并进入项目根目录，后续所有命令都在该目录执行。

   git clone https://github.com/zhnt/loushang.git
   cd loushang

   复制

2. 2创建虚拟环境

   在项目根目录用 uv 创建名为 .venv 的虚拟环境，这是 README 推荐的项目本地开发环境。

   uv venv .venv

   复制

3. 3激活虚拟环境

   激活 .venv，使后续的安装与运行命令都作用在该环境内。

   source .venv/bin/activate

   复制

4. 4安装项目依赖

   以可编辑模式安装项目及其 dev 依赖，源码改动可即时生效。

   uv pip install -e ".[dev]"

   复制

5. 5验证安装

   运行帮助命令，若能正常打印用法说明即表示 CLI 安装成功。

   loushang --help

   复制

6. 6查看模型与命令

   列出当前可用的模型与内置命令，确认模型路由和命令表可用。

   loushang --list-models
   loushang --list-commands

   复制

7. 7运行一次任务

   用 -p 参数传入提示词，让 loushang 检查当前仓库并总结其功能，验证端到端可用。

   loushang -p "Inspect this repository and summarize what it does."

   复制

如何确认成功

执行 loushang --help 能正常输出帮助信息，且 loushang --list-models、--list-commands 能列出模型与命令，即安装成功。

常见问题

注意事项

• 项目处于早期开发阶段，README 明确推荐从源码运行。
• 请始终在项目根目录的 .venv/ 虚拟环境中执行开发与测试。
• 激活命令 source .venv/bin/activate 为 macOS/Linux 写法，Windows 平台请按本机虚拟环境激活方式处理。
• README 未提供模型 API Key 等配置说明，如需接入具体模型请自行查阅项目文档。