PWCP帮助文档

欢迎使用PWCP (Python Windows Command Prompt) 帮助文档。PWCP是一个基于Python开发的现代化命令行工具,提供丰富的系统管理、文件操作和网络功能。

📝 文档说明

本文档基于PWCP实际代码实现(prompt.py、funcpool.py),包含所有命令的详细说明、参数选项和使用示例。

版本: 3.13.3274.72145

开发者: PWCP Development Team

🎯 核心特性

  • 文件操作: 下载、读取、目录管理、文件搜索
  • 网络工具: 网页浏览、服务器管理、网络扫描、IP查询
  • 系统信息: 版本信息、电池状态、进程管理、计算机信息
  • 实用工具: 二维码生成、数学计算
  • 平台支持: Windows

快速开始

如果您是第一次使用PWCP,请按照以下步骤快速上手:

步骤1:启动PWCP

python prompt.py

在命令行中运行此命令启动PWCP。

步骤2:查看版本信息

ver

查看PWCP版本信息和开发者信息。

步骤3:查看帮助

help

输入help命令进入帮助模式,查看所有可用命令。

步骤4:尝试基本命令

time
dir
battery

尝试查看当前时间、目录列表和电池信息。

命令参考

PWCP基于实际代码实现提供了丰富的命令集,以下是详细的命令说明:

📋 命令分类

  • 文件操作: dir, ls, mkdir, rmdir, read, download
  • 系统信息: ver, time, macver, battery, getpid, kill
  • 网络工具: web, server, network, webip
  • 实用工具: qrcode, math, ask, help, keyword

ver命令

功能:显示PWCP版本信息和开发者信息

语法: ver

示例:

ver

输出示例:

Python Windows Command Prompt [版本 3.13.3274.72145]
由 deepclour 开发

time命令

功能:显示当前系统时间

语法: time

示例:

time

dir命令

功能:显示当前目录的文件和文件夹列表

语法: dir

示例:

dir

输出示例:

驱动器 C 中的卷没有标签。
卷的序列号是 0000-0000

C:\Users\user 的目录

<DIR>          docs
<DIR>          src
README.md              1024  2024-12-20  10:00
LICENSE.md            2048  2024-12-20  10:00

2 个目录 2 个文件 1024000000 可用字节

ls命令

功能:显示文件列表(与dir命令功能相同)

语法: ls [-d|-f|-info]

参数:

  • -d - 只显示目录
  • -f - 只显示文件
  • -info - 显示详细信息

示例:

ls                    # 显示所有文件和目录
ls -d                 # 只显示目录
ls -f                 # 只显示文件

mkdir命令

功能:创建新的文件夹

语法: mkdir [文件夹名]

示例:

mkdir myfolder        # 创建名为myfolder的文件夹
mkdir new_project     # 创建新项目文件夹

rmdir命令

功能:删除指定的文件夹

语法: rmdir [文件夹名]

示例:

rmdir oldfolder       # 删除名为oldfolder的文件夹
rmdir temp            # 删除临时文件夹

download命令

功能:从网络下载文件到本地

语法: download [URL] [文件名] [-path 路径] [-ua 类型] [-pre] [-open]

参数:

  • -path - 指定下载路径
  • -ua - 设置User-Agent类型(android, iphone, windows, linux, mac)
  • -pre - 下载后预览文件内容
  • -open - 下载后自动打开文件

示例:

download https://example.com/file.txt                    # 基本下载
download https://example.com/file.txt myfile.txt         # 指定文件名
download https://example.com/file.txt -path /downloads   # 指定下载路径
download https://example.com/file.txt -ua android        # 使用Android User-Agent
download https://example.com/file.txt -pre               # 下载后预览

read命令

功能:读取并显示文件内容

语法: read [文件名]

示例:

read example.txt        # 读取example.txt文件
read README.md          # 读取README文件
read config.json        # 读取配置文件

输出示例:

文件 example.txt 的内容,长度为 45 个字符:
这是一个示例文件的内容
Hello World!

battery命令

功能:显示电池信息和状态

语法: battery

示例:

battery

输出示例:

电池信息:
  电量: 85%
  状态: 充电中
  预计剩余时间: 2小时30分钟

web命令

功能:在默认浏览器中打开网页

语法: web [URL]

示例:

web https://www.example.com          # 打开示例网站
web www.google.com                   # 打开Google
web 192.168.1.1                     # 打开本地路由器

server命令

功能:启动本地服务器

语法: server [端口] -frame [框架类型]

框架类型:

  • simple - 简单HTTP服务器
  • cgi - CGI服务器
  • socket - Socket服务器
  • csocket - Socket客户端

示例:

server 8080 -frame simple          # 启动简单服务器
server 3000 -frame cgi             # 启动CGI服务器
server 9000 -frame socket          # 启动Socket服务器
server 8080 -frame csocket         # 启动Socket客户端

network命令

功能:网络工具和诊断

语法: network [-host|-scan|-act]

参数:

  • -host - 显示本机网络配置信息
  • -scan - 扫描WiFi网络
  • -act - 查看网络活动信息

示例:

network -host        # 查看本机网络配置
network -scan        # 扫描WiFi网络
network -act         # 查看网络活动

webip命令

功能:获取网站的IP地址

语法: webip [网址]

示例:

webip google.com        # 获取Google的IP地址
webip github.com        # 获取GitHub的IP地址
webip baidu.com         # 获取百度的IP地址

getpid命令

功能:获取进程信息

语法: getpid [进程名/PID] [-all]

参数:

  • -all - 显示所有进程列表

示例:

getpid chrome.exe        # 获取Chrome进程信息
getpid 1234              # 获取PID为1234的进程信息
getpid -all              # 显示所有进程列表

kill命令

功能:终止指定进程

语法: kill [进程名/PID]

示例:

kill chrome.exe        # 终止Chrome进程
kill 1234              # 终止PID为1234的进程

qrcode命令

功能:生成二维码

语法: qrcode -make [内容]

示例:

qrcode -make "Hello World"        # 生成包含"Hello World"的二维码
qrcode -make https://example.com  # 生成网址二维码

math命令

功能:数学计算

语法: math [表达式]

示例:

math 2 + 3 * 5        # 计算数学表达式
math 100 / 4          # 除法计算

ask命令

简介:标准输入,并返回用户输入的文本

语法: ask [问题]

示例:

ask "今天天气怎么样?"        # 提问天气
ask "我应该学习什么?"         # 提问学习建议

help命令

功能:进入帮助模式,查看详细命令帮助

语法: help

示例:

help        # 进入帮助模式

使用说明:

输入help后进入帮助模式,可以输入具体命令名查看详细帮助,输入"exit"退出帮助模式。

keyword命令

功能:查看所有可用命令列表

语法: keyword

示例:

keyword        # 查看所有可用命令

out命令

功能:动态输出文本

语法: out [文本]

示例:

out "Hello, World!"                # 输出文本
out 12345                         # 输出数字
out $PATH                         # 输出环境变量

nout命令

功能:静态输出文字

语法: nout [文本]

示例:

nout "Hello, World!"               # 直接输出文本

server命令

功能:启动本地服务器

语法: server [端口] -frame [框架类型]

框架类型:

  • simple - 简单HTTP服务器
  • cgi - CGI服务器
  • socket - Socket服务器

示例:

server 8080 -frame simple          # 启动简单服务器
server 3000 -frame cgi             # 启动CGI服务器
server 9000 -frame socket          # 启动Socket服务器

webip命令

功能:获取网站的IP地址

语法: webip [网址]

示例:

webip www.baidu.com                # 获取百度IP
webip github.com                   # 获取GitHub IP

space命令

功能:创建简单的消息窗口

语法: space [标题] [内容]

示例:

space "提示" "操作完成!"           # 创建提示窗口
space "错误" "文件不存在"           # 创建错误窗口

wcmd命令

功能:执行Windows命令提示符命令

语法: wcmd [命令]

示例:

wcmd dir                           # 显示目录
wcmd ipconfig                      # 显示网络配置
wcmd systeminfo                    # 显示系统信息

find命令

功能:查找文件或文件夹

语法: findfile [文件名]

示例:

findfile *.txt                     # 查找所有txt文件
findfile myfile.py                 # 查找特定文件
findfile documents                 # 查找文件夹

文件操作命令

mkdir:创建文件夹

mkdir newfolder                    # 创建新文件夹

rmdir:删除文件夹

rmdir oldfolder                    # 删除文件夹

dir:显示当前目录

dir                                # 显示目录内容

chdir:切换目录

chdir C:\Users                     # 切换到用户目录

nedir:切换到当前目录下级的目录

nedir myfolder                    # 切换到myfolder目录

系统命令

time:显示当前时间

time                               # 显示时间

ver:显示PWCP版本

ver                                # 显示版本信息

macver:显示计算机信息

macver                             # 显示系统信息

clear/clean:清空屏幕

clear                              # 清空屏幕
clean                              # 清空屏幕

故障排除

如果您在使用PWCP时遇到问题,请参考以下解决方案:

问题1:无法启动PWCP

可能原因: Python环境未正确安装

解决方案:

# 检查Python版本
python --version

# 如果未安装Python,请从官网下载安装
# https://www.python.org/downloads/

问题2:命令执行失败

可能原因: 权限不足或文件不存在

解决方案:

  • 以管理员身份运行命令提示符
  • 检查文件路径是否正确
  • 确保有足够的权限执行操作

问题3:网络功能无法使用

可能原因: 网络连接问题或防火墙阻止

解决方案:

  • 检查网络连接状态
  • 暂时关闭防火墙测试
  • 检查代理设置是否正确

问题4:下载功能失败

可能原因: 网络问题或目标服务器不可用

解决方案:

  • 检查网络连接
  • 尝试使用不同的User-Agent
  • 检查目标URL是否有效

问题5:服务器功能无法启动

可能原因: 端口被占用或权限不足

解决方案:

  • 尝试使用不同的端口号
  • 检查端口是否被其他程序占用
  • 以管理员身份运行

💡 获取帮助

如果以上解决方案无法解决您的问题,请:

  • 查看详细的错误信息
  • 在GitHub仓库提交问题报告
  • 联系开发者获取技术支持

GitHub仓库: https://github.com/deepclour/PWCP