项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 已安装并可使用 Claude Code(或 Codex CLI / Kimi Code CLI / OpenCode)
- 系统具备 git 与 bash 环境
- Windows 用户需使用 Git Bash 或 WSL 运行安装脚本
- 对 ~/.claude 目录有写入权限
安装与启动步骤
-
1克隆仓库
把仓库克隆到 /tmp/claude-scholar,后续所有安装命令都基于该目录。
git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar -
2运行安装脚本
推荐方式,脚本为增量更新并会自动备份被覆盖的文件。Windows 请用 Git Bash 或 WSL。
bash /tmp/claude-scholar/scripts/setup.sh -
3合并 CLAUDE 配置
若你已有 CLAUDE.md,需手动查看 scholar 侧车文件并合并所需内容,侧车不会自动生效。
-
4可选插件安装
也可在 Claude Code 内用插件市场安装,技能/命令/代理/钩子会自动加载,规则仍需手动装。
/plugin marketplace add Galaxy-Dawn/claude-scholar /plugin install claude-scholar@claude-scholar -
5后续更新
进入克隆目录拉取最新代码后重跑安装脚本,保持增量更新。
cd /tmp/claude-scholar git pull --ff-only bash scripts/setup.sh -
6卸载
在克隆目录执行卸载脚本,只会删除安装状态中记录的文件与设置项。
cd /tmp/claude-scholar bash scripts/uninstall.sh
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
settings.json | 否 | Claude Code 配置,含 hooks、env、权限与 mcpServers;最小安装需手动合并模板条目。 | settings.json.template |
mcpServers | 否 | MCP 服务配置;安装器会保留你已有的 mcpServers 值不被覆盖。 | 保留原有 mcpServers 配置 |
如何确认成功
安装后确认 ~/.claude/.claude-scholar-manifest.txt 与 ~/.claude/CLAUDE.scholar.md 已生成,且 manifest 列出了受管文件。
常见问题
Q:Windows 下安装脚本跑不起来怎么办?
A:README 明确要求 Windows 使用 Git Bash 或 WSL 来运行安装脚本,直接在 CMD/PowerShell 中执行 bash 脚本可能不可用。
Q:安装会覆盖我现有的 CLAUDE.md 吗?
A:不会。安装器保留原有 ~/.claude/CLAUDE.md 与 CLAUDE.zh-CN.md,把仓库版本装成 CLAUDE.scholar.md 与 CLAUDE.zh-CN.scholar.md,需要你手动合并。
Q:最小安装/选择性安装后钩子没生效?
A:这两种方式不会自动合并 settings.json,需要你自行从 settings.json.template 中挑出需要的 hooks 或 MCP 条目复制过去。
Q:怎么更新到最新版本?
A:执行 cd /tmp/claude-scholar、git pull --ff-only、bash scripts/setup.sh,安装器支持增量更新并会先备份。
Q:如何安全卸载?
A:在克隆目录执行 bash scripts/uninstall.sh,它只删除安装状态记录的文件与设置项,不会凭当前仓库内容猜测归属。
注意事项
- 安装器会把被覆盖的文件备份到 ~/.claude/.claude-scholar-backups/
/,并把 settings.json 备份为 settings.json.bak。 - 安装会保留你已有的 env、模型/供应商设置、API 密钥、权限以及当前 mcpServers 值,缺失的 hook 条目是追加而非整体替换。
- 不同 AI 编程代理对应仓库不同分支:Codex CLI 用 codex 分支,Kimi Code CLI 用 kimi 分支,OpenCode 用 opencode 分支。
- ~/.claude/.claude-scholar-install-state 记录安装归属信息,卸载依赖它判断文件归属。
核心亮点
- 同时兼容 Claude Code、Codex CLI、Kimi Code CLI、OpenCode 四种主流代理,切换成本低
- 覆盖选题、编码、实验、写作、投稿全流程,而非只做代码补全
- 基于 MCP 与 Python 工具链,可接入本地实验环境与数据,扩展性较强
不足之处
- 半自动化定位意味着关键判断仍需人工介入,无法完全托管科研流程
- 多 CLI 适配带来配置复杂度,新手需要一定时间理解各代理差异
适用场景
- 研究生用 AI 代理管理实验脚本、记录结果并生成论文初稿
- 科研工程师在多个 AI 编程 CLI 之间复用同一套科研提示与工具链
- 独立研究者需要从选题到投稿的轻量级自动化辅助流程
替代项目
gpt-researcher、AutoGen、MetaGPT
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
