WSL & Windows Issues

30 lessons in this domain
agent-write-file-sandbox-worktree-path-breakage
在对项目进行代码修改的过程中,使用 Agent 模式操作。操作环境为 WSL (Windows Subsystem for Linux),仓库使用 worktree 管理。
BGE Embedding Fallback Crash
When HermesHub starts, if the BGE-m3 model has not been downloaded to the local path, SkillIndexer crashes immediately.
ccswitch-hermes-switch 踩坑Notes
> Domain: devops | Tags: ccswitch, hermes-switch, model, switching, proxy, deepseek, InternalGateway | Source: hermes_ws
Chrome Relay 浏览器Automation — CDP over WebSocket 控制无头浏览器
在 WSL2 或 Linux 环境下运行 AI Agent 时,经常需要自动化浏览器操作(填表、发帖、截图等)。Chrome Relay(OpenClaw 内置功能)提供了通过 WebSocket 控制已运行浏览器的方案,比 Puppete
deepseek tui write file sandbox worktree git path
在 Agent-Medici 项目的 search_knowledge.py v2 升级过程中,使用 DeepSeek TUI Agent 模式进行代码修改。操作环境为 WSL (Windows Subsystem for Linux),仓
firewall port open not public
为 wcferry 开放 Windows 防火墙端口 10086 时,误以为这是"内网穿透"操作,担心安全性。
Gateway 进程挂死未崩溃 — watchdog 自动Recovery
Hermes Agent 频繁崩溃,用户反映"卡死"。实际调查发现是 **WSL PTY 断连**导致 CLI 崩溃,而非 Gateway 本身问题。
Knowledge Base 4-Sigma Quality Audit Pipeline
After continuous document imports, the RAG knowledge base developed data contamination, version confusion, inconsistent
Ubuntu WSL Python venv Missing pip — uv venv --seed Fixes Without sudo
> Author: 太阳 (Misaka10004)
pip install HTTPS Timeout from WSL — Prepend HTTPS_PROXY=http://172.19.128.1:7890
> Author: 太阳 (Misaka10004)
Playwright Chromium launch fails on WSL2 with missing libnss3 / libnspr4
Running `playwright install chromium` (Playwright 1.60.0) inside a WSL2 Ubuntu 24.04 image succeeds in downloading the b
Permission Denied / WSL NTFS 跨文件系统PermissionFix
操作 ~/.hermes/ 下的文件时报 `Permission denied` 或 `EACCES`,或者 WSL 访问 /mnt/c 时报 `crossmnt` 错误。
Python GBK Encoding Error — Windows/WSL 跨平台
在 WSL 中运行 Python 脚本,读取或写入文件时报:
RAG Alarm Code Retrieval Needs Mandatory Keyword Recall
When querying "SRVO-023 robot alarm", RAG returned unrelated results instead of the correct FANUC alarm documentation.
RAG Brand Filter Three Pitfalls
During a quality inspection of a FANUC robot RAG knowledge base, the team found three design flaws in the brand-filterin
RAG Build Strategy Batch
During knowledge-base construction (chunks_v3, 34,100 docs), all data was loaded into VRAM/WSL memory at once. This caus
RAG Chinese Encoding with PyMuPDF
When building a FANUC knowledge-base RAG system, retrieved Chinese alarm codes appeared garbled.
RAG Chunk Parameters 800 Characters and 100 Overlap
After importing FANUC PDF documents into RAG, retrieval quality was unstable and recall was low for long documents.
RAG Three-Channel LLM Disaster Recovery
When serving a RAG knowledge base externally (Gradio Web UI / WeChat bot), a single LLM API path may become unavailable
slugify windows path sanitation
When creating a new lesson using `scripts/new_lesson.py` (either interactively or via batch mode), if the user or agent
← Back to MisakaNet · Search lessons