windcode 0.1.0__tar.gz → 0.1.2__tar.gz

{windcode-0.1.0 → windcode-0.1.2}/.gitignore

@@ -14,6 +14,12 @@ tests/
 
 .windcode/config.toml
 .windcode/state/
+.windcode/skill/
+.windcode/memory/
+.windcode/sessions/
+.windcode/traces/
+.windcode/extensions/
+.windcode/worktrees/
 
 
 spec/

{windcode-0.1.0 → windcode-0.1.2}/.windcode/config.toml.example

@@ -54,8 +54,8 @@ url =
 required = true
 
 [storage]
-project_state_root = ".windcode/state"
-user_storage_root = "~/.local/state/windcode/state"
+project_state_root = ".windcode"
+user_storage_root = "~/.local/state/windcode"
 
 [memory]
 enabled = true

{windcode-0.1.0 → windcode-0.1.2}/AGENTS.md

@@ -56,8 +56,9 @@ explicit SDK state_root
 -> user_storage_root
 ```
 
-The root contains `memory/`, `sessions/`, `traces/`, `extensions/`, and `worktrees/`.
-`.windcode/config.toml`, `.windcode/state/`, `tests/`, and `spec/` are local-only ignored paths.
+The root contains `skill/`, `memory/`, `sessions/`, `traces/`, `extensions/`, and `worktrees/`.
+`.windcode/config.toml`, runtime directories under `.windcode/`, `tests/`, and `spec/` are local-only
+ignored paths.
 Never remove, rewrite, force-add, or commit them without an explicit user request.
 
 For MCP servers, `enable` controls discovery and runtime visibility; `required` only controls startup

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windcode
-Version: 0.1.0
+Version: 0.1.2
 Summary: A safe, extensible terminal coding agent
 Project-URL: Homepage, https://github.com/tingfeng347/windcode
 Project-URL: Repository, https://github.com/tingfeng347/windcode
@@ -149,12 +149,13 @@ Windcode 将记忆、会话、trace、扩展状态和 Worktree 统一存放在
 
 ```toml
 [storage]
-project_state_root = ".windcode/state"
-user_storage_root = "~/.local/state/windcode/state"
+project_state_root = ".windcode"
+user_storage_root = "~/.local/state/windcode"
 ```
 
-配置项目状态根时优先使用项目目录；未配置时使用用户状态目录。`.windcode/config.toml` 和
-`.windcode/state/` 都不应提交到 Git。
+配置项目状态根时优先使用项目目录；未配置时使用用户状态目录。Skill 会同时扫描两边的
+`skill/`，同名时项目级覆盖用户级。`.windcode/config.toml` 和 `.windcode/` 下的运行状态都
+不应提交到 Git。
 
 ## 开发
 

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

@@ -114,12 +114,13 @@ Windcode 将记忆、会话、trace、扩展状态和 Worktree 统一存放在
 
 ```toml
 [storage]
-project_state_root = ".windcode/state"
-user_storage_root = "~/.local/state/windcode/state"
+project_state_root = ".windcode"
+user_storage_root = "~/.local/state/windcode"
 ```
 
-配置项目状态根时优先使用项目目录；未配置时使用用户状态目录。`.windcode/config.toml` 和
-`.windcode/state/` 都不应提交到 Git。
+配置项目状态根时优先使用项目目录；未配置时使用用户状态目录。Skill 会同时扫描两边的
+`skill/`，同名时项目级覆盖用户级。`.windcode/config.toml` 和 `.windcode/` 下的运行状态都
+不应提交到 Git。
 
 ## 开发
 

{windcode-0.1.0 → windcode-0.1.2}/examples/README.md

@@ -61,7 +61,7 @@ uv run python examples/07_bash_approval.py
 
 ```toml
 [storage]
-project_state_root = ".windcode/state"
+project_state_root = ".windcode"
 ```
 
 ## MCP 示例配置

{windcode-0.1.0 → windcode-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "windcode"
-version = "0.1.0"
+version = "0.1.2"
 description = "A safe, extensible terminal coding agent"
 readme = "README.md"
 requires-python = ">=3.12"

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/__init__.py

@@ -3,4 +3,4 @@
 from windcode.sdk import Windcode
 
 __all__ = ["Windcode"]
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/cli.py

@@ -8,7 +8,7 @@ from collections.abc import Sequence
 from dataclasses import dataclass
 from pathlib import Path
 
-from windcode.config import AppConfig, ConfigError, PermissionMode, load_config
+from windcode.config import AppConfig, ConfigError, PermissionMode, ensure_user_config, load_config
 
 
 @dataclass(frozen=True, slots=True)
@@ -156,8 +156,9 @@ def run(argv: Sequence[str] | None = None) -> int:
         options = parse_options(arguments)
         if not options.workspace.is_dir():
             raise ConfigError(options.workspace, "workspace is not a directory")
+        write_config_file = options.config_file or ensure_user_config()
         config = resolve_config(options)
-    except ConfigError as exc:
+    except (ConfigError, OSError) as exc:
         print(f"windcode: {exc}", file=sys.stderr)
         return 2
 
@@ -171,7 +172,7 @@ def run(argv: Sequence[str] | None = None) -> int:
         permission_mode=(
             options.permission_mode.value if options.permission_mode is not None else None
         ),
-        config_file=options.config_file,
+        config_file=write_config_file,
     )
     app.run()
     return 0

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/config/__init__.py

@@ -1,4 +1,9 @@
-from windcode.config.loader import ConfigError, load_config
+from windcode.config.loader import (
+    ConfigError,
+    default_user_config_path,
+    ensure_user_config,
+    load_config,
+)
 from windcode.config.models import (
     HARD_MAX_CONCURRENT_SUBAGENTS,
     HARD_MAX_SUBAGENT_TASKS,
@@ -35,6 +40,8 @@ __all__ = [
     "StorageConfig",
     "SubagentConfig",
     "TraceConfig",
+    "default_user_config_path",
+    "ensure_user_config",
     "load_config",
     "save_memory_config",
     "save_model_config",

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/config/loader.py

@@ -1,11 +1,13 @@
 from __future__ import annotations
 
 import copy
+import os
 import tomllib
 from collections.abc import Mapping
 from pathlib import Path
 from typing import Any, cast
 
+import tomli_w
 from platformdirs import user_config_path
 from pydantic import ValidationError
 
@@ -18,6 +20,30 @@ class ConfigError(ValueError):
         super().__init__(f"{source}: {message}")
 
 
+def default_user_config_path() -> Path:
+    return user_config_path("windcode") / "config.toml"
+
+
+def ensure_user_config(path: Path | None = None) -> Path:
+    """Create the default user configuration once without overwriting an existing file."""
+    target = (path or default_user_config_path()).expanduser().resolve()
+    if target.exists():
+        return target
+
+    content = tomli_w.dumps(AppConfig().model_dump(mode="json", exclude_none=True)).encode()
+    target.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        descriptor = os.open(target, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
+    except FileExistsError:
+        return target
+
+    with os.fdopen(descriptor, "wb") as stream:
+        stream.write(content)
+        stream.flush()
+        os.fsync(stream.fileno())
+    return target
+
+
 def _deep_merge(base: dict[str, Any], overlay: Mapping[str, Any]) -> dict[str, Any]:
     merged = copy.deepcopy(base)
     for key, value in overlay.items():
@@ -52,7 +78,7 @@ def load_config(
     overrides: Mapping[str, Any] | None = None,
 ) -> AppConfig:
     workspace = workspace.expanduser().resolve()
-    default_user = user_config_path("windcode") / "config.toml"
+    default_user = default_user_config_path()
     default_project = workspace / ".windcode" / "config.toml"
     layers: list[tuple[Path | str, dict[str, Any]]] = [
         (

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/extensions/service.py

@@ -8,6 +8,7 @@ from pathlib import Path
 from typing import cast
 from uuid import uuid4
 
+from platformdirs import user_state_path
 from pydantic import TypeAdapter, ValidationError
 
 from windcode.config.models import (
@@ -57,13 +58,23 @@ class ExtensionService:
         workspace: Path,
         state_store: ExtensionStateStore,
         plugins_root: Path,
+        *,
+        user_skill_root: Path | None = None,
     ) -> None:
         self.config = config
         self.workspace = workspace.expanduser().resolve()
         self.state_store = state_store
         self.plugins_root = plugins_root
-        self._user_skill_roots = tuple(Path(path).expanduser() for path in config.skill_roots)
-        self._project_skill_root = self.workspace / ".windcode" / "skills"
+        default_user_skill_root = user_skill_root or user_state_path("windcode") / "skill"
+        self._user_skill_roots = tuple(
+            dict.fromkeys(
+                (
+                    default_user_skill_root.expanduser().resolve(),
+                    *(Path(path).expanduser().resolve() for path in config.skill_roots),
+                )
+            )
+        )
+        self._project_skill_root = self.workspace / ".windcode" / "skill"
         loaded = state_store.load()
         self._state = loaded.state
         self._state_diagnostics = loaded.diagnostics

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/sdk.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import asyncio
-import shutil
 from collections.abc import AsyncIterator, Mapping
 from dataclasses import replace
 from pathlib import Path
@@ -226,21 +225,13 @@ class Windcode:
     def _resolve_state_root(self, explicit_root: Path | None) -> Path:
         if explicit_root is not None:
             return explicit_root.expanduser().resolve()
-        legacy_root = user_state_path("windcode").expanduser().resolve()
+        configured_project_root = self.config.storage.project_state_root
+        if configured_project_root is not None:
+            return self._configured_state_path(configured_project_root)
         configured_user_root = self.config.storage.user_storage_root
-        user_root = (
-            self._configured_state_path(configured_user_root)
-            if configured_user_root is not None
-            else legacy_root / "state"
-        )
-        source_root = user_root if user_root.exists() else legacy_root
-        configured = self.config.storage.project_state_root
-        if configured is None:
-            self._migrate_state_root(source_root, user_root)
-            return user_root
-        project_root = self._configured_state_path(configured)
-        self._migrate_state_root(source_root, project_root)
-        return project_root
+        if configured_user_root is not None:
+            return self._configured_state_path(configured_user_root)
+        return user_state_path("windcode").expanduser().resolve()
 
     def _configured_state_path(self, value: str) -> Path:
         project_root = Path(value).expanduser()
@@ -248,34 +239,6 @@ class Windcode:
             project_root = self.workspace / project_root
         return project_root.resolve()
 
-    @staticmethod
-    def _state_manifest(root: Path) -> dict[str, int]:
-        return {
-            str(path.relative_to(root)): path.stat().st_size
-            for path in root.rglob("*")
-            if path.is_file() and not path.is_symlink()
-        }
-
-    @classmethod
-    def _migrate_state_root(cls, source: Path, target: Path) -> None:
-        """Copy the complete legacy state once, validate it, then atomically install it."""
-        if source == target or target.exists():
-            return
-        target.parent.mkdir(parents=True, exist_ok=True)
-        temporary_parent = source.parent if target.is_relative_to(source) else target.parent
-        temporary = temporary_parent / f".{target.name}.migrate-{uuid4().hex}"
-        try:
-            if source.exists():
-                shutil.copytree(source, temporary, copy_function=shutil.copy2)
-                if cls._state_manifest(source) != cls._state_manifest(temporary):
-                    raise OSError("project state migration validation failed")
-            else:
-                temporary.mkdir(parents=True)
-            temporary.replace(target)
-        finally:
-            if temporary.exists():
-                shutil.rmtree(temporary)
-
     @classmethod
     def open(
         cls,

{windcode-0.1.0 → windcode-0.1.2}/src/windcode/tui/app.py

@@ -16,7 +16,7 @@ from textual.theme import Theme
 from textual.widgets import Static
 
 from windcode.auth import CredentialStore, CredentialStoreError
-from windcode.config import AppConfig, PermissionMode, ProviderConfig
+from windcode.config import AppConfig, PermissionMode, ProviderConfig, default_user_config_path
 from windcode.domain.events import (
     ApprovalRequested,
     ApprovalResponse,
@@ -86,9 +86,7 @@ class WindcodeApp(App[None]):
         super().__init__()
         self.config = config
         self.workspace = workspace
-        self.config_file = (
-            (config_file or self.workspace / ".windcode" / "config.toml").expanduser().resolve()
-        )
+        self.config_file = (config_file or default_user_config_path()).expanduser().resolve()
         self.model = model
         self.session_id = session_id
         self.permission_mode = permission_mode or config.permission.mode.value
@@ -122,6 +120,13 @@ class WindcodeApp(App[None]):
                 return provider.model
         return "按配置"
 
+    def _model_setup_message(self) -> str | None:
+        if self.client.transport_registry.aliases:
+            return None
+        if self.config.providers:
+            return "模型 Provider 尚未连接, 请检查 API Key 或重新配置 Provider"
+        return "尚未配置模型 Provider, 请先连接模型后再开始任务"
+
     def _make_banner(self) -> RichText:
         banner = RichText()
         banner.append("▣ ", style="bold color(75)")
@@ -172,6 +177,8 @@ class WindcodeApp(App[None]):
         self.set_class(self.size.width < 60, "narrow")
         self.query_one("#chat-input", ChatInput).focus()
         self._update_status("loading MCP" if self.client.required_mcp_loading else "idle")
+        if setup_message := self._model_setup_message():
+            self.query_one("#welcome-view", WelcomeView).show_notice(setup_message)
         if self.client.required_mcp_loading:
             self.query_one("#welcome-view", WelcomeView).start_mcp_loading()
             self.run_worker(self._load_required_mcp(), group="mcp-startup", exclusive=True)
@@ -188,7 +195,7 @@ class WindcodeApp(App[None]):
             return
         self.query_one("#welcome-view", WelcomeView).stop_mcp_loading()
         self._update_status("idle")
-        await self._show_system_message("MCP 服务已加载")
+        await self._show_system_message(self._model_setup_message() or "MCP 服务已加载")
 
     def on_resize(self, event: events.Resize) -> None:
         self.set_class(event.size.width < 60, "narrow")
@@ -230,7 +237,7 @@ class WindcodeApp(App[None]):
             await self._show_system_message("没有可复制的内容", error=True)
             return
         try:
-            await self.copy_to_clipboard(text)
+            self.copy_to_clipboard(text)
             preview = text.replace("\n", " ")[:60]
             await self._show_system_message(
                 f"已复制到剪贴板: {preview}{'...' if len(text) > 60 else ''}"
@@ -458,6 +465,10 @@ class WindcodeApp(App[None]):
         await self._start_prompt(value)
 
     async def _start_prompt(self, value: str) -> None:
+        if setup_message := self._model_setup_message():
+            await self._show_system_message(setup_message, error=True)
+            await self._open_provider_manager()
+            return
         if self.handle is not None and not self.handle.done:
             self.prompt_queue.append(value)
             self._update_status(f"运行中 · 队列 {len(self.prompt_queue)}")
@@ -1006,7 +1017,7 @@ class WindcodeApp(App[None]):
         # If the user has selected text, copy it first instead of canceling.
         selected = self.screen.get_selected_text()
         if selected:
-            await self.copy_to_clipboard(selected)
+            self.copy_to_clipboard(selected)
             self.screen.clear_selection()
             return
         if self.handle is not None and not self.handle.done:

{windcode-0.1.0 → windcode-0.1.2}/uv.lock

@@ -1498,7 +1498,7 @@ wheels = [
 
 [[package]]
 name = "windcode"
-version = "0.1.0"
+version = "0.1.2"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },