{"id":51406323,"url":"https://github.com/qxbyte/wiki-noosphere","last_synced_at":"2026-07-04T11:03:40.565Z","repository":{"id":354000220,"uuid":"1221721305","full_name":"qxbyte/wiki-noosphere","owner":"qxbyte","description":"Portable Obsidian LLM Wiki starter kit with Claude/Codex skills, MarkItDown ingestion, and local vault indexing.","archived":false,"fork":false,"pushed_at":"2026-04-26T16:16:44.000Z","size":50,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T18:13:25.318Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qxbyte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-26T15:43:25.000Z","updated_at":"2026-04-26T16:16:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/qxbyte/wiki-noosphere","commit_stats":null,"previous_names":["qxbyte/wiki-noosphere"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/qxbyte/wiki-noosphere","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fwiki-noosphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fwiki-noosphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fwiki-noosphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fwiki-noosphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qxbyte","download_url":"https://codeload.github.com/qxbyte/wiki-noosphere/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qxbyte%2Fwiki-noosphere/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35119016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-04T11:03:39.828Z","updated_at":"2026-07-04T11:03:40.555Z","avatar_url":"https://github.com/qxbyte.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wiki Noosphere\n\n`wiki-noosphere` 是一套面向 Obsidian 的本地 LLM Wiki 启动套件。它提供 Claude Code commands、Claude/Codex skills、MarkItDown 转换辅助脚本和 vault 索引器，用来快速创建、导入、整理和维护一套中文优先、适合检索和双链浏览的 Markdown 知识库。\n\n项目的核心思路是：脚本和运行程序保留在本项目中，Obsidian vault 只保存知识库内容。用户安装本项目后，在 Claude Code 或 Codex 中输入 startup 指令，即可由 agent 初始化 vault 目录、生成首页和首份索引报告。\n\n## 适合谁\n\n- 想把 PDF、网页、Office 文档、模型文档、工具资料整理到 Obsidian 的用户。\n- 想用 Claude Code 或 Codex 通过 skill/command 维护本地知识库的用户。\n- 想把已有 LLM Wiki 工作流迁移到另一台 Mac、Windows PC 或 Linux 机器的用户。\n\n## 项目包含什么\n\n```text\nwiki-noosphere/\n├── claude/\n│   ├── commands/\n│   │   ├── llm-wiki-startup.md\n│   │   ├── markitdown-cli.md\n│   │   ├── llm-wiki-obsidian.md\n│   │   └── wiki-sort.md\n│   └── skills/\n│       ├── harness-hub/\n│       ├── llm-wiki-startup/\n│       ├── llm-wiki-obsidian/\n│       ├── markitdown-cli/\n│       └── wiki-sort/\n├── codex/\n│   ├── commands/\n│   │   ├── llm-wiki-startup.md\n│   │   └── markitdown-cli.md\n│   └── skills/\n│       ├── harness-hub/\n│       ├── llm-wiki-startup/\n│       ├── llm-wiki-obsidian/\n│       ├── markitdown-cli/\n│       └── wiki-sort/\n├── scripts/\n│   ├── convert.py\n│   ├── init-vault.py\n│   ├── install.sh\n│   └── llm-wiki-indexer.py\n├── LICENSE\n└── README.md\n```\n\n说明：\n\n- `claude/commands`：Claude Code 斜杠命令，当前包含 `/llm-wiki-startup`、`/markitdown-cli`、`/llm-wiki-obsidian` 和 `/wiki-sort`。\n- `claude/skills`：Claude Code 使用的 skills。\n- `codex/commands`：Codex 命令入口。当前包含 `/llm-wiki-startup` 和 `/markitdown-cli`；是否自动读取取决于本机 Codex 版本，不能读取时用同名 skill 或自然语言触发。\n- `codex/skills`：Codex 使用的 skills。\n- `scripts/convert.py`：MarkItDown CLI 的封装，默认把转换结果写入 vault 的 `markitdown-input/YYYYMMDD/`。\n- `scripts/init-vault.py`：首次初始化 Obsidian LLM Wiki vault 目录。\n- `scripts/llm-wiki-indexer.py`：扫描 vault，生成检索地图和每日整理候选报告。\n- `scripts/install.sh`：安装套件、复制 skills/commands。vault 初始化建议交给 Claude Code 或 Codex 端的 startup 指令完成。\n\n本项目没有打包 Obsidian、Claude Code、Codex、Node.js、Python、MarkItDown 等外部程序。它只保存可迁移的工作流资产和必要脚本。\n\n## 依赖软件\n\n### 必装\n\n1. Git\n\n用于下载项目。\n\nmacOS:\n\n```bash\nxcode-select --install\n```\n\nWindows:\n\n```powershell\nwinget install --id Git.Git -e\n```\n\n2. Python 3.12 或更新版本\n\n`init-vault.py`、`convert.py`、`llm-wiki-indexer.py` 都使用 Python。Python 3.10+ 通常也能运行，但建议 3.12。\n\nmacOS:\n\n```bash\nbrew install python@3.12\npython3 --version\n```\n\nWindows:\n\n```powershell\nwinget install --id Python.Python.3.12 -e\npython --version\n```\n\n3. Node.js\n\nClaude Code CLI 通常依赖 Node.js/npm 生态安装和运行。建议使用 LTS 版本。\n\nmacOS:\n\n```bash\nbrew install node\nnode --version\nnpm --version\n```\n\nWindows:\n\n```powershell\nwinget install OpenJS.NodeJS.LTS\nnode --version\nnpm --version\n```\n\n4. Obsidian\n\n用于打开和浏览 Markdown vault。\n\nmacOS:\n\n```bash\nbrew install --cask obsidian\n```\n\nWindows:\n\n```powershell\nwinget install Obsidian.Obsidian\n```\n\n5. MarkItDown CLI\n\n[MarkItDown](https://github.com/microsoft/markitdown) 是 Microsoft 开源的文档转换工具，可以把 PDF、Word、Excel、PowerPoint、HTML、图片、音频、压缩包、URL 等内容转换为 Markdown。本项目通过 `markitdown-cli` skill 和 `scripts/convert.py` 对它做了一层封装，默认把转换结果放进 Obsidian vault 的 `markitdown-input/YYYYMMDD/`。\n\n推荐安装方式：\n\n```bash\npython3 -m pip install --user markitdown\nmarkitdown --help\n```\n\n如果需要使用插件能力，可以按 MarkItDown 官方文档安装插件版本或运行：\n\n```bash\nmarkitdown --list-plugins\n```\n\n如果系统找不到 `markitdown`，需要把 Python user bin 加入 `PATH`。常见路径：\n\nmacOS/Linux:\n\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\nWindows PowerShell:\n\n```powershell\n$env:Path += \";$env:APPDATA\\Python\\Python312\\Scripts\"\n```\n\n### 推荐安装\n\n1. ripgrep\n\nskills 会优先使用 `rg` 搜索本地 Markdown 和代码。\n\nmacOS:\n\n```bash\nbrew install ripgrep\n```\n\nWindows:\n\n```powershell\nwinget install BurntSushi.ripgrep.MSVC\n```\n\n2. Claude Code CLI\n\n如果你主要使用 Claude Code，需要安装并登录 Claude Code CLI。安装方式可能随官方发布变化，请以 Anthropic/Claude Code 官方文档为准。安装后确认：\n\n```bash\nclaude --help\n```\n\n3. Codex CLI 或 Codex 桌面端\n\n如果你主要使用 Codex，需要安装对应客户端，并让 Codex 能读取 `~/.codex/skills`。\n\n4. Obsidian CLI\n\nObsidian CLI 不是硬依赖。不同社区 CLI 语法不完全一致，本套 skills 会先检查 `obsidian --help` 或 `obsidian-cli --help`，可用时优先调用，不可用时直接编辑 Markdown 文件。\n\n## 快速安装\n\n1. 克隆项目\n\n```bash\ngit clone https://github.com/YOUR_NAME/wiki-noosphere.git\ncd wiki-noosphere\n```\n\n2. 一键安装到默认位置\n\n```bash\nbash scripts/install.sh\n```\n\n默认行为：\n\n- 把项目复制到 `~/.wiki-noosphere`。\n- 把 Claude commands 复制到 `~/.claude/commands`。\n- 把 Claude skills 复制到 `~/.claude/skills`。\n- 把 Codex commands 复制到 `~/.codex/commands`。\n- 把 Codex skills 复制到 `~/.codex/skills`。\n- 不立即初始化 Obsidian vault。初始化由 Claude Code 或 Codex 中的 startup 指令触发。\n\n3. 推荐把环境变量写入 shell profile\n\nmacOS/Linux zsh:\n\n```bash\ncat \u003e\u003e ~/.zshrc \u003c\u003c'EOF'\nexport WIKI_NOOSPHERE_HOME=\"$HOME/.wiki-noosphere\"\nexport LLM_WIKI_VAULT=\"$HOME/Obsidian/LLM-Wiki\"\nEOF\nsource ~/.zshrc\n```\n\nWindows PowerShell:\n\n```powershell\n[Environment]::SetEnvironmentVariable(\"WIKI_NOOSPHERE_HOME\", \"$HOME\\.wiki-noosphere\", \"User\")\n[Environment]::SetEnvironmentVariable(\"LLM_WIKI_VAULT\", \"$HOME\\Obsidian\\LLM-Wiki\", \"User\")\n```\n\n4. 在 Claude Code 或 Codex 中开箱启动\n\nClaude Code 推荐使用项目提供的 slash command：\n\n```text\n/llm-wiki-startup\n```\n\n指定 Obsidian vault 根目录：\n\n```text\n/llm-wiki-startup -path \"~/Obsidian/LLM-Wiki\"\n```\n\n你也可以在 Claude Code 或 Codex 对话里输入自然语言启动：\n\n```text\nstart up llm-wiki\n```\n\n```text\nstart up llm-wiki -path \"~/Obsidian/LLM-Wiki\"\n```\n\n说明：很多 CLI 的 slash command 名称不支持空格，所以本项目提供的正式 Claude Code 命令是 `/llm-wiki-startup`。如果你输入 `/start up llm-wiki -path \"...\"`，agent 应把它当作自然语言启动请求处理，触发 `llm-wiki-startup` skill。\n\nCodex 本机目录中可能存在 `~/.codex/commands`，本项目也会复制 `codex/commands/llm-wiki-startup.md`。如果你的 Codex 版本支持读取该目录，可以直接输入 `/llm-wiki-startup`；如果不支持，就输入 `start up llm-wiki -path \"...\"`，由 `llm-wiki-startup` skill 处理。\n\nstartup 会执行：\n\n```bash\npython \"${WIKI_NOOSPHERE_HOME:-$HOME/.wiki-noosphere}/scripts/init-vault.py\" --vault \"\u003cvault-root\u003e\"\npython \"${WIKI_NOOSPHERE_HOME:-$HOME/.wiki-noosphere}/scripts/llm-wiki-indexer.py\" --vault \"\u003cvault-root\u003e\" --scope all\n```\n\n它会创建或确认目录结构，生成 `00-索引/Home.md`，刷新 `00-索引/_system/llm-wiki-map.json` 和 `99-收件箱/每日整理候选.md`。\n\n5. 打开 Obsidian\n\n在 Obsidian 中选择 `Open folder as vault`，打开：\n\n```text\n~/Obsidian/LLM-Wiki\n```\n\n## 自定义路径安装\n\n如果你希望 vault 放在外置硬盘或同步盘：\n\n```bash\nbash scripts/install.sh \\\n  --kit-home \"$HOME/.wiki-noosphere\" \\\n  --vault \"/path/to/your/Obsidian/LLM-Wiki\"\n```\n\n安装时顺便初始化 vault，不通过 agent startup：\n\n```bash\nbash scripts/install.sh --init-vault\n```\n\n只安装 Claude Code 资产：\n\n```bash\nbash scripts/install.sh --claude-only\n```\n\n只安装 Codex 资产：\n\n```bash\nbash scripts/install.sh --codex-only\n```\n\n显式保持只安装 assets、不初始化 vault：\n\n```bash\nbash scripts/install.sh --no-init-vault\n```\n\n只测试项目复制，不写入 `~/.claude`、`~/.codex`，也不初始化 vault：\n\n```bash\nbash scripts/install.sh --kit-only --kit-home /tmp/wiki-noosphere-test\n```\n\n## 手动部署\n\n如果不想使用安装脚本，可以手动复制。\n\nClaude Code:\n\n```bash\nmkdir -p ~/.claude/commands ~/.claude/skills\ncp -R claude/commands/* ~/.claude/commands/\ncp -R claude/skills/* ~/.claude/skills/\n```\n\nCodex:\n\n```bash\nmkdir -p ~/.codex/commands ~/.codex/skills\ncp -R codex/commands/* ~/.codex/commands/\ncp -R codex/skills/* ~/.codex/skills/\n```\n\n脚本套件：\n\n```bash\nmkdir -p ~/.wiki-noosphere\ncp -R scripts ~/.wiki-noosphere/\nexport WIKI_NOOSPHERE_HOME=\"$HOME/.wiki-noosphere\"\nexport LLM_WIKI_VAULT=\"$HOME/Obsidian/LLM-Wiki\"\n```\n\n脚本不要复制到 Obsidian vault 中。`scripts/` 应始终保留在项目安装目录，例如：\n\n```text\nmacOS/Linux: ~/.wiki-noosphere/scripts/\nWindows:     %USERPROFILE%\\.wiki-noosphere\\scripts\\\n```\n\nskills 和 commands 通过 `WIKI_NOOSPHERE_HOME` 定位这些脚本，因此不依赖用户机器上的个人绝对路径。\n\n初始化 vault：\n\n```bash\npython3 \"$WIKI_NOOSPHERE_HOME/scripts/init-vault.py\" --vault \"$LLM_WIKI_VAULT\"\n```\n\n## Vault 目录结构\n\n执行 `/llm-wiki-startup` 后会创建或确认以下目录：\n\n```text\n00-索引/\n00-索引/_system/\n01-概念/\n02-模型/\n03-提供方/\n04-工具/\n05-工作流/\n06-提示词/\n07-评估/\n08-来源/\n09-日记/\n99-收件箱/\nmarkitdown-input/\n```\n\n同时会创建或刷新以下关键文件：\n\n```text\n00-索引/Home.md\n00-索引/_system/llm-wiki-map.json\n99-收件箱/每日整理候选.md\n```\n\n其中 `00-索引/Home.md` 和各主要目录的 `说明.md` 由初始化脚本创建；`00-索引/_system/llm-wiki-map.json` 和 `99-收件箱/每日整理候选.md` 会在 startup 运行首轮索引后生成或刷新。\n\n## markitdown-input 是什么\n\n`markitdown-input/` 是新导入材料的暂存区。推荐流程：\n\n1. 用 MarkItDown 把 PDF、网页、docx、xlsx、pptx 等资料转换成 Markdown。\n2. 输出到 `markitdown-input/YYYYMMDD/`。\n3. 运行 `/wiki-sort` 扫描新输入。\n4. 查看 `99-收件箱/每日整理候选.md`。\n5. 再让 agent 按 LLM Wiki 规则归档、拆分、建立索引和双链。\n\n示例：\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" ~/Downloads/paper.pdf\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" https://example.com/article --name example-article\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" ~/Downloads/report.docx --output \"$LLM_WIKI_VAULT/markitdown-input/manual\"\n```\n\n转换后运行：\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/llm-wiki-indexer.py\" --vault \"$LLM_WIKI_VAULT\" --scope markitdown-input\n```\n\n## Claude Code 使用\n\n安装后，Claude Code 会读取：\n\n```text\n~/.claude/commands/\n~/.claude/skills/\n```\n\n### /llm-wiki-obsidian\n\n用途：让 Claude Code 按中文优先的 LLM Wiki 规则整理当前 Obsidian vault。\n\n示例：\n\n```text\n/llm-wiki-obsidian 请为 04-工具 下的 Claude Code、Codex、MarkItDown 建立工具索引\n```\n\n```text\n/llm-wiki-obsidian 把 markitdown-input/20260426 中的资料整理为来源笔记，并链接到 00-索引/Home\n```\n\n### /wiki-sort\n\n用途：扫描 `markitdown-input/`，生成整理候选报告。默认只生成报告，不移动、不删除、不改写原始笔记。\n\n示例：\n\n```text\n/wiki-sort\n```\n\n实际运行的命令等价于：\n\n```bash\npython \"${WIKI_NOOSPHERE_HOME:-$HOME/.wiki-noosphere}/scripts/llm-wiki-indexer.py\" --vault \"${LLM_WIKI_VAULT:-$HOME/Obsidian/LLM-Wiki}\" --scope markitdown-input\n```\n\n### /wiki-sort all\n\n用途：扫描整个 vault，检查坏链、孤立笔记、重复标题、缺少用途段等。\n\n示例：\n\n```text\n/wiki-sort all\n```\n\n实际运行的命令等价于：\n\n```bash\npython \"${WIKI_NOOSPHERE_HOME:-$HOME/.wiki-noosphere}/scripts/llm-wiki-indexer.py\" --vault \"${LLM_WIKI_VAULT:-$HOME/Obsidian/LLM-Wiki}\" --scope all\n```\n\n### /llm-wiki-startup\n\n用途：首次开箱启动 LLM Wiki。它会根据默认路径或 `-path` 指定路径创建 Obsidian vault 目录、生成说明页、建立 Home 入口，并运行首轮全库索引。\n\n默认路径：\n\n```text\n${LLM_WIKI_VAULT:-$HOME/Obsidian/LLM-Wiki}\n```\n\n示例：\n\n```text\n/llm-wiki-startup\n```\n\n```text\n/llm-wiki-startup -path \"~/Obsidian/LLM-Wiki\"\n```\n\n自然语言等价写法：\n\n```text\nstart up llm-wiki -path \"~/Obsidian/LLM-Wiki\"\n```\n\n## Codex 使用\n\nCodex 使用 skills；部分 Codex 版本也会读取 `~/.codex/commands`。安装后，本项目会放置：\n\n```text\n~/.codex/commands/\n~/.codex/skills/\n```\n\n如果你的 Codex 支持 commands，可以直接输入：\n\n```text\n/llm-wiki-startup\n```\n\n推荐在 Codex 中直接输入自然语言触发对应 skill：\n\n```text\nstart up llm-wiki\n```\n\n```text\nstart up llm-wiki -path \"~/Obsidian/LLM-Wiki\"\n```\n\n```text\n使用 llm-wiki-obsidian，把当前 vault 的 04-工具 建成工具索引\n```\n\n```text\n/wiki-sort\n```\n\n```text\n使用 markitdown-cli，把 ~/Downloads/report.pdf 转成 Markdown 并放入 markitdown-input\n```\n\n如果 Codex 没有自动继承环境变量，可以在任务中明确 vault：\n\n```text\nLLM_WIKI_VAULT 是 ~/Obsidian/LLM-Wiki，请运行 wiki-sort all 并总结报告。\n```\n\n## 基于知识库提问\n\n安装并运行 `/llm-wiki-startup` 后，Claude Code 可以通过 `llm-wiki-obsidian` skill 按索引链路检索本地 Obsidian LLM Wiki。推荐在问题里明确写出“基于本地 LLM Wiki”或“基于我的 Obsidian 知识库”，这样 agent 会按 skill 中的“问答检索流程”工作：先读 `00-索引/Home.md`，再根据问题进入相关分类索引，只读取回答所需的链接笔记。\n\nClaude Code 命令示例：\n\n```text\n/llm-wiki-obsidian 请基于本地 LLM Wiki 回答：Claude Code 和 Codex 在本项目中的部署差异是什么？\n```\n\n```text\n/llm-wiki-obsidian 请基于我的 Obsidian LLM Wiki 检索：MarkItDown 导入资料后应该怎么整理？请说明依据来自哪些笔记。\n```\n\n自然语言示例：\n\n```text\n请使用 llm-wiki-obsidian，基于本地 LLM Wiki 回答：我应该如何维护 04-工具 目录？\n```\n\n```text\n基于我的 Obsidian LLM Wiki 检索一下 RAG 评估相关笔记，只读取必要的索引和链接笔记，并在回答末尾列出依据笔记。\n```\n\nCodex 中也可以用同样的自然语言触发：\n\n```text\n使用 llm-wiki-obsidian，基于本地 LLM Wiki 回答：wiki-sort 和 markitdown-input 的关系是什么？\n```\n\n如果刚导入新资料，先运行 `/wiki-sort`；如果想让回答覆盖全库健康状态或旧资料关系，先运行 `/wiki-sort all` 刷新检索地图和整理候选报告。\n\n## Claude Code 和 Codex 的部署差异\n\nClaude Code:\n\n- commands 放在 `~/.claude/commands`。\n- skills 放在 `~/.claude/skills`。\n- `/wiki-sort`、`/llm-wiki-obsidian` 这类 slash command 可直接触发。\n- 更适合通过命令模板固定工作流入口。\n\nCodex:\n\n- commands 放在 `~/.codex/commands`。是否可用取决于当前 Codex 版本；不可用时不影响 skills。\n- skills 放在 `~/.codex/skills`。\n- 通过 command、skill 描述、自然语言、或明确输入 `/wiki-sort` 触发。\n- 更适合在工程项目里结合代码搜索、脚本验证、README/交付文档一起处理。\n\n共同点：\n\n- 两者都使用同一套 portable scripts。\n- 两者都可以维护同一个 Obsidian vault。\n- 两者都应避免把私人 vault 内容发送到网络服务，除非用户明确允许。\n\n## Skills 说明和示例\n\n### llm-wiki-startup\n\n用途：首次开箱启动 Obsidian LLM Wiki。安装项目资产后，用户在 Claude Code 或 Codex 端输入启动指令，由 agent 调用本项目脚本初始化目录和首轮索引。\n\n支持的输入形式：\n\n```text\n/llm-wiki-startup\n```\n\n```text\n/llm-wiki-startup -path \"~/Obsidian/LLM-Wiki\"\n```\n\n```text\nstart up llm-wiki -path \"~/Obsidian/LLM-Wiki\"\n```\n\n如果没有指定 `-path`，默认使用当前用户目录下的：\n\n```text\n~/Obsidian/LLM-Wiki\n```\n\n启动后会生成或刷新：\n\n```text\n00-索引/Home.md\n00-索引/_system/llm-wiki-map.json\n99-收件箱/每日整理候选.md\nmarkitdown-input/\n```\n\n### llm-wiki-obsidian\n\n用途：创建、整理、重构或维护本地 Obsidian LLM Wiki。\n\n它会优先采用中文目录模型：\n\n```text\n00-索引/\n01-概念/\n02-模型/\n03-提供方/\n04-工具/\n05-工作流/\n06-提示词/\n07-评估/\n08-来源/\n09-日记/\n99-收件箱/\n```\n\n示例：\n\n```text\n请使用 llm-wiki-obsidian，为 MCP、RAG、工具调用分别创建概念笔记，并加入 01-概念/说明.md。\n```\n\n```text\n请检查 02-模型 下面有没有重复标题，把重复项列出来，不要直接删除。\n```\n\n### wiki-sort\n\n用途：运行索引器，生成 `llm-wiki-map.json` 和 `每日整理候选.md`。\n\n示例：\n\n```text\n/wiki-sort\n```\n\n```text\n/wiki-sort all\n```\n\n命令行手动运行：\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/llm-wiki-indexer.py\" --vault \"$LLM_WIKI_VAULT\" --scope markitdown-input\npython \"$WIKI_NOOSPHERE_HOME/scripts/llm-wiki-indexer.py\" --vault \"$LLM_WIKI_VAULT\" --scope all\n```\n\n### markitdown-cli\n\n用途：调用 Microsoft 开源的 [MarkItDown](https://github.com/microsoft/markitdown)，把外部资料转换为 Markdown，并把结果放到 `markitdown-input/YYYYMMDD/`，方便后续用 `/wiki-sort` 生成整理候选。\n\n示例：\n\n```text\n/markitdown-cli ~/Downloads/openai-doc.pdf\n```\n\n```text\n/markitdown-cli https://example.com/post --name example-post\n```\n\n```text\n使用 markitdown-cli，把 ~/Downloads/openai-doc.pdf 转成 Markdown。\n```\n\n命令行等价用法：\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" ~/Downloads/openai-doc.pdf\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" ~/Downloads/slides.pptx --name openai-slides\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" https://example.com/post --name example-post\n```\n\n常用参数：\n\n- `--output /path/to/file.md`：指定输出文件。\n- `--output /path/to/directory`：指定输出目录。\n- `--name custom-name`：为 URL、stdin 或复杂文件名指定输出文件名。\n- `--extension .pdf`：在输入缺少扩展名时提示文件类型。\n- `--use-plugins`：启用已安装的 MarkItDown 插件。\n\n### harness-hub\n\n用途：把需求按工程交付方式闭环，适合需要方案、实现、测试、复核和交付说明的开发任务。\n\n示例：\n\n```text\n使用 Harness Hub，帮我给 llm-wiki-indexer 增加一个 --strict 模式，并补充 README。\n```\n\n注意：只有当任务确实较复杂，或用户明确要求 Harness Hub 多角色模式时，才需要启用多角色/子代理协作。简单单文件改动不必强行使用。\n\n## 索引器行为\n\n`llm-wiki-indexer.py` 会：\n\n- 扫描 vault 中的 Markdown 文件。\n- 解析 frontmatter、标题、wikilink、标签、别名、摘要。\n- 生成 `00-索引/_system/llm-wiki-map.json`。\n- 生成 `99-收件箱/每日整理候选.md`。\n- 检查坏链、孤立笔记、缺少用途段、重复标题、疑似项目目录。\n- 对敏感路径只做路径级索引，避免自动摘取正文摘要。\n\n敏感路径规则默认包含：\n\n```text\n账号\n激活\n权限申请\n系统\n```\n\n## 常见维护流程\n\n### 导入一份 PDF\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/convert.py\" ~/Downloads/paper.pdf\npython \"$WIKI_NOOSPHERE_HOME/scripts/llm-wiki-indexer.py\" --vault \"$LLM_WIKI_VAULT\" --scope markitdown-input\n```\n\n然后对 agent 说：\n\n```text\n请使用 llm-wiki-obsidian，阅读每日整理候选，把刚导入的 paper 拆成来源笔记和相关概念笔记。\n```\n\n### 做全库健康检查\n\n```bash\npython \"$WIKI_NOOSPHERE_HOME/scripts/llm-wiki-indexer.py\" --vault \"$LLM_WIKI_VAULT\" --scope all\n```\n\n然后打开：\n\n```text\n99-收件箱/每日整理候选.md\n```\n\n### 迁移到新电脑\n\n1. 安装 Git、Python、Node.js、Obsidian、MarkItDown、Claude Code 或 Codex。\n2. clone 本项目。\n3. 运行 `bash scripts/install.sh --vault \"你的 vault 路径\"`。\n4. 如果已有 vault，把旧 vault 内容复制到新 vault 路径。\n5. 运行 `/wiki-sort all` 检查坏链和索引状态。\n\n## Windows 注意事项\n\n本项目的 `install.sh` 适合 macOS/Linux/Git Bash/WSL。Windows 用户有三种选择：\n\n- 使用 WSL 运行安装脚本。\n- 使用 Git Bash 运行安装脚本。\n- 按“手动部署”章节复制文件。\n\nPowerShell 下路径建议写成：\n\n```powershell\n$env:WIKI_NOOSPHERE_HOME=\"$HOME\\.wiki-noosphere\"\n$env:LLM_WIKI_VAULT=\"$HOME\\Obsidian\\LLM-Wiki\"\npython \"$env:WIKI_NOOSPHERE_HOME\\scripts\\init-vault.py\" --vault \"$env:LLM_WIKI_VAULT\"\n```\n\n## 许可\n\n默认使用 MIT License。若 skills 中包含第三方授权材料，请在发布前逐一确认 license。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqxbyte%2Fwiki-noosphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqxbyte%2Fwiki-noosphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqxbyte%2Fwiki-noosphere/lists"}