DeepSeek Harness plugin

dsh-journal-monitor

经管期刊/工作论文监控推送插件(经济学垂直):arXiv 多类目 API + NBER RSS + 中文经管期刊(世界经济/中国农村观察/财贸经济/中国人口科学/经济管理)抓取 → 关键词过滤 → dry-run/Webhook 推送(含本地 mock 集成测试)→ 去重持久化 → 定时简报(schedule_create 协议端到端验证)→ 运行时自定义源。含真实 dsh-tools

Jump to install

Source facts

Repository
SIMON-WORLD/dsh-journal-monitor
Latest update
Aug 17, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/SIMON-WORLD/dsh-journal-monitor
Plugin: dsh-journal-monitor
Author: SIMON-WORLD

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-journal-monitor — 经管期刊/工作论文监控推送插件

> 让 DeepSeek Harness (dsh) 帮你盯着 NBER / arXiv 经济学的新论文:抓取 → 关键词过滤 → 推送(Bark/飞书/Dry-run)→ 去重持久化 → 定时简报。

![MIT License](LICENSE) ![PRs Welcome](CONTRIBUTING.md) ![dsh-plugin](https://github.com/topics/dsh-plugin)

> ⚠️ 状态(诚实声明):v1.1.0 = 可用原型。已实现并实测:多源抓取(NBER 42 条 ✓ + arXiv 三类目各 10 条 ✓ + 5 个中文经管期刊源 123 条 ✓)、关键词过滤(✓ 单测)、工具注册(7 工具 ✓)、推送链路端到端(✓ 本地 mock 服务器 5 集成测试)、去重持久化(✓)、定时简报 schedule_create 协议端到端(✓ 真实 dsh-schedule API 6 用例)插件树加载探针(✓ 真实 dsh-tools API)运行时自定义源(✓ journal_add_source/journal_list_sources)未实现:真实 Bark/飞书推送(代码+链路已验证,需真实 webhook 最终确认)、Web/UI 端到端验收、定时调度会话内执行(协议已验证,执行需 API key 会话)。

为什么是真插件,不是 skill

Skill本插件
抓取 RSS❌ 只能教你怎么抓✅ 真代码 journal_scan 直接抓
定时推送❌ 做不到✅ 计划接 dsh-schedule(every/at)
去重持久化❌ 做不到✅ 状态文件 JSONL 去重
关键词过滤文本建议journal_filter 真过滤

安装

# 方式一:装进现有 profile
dsh plugin --profile web add git+https://github.com/SIMON-WORLD/dsh-journal-monitor.git

# 方式二:headless
dsh plugin --profile headless add git+https://github.com/SIMON-WORLD/dsh-journal-monitor.git

重启 dsh 后,模型自动获得 4 个工具:journal_scan / journal_filter / journal_push / journal_status

快速使用

对话里直接说人话:

1. journal_scan(默认全部经济源:NBER + arXiv econ.GN/EM/TH + q-fin.GN + 世界经济×2 + 中国农村观察 + 财贸经济 + 中国人口科学;可传 source 指定单个源,或 sourceUrl 抓任意 RSS) 2. journal_filter(关键词如 ["china","trade","labor","did"],标题+摘要子串匹配,大小写不敏感) 3. journal_push(默认 dry-run 只记录;配 webhook 后真实推送) 4. journal_status(已推送记录 + 去重依据) 5. 定时journal_briefing(生成 schedule_create 参数 + 监控提示词,配合内置 dsh-schedule 每日/每周自动跑) 6. 自定义源journal_add_source(会话内注册 RSS/arXiv/CN 源)+ journal_list_sources(查看全部源)

用 journal_scan 抓最新 NBER 论文,用 journal_filter 筛出含 "china" 或 "trade" 的,
再用 journal_push 推送(dry-run),最后 journal_status 看看记录。
想每天自动跑:journal_briefing(topic="中国贸易", interval_days=1) 然后用返回的 every_seconds 建 schedule_create。
想监控其他期刊:journal_add_source(id="my-journal", url="https://example.com/feed.xml", kind="rss")

真实推送配置

环境变量说明
DSH_BARK_URLBark 推送 URL(例 https://api.day.app/TOKEN/),设置即启用
DSH_FEISHU_URL飞书机器人 webhook,设置即启用
DSH_JOURNAL_STATE状态文件路径(默认 <workspace>/.dsh-journal-monitor/state.jsonl
DSH_WORKSPACE工作区根(dsh 自动注入)

工具说明

journal_scan

  • 内置源:NBER Working Papers(RSS)、arXiv 经济类目(API:econ.GN / econ.EM / econ.TH / q-fin.GN)、《世界经济》online_first(中文经管)+ 当期目录(含作者/卷期/摘要)
  • 参数:source(指定单个源)、sourceUrl(自定义 RSS/Atom)、limit(默认 20)
  • 输出:title/link/summary/date 列表

journal_filter

  • 参数:items(scan 结果)、keywords(字符串数组,子串匹配)
  • 空关键词返回原样

journal_push

  • 参数:itemsdryRun(强制 dry-run)
  • 无 webhook 时自动 dry-run(只写状态、不发消息),不会误发

journal_status

  • 参数:limit(最近 N 条,默认 10)
  • 输出:已记录总数、最近记录、状态文件路径

journal_briefing(v0.2.0 新增)

  • 参数:topic(简报主题)、interval_days(间隔天数,默认 1)
  • 输出:every_seconds + schedule_prompt,可直接传给内置 schedule_create 建立定时监控

journal_add_source(v1.0.0 新增)

  • 参数:id(源唯一 id)、url(RSS/CN 平台 URL)、kind(rss/arxiv/cn-toc/ajcass)、label(显示名)
  • 会话内有效(重启失效);重复 id / 非法 id / 缺 url 会校验拒绝

journal_list_sources(v1.0.0 新增)

  • 列出全部监控源(内置 + 自定义),含 id/类型/URL

最小闭环(scan → plan → apply → verify)

scan(抓 RSS/API/CN 目录)→ filter(plan:关键词筛选)→ push(apply:推送)→ status(verify:查状态)→ 状态文件(rollback:删除行即可回滚)→ briefing(schedule_create 定时)→ add_source(自定义源扩展)

开发与验证(门禁)

npm install          # devDeps: typescript + @deepseek-ai/* 类型
npm run check        # typecheck(erasable-only TS)
npm run build        # tsc 构建到 lib/
npm test             # 单测(parseFeed/filterItems/itemId,6 用例)

门禁清单(达到才可发版)

  • [x] typecheck 通过(erasableSyntaxOnly)
  • [x] 单测 + 集成测试 29/29 通过(含推送链路 mock + registerSource 校验 + 路径式 href)
  • [x] 真实抓取验证:NBER RSS 42 条、arXiv econ.GN/EM/q-fin.GN 各 10 条、5 中文经管源 123 条(世界经济 15 / 农村观察 41 / 财贸 10 / 人口科学 42 / 经济管理 15)
  • [x] 插件契约:name/inject/apply + cordis.patch.yml + dsh.bundle 完整
  • [x] 工具注册:7 工具注册成功(真实 dsh-tools API)
  • [x] 插件树加载探针:scripts/probe-embed.mjs(真实 dsh-tools 端到端,已入 CI)
  • [x] 推送链路端到端:Bark GET / 飞书 POST / dry-run / 去重(本地 mock 服务器)
  • [x] 定时调度协议端到端:scripts/probe-schedule.mjs(真实 dsh-schedule API,6 用例,已入 CI)
  • [x] 运行时自定义源:journal_add_source/journal_list_sources(端到端实测)
  • [ ] 真实 Bark/飞书推送最终确认(需真实 webhook)
  • [ ] CI 全绿(仓库已建,CI 自动跑)
  • [ ] Web/UI 端到端验收
  • [ ] 定时调度会话内实际执行(需 API key + dsh 会话实测)

路线图(不铺开,逐个门禁)

  • [x] v0.1.0:抓取/过滤/推送/去重闭环原型
  • [x] v0.2.0:arXiv 多类目 API + 定时简报参数生成(并入 schedule-briefing 能力)
  • [x] v0.3.0:中文经管期刊源(《世界经济》online_first)——经济学垂直差异化
  • [x] v0.4.0:插件树加载探针(真实 dsh-tools API,入 CI)
  • [x] v0.5.0:《世界经济》当期目录源(含作者/卷期/摘要全文解析)
  • [x] v0.6.0:《中国农村观察》(ajcass 平台)
  • [x] v0.7.0:推送链路端到端验证(本地 mock 服务器)
  • [x] v0.8.0:定时调度协议端到端(真实 dsh-schedule API)
  • [x] v0.9.0:《财贸经济》《中国人口科学》(ajcass v2 版式 + 截断标题去重)
  • [x] v1.0.0:运行时自定义源(journal_add_source/list_sources,7 工具)
  • [x] v1.1.0:《经济管理》(ajcass 路径式 href)——5 中文经管源 123 条
  • [ ] v1.2.0:真实 webhook 最终确认 + 定时调度会话内执行
  • [ ] v1.3.0:更多中文经管期刊(管理世界/经济研究——经 CNKI 平台需登录态,评估可行性)+ 引用核验联动

文档

  • [10-sources.md](docs/10-sources.md) — 期刊/数据源清单与扩展方法
  • [20-cn-journals.md](docs/20-cn-journals.md) — 中文经管期刊接入规划(进行中)
  • [30-push-verification.md](docs/30-push-verification.md) — 推送链路端到端验证记录(mock 服务器,含 dry-run bug 修复说明)

贡献

  • 每个 PR 对应一个真实痛点或已验证功能;写明「验证结果」。
  • 遵守 DSH 插件规范(cordis.patch.yml + defineTool + erasable TS)。
  • 本仓库与 SIMON-WORLD/dsh-toolkit 是姊妹仓库:toolkit 做通用好用化,本仓做经济学垂直。

License

MIT