Skip to content

1.0.0

Choose a tag to compare

@Qin-collab Qin-collab released this 25 Sep 08:03
· 6 commits to main since this release
f5e92c9

KShell 1.0.0 介绍

一句话定位

KShell 是一个纯 Python 编写的跨平台终端,零 GUI 依赖、零外部依赖,一个文件即可开箱即用。

它支持 Windows / macOS / Linux,提供 60+ 条常用命令、主题切换、别名系统、脚本执行和管道重定向,适合作为轻量级命令行环境或学习 Shell 原理的参考实现。


核心特性

  • 纯 Python 实现:不依赖 PyQt/Tkinter 等 GUI 库,核心逻辑不使用 os 模块
  • 跨平台:Windows(kshell.exe)、Linux(.deb / apt install)、macOS(源码运行)
  • 60+ 命令:cd/ls/cp/mv/grep/find/sudo/ps/kill/base64/md5sum/sha256sum/head/tail/wc/sort/uniq/tree/seq/...
  • 主题系统:default / dark / light / ocean / monokai / solarized,自动检测是否支持颜色
  • 别名系统:支持自定义 alias,重启后仍然生效
  • 脚本执行:运行 .ksh 脚本文件,支持管道与重定向
  • 配置持久化:JSON 配置文件,保存主题、别名、历史等
  • 启动横幅:可开关的 ASCII 欢迎界面

快速安装

Windows

bat
复制
kshell.exe

Linux(apt)

bash
复制
echo "deb [trusted=yes] http://39.96.82.163/apt stable main" | sudo tee /etc/apt/sources.list.d/kshell.list
sudo apt update
sudo apt install -y kshell
kshell

Linux(deb)

bash
复制
sudo dpkg -i kshell_1.0.0_amd64.deb
kshell

源码运行

bash
复制
python3 kshell.py

使用示例

bash
复制
# 交互模式
kshell

# 脚本模式
kshell example.ksh

# 命令示例
ls -la
cd /tmp
echo Hello World > hello.txt
cat hello.txt
grep KShell README.md
find . -name "*.py"
theme list
config set theme ocean
alias ll='ls -l'

技术亮点

模块 | 职责 -- | -- terminal.py | 主循环、命令调度、管道/重定向 parser.py | 命令解析、选项识别、引号处理 builtin.py | 核心内置命令 commands_extra.py | 扩展命令,自动注册 cmd_xxx 方法 filesystem.py | 基于 pathlib / shutil 的文件操作 process.py | 外部命令执行与 which 查找 settings.py | JSON 配置持久化 theme.py | ANSI 颜色与主题预设 kplatform.py | 平台抽象与路径分隔符

1.0.0 发布说明

首次正式版本发布

  • 完成核心终端框架
  • 实现 60+ 内置/扩展命令
  • 提供 Windows .exe、Linux .deb、apt 仓库三种分发方式
  • 支持 6 套预设主题
  • 支持别名、历史、脚本执行
  • 支持管道与输入/输出重定向

Liunx APT服务器目前正在维护,请下载kshell_1.0.0_liunx_amd64.deb安装,或下载kshell-1.0.0-linux-x86_64.tar.gz自行构建