wiki-setup

用途：初始化新的 Obsidian wiki 仓库，或修复已有仓库的结构与配置，适用于新建仓库、生成 .env/config、重新配置或结构损坏时的修复。\n\n主要能力：\n1. 创建 .env：需向用户询问仓库路径 OBSIDIAN_VAULT_PATH（默认 ~/Documents/obsidian-wiki-vault，须为绝对路径）、来源目录 OBSIDIAN_SOURCES_DIR（可逗号分隔多个，默认 ~/Documents）、Claude 历史路径 CLAUDE_HISTORY_PATH（默认从 ~/.claude 自动发现）等。\n2. 可选 QMD 语义搜索：设置 QMD_WIKI_COLLECTION / QMD_PAPERS_COLLECTION / QMD_TRANSPORT，CLI 模式默认 QMD_CLI_SEARCH_MODE=quality；若已设置 wiki collection，需确认其 ignore 列表排除 _raw/**，必要时手工编辑 ~/.config/qmd/index.yml 后运行 qmd update，因为 qmd 无 --ignore 参数。\n3. 可选令牌预警 WIKI_TOKEN_WARN_THRESHOLD（默认 100000，设 0 关闭）与暂存写入 WIKI_STAGED_WRITES（默认 false；开启后新页面先入 _staging/，用 /wiki-stage-commit 审核提升）。\n4. 创建目录结构：mkdir -p "$OBSIDIAN_VAULT_PATH"/{concepts,entities,skills,references,synthesis,journal,projects,_archives,_raw,_staging,.obsidian}。\n5. 创建核心文件：obsidian-wiki setup --vault <path> [--timezone <IANA name>] 可一次生成 index.md、log.md、hot.md、空 .manifest.json（printf '{}\n' > "$OBSIDIAN_VAULT_PATH/.manifest.json"），以及 .obsidian 下的 app.json、appearance.json。\n6. 写入配置：按 llm-wiki/SKILL.md 的 Config Resolution Protocol 解析全局配置目录，仅在不存在时从模板复制生成 WRITING.md，不覆盖已有文件。\n7. 推荐可选社区插件：Dataview、Graph Analysis、Templater、Obsidian Git（均需用户手动安装）。\n\n使用方式：执行上述 setup 命令后，按清单核验仓库目录、index.md（含 timezone 时写入 frontmatter）、log.md、hot.md、.manifest.json、.env、.obsidian/、_staging/ 及 WRITING_PROFILE 路径，并确认来源目录可读。随后可在 Obsidian 中打开仓库，运行 wiki-status、wiki-ingest、claude-history-ingest、codex-history-ingest 等后续技能。\n\n可选附加：安装 Stop 钩子实现会话结束自动捕获（需合并到 ~/.claude/settings.json，注意不要覆盖已有 hooks；可用 WIKI_STOP_CAPTURE=false 跳过单次）；配置 GitHub 同步用 obsidian-wiki sync-setup "<repo-url>" --vault "$OBSIDIAN_VAULT_PATH"，之后用 obsidian-wiki sync 提交推送。\n\n限制：仓库路径须为展开后的绝对路径；QMD 集合与 papers 集合必须保持互斥，且需手工改 YAML 才能排除 _raw/；钩子与同步均为可选且需用户确认；未提供价格、平台支持范围等资料。