convention/path-marking
2026-05-15 建立 — 因新增 IDA PC,需要區分三台機器的路徑
規則
所有包含檔案系統路徑的 vault 文檔,必須在路徑旁標明所屬機器,格式:
[IDAPC] C:\Users\IDA\...
[SozoPC] D:\hermes\...
[S23] ~/.hermes/...
三台機器對照
| 標記 | 機器 | 主機名 | 用戶 | 特徵路徑 |
|---|---|---|---|---|
[S23] | S23 Ultra (Termux) | - | sozo | ~/.hermes/ |
[SozoPC] | Sozo PC | DESKTOP-F9KSPPP | Sozo | D:\, C:\Users\Sozo\ |
[IDAPC] | IDA PC | DESKTOP-GKHUGAD | IDA | C:\Users\IDA\, G:\ |
範例
❌ 錯誤:worker 原始碼在 D:\hermes\quotation-worker\
✅ 正確:worker 原始碼在 [SozoPC] D:\hermes\quotation-worker\
何時需要標記
任何出現絕對路徑的地方都要加:
- Agent 文檔中的 Instance 段落
- 環境文檔(env/)中的路徑
- 技能文檔(skill/)中的命令
- 項目文檔(projects/)中的檔案位置
相對路徑(如 ~/.hermes/)或純粹的網路路徑(如 https://...)不需要。