nifdi 插件

nifdi 图表插件：@nifdi/mcp 图表服务器，附带了教授其使用的技能——深入模型、布局语法、配方案例，以及确保构建结果符合预期的迭代循环。

服务器是操作界面，技能是工艺本身。二者以统一整体安装。

安装

claude plugin marketplace add nifdi-app/nifdi-plugin

claude plugin install nifdi@nifdi-plugin

这会将此仓库注册为市场并安装插件：nifdi-diagram MCP 服务器（通过 npx -y @nifdi/mcp@<pinned> 启动）以及技能，任务调用时客户端会渐进加载这些技能。

在 Claude Code 下无需目录配置——它会自动注入项目根目录，图表将作为 .nifdi.svg 文件存放在您当前工作的仓库中。如果客户端不支持此功能，请将 NIFDI_ROOT 设置为所需的存放目录。

不包含教学层的独立服务器仍可按之前的方式安装：

claude mcp add nifdi-diagram -s project -- npx -y @nifdi/mcp@latest

内容说明

.claude-plugin/plugin.json       the plugin: pins the server version, ships the skills
.claude-plugin/marketplace.json  the single-plugin marketplace
skills/nifdi/                    the core skill: the model, placement, styling, connectors, workflow
test/                            contract CI — every fenced example, through the pinned server

核心技能的 SKILL.md 是一个索引，与服务器自身指令处于同一层级；详细内容位于 skills/nifdi/references/ 目录下，仅当客户端执行路径需要时才会加载。

独立服务器依然可用

技能属于可选上下文——原始 MCP 客户端永远不会看到它们。因此，智能体正确使用工具所需的任何信息都不会仅存在于技能中。此处存放的是无限层：模型深入解析、配方案例、风格判断和提供商约定。契约——每个工具的功能、接受和拒绝的内容——保留在服务器中，传递给所有客户端。

其推论更为重要：行为缺陷应在服务器中修复，绝不可在技能中掩盖。教导智能体绕过有缺陷工具的技能会向所有原始 MCP 客户端隐藏该缺陷。详见 CONTRIBUTING.md。

技能同样是契约

每个技能中的每个代码示例都会通过已发布的 @nifdi/mcp 在 CI 中执行——这与服务器对其自身引用示例应用的往返规则相同，只是从外部执行。如果某个配方的 XML 不再可解析，或声称的结果不再与工具报告一致，则构建失败。

技能固定了其测试所针对的服务器版本，清单将二者固定在一起，因此安装的是一个协调的配对。定期运行还会使用 @nifdi/mcp@latest 对技能进行测试，因此，使配方失效的服务器版本将会在此处被检测到，而不会在智能体绘制图表的过程中才发现。

npm install && npm test

要针对未发布到 npm 的服务器构建版本（本地签出、压缩包、候选版本）运行契约，请将 NIFDI_MCP_SPEC 指向该版本：

NIFDI_MCP_SPEC=../nifdi-app/mcp npm run test:examples

状态。 @nifdi/mcp@0.1.1（此仓库固定的版本）尚未发布到 npm。在发布之前，上述安装命令和固定的 CI 作业无法解析服务器，契约仅能通过 NIFDI_MCP_SPEC 运行。

贡献

提供商约定——好的 AWS、Azure 或 GCP 图表应具备什么样子，以及使用哪些 nifdi 词汇来实现——是主要的贡献领域：有价值、界限明确，且无需访问 nifdi 内部实现。CONTRIBUTING.md 中列出了标准以及如何在本地运行检查。

许可证

Apache-2.0。nifdi 应用程序本身是闭源的，此教学层是开源的。