setup

/setup

引导你完成 ΩmegaWiki 的可选 API key 配置。 读取当前 .env，展示已配置和未配置的内容，并帮助你逐步设置每个 key， 包括清晰解释每个 key 的作用和获取方式。 可随时重新运行，只更新你选择配置的 key。

Inputs

• 不需要任何参数
• 读取：.env（当前配置状态）
• 读取：config/setup-guide.md（每个 key 的参考说明）

Outputs

• 更新后的 .env（包含新配置的 key）
• 当前配置状态总结

Wiki Interaction

Reads

• 无（setup 在 wiki 创建之前运行）

Writes

• 无（不修改 wiki）

Workflow

Step 1：读取配置参考文档

读取 config/setup-guide.md，加载所有可配置 key 的完整参考信息， 包括每个 key 的作用、使用它的 skill、获取方式以及未配置时的降级行为。

Step 2：检测当前环境

运行以下命令检查已配置的内容：

python3 -c "
import sys, os
sys.path.insert(0, 'tools')
try:
    import _env
except Exception:
    pass
keys = {
    'SEMANTIC_SCHOLAR_API_KEY': 'Semantic Scholar',
    'DEEPXIV_TOKEN':            'DeepXiv',
    'LLM_API_KEY':              'Review LLM（API key）',
    'LLM_BASE_URL':             'Review LLM（base URL）',
    'LLM_MODEL':                'Review LLM（模型名）',
}
for k, label in keys.items():
    v = os.environ.get(k, '').strip()
    print(f'SET:{k}' if v else f'UNSET:{k}')
"

同时检测 Python 环境和 .venv 状态：

ls .venv/ 2>/dev/null && echo "venv:present" || echo "venv:absent"
python3 --version

Step 3：展示配置状态

向用户展示清晰的状态总结，按状态分组：

ΩmegaWiki 配置状态
================================
✓  ANTHROPIC_API_KEY      — 由 Claude Code 管理（claude login）

推荐配置：
✗  Semantic Scholar        — 未配置（引用链扩展速度慢 3 倍，建议配置免费 key）

可选：
✗  DeepXiv                 — 未配置（语义搜索不可用）
✗  Review LLM              — 未配置（跨模型 review 不可用）

询问用户："您想配置哪些？（可以跳过任意一个或全部）"

Step 4：配置各 Key（用户决定）

对用户想要配置的每个 key，按以下子流程处理。 写入 .env 前必须向用户确认。

---

4a：Semantic Scholar API Key

解释："Semantic Scholar 提供论文引用数据和检索功能。 被 /ingest、/init、/novelty、/ideate 使用。免费获取。 推荐配置 — 不配置的话，/init 速度慢 3 倍，引用链扩展效率大幅下降。"

引导获取："访问 https://www.semanticscholar.org/product/api， 点击 'Get API Key'，免费申请。"

询问："您是否有 Semantic Scholar API key？（粘贴，或输入 'skip' 跳过）"

如果提供了 key，写入 .env： 使用 Edit 工具更新 .env：

• 若已有 SEMANTIC_SCHOLAR_API_KEY=（即使为空），替换该行
• 否则追加 SEMANTIC_SCHOLAR_API_KEY=<值>

---