fcbyk-cli 0.2.2__tar.gz → 0.3.0__tar.gz

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Yoki
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Yoki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/MANIFEST.in

@@ -1,18 +1,18 @@
-# Controls files included in the source distribution (sdist)
-
-# Ensure frontend build artifacts are included in sdist
-recursive-include src/fcbyk/web/dist *
-
-# Exclude Python bytecode caches
-global-exclude *.py[cod]
-global-exclude __pycache__/*
-global-exclude */__pycache__/*
-
-# Exclude common build/test caches and build outputs
-prune build
-prune dist
-prune .pytest_cache
-prune .mypy_cache
-prune .ruff_cache
-global-exclude *.egg-info/*
-
+# Controls files included in the source distribution (sdist)
+
+# Ensure frontend build artifacts are included in sdist
+recursive-include src/fcbyk/web/dist *
+
+# Exclude Python bytecode caches
+global-exclude *.py[cod]
+global-exclude __pycache__/*
+global-exclude */__pycache__/*
+
+# Exclude common build/test caches and build outputs
+prune build
+prune dist
+prune .pytest_cache
+prune .mypy_cache
+prune .ruff_cache
+global-exclude *.egg-info/*
+

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/PKG-INFO

@@ -1,103 +1,91 @@
-Metadata-Version: 2.4
-Name: fcbyk-cli
-Version: 0.2.2
-Summary: A CLI tool for fcbyk
-Author: fcbyk
-Author-email: 731240932@qq.com
-License: MIT
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8; python_version >= "3.7"
-Requires-Dist: click<8.0; python_version < "3.7"
-Requires-Dist: rich>=10.0.0
-Requires-Dist: flask>=2.0; python_version >= "3.7"
-Requires-Dist: flask<2.1; python_version < "3.7"
-Requires-Dist: dataclasses; python_version < "3.7"
-Requires-Dist: flask-socketio==5.3.3
-Requires-Dist: python-socketio==5.9.0
-Requires-Dist: pyperclip<2.0.0,>=1.9.0
-Requires-Dist: importlib-metadata>=4.8.0; python_version < "3.8"
-Requires-Dist: requests>=2.28.0; python_version >= "3.7"
-Requires-Dist: requests>=2.27.0; python_version < "3.7"
-Requires-Dist: pyautogui<1.0.0,>=0.9.50
-Requires-Dist: psutil==5.8.0; python_version < "3.12"
-Requires-Dist: psutil>=5.9.0; python_version >= "3.12"
-Requires-Dist: waitress>=2.0.0
-Provides-Extra: test
-Requires-Dist: pytest<8.0.0,>=7.0.0; extra == "test"
-Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == "test"
-Requires-Dist: beautifulsoup4<4.11.0,>=4.10.0; extra == "test"
-Provides-Extra: gui
-Requires-Dist: PySide6>=6.0.0; python_version >= "3.7" and extra == "gui"
-Requires-Dist: PyQt5<6; python_version < "3.7" and extra == "gui"
-Dynamic: license-file
-
-![image](https://github.com/user-attachments/assets/655b2999-fd7a-4a63-bc54-c0297c16e0a8)
-
-[![PyPI](https://img.shields.io/pypi/v/fcbyk-cli.svg)](https://pypi.org/project/fcbyk-cli/)
-[![Tests](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml/badge.svg)](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml)
-[![codecov](https://codecov.io/gh/fcbyk/fcbyk-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/fcbyk/fcbyk-cli)
-[![License](https://img.shields.io/github/license/fcbyk/fcbyk-cli.svg)](https://github.com/fcbyk/fcbyk-cli/blob/main/LICENSE)
-
-## 子命令
-
-- `lansend`：在指定端口开启 `http服务器`，用于局域网内共享文件
-- `ai`：在控制台与 `ai` 聊天 （需自行配置`api-key`）
-- `pick`：随机抽取一个元素（可用于抽奖、随机选择等）
-- `slide`：同一局域网内，手机控制电脑PTT翻页
-
-## 安装
-
-#### 使用 pip 安装
-
-```bash
-pip install fcbyk-cli
-```
-
-> GUI为可选依赖
-
-```bash
-pip install fcbyk-cli[gui]
-```
-
-#### 从源码安装（可按需调整代码）
-
-- 前端构建
-```bash
-git clone https://github.com/fcbyk/fcbyk-cli.git
-cd web-ui
-npm install
-npm run build:flatten
-```
-
-- 后端安装
-```bash
-cd ..
-cd fcbyk-cli
-pip install -e .
-```
-
-## 查看帮助信息
-
-```bash
-fcbyk --help
-fcbyk --version
-```
-
-## 系统要求
-
-- Python 3.6+
-- Windows
+Metadata-Version: 2.4
+Name: fcbyk-cli
+Version: 0.3.0
+Summary: A CLI tool for fcbyk
+Author: fcbyk
+Author-email: 731240932@qq.com
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8; python_version >= "3.7"
+Requires-Dist: click<8.0; python_version < "3.7"
+Requires-Dist: rich>=10.0.0
+Requires-Dist: flask>=2.0; python_version >= "3.7"
+Requires-Dist: flask<2.1; python_version < "3.7"
+Requires-Dist: dataclasses; python_version < "3.7"
+Requires-Dist: flask-socketio==5.3.3
+Requires-Dist: python-socketio==5.9.0
+Requires-Dist: pyperclip<2.0.0,>=1.9.0
+Requires-Dist: importlib-metadata>=4.8.0; python_version < "3.8"
+Requires-Dist: requests>=2.28.0; python_version >= "3.7"
+Requires-Dist: requests>=2.27.0; python_version < "3.7"
+Requires-Dist: pyautogui<1.0.0,>=0.9.50
+Requires-Dist: psutil==5.8.0; python_version < "3.12"
+Requires-Dist: psutil>=5.9.0; python_version >= "3.12"
+Requires-Dist: waitress>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest<8.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == "dev"
+Requires-Dist: beautifulsoup4<4.11.0,>=4.10.0; extra == "dev"
+Requires-Dist: commitizen; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+## 简介
+
+[![PyPI](https://img.shields.io/pypi/v/fcbyk-cli.svg)](https://pypi.org/project/fcbyk-cli/)
+[![Tests](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml/badge.svg)](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/fcbyk/fcbyk-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/fcbyk/fcbyk-cli)
+[![License](https://img.shields.io/github/license/fcbyk/fcbyk-cli.svg)](https://github.com/fcbyk/fcbyk-cli/blob/main/LICENSE)
+
+**`fcbyk-cli`** 是一个轻量、实用的命令行工具集合，
+
+它用于通过终端快速完成一些 **零散但真实存在的需求**：
+- 没有现成软件可用
+- 或者已有软件过于臃肿、广告过多、不够轻量
+- 又或者只是想用一条命令把事情做完
+
+**`fcbyk-cli`** 的目标不是 “做一个大全”，  
+而是用 **小而直接的工具**，解决当下遇到的问题。
+
+如果你有实际需求或好的想法，也欢迎提交 [**issue**](https://github.com/fcbyk/fcbyk-cli/issues) 一起讨论。
+
+## 已有功能 (子命令)
+
+- [`lansend`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/LANSend.md)：在指定端口开启 `http服务器`，用于局域网内共享文件
+- [`ai`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/AI.md)：在控制台与 `ai` 聊天 （需自行配置`api-key`）
+- [`pick`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Pick.md)：随机抽取一个元素（可用于抽奖、随机选择等）
+- [`slide`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Slide.md)：同一局域网内，手机控制电脑PTT翻页
+- [`alias`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Alias.md)：为常用命令添加别名，方便快速执行
+- [`run`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Run.md)：从 scripts.byk.json 文件中运行可重复使用的命令脚本
+- [`get`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Get.md)：资源获取，支持下载和打开官网
+- [`config`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Config.md)：查看数据目录、日志目录和配置文件路径
+- [`svc`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Svc.md)：统一管理由各子命令启动的后台 Web 服务进程
+
+## 快速开始
+
+- 使用 pip 安装
+
+```bash
+pip install fcbyk-cli
+```
+
+- 显示帮助信息
+
+```bash
+fcbyk
+```

fcbyk_cli-0.3.0/README.md

@@ -0,0 +1,44 @@
+## 简介
+
+[![PyPI](https://img.shields.io/pypi/v/fcbyk-cli.svg)](https://pypi.org/project/fcbyk-cli/)
+[![Tests](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml/badge.svg)](https://github.com/fcbyk/fcbyk-cli/actions/workflows/test.yml)
+[![codecov](https://codecov.io/gh/fcbyk/fcbyk-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/fcbyk/fcbyk-cli)
+[![License](https://img.shields.io/github/license/fcbyk/fcbyk-cli.svg)](https://github.com/fcbyk/fcbyk-cli/blob/main/LICENSE)
+
+**`fcbyk-cli`** 是一个轻量、实用的命令行工具集合，
+
+它用于通过终端快速完成一些 **零散但真实存在的需求**：
+- 没有现成软件可用
+- 或者已有软件过于臃肿、广告过多、不够轻量
+- 又或者只是想用一条命令把事情做完
+
+**`fcbyk-cli`** 的目标不是 “做一个大全”，  
+而是用 **小而直接的工具**，解决当下遇到的问题。
+
+如果你有实际需求或好的想法，也欢迎提交 [**issue**](https://github.com/fcbyk/fcbyk-cli/issues) 一起讨论。
+
+## 已有功能 (子命令)
+
+- [`lansend`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/LANSend.md)：在指定端口开启 `http服务器`，用于局域网内共享文件
+- [`ai`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/AI.md)：在控制台与 `ai` 聊天 （需自行配置`api-key`）
+- [`pick`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Pick.md)：随机抽取一个元素（可用于抽奖、随机选择等）
+- [`slide`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Slide.md)：同一局域网内，手机控制电脑PTT翻页
+- [`alias`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Alias.md)：为常用命令添加别名，方便快速执行
+- [`run`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Run.md)：从 scripts.byk.json 文件中运行可重复使用的命令脚本
+- [`get`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Get.md)：资源获取，支持下载和打开官网
+- [`config`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Config.md)：查看数据目录、日志目录和配置文件路径
+- [`svc`](https://github.com/fcbyk/fcbyk-cli/blob/main/docs/Svc.md)：统一管理由各子命令启动的后台 Web 服务进程
+
+## 快速开始
+
+- 使用 pip 安装
+
+```bash
+pip install fcbyk-cli
+```
+
+- 显示帮助信息
+
+```bash
+fcbyk
+```

fcbyk_cli-0.3.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=40", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+testpaths = ["src/fcbyk/tests"]
+python_files = ["test_*.py"]
+addopts = "-v --cov=fcbyk --cov-report=term-missing"
+
+[tool.commitizen]
+name = "cz_customize"
+version = "0.3.0"
+tag_format = "v$version"
+changelog_file = "CHANGELOG.md"
+bump_message = "release: v$new_version"
+version_files = [
+    "setup.cfg:version =",
+    "pyproject.toml:version ="
+]
+
+[tool.commitizen.customize]
+# 兼容历史emoji提交（emoji可选存在）
+commit_parser = '^(?:✨|🐛|♻️|📝|🎨|⚡️|✅|🔧\s*)?(?P<change_type>feat|fix|refactor|docs|perf|test|style|chore)(?:\((?P<scope>[^\)]+)\))?:\s*(?P<message>.+)$'
+changelog_pattern = '^(?:(?:✨|🐛|♻️|📝|🎨|⚡️|✅|🔧)\s*)?(feat|fix|refactor|docs|perf|test|style|chore)'
+change_type_order = [
+    "feat",
+    "fix",
+    "refactor",
+    "docs",
+    "style",
+    "perf",
+    "test",
+    "chore"
+]
+
+message_template = """
+{{ change_type }}{% if scope %}({{ scope }}){% endif %}: {{ message }}
+"""
+
+[tool.commitizen.customize.change_type_map]
+feat = "Features"
+fix = "Bug Fixes"
+refactor = "Refactor"
+docs = "Documentation"
+style = "Styles"
+perf = "Performance"
+test = "Tests"
+chore = "Chores"

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/setup.cfg

@@ -1,75 +1,75 @@
-[metadata]
-name = fcbyk-cli
-version = 0.2.2
-description = A CLI tool for fcbyk
-long_description = file: README.md
-long_description_content_type = text/markdown
-author = fcbyk
-author_email = 731240932@qq.com
-license = MIT
-license_files = LICENSE
-classifiers = 
-	Development Status :: 3 - Alpha
-	Intended Audience :: Developers
-	License :: OSI Approved :: MIT License
-	Programming Language :: Python :: 3
-	Programming Language :: Python :: 3.6
-	Programming Language :: Python :: 3.7
-	Programming Language :: Python :: 3.8
-	Programming Language :: Python :: 3.9
-	Programming Language :: Python :: 3.10
-	Programming Language :: Python :: 3.11
-	Programming Language :: Python :: 3.12
-	Programming Language :: Python :: 3.13
-
-[options]
-packages = find:
-package_dir = 
-	= src
-python_requires = >=3.6
-install_requires = 
-	click>=8; python_version>="3.7"
-	click<8.0; python_version<"3.7"
-	rich>=10.0.0
-	flask>=2.0; python_version>="3.7"
-	flask<2.1; python_version<"3.7"
-	dataclasses; python_version < "3.7"
-	flask-socketio==5.3.3
-	python-socketio==5.9.0
-	pyperclip>=1.9.0,<2.0.0
-	importlib-metadata>=4.8.0; python_version < "3.8"
-	requests>=2.28.0; python_version>="3.7"
-	requests>=2.27.0; python_version<"3.7"
-	pyautogui>=0.9.50,<1.0.0
-	psutil==5.8.0 ; python_version < "3.12"
-	psutil>=5.9.0 ; python_version >= "3.12"
-	waitress>=2.0.0
-
-[options.extras_require]
-test = 
-	pytest>=7.0.0,<8.0.0
-	pytest-cov>=4.0.0,<5.0.0
-	beautifulsoup4>=4.10.0,<4.11.0
-gui = 
-	PySide6>=6.0.0; python_version >= "3.7"
-	PyQt5<6; python_version < "3.7"
-
-[options.packages.find]
-where = src
-exclude = 
-	fcbyk.tests
-	fcbyk.tests.*
-
-[options.entry_points]
-console_scripts = 
-	fcbyk = fcbyk.cli:cli
-
-[options.package_data]
-fcbyk = 
-	gui/assets/*
-	web/dist/**/*
-
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[metadata]
+name = fcbyk-cli
+version = 0.3.0
+description = A CLI tool for fcbyk
+long_description = file: README.md
+long_description_content_type = text/markdown
+author = fcbyk
+author_email = 731240932@qq.com
+license = MIT
+license_files = LICENSE
+classifiers = 
+	Development Status :: 3 - Alpha
+	Intended Audience :: Developers
+	License :: OSI Approved :: MIT License
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.6
+	Programming Language :: Python :: 3.7
+	Programming Language :: Python :: 3.8
+	Programming Language :: Python :: 3.9
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+	Programming Language :: Python :: 3.13
+
+[options]
+packages = find:
+package_dir = 
+	= src
+python_requires = >=3.6
+install_requires = 
+	click>=8; python_version>="3.7"
+	click<8.0; python_version<"3.7"
+	rich>=10.0.0
+	flask>=2.0; python_version>="3.7"
+	flask<2.1; python_version<"3.7"
+	dataclasses; python_version < "3.7"
+	flask-socketio==5.3.3
+	python-socketio==5.9.0
+	pyperclip>=1.9.0,<2.0.0
+	importlib-metadata>=4.8.0; python_version < "3.8"
+	requests>=2.28.0; python_version>="3.7"
+	requests>=2.27.0; python_version<"3.7"
+	pyautogui>=0.9.50,<1.0.0
+	psutil==5.8.0 ; python_version < "3.12"
+	psutil>=5.9.0 ; python_version >= "3.12"
+	waitress>=2.0.0
+
+[options.extras_require]
+dev = 
+	pytest>=7.0.0,<8.0.0
+	pytest-cov>=4.0.0,<5.0.0
+	beautifulsoup4>=4.10.0,<4.11.0
+	commitizen
+	build
+	twine
+
+[options.packages.find]
+where = src
+exclude = 
+	fcbyk.tests
+	fcbyk.tests.*
+
+[options.entry_points]
+console_scripts = 
+	fcbyk = fcbyk.cli:main
+	byk = fcbyk.cli:main
+
+[options.package_data]
+fcbyk = 
+	web/dist/**/*
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/setup.py

@@ -1,4 +1,4 @@
-from setuptools import setup
-
-# 依赖/元数据主要放在 setup.cfg；这里保留最小 setup.py 以兼容老的构建工具。
-setup()
+from setuptools import setup
+
+# 依赖/元数据主要放在 setup.cfg；这里保留最小 setup.py 以兼容老的构建工具。
+setup()

{fcbyk_cli-0.2.2 → fcbyk_cli-0.3.0}/src/fcbyk/cli.py

@@ -1,46 +1,51 @@
-#!/usr/bin/env python3
-import click,random
-
-from fcbyk import commands
-from fcbyk.commands.alias import AliasedGroup
-from fcbyk.cli_support import (
-    version_callback, 
-    print_aliases, 
-    add_gui_options, 
-    banner
-)
-
-
-@click.group(
-    cls=AliasedGroup,
-    context_settings=dict(
-        help_option_names=['-h', '--help']
-    ),
-    invoke_without_command=True
-)
-@click.option(
-    '--version', '-v', 
-    is_flag=True, 
-    callback=version_callback, 
-    expose_value=False, 
-    is_eager=True, 
-    help='Show version and exit.'
-)
-@add_gui_options
-@click.pass_context
-def cli(ctx):
-    if ctx.invoked_subcommand is None:
-        banner_text = random.choice(banner)
-        
-        click.secho(banner_text, fg="white", dim=True)
-        click.echo(ctx.get_help())      # 帮助信息
-        print_aliases()                 # 打印别名，如果有
-
-
-# 注册子命令
-for cmd_name in commands.__all__:
-    cli.add_command(getattr(commands, cmd_name))
-
-
-if __name__ == "__main__":
-    cli()
+#!/usr/bin/env python3
+import click, random, os
+from fcbyk import commands, defaults
+from fcbyk.utils import storage
+from fcbyk.commands.alias import AliasedGroup
+from fcbyk.cli_support import (
+    version_callback, 
+    print_aliases, 
+    print_commands,
+    banner
+)
+
+
+@click.group(
+    cls=AliasedGroup,
+    context_settings=dict(
+        help_option_names=['-h', '--help']
+    ),
+    invoke_without_command=True
+)
+@click.option(
+    '--version', '-v', 
+    is_flag=True, 
+    callback=version_callback, 
+    expose_value=False, 
+    is_eager=True, 
+    help='Show version and exit.'
+)
+@click.pass_context
+def main(ctx):
+    # 初始化默认配置
+    config_path = storage.get_path(defaults.CONFIG_FILE)
+    if not os.path.exists(config_path):
+        storage.save_json(config_path, defaults.DEFAULT_CONFIG)
+
+    if ctx.invoked_subcommand is None:
+        banner_text = random.choice(banner)
+        
+        click.secho(banner_text, fg="white", dim=True)
+        click.echo(ctx.get_help())      # 帮助信息
+        print_aliases()                 # 打印别名，如果有
+        print_commands(leading_newline=False, merge_local=True)  # 打印已存脚本，如果有
+
+
+# 注册子命令
+for cmd_name in commands.__all__:
+    main.add_command(getattr(commands, cmd_name))
+
+
+if __name__ == "__main__":
+    main()

fcbyk_cli-0.3.0/src/fcbyk/cli_support/__init__.py

@@ -0,0 +1,11 @@
+"""CLI 支持模块"""
+
+from .callbacks import (
+    version_callback, 
+    print_aliases, 
+    print_commands
+)
+
+from .helpers import banner
+
+__all__ = ['version_callback', 'print_aliases', 'banner', 'print_commands']