[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MrLesk--Backlog.md":3,"tool-MrLesk--Backlog.md":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},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,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},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 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70626,"2026-04-05T22:51:36",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":81,"owner_email":80,"owner_twitter":82,"owner_website":83,"owner_url":84,"languages":85,"stars":110,"forks":111,"last_commit_at":112,"license":113,"difficulty_score":114,"env_os":115,"env_gpu":116,"env_ram":116,"env_deps":117,"category_tags":123,"github_topics":124,"view_count":23,"oss_zip_url":80,"oss_zip_packed_at":80,"status":16,"created_at":132,"updated_at":133,"faqs":134,"releases":165},2429,"MrLesk\u002FBacklog.md","Backlog.md","Backlog.md - A tool for managing project collaboration between humans and AI Agents in a git ecosystem","Backlog.md 是一款专为 Git 生态系统设计的轻量级项目管理工具，旨在优化人类开发者与 AI 智能体之间的协作流程。它将传统的任务看板转化为纯 Markdown 文件，直接存储在代码仓库中，无需依赖任何外部服务器或复杂的配置即可运行。\n\n在 AI 辅助编程日益普及的今天，开发者常面临任务上下文丢失、AI 输出不可控以及项目状态不同步等痛点。Backlog.md 通过“规范驱动开发”的理念解决了这些问题。它允许用户以结构化的 Markdown 文档定义任务、验收标准和实施计划，确保 AI 智能体（如 Claude Code、Gemini CLI 等）能够准确理解需求并交付可预测的代码结果。这种“单一事实来源”的设计，使得任务管理与代码版本控制完美融合，既保证了数据的 100% 隐私与离线可用性，又实现了跨平台的无缝同步。\n\nBacklog.md 特别适合热衷于使用 AI 编程助手的软件开发者、技术团队负责人以及开源项目维护者。它不仅提供命令行下的即时看板视图和现代化的 Web 管理界面，还支持模糊搜索、任务导出及灵活的查询命令。其独特的技术亮点在于原生支持 MCP（模型上下文协","Backlog.md 是一款专为 Git 生态系统设计的轻量级项目管理工具，旨在优化人类开发者与 AI 智能体之间的协作流程。它将传统的任务看板转化为纯 Markdown 文件，直接存储在代码仓库中，无需依赖任何外部服务器或复杂的配置即可运行。\n\n在 AI 辅助编程日益普及的今天，开发者常面临任务上下文丢失、AI 输出不可控以及项目状态不同步等痛点。Backlog.md 通过“规范驱动开发”的理念解决了这些问题。它允许用户以结构化的 Markdown 文档定义任务、验收标准和实施计划，确保 AI 智能体（如 Claude Code、Gemini CLI 等）能够准确理解需求并交付可预测的代码结果。这种“单一事实来源”的设计，使得任务管理与代码版本控制完美融合，既保证了数据的 100% 隐私与离线可用性，又实现了跨平台的无缝同步。\n\nBacklog.md 特别适合热衷于使用 AI 编程助手的软件开发者、技术团队负责人以及开源项目维护者。它不仅提供命令行下的即时看板视图和现代化的 Web 管理界面，还支持模糊搜索、任务导出及灵活的查询命令。其独特的技术亮点在于原生支持 MCP（模型上下文协议）和 CLI 集成，能够自动为 AI 助手生成工作流指令，让 AI 真正“读懂”项目 backlog。如果你希望在不引入重型项目管理软件的前提下，实现高效、透明且对 AI 友好的开发协作，Backlog.md 是一个简洁而强大的选择。","\u003Ch1 align=\"center\">Backlog.md\u003C\u002Fh1>\n\u003Cp align=\"center\">Markdown‑native Task Manager & Kanban visualizer for any Git repository\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ccode>npm i -g backlog.md\u003C\u002Fcode> or \u003Ccode>bun add -g backlog.md\u003C\u002Fcode> or \u003Ccode>brew install backlog-md\u003C\u002Fcode> or \u003Ccode>nix run github:MrLesk\u002FBacklog.md\u003C\u002Fcode>\n\u003C\u002Fp>\n\n![Backlog demo GIF using: backlog board](.\u002F.github\u002Fbacklog-v1.40.gif)\n\n\n---\n\n> **Backlog.md** turns any folder with a Git repo into a **self‑contained project board**\n> powered by plain Markdown files and a zero‑config CLI.\n> Built for **spec‑driven AI development** — structure your tasks so AI agents deliver predictable results.\n\n## Features\n\n* 📝 **Markdown-native tasks** -- manage every issue as a plain `.md` file\n\n* 🤖 **AI-Ready** -- Works with Claude Code, Gemini CLI, Codex, Kiro & any other MCP or CLI compatible AI assistants\n\n* 📊 **Instant terminal Kanban** -- `backlog board` paints a live board in your shell\n\n* 🌐 **Modern web interface** -- `backlog browser` launches a sleek web UI for visual task management\n\n* 🔍 **Powerful search** -- fuzzy search across tasks, docs & decisions with `backlog search`\n\n* 📋 **Rich query commands** -- view, list, filter, or archive tasks with ease\n* ✅ **Definition of Done defaults** -- add a reusable checklist to every new task\n\n* 📤 **Board export** -- `backlog board export` creates shareable markdown reports\n\n* 🔒 **100 % private & offline** -- backlog lives entirely inside your repo and you can manage everything locally\n\n* 💻 **Cross-platform** -- runs on macOS, Linux, and Windows\n\n* 🆓 **MIT-licensed & open-source** -- free for personal or commercial use\n\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002F5-minute-tour-256.png\" alt=\"Getting started\" width=\"28\" height=\"28\" align=\"center\"> Getting started\n\n```bash\n# Install\nbun i -g backlog.md\n# or: npm i -g backlog.md\n# or: brew install backlog-md\n\n# Initialize in any git repo\nbacklog init \"My Awesome Project\"\n```\n\nThe init wizard will ask how you want to connect AI tools:\n- **MCP connector** (recommended) — auto-configures Claude Code, Codex, Gemini CLI, Kiro or Cursor and adds workflow instructions for your agents.\n- **CLI commands** — creates instruction files (CLAUDE.md, AGENTS.md, etc.) so agents use Backlog via CLI.\n- **Skip** — no AI setup; use Backlog.md purely as a task manager.\n\nBacklog data is stored in a project-local backlog folder such as `backlog\u002F`, `.backlog\u002F`, or a custom project-relative path configured through `backlog.config.yml`. Tasks remain human-readable Markdown files (e.g. `task-10 - Add core search functionality.md`).\n\n---\n\n### Working with AI agents\n\nThis is the recommended flow for Claude Code, Codex, Gemini CLI, Kiro and similar tools — following the **spec‑driven AI development** approach.\nAfter running `backlog init` and choosing the MCP or CLI integration, work in this loop:\n\n**Step 1 — Describe your idea.** Tell the agent what you want to build and ask it to split the work into small tasks with clear descriptions and acceptance criteria.\n\n**🤖 Ask your AI Agent:**\n> I want to add a search feature to the web view that searches tasks, docs, and decisions. Please decompose this into small Backlog.md tasks.\n\n> [!NOTE]\n> **Review checkpoint #1** — read the task descriptions and acceptance criteria.\n\n**Step 2 — One task at a time.** Work on a single task per agent session, one PR per task. Good task splitting means each session can work independently without conflicts. Make sure each task is small enough to complete in a single conversation. You want to avoid running out of context window.\n\n**Step 3 — Plan before coding.** Ask the agent to research and write an implementation plan in the task. Do this right before implementation so the plan reflects the current state of the codebase.\n\n**🤖 Ask your AI Agent:**\n> Work on BACK-10 only. Research the codebase and write an implementation plan in the task. Wait for my approval before coding.\n\n> [!NOTE]\n> **Review checkpoint #2** — read the plan. Does the approach make sense? Approve it or ask the agent to revise.\n\n**Step 4 — Implement and verify.** Let the agent implement the task.\n\n> [!NOTE]\n> **Review checkpoint #3** — review the code, run tests, check linting, and verify the results match your expectations.\n\nIf the output is not good enough: clear the plan\u002Fnotes\u002Ffinal summary, refine the task description and acceptance criteria, and run the task again in a fresh session.\n\n---\n\n### Working without AI agents\n\nUse Backlog.md as a standalone task manager from the terminal or browser.\n\n```bash\n# Create and refine tasks\nbacklog task create \"Render markdown as kanban\"\nbacklog task edit BACK-1 -d \"Detailed context\" --ac \"Clear acceptance criteria\"\n\n# Track work\nbacklog task list -s \"To Do\"\nbacklog search \"kanban\"\nbacklog board\n\n# Work visually in the browser\nbacklog browser\n```\n\nYou can switch between AI-assisted and manual workflows at any time — both operate on the same Markdown task files. It is recommended to modify tasks via Backlog.md commands (CLI\u002FMCP\u002FWeb) rather than editing task files manually, so field types and metadata stay consistent.\n\n**Learn more:** [CLI reference](CLI-INSTRUCTIONS.md) | [Advanced configuration](ADVANCED-CONFIG.md)\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fweb-interface-256.png\" alt=\"Web Interface\" width=\"28\" height=\"28\" align=\"center\"> Web Interface\n\nLaunch a modern, responsive web interface for visual task management:\n\n```bash\n# Start the web server (opens browser automatically)\nbacklog browser\n\n# Custom port\nbacklog browser --port 8080\n\n# Don't open browser automatically\nbacklog browser --no-open\n```\n\n**Features:**\n- Interactive Kanban board with drag-and-drop\n- Task creation and editing with rich forms\n- Interactive acceptance criteria editor with checklists\n- Real-time updates across all views\n- Responsive design for desktop and mobile\n- Task archiving with confirmation dialogs\n- Seamless CLI integration - all changes sync with markdown files\n\n![Web Interface Screenshot](.\u002F.github\u002Fweb.jpeg)\n\n---\n\n## 🔧 MCP Integration (Model Context Protocol)\n\nThe easiest way to connect Backlog.md to AI coding assistants like Claude Code, Codex, Gemini CLI and Kiro is via the MCP protocol.\nYou can run `backlog init` (even if you already initialized Backlog.md) to set up MCP integration automatically, or follow the manual steps below.\n\n### Client guides\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  claude mcp add backlog --scope user -- backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Codex\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  codex mcp add backlog backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Gemini CLI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  gemini mcp add backlog -s user backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Kiro\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  kiro-cli mcp add --scope global --name backlog --command backlog --args mcp,start\n  ```\n\n\u003C\u002Fdetails>\n\nUse the shared `backlog` server name everywhere – the MCP server auto-detects whether the current directory is initialized and falls back to `backlog:\u002F\u002Finit-required` when needed.\n\n### Manual config\n\n```json\n{\n  \"mcpServers\": {\n    \"backlog\": {\n      \"command\": \"backlog\",\n      \"args\": [\"mcp\", \"start\"],\n      \"env\": {\n        \"BACKLOG_CWD\": \"\u002Fabsolute\u002Fpath\u002Fto\u002Fyour\u002Fproject\"\n      }\n    }\n  }\n}\n```\n\nIf your IDE can't set the process working directory for MCP servers, set `BACKLOG_CWD` as shown above.\nIf your IDE supports custom args but not env vars, you can also use `[\"mcp\", \"start\", \"--cwd\", \"\u002Fabsolute\u002Fpath\u002Fto\u002Fyour\u002Fproject\"]`.\n\n> [!IMPORTANT]\n> When adding the MCP server manually, you should add some extra instructions in your CLAUDE.md\u002FAGENTS.md files to inform the agent about Backlog.md.\n> This step is not required when using `backlog init` as it adds these instructions automatically.\n> Backlog.md's instructions for agents are available at [`\u002Fsrc\u002Fguidelines\u002Fmcp\u002Fagent-nudge.md`](\u002Fsrc\u002Fguidelines\u002Fmcp\u002Fagent-nudge.md).\n\n\nOnce connected, agents can read the Backlog.md workflow instructions via the resource `backlog:\u002F\u002Fdocs\u002Ftask-workflow`.\nUse `\u002Fmcp` command in your AI tool (Claude Code, Codex, Kiro) to verify if the connection is working.\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fcli-reference-256.png\" alt=\"CLI Reference\" width=\"28\" height=\"28\" align=\"center\"> CLI reference\n\nFull command reference — task management, search, board, docs, decisions, and more: **[CLI-INSTRUCTIONS.md](CLI-INSTRUCTIONS.md)**\n\nQuick examples: `backlog task create`, `backlog task list`, `backlog task edit`, `backlog search`, `backlog board`, `backlog browser`.\n\nFull help: `backlog --help`\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fconfiguration-256.png\" alt=\"Configuration\" width=\"28\" height=\"28\" align=\"center\"> Configuration\n\nBacklog.md merges the following layers (highest → lowest):\n\n1. CLI flags\n2. Project config file:\n   - `backlog.config.yml` when present\n   - otherwise `backlog\u002Fconfig.yml` or `.backlog\u002Fconfig.yml`\n3. Built‑ins\n\n### Interactive wizard (`backlog config`)\n\nRun `backlog config` with no arguments to launch the full interactive wizard. This is the same experience triggered from `backlog init` when you opt into advanced settings, and it walks through the complete configuration surface:\n- Cross-branch accuracy: `checkActiveBranches`, `remoteOperations`, and `activeBranchDays`.\n- Git workflow: `autoCommit` and `bypassGitHooks`.\n- ID formatting: enable or size `zeroPaddedIds`.\n- Editor integration: pick a `defaultEditor` with availability checks.\n- Definition of Done defaults: interactively add\u002Fremove\u002Freorder\u002Fclear project-level `definition_of_done` checklist items.\n- Web UI defaults: choose `defaultPort` and whether `autoOpenBrowser` should run.\n\nSkipping the wizard (answering \"No\" during init) applies the safe defaults that ship with Backlog.md:\n- `checkActiveBranches=true`, `remoteOperations=true`, `activeBranchDays=30`.\n- `autoCommit=false`, `bypassGitHooks=false`.\n- `zeroPaddedIds` disabled.\n- `defaultEditor` unset (falls back to your environment).\n- `defaultPort=6420`, `autoOpenBrowser=true`.\n\nWhenever you revisit `backlog init` or rerun `backlog config`, the wizard pre-populates prompts with your current values so you can adjust only what changed.\n\n### Definition of Done defaults\n\nSet project-wide DoD items with `backlog config` (or during `backlog init` advanced setup), in the Web UI (Settings → Definition of Done Defaults), or by editing the project config file directly:\n\n```yaml\ndefinition_of_done:\n  - Tests pass\n  - Documentation updated\n  - No regressions introduced\n```\n\nWhen a project uses root config discovery, edit `backlog.config.yml` instead of `backlog\u002Fconfig.yml`.\n\nThese items are added to every new task by default. You can add more on create with `--dod`, or disable defaults per task with `--no-dod-defaults`.\n\nFor the full configuration reference (all options, commands, and detailed notes), see **[ADVANCED-CONFIG.md](ADVANCED-CONFIG.md)**.\n\n---\n\n### License\n\nBacklog.md is released under the **MIT License** – do anything, just give credit. See [LICENSE](LICENSE).\n","\u003Ch1 align=\"center\">Backlog.md\u003C\u002Fh1>\n\u003Cp align=\"center\">原生支持 Markdown 的任务管理器与看板可视化工具，适用于任何 Git 仓库\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n\u003Ccode>npm i -g backlog.md\u003C\u002Fcode> 或 \u003Ccode>bun add -g backlog.md\u003C\u002Fcode> 或 \u003Ccode>brew install backlog-md\u003C\u002Fcode> 或 \u003Ccode>nix run github:MrLesk\u002FBacklog.md\u003C\u002Fcode>\n\u003C\u002Fp>\n\n![使用 Backlog 看板的演示 GIF](.\u002F.github\u002Fbacklog-v1.40.gif)\n\n\n---\n\n> **Backlog.md** 可以将任意包含 Git 仓库的文件夹转换为一个**自包含的项目看板**，\n> 完全基于纯 Markdown 文件和零配置的命令行工具。专为**规范驱动的 AI 开发**而设计——通过结构化任务，让 AI 助手交付可预测的结果。\n\n## 特性\n\n* 📝 **原生 Markdown 任务** -- 将每个问题都以普通的 `.md` 文件形式进行管理\n\n* 🤖 **AI 就绪** -- 兼容 Claude Code、Gemini CLI、Codex、Kiro 以及其他任何符合 MCP 或 CLI 标准的 AI 助手\n\n* 📊 **即时终端看板** -- `backlog board` 命令可在你的终端中实时绘制出看板视图\n\n* 🌐 **现代化 Web 界面** -- `backlog browser` 命令会启动一个简洁美观的 Web UI，用于可视化任务管理\n\n* 🔍 **强大的搜索功能** -- 使用 `backlog search` 命令可在任务、文档和决策中进行模糊搜索\n\n* 📋 **丰富的查询命令** -- 轻松查看、列出、筛选或归档任务\n* ✅ **完成标准默认设置** -- 为每个新任务添加可复用的检查清单\n\n* 📤 **看板导出** -- `backlog board export` 命令可以生成可分享的 Markdown 报告\n\n* 🔒 **100% 私密且离线** -- Backlog 的所有数据完全存储在你的仓库内，你可以完全在本地管理一切\n\n* 💻 **跨平台** -- 支持 macOS、Linux 和 Windows\n\n* 🆓 **MIT 许可且开源** -- 个人及商业用途均可免费使用\n\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002F5-minute-tour-256.png\" alt=\"入门\" width=\"28\" height=\"28\" align=\"center\"> 入门指南\n\n```bash\n# 安装\nbun i -g backlog.md\n# 或：npm i -g backlog.md\n# 或：brew install backlog-md\n\n# 在任意 Git 仓库中初始化\nbacklog init \"我的超棒项目\"\n```\n\n初始化向导会询问你希望如何连接 AI 工具：\n- **MCP 连接器**（推荐）— 自动配置 Claude Code、Codex、Gemini CLI、Kiro 或 Cursor，并为你的助手添加工作流说明。\n- **CLI 命令** — 创建指令文件（CLAUDE.md、AGENTS.md 等），以便助手通过 CLI 使用 Backlog。\n- **跳过** — 不进行 AI 设置；仅将 Backlog.md 作为纯粹的任务管理工具使用。\n\nBacklog 的数据会存储在项目本地的 `backlog\u002F`、`.backlog\u002F` 文件夹中，或者通过 `backlog.config.yml` 配置的自定义相对路径。任务始终是人类可读的 Markdown 文件（例如 `task-10 - 添加核心搜索功能.md`）。\n\n---\n\n### 与 AI 助手协作\n\n这是针对 Claude Code、Codex、Gemini CLI、Kiro 等工具推荐的工作流程——遵循**规范驱动的 AI 开发**方法。运行 `backlog init` 并选择 MCP 或 CLI 集成后，按照以下循环操作：\n\n**步骤 1 — 描述你的想法。** 向助手说明你想构建什么，并请它将工作拆分为多个小任务，每个任务都应有清晰的描述和验收标准。\n\n**🤖 请求你的 AI 助手：**\n> 我想在网页视图中添加一个搜索功能，能够搜索任务、文档和决策。请将其分解为若干个 Backlog.md 任务。\n\n> [!NOTE]\n> **审查检查点 #1** — 阅读任务描述和验收标准。\n\n**步骤 2 — 每次处理一个任务。** 每次与助手对话只处理一个任务，每个任务对应一个 Pull Request。良好的任务拆分意味着每次对话都可以独立完成，不会产生冲突。确保每个任务足够小，能够在一次对话中完成。这样可以避免上下文窗口不足的问题。\n\n**步骤 3 — 编写计划再编码。** 请助手研究并编写任务的实现计划。务必在实施之前执行此步骤，以确保计划反映当前代码库的状态。\n\n**🤖 请求你的 AI 助手：**\n> 请只处理 BACK-10 任务。研究代码库并在任务中写下实现计划。等待我的批准后再开始编码。\n\n> [!NOTE]\n> **审查检查点 #2** — 阅读计划。这个方案是否合理？批准它，或者要求助手修改。\n\n**步骤 4 — 实现并验证。** 让助手完成任务的实现。\n\n> [!NOTE]\n> **审查检查点 #3** — 审查代码，运行测试，检查代码风格，并确认结果符合预期。\n\n如果输出不够理想：清除计划、笔记和最终总结，重新细化任务描述和验收标准，然后在新的对话中再次执行该任务。\n\n---\n\n### 不使用 AI 助手时的操作\n\n将 Backlog.md 作为独立的任务管理工具，通过终端或浏览器进行操作。\n\n```bash\n# 创建和优化任务\nbacklog task create \"将 Markdown 渲染为看板\"\nbacklog task edit BACK-1 -d \"详细背景信息\" --ac \"明确的验收标准\"\n\n# 跟踪工作\nbacklog task list -s \"待办\"\nbacklog search \"看板\"\nbacklog board\n\n# 在浏览器中进行可视化操作\nbacklog browser\n```\n\n你可以随时在 AI 辅助和手动工作流之间切换——两者都基于相同的 Markdown 任务文件。建议通过 Backlog.md 提供的命令行工具（CLI\u002FMCP\u002FWeb）来修改任务，而不是直接编辑任务文件，这样可以保持字段类型和元数据的一致性。\n\n**了解更多：** [CLI 参考](CLI-INSTRUCTIONS.md) | [高级配置](ADVANCED-CONFIG.md)\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fweb-interface-256.png\" alt=\"Web 界面\" width=\"28\" height=\"28\" align=\"center\"> Web 界面\n\n启动一个现代化、响应式的 Web 界面，用于可视化任务管理：\n\n```bash\n# 启动 Web 服务器（自动打开浏览器）\nbacklog browser\n\n# 自定义端口\nbacklog browser --port 8080\n\n# 不自动打开浏览器\nbacklog browser --no-open\n```\n\n**功能：**\n- 带拖拽功能的交互式看板\n- 丰富的表单用于创建和编辑任务\n- 带检查清单的交互式验收标准编辑器\n- 所有视图实时更新\n- 适配桌面和移动设备的响应式设计\n- 带确认对话框的任务归档功能\n- 与命令行无缝集成——所有更改都会同步到 Markdown 文件中\n\n![Web 界面截图](.\u002F.github\u002Fweb.jpeg)\n\n---\n\n## 🔧 MCP 集成（模型上下文协议）\n\n将 Backlog.md 与 Claude Code、Codex、Gemini CLI 和 Kiro 等 AI 编码助手连接的最简单方式是通过 MCP 协议。你可以运行 `backlog init`（即使你已经初始化过 Backlog.md）来自动设置 MCP 集成，或者按照下面的手动步骤操作。\n\n### 客户端指南\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Claude Code\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  claude mcp add backlog --scope user -- backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Codex\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  codex mcp add backlog backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Gemini CLI\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  gemini mcp add backlog -s user backlog mcp start\n  ```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Kiro\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n  ```bash\n  kiro-cli mcp add --scope global --name backlog --command backlog --args mcp,start\n  ```\n\n\u003C\u002Fdetails>\n\n在所有地方都使用共享的 `backlog` 服务器名称——MCP 服务器会自动检测当前目录是否已初始化，并在需要时回退到 `backlog:\u002F\u002Finit-required`。\n\n### 手动配置\n\n```json\n{\n  \"mcpServers\": {\n    \"backlog\": {\n      \"command\": \"backlog\",\n      \"args\": [\"mcp\", \"start\"],\n      \"env\": {\n        \"BACKLOG_CWD\": \"\u002Fabsolute\u002Fpath\u002Fto\u002Fyour\u002Fproject\"\n      }\n    }\n  }\n}\n```\n\n如果您的 IDE 无法为 MCP 服务器设置进程工作目录，请按照上述方式设置 `BACKLOG_CWD`。如果您的 IDE 支持自定义参数但不支持环境变量，您也可以使用 `[\"mcp\", \"start\", \"--cwd\", \"\u002Fabsolute\u002Fpath\u002Fto\u002Fyour\u002Fproject\"]`。\n\n> [!重要]\n> 手动添加 MCP 服务器时，应在 CLAUDE.md\u002FAGENTS.md 文件中添加一些额外的说明，以告知代理关于 Backlog.md 的信息。\n> 使用 `backlog init` 时不需要此步骤，因为它会自动添加这些说明。\n> Backlog.md 中关于代理的说明可在 [`\u002Fsrc\u002Fguidelines\u002Fmcp\u002Fagent-nudge.md`](\u002Fsrc\u002Fguidelines\u002Fmcp\u002Fagent-nudge.md) 找到。\n\n\n连接成功后，代理可以通过资源 `backlog:\u002F\u002Fdocs\u002Ftask-workflow` 阅读 Backlog.md 工作流说明。\n请在您的 AI 工具（Claude Code、Codex、Kiro）中使用 `\u002Fmcp` 命令来验证连接是否正常工作。\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fcli-reference-256.png\" alt=\"CLI 参考\" width=\"28\" height=\"28\" align=\"center\"> CLI 参考\n\n完整的命令参考——任务管理、搜索、看板、文档、决策等：**[CLI-INSTRUCTIONS.md](CLI-INSTRUCTIONS.md)**\n\n快速示例：`backlog task create`、`backlog task list`、`backlog task edit`、`backlog search`、`backlog board`、`backlog browser`。\n\n完整帮助：`backlog --help`\n\n---\n\n## \u003Cimg src=\".\u002F.github\u002Fconfiguration-256.png\" alt=\"配置\" width=\"28\" height=\"28\" align=\"center\"> 配置\n\nBacklog.md 合并了以下几层配置（从高到低）：\n\n1. CLI 标志\n2. 项目配置文件：\n   - 如果存在 `backlog.config.yml`，则优先使用\n   - 否则使用 `backlog\u002Fconfig.yml` 或 `.backlog\u002Fconfig.yml`\n3. 内置默认值\n\n### 交互式向导（`backlog config`）\n\n运行 `backlog config` 而不带任何参数即可启动完整的交互式向导。这与您在选择高级设置时通过 `backlog init` 触发的体验相同，它将引导您完成整个配置流程：\n- 跨分支准确性：`checkActiveBranches`、`remoteOperations` 和 `activeBranchDays`。\n- Git 工作流：`autoCommit` 和 `bypassGitHooks`。\n- ID 格式化：启用或调整 `zeroPaddedIds` 的长度。\n- 编辑器集成：选择一个带有可用性检查的 `defaultEditor`。\n- 完成标准默认值：以交互方式添加\u002F删除\u002F重新排序\u002F清空项目级别的 `definition_of_done` 检查清单项。\n- Web UI 默认值：选择 `defaultPort` 以及是否应自动打开浏览器。\n\n如果您跳过向导（在初始化过程中回答“否”），则会应用 Backlog.md 自带的安全默认值：\n- `checkActiveBranches=true`、`remoteOperations=true`、`activeBranchDays=30`。\n- `autoCommit=false`、`bypassGitHooks=false`。\n- `zeroPaddedIds` 已禁用。\n- `defaultEditor` 未设置（将回退到您的环境）。\n- `defaultPort=6420`、`autoOpenBrowser=true`。\n\n无论何时您再次访问 `backlog init` 或重新运行 `backlog config`，向导都会预先填充您当前的值，以便您只需调整已更改的部分。\n\n### 完成标准默认值\n\n您可以通过 `backlog config`（或在 `backlog init` 的高级设置中）、Web UI（设置 → 完成标准默认值）或直接编辑项目配置文件来设置项目范围内的 DoD 项目：\n\n```yaml\ndefinition_of_done:\n  - 测试通过\n  - 文档已更新\n  - 未引入回归\n```\n\n当项目使用根目录配置发现功能时，请编辑 `backlog.config.yml` 而不是 `backlog\u002Fconfig.yml`。\n\n这些项目默认会添加到每个新任务中。您可以在创建任务时使用 `--dod` 添加更多项目，或使用 `--no-dod-defaults` 禁用默认项目。\n\n有关完整配置参考（所有选项、命令及详细说明），请参阅 **[ADVANCED-CONFIG.md](ADVANCED-CONFIG.md)**。\n\n---\n\n### 许可证\n\nBacklog.md 采用 **MIT 许可证** 发布——您可以自由使用，但需注明出处。详情请参阅 [LICENSE](LICENSE)。","# Backlog.md 快速上手指南\n\nBacklog.md 是一个基于 Markdown 的任务管理器和看板可视化工具，专为 Git 仓库设计。它将任务存储为纯文本 `.md` 文件，支持零配置 CLI、终端看板、Web 界面以及与 Claude Code、Gemini 等 AI 编程助手的深度集成。\n\n## 环境准备\n\n*   **操作系统**：macOS, Linux, Windows\n*   **前置依赖**：\n    *   已安装 **Git** 并初始化了仓库。\n    *   已安装以下任一包管理器：**Node.js (npm)**, **Bun**, 或 **Homebrew**。\n*   **AI 集成（可选）**：如需与 AI 助手联动，需安装支持的客户端（如 Claude Code, Codex, Gemini CLI, Kiro 等）。\n\n## 安装步骤\n\n选择以下任意一种方式全局安装 Backlog.md：\n\n```bash\n# 使用 npm\nnpm i -g backlog.md\n\n# 使用 Bun\nbun add -g backlog.md\n\n# 使用 Homebrew (macOS\u002FLinux)\nbrew install backlog-md\n\n# 使用 Nix\nnix run github:MrLesk\u002FBacklog.md\n```\n\n## 基本使用\n\n### 1. 初始化项目\n\n进入你的 Git 仓库目录，运行初始化命令。向导将询问你如何连接 AI 工具（推荐选择 MCP 连接器以自动配置 AI 工作流，或选择 Skip 仅作为普通任务管理器使用）。\n\n```bash\nbacklog init \"My Awesome Project\"\n```\n\n*初始化后，任务数据将存储在项目本地的 `backlog\u002F` 或 `.backlog\u002F` 文件夹中，所有任务均为人类可读的 Markdown 文件。*\n\n### 2. 创建与管理任务\n\n你可以使用 CLI 命令快速创建和查看任务：\n\n```bash\n# 创建新任务\nbacklog task create \"Render markdown as kanban\"\n\n# 编辑任务详情和验收标准\nbacklog task edit BACK-1 -d \"Detailed context\" --ac \"Clear acceptance criteria\"\n\n# 列出待办任务\nbacklog task list -s \"To Do\"\n\n# 模糊搜索任务、文档或决策\nbacklog search \"kanban\"\n```\n\n### 3. 可视化看板\n\nBacklog.md 提供两种看板视图：\n\n**终端看板（即时预览）：**\n```bash\nbacklog board\n```\n\n**Web 界面（功能更丰富，支持拖拽）：**\n```bash\n# 启动 Web 服务并自动打开浏览器\nbacklog browser\n\n# 指定端口\nbacklog browser --port 8080\n```\n\n### 4. 与 AI 助手协作（推荐工作流）\n\n如果你选择了 MCP 或 CLI 集成模式，可以遵循“规格驱动开发”流程：\n\n1.  **分解任务**：让 AI 将大需求拆分为小的 Backlog.md 任务。\n    > *示例提示词*：\"I want to add a search feature... Please decompose this into small Backlog.md tasks.\"\n2.  **逐个执行**：每次会话只处理一个任务，避免上下文溢出。\n3.  **先计划后编码**：要求 AI 在任务文件中写入实施计划，经你批准后再编码。\n    > *示例提示词*：\"Work on BACK-10 only. Research the codebase and write an implementation plan in the task. Wait for my approval before coding.\"\n4.  **实现与验证**：让 AI 执行代码并验证结果。\n\n*注意：建议通过 Backlog.md 的命令（CLI\u002FMCP\u002FWeb）修改任务，以确保元数据和字段类型的一致性。*","资深全栈开发者 Alex 正在独立开发一个基于 Next.js 的 SaaS 仪表盘，他计划利用 Claude Code 等 AI 编程助手加速功能迭代，但需要确保代码质量与架构的一致性。\n\n### 没有 Backlog.md 时\n\n- **任务上下文碎片化**：需求分散在聊天窗口、便签或口头记忆中，AI 经常因缺乏完整背景而“幻觉”出错误的实现方案，导致反复修正。\n- **协作状态不透明**：无法直观追踪哪些功能已完成、哪些待办，每次开启新的 AI 会话都要重新粘贴大量代码和背景信息，极易超出上下文窗口限制。\n- **验收标准模糊**：AI 生成的代码往往只满足表面功能，缺少统一的“完成定义”（Definition of Done），导致测试覆盖率低或边缘情况被忽略。\n- **历史记录难追溯**：决策过程和任务变更散落在漫长的对话日志中，后期复盘或排查 Bug 时难以定位当初的设计意图。\n\n### 使用 Backlog.md 后\n\n- **结构化任务驱动**：Alex 通过 `backlog init` 初始化项目，将大需求拆解为独立的 `.md` 任务文件。AI 代理直接读取 Markdown 中的详细描述和验收标准，确保每次输出都精准对齐需求。\n- **可视化进度管理**：运行 `backlog board` 即可在终端看到实时看板，清晰区分 To-Do、In Progress 和 Done 状态。每个任务独立对应一次 Git 提交，上下文隔离完美，避免信息过载。\n- **标准化交付质量**：利用内置的“完成定义”模板，AI 在编码前会自动生成实施计划并等待确认，确保包含单元测试和文档更新，显著提升代码健壮性。\n- **本地化知识沉淀**：所有任务、决策和搜索记录均存储在 Git 仓库中，支持离线模糊搜索。Alex 可随时回溯历史决策，形成可维护的项目知识库。\n\nBacklog.md 通过将非结构化的 AI 对话转化为 Git 原生的结构化工作流，让开发者在享受 AI 高效编码的同时，牢牢掌握项目的控制权与可维护性。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMrLesk_Backlog.md_4084af3d.jpg","MrLesk","Alex Gavrilescu","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMrLesk_a0ef63a6.jpg","Born in Romania 👶🇷🇴  - \r\nRaised in Italy 🎓🇮🇹  - \r\nLiving in Vienna 🏛️🇦🇹  - \r\nCoding around the world 👨‍💻🗺️",null,"Vienna","mrlesk","https:\u002F\u002Fmrlesk.com","https:\u002F\u002Fgithub.com\u002FMrLesk",[86,90,94,98,102,106],{"name":87,"color":88,"percentage":89},"TypeScript","#3178c6",86.2,{"name":91,"color":92,"percentage":93},"Nix","#7e7eff",7.9,{"name":95,"color":96,"percentage":97},"JavaScript","#f1e05a",5.2,{"name":99,"color":100,"percentage":101},"Shell","#89e051",0.4,{"name":103,"color":104,"percentage":105},"CSS","#663399",0.2,{"name":107,"color":108,"percentage":109},"HTML","#e34c26",0,5279,279,"2026-04-02T23:40:29","MIT",1,"Linux, macOS, Windows","未说明",{"notes":118,"python":116,"dependencies":119},"该工具是一个基于 Node.js\u002FBun 的命令行工具，不依赖 Python 或 GPU。需要安装 Git 以管理仓库。支持通过 npm、bun、brew 或 nix 安装。主要功能依赖于本地 Markdown 文件和 Git 版本控制。",[120,121,122],"Node.js (npm)","Bun","Git",[15],[125,126,127,128,129,130,131],"agent","agentic-ai","management","markdown","project","task-manager","tasks","2026-03-27T02:49:30.150509","2026-04-06T11:29:25.632731",[135,140,145,150,155,160],{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},11178,"如何在 Backlog.md 中设置自定义目录或管理多个待办事项列表？","你可以在执行 `backlog init` 时指定仓库内的任意自定义文件夹。如果需要指向当前仓库之外的待办事项文件夹，请使用 CWD（当前工作目录）覆盖功能。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F334",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},11179,"在大型仓库中运行 `backlog board` 时加载速度非常慢，如何优化？","这是一个已知问题，已在 v1.7.3 版本中修复。之前存在一个 bug，导致 `checkActiveBranches` 配置项被忽略。升级后，该配置将正确生效，从而避免不必要的分支检查，提升加载速度。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F183",{"id":146,"question_zh":147,"answer_zh":148,"source_url":149},11180,"在 macOS 上使用 `backlog board` 打开编辑器（如 vim\u002Fnano）时，方向键无法正常工作怎么办？","这个问题通常是由于 TUI（文本用户界面）在将键盘输入传递给编辑器子进程之前拦截了输入导致的。确保你使用的是包含 stdio 继承修复的版本（如 TASK-318 相关更新）。如果问题依旧，请检查终端环境变量 TERM 设置，或尝试在原生终端而非 IDE 集成终端中运行。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F457",{"id":151,"question_zh":152,"answer_zh":153,"source_url":154},11181,"为什么下载的预构建二进制文件（如 backlog-bun-linux-x64）运行时显示的是 Bun CLI 的帮助信息而不是 Backlog？","这通常与环境变量或二进制文件配置有关。Bun 的独立可执行文件如果检测到 `BUN_BE_BUN=1` 环境变量，会暴露 Bun 的 CLI 功能。请确保未设置该环境变量。如果问题持续，建议在 Linux 上通过 Homebrew 安装，或者使用 Node.js 版本而不是 Bun 预构建版本，许多用户反馈通过包管理器安装可以完美解决此问题。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F297",{"id":156,"question_zh":157,"answer_zh":158,"source_url":159},11182,"在 Windows 或旧款 CPU 上运行 Backlog.md 时出现 \"Illegal instruction\"（非法指令）错误如何解决？","这通常是因为预构建的二进制文件使用了较新的 CPU 指令集，而你的处理器（如 Intel 第三代 Core i7-3770）不支持。解决方案是使用兼容性好一点的运行时环境。例如，在使用 Nix 包管理器时，可以通过 overlay 将 Bun 版本调整为更稳定的版本或使用 baseline 构建。对于普通用户，建议尝试通过 Node.js 运行或等待官方提供兼容性更好的构建版本。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F412",{"id":161,"question_zh":162,"answer_zh":163,"source_url":164},11183,"如何让 AI 工具（如 Claude）更好地与 Backlog.md 交互，特别是在需要多个输入参数时？","项目正在开发用于与 Backlog 交互的 MCP（Model Context Protocol）服务器。这将使 Claude Code、Codex 和 Gemini CLI 等工具能够通过 stdio 传输更轻松地处理需要多个参数的操作（如清理 backlog 时需设置最小票证年龄）。你可以关注相关的 PR 或参与 Beta 测试来获取此功能。","https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fissues\u002F288",[166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261],{"id":167,"version":168,"summary_zh":169,"released_at":170},61627,"v1.44.0","## 变更内容\n* BACK-408 - 由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F572 中合并 MCP 工作流指南工具\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.43.0...v1.44.0","2026-03-21T14:25:13",{"id":172,"version":173,"summary_zh":174,"released_at":175},61628,"v1.43.0","## 变更内容\n* BACK-404 - 通过 @apetersson 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F565 中实现，强化任务 ID 锁定机制，以应对并发的创建、晋升和降级操作。\n  * BACK-404.1 - 将任务创建流程收敛到单一的标准核心管道中，由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F568 中完成。\n* BACK-405 - 恢复发布工作流中的 package.json 版本同步功能，由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F569 中实现。\n* BACK-406 - 当当前工作目录无法确定项目根目录时，改用 MCP 根目录进行发现，由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F570 中完成。\n* BACK-407 - 使 MCP 服务器与最新规范保持一致（注解、日志记录、错误码、根目录通知等），由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F571 中实现。\n\n## 新贡献者\n* @apetersson 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F565 中完成了首次贡献。\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.42.0...v1.43.0","2026-03-21T13:51:08",{"id":177,"version":178,"summary_zh":179,"released_at":180},61629,"v1.42.0","## 变更内容\n* BACK-403 - 在 MCP 任务工具中暴露并尊重任务序号，由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F564 中实现\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.41.0...v1.42.0","2026-03-15T14:05:39",{"id":182,"version":183,"summary_zh":184,"released_at":185},61630,"v1.41.0","## 变更内容\n* BACK-402 - 由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F563 中实现，支持项目本地的自定义待办目录\n  * 现在，您可以将 Backlog.md 文件夹初始化为 `backlog`、`.backlog` 或项目内的任何其他相对路径。\n  注意：由于通过 Git 同步任务的功能限制，目前尚不支持仓库外部的路径。\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.40.0...v1.41.0","2026-03-15T11:56:12",{"id":187,"version":188,"summary_zh":189,"released_at":190},61631,"v1.40.0","## 变更内容\n* BACK-398 - 由 @maeste 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F549 中为 TUI 看板添加里程碑筛选器\n* BACK-399 - 由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F553 中重构 TUI 筛选器，以实现任务列表和看板之间的用户体验一致性\n* BACK-400 - 由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F552 中为任务列表（CLI 和 MCP）添加里程碑筛选器支持\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.39.2...v1.40.0","2026-03-02T19:39:49",{"id":192,"version":193,"summary_zh":194,"released_at":195},61632,"v1.39.2","## 变更内容\n* BACK-397 - 修复目标列较短时跨列拖放的问题，由 @paoloantinori 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F544 中完成\n\n## 新贡献者\n* @paoloantinori 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F544 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.39.1...v1.39.2","2026-02-22T17:24:56",{"id":197,"version":198,"summary_zh":199,"released_at":200},61633,"v1.39.1","## 变更内容\n* BACK-396 - 由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F545 中永久修复已发布 TUI 编辑器交接回归问题\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.39.0...v1.39.1","2026-02-22T15:05:22",{"id":202,"version":203,"summary_zh":204,"released_at":205},61634,"v1.39.0","## 变更内容\n* BACK-392 - CLI 高级配置：交互式“完成定义”默认值编辑器，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F537 中实现\n* BACK-386 - 在里程碑页面中使用 Fuse.js 添加快速里程碑搜索功能，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F538 中实现\n* BACK-393 - CLI 任务创建\u002F编辑：统一的 Clack 向导，并支持编辑时预填充，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F539 中实现\n* BACK-387 - 在里程碑页面上隐藏“未分配”组中的已完成任务，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F540 中实现\n* BACK-348 - 重新设计“所有任务”页面，采用表格布局，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F541 中实现\n* BACK-394 - MCP：明确“完成定义”的语义，并添加“完成定义”默认值管理工具，由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F542 中实现\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.38.1...v1.39.0","2026-02-21T22:39:09",{"id":207,"version":208,"summary_zh":209,"released_at":210},61635,"v1.38.1","## 变更内容\n* BACK-389 - 修复 TUI 编辑器交接回归问题，该问题与 #457 提议相关，并通过确定性交互式测试实现，由 @MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F533 中完成。\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.38.0...v1.38.1","2026-02-21T15:33:20",{"id":212,"version":213,"summary_zh":214,"released_at":215},61636,"v1.38.0","## 变更内容\n* BACK-391 - 由 MrLesk 在 https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F536 中添加了对 MCP 启动和 CLI 根路径解析的当前工作目录覆盖支持\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.37.0...v1.38.0","2026-02-20T23:21:20",{"id":217,"version":218,"summary_zh":219,"released_at":220},61637,"v1.37.0","## What's Changed\r\n* BACK-366 - Replace prompts library with clack in CLI wizards by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F535\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.36.0...v1.37.0","2026-02-20T22:50:32",{"id":222,"version":223,"summary_zh":224,"released_at":225},61638,"v1.36.0","## What's Changed\r\n* BACK-383 - Restructure README into MCP and CLI usage paths by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F520\r\n* BACK-384 - Fix milestone rename to use milestone files as single source of truth by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F527\r\n* BACK-385 - Release: harden npm propagation gates for platform binaries and install-sanity by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F532\r\n* BACK-390 - Add Kiro support in initialization flow and documentation by @mreferre in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F528\r\n\r\n## New Contributors\r\n* @mreferre made their first contribution in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F528\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.7...v1.36.0","2026-02-17T22:00:36",{"id":227,"version":228,"summary_zh":229,"released_at":230},61639,"v1.35.7","## What's Changed\r\n* BACK-380 - Fix MCP milestone persistence to use milestone IDs by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F518\r\n* BACK-381 - Fix frontmatter parsing corruption when titles contain dollar-sign sequences by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F517\r\n* BACK-382 - Sanitize dependencies and references when archiving tasks by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F519\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.6...v1.35.7","2026-02-11T21:38:39",{"id":232,"version":233,"summary_zh":234,"released_at":235},61640,"v1.35.6","## What's Changed\r\n* BACK-379 - Auto-plain output when stdout is not a TTY by @eisbaw in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F501\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.5...v1.35.6","2026-02-09T20:00:46",{"id":237,"version":238,"summary_zh":239,"released_at":240},61641,"v1.35.5","## What's Changed\r\n* BACK-378 - Fix timezone docs and task modal local date display by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F513\r\n* BACK-377 - Fix blank-page crash for angle-bracket markdown in web preview by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F512\r\n* BACK-376 - Fix milestone loss when creating tasks from web UI by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F511\r\n* BACK-375 - Fix inconsistent draft IDs for task create --draft by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F510\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.4...v1.35.5","2026-02-09T18:10:32",{"id":242,"version":243,"summary_zh":244,"released_at":245},61642,"v1.35.4","## What's Changed\r\n* BACK-374 - Ensure MCP server exits when stdio closes and disposes watchers by @zheruiqiu in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F500\r\n\r\n## New Contributors\r\n* @zheruiqiu made their first contribution in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F500\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.3...v1.35.4","2026-01-23T19:39:22",{"id":247,"version":248,"summary_zh":249,"released_at":250},61643,"v1.35.3","## What's Changed\r\n* BACK-373 - Support Drafts via MCP task tools by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F498\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.2...v1.35.3","2026-01-22T21:50:04",{"id":252,"version":253,"summary_zh":254,"released_at":255},61644,"v1.35.2","## What's Changed\r\n* BACK-370 - Publish platform binaries before main npm package by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F494\r\n* BACK-372 - Drop sourcemap in CI smoke-test build by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F496\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.1...v1.35.2","2026-01-21T21:38:53",{"id":257,"version":258,"summary_zh":259,"released_at":260},61645,"v1.35.1","## What's Changed\r\n* BACK-369 - Fix web UI acceptance criteria toggle flicker via ContentStore sync by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F493\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.35.0...v1.35.1","2026-01-21T19:27:57",{"id":262,"version":263,"summary_zh":264,"released_at":265},61646,"v1.35.0","## What's Changed\r\n* BACK-367 - Add Final Summary field for task completion notes by @MrLesk in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F491\r\n* feat: enable symlink traversal in file scanning by @mishkaechoes in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F490\r\n\r\n## New Contributors\r\n* @mishkaechoes made their first contribution in https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fpull\u002F490\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FMrLesk\u002FBacklog.md\u002Fcompare\u002Fv1.34.0...v1.35.0","2026-01-19T21:39:47"]