Obsidian

细雨初晴

platform deploy.sh 首次部署不生效 (Nginx Deploy Copy-Order Bug)

触发条件在 ~/workspace/platform/nginx/routes.json 里改路由后，跑 ./deploy.sh 第一次，新配置没有生效。症状deploy.sh 输出 ✅ 部署成功、nginx -t 通过、systemctl reload nginx 执行，但 curl 验证时行为还是旧配置（例如新加的 auth_basic 不生效，无凭据仍返回 200）。根因deploy.sh

Obsidian

细雨初晴

HTTPS 协议

1. HTTP 明文风险：谁看得到HTTP 是明文传输。 只要是 http 的请求（URL、表单、Cookie、Authorization 头），路径上的每个节点都能直接读取，不需要"破解"。按风险等级的场景：场景风险说明公共 WiFi高同网任意设备可抓包（Wireshark 傻瓜式操作）校园网/公司网关中-高网关天然记录经过的所有明文流量运营商/ISP中可缓存、重定向、注入；国内有运营商插入广告

Obsidian

细雨初晴

防盗链_防克隆跳转机制 (preventCheat)

防克隆 / 防自部署跳转机制是商业站（如 toolonline.net）用 obfuscator.io 混淆前端时植入的多层自我保护，核心是 domainLock（域名锁）：检测当前域名是否属于白名单，否则把页面重定向回原站。这类逻辑的字符串被加密在字符串数组里，直接 grep "toolonline.net" 永远搜不到，必须先解码。domainLock（域名锁）——"域名统

Obsidian

细雨初晴

bun install 大包被代理截断 (Bun Install Tarball Truncation via Proxy)

触发条件服务器（腾讯云国内）上，bun/npm 安装依赖时走 mihomo 代理 127.0.0.1:7890（.npmrc 里 proxy/https-proxy）。依赖里包含 大包（>80MB），典型是 @anthropic-ai/claude-agent-sdk-linux-x64 和 -musl（各约 85MB 的原生二进制，属于可选依赖）。症状：bun install 长时间无进展

Obsidian

细雨初晴

Agent 工具结果文本化 (Tool Result Text Formatting for LLM Agents)

给 LLM 的 function calling 工具输出应该从裸 JSON 转成精简排版文本，这是 Anthropic / OpenAI 官方 tool use 最佳实践，也一直是我们的默认做法（忘记记录，补上）。为什么不做裸 JSON函数返回的原始 dict 直接 json.dumps 喂给模型有两大问题：字段名是噪音：category_name、matched_keywords、coordi