在 Claude Code 里用 Dosi 插件¶
Claude Code 能用上插件的全部功能:dosi 的 MCP 工具、各个 skill、钩子,还有它独有的
界面(状态栏、/dosi 和血缘面板)。插件在所有 Agent 里都能做什么,见
Dosi 插件。
安装¶
在 Claude Code 提示符里输入:
然后运行 /reload-plugins,或者开一个新会话。Claude Code 2.1.275 及以上版本可以
一行完成:/plugin install dosi --marketplace Datus-ai/dosi-plugins。在 shell 里:
确认装好了¶
打开一个项目目录,开一个会话。第一次会话会在后台下载 dosi,等十秒左右,然后:
/mcp里能看到plugin:dosi:dosi已连接。服务随会话启动,并且跟着dosi/model.yaml走:模型还没建时它也能启动,模型写出来后自动加载。/dosi显示当前连接、模型及其是否通过校验,以及下一步做什么。
然后直接问数据问题。Claude 会通过 dosi 的工具回答,dosi 自己的调用不弹权限确认。
只有 Claude Code 才有的¶
这些都不改变 Claude 读到的内容,没有它们每一步照样能完成。
- 状态栏:项目的实时状态,比如
dosi · duckdb:local · 3 ds · 8 metrics · ontology 3。 /dosi:当前连接、模型,数据集、指标、维度各有多少,ontology,以及下一步。/dosi metrics列出每个指标和它的说明。/dosi lineage [指标]:打开一个面板,画出指标是由什么算出来的,或者有哪些 东西依赖某张表。按h还会写出一份 HTML 页面。- 结果表格:dosi 的结果显示成表格,下面注明来源和行数,点一下就能看 SQL。 命令失败时显示错误、原因和下一步该做什么。
- 功能建议:问过几个问题后,插件会提议看血缘,之后再提议构建 ontology,各提一次。
更新和卸载¶
重启 Claude Code 后加载新版本。dosi 本身单独升级:在对话里说“升级 dosi”。
卸载插件:/plugin uninstall dosi@dosi-plugins,它下载的 dosi 也会一起删除。
排错¶
| 现象 | 解决办法 |
|---|---|
Plugin "dosi" not found in any marketplace |
Claude Code 版本低于 2.1.275,用两行的安装方式 |
/mcp 里 plugin:dosi:dosi 显示失败 |
会话启动时第一次下载还没完成。在 /mcp 里重连,或者开新会话 |
Claude 在 shell 里跑 dosi,没用工具 |
装的是不带 MCP 服务的旧版插件,按上面的方法更新 |