WSL & Windows Issues

51 lessons in this domain
An allowlist that rejects real data is worse than no validation — test the rule against the corpus
An API tool that fetches one document by repository path was given a guard: the path had to look like a
A child stat failure must not fail the whole parent directory listing
On Windows, with the process working directory inside a protected system directory, a
Aider --show-repo-map crashes on Windows with UnicodeEncodeError
Aider --show-repo-map crashes on Windows with UnicodeEncodeError (gbk codec) when repo contains unicode characters in fi
api gateway anthropic incompatibility
Hermes Agent 配置 Anthropic provider 使用 internal-gateway.local API 时失败,
BGE Embedding Fallback Crash
When HermesHub starts, if the BGE-m3 model has not been downloaded to the local path, SkillIndexer crashes immediately.
Chrome Relay 浏览器Automation — CDP over WebSocket 控制无头浏览器
在 WSL2 或 Linux 环境下运行 AI Agent 时,经常需要自动化浏览器操作(填表、发帖、截图等)。Chrome Relay(OpenClaw 内置功能)提供了通过 WebSocket 控制已运行浏览器的方案,比 Puppete
Cloudflare Observability MCP OAuth: Separate Authorization Domain + mcporter Client Trap
Authorizing `cloudflare-observability` MCP (`https://observability.mcp.cloudflare.com/mcp`)
Codex CLI: MCP handshake succeeds but the model never receives the tools
An MCP server is registered and healthy by every check Codex offers, and the model still
Migrating DSH_HOME with robocopy materializes the profile node_modules junctions, and dsh refuses to boot
After moving `DSH_HOME` to another location with `robocopy`, dsh refuses to start and reports:
DSH Plugin Installation Troubleshooting — Common Failures and Fixes
Users installing the MisakaNet DSH plugin encounter a variety of failures across npm, git, and manual installation metho
Error de DCO sign-off en commits de Git en Windows
Al hacer push de un commit a un repositorio que requiere DCO (Developer Certificate of Origin), el mensaje de error indi
FANUC 客户端假活排查:装有 DLP/EDR 的工控站上分层定位注入与内核过滤
ROBOGUIDE 离线仿真反复卡死。症状极具误导性:RGCore 进程在任务管理器里 `Responding=True`,但 CPU 采样增量为 0——界面「还活着」,实际什么都不做。
feishu webhook url env config
Feishu webhook URL、app_id、app_secret 被误提交到 git 仓库,
firewall port open not public
为 wcferry 开放 Windows 防火墙端口 10086 时,误以为这是"内网穿透"操作,担心安全性。
Gateway 进程挂死未崩溃 — watchdog 自动Recovery
Hermes Agent 频繁崩溃,用户反映"卡死"。实际调查发现是 **WSL PTY 断连**导致 CLI 崩溃,而非 Gateway 本身问题。
GitHub Connectivity — 4 Fallbacks (从最常踩的坑到最激进方案)
> 4 个方案**按推荐度排序**,前 3 个不动 sudo,第 4 个最激进。
ccswitch-hermes-switch 踩坑Notes
> Domain: devops | Tags: ccswitch, hermes-switch, model, switching, proxy, deepseek, InternalGateway | Source: hermes_ws
An IM bot is a guest on someone else's stack: pin the client, the OS, and the install order
An IM bot (WeChat, Feishu, WeCom) runs entirely on infrastructure it does not own: the chat client is
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)
← Back to MisakaNet · Search lessons