awesome-student-ai-skills
"35 个大学生竞赛与立项 AI Skill 集合 | 覆盖大创/挑战杯/互联网+/国家级项目/答辩模拟等 | 零门槛即用 | Agent Skills 标准"
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 15 Nov 2026. Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/cuic19053-hue/stardust-agent with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/cuic19053-hue/stardust-agent'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/cuic19053-hue--awesome-student-ai-skills)HTML
<a href="/listings/cuic19053-hue--awesome-student-ai-skills"><img src="/api/listings/cuic19053-hue--awesome-student-ai-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 328 lines
- ---
- name: awesome-student-ai-skills
- description: "35 个大学生竞赛与立项 AI Skill 集合 | 覆盖大创/挑战杯/互联网+/国家级项目/答辩模拟等 | 零门槛即用 | Agent Skills 标准"
- ---
- # awesome-student-ai-skills(路由 v2.0)
- 本 skill 是 **路由入口**,不直接生成申报书。它的职责是:识别用户要写哪一类申报书,然后分流到对应的 35 个子 skill 之一。
- > **v2.1 升级**:已实现 35 个子 skill 1 对 1 精准映射,覆盖 9 大类;包含 `utils/` 工程化能力(dispatcher 分流决策树 / docx_common 共享样式 / school_template 学校适配 / pdf_export PDF 导出 / plagiarism_checker 查重预检 / review_simulator 评审模拟);`index.json` 机器可读索引 + `version.json` 项目元数据。
- ---
- ## 何时触发
- - 用户说"帮我写个申报书 / 申请书 / 立项书 / 申报材料 / 申报模板"——必触发,先用 `utils/dispatcher.py` 分流
- - 用户已经说了具体类型(如"国家奖学金申请书")——直接路由到对应子 skill
- - 用户给了一份空白模板或旧版申报书要改——识别类型后路由
- - 用户问"如何写 XX 申报"——回答分流逻辑后路由
- ---
- ## 路由方式
- ### 方式 1:CLI 分流(推荐)
- ```bash
- python3 utils/dispatcher.py --query "用户原话"
- # 输出:候选子 skill 列表、关键词匹配分数和加载路径
- ```
- 详见 `utils/DISPATCHER_README.md`。
- ### 方式 2:Python API 分流
- ```python
- from utils.dispatcher import Dispatcher
- d = Dispatcher()
- candidates = d.dispatch("国家级项目立项逻辑评测")
- if candidates:
- top = candidates[0]
- print(top["name"], top["score"])
- print(top["skill_md_path"])
- ```
- `dispatch()` 返回候选字典列表;未命中时返回空列表。每项包含 `name`、`score`、`matched`、`skill_md_path` 和 `build_py_path` 等字段。`score` 是整数关键词匹配分数,不是概率;加载路径相对于仓库根目录。
- ### 方式 3:手动对照下表
- 见下方 §35 个子 skill 索引。
- ---
- ## 35 个子 skill 索引(按 9 大类分组)
- > 机器可读索引:`index.json`(含 name / display_name / category / description / triggers / paths / version / line_count)
- ### §1 奖学金类(6 个)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/national-scholarship/` | 国家奖学金 | "国家奖学金""国奖""10000元"(2024 年起标准,以当年通知为准) |
- | `subskills/motivation-scholarship/` | 国家励志奖学金 | "励志""6000元""家庭经济困难"(2024 年起标准,以当年通知为准) |
- | `subskills/university-scholarship/` | 校级奖学金 | "校奖""一等奖学金" |
- | `subskills/enterprise-scholarship/` | 企业专项奖学金 | "企业奖""专项奖""华为奖" |
- | `subskills/single-scholarship/` | 单项奖学金 | "单项奖""科研单项""文体单项" |
- | `subskills/grant-application/` | 国家助学金 | "助学金""贫困生""家庭经济困难补助" |
- ### §2 评优类(6 个)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/outstanding-student/` | 优秀学生/三好学生/优秀团员 | "三好学生""优秀学生""优秀团员" |
- | `subskills/outstanding-graduate/` | 优秀毕业生 | "优秀毕业生""省优毕业生" |
- | `subskills/outstanding-cadre/` | 优秀学生干部 | "优秀班干部""优秀学生干部" |
- | `subskills/civilized-student/` | 文明大学生 | "文明大学生""文明学生" |
- | `subskills/class-collective/` | 优秀班集体 | "优秀班集体""先进班级" |
- | `subskills/outstanding-thesis/` | 优秀毕业设计/论文申报书 | "优秀毕设""毕设评优" |
- ### §3 政治类(3 个)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/youth-league-application/` | 入团申请书 | "入团""申请入团" |
- | `subskills/summary-report/` | 阶段汇报/思想汇报 | "阶段汇报""思想汇报""季度思想汇报" |
- | `subskills/youth-league-conversion/` | 转正申请书 | "转正申请书""预备党员转正""转正申请" |
- ### §4 科研类(6 个)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/national-project-eval/` | 国家级项目立项逻辑评测 | "国家级项目立项逻辑评测""国家级项目评测" |
- | `subskills/innovation-research/` | 大创·创新训练 | "大创""创新训练" |
- | `subskills/entrepreneurship-training/` | 大创·创业训练 | "创业训练""商业计划书模拟" |
- | `subskills/entrepreneurship-practice/` | 大创·创业实践 | "创业实践""实际注册公司" |
- | `subskills/university-research/` | 校级科研立项 | "校级科研""SRTP" |
- | `subskills/college-research/` | 院级科研立项 | "院级科研""院级立项" |
- ### §5 竞赛类(3 个,4209 行)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/challenge-cup/` | 挑战杯 | "挑战杯""课外学术" |
- | `subskills/internet-plus/` | 互联网+ | "互联网+""创新创业大赛" |
- | `subskills/internet-plus-red-tour/` | 互联网+红旅赛道 | "红旅""红色之旅""红色筑梦" |
- ### §6 三下乡/实践类(5 个,7870 行)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/social-survey/` | 三下乡社会调查 | "三下乡""社会调查""暑期实践" |
- | `subskills/volunteer-teaching/` | 支教 | "支教""教育帮扶" |
- | `subskills/policy-lecture/` | 政策宣讲 | "政策宣讲""理论宣讲" |
- | `subskills/tech-service/` | 科技服务 | "科技服务""科技下乡" |
- | `subskills/western-plan/` | 西部计划 | "西部计划""西部志愿" |
- ### §7 征兵/入伍类(1 个,1336 行)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/military-enlistment/` | 应征入伍申请书 | "应征入伍""大学生入伍""参军""征兵" |
- ### §8 公派留学/交流类(2 个,2759 行)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/csc-scholarship/` | CSC 国家公派留学申请书 | "CSC""公派留学""国家公派""联合培养" |
- | `subskills/exchange-program/` | 交流项目申请书 | "交流项目""交换生""校际交流" |
- ### §9 其他类(3 个,4148 行)
- | 子 skill | 中文名 | 触发关键词 |
- |----------|--------|------------|
- | `subskills/graduate-recommendation/` | 保研推免 | "保研""推免" |
- | `subskills/selected-graduate/` | 选调生申请 | "选调生""基层选调" |
- | `subskills/major-transfer/` | 转专业申请 | "转专业""专业转换" |
- **9 大类合计:6 + 6 + 3 + 6 + 3 + 5 + 1 + 2 + 3 = 35 个子 skill ✅**
- ---
- ## 类型识别决策树
- ```
- 用户要"申报 / 申请"什么?
- │
- ├─ Q1:科研立项或立项逻辑评测?
- │ ├─ Q2:大创训练计划?
- │ │ ├─ 偏学术研究 → innovation-research
- │ │ ├─ 偏商业计划(不实际运营) → entrepreneurship-training
- │ │ └─ 实际注册公司运营 → entrepreneurship-practice
- │ ├─ Q3:校级/院级科研课题?
- │ │ ├─ 校级 → university-research
- │ │ └─ 院级 → college-research
- │ └─ 国家级项目立项逻辑评测 → national-project-eval
- │
- ├─ Q4:学科竞赛?
- │ ├─ 学术科技作品 → challenge-cup
- │ ├─ 创业计划书(主赛道) → internet-plus
- │ └─ 创业计划书(红旅赛道) → internet-plus-red-tour
- │
- ├─ Q5:要荣誉?
- │ ├─ Q6:奖学金?
- │ │ ├─ 国家奖学金 10000 元 → national-scholarship
- │ │ ├─ 国家励志奖学金 6000 元,家庭经济困难 → motivation-scholarship
- │ │ ├─ 校级(一二三等) → university-scholarship
- │ │ ├─ 企业/社会捐赠 → enterprise-scholarship
- │ │ ├─ 单项(科研/社工/文体) → single-scholarship
- │ │ └─ 助学金(贫困补助,无成绩要求) → grant-application
- │ ├─ Q7:在校生学年评优?
- │ │ ├─ 三好学生/优秀学生/优秀团员 → outstanding-student
- │ │ ├─ 优秀学生干部 → outstanding-cadre
- │ │ ├─ 文明大学生 → civilized-student
- │ │ └─ 优秀班集体 → class-collective
- │ ├─ Q8:毕业生评优?
- │ │ ├─ 优秀毕业生 → outstanding-graduate
- │ │ └─ 优秀毕业设计/论文 → outstanding-thesis
- │
- ├─ Q9:政治身份?
- │ ├─ 申请入团 → youth-league-application
- │ ├─ 转正申请 → youth-league-conversion
- │ └─ 阶段汇报/思想汇报 → summary-report
- │
- ├─ Q10:三下乡/社会实践?
- │ ├─ 社会调查类 → social-survey
- │ ├─ 教育帮扶 → volunteer-teaching
- │ ├─ 政策/理论宣讲 → policy-lecture
- │ ├─ 科技服务 → tech-service
- │ └─ 西部计划(1-3 年) → western-plan
- │
- ├─ Q11:征兵入伍? → military-enlistment
- │
- ├─ Q12:公派留学/交流?
- │ ├─ CSC 国家公派(攻读博士/联合培养/硕士/访问学者) → csc-scholarship
- │ └─ 校际/院际交流项目 → exchange-program
- │
- └─ Q13:其他?
- ├─ 保研推免 → graduate-recommendation
- ├─ 选调生申请 → selected-graduate
- └─ 转专业 → major-transfer
- ```
- ---
- ## 路由流程
- 1. **识别**:根据用户原话匹配上表关键词 / 调用 `utils/dispatcher.py`
- 2. **确认**:如果不确定,列出 2~3 个候选让用户选
- 3. **移交**:明确告诉用户"正在为你调用 [子 skill 名称],它专门处理 [该类型]"
- 4. **执行**:调用子 skill 的 SKILL.md,按其工作流执行(信息采集 → 撰写 → build.py 生成 → 质检)
- 5. **质检**:字数 + 结构 + 内容 + 格式 + **AI 味检测(辅助复核)** + 可选查重/评审模拟
- > 文风检测可用 `python3 utils/ai_flavor_check.py --file draft.txt` 辅助复核;
- > 分数是启发式提示,不能单凭分数拒绝交付或编造事实。完整规范见 `docs/design/WRITING_STYLE.md`。
- ---
- ## 工程化能力(utils/)
- `utils/` 目录提供 7 大工程化能力,所有子 skill 共享:
- | 模块 | 行数 | 功能 | 文档 |
- |------|------|------|------|
- | `dispatcher.py` | 837 | 5 级决策树分流 + 关键词匹配 + 交互式 CLI | `DISPATCHER_README.md` |
- | `docx_common.py` | 897 | 共享 docx 生成工具(页边距/字体/标题/表格/落款/页码) | `DOCX_COMMON_README.md` |
- | `school_template.py` | 760 | 5 所学校格式适配(PKU/THU/WHU/ZJU/default) | `SCHOOL_README.md` |
- | `pdf_export.py` | 1036 | docx → PDF 转换(LibreOffice/docx2pdf 双引擎) | `PDF_README.md` |
- | `plagiarism_checker.py` | 742 | n-gram 查重 + 关键短语匹配 + 查重报告 | — |
- | `ai_flavor_check.py` | 620 | **AI 味检测**:6 维度量化(套话/排比/抽象词/具体性/句长/模板),0~100 分,75 分仅供参考 | `docs/design/WRITING_STYLE.md` |
- | `review_simulator.py` | 1089 | 按 review_criteria.json 模拟评审打分 + 改进建议(已含文风维度) | `REVIEW_README.md` |
- | `example_usage.py` | 303 | 完整调用示例(分流→采集→生成→质检→PDF) | — |
- 学校模板数据:`utils/schools/template_{default,pku,tsinghua,whu,zju}.json`(5 个,各 53~54 行)
- 评审标准:`utils/review_criteria.json`(字数/结构/内容/格式/政策 5 类)
- ---
- ## 通用诚实底线(所有子 skill 共享)
- 大学生申报书是面向学校 / 教育主管部门 / 党组织的正式材料,**造假会被记入档案甚至触发学籍处分**。所有子 skill 必须遵守:
- 1. **只写用户能提供证据的事实**——问"你拿过什么奖",不替用户列奖项
- 2. **不放大、不润色**——"班级第二"不能写成"成绩优异名列前茅"
- 3. **不留模糊占位**——拿不准的信息要追问,不要写"获得多项荣誉"这种空话
- 4. **提醒用户复核**——生成 docx 后必须明确提示用户:"以下内容基于你提供的信息生成,提交前请逐项核对真实性"
- 5. **禁抄袭**——不复制网络模板原文;生成后用 `utils/plagiarism_checker.py` 自检
- 6. **禁虚构**——不替用户列奖项 / 编绩点 / 虚构项目经历 / 虚构导师推荐
- 7. **禁字数不达标**——每个子 skill 规定字数区间,生成后必须核验
- ---
- ## 通用格式标准(所有子 skill 共享)
- 字体字号只是第一层。完整条款见 **[`references/layout_standard.md`](references/layout_standard.md)**:
- 13 条静态条款 + 5 条渲染条款,每条都有编号、判据、检测方式与实现手法。
- ### 基础排版
- - 纸张:A4,页边距 2.5cm(部分学校 2.54cm,详见 `utils/school_template.py`)
- - 正文:宋体小四,1.5 倍行距,首行缩进 2 字符
- - 一级标题:黑体三号,居中,段前段后 12pt
- - 二级标题:黑体小三,左对齐,段前段后 6pt
- - 三级标题:宋体四号加粗
- - 表格:宋体五号,居中
- - 英文/数字:Times New Roman
- ### 交付前必过(不可跳过)
- 生成的 `.docx` 必须通过排版审计,退出码为 `0` 才能交付:
- ```bash
- python utils/layout_audit.py <输出路径> # 18 条静态/结构条款
- python utils/layout_audit.py <输出路径> --render # 再加 5 条渲染条款(需 LibreOffice)
- ```
- - 不通过 → 按报告里每条 FAIL 的「修法」改,改完重跑,直到 `0`。
- - 确实无法修复(环境没有 LibreOffice / 装不上 pymupdf)→ 在交付说明里列出未通过的条款编号,**不得假装通过**。
- - 报告里的每条 FAIL 都值得人工复核:审计器自己也会误判(例:正则把「发表 14 篇」读成「表 14」)。
- ### 三条最容易踩的红线
- | 条款 | 典型症状 | 修法 |
- |---|---|---|
- | **L07** 表格不可拆行 | 8 行表被拆成 6+2,第二页只剩表尾没有表头 | `utils.docx_common.harden_table(t)` |
- | **L10** 图注与图同页 | 图在页底、图注跑到下一页顶部 | 图段 `keep_with_next=True` |
- | **L04** 图表引用闭环 | 全文 50 张表,正文没有一处「见表 N」 | 收尾跑 `cite_all(doc)` 全文兜底 |
- `utils/docx_common.py` 已内置这三项:`add_table()` 自动调 `harden_table()`;
- `add_figure()` 自动绑定图注;`add_review_boxes()` 生成不可拆分的三级评审意见栏;
- `add_page_number()` 生成带「共 N 页」且封面不显示的页码。
- 具体到每个类型的栏目顺序、字数要求、撰写要点,由对应子 skill 的 SKILL.md 详细规定。
- ---
- ## 与其他 skill 的协作
- - **docx skill**:实际生成 Word 文档时调用(覆盖默认排版)
- - **pdf skill**:用户要求 PDF 输出时调用(优先用 `utils/pdf_export.py`,复杂 PDF 调 pdf skill)
- - **pptx skill**:用户要求配套答辩 PPT 时调用(如挑战杯 / 互联网+ 答辩)
- - **charts skill**:申报书里要画技术路线图 / 进度甘特图 / 经费饼图时调用
- - **web-search skill**:用户要求"参考同类项目"或"查找最新政策依据"时调用
- - **xlsx skill**:用户要求经费预算表 / 成绩汇总表为 Excel 附件时调用
- ---
- ## 反模式
- - ❌ 不识别类型就直接写——会拿大创模板写奖学金申请书
- - ❌ 路由后还在本 skill 里写内容——应该完全移交给子 skill
- - ❌ 替用户编造任何可核查事实——红线
- - ❌ 字数不足不补——必须追问补信息后重写
- - ❌ 不质检就交付——必须执行字数 + 结构 + 内容 + 格式质检
- - ❌ 直接交付不附免责声明——必须提醒用户逐项核对真实性
- ---
- ## 项目元数据
- - **版本**:v2.1(详见 `version.json`)
- - **总规模**:35 个子 skill · 55317 行 SKILL.md · 44198 行 build.py · 8228 行 utils · 总计 ~108000 行
- - **机器可读索引**:`index.json`
- - **总调度 prompt**:`docs/design/AGENT_PROMPT.md`
- - **项目说明**:`README.md`
- ---
- *— SKILL.md · v2.0 · 2025-05-20 —*
README.md · README · 215 lines
- # Stardust Agent|大学生申报材料一站式工作台
- <img align="right" src="./assets/logo.png" width="72" height="72" alt="Stardust Agent">
- **大学生申报材料(申报书、申请书、商业计划书、实践报告、个人陈述)一站式工作台。**
- **Stardust Agent** 是面向大学生的开源 AI Agent 工作台,帮助整理大创申报书、挑战杯申报书、中国国际大学生创新大赛商业计划书、奖学金申请书、保研材料和三下乡实践材料。学生可以在项目中整理学校通知和已有资料,让 Agent 检索依据、协助起草,再逐章编辑并导出 Word。
- 项目提供 35 个领域指南。后端使用 Python 和 FastAPI,支持 Ollama 本地模型和 OpenAI 兼容接口。这里的覆盖指指南与赛道目录,各赛道的模型写作、模板、图表和导出支持程度不同,尚未完成全部场景的端到端验收。仓库改动不代表已经在线上部署。
- [](https://github.com/cuic19053-hue/stardust-agent/stargazers) [](./LICENSE) [](https://www.python.org/) [](https://fastapi.tiangolo.com/) [](https://modelcontextprotocol.io/) [](https://agent.stardust.website)
- [打开在线工作台](https://agent.stardust.website) · [查看大创 Word 样例](./examples/demos/demo_innovation_research.docx) · [Agent 设计说明](./docs/design/AGENT_REFACTOR.md) · [English](./README_EN.md)
- ## 快速上手
- 1. 打开 [在线工作台](https://agent.stardust.website),登录后创建项目。
- 2. 描述申报目标,上传学校通知、项目记录等材料,并核对确认提取出的信息。
- 3. 在对话中查找依据、起草内容,预览并保存章节草稿,逐章编辑后导出 Word。
- 例如,可以先问:“我想申报大创创新训练项目,课题是校园无人机巡检。请帮我梳理申报书结构,还需要准备哪些材料?”
- 在线入口无需安装 Python 或使用命令行。使用平台模型无需自备 API Key,账号额度、模型可用性与费用以工作台提示为准。未知事实应保留待补充;用户确认只代表其提供或认可了信息,不代表系统完成独立核验。
- ## 支持哪些大学生申报材料?
- | 申报场景 | 可以整理的材料 | 样例与指南 |
- | --- | --- | --- |
- | **大创与科研立项** | 大创创新训练、创业训练和校院级科研立项申报书 | [大创 Word 样例](./examples/demos/demo_innovation_research.docx) · [创新训练指南](./subskills/innovation-research/SKILL.md) |
- | **挑战杯与创新大赛** | 挑战杯申报书、大学生创新大赛(原互联网+)商业计划书 | [挑战杯样例](./examples/demos/demo_challenge_cup.docx) · [商业计划书样例](./examples/demos/demo_internet_plus.docx) |
- | **奖学金与评优** | 国家奖学金、国家励志奖学金、校级奖学金及评优申请材料 | [国家奖学金样例](./examples/demos/demo_national_scholarship.docx) · [申请指南](./subskills/national-scholarship/SKILL.md) |
- | **升学与留学** | 保研推免个人陈述、交流项目和国家公派留学申请材料 | [保研样例](./examples/demos/demo_graduate_recommendation.docx) · [推免指南](./subskills/graduate-recommendation/SKILL.md) |
- | **三下乡与社会实践** | 社会调研、支教、政策宣讲和科技服务等实践申报材料 | [社会调研指南](./subskills/social-survey/SKILL.md) |
- 样例使用示例数据,供了解材料结构和排版,不是已授权入库的真实学生范文。具体栏目、字数及提交要求请以所在学校的最新通知为准。[查看全部 35 个领域指南](./subskills/README.md) · [查看全部 Word 样例](./examples/demos/)
- ## 常见问题
- **不会编程,可以使用吗?** 可以直接使用在线工作台,按提示创建项目并填写或上传材料。本地部署和 MCP 接入面向需要自行配置环境的用户。
- **可以用自己的材料吗?** 可以上传学校通知、项目记录等资料,核对并确认提取结果后,再让 Agent 在项目资料中检索依据。现有数字、来源和完整性检查范围有限,模型仍可能遗漏、误解或编造;回答中的事实、引文及其适用性仍需要本人逐项检查。
- **需要付费或配置模型吗?** 代码按 MIT 协议开源。在线平台模型有试用额度与积分计费;使用自己的 API Key 时,费用按模型服务商规则计算。本机 Ollama 不扣工作台积分,但需自行准备运行环境。[模型与服务配置](./server/README.md)
- 当前仓库实现中,国奖基础起稿可不调用模型;明确要求字数、风格或重点经历时使用所选模型。是否已在线上提供以部署版本为准。
- ## 跟着一次工具调用读代码
- > 请查一下已确认材料,告诉我样本量和记录的观察指标。
- 测试项目里有一份已确认的观察记录。本机实测中,Qwen2.5 7B 选择了 `search_project_materials`。服务端在当前项目中检索,将命中的段落交还给模型。下面是这次回答的节选。
- > 根据已确认的观察记录,团队观察了12株番茄苗,并记录了土壤含水量和病斑面积。
- 评测会同时核对工具名和答复内容。如果回答引入记录里没有的“准确率达到 92%”,这条用例就会失败。[用例与原始材料](./server/evals/cases.json) · [评测脚本](./server/evals/run.py)
- | 工程问题 | 实现方式 | 源码 |
- | --- | --- | --- |
- | 模型怎样选工具,何时结束? | 同步答复与 SSE 流式答复共用对话循环。一轮对话最多迭代 6 次,工具调用预算为 8 次。服务端执行前再次检查工具授权,并绑定当前项目。 | [运行时](./server/proposal/chat_runtime.py) · [工具路由](./server/proposal/chat_tools.py) |
- | 回答里的材料从哪里来? | 项目资料经用户确认后分段索引。RAG 检索结合关键词和可用的同版本向量,返回来源文件和段落位置。官方通知另按学校、年度和适用范围查找。 | [项目检索](./server/proposal/retrieval.py) · [知识来源与覆盖](./docs/rag-status.md) |
- | 聊天怎样变成 Word? | 学生从对话中预览并选取章节草稿,编辑后保存。导出使用项目里已保存的正文,提交前仍可核对学校模板和引用。 | [对话草稿](./server/proposal/chat_drafts.py) · [Word 导出](./server/proposal/exporter.py) |
- | 长任务中途断开怎么办? | 启用材料 worker 后,章节生成和导出等任务按项目入队。提交使用幂等键,写回前检查项目版本,付费任务租约中断时保留记录供核对。普通聊天仍依赖当前请求,断线续传与跨设备去重尚未完整接通。 | [任务队列](./server/proposal/material_jobs.py) · [执行进程](./server/material_worker.py) |
- ## 本地运行与复现
- 需要 Python 3.11 或更高版本,并启动本机 Ollama。在终端运行以下命令。
- ```bash
- git clone https://github.com/cuic19053-hue/stardust-agent.git
- cd stardust-agent
- python3 -m venv .venv
- .venv/bin/python -m pip install -r utils/requirements.txt -r server/requirements.txt
- ollama pull qwen2.5:7b
- ollama pull bge-m3
- .venv/bin/python -m uvicorn app:app --app-dir server --host 127.0.0.1 --port 8765
- ```
- 打开本机工作台,在「模型配置」中选择 Ollama。点击「开始新对话」描述申报目标,上传并核对资料后即可提问。本机模式使用 SQLite,数据保存在 `.agent-data/`。云端使用 Supabase 按账号管理项目。平台模型使用工作台积分,自带 API Key 时按模型服务商规则计费。[本机工作台](http://127.0.0.1:8765) · [模型、存储和服务配置](./server/README.md)
- 在仓库根目录运行下面的命令,可以用本机模型复现上面的提问。脚本使用临时项目,输出实际调用的工具、答复片段和各用例的通过情况。
- ```bash
- .venv/bin/python server/evals/run.py
- ```
- ## 场景、样例与扩展
- 35 个申报场景以 Skills 形式提供领域指南。网页按选定赛道加载经过滤的指南,并支持按需分页读取该 Skill 已链接的参考资料;指南及示例不能当作官方规则或学生事实。Word 输出是供编辑核对的草稿,自动图形需要构建器支持、有效图片或节点数据及绘图依赖;数据不足或渲染失败时可能留下待补充提示,不能据此推定全部赛道图表已接通。[全部场景](./subskills/README.md) · [挑战杯样例](./examples/demos/demo_challenge_cup.docx) · [奖学金样例](./examples/demos/demo_national_scholarship.docx) · [全部 Word 样例](./examples/demos/)
- 仓库公共语料包含 **42 篇正式高校官方通知及 1 篇院级科创活动报道**,检索需匹配学校、年度与适用对象,并回源核验。**已获授权、脱敏并审核通过的真实范文当前为 0 篇**;详见 [RAG 状态说明](./docs/rag-status.md)。
- 开发者可以从 Codex、Cursor 或其他 MCP 客户端连接本机项目工具,也可以直接加载某一赛道的 `SKILL.md`。本机项目 MCP 与网页共享项目和材料,使用 stdio 启动的命令为 `.venv/bin/python server/mcp_server.py --transport stdio`。[项目 MCP 实现](./server/mcp_server.py) · [Skills 入口](./SKILL.md)
- <details>
- <summary><b>展开 35 个领域指南及文件大小</b></summary>
- 以下是指南目录与内容量,不表示各赛道已通过相同的写作、排版或线上交付验收。
- **🔬 科研与竞赛 · 9 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 1 | 大创 · 创新训练项目 | `innovation-research` | 64 KB |
- | 2 | 大创 · 创业训练项目 | `entrepreneurship-training` | 47 KB |
- | 3 | 大创 · 创业实践项目 | `entrepreneurship-practice` | 53 KB |
- | 4 | 校级科研立项 | `university-research` | 62 KB |
- | 5 | 院级科研立项 | `college-research` | 80 KB |
- | 6 | 挑战杯 · 课外学术科技作品 | `challenge-cup` | 82 KB |
- | 7 | 互联网+ · 商业计划书 | `internet-plus` | 76 KB |
- | 8 | 互联网+ · 红旅赛道 | `internet-plus-red-tour` | 65 KB |
- | 9 | 国家级项目立项逻辑评测 | `national-project-eval` | 44 KB |
- **🏆 评优与资助· 12 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 10 | 国家奖学金(10000 元) | `national-scholarship` | 38 KB |
- | 11 | 国家励志奖学金(6000 元) | `motivation-scholarship` | 48 KB |
- | 12 | 校级奖学金 | `university-scholarship` | 44 KB |
- | 13 | 企业专项奖学金 | `enterprise-scholarship` | 50 KB |
- | 14 | 单项奖学金 | `single-scholarship` | 46 KB |
- | 15 | 国家助学金 | `grant-application` | 14 KB |
- | 16 | 优秀毕业生 | `outstanding-graduate` | 46 KB |
- | 17 | 优秀学生 / 三好学生 / 优秀团员 | `outstanding-student` | 61 KB |
- | 18 | 优秀学生干部 | `outstanding-cadre` | 72 KB |
- | 19 | 文明大学生 | `civilized-student` | 62 KB |
- | 20 | 优秀班集体 | `class-collective` | 57 KB |
- | 21 | 优秀毕业设计 / 论文 | `outstanding-thesis` | 65 KB |
- **🌾 活动类 · 5 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 22 | 三下乡 · 社会调查 | `social-survey` | 47 KB |
- | 23 | 三下乡 · 支教 | `volunteer-teaching` | 53 KB |
- | 24 | 三下乡 · 政策宣讲 | `policy-lecture` | 56 KB |
- | 25 | 三下乡 · 科技服务 | `tech-service` | 67 KB |
- | 26 | 西部计划 | `western-plan` | 65 KB |
- **🚩 政治身份类 · 3 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 27 | 入团申请书 | `youth-league-application` | 62 KB |
- | 28 | 阶段汇报 / 思想汇报 | `summary-report` | 30 KB |
- | 29 | 转正申请书 | `youth-league-conversion` | 30 KB |
- **🎓 升学类 · 2 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 30 | 保研推免申请 | `graduate-recommendation` | 46 KB |
- | 31 | 选调生申请 | `selected-graduate` | 64 KB |
- **✈️ 公派留学 / 交流类 · 2 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 32 | CSC 国家公派留学 | `csc-scholarship` | 61 KB |
- | 33 | 交流项目申请 | `exchange-program` | 74 KB |
- **📋 其他 · 2 个**
- | # | 赛道 | 编码 | 内容量 |
- |---|---|---|---|
- | 34 | 转专业申请 | `major-transfer` | 67 KB |
- | 35 | 应征入伍申请书 | `military-enlistment` | 62 KB |
- </details>
- ## 项目与社区
- 项目源自团队参加挑战杯、反复修改申报书的实践。感谢完成了本项目绝大部分编写工作的 [@richyhu](https://github.com/richyhu)。欢迎通过 Issue 提供学校模板的差异、更新的申报要求和能够复现的问题。[项目演示视频](https://www.douyin.com/video/7692700167341985051) · [贡献指南](./CONTRIBUTING.md)
- ### 交流与合作
- - **大学生科创交流群**:交流大创、挑战杯、大学生创新大赛备赛与申报材料准备。
- - **合作咨询**:交流立项思路、技术路线、商业计划书等具体需求。
- <div align="center">
- <img src="./assets/contact_qr.png" width="200" alt="作者微信二维码">
- <p>👉 扫码加微信(进群备注 <b>进群</b> | 合作私聊 <b>合作+具体需求</b>)</p>
- </div>
- <details>
- <summary>社区路线图</summary>
- > 已突破 140 ⭐,「讲莲杯 / 创青春 / 三创赛」已进入开发队列。**点 Star = 催更。**
- | 里程碑 | 解锁赛道 |
- |---|---|
- | ⭐ 300 | 节能减排大赛、生命科学竞赛(学科专项类) |
- | ⭐ 500 | 服务外包大赛、商业精英挑战赛(商科类) |
- | ⭐ 1000 | 师范生教学技能、英语类竞赛 |
- </details>
- <details>
- <summary>使用说明与免责声明</summary>
- **本项目按「现状」提供,仅供学习和参考。**
- 1. **非官方出品**:与任何高校、教育主管部门、评审委员会无关。评审标准与格式规范基于公开信息和社区经验整理,不构成官方指导意见。
- 2. **真实性由使用者负责**:生成的申报材料,其真实性和准确性由使用者本人承担全部责任。虚假申报可能面临学籍处分乃至法律责任。
- 3. **不保证结果**:不承诺通过评审、获得立项或拿到奖学金。
- 4. **格式以学校模板为准**:各校模板在栏目顺序、字数、排版上可能不同,提交前请对照本校要求逐项检查。
- 5. **政治类文书的特殊性**:参考内容不构成政治立场建议,政治表述的准确性由申请人承担全部责任。
- 6. **责任豁免**:在法律允许的最大范围内,作者及贡献者不对因使用或无法使用本项目产生的任何直接、间接或后果性损害承担责任。
- 7. **合规使用**:请遵守所在国家/地区及学校的法律法规。如使用行为违反相关规定,请立即停止并删除本项目。
- **使用本项目即表示你已阅读、理解并同意上述声明。**
- </details>
- 本项目采用 MIT 许可,使用与分发时请保留原作者署名和许可声明。[LICENSE](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.