Claude代码健康检查工具

MemoryOS

Your Claude Code setup has 45 things that could be better. This finds them in 2 seconds.

Open-source context engineering scanner for Claude Code

在45个检查层和3个维度上对您的克劳德代码设置进行评分。返回具有上下文工程模式映射的自适应报告、具有时间估计的优先级修复和HTML仪表板。免费工具在本地运行，无需网络调用。付费工具解锁了进度跟踪、上下文分析、对话导入和AI驱动的升级。

安装

一个命令设置

npx @iwo-szapar/second-brain-health-check setup

互动式入职培训（约2分钟）：

1. 询问您的API密钥（或跳过免费层）
2. 用Claude代码配置MCP服务器
3. 询问你的角色、经验和目标
4. 运行第一次健康检查并打开仪表板

手动MCP设置

claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check

然后问克劳德：“对我的项目进行健康检查。”

工具

免费工具

不需要API密钥。在本地运行，无网络呼叫。

check_health

完整的45层扫描，涵盖设置质量、使用活动和AI流畅性。根据你大脑的成熟度调整报告。

> Run a health check

> Check my setup health in quick mode

> Run health check in Spanish

参数：

get_fix_suggestions

针对你最薄弱的领域制定优先行动计划。每个修复都包括时间估计和点值。

> What should I fix first in my setup?

> Give me fix suggestions focused on setup quality

参数：

generate_dashboard

具有分数可视化、CE雷达图和引导修复的独立HTML仪表板。在浏览器中打开。

> Generate a health check dashboard

> Generate dashboard and save to ~/reports/brain.html

参数：

generate_pdf

通过无头Chrome浏览器生成PDF报告。需要安装Chrome或Chromium。

> Generate a PDF health check report

参数：

付费工具

需要API密钥。集 SBF_TOKEN 在您的环境中或跑步 setup 配置。

weekly_pulse

随着时间的推移跟踪进度。显示分数增量、CE模式趋势、条纹检测和有针对性的建议。

> Show my weekly pulse

> Show my progress over the last 30 days

参数：

context_pressure

分析固定开销（CLAUDE.md、MEMORY.md、知识文件、MCP定义、技能、钩子和设置）消耗了20万令牌上下文窗口的多少。

> Check my context pressure

> How much of my context window am I using?

参数：

audit_config

审核您的配置，查看是否存在死引用、冲突、安全问题、未使用项和性能问题。

> Audit my config

> Run a security audit on my setup

参数：

每个类别检查的内容：

• 参考文献 --CLAUDE.md中的死文件路径，缺少挂钩脚本
• 冲突 --重复的CLAUDE.md文件、重叠的MCP服务器、不匹配的挂钩
• 安全 -- .env 在 .gitignore，配置文件中的API密钥模式，通配符权限
• 未使用的 --会话日志中零调用的技能
• 演出 --CLAUDE.md过大（>300行），MEMORY.md（>180行），MCP工具过多（>30）

import_context

从ChatGPT导入对话历史记录，或将Claude导出到有组织的内存文件中。先扫描以预览，然后导入以创建文件。

> Scan my ChatGPT export at ~/Downloads/conversations.json

> Import my ChatGPT conversations, only coding-related ones from 2025

参数：

upgrade_brain

识别设置中丢失和过时的文件，并生成个性化升级。在本地运行运行运行状况检查和清点，然后调用Factory API进行模板匹配和个性化设置。需要 UPGRADE_BRAIN_API_KEY.

> Upgrade my brain

> Show me what files I'm missing (dry run)

> Upgrade brain, high impact only

参数：

命令行界面

# First-time setup (interactive)
npx @iwo-szapar/second-brain-health-check setup

# Run health check (prints report + opens dashboard)
npx @iwo-szapar/second-brain-health-check

# Scan a specific directory
npx @iwo-szapar/second-brain-health-check /path/to/project

# Text report only (no browser)
npx @iwo-szapar/second-brain-health-check --no-open

# Generate PDF report
npx @iwo-szapar/second-brain-health-check --pdf

它衡量什么

三维。45个检查层。~459个原始点，每个标准化为/100。

SETUP QUALITY      32 layers    ~284 pts
A (85%+) | B (70%+) | C (50%+) | D (30%+) | F (<30%)

USAGE ACTIVITY      7 layers    ~125 pts
Active (85%+) | Growing (70%+) | Starting (50%+) | Dormant (30%+) | Empty (<30%)

AI FLUENCY          6 layers     ~60 pts
Expert (85%+) | Proficient (70%+) | Developing (50%+) | Beginner (30%+) | Novice (<30%)

自适应报告

报告根据大脑成熟度而变化：

上下文工程模式

所有45层映射到7个CE图案：

HTML仪表板

安全和隐私

• 完全在本地运行——免费层无网络调用
• 免费层零遥测
• 仅读取文件结构和配置元数据——从不读取代码、电子邮件或文档
• 仅显示“找到/未找到”的秘密检测报告——从不显示实际键值
• 主目录边界--无法扫描外部 $HOME
• 通过Zod进行路径验证（无空字节，长度限制）
• 文件计数限制：每次目录扫描5000个
• 递归深度：最多3-4级
• HTML输出中转义的所有用户内容
• 仅限stdio传输

付费工具： weekly_pulse, context_pressure, audit_config，以及 import_context 进行零网络调用（它们只读取本地文件）。 upgrade_brain 将匿名分数和文件清单发送到工厂API进行模板匹配——不发送文件内容。

免费vs付费

获取访问权限： iwoszapar.com/memory-os

文档

什么是上下文工程？

快速工程优化了单个LLM呼叫。 上下文工程优化了围绕这些调用的持久系统-- 塑造每个会话的文件、钩子、记忆和技能。

您的CLAUDE.md， .claude/ 目录、技能、钩子、内存文件、MCP服务器和规划工件形成了一个持久的上下文层。MemoryOS对该层进行评分，而不是对提示进行评分。

故障排除

从以下位置迁移 @iwo-szapar/memoryos

旧包裹 @iwo-szapar/memoryos 已弃用。如果你看到 Memoryos [tool_name] （大写M）在您的工具输出中，您使用的是旧软件包。

克劳德代码CLI：

claude mcp remove memoryos
claude mcp remove second-brain-health-check
npm cache clean --force
claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check@latest

克劳德桌面/协作：

上面的CLI命令仅修改Claude Code配置(.claude.json).Claude Desktop将MCP配置存储在单独的文件中：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

打开那个文件，找到旧的 "memoryos" 进入下 "mcpServers"，并替换为：

"second-brain-health-check": {
  "command": "npx",
  "args": ["@iwo-szapar/second-brain-health-check@latest"],
  "env": {
    "SBK_TOKEN": "your_sbk_token_here"
  }
}

然后重新启动应用程序。

发布流程

发布使用GitHub Actions中的npm可信发布。中的工作流 .github/workflows/publish.yml 在GitHub发布时运行，然后执行：

npm ci
npm test
npm install -g npm@latest
npm publish --access public

工作流程故意不使用 NPM_TOKENnpm通过GitHub Actions OIDC对发布进行身份验证，因此包必须在npm上配置此受信任的发布者：

在发布发布之前：

1. 更新 package.json 和 CHANGELOG.md.
2. 在Ubuntu和Windows上打开发布PR并等待CI。
3. 合并PR。
4. 例如，为匹配的标签创建GitHub版本 v0.18.7.
5. 验证npm latest 发布工作流完成后：

npm view @iwo-szapar/second-brain-health-check version dist-tags --json

如果发布失败 ENEEDAUTH，检查npm可信发布者字段是否与表完全匹配，以及 package.json repository.url 指向 git+https://github.com/iwo-szapar/second-brain-health-check.git.

Windows：路径错误

如果你看到 Path "c:\Users\..." is outside the home directory，驱动器号大小写不匹配。已在v0.17.2+版本中修复。更新为：

npm cache clean --force

然后重新运行该工具。服务器在下次调用时获取最新版本。

固定 npx 缓存

如果更新后修复未生效，则npx可能正在提供缓存的旧版本。标志：错误消息参考 UPGRADE_BRAIN_API_KEY （在v0.17.2中删除），或工具输出缺少 [MemoryOS vX.Y.Z] 版本前缀。

npm cache clean --force
npx clear-npx-cache

如何检查您的版本

每个工具响应都始于 [MemoryOS v0.17.4] （或您安装的版本）。如果您没有看到此前缀，则表示您使用的是v0.17.3或更旧版本。

记忆 通过 伊沃 沙帕尔.MIT许可证。