Skip to content

📦 v2.1.5

Choose a tag to compare

View all tags
@Aas-ee Aas-ee released this 03 Apr 10:52
· 38 commits to main since this release
v2.1.5
82744eb

English

From 2.0.2 to 2.1.5, open-websearch has been significantly refined into a clearer multi-entry capability layer: MCP server + CLI + local daemon + skill-guided workflow.

Highlights

  • Added and clarified explicit local daemon commands:
    • open-websearch serve
    • open-websearch status
  • Improved one-shot CLI commands and execution model:
    • search
    • fetch-web
    • fetch-github-readme
    • fetch-csdn
    • fetch-juejin
    • fetch-linuxdo
  • Clarified daemon-first behavior for action commands:
    • default local daemon discovery
    • explicit --daemon-url
    • auto-start retry via --spawn
  • Improved --help so it now explains the real CLI model, including:
    • --daemon-url
    • --spawn
    • --json
    • --search-mode
    • --max-chars
    • status vs action-command URL flags
  • Reduced noisy startup output for --help, status, and --json
  • Improved daemon timeout and error handling:
    • distinguish daemon unreachable / timed out / failed while processing
    • use faster discovery timeout and longer explicit action timeout

Skill and setup improvements

  • Refined the open-websearch skill into a more structured setup playbook:
    • detect
    • choose path
    • collect required inputs
    • confirm risky actions
    • perform
    • validate
    • report final state
  • Added stronger real-world setup guidance for:
    • npm proxy / registry mirror
    • runtime proxy
    • daemon startup flow
    • Playwright/browser-assisted usage
  • Added clearer “ask first” rules for:
    • package installation
    • Playwright downloads
    • config changes
    • long-lived daemon startup

Documentation improvements

  • README / README-zh now explain the relationship between:
    • MCP
    • CLI
    • local daemon
    • skill
  • Added a new Use with a Skill section for realistic first-use onboarding
  • Clarified the difference between:
    • installation proxy / mirror
    • runtime proxy after serve
  • Improved Playwright guidance and setup notes

Notes

  • FETCH_WEB_INSECURE_TLS only affects fetch-web, not search engines
  • SEARCH_MODE currently mainly affects Bing
  • bare open-websearch remains the MCP compatibility entrypoint
  • for daemon automation, prefer:
    • open-websearch serve
    • open-websearch status

中文

从 2.0.2 到 2.1.5，open-websearch 进一步完善为更清晰的多入口能力层：MCP server + CLI + 本地 daemon + skill 引导工作流。

重点改进

  • 新增并明确了本地 daemon 的显式命令：
    • open-websearch serve
    • open-websearch status
  • 强化了一次性 CLI 命令与执行模型：
    • search
    • fetch-web
    • fetch-github-readme
    • fetch-csdn
    • fetch-juejin
    • fetch-linuxdo
  • 明确了 action commands 的 daemon-first 行为：
    • 默认本地 daemon 探测
    • 显式 --daemon-url
    • 使用 --spawn 自动拉起并重试
  • 改进了 --help，现在会更完整地说明 CLI 模型，包括：
    • --daemon-url
    • --spawn
    • --json
    • --search-mode
    • --max-chars
    • status 与 action commands 的参数区别
  • 减少了 --help、status、--json 场景下的启动噪音
  • 改进了 daemon 超时与错误处理：
    • 区分 daemon 不可达 / 请求超时 / 处理失败
    • 隐式探测用短超时，显式 daemon 请求用更长超时

Skill 与 setup 改进

  • 将 open-websearch skill 进一步整理为更结构化的 setup playbook：
    • detect
    • choose path
    • collect required inputs
    • confirm risky actions
    • perform
    • validate
    • report final state
  • 增强了贴近真实场景的 setup 引导，包括：
    • npm proxy / registry mirror
    • runtime proxy
    • daemon 启动流程
    • Playwright / 浏览器辅助模式
  • 更明确要求在以下动作前先确认：
    • 安装包
    • 下载 Playwright
    • 修改配置
    • 启动长期 daemon

文档改进

  • README / README-zh 更清楚地说明了以下入口之间的关系：
    • MCP
    • CLI
    • 本地 daemon
    • skill
  • 新增了 Use with a Skill / 配合 skill 使用 小节，用于说明真实首次使用路径
  • 更清楚地区分了：
    • 安装阶段代理 / 镜像
    • serve 之后的运行时代理
  • 改进了 Playwright 相关说明和 setup 指引

说明

  • FETCH_WEB_INSECURE_TLS 只影响 fetch-web，不影响搜索引擎
  • SEARCH_MODE 当前主要影响 Bing
  • 裸命令 open-websearch 仍保留为 MCP 兼容入口
  • 对于 daemon 自动化，推荐使用：
    • open-websearch serve
    • open-websearch status

What's Changed

  • Refactor/runtime and add cli daemon by @Aas-ee in #59
  • feat(cli): add quiet startup logs and improve CLI help output by @Aas-ee in #60
  • Fix/user experience by @Aas-ee in #61
  • fix(cli): update documentation and help text for daemon and action commands by @Aas-ee in #62
  • refactor(open-websearch): restructure setup documentation with staged… by @Aas-ee in #63
  • docs(open-websearch): clarify proxy configuration guidelines by @Aas-ee in #64

Full Changelog: v2.0.2...v2.1.5

Contributors

Aas-ee
Assets 2
Loading