9 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
thzxx	ea7a60a460	fix(test): subprocess 显式指定 encoding=utf-8，修复 Windows GBK 解码崩溃 ... _run_cli 辅助函数的 subprocess.run 用 text=True 但未指定 encoding，Windows 中文系统默认用 GBK 解码子进程输出，--help 的非 ASCII 字符（box-drawing/em-dash）触发 UnicodeDecodeError。显式指定 encoding='utf-8' 与脚本的 force_utf8_stdout() 对齐。 测试: 362/362 全部通过	2026-08-01 20:57:08 +08:00
thzxx	f7cdc81c7f	feat(v1.8.1): Windows 兼容性修复 + SKILL.md 铁律区块 ... Windows 兼容性修复（基于真实使用痛点）: - force_utf8_stdout(): 强制 stdout/stderr 为 UTF-8，修复 Windows GBK 崩溃（print('\\xa0') 不再炸） - resolve_instances/load_config 新增 %APPDATA%/searxng-cli/ 路径，覆盖 Windows 配置约定 - fetch.py 失败诊断增强：输出 status_code=/cause=/url= 字段，AI Agent 可程序化区分 404/403/DNS 失败 SKILL.md 铁律区块（5 条，置顶）: - stdout=数据/stderr=日志 永不混淆 - 禁用 2>/dev/null（丢弃 stderr = 失败时零诊断） - 排错去 --quiet 加 --verbose - 配置查找覆盖 WSL + Windows 双路径 - 实例 URL 必填，公共实例发现已移除 测试: 352 -> 362（新增 10 个：force_utf8_stdout 幂等性/GBK 替换/非 ASCII 打印/APPDATA 路径发现/txt 回退/空 APPDATA）	2026-08-01 20:50:42 +08:00
thzxx	657af0a221	docs: 精简 SKILL.md，移除 AI Agent 无关章节 ... 删除：SearXNG Search API Quick Reference、Common Workflow、Troubleshooting、Common Pitfalls、Verification Checklist 精简：Cross-Agent Compatibility 表格压缩为段落 SKILL.md: 43KB -> 30KB（-32%），聚焦 AI Agent 核心需求	2026-08-01 19:36:23 +08:00
thzxx	fb9b2af45f	feat(v1.8.0): 稳定性修复 + AI Agent 体验增强 ... 稳定性修复: - 修复 cache.py SQLite 连接泄漏（contextlib.closing 包装） - 修复 fetch.py requests stream=True 连接泄漏（try/finally resp.close()） - RETRYABLE_STATUS 新增 403，激活 UA fallback 切换逻辑 - --cache-stats 移至实例解析前，无需实例即可查询 - classify_error 从错误消息提取 HTTP 状态码，正确分类 E_AUTH/E_RATE_LIMIT - --stream 与 --queries-file 互斥检查，违规报 E_INPUT - batch 退出码语义统一（0=有结果 / 1=全部错误 / 2=全部空结果） AI Agent 体验增强: - 错误码体系完善：E_CONFIG/E_AUTH/E_NETWORK/E_RATE_LIMIT/E_PARSE/E_EMPTY/E_INPUT/E_INTERNAL - recovery_hint 恢复提示字段，AI Agent 可程序化决策恢复策略 - stream 模式新增 error 事件类型（含 error_code + recovery_hint） - 进度事件扩展：instance_try/instance_ok/instance_fail - batch 模式统一 schema（status 字段区分 success/failed） - JSON 输出含 schema_version 字段确保版本兼容 测试与文档: - 测试覆盖：330 -> 352 - SKILL.md / README.md 同步更新	2026-08-01 19:02:44 +08:00
thzxx	dea899143d	feat: searxng.toml 支持 auth_basic/auth_bearer 认证配置 ... - common.py: resolve_auth_basic/bearer 新增 config_value 参数，优先级 CLI > file > config > env - search.py: main() 从 load_config() 读取 auth_basic/auth_bearer；修复 --config 指定文件中 instance 字段不被解析的问题 - LICENSE: 补齐 MIT 协议文件 - tests: +21 测试覆盖配置文件认证优先级链与 main() 集成（309→330） - docs: SKILL.md/README.md 同步更新认证配置说明与安全提醒	2026-08-01 18:01:32 +08:00
thzxx	f983a9377e	feat(v1.7.0): AI 友好度增强 + 测试补全 (155→309) ... 核心新增（面向 AI Agent 程序化使用）： - 结构化错误码体系：E_CONFIG/E_AUTH/E_NETWORK/E_RATE_LIMIT/E_PARSE/E_EMPTY/E_INPUT/E_INTERNAL classify_error() 自动分类异常，JSON 错误输出含 error_code 字段 - JSON Lines 流式输出 (--stream)：每条结果独立一行，AI 可增量处理 - 进度事件 (--progress)：JSON Lines 事件流到 stderr（start/cache_hit/fetch_ok/done 等） 测试补全（+154 例，覆盖全部高风险盲区）： - HTML 回退搜索路径 (19) - --fetch 自动抓取 (21) - --verify 健康检查 (15) - 输出格式化 (15) - 实例解析链 (20) - 并行多实例搜索 (10) - CLI 入口与端到端 (17) - 错误码分类 (27) - 流式输出与进度事件 (10) 源码改进： - search.py: h3 内 a 标签 href 作为 url fallback，提升 SearXNG 主题兼容性 - common.py: 新增 classify_error/emit_progress/set_progress_enabled 文档同步：SKILL.md 新增 AI Agent Integration Guide 章节，README.md 更新参数与错误码表	2026-08-01 17:40:14 +08:00
Metona Team	9796988da9	docs: README 改为中文并面向 AI 使用场景; 删除 CI 配置	2026-08-01 17:08:56 +08:00
Metona Team	c3e8cdf6cb	ci: use debian-latest runner label	2026-08-01 17:04:08 +08:00
Metona Team	0468dd4e9d	Initial commit: SearXNG CLI Toolkit v1.6.0 ... Multi-instance failover, exponential-backoff retry, SQLite cache, batch mode, domain filter, cross-engine dedup, result sorting, CSV export, structured logging, enhanced Markdown conversion, 155 pytest tests, Gitea Actions CI	2026-08-01 17:02:34 +08:00