MisakaNet

Name: Ikalus1988/MisakaNet
Author: Ikalus1988

Ikalus1988/MisakaNet

失败恢复记忆库：从真实工程会话中搜索和记录失败恢复教训，支持 BM25 + 语义 RAG 检索和知识库管理。

391156PythonApache-2.0源码

安装

把 MisakaNet 装进 DeepSeek Harness

GitHub 方式 · GitHub 源码

从 GitHub 装会执行项目自己的构建脚本，而 pnpm 默认拦着不让跑——先跑一次这条命令，pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

安装前须知

装 MisakaNet 之前，先看这几条

源码在这里： Ikalus1988/MisakaNet——已进入社区精选库，DSH 自带的插件市场就是从这儿装的。
开源协议：Apache-2.0。
自动识别到：终端执行。授权之前请先读一遍源码。
被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

MisakaNet 是做什么的

Error fragments pass through keyword and semantic filters into ordered recovery lessons.

MisakaNet 是一个 DeepSeek Harness 插件，用于给 agent 提供失败恢复知识。它不保存通用记忆，而是把真实工程会话中的报错、处理步骤和修复结果整理成可检索的 lessons，帮助 agent 在遇到相似问题时先查已有经验。

本地模式以 Git-backed 仓库保存知识条目，不需要独立 server、database 或额外依赖。agent 可以通过 python3 search_knowledge.py "your error here" 搜索，也可以运行 python3 scripts/misakanet_cli.py smoke 做检查；MCP 服务由 python3 scripts/mcp_server.py 启动，DeepSeek Harness 适配器由 python3 scripts/mcp_deepseek_adapter.py 启动，并提供 deepseek.recovery.* tools。README 提到当前包含 289 条 lessons，覆盖 pip、GitHub API 401、DCO、MCP、编码和 CI 等失败类型。没有匹配项时，可选择提交经过脱敏的 failure report；项目声明不会泄露 prompt，也不保存 raw logs。

它适合经常处理构建、依赖、认证或 CI 故障，并希望共享版本化修复经验的 agent。不适合拿来替代通用记忆系统、agent runtime 或 vector database。插件会通过终端运行 Python 脚本，因此 server、适配器和搜索命令都继承 agent 运行环境的权限；若不希望插件接触终端，或只需要一般知识记忆，就不应安装 MisakaNet。

MisakaNet 的文档

行为说明

MisakaNet 的流程是搜索 failure、阅读匹配的 lesson、执行其中记录的修复。没有匹配项时，agent 可选择提交脱敏的 failure report；被接受的报告会经审核后转成 draft lesson。项目声明不会泄露 prompt，也不保存 raw logs。README 所述版本包含 289 条 lessons。

命令

用途	命令或地址
运行检查	`python3 scripts/misakanet_cli.py smoke`
搜索知识	`python3 search_knowledge.py "your error here"`
启动本地 MCP	`python3 scripts/mcp_server.py`
启动 DSH 适配器	`python3 scripts/mcp_deepseek_adapter.py`
Remote MCP	`https://misakanet.org/mcp`

适配器兼容 MCP，并暴露 deepseek.recovery.* tools。本地 server 需要加入 agent 的 MCP 配置；README 没有规定适用于所有客户端的统一配置格式。

环境要求

README 标注 Python 3.10+。本地用法是先取得源码仓库，再直接运行 Python 脚本；该模式声明不需要额外依赖、独立 server 或 database。文档还提到 Docker 和 Remote MCP，但给定内容没有完整设置步骤。

已知限制

MisakaNet 专注于 failure-recovery knowledge，不是通用 memory system、agent runtime、vector database 或 skill marketplace。本地搜索使用 BM25 keyword search。启动脚本需要终端权限，并继承 agent 运行环境的权限。给定 README 没有说明配置 key 或默认值。

根据项目自己的文档整理，会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类