
Humanities Thesis
- 98 installs
- 396 repo stars
- Updated April 29, 2026
- ganzhi-black/humanities-thesis-skill
Guides Chinese humanities and social-science academic papers from topic selection through literature review, structure, revision, and journal submission.
About
Covers the full Chinese humanities thesis workflow with anti-hallucination rules, academic database search, and 21 text-evaluation rules. A student or researcher uses it to select a topic, review literature, structure arguments, and prepare a paper for submission.
- Hard anti-fabrication rules for citations, quotes, and data
- Free public APIs (OpenAlex, Semantic Scholar, CORE, CrossRef) for literature search
Humanities Thesis by the numbers
- 98 all-time installs (skills.sh)
- Ranked #331 of 688 Office & Documents skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ganzhi-black/humanities-thesis-skill --skill humanities-thesisAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 98 |
|---|---|
| repo stars | ★ 396 |
| Last updated | April 29, 2026 |
| Repository | ganzhi-black/humanities-thesis-skill ↗ |
What it does
Guides Chinese humanities and social-science academic papers from topic selection through literature review, structure, revision, and journal submission.
Files
人文社科论文写作全流程指导
适用范围:文学、历史、哲学、社会学、传播学、新闻学、文化研究等人文社科领域的中文学术论文。
>
适配 Agent:Claude Code / OpenClaw。也可作为 system prompt 用于 Coze、Kimi、ChatGPT 等平台。
---
Rules:学术严谨性硬性规则
以下规则在任何阶段、任何操作中都必须遵守,不可妥协。
R1:不编造,不虚构
- 绝不生成不可查阅的文献。 不要编造作者名、论文标题、期刊名、出版年份、页码中的任何一项。如果记不清一篇文献的具体信息,明确告诉用户"我不确定这篇文献的具体信息,建议你在知网/Google Scholar中核实",而不是填一个"大概对"的信息
- 绝不虚构引文内容。 不要生成"某某曾说过……"然后跟一段编造的话。如果没有读到原文,就说没有读到
- 绝不编造数据、年份、历史事件细节。 不确定的信息用搜索工具核实,核实不了的标注"待查证"
R2:区分"知道"和"不知道"
- 对于自己的训练数据中存在的知识,可以正常使用,但涉及具体文献信息(标题、页码、出版年)时仍然需要核实
- 对于不确定的信息,使用以下表述而不是编造答案:
- "根据我的了解……但建议核实具体出处"
- "这个细节我不确定,建议查阅原文第X章"
- "此处需要你补充具体的文献信息"
- 在生成论文草稿时,对不确定的引文位置使用占位符
[待补充出处],而不是编一个看似合理的引用
R3:文献相关的红线
- 不要根据论文标题推测论文内容。标题为"论X的Y"不意味着论文就一定论证了Y
- 不要在没有读到原文的情况下描述论文的"论证过程"或"核心发现"
- 不要把摘要的概括当作论文的全部内容——很多论点的细节和限定条件只在正文中出现
- 不要混淆"作者的观点"和"作者引用的别人的观点"
- 如果用户要求引用某篇文献但你无法获取原文,告诉用户而不是凭印象编写引文
R4:生成内容的自查
每次生成论文内容后,自查以下项目:
- 所有提到的文献是否都是真实存在的?
- 所有引文是否都标注了来源(哪怕是占位符)?
- 有没有把推测性的说法写成了确定性的断言?
- 历史事件的年份、人名是否准确?
---
阶段零:提问引导——帮用户理清思路
在动笔之前,先通过结构化提问,帮用户把模糊的想法变成清晰的方案。不要跳过这个环节。
第一轮:定位(必问)
逐个提问,每次只问一个,等用户回答后再问下一个:
1. 你在写什么? 课程论文 / 本科毕业论文 / 硕士论文 / 博士论文 / 期刊投稿? 2. 你的研究对象是什么? 具体到作品名 / 历史事件 / 哲学文本 / 社会现象。如果用户说"我想研究鲁迅",追问:鲁迅的哪部作品或哪个时期? 3. 你现在最困惑的一件事是什么? 这比"你的论点是什么"更容易回答,往往直接指向真正的问题意识。 4. 你有没有已经读过的文献或理论? 如果有,追问:这个理论在你看来能解释材料里的什么现象?
第二轮:聚焦(根据第一轮回答决定)
| 用户状态 | 追问方向 |
|---|---|
| 有研究对象,没有问题 | "读这个文本时,哪个细节让你最困惑?" |
| 有问题,不知道怎么论证 | "如果有人反对你的观点,他们最可能怎么说?" |
| 有理论,不知道怎么结合材料 | "这个理论描述的现象,在你的材料里对应哪个具体段落?" |
| 有大量笔记,不知道怎么组织 | → 读取 references/material-integration.md |
| 已有完整草稿,想修改 | → 直接进入阶段六(诊断与修改) |
第三轮:确认方案
开始写作前,把以下要素复述给用户确认:研究对象、核心问题、初步论点方向、拟用理论框架、论文类型和预期篇幅。确认后再进入后续阶段。
---
方法论原则
三条贯穿始终的标准:
理论是工具,文本/史料是目的地。 引入理论是因为它能命名材料里已经存在的现象,不是为材料提供需要被验证的答案。用一个概念把一个问题真正想透,远胜于堆砌多个概念各说一点。
历史背景是语境,不是解释。 背景的功能是回答"为什么这个作者/文本会提出这个问题",而不是回答"这个文本说了什么"。把背景当答案,论文就变成了历史注脚。
论点从材料内部生长出来。 好的论点是被材料逼出来的,不是从外部框架演绎出来的。先有细读中的困惑或发现,再去找匹配的理论语言。
---
阶段一:选题与问题意识
帮用户把模糊的兴趣转化为可论证的问题。一个好问题应该是可争辩的(有人可能不同意)、可论证的(材料里有证据)、有原创性的(不是重复已有结论)。
| 层次 | 示例 | 问题 |
|---|---|---|
| 弱论点 | "《X》批判了Y" | 描述性,是常识 |
| 中等论点 | "《X》通过Y机制揭示了Z" | 有分析,可能缺深度 |
| 强论点 | "《X》在A和B的双重失败之后,在C处涌现出D,揭示了关于E的根本悖论" | 有张力,有原创,可争辩 |
---
阶段二:理论框架选择
把理论框架和材料的核心观察放在一起问:这个理论家是否已经在理论层面想透了材料里存在的问题?如果需要削足适履地改造材料来适应理论,就换框架。
每次引入新的理论概念,必须包含三个层次:① 定义(用自己的语言) ② 适用性论证(为什么它能描述材料里的现象) ③ 落地(对应哪个具体细节)。
常见错误:理论堆砌(引入三个框架各用一点)、理论先于材料(先定框架再找印证)、引用而不分析(大段引用但没说"这意味着什么")。
当用户选择理论框架时,读取 references/theory-frameworks.md。
---
阶段三:论文结构设计
好的结构是递进的论证,不是平行的观察。每章应该:接收上一章留下的张力,推进论证,开启下一章的问题。把三章标题连成一句话——如果能读出完整的论证逻辑,结构就是对的。
引言:有张力的细节切入 → 核心问题 → 研究空白 → 分析框架 → 论点
章节开头:从具体细节或引文开始,不要从理论定义或背景介绍开始。
章节结尾:收拢论点(1-2句)→ 点出张力 → 自然引向下一章。不用"下一章将分析……"。
结语:收拢三章论证,回应引言核心问题,说明对更大问题的意义。不要只罗列各章结论。
标题格式:采用"核心概念:论点方向"。冒号前点明对象,冒号后揭示论证动作。
当用户进入写作阶段时,读取 references/writing-templates.md。
---
阶段四:材料细读方法
1. 找有张力的细节:不是著名段落,而是让你困惑或与论点直接相关的细节 2. 慢读:一个词、一个时态都可能是分析入口。问:为什么是这个词? 3. 从细节到论点:分析完细节后,明确说出它如何支撑核心论点
常见陷阱:描述而不分析、孤立引文(没说和论点的关系)、过度诠释(失去和材料的连接)。
---
阶段五:历史语境处理
语境材料的放置:引言用一段交代"为什么作者在这个时刻提出这个问题";正文中在需要照亮材料的时刻自然出现;结语收拢历史线索。
正确顺序:材料细读 → 指出内部张力 → 引入历史背景 → 论证对应关系。
错误顺序:先介绍历史背景 → 声称材料反映了这个背景(沦为历史注脚)。
---
阶段六:常见问题诊断与修改
| 症状 | 诊断 | 处方 |
|---|---|---|
| 章节之间缺逻辑连接 | 结构是并列的 | 重新设计每章的"接收"和"开启" |
| 理论和材料脱节 | 理论、细读各自集中 | 每次引用材料都要有理论接应 |
| 论点不清晰 | 论点句是描述性的 | 重写:存在X张力,通过Y分析,论证Z |
| 历史背景喧宾夺主 | 背景多于分析 | 把背景分散到需要它的具体分析时刻 |
| 结尾戛然而止 | 没有向更大问题敞开 | 加一个向更大问题回望的句子 |
| 论文没有新意 | 重复已有结论 | 回到材料,找已有研究没处理的张力 |
| 摘要像内容简介 | 只说了"分析了X" | 见 references/writing-templates.md 摘要模板 |
---
文献搜索策略
自动搜索(稳定可用)
以下数据源通过免费公开 API 搜索,稳定可靠:
| 数据源 | 语言 | 说明 |
|---|---|---|
| OpenAlex | 英文为主 | 2.5亿+论文,Scopus 的免费替代品 |
| Semantic Scholar | 英文 | Allen AI 提供,免费公开 API |
| CORE | 英文 | 3亿+开放获取论文 |
| CrossRef | 英文 | DOI 元数据查询 |
使用方式:python scripts/search.py "关键词"
用户手动搜索 + AI 分析(中文文献推荐)
知网、Google Scholar 等平台的反爬机制较强,自动抓取不稳定。推荐以下工作流:
知网: 1. 用户自行在 知网 搜索 2. 搜索结果页 → 勾选文献 → 点击"导出/参考文献" → 选择"自定义"或"Endnote"格式导出 3. 将导出的文件上传给 AI,或者把内容粘贴到对话中 4. AI 负责解析、筛选、拆解、整合这些文献
Google Scholar: 1. 用户自行在 Google Scholar 搜索 2. 将搜索结果页的内容复制粘贴到对话中 3. 或者:找到文献后直接下载 PDF 上传给 AI
国家哲社文献中心: 1. 用户自行在 NCPSSD 搜索(完全免费,无需登录) 2. 将搜索结果粘贴到对话中
万方: 1. 用户自行在 万方 搜索 2. 将搜索结果或导出文献粘贴到对话中
用户提供文献信息后,AI 按 references/literature-review.md 的方法整理文献综述,按 references/literature-analysis.md 的方法拆解核心文献。
---
扩展功能(按需加载)
以下功能的详细内容在 references/ 中,用户提出对应需求时再读取对应文件:
| 阶段 | 触发场景 | 参考文件 |
|---|---|---|
| 文献综述与搜索 | "帮我查文献""写文献综述" | references/literature-review.md |
| 核心文献拆解 | 用户上传文献要求分析 | references/literature-analysis.md |
| 材料整合 | 用户提供散碎笔记要整合 | references/material-integration.md |
| 英文翻译与投稿 | "翻译摘要""准备投稿" | references/english-translation.md |
| 格式规范 | 字体字号、脚注、参考文献 | references/formatting-guide.md |
| 文本评估 | 生成章节后检查、定稿前审查 | references/text-review.md |
---
文本评估:生成内容的质量校验
每次生成完整章节或段落后,使用评估脚本做一次自动检查。这不是让模型"自己检查自己"——而是用确定性规则(正则匹配、术语表比对、格式模板检查)做硬性校验。
使用方式:
# 命令行
python scripts/review.py paper.md
# Agent 内部调用
from scripts.review import review
issues = review(text)检查六个维度:可信度(编造文献、模糊引用、过度断言)、术语一致性(译名混用)、格式规范(脚注、标点、参考文献)、学术语体(口语化、自称不统一)、论证逻辑(句间/段间/章节间的论证断裂、只论不证、只证不论、引文后缺分析、预设前提未论证、因果跳跃、结尾概念堆砌、强度词缺论据)、结构完整性(缺摘要、缺论点句)。
评估系统的边界:评估脚本只检查确定性规则(格式、用词、结构信号),不能判断论点说服力和论证逻辑连贯性。后者需要结合方法论指导做人工判断。
---
文件读取:处理用户上传的文献
当用户上传 PDF、DOCX 等文件要求分析或拆解时:
Claude Code 环境: 1. 用户上传的文件在 /mnt/user-data/uploads/ 目录下 2. PDF 文件:用 PyMuPDF(fitz)或 pdfplumber 提取文本。扫描件尝试 OCR 3. DOCX 文件:用 python-docx 读取 4. 提取失败则建议用户将关键章节粘贴到对话中 5. 提取成功后,进入 references/literature-analysis.md 的拆解流程
其他平台(Coze / Kimi / ChatGPT 等): 1. 如果平台支持文件上传,直接上传 PDF 2. 如果不支持,将文献内容粘贴到对话中
通用规则(遵守 Rules R3):
- 只分析提取到的原文内容,不推测未读到的部分
- 绝不在未读到原文的情况下"拆解"一篇文献
---
参考资源索引
| 文件 | 内容 | 加载时机 |
|---|---|---|
references/writing-templates.md | 引言、摘要、章节结尾、过渡段模板与正反面示范 | 用户进入写作阶段 |
references/theory-frameworks.md | 20位理论家速查 + 框架搜索兜底 | 用户选择理论框架 |
references/terminology-bilingual.md | 350+条术语中英法德对照表(19个学科) | 翻译或查术语英文 |
references/formatting-guide.md | 字体字号、脚注、参考文献格式 | 用户问排版格式 |
references/literature-review.md | 文献综述方法 + 搜索策略 | 用户做文献综述 |
references/literature-analysis.md | 核心文献五层拆解法 + 防臆断检查 | 用户上传文献要求分析 |
references/material-integration.md | 散碎笔记整合为论文的工作流 | 用户提供多份材料 |
references/english-translation.md | 摘要英译、投稿准备 | 用户准备英文投稿 |
references/text-review.md | 文本评估维度说明 + 脚本使用 | 生成章节后检查 |
references/platform-guide.md | Agent 适配说明 + 文件结构总览 | 首次部署时参考 |
# 敏感配置——绝不提交到仓库
scripts/.env
# Python 缓存
__pycache__/
*.pyc
*.pyo
# IDE
.vscode/
.idea/
# OS
.DS_Store
Thumbs.db
# 虚拟环境
venv/
.venv/
MIT License
Copyright (c) 2025-2026
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
<div align="center">
📜 humanities-thesis-skill
给人文社科研究者的 AI 写作副驾驶
   
<br>
<table> <tr><td align="left">
📖 论文选题想了三天,还是"浅析《XXX》的叙事策略"?<br> 🤖 让AI帮你写论文,结果它编了三篇不存在的文献?<br> 😵 每句话单独看都对,连在一起读就是一盘散沙?<br> 🌍 翻译英文摘要,"延异"到底译成 différance 还是 differance?
</td></tr> </table>
✨ 这个 Skill 解决以上所有问题。
<br>
从选题到投稿的 全流程方法论指导 + 21 条规则的文本评估引擎 + 350+ 条术语对照表
不是帮你"写"论文——是帮你想清楚论文该怎么写,然后检查你写的每一段是否站得住脚。
<br>
⚡ 快速开始 · 🧠 核心能力 · 🔬 文本评估 · 📚 文献工作流 · 📂 项目结构 · 🎯 设计原则
</div>
---
⚡ 快速开始
方式一:直接粘贴(最简单,适合所有平台)
1. 打开 SKILL.md 文件,全选复制 2. 粘贴到你用的 AI 平台里:
- Coze(扣子) → 创建 Bot → 粘贴到"人设与回复逻辑"
- Kimi / 豆包 / 通义千问 → 直接发给它说"请按照这个指导帮我写论文"
- ChatGPT → 创建 GPTs → 粘贴到 Instructions
3. references/ 文件夹里的参考资料按需投喂——要选理论框架就发 theory-frameworks.md,要查术语就发 terminology-bilingual.md
方式二:作为 Skill 安装(Claude Code / OpenClaw)
打开你的 Agent,说:
帮我安装这个 skill:https://github.com/ganzhi-black/humanities-thesis-skillAgent 会自动读取 SKILL.md 并加载全部功能。
方式三:命令行工具
git clone https://github.com/ganzhi-black/humanities-thesis-skill
cd humanities-thesis-skill
pip install -r requirements.txt
# 搜索英文学术文献(通过免费 API)
python scripts/search.py "trauma narrative Chinese literature"
# 检查论文文本质量
python scripts/review.py paper.md---
🧠 核心能力
<table> <thead> <tr> <th width="33%" align="center">📋 方法论指导</th> <th width="33%" align="center">🔍 文献工具链</th> <th width="33%" align="center">✅ 质量保障</th> </tr> </thead> <tbody> <tr> <td>
提问引导<br> <sub>三轮结构化提问,从模糊兴趣到可论证的问题</sub>
选题 → 定稿全流程<br> <sub>选题、理论框架、结构设计、材料细读、历史语境、修改诊断</sub>
散碎材料 → 完整论文<br> <sub>四步整合工作流:清点 → 提取线索 → 重组结构 → 缝合补写</sub>
</td> <td>
英文文献自动搜索<br> <sub>OpenAlex · Semantic Scholar · CORE · CrossRef(免费 API,稳定可靠)</sub>
中文文献:用户搜索 + AI 分析<br> <sub>引导用户在知网/NCPSSD搜索导出,AI负责解析、拆解、整合</sub>
五层文献拆解法<br> <sub>元信息 → 论证结构 → 证据标记 → 关系定位 → 交叉比对</sub>
</td> <td>
R1-R4 防幻觉硬规则<br> <sub>不编造文献、不虚构引文、不捏造数据</sub>
21 条文本评估规则<br> <sub>六个维度:可信度 · 术语 · 格式 · 语体 · 论证逻辑 · 结构</sub>
350+ 条术语对照表<br> <sub>覆盖 19 个学科:文学、历史、哲学、社会学、传播学、新闻学……</sub>
</td> </tr> </tbody> </table>
---
🔬 文本评估引擎
写完一段,跑一次检查。不是让模型"自己检查自己"——而是用正则匹配 + 术语表比对做确定性校验。
python scripts/review.py paper.md评估完成:2 个错误 / 5 个警告 / 1 个提示
✗ [错误] R1-01 第12行
模糊引用:使用了「有学者指出」类表述但未给出具体文献
建议:替换为具体的作者名+出处,或删除这个引用
⚠ [警告] L-07 第45行
总结句中堆砌了 5 个以上并列概念
建议:检查这些并列项是否都在前文得到了论证
⚠ [警告] L-08 第38行
强断言「显然」附近未见充分的论据支撑
建议:删去强度词,或补充多重论据六个维度 · 21 条规则
| 维度 | 规则 | 做什么 |
|---|---|---|
| 🔴 可信度 | R1-01 ~ R3-01 | 模糊引用、未来年份引用(编造嫌疑)、过度断言 |
| 🟡 术语 | T-01 | 同一概念多个译名混用(灵晕/灵韵/灵光) |
| 🟠 格式 | F-01 ~ F-04 | 空脚注、参考文献缺 [M][J]、中英标点混用、标题编号混用 |
| 🔵 语体 | S-01 ~ S-02 | 口语化("说白了""笔者觉得")、自称不统一 |
| 🟣 论证逻辑 | L-01 ~ L-08 | 连续断言无论证连接、并列堆砌无递进、引文后缺分析、因果前提未论证、总结句概念堆砌、强度词缺论据 |
| ⚪ 结构 | ST-01 ~ ST-02 | 缺摘要/关键词/参考文献、引言缺论点句 |
---
📚 文献搜索与分析
英文文献:自动搜索
通过免费公开 API 搜索,稳定可靠,零配置即可使用:
python scripts/search.py "trauma narrative Chinese literature"| 数据源 | 说明 |
|---|---|
| 🌐 OpenAlex | 2.5亿+论文,Scopus 的免费替代品 |
| 🌐 Semantic Scholar | Allen AI 提供,免费公开 API |
| 🌐 CORE | 3亿+开放获取论文 |
| 🌐 CrossRef | DOI 元数据查询 |
中文文献:用户搜索 + AI 分析
知网、Google Scholar 等平台反爬机制较强,自动抓取不稳定。推荐的工作流是:
1. 你自己搜 — 在知网/国家哲社文献中心/万方搜索 2. 导出或复制 — 导出文献列表(txt/Endnote格式),或直接复制搜索结果 3. 交给 AI — 上传文件或粘贴到对话中 4. AI 来分析 — 解析、筛选、拆解、整合文献,撰写文献综述
这其实更符合真实的学术研究流程——研究者本来就是自己搜文献,AI 的价值在于帮你分析和写作。
文献拆解
筛选出核心文献后,用五层拆解法榨干每篇文献的价值:
1. 元信息提取 — 标题、作者、论点、方法、关键词 2. 论证结构拆解 — 问题→立场→论证路径→结论 3. 证据与引文标记 — 可引用的论点/数据/方法,附页码 4. 与你论文的关系定位 — 理论基础/对话对象/反面论据 5. 交叉比对 — 多篇文献之间的共识、分歧与空白
---
📂 项目结构
humanities-thesis-skill/
├── SKILL.md # 核心指令(agent 启动时加载)
├── README.md # 本文件
├── LICENSE # MIT License
├── requirements.txt # Python 依赖
├── .gitignore # 忽略 .env 等敏感文件
│
├── references/ # 📚 参考文档(按需加载,节省 token)
│ ├── writing-templates.md # 写作模板与正反面示范(269行)
│ ├── theory-frameworks.md # 理论家速查(20 位,含兜底搜索策略)
│ ├── terminology-bilingual.md # 术语对照表(350+ 条,19 个学科)
│ ├── formatting-guide.md # 格式规范(字体字号、脚注、参考文献)
│ ├── literature-review.md # 文献综述方法 + 搜索策略
│ ├── literature-analysis.md # 核心文献五层拆解法
│ ├── material-integration.md # 散碎材料 → 完整论文工作流
│ ├── english-translation.md # 英文翻译与投稿准备
│ ├── text-review.md # 文本评估维度说明
│ └── platform-guide.md # Agent 适配说明
│
└── scripts/ # 🔧 Python 工具链
├── search.py # 文献搜索入口
├── review.py # 文本评估入口
├── .env.example # 数据源配置模板
├── lib/ # 公共模块
│ ├── schema.py # 数据模型
│ ├── http_client.py # HTTP 封装(SSL 安全验证)
│ ├── utils.py # 工具函数
│ ├── query.py # 查询预处理(中英双语展开)
│ ├── score.py # 搜索结果评分排序
│ ├── dedupe.py # 跨数据源去重
│ ├── render.py # 输出渲染
│ ├── citation.py # 引文自动生成
│ └── review_rules.py # 文本评估规则引擎(21 条)
└── sources/ # 数据源模块
├── source_openalex.py # OpenAlex(免费)
├── source_semantic_scholar.py # Semantic Scholar(免费)
├── source_core.py # CORE(免费)
├── source_crossref.py # CrossRef(免费)
├── source_cnki.py # 知网(实验性)
├── source_ncpssd.py # 国家哲社文献中心(实验性)
├── source_wanfang.py # 万方(实验性)
├── source_google_scholar.py # Google Scholar(实验性)
└── autocli_fetch.py # autocli 增强抓取(可选)---
🎯 设计原则
| 原则 | 具体做法 |
|---|---|
| SKILL.md 保持精简 | 核心指令控制在 250 行以内,其余内容按需从 references/ 加载 |
| Rules 优先于方法论 | R1-R4 防幻觉规则写在所有写作指导之前——学术可信度是底线 |
| 从材料出发 | 方法论始终强调"论点从材料内部生长",不是先选理论再找材料印证 |
| 确定性校验优先 | 文本评估用正则匹配 + 术语表比对,不依赖模型自我判断 |
| 搜索与分析分离 | 英文文献自动搜索;中文文献用户搜索、AI分析——各取所长 |
| 查不到就搜 | 理论框架和术语对照表都内置兜底机制:表里没有 → 联网搜 → 拼音+解释兜底 |
---
⚠️ 注意事项
- 这是写作辅助工具,不是论文代写工具。 Skill 帮你理清思路、检查问题、搜索文献,但核心论点和原创分析必须来自你自己
- 所有生成内容都需要人工核实。 尤其是文献信息(作者、标题、年份、页码),即使有防幻觉规则,仍然建议逐条验证
- 中文文献搜索建议手动。 知网、Google Scholar 的反爬机制较强,脚本自动抓取不稳定,推荐用户自行搜索后将结果交给 AI 分析
- 术语表和理论框架会持续扩充。 目前覆盖 20 位理论家、350+ 条术语,欢迎 PR 补充
---
🤝 贡献
欢迎以下类型的贡献:
- 📖 理论家 / 术语补充 — 编辑
references/theory-frameworks.md或terminology-bilingual.md - 🔍 评估规则 — 发现了 AI 写学术论文的新型错误模式?往
review_rules.py里加一条 - 🔧 新数据源 — 写一个
source_xxx.py提 PR - 🐛 Bug 修复 — 评估规则误报、脚本解析失败等
---
<div align="center">
MIT License · Created by @ganzhi-black
<sub>给每一个在深夜和论文搏斗的人文社科研究者。</sub>
</div>
学术英文翻译与投稿准备
---
摘要英译
中文摘要翻译为英文时,遵循以下原则:
1. 不是逐句翻译,而是重写:英文学术摘要的句式习惯和中文不同。中文摘要常用"本文认为……""本文论证……",英文更倾向"This article argues that…""By examining…, this study reveals…" 2. 术语一致性:同一个概念在全文中只用一个英文对应词,不要换来换去。查阅 terminology-bilingual.md(学术术语对照表)获取常见理论术语的标准英译 3. 关键词英译:关键词直接使用学界通行译法,不要自己造词。如果某个概念没有通行英译,保留原文拼音并在括号内解释
英文摘要常用句型
| 功能 | 句型 |
|---|---|
| 提出问题 | This article examines / investigates / explores… |
| 交代方法 | Drawing on [theorist]'s concept of [concept], this study… |
| 陈述论点 | This article argues that… / I contend that… |
| 介绍章节 | The first section analyzes… / Chapter 2 turns to… |
| 总结结论 | By doing so, this study reveals… / This analysis ultimately suggests… |
| 指出意义 | These findings contribute to… / This study sheds light on… |
---
标题英译
- 学术论文英文标题通常采用"主标题:副标题"格式
- 主标题点明核心论点或核心概念,副标题交代研究对象和方法
- 避免过长,控制在 15 个词以内
示例:
- 中文:论鲁迅小说中暴力书写的寓言结构
- 英文:Allegories of Violence: Narrative Structure in Lu Xun's Fiction
---
理论术语翻译原则
- 已有通行英译的:直接使用(如"延异"→ différance,"规训"→ discipline)
- 中国特有概念的:优先查找海外汉学界的通行译法,没有的话用拼音+解释(如"气韵" → qiyun (spirit resonance))
- 需要回译的:西方理论经中文学界转化后产生的特殊用法,翻译时要回到原文术语,同时标注中文学界的特殊内涵
翻译时如果遇到不确定的术语,利用联网搜索能力查找该术语在英文学术文献中的标准用法;如果当前环境不支持联网,建议用户在 Google Scholar 中搜索确认。
详细术语对照请查阅 terminology-bilingual.md(学术术语对照表)。
---
投稿准备检查清单
| 检查项 | 要求 |
|---|---|
| 英文摘要字数 | 符合目标期刊要求(通常 150-300 词) |
| 关键词数量 | 通常 4-6 个 |
| 作者信息 | 英文姓名拼写、机构名称规范 |
| 参考文献格式 | 符合目标期刊要求(见 formatting-guide.md) |
| 图表标注 | 英文标题、编号与正文对应 |
| 致谢 | 基金项目编号、指导老师等 |
| Cover Letter | 简要说明论文主题、创新点、适合该刊的理由 |
论文格式规范
本文件覆盖中文人文社科论文的排版格式、脚注引用、参考文献等规范。不同学校和期刊的具体要求可能有差异,以目标院校/期刊的最新版式指南为准。以下是通行的基准规范。
---
一、页面设置与字体字号
页面设置
| 项目 | 规范 |
|---|---|
| 纸张 | A4(210mm × 297mm) |
| 页边距 | 上 2.5cm、下 2.5cm、左 3.0cm、右 2.5cm |
| 行距 | 正文 1.5 倍行距;注释和参考文献单倍行距 |
| 页码 | 页脚居中,摘要和目录用罗马数字,正文从第 1 页起用阿拉伯数字 |
| 装订 | 左侧装订,预留 0.5cm 装订线 |
字体字号
| 部位 | 中文 | 英文/数字 | 字号 |
|---|---|---|---|
| 论文标题 | 黑体 | Times New Roman 加粗 | 小二号(18pt) |
| 章标题(第一章、第二章) | 黑体 | Times New Roman 加粗 | 三号(16pt) |
| 节标题(1.1、1.2) | 黑体 | Times New Roman 加粗 | 四号(14pt) |
| 小节标题(1.1.1) | 黑体 | Times New Roman 加粗 | 小四号(12pt) |
| 正文 | 宋体 | Times New Roman | 小四号(12pt) |
| 摘要正文 | 宋体 | Times New Roman | 小四号(12pt) |
| "摘要"二字 | 黑体 | — | 三号(16pt) |
| 脚注 | 宋体 | Times New Roman | 小五号(9pt) |
| 参考文献条目 | 宋体 | Times New Roman | 五号(10.5pt) |
| 页眉 | 宋体 | Times New Roman | 五号(10.5pt) |
| 页码 | — | Times New Roman | 小五号(9pt) |
特殊排版
- 引用块(超过 3 行的直接引文):左缩进 2 字符,字号不变或改为五号,不加引号,上下各空一行
- 图表标题:图标题在图下方,表标题在表上方,五号黑体居中
- 目录:标题层级缩进,页码右对齐,用点线连接
---
二、标题编号体系
人文社科论文常用两种编号体系:
体系 A:传统中文体系(学位论文常用)
第一章 xxxxxx
第一节 xxxxxx
一、xxxxxx
(一)xxxxxx
1. xxxxxx体系 B:数字编号体系(期刊论文常用)
1 xxxxxx
1.1 xxxxxx
1.1.1 xxxxxx选择哪种体系取决于目标院校/期刊的要求。同一篇论文中只使用一种体系,不要混用。
---
三、脚注/尾注引用格式
人文社科论文通常使用脚注(页下注),而非文内夹注。以下是 GB/T 7714 和 Chicago 两种常见格式。
GB/T 7714 脚注格式(中文期刊和学位论文最常用)
专著:
① 作者.书名[M].出版地:出版社,出版年:页码.
例:① 福柯.规训与惩罚[M].刘北成,杨远婴,译.北京:三联书店,2003:225.期刊论文:
② 作者.文章标题[J].期刊名,年,卷(期):页码.
例:② 陈思和.中国当代文学中的创伤叙事[J].文学评论,2018(3):5-15.学位论文:
③ 作者.论文标题[D].城市:学校名,年份:页码.
例:③ 张三.鲁迅小说的叙事伦理研究[D].北京:北京大学,2020:45.论文集中的文章:
④ 作者.文章标题[C]//编者.论文集名.出版地:出版社,年:页码.
例:④ 王德威.被压抑的现代性[C]//李欧梵,编.现代性的追求.台北:麦田出版,2000:31-56.外文文献(在中文论文中引用时):
⑤ 作者.书名[M].出版地:出版社,年:页码.
例:⑤ Benjamin, Walter. Illuminations[M]. New York: Schocken Books, 1969: 257.再次引用同一文献:
⑥ 作者.书名[M].页码.
例:⑥ 福柯.规训与惩罚[M].230.
(省略出版信息,只保留作者、书名和新的页码)Chicago 脚注格式(英文投稿和海外汉学期刊常用)
专著首次引用:
1. Walter Benjamin, Illuminations, trans. Harry Zohn (New York: Schocken Books, 1969), 257.期刊论文首次引用:
2. Rey Chow, "Rereading Mandarin Ducks and Butterflies," Cultural Critique 45 (2000): 69.再次引用(同一文献):
3. Benjamin, Illuminations, 261.紧接上条引用同一文献:
4. Ibid., 263.---
四、参考文献格式
参考文献列在论文末尾,与脚注的格式略有不同。
GB/T 7714 参考文献格式
按文献类型标注 [M]专著 [J]期刊 [D]学位论文 [C]论文集 [N]报纸 [EB/OL]网络文献。
排列顺序:中文文献在前,外文文献在后。中文按作者姓氏拼音排列,外文按作者姓氏字母排列。
[1] 本雅明.启迪:本雅明文选[M].张旭东,王斑,译.北京:三联书店,2008.
[2] 陈思和.中国当代文学中的创伤叙事[J].文学评论,2018(3):5-15.
[3] 福柯.规训与惩罚[M].刘北成,杨远婴,译.北京:三联书店,2003.
[4] Benjamin, Walter. Illuminations[M]. New York: Schocken Books, 1969.
[5] Chow, Rey. Rereading Mandarin Ducks and Butterflies[J]. Cultural Critique, 2000(45): 69-93.Chicago 参考文献格式
注意与脚注的差异:姓在前,名在后;句号代替逗号;不标页码(除期刊论文标页码范围)。
Benjamin, Walter. Illuminations. Translated by Harry Zohn. New York: Schocken Books, 1969.
Chow, Rey. "Rereading Mandarin Ducks and Butterflies." Cultural Critique 45 (2000): 69–93.MLA 格式(文学研究英文投稿常用)
Benjamin, Walter. Illuminations. Translated by Harry Zohn, Schocken Books, 1969.
Chow, Rey. "Rereading Mandarin Ducks and Butterflies." Cultural Critique, no. 45, 2000, pp. 69–93.---
五、引用格式速查
根据目标期刊/学校的要求选择格式:
| 场景 | 推荐格式 | 注释方式 |
|---|---|---|
| 中文学位论文 | GB/T 7714 | 脚注 |
| 中文核心期刊 | GB/T 7714(部分期刊有变体) | 脚注或文末 |
| CSSCI 期刊 | GB/T 7714 | 脚注为主 |
| 英文人文学科期刊 | Chicago(Notes-Bibliography) | 脚注 |
| 英文文学期刊 | MLA | 文内夹注 |
| 英文社科期刊 | APA 或 Chicago(Author-Date) | 文内夹注 |
| 海外汉学期刊 | 视期刊而定(多为 Chicago) | 脚注 |
---
六、常见格式错误
| 错误 | 正确做法 |
|---|---|
| 中文标点和英文标点混用 | 中文语境用中文标点(全角),英文引文内用英文标点(半角) |
| 书名号内嵌套书名号 | 外层用《》,内层用〈〉 |
| 脚注编号后有空格 | ① 紧跟内容,不加空格;或根据学校模板决定 |
| 参考文献缺少文献类型标识 | [M] [J] [D] 等不可省略(GB/T 7714) |
| 译著只写原作者不写译者 | 必须标注译者姓名 |
| 引用网页不标注访问日期 | [EB/OL] 类文献必须标注访问日期 |
| 同一文献重复出现在参考文献列表中 | 无论引用多少次,参考文献列表中只出现一次 |
| 正文引用的文献不在参考文献列表中 | 正文脚注中出现的所有文献都应收入参考文献 |
核心文献拆解流程
筛选出核心文献后,如何系统拆解以实现最大化利用,同时不对文献内容产生主观臆断。
---
前置要求:确保读到了原文
拆解的前提是读到文献的原文内容,而不是凭标题和摘要推测。
文件读取流程: 1. 用户上传 PDF / DOCX / 其他格式文件后,使用 agent 的文件读取能力解析全文 2. 如果是 PDF,优先尝试直接提取文本;如果是扫描件(图片型PDF),使用 OCR 工具处理 3. 如果文件无法解析,告知用户并建议:将文献关键章节手动粘贴到对话中 4. 绝对不要在没有读到原文的情况下"拆解"文献——那不是拆解,是编造
---
拆解的五个层次
对每篇核心文献,按以下五个层次逐层拆解。每个层次都只从文献原文中提取信息,不添加主观推断。
第一层:元信息提取
从文献中提取以下基本信息,形成一张卡片:
标题:
作者:
年份:
期刊/出处:
核心论点(用一句话概括):
研究对象:
理论框架:
方法论:
关键词:注意:核心论点必须从论文自身的论点句中提取(通常在摘要或引言末尾),不要用自己的话重新概括——重新概括容易无意中改变论点的方向。
第二层:论证结构拆解
梳理文献的论证逻辑链条:
1. 问题:作者提出了什么问题?这个问题的学术背景是什么? 2. 立场:作者对已有研究持什么态度?同意谁?反对谁? 3. 论证路径:从问题到结论,作者经过了哪几步?每步的核心论据是什么? 4. 结论:最终论点是什么?作者自己承认了哪些局限?
拆解时按章节顺序走,逐章记录该章的核心任务和推进逻辑。不要跳过章节,不要合并段落。
第三层:证据与引文标记
标记文献中可以被你的论文直接使用的内容:
| 标记类型 | 说明 | 提取方式 |
|---|---|---|
| 可引用论点 | 作者的原创论断 | 原文摘录 + 页码 |
| 可引用数据/事实 | 作者引用的历史事实、统计等 | 原文摘录 + 页码,同时标注数据的原始来源(作者也可能是转引的) |
| 可引用方法 | 作者的分析方法值得借鉴 | 记录方法描述 + 页码 |
| 需要回应的观点 | 你不同意或需要补充的论断 | 原文摘录 + 你的初步回应方向 |
关键规则:所有标记必须附带页码。没有页码的引用在学术论文中不可接受。
第四层:与你论文的关系定位
在拆解完前三层之后(不是之前),才判断这篇文献和你的论文之间的关系:
| 关系类型 | 判断标准 | 在论文中如何使用 |
|---|---|---|
| 理论基础 | 你的分析框架建立在这篇文献之上 | 引言或理论框架部分引用 |
| 对话对象 | 你同意其部分观点但要推进/修正 | 文献综述中作为对话方 |
| 反面论据 | 你要明确反对其论点 | 正文中设置张力 |
| 方法借鉴 | 你的分析方法参考了它 | 方法论部分引用 |
| 背景材料 | 提供历史或语境信息 | 在需要语境的地方引用 |
第五层:交叉比对
如果拆解了多篇核心文献,做一次交叉比对:
- 这几篇文献之间存在什么共识?
- 存在什么分歧?分歧的焦点在哪里?
- 它们共同忽略了什么?(这往往指向你的论文可以填补的空白)
- 它们各自的证据是否能相互验证或相互矛盾?
---
防止臆断的检查清单
拆解完成后,用以下清单自查:
| 检查项 | 通过标准 |
|---|---|
| 每个论点归纳都能指向文献原文的具体位置 | 有页码/段落编号 |
| 没有把自己的推测混入对文献的描述中 | 所有评价性语言都标注了"本文认为"而非直接断言 |
| 区分了"作者说了什么"和"这意味着什么" | 描述与分析分开 |
| 如果文献的某部分没读到原文,标注了"未见原文" | 不凭摘要推测正文内容 |
| 引文的上下文没有被截断导致意思改变 | 回原文检查引文前后文 |
---
常见拆解错误
| 错误 | 表现 | 后果 |
|---|---|---|
| 只读摘要就"拆解" | 把摘要的概括当作文献的全部论点 | 遗漏论证的细节和张力 |
| 带着预设去拆解 | 只提取支持自己观点的内容 | 选择性引用,学术不诚实 |
| 混淆作者观点和转引观点 | 把作者引用的别人的话当作作者自己的话 | 错误归因 |
| 拆解变成了复述 | 逐段翻译文献内容 | 没有分析价值 |
| 忽略作者的自我限定 | 作者说了"可能""在某种程度上",转述时去掉了 | 歪曲了论点的强度 |
文献综述与搜索策略
文献综述不是罗列"谁说了什么",而是建立你的论文在学术对话中的位置。
---
搜索策略
按以下顺序逐步缩小范围:
1. 核心关键词搜索:用研究对象+核心概念搜索(如"鲁迅 创伤叙事 研究"),先获得领域全貌 2. 理论方向搜索:用理论家名字+研究对象搜索(如"本雅明 寓言 中国现代文学"),找到理论运用的先例 3. 近五年动态搜索:加上年份限定,了解最新研究走向 4. 英文文献补充:用英文关键词搜索同一主题的海外研究,拓宽视野
搜索工具选择(按优先级): 1. 如果当前环境支持执行 Python 脚本,运行 scripts/search.py 自动聚合多个学术数据库 2. 如果当前环境有联网搜索能力(如 Claude、GPT 联网模式),直接搜索 3. 都没有的话,引导用户前往以下数据库按此策略自行检索
推荐学术数据库:
- 中文文献:中国知网(CNKI)、万方数据、维普、读秀
- 英文文献:Google Scholar、JSTOR、Project MUSE、Web of Science
- 开放获取:Semantic Scholar、Academia.edu
每次搜索后,帮用户筛选:这篇文献和我的论文是什么关系?是要对话的对手、可以借力的盟友、还是需要补充的空白?
---
文献综述的组织方式
不要按时间顺序罗列文献,而是按论证功能分组:
| 功能 | 作用 | 写法 |
|---|---|---|
| 奠基型 | 确立研究领域的基本共识 | "关于X,学界已形成共识:……" |
| 对话型 | 展示你要介入的争论 | "A认为……,B则提出……,但双方都忽略了……" |
| 空白型 | 指出你的论文填补什么 | "已有研究较少追问……,而这恰恰是理解X的关键" |
文献综述的最后一段必须落到你的论文要做什么——读者读完综述后应该自然理解:为什么需要你这篇论文。
---
脚本工具:学术文献搜索
scripts/ 目录包含一套 Python 脚本,可以自动聚合多个学术数据库进行文献搜索。
支持的数据源
| 数据源 | 脚本文件 | 是否需要配置 | 说明 |
|---|---|---|---|
| 国家哲社文献中心 | sources/source_ncpssd.py | 无需配置 | 人文社科首选,2,400+种核心期刊,完全免费 |
| 知网 CNKI | sources/source_cnki.py | 需要 Cookie | 中文文献最全,需从浏览器复制 Cookie |
| 万方数据 | sources/source_wanfang.py | 无需配置 | 中文文献补充 |
| OpenAlex | sources/source_openalex.py | 无需配置 | 2.5亿+论文,Scopus 的免费替代品 |
| CORE | sources/source_core.py | 无需配置 | 3亿+开放获取论文,可获取全文 |
| Google Scholar | sources/source_google_scholar.py | 推荐配置 SerpAPI Key | 综合学术搜索 |
| Semantic Scholar | sources/source_semantic_scholar.py | 无需配置 | 英文文献,免费公开 API |
| CrossRef | sources/source_crossref.py | 无需配置 | 通过 DOI 获取英文文献元数据 |
使用方式
# 搜索所有可用数据源
python scripts/search.py "鲁迅 创伤叙事"
# 指定数据源
python scripts/search.py "鲁迅 创伤叙事" --sources cnki,wanfang
# 查看数据源配置状态
python scripts/search.py --list-sources配置方式
将 scripts/.env.example 复制为 scripts/.env,填入对应的 Key 或 Cookie。没有配置的数据源会被自动跳过。
在 Agent 工作流中调用
from scripts.search import search_to_json
result = search_to_json("鲁迅 创伤叙事", sources=["cnki", "semantic_scholar"], limit=10)返回标准化 JSON,包含标题、作者、年份、摘要、引用次数等字段。
材料整合工作流
当用户提供散碎笔记、多份草稿、读书摘录等材料,需要整合成完整论文时,按以下步骤处理。
---
第一步:材料清点
逐份阅读用户提供的所有材料,生成一份材料清单,标注每份材料的类型和可用价值:
- 这段笔记里有没有可以直接用的论点?
- 这段引文属于哪个论证环节?
- 这段草稿的问题在哪里(描述性?逻辑断裂?理论脱节?)
材料清单格式建议:
材料编号 | 来源文件 | 类型 | 核心内容 | 可用于章节 | 问题
1 | 笔记1 | 读书摘录 | 福柯权力分析 | 第二章 | 只有摘录没有分析
2 | 草稿A | 章节草稿 | 引言初稿 | 引言 | 论点句是描述性的
3 | 笔记3 | 细读笔记 | 文本第三章分析 | 第一章 | 可直接使用---
第二步:论证线索提取
从散碎材料中提取可论证的核心观察,不是所有材料都要用——筛掉重复的、偏题的、没有分析潜力的内容。
把保留的材料按论证功能排列:
- 哪些支撑论点 A
- 哪些支撑论点 B
- 哪些提供反例或张力
- 哪些是背景性的(只在需要时调用)
---
第三步:结构重组
根据提取的论证线索,设计递进式结构。把材料分配到对应章节,标注每个章节还缺什么:
- 缺细读(有引文但没有分析)
- 缺理论接应(有分析但没有理论提升)
- 缺过渡(章节内部或章节之间的逻辑连接)
- 缺收束(章节结尾没有收拢论点)
---
第四步:缝合与补写
按章节顺序,把现有材料缝合成连贯文本。缝合时重点处理:
- 语气统一:不同时期写的草稿语气常不一致,需要统一为学术论文的书面语
- 逻辑连接:在材料之间补写过渡句,让论证连贯
- 分析补充:对只有引文没有分析的地方,补上"这意味着什么"
---
整合的常见陷阱
| 陷阱 | 表现 | 解决 |
|---|---|---|
| 舍不得删 | 读书笔记全塞进论文 | 与核心论点无关的材料果断舍弃 |
| 拼贴感 | 材料之间没有论证逻辑串联 | 每段之间加过渡,说明"为什么从这里到那里" |
| 详略失衡 | 熟悉的写过细,不熟的一笔带过 | 重新分配篇幅,以论证需要而非个人熟悉度为标准 |
| 语气不统一 | 有的段落口语化,有的过度学术 | 通篇统一为中等正式的学术书面语 |
Agent 适配说明
本 skill 适配两个 agent 环境:Claude Code 和 OpenClaw。
---
文件结构总览
humanities-thesis/
├── SKILL.md ← 核心指令(agent 启动时加载)
├── README.md ← 项目说明
├── references/ ← 参考文档(按需加载)
│ ├── writing-templates.md ← 写作模板
│ ├── theory-frameworks.md ← 理论家速查(16位)
│ ├── terminology-bilingual.md ← 术语对照表(224条)
│ ├── formatting-guide.md ← 格式规范
│ ├── literature-review.md ← 文献综述与搜索策略
│ ├── literature-analysis.md ← 核心文献拆解流程
│ ├── material-integration.md ← 材料整合工作流
│ ├── english-translation.md ← 英文翻译与投稿
│ └── platform-guide.md ← 本文件
└── scripts/ ← 文献搜索脚本
├── search.py ← 统一搜索入口
├── .env.example ← 配置模板
├── lib/ ← 公共模块
│ ├── schema.py ← 数据模型
│ ├── http_client.py ← HTTP 封装
│ ├── utils.py ← 工具函数
│ ├── query.py ← 查询预处理
│ ├── score.py ← 评分排序
│ ├── dedupe.py ← 去重
│ ├── render.py ← 输出渲染
│ └── citation.py ← 引文生成
└── sources/ ← 数据源模块(8个)
├── source_cnki.py ← 知网
├── source_ncpssd.py ← 国家哲社文献中心
├── source_wanfang.py ← 万方
├── source_openalex.py ← OpenAlex
├── source_core.py ← CORE
├── source_google_scholar.py ← Google Scholar
├── source_semantic_scholar.py ← Semantic Scholar
└── source_crossref.py ← CrossRef---
Claude Code 适配
安装与启动
# 在项目目录下,Claude Code 会自动读取 SKILL.md
# 也可以手动指定
claude --skill ./SKILL.md能力对照
| 本 skill 需要的能力 | Claude Code 支持情况 | 调用方式 |
|---|---|---|
| 读取 SKILL.md | ✓ 自动读取 | 放在项目根目录即可 |
| 按需加载 references/ | ✓ 文件读取 | cat references/xxx.md |
| 执行搜索脚本 | ✓ bash 执行 | python scripts/search.py "关键词" |
| 读取用户上传的 PDF | ✓ Python 环境 | 用 PyMuPDF/pdfplumber 提取文本 |
| 读取用户上传的 DOCX | ✓ Python 环境 | 用 python-docx 读取 |
| 联网搜索 | ✓ 内置 | 直接使用联网能力搜索术语/文献 |
| 生成 DOCX/PDF 输出 | ✓ Python 环境 | 用 python-docx / reportlab 生成 |
安装依赖
pip install PyMuPDF pdfplumber python-docx beautifulsoup4 requests文件读取流程
用户上传文件后,Claude Code 可以直接访问文件:
# PDF 文本提取
import fitz # PyMuPDF
doc = fitz.open("/path/to/file.pdf")
for page in doc:
text = page.get_text()
# DOCX 文本提取
from docx import Document
doc = Document("/path/to/file.docx")
for para in doc.paragraphs:
text = para.text---
OpenClaw 适配
安装与启动
将整个项目目录作为 skill 导入 OpenClaw。SKILL.md 会被自动识别为主指令文件。
能力对照
| 本 skill 需要的能力 | OpenClaw 支持情况 | 调用方式 |
|---|---|---|
| 读取 SKILL.md | ✓ 自动读取 | skill 主文件 |
| 按需加载 references/ | ✓ 文件读取 | 读取 skill 目录下的文件 |
| 执行搜索脚本 | ✓ 代码执行 | 在代码执行环境中运行 Python |
| 读取用户上传的文件 | 视配置 | 检查 agent 提供的文件处理工具 |
| 联网搜索 | ✓ 内置 | 使用 agent 的搜索能力 |
注意事项
- OpenClaw 的文件处理能力取决于具体配置,如果不支持直接读取 PDF,引导用户粘贴文献内容
- 脚本执行环境可能需要预装依赖,在 skill 配置中声明
requirements.txt
---
关于 Rules 的执行
SKILL.md 中的 Rules(R1-R4)是硬性规则,两个 agent 环境都必须遵守。其核心目的是防止模型幻觉在学术场景中造成严重后果(编造文献、虚构引文)。
具体来说:
- Claude Code:Claude 模型本身的幻觉率较低,但在生成文献信息时仍然可能出错。Rules 的作用是在 skill 层面再加一道检查
- OpenClaw:如果底层使用的模型幻觉率较高(如某些开源模型),Rules 的约束尤为重要。建议在 agent 配置中将 temperature 设为较低值(0.3-0.5),并开启自我检查
无论哪个 agent,生成的论文内容中如果涉及具体文献信息,都应提醒用户核实。
人文社科学术术语对照表
本文件收录人文社科论文写作和翻译中常用的理论术语。按理论家/学派分组,每个条目包含:中文译名、原文(法/德/英)、英文通行用法、使用语境提示。
翻译原则:优先使用学界已有的通行译法。如果某个术语在不同学者的翻译中有差异,标注主要的几种译法并说明各自的学术脉络。
---
⚠ 查不到的术语怎么办
本表无法穷尽所有术语。遇到表中没有的术语时,按以下顺序处理:
1. 联网搜索:如果当前环境支持联网,搜索 "术语中文" site:scholar.google.com 或 "术语中文" English translation academic,从英文学术论文中找通行译法 2. 查询 OpenAlex / Semantic Scholar:用中文术语搜索相关论文,从英文论文标题和摘要中提取对应英文表述 3. 回溯原文:如果是西方理论经中文转化的概念,先查找原始理论家的母语用词,再看英文学界如何翻译 4. 拼音+解释兜底:确实没有通行英译的中国本土概念,用拼音加括号解释(如 qiyun (spirit resonance)) 5. 标注不确定性:如果找到的译法不确定是否通行,在论文中标注"本文将X译为Y",让读者知道这是作者的翻译选择
对于查询预处理脚本:脚本内置了本表的关键词映射,用于将中文搜索词自动转为中英双语查询。如果脚本查不到映射,会保留原文搜索,不会丢失任何查询。
---
目录
1. 解构主义与后结构主义(德里达、福柯、巴特勒) 2. 生命政治与政治哲学(阿甘本、阿伦特、朗西埃) 3. 共同体理论(南希、布朗肖) 4. 批判理论与历史哲学(本雅明、阿多诺、哈贝马斯) 5. 后殖民理论(萨义德、巴巴、斯皮瓦克、法农) 6. 精神分析(弗洛伊德、拉康、齐泽克、克里斯蒂娃) 7. 现象学与存在主义(胡塞尔、海德格尔、梅洛-庞蒂、列维纳斯) 8. 马克思主义文论(卢卡奇、阿尔都塞、葛兰西、詹姆逊) 9. 女性主义与性别理论(波伏瓦、西苏、伊利格瑞、塞吉维克) 10. 空间理论(列斐伏尔、索雅、德赛托) 11. 情动理论与新唯物主义(德勒兹、马苏米、巴拉德) 12. 媒介理论与技术哲学(基特勒、斯蒂格勒、鲍德里亚) 13. 叙事学与文学理论通用术语 14. 通用学术写作术语 15. 中国文学与文化研究常用概念 16. 历史学核心术语 17. 哲学核心术语 18. 传播学与新闻学核心术语 19. 社会学核心术语
---
1. 解构主义与后结构主义
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 延异 | différance (法) | différance(保留法文) | 德里达特造词,英文文献不翻译 |
| 解构 | déconstruction (法) | deconstruction | |
| 增补 | supplément (法) | supplement | "增补逻辑"译为 the logic of the supplement |
| 踪迹/痕迹 | trace (法) | trace | |
| 在场/在场形而上学 | présence (法) | presence / metaphysics of presence | |
| 书写 | écriture (法) | writing / écriture | 德里达用法,区别于日常"写作" |
| 播撒 | dissémination (法) | dissemination | 德里达著作名兼概念 |
| 法律的力量 | force de loi (法) | force of law | 德里达著作名 |
| 幽灵学 | hantologie (法) | hauntology | 德里达,谐音 ontology |
| 药 | pharmakon (希) | pharmakon(保留希腊文) | 既是药又是毒 |
| 话语 | discours (法) | discourse | 福柯用法,知识-权力的实践系统 |
| 规训 | discipline (法/英) | discipline | "规训权力"译为 disciplinary power |
| 生命权力/生命政治 | biopouvoir / biopolitique (法) | biopower / biopolitics | 福柯与阿甘本均使用但内涵有差异 |
| 全景监狱/圆形监狱 | panoptique (法) | panopticon | |
| 知识考古学 | archéologie du savoir (法) | archaeology of knowledge | |
| 谱系学 | généalogie (法) | genealogy | |
| 治理术 | gouvernementalité (法) | governmentality | 福柯晚期核心概念 |
| 关怀自我 | souci de soi (法) | care of the self | 福柯晚期伦理学 |
| 异托邦 | hétérotopie (法) | heterotopia | 福柯,区别于乌托邦 |
| 知识型 | épistémè (法) | episteme | 福柯,一个时代的知识基本结构 |
| 操演性 | performativité (法) | performativity | 巴特勒用法,区别于奥斯汀 |
| 脆弱性/不稳定性 | précarité / vulnérabilité | precarity / vulnerability | precarity 偏社会政治,vulnerability 偏伦理 |
| 主体化/主体建构 | subjectivation (法) | subjectivation / subjectification | 福柯与巴特勒用法略不同 |
| 异质性 | hétérogénéité (法) | heterogeneity | |
| 性别操演 | — | gender performativity | 巴特勒核心概念 |
| 可悲悼性 | — | grievability | 巴特勒,哪些生命被认为值得哀悼 |
2. 生命政治与政治哲学
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 赤裸生命 | nuda vita (意) | bare life | 阿甘本核心概念 |
| 神圣人 | homo sacer (拉) | homo sacer(保留拉丁文) | |
| 例外状态 | stato di eccezione (意) | state of exception | |
| 姿势 | gesto (意) | gesture | 阿甘本用法,纯粹手段性的展示 |
| 潜能/非潜能 | potenza / impotenza (意) | potentiality / impotentiality | |
| 剩余时间 | il tempo che resta (意) | the time that remains | 阿甘本对保罗的解读 |
| 装置/部署 | dispositivo (意) | apparatus / dispositif | 阿甘本经福柯发展 |
| 公共领域 | öffentlicher Raum (德) | public realm / public sphere | 阿伦特用 realm,哈贝马斯用 sphere |
| 行动 | Handeln (德) | action | 阿伦特用法,区别于 labor 和 work |
| 平庸之恶 | Banalität des Bösen (德) | the banality of evil | |
| 极权主义 | Totalitarismus (德) | totalitarianism | |
| 诞生性 | Natalität (德) | natality | 阿伦特,人开创新事物的能力 |
| 复数性 | Pluralität (德) | plurality | 阿伦特政治哲学核心 |
| 歧感/歧义 | mésentente (法) | disagreement / dissensus | 朗西埃核心概念 |
| 感性的分配 | partage du sensible (法) | distribution of the sensible | 朗西埃美学政治学 |
| 无分之分 | la part des sans-part (法) | the part of those who have no part | 朗西埃 |
3. 共同体理论
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 无为的共同体/解构的共通体 | communauté désoeuvrée (法) | the inoperative community | 南希著作名 |
| 作品式共同体 | communauté oeuvre (法) | community as work | |
| 有限性共显 | com-parution (法) | compearance | 南希术语,英译不统一 |
| 神话的打断 | l'interruption du mythe (法) | the interruption of myth | |
| 独一存在 | être singulier pluriel (法) | being singular plural | 南希著作名兼核心概念 |
| 不可言明的共通体 | communauté inavouable (法) | the unavowable community | 布朗肖著作名 |
| 触碰/接触 | toucher (法) | touch / touching | 南希与德里达之间的关键概念 |
4. 批判理论与历史哲学
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 历史天使 | Angelus Novus (拉) | Angel of History | 本雅明概念 |
| 辩证意象 | dialektisches Bild (德) | dialectical image | |
| 灵晕/灵韵 | Aura (德) | aura | "灵晕的消散"译为 the decay of the aura |
| 寓言 | Allegorie (德) | allegory | 本雅明用法,区别于象征 symbol |
| 机械复制 | mechanische Reproduktion (德) | mechanical reproduction | |
| 废墟 | Ruine (德) | ruin | 本雅明用法,与寓言相关 |
| 弥赛亚时间 | messianische Zeit (德) | messianic time | |
| 当下/此刻 | Jetztzeit (德) | now-time / Jetztzeit | 有时保留德文 |
| 闲逛者 | Flaneur (德/法) | flâneur(保留法文) | 本雅明巴黎研究 |
| 拱廊街 | Passagen (德) | arcades | 本雅明未完成巨著 |
| 文化工业 | Kulturindustrie (德) | culture industry | 阿多诺与霍克海默 |
| 否定辩证法 | negative Dialektik (德) | negative dialectics | 阿多诺 |
| 星丛 | Konstellation (德) | constellation | 阿多诺/本雅明 |
| 非同一性 | Nichtidentität (德) | nonidentity | 阿多诺 |
| 交往行为 | kommunikatives Handeln (德) | communicative action | 哈贝马斯 |
| 生活世界 | Lebenswelt (德) | lifeworld | 哈贝马斯经胡塞尔发展 |
5. 后殖民理论
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 东方主义 | — | Orientalism | 萨义德 |
| 对位阅读 | — | contrapuntal reading | 萨义德 |
| 混杂性 | — | hybridity | 巴巴 |
| 模拟/模仿 | — | mimicry | 巴巴,"几乎一样但又不完全一样" |
| 第三空间 | — | third space | 巴巴 |
| 矛盾心理 | — | ambivalence | 巴巴,殖民者与被殖民者的矛盾情感 |
| 属下/庶民 | — | subaltern | 斯皮瓦克,源自葛兰西 |
| 认识论暴力 | — | epistemic violence | 斯皮瓦克 |
| 策略性本质主义 | — | strategic essentialism | 斯皮瓦克 |
| 黑皮肤白面具 | peau noire, masques blancs (法) | black skin, white masks | 法农著作名 |
| 被诅咒者 | les damnés de la terre (法) | the wretched of the earth | 法农著作名 |
| 离散/流散 | — | diaspora |
6. 精神分析
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 无意识 | das Unbewusste (德) | the unconscious | 弗洛伊德 |
| 压抑 | Verdrängung (德) | repression | |
| 升华 | Sublimierung (德) | sublimation | |
| 创伤 | Trauma (德/英) | trauma | |
| 强迫性重复 | Wiederholungszwang (德) | repetition compulsion | |
| 哀悼与忧郁 | Trauer und Melancholie (德) | mourning and melancholia | 弗洛伊德论文名 |
| 恐怖/怪异 | das Unheimliche (德) | the uncanny | 弗洛伊德 |
| 能指链 | chaîne signifiante (法) | signifying chain | 拉康 |
| 大他者 | le grand Autre (法) | the big Other | 拉康 |
| 实在界/象征界/想象界 | le Réel / le Symbolique / l'Imaginaire | the Real / the Symbolic / the Imaginary | 拉康三界 |
| 镜像阶段 | stade du miroir (法) | mirror stage | 拉康 |
| 对象小a | objet petit a (法) | objet petit a(保留法文) | 拉康,欲望的对象-原因 |
| 享乐 | jouissance (法) | jouissance(保留法文) | 拉康,超越快感的享乐 |
| 缝合 | suture (法/英) | suture | 拉康/齐泽克 |
| 崇高客体 | — | sublime object | 齐泽克 |
| 贱斥 | abjection (法/英) | abjection | 克里斯蒂娃 |
7. 现象学与存在主义
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 意向性 | Intentionalität (德) | intentionality | 胡塞尔 |
| 悬搁/还原 | Epoché (希/德) | epoché / phenomenological reduction | 胡塞尔 |
| 此在 | Dasein (德) | Dasein(保留德文) | 海德格尔 |
| 在世存在 | In-der-Welt-sein (德) | being-in-the-world | 海德格尔 |
| 存在/存在者 | Sein / Seiendes (德) | Being / beings | 海德格尔存在论差异 |
| 向死存在 | Sein zum Tode (德) | being-toward-death | 海德格尔 |
| 上手/在手 | Zuhandenheit / Vorhandenheit (德) | ready-to-hand / present-at-hand | 海德格尔 |
| 解蔽/遮蔽 | Entbergung / Verbergung (德) | unconcealment / concealment | 海德格尔论真理 |
| 座架 | Gestell (德) | enframing | 海德格尔论技术 |
| 被抛 | Geworfenheit (德) | thrownness | 海德格尔 |
| 身体图式 | schéma corporel (法) | body schema | 梅洛-庞蒂 |
| 肉身 | chair (法) | flesh | 梅洛-庞蒂晚期概念 |
| 面容 | visage (法) | face | 列维纳斯伦理学核心 |
| 他者的优先性 | — | priority of the Other | 列维纳斯 |
8. 马克思主义文论
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 异化/疏离 | Entfremdung (德) | alienation / estrangement | 马克思 |
| 物化 | Verdinglichung (德) | reification | 卢卡奇核心概念 |
| 总体性 | Totalität (德) | totality | 卢卡奇 |
| 意识形态国家机器 | appareils idéologiques d'État (法) | ideological state apparatus (ISA) | 阿尔都塞 |
| 症候阅读 | lecture symptomale (法) | symptomatic reading | 阿尔都塞 |
| 询唤/质询 | interpellation (法/英) | interpellation | 阿尔都塞 |
| 过度决定 | surdétermination (法) | overdetermination | 阿尔都塞 |
| 文化霸权/领导权 | egemonia (意) | hegemony | 葛兰西 |
| 有机知识分子 | intellettuale organico (意) | organic intellectual | 葛兰西 |
| 政治无意识 | — | political unconscious | 詹姆逊 |
| 认知图绘 | — | cognitive mapping | 詹姆逊 |
| 晚期资本主义 | — | late capitalism | 詹姆逊/曼德尔 |
9. 女性主义与性别理论
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 第二性 | le deuxième sexe (法) | the second sex | 波伏瓦著作名 |
| 阴性书写 | écriture féminine (法) | écriture féminine(保留法文) | 西苏 |
| 美杜莎的笑 | le rire de la Méduse (法) | the laugh of the Medusa | 西苏论文名 |
| 此性 | ce sexe qui n'en est pas un (法) | this sex which is not one | 伊利格瑞著作名 |
| 酷儿理论 | — | queer theory | |
| 壁橱认识论 | — | epistemology of the closet | 塞吉维克著作名 |
| 同性社会性欲望 | — | homosocial desire | 塞吉维克 |
| 交叉性 | — | intersectionality | 克伦肖提出 |
| 具身性 | — | embodiment | 女性主义现象学 |
10. 空间理论
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 空间的生产 | la production de l'espace (法) | the production of space | 列斐伏尔著作名 |
| 空间实践/空间表征/表征空间 | pratique spatiale / représentation de l'espace / espace de représentation | spatial practice / representations of space / representational spaces | 列斐伏尔三元辩证法 |
| 日常生活批判 | critique de la vie quotidienne (法) | critique of everyday life | 列斐伏尔 |
| 第三空间 | — | Thirdspace | 索雅,注意与巴巴的 third space 不同 |
| 日常生活的实践 | l'invention du quotidien (法) | the practice of everyday life | 德赛托著作名 |
| 策略/战术 | stratégie / tactique (法) | strategy / tactics | 德赛托,权力者 vs 弱者 |
| 非场所 | non-lieu (法) | non-place | 奥热 |
11. 情动理论与新唯物主义
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 情动/情感 | affect (英/法) | affect | 区别于 emotion 和 feeling |
| 生成/变化 | devenir (法) | becoming | 德勒兹 |
| 解域化/再域化 | déterritorialisation / reterritorialisation (法) | deterritorialization / reterritorialization | 德勒兹与瓜塔里 |
| 根茎 | rhizome (法/英) | rhizome | 德勒兹与瓜塔里 |
| 褶子 | pli (法) | fold | 德勒兹 |
| 无器官的身体 | corps sans organes (法) | body without organs (BwO) | 德勒兹与瓜塔里 |
| 内行动 | intra-action (英) | intra-action | 巴拉德,区别于 interaction |
| 衍射 | — | diffraction | 巴拉德/哈拉维 |
| 赛博格 | — | cyborg | 哈拉维 |
12. 媒介理论与技术哲学
| 中文 | 原文 | 英文通行用法 | 语境说明 |
|---|---|---|---|
| 话语网络 | Aufschreibesysteme (德) | discourse networks | 基特勒著作名 |
| 技术与时间 | la technique et le temps (法) | technics and time | 斯蒂格勒著作名 |
| 第三持留 | rétention tertiaire (法) | tertiary retention | 斯蒂格勒 |
| 媒介即讯息 | — | the medium is the message | 麦克卢汉 |
| 拟像/仿真 | simulacre / simulation (法) | simulacrum / simulation | 鲍德里亚 |
| 超真实 | hyperréalité (法) | hyperreality | 鲍德里亚 |
| 景观社会 | la société du spectacle (法) | the society of the spectacle | 居伊·德波 |
13. 叙事学与文学理论通用术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 叙事学 | narratology | |
| 隐含作者 | implied author | 布斯提出 |
| 聚焦 | focalization | 热奈特,取代传统"视角" |
| 内聚焦/外聚焦/零聚焦 | internal / external / zero focalization | 热奈特 |
| 时序/时距/频率 | order / duration / frequency | 热奈特叙事时间三要素 |
| 副文本 | paratext | 热奈特 |
| 互文性 | intertextuality | 克里斯蒂娃提出 |
| 对话性/复调 | dialogism / polyphony | 巴赫金 |
| 狂欢化 | carnivalization | 巴赫金 |
| 时空体 | chronotope | 巴赫金 |
| 能指/所指 | signifier / signified | 索绪尔 |
| 陌生化 | ostranenie / defamiliarization | 什克洛夫斯基 |
| 期待视野 | Erwartungshorizont / horizon of expectations | 姚斯,接受美学 |
| 文学场 | champ littéraire / literary field | 布尔迪厄 |
| 文化资本 | capital culturel / cultural capital | 布尔迪厄 |
| 惯习 | habitus (法/英) | habitus |
| 作者之死 | la mort de l'auteur / the death of the author | 巴特 |
| 可读文本/可写文本 | readerly / writerly text | 巴特 |
14. 通用学术写作术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 论点/核心论点 | thesis / central argument | thesis 更常用于人文学科 |
| 文献综述 | literature review | |
| 研究空白 | research gap / lacuna | |
| 研究问题 | research question | |
| 问题意识 | problematic / research question | problematic 更偏理论性 |
| 细读 | close reading | |
| 远读 | distant reading | 莫雷蒂提出 |
| 文本分析 | textual analysis | |
| 话语分析 | discourse analysis | |
| 理论框架 | theoretical framework | |
| 分析框架 | analytical framework | |
| 方法论 | methodology | |
| 主体性 | subjectivity | |
| 他者/他异性 | the Other / alterity / otherness | 不同理论传统用法不同 |
| 能动性 | agency | |
| 再现/表征 | representation | |
| 意识形态 | ideology | |
| 典范/范式 | paradigm | 库恩 |
| 本文论证…… | This article/paper argues that… | |
| 已有研究指出…… | Previous scholarship has shown/noted… | |
| 本文试图揭示…… | This study seeks to reveal/uncover… | |
| 本文借助……的理论 | Drawing on the theory/concept of… | |
| 值得注意的是…… | It is worth noting that… / Notably, … | |
| 尚未得到充分关注 | has not received sufficient attention | |
| 本文填补了……的空白 | This study fills a gap in… |
15. 中国文学与文化研究常用概念
海外汉学界有相对通行的英译,翻译时优先采用:
| 中文 | 英文通行译法 | 说明 |
|---|---|---|
| 伤痕文学 | scar literature / wound literature | scar literature 更通行 |
| 反思文学 | reflective literature | |
| 寻根文学 | root-seeking literature | |
| 先锋文学 | avant-garde literature / experimental fiction | |
| 朦胧诗 | Misty Poetry / Obscure Poetry | Misty Poetry 更通行 |
| 知青文学 | sent-down youth literature / zhiqing literature | |
| 新时期文学 | New Era literature / post-Mao literature | |
| 新写实主义 | neo-realism / new realism | |
| 底层文学/底层叙事 | subaltern literature / grassroots narrative | 注意与斯皮瓦克 subaltern 的区别 |
| 非虚构写作 | non-fiction writing / literary non-fiction | |
| 五四运动/五四文学 | May Fourth Movement / May Fourth literature | |
| 现代性 | modernity | |
| 启蒙 | Enlightenment / qimeng | 中国语境时有时用拼音 |
| 革命叙事 | revolutionary narrative | |
| 文以载道 | literature as vehicle of the Way | |
| 言志/缘情 | expressing the will / arising from emotion | 中国诗学两大传统 |
| 兴观群怨 | xing-guan-qun-yuan | 孔子诗论,通常保留拼音 |
| 气韵 | qiyun / spirit resonance | 通常保留拼音 |
| 意境 | yijing / artistic conception | 通常保留拼音 |
| 神韵 | shenyun / spiritual charm | 通常保留拼音 |
| 江湖 | jianghu / rivers and lakes | 保留拼音 |
| 武侠 | wuxia / martial arts fiction | |
| 文化热 | culture fever | 1980年代文化讨论热潮 |
| 人文精神大讨论 | humanistic spirit debate | 1990年代知识界论争 |
| 纯文学/通俗文学 | pure literature / popular literature | |
| 样板戏 | model opera / revolutionary model plays | |
| 百花运动 | Hundred Flowers Campaign | |
| 左翼文学 | left-wing literature | |
| 鸳鸯蝴蝶派 | Mandarin Duck and Butterfly fiction | |
| 新感觉派 | Neo-Sensationist school | 1930年代上海现代派 |
16. 历史学核心术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 史料 | historical sources / primary sources | |
| 一手史料/二手史料 | primary sources / secondary sources | |
| 史料批判 | source criticism | |
| 编年史 | chronicle / annals | |
| 历史编纂学 | historiography | 既指写史方法,也指对写史行为本身的研究 |
| 历史主义 | historicism | |
| 新历史主义 | New Historicism | 格林布拉特提出 |
| 历史记忆 | historical memory | |
| 集体记忆 | collective memory | 阿尔布瓦克斯提出 |
| 记忆之场 | lieux de mémoire / sites of memory | 皮埃尔·诺拉 |
| 口述史 | oral history | |
| 微观史 | microhistory | 金兹伯格等 |
| 全球史 | global history / world history | |
| 长时段 | longue durée | 布罗代尔,年鉴学派 |
| 年鉴学派 | Annales School | |
| 心态史 | history of mentalities / mentalités | 年鉴学派 |
| 社会史 | social history | |
| 概念史 | conceptual history / Begriffsgeschichte | 科塞雷克 |
| 知识考古学 | archaeology of knowledge | 福柯(与历史学交叉) |
| 断裂/断代 | rupture / periodization | |
| 历史叙事 | historical narrative | |
| 历史目的论 | historical teleology | |
| 后设历史 | metahistory | 海登·怀特 |
| 历史诗学 | historical poetics | 海登·怀特 |
| 话语转义 | trope / emplotment | 海登·怀特 |
| 档案 | archive | 德里达/福柯均有使用 |
| 考证 | textual criticism / evidential research | 中国传统史学 |
| 正史/野史 | official history / unofficial history | |
| 春秋笔法 | Chunqiu rhetorical method | 通常保留拼音或解释 |
| 以史为鉴 | using history as a mirror |
17. 哲学核心术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 本体论 | ontology | |
| 认识论 | epistemology | |
| 形而上学 | metaphysics | |
| 伦理学 | ethics | |
| 逻辑学 | logic | |
| 美学 | aesthetics | |
| 先验 | transcendental / a priori | 康德 |
| 经验 | empirical / a posteriori | |
| 辩证法 | dialectics | 黑格尔/马克思 |
| 扬弃 | Aufhebung / sublation | 黑格尔,同时包含否定和保留 |
| 绝对精神 | absolute spirit / absoluter Geist | 黑格尔 |
| 物自体 | Ding an sich / thing-in-itself | 康德 |
| 范畴 | category / Kategorie | 康德/亚里士多德 |
| 主体间性 | intersubjectivity | 胡塞尔/哈贝马斯 |
| 生活世界 | lifeworld / Lebenswelt | 胡塞尔 |
| 实践智慧 | phronesis | 亚里士多德 |
| 善 | the Good / to agathon | 柏拉图 |
| 正义论 | theory of justice | 罗尔斯 |
| 无知之幕 | veil of ignorance | 罗尔斯 |
| 语言游戏 | language game / Sprachspiel | 维特根斯坦 |
| 家族相似性 | family resemblance | 维特根斯坦 |
| 知识型 | episteme | 福柯 |
| 话语实践 | discursive practice | 福柯 |
| 解释学循环 | hermeneutic circle | 伽达默尔 |
| 视域融合 | fusion of horizons / Horizontverschmelzung | 伽达默尔 |
| 道 | Dao / the Way | 中国哲学,保留拼音 |
| 气 | qi / vital energy | 中国哲学,保留拼音 |
| 理/气 | li and qi / principle and vital force | 朱熹理学 |
| 心即理 | the mind is principle | 王阳明心学 |
| 知行合一 | unity of knowledge and action | 王阳明 |
| 格物致知 | investigation of things and extension of knowledge | |
| 天人合一 | unity of heaven and humanity | |
| 中庸 | zhongyong / the Doctrine of the Mean | 保留拼音 |
18. 传播学与新闻学核心术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 大众传播 | mass communication | |
| 人际传播 | interpersonal communication | |
| 组织传播 | organizational communication | |
| 跨文化传播 | intercultural communication | |
| 媒介环境学 | media ecology | 波兹曼/麦克卢汉传统 |
| 议程设置 | agenda setting | 麦库姆斯与肖 |
| 框架理论 | framing theory | 戈夫曼/恩特曼 |
| 涵化理论 | cultivation theory | 格伯纳 |
| 使用与满足 | uses and gratifications | |
| 沉默的螺旋 | spiral of silence | 诺尔-诺伊曼 |
| 知沟理论 | knowledge gap theory | |
| 两级传播 | two-step flow of communication | 拉扎斯菲尔德 |
| 意见领袖 | opinion leader | 拉扎斯菲尔德 |
| 把关人 | gatekeeper / gatekeeping | 勒温 |
| 编码/解码 | encoding / decoding | 斯图亚特·霍尔 |
| 优先式/协商式/对抗式解读 | dominant / negotiated / oppositional reading | 霍尔 |
| 媒介素养 | media literacy | |
| 新闻专业主义 | journalistic professionalism | |
| 新闻框架 | news frame | |
| 公共新闻 | public journalism / civic journalism | |
| 调查性报道 | investigative journalism | |
| 叙事新闻 | narrative journalism | |
| 数据新闻 | data journalism | |
| 融合媒体 | media convergence | 亨利·詹金斯 |
| 参与文化 | participatory culture | 詹金斯 |
| 迷文化 | fan culture / fandom | |
| 公共舆论 | public opinion | |
| 舆论场 | public opinion field | |
| 网络舆情 | online public opinion / internet sentiment | |
| 回音室效应 | echo chamber effect | |
| 过滤气泡 | filter bubble | 帕里泽 |
| 信息茧房 | information cocoon | 桑斯坦 |
| 后真相 | post-truth | |
| 情感传播 | affective communication |
19. 社会学核心术语
| 中文 | 英文 | 说明 |
|---|---|---|
| 社会结构 | social structure | |
| 社会分层 | social stratification | |
| 社会流动 | social mobility | |
| 社会资本 | social capital | 布尔迪厄/普特南 |
| 文化资本 | cultural capital | 布尔迪厄 |
| 符号暴力 | symbolic violence | 布尔迪厄 |
| 场域 | field / champ | 布尔迪厄 |
| 惯习 | habitus | 布尔迪厄 |
| 社会化 | socialization | |
| 社会建构 | social construction | 伯格与卢克曼 |
| 社会事实 | social fact | 涂尔干 |
| 集体意识 | collective consciousness | 涂尔干 |
| 机械团结/有机团结 | mechanical / organic solidarity | 涂尔干 |
| 失范 | anomie | 涂尔干 |
| 理想类型 | ideal type / Idealtypus | 韦伯 |
| 合法性 | legitimacy | 韦伯 |
| 科层制 | bureaucracy | 韦伯 |
| 新教伦理 | Protestant ethic | 韦伯 |
| 理性化 | rationalization | 韦伯 |
| 铁笼 | iron cage / stahlhartes Gehäuse | 韦伯 |
| 符号互动论 | symbolic interactionism | 米德/布鲁默 |
| 标签理论 | labeling theory | 贝克尔 |
| 污名 | stigma | 戈夫曼 |
| 拟剧理论 | dramaturgical theory | 戈夫曼 |
| 前台/后台 | front stage / back stage | 戈夫曼 |
| 面子功夫 | face-work | 戈夫曼 |
| 日常生活 | everyday life | |
| 生命历程 | life course | |
| 风险社会 | risk society | 贝克 |
| 液态现代性 | liquid modernity | 鲍曼 |
| 规训社会/控制社会 | disciplinary society / society of control | 福柯/德勒兹 |
| 监控资本主义 | surveillance capitalism | 祖博夫 |
| 差序格局 | differential mode of association / chaxu geju | 费孝通,保留拼音 |
| 乡土社会 | earthbound society | 费孝通《乡土中国》 |
| 单位制 | work unit system / danwei | 中国社会学特有概念 |
文本评估系统使用指南
什么时候用
在以下时机对生成的文本运行评估:
1. 每次生成完整章节后:写完一章就检查一次,不要等全文写完 2. 用户要求检查时:用户说"帮我检查一下""看看有什么问题" 3. 定稿前最终检查:提交/投稿前做一次全面评估
怎么用
命令行调用
# 评估一个文件
python scripts/review.py paper.md
# 只看错误级别
python scripts/review.py paper.md --severity error
# JSON输出(方便程序处理)
python scripts/review.py paper.md --format jsonAgent 内部调用
from scripts.review import review
text = "论文文本内容..."
issues = review(text)
for issue in issues:
print(f"[{issue.severity.value}] {issue.rule}: {issue.message}")检查维度
| 编号 | 维度 | 检查内容 | 严重级别 |
|---|---|---|---|
| R1-01 | 可信度 | 「有学者指出」等模糊引用 | 错误 |
| R1-02 | 可信度 | [待补充] 占位符(提醒补充) | 提示 |
| R1-03 | 可信度 | 引用年份超过当前年份 | 错误 |
| R3-01 | 可信度 | 过度断言(毫无疑问、众所周知等) | 警告 |
| T-01 | 术语 | 同一概念使用多个中文译名 | 警告 |
| F-01 | 格式 | 空脚注 | 错误 |
| F-02 | 格式 | 参考文献缺少文献类型标识 | 警告 |
| F-03 | 格式 | 中文语境使用英文标点 | 警告 |
| F-04 | 格式 | 标题编号体系混用 | 警告 |
| S-01 | 语体 | 口语化表述 | 警告 |
| S-02 | 语体 | 自称用法不统一 | 警告 |
| L-01 | 论证逻辑 | 段落内连续多句缺少论证连接(只论不证) | 警告 |
| L-02 | 论证逻辑 | 连续多段以并列词开头(只证不论) | 警告 |
| L-03 | 论证逻辑 | 引文后缺少分析,直接跳到新话题 | 警告 |
| L-04 | 论证逻辑 | 章节开头缺少与上一章的逻辑衔接 | 提示 |
| L-05 | 论证深度 | 因果前提含价值判断但未论证("由于X并非Y") | 警告 |
| L-06 | 论证深度 | 长句中叙述成分过多,缺少分析性表述 | 提示 |
| L-07 | 论证深度 | 总结句堆砌了前文未充分展开的并列概念 | 警告 |
| L-08 | 论证深度 | 强度词(显然、极其)附近缺少充分论据 | 警告 |
| ST-01 | 结构 | 缺少摘要/关键词/参考文献 | 提示 |
| ST-02 | 结构 | 引言缺少论点句 | 警告 |
评估系统的边界
这个评估系统能做的:
- 用正则匹配发现确定性的格式和用词问题
- 比对术语表检查译名一致性
- 检查结构要素是否完整
这个评估系统不能做的(需要人工或模型辅助判断):
- 判断论点是否有说服力
- 判断论证逻辑是否连贯
- 判断文献引用是否准确(需要对照原文)
- 判断理论运用是否恰当
对于后者,应在 SKILL.md 的方法论指导下,由 agent 和用户共同判断。
人文社科常用理论框架速查
本文件收录人文社科论文中常被引用的理论家及其核心概念。 每个条目包含:核心概念、基本论点、适用场景、主要著作。
---
⚠ 找不到合适的理论框架怎么办
本表收录的是最常用的理论家,无法覆盖所有研究方向。如果用户的研究对象在本表中找不到匹配的框架,按以下步骤处理:
第一步:从材料出发,而不是从理论出发。 先问用户:你在材料里观察到了什么现象?这个现象的核心张力是什么?用一句不带任何理论术语的话描述它。
第二步:联网搜索匹配的理论资源。 根据用户描述的现象,搜索可能适配的理论:
- 搜索策略 A(按现象搜):
"[用户描述的现象]" theory framework academic - 搜索策略 B(按研究对象搜):
"[研究对象]" theoretical approach literature review - 搜索策略 C(按学科交叉搜):
"[研究对象]" AND ("[理论家A]" OR "[理论家B]" OR "[理论家C]") - 如果当前环境支持执行脚本,用
scripts/search.py在学术数据库中搜索相关文献,从已有研究中提取它们使用的理论框架
第三步:评估搜索到的框架是否合适。 用阶段二的测试标准判断:这个理论家是否已经在理论层面想透了材料里存在的问题?如果需要削足适履地改造材料来适应理论,就换一个。
第四步:如果确实找不到现成框架。 这不一定是坏事。有些原创性的研究恰恰需要自己建构分析框架,而不是套用现成理论。可以引导用户:从材料内部提炼核心概念,用这个概念作为分析工具贯穿全文,在结语中将其上升为有一定普遍性的分析框架。
---
目录
1. 让-吕克·南希(Jean-Luc Nancy)——共同体理论 2. 乔吉奥·阿甘本(Giorgio Agamben)——生命政治、例外状态 3. 米歇尔·福柯(Michel Foucault)——权力/知识、规训、话语 4. 雅克·德里达(Jacques Derrida)——解构、延异、法律的力量 5. 瓦尔特·本雅明(Walter Benjamin)——历史哲学、寓言、灵晕 6. 汉娜·阿伦特(Hannah Arendt)——公共领域、平庸之恶 7. 朱迪斯·巴特勒(Judith Butler)——操演性、脆弱性 8. 霍米·巴巴(Homi Bhabha)——混杂性、第三空间、后殖民 9. 爱德华·萨义德(Edward Said)——东方主义、文化与帝国主义 10. 雅克·拉康(Jacques Lacan)——精神分析、主体理论 11. 吉尔·德勒兹(Gilles Deleuze)——差异哲学、情动理论 12. 弗洛伊德(Sigmund Freud)——精神分析基础概念 13. 列维纳斯(Emmanuel Levinas)——他者伦理学 14. 阿尔都塞(Louis Althusser)——意识形态理论 15. 布尔迪厄(Pierre Bourdieu)——文学场、文化资本 16. 朗西埃(Jacques Rancière)——感性的分配、美学政治
---
1. 让-吕克·南希——共同体理论
适用场景:分析共同体的建构与瓦解、集体身份认同、政治暴力的内在逻辑、人与人之间联结的可能性
核心概念:
作品式共同体(communauté oeuvre) 试图通过仪式、铭刻、展演把人群铸造成有机整体的共同体。依赖排除异质者才能维持自身,最终走向死亡逻辑。适用于分析任何试图建立纯粹内在性的政治体或宗教体。
无为的共同体 / 非功效的共通体(communauté désoeuvrée) 不生产任何作品,不指向任何完成,只是独一存在者之间不断发生的、未完成的分享。正因永远未完成,才无法被极权逻辑捕获。
有限性共显(com-paraît) 有限存在者在彼此边界上的赤裸显现,先于语言和目的。"一个独一的存在者作为有限性本身而显现:与另一个独一的存在者的皮肤(或心脏)相接触而显现。"
神话的打断(l'interruption du mythe) 任何试图通过神话/起源叙事建立共同体的努力,在自身实现的时刻被内在悬搁。打断发生的地方,真实的共通才涌现。
主要著作:《无为的共同体》(La Communauté désoeuvrée,中译《解构的共通体》,上海人民出版社)
---
2. 乔吉奥·阿甘本——生命政治、例外状态
适用场景:分析国家权力对身体的管控、法律与生命的关系、被排除在政治之外的群体、姿势与纯粹手段性
核心概念:
赤裸生命(nuda vita) 被剥夺了政治属性的纯粹生物性生命,既被纳入法律秩序又被排斥在外。集中营是其极端形态。
例外状态(stato di eccezione) 主权者通过悬置法律来确立法律的效力。例外不是规则之外,而是规则本身的基础。
姿势(gesto) 既不是手段也不是目的,而是对"纯粹手段性"的展示。姿势打开了一个从目的-手段逻辑中解放出来的空间,是政治和伦理行动的可能基础。适用于分析文学或艺术中无法被工具化的行为/表达。
主要著作:《神圣人》(Homo Sacer)、《例外状态》、《手段即目的》(Means Without End)
---
3. 米歇尔·福柯——权力/知识、规训、话语
适用场景:分析权力如何通过知识生产来运作、身体的规训与管控、话语如何建构"真理"、主体如何被权力关系所构成
核心概念:
话语(discours) 不只是语言,而是生产知识、建构对象和主体的实践系统。分析某个领域的"话语",就是分析什么能被说出来、谁有权说、什么被排斥在可说之外。
规训权力(pouvoir disciplinaire) 通过监视、规范化、检查等技术对身体进行精细化管控的权力形式。全景监狱(Panopticon)是其理想模型。
生命政治(biopolitique) 针对"人口"这一生物性集合体的权力技术,管理出生率、死亡率、健康等生命过程。
知识/权力(savoir/pouvoir) 知识不是权力之外的中立物,知识的生产本身就是权力运作的一部分。
主要著作:《规训与惩罚》《性史》《知识考古学》
---
4. 雅克·德里达——解构、延异、法律的力量
适用场景:分析文本的内在矛盾、语言与意义的不稳定性、法律与正义的区分、礼物/好客/宽恕等伦理概念的悖论结构
核心概念:
延异(différance) 意义永远被推延,差异是意义得以产生的条件。没有任何词语能完全在场地指向它的所指。
法律与正义的区分 法律(droit)是可以被解构的——它是人为建构的,可以被质疑和改变;正义(justice)是不可被解构的——它是解构本身的动力。一个宣称自己执行"正义"的法律体系,其正义性始终是可质疑的。适用于分析任何涉及法律合法性的文本。
增补(supplément) 某个被当作外部附加物的东西,实际上揭示了原本结构的内在缺失。
主要著作:《论文字学》《法律的力量》《书写与差异》
---
5. 瓦尔特·本雅明——历史哲学、寓言、灵晕
适用场景:分析历史书写的政治性、被压迫者的历史与"官方历史"的张力、艺术复制与原真性、废墟与碎片作为历史认识的方式
核心概念:
历史天使(Angelus Novus) 面向过去的天使看见的是一场灾难的废墟堆积,却被"进步"的风暴吹向未来。用于批判线性进步史观,强调历史是由断裂和灾难构成的。
辩证意象(dialektisches Bild) 历史真相不在连续叙事中,而在过去与现在突然相遇的"闪现"时刻。批评者的任务是捕捉这些闪现。
灵晕(Aura) 艺术作品在特定时空中的独一无二性及其与传统的联系。机械复制摧毁了灵晕,但同时也解放了艺术的政治潜能。
寓言(Allegorie) 不同于象征(整体与意义的有机统一),寓言呈现的是碎片、废墟、意义的失落。是把握历史创伤的认识形式。
主要著作:《历史哲学论纲》《机械复制时代的艺术作品》《德国悲剧的起源》
---
6. 汉娜·阿伦特——公共领域、平庸之恶
适用场景:分析政治行动与公共空间的关系、极权主义的运作逻辑、责任与判断的伦理问题
核心概念:
公共领域(public realm) 人们通过言语和行动共同出现的空间,是政治自由的场所。与私人领域(生命需求)和社会领域(经济交换)相区别。
行动(action) 在公共领域中开创新事物的能力,是人最根本的政治能力。不同于劳动(维持生命)和工作(制造物品)。
平庸之恶(banality of evil) 极端邪恶的行为不一定来自邪恶的意图,而可能来自思维的停止——只是执行命令、服从程序,不进行道德判断。
主要著作:《人的条件》《极权主义的起源》《艾希曼在耶路撒冷》
---
7. 朱迪斯·巴特勒——操演性、脆弱性
适用场景:分析性别、身份认同的建构性、身体与权力的关系、哀悼与政治的关联
核心概念:
操演性(performativity) 身份(尤其是性别身份)不是预先存在的本质,而是通过反复的操演行为被建构出来的。没有操演之前的"真实"身份。
脆弱性(precarity / vulnerability) 身体对他者和环境的根本依赖性。脆弱性不只是个体弱点,而是所有生命的共同状况,是伦理关系的基础。
主要著作:《性别麻烦》《脆弱的生命》《战争的框架》
---
8. 霍米·巴巴——混杂性、后殖民
适用场景:分析殖民话语的内在矛盾、被殖民者对殖民权威的模拟与抵抗、文化翻译与第三空间
核心概念:
混杂性(hybridity) 殖民接触产生的文化混合,它不是两种纯粹文化的简单叠加,而是揭示了所有文化身份的建构性和不纯粹性。混杂性瓦解了殖民话语关于"纯粹"原始文化的神话。
模拟(mimicry) 被殖民者对殖民者的模仿,但这种模仿是"几乎一样,但又不完全一样"的,它在服从的同时暗含威胁,瓦解了殖民权威的稳定性。
第三空间(third space) 文化翻译和协商发生的"之间"地带,在这里固定的身份和意义被打开,新的文化形式得以涌现。
主要著作:《文化的定位》(The Location of Culture)
---
9. 爱德华·萨义德——东方主义
适用场景:分析西方对非西方的话语建构、知识生产与殖民权力的关系、文学和文化文本中的帝国主义意识形态
核心概念:
东方主义(Orientalism) 西方生产关于"东方"的知识的话语体系。东方不是被客观描述的,而是被西方的权力-知识结构所建构的。这套话语服务于殖民统治的合法化。
对位阅读(contrapuntal reading) 同时阅读殖民者与被殖民者的文本,在两者的对话与张力中揭示被主流叙事压制的声音。
主要著作:《东方主义》《文化与帝国主义》
---
10. 雅克·拉康——精神分析、主体理论
适用场景:分析欲望的结构、语言与无意识的关系、主体的分裂、文学文本中的创伤与重复
核心概念:
三界(the Real / the Symbolic / the Imaginary) 实在界是无法被语言捕获的创伤性内核;象征界是语言和社会秩序的领域;想象界是镜像认同和自我幻象的领域。三界相互缠绕,主体在三者的交织中被构成。
镜像阶段(mirror stage) 婴儿在镜中看到完整的自我形象,由此产生"我"的幻觉。但这个完整性是误认——主体从一开始就是分裂的。
大他者(the big Other) 象征秩序本身——语言、法律、社会规范的总和。主体的欲望是"大他者的欲望",即被社会秩序所塑造。
对象小a(objet petit a) 欲望的对象-原因,不是欲望指向的目标,而是驱动欲望运动的那个永远缺失的东西。
主要著作:《文集》(Écrits)、研讨班系列
---
11. 吉尔·德勒兹——差异哲学、情动理论
适用场景:分析文本/艺术中的生成与流变、挑战二元对立的思维方式、分析情动与身体的政治、非线性的时间与叙事
核心概念:
生成/变化(becoming) 不是从A变成B,而是处于不断流变中的状态。"变-女人""变-动物""变-少数"都不是要成为女人或动物,而是进入一种解域化的运动。
根茎(rhizome) 与树状的等级结构相对,根茎没有起点和终点,任意一点都可以与任意另一点连接。适用于分析去中心化的文本结构、网络化的文化现象。
解域化/再域化(deterritorialization / reterritorialization) 从固定的编码和领地中逃逸出去(解域化),但逃逸的线条又总是被重新捕获(再域化)。文学文本中的越界、逃逸、回归都可以用这对概念分析。
主要著作:《千高原》(与瓜塔里合著)、《差异与重复》、《感觉的逻辑》
---
12. 弗洛伊德——精神分析基础概念
适用场景:分析文学文本中的创伤、梦境、压抑、重复;分析叙事中的恐怖/怪异效果;分析丧失与哀悼
核心概念:
压抑与回归(repression and return) 被压抑的内容不会消失,而是以症状、梦、口误等形式回归。文学文本中的"不可言说之物"往往在叙事的裂隙中显现。
恐怖/怪异(the uncanny / das Unheimliche) 熟悉之物突然变得陌生而可怕。核心论点:恐怖感来自被压抑之物的回归。适用于分析哥特文学、恐怖叙事、日常生活中的异样感。
哀悼与忧郁(mourning and melancholia) 哀悼是正常的丧失处理过程,忧郁则是无法完成哀悼——失去的对象被内化为自我的一部分。适用于分析文学中的丧失、记忆与身份。
主要著作:《梦的解析》《超越快乐原则》《文明及其不满》
---
13. 列维纳斯——他者伦理学
适用场景:分析自我与他者的伦理关系、面容的召唤与责任、文学中的伦理维度
核心概念:
面容(visage / face) 他者的面容不是一个可被认知的对象,而是一个伦理召唤——它说"不要杀我"。面容的显现先于任何知识和主题化。
他者的优先性(priority of the Other) 伦理关系不是对称的。我对他者的责任是无限的、先于任何选择的。"我"首先是一个被他者的面容所召唤的回应者。
主要著作:《总体与无限》《异于存在》
---
14. 阿尔都塞——意识形态理论
适用场景:分析文学/文化文本中的意识形态运作、主体如何被社会结构所建构、症候阅读方法
核心概念:
意识形态国家机器(Ideological State Apparatus / ISA) 学校、家庭、宗教、媒体等机构通过意识形态(而非暴力)再生产现存的生产关系。文学和艺术也是意识形态国家机器的一部分。
询唤/质询(interpellation) 意识形态通过"嘿,你!"的召唤把个体建构为主体。个体在回应召唤的瞬间成为主体——成为服从于特定社会秩序的存在。
症候阅读(symptomatic reading) 不是读文本说了什么,而是读文本的沉默——它回避了什么问题?它的论证在哪里出现裂缝?裂缝处暴露了什么被压抑的矛盾?
主要著作:《意识形态和意识形态国家机器》《读〈资本论〉》
---
15. 布尔迪厄——文学场、文化资本
适用场景:分析文学生产的社会条件、作家的位置与策略、文学经典化的权力机制、品味与阶级的关系
核心概念:
文学场(literary field) 文学不是孤立的审美活动,而是一个相对自主的社会场域,有自己的游戏规则、位置结构和权力斗争。作家的创作选择(先锋还是通俗、长篇还是短篇)与他们在场域中的位置相关。
文化资本(cultural capital) 以知识、教育、品味等形式存在的社会资源。文化资本可以转化为经济资本和社会资本。文学阅读和文学批评本身就是文化资本的积累和展示。
惯习(habitus) 长期社会化过程中形成的持久性情倾向系统,既是社会结构的产物,又是实践的生成原则。
主要著作:《艺术的法则》《区分》
---
16. 朗西埃——感性的分配、美学政治
适用场景:分析文学/艺术如何重新分配可见与不可见、可说与不可说的边界;分析"谁有权发声"的政治问题
核心概念:
感性的分配(distribution of the sensible) 社会秩序的根基不是法律条文,而是对什么可以被感知、谁可以被看见和听见的预先分配。文学和艺术的政治性在于它们能够打乱这种分配。
歧感/歧义(dissensus) 真正的政治不是在既有框架内的利益协商,而是对"什么算政治议题""谁有资格参与"这一前提的根本争议。
主要著作:《感性的分配》《被解放的观众》《文学的政治》
---
17. 海登·怀特——历史叙事、后设历史
适用场景:分析历史书写中的叙事策略、质疑历史客观性的声称、分析历史文本的文学性
核心概念:
后设历史(metahistory) 历史书写不是对"事实"的客观再现,而是通过特定的叙事模式(浪漫剧、悲剧、喜剧、讽刺剧)来赋予事件以意义。历史学家的选择——先于他们的研究——已经决定了他们将"看到"什么。
话语转义(tropology / emplotment) 历史书写依赖四种基本修辞格(隐喻、换喻、提喻、反讽),这些修辞格不是装饰,而是历史认识的深层结构。不同的修辞策略产生不同的历史解释。
主要著作:《元史学》《话语转义》《形式之内容》
---
18. 斯图亚特·霍尔——文化研究、编码/解码
适用场景:分析媒介文本的意义生产与接收、分析文化表征中的权力关系、研究受众如何以不同方式解读媒介信息
核心概念:
编码/解码(encoding / decoding) 媒介文本的意义不是固定的。生产者对信息进行"编码"(嵌入特定意义),但受众在"解码"时可以采取三种立场:优先式解读(接受主导意义)、协商式解读(部分接受部分改写)、对抗式解读(完全拒绝主导意义并赋予替代含义)。
表征(representation) 文化中的意义不是现实的反映,而是通过语言、图像、符号等表征实践被生产出来的。表征总是涉及权力——谁有权定义谁、用什么方式定义。
主要著作:《编码/解码》《文化表征与意指实践》《文化身份与离散》
---
19. 韦伯——理想类型、合理化、社会行动
适用场景:分析社会制度的合法性基础、分析现代化过程中理性化的张力、构建分析性概念工具
核心概念:
理想类型(ideal type) 不是对现实的描述,而是一种分析工具——通过有意识地强调某些特征来构造一个纯粹的概念模型,用于与现实进行比较。任何现实现象都不会完全符合理想类型,但理想类型帮助我们看清现实的偏差和张力。
理性化(rationalization) 现代性的核心过程:传统的、情感的、价值理性的行为方式逐渐被工具理性所取代。科层制是理性化的典型产物——高效但冰冷,韦伯称之为"铁笼"。
主要著作:《新教伦理与资本主义精神》《经济与社会》《学术与政治》
---
20. 涂尔干——社会事实、团结、失范
适用场景:分析社会规范的形成与瓦解、分析个体与社会的关系、分析现代社会中的道德危机
核心概念:
社会事实(social fact) 社会现象不能还原为个体心理——它们是外在于个体、对个体具有强制力的事实。语言、法律、道德规范、宗教仪式都是社会事实。
机械团结与有机团结(mechanical / organic solidarity) 传统社会靠成员的相似性维系(机械团结),现代社会靠分工产生的相互依赖维系(有机团结)。从前者到后者的转变中,如果新的道德规范来不及建立,就会出现"失范"。
主要著作:《社会分工论》《自杀论》《宗教生活的基本形式》
写作模板与示范
本文件提供人文社科论文各部分的写作模板、正反面示范、体量适配建议。模板是起点而非终点——学会了套路之后要忘掉套路,用自己的方式写出有说服力的论证。
---
一、摘要
体量适配
| 论文类型 | 摘要字数 | 结构要求 |
|---|---|---|
| 课程论文(3,000-5,000字) | 150-200字 | 可以是一个完整段落,不分层 |
| 本科毕业论文(8,000-15,000字) | 200-400字 | 五层结构,各层可合并 |
| 硕士论文(30,000-50,000字) | 500-800字 | 五层结构完整展开 |
| 博士论文(80,000-150,000字) | 800-1,200字 | 五层结构充分展开,可加方法论说明 |
| 期刊论文(8,000-15,000字) | 按目标期刊要求(通常200-400字) | 精炼紧凑 |
五层结构
第一层:研究定位——你在研究什么,为什么值得研究
不是背景介绍,而是在一两句话内同时完成三件事:点明研究对象、交代学术脉络、暗示研究空白。
短论文写法(1-2句):
鲁迅《野草》自发表以来一直是中国现代文学研究的核心文本,已有研究多从政治隐喻或存在主义角度加以阐释,但较少追问其散文诗形式本身与创伤经验之间的结构性关联。
硕博论文写法(3-5句,可展开学术史脉络):
自20世纪80年代以来,鲁迅《野草》研究经历了从政治解读到审美分析、从存在主义到精神分析的多次范式转移。李欧梵(1987)将其置于现代性焦虑的框架中,汪晖(1988)强调其思想史意涵,孙歌(2004)则从"文学的位置"出发重新审视其文体实验的意义。然而,已有研究在分析文本内部的修辞装置时,较少追问散文诗这一形式选择本身与创伤经验的书写困境之间存在怎样的结构性关联——而这恰恰是理解《野草》如何处理"不可言说之物"的关键。
第二层:分析框架——你用什么工具来分析
不要只说"以XX理论为框架",要说清楚你用这个理论中的哪个概念来处理哪个问题。
短论文写法(1句):
本文借助本雅明的寓言理论,将散文诗形式理解为一种在意义废墟上进行碎片化书写的认识形式。
硕博论文写法(2-4句,说明为什么选这个框架而非其他):
本文借助本雅明的寓言理论作为核心分析框架。在本雅明的论述中,寓言不同于象征——象征将意义有机地融入整体,寓言则在碎片和废墟中展示意义的失落本身。这一区分为理解《野草》提供了关键的切入点:如果说此前的研究多将《野草》的晦涩归因于思想的复杂性,那么寓言理论使我们得以追问,这种晦涩本身是否就是一种积极的认识形式——在历史创伤使连贯叙事不再可能之后,碎片化的书写是否恰恰是唯一忠实于经验的方式。
第三层:各章论点——你做了什么、发现了什么
这是摘要最核心的部分。不是罗列各章"分析了什么",而是用递进逻辑串联各章的论证结论。
错误写法(描述性罗列):
❌ 第一章分析了《野草》的语言特征。第二章分析了《野草》的意象系统。第三章分析了《野草》与鲁迅其他作品的关系。
正确写法(递进论证):
第一章从《秋夜》《影的告别》等文本的语言层面入手,论证《野草》的碎片化句法并非修辞装饰,而是对连贯叙事能力之丧失的形式回应——在这些文本中,主语的反复取消和时态的持续漂移构成了一种"无法完成的言说"。第二章转向《死火》《墓碣文》等文本的意象系统,论证其核心意象(火、影、墓碣)并非象征特定的政治或哲学含义,而是作为寓言碎片,在意义的废墟上展示着意义本身的不可复原。第三章将《野草》放回鲁迅1924-1926年的整体写作中考察,论证散文诗形式的选择并非偶然的文体实验,而是鲁迅在经历了"呐喊"式启蒙叙事的失败之后,不得不发明的一种新的书写方式——一种不再试图传达明确信息、而是在语言内部容纳创伤的方式。
第四层:总体结论——你的论文证明了什么
不要重复第三层的内容,而是提升到更高层次:你的发现对理解更大的问题有什么意义。
短论文写法(1-2句):
本文认为,《野草》呈现的不只是一个作家的精神危机,而是在启蒙叙事失效之后,现代中文书写如何重新获得面对创伤的能力的一次根本性探索。
硕博论文写法(2-4句,可扩展到学科意义):
通过以上三个层面的分析,本文论证《野草》的散文诗形式不应被理解为鲁迅的文体实验或情绪宣泄,而是一种在历史创伤面前的认识论回应——当连贯的叙事和明确的意义表达不再可能时,碎片化的寓言书写成为唯一忠实于经验的形式。这一结论对重新理解中国现代文学中"形式"与"内容"的关系具有方法论意义:形式不是内容的容器,而是认识本身的一部分。
第五层:关键词
4-6个关键词,覆盖三个维度:研究对象、理论工具、核心发现。
关键词:鲁迅;《野草》;散文诗;寓言;创伤叙事;本雅明
摘要的常见错误
| 错误 | 表现 | 修改方向 |
|---|---|---|
| 背景过多 | 用三分之一篇幅介绍时代背景 | 背景压缩到一个从句内 |
| 只说做了什么,不说发现了什么 | "本文分析了X的Y" | 改为"本文论证X的Y呈现了Z" |
| 各章罗列而非递进 | "第一章…第二章…第三章…" | 用"在此基础上""由此转向"串联 |
| 结论重复各章 | 结论只是各章结论的叠加 | 结论要提升到更高层次 |
| 关键词过于宽泛 | "中国文学""现代性" | 缩小到具体概念 |
---
二、引言
体量适配
| 论文类型 | 引言字数 | 占全文比例 |
|---|---|---|
| 课程论文 | 300-600字 | 约10% |
| 本科毕业论文 | 800-1,500字 | 约10% |
| 硕士论文 | 2,000-4,000字 | 约8-10% |
| 博士论文 | 5,000-10,000字 | 约5-8%,可作为独立的"绪论"章 |
引言的五步结构
第一步:切入——从材料里一个有张力的细节开始
不要从"XXX是一部重要的作品"开始,不要从时代背景开始,不要从理论定义开始。从一个让读者也感到困惑或好奇的细节开始。
好的切入(从细节开始):
《野草》二十三篇散文诗中,"影"这个意象出现了不下十次,但几乎每次出现都伴随着自我取消的动作——影告别、影消失、影被黑暗吞没。一个反复出现却又反复自我否定的意象,在文本中究竟扮演什么角色?
差的切入(从背景开始):
❌ 鲁迅(1881-1936)是中国现代文学的奠基者,他的作品深刻反映了中国社会的变革。《野草》写于1924-1926年,是鲁迅创作的一组散文诗……
第二步:问题化——把细节转化为学术问题
从"这个细节很有趣"推进到"这背后有一个需要回答的学术问题":
这个问题不仅关乎单个意象的修辞功能,更指向一个根本性的难题:在《野草》中,言说本身为何总是走向自我取消?如果说《呐喊》和《彷徨》中的鲁迅仍然相信叙事能够传达意义,那么《野草》中发生了什么,使得连贯的表达变得不再可能?
第三步:学术史定位——已有研究做了什么,留下了什么
这一步的功能是告诉读者:这个问题别人想过,但没有想透。
短论文写法(3-5句,概括性交代):
关于《野草》的研究汗牛充栋。从政治解读(XXX)到存在主义分析(XXX),从精神分析(XXX)到比较文学视角(XXX),学界对这组文本的思想内涵已有深入挖掘。然而,已有研究在处理《野草》的"晦涩"时,多将其归因于思想的复杂性或情感的矛盾性,较少追问这种晦涩与散文诗形式本身之间的结构性关联。
硕博论文写法(1,000-3,000字,详细的文献综述,按论证功能分组——不是按时间罗列):
在这部分中,按"奠基型→对话型→空白型"组织文献。具体写法参见 literature-review.md 中的文献综述组织方式。第四步:分析框架——你打算怎么做
简洁交代理论工具和方法,不要在这里展开理论阐述(那是正文的事):
本文将借助本雅明的寓言理论来处理这个问题。寓言——与象征相对——呈现的不是意义的有机统一,而是意义在碎片和废墟中的失落本身。这一概念为理解《野草》的形式选择提供了关键的理论语言。
第五步:论点陈述——用一两句话说出你的核心论点
这是引言最重要的一句话。它应该是可争辩的、具体的、能概括全文论证方向的。
本文论证,《野草》的散文诗形式不是文体实验或情绪宣泄,而是在启蒙叙事失效后,一种在语言内部容纳创伤、而非传达信息的认识论回应。
引言的常见错误
| 错误 | 表现 | 后果 |
|---|---|---|
| 虎头蛇尾 | 背景写了一页,论点一句带过 | 读者记不住论点 |
| 述而不论 | 文献综述变成读书笔记 | 看不出你要做什么 |
| 承诺过大 | "全面考察""系统梳理" | 一篇论文做不到"全面" |
| 论点是描述性的 | "本文分析了X中的Y" | 缺少论证方向 |
| 引言和正文脱节 | 引言提的问题和正文分析的不是同一个 | 结构性问题 |
---
三、章节开头
章节的第一段决定了这一章的论证方向和阅读体验。
正确做法:从材料细节或上一章留下的张力切入
示范一(从材料细节切入):
《影的告别》以一句"人睡到不知道时候的时候,就会有影来告别"开篇。这个开头本身就值得停留:梦与醒的模糊边界、影子作为告别的主体而非被告别的对象、时间的不确定性——这些要素在第一句话中已经全部到场。
示范二(从上一章的张力承接):
上一章的分析表明,《野草》中的碎片化句法构成了一种"无法完成的言说"。但这个结论本身留下了一个疑问:如果言说总是走向中断,那么《野草》中反复出现的意象——火、影、墓碣——是否提供了另一种不依赖句法连贯性的意义生成方式?
错误做法
❌ 本章将运用本雅明的寓言理论来分析《野草》中的意象系统。本雅明(Walter Benjamin,1892-1940)是德国批判理论家,他在《德国悲剧的起源》中提出了寓言的概念……
问题:从理论定义开始,读者要等很久才知道这一章要论证什么。
---
四、章节结尾
结尾做三件事:收拢本章论点、点出遗留张力、引向下一章。
示范
通过以上分析可以看到,《野草》中"影"的反复出现与自我取消,构成了一种言说的悖论:必须说出口的东西恰恰是在说出口的瞬间失去效力的东西。这一悖论并非修辞技巧,而是《野草》面对创伤经验时的基本书写困境。然而,如果言说总是走向自我否定,那么《野草》为什么没有走向沉默?是什么力量使得鲁迅在1924年至1926年间持续地写下这些"无法完成的言说"?
注意:最后一句不是"下一章将分析……",而是一个从论证内部生长出来的问题——读者会自然想看下一章如何回应。
---
五、过渡段
连接两章的过渡段,做承前启后:上一章的结论→遗留的张力→为什么需要下一章。
示范
上一章论证了《野草》的碎片化句法是对连贯叙事能力之丧失的形式回应。但这个结论带出了一个新的层次的问题:如果句法层面的言说已经无法承载完整的意义,那么文本中密集出现的意象——火与灰、影与光、墓碣与死者——是否承担了句法无法完成的工作?换言之,《野草》是否在语言的碎片化之外,通过意象的寓言化开辟了另一条通达经验的路径?正是在这个意义上,本章将从句法层面转向意象层面的分析。
---
六、论点句写法
论点句是论文的骨架。每一章、每一节都应该有一个明确的论点句。
改写练习
| 改写前(描述性) | 改写后(论证性) | 区别在哪里 |
|---|---|---|
| 本文分析了《X》中的暴力书写 | 本文论证《X》中的暴力书写并非对历史暴力的再现,而是通过[机制]揭示了[问题] | 加了"并非A而是B"的论证方向 |
| 本章讨论了鲁迅的创伤叙事 | 本章论证鲁迅的创伤叙事在[文本]中采取了[形式],这一形式选择回应了[困境] | 加了具体的形式-困境对应 |
| 本节探讨了福柯的权力理论在文本中的体现 | 本节论证文本中[具体现象]的运作逻辑与福柯所描述的[概念]构成了精确的对应,这一对应揭示了[洞察] | 加了双向论证(文本→理论→洞察) |
论点句的自检标准
一个合格的论点句应该同时满足以下三个条件: 1. 可争辩——有合理的人可能不同意 2. 可论证——你能在接下来的分析中提供证据 3. 有方向——读者读完这句话知道你要往哪走
---
七、理论引入
短引入(1段,用于正文中按需引入概念)
本雅明在《德国悲剧的起源》中将"寓言"与"象征"对立起来:如果说象征呈现的是意义与形式的有机统一,那么寓言展示的恰恰是这种统一的不可能——碎片、废墟、意义的无法复原。这个区分为理解《野草》的意象系统提供了关键切入点:那些反复出现又反复消失的意象(影、火、墓碣),与其说是象征某种确定的含义,不如说是作为寓言碎片,在意义的废墟上展示着意义本身的失落。
长引入(2-3段,用于理论框架章节)
第一段定义概念:
本雅明在《德国悲剧的起源》中对"寓言"的重新阐发,构成了他历史哲学最重要的贡献之一。在本雅明看来,寓言不是一种低级的修辞手法(如古典修辞学传统所认为的那样),而是一种与象征根本不同的认识形式。象征将意义有机地融入感性形象,前提是意义与世界之间存在和谐的对应关系;寓言则出现在这种对应关系破裂之后——当世界不再能够被有机地把握时,碎片化的书写成为唯一忠实于经验的方式。
第二段论证为什么这个概念适用于你的材料:
这一区分之所以对理解《野草》具有阐释力,是因为《野草》正处于这样一个"对应关系破裂"的时刻。如果说《呐喊》时期的鲁迅仍然相信文学能够承载明确的启蒙信息——"铁屋子"的隐喻预设了一个可以被唤醒的听众,那么到了1924年的《野草》,这个预设已经崩塌。连贯的叙事让位于碎片化的散文诗,明确的寓意让位于"无法完成的言说"。本雅明的寓言概念恰恰为命名这一转变提供了精确的理论语言。
第三段落地到具体文本:
具体而言,本文将从以下三个层面运用这一概念:句法层面的碎片化(第一章)、意象层面的废墟化(第二章)、文体选择层面的寓言化(第三章)。需要说明的是,本文并非将本雅明的理论"套用"于《野草》,而是认为《野草》的文本实践与本雅明的理论思考之间存在一种结构性的呼应——二者都在回应同一个问题:当历史创伤使有机的意义表达不再可能时,书写如何继续?
理论引入的常见错误
| 错误 | 表现 | 修改方向 |
|---|---|---|
| 词典式介绍 | "福柯(1926-1984),法国哲学家……" | 直接从概念切入,传记放脚注 |
| 大段引用原文 | 引用理论家三四行原文 | 用自己的语言转述,原文留给注释 |
| 只定义不落地 | 解释完概念就进入下一个话题 | 定义之后必须说明和材料的对应关系 |
| 强行适配 | "福柯的理论可以应用于本文的分析" | 说清楚为什么能适配,而不是宣称能适配 |
---
八、结语
结语不是各章结论的简单重复,而是做三件事:收拢论证、回应引言、向更大问题敞开。
体量适配
| 论文类型 | 结语字数 |
|---|---|
| 课程论文 | 200-400字 |
| 本科毕业论文 | 500-1,000字 |
| 硕士论文 | 1,500-3,000字 |
| 博士论文 | 3,000-5,000字 |
结语的三步结构
第一步:收拢(不是重复各章结论,而是提炼出贯穿全文的核心洞察):
通过对《野草》句法、意象、文体三个层面的分析,本文论证了散文诗形式在鲁迅写作中的独特位置:它不是文体实验或情绪宣泄,而是在启蒙叙事失效之后,一种在语言内部容纳创伤的认识论回应。
第二步:回应引言(呼应引言提出的核心问题,形成闭合):
回到本文开头提出的问题——"影"这个反复出现又反复自我取消的意象在《野草》中扮演什么角色?现在我们可以说,影的自我取消恰恰是《野草》书写逻辑的核心:在意义不再能够被稳定地持有的历史时刻,只有通过不断取消自身,言说才能保持对经验的忠实。
第三步:向更大问题敞开(说明你的研究对理解更大的问题有什么意义):
这一结论或许也有助于重新思考中国现代文学史中一个更大的问题:形式创新与历史创伤之间的关系。《野草》提示我们,形式不是内容的外衣,而是认识本身的一部分——当一个时代的核心经验无法被既有的文学形式所承载时,新形式的发明本身就是一种思想行为。
---
九、脚注写法
脚注在人文社科论文中不只是标注出处,还有三种功能:
三种脚注功能
出处注(最基本):标注引文来源,格式参见 formatting-guide.md。
补充注(扩展论证):正文中放不下但值得提及的补充信息:
① 关于本雅明寓言概念的详细讨论,参见刘北成《本雅明思想肖像》第四章。本文此处的运用侧重于寓言作为认识形式的维度,与刘北成强调的政治维度有所不同。
辩护注(处理可能的反对意见):
② 有读者可能会质疑将本雅明的寓言概念用于分析中国文学的合法性。本文认为这种运用的基础不在于地域或文化的对应,而在于二者面对的问题结构的同构性:当有机的意义表达不再可能时,碎片化的书写如何成为一种认识形式。关于跨文化理论旅行的方法论问题,参见萨义德《理论的旅行》。
# 人文社科论文写作 skill - Python 依赖
# pip install -r requirements.txt
# 文献搜索脚本依赖
beautifulsoup4>=4.12.0 # HTML 解析(知网、万方、Google Scholar)
requests>=2.31.0 # HTTP 请求(备用)
# 文件读取依赖
PyMuPDF>=1.23.0 # PDF 文本提取(import fitz)
pdfplumber>=0.10.0 # PDF 表格/文本提取(备选)
python-docx>=1.0.0 # DOCX 读取/生成
# 可选:OCR(扫描件 PDF)
# pytesseract>=0.3.10 # 需要系统安装 tesseract-ocr
# Pillow>=10.0.0 # 图像处理
# 人文社科论文写作 - 学术文献搜索脚本集
# 人文社科论文写作 - 学术文献搜索配置
# 将此文件复制为 .env 并填入你的配置
# 没有配置的数据源会被自动跳过或以免费模式运行
# ── 知网 CNKI(需要配置才能用)──
# 从浏览器开发者工具中复制你的知网 Cookie
# CNKI_COOKIE=你的Cookie内容
# ── Google Scholar(推荐配置)──
# 从 https://serpapi.com 注册免费账号获取 API Key
# SERPAPI_KEY=你的SerpAPI密钥
# ── 以下数据源无需配置即可使用,配置后体验更好 ──
# ── OpenAlex(可选,配置 email 后速率更快更稳定)──
# OPENALEX_EMAIL=your@email.com
# ── CORE(可选,注册免费 Key 后速率更高)──
# 从 https://core.ac.uk/services/api 免费注册
# CORE_API_KEY=你的CORE密钥
# ── Semantic Scholar(可选)──
# S2_API_KEY=你的密钥
# ── CrossRef(可选,填入邮箱后速率更快)──
# CROSSREF_EMAIL=your@email.com
# ── 无需任何配置的数据源 ──
# 国家哲社文献中心 (NCPSSD) — 直接可用
# 万方数据 — 直接可用
"""统一的 HTTP 请求封装,供各数据源脚本调用"""
from __future__ import annotations
import urllib.request
import urllib.parse
import urllib.error
import ssl
import json
import logging
from typing import Optional
logger = logging.getLogger(__name__)
# 默认使用系统 SSL 证书验证
_SSL_CTX_SECURE = ssl.create_default_context()
# 仅在安全连接失败时作为 fallback,并发出警告
_SSL_CTX_INSECURE = ssl.create_default_context()
_SSL_CTX_INSECURE.check_hostname = False
_SSL_CTX_INSECURE.verify_mode = ssl.CERT_NONE
DEFAULT_UA = (
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
"(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
)
def get_text(
url: str,
params: Optional[dict] = None,
headers: Optional[dict] = None,
timeout: int = 15,
encoding: str = "utf-8",
) -> str:
"""发送 GET 请求,返回响应文本。默认验证 SSL,失败时 fallback 并警告。"""
if params:
url = url + "?" + urllib.parse.urlencode(params, quote_via=urllib.parse.quote)
req = urllib.request.Request(url)
req.add_header("User-Agent", DEFAULT_UA)
if headers:
for k, v in headers.items():
req.add_header(k, v)
# 先尝试安全连接
try:
with urllib.request.urlopen(req, timeout=timeout, context=_SSL_CTX_SECURE) as resp:
return resp.read().decode(encoding, errors="replace")
except ssl.SSLError as ssl_err:
# SSL 验证失败,fallback 到不验证,但发出警告
logger.warning(
"SSL verification failed for %s (%s), retrying without verification. "
"This may expose data to interception.",
url.split("?")[0], ssl_err,
)
try:
# 需要重新创建 Request 对象
req2 = urllib.request.Request(url)
req2.add_header("User-Agent", DEFAULT_UA)
if headers:
for k, v in headers.items():
req2.add_header(k, v)
with urllib.request.urlopen(req2, timeout=timeout, context=_SSL_CTX_INSECURE) as resp:
return resp.read().decode(encoding, errors="replace")
except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError) as e:
raise ConnectionError(f"HTTP request failed (SSL fallback): {e}") from e
except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError) as e:
raise ConnectionError(f"HTTP request failed: {e}") from e
def get_json(
url: str,
params: Optional[dict] = None,
headers: Optional[dict] = None,
timeout: int = 15,
) -> dict:
"""发送 GET 请求,解析 JSON 响应"""
text = get_text(url, params=params, headers=headers, timeout=timeout)
return json.loads(text)