用 JiuwenSwarm 搭建论文写作 Agent 团队：文献检索、大纲生成、语法润色与引用格式避坑

毕业论文/科研论文卡住了：文献看不完、大纲理不清、语法润色靠肉眼、引用格式一查就错……能不能让多个 Agent 分工协作，各管一摊？

JiuwenSwarm 是基于 openJiuwen 框架构建的智能 AI Agent，提供 Team 模式（多智能体协作）、Skill 技能系统、Heartbeat 心跳巡检、Cron 定时任务等能力，可以帮助高校学生和科研人员构建智能化的论文写作 Agent 团队。

• 官方站点：https://www.openjiuwen.com

• 代码仓库：https://atomgit.com/openJiuwen

核心能力速览

动手之前，先了解 JiuwenSwarm 中与论文写作场景相关的几个核心能力：

Team 模式（多智能体协作）

JiuwenSwarm 支持 Agent / Code / Team 三种运行模式。Team 模式支持配置 Leader + 多个 Agent 的协作团队，通过/mode team切换。在 config.yaml 中配置团队结构，Leader 的 persona 字段定义该角色的行为方式。

Skill 技能系统

Skill 是 JiuwenSwarm 的可安装能力模块，每个 Skill 是一个包含 SKILL.md 的文件夹：

skills/ └── literature-search/ └── SKILL.md

技能来源包括：内置技能、SkillNet（基于 GitHub）、ClawHub（技能商店）、SkillHub（Swarm Skills Hub）、本地导入。

Heartbeat 心跳巡检

Heartbeat 机制可以按固定间隔触发 Agent 执行任务。在 HEARTBEAT.md 中定义巡检任务，Agent 会在每次心跳时读取并执行。

Cron 定时任务

Cron 功能支持创建定时执行的 Agent 任务，在 Web UI 的 Cron / Scheduled tasks 面板中配置，支持标准 5 字段 cron 表达式，结果可推送到 web、飞书等渠道。

实操：搭建论文写作 Agent 团队

一、安装与初始化

创建虚拟环境 python -m venv jiuwenswarm 激活虚拟环境 jiuwenswarm\Scripts\activate # Windows source jiuwenswarm/bin/activate # MacOS 安装 JiuwenSwarm pip install jiuwenswarm

初始化完成后，工作空间位于~/.jiuwenswarm/，通过jiuwenswarm-start启动服务，浏览器访问 http://localhost:5173。

启动后进入"设置 → 配置信息 → 模型配置"，填入大模型 API KEY（支持华为云 MaaS 等平台）。

二、配置论文写作团队（Team 模式）

编辑~/.jiuwenswarm/config/config.yaml，在 modes 部分添加 Team 配置：

modes: team: leader: name: "论文写作管家" persona: | 你是一个论文写作总调度管家，负责协调文献检索、大纲生成和语法润色三个助手。 根据用户的需求，合理分配任务给对应助手，汇总结果后统一回复。 agents: - name: "文献检索助手" persona: | 你是专业的文献检索助手。根据用户提供的研究主题，使用 DeepSearch 进行精准检索， 返回带有片段级引用标注的文献列表，并按相关性排序。 - name: "大纲生成助手" persona: | 你是论文大纲生成助手。根据用户的研究主题和文献摘要，生成结构清晰的论文大纲， 包含摘要、引言、相关工作、方法、实验、结论等章节。 - name: "语法润色助手" persona: | 你是学术语法润色助手。接收用户提供的论文段落，进行语法校对、用词优化、 学术表达规范化，同时检查引用格式是否统一（如 APA、GB/T 7714）。

三、创建论文写作技能（Skill）

除了 Team 模式，也可以创建专用 Skill 来处理论文写作中的具体任务。

本地创建 Skill 文件：

mkdir -p ~/.jiuwenswarm/skills/literature-search

创建 SKILL.md：

学术文献检索 ## 描述 根据研究主题，调用 DeepSearch 进行深度检索，返回带有片段级引用标注的文献结果。 ## 触发条件 当用户提到"查文献"、"检索"、"找论文"、"文献综述"等关键词时触发。 ## 步骤 1. 解析用户的研究主题和检索范围（年份、领域等） 2. 调用 DeepSearch 执行多源检索（支持 bocha、jina、perplexity 等搜索引擎） 3. 对检索结果进行知识增强融合，去重并按相关性排序 4. 为每条结果添加片段级引用标注，标注出处来源 5. 汇总为结构化的文献摘要列表返回给用户 ## 输出格式 - 文献标题 - 作者、年份、期刊/会议 - 核心观点摘要 - 引用溯源链接 - 建议 GB/T 7714 格式的参考文献条目

技能自演进：JiuwenSwarm 支持技能自演进（Skill Evolution），Agent 会根据使用反馈自动优化 SKILL.md 内容。例如当用户反馈"引用格式不对"时，技能会自动调整输出格式模板。

四、配置心跳巡检（Heartbeat）

论文写作周期长，可以利用 Heartbeat 机制定期检查写作进度。

编辑~/.jiuwenswarm/agent/jiuwenswarm_workspace/HEARTBEAT.md，添加巡检任务：

# 论文写作进度巡检 ## 当前研究主题 大语言模型在学术论文写作中的应用研究 ## 任务 每次心跳触发时，检查以下内容： 1. 回顾当前论文写作进度（哪些章节已完成、哪些待写） 2. 检查已有段落的引用标注是否完整 3. 提醒用户当前待完成的关键任务

在 config.yaml 中调整心跳间隔：

heartbeat: enabled: true interval: 3600 # 每小时巡检一次

五、配置定时文献更新提醒（Cron）

科研领域文献更新频繁，可以利用 Cron 功能定时检索最新论文。

在 Web UI 的 Cron / Scheduled tasks 面板中创建定时任务：

每周一上午 9 点检索最新文献 schedule: "0 9 * * 1" task: "检索近一周关于大语言模型在学术论文写作中的应用研究的最新论文，整理为文献摘要列表，推送给我" channel: "飞书"

Cron 执行后，结果会自动推送到配置的渠道（Web、飞书等），无需手动触发。

六、引用格式避坑——DeepSearch 片段级引用的实战价值

论文引用格式是最容易踩坑的地方，常见问题：

DeepSearch 的片段级引用和溯源推理能力可以直接解决上述问题——每条检索结果精确标注来源片段，而不是笼统地指向一篇文章。结合语法润色 Agent，可以在润色时同步校对文内引用标注（如[1]、(Author, Year)）的格式一致性。

实际使用示例

切换到 Team 模式后，直接用自然语言与 Agent 团队交互：

示例 1：启动文献检索

用户：帮我查一下近三年关于大语言模型在代码生成方面的论文

JiuwenSwarm Leader 会自动将任务分配给"文献检索助手"，该助手调用 DeepSearch 进行多源检索，返回带溯源标注的文献列表。

示例 2：生成论文大纲

用户：基于这些文献，帮我生成一篇关于"LLM 辅助代码生成的安全性分析"的论文大纲

Leader 将文献摘要和大纲生成任务分配给"大纲生成助手"，生成结构化大纲后返回。

示例三：润色

特性总结

相关资源

• 官方官网：https://www.openjiuwen.com
• 代码仓库：https://atomgit.com/openJiuwen