# ❓ 常见问题

[🇬🇧 English](FAQ.md) | [🇨🇳 中文](FAQ_CN.md)

---

## 常规问题

### Q: 这能帮我逃避 AI 检测器吗？

**A:** 主要目标是提高写作质量和真实性。作为副作用，自然的写作不太可能触发 AI 检测，但这不是主要目的。我们专注于教你*为什么*文本听起来像 AI 以及*如何*修复它——而不是"欺骗"检测系统。

---

### Q: 我可以用于论文/学位论文吗？

**A:** 可以，如果你用 AI 起草表达*你自己原创研究和想法*的文本。现在许多学者使用 AI 作为写作助手。关键是智力贡献必须是你的。

**适当的场景：**
- 你进行了研究，发展了论点，有清晰的想法
- 你用 AI 帮助起草表达这些想法的文本
- 你现在正在改进草稿的自然度
- ✅ 这是合乎道德的 AI 辅助使用

**不当的场景：**
- 你让 AI 生成你实际上没有进行的想法、论点或"研究"
- 你试图掩盖不是你智力贡献的作品
- ❌ 这是学术不端

---

### Q: 如果我不是社科领域怎么办？

**A:** 核心原则适用于所有领域：
- 变化句子节奏
- 删除机械过渡词
- 增加具体性而非抽象
- 自然整合引用

学科特定指导目前关注社科，但欢迎为其他领域贡献！检测和改写策略适用于任何学术写作。

---

### Q: 脚本需要网络连接吗？

**A:** 不需要。所有分析都使用 Python 标准库在本地运行：
- 没有 API 调用
- 不会发送数据到任何地方
- 无外部依赖
- 你的作品完全隐私

---

### Q: 可以用于英语以外的语言吗？

**A:** 目前针对英文学术写作优化。原则（句子变化、具体性、自然流畅）可能适用于其他语言，但：
- 检测模式是针对英语的
- 示例是英文的
- 过渡词列表是英文的

为其他语言做贡献将是项目的宝贵补充！

---

### Q: 与商业 AI 检测工具（如 GPTZero、Turnitin）相比如何？

**A:** 本工具的目的不同：

**商业检测器：**
- 告诉你"这可能是 AI 写的"（是/否）
- 黑箱评分
- 不教你任何东西

**本工具：**
- 向你展示*为什么*文本听起来像 AI
- 教你*如何*修复它
- 帮助你发展更好的写作技能
- 专注于学习和提高，而不仅仅是检测

把它想象成写作教练而不是检测器。

---

## 技术问题

### Q: 为什么需要 Python 3.7+？可以用旧版本吗？

**A:** Python 3.7 是必需的，因为使用了以下特性：
- `statistics.stdev()` 行为
- 字符串格式化方法
- 文件编码处理（在 Windows 上特别重要）

2018年以后的大多数系统都有 Python 3.7 或更高版本。如果你的系统较旧，建议升级 Python 以获得安全性和兼容性。

---

### Q: 我可以将其集成到自己的工具/工作流程中吗？

**A:** 可以！MIT License 允许：
- ✅ 用于商业项目
- ✅ 修改和重新分发
- ✅ 集成到其他工具
- ✅ 用于闭源项目

只需包含 LICENSE 文件中的版权声明。

---

### Q: 检测器说我的人类写作文本"像 AI"。怎么回事？

**A:** 检测器识别 *AI 写作中常见的模式*，这些模式也可能出现在：
- 模板化的学术散文
- 过于正式的写作
- 具有重复结构的文本

如果你的人类写作文本触发警告，这实际上是有用的反馈——意味着你的写作有使其不那么吸引人的模式。改写策略将帮助改进它！

---

### Q: 我可以用于 ChatGPT 以外的 AI 模型吗？

**A:** 当然！这些模式适用于来自以下模型的文本：
- ChatGPT（所有版本）
- Claude
- Gemini
- DeepSeek
- 任何其他 LLM

AI 写作模式在不同模型之间相当一致，因为它们源于 transformers 生成文本的方式（统计下一个 token 预测）。

---

## 使用问题

### Q: 人性化一篇论文需要多长时间？

**A:** 取决于长度和 AI 检测级别：
- **摘要（150-250词）：** 10-15分钟
- **章节（1000词）：** 30-45分钟
- **完整论文（6000-8000词）：** 2-4小时

随着练习，当你内化这些模式后会变得更快。

---

### Q: 我应该人性化所有内容还是只针对问题区域？

**A:** 先运行检测器，然后优先处理：
1. **高关注区域**（红旗）- 首先处理这些
2. **中等关注区域**（黄旗）- 如果时间允许修复
3. **低关注区域**（绿色）- 这些很好，专注于其他地方

专注于最像 AI 的部分以高效改进。

---

### Q: 我可以使用 Cursor AI 来帮助改写本身吗？

**A:** 可以！这是预期的工作流程：
1. 运行检测器脚本识别问题
2. 问 Cursor：*"你能用 humanize-academic-writing 技能帮我人性化这段话吗？"*
3. Cursor 自动应用改写策略
4. 你审查和完善

该技能指导 Cursor 正确应用原则。

---

### Q: 我需要在论文中引用这个工具吗？

**A:** 不需要在论文本身中。这是一个写作改进工具（像 Grammarly 或写作中心）。

**需要引用的情况：**
- 你在方法论文中*关于*这个工具写作
- 你在研究中讨论 AI 写作工具

**软件引用格式见主 README**

---

## 伦理问题

### Q: 用 AI 进行学术写作本身是否合乎道德？

**A:** 学术界仍在形成共识，但一般原则：

**越来越被接受：**
- AI 作为写作助手（像更高级的语法检查器）
- 改进你自己想法的清晰度
- 非母语者获得语言帮助

**通常不可接受：**
- AI 生成你没有的想法
- AI 创造你没有进行的"研究"
- 当你的机构要求披露时隐藏 AI 使用

**最佳实践：** 检查你的机构的 AI 政策，在透明度方面宁可过度。

---

### Q: 我应该向期刊/导师披露 AI 使用吗？

**A:** 遵循你的机构/期刊政策：
- 许多期刊现在要求 AI 披露声明
- 一些导师想知道；其他人只要想法是你的就不介意
- 透明通常是最安全的方法

**示例披露：**
> "AI 工具用于协助起草和提高手稿的清晰度。所有想法、论点和解释代表作者的原创智力贡献。"

---

### Q: "编辑"和"不端行为"之间有什么区别？

**A:** 一个有用的框架：

**可接受的编辑：**
- 修复语法/清晰度
- 改进句子流畅性
- 使你的想法更清晰
- 作为非母语者获得语言帮助

**不端行为：**
- 让某人/AI 写你不理解的论点
- 将 AI 生成的想法作为你自己的想法呈现
- 捏造你没有做的研究

**测试：** 你能解释和捍卫论文中的每一个主张吗？如果是，你就没问题。如果不是，那就有问题了。

---

## 故障排除

### Q: 检测器脚本出错。我该怎么办？

**常见问题：**

**Windows 上的 UnicodeEncodeError：**
- 最新版本已修复
- 从 GitHub 更新你的副本

**"找不到文件"：**
- 检查文件路径是否正确
- 对包含空格的路径使用引号：`"my file.txt"`

**导入错误：**
- 验证 Python 3.7+：`python --version`
- 不需要外部依赖

---

### Q: Cursor 技能没有激活。帮助！

**检查清单：**
1. 文件名为 `SKILL.md`（区分大小写）
2. 位于 `~/.cursor/skills/humanize-academic-writing/SKILL.md`
3. 安装后重启了 Cursor
4. 尝试明确提及它：*"使用 humanize-academic-writing 技能"*

---

### Q: 结果不够好。我做错了什么？

**常见问题：**

**没有解决根本模式：**
- 不要只是删除"Moreover"——改变整个句子结构
- 不要只是添加引用——自然地整合它们

**不够具体：**
- 用具体概念替换抽象
- 在具体文献/例子中扎根主张

**仍然太均匀：**
- 混合简短有力的句子和较长的分析句子
- 变化段落开头和过渡

查看 `docs/rewriting-principles_CN.md` 获取更深入的指导。

---

## 贡献

### Q: 我如何贡献？

**帮助的方式：**
- 添加学科特定示例（经济学、地理学、传播学）
- 改进检测算法
- 翻译成其他语言
- 分享你的前后示例
- 报告错误或建议功能

详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

---

### Q: 我发现了一个错误。在哪里报告？

**在 GitHub Issues 上报告：**
- [github.com/momo2young/humanize-academic-writing/issues](https://github.com/momo2young/humanize-academic-writing/issues)

**包括：**
- 你试图做什么
- 发生了什么 vs. 你期望什么
- 错误消息（如果有）
- 你的 Python 版本和操作系统

---

## 还有问题？

- **GitHub Issues：** [github.com/momo2young/humanize-academic-writing/issues](https://github.com/momo2young/humanize-academic-writing/issues)
- **邮箱：** pgallerymoon@gmail.com

我们在这里帮助你！🎓