From 7ede95108304cec08572d9da5ce1f41116e4970d Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Thu, 27 Aug 2026 17:02:46 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=20DevHarness=204bbac?=
 =?UTF-8?q?f4=20=E5=B7=A5=E4=BD=9C=E6=B5=81=20(#108)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Local-Development-and-Verification.-.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/Local-Development-and-Verification.-.md b/Local-Development-and-Verification.-.md
index e94b676..d57e0bc 100644
--- a/Local-Development-and-Verification.-.md
+++ b/Local-Development-and-Verification.-.md
@@ -11,6 +11,12 @@
 
 Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的 Python/CUDA 以及 PostgreSQL、MediaMTX 精确版本仍将在对应骨架工单冻结。旧仓库环境不自动成为新项目事实。
 
+## Windows PowerShell 与 UTF-8
+
+- Windows 环境优先使用当前已配置的 PowerShell；可选择时优先 PowerShell 7 `pwsh.exe`，不为设置编码重复启动一层 PowerShell。
+- 文本文件读写在命令支持时显式指定 UTF-8。文件解码与控制台输出分别处理，只有出现真实乱码或已知宿主非 UTF-8 时才调整当前进程输出编码或 Python UTF-8 环境变量。
+- 不默认使用 `-ExecutionPolicy Bypass`。只有可信脚本确实被策略阻止且没有更小替代方案时，才对该次进程使用并在工单记录原因。
+
 ## 第一次运行
 
 1. 检查工作区：
@@ -24,7 +30,7 @@ Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的
 2. 检查 Harness：
 
    ```powershell
-   python dev_scripts/check_harness.py --strict
+   python dev_scripts/harness.py check --strict
    ```
 
    预期：输出“DevHarness 检查通过”。
@@ -40,7 +46,7 @@ Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的
 4. 对照 Wiki：
 
    ```powershell
-   python dev_scripts/sync_wiki_docs.py --check
+   python dev_scripts/harness.py sync --check
    ```
 
    预期：全部映射一致。
@@ -73,8 +79,8 @@ Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的
 
 ```powershell
 python -m unittest discover -s tests -v
-python dev_scripts/check_harness.py --strict
-python dev_scripts/sync_wiki_docs.py --check
+python dev_scripts/harness.py check --strict
+python dev_scripts/harness.py sync --check
 git diff --check
 git status --short
 ```