dsh-tool-hackernews

English | 中文

面向 DeepSeek Harness（DSH）智能体的 Hacker News 工具套件：hn_top_stories、hn_search、hn_item。基于免费的 Algolia HN 搜索 API 构建 —— 无需任何 API Key。

工具

工具	参数	行为
hn_top_stories	limit（可选，1–30）	Hacker News 当前热门首页：标题、链接、评分、评论数、作者、相对时间。
hn_search	query（必填）、tag（story/comment/poll/ask_hn/show_hn）、since_hours（1–8760）、limit（1–30）	关键词搜索 HN，可限定标签或最近 N 小时。
hn_item	id（必填）、max_comments（0–100）	单个故事详情 + 有上限的评论树（自动去除 HTML、按层级缩进），保护上下文窗口。

三个工具都是只读且并发安全的，DSH 可以并行调度同级的工具调用。每个请求都携带部署方配置的超时预算，并转发调用方的 AbortSignal。

安装

DSH 插件通过 dsh plugin（底层是 pnpm）安装到 profile 中。从本 GitHub 仓库安装：

dsh plugin --profile <名称> add "github:tanf1ng/dsh-tool-hackernews"

或从本地源码安装：

pnpm install
pnpm build
# 然后在需要加载它的 profile 里执行：
dsh plugin --profile <名称> add "file:../../dsh-tool-hackernews"

在 profile 的 cordis.patch.yml（或产品 bundle）中启用插件：

- id: tool-hackernews
  name: dsh-tool-hackernews

配置

所有配置项均可选：

配置项	默认值	含义
registerTopStories	true	是否注册 hn_top_stories。
registerSearch	true	是否注册 hn_search。
registerItem	true	是否注册 hn_item。
topStoriesLimit	10	hn_top_stories 的默认结果条数上限。
searchLimit	8	hn_search 的默认结果条数上限。
maxComments	20	hn_item 的默认评论条数上限。
fetchTimeoutMs	15000	单次请求的超时预算（毫秒）。

开发

pnpm install
pnpm build     # tsc -> lib/
pnpm test      # 冒烟测试（stub fetch，无需网络）

本包遵循官方 DSH 工具插件模式：一个 Cordis 插件（name / inject / Config / apply），通过 ctx.tools.register(defineTool(...)) 注册工具，包含完整的参数 schema、规范化的输出 schema、文本渲染器和 presentCall UI 卡片。

使用示例

装上之后，你可以直接问智能体：

"今天 Hacker News 上最火的是什么？" → hn_top_stories "HN 上最近有人讨论 DeepSeek 吗？" → hn_search（搜索 "deepseek"，限最近 24 小时） "这篇热门帖子的评论都在聊什么？" → hn_item

许可证

MIT