pp-digg

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Digg AI — Printing Press CLI

Prerequisites: Install the CLI

前置条件：安装CLI

This skill drives the

digg-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install digg --cli-only

Verify:
```
digg-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

Digg AI is a curated leaderboard of 1,000 AI accounts on X and the story clusters they surface. The web UI shows you today's snapshot. This CLI tails the pipeline events, keeps a local rank-history that survives daily overwrites, and exposes Digg's own replacement rationale and gravity components so an agent can answer 'why this story?' and 'what got dropped overnight?' with structured data.

本技能驱动

digg-pp-cli

二进制文件。在调用本技能的任何命令之前，您必须确认CLI已安装。如果未安装，请先执行以下步骤：

通过Printing Press安装程序安装：

bash

npx -y @mvanhorn/printing-press install digg --cli-only

验证安装：
```
digg-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果在该CLI进入公共库分类前

npx

安装失败，请安装Node.js，或在发布后使用特定分类的Go备用安装方式。

如果安装后执行

--version

提示“command not found”，说明安装步骤未将二进制文件添加到

$PATH

中。在验证成功前，请不要执行技能命令。

Digg AI是X平台上1000个AI账号的精选排行榜，以及这些账号发布的故事集群。网页界面展示的是当日快照。本CLI可追踪流水线事件，保留不受每日覆盖影响的本地排名历史，并公开Digg自身的替换依据和权重组件，让Agent能够通过结构化数据回答“为什么是这个故事？”以及“夜间哪些内容被替换了？”等问题。

When to Use This CLI

何时使用本CLI

Use this CLI when an agent or power user needs structured access to Digg AI's rankings, ranking-change history, pipeline events, or per-cluster transparency record. It is the right tool for tracking AI-news cycle movement, building cross-aggregator research over HN+Techmeme+Digg, or exposing Digg AI signals into a larger automation. Do NOT use it for vote, comment, or post automation — those mutations are explicitly out of scope.

当Agent或高级用户需要结构化访问Digg AI的排名、排名变化历史、流水线事件或集群级透明度记录时，可使用本CLI。它是追踪AI新闻周期动态、构建HN+Techmeme+Digg跨聚合器研究，或将Digg AI信号集成到更大自动化流程中的理想工具。请勿将其用于投票、评论或发布自动化——这些操作明确不在本工具的范围内。

When Not to Use This CLI

何时不使用本CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

请勿为需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或修改远程状态的请求激活本CLI。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.

这些功能是其他同类型API工具所不具备的。

Topic search and per-post citations

主题搜索与单帖引用

search
— Topic search across Digg's full window. Live by default — hits
```
/api/search/stories
```
, the same server-side search that backs the di.gg/ai Cmd+K modal — with FTS5 fallback to the local store on network error or
```
--data-source local
```
.
Returns ranked clusters with engagement metadata (postCount, uniqueAuthors, firstPostAge); the load-bearing recipe for last30days-style research workflows.
bash
```
digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge
```
- --since Nh|Nd|Nw|Nm
  — filter to clusters first posted within the window (live mode parses Digg's own
```
firstPostAge
```
  ; local mode reads
```
digg_clusters.first_post_at
```
  ).
posts
— X posts attached to one cluster, with author rank, body when rendered, media URLs, repost-context, and minted xUrl for one-click citation.
The citations recipe: surface the highest-credibility AI 1000 voices on a story, sortable by rank, type, or time.
bash
```
digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body
```

search
— 在Digg的完整时间范围内进行主题搜索。默认使用实时模式——调用
```
/api/search/stories
```
，即支持di.gg/ai Cmd+K模态框的服务器端搜索——在网络错误或指定
```
--data-source local
```
时，会回退到本地存储的FTS5搜索。
返回包含互动元数据（postCount、uniqueAuthors、firstPostAge）的排名集群；是支持近30天研究工作流的核心命令。
bash
```
digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge
```
- --since Nh|Nd|Nw|Nm
  — 筛选在指定时间窗口内首次发布的集群（实时模式解析Digg自身的
```
firstPostAge
```
  ；本地模式读取
```
digg_clusters.first_post_at
```
  ）。
posts
— 关联到单个集群的X帖子，包含作者排名、渲染后的正文、媒体URL、转发上下文和用于一键引用的专属xUrl。
引用解决方案：展示某一故事中可信度最高的AI 1000账号内容，可按排名、类型或时间排序。
bash
```
digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body
```

Author lookup and roster browse

作者查询与排行榜浏览

authors get
— Look up any X handle in Digg's full author universe (1000 + off-1000) via
```
/api/search/users
```
. For off-1000 handles, the response includes
```
subject_peer_follow_count
```
, the rank-1000 anchor's
```
peer_follow_count
```
, and a signed
```
peer_follow_gap
```
— the gap to the 1000 measured in AI-1000 peer follows (NOT raw X follower count).
The credibility lookup: an agent can decide whether to quote a handle by reading one structured record.
bash
```
digg-pp-cli authors get <handle> --agent
```
Trimmed off-1000 example for
```
mvanhorn
```
:
json
```
{
  "username": "mvanhorn",
  "current_rank": null,
  "subject_peer_follow_count": 19,
  "nearest_in_1000": {"rank": 1000, "username": "...", "peer_follow_count": 90},
  "peer_follow_gap": 71
}
```
```
peer_follow_gap
```
is the gap to rank-1000's
```
followed_by_count
```
(peer follows from inside the AI 1000). Do not read it as a raw X follower delta.

authors list
— Full ranked AI 1000 from

/ai/1000

, persisted with rich fields (rank, category, bio, vibeDistribution, GitHub URL).

Identify rising voices in a category, find authors who just joined the 1000, see who's falling fast — sortable, filterable, scriptable.

bash

# Biggest movers since the last snapshot
digg-pp-cli authors list --by rankChange --limit 20 --agent

# Newly listed (first appearance in the 1000)
digg-pp-cli authors list --only-new --agent

Sort with

--by rank|rankChange|category|followers

; filter with

--category "<name>"

--only-new

--only-fallers

authors get
— 通过
```
/api/search/users
```
查询Digg完整作者库中的任意X账号（1000个核心账号+非核心账号）。对于非核心账号，响应包含
```
subject_peer_follow_count
```
、排名1000的基准账号的
```
peer_follow_count
```
，以及签名后的
```
peer_follow_gap
```
——与1000名核心账号的关注差距（不是X平台的原始粉丝数）。
可信度查询：Agent可通过一条结构化记录决定是否引用某账号内容。
bash
```
digg-pp-cli authors get <handle> --agent
```
非核心账号
```
mvanhorn
```
的精简示例：
json
```
{
  "username": "mvanhorn",
  "current_rank": null,
  "subject_peer_follow_count": 19,
  "nearest_in_1000": {"rank": 1000, "username": "...", "peer_follow_count": 90},
  "peer_follow_gap": 71
}
```
```
peer_follow_gap
```
是与排名1000账号的
```
followed_by_count
```
（AI 1000核心账号的关注数）差距。请勿将其视为X平台原始粉丝数的差值。
authors list
— 从
```
/ai/1000
```
获取完整的AI 1000排名列表，并持久化存储丰富字段（rank、category、bio、vibeDistribution、GitHub URL）。
识别某一分类中的新兴账号、找到刚加入1000榜单的作者、查看排名快速下降的账号——支持排序、筛选和脚本化处理。
bash
```
# 上次快照以来排名变化最大的账号
digg-pp-cli authors list --by rankChange --limit 20 --agent

# 新上榜账号（首次进入1000榜单）
digg-pp-cli authors list --only-new --agent
```
使用
```
--by rank|rankChange|category|followers
```
进行排序；使用
```
--category "<name>"
```
、
```
--only-new
```
、
```
--only-fallers
```
进行筛选。

Live pipeline observability

实时流水线监控

events
— Tail Digg's ingestion pipeline in real time — see clusters as they're detected, stories fast-climbing the leaderboard with explicit rank deltas, X posts being processed, batch breakdowns.
When an agent needs 'tell me when story X just climbed N ranks' or 'what new clusters did Digg detect in the last hour', this is the only way.
bash
```
digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank
```
watch
— Poll /ai, diff against last snapshot, alert when any cluster moves N+ ranks.
Read-only operational watcher; never writes anything back to Digg.
bash
```
digg-pp-cli watch --alert 'rank.delta>=10'
```
pipeline status
— One-screen view of /api/trending/status: isFetching, nextFetchAt, storiesToday, clustersToday, last 5 events.
Lets ops and power users see when a fresh batch is about to land and what's been ingested in the last hour.
bash
```
digg-pp-cli pipeline status --watch
```

events
— 实时追踪Digg的 ingestion 流水线——查看集群检测情况、排名快速上升的故事（包含明确的排名变化值）、正在处理的X帖子、批量处理详情。
当Agent需要“告知我故事X何时上升了N个排名”或“过去一小时Digg检测到哪些新集群”时，这是唯一的实现方式。
bash
```
digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank
```
watch
— 轮询
```
/ai
```
接口，与上次快照对比，当任意集群排名变化超过N时发出警报。
只读操作监控器；绝不会向Digg写入任何内容。
bash
```
digg-pp-cli watch --alert 'rank.delta>=10'
```
pipeline status
— 单屏展示
```
/api/trending/status
```
信息：isFetching、nextFetchAt、storiesToday、clustersToday、最近5个事件。
让运维人员和高级用户了解新批次内容何时上线，以及过去一小时内已摄入的内容。
bash
```
digg-pp-cli pipeline status --watch
```

Local state that compounds

可累积的本地状态

replaced
— Show stories that were knocked out of the rankings since the last sync, with Digg's own published replacement rationale.
Best-of-feed shifts faster than people remember. This makes 'what did Digg drop and why' queryable.
bash
```
digg-pp-cli replaced --since 24h --json
```
crossref
— Show this cluster's Hacker News and Techmeme mirrors when Digg has detected the story is being discussed there.
Removes the manual 'is HN talking about this too' step from any cross-aggregator research workflow.
bash
```
digg-pp-cli crossref iq7usf9e
```
authors top
— Top accounts in the Digg AI 1000 ranked by Digg's influence score, story count, or reach.
Investors and AI scouts care which accounts move the news cycle. Now queryable, sortable, scriptable.
bash
```
digg-pp-cli authors top --by influence --limit 50 --json
```
history
— Full trajectory of one cluster's currentRank, peakRank, and delta over local snapshot history.
'Entered at #18, peaked at #4 over 6h, dropped to #22 by 24h' is impossible to learn from the live site.
bash
```
digg-pp-cli history iq7usf9e --json
```
author
— Every cluster a given X account contributed to, with post type (original, retweet, quote, reply).
'Show me every story this account surfaced this week' is the investor-scout query.
bash
```
digg-pp-cli author Scobleizer --since 7d --json
```

replaced
— 展示自上次同步以来被移出排名的故事，以及Digg官方发布的替换依据。
精选信息流的变化速度远超人们的记忆。该功能让“Digg移除了哪些内容以及原因”可被查询。
bash
```
digg-pp-cli replaced --since 24h --json
```
crossref
— 当Digg检测到某故事在Hacker News和Techmeme上被讨论时，展示该集群在这两个平台的镜像内容。
省去了跨聚合器研究工作流中手动检查“HN是否也在讨论这个内容”的步骤。
bash
```
digg-pp-cli crossref iq7usf9e
```
authors top
— 按Digg影响力评分、故事数量或覆盖范围排名的AI 1000顶级账号。
投资者和AI scout关注哪些账号能推动新闻周期。现在该信息可被查询、排序和脚本化处理。
bash
```
digg-pp-cli authors top --by influence --limit 50 --json
```
history
— 单个集群在本地快照历史中的currentRank、peakRank和delta完整轨迹。
“初始排名18，6小时内升至第4，24小时后降至22”这类信息无法从实时网站获取。
bash
```
digg-pp-cli history iq7usf9e --json
```
author
— 某一X账号贡献的所有集群，包含帖子类型（原创、转发、引用、回复）。
“展示该账号本周发布的所有故事”是投资者和AI scout常用的查询需求。
bash
```
digg-pp-cli author Scobleizer --since 7d --json
```

Transparency

透明度

evidence
— Print the full ranking transparency record for one cluster — scoreComponents, evidence array, numeratorLabel, percentAboveAverage.
When a user asks 'why is THIS the top story', the answer is structured data; agents can compose with it.
bash
```
digg-pp-cli evidence iq7usf9e --json
```
sentiment
— Read per-time-window positivity ratios (pos6h, pos12h, pos24h, posLast) for a cluster.
Tells an agent whether the conversation around a story is still net-positive or has soured; useful before quoting a story.
bash
```
digg-pp-cli sentiment iq7usf9e --window 6h --json
```

evidence
— 打印单个集群的完整排名透明度记录——scoreComponents、evidence数组、numeratorLabel、percentAboveAverage。
当用户询问“为什么这个故事是榜首”时，答案是结构化数据；Agent可对其进行组合使用。
bash
```
digg-pp-cli evidence iq7usf9e --json
```
sentiment
— 读取集群在指定时间窗口内的正面情绪比率（pos6h、pos12h、pos24h、posLast）。
告知Agent某故事的讨论氛围是否仍为正面，或已转向负面；在引用故事前非常有用。
bash
```
digg-pp-cli sentiment iq7usf9e --window 6h --json
```

HTTP Transport

HTTP传输

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

本CLI使用兼容Chrome的HTTP传输访问面向浏览器的端点。正常API调用不需要常驻浏览器进程。

Command Reference

命令参考

feed — Top-level AI story feed (HTML page; CLI parses the embedded RSC stream)

```
digg-pp-cli feed raw
```
— Fetch the raw /ai HTML page. The CLI's sync command parses this; most users should run
```
sync
```
then
```
top
```
instead of...
```
digg-pp-cli feed story_raw
```
— Fetch the raw /ai/{clusterUrlId} story detail page (HTML). The CLI's
```
story
```
command parses this; users should not...

search — Topic search across the full Digg window

digg-pp-cli search "<query>"

— Live by default (

/api/search/stories

); FTS5 fallback to the local store. Flags:

--since Nh|Nd|Nw|Nm

--data-source live|local|auto

--limit

authors — Inspect the Digg AI 1000 leaderboard

```
digg-pp-cli authors get <handle>
```
— Look up any X handle (1000 + off-1000); off-1000 records include
```
subject_peer_follow_count
```
,
```
nearest_in_1000
```
anchor, and
```
peer_follow_gap
```
. Flag:
```
--limit
```
(fuzzy fallback).

digg-pp-cli authors list

— Full ranked AI 1000 from

/ai/1000

, persisted with rich fields. Flags:

--by rank|rankChange|category|followers

--category

--only-new

--only-fallers

--limit

```
digg-pp-cli authors top
```
— Top contributors by influence, post count, or reach. Flags:
```
--by
```
,
```
--limit
```
.

posts — X posts attached to one cluster

```
digg-pp-cli posts <clusterUrlId>
```
— Origins, replies, quotes, retweets with author rank, body when rendered, media URLs, minted xUrl. Flags:
```
--by rank|type|time
```
,
```
--type tweet|reply|quote|retweet
```
,
```
--limit
```
,
```
--no-cache
```
.

story — Full cluster detail. Envelope now includes

posts

and

postsMeta

fields populated by the U5 RSC parser.

trending — Public ingestion-pipeline status and event stream

```
digg-pp-cli trending
```
— Read the current pipeline status: storiesToday, clustersToday, isFetching, nextFetchAt, and the recent event stream...

feed — 顶级AI故事信息流（HTML页面；CLI解析嵌入的RSC流）

```
digg-pp-cli feed raw
```
— 获取原始
```
/ai
```
HTML页面。CLI的sync命令会解析该页面；大多数用户应运行
```
sync
```
然后
```
top
```
，而非直接使用此命令……
```
digg-pp-cli feed story_raw
```
— 获取原始
```
/ai/{clusterUrlId}
```
故事详情页面（HTML）。CLI的
```
story
```
命令会解析该页面；用户无需直接使用此命令……

search — 在Digg完整时间范围内进行主题搜索

digg-pp-cli search "<query>"

— 默认使用实时模式（

/api/search/stories

）；回退到本地存储的FTS5搜索。支持参数：

--since Nh|Nd|Nw|Nm

、

--data-source live|local|auto

、

--limit

。

authors — 查看Digg AI 1000排行榜

```
digg-pp-cli authors get <handle>
```
— 查询任意X账号（核心+非核心）；非核心账号记录包含
```
subject_peer_follow_count
```
、
```
nearest_in_1000
```
基准账号和
```
peer_follow_gap
```
。支持参数：
```
--limit
```
（模糊匹配回退）。

digg-pp-cli authors list

— 从

/ai/1000

获取完整的AI 1000排名列表，并持久化存储丰富字段。支持参数：

--by rank|rankChange|category|followers

、

--category

、

--only-new

、

--only-fallers

、

--limit

。

```
digg-pp-cli authors top
```
— 按影响力、帖子数量或覆盖范围排名的顶级贡献者。支持参数：
```
--by
```
、
```
--limit
```
。

posts — 关联到单个集群的X帖子

```
digg-pp-cli posts <clusterUrlId>
```
— 原创帖、回复、引用、转发，包含作者排名、渲染后的正文、媒体URL、专属xUrl。支持参数：
```
--by rank|type|time
```
、
```
--type tweet|reply|quote|retweet
```
、
```
--limit
```
、
```
--no-cache
```
。

story — 完整集群详情。信封现在包含由U5 RSC解析器填充的

posts

和

postsMeta

字段。

trending — 公开的ingestion流水线状态和事件流

```
digg-pp-cli trending
```
— 读取当前流水线状态：storiesToday、clustersToday、isFetching、nextFetchAt，以及最近的事件流……

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:

bash

digg-pp-cli which "<capability in your own words>"

which

resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当您知道要做什么但不知道对应命令时，可直接询问CLI：

bash

digg-pp-cli which "<用您自己的语言描述功能>"

which

会将自然语言功能查询解析为CLI精选功能索引中最匹配的命令。退出码

表示至少有一个匹配项；退出码

表示没有确定的匹配项——请回退到

--help

或使用更具体的查询。

Recipes

使用示例

Topic search for research workflows

研究工作流的主题搜索

bash

digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge

Server-side search across Digg's full window via

/api/search/stories

; returns ranked clusters with engagement metadata (postCount, uniqueAuthors, firstPostAge). The load-bearing recipe for last30days-style consumers — pair with

posts

for citations.

bash

digg-pp-cli search "<topic>" --since 30d --agent --select clusterUrlId,title,rank,postCount,uniqueAuthors,firstPostAge

通过

/api/search/stories

在Digg完整时间范围内进行服务器端搜索；返回包含互动元数据（postCount、uniqueAuthors、firstPostAge）的排名集群。这是支持近30天研究工作流的核心命令——可与

posts

配合使用以获取引用内容。

Author credibility lookup (in or out of the 1000)

作者可信度查询（核心/非核心账号）

bash

digg-pp-cli authors get <handle> --agent

Resolves any X handle to a structured record. For an off-1000 handle like

mvanhorn

, the response includes

subject_peer_follow_count: 19

nearest_in_1000.peer_follow_count: 90

, and

peer_follow_gap: 71

peer_follow_gap

is the distance to rank-1000 measured in AI-1000 peer follows (the metric Digg actually ranks by) — NOT a raw X follower-count delta.

bash

digg-pp-cli authors get <handle> --agent

将任意X账号解析为结构化记录。对于非核心账号如

mvanhorn

，响应包含

subject_peer_follow_count: 19

、

nearest_in_1000.peer_follow_count: 90

和

peer_follow_gap: 71

。

peer_follow_gap

是与排名1000账号的AI 1000核心账号关注数差距（Digg实际使用的排名指标）——不是X平台原始粉丝数的差值。

Roster browse: biggest movers and newly listed

排行榜浏览：排名变化最大和新上榜账号

bash

undefined

bash

undefined

Biggest movers since the last snapshot

上次快照以来排名变化最大的账号

digg-pp-cli authors list --by rankChange --limit 20 --agent

Newly listed (first appearance in the 1000)

新上榜账号（首次进入1000榜单）

digg-pp-cli authors list --only-new --agent


Identify rising voices in a category, find authors who just joined the 1000. Sort with `--by rank|rankChange|category|followers`; filter with `--category`, `--only-new`, `--only-fallers`.

digg-pp-cli authors list --only-new --agent


识别某一分类中的新兴账号、找到刚加入1000榜单的作者。使用`--by rank|rankChange|category|followers`进行排序；使用`--category`、`--only-new`、`--only-fallers`进行筛选。

每篇文章的顶级评论（引用）

bash

digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body

Surfaces the highest-credibility AI 1000 voices on a story; minted X URLs make citations one-click. Combine with

search

to go from topic → cluster → quotable posts in two commands.

bash

digg-pp-cli posts <clusterUrlId> --by rank --limit 5 --agent --select author.username,author.rank,post_type,xUrl,body

展示某一故事中可信度最高的AI 1000账号内容；专属X URL支持一键引用。结合

search

命令，可通过两步操作从主题→集群→可引用帖子。

What climbed >=10 ranks in the last hour

过去一小时内排名上升≥10的内容

bash

digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank

Reads the public events stream, filters to fast-climb events only, and narrows the JSON to the five fields an agent actually needs.

bash

digg-pp-cli events --since 1h --type fast_climb --json --select clusterId,label,delta,currentRank,previousRank

读取公开事件流，仅筛选快速上升事件，并将JSON结果精简为Agent实际需要的五个字段。

Why is a story the top story

为什么某故事是榜首

bash

digg-pp-cli evidence 65idu2x5 --json

Print the scoreComponents and evidence array for one cluster. Get a clusterUrlId from

digg-pp-cli top --json --select clusterUrlId

bash

digg-pp-cli evidence 65idu2x5 --json

打印单个集群的scoreComponents和evidence数组。可通过

digg-pp-cli top --json --select clusterUrlId

获取clusterUrlId。

Show every cluster a given X account contributed to this week

展示某X账号本周贡献的所有集群

bash

digg-pp-cli author Scobleizer --since 7d --json --select label,clusterUrlId,activityAt

Queries the local store for clusters where the named author was a contributor; output is narrowed for agent consumption.

bash

digg-pp-cli author Scobleizer --since 7d --json --select label,clusterUrlId,activityAt

查询本地存储中指定作者贡献的集群；输出已精简以适配Agent使用。

Cross-reference a story across HN and Techmeme

跨HN和Techmeme交叉引用故事

bash

digg-pp-cli crossref 65idu2x5

Uses Digg's own hackerNews/techmeme reference fields so you don't have to search those sites manually. Pass any clusterUrlId from

top --json --select clusterUrlId

bash

digg-pp-cli crossref 65idu2x5

使用Digg自身的hackerNews/techmeme参考字段，无需手动搜索这些平台。传入从

top --json --select clusterUrlId

获取的任意clusterUrlId即可。

Tail the pipeline live

实时追踪流水线

bash

digg-pp-cli pipeline status --watch

One-screen dashboard of isFetching, nextFetchAt, storiesToday, clustersToday, and the last few pipeline events.

bash

digg-pp-cli pipeline status --watch

单屏仪表盘展示isFetching、nextFetchAt、storiesToday、clustersToday以及最近几个流水线事件。

Auth Setup

认证设置

No authentication required.

Run

digg-pp-cli doctor

to verify setup.

无需认证。

运行

digg-pp-cli doctor

验证设置。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
digg-pp-cli feed raw --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

在任意命令后添加

--agent

。等效于：

--json --compact --no-input --no-color --yes

。

可管道化 — stdout输出JSON，stderr输出错误信息
可筛选 —
```
--select
```
保留字段子集。点路径可深入嵌套结构；数组可遍历元素。对于冗长的API，这是保持上下文精简的关键：
bash
```
digg-pp-cli feed raw --agent --select id,name,status
```
可预览 —
```
--dry-run
```
显示请求但不发送
离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
非交互式 — 从不提示，所有输入均为参数
只读 — 请勿使用本CLI执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送或其他修改状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令会将输出包装在来源信封中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

获取数据，

.meta.source

可了解数据是实时还是本地的。仅当stdout为终端时，才会向stderr打印人类可读的

N results (live)

摘要——管道/Agent消费者仅会在stdout获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

digg-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
digg-pp-cli feedback --stdin < notes.txt
digg-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.digg-pp-cli/feedback.jsonl

. They are never POSTed unless

DIGG_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

DIGG_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当您（或Agent）发现本CLI存在问题时，请记录：

digg-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
digg-pp-cli feedback --stdin < notes.txt
digg-pp-cli feedback list --json --limit 10

反馈条目存储在本地

~/.digg-pp-cli/feedback.jsonl

中。除非设置了

DIGG_FEEDBACK_ENDPOINT

且传递了

--send

或设置

DIGG_FEEDBACK_AUTO_SEND=true

，否则绝不会POST到服务器。默认行为仅存储在本地。

请记录让您感到意外的内容，而非提交bug报告。简短、具体、单行描述：这样的反馈才更有价值。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

所有命令均支持

--deliver <sink>

。输出会发送到指定的sink，同时（或替代）输出到stdout，以便Agent无需手动管道即可路由命令结果。支持三种sink：

Sink	效果
`stdout`	默认；仅输出到stdout
`file:<path>`	原子性地将输出写入 `<path>` （临时文件+重命名）
`webhook:<url>`	将输出体POST到指定URL（ `application/json` 格式；使用 `--compact` 时为 `application/x-ndjson` 格式）

未知格式会被拒绝，并返回包含支持格式的结构化错误。Webhook失败时返回非零退出码，并在stderr记录URL和HTTP状态。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

digg-pp-cli profile save briefing --json
digg-pp-cli --profile briefing feed raw
digg-pp-cli profile list --json
digg-pp-cli profile show briefing
digg-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的参数值，可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时，可使用此功能——即HeyGen的“Beacon”模式。

digg-pp-cli profile save briefing --json
digg-pp-cli --profile briefing feed raw
digg-pp-cli profile list --json
digg-pp-cli profile show briefing
digg-pp-cli profile delete briefing --yes

显式参数始终优先于配置文件值；配置文件值优先于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，以便自省Agent在运行时发现它们。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

代码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
5	API错误（上游问题）
7	速率限制（等待后重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
digg-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
digg-pp-cli --help
```
输出
以
install
开头 → 结尾为
```
mcp
```
→ MCP安装；否则 → 参见上方前置条件
其他内容 → 直接使用（添加
```
--agent
```
参数执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

bash

claude mcp add digg-pp-mcp -- digg-pp-mcp

Verify:

claude mcp list

从本CLI的已发布公共库条目或预构建版本安装MCP二进制文件，然后注册：

bash

claude mcp add digg-pp-mcp -- digg-pp-mcp

验证：

claude mcp list

Direct Use

直接使用

Check if installed:
```
which digg-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

digg-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
digg-pp-cli <command> --help
```
.

检查是否安装：
```
which digg-pp-cli
```
如果未找到，提供安装选项（参见顶部前置条件）。
将用户查询与上方独特功能和命令参考中的最佳命令匹配。

添加

--agent

参数执行：

bash

digg-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
digg-pp-cli <command> --help
```
。

pp-digg

Original

Translation

Digg AI — Printing Press CLI

Digg AI — Printing Press CLI

Prerequisites: Install the CLI

前置条件：安装CLI

When to Use This CLI

何时使用本CLI

When Not to Use This CLI

何时不使用本CLI

Unique Capabilities

独特功能

Topic search and per-post citations

主题搜索与单帖引用

Author lookup and roster browse

作者查询与排行榜浏览

Live pipeline observability

实时流水线监控

Local state that compounds

可累积的本地状态

Transparency

透明度

HTTP Transport

HTTP传输

Command Reference

命令参考

Finding the right command

查找合适的命令

Recipes

使用示例

Topic search for research workflows

研究工作流的主题搜索

Author credibility lookup (in or out of the 1000)

作者可信度查询（核心/非核心账号）

Roster browse: biggest movers and newly listed

排行榜浏览：排名变化最大和新上榜账号

Biggest movers since the last snapshot

上次快照以来排名变化最大的账号

Newly listed (first appearance in the 1000)

新上榜账号（首次进入1000榜单）

Top comments per article (citations)

每篇文章的顶级评论（引用）

What climbed >=10 ranks in the last hour

过去一小时内排名上升≥10的内容

Why is a story the top story

为什么某故事是榜首

Show every cluster a given X account contributed to this week

展示某X账号本周贡献的所有集群

Cross-reference a story across HN and Techmeme

跨HN和Techmeme交叉引用故事

Tail the pipeline live

实时追踪流水线

Auth Setup

认证设置

Agent Mode

Agent模式

Response envelope

响应信封

Agent Feedback

Agent反馈

Output Delivery

输出交付

Named Profiles

命名配置文件

Exit Codes

退出码

Argument Parsing

参数解析

MCP Server Installation

MCP服务器安装

Direct Use

直接使用