农大门户(cau-portal)
给中国农业大学学生用的 DeepSeek Harness(DSH)插件与数据管道:自动抓取学院/学校通知公告,AI 生成摘要/分类/重要度/截止日期,在 DSH 侧边栏面板浏览,并可在对话中直接查询(MCP 工具)。
本项目只开源工具本身:数据由每位使用者自己收集、自己保管,不作为工具服务的一部分。校内数据版权归学校所有,公开页面信息仅作个人学习使用(见文末免责声明)。
维护者:@ZBber-lab · 欢迎提 Issue / 建议
Усильте агента
Установка от издателя. Не эндпоинт 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
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Cau Portal Open работает локально через stdio.
Последняя проверка: 2026-10-28. 农大门户(cau-portal):中国农业大学通知公告 DSH 插件 + 爬虫/AI 加工管道(开源工具,数据由使用者自建)