Skip to content

Commit 31eb41a

Browse files
committed
docs(paths): remove absolute path references
Why: - exported docs should not leak local machine paths - repository links need to remain portable across machines and remotes - session start reminder should infer repo root instead of hardcoding a workstation path What: - replace absolute file links with relative repository links in docs - replace local tool paths in dev-journal examples with portable HOME-based commands - make session_start_reminder.py derive REPO_ROOT from __file__ - expand vibecoding retrospective with concrete environment constraints and pitfalls Verify: - git diff --check - rg -n "/home/yuanzhi/|file://|/tmp/TrendRadar-upstream" . -g '!target/**' -g '!*.lock'
1 parent 224c076 commit 31eb41a

7 files changed

Lines changed: 345 additions & 169 deletions

docs/benchmark-python-baseline.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ cargo bench --package trendradar-app --bench pipeline_bench
7979

8080
Python 真实入口已经固定为:
8181

82-
- 代码入口:`/home/yuanzhi/Develop/ai-research/TrendRadar/trendradar/__main__.py`
82+
- 代码入口:`<python-trendradar-repo>/trendradar/__main__.py`
8383
- CLI 入口:`python -m trendradar`
8484

8585
但 Python CLI 当前没有暴露可配置的热榜 API 基址,因此本仓库内新增了一个 benchmark bridge:
@@ -93,7 +93,7 @@ Python 真实入口已经固定为:
9393
Python 侧当前主对比命令:
9494

9595
```bash
96-
/home/yuanzhi/Develop/ai-research/TrendRadar/.venv/bin/python \
96+
<python-trendradar-repo>/.venv/bin/python \
9797
scripts/benchmark_python_baseline.py --warmups 5 --runs 10
9898
```
9999

docs/deployment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ sudo journalctl -u trendradar.service -n 50 --no-pager
126126
OnUnitActiveSec=30min
127127
```
128128

129-
如需修改,编辑 [trendradar.timer](/home/yuanzhi/Develop/ai-research/TrendRadar-Rust/deploy/systemd/trendradar.timer) 后重新加载:
129+
如需修改,编辑 [trendradar.timer](../deploy/systemd/trendradar.timer) 后重新加载:
130130

131131
```bash
132132
sudo systemctl daemon-reload

docs/dev-journal/2026-04-10-github-geo-optimization.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -76,9 +76,9 @@
7676
本轮实际执行:
7777

7878
```bash
79-
python3 /home/yuanzhi/.codex/skills/seo/scripts/github_readme_lint.py README.md --json
80-
python3 /home/yuanzhi/.codex/skills/seo/scripts/github_repo_audit.py --repo codefromkarl/TrendRadar-Rust --provider auto --json
81-
python3 /home/yuanzhi/.codex/skills/seo/scripts/github_community_health.py --repo codefromkarl/TrendRadar-Rust --provider auto --json
79+
python3 "$HOME/.codex/skills/seo/scripts/github_readme_lint.py" README.md --json
80+
python3 "$HOME/.codex/skills/seo/scripts/github_repo_audit.py" --repo codefromkarl/TrendRadar-Rust --provider auto --json
81+
python3 "$HOME/.codex/skills/seo/scripts/github_community_health.py" --repo codefromkarl/TrendRadar-Rust --provider auto --json
8282
cargo fmt --all --check
8383
just verify-basic
8484
```

docs/project-closeout.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@
5151
本轮真正影响收尾判断的三个尾项已经处理完:
5252

5353
- `E6`:已补 Rust / Python 的真实主对比值,见 [Python 对比基线](./benchmark-python-baseline.md)
54-
- `O5`:已补复杂并发慢源 / 失败源组合下的多轮稳定性测试,见 [tests/system/http_resilient_recovery.rs](/home/yuanzhi/Develop/ai-research/TrendRadar-Rust/tests/system/http_resilient_recovery.rs)
54+
- `O5`:已补复杂并发慢源 / 失败源组合下的多轮稳定性测试,见 [tests/system/http_resilient_recovery.rs](../tests/system/http_resilient_recovery.rs)
5555
- `P5`:已补最小可扩展通知 sink 模型,见 [配置契约](./contracts/config.md)[app 实施说明](./implementation/app.md)
5656

5757
这些项补完后,仓库已经不再停留在“几乎收完,但还差几个关键尾巴”的状态。

docs/runtime-stability.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@
2626

2727
关键入口:
2828

29-
- [http_resilient_recovery.rs](/home/yuanzhi/Develop/ai-research/TrendRadar-Rust/tests/system/http_resilient_recovery.rs)
30-
- [large_input_stability.rs](/home/yuanzhi/Develop/ai-research/TrendRadar-Rust/tests/system/large_input_stability.rs)
31-
- [large_output_consistency.rs](/home/yuanzhi/Develop/ai-research/TrendRadar-Rust/tests/system/large_output_consistency.rs)
29+
- [http_resilient_recovery.rs](../tests/system/http_resilient_recovery.rs)
30+
- [large_input_stability.rs](../tests/system/large_input_stability.rs)
31+
- [large_output_consistency.rs](../tests/system/large_output_consistency.rs)
3232

3333
### 3. 重复执行稳定性
3434

0 commit comments

Comments
 (0)