illusion-code 0.1.1__tar.gz → 0.1.3__tar.gz

{illusion_code-0.1.1 → illusion_code-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: illusion-code
-Version: 0.1.1
+Version: 0.1.3
 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
@@ -155,6 +155,20 @@ pip install .
 
 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)
 
 `uv sync` creates an editable install within the project directory. It does **not** trigger the hatch build hook, so you must build frontends manually. This is recommended for developers who want to modify the source code.
@@ -186,6 +200,9 @@ 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 source installs only)
@@ -194,8 +211,6 @@ If you installed from source and need to rebuild frontends (e.g., after updating
 
 **Build script (recommended)**
 
-**Build script (recommended)**
-
 ```bash
 python scripts/build_frontend.py              # Build both
 python scripts/build_frontend.py --terminal   # Terminal TUI only
@@ -220,14 +235,15 @@ cd ../..
 
 #### Key differences
 
-| | `pip install illusion-code` | `pip install .` | `uv sync` |
-|---|---|---|---|
-| Source | PyPI | Local git clone | Local git clone |
-| Frontend build | Pre-built (included) | Automatic (hatch hook) | Manual |
-| Node.js required | No | Yes (18+) | Yes (18+) |
-| `illusion` command | Global | Global | Project-only (via `uv run` or venv activation) |
-| Install type | Standard | Standard | Editable |
-| Best for | End users | Contributors | 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
 
@@ -304,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
@@ -318,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 |
 
 ---
 
@@ -600,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"` |
@@ -623,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
 
@@ -642,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.1 → illusion_code-0.1.3}/README.md

@@ -107,6 +107,20 @@ pip install .
 
 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)
 
 `uv sync` creates an editable install within the project directory. It does **not** trigger the hatch build hook, so you must build frontends manually. This is recommended for developers who want to modify the source code.
@@ -138,6 +152,9 @@ 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 source installs only)
@@ -146,8 +163,6 @@ If you installed from source and need to rebuild frontends (e.g., after updating
 
 **Build script (recommended)**
 
-**Build script (recommended)**
-
 ```bash
 python scripts/build_frontend.py              # Build both
 python scripts/build_frontend.py --terminal   # Terminal TUI only
@@ -172,14 +187,15 @@ cd ../..
 
 #### Key differences
 
-| | `pip install illusion-code` | `pip install .` | `uv sync` |
-|---|---|---|---|
-| Source | PyPI | Local git clone | Local git clone |
-| Frontend build | Pre-built (included) | Automatic (hatch hook) | Manual |
-| Node.js required | No | Yes (18+) | Yes (18+) |
-| `illusion` command | Global | Global | Project-only (via `uv run` or venv activation) |
-| Install type | Standard | Standard | Editable |
-| Best for | End users | Contributors | 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
 
@@ -256,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
@@ -270,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 |
 
 ---
 
@@ -552,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"` |
@@ -575,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
 
@@ -594,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.1 → illusion_code-0.1.3}/README.zh-CN.md

@@ -107,6 +107,20 @@ pip install .
 
 需要 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（适合开发者）
 
 `uv sync` 创建 editable install，不会触发 hatch build hook，需要手动构建前端。适合需要修改源代码的开发者。
@@ -138,6 +152,9 @@ python scripts/build_frontend.py --web        # 只构建 Web UI
 >
 > # 方式三：使用 pip 全局安装（推荐）
 > pip install .
+>
+> # 方式四：pip 可编辑安装（全局 + 代码即时生效）
+> pip install -e .
 > ```
 
 #### 手动构建前端（仅源码安装需要）
@@ -168,16 +185,17 @@ npm run build
 cd ../..
 ```
 
-#### 三种方式对比
+#### 四种方式对比
 
-| | `pip install illusion-code` | `pip install .` | `uv sync` |
-|---|---|---|---|
-| 来源 | PyPI | 本地 git clone | 本地 git clone |
-| 前端构建 | 预构建（已包含） | 自动（hatch hook） | 手动 |
-| 需要 Node.js | 否 | 是（18+） | 是（18+） |
-| `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` 或激活虚拟环境） |
+| 安装类型 | 标准安装 | 标准安装 | 可编辑安装 | 可编辑安装 |
+| 代码修改生效 | 需重新安装 | 需重新安装 | 即时生效 | 即时生效 |
+| 适用场景 | 终端用户 | 贡献者 | 开发者（全局+可编辑） | 开发者 |
 
 ### 基本使用
 
@@ -254,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           # 同时更新项目依赖
 ```
 
 ### 交互式斜杠命令
@@ -268,6 +290,7 @@ illusion cron logs               # 查看调度器日志
 | 插件扩展 | `/skills`, `/hooks`, `/mcp`, `/plugin` | 管理扩展功能 |
 | 项目 Git | `/init`, `/diff`, `/branch`, `/commit` | 项目与版本控制 |
 | 多智能体 | `/continue` | Agent 协作 |
+| 自更新 | `/update` | 检查并安装 IllusionCode 更新 |
 
 ---
 
@@ -550,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"` |
@@ -573,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]`） |
 
 #### 多模型配置示例
 
@@ -592,6 +615,9 @@ IllusionCode 支持通过 `env_N` 分组管理多个环境/提供商配置。每
 }
 ```
 
+> **百万上下文**：Anthropic 模型支持 `[1m]` 后缀以启用 100 万 token 的扩展上下文窗口。在模型名后追加即可（如 `claude-sonnet-4-6[1m]`）。IllusionCode 会自动检测此后缀并将内部上下文追踪调整为 1,000,000 tokens。
+```
+
 **切换模型的方式**：
 
 ```bash