DeepSeek-Reasonix 插件 Manifest 完全指南技能、钩子、MCP 与主题声明一文读懂【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-ReasonixDeepSeek-Reasonix 是一款 DeepSeek 原生的终端 AI 编程智能体AI coding agent而它的插件包Plugin Package通过一份 Manifest 清单文件把技能Skills、钩子Hooks、MCP 服务器与主题Themes打包成一个可安装单元。本文带你完整读懂reasonix-plugin.json的每一项声明从零上手为自己的插件或扩展写出规范的 Manifest。先 clone 项目源码来熟悉结构git clone https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix一、什么是插件 Manifest为什么重要Manifest 是插件包的身份证 能力声明表。安装插件时Reasonix 会读取它并回答三个问题这个插件叫什么、什么版本name/version/description它贡献了什么能力skills、hooks、mcpServers、prompts、themes它需要什么、提供什么v2 的requires/provides/runtime解析逻辑集中在internal/pluginpkg/目录入口是 pluginpkg.go 中的ParseDirv2 版本的严格解析在 manifest_v2.go。官方使用文档见docs/PLUGIN_PACKAGES.md。Reasonix 支持三种 Manifest按优先级探测文件位置类型说明reasonix-plugin.json原生Reasonix 专属能力最完整.codex-plugin/plugin.jsonCodex 兼容自动映射技能与命令.claude-plugin/plugin.jsonClaude 兼容自动映射技能、命令、代理、钩子、MCP二、最小可用的原生 Manifest一个最小原生插件长这样相对路径都相对于插件根目录{ name: example, version: 1.0.0, description: Example plugin, skills: skills, hooks: { SessionStart: [ { command: hooks/session-start, args: [], description: 加载启动上下文 } ] }, mcpServers: { helper: { command: bin/helper } } }注意几个新手容易踩的坑name必须合规字母、数字开头仅含字母数字、.、_、-最长 64 字符。路径必须是相对路径且不能逃出插件根目录绝对路径、../穿越都会被直接拒绝。Reasonix 不会执行第三方安装脚本安全性由解析层兜底。三、技能Skills声明让智能体多会一样本事skills字段声明技能根目录支持三种写法{ skills: skills } { skills: [skills, tools/skills] } { skills: [{ path: skills }] }安装后技能会出现在/skills列表中用/插件名:技能名调用例如/superpowers:writing-plans也可以自然语言提问让智能体按描述自动匹配技能。Claude 风格插件未显式声明时会自动探测skills/与.claude/skills/目录与 Claude Code 的自动发现行为保持一致。四、钩子Hooks声明在生命周期事件上自动执行hooks以事件名 → 钩子列表的映射形式声明。常用事件包括SessionStart、UserPromptSubmit、PreToolUse、PostToolUse。每个钩子支持这些字段字段作用command要执行的命令相对插件根目录args参数数组有无args字段决定执行模式shell指定解释器auto/bash/powershell/cmdmatch匹配条件如工具名cwd/env工作目录与环境变量async/timeout异步执行与超时contextFile纯上下文文件不走 shell直接读入关键规则——exec 形式 vs shell 形式声明了args哪怕args: []→exec 形式command即可执行文件参数原样传递不经过 shell最安全。未声明args但有shell→shell 形式整条command原样交给 bash / PowerShell / cmd 解释支持等复合命令。hooks: { SessionStart: [ { command: hooks/audit, args: [], description: exec 形式 }, { command: printf ready ./hooks/audit, shell: bash, description: shell 形式 } ] }钩子运行时可读取REASONIX_PLUGIN_ROOT、REASONIX_PLUGIN_NAME、REASONIX_HOME、REASONIX_WORKSPACE_ROOT等环境变量定位插件内部文件。五、MCP 服务器声明给智能体接入外部工具mcpServers声明插件自带的 MCPModel Context Protocol服务器安装启用后自动并入正常的 MCP/工具流智能体在相关任务中会自动调用mcpServers: { helper: { command: bin/helper, args: [--stdio], display_name: Helper Server, description: 提供示例工具 } }常用字段type、command/args/envstdio 本地进程、url/headers远程服务、auto_start是否随会话自动启动兼容导入的服务器默认false按需连接。服务器名同样受插件名规范约束。六、主题Themes声明一个字段换一整套界面皮肤v2 Manifest 中contributes.themes声明*.reasonix-theme主题文件支持通配符contributes: { themes: [themes/*.reasonix-theme] }主题在桌面端设置 → 主题中只读展示ID 形如plugin:插件名:主题名不会被复制进用户主题库避免污染。校验很严格路径必须是普通文件、不能通过符号链接逃出插件根目录通配符按路径段展开不跨目录。插件被禁用或卸载时桌面端回落到基础样式但保留主题 ID——重装同一插件主题原样恢复。七、进阶v2 的 requires / provides / runtime原生插件若要声明为代码型扩展ExtensionManifest 必须使用精确的版本号写错一个字符都会直接报错apiVersion: reasonix.io/plugin/v2v2 是严格解析任何未知字段包括contributes/runtime内部都会触发带字段路径的错误提示——拼错字段名不会静默失效而是响亮地失败这对新手排查拼写错误非常友好。三个进阶块provides声明本插件提供的能力命名空间 种类 ID 版本重复的能力键会被拒绝。requires声明依赖其他插件/平台的能力支持版本区间versionRange与optional: true可选依赖。runtime声明一个由 Reasonix 启动的 sidecar 进程通过扩展协议JSON-RPC 2.0 over stdio通信。runtime: { command: ${REASONIX_PLUGIN_ROOT}/bin/example, args: [], required: true, intercepts: [input.receive, tool.before], capabilities: [interceptors] }command支持${REASONIX_PLUGIN_ROOT}前缀在启动时展开为插件根目录。intercepts可从 17 个拦截点中选择session.start、provider.request、tool.after、permission.decision等。replaces声明可独占的替换槽位system_prompt、context、compaction等每个槽位全局只有一个拥有者冲突会导致构建失败并指明双方来源。⚠️完全信任警告带runtime的插件在沙箱之外运行可读取完整会话与环境、绕过权限检查。安装预览、reasonix plugin show与桌面安装器都会展示醒目的FULL TRUST区块——安装前务必核对只安装你完全信任的扩展。八、新手排错清单doctor 与能力诊断Manifest 写错了怎么办不要猜直接跑诊断# 检查某个插件的 Manifest 与技能根目录可读性 reasonix plugin doctor superpowers # 工作区级能力总览技能/钩子/MCP 合并情况、包根目录 reasonix doctor capabilities --json诊断会区分错误路径逃逸、未知字段、非普通文件的主题与警告声明的文件不存在、通配符未匹配到文件。另外桌面端 Settings → Diagnostics 与聊天中的/reasonix-guide命令提供同一套能力诊断。常见报错速查报错关键词原因解决unsupported apiVersionv2 版本号不精确必须写reasonix.io/plugin/v2must be relative and stay inside the plugin root路径越界改用插件内相对路径escapes the plugin root through a symlink符号链接逃逸把文件移入插件目录is not a regular file主题指向目录/设备主题必须指向*.reasonix-theme文件九、快速上手三步发布你的第一个插件建目录my-plugin/下放reasonix-plugin.jsonskills/hooks/等资源。先预览reasonix plugin install /path/to/my-plugin --dry-run验证解析通过。安装试用reasonix plugin install /path/to/my-plugin --link --replace --yes用--link链接模式开发改完即生效发布时去掉--link改为复制安装。插件状态持久化在~/.reasonix/plugin-packages.json插件内容位于~/.reasonix/plugins/name/。配合/plugins、/plugins show name命令即可在会话内随时核对插件导出的技能、钩子与 MCP 服务器清单。掌握这份 Manifest 声明规范后你就能把技能、钩子、MCP 与主题打包成即装即用的插件包把 DeepSeek-Reasonix 改造成完全贴合自己工作流的 AI 编程助手。【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
