魔搭社区公众号文章撰写规范

工作原则

本技能的写作规范与编辑取舍均在本文件内，不依赖外部定稿对照文档。用户提供定稿或修改稿时，先读取其最新内容，以确认后的表达与版式为后续编辑基准，不用旧稿覆盖，不擅自回填已删内容。具体任务要求和已确认的编辑风格优先，事实与数据仍须核验。

定位与调性

魔搭社区公众号面向 AI 开发者和研究人员，文章目标是让读者快速了解一个模型、技术或评测基准的核心价值、关键方法、性能表现，并获得最短的魔搭上手路径。

调性要求：

技术导向，信息密度高，不说废话
客观准确，不夸大不贬低
简洁直接，每句话都要有信息增量
面向实践，读完能用
必须避免使用保护性话语。 公众号正文不写自我辩护、预防性免责声明和空泛保留句；必要的测试范围、统计口径与真实能力缺口直接写成具体事实，不用防御性句式反复强调。

文章结构

必须包含

标题
引言（含开源地址）
技术内容（架构/方法/训练等）
性能表现（基准测试数据）

优选（按对象选择）

魔搭上手（模型给推理／部署，数据集与评测基准给下载／使用，系统工具给最短运行示例）。不为凑章节加入无关部署方案或完整复现手册。

可选（根据内容灵活添加）

核心特性（快速概览）
模型版本（多版本对比）
效果展示（生成样例等）
模型微调
数据集使用
总结 / 写在最后

章节顺序不强制，但引言必须在最前面，技术内容应在性能表现之前。

各部分写作要求

标题

参考结构：有辨识度的发布团队 + 项目／模型名 + 开源或发布动作 + 核心数字与价值。发布团队有官方依据时优先体现，不必机械凑齐两个卖点；代码仓库或数据集的命名空间只能提供线索，不能单独证明发布团队归属。

要求：

优先包含已核验的具体数字或对比，不为满足标题格式制造卖点
尽量精炼，约 30 字作为建议；完整项目名、团队归属和自然语序优先，不机械按中英文字符串字符数裁剪
不使用问句、感叹号堆叠，不堆砌“首个／最强／超越”等未经证实的结论

标题改写示例（仅作表达示意，具体事实须按当次来源核验）：

"Qwen 团队开源 BlenderWorld：223 任务实测 3D 创作"
"模型名开源：参数规模与核心评测表现"
"团队名发布技术名：核心能力与实际使用价值"

差的标题：

"震惊！！这个模型太强了！！快来看看！！"
"一个很厉害的新模型发布了"
"XX模型介绍"

引言

要求：

3-5句话说清楚：谁发布了什么、核心创新是什么、关键数据是什么
必须包含具体的性能数字（基准分数、参数量、加速比等）
引言后紧跟开源地址（ModelScope地址必须有，GitHub/HuggingFace等按需）
不要出现"本文将介绍""接下来我们来看"等引导语
不要在引言中写完所有技术细节，引言是概览不是摘要

示例：

NucleusAI开源了Nucleus-Image，一个拥有17B参数的文本到图像扩散模型。
该模型首次将稀疏混合专家（Sparse MoE）架构引入扩散模型领域，每次前向
传播仅激活约2B参数，在GenEval、DPG-Bench和OneIG-Bench三项基准上匹配
或超越GPT Image 1、Imagen 4等闭源模型，且完全来自预训练，未使用任何
DPO或RLHF。

开源地址：
● ModelScope：https://modelscope.cn/models/xxx
● GitHub：https://github.com/xxx

核心特性（如包含）

要求：

每条用加粗关键词开头，后跟一句话说明
每条控制在2行以内，信息密度要高
5条左右，不超过7条
不使用emoji作为列表标记（❌ 🧬、🎨、⚡）

格式示例：

**首个高质量MoE扩散模型**　17B参数仅激活约2B，大模型容量、
小模型推理成本，首次验证稀疏MoE在扩散模型中的可行性。

**纯预训练即达SOTA**　无DPO、无RL、无偏好调优，GenEval 0.87、
DPG-Bench 88.79（第一）、OneIG-Bench 0.522，超越Imagen 4。

技术内容

要求：

用读者能理解的语言解释技术，避免堆砌术语
每个技术点用加粗小标题标注，一段说清一个点；需要解释过程时，用“先生成、再检查、随后提取、最终冻结”等动作串联，不压缩成抽象名词堆叠
保留关键公式、架构图、核心流程与影响结论的约束，不铺开推导或论文全部附录
有现成配图时直接插入真实图片引用，配简短图注；尚无素材时才写明确待补占位
从论文／博客中提取核心创新，不要面面俱到

性能表现

要求：

以 Markdown 表格或清晰的官方成绩表图片展示基准数据；图片能完整表达时，不再重抄一张大表，也不只用散文罗列分数
根据官方实际评测对象呈现比较，优先保留有代表性的模型或系统，不为凑“主流竞品”编造数据；有可靠对比数据时应呈现，未发布对比时如实说明
图表后用 1—2 句话给出关键结论，再按需要保留一个有解释力的效率对比、失败案例或能力缺口，避免重复逐行读表
保留会改变读者判断的测试条件和统计口径，如输入类型、分数含义、评测对象是模型还是完整 Agent 系统；版本号、完整环境清单和额外统计放入编辑底稿或官方链接，不能因简短省去必要限定
数据必须来自论文或官方发布，核验原始出处与比较范围，不可编造；来源是否出现在正文由发布规范决定，核验与留底不能省略
自制 Markdown 表格通常不超过 6 列；官方表格图片不机械限列，但须在移动端可辨认，过宽时裁分、保留关键列或重绘

表格示例：

| 基准 | 模型A | 模型B | 模型C |
|------|-------|-------|-------|
| GenEval | 0.87 | 0.84 | 0.87 |
| DPG-Bench | 88.79 | 88.27 | 88.32 |

魔搭上手／部署与推理（按对象选择）

要求：

提供与正文承诺一致、可直接运行的最短代码示例，魔搭仓库地址、SDK 接口和关键参数须核验
代码用代码块包裹，标注语言类型（python/bash）
模型需要部署时给安装与启动命令；多种部署方式仅在读者确有需求时分别列出，不默认罗列 vLLM、SGLang 等全部方案
数据集或评测基准可以只给安装与下载；需要加载或跑评测时再补最短示例或官方入口，不能编造尚未发布的接口
必要且不直观的参数加简短注释；显然的 print、无关提醒和不影响执行的注释不为凑教程而添加
单个代码块不超过 30 行，超出部分引导读者去官方仓库查看

总结 / 写在最后（如包含）

要求：

3-5句话概括模型核心价值
回扣引言提到的核心创新和数据
不要出现"综上所述""总而言之"等套话

行文风格

必须遵守

简洁直接：每句话都要有信息增量，删掉不影响理解的修饰词
数字具体：用"17B参数"而非"大规模参数"，用"提升40.1分"而非"大幅提升"
不要机械重复：避免同一信息在多个章节大段原样出现；允许在结果分析和结尾回扣必要数字，但必须增加解释、对比或使用意义，不能把引言重新抄一遍
统一术语：全文对同一概念使用同一名称，不要混用（如"稠密"和"dense"选一个贯穿全文）
中英文混排：中文和英文/数字之间加空格，如"GenEval 达到 0.87"

禁止事项

不使用emoji作为章节标记或列表标记
不使用"本文""笔者""小编"等自称
不使用"震惊""竟然""居然"等情绪化用词
不使用"众所周知""不言而喻"等空洞表述
不在开头写"随着AI技术的快速发展"等万能开头（除非确实与主题强相关）
不用“你不需要 X 也不需要 Y”“不是 X 而是 Y”“X 可以理解为 Y”等固定模板替代具体解释
不在同一句堆叠近义价值词，如“可编辑、可复用、可继续修改”；保留最具体的主张，其他能力有证据且影响读者判断时再展开

编辑取舍与工作流程

先分主线、旁支与编辑底稿。 主稿回答有什么用、怎么做、表现怎样、如何在魔搭使用。核心方法、关键结果与有解释力的真实案例组成主线；附件子集、分类分数细析、额外验收门槛、完整环境和评审一致率等仅在影响读者判断时展开。出处核对、全量数据、版本清单、长复现说明和上传操作留在编辑底稿，不把收集到的资料全部塞进正文。

直接给出判断，不写保护性话语。 用已核验的数据说明优势，用实际问题和失败原因说明不足。删除“仅供参考”“不应据此认为”“不代表实际能力”等为作者预先免责的空泛句子，避免在每段样例后附加免责声明。测试范围和统计口径写成明确事实，无法核实的主张不作断言；相关性不写成因果关系，主视角效果不写成全部结构与功能已满足。

说明过程，不能只做字数压缩。 技术段落用动作串联输入、处理、检查与输出，必要时补足“先、再、随后、最终”，不写抽象名词串。保留关键公式、评分定义与决定结论的约束；删掉近义词叠加、反复解释和不影响理解的修饰语。小节标题直指内容，结尾直接回扣价值，不另起一节凑长度。

让图表和视频承担视觉信息。 官方成绩表图片与自制 Markdown 表选一种适合移动端阅读的形式，正文解释发现，不逐行复述。效果样例通常精选 2—3 个，用户要求更多或不同领域覆盖时调整。每例一段交代输入、目标或关键观察，随后直接配图／视频，不默认同时摆出网页总览、详情截图、逐帧对照和原视频。参考／生成、截图／抽帧拼图、实际结果／示意图分别标清，已要求的媒体不省略。

把魔搭上手缩到能执行。 魔搭入口负责下载与使用，代码仓库负责实现细节，官网负责效果展示；同类下载入口不机械凑齐。模型给最短推理示例，基准给安装与下载，需要时再补加载或评测入口。不要附带尚不需要的 MCP 清单和复现手册，必要参数与正确接口必须保留；正文承诺的 CLI、微调或部署应有对应命令。

从定稿学取舍，不学偶发错误。 逐项区分事实修正、表达精简、版式调整、原需求补齐和平台转换。用户确认的终稿是后续编辑基准，未要求时不回填已删章节、链接或样例。病句、未核验的身份归属、转码空行、托管媒体地址、附件卡片和单次封面删改不成为通用规范；不会因技能更新而改写用户文章。

交付前完成一轮整体检查。 先核对读者与明确要求，组织价值、方法、结果、展示和魔搭上手，再逐段检查信息增量、图文重复、术语与语序。最后验证数字与出处、代码与承诺、媒体与链接、定稿保护以及目标发布环境的可用性。

格式规范

章节使用统一编号（01、02、03...）或统一用加粗标题，不混用；章节名称直指内容，不必每个标题都塞一个判断
列表项至少 1—2 句话，不要只有几个词；技术解释优先采用自然段和短小加粗引题
现成图片直接用 Markdown／HTML 引用，视频用目标环境支持的嵌入方式；只有确实缺素材时才写清待补内容，不在真实配图前重复放“图片”或“视频”字样
图注通常用一句话解释图中信息，不默认重复图号、Figure 编号、页码、整段来源与操作说明；参考／生成区分、示意图身份及许可要求等必要信息不能省略
开源地址统一使用“●”，ModelScope 优先；GitHub、官网按需保留，Hugging Face 等同类入口只有提供额外价值或用户要求时再添加，不机械凑全平台
论文链接统一使用魔搭论文页：将 https://arxiv.org/abs/xxxx.xxxxx 替换为 https://modelscope.cn/papers/xxxx.xxxxx，例如 https://arxiv.org/abs/2609.23490 应写为 https://modelscope.cn/papers/2609.23490
ModelScope 地址必须真实、对应模型／数据集类型；未有资源时如实说明，不编造入口
正文不默认加入论文式 [1]、完整“资料来源”尾节或逐图学术引用；原始出处、关键数据位置与素材来源必须在编辑底稿可追溯。按用户、媒体许可或发布规范要求保留必要署名与引用
面向发布的正文与编辑备注分离；本地路径、上传说明、核验日志、临时标记不当成读者需要的技术内容

审稿检查清单

以下任何一项不满足，应打回修改：

标题缺少清楚的发布对象或价值，数字／比较主张未核验，或为凑卖点牺牲自然语序
引言超过 5 句话，或未交代发布方、核心价值与关键数据
开源／魔搭入口缺失、类型错误或虚构；尚未发布的资源未如实说明
同一信息在多个章节大段重复，或旁支资料挤压核心内容
性能数据只用散文罗列，未使用清晰表格或官方成绩表图片；或图表已完整表达仍重复抄表
已有可靠对比数据却未呈现，或为了凑竞品使用无来源、不同口径的比较
数据与论文／官方发布不一致，或出处、统计口径、比较范围无法核验
技术内容堆砌术语，核心流程没有说清；或为精简删掉影响结论成立的约束
代码块超过 30 行且未精简；接口不可用；正文承诺的 CLI／部署／微调等缺少对应步骤
章节编号跳跃、格式不统一、图片视频缺失，或存在未处理的发布占位
术语前后不一致、近义词堆叠、明显病句或固定模板句没有信息增量
使用emoji作为章节或列表标记
样例描述与图／视频重复，参考与生成未区分，或把精选案例、截图观感当成全量性能或全部验收通过
用户已定稿的取舍被擅自回填，或把编辑日志／上传说明混入主稿
正文出现保护性话语、自我辩护、预防性免责声明或空泛保留句，未改成具体事实或直接删去

不同类型文章的侧重

大语言模型（LLM）

侧重：架构创新、训练方法、代表性基准对比、最短推理入口。部署参数按需展开，不写完整运维手册。

图像/视频生成模型

侧重：精选效果展示、基准对比、关键方法、最短推理代码、影响使用的分辨率／时长／宽高比。已有素材直接插入，不重复占位。

数据集/评测基准

侧重：任务或数据构成、评测方法、关键结果、代表性样例、实质性不足与魔搭获取方式。必须区分分数含义和统计口径，但不抄全量附录；上手可只给安装与下载，加载和评测按需。

推理优化/系统工具

侧重：解决什么问题、关键方案、准确的加速／压缩结果、对比条件与最短运行示例。性能限制集中说明，不在每个段落重复免责声明。