kefeiqian · kefeiqian · Jul 14, 2026 · Jul 14, 2026 · Jul 14, 2026 · Jul 14, 2026
diff --git a/.cargo/config.toml b/.cargo/config.toml
@@ -1,2 +1,9 @@
 [alias]
-xtask = "run -p xtask --"
+# Build and run xtask in a private `target/xtask` dir, isolated from the
+# workspace `target/`. On Windows a running exe is locked, so sharing `target/`
+# would let a concurrent `cargo build` or `cargo xtask` cause "Access is denied
+# (os error 5)" relink failures. The isolation is set via this `--target-dir`
+# flag (not the CARGO_TARGET_DIR env var) so it does NOT leak into the nested
+# cargo builds xtask itself spawns (e.g. packaging), which must still use the
+# workspace `target/`.
+xtask = "run -p xtask --target-dir target/xtask --"
diff --git a/.run/xtask_blog_build.run.xml b/.run/xtask_blog_build.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: blog-build" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-build" />
+    <option name="command" value="xtask blog-build" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_blog_install.run.xml b/.run/xtask_blog_install.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: blog-install" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-install" />
+    <option name="command" value="xtask blog-install" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_blog_preview.run.xml b/.run/xtask_blog_preview.run.xml
@@ -1,7 +1,17 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="xtask: blog-preview" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-preview" />
-    <option name="workingDirectory" value="$PROJECT_DIR$" />
+  <configuration default="false" name="xtask: blog-preview" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="blog-preview" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
     <method v="2" />
   </configuration>
 </component>
diff --git a/.run/xtask_blog_serve.run.xml b/.run/xtask_blog_serve.run.xml
@@ -1,7 +1,17 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="xtask: blog-serve" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-serve" />
-    <option name="workingDirectory" value="$PROJECT_DIR$" />
+  <configuration default="false" name="xtask: blog-serve" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="blog-serve" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
     <method v="2" />
   </configuration>
 </component>
diff --git a/.run/xtask_blog_serve_en.run.xml b/.run/xtask_blog_serve_en.run.xml
@@ -1,7 +1,17 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="xtask: blog-serve-en" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-serve-en" />
-    <option name="workingDirectory" value="$PROJECT_DIR$" />
+  <configuration default="false" name="xtask: blog-serve-en" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="blog-serve-en" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
     <method v="2" />
   </configuration>
 </component>
diff --git a/.run/xtask_blog_typecheck.run.xml b/.run/xtask_blog_typecheck.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: blog-typecheck" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- blog-typecheck" />
+    <option name="command" value="xtask blog-typecheck" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_fixture_prepare_react_complex.run.xml b/.run/xtask_fixture_prepare_react_complex.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: fixture-prepare-react-complex" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- fixture-prepare-react-complex" />
+    <option name="command" value="xtask fixture-prepare-react-complex" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_fixture_prepare_react_simple.run.xml b/.run/xtask_fixture_prepare_react_simple.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: fixture-prepare-react-simple" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- fixture-prepare-react-simple" />
+    <option name="command" value="xtask fixture-prepare-react-simple" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_help.run.xml b/.run/xtask_help.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: help" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- help" />
+    <option name="command" value="xtask help" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_package.run.xml b/.run/xtask_package.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: package" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- package" />
+    <option name="command" value="xtask package" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_package_release.run.xml b/.run/xtask_package_release.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: package-release" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- package-release" />
+    <option name="command" value="xtask package-release" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_set-version.run.xml b/.run/xtask_set-version.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: set-version" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- set-version" />
+    <option name="command" value="xtask set-version" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_tui_dev.run.xml b/.run/xtask_tui_dev.run.xml
@@ -1,18 +1,17 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="xtask: tui-dev" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="buildProfileId" value="dev" />
-    <option name="command" value="run -p xtask -- tui-dev" />
-    <option name="workingDirectory" value="file://$PROJECT_DIR$" />
+  <configuration default="false" name="xtask: tui-dev" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="tui-dev" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
     <envs />
-    <option name="emulateTerminal" value="true" />
-    <option name="channel" value="DEFAULT" />
-    <option name="requiredFeatures" value="true" />
-    <option name="allFeatures" value="false" />
-    <option name="withSudo" value="false" />
-    <option name="buildTarget" value="REMOTE" />
-    <option name="backtrace" value="SHORT" />
-    <option name="isRedirectInput" value="false" />
-    <option name="redirectInputPath" value="" />
     <method v="2" />
   </configuration>
-</component>
+</component>
diff --git a/.run/xtask_tui_dev_here.run.xml b/.run/xtask_tui_dev_here.run.xml
@@ -0,0 +1,17 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="xtask: tui-dev-here" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="tui-dev-here" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>
diff --git a/.run/xtask_tui_install.run.xml b/.run/xtask_tui_install.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: tui-install" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- tui-install" />
+    <option name="command" value="xtask tui-install" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_tui_prod.run.xml b/.run/xtask_tui_prod.run.xml
@@ -1,18 +1,17 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="xtask: tui-prod" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="buildProfileId" value="dev" />
-    <option name="command" value="run -p xtask -- tui-prod" />
-    <option name="workingDirectory" value="file://$PROJECT_DIR$" />
+  <configuration default="false" name="xtask: tui-prod" type="ShConfigurationType">
+    <option name="SCRIPT_TEXT" value="" />
+    <option name="INDEPENDENT_SCRIPT_PATH" value="true" />
+    <option name="SCRIPT_PATH" value="$PROJECT_DIR$/scripts/xtask.ps1" />
+    <option name="SCRIPT_OPTIONS" value="tui-prod" />
+    <option name="INDEPENDENT_SCRIPT_WORKING_DIRECTORY" value="true" />
+    <option name="SCRIPT_WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+    <option name="INDEPENDENT_INTERPRETER_PATH" value="false" />
+    <option name="INTERPRETER_PATH" value="C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe" />
+    <option name="INTERPRETER_OPTIONS" value="-ExecutionPolicy Bypass -File" />
+    <option name="EXECUTE_IN_TERMINAL" value="true" />
+    <option name="EXECUTE_SCRIPT_FILE" value="true" />
     <envs />
-    <option name="emulateTerminal" value="true" />
-    <option name="channel" value="DEFAULT" />
-    <option name="requiredFeatures" value="true" />
-    <option name="allFeatures" value="false" />
-    <option name="withSudo" value="false" />
-    <option name="buildTarget" value="REMOTE" />
-    <option name="backtrace" value="SHORT" />
-    <option name="isRedirectInput" value="false" />
-    <option name="redirectInputPath" value="" />
     <method v="2" />
   </configuration>
 </component>
diff --git a/.run/xtask_tui_test.run.xml b/.run/xtask_tui_test.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: tui-test" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- tui-test" />
+    <option name="command" value="xtask tui-test" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/.run/xtask_tui_typecheck.run.xml b/.run/xtask_tui_typecheck.run.xml
@@ -1,6 +1,6 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="xtask: tui-typecheck" type="CargoCommandRunConfiguration" factoryName="Cargo Command">
-    <option name="command" value="run -p xtask -- tui-typecheck" />
+    <option name="command" value="xtask tui-typecheck" />
     <option name="workingDirectory" value="$PROJECT_DIR$" />
     <method v="2" />
   </configuration>

diff --git a/AGENTS.md b/AGENTS.md
@@ -40,11 +40,12 @@ For the nested TUI package, prefer Cargo-facing xtask commands instead of runnin
 cargo xtask tui-install
 cargo xtask tui-typecheck
 cargo xtask tui-test
-cargo xtask tui-dev    # run the TUI from TypeScript source against a workspace fixture
-cargo xtask tui-prod   # package the standalone kqode binary and run it from the workspace
+cargo xtask tui-dev       # run the TUI from TypeScript source against a workspace fixture
+cargo xtask tui-dev-here  # run the TUI from TypeScript source against the terminal cwd
+cargo xtask tui-prod      # package the standalone kqode binary and run it from the workspace
 ```
 
-`tui-dev` and `tui-prod` both run against a workspace fixture; seed one first with `cargo xtask fixture-prepare-react-simple` (or `fixture-prepare-react-complex`) to skip the interactive fixture prompt.
+`tui-dev` and `tui-prod` both run against a workspace fixture; seed one first with `cargo xtask fixture-prepare-react-simple` (or `fixture-prepare-react-complex`) to skip the interactive fixture prompt. Use `tui-dev-here` through `scripts/xtask.sh`/`scripts/xtask.ps1` from another project directory when source-mode TUI should see that directory as its cwd.
 
 For the Docusaurus blog/docs site under `blog/`, prefer Cargo-facing xtask commands instead of running package-manager commands directly:
 
@@ -57,7 +58,14 @@ cargo xtask blog-serve-en
 cargo xtask blog-preview
 ```
 
-Running two or more `cargo xtask` commands at once fails on Windows: `cargo xtask` expands to `cargo run -p xtask`, which relinks the shared `target\debug\xtask.exe` on each call, and a long-running command keeps that executable locked so the next call cannot replace it (os error 32, or os error 5 on the remove step). To run long-lived or multiple commands in parallel, use the launcher, which builds once then runs a per-invocation copy under `target/debug/xtask-run/`:
+`cargo xtask` is parallel-safe on Windows: the alias builds and runs xtask in a private `target\xtask` directory (separate from the workspace `target\`), so ordinary fast commands never relink a binary another `cargo xtask` or a `cargo build --workspace` is holding. Run fast commands normally, including concurrently:
+
+```powershell
+cargo xtask tui-typecheck
+cargo xtask blog-build
+```
+
+The long-running servers (`blog-serve`, `blog-serve-en`, `blog-preview`, `tui-dev`, `tui-dev-here`, `tui-prod`) hold the binary for their whole session, so run those through the launcher — it builds once, then runs a per-invocation copy under `target\xtask\debug\xtask-run\`, leaving the canonical binary free to relink:
 
 ```powershell
 ./scripts/xtask.ps1 blog-serve   # Windows (PowerShell)
@@ -67,7 +75,7 @@ Running two or more `cargo xtask` commands at once fails on Windows: `cargo xtas
 ./scripts/xtask.sh blog-serve    # macOS/Linux
 ```
 
-Keep xtask command modules as thin wrappers around reusable implementation modules. When adding or renaming an xtask command, add a matching checked-in IDE run profile under `.run/` using the `xtask: <command>` naming pattern.
+Keep xtask command modules as thin wrappers around reusable implementation modules. When adding or renaming an xtask command, add a matching checked-in IDE run profile under `.run/` using the `xtask: <command>` naming pattern, with its Cargo command routed through the `xtask` alias (`xtask <command>`) so IDE runs inherit the private-dir isolation.
 
 ## Architecture
 

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -70,6 +70,7 @@ cargo xtask tui-install    # install nested TUI dependencies
 cargo xtask tui-typecheck  # type-check the TUI (tsc --noEmit)
 cargo xtask tui-test       # run TUI tests (vitest)
 cargo xtask tui-dev        # run the TUI from a throwaway fixture workspace
+cargo xtask tui-dev-here   # run the TUI from source against the current cwd
 ```
 
 ### Documentation site
@@ -85,10 +86,14 @@ cargo xtask blog-preview
 
 ### Windows note
 
-Running two or more `cargo xtask` commands at once fails on Windows, because each
-call relinks the shared `target\debug\xtask.exe` and a long-running command keeps
-it locked. To run long-lived or multiple commands in parallel, use the launcher,
-which builds once and then runs a per-invocation copy:
+`cargo xtask` is parallel-safe on Windows: the alias builds and runs xtask in a
+private `target\xtask` directory, separate from the workspace `target\`, so a
+fast command never relinks a binary another process is holding. Run fast
+commands normally, including in parallel. The long-running servers
+(`blog-serve`, `blog-serve-en`, `blog-preview`, `tui-dev`, `tui-dev-here`,
+`tui-prod`) hold the binary for their whole session, so run those through the
+launcher, which builds once and then runs a per-invocation copy that leaves the
+canonical binary free:
 
 ```powershell
 ./scripts/xtask.ps1 blog-serve   # Windows (PowerShell)

diff --git a/CONTRIBUTING.zh-CN.md b/CONTRIBUTING.zh-CN.md
@@ -69,6 +69,7 @@ cargo xtask tui-install    # 安装内嵌 TUI 的依赖
 cargo xtask tui-typecheck  # 对 TUI 做类型检查（tsc --noEmit）
 cargo xtask tui-test       # 运行 TUI 测试（vitest）
 cargo xtask tui-dev        # 在一次性 fixture 工作区中运行 TUI
+cargo xtask tui-dev-here   # 从源码运行 TUI，并使用当前终端目录作为 cwd
 ```
 
 ### 文档站点
@@ -84,9 +85,13 @@ cargo xtask blog-preview
 
 ### Windows 注意事项
 
-在 Windows 上同时运行两个或更多 `cargo xtask` 命令会失败，因为每次调用都会重新
-链接共享的 `target\debug\xtask.exe`，而长时间运行的命令会一直锁定它。若要并行运行
-长时命令或多个命令，请使用启动器，它只构建一次，然后运行每次调用独立的副本：
+在 Windows 上，`cargo xtask` 已可并行运行：别名会把 xtask 构建并运行在私有的
+`target\xtask` 目录中（与工作区的 `target\` 分开），因此快速命令不会去重新链接
+其他进程正在占用的可执行文件。快速命令可以照常运行，也可以并行运行。长时间运行的
+服务器命令（`blog-serve`、`blog-serve-en`、`blog-preview`、`tui-dev`、
+`tui-dev-here`、`tui-prod`）会在整个会话期间占用该可执行文件，因此请通过启动器
+运行它们——启动器只构建一次，然后运行每次调用独立的副本，从而让规范可执行文件
+保持可被重新链接：
 
 ```powershell
 ./scripts/xtask.ps1 blog-serve   # Windows（PowerShell）