lywsvip/kwcode
1
0
Fork 0
mirror of https://github.com/val1813/kwcode.git synced 2026-09-03 06:34:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

Rename CLI command kaiwu → kwqode

Browse Source 
- Entry point: kwqode = "kaiwu.cli.main:app"
- Display name: KwQode (banners, help, REPL prompt)
- MCP tool: kwqode_execute
- Python package name kaiwu/ and imports unchanged
- .kaiwu/ config dir and KAIWU.md unchanged

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Val-sss
2026-04-27 10:01:04 +08:00
parent 61e7efcc32
commit 8660e26b1a
7 changed files with 82 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
README_zh.md
View File

@@ -1,4 +1,4 @@
# Kaiwu - 本地模型 Coding Agent
# KwQode - 本地模型 Coding Agent
> 中国开发者的本地 coding agent——Windows 打开就能用，数据不出网，越用越懂你的项目。
@@ -33,7 +33,7 @@ chmod +x install.sh && ./install.sh
### 手动安装
```bash
# 1. 安装 Kaiwu
# 1. 安装 KwQode
pip install kaiwu
# 国内网络慢可用清华镜像
pip install kaiwu -i https://pypi.tuna.tsinghua.edu.cn/simple
@@ -49,7 +49,7 @@ ollama pull gemma3:4b # 4GB 显存或 CPU
# 4. 初始化项目
cd your-project
kaiwu init
kwqode init
```
## 使用方法
@@ -58,18 +58,18 @@ kaiwu init
```bash
# 交互模式（REPL）
kaiwu
kwqode
# 单次任务
kaiwu "修复登录接口的空指针异常"
kaiwu "给 UserService 加单元测试"
kaiwu "把这个函数重构成策略模式"
kwqode "修复登录接口的空指针异常"
kwqode "给 UserService 加单元测试"
kwqode "把这个函数重构成策略模式"
```
### CLI 参数
```bash
kaiwu [任务] [选项]
kwqode [任务] [选项]
选项:
-m, --model TEXT Ollama 模型名称（默认 qwen3-8b）
@@ -98,21 +98,21 @@ kaiwu [任务] [选项]
### 子命令
```bash
kaiwu init # 初始化项目记忆
kaiwu status # 查看模型/专家/连接状态
kaiwu memory # 查看 KAIWU.md 内容
kaiwu serve-mcp # 启动 MCP Server（stdio 模式）
kwqode init # 初始化项目记忆
kwqode status # 查看模型/专家/连接状态
kwqode memory # 查看 KAIWU.md 内容
kwqode serve-mcp # 启动 MCP Server（stdio 模式）
```
### 专家管理
```bash
kaiwu expert list # 列出所有专家
kaiwu expert info APIExpert # 查看专家详情
kaiwu expert create my-expert # 创建自定义专家模板
kaiwu expert export APIExpert # 导出为 .kwx 包
kaiwu expert install ./my.kwx # 安装专家包
kaiwu expert remove my-expert # 删除专家
kwqode expert list # 列出所有专家
kwqode expert info APIExpert # 查看专家详情
kwqode expert create my-expert # 创建自定义专家模板
kwqode expert export APIExpert # 导出为 .kwx 包
kwqode expert install ./my.kwx # 安装专家包
kwqode expert remove my-expert # 删除专家
```
## 架构
@@ -186,7 +186,7 @@ kaiwu expert remove my-expert # 删除专家
## 配置
Kaiwu 通过命令行参数和环境变量配置，无需配置文件。
KwQode 通过命令行参数和环境变量配置，无需配置文件。
**环境变量：**
@@ -198,10 +198,10 @@ Kaiwu 通过命令行参数和环境变量配置，无需配置文件。
**项目级配置：**
每个项目根目录的 `KAIWU.md` 文件记录项目架构、技术栈和偏好，Kaiwu 会自动读取并作为上下文传给 LLM。
每个项目根目录的 `KAIWU.md` 文件记录项目架构、技术栈和偏好，KwQode 会自动读取并作为上下文传给 LLM。
```bash
kaiwu init # 自动扫描项目结构，生成 KAIWU.md
kwqode init # 自动扫描项目结构，生成 KAIWU.md
```
## 常见问题
@@ -227,13 +227,13 @@ pip install kaiwu -i https://pypi.tuna.tsinghua.edu.cn/simple
**Q: 模型推理太慢？**
- 确认 GPU 被正确识别：`nvidia-smi` 或 `kaiwu status`
- 换用更小的模型：`kaiwu -m gemma3:4b "你的任务"`
- 确认 GPU 被正确识别：`nvidia-smi` 或 `kwqode status`
- 换用更小的模型：`kwqode -m gemma3:4b "你的任务"`
- Reasoning 模型（如 deepseek-r1）可关闭 thinking：自动优化已内置
**Q: Windows 下中文乱码？**
Kaiwu 已内置 GBK 编码修复。如仍有问题：
KwQode 已内置 GBK 编码修复。如仍有问题：
```powershell
# PowerShell 设置 UTF-8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -244,17 +244,17 @@ chcp 65001
通过 MCP 协议：
```bash
kaiwu serve-mcp -m qwen3:8b
kwqode serve-mcp -m qwen3:8b
```
在 IDE 的 MCP 配置中添加 Kaiwu 作为 stdio server 即可。
在 IDE 的 MCP 配置中添加 KwQode 作为 stdio server 即可。
**Q: 如何创建自定义专家？**
```bash
kaiwu expert create my-expert # 生成模板 YAML
kwqode expert create my-expert # 生成模板 YAML
# 编辑 ~/.kaiwu/experts/my-expert.yaml
# 配置 trigger_keywords、system_prompt、pipeline
kaiwu expert list # 确认已加载
kwqode expert list # 确认已加载
```
## 系统要求

28
install.ps1
View File

@@ -1,4 +1,4 @@
# Kaiwu 安装程序 - Windows PowerShell
# KwQode 安装程序 - Windows PowerShell
# 用法: powershell -ExecutionPolicy Bypass -File install.ps1
$ErrorActionPreference = "Continue"
@@ -7,7 +7,7 @@ $ErrorActionPreference = "Continue"
# ── Banner ───────────────────────────────────────────────────
Write-Host ""
Write-Host " ╔══════════════════════════════════════╗" -ForegroundColor Cyan
Write-Host " ║ Kaiwu 安装程序 v0.4 ║" -ForegroundColor Cyan
Write-Host " ║ KwQode 安装程序 v0.4 ║" -ForegroundColor Cyan
Write-Host " ║ 本地模型 Coding Agent ║" -ForegroundColor Cyan
Write-Host " ╚══════════════════════════════════════╝" -ForegroundColor Cyan
Write-Host ""
@@ -64,7 +64,7 @@ try {
}
# ── Step 3: pip install kaiwu ────────────────────────────────
Write-Step "安装 Kaiwu..."
Write-Step "安装 KwQode..."
$installed = $false
@@ -87,7 +87,7 @@ if (-not $installed) {
}
if (-not $installed) {
Write-Err "Kaiwu 安装失败"
Write-Err "KwQode 安装失败"
Write-Info "请手动执行: $pythonCmd -m pip install kaiwu"
Write-Info "如果网络慢，加上: -i https://pypi.tuna.tsinghua.edu.cn/simple"
exit 1
@@ -155,26 +155,26 @@ if ($ollamaOk) {
}
}
# ── Step 6: kaiwu init ───────────────────────────────────────
Write-Step "初始化 Kaiwu..."
# ── Step 6: kwqode init ──────────────────────────────────────
Write-Step "初始化 KwQode..."
try {
& kaiwu init 2>&1 | Out-Null
& kwqode init 2>&1 | Out-Null
if ($LASTEXITCODE -eq 0) {
Write-Info "KAIWU.md 已初始化"
}
} catch {
Write-Info "跳过初始化（可稍后在项目目录执行 kaiwu init）"
Write-Info "跳过初始化（可稍后在项目目录执行 kwqode init）"
}
# ── Step 7: kaiwu status ─────────────────────────────────────
# ── Step 7: kwqode status ────────────────────────────────────
Write-Step "验证安装..."
try {
& kaiwu status
& kwqode status
} catch {
Write-Warn "状态检查失败，但安装可能已成功"
Write-Info "请手动执行: kaiwu status"
Write-Info "请手动执行: kwqode status"
}
# ── 完成 ─────────────────────────────────────────────────────
@@ -185,9 +185,9 @@ Write-Host " ╚═════════════════════
Write-Host ""
Write-Host " 下一步:" -ForegroundColor Cyan
Write-Host " 1. cd 到你的项目目录" -ForegroundColor White
Write-Host " 2. kaiwu init # 初始化项目记忆" -ForegroundColor White
Write-Host " 3. kaiwu # 进入交互模式" -ForegroundColor White
Write-Host ' 4. kaiwu "修复登录bug" # 直接执行任务' -ForegroundColor White
Write-Host " 2. kwqode init # 初始化项目记忆" -ForegroundColor White
Write-Host " 3. kwqode # 进入交互模式" -ForegroundColor White
Write-Host ' 4. kwqode "修复登录bug" # 直接执行任务' -ForegroundColor White
Write-Host ""
Write-Host " 文档: https://github.com/kaiwu-agent/kaiwu" -ForegroundColor Gray
Write-Host ""

30
install.sh
View File

@@ -1,5 +1,5 @@
#!/bin/sh
# Kaiwu 安装程序 - Mac/Linux
# KwQode 安装程序 - Mac/Linux
# 用法: curl -sSL https://raw.githubusercontent.com/kaiwu-agent/kaiwu/main/install.sh | sh
# 或: chmod +x install.sh && ./install.sh
@@ -21,7 +21,7 @@ info() { printf " ${GRAY}%s${NC}\n" "$1"; }
# ── Banner ───────────────────────────────────────────────────
printf "\n"
printf " ${CYAN}╔══════════════════════════════════════╗${NC}\n"
printf " ${CYAN}║ Kaiwu 安装程序 v0.4 ║${NC}\n"
printf " ${CYAN}║ KwQode 安装程序 v0.4 ║${NC}\n"
printf " ${CYAN}║ 本地模型 Coding Agent ║${NC}\n"
printf " ${CYAN}╚══════════════════════════════════════╝${NC}\n"
printf "\n"
@@ -95,7 +95,7 @@ else
fi
# ── Step 3: pip install kaiwu ────────────────────────────────
step "安装 Kaiwu..."
step "安装 KwQode..."
INSTALLED=0
@@ -119,7 +119,7 @@ if [ "$INSTALLED" -eq 0 ]; then
fi
if [ "$INSTALLED" -eq 0 ]; then
err "Kaiwu 安装失败"
err "KwQode 安装失败"
info "请手动执行: $PYTHON_CMD -m pip install kaiwu"
info "如果网络慢，加上: -i https://pypi.tuna.tsinghua.edu.cn/simple"
exit 1
@@ -184,21 +184,21 @@ if [ "$OLLAMA_OK" -eq 1 ]; then
fi
fi
# ── Step 6: kaiwu init ───────────────────────────────────────
step "初始化 Kaiwu..."
# ── Step 6: kwqode init ──────────────────────────────────────
step "初始化 KwQode..."
if command -v kaiwu >/dev/null 2>&1; then
kaiwu init 2>/dev/null && info "KAIWU.md 已初始化" || info "跳过初始化（可稍后在项目目录执行 kaiwu init）"
if command -v kwqode >/dev/null 2>&1; then
kwqode init 2>/dev/null && info "KAIWU.md 已初始化" || info "跳过初始化（可稍后在项目目录执行 kwqode init）"
else
info "kaiwu 命令未在 PATH 中，跳过初始化"
info "kwqode 命令未在 PATH 中，跳过初始化"
info "尝试: $PYTHON_CMD -m kaiwu init"
fi
# ── Step 7: kaiwu status ─────────────────────────────────────
# ── Step 7: kwqode status ────────────────────────────────────
step "验证安装..."
if command -v kaiwu >/dev/null 2>&1; then
kaiwu status || warn "状态检查失败，但安装可能已成功"
if command -v kwqode >/dev/null 2>&1; then
kwqode status || warn "状态检查失败，但安装可能已成功"
else
"$PYTHON_CMD" -m kaiwu status 2>/dev/null || warn "状态检查失败"
fi
@@ -211,9 +211,9 @@ printf " ${GREEN}╚═══════════════════
printf "\n"
printf " ${CYAN}下一步:${NC}\n"
printf " 1. cd 到你的项目目录\n"
printf " 2. kaiwu init # 初始化项目记忆\n"
printf " 3. kaiwu # 进入交互模式\n"
printf ' 4. kaiwu "修复登录bug" # 直接执行任务\n'
printf " 2. kwqode init # 初始化项目记忆\n"
printf " 3. kwqode # 进入交互模式\n"
printf ' 4. kwqode "修复登录bug" # 直接执行任务\n'
printf "\n"
printf " ${GRAY}文档: https://github.com/kaiwu-agent/kaiwu${NC}\n"
printf "\n"

26
kaiwu/cli/main.py
View File

@@ -1,9 +1,9 @@
"""
Kaiwu CLI entry point.
- kaiwu → 进入交互式 REPL
- kaiwu "修复bug" → 单次执行
- kaiwu init → 初始化 KAIWU.md
- kaiwu memory → 查看项目记忆
KwQode CLI entry point.
- kwqode → 进入交互式 REPL
- kwqode "修复bug" → 单次执行
- kwqode init → 初始化 KAIWU.md
- kwqode memory → 查看项目记忆
"""
import logging
@@ -23,8 +23,8 @@ from rich.panel import Panel
from rich.prompt import Prompt
app = typer.Typer(
name="kaiwu",
help="Kaiwu - 本地模型 coding agent",
name="kwqode",
help="KwQode - 本地模型 coding agent",
add_completion=False,
no_args_is_help=False,
)
@@ -203,7 +203,7 @@ def _repl(model_path, ollama_url, ollama_model, project_root, verbose):
from kaiwu.memory.kaiwu_md import KaiwuMemory
console.print(Panel(
f"[bold]Kaiwu v0.4[/bold] 交互模式\n"
f"[bold]KwQode v0.4[/bold] 交互模式\n"
f"模型: {ollama_model} 项目: {project_root}\n"
f"输入任务开始，/help 查看命令，/exit 退出",
border_style="cyan",
@@ -223,7 +223,7 @@ def _repl(model_path, ollama_url, ollama_model, project_root, verbose):
while True:
try:
console.print()
user_input = Prompt.ask("[bold cyan]kaiwu[/bold cyan]").strip()
user_input = Prompt.ask("[bold cyan]kwqode[/bold cyan]").strip()
except (KeyboardInterrupt, EOFError):
console.print("\n [dim]bye[/dim]")
break
@@ -342,7 +342,7 @@ def main(
do_init: bool = typer.Option(False, "--init", help="初始化KAIWU.md"),
show_memory: bool = typer.Option(False, "--memory", help="查看项目记忆"),
):
"""Kaiwu - 本地模型 coding agent。无参数进入交互模式。"""
"""KwQode - 本地模型 coding agent。无参数进入交互模式。"""
log_level = logging.DEBUG if verbose else logging.WARNING
logging.basicConfig(level=log_level, format="%(name)s: %(message)s")
@@ -376,7 +376,7 @@ def main(
# ── Single task mode ──
console.print(Panel(
f"[bold]Kaiwu v0.4[/bold] | {ollama_model} | {project_root}",
f"[bold]KwQode v0.4[/bold] | {ollama_model} | {project_root}",
border_style="cyan",
))
@@ -568,8 +568,8 @@ def cmd_status(
f"模型: {ollama_model} Ollama: {'[green]连接正常[/green]' if ollama_ok else '[red]无法连接[/red]'} ({ollama_url})\n"
f"专家: {len(builtin)} builtin + {len(custom)} custom = {len(experts)} total\n"
f"项目: {project_root}\n"
f"记忆: {'[green]KAIWU.md 已初始化[/green]' if has_memory else '[yellow]未初始化 (kaiwu init)[/yellow]'}",
title="Kaiwu Status",
f"记忆: {'[green]KAIWU.md 已初始化[/green]' if has_memory else '[yellow]未初始化 (kwqode init)[/yellow]'}",
title="KwQode Status",
border_style="cyan",
))

18
kaiwu/mcp/router_mcp.py
View File

@@ -1,7 +1,7 @@
"""
KaiwuMCP: Router MCP server.
CORE-7: This is the ONLY external entry point. LLM does not directly see experts.
Single tool: kaiwu_execute(task_description: str) -> str
Single tool: kwqode_execute(task_description: str) -> str
The `mcp` package is optional. This module is always importable, but
starting the server requires `pip install mcp`.
@@ -30,7 +30,7 @@ def _require_mcp():
class KaiwuMCP:
"""MCP server that wraps the entire Kaiwu pipeline as a single tool."""
"""MCP server that wraps the entire KwQode pipeline as a single tool."""
def __init__(self, gate, orchestrator, memory, project_root: str):
_require_mcp()
@@ -38,20 +38,20 @@ class KaiwuMCP:
self.orchestrator = orchestrator
self.memory = memory
self.project_root = project_root
self.server = Server("kaiwu")
self.server = Server("kwqode")
self._setup_tools()
def _setup_tools(self):
"""Register the single kaiwu_execute tool."""
"""Register the single kwqode_execute tool."""
@self.server.list_tools()
async def list_tools():
return [
Tool(
name="kaiwu_execute",
name="kwqode_execute",
description=(
"Execute a coding task through Kaiwu's local-model expert pipeline. "
"Kaiwu automatically selects the right expert, locates relevant files, "
"Execute a coding task through KwQode's local-model expert pipeline. "
"KwQode automatically selects the right expert, locates relevant files, "
"generates patches, and verifies the result."
),
inputSchema={
@@ -69,7 +69,7 @@ class KaiwuMCP:
@self.server.call_tool()
async def call_tool(name: str, arguments: dict):
if name != "kaiwu_execute":
if name != "kwqode_execute":
return [TextContent(type="text", text=f"Unknown tool: {name}")]
task = arguments.get("task_description", "").strip()
@@ -80,7 +80,7 @@ class KaiwuMCP:
result_text = await self._execute(task)
return [TextContent(type="text", text=result_text)]
except Exception as e:
logger.exception("kaiwu_execute failed")
logger.exception("kwqode_execute failed")
return [TextContent(type="text", text=f"Error: {e}")]
async def _execute(self, task: str) -> str:

2
kaiwu/memory/project_md.py
View File

@@ -315,7 +315,7 @@ def show(project_root: str) -> str:
"""Display PROJECT.md content."""
path = _md_path(project_root)
if not os.path.exists(path):
return "PROJECT.md not found. Run `kaiwu init` to create."
return "PROJECT.md not found. Run `kwqode init` to create."
try:
with open(path, "r", encoding="utf-8") as f:
return f.read()

4
pyproject.toml
View File

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "kaiwu"
version = "0.4.0"
description = "Local-model coding agent with MoE expert pipeline"
description = "KwQode - Local-model coding agent with MoE expert pipeline"
requires-python = ">=3.10"
dependencies = [
@@ -25,7 +25,7 @@ dependencies = [
]
[project.scripts]
kaiwu = "kaiwu.cli.main:app"
kwqode = "kaiwu.cli.main:app"
[tool.setuptools.packages.find]
where = ["."]