用于获取 Hacker News 榜单、讨论串、搜索和用户资料的工具。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-hacker-news
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:heartleo/hn-cli#path:/plugins/hacker-news
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
该插件的 README 只有英文版本。
Hacker News tools for DeepSeek Harness: browse the ranked feeds, read a thread with its reply tree, search the Algolia index, and look up a user.
The plugin is published as dsh-hacker-news and listed in the awesome-dsh-plugin community registry.
Plain ESM JavaScript, no build step and no runtime dependency on the hn binary — it talks to the public HN APIs directly (https://hacker-news.firebaseio.com/v0 and https://hn.algolia.com/api/v1).
Tools
| Tool | Arguments | Returns |
|---|---|---|
hn_stories |
feed (top/new/best/ask/show/job), limit, offset |
Ranked stories with id, score, comment count, URLs |
hn_item |
id (required), comment_limit, max_depth |
The item plus its reply tree in reading order, with depth and truncated |
hn_search |
query (required), sort (relevance/date), tags, limit |
Algolia hits normalised to the story shape |
hn_user |
id (required) |
found, karma, account age, bio, submission count |
Comment HTML is converted to plain text (links keep their label plus target) and clipped at maxTextLength. Reply loading is breadth-first, so a small comment_limit returns the top of the thread rather than one deep branch; truncated reports whether anything was left out.
Use
Ask naturally; the plugin guides the agent to the matching tool:
What's popular on Hacker News right now?
Search Hacker News for SQLite WASM.
Read HN item 49322107 and summarize the discussion.
Look up the HN user dang.
Install
Install the published package:
dsh plugin --profile <name> add -w dsh-hacker-news
Restart DSH Web after installation. If your npm mirror has not indexed the latest release, use the public npm registry for the install:
$env:npm_config_registry = 'https://registry.npmjs.org/'
dsh plugin --profile <name> add -w dsh-hacker-news
The package ships runnable JavaScript, so no prepare build and no pnpm allowBuilds entry is needed. To install directly from the repository or from a local checkout:
dsh plugin --profile <name> add -w github:heartleo/hn-cli#path:/plugins/hacker-news
dsh plugin --profile <name> add -w /absolute/path/to/hn-cli/plugins/hacker-news
dsh --profile <name> --dump-config # shows the "# == dsh-hacker-news" layer
To load it from source without installing, point a patch overlay at the entry file:
- insert:
- id: hacker-news
name: '/absolute/path/to/hn-cli/plugins/hacker-news/index.js'
pnpm dsh web --patch ./scratch/hacker-news.cordis.yml
Configuration
Every tunable is a config field, overridable per profile in cordis.patch.yml:
- id: hacker-news
name: dsh-hacker-news
config:
defaultStoryLimit: 30
defaultCommentLimit: 100
requestTimeoutMs: 20000
| Field | Default | Meaning |
|---|---|---|
firebaseBaseUrl |
https://hacker-news.firebaseio.com/v0 |
Official HN API root |
algoliaBaseUrl |
https://hn.algolia.com/api/v1 |
Search API root |
requestTimeoutMs |
15000 |
Per-request timeout |
concurrency |
20 |
Maximum in-flight item fetches |
defaultStoryLimit / maxStoryLimit |
20 / 100 |
Story and search result counts |
defaultCommentLimit / maxCommentLimit |
50 / 400 |
Replies loaded per hn_item call |
defaultCommentDepth / maxCommentDepth |
5 / 10 |
Reply nesting followed |
maxTextLength |
2000 |
Clip length for story, comment, and bio text |
userAgent |
dsh-hacker-news/0.1.0 … |
Sent on every request |
Checking it locally
npm test first runs the offline routing and presentation tests, then load-check.mjs registers the tools against a stub context, runs every tool against the live API, validates each result with the registry's own output-schema validator, and exercises the rejection paths:
cd plugins/hacker-news
npm install --no-package-lock
npm test
The final integration phase needs network access.
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37401
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36932
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 7929
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5798
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2081
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
yjl9903/AnimeGarden#dsh★ 1400
Anime Garden 的 DSH 插件:在 DSH 内搜索来自動漫花園、蜜柑计划、萌番组和 ANi 的动画 BT 资源——支持对话搜索、按字幕组和类型筛选的侧边栏面板、新番周历,以及站内浮窗播放。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。