@@ -70,6 +74,8 @@
`conda-helper` 是一个轻量、跨平台的 Conda 命令行增强工具。它基于原生 [`conda`](https://docs.conda.io/) 封装常用环境管理动作，把繁琐命令变成清晰的一行命令，并提供更友好的错误提示与交互式面板。
+项目介绍网站：[`wellkilo.github.io/conda-helper`](https://wellkilo.github.io/conda-helper/)
+
diff --git a/docs/.nojekyll b/docs/.nojekyll
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/docs/.nojekyll
@@ -0,0 +1 @@
+
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..d1dfb9c
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,196 @@
+
+
+
+ conda-helper · Beautiful Conda environment workflows
+
+
+
+
+
+
+
Python CLI · Conda · Cross-platform
+
Make Conda environment operations beautiful, safe, and repeatable.
+
+ conda-helper wraps frequent environment tasks into readable one-liners,
+ adds safer defaults, and turns common Conda failures into actionable
+ hints for research, data science, and local development workflows.
+
+
+
+
8+ CLI commands
+
3 platform families
+
MIT open source
+
+
+
+
$ conda-helper ls
+NAME SIZE PREFIX
+base 4.2 GB /opt/miniconda3
+vision-lab 9.8 GB /envs/vision-lab
+
+$ conda-helper backup vision-lab --from-history
+backup written: vision-lab-20260601-101530-history.yml
+
+$ conda-helper pack vision-lab -o ./dist
+archive ready: dist/vision-lab-20260601-101630.tar.gz
+
+
+
+ Backup
+ Restore
+ Clone
+ Pack
+ Clean
+ Doctor
+ Panel
+
+
+
+
+
Feature map
+
Everything you need for daily Conda environment operations.
+
+ Designed for users who manage many local environments and want a safer,
+ more memorable interface on top of native Conda.
+
+
+
+ 01
+ Versioned backups
+ Export environments to timestamped YAML files, with history-only mode for portable migrations.
+
+
+ 02
+ Restore and rename
+ Rebuild from any backup and override the target environment name during restore.
+
+
+ 03
+ One-command cloning
+ Wrap native conda create --clone into a compact, easy-to-remember command.
+
+
+ 04
+ Offline archives
+ Prefer conda-pack for relocatable archives and fall back to metadata-rich tarballs.
+
+
+ 05
+ Safe cleanup
+ Batch-remove stale environments and preview cache cleanup with dry-run support.
+
+
+ 06
+ Friendly diagnostics
+ Run health checks and translate network, disk, channel, and permission problems into practical hints.
+
+
+
+
+
+
Workflow design
+
A CLI that follows how environments actually move.
+
+ conda-helper organizes Conda operations around a repeatable lifecycle:
+ inspect, preserve, move, deploy, and clean. Each command has clear output
+ and conservative behavior by default.
+
+
+
Inspect conda-helper ls shows size and prefix.
+
Preserve backup --from-history keeps migrations portable.
+
Move restore, clone, and pack cover common transfer paths.
+
Recover doctor and friendly errors guide next actions.
+
+
+
+
+
Technical design
+
Small modules, testable boundaries, native Conda underneath.
+
+
+ Click-based interface
+ The command layer provides ergonomic flags, aliases, validation, and terminal-friendly output.
+
+
+ Command service layer
+ High-level operations return plain Python data so core behavior can be unit-tested independently.
+
+
+ Conda wrapper
+ A focused adapter delegates to the real Conda executable instead of reimplementing package logic.
+
+
+ Actionable error model
+ Known Conda failure patterns are mapped to friendly explanations and next-step suggestions.
+
+
+
+
+
+
Install
+
Start from PyPI or source.
+
Requires Python 3.8+ and an available Conda installation.
+
pip install conda-helper
+conda-helper doctor
+
+# or install from source
+git clone https://github.com/wellkilo/conda-helper.git
+cd conda-helper
+pip install -e .
+
+
+
+
+ 