农大门户(cau-portal)
给中国农业大学学生用的 DeepSeek Harness(DSH)插件与数据管道:自动抓取学院/学校通知公告,AI 生成摘要/分类/重要度/截止日期,在 DSH 侧边栏面板浏览,并可在对话中直接查询(MCP 工具)。
本项目只开源工具本身:数据由每位使用者自己收集、自己保管,不作为工具服务的一部分。校内数据版权归学校所有,公开页面信息仅作个人学习使用(见文末免责声明)。
维护者:@ZBber-lab · 欢迎提 Issue / 建议
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
给中国农业大学学生用的 DeepSeek Harness(DSH)插件与数据管道:自动抓取学院/学校通知公告,AI 生成摘要/分类/重要度/截止日期,在 DSH 侧边栏面板浏览,并可在对话中直接查询(MCP 工具)。
本项目只开源工具本身:数据由每位使用者自己收集、自己保管,不作为工具服务的一部分。校内数据版权归学校所有,公开页面信息仅作个人学习使用(见文末免责声明)。
维护者:@ZBber-lab · 欢迎提 Issue / 建议
农大门户(cau-portal):中国农业大学通知公告 DSH 插件 + 爬虫/AI 加工管道(开源工具,数据由使用者自建)
tools/scraper/probe.mjs 探测站点结构并报告「能直接接 / 需写解析器 / 接不了」,你确认后才写进 sites.jsonsites.json 数据驱动,内置博达 boda(/col/col<栏目号>/index.html + dataproxy 翻页)、苏迪 sudy(/<栏目号>/list.htm + /<年>/<月日>/c<a>/page.htm)与校新闻网自研 news-custom 三类解析器;node tools/scraper/probe.mjs <网址> 可探测目标站(判定 CMS、列出可用栏目、给出现成的 sites.json 片段),因此也能接入其他院校/院系的公开栏目┌─────────────┐ GitHub Contents API / 代理 ┌──────────────────┐
│ DSH 浏览器 │ ──────────────────────────────▶ │ 你的数据仓库 │
│ 侧边栏面板 │ │ data/ │
│ (插件) │ │ ├ index.json │
└──────┬──────┘ │ ├ feed/ 栏目列表 │
│ │ ├ articles/ 全文 │
┌──────▼──────┐ MCP(stdio) │ └ usage.jsonl │
│ 对话查询 │ ──────────────────────────────▶ └──────────────────┘
│ mcp__cau__*│
└─────────────┘
▲
│ 工具代码公开;数据各自收集
┌───────┴────────────────────────────────────────┐
│ 爬虫管道 tools/scraper(本仓库,公开) │
│ 抓取 → AI 加工 → 提交到**你自己的**数据仓库 │
└────────────────────────────────────────────────┘
数据流:爬虫抓取公开网页 → AI 加工(DeepSeek API)→ 产物提交到你的数据仓库 data/ → 插件与 MCP 读取展示。数据仓库与你绑定,与工具代码解耦。
deepseek-v4-flash 等)安全:这些 key/令牌只服务于你自己的数据与调度;除调度桥的令牌需填入 cron-job.org(第三方)外,其余凭据只存本机。
桌面版(官方已发布,推荐这条):在 DSH 侧边栏点「插件」→「添加插件」,把下面这段填进去:
github:ZBber-lab/cau-portal-open
装完一定要点「立即启用」 —— 直接关掉对话框=已安装但未启用,侧边栏不会出现「农大门户」入口。
有 dsh 命令的环境(web / CLI;桌面版安装目录默认不提供这个命令,它打包在应用内部但没加进 PATH):
dsh plugin --profile desktop add "github:ZBber-lab/cau-portal-open" # 桌面版的 profile 是 desktop
dsh plugin --profile web add "github:ZBber-lab/cau-portal-open" # 老的 web / CLI 环境
⚠️ profile 别填错:桌面版读
profiles/desktop,web/CLI 读profiles/web。装错 profile 的症状是「显示安装成功,但界面上什么都不出现」。拿不准就先看现有插件装在哪个 profile ——~/.dsh/profiles/<名字>/node_modules/下有cau-portal的那个就是(设了DSH_HOME的话把~/.dsh换成它)。 ⚠️ 第三方插件暂不支持自动更新:升级要先在「插件」页卸载、再安装新版(直接再装一次不会覆盖旧版)。
(这是官方仓库;若你 fork 了自己的一份,把地址换成你自己的 github:你的用户名/仓库名。安装后侧边栏出现「农大门户」入口。)
data/ 目录(可先留空,管道会自动生成内容)。打开 DSH 侧边栏 →「设置」:
yourname/cau-data)—— 填一次即可:
保存后面板会把它同步到本机共享存储(<profile>\cau-portal-store\config.json),对话里的 MCP 用同一个仓(v0.5.4 起不必再在配置文件里写 CAU_GITHUB_REPO);管道代码在工具仓里,产物要写进你的数据仓 —— 所以两个仓都克隆到本地(工具仓只用来跑,数据仓才是你提交的地方):
git clone https://github.com/ZBber-lab/cau-portal-open # 工具(只读用)
git clone https://github.com/<你>/<数据仓> # 你的数据仓
cd cau-portal-open
# 抓取 + AI 加工:用 --data-dir 指定产物写进你的数据仓
node tools/scraper/crawl.mjs --data-dir ../<数据仓>/data --pages 2 --articles 8
DEEPSEEK_API_KEY=sk-... node tools/scraper/enrich.mjs --data-dir ../<数据仓>/data --limit 8
Windows PowerShell 用户:
$env:DEEPSEEK_API_KEY='sk-...'; node tools/scraper/enrich.mjs --data-dir ..\<数据仓>\data --limit 8(DEEPSEEK_API_KEY=... node ...是 macOS/Linux 语法)。 为什么要--data-dir:不加就会写进工具仓目录;指定后爬虫只写你自己的数据仓,工具仓保持干净,也不会误把数据提交到工具仓。
产物在 <数据仓>/data/:index.json(目录与统计)/ feed/<site>__<column>.json(栏目列表)/ articles/<sha1>.json(全文 + AI 元数据)/ usage.jsonl(用量账本)。然后在你的数据仓里提交:
cd ../<数据仓> && git add data && git commit -m "data: first crawl" && git push
插件即可读到数据(面板会自动刷新)。
只把一个文件复制到你自己的数据仓库:.github/workflows/crawl.yml,再配置仓库 Secret DEEPSEEK_API_KEY(AI 加工用;缺省时抓取照常、AI 加工跳过)。
这个 workflow 会先 checkout 你的数据仓,再临时把公开的工具仓取到 .cau-tools/ 跑爬虫,用 --data-dir ./data 把产物写回你的数据仓。因此:
data/,不含任何工具代码 —— 数据始终由你自己保管;tools/,工具升级你自动跟上;sites.json 放在数据仓根,并在 workflow 的两条命令里各加 --sites ./sites.json(爬虫本来就支持这个参数;不加就用工具仓里的默认配置)。本 workflow 用 workflow_dispatch(手动触发)而非原生 schedule,因为 GitHub 免费私有仓的 schedule 触发器不生效。要实现「每 2 小时自动」,需用外部触发器调用 Actions 的 dispatch 接口,常用 cron-job.org(免费):
POST,URL:https://api.github.com/repos/<你的用户名>/<你的数据仓>/actions/workflows/crawl.yml/dispatchesAuthorization: Bearer <第 1 步的令牌>、Accept: application/vnd.github+json{"ref":"main"}安全提醒:该调度令牌只用于触发,请只授予
Actions: Read & write一个最小权限,且不要写进任何仓库或共享给他人。
想让 AI 直接在对话里查询(如最近有什么通知、推免报名截止几号),需把 MCP 服务器接入 DSH:
cd tools/mcp && pnpm install
cordis.patch.yml 里加(@deepseek-ai/dsh-mcp-client 是 DSH 内置插件;<...> 换成你的实际路径)。路径按你那套选——桌面版:C:\Users\<你>\.dsh\profiles\desktop\cordis.patch.yml(macOS/Linux:~/.dsh/profiles/desktop/cordis.patch.yml);web / CLI:…\.dsh\profiles\web\cordis.patch.yml;若你设了 DSH_HOME,主目录就是它而不是 ~/.dsh:
- id: mcp-cau
name: '@deepseek-ai/dsh-mcp-client'
serverName: cau
transport: stdio
command: <Node 可执行文件路径,如 D:\nodejs1\node.exe>
args: [<本仓库路径>\tools\mcp\index.mjs]
cwd: <本仓库路径>\tools\mcp
env:
# 数据仓名**不必写在这里**(v0.5.4 起 MCP 直接读面板「设置 → 数据源」写下的那份);
# 只想临时换仓时才用这行覆盖:
# CAU_GITHUB_REPO: <你的数据仓,owner/repo>
# 若你设了 DSH_HOME(数据目录不在 ~/.dsh),这行必须带上,否则 MCP 找不到令牌:
# DSH_HOME: <你的 DSH 主目录>
数据仓名不用在这里再写一次(v0.5.4 起):MCP 每次调用现读本机共享存储里的
<profile>\cau-portal-store\config.json —— 也就是面板「设置 → 数据源」填的那一份,改完不必重启 DSH。
CAU_GITHUB_REPO 仅在想临时覆盖时使用(优先级最高)。
不需要在配置里写令牌 —— MCP 服务器会自动读面板设置页写下的那份(见下)。
(如果你确实想用环境变量覆盖,加 env: { CAU_GITHUB_TOKEN: <令牌> } 即可,它的优先级最高。)<profile>\cau-portal-store\token.json),MCP 与工具脚本都读这一份 ——
以后换令牌只改这里,不用再动配置文件、也不用重启 DSH。dsh web),对话里即可使用 mcp__cau__* 工具(共 6 个:最新通知 / 检索 / 截止事项 / 站点目录 / 用量统计 / 文章详情)。说明:令牌是共用的 —— 面板设置页是唯一入口,MCP 与工具脚本都读那一份。 数据仓库名也只需要写一次(v0.5.4 起):面板「设置 → 数据源」保存后写入
<profile>\cau-portal-store\config.json, MCP 每次调用现读它(5 秒缓存,改完不用重启 DSH)。想让 MCP 暂时用别的仓,再用CAU_GITHUB_REPO覆盖。 自查办法:对话里调一次mcp__cau__list_sites,返回的data_source应显示github:<你的数据仓>@main;若显示成别的仓、或报 404,就是数据仓没配对 —— MCP 的报错里会直接写出它当前正在用哪个仓。 没配数据仓时:MCP 不会再静默去读别人的仓,而是明确提示「请先配置数据仓库(面板 设置 → 数据源)」。 找不到令牌时 MCP 会退回本地data/目录,不会静默失败:启动日志里会写明当前用的是 GitHub 还是本地。
设置 → 通知与关注 → 每日邮件报告:
[email protected])与 邮箱授权码 —— 是授权码,不是邮箱登录密码(QQ/163/Outlook 等常见服务商会被自动识别,SMTP 参数免手填);08:00);发什么:今日高重要通知 + 3 天内截止 + 命中关注规则 + 昨日回顾。若发送时间已过才开机,会自动补发。授权码只存本机(仓库外),不上传、不进日志、不显示。
面板是 DSH 官方右侧栏里的一个页面标签(入口在左侧栏底部,没有打开会话时置灰)。视图状态按会话各记一份(切走再切回来还停在你上次看的那一页),不跨会话跟随。
面板底栏:左侧圆点 + 时间显示云端数据新鲜度 —— 超过 4 小时变黄、超过 24 小时变红;悬停能看到原因(例如「可能上一轮抓取失败或定时任务没触发」)。面板开着时「已 N 小时」会自己往前走。正常每 2 小时一轮。
设置首页是三组卡片(智能与数据 / 通知与关注 / 面板行为),顶部有提醒条(红=基本需求没满足,黄=提醒)。功能卡(AI / 数据源 / 待办 / 引用协同 / 邮件)在首页就有总开关;凭据卡(令牌 / 门户账号,淡底)没有开关,只显示状态。
sites.json 中面向公开页面进行抓取。├── src/ # 插件源码(服务端路由 + 客户端面板)
├── lib/ # 构建产物(随包发布)
├── tools/
│ ├── scraper/ # 爬虫 + AI 加工管道(零重型依赖,Node fetch 手写解析)
│ ├── mcp/ # MCP 服务器(6 个查询工具;需 pnpm install + cordis 注册,见快速开始第 6 步)
│ ├── email/ # 每日邮件报告(SMTP;授权码只存本机,见第 7 步)
│ └── shared/ # 本机令牌共享存储的读取
├── assets/preview.html # 面板 UI 的开发预览页(仓库不含官方校徽、校名素材)
├── sites.json # 站点/栏目配置(数据驱动,可自行增改)
├── docs/AI-SETUP-GUIDE.md# 给 AI agent 的配置指南(见下)
└── .github/workflows/ # Actions 定时抓取模板
站点/栏目是数据驱动的(sites.json):默认内置 4 个公开来源 —— 中国农业大学土地科学与技术学院 / 教务处 / 校新闻网 / 校团委;想适配其他院校或栏目,改 sites.json 即可。
不含「统一门户」:那是校内需要登录的信息平台(
one.cau.edu.cn),开源版不提供抓取(既不抓取、也不含相关代码)—— 面板里该来源会标「不可用」。设置 → 数据源 里那个「统一门户」开关同样只对维护版有意义。
本项目同时提供 docs/AI-SETUP-GUIDE.md——写给 DSH 里的 AI agent 看的配置指南:把本文件路径发给 AI,或让用户把文件内容贴给 AI,AI 就能按步骤指导用户完成完整配置(安装 → 令牌 → 数据源 → 跑管道 → 验证)。
见 LICENSE。
农大门户(cau-portal):中国农业大学通知公告 DSH 插件 + 爬虫/AI 加工管道(开源工具,数据由使用者自建)
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Cau Portal Open stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। 农大门户(cau-portal):中国农业大学通知公告 DSH 插件 + 爬虫/AI 加工管道(开源工具,数据由使用者自建)