docs: 同步 DevHarness 4bbacf4 工作流 (#108)
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user