docs: 同步 DevHarness 4bbacf4 工作流 (#108)

ila
2026-08-27 17:02:46 +08:00
parent 96fca4d2aa
commit 7ede951083
+10 -4
@@ -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
```