illusion-code 0.2.1__tar.gz → 0.2.2__tar.gz

{illusion_code-0.2.1 → illusion_code-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: illusion-code
-Version: 0.2.1
+Version: 0.2.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

{illusion_code-0.2.1 → illusion_code-0.2.2}/docs/zh-CN/extensions.md

@@ -433,3 +433,211 @@ hooks:
 - 钩子事件：`src/illusion/hooks/events.py`
 - 钩子 schema：`src/illusion/hooks/schemas.py`
 - 钩子类型：`src/illusion/hooks/types.py`
+
+---
+
+## 插件配置
+
+### 全局启用/禁用
+
+在 `~/.illusion/settings.json` 的 `enabled_plugins` 字段中控制：
+
+```json
+{
+  "enabled_plugins": {
+    "plugin-name": true,   // 启用
+    "plugin-name": false   // 禁用
+  }
+}
+```
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_plugins` 字段中控制：
+
+```json
+{
+  "denied_plugins": ["plugin-name"]  // 禁用特定插件
+  "denied_plugins": ["*"]            // 禁用所有插件
+}
+```
+
+### 优先级
+
+项目级 `denied_plugins` > 全局 `enabled_plugins` > 默认值
+
+### 源码参考
+
+- 插件加载器：`src/illusion/plugins/loader.py`
+
+---
+
+## MCP 服务器配置
+
+### 全局启用/禁用
+
+在 MCP 服务器配置中添加 `enabled` 字段：
+
+```json
+{
+  "mcp_servers": {
+    "server-name": {
+      "type": "stdio",
+      "command": "python",
+      "args": ["server.py"],
+      "enabled": false  // 禁用此服务器
+    }
+  }
+}
+```
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_mcp_servers` 字段中控制：
+
+```json
+{
+  "denied_mcp_servers": ["server-name"]  // 禁用特定服务器
+  "denied_mcp_servers": ["*"]            // 禁用所有服务器
+}
+```
+
+### 优先级
+
+项目级 `denied_mcp_servers` > 全局 `enabled` 字段 > 默认值
+
+### 源码参考
+
+- MCP 配置加载器：`src/illusion/mcp/config.py`
+
+---
+
+## 记忆系统配置
+
+### 全局启用/禁用
+
+在 `~/.illusion/settings.json` 的 `memory.enabled` 字段中控制：
+
+```json
+{
+  "memory": {
+    "enabled": false  // 禁用记忆功能
+  }
+}
+```
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_memory` 字段中控制：
+
+```json
+{
+  "denied_memory": true  // 禁用记忆功能
+}
+```
+
+### 优先级
+
+项目级 `denied_memory` > 全局 `memory.enabled` > 默认值
+
+### 源码参考
+
+- 记忆管理器：`src/illusion/memory/manager.py`
+
+---
+
+## Skills 配置
+
+### 加载来源
+
+Skills 可以从以下位置加载：
+- 内置 skills（`src/illusion/skills/bundled/`）
+- 用户 skills（`~/.illusion/skills/`）
+- 项目级 skills（`<project>/.illusion/skills/`）
+- 插件 skills（插件的 `skills/` 目录）
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_skills` 字段中控制：
+
+```json
+{
+  "denied_skills": ["skill-name"]  // 禁用特定 skill
+  "denied_skills": ["*"]           // 禁用所有 skills
+}
+```
+
+### 源码参考
+
+- Skills 加载器：`src/illusion/skills/loader.py`
+
+---
+
+## Hooks 配置
+
+### 加载来源
+
+Hooks 可以从以下位置加载：
+- 全局 `settings.json` 的 `hooks` 字段
+- 插件的 `hooks.json` 文件
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_hooks` 字段中控制：
+
+```json
+{
+  "denied_hooks": ["PreToolUse"]  // 禁用特定事件的 hooks
+  "denied_hooks": ["*"]           // 禁用所有 hooks
+}
+```
+
+### 源码参考
+
+- Hooks 加载器：`src/illusion/hooks/loader.py`
+
+---
+
+## Commands 配置
+
+### 命令类型
+
+IllusionCode 的斜杠命令分为两类：
+
+1. **内置命令**：如 `/help`、`/model`、`/skills` 等，硬编码注册，不可禁用
+2. **插件命令**：通过插件的 `commands/` 或 `skills/` 目录提供，遵循插件的启用/禁用规则
+
+### 插件命令的启用/禁用
+
+- 通过 `enabled_plugins` 控制插件整体启用/禁用
+- 通过 `denied_plugins` 项目级禁用插件
+- 插件禁用后，其提供的所有命令都会被禁用
+
+### 源码参考
+
+- 命令注册表：`src/illusion/commands/registry.py`
+
+---
+
+## Rules 配置
+
+### 加载来源
+
+Rules 从以下位置加载：
+- `.claude/rules/*.md`
+- `.illusion/rules/*.md`
+
+### 项目级禁用
+
+在 `<project>/.illusion/permissions.json` 的 `denied_rules` 字段中控制：
+
+```json
+{
+  "denied_rules": ["rule-name"]  // 禁用特定 rule
+  "denied_rules": ["*"]          // 禁用所有 rules
+}
+```
+
+### 源码参考
+
+- Rules 发现逻辑：`src/illusion/prompts/claudemd.py`

{illusion_code-0.2.1 → illusion_code-0.2.2}/docs/zh-CN/project-files.md

@@ -119,3 +119,47 @@ metadata:
 - 路径解析：`src/illusion/memory/paths.py`
 - 加载逻辑：`src/illusion/memory/memdir.py`
 - 管理功能：`src/illusion/memory/manager.py`
+
+---
+
+## 项目级权限配置 (permissions.json)
+
+项目级 `permissions.json` 文件位于 `<project>/.illusion/permissions.json`，用于控制该项目的权限和禁用开关。
+
+### 配置示例
+
+```json
+{
+  "always_allow_tools": ["read_file", "grep"],
+  "denied_tools": ["bash"],
+  "denied_skills": ["dangerous-skill"],
+  "denied_hooks": ["PreToolUse"],
+  "denied_plugins": ["unwanted-plugin"],
+  "denied_mcp_servers": ["external-server"],
+  "denied_memory": false
+}
+```
+
+### 配置字段说明
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `always_allow_tools` | list | `[]` | 始终允许的工具列表 |
+| `denied_tools` | list | `[]` | 始终拒绝的工具列表 |
+| `denied_skills` | list | `[]` | 禁用的 skill 名称列表，`["*"]` 表示全部禁用 |
+| `denied_hooks` | list | `[]` | 禁用的 hook 事件列表，`["*"]` 表示全部禁用 |
+| `denied_plugins` | list | `[]` | 禁用的插件名称列表，`["*"]` 表示全部禁用 |
+| `denied_mcp_servers` | list | `[]` | 禁用的 MCP 服务器名称列表，`["*"]` 表示全部禁用 |
+| `denied_memory` | bool | `false` | 是否禁用 memory 功能 |
+| `denied_rules` | list | `[]` | 禁用的规则名称列表，`["*"]` 表示全部禁用 |
+
+### 优先级规则
+
+1. 项目级 `permissions.json` — 最高优先级
+2. 全局 `settings.json` — 次优先级
+3. 默认值 — 最低优先级
+
+### 源码参考
+
+- 权限加载器：`src/illusion/permissions/loader.py`
+- 权限数据类：`src/illusion/permissions/schemas.py`

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/terminal/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@illusion/terminal",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@illusion/terminal",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "dependencies": {
         "chalk": "^5.6.2",
         "ink": "^5.1.0",

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/terminal/package.json

@@ -24,5 +24,5 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.3"
   },
-  "version": "0.2.1"
+  "version": "0.2.2"
 }

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/terminal/src/App.tsx

@@ -340,6 +340,12 @@ function AppInner({config}: {config: FrontendConfig}): React.JSX.Element {
 			return true;
 		}
 
+		// /skills → 显示技能选择器
+		if (trimmed === '/skills') {
+			session.sendRequest({type: 'select_command', command: 'skills'});
+			return true;
+		}
+
 		// /context → 显示上下文管理选择器
 		if (trimmed === '/context') {
 			session.sendRequest({type: 'select_command', command: 'context'});

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/terminal/src/version.ts

@@ -6,4 +6,4 @@
  */
 
 /** 当前版本号 */
-export const VERSION = '0.2.1';
+export const VERSION = '0.2.2';

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@illusion/web",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@illusion/web",
-      "version": "0.2.1",
+      "version": "0.2.2",
       "dependencies": {
         "highlight.js": "^11.11.0",
         "react": "^18.3.1",

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illusion/web",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": true,
   "type": "module",
   "scripts": {

{illusion_code-0.2.1 → illusion_code-0.2.2}/frontend/web/src/version.ts

@@ -6,4 +6,4 @@
  */
 
 /** 当前版本号 */
-export const VERSION = '0.2.1';
+export const VERSION = '0.2.2';

{illusion_code-0.2.1 → illusion_code-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "illusion-code"
-version = "0.2.1"
+version = "0.2.2"
 description = "Open-source Python port of Claude Code - an AI-powered CLI coding assistant"
 readme = "README.md"
 license = "MIT"

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/__init__.py

@@ -23,4 +23,4 @@ IllusionCode 是一个 AI 驱动的编程助手，提供交互式会话和命令
 
 from __future__ import annotations
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/commands/misc.py

@@ -107,20 +107,57 @@ async def reload_plugins_handler(_: str, context: CommandContext) -> CommandResu
 
 async def skills_handler(args: str, context: CommandContext) -> CommandResult:
     """列出或显示可用技能"""
+    from illusion.skills.loader import get_user_skills_dir, get_project_skills_dir
+
     skill_registry = load_skill_registry(context.cwd)
-    if args:
-        skill = skill_registry.get(args)
-        if skill is None:
-            return CommandResult(message=f"Skill not found: {args}")
-        return CommandResult(message=skill.content)
     skills = skill_registry.list_skills()
+
     if not skills:
         return CommandResult(message="No skills available.")
-    lines = ["Available skills:"]
-    for skill in skills:
-        source = f" [{skill.source}]"
-        lines.append(f"- {skill.name}{source}: {skill.description}")
-    return CommandResult(message="\n".join(lines))
+
+    tokens = args.strip().split()
+
+    # /skills — 列出所有技能
+    if not tokens:
+        user_skills_dir = get_user_skills_dir()
+        project_skills_dir = get_project_skills_dir(context.cwd)
+        lines = ["Available skills:", ""]
+        if user_skills_dir.exists():
+            lines.append(f"User skills directory: {user_skills_dir}")
+        if project_skills_dir.exists():
+            lines.append(f"Project skills directory: {project_skills_dir}")
+        lines.append("")
+        for i, skill in enumerate(skills, 1):
+            source = f" [{skill.source}]"
+            first_line = skill.description.split("\n", 1)[0][:60] if skill.description else "(empty)"
+            lines.append(f"  {i}. {skill.name}{source}  —  {first_line}")
+        lines.append("")
+        lines.append("Usage: /skills <name|number>  — view a specific skill")
+        return CommandResult(message="\n".join(lines))
+
+    # /skills <name|number> — 显示指定技能内容
+    target = tokens[0]
+    selected = None
+
+    # 按序号查找
+    try:
+        idx = int(target) - 1
+        if 0 <= idx < len(skills):
+            selected = skills[idx]
+    except ValueError:
+        pass
+
+    # 按名称查找
+    if selected is None:
+        for skill in skills:
+            if skill.name.lower() == target.lower():
+                selected = skill
+                break
+
+    if selected is None:
+        return CommandResult(message=f"Skill not found: {target}. Use /skills to list available skills.")
+
+    return CommandResult(message=selected.content)
 
 
 async def files_handler(args: str, context: CommandContext) -> CommandResult:

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/commands/rules.py

@@ -14,8 +14,19 @@ async def rules_handler(args: str, context: CommandContext) -> CommandResult:
     """规则命令处理器"""
     from illusion.skills.loader import get_project_rules_dir
 
+    # 加载项目级权限配置
+    from illusion.permissions.loader import load_project_permissions, is_rules_disabled, filter_rules_by_permissions
+    project_permissions = load_project_permissions(context.cwd)
+
+    # 检查是否禁用所有 rules
+    if is_rules_disabled(project_permissions):
+        return CommandResult(message="All rules are disabled")
+
     rules_dir = get_project_rules_dir(context.cwd)
-    rule_files = sorted(rules_dir.glob("*.md"))
+    all_rule_files = sorted(rules_dir.glob("*.md"))
+
+    # 过滤掉被禁用的 rules
+    rule_files = filter_rules_by_permissions(all_rule_files, project_permissions)
 
     if not rule_files:
         return CommandResult(message=f"No rules found in {rules_dir}")

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/config/i18n.py

@@ -528,6 +528,7 @@ _COMMAND_SUBSTITUTIONS: list[tuple[str, str | Any]] = [
     # 技能
     (r"^Skill not found: (.+)$", r"未找到技能：\1"),
     # 规则
+    (r"^All rules are disabled$", r"所有规则已被禁用"),
     (r"^No rules found in (.+)$", r"在 \1 中未找到规则"),
     (r"^Rule not found: (.+)\. Use /rules to list available rules\.$", r"未找到规则：\1。使用 /rules 查看可用规则。"),
     # 状态行（多行消息的逐行翻译）
@@ -553,6 +554,10 @@ _COMMAND_SUBSTITUTIONS: list[tuple[str, str | Any]] = [
     (r"^Bridge summary:$", r"Bridge 摘要："),
     (r"^Reloaded plugins:$", r"已重新加载插件："),
     (r"^Available skills:$", r"可用技能："),
+    (r"^User skills directory: (.+)$", r"用户技能目录：\1"),
+    (r"^Project skills directory: (.+)$", r"项目技能目录：\1"),
+    (r"^Usage: /skills <name|number>  — view a specific skill$", r"用法：/skills <名称|序号>  — 查看指定技能"),
+    (r"^Skill not found: (.+)\. Use /skills to list available skills\.$", r"未找到技能：\1。使用 /skills 查看可用技能。"),
     (r"^Rules directory: (.+)$", r"规则目录：\1"),
     # 前缀行（doctor, privacy-settings, bridge, login, stats, permissions 等）
     (r"^- backend host: available$", r"- 后端宿主：可用"),

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/hooks/loader.py

@@ -9,6 +9,7 @@
 from __future__ import annotations
 
 from collections import defaultdict
+from pathlib import Path
 from typing import Any
 
 from illusion.hooks.events import HookEvent
@@ -85,7 +86,7 @@ def _normalize_hooks_value(value: Any) -> list[HookMatcherDefinition]:
     return result
 
 
-def load_hook_registry(settings: Any, plugins: Any = None) -> HookRegistry:
+def load_hook_registry(settings: Any, plugins: Any = None, cwd: str | Path | None = None) -> HookRegistry:
     """从设置对象加载钩子注册表。
 
     事件名必须是 PascalCase（如 PreToolUse）。
@@ -93,11 +94,24 @@ def load_hook_registry(settings: Any, plugins: Any = None) -> HookRegistry:
     """
     registry = HookRegistry()
 
+    # 加载项目级权限配置
+    from illusion.permissions.loader import load_project_permissions
+    project_permissions = load_project_permissions(cwd) if cwd else None
+
+    # 检查是否禁用所有 hooks
+    if project_permissions and "*" in project_permissions.denied_hooks:
+        return registry
+
     for raw_event, hooks_value in settings.hooks.items():
         try:
             event = HookEvent(str(raw_event))
         except ValueError:
             continue
+
+        # 检查是否禁用特定事件的 hooks
+        if project_permissions and event.value in project_permissions.denied_hooks:
+            continue
+
         for matcher_def in _normalize_hooks_value(hooks_value):
             registry.register(event, matcher_def)
 
@@ -109,6 +123,11 @@ def load_hook_registry(settings: Any, plugins: Any = None) -> HookRegistry:
                 event = HookEvent(str(raw_event))
             except ValueError:
                 continue
+
+            # 检查是否禁用特定事件的 hooks
+            if project_permissions and event.value in project_permissions.denied_hooks:
+                continue
+
             for matcher_def in _normalize_hooks_value(hooks_value):
                 registry.register(event, matcher_def)
 

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/mcp/config.py

@@ -117,6 +117,14 @@ def load_mcp_server_configs(settings, plugins: list[LoadedPlugin], cwd: str | Pa
         >>> for name, config in configs.items():
         ...     print(f"{name}: {config}")
     """
+    # 加载项目级权限配置
+    from illusion.permissions.loader import load_project_permissions
+    project_permissions = load_project_permissions(cwd) if cwd else None
+
+    # 检查是否禁用所有 MCP 服务器
+    if project_permissions and "*" in project_permissions.denied_mcp_servers:
+        return {}
+
     # 从全局设置中获取 MCP 服务器配置（跳过已禁用的服务器）
     servers = {name: cfg for name, cfg in settings.mcp_servers.items()
                if getattr(cfg, "enabled", True)}
@@ -137,4 +145,12 @@ def load_mcp_server_configs(settings, plugins: list[LoadedPlugin], cwd: str | Pa
                 continue
             # 使用 "插件名:服务器名" 格式作为键，避免与全局设置冲突
             servers.setdefault(f"{plugin.manifest.name}:{name}", config)
+
+    # 过滤掉被禁用的 MCP 服务器
+    if project_permissions:
+        servers = {
+            name: cfg for name, cfg in servers.items()
+            if name not in project_permissions.denied_mcp_servers
+        }
+
     return servers

{illusion_code-0.2.1 → illusion_code-0.2.2}/src/illusion/memory/manager.py

@@ -28,30 +28,66 @@ from re import sub
 from illusion.memory.paths import get_memory_entrypoint, get_project_memory_dir
 
 
+def is_memory_enabled(cwd: str | Path) -> bool:
+    """检查记忆功能是否启用
+
+    检查项目级权限配置中的 denied_memory 字段。
+    如果 denied_memory 为 True，则禁用记忆功能。
+
+    Args:
+        cwd: 当前工作目录
+
+    Returns:
+        bool: 记忆功能是否启用
+    """
+    from illusion.permissions.loader import load_project_permissions
+    project_permissions = load_project_permissions(cwd)
+
+    # 检查项目级权限配置
+    if project_permissions.denied_memory:
+        return False
+
+    # 检查全局配置
+    from illusion.config.settings import load_settings
+    settings = load_settings()
+    return settings.memory.enabled
+
+
 def list_memory_files(cwd: str | Path) -> list[Path]:
     """列出项目的所有记忆markdown文件
-    
+
     Args:
         cwd: 当前工作目录
-    
+
     Returns:
         list[Path]: 排序后的记忆文件路径列表
     """
+    # 检查记忆功能是否启用
+    if not is_memory_enabled(cwd):
+        return []
+
     memory_dir = get_project_memory_dir(cwd)  # 获取记忆目录
     return sorted(path for path in memory_dir.glob("*.md"))  # 返回排序后的文件列表
 
 
 def add_memory_entry(cwd: str | Path, title: str, content: str) -> Path:
     """创建记忆文件并添加到MEMORY.md索引
-    
+
     Args:
         cwd: 当前工作目录
         title: 记忆标题
         content: 记忆内容
-    
+
     Returns:
         Path: 创建的记忆文件路径
+
+    Raises:
+        RuntimeError: 记忆功能被禁用时抛出
     """
+    # 检查记忆功能是否启用
+    if not is_memory_enabled(cwd):
+        raise RuntimeError("Memory is disabled by project permissions")
+
     memory_dir = get_project_memory_dir(cwd)  # 获取记忆目录
     slug = sub(r"[^a-zA-Z0-9]+", "_", title.strip().lower()).strip("_") or "memory"  # 转换为slug
     path = memory_dir / f"{slug}.md"  # 构建文件路径
@@ -67,14 +103,21 @@ def add_memory_entry(cwd: str | Path, title: str, content: str) -> Path:
 
 def remove_memory_entry(cwd: str | Path, name: str) -> bool:
     """删除记忆文件及其在MEMORY.md中的索引条目
-    
+
     Args:
         cwd: 当前工作目录
         name: 记忆文件名称 (不带.md扩展名)
-    
+
     Returns:
         bool: 是否成功删除
+
+    Raises:
+        RuntimeError: 记忆功能被禁用时抛出
     """
+    # 检查记忆功能是否启用
+    if not is_memory_enabled(cwd):
+        raise RuntimeError("Memory is disabled by project permissions")
+
     memory_dir = get_project_memory_dir(cwd)  # 获取记忆目录
     matches = [path for path in memory_dir.glob("*.md") if path.stem == name or path.name == name]  # 查找匹配文件
     if not matches:  # 没有匹配