xby-hackernews-search: HackerNews 内容检索与分析服务

DeepSeek Harness (DSH) 的插件生态采用“一切皆插件”的理念，通过扩展 MCP（Model Context Protocol）服务来增强 AI 代理获取外部数据的能力。xby-hackernews-search 是一个针对 HackerNews 的数据检索与分析插件，由 xby-skill 维护，开源协议为 MIT。它主要解决 AI 代理或开发者需要实时访问 HackerNews 数据、进行关键词搜索以及分析热门内容的需求。

核心功能¶

该插件提供以下主要能力：

set_xby_apikey：在聊天会话中设置 API 密钥。该密钥会自动持久化，重启后依然有效。
search_posts：根据关键词检索 HackerNews 内容。支持标题、文本和作者的搜索，并提供标签过滤、数值过滤（如点赞数、评论数）、分页以及 OR 逻辑的高级筛选功能。
get_front_page：获取当前 HackerNews 首页的帖子列表。返回的数据包含排序后的热门内容，并支持分页。
get_latest_posts：获取按时间排序的最新 HackerNews 帖子。
get_item：获取特定 HackerNews 条目（ID）的详细信息，包括完整的嵌套评论树和元数据。
get_user：获取 HackerNews 用户的公开档案信息，包括 Karma 值、简介和注册时间。

安装与启用¶

安装该插件需要 DeepSeek Harness 的 CLI 工具。在安装前，请确保已配置好 web profile。

dsh plugin --profile web add github:xby_skill/xby-hackernews-search

安装完成后，在 DSH 的会话中即可调用上述功能。

使用示例¶

设置 API 密钥¶

使用该服务前，需要在聊天中设置 API 密钥。

set_xby_apikey
// 接下来会提示输入密钥

搜索帖子¶

支持通过关键词、标签和数值过滤器组合使用。

基础搜索：搜索 AI 相关的故事。

    search_posts
    {
      "query": "AI",
      "tags": ["story"]
    }

数值过滤：查找点赞数超过 100 的 Python 帖子。

    search_posts
    {
      "query": "Python",
      "numericFilters": ["points>=100"]
    }

OR 逻辑与标签：获取 Web 类别下包含故事或投票的内容。

    search_posts
    {
      "query": "web",
      "tags": ["(story,poll)"]
    }

获取首页与最新内容¶

获取首页：获取首页帖子，可自定义每页数量。

    get_front_page
    {
      "hitsPerPage": 50
    }

获取最新帖子：获取最新的评论内容。

    get_latest_posts
    {
      "tags": ["comment"]
    }

获取用户与条目详情¶

获取用户信息：查询特定用户的档案。

    get_user
    {
      "username": "pg"
    }

获取条目详情：获取特定 ID 的故事及其所有评论。

    get_item
    {
      "itemId": "38456789"
    }

注意事项¶

API 密钥来源：该插件需要外部 API 密钥，请前往小笨羊官网注册获取。
性能与错误处理：
- get_item：对于包含超过 500 条评论的大型线程，加载可能需要 2-3 秒。如果条目不存在或已被删除，将返回错误。
- get_user：如果用户不存在或用户名格式无效（仅允许字母数字和下划线，且区分大小写），将返回错误。
运行环境：插件以当前 DSH 进程的权限运行。在安装前，建议检查源码及许可证（MIT）以确认符合项目需求。