%s（%s）
黑曜石内部的Claude Code——具有学术研究技能、内联差异编辑和MCP支持。
  
一个黑曜石插件，将Claude Code集成为侧边栏聊天面板。专为用黑曜石语写作并希望在文献综述、引文检查、手稿编辑和同行评审方面获得人工智能帮助的研究人员而设计，而无需离开他们的编辑。
船舶与 7学术研究技能 它作为斜线命令工作。 仅限桌面 （需要Claude Code CLI）。
______________________________________________________________________
快速开始
- 安装克劳德代码：
npm install -g @anthropic-ai/claude-code然后运行claude登录 - 克隆和构建：
git clone https://github.com/hkcanan/katmer-code.git && cd katmer-code && npm install && npm run build - 复制
main.js,manifest.json,styles.css进入/.obsidian/plugins/katmer-code/ - 启用 %s（%s） 黑曜石→ 设置→ 社区插件
- 学术技能：设置→ KatmerCode→ 打开+启用技能 允许Web请求
______________________________________________________________________
它的作用
- 在黑曜石内部运行克劳德代码（通过 代理SDK)
- 编辑您的手稿 内联差速器 --编辑器中的单词级跟踪更改（接受/撤消）
- 生成 HTML研究报告 （同行评审、引文分析、差距分析）可在黑曜石内部查看
- 连接到您的 MCP服务器 --在中配置的任何服务器
~/.claude.json自动工作 - 支持
/compact、选项卡、会话恢复、流媒体以及Claude Code终端可以做的一切
______________________________________________________________________
截图
聊天面板
Chat *文本选择自动附加为上下文。工具调用、思维块和侧边栏中的流式文本。*
内联差异编辑
Diff *单词级跟踪更改——删除文本用红色删除线，添加文本用绿色下划线。接受（✓）或撤消（✕）。*
同行评审报告
Report */peer-review 生成一份包含8个标准分数、雷达图和详细评估的HTML报告。*
引文验证和缺失参考文献
Citations *使用评估徽章进行索赔级别验证。按引用次数和相关性排列的缺失参考文献。*
______________________________________________________________________
学术技能
启用自 设置→ KatmerCode→ 学术技能。每个技能都以斜线命令的形式安装。
关于期望的说明： 这些技能是研究辅助工具，而不是神谕。他们查询真实的学术数据库（Semantic Scholar、CrossRef、OpenAlex、Unpaywall、arXiv、PubMed）并应用结构化分析，但输出是起点，而不是最终结论。A./peer-review报告不会取代人工审阅者。A./cite-verify如果数据库缺乏覆盖率，run可能会将有效引用标记为未验证。价值在于揭示你可能错过的东西：你没有考虑过的文献中的空白，你的参考文献中没有被引用的高引用论文，或者你的论点中的结构性弱点，当放在表格中时更容易看到。将报告用作地图，而不是领土。
技能是如何运作的
- 你提供了一份手稿 --活动文件、文件路径或选定文本。
- 克劳德阅读并分析了它 --解析结构，提取声明，识别引用。
- 查询API --该技能要求学术数据库进行交叉检查、搜索或丰富。
- 生成HTML报告 --有表格、图表和可操作的发现。
- 报告以《黑曜石》开头 --或者在浏览器中，由您选择。
对于较长的任务（引用验证的同行评审、研究差距分析），Claude使用 子代理 --同时处理分析不同部分的并行工作者。
可用技能
| 命令 | 它的作用 | 典型用例 |
|---|---|---|
/peer-review | 根据8个标准（原创性、论证结构、文献覆盖面、方法论等）评估你的手稿。生成雷达图和逐段反馈。 | 提交前：“审稿人可能会标记什么？” |
/cite-verify | 对照CrossRef、Semantic Scholar和OpenAlex检查每个引用。标记在作者姓名、年份或标题中不匹配。测试引用的声明是否得到消息来源的实际支持。 | 起草后：“我的引用准确吗？” |
/lit-search | 并行搜索arXiv、语义学者、PubMed和OpenAlex。按相关性对结果和排名进行重复。 | 开始一个新项目：“X上发布了什么？” |
/citation-network | 构建一个交互式引文图（vis.js），显示谁引用了谁。包括时间线视图。 | 理解一个领域：“这些论文是如何联系起来的？” |
/research-gap | 识别文献中的时间、方法、主题和应用差距。根据可行性和潜在影响对每个差距进行评分。 | 规划研究：“机会在哪里？” |
/journal-match | 分析你的手稿的参考资料，并根据你引用的来源发表的地方建议目标期刊。 | 准备提交：“哪本期刊适合这篇论文？” |
/abstract | 以5种格式生成摘要：结构化、叙述性、图形描述、亮点和社交媒体摘要。 | 定稿：“给我写一份结构化的摘要。” |
技能产出
/cite-verify --引文验证
Citation Verify *每个引用都会根据CrossRef、Semantic Scholar和OpenAlex进行检查。用评估徽章标记的问题——年份错误、可疑引用、建议修复。*
/journal-match --期刊建议
Journal Match *前10名期刊在范围、影响力、受众和接受度方面得分最高。对当前期刊进行优缺点评估。*
Journal Recommendation *具有最佳选择、强选择和安全选择的战略建议——每种选择都有推理。*
/research-gap --差距分析
Gap Matrix *按优先级和影响排列的差距。证据密度显示了每个地区的勘探不足程度。*
Gap Detail *每个差距包括证据库、研究问题、可行性评估和战略说明。*
Publication Trend *出版趋势图显示了随时间推移的实地活动，有助于确定新兴或衰退领域。*
报表设计
所有技能都可以使用共享设计系统生成HTML报告：
- Crimson Pro 衬线字体（学术书籍美学）
- Chart.js 用于雷达图、条形图、时间线
- Alpine.js 用于可折叠部分和交互元素
- 所有报告类型均采用一致的调色板、表格样式和徽章系统
报告在Obsidian（iframe查看器）或默认浏览器中打开。生成新报告时会自动显示通知。
一个实际的例子
假设你起草了一篇关于人工智能在法律推理中的应用的论文。以下是使用这些技能的一种方法：
/peer-review makaleler/demo-article.md--在询问同事之前，先进行结构化评估- 查看雷达图——注意“文献报道”得分较低
/lit-search AI legal reasoning hermeneutics--查找您可能遗漏的文件/cite-verify makaleler/demo-article.md--检查所有14个参考文献是否准确/journal-match makaleler/demo-article.md--查看哪些期刊发表了类似的工作- 根据调查结果编辑你的手稿，然后运行
/peer-review再次
没有一次跑步能给你一个明确的答案。但每一个都向你展示了一些你自己可能没有看到的东西。
______________________________________________________________________
需求
- 黑曜石 1.4.0+（仅限台式机-macOS、Windows或Linux）
- Claude 代码命令行工具 已安装并登录
- 克劳德账户 具有API访问权限
npm install -g @anthropic-ai/claude-code
claude # log in once安装
从源代码构建
git clone https://github.com/hkcanan/katmer-code.git
cd katmer-code
npm install
npm run build这将在项目根目录中生成三个文件： main.js, manifest.json，以及 styles.css.
将所有三个复制到您的保险库中：
mkdir -p /.obsidian/plugins/katmer-code
cp main.js manifest.json styles.css /.obsidian/plugins/katmer-code/然后启用 %s（%s） 黑曜石→ 设置→ 社区插件。
______________________________________________________________________
配置
| 设置 | 默认值 | 说明 |
|---|---|---|
| CLI路径 | claude | 自动检测到。如果需要，手动设置。 |
| 工作目录 | vault根目录 | 运行Claude会话的位置。 |
| 默认型号 | Sonnet | Opus、Opus 1M、Sonnet或Haiku |
| 权限模式 | 接受编辑 | 仅自动批准文件编辑 |
| 允许Web请求 | 关闭 | 学术技能所需（启用WebFetch、WebSearch、curl） |
MCP服务器（可选）
该插件从您的Claude Code配置继承MCP服务器(~/.claude.json).无需额外配置——如果您已经为终端Claude Code设置了MCP服务器，它们也可以在这里工作。
这些是 不需要 但如果安装了，可以提高学术技能：
- 论文搜索mcp --一台服务器上有20多个学术数据库
- arxiv mcp服务器 --arXiv支持PDF全文阅读
- openalex研究中心 --引文分析、趋势、期刊质量
没有MCP服务器，技能使用WebFetch直接调用API。这工作得很好——MCP服务器只是让它更快，使用更少的令牌。
______________________________________________________________________
运作原理
Obsidian
├── Editor (with inline diffs)
├── KatmerCode Chat (sidebar)
│ └── Agent SDK → Claude Code CLI subprocess
│ ├── Tools (Read, Edit, Write, Bash, Grep...)
│ ├── MCP servers (from your config)
│ └── Skills (~/.claude/commands/)
└── Report Viewer (iframe)技能是 .md 提示文件已安装到 ~/.claude/commands/ 当您在设置中启用它们时。它们在插件和终端中都能工作。
______________________________________________________________________
许可证
贡献
欢迎发布问题和PR。这是一个副项目，由一位研究人员为研究人员构建。