docs: 同步 DevHarness 长期文档 (#108)

docs/04-local-development-and-verification.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Local-Development-and-Verification
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.-
-wiki_revision: 925a16a72bd5840697b5c61489a97018134b3930
-synchronized_at: 2026-08-27T08:07:04Z
+wiki_revision: 7ede95108304cec08572d9da5ce1f41116e4970d
+synchronized_at: 2026-08-27T09:05:09Z
 <!-- gitea-wiki-mirror:end -->
 
 # 本地开发与验证
@@ -19,6 +19,12 @@ synchronized_at: 2026-08-27T08:07:04Z
 
 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. 检查工作区：
@@ -32,7 +38,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 检查通过”。
@@ -48,7 +54,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
    ```
 
    预期：全部映射一致。
@@ -81,8 +87,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
 ```