Zotero KB

本地 Zotero 文献卡片工作台。

当前能力

• 从本地 Zotero 数据目录读取条目、标签、笔记、collection 和附件文本
• 通过项目管理指定文献子集
• 生成 Markdown 知识卡片和 JSON 索引
• 提供项目内引用推荐和初版引用方案 API
• 提供最小 Web 控制台
• 提供 Claude Code / Codex 可直接读取的 skill 文件
• 支持按 Zotero collection 树浏览并逐篇选择文献导入到当前项目

本地运行

1. 安装依赖

UV_CACHE_DIR=/tmp/uv-cache uv sync --extra dev

2. 设置环境变量

export DEEPSEEK_API_KEY=你的_deepseek_api_key
export ZOTERO_DATA_DIR=/mnt/c/Users/WSX/Zotero
export ZOTERO_KB_WORKSPACE=workspace
export ZOTERO_BRIDGE_FILE=workspace/bridge/selected-items.json

如果你已经在 ~/.bashrc 里配过这些变量，这一步可以跳过。

3. 启动服务

UV_CACHE_DIR=/tmp/uv-cache uv run python main.py

4. 打开浏览器访问

http://127.0.0.1:8000

5. 在左侧点击 导入文献

• 先选择一个项目
• 点击 导入文献 打开全屏导入界面
• 左侧点击一个 Zotero collection
• 右侧会显示该 collection 直接包含的文献
• 逐篇勾选需要导入的文献
• 点击顶部 导入所选
• 文献列表默认只显示标题和年份
• 鼠标悬停标题 3 秒后会显示摘要预览
• 在窄屏或不方便 hover 的场景下，可点击 i 按钮查看摘要

默认环境变量：

• ZOTERO_DATA_DIR=/mnt/c/Users/WSX/Zotero
• ZOTERO_KB_WORKSPACE=workspace
• ZOTERO_BRIDGE_FILE=workspace/bridge/selected-items.json
• DEEPSEEK_API_KEY=...

如果项目创建时使用：

• llm_provider=deepseek
• llm_model=deepseek-chat

导入文献生成卡片时会自动读取 DEEPSEEK_API_KEY 调用 DeepSeek。

测试

UV_CACHE_DIR=/tmp/uv-cache uv run pytest -q