[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-heyitsnoah--claudesidian":3,"tool-heyitsnoah--claudesidian":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":66,"owner_company":76,"owner_location":77,"owner_email":66,"owner_twitter":66,"owner_website":78,"owner_url":79,"languages":80,"stars":97,"forks":98,"last_commit_at":99,"license":100,"difficulty_score":24,"env_os":101,"env_gpu":102,"env_ram":102,"env_deps":103,"category_tags":111,"github_topics":66,"view_count":24,"oss_zip_url":66,"oss_zip_packed_at":66,"status":17,"created_at":112,"updated_at":113,"faqs":114,"releases":150},10053,"heyitsnoah\u002Fclaudesidian","claudesidian",null,"claudesidian 是一款将 Obsidian 笔记库与 Claude Code 深度整合的开源启动套件，旨在把你的个人知识库升级为由 AI 驱动的“第二大脑”。它主要解决了传统笔记工具中知识整理困难、AI 交互缺乏上下文以及难以持续沉淀思维成果的问题。通过预置的 PARA（项目、领域、资源、归档）分类体系，claudesidian 帮助用户建立清晰的知识架构，并利用 Git 实现版本控制，确保数据随时可追溯、多端可同步。\n\n这款工具特别适合希望提升思考效率的研究人员、知识工作者、开发者以及任何热衷于构建个人知识体系的普通用户。其独特亮点在于区分了“思考模式”与“写作模式”：在思考模式下，Claude 不再是简单的代笔助手，而是主动搜索既有笔记、提出启发性问题并协助连接观点的思维伙伴；而在写作模式下，则专注于内容生成与润色。此外，claudesidian 内置智能初始化向导，能自动分析现有笔记结构、安全导入旧数据，并支持配置图像识别与网络研究插件，让用户无需复杂配置即可开启高效的 AI 协作之旅。","# Claudesidian: Claude Code + Obsidian Starter Kit\n\nTurn your Obsidian vault into an AI-powered second brain using Claude Code.\n\n## What is this?\n\nThis is a pre-configured Obsidian vault structure designed to work seamlessly\nwith Claude Code, enabling you to:\n\n- Use AI as a thinking partner, not just a writing assistant\n- Organize knowledge using the PARA method\n- Maintain version control with Git\n- Access your vault from anywhere (including mobile)\n\n## Quick Start\n\n### 1. Get the Starter Kit\n\n**Option A: Clone with Git**\n\n```bash\n# Clone with your preferred folder name (replace 'my-vault' with any name you like)\ngit clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git my-vault\ncd my-vault\n\n# Examples:\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git obsidian-notes\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git knowledge-base\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git second-brain\n```\n\n**Option B: Download ZIP (no Git required)**\n\n1. Click \"Code\" → \"Download ZIP\" on GitHub\n2. Extract to your desired location\n3. Open the folder in Claude Code\n\n### 2. Run the Setup Wizard\n\n```bash\n# Start Claude Code in the directory\nclaude\n\n# Run the interactive setup wizard (in Claude Code)\n\u002Finit-bootstrap\n```\n\nThis will:\n\n- Install dependencies automatically\n- Disconnect from the original claudesidian repository\n- **Intelligently analyze** your existing vault structure and patterns\n- **Import your existing Obsidian vault** safely to OLD_VAULT\u002F (if you have one)\n- **Research your public work** for personalized context (with your permission)\n- Ask you about your workflow preferences\n- Create a personalized CLAUDE.md configuration\n- Set up your folder structure\n- Optionally configure Gemini Vision for image\u002Fvideo analysis\n- Optionally configure Firecrawl for web research\n- Initialize Git for version control\n\n### 3. Open in Obsidian (Optional but Recommended)\n\n- Download [Obsidian](https:\u002F\u002Fobsidian.md)\n- Open vault from the claudesidian folder\n- This gives you a visual interface alongside Claude Code\n\n### 4. Your First Session\n\nTell Claude Code:\n\n```\nI'm starting a new project about [topic].\nI'm in thinking mode, not writing mode.\nPlease search my vault for any relevant existing notes,\nthen help me explore this topic by asking questions.\n```\n\nOr use one of the pre-configured commands (in Claude Code):\n\n```\n\u002Fthinking-partner   # For collaborative exploration\n\u002Fdaily-review       # For end-of-day reflection\n\u002Fresearch-assistant # For deep dives into topics\n```\n\n## Folder Structure\n\n```\nclaudesidian\u002F\n├── 00_Inbox\u002F           # Temporary capture point for new ideas\n├── 01_Projects\u002F        # Active, time-bound initiatives\n├── 02_Areas\u002F           # Ongoing responsibilities\n├── 03_Resources\u002F       # Reference materials and knowledge base\n├── 04_Archive\u002F         # Completed projects and inactive items\n├── 05_Attachments\u002F     # Images, PDFs, and other files\n├── 06_Metadata\u002F        # Vault configuration and templates\n│   ├── Reference\u002F      # Documentation and guides\n│   └── Templates\u002F      # Reusable note templates\n└── .scripts\u002F           # Helper scripts for automation\n```\n\n## Key Concepts\n\n### Thinking Mode vs Writing Mode\n\n**Thinking Mode** (Research & Exploration):\n\n- Claude asks questions to understand your goals\n- Searches existing notes for relevant content\n- Helps make connections between ideas\n- Maintains a log of insights and progress\n\n**Writing Mode** (Content Creation):\n\n- Generates drafts based on your research\n- Helps structure and edit content\n- Creates final deliverables\n\n### The PARA Method\n\n**Projects**: Have a deadline and specific outcome\n\n- Example: \"Q4 2025 Marketing Strategy\"\n- Create a folder in `01_Projects\u002F`\n\n**Areas**: Ongoing without an end date\n\n- Example: \"Health\", \"Finances\", \"Team Management\"\n- Lives in `02_Areas\u002F`\n\n**Resources**: Topics of ongoing interest\n\n- Example: \"AI Research\", \"Writing Tips\"\n- Store in `03_Resources\u002F`\n\n**Archive**: Inactive items\n\n- Completed projects with their outputs\n- Old notes no longer relevant\n\n## Skills\n\nClaudesidian ships with agent skills that auto-discover when you describe a\ntask. Skills work in Claude Code, OpenCode, Codex, Cursor, and Pi — they live\nin `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md` (canonical) with symlinks in\n`.claude\u002Fskills\u002F` and `.pi\u002Fskills\u002F`.\n\n- `thinking-partner` - Explore ideas through questions\n- `inbox-processor` - Organize your captures\n- `research-assistant` - Deep dive into topics\n- `daily-review` - End of day reflection\n- `weekly-synthesis` - Find patterns in your week\n- `de-ai-ify` - Remove AI writing patterns from text\n- `add-frontmatter` - Add YAML properties to notes\n- `download-attachment` - Save URLs to your attachments folder\n- `pragmatic-review` - YAGNI\u002FKISS code review\n- `pull-request` - Open a PR from your changes\n- `release` - Cut a new claudesidian release\n- `upgrade` - Update to the latest claudesidian version\n- `init-bootstrap` - Re-run the setup wizard\n- `install-claudesidian-command` - Install shell command to launch vault from\n  anywhere\n\nSkills trigger automatically when you describe what you want — e.g. \"wrap up\nmy day\" loads `daily-review`, \"open a PR for this\" loads `pull-request`. No\nslash command needed.\n\n### Staying updated with `upgrade`\n\nClaudesidian automatically checks for updates when you start Claude Code and\nwill remind you to run the `upgrade` skill when new features are available.\n\nThe upgrade command intelligently merges new features while preserving your\ncustomizations:\n\n```bash\n# Preview what would be updated (recommended first)\n\u002Fupgrade check\n\n# Run the interactive upgrade\n\u002Fupgrade\n\n# Skip confirmations for safe updates (advanced)\n\u002Fupgrade force\n```\n\n**What the upgrade does:**\n\n- Creates a timestamped backup before making any changes\n- Shows you diffs for each file before updating\n- Preserves your personal notes and customizations\n- Only updates system files (commands, agents, scripts)\n- Never touches your content folders (00_Inbox, 01_Projects, etc.)\n- Provides rollback capability if needed\n\n**Safety features:**\n\n- All your personal content is protected\n- Complete backup created in `.backup\u002Fupgrade-[timestamp]\u002F`\n- File-by-file review and confirmation\n- Progress tracked in `.upgrade-checklist.md`\n- Can be stopped and resumed at any time\n\n## Vision & Document Analysis (Optional)\n\nWith [Google Gemini](https:\u002F\u002Fai.google.dev\u002F) MCP configured, Claude Code can\nprocess your attachments directly without having to describe them. This means:\n\n- **Direct image analysis**: Claude sees the actual image, not your description\n- **PDF text extraction**: Full document text without copy-pasting\n- **Bulk processing**: Analyze multiple screenshots or documents at once\n- **Smart organization**: Auto-generate filenames based on image content\n- **Comparison tasks**: Compare before\u002Fafter screenshots, designs, etc.\n\n**Why this matters**: Instead of describing \"a screenshot showing an error\nmessage\", Claude Code directly sees and reads the error. Perfect for debugging\nUI issues, analyzing charts, or processing scanned documents.\n\n**Getting a Gemini API key:**\n\n1. Visit [Google AI Studio](https:\u002F\u002Faistudio.google.com)\n2. Sign in with your Google account\n3. Click \"Get API key\" in the left sidebar\n4. Create a new API key (it's free!)\n5. Set it in your environment: `export GEMINI_API_KEY=\"your-key-here\"`\n\nSee `.claude\u002Fmcp-servers\u002FREADME.md` for full setup instructions\n\n## Web Research (Optional)\n\nWith [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev\u002F) configured, our helper scripts\nfetch and save full web content directly to your vault. This means:\n\n- **Full text capture**: Scripts pipe complete article text to files, not\n  summaries\n- **Context preservation**: Claude doesn't need to hold web content in memory\n- **Batch processing**: Save multiple articles at once with `firecrawl-batch.sh`\n- **Clean markdown**: Web pages converted to readable, searchable markdown\n- **Permanent archive**: Your research stays in your vault forever\n\n**Why this matters**: Instead of Claude reading a webpage and summarizing it\n(losing detail), the scripts save the FULL text. Claude can then search and\nanalyze thousands of saved articles without hitting context limits. Perfect for\nresearch projects, documentation archives, or building a knowledge base.\n\n**Example workflow:**\n\n```bash\n# Save a single article\nnpm run firecrawl:scrape -- \"https:\u002F\u002Fexample.com\u002Farticle\" \"03_Resources\u002FArticles\"\n\n# Batch save multiple URLs\nnpm run firecrawl:batch -- urls.txt \"03_Resources\u002FResearch\"\n```\n\n**Getting a Firecrawl API key:**\n\n1. Visit [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev) and sign up\n2. Get 300 free credits to start (open-source, can self-host)\n3. Go to your dashboard to find your API key\n4. Copy the key (format: `fc-xxxxx...`)\n5. Set it in your environment: `export FIRECRAWL_API_KEY=\"fc-your-key-here\"`\n\n## Helper Scripts\n\nRun these with `pnpm`:\n\n- `attachments:list` - Show unprocessed attachments\n- `attachments:organized` - Count organized files\n- `attachments:sizes` - Find large files\n- `attachments:orphans` - Find unreferenced attachments\n- `vault:stats` - Show vault statistics\n\n## Advanced Setup\n\n### Quick Launch from Anywhere\n\nInstall a shell command to launch your vault from any directory:\n\n```bash\n# In Claude Code, run:\n\u002Finstall-claudesidian-command\n```\n\nThis creates a `claudesidian` alias that:\n\n- Changes to your vault directory automatically\n- Tries to resume your existing session (if one exists)\n- Falls back to starting a new session\n- Returns to your original directory when done\n\n**Usage:**\n\n```bash\n# From anywhere in your terminal:\nclaudesidian\n\n# It will automatically resume your last session or start a new one\n```\n\nThe command is added to your shell config (~\u002F.zshrc, ~\u002F.bashrc, etc.) so it\npersists across terminal sessions.\n\n### Git Integration\n\nInitialize Git for version control:\n\n```bash\ngit init\ngit add .\ngit commit -m \"Initial vault setup\"\ngit remote add origin your-repo-url\ngit push -u origin main\n```\n\nBest practices:\n\n- Commit after each work session\n- Use descriptive commit messages\n- Pull before starting work\n\n### Mobile Access\n\n1. Set up a small server (mini PC, cloud VPS, or home server)\n2. Install Tailscale for secure VPN access\n3. Clone your vault to the server\n4. Use Termius or similar SSH client on mobile\n5. Run Claude Code remotely\n\n### Custom Commands\n\nCreate specialized commands by saving instructions in `.claude\u002Fcommands\u002F`:\n\n**Research Assistant** (`06_Metadata\u002FAgents\u002Fresearch-assistant.md`):\n\n```markdown\nYou are a research assistant.\n\n- Search the vault for relevant information\n- Synthesize findings from multiple sources\n- Identify gaps in knowledge\n- Suggest areas for further exploration\n```\n\n## Tips & Best Practices\n\n### From Experience\n\n1. **Start in thinking mode**: Resist the urge to generate content immediately\n2. **Be a token maximalist**: More context = better results\n3. **Save everything**: Capture chats, fragments, partial thoughts\n4. **Trust but verify**: Always read AI-generated content\n5. **Break your flow**: AI helps you resume easily\n\n## Troubleshooting\n\n### Claude Code can't find my notes\n\n- Make sure you're running Claude Code from the vault root directory\n- Check file permissions\n- Verify markdown files have `.md` extension\n\n### Git conflicts\n\n- Always pull before starting work\n- Commit frequently with clear messages\n- Use branches for experimental changes\n\n### Attachment management\n\n- Run `npm run attachments:create-organized` to set up folders\n- Use helper scripts to find orphaned files\n- Keep attachments under 10MB for Git\n\n## Philosophy\n\nThis setup is based on key principles:\n\n1. **AI amplifies thinking, not just writing**\n2. **Local files = full control**\n3. **Structure enables creativity**\n4. **Iteration beats perfection**\n5. **The goal is insight, not just information**\n\n## Contributing\n\nWe welcome contributions from the community! This is a living template that gets\nbetter with everyone's input.\n\n### How to Contribute\n\n1. **Fork the repository** on GitHub\n2. **Create a feature branch** (`git checkout -b feature\u002Famazing-feature`)\n3. **Make your changes**\n4. **Test your changes** to ensure everything works\n5. **Commit your changes** (`git commit -m 'Add amazing feature'`)\n6. **Push to the branch** (`git push origin feature\u002Famazing-feature`)\n7. **Open a Pull Request** with a clear description of what you've done\n\n### What We're Looking For\n\n- **New commands**: Useful Claude Code commands for common workflows\n- **New agents**: Specialized agents for specific tasks\n- **Documentation improvements**: Better explanations, examples, or guides\n- **Bug fixes**: Found something broken? Fix it!\n- **Workflow templates**: Share your productive workflows\n- **Helper scripts**: Automation tools that make vault management easier\n- **Integration guides**: Connect Claudesidian with other tools\n- **Core updates**: Improvements to the upgrade system, setup wizard, or other\n  core features\n\n### Guidelines\n\n- Keep commands focused and single-purpose\n- Write clear documentation with examples\n- Test thoroughly before submitting\n- Follow existing code style and structure\n- Update the CHANGELOG.md with your changes\n- **AI-generated content is welcome, but you MUST carefully read and review\n  everything before submitting** - never submit code you don't understand\n\n### Getting Updates\n\nWhen new features are contributed and merged, users can easily get them with:\n\n```bash\n\u002Fupgrade\n```\n\nThe upgrade command intelligently merges new features while preserving your\npersonal customizations, making it easy to benefit from community contributions\nwithout losing your work.\n\n### Questions or Ideas?\n\n- Open an issue to discuss major changes before starting work\n- Join discussions in existing issues\n- Share your use cases - they help us understand needs better\n\nRemember: best practices emerge from use, not theory. Your real-world experience\nmakes this better for everyone!\n\n## Resources\n\n- [Obsidian Documentation](https:\u002F\u002Fhelp.obsidian.md)\n- [PARA Method](https:\u002F\u002Ffortelabs.com\u002Fblog\u002Fpara\u002F)\n- [Claude Code Documentation](https:\u002F\u002Fclaude.ai\u002Fdocs)\n\n## Inspiration\n\nThis starter kit was inspired by the workflows discussed in:\n\n- [How to Use Claude Code as a Second Brain](https:\u002F\u002Fevery.to\u002Fpodcast\u002Fhow-to-use-claude-code-as-a-thinking-partner) -\n  Noah Brier's interview with Dan Shipper\n- Built by the team at [Alephic](https:\u002F\u002Falephic.com) - an AI-first strategy and\n  software partner that helps organizations solve complex challenges through\n  custom AI systems\n\n## License\n\nMIT - Use this however you want. Make it your own.\n\n---\n\n_Remember: The bicycle feels wobbly at first, then you forget it was ever hard._\n","# Claudesidian：Claude Code + Obsidian 入门套件\n\n使用 Claude Code 将你的 Obsidian 私库转变为一个由 AI 驱动的第二大脑。\n\n## 这是什么？\n\n这是一个预配置的 Obsidian 私库结构，旨在与 Claude Code 无缝协作，使你能够：\n\n- 将 AI 视为思考伙伴，而不仅仅是写作助手\n- 使用 PARA 方法组织知识\n- 通过 Git 实现版本控制\n- 随时随地访问你的私库（包括在移动设备上）\n\n## 快速开始\n\n### 1. 获取入门套件\n\n**选项 A：使用 Git 克隆**\n\n```bash\n# 使用你喜欢的文件夹名称进行克隆（将 'my-vault' 替换为你喜欢的名称）\ngit clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git my-vault\ncd my-vault\n\n# 示例：\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git obsidian-notes\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git knowledge-base\n# git clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git second-brain\n```\n\n**选项 B：下载 ZIP 文件（无需 Git）**\n\n1. 在 GitHub 上点击“Code”→“Download ZIP”\n2. 解压到你想要的位置\n3. 在 Claude Code 中打开该文件夹\n\n### 2. 运行设置向导\n\n```bash\n# 在目录中启动 Claude Code\nclaude\n\n# 在 Claude Code 中运行交互式设置向导\n\u002Finit-bootstrap\n```\n\n这将：\n\n- 自动安装依赖项\n- 断开与原始 claudesidian 仓库的连接\n- **智能分析**你现有的私库结构和模式\n- 安全地**导入你现有的 Obsidian 私库**到 OLD_VAULT\u002F 目录下（如果你有的话）\n- 在征得你同意的情况下，**检索你的公开作品**以提供个性化上下文\n- 询问你的工作流偏好\n- 创建个性化的 CLAUDE.md 配置\n- 设置你的文件夹结构\n- 可选地配置 Gemini Vision 以进行图像\u002F视频分析\n- 可选地配置 Firecrawl 以进行网络研究\n- 初始化 Git 以实现版本控制\n\n### 3. 在 Obsidian 中打开（可选但推荐）\n\n- 下载 [Obsidian](https:\u002F\u002Fobsidian.md)\n- 从 claudesidian 文件夹中打开私库\n- 这样你就可以在 Claude Code 的同时使用 Obsidian 的可视化界面\n\n### 4. 你的第一次会话\n\n告诉 Claude Code：\n\n```\n我正在开始一个关于[主题]的新项目。\n我现在处于思考模式，而不是写作模式。\n请在我的私库中搜索任何相关的现有笔记，\n然后通过提问来帮助我探索这个主题。\n```\n\n或者使用 Claude Code 中预配置的命令之一：\n\n```\n\u002Fthinking-partner   # 用于协作式探索\n\u002Fdaily-review       # 用于每日回顾\n\u002Fresearch-assistant # 用于深入研究主题\n```\n\n## 文件夹结构\n\n```\nclaudesidian\u002F\n├── 00_Inbox\u002F           # 新想法的临时收集点\n├── 01_Projects\u002F        # 有时间限制的正在进行的项目\n├── 02_Areas\u002F           # 持续性的责任领域\n├── 03_Resources\u002F       # 参考资料和知识库\n├── 04_Archive\u002F         # 已完成的项目和不再活跃的内容\n├── 05_Attachments\u002F     # 图片、PDF 等文件\n├── 06_Metadata\u002F        # 私库配置和模板\n│   ├── Reference\u002F      # 文档和指南\n│   └── Templates\u002F      # 可重用的笔记模板\n└── .scripts\u002F           # 用于自动化的辅助脚本\n```\n\n## 核心概念\n\n### 思考模式 vs 写作模式\n\n**思考模式**（研究与探索）：\n\n- Claude 会提出问题以理解你的目标\n- 搜索现有笔记以找到相关内容\n- 帮助建立不同想法之间的联系\n- 记录见解和进展\n\n**写作模式**（内容创作）：\n\n- 根据你的研究生成草稿\n- 帮助组织和编辑内容\n- 制作最终成果\n\n### PARA 方法\n\n**项目**：有明确的截止日期和具体成果\n\n- 示例：“2025 年第四季度营销战略”\n- 创建于 `01_Projects\u002F` 文件夹中\n\n**领域**：持续进行且无明确结束日期\n\n- 示例：“健康”、“财务”、“团队管理”\n- 存在于 `02_Areas\u002F` 文件夹中\n\n**资源**：持续感兴趣的主题\n\n- 示例：“AI 研究”、“写作技巧”\n- 存放在 `03_Resources\u002F` 文件夹中\n\n**归档**：不再活跃的内容\n\n- 包括已完成项目及其成果\n- 以及不再相关的旧笔记\n\n## 技能\n\nClaudesidian 自带代理技能，当你描述任务时会自动发现。这些技能可在 Claude Code、OpenCode、Codex、Cursor 和 Pi 中使用——它们位于 `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md`（规范路径），并在 `.claude\u002Fskills\u002F` 和 `.pi\u002Fskills\u002F` 中设有符号链接。\n\n- `thinking-partner` - 通过提问探索想法\n- `inbox-processor` - 整理你的收集内容\n- `research-assistant` - 深入研究主题\n- `daily-review` - 每日回顾\n- `weekly-synthesis` - 发现一周中的规律\n- `de-ai-ify` - 从文本中移除 AI 写作风格\n- `add-frontmatter` - 为笔记添加 YAML 属性\n- `download-attachment` - 将 URL 保存到附件文件夹\n- `pragmatic-review` - 符合 YAGNI\u002FKISS 原则的代码审查\n- `pull-request` - 根据你的更改创建拉取请求\n- `release` - 发布新的 Claudesidian 版本\n- `upgrade` - 更新到最新版本的 Claudesidian\n- `init-bootstrap` - 重新运行设置向导\n- `install-claudesidian-command` - 安装 Shell 命令，以便从任何地方启动私库\n\n当你描述所需操作时，技能会自动触发——例如，“总结一下今天的工作”会加载 `daily-review`，“为此创建一个拉取请求”会加载 `pull-request`。无需使用斜杠命令。\n\n### 使用 `upgrade` 保持更新\n\nClaudesidian 会在你启动 Claude Code 时自动检查更新，并在有新功能可用时提醒你运行 `upgrade` 技能。\n\n升级命令会智能地合并新功能，同时保留你的自定义设置：\n\n```bash\n# 首先预览将要更新的内容（建议先执行）\n\u002Fupgrade check\n\n# 运行交互式的升级\n\u002Fupgrade\n\n# 跳过确认以安全更新（高级选项）\n\u002Fupgrade force\n```\n\n**升级会做什么：**\n\n- 在进行任何更改之前创建带有时间戳的备份\n- 在更新每个文件之前显示差异对比\n- 保留你的个人笔记和自定义设置\n- 只更新系统文件（命令、代理、脚本）\n- 绝不会触及你的内容文件夹（00_Inbox、01_Projects 等）\n- 提供必要的回滚功能\n\n**安全特性：**\n\n- 你的所有个人内容都受到保护\n- 在 `.backup\u002Fupgrade-[timestamp]\u002F` 中创建完整备份\n- 对每个文件进行逐一审查并确认\n- 进度记录在 `.upgrade-checklist.md` 中\n- 可随时停止或继续升级\n\n## 视觉与文档分析（可选）\n\n在配置了 [Google Gemini](https:\u002F\u002Fai.google.dev\u002F) MCP 后，Claude Code 可以直接处理你的附件，而无需你对其进行描述。这意味着：\n\n- **直接图像分析**：Claude 能看到实际的图像，而不是你的描述\n- **PDF 文本提取**：无需复制粘贴即可获取完整文档文本\n- **批量处理**：一次分析多张截图或多个文档\n- **智能整理**：根据图像内容自动生成文件名\n- **对比任务**：比较前后截图、设计等\n\n**为什么这很重要**：与其描述“一张显示错误信息的截图”，Claude Code 直接查看并读取错误内容。这对于调试 UI 问题、分析图表或处理扫描文档非常理想。\n\n**如何获取 Gemini API 密钥：**\n\n1. 访问 [Google AI Studio](https:\u002F\u002Faistudio.google.com)\n2. 使用 Google 账号登录\n3. 点击左侧边栏中的“获取 API 密钥”\n4. 创建一个新的 API 密钥（免费！）\n5. 在环境变量中设置：`export GEMINI_API_KEY=\"your-key-here\"`\n\n完整设置说明请参阅 `.claude\u002Fmcp-servers\u002FREADME.md`\n\n## 网络研究（可选）\n\n在配置了 [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev\u002F) 后，我们的辅助脚本会直接将完整的网页内容抓取并保存到你的知识库中。这意味着：\n\n- **全文捕获**：脚本会将整篇文章的文本输出到文件，而不是摘要\n- **上下文保留**：Claude 不需要在内存中存储网页内容\n- **批量处理**：使用 `firecrawl-batch.sh` 一次性保存多篇文章\n- **干净的 Markdown 格式**：将网页转换为可读、可搜索的 Markdown 格式\n- **永久存档**：你的研究内容将永远保存在你的知识库中\n\n**为什么这很重要**：与其让 Claude 阅读网页并总结内容（从而丢失细节），不如使用脚本保存完整的文本。这样，Claude 就可以在不超出上下文限制的情况下搜索和分析数千篇已保存的文章。这对于研究项目、文档存档或构建知识库来说非常理想。\n\n**示例工作流程：**\n\n```bash\n# 保存单篇文章\nnpm run firecrawl:scrape -- \"https:\u002F\u002Fexample.com\u002Farticle\" \"03_Resources\u002FArticles\"\n\n# 批量保存多个 URL\nnpm run firecrawl:batch -- urls.txt \"03_Resources\u002FResearch\"\n```\n\n**如何获取 Firecrawl API 密钥：**\n\n1. 访问 [Firecrawl](https:\u002F\u002Fwww.firecrawl.dev) 并注册\n2. 获取 300 次免费调用额度开始使用（开源，支持自托管）\n3. 进入仪表盘找到你的 API 密钥\n4. 复制密钥（格式：`fc-xxxxx...`）\n5. 在环境变量中设置：`export FIRECRAWL_API_KEY=\"fc-your-key-here\"`\n\n## 辅助脚本\n\n使用 `pnpm` 运行以下命令：\n\n- `attachments:list` - 显示未处理的附件\n- `attachments:organized` - 统计已整理的文件数量\n- `attachments:sizes` - 查找大文件\n- `attachments:orphans` - 查找未被引用的附件\n- `vault:stats` - 显示知识库统计信息\n\n## 高级设置\n\n### 从任意位置快速启动\n\n安装一个 shell 命令，以便从任何目录启动你的知识库：\n\n```bash\n# 在 Claude Code 中运行：\n\u002Finstall-claudesidian-command\n```\n\n这会创建一个名为 `claudesidian` 的别名，它会：\n\n- 自动切换到你的知识库目录\n- 尝试恢复现有的会话（如果存在）\n- 如果没有会话，则启动一个新的会话\n- 完成后返回到你原来的目录\n\n**使用方法：**\n\n```bash\n# 从终端的任何位置运行：\nclaudesidian\n\n# 它会自动恢复上次会话或启动一个新的会话\n```\n\n该命令会被添加到你的 shell 配置文件（~\u002F.zshrc、~\u002F.bashrc 等）中，因此在每次打开终端时都会生效。\n\n### Git 集成\n\n初始化 Git 以进行版本控制：\n\n```bash\ngit init\ngit add .\ngit commit -m \"初始知识库设置\"\ngit remote add origin your-repo-url\ngit push -u origin main\n```\n\n最佳实践：\n\n- 每次工作结束后提交一次\n- 使用描述性的提交信息\n- 在开始工作前先拉取最新代码\n\n### 移动端访问\n\n1. 搭建一个小服务器（迷你 PC、云 VPS 或家用服务器）\n2. 安装 Tailscale 以实现安全的 VPN 访问\n3. 将你的知识库克隆到服务器上\n4. 在手机上使用 Termius 或类似的 SSH 客户端\n5. 远程运行 Claude Code\n\n### 自定义命令\n\n通过将指令保存到 `.claude\u002Fcommands\u002F` 目录来创建专用命令：\n\n**研究助理**（`06_Metadata\u002FAgents\u002Fresearch-assistant.md`）：\n\n```markdown\n你是一名研究助理。\n\n- 在知识库中搜索相关信息\n- 整合来自多个来源的研究成果\n- 识别知识缺口\n- 提出进一步探索的方向\n```\n\n## 小贴士与最佳实践\n\n### 经验之谈\n\n1. **先思考再行动**：不要急于立即生成内容\n2. **尽可能多地提供上下文**：更多的上下文能带来更好的结果\n3. **保存一切**：捕捉聊天记录、片段以及部分想法\n4. **信任但验证**：始终仔细阅读 AI 生成的内容\n5. **适时中断**：AI 可以帮助你轻松恢复工作状态\n\n## 故障排除\n\n### Claude Code 找不到我的笔记\n\n- 确保你是在知识库根目录下运行 Claude Code\n- 检查文件权限\n- 确认 Markdown 文件具有 `.md` 扩展名\n\n### Git 冲突\n\n- 在开始工作前务必先拉取最新代码\n- 经常提交，并附上清晰的提交信息\n- 对于实验性更改，请使用分支\n\n### 附件管理\n\n- 运行 `npm run attachments:create-organized` 来设置文件夹结构\n- 使用辅助脚本查找孤立的文件\n- 为便于 Git 管理，建议将附件大小控制在 10MB 以内\n\n## 哲学理念\n\n此设置基于以下核心原则：\n\n1. **AI 放大思考能力，而不仅仅是写作能力**\n2. **本地文件意味着完全掌控**\n3. **结构化有助于激发创造力**\n4. **迭代胜过完美**\n5. **目标是洞察力，而非单纯的信息**\n\n## 贡献方式\n\n我们欢迎社区的贡献！这是一个不断完善的模板，受益于每个人的参与。\n\n### 如何贡献\n\n1. 在 GitHub 上 **fork 该仓库**\n2. 创建一个功能分支（`git checkout -b feature\u002Famazing-feature`）\n3. 进行修改\n4. 测试你的更改，确保一切正常运行\n5. 提交更改（`git commit -m '添加超赞功能'`）\n6. 推送到分支（`git push origin feature\u002Famazing-feature`）\n7. 打开一个带有清晰说明的 Pull Request，解释你所做的工作\n\n### 我们期待的贡献\n\n- **新命令**：适用于常见工作流程的实用 Claude Code 命令\n- **新代理**：针对特定任务的专业代理\n- **文档改进**：更优秀的说明、示例或指南\n- **错误修复**：发现 bug？请修复它！\n- **工作流程模板**：分享你的高效工作流程\n- **辅助脚本**：使知识库管理更便捷的自动化工具\n- **集成指南**：将 Claudesidian 与其他工具连接起来\n- **核心更新**：对升级系统、设置向导或其他核心功能的改进\n\n### 指南\n\n- 保持命令简洁且单一功能\n- 编写清晰的文档并附带示例\n- 提交前进行充分测试\n- 遵循现有代码风格和结构\n- 更新 `CHANGELOG.md` 文件以记录您的更改\n- **欢迎使用 AI 生成的内容，但您必须在提交前仔细阅读并审查所有内容**——切勿提交您不理解的代码\n\n### 获取更新\n\n当有新功能被贡献并合并后，用户可以通过以下命令轻松获取：\n\n```bash\n\u002Fupgrade\n```\n\n升级命令会智能地将新功能合并到现有代码中，同时保留您的个性化配置，使您能够轻松受益于社区贡献，而不会丢失自己的工作成果。\n\n### 有问题或想法吗？\n\n- 在开始工作之前，请先开一个议题讨论重大变更\n- 参与现有议题的讨论\n- 分享您的使用场景——这有助于我们更好地理解需求\n\n请记住：最佳实践源于实际使用，而非理论。您的真实使用经验会让整个项目对每个人都有所裨益！\n\n## 资源\n\n- [Obsidian 官方文档](https:\u002F\u002Fhelp.obsidian.md)\n- [PARA 方法](https:\u002F\u002Ffortelabs.com\u002Fblog\u002Fpara\u002F)\n- [Claude Code 官方文档](https:\u002F\u002Fclaude.ai\u002Fdocs)\n\n## 灵感来源\n\n本入门工具包的灵感来源于以下内容中讨论的工作流：\n\n- [如何将 Claude Code 用作第二大脑](https:\u002F\u002Fevery.to\u002Fpodcast\u002Fhow-to-use-claude-code-as-a-thinking-partner) —— Noah Brier 对 Dan Shipper 的访谈\n- 由 [Alephic](https:\u002F\u002Falephic.com) 团队构建——一家以 AI 为导向的战略与软件合作伙伴，帮助企业通过定制化 AI 系统解决复杂挑战\n\n## 许可证\n\nMIT 许可证——您可以自由地按任何方式使用本项目，并根据需要进行修改。\n\n---\n\n_请记住：骑自行车刚开始时可能会觉得摇晃，但很快您就会忘记它曾经有多难。_","# Claudesidian 快速上手指南\n\nClaudesidian 是一个预配置的 Obsidian 知识库模板，旨在与 **Claude Code** 无缝协作。它将你的本地笔记库转变为由 AI 驱动的“第二大脑”，支持 PARA 知识管理法、Git 版本控制以及深度的 AI 思维协作。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：macOS, Linux 或 Windows (WSL2 推荐)\n*   **核心依赖**：\n    *   [Node.js](https:\u002F\u002Fnodejs.org\u002F) (建议 v18+)\n    *   [Git](https:\u002F\u002Fgit-scm.com\u002F)\n    *   [pnpm](https:\u002F\u002Fpnpm.io\u002F) (包管理工具)\n    *   [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) (需已安装并配置好 API Key)\n*   **可选工具**：\n    *   [Obsidian](https:\u002F\u002Fobsidian.md)：用于可视化查看和管理笔记。\n    *   Google Gemini API Key：用于图像\u002FPDF 分析（可选）。\n    *   Firecrawl API Key：用于网页内容抓取（可选）。\n\n> **提示**：国内用户若遇到 npm\u002Fpnpm 下载缓慢，可临时切换镜像源：\n> `pnpm config set registry https:\u002F\u002Fregistry.npmmirror.com`\n\n## 安装步骤\n\n### 1. 获取项目代码\n\n你可以选择通过 Git 克隆或直接下载 ZIP 包。推荐使用 Git 以便后续更新。\n\n**方式 A：使用 Git 克隆（推荐）**\n\n```bash\n# 将仓库克隆到你喜欢的文件夹名称（例如 my-vault）\ngit clone https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian.git my-vault\ncd my-vault\n\n# 安装依赖\npnpm install\n```\n\n**方式 B：下载 ZIP 包**\n\n1. 在 GitHub 页面点击 \"Code\" → \"Download ZIP\"。\n2. 解压到本地目录。\n3. 终端进入该目录并运行 `pnpm install`。\n\n### 2. 运行初始化向导\n\n进入目录后，启动 Claude Code 并运行内置的引导程序。这将自动配置环境、迁移旧笔记（如有）并生成个性化配置文件。\n\n```bash\n# 启动 Claude Code\nclaude\n\n# 在 Claude Code 交互界面中，输入以下命令运行向导\n\u002Finit-bootstrap\n```\n\n**向导将执行以下操作：**\n*   自动安装缺失的依赖。\n*   断开与原仓库的关联，使其成为你的独立项目。\n*   智能分析现有结构，若有旧 Obsidian 库会安全导入至 `OLD_VAULT\u002F`。\n*   询问你的工作流偏好，生成个性化的 `CLAUDE.md`。\n*   初始化 Git 版本控制。\n*   （可选）配置 Gemini Vision 和 Firecrawl。\n\n### 3. 连接 Obsidian（可选但推荐）\n\n为了获得图形化界面体验：\n1. 打开 **Obsidian** 软件。\n2. 选择 \"Open folder as vault\"（打开文件夹作为库）。\n3. 指向你刚才克隆的 `my-vault` 目录。\n\n## 基本使用\n\n安装完成后，你可以通过两种模式与 AI 协作：**思考模式**（探索与提问）和 **写作模式**（内容生成）。\n\n### 启动会话\n\n在终端进入项目目录，运行：\n\n```bash\nclaude\n```\n\n### 常用指令示例\n\n**1. 开启新项目（思考模式）**\n告诉 Claude 你想探索一个主题，让它先检索库中现有笔记并提出问题，而不是直接生成文章。\n\n```text\nI'm starting a new project about [你的主题].\nI'm in thinking mode, not writing mode.\nPlease search my vault for any relevant existing notes,\nthen help me explore this topic by asking questions.\n```\n\n**2. 使用预设技能命令**\nClaudesidian 内置了多种自动化技能，可直接在对话中调用：\n\n*   **协作探索**：\n    ```text\n    \u002Fthinking-partner\n    ```\n*   **每日复盘**：\n    ```text\n    \u002Fdaily-review\n    ```\n*   **深度研究**：\n    ```text\n    \u002Fresearch-assistant\n    ```\n\n> **注意**：部分技能支持自然语言触发。例如，直接说 \"wrap up my day\" 会自动加载 `daily-review` 技能，无需输入斜杠命令。\n\n### 目录结构概览\n\n系统采用 **PARA 方法** 组织文件，建议遵循以下结构存放笔记：\n\n*   `00_Inbox\u002F`：临时收集的新想法。\n*   `01_Projects\u002F`：有明确截止日期的活跃项目。\n*   `02_Areas\u002F`：长期持续的責任领域（如健康、财务）。\n*   `03_Resources\u002F`：参考材料和知识库。\n*   `04_Archive\u002F`：已完成的项目或非活跃内容。\n*   `06_Metadata\u002F`：包含模板和系统配置。\n\n### 保持更新\n\n当有新功能发布时，Claude Code 会提示你升级。运行以下命令可安全更新系统文件（不会触碰你的个人笔记）：\n\n```bash\n# 在 Claude Code 中运行\n\u002Fupgrade\n```","一位独立开发者正试图整理过去三年散乱的技术笔记，以启动一个新的开源项目架构设计。\n\n### 没有 claudesidian 时\n- **知识孤岛严重**：旧笔记分散在不同文件夹，手动搜索难以发现概念间的潜在联系，导致重复造轮子。\n- **角色定位单一**：AI 仅被当作润色工具，无法主动通过提问引导思路，缺乏真正的“思考伙伴”体验。\n- **结构混乱无序**：缺乏统一的标准（如 PARA 方法），项目、领域和资源混杂，随着内容增加越来越难维护。\n- **版本管理缺失**：笔记修改无历史记录，一旦误删或改错无法回溯，且多设备同步容易冲突。\n- **启动成本高昂**：每次新课题都需要重新配置环境和分析背景，无法快速进入深度工作状态。\n\n### 使用 claudesidian 后\n- **智能知识关联**：claudesidian 自动分析现有库，在“思考模式”下主动检索并连接相关旧笔记，激发新的架构灵感。\n- **深度协作探索**：通过 `\u002Fthinking-partner` 命令，Claude 变身为提问者而非代笔者，帮助用户厘清项目目标与边界。\n- **标准化知识体系**：内置 PARA 方法论自动将内容归类至 Projects、Areas 等资源目录，让知识库井井有条。\n- **Git 原生支持**：底层集成 Git 版本控制，确保每次思想迭代都有迹可循，安全实现多端无缝同步。\n- **一键个性化启动**：运行初始化向导即可根据用户习惯生成专属配置，瞬间构建好包含上下文环境的第二大脑。\n\nclaudesidian 将原本静态的笔记仓库转化为能主动辅助决策的动态智能系统，让知识管理真正服务于创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fheyitsnoah_claudesidian_283a7f22.png","heyitsnoah","Noah Brier","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fheyitsnoah_cb249da3.jpg","Alephic","NYC","http:\u002F\u002Fnoahbrier.com","https:\u002F\u002Fgithub.com\u002Fheyitsnoah",[81,85,89,93],{"name":82,"color":83,"percentage":84},"Python","#3572A5",47.1,{"name":86,"color":87,"percentage":88},"HTML","#e34c26",27.3,{"name":90,"color":91,"percentage":92},"JavaScript","#f1e05a",19.4,{"name":94,"color":95,"percentage":96},"Shell","#89e051",6.2,2240,171,"2026-04-20T01:48:20","MIT","Linux, macOS, Windows","未说明",{"notes":104,"python":102,"dependencies":105},"该工具是基于 Obsidian 笔记库和 Claude Code 的启动套件，并非本地运行的 AI 模型，因此无需 GPU 或特定 Python 环境。核心依赖是安装 'Claude Code' 命令行工具、Git 以及 Node.js 包管理器 (npm\u002Fpnpm)。可选功能需配置 Google Gemini API Key（用于图像\u002FPDF 分析）和 Firecrawl API Key（用于网页抓取）。支持通过 Tailscale 和 SSH 在移动端或远程服务器访问。",[106,107,108,109,110],"Git","Node.js (npm\u002Fpnpm)","Claude Code","Google Gemini API (可选)","Firecrawl API (可选)",[36,13],"2026-03-27T02:49:30.150509","2026-04-20T16:46:51.004711",[115,120,125,130,135,140,145],{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},45166,"该项目是否支持 Claude 免费层级，还是必须使用 Pro 或 API？","该项目主要基于 Claude Code，通常仅对 Pro 层级及以上用户可用。免费层级用户无法直接使用，需要配置 API 密钥来运行。如果在运行引导脚本时被提示支付代币费用，通常是因为未满足 Pro 要求或未正确设置 API 密钥。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F9",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},45167,"每次启动时都重复显示欢迎屏幕（Welcome Screen），如何解决？","欢迎屏幕通常在首次运行后应消失。如果反复出现，请尝试在 Claude 中运行 `\u002Finit-bootstrap` 命令。此外，可能存在一个需要删除的“首次运行”标记文件，您可以直接询问 Claude 该文件的具体位置并将其删除以解决问题。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F7",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},45168,"如何在 VPS、PC 和 iOS 设备之间同步项目数据？","推荐的同步方案是组合使用 Git 和 Obsidian Sync。使用 Git 处理仓库级别的代码同步，使用 Obsidian Sync 处理电脑和移动设备间的笔记数据同步。两者可以协同工作，还可以配合使用 Git Sync 插件来优化流程。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F10",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},45169,"是否支持 Cursor、Codex 或 OpenCode 等其他 AI 代理？","支持。项目已通过通用 `.agents\u002Fskills\u002F` 目录结构添加了对 OpenCode、Codex、Cursor 和 Pi 的支持。技能文件的标准位置是 `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md`，其他代理（如 Claude Code 和 Pi）通过符号链接指向该位置。只需在标准位置编辑一次技能，所有五个代理即可同步更新。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F30",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},45170,"Obsidian 索引了 `node_modules` 文件夹导致干扰，如何忽略它？","这是一个已知问题。虽然可以在配置中添加 `\"userIgnoreFilters\": [\"node_modules\u002F\"]`，但更有效的解决方案是将 `node_modules` 文件夹移出 Vault（仓库根目录），然后创建一个符号链接（symlink）指向原位置。注意：单纯依靠 Obsidian 设置可能无法完全解决此问题，因为部分行为源于 Obsidian 端的限制。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F6",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},45171,"遇到 429 错误提示“No deployments available”或始终默认使用按量计费而非 Pro 额度怎么办？","如果遇到 429 错误，可能是由于后台有静默运行的代理（launch agent）冲突创建了多余的 API 密钥，检查并停止相关进程可解决。如果系统始终默认使用 API 计费而忽略 Claude Pro 计划额度，请确保没有残留的 API 密钥配置干扰，并确认您是在正确的环境中运行（Pro 用户通常不需要配置 API Key 即可使用本地额度）。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F14",{"id":146,"question_zh":147,"answer_zh":148,"source_url":149},45172,"firecrawl-batch.sh 脚本生成的文件名丢失了中文（CJK）字符怎么办？","这是因为 `sanitize_filename()` 函数错误地移除了所有非 ASCII 字符。解决方法是修改该函数，使其仅移除文件系统非法字符（如 `\u002F \\ : * ? \" \u003C > |`），而保留 Unicode 文本（包括中文、日文、韩文），从而确保标题中的 CJK 字符能正确保存在文件名中。","https:\u002F\u002Fgithub.com\u002Fheyitsnoah\u002Fclaudesidian\u002Fissues\u002F25",[151,156,161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241,246],{"id":152,"version":153,"summary_zh":154,"released_at":155},360024,"v0.15.1","### 已修复\n\n- 在项目脚本中使用可移植的 Bash shebang（`#!\u002Fusr\u002Fbin\u002Fenv bash`），而非硬编码的 `\u002Fbin\u002Fbash`。这修复了在 NixOS 及其他 `\u002Fbin\u002Fbash` 不是标准路径的系统上脚本无法执行的问题。感谢 @jamestrew (#37)。\n\n\n---\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成\n","2026-04-11T22:44:34",{"id":157,"version":158,"summary_zh":159,"released_at":160},360025,"v0.15.0","### 新增\n\n- 多智能体技能布局：技能现位于 `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md`（规范路径，可被 OpenCode、Codex 和 Cursor 原生读取），同时在 `.claude\u002Fskills\u002F\u003Cname>` 和 `.pi\u002Fskills\u002F\u003Cname>` 下设有符号链接，以便 Claude Code 和 Pi 也能找到这些技能。编辑规范路径后，所有五个智能体会同步更新。\n- `pnpm skills:validate` 脚本——遍历每个技能运行内置的 `quick_validate.py`，报告任何格式错误的 frontmatter，并在首次失败时以非零退出码终止。\n- 捆绑了 Anthropic 官方的 `skill-creator` 技能，来自 [anthropics\u002Fskills](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills\u002Ftree\u002Fmain\u002Fskills\u002Fskill-creator)，包含完整的 `agents\u002F`、`scripts\u002F`、`references\u002F` 和 `assets\u002F` 目录结构，以及其 `LICENSE.txt`（Apache 2.0 许可）和指向上游第三方声明的 `NOTICE.md`。\n\n### 变更\n\n- 将 `.claude\u002Fcommands\u002F` 中的所有 14 条斜杠命令转换为具备正确 `name` 和 `description` frontmatter 的智能体技能。正文内容原样保留，仅对过时的引用进行了修正。\n- 针对新布局重写了 `upgrade` 技能（从 642 行缩减至 276 行）。新增布局检测功能（跳过旧版 `.claude\u002Fcommands\u002F` 存储库），并加入了一步符号链接清理流程，使用 `-L` 和 `readlink` 安全修复错误或损坏的符号链接，同时为老用户提供了明确的迁移路径。原有安全机制全部保留（备份、强制差异检查、不自动选择、绝不使用 `cp -f`、列出“绝不触碰的文件”清单以及回滚说明）。\n- 重写了 `init-bootstrap` 技能中“可用命令”部分，使其指向带有自然语言触发器的技能。将已失效的 `\u002Fsetup-gemini` 和 `\u002Fsetup-firecrawl` 引用替换为具体的内联设置说明。\n- 重写了 README 中的“Claude Code 命令”部分，改为介绍技能；移除了已失效的 `\u002F[command-name]` 调用提示以及 `create-command` 条目。\n\n### 修复\n\n- `install-claudesidian-command` 技能：代码审查过程中发现了两个已存在的数据丢失漏洞。\n  1. `sed` 的范围删除命令 `\u002Falias|function\u002F,\u002F^end$\u002Fd` 会从一个 Bash 别名（没有 `end` 关键字）开始，一直删除到文件中下一个出现的 `^end$` 关键字，从而可能误删无关的 shell 配置。现已拆分为针对别名的单行删除和针对 Fish 函数的范围删除。\n  2. 路径转义顺序颠倒（先转义引号再转义反斜杠，导致新反斜杠被双重转义）。现已调整为先转义反斜杠。\n\n### 移除\n\n- `.claude\u002Fclaude_config.json`——已废弃且无代码引用的配置文件。\n- `.claude\u002Fcommands\u002FREADME.md`——针对空目录的过时文档。\n- `.claude\u002Fcommands\u002Fcreate-command.md`——不再需要。\n\n### 迁移\n\n- 对于仍采用 `.claude\u002Fcommands\u002F` 布局的现有存储库，请运行 `upgrade` 技能。它会检测到旧版布局，并逐步引导完成迁移过程（将命令文件移动到 `.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md`，通过 `add-frontmatter` 添加 frontmatter，创建符号链接，并进行验证）。迁移只需执行一次。成功完成后，后续升级将按正常流程进行。\n- 解决了 #16（升级至使用 Skills）和 #17（未知问题）。","2026-04-11T00:26:52",{"id":162,"version":163,"summary_zh":164,"released_at":165},360026,"v0.14.2","## 变更\n\n- 将 `@modelcontextprotocol\u002Fsdk` 更新至 v1.25.2（修复了高危的 ReDoS 和 DNS 重绑定漏洞）\n- 将开发依赖项（eslint、prettier、typescript-eslint）更新至最新版本\n\n## 新增\n\n- 为 kepano\u002Fobsidian-skills 添加 MIT 许可证归属信息（包括 json-canvas、obsidian-bases、obsidian-markdown）\n- 在 `.gitignore` 中添加 `.worktrees\u002F`，以支持 Git 工作树工作流\n\n## 安全\n\n- 修复了 5 个 Dependabot 安全警告（3 个高危，2 个中危）\n\n---\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2026-01-13T22:48:37",{"id":167,"version":168,"summary_zh":169,"released_at":170},360027,"v0.14.1","## 修复\n\n- 在 `firecrawl-batch.sh` 的文件名 sanitization 中保留 CJK（中文\u002F日文\u002F韩文）字符\n- 为 zsh 兼容性，将 `\u002Fupgrade` 命令中的 sed 替换为 cut\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2026-01-13T21:37:38",{"id":172,"version":173,"summary_zh":174,"released_at":175},360028,"v0.14.0","## 新增\n\n- 新增 `.claude\u002Fskills\u002F` 目录，包含自动触发的技能系统\n  - `obsidian-markdown` - Obsidian 风格 Markdown 参考（维基链接、提示框、嵌入）\n  - `obsidian-bases` - .base 文件的创建与编辑指南\n  - `json-canvas` - .canvas 文件的创建与编辑指南\n  - `systematic-debugging` - 四阶段调试方法论\n  - `skill-creator` - 创建新技能和命令的指南\n  - `git-worktrees` - Git 工作树工作流指南\n- 新增 `\u002Fpragmatic-review` 命令，用于以 YAGNI\u002FKISS 为导向的代码审查\n  - 默认模式：快速扫描过度设计\n  - 深度模式 (--deep)：六步全面审查\n  - CI 模式 (--ci)：非交互式，适用于 GitHub Actions\n- 技能发现钩子，在用户提到“skill”时列出可用技能\n- 更新了 `.prettierignore`，排除 Markdown 文件\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2026-01-13T21:24:11",{"id":177,"version":178,"summary_zh":179,"released_at":180},360029,"v0.13.1","## 修复\n\n- 将硬编码的文件夹路径中的空格替换为下划线\n  - 修复 `transcript-extract.sh`：`00 Inbox\u002FClippings` → `00_Inbox\u002FClippings\u002F`\n  - 修复 `firecrawl-batch.sh`：`00 Inbox\u002FClippings` → `00_Inbox\u002FClippings\u002F`\n  - 修复 `update-attachment-links.js`：`05 Attachments` → `05_Attachments`\n  - 修复 `fix-renamed-links.js`：`05 Attachments` → `05_Attachments`\n  - 修复 `GEMINI_VISION_QUICK_START.md` 中的示例路径\n- 移除 `firecrawl-batch.sh` 中的 `source ~\u002F.zshrc`，以消除安全风险\n- 修正 Gemini Vision 文档中不存在的文件引用\n\n## 新增\n\n- 为 `firecrawl-batch.sh` 添加自定义输出目录标志 (`-o|--output-dir`)\n- 在 `README.md` 中添加关于新输出目录选项的文档\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2025-10-13T01:44:22",{"id":182,"version":183,"summary_zh":184,"released_at":185},360030,"v0.13.0","## 新增\n\n- 新增 `\u002Finstall-claudesidian-command`，用于创建可在任意位置启动 Vault 的 Shell 别名或函数\n- 在 `\u002Finit-bootstrap` 中添加了对 iCloud Drive Vault 的检测与导入支持（仅限 macOS）\n- 为启动器命令增加了 Fish Shell 支持，并采用正确的函数语法\n- 提供全面的用户输入路径验证，并附带友好的错误提示信息\n- 实现平台检测功能，以确保跨平台兼容性（Linux、macOS、Windows）\n\n## 修复\n\n- 修复了启动器命令中的严重 Shell 注入漏洞，通过正确的路径转义实现安全防护\n- 在修改 Shell 配置文件之前先创建备份\n- 增强了 iCloud 同步状态检查功能，对于下载不完整的情况会发出温和警告\n- Shell 检测现使用默认 Shell 而非当前会话的 Shell\n- 替换现有别名或函数时会先征求用户确认\n- 完善了错误处理文档，并增加了相关说明\n\n## 安全性\n\n- 对包含空格、引号及特殊字符的 Vault 路径进行转义处理\n- 在修改 Shell 配置前生成带时间戳的备份\n- 对用户提供的 Vault 路径进行输入验证\n- 在文档中新增了安全注意事项章节\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2025-10-07T16:52:34",{"id":187,"version":188,"summary_zh":189,"released_at":190},360031,"v0.12.1","## 修复\n\n- 改进了升级命令，防止交互式提示和卡顿\n- 增强了升级命令，增加了明确的备份步骤和非交互式文件替换\n- 根据实际使用反馈优化了升级命令，提升了可靠性\n- 对升级命令应用了代码风格检查修复，以提高代码质量\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) 生成","2025-10-01T17:10:14",{"id":192,"version":193,"summary_zh":194,"released_at":195},360032,"v0.12.0","## 变更内容\n\n### 新增\n- 新的 `\u002Fdownload-attachment` 命令，用于将网页内容和文件下载到 Obsidian 的附件文件夹中\n- 新的 `\u002Fpull-request` 命令，用于创建带有智能变更分析和描述生成功能的 Pull Request\n- 两个命令均与 Obsidian 的 vault 结构无缝集成\n\n### 修复\n- 根据 PR 审查反馈对下载命令进行了安全改进\n- 调整代码格式以通过 lint 检查\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) 生成","2025-09-17T20:20:14",{"id":197,"version":198,"summary_zh":199,"released_at":200},360033,"v0.11.0","## 变更内容\n\n### 新增\n- 使用 ESLint 和 Prettier 实现全面的代码检查与格式化配置\n- 将配置文件组织到 `.config\u002F` 文件夹中，以优化项目结构\n- 添加 GitHub Actions 工作流，用于在拉取请求上自动执行代码检查\n- 规范包管理器使用，确保依赖管理的一致性\n\n### 修复\n- 解决了孤立的 `if` 语句 ESLint 警告，使代码更加整洁\n- 修正了 GitHub Actions 配置，确保 pnpm 正确设置\n- 添加了 `packageManager` 字段，以保证不同环境中工具链的一致性\n\n---\n\n🤖 由 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) 生成","2025-09-17T19:50:44",{"id":202,"version":203,"summary_zh":204,"released_at":205},360034,"v0.10.1","## [0.10.1] - 2025-01-15\n\n### Fixed\n- Corrected GitHub Action configuration to use `claude_args` instead of `allowed_tools`\n- Fixed workflow validation error for allowed tools parameter\n- Tools are now properly configured via the `--allowed-tools` flag\n\nThis patch release fixes the GitHub Action configuration issue that was causing validation errors.\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T20:57:33",{"id":207,"version":208,"summary_zh":209,"released_at":210},360035,"v0.10.0","## [0.10.0] - 2025-01-15\n\n### Added\n- 🤖 **GitHub Actions workflow for Claude Code integration**\n  - Claude can now respond to @claude mentions in issues and PRs\n  - Configured permissions for creating PRs and pushing changes\n  - Added allowed tools configuration for pnpm, git, gh CLI operations\n  - User restriction to repository owner for security\n  \n- 🔧 **Development workflow option in init-bootstrap**\n  - Personal vault users: Automatically removes .github folder\n  - Contributors: Keeps GitHub workflows for development\n  - Prevents confusion with GitHub Actions for personal vaults\n\n### What's New\n\nThis release brings GitHub integration to claudesidian! You can now:\n- Tag @claude in issues and PRs to get AI assistance\n- Have Claude automatically review code, fix issues, or answer questions\n- Keep development workflows separate from personal vault setups\n\n### Security\n- Only repository owner can trigger Claude actions\n- Proper permission scoping for GitHub operations\n- Personal vaults automatically have workflows removed\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T20:27:48",{"id":212,"version":213,"summary_zh":214,"released_at":215},360036,"v0.9.2","### Fixed\n- Corrected Firecrawl script examples to use npm run commands\n- Added contributing guideline about reviewing AI-generated content before submission\n\n### Removed\n- Removed Common Patterns section from README (redundant)\n\n---\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)\n\nCo-Authored-By: Claude \u003Cnoreply@anthropic.com>","2025-09-14T12:22:35",{"id":217,"version":218,"summary_zh":219,"released_at":220},360037,"v0.9.1","### Changed\n- Enhanced Gemini Vision documentation to explain direct image\u002FPDF processing benefits\n- Enhanced Firecrawl documentation to explain full-text capture and context preservation\n- Added detailed API key setup instructions for both Gemini and Firecrawl\n\n### Removed\n- Removed Essential Workflows section from README (redundant with command descriptions)\n\n---\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)\n\nCo-Authored-By: Claude \u003Cnoreply@anthropic.com>","2025-09-14T12:15:37",{"id":222,"version":223,"summary_zh":224,"released_at":225},360038,"v0.9.0","### Added\n- Enhanced upgrade command documentation with detailed usage examples and safety features\n- Contributing section with guidelines for community contributions\n- MIT license file for clear open-source licensing\n\n### Changed\n- Improved documentation clarity on Claude Code commands vs agents distinction\n- Updated contributing guidelines to encourage PRs for commands, agents, and core updates\n\n### Removed\n- Removed thinking-partner agent (keeping slash command only)\n\n---\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)\n\nCo-Authored-By: Claude \u003Cnoreply@anthropic.com>","2025-09-14T12:02:49",{"id":227,"version":228,"summary_zh":229,"released_at":230},360039,"v0.8.8","## [0.8.8] - 2025-01-13\n\n### Fixed\n- Added critical warnings to upgrade command documentation\n- Emphasized requirement to show diffs before applying changes\n- Added correct vs wrong implementation examples\n- Prevents loss of user customizations during upgrades\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T02:09:50",{"id":232,"version":233,"summary_zh":234,"released_at":235},360040,"v0.8.7","## [0.8.7] - 2025-01-13\n\n### Fixed\n- Release command now automatically creates GitHub release using gh CLI\n- Prevents missing GitHub releases (like v0.8.2-v0.8.5 were)\n- Extracts release notes from CHANGELOG.md for GitHub release body\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T02:07:31",{"id":237,"version":238,"summary_zh":239,"released_at":240},360041,"v0.8.6","## [0.8.6] - 2025-01-13\n\n### Changed\n- Improved semantic versioning guidelines in release command with clearer decision guide\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T02:03:14",{"id":242,"version":243,"summary_zh":244,"released_at":245},360042,"v0.8.5","## [0.8.5] - 2025-01-13\n\n### Fixed\n- Upgrade command now works without git connection for disconnected users\n- Clone latest version to .tmp\u002F directory instead of requiring upstream remote\n- Use .tmp\u002F instead of \u002Ftmp\u002F to hide upgrade files from Obsidian\n- Added user choice prompt when local modifications are detected\n- Added verification step to ensure all files were properly addressed\n- Added .tmp\u002F to .gitignore for cleaner repository\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T02:03:26",{"id":247,"version":248,"summary_zh":249,"released_at":250},360043,"v0.8.4","## [0.8.4] - 2025-01-13\n\n### Fixed\n- Simplified upgrade command to systematically check all system files\n- Created upgrade checklist to track progress file-by-file\n- Filtered upgrades to only claudesidian system files, not user content\n- Added explicit file-by-file diff review before updating\n- Made upgrade process resumable with checklist tracking\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode)","2025-09-14T02:03:35"]