克伦大学医学院
将Claude从无状态助手转变为持久智能层
问题
人工智能辅助开发存在三种灾难性的故障模式，导致数小时的工作损失：
8分钟死亡 -Claude Desktop在长时间操作期间崩溃（效率模式限制、内存限制），丢失了会话中建立的所有架构决策和上下文。你只能盯着空白的聊天，试图记住你讨论过的内容。
Bootstrap税 -每个新会话都需要5-10分钟手动恢复上下文：“我们正在处理X，决定Y是因为Z，接下来我们需要……”这种情况每天发生几十次。
孤立学习 -在一个项目中发现的解决方案仍然被困在那里。你在不同的代码库中三次解决同一个问题，因为没有传输机制。
解决方案
KERNL提供积极的会话状态管理，每2-3次工具调用自动检查点。当发生崩溃时（确实如此），恢复会恢复精确的状态——活动文件、架构决策、进度、下一步——损失几分钟而不是几小时。
核心能力：
- 故障恢复：自动检查点，一键恢复
- 语义搜索：按概念而非关键字查找所有项目的解决方案
- 跨项目学习：将一个代码库中学习到的模式转移到其他代码库中
- Chrome 自动化：19个基于浏览器的工作流工具
- 17个类别的101个工具：会话管理、文件操作、智能层、过程控制、git集成等
为什么存在
进展：
第1-2周： 在复杂的重构过程中撞到天花板——Claude Desktop会崩溃45分钟，失去所有的架构讨论。手动解决方法：疯狂地将粘贴决定复制到markdown文件中（总是忘记，无论如何都会丢失工作）。
第3-4周： 构建了基本的检查点保存/恢复。立刻撞车了——艰难地了解了比赛情况。添加了恢复检测，并进行了细致的提示工程，以实现自然的用户体验。
第5-8周： 意识到检查点是不够的——需要工作区管理、语义搜索、跨项目模式。系统地扩展到101个工具。
2026年1月14日： 在D:/驱动器重组过程中意外删除了整个代码库。零恐慌——与克劳德有完整的聊天记录，记录了每一个决定。
2026年1月14日（同日）： 仅在8小时内就从聊天历史中重建了所有101个工具。这是您正在查看的存储库。您正在阅读此README的事实证明了该系统是有效的。
安装
# Clone the repository
git clone https://github.com/duke-of-beans/KERNL.git
cd KERNL
# Install dependencies
npm install
# Build
npm run buildClaude桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"kernl": {
"command": "node",
"args": ["/path/to/KERNL/dist/index.js"],
"env": {
"PROJECT_MIND_DB_PATH": "/path/to/KERNL/data/project-mind.db"
}
}
}
}重新启动克劳德桌面。您将立即看到KERNL工具可用。
快速开始
// Start of EVERY session - mega-bootstrap with mode detection
KERNL:get_session_context({
project: "my-project",
mode: "auto" // coding | architecture | debugging | auto
})
// During work - aggressive checkpointing (every 2-3 tool calls)
KERNL:auto_checkpoint({
project: "my-project",
operation: "Implementing Z3 solver integration",
progress: 0.65,
currentStep: "Writing constraint translation layer",
decisions: ["Using Z3 Python API instead of SMT-LIB2", "Caching solver instances"],
nextSteps: ["Test constraint generation", "Add error handling", "Document API"],
activeFiles: ["src/solver/z3-wrapper.ts", "tests/solver.test.ts"]
})
// Task complete - clear checkpoint state
KERNL:mark_complete({
project: "my-project",
summary: "Z3 integration complete, 12 tests passing"
})发展历程
使用系统的AI原生开发方法，零传统编码背景构建。
主要学习内容
会话管理不仅仅是“保存状态” -它理解什么状态很重要（架构决策>文件更改）以及如何在不中断流的情况下捕获它。错误的检查点=比没有检查点更糟糕。
碰撞恢复设计 -在三次错误启动后：检测必须是非侵入性的（无声的背景检查），恢复提示必须感觉自然（不是“错误：恢复？”），检查点频率必须是积极的（每2-3次工具调用，而不是“方便时”）。
重建测试 -系统设计质量的最终验证是您是否可以仅从文档中重建它。KERNL通过了这项测试——在8小时内从聊天历史中重建了101个工具，因为每个决定都会在发生时被记录下来。
面临的挑战
检查站的比赛条件 -在工具执行期间尝试保存状态时，初始实现会崩溃。解决方案：使用基于队列的写入来分离检查点线程。
Bootstrap复杂性 -每次会话加载101个工具的上下文是昂贵的。解决方案：智能模式检测（编码vs架构vs调试）仅加载相关上下文。
语义搜索准确性 -概念查询的关键字匹配失败。解决方案：ONNX嵌入余弦相似性，用于基于意义的搜索。
建筑
MCP协议基金会 -将工具暴露给任何MCP客户端（Claude Desktop、自定义客户端）。工具接口和实现之间的清晰分离。
SQLite状态持久化 -所有会话状态、项目元数据和语义索引都在better-squarite3中，以实现事务安全和零配置部署。
ONNX嵌入 -用于语义搜索的本地转换器模型（全MiniLM-L6-v2）。没有API调用，即时结果，离线工作。
模块化工具类别 -17个类别（会话、项目、文件、智能、chrome、git、backlog、测试、实用程序、研究等），界限清晰，独立运作。
协议驱动的质量 -每个工具都有明确的输入验证、全面的错误处理和类型化接口。没有模拟、没有存根、没有占位符——生产质量代码或什么都没有。
工具类别（共101个）
- 会话管理 （5个工具）：检查点、恢复、状态管理
- 项目运营 （5个工具）：注册、列出、更新、删除项目
- 文件操作 （6个工具）：读、写、搜索、批处理操作
- 语义搜索 （3个工具）：基于概念的搜索、索引、模式
- 模式识别 （3个工具）：跨项目学习，提出解决方案
- 平行门 （1个工具）：五门验证（git/code/ui/backlog/patterns）
- 进程管理 （7个工具）：启动、监控、控制系统流程
- 流媒体搜索 （4个工具）：大规模文件/内容搜索
- 系统文件 （5个工具）：高级文件操作、元数据
- 配置和元数据 （4个工具）：版本、状态、配置管理
- Chrome 自动化 （19个工具）：浏览器控制、抓取、交互
- 影子文档 （4个工具）：并行文档系统
- Git工具 （2个工具）：智能提交、会话打包
- 待办事项 （5个工具）：EPIC管理、冲刺跟踪
- 测试 （4个工具）：测试生成、覆盖率、CI集成
- 公用事业 （12个工具）：辅助工具、格式化工具、转换器
- 研究 （10个工具）：论文索引、引文管理、分析
当前状态
生产 -在多个开发项目中积极日常使用。防止因崩溃和引导开销导致的上下文丢失，估计每周10-15小时。
从聊天记录重建 -2026年1月14日意外删除后，仅从Claude对话历史中重建了整个代码库（101个工具，17个类别，完整的测试覆盖率）。当天完成。
持续进化 -随着摩擦点的出现，添加了新的工具。目前的重点是：增强Chrome对工作申请工作流程的自动化。
文档
贡献
该项目展示了系统的人工智能原生开发方法：
- 质量门 -TypeScript严格模式，提交前零错误
- 无技术债务 -没有模拟、存根、占位符或没有票的TODO
- 文档同步 -每一个决定都会被记录下来
- 激进的检查站 -每2-3次工具调用，内置崩溃恢复功能
- 协议驱动 -显式接口，全面的错误处理
欢迎保持这些标准的拉取请求。
许可证
麻省理工学院-参见 许可证 详见
作者
______________________________________________________________________
哲学： 构建智能，而不是管道\ 现实检查： 如果你能在一天内从聊天记录中重建101个工具，那么你的记录是正确的。