illusion-code 0.1.0__tar.gz → 0.1.2__tar.gz

{illusion_code-0.1.0 → illusion_code-0.1.2}/.github/workflows/publish.yml

@@ -34,15 +34,7 @@ jobs:
         run: ruff check src/
 
       - name: Test
-        run: |
-          pytest tests/ -q \
-            --deselect tests/test_mcp/test_stdio_flow.py::test_stdio_mcp_manager_connects_and_executes_real_server \
-            --deselect tests/test_plugins/test_lifecycle_flow.py::test_plugin_install_load_and_uninstall_flow \
-            --deselect tests/test_skills/test_loader.py::test_load_skill_registry_includes_bundled \
-            --deselect tests/test_tools/test_core_tools.py::test_glob_and_grep \
-            --deselect tests/test_tools/test_integration_flows.py::test_search_edit_flow_across_registry \
-            --deselect tests/test_auth/test_external.py::test_external_binding_for_codex_without_switching \
-            --deselect tests/test_commands/test_registry.py::test_agents_session_files_and_reload_plugins_commands
+        run: pytest tests/ -q
 
       - name: Build
         run: python -m build

{illusion_code-0.1.0 → illusion_code-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: illusion-code
-Version: 0.1.0
+Version: 0.1.2
 Summary: Open-source Python port of Claude Code - an AI-powered CLI coding assistant
 Project-URL: Homepage, https://github.com/YunTaiHua/illusion-code
 Project-URL: Repository, https://github.com/YunTaiHua/illusion-code
@@ -133,17 +133,41 @@ IllusionCode is an open-source AI-powered command-line programming assistant tha
 
 ### Installation
 
-#### Recommended: pip install (one-step setup)
+#### Recommended: pip install from PyPI
 
-`pip install .` triggers the hatch build hook to automatically build both frontends (terminal TUI and Web UI), and registers the `illusion` command globally. This is the simplest way to get started.
+The simplest way to install IllusionCode. Automatically installs both frontends and registers the `illusion` command globally.
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+No git clone or Node.js required — everything is included in the package.
+
+#### Alternative: pip install from source
+
+Clone the repository and install locally. Triggers the hatch build hook to build frontends automatically.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-After installation, `illusion` is available globally from any directory. Requires Node.js 18+ (for frontend build).
+Requires Node.js 18+ (for frontend build).
+
+#### Alternative: pip install -e . (editable, from source)
+
+Editable install from source. Like `pip install .`, it triggers the hatch build hook to build frontends automatically and registers `illusion` globally. Like `uv sync`, source code changes take effect immediately without reinstalling.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install -e .
+```
+
+Requires Node.js 18+ (for frontend build).
+
+> **When to use**: Best for developers who want both an editable install (live code changes) and the `illusion` command available globally. Unlike `uv sync`, no manual frontend build or `uv run` wrapper is needed.
 
 #### Alternative: uv sync (for development)
 
@@ -176,11 +200,14 @@ python scripts/build_frontend.py --web        # Web UI only
 >
 > # Option 3: Install globally with pip (recommended)
 > pip install .
+>
+> # Option 4: Editable install with pip (global + live code changes)
+> pip install -e .
 > ```
 
-#### Manual frontend build (for both methods)
+#### Manual frontend build (for source installs only)
 
-If you need to rebuild frontends manually (e.g., after updating frontend code):
+If you installed from source and need to rebuild frontends (e.g., after updating frontend code). PyPI users do not need this step.
 
 **Build script (recommended)**
 
@@ -208,12 +235,15 @@ cd ../..
 
 #### Key differences
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| Frontend build | Automatic (hatch hook) | Manual |
-| `illusion` command | Global | Project-only (via `uv run` or venv activation) | 
-| Install type | Standard | Editable |
-| Best for | End users | Developers |
+| | `pip install illusion-code` | `pip install .` | `pip install -e .` | `uv sync` |
+|---|---|---|---|---|
+| Source | PyPI | Local git clone | Local git clone | Local git clone |
+| Frontend build | Pre-built (included) | Automatic (hatch hook) | Automatic (hatch hook) | Manual |
+| Node.js required | No | Yes (18+) | Yes (18+) | Yes (18+) |
+| `illusion` command | Global | Global | Global | Project-only (via `uv run` or venv activation) |
+| Install type | Standard | Standard | Editable | Editable |
+| Code changes take effect | Reinstall needed | Reinstall needed | Immediately | Immediately |
+| Best for | End users | Contributors | Developers (global + editable) | Developers |
 
 ### Basic Usage
 
@@ -290,6 +320,10 @@ illusion cron toggle <name> <true|false>  # Enable/disable task
 illusion cron run <name>         # Manually trigger task
 illusion cron history            # View execution history
 illusion cron logs               # View scheduler logs
+
+# Self-update
+illusion update                  # Check for and install updates from PyPI
+illusion update --deps           # Also update project dependencies
 ```
 
 ### Interactive Slash Commands
@@ -304,6 +338,7 @@ In interactive sessions, you can use the following commands:
 | Plugin Extensions | `/skills`, `/hooks`, `/mcp`, `/plugin` | Manage extension features |
 | Project Git | `/init`, `/diff`, `/branch`, `/commit` | Project and version control |
 | Multi-Agent | `/continue` | Agent collaboration |
+| Self-Update | `/update` | Check for and install IllusionCode updates |
 
 ---
 
@@ -586,7 +621,7 @@ settings.json uses the `env_N` grouped format to manage multiple environment/pro
 | `env_N` | object | - | Environment config group (EnvConfig), supports dynamic env_1, env_2... | See EnvConfig field description below |
 | `model` | string | "env_1.model_1" | Active model reference, format: `env_N.model_N` | `"env_2.model_1"` |
 | `context_window` | int | 200000 | Context window size | `128000` |
-| `system_prompt` | string\|null | null | Custom system prompt (global override) | `"You are a professional Python developer"` |
+| `system_prompt` | string\|null | null | Custom system prompt (global; can be overridden per env_N) | `"You are a professional Python developer"` |
 | `max_tokens` | int | 16384 | Maximum output token count | `32768` |
 | `max_turns` | int | 200 | Maximum conversation turns | `500` |
 | `ui_language` | string | "en-US" | UI language | `"zh-CN"` |
@@ -609,7 +644,7 @@ IllusionCode supports managing multiple environment/provider configurations thro
 | `base_url` | string\|null | No | Custom API endpoint, null uses default endpoint |
 | `api_key` | string | No | API key (can be filled directly, or left empty for `illusion auth login` to store in credentials.json) |
 | `system_prompt` | string\|null | No | System prompt for this environment (overrides global) |
-| `model_N` | string | No | Model name, supports multiple: model_1, model_2, model_3... |
+| `model_N` | string | No | Model name, supports multiple: model_1, model_2, model_3... Append `[1m]` for million-token context (e.g. `claude-sonnet-4-6[1m]`) |
 
 #### Multi-Model Configuration Example
 
@@ -628,6 +663,9 @@ Configure multiple models under the same environment, switch via `env_N.model_N`
 }
 ```
 
+> **Million-Token Context**: Anthropic models support the `[1m]` suffix for extended 1M context window. Append it to the model name (e.g. `claude-sonnet-4-6[1m]`). IllusionCode automatically detects this suffix and adjusts the internal context tracking to 1,000,000 tokens.
+```
+
 **Ways to switch models**:
 
 ```bash

{illusion_code-0.1.0 → illusion_code-0.1.2}/README.md

@@ -85,17 +85,41 @@ IllusionCode is an open-source AI-powered command-line programming assistant tha
 
 ### Installation
 
-#### Recommended: pip install (one-step setup)
+#### Recommended: pip install from PyPI
 
-`pip install .` triggers the hatch build hook to automatically build both frontends (terminal TUI and Web UI), and registers the `illusion` command globally. This is the simplest way to get started.
+The simplest way to install IllusionCode. Automatically installs both frontends and registers the `illusion` command globally.
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+No git clone or Node.js required — everything is included in the package.
+
+#### Alternative: pip install from source
+
+Clone the repository and install locally. Triggers the hatch build hook to build frontends automatically.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-After installation, `illusion` is available globally from any directory. Requires Node.js 18+ (for frontend build).
+Requires Node.js 18+ (for frontend build).
+
+#### Alternative: pip install -e . (editable, from source)
+
+Editable install from source. Like `pip install .`, it triggers the hatch build hook to build frontends automatically and registers `illusion` globally. Like `uv sync`, source code changes take effect immediately without reinstalling.
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install -e .
+```
+
+Requires Node.js 18+ (for frontend build).
+
+> **When to use**: Best for developers who want both an editable install (live code changes) and the `illusion` command available globally. Unlike `uv sync`, no manual frontend build or `uv run` wrapper is needed.
 
 #### Alternative: uv sync (for development)
 
@@ -128,11 +152,14 @@ python scripts/build_frontend.py --web        # Web UI only
 >
 > # Option 3: Install globally with pip (recommended)
 > pip install .
+>
+> # Option 4: Editable install with pip (global + live code changes)
+> pip install -e .
 > ```
 
-#### Manual frontend build (for both methods)
+#### Manual frontend build (for source installs only)
 
-If you need to rebuild frontends manually (e.g., after updating frontend code):
+If you installed from source and need to rebuild frontends (e.g., after updating frontend code). PyPI users do not need this step.
 
 **Build script (recommended)**
 
@@ -160,12 +187,15 @@ cd ../..
 
 #### Key differences
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| Frontend build | Automatic (hatch hook) | Manual |
-| `illusion` command | Global | Project-only (via `uv run` or venv activation) | 
-| Install type | Standard | Editable |
-| Best for | End users | Developers |
+| | `pip install illusion-code` | `pip install .` | `pip install -e .` | `uv sync` |
+|---|---|---|---|---|
+| Source | PyPI | Local git clone | Local git clone | Local git clone |
+| Frontend build | Pre-built (included) | Automatic (hatch hook) | Automatic (hatch hook) | Manual |
+| Node.js required | No | Yes (18+) | Yes (18+) | Yes (18+) |
+| `illusion` command | Global | Global | Global | Project-only (via `uv run` or venv activation) |
+| Install type | Standard | Standard | Editable | Editable |
+| Code changes take effect | Reinstall needed | Reinstall needed | Immediately | Immediately |
+| Best for | End users | Contributors | Developers (global + editable) | Developers |
 
 ### Basic Usage
 
@@ -242,6 +272,10 @@ illusion cron toggle <name> <true|false>  # Enable/disable task
 illusion cron run <name>         # Manually trigger task
 illusion cron history            # View execution history
 illusion cron logs               # View scheduler logs
+
+# Self-update
+illusion update                  # Check for and install updates from PyPI
+illusion update --deps           # Also update project dependencies
 ```
 
 ### Interactive Slash Commands
@@ -256,6 +290,7 @@ In interactive sessions, you can use the following commands:
 | Plugin Extensions | `/skills`, `/hooks`, `/mcp`, `/plugin` | Manage extension features |
 | Project Git | `/init`, `/diff`, `/branch`, `/commit` | Project and version control |
 | Multi-Agent | `/continue` | Agent collaboration |
+| Self-Update | `/update` | Check for and install IllusionCode updates |
 
 ---
 
@@ -538,7 +573,7 @@ settings.json uses the `env_N` grouped format to manage multiple environment/pro
 | `env_N` | object | - | Environment config group (EnvConfig), supports dynamic env_1, env_2... | See EnvConfig field description below |
 | `model` | string | "env_1.model_1" | Active model reference, format: `env_N.model_N` | `"env_2.model_1"` |
 | `context_window` | int | 200000 | Context window size | `128000` |
-| `system_prompt` | string\|null | null | Custom system prompt (global override) | `"You are a professional Python developer"` |
+| `system_prompt` | string\|null | null | Custom system prompt (global; can be overridden per env_N) | `"You are a professional Python developer"` |
 | `max_tokens` | int | 16384 | Maximum output token count | `32768` |
 | `max_turns` | int | 200 | Maximum conversation turns | `500` |
 | `ui_language` | string | "en-US" | UI language | `"zh-CN"` |
@@ -561,7 +596,7 @@ IllusionCode supports managing multiple environment/provider configurations thro
 | `base_url` | string\|null | No | Custom API endpoint, null uses default endpoint |
 | `api_key` | string | No | API key (can be filled directly, or left empty for `illusion auth login` to store in credentials.json) |
 | `system_prompt` | string\|null | No | System prompt for this environment (overrides global) |
-| `model_N` | string | No | Model name, supports multiple: model_1, model_2, model_3... |
+| `model_N` | string | No | Model name, supports multiple: model_1, model_2, model_3... Append `[1m]` for million-token context (e.g. `claude-sonnet-4-6[1m]`) |
 
 #### Multi-Model Configuration Example
 
@@ -580,6 +615,9 @@ Configure multiple models under the same environment, switch via `env_N.model_N`
 }
 ```
 
+> **Million-Token Context**: Anthropic models support the `[1m]` suffix for extended 1M context window. Append it to the model name (e.g. `claude-sonnet-4-6[1m]`). IllusionCode automatically detects this suffix and adjusts the internal context tracking to 1,000,000 tokens.
+```
+
 **Ways to switch models**:
 
 ```bash

{illusion_code-0.1.0 → illusion_code-0.1.2}/README.zh-CN.md

@@ -85,17 +85,41 @@ IllusionCode 是一个开源的 AI 驱动命令行编程助手，集成了众多
 
 ### 安装
 
-#### 推荐方式：pip install（一步到位）
+#### 推荐方式：从 PyPI 安装
 
-`pip install .` 会触发 hatch build hook 自动构建两个前端（终端 TUI 和 Web UI），并将 `illusion` 命令注册到全局 PATH。这是最简单的安装方式。
+最简单的安装方式，自动安装前端并注册 `illusion` 命令到全局 PATH。
 
 ```bash
-git clone https://github.com/your-repo/illusion-code.git
+pip install illusion-code
+```
+
+无需克隆仓库或安装 Node.js，所有内容已包含在包中。
+
+#### 备选方式：从源码安装
+
+克隆仓库后本地安装，hatch build hook 会自动构建前端。
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
 cd illusion-code
 pip install .
 ```
 
-安装完成后，`illusion` 命令在任意目录均可直接使用。需要 Node.js 18+（用于前端构建）。
+需要 Node.js 18+（用于前端构建）。
+
+#### 备选方式：pip install -e .（可编辑安装，从源码）
+
+从源码进行可编辑安装。与 `pip install .` 相同，会触发 hatch build hook 自动构建前端并全局注册 `illusion` 命令；与 `uv sync` 相同，源码修改立即生效，无需重新安装。
+
+```bash
+git clone https://github.com/YunTaiHua/illusion-code.git
+cd illusion-code
+pip install -e .
+```
+
+需要 Node.js 18+（用于前端构建）。
+
+> **适用场景**：适合希望同时拥有可编辑安装（代码即时生效）和全局 `illusion` 命令的开发者。与 `uv sync` 不同，无需手动构建前端，也无需使用 `uv run` 包装。
 
 #### 开发方式：uv sync（适合开发者）
 
@@ -128,11 +152,14 @@ python scripts/build_frontend.py --web        # 只构建 Web UI
 >
 > # 方式三：使用 pip 全局安装（推荐）
 > pip install .
+>
+> # 方式四：pip 可编辑安装（全局 + 代码即时生效）
+> pip install -e .
 > ```
 
-#### 手动构建前端
+#### 手动构建前端（仅源码安装需要）
 
-如需手动重新构建前端（例如更新了前端代码）：
+如从源码安装后需要重新构建前端（例如更新了前端代码）。PyPI 用户无需此步骤。
 
 **构建脚本（推荐）**
 
@@ -158,14 +185,17 @@ npm run build
 cd ../..
 ```
 
-#### 两种方式对比
+#### 四种方式对比
 
-| | `pip install .` | `uv sync` |
-|---|---|---|
-| 前端构建 | 自动（hatch hook） | 手动 |
-| `illusion` 命令 | 全局可用 | 仅项目内（需 `uv run` 或激活虚拟环境） |
-| 安装类型 | 标准安装 | Editable 安装 |
-| 适用场景 | 终端用户 | 开发者 |
+| | `pip install illusion-code` | `pip install .` | `pip install -e .` | `uv sync` |
+|---|---|---|---|---|
+| 来源 | PyPI | 本地 git clone | 本地 git clone | 本地 git clone |
+| 前端构建 | 预构建（已包含） | 自动（hatch hook） | 自动（hatch hook） | 手动 |
+| 需要 Node.js | 否 | 是（18+） | 是（18+） | 是（18+） |
+| `illusion` 命令 | 全局可用 | 全局可用 | 全局可用 | 仅项目内（需 `uv run` 或激活虚拟环境） |
+| 安装类型 | 标准安装 | 标准安装 | 可编辑安装 | 可编辑安装 |
+| 代码修改生效 | 需重新安装 | 需重新安装 | 即时生效 | 即时生效 |
+| 适用场景 | 终端用户 | 贡献者 | 开发者（全局+可编辑） | 开发者 |
 
 ### 基本使用
 
@@ -242,6 +272,10 @@ illusion cron toggle <name> <true|false>  # 启用/禁用任务
 illusion cron run <name>         # 手动触发执行任务
 illusion cron history            # 查看执行历史
 illusion cron logs               # 查看调度器日志
+
+# 自更新
+illusion update                  # 检查并从 PyPI 安装更新
+illusion update --deps           # 同时更新项目依赖
 ```
 
 ### 交互式斜杠命令
@@ -256,6 +290,7 @@ illusion cron logs               # 查看调度器日志
 | 插件扩展 | `/skills`, `/hooks`, `/mcp`, `/plugin` | 管理扩展功能 |
 | 项目 Git | `/init`, `/diff`, `/branch`, `/commit` | 项目与版本控制 |
 | 多智能体 | `/continue` | Agent 协作 |
+| 自更新 | `/update` | 检查并安装 IllusionCode 更新 |
 
 ---
 
@@ -538,7 +573,7 @@ settings.json 使用 `env_N` 分组格式管理多个环境/提供商配置。
 | `env_N` | object | - | 环境配置组（EnvConfig），支持动态添加 env_1, env_2... | 见下方 EnvConfig 字段说明 |
 | `model` | string | "env_1.model_1" | 当前活跃模型引用，格式为 `env_N.model_N` | `"env_2.model_1"` |
 | `context_window` | int | 200000 | 上下文窗口大小 | `128000` |
-| `system_prompt` | string\|null | null | 自定义系统提示词（全局覆盖） | `"你是一个专业的Python开发者"` |
+| `system_prompt` | string\|null | null | 自定义系统提示词（全局，可被 env_N 级别覆盖） | `"你是一个专业的Python开发者"` |
 | `max_tokens` | int | 16384 | 最大输出 token 数 | `32768` |
 | `max_turns` | int | 200 | 最大对话轮数 | `500` |
 | `ui_language` | string | "zh-CN" | 界面语言 | `"en-US"` |
@@ -561,7 +596,7 @@ IllusionCode 支持通过 `env_N` 分组管理多个环境/提供商配置。每
 | `base_url` | string\|null | 否 | 自定义 API 端点，null 表示使用默认端点 |
 | `api_key` | string | 否 | API 密钥（可直接填写，也可留空由 `illusion auth login` 存储到 credentials.json） |
 | `system_prompt` | string\|null | 否 | 该环境的系统提示词（覆盖全局） |
-| `model_N` | string | 否 | 模型名称，支持多个 model_1, model_2, model_3... |
+| `model_N` | string | 否 | 模型名称，支持多个 model_1, model_2, model_3... 追加 `[1m]` 可启用百万上下文（如 `claude-sonnet-4-6[1m]`） |
 
 #### 多模型配置示例
 
@@ -580,6 +615,9 @@ IllusionCode 支持通过 `env_N` 分组管理多个环境/提供商配置。每
 }
 ```
 
+> **百万上下文**：Anthropic 模型支持 `[1m]` 后缀以启用 100 万 token 的扩展上下文窗口。在模型名后追加即可（如 `claude-sonnet-4-6[1m]`）。IllusionCode 会自动检测此后缀并将内部上下文追踪调整为 1,000,000 tokens。
+```
+
 **切换模型的方式**：
 
 ```bash