Academic DeAI 的作用
Academic DeAI 是一项用于编辑中英文英文学术 prose 的技能。它会在保留手稿事实、引文、术语、否定表达、证据强度、因果限定和作者声音的同时，删除空泛的铺垫、重复结构和模板化语言。
该项目支持校对、语言润色、学术翻译以及经用户授权的结构性修改。其主要适用范围不包括普通电子邮件、博客或营销文案。
Academic DeAI 不会选择 AI 模型、调用模型 API，也不会自动串联其他编辑器。它是一项在兼容宿主中运行的编辑技能。3.0.0 版本遵循当前 GPT-6 技能指南，并借鉴了 Humanizer 3.1.0 的上下文编辑理念，但不声称在每个 GPT-6 检查点上都具有完全相同的表现。
为什么上下文学术编辑很重要
学术 prose 中经常包含一些只增加强调、却没有增加证据的短语。Academic DeAI 旨在仅在周围语境支持修改时删除这类铺垫。它会先评估结构和含义，再判断单个词语是否属于不必要的模式。
例如，考虑下面这段虚构的中文文字：
值得注意的是，本研究对126名患者进行了横断面分析，结果表明睡眠质量评分与瘙痒严重程度评分相关（r=0.32，P=0.01）。这一发现不仅揭示了二者之间的复杂联系，也为今后的研究提供了重要启示。
一种可能的修改方式是：
本研究对126名患者进行横断面分析，发现睡眠质量评分与瘙痒严重程度评分相关（r=0.32，P=0.01）。
这一修改删除了泛化的铺垫，同时保留了研究设计、样本量、变量、相关系数和 P 值。这个简短示例用于说明编辑方法，并非基准比较。
主要功能
- 中英文编辑：根据用户要求的深度，编辑任一语言的学术写作。
- 学术翻译：在遵循所提供的术语、写作样例、结构要求和篇幅限制的同时翻译手稿。
- 主张保留：在源主张层面检查行为者、对象、方向、时间、条件以及引文归属。
- 证据感知式修订：保留不确定性、否定、因果限定、范围、阴性结果和必要比较。
- 结构感知式编辑：在修改局部措辞前，先考虑手稿的组织结构。
- 风格指导：使用作者样例指导表达，但不从样例中引入新事实。
- 灵活执行：当请求已经足够明确时，避免强制规定重写次数或要求提交报告。
- 选择性加载资源：仅在与任务相关时加载参考资料和工具。
前提条件
你需要使用支持技能的宿主，并为该宿主配置有效的技能位置。当前 Codex 文档将 ~/.agents/skills 列为用户级技能目录，将 .agents/skills 列为仓库级技能目录。现有环境可能使用其他已配置的位置，因此请遵循宿主的文档说明。
只有所包含的文本工具和验证命令需要 Python 3.10 或更高版本。这些工具用于检查内容和软件包行为，不会生成或重写 prose。
安装 Academic DeAI
全新用户安装
在你希望下载仓库的目录中运行：
git clone https://github.com/heise3/academic-deai.git
mkdir -p ~/.agents/skills
cp -R academic-deai ~/.agents/skills/academic-deai请复制整个仓库目录。不要只复制 SKILL.md，因为该软件包使用相对引用，并包含可选脚本。
仅当目标位置尚不存在时，才使用复制命令。安装完成后，重新打开宿主的技能列表。如果 Academic DeAI 没有出现，请重启 Codex 或相关宿主。
仓库级安装
如果你的宿主支持仓库技能，请将完整软件包放入仓库配置的技能目录中，通常是 .agents/skills。复制文件前，请确认确切的受支持路径。
升级现有安装
升级前，请备份已安装的 Academic DeAI 目录。请有意替换现有文件夹，不要将旧版本中的未知文件直接合并进来。这有助于防止过时的引用、脚本或配置文件残留在软件包中。
如需当前针对特定宿主的安装指导，请查阅官方技能文档。
基本用法
修改中文学术段落
指出要使用的技能，说明段落和语言，列出必须保持不变的内容，并说明所需的输出格式：
使用 $academic-deai 修改这一中文讨论部分。
保留所有实质性主张、引文、数字和因果限定。
仅返回修改后的文本。在指令后粘贴讨论部分。当你需要可直接插入手稿的文本时，最后一句可以避免生成额外说明。
将手稿翻译成英文
翻译时，请同时提供术语和风格参考，并明确结构限制：
使用 $academic-deai 将这篇手稿翻译成英文。
使用下面的术语表和我的写作样例。
保留指定的章节结构和最小篇幅。术语表可以为专业领域术语建立一致的译法。写作样例可以指导风格，但不应被视为新事实的来源。
请求受控的结构性修改
在获得授权后，Academic DeAI 可以执行结构性修订。请明确哪些内容可以更改，哪些内容必须保持不变。例如：
使用 $academic-deai 修订这一英文结果部分。
改善段落顺序和衔接，但保留所有标题、统计数据、比较、负面结果、引文和限定语。
仅返回修订后的部分。该指令区分了允许进行的组织性更改与受保护的实质性内容。按照要求，必要的标题以及有意义的方法学表达，包括必要的被动语态方法描述，都应保留。
验证软件包
从仓库根目录运行软件包验证器：
PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_package.py .验证器会检查软件包结构、引用、版本信息和可移植文件。
运行单元测试：
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -v测试涵盖所含工具的可观察行为。通过验证和测试并不能证明编辑质量、语义等价性、作者身份或检测器性能。
使用内容锁定检查两个文本文件
内容锁定工具可以比较原始文档与修订稿：
python3 scripts/content_lock.py original.md revised.md --strict该工具属于验证流程，而不是文本生成器。应将其输出视为辅助信息，而不是证明所有含义和主张都已保留的依据。
处理 PDF 和 DOCX 源文件
提取 PDF 文本还需要 Poppler 的 pdftotext。在依赖 PDF 提取功能之前，请确保该命令已安装并可在你的环境中使用。
DOCX 提取会读取正文 XML，但不会保留所有样式、批注、修订痕迹、脚注或文本框。如果这些文档特性很重要，请使用具备文档处理能力的工具，并直接核查可编辑的 Word 文件。
可靠编辑的高级技巧
明确界定受保护内容
不要依赖诸如让这段话听起来更好之类的笼统请求。请列出不可更改的要素，包括主张、数字、引文、术语、否定表达、不确定性、时间范围、条件和因果强度。
说明允许的编辑深度
区分校对与更深入的修订。对于校对，将更改限制在语法和措辞范围内。对于结构性编辑，请明确授权重新排列段落、修改衔接或删除冗余的铺垫。
保护证据强度
要求该技能保留诸如相关性与因果性、可能性与确定性、没有证据与证明不存在之间的区别。阴性结果和经过限定的结论在风格上可能显得不够有力，但在科学上可能至关重要。
将引文附在正确的主张之后
修改句子边界或段落结构时，请确保每条引文仍然附在其所支持的命题之后。当一个长句被拆分为几个较短的句子时，这一点尤其重要。
提供术语表
对于多语言或专业性较强的稿件，请提供首选译法、缩写、大小写形式以及必须保持不变的术语。这样可以减少不一致，而无需编辑者自行推断领域惯例。
谨慎使用作者范文
有代表性的写作样本可以指导句子长度、正式程度和偏好的措辞。请说明该样本仅作为风格参考，不得向编辑后的稿件贡献事实、引文或论点。
保留必要格式
如果期刊、机构或导师要求使用特定标题、最低篇幅、章节顺序或报告用语，请将这些限制写入提示词。按照指示时，Academic DeAI 会保留必要的标题和结构。
人工审阅结果
编辑完成后，请在主张层面将修订稿与源文档进行比较。检查每项行动由谁执行、测量了什么、每项结果的方向、适用的时间段和条件、因果措辞、数值以及引文位置。
重要限制
- Academic DeAI 不会选择模型，也不会调用模型 API。
- 所含工具不会撰写或改写文本。
- 验证并不能证明语义等价性或编辑质量。
- DOCX 提取无法保留所有文档特性。
- 项目的设计指导并不保证适用于每个 GPT-6 检查点。
- 安装该技能不会创建或修改远程 Git 仓库。
结论
Academic DeAI 提供了一种结构化方式，用于润色和翻译中英文 akademic 写作，同时避免有意削弱证据或改变实质性主张。请安装完整软件包，明确规定编辑边界，保留学科专用术语，并将每次修订与源文档进行人工比较。该项目采用 MIT 许可证。