本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

MisakaNet

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Ikalus1988/MisakaNet

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Cursor / Claude Code / Codex 遇到你没见过的错误
• CI 失败但不知道原因
• DCO、token、pip、MCP、编码问题在多个项目中重复出现
• 🌐 在线搜索
• ⭐ GitHub 仓库

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

MisakaNet 是用来做什么的？

帮 AI 编码 Agent 在撞到已知错误时快速找到修复方案。它把 290+ 条来自真实调试会话的 markdown 教训（lessons）放进仓库，Agent 通过 BM25 关键词检索即可拿到"问题-根因-修复-验证"四段式答案。本质是失败经验的共享记忆库，不是记忆数据库或向量数据库。

它和 DSH 的官方 AI 能力是什么关系？

它是 DSH 之上的一个独立恢复层插件，不接管模型对话和会话管理。DSH 把 mcp__misakanet__* 当成普通 MCP 工具调用，由这个插件去搜本地 lessons 库返回修复路径，等于在 Agent 调工具链之外补一层"避坑记忆"。

安装后需要额外启动什么服务吗？

不需要。该插件通过 DSH 的 Cordis patch 自动把 misakanet MCP 客户端注册到 web profile，启动后直接以 stdio 进程形式跑 python3 scripts/mcp_deepseek_adapter.py，所有数据都在本地 lessons 仓库里，无需额外服务。

必须要装 Python 才能用吗？

是。核心依赖 Python 3.10 及以上，因为适配层是 stdio 上的 MCP Python 进程，会加载仓库内的 markdown lessons 并用 BM25 关键词索引。Git 也是必需的，lessons 是仓库里的文件，跟 Git 版本控制绑定。

需要 GitHub 账号或 Bearer Token 吗？

本地使用不需要。DSH 跑这个插件时走本地 stdio MCP，不需要 GitHub 凭证。如果是直接连远端 https://misakanet.org/mcp 才需要在 misakanet.org/connect 页面生成 6 位配对码换 Bearer Token。

lessons 数据存在哪里？能改吗？

全部以 markdown 文件存在插件仓库的 lessons/ 目录（290+ 条），由 Git 版本控制。每次贡献需要走 DCO 签名的 PR；如果你不想走 PR，也可以用 misakanet_submit_intake 工具提交一个脱敏后的失败报告。

报"搜索无结果"怎么办？

三步排查：先 git pull --ff-only 确保 lessons 拉到最新，再 python3 -m pip install misakanet-core 装上核心包，最后用更具体的报错短语重新搜。底层是 BM25 关键词匹配，措辞差异过大会漏检，可以加 --broad 放宽。

提交反馈（submit_feedback）实际做了什么？

当前版本只是在本地记录一条"哪个 lesson 被用到、结果如何（solved/partial/not-helpful）"的日志（源码里有 TODO: POST to /api/usage or create GitHub Issue），并不会立刻同步到云端，等后续接入对外接口。

怎么卸载？

dsh plugin --profile web remove Ikalus1988/MisakaNet 即可移除 profile 依赖和 Cordis bundle 注入；本地 lessons 仓库是 Git 克隆下来的独立目录，卸载不会自动删除。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则