使用说明
功能模块

Skill 与 MCP

安装和管理 Skill,添加自定义 MCP 服务器,扩展 AI 的能力边界。

Skill 给 AI 装上专项本领——公众号写作、数据分析、PPT 制作等成套工作流,装完即用;MCP 则让 AI 接入外部工具和数据源。两者一起,把通用 AI 变成懂你业务的专家。

Skill 市场:按分类浏览并一键安装技能

技能系统

技能(Skill)是NewMax的扩展能力系统,类似插件。每个技能赋予 AI 特定领域的专业能力。

什么是技能

技能是一组预定义的指令和工具配置,安装后 AI 可以使用该技能完成特定类型的任务。例如:

  • 公众号文章写作技能
  • 数据分析技能
  • PPT 制作技能
  • 视频创作技能

技能来源

技能按优先级从三个位置加载(同名技能高优先级覆盖低优先级):

  1. 项目级:当前工作区 .claude/skills/ 下的技能(最高优先级)
  2. 插件级:通过 Claude Code 插件安装的技能
  3. 用户级:手动安装或从市场下载的技能

通过 Claude Code 插件安装的 MCP 能力也会自动接入 NewMax。若插件自带浏览器自动化 MCP,NewMax 会优先停用该插件浏览器并改用内置「浏览器」能力,避免打开没有登录态的空白浏览器。

扩展管理入口

点击左侧导航栏「扩展」,第二栏按「Skills、插件、MCP、连接器」排列四个页面;插件与 MCP 相邻,连接器在最下面。点击其中一项,右侧显示对应管理内容;使用窗口顶部的侧栏开关可收起或展开第二栏,窄窗口中选择页面后会收起浮动侧栏。

  • Skills:浏览 Skill 市场、管理我的 Skill,并保留团队、创作者和个人内容。
  • 插件:按「推荐插件」「已安装插件」分组管理。简短说明集中在顶部标题下,点击旁边的「插件目录」可打开本机缓存目录,悬浮查看路径。卡片顶部为名称、简介和开关,中部为能力摘要,底部统一显示来源、版本及当前主操作。点击整张卡片打开详情弹窗,可查看完整 Skill、MCP 名称;Mole 的详情按「能做什么、怎么使用、清理与安全、数据去向」分区说明;含 MCP 的插件可在弹窗底部点「查看连接」。详情操作统一位于弹窗底部,仅项目主页、安装指引等外部链接带箭头;检测依赖、开始体检和查看连接不带箭头,长说明滚动时按钮仍保持可见。开关和主操作独立响应,不会同时打开弹窗;卡片聚焦后也可按 Enter 或空格打开,Esc 或点击遮罩关闭后焦点回到原卡片。Skills 与 MCP 可加载,Commands / Agents / Hooks 仅计数且在详情中分项说明;能力数量不代表已连接或被模型调用。
  • MCP:按来源查看「手动配置的连接」和「插件自带的连接」。手动配置保留添加、导入、编辑、启停和删除;插件连接显示来源,只提供「管理插件」跳回对应插件卡片,不另设开关。
  • 连接器:顶部使用标签切换栏在 NewMax Provider 与第三方 Provider 之间切换,两类目录都可通过右侧搜索框按名称、标识或类别搜索,切换目录或从详情返回时保留关键词。NewMax Provider 目录顶部另有分类栏(全部 + 社交媒体、视频与直播、电商零售、搜索与 SEO 等,每项显示数量),点选后只显示该类,数量随搜索关键词变化;第三方 Provider 不显示分类栏。卡片第二行按「类别 · 动作数量」排列;点击卡片右侧「连接」进入详情,再按服务要求完成授权,不会点击后直接连接。已启用的连接器右侧显示「已启用」,点击卡片可管理;钱包余额入口仍打开设置中的钱包。国际版 NewMax Provider 只开放已审核的国际场景,未审核的新连接器不自动显示或开放调用;只面向国内市场的连接器(如抖音、小红书、微信系等)不显示。英文界面使用对应的英文连接器名称,可按英文名称搜索。第三方 Provider 隐藏飞书、钉钉等国内服务,但已连接的条目仍保留可管理。

Skills 市场、已分享、我的创作,以及插件、连接器、MCP 使用与浏览器已保存任务一致的卡片列表,宽窗口多列、窄窗口单列。卡片采用紧凑等高布局,名称与版本或状态通常显示在同一行;连接器第二行以「类别 · 动作数量」显示摘要,连接入口或已启用状态位于右侧,无底部操作的卡片保持更紧凑的两行布局。说明只保留一行,超出卡片宽度时在右侧渐隐,不显示省略号;悬浮在说明上可查看完整文字。插件使用统一摘要卡,点击整卡在弹窗中查看完整能力清单,不改变列表卡片高度;MCP 连接信息继续以单行摘要显示,悬浮可看完整内容,原有管理按钮和开关保留。「我的 Skill」保留单列横向列表,按列显示名称、安装位置、已激活工作区、近期触发次数、最后触发、使用/编辑操作和启停;七列随内容宽度自适应,无需横向滚动;长名称和描述会截断,窄窗口中的操作按钮可在本列内换行。点击 Skill 列表行或 Skill、连接器、手动配置的 MCP 卡片进入详情,独立按钮和开关不会同时打开详情;插件卡片整卡点击打开详情弹窗,可查看包内名称并进入连接列表。插件来源的 MCP 不打开手动编辑弹窗。

插件、连接器和 MCP 不再位于设置的「连接」标签中;历史 MCP 管理链接会直接打开这里的对应页面。

Mole · 电脑体检

  1. 打开「扩展 → 插件」,在顶部「推荐插件」找到 Mole · 电脑体检。默认关闭,卡片与详情标题区均使用 Mole 官方鼹鼠图标,卡片显示能力摘要和作者 tw93,已检测到的版本也显示在底部。
  2. 点击整张卡片打开详情弹窗,阅读检测与数据使用边界,也可从弹窗内的「项目主页」了解开源项目;关闭弹窗后打开卡片右上角开关。NewMax 检查本机独立安装的 Mole,不会自动安装、升级、下载检测程序或索取管理员权限。
  3. 已启用的 Mole 在重启后首次打开插件页会自动检测本机依赖一次,检测中卡片显示“正在检测本机依赖…”。依赖异常会直接显示原因和处理步骤:未找到时点「安装指引」核对位置并完成安装;旧版本会显示当前版本与最低要求,按原安装方式更新;缺少或无法执行配套程序时会列出具体程序,按指引修复完整安装。处理后直接点卡片上的「重新检测」,不必打开详情,也不会自动安装或升级。无法确认版本时先重新检测,仍失败再打开卡片核对检测路径与项目归属,不要盲目升级或重装。普通检测失败可点「检测依赖」重试,详情中也提供安装指引。macOS 需 Mole 1.62.0 或更新的兼容 1.x,Windows 需 1.37.0 或更新的兼容 1.x;其他主版本会提示当前支持范围,可从卡片详情的「项目主页」查看版本说明。
  4. 检测通过后,卡片底部出现「开始体检」。点击打开普通对话,只预填「用 Mole 帮我检查一下电脑状态。」,确认后发送才开始检查。调用与安全规则由插件提供,无需写进需求;使用成功检测结果回答时,插件会提示 AI 在末尾注明 Mole 来源和项目主页,同一回答不重复署名。直接在对话中使用 Mole 也适用;未调用或失败不代表已完成体检。重新启动 NewMax 后,需要再次检测依赖。没有工作区时先添加或选择工作区。
  5. 可以直接在对话中询问电脑状态、磁盘占用和最近清理历史,不必点名 Mole。查看磁盘概览后,可以继续说「分析这个目录里什么最占空间」,并提供具体本地目录;不需要自己输入命令。扫描不完整时,结果会提供未完成项和可补查的目录,并提示 AI 明确说明范围;目录不可用时的零值不代表为空,也不能直接判断是权限不足。不会自动提权或改扫其它目录。磁盘占用、系统可回收空间不等于可安全删除的空间。Windows 可预览清理空间;macOS 预览可能复用已有 sudo 授权,当前不开放。不会调用 Mole 的整体清理、卸载或项目清除命令。
  6. macOS 普通桌面对话中,可以直接说「把 ~/Documents/GitHub/旧项目 删掉」或「清理 Gradle 缓存」,不需要先分析磁盘。AI 只会处理你点名或逐项同意的路径,生成清单后直接移入废纸篓,审批方式和终端命令一样跟随对话的权限模式:完全模式下直接执行;其它模式会在对话里出现「移入废纸篓」审批卡片,逐行列出完整路径,拒绝则不移动文件。AI 会在回复里说明大小和类型;如果是 Git 仓库,还会说明未提交改动、未推送提交、stash 或没有远程;包含锁定文件时也会提示。清单最多 10 项,5 分钟内有效。支持用户目录中的普通文件和文件夹(包括含 node_modules 的项目),Xcode DerivedData、Gradle、npm、uv、pip、Homebrew、CocoaPods、Yarn 缓存,以及资源库 Caches、Logs 中的单个应用缓存和日志文件夹。以下内容不处理:资源库中的其它应用数据(如 Application Support、模拟器)、已安装的应用、凭据与配置目录、用户目录下的隐藏配置文件、Git 元数据、照片图库、桌面/文稿/下载等文件夹本身,以及正在使用或无法核实的项目。NewMax 工作区文件夹本身及其上级目录不能整体移走,工作区里的具体内容可以点名处理。Windows、定时任务和后台自动任务不开放此操作。
  7. 移入废纸篓通常不会立即释放磁盘空间,也不会自动清空废纸篓或永久删除。清空废纸篓时如提示部分项目被锁定,需要先对该文件夹解除锁定。每项放在带回执的 NewMax-Recovery-* 文件夹中移入系统废纸篓;需要恢复时取回该文件夹,按 RECOVERY.json 的原路径将内容移回。中断或失败后若返回恢复位置,文件仍在那里;不要直接重复删除或覆盖原位置。没有宿主一键撤销按钮。
  8. 关闭卡片右上角开关即可停用插件并取消当前实例中的在途检测或尚未提交的移动,不会卸载 Mole 或删除它的数据。已经提交给系统废纸篓的操作会等待真实结果,不能当作已撤销。

隐私与边界:Mole 检测可能维护自身缓存、日志及预览文件,不是文件系统零写入;定向移入废纸篓由 NewMax 按对话权限模式审批后执行,不是 Mole 整体清理。检测结果可能含目录、进程、设备和历史信息,发送体检需求后这些结果会交给当前对话模型。预览不是删除授权,异常、超时或缺失指标不能解释为电脑健康。报告应注明检测能力来自 Mole 并附项目主页。

Mole 是由 tw93 维护的第三方开源项目,NewMax 提供推荐入口和调用适配,不代表由 NewMax 自研或已安装。使用它不需要安装 Skill,也不在 MCP 连接列表重复配置;同名第三方插件的开关不会控制它。卡片加载失败与未安装是不同状态,失败时显示具体错误,可重试;不要让 AI 改用终端绕过停用、版本或平台限制。

使用 API Key 连接第三方服务

  1. 打开「扩展 → 连接器」,切到「第三方 Provider」,找到对应服务并进入详情。
  2. 在 API Key 输入框填写该服务签发的密钥,再点击「连接」。NewMax 会自动准备本地连接服务并等待就绪,无需另外安装 Node 或配置启动开关。
  3. 密钥经第三方服务校验成功后,连接器才会显示为已启用。API Key 及相关凭据加密保存在本机,不会因此上传到 NewMax 云端;验证时仍会发送给对应的第三方服务。
  4. 如果提示「本地连接器服务未能启动」,说明尚未完成密钥校验,不等同于密钥错误。先重启 NewMax;仍失败时重新安装完整应用,并保留错误信息供排查,不要反复更换密钥。

本机凭据受当前操作系统账号的加密能力保护;不要仅复制凭据数据库到另一台设备,也不要删除加密密钥文件。更换设备或系统账号后可能需要重新连接。

连接后,详情页若显示「测试调用」,可点击「运行」查看真实调用结果。Microsoft Clarity 的测试会只读查询最近 24 小时的数据,无需手填参数或打开「上云」。调用期间按钮暂时禁用,成功显示动作名称与返回数据;失败显示具体原因并恢复按钮。如果显示 invalid_input,表示测试参数不符合动作要求,不代表 API Key 错误或授权失效;请保留错误信息反馈排查,不要因此删除连接或反复更换密钥。

连接器已启用,但 AI 提示动作目录缺失

“已启用”表示连接器已登记,不等于每次动作目录读取都成功。Google Analytics、Google Search Console 等第三方连接器需完成授权,AI 再通过连接器搜索动作、查看参数并执行;无需因此改走浏览器登录。

如果提示“动作目录为空或不完整”,先查看提示中列出的 Provider 标识。这表示本次没有取得这些连接器的动作定义,不能据此判断平台没有查询能力、授权已失效或服务正在更新。不要反复更换搜索关键词,也不要直接删除授权重连。可在「扩展 → 连接器」核对对应服务的状态,并将缺失标识及错误信息反馈给维护者检查动作目录接口。客户端不会缓存残缺目录;服务端恢复后再次查询即可重新获取。

MCP 服务器

MCP(Model Context Protocol)服务器可以向 AI 提供额外的工具和数据源。内置 MCP(包括 NewMax 产品帮助)由 NewMax 维护,不在「扩展 → MCP」的自定义服务器列表显示,不能卸载、删除或编辑,调用时也不会进入通用工具审批;用户可以添加和管理自定义的 stdio、HTTP 或 SSE 服务器,自定义服务器仍遵循当前权限模式。

插件与 MCP 重叠时怎么管理

插件是一个能力包,可以同时包含 Skills 和 MCP;MCP 页面展示的是连接。两个页面出现同一个服务不代表需要再安装一次。

  1. 在「扩展 → 插件」查看卡片内的 Skill 与 MCP 名称;插件开关统一控制整包,停用会让包内 Skills 与 MCP 不再提供给新一轮对话
  2. 点「查看连接」,在「插件自带的连接」区看到对应 MCP;停用插件仍保留来源记录,状态显示「插件已停用」,不会另设连接开关
  3. 点连接卡片的「管理插件」,自动返回并定位到对应来源的插件卡片;在那里启用或停用整包。标为「由内置浏览器接管」的连接不单独加载,浏览器操作使用 NewMax 内置能力
  4. 手动添加或外部文件配置的 MCP 位于「手动配置的连接」区,继续使用自己的启停开关;插件开关不会修改这些独立配置
  5. 若出现「疑似重复」,悬浮在标记上查看另一份配置的名称与来源。地址或启动命令/参数相同时会提示,多处启用时额外提醒可能重复加载;按需要保留来源,不会自动合并或停用。账号、请求头或环境变量可能不同,不能只看标记就删除
  6. 远程插件连接(如 Figma)需要登录授权时,卡片上显示「需要授权」和「授权」按钮。点「授权」会打开浏览器,登录并同意后自动返回,状态变为「已授权」;之后可点「取消授权」清除本机保存的登录。授权由配套的 Claude Code 完成,登录信息保存在 NewMax 自己的配置里,覆盖 NewMax 默认配置和已启用的备用 Claude 账号(每个账号可能各需同意一次);使用「系统」Claude Code 账号时走的是你自己的 Claude Code 配置,NewMax 不会替你写入,需要时请在终端运行 claude mcp login。授权后请新开一个对话使用,已打开的对话可能还拿不到新授权。看不到按钮表示该插件已停用或连接是本地的

插件连接列表在重新进入页面、切换工作区或窗口重新获得焦点时刷新;读取失败会明确提示,不表示插件不存在。无效配置不会作为可用连接列出,包内名称计数也不代表服务器已连接。

操作步骤:添加或管理自定义 MCP 服务器

  1. 点击左侧导航栏「扩展」
  2. 点击第二栏「MCP」
  3. 点击右上角「添加服务器」
  4. 填写服务器名称、连接类型及对应配置:本地 stdio 服务器填写命令、参数和环境变量;HTTP / SSE 服务器填写 URL,需要固定 Token 或 API Key 鉴权时,在「请求头」中每行填写一个 name=value,例如 Authorization=Bearer xxx 或 X-API-Key=xxx
  5. 如果开启「启用此服务器」,点击「添加」或「保存」时 NewMax 会先带上已填写的环境变量或请求头,完成 MCP 初始化并读取工具列表
  6. 连接测试成功后,服务器会按启用状态保存;测试失败时弹窗会保留并自动关闭表单的启用开关,但尚未保存任何更改,原有连接的启用状态也不变。提示为「连接测试失败,更改尚未保存」(英文 Connection test failed. Changes haven't been saved.)。你可以修正命令、地址或鉴权信息,也可以再次点击「添加」或「保存」明确存为停用配置;取消不会修改原连接。
  7. 自定义服务器出现在卡片列表后,可通过卡片右上角开关启用或停用;从停用切换为启用时也会先测试连接。点击服务器卡片可打开详情进行编辑,需要删除时使用详情弹窗左下角的「删除」

内置 MCP 不会出现在此列表中,其配置由 NewMax 保护,避免误改或删除系统服务。

已启用的自定义 MCP 默认按需加载:NewMax 不会预先加载服务器的全部工具定义,而是在 AI 搜索到相关工具时再加载,从而减少上下文占用。你在对话中 @mention 某个服务器时,该服务器的工具会直接加载。此策略由 NewMax 自动管理,无需单独设置。

操作步骤:粘贴 JSON 添加 MCP 服务器

  1. 打开「扩展 → MCP」→「添加服务器」,把弹窗顶部的输入方式切到「粘贴 JSON」
  2. 粘贴 MCP 项目 README 里的配置片段。支持 Claude Desktop / Claude Code / Cursor 通用的 {"mcpServers": {...}} 格式、不带外层的「名称 → 服务器」映射,以及单个服务器对象;带 ```json 围栏也能识别
  3. 识别到一个服务器时点「填入表单」,NewMax 会把名称、类型、命令、参数、环境变量或 URL、请求头回填到表单,切回表单模式后可以继续修改、开启「启用此服务器」再点「添加」
  4. 识别到多个服务器时点「全部导入(默认停用)」,所有服务器会以停用状态一次性保存到列表;与已有服务器同名的条目会被跳过并在列表上方提示

没有 type 字段时按内容推断:有 command 视为 stdio,有 url 视为 HTTP(URL 以 /sse 结尾视为 SSE);streamable-http 会归为 HTTP。缺少 command 和 url 的条目会被跳过。JSON 中的 enabled / disabled 字段不会生效,导入的服务器一律先停用,启用时再走连接测试。

操作步骤:从 JSON 文件批量导入

  1. 打开「扩展 → MCP」,点击列表右上角「导入 JSON」
  2. 选择一个 .json 文件,例如从 Claude Desktop 的 claude_desktop_config.json 或其他客户端导出的配置
  3. NewMax 会按上面的规则解析文件,新服务器全部以停用状态加入列表,列表上方会显示导入了几个、跳过了哪些同名或未命名条目
  4. 逐个核对命令、地址、环境变量或请求头后,用行内开关启用;启用时会先测试连接

导入不会覆盖已有的同名服务器。需要更新时,先点击原有服务器编辑或删除,再重新导入。

操作步骤:在对话中让 AI 添加 MCP 服务器

  1. 在对话中明确告诉 AI 要添加的 MCP 服务器,以及已知的连接方式、命令、参数、URL 或鉴权方式;也可以直接把 README 里的 mcpServers JSON 片段贴进对话,不必再说明「添加 MCP」
  2. 信息齐全时直接添加:AI 会先发起「添加 MCP 服务器」的工具审批,卡片列出名称、将运行的命令或将连接的地址,以及环境变量、请求头的名称(不显示密钥值)。审批方式和其它工具一样跟随对话的权限模式:完全模式下直接执行;其它模式需要你点允许
  3. 批准后 NewMax 先测试连接并读取工具列表,测试通过才按启用状态保存,AI 随后告诉你保存结果和工具数量;全程无需切换页面
  4. 信息不全或测试失败时改走草案:缺少 API Key 等密钥、你想先核对,或连接测试失败时,不会保存任何内容,AI 会打开「扩展 → MCP」里的「添加 MCP 服务器」对话框并预填一份默认停用的草案。片段里有多个服务器时,草案会逐个弹出,上一个保存或取消后再显示下一个,离开 MCP 页面(切换到其它二级页面或返回首页)会丢弃尚未弹出的草案
  5. 检查草案里的服务器名称、命令或 URL、参数,以及 stdio 的环境变量或 HTTP / SSE 的请求头;如需立即使用,开启「启用此服务器」再点击「添加」,同样会先测试连接

直接添加只在你亲自发送消息的普通对话轮次可用;定时任务、对话内循环、自动续轮和队列自动发送只能打开草案。AI 不能覆盖、编辑或删除已有服务器,名称与已有服务器或内置服务器重名时会被拒绝并保持原样。缺少密钥不会阻止草案弹出;AI 已知环境变量或请求头名称时会留空预填,密钥值仍需由你补充。需要浏览器登录和回调的 OAuth 仍需你按服务提示完成授权。

操作步骤:在对话中查看 MCP 状态

  1. 在主对话或快速输入窗口中输入 /,选择「MCP 服务器」;也可以直接输入 /mcp
  2. 在只读列表中查看各服务器的名称、描述和「已启用 / 已禁用」状态
  3. 如需更改状态,点击列表标题右侧的「管理 MCP」,或前往「扩展 → MCP」,使用服务器行内的「启用」开关

/mcp 状态列表只显示手动配置的自定义服务器,不包含内置和插件等运行时来源;「扩展 → MCP」管理页另有插件连接区,用于查看来源并跳回插件管理。手动连接在 MCP 管理页启停,插件连接随插件整包启停;启用状态不等于已连接或被 AI 调用。

操作步骤:浏览和安装技能(Skill管理)

我的 Skill:启停、触发统计与上下文占用

  1. 点击左侧导航栏「扩展」(拼图图标)
  2. 第二栏点击「Skills」,右侧显示 Skill 管理页面
  3. 顶部可在 Skill 市场 和 我的 Skill 之间切换:
    • Skill 市场:浏览所有可用的社区技能
    • 我的 Skill:管理已安装和已共享的技能
  4. 使用搜索栏输入关键词搜索技能,或使用分类筛选下拉菜单
  5. 技能按分类展示:开发、写作、分析、自动化、设计、文档排版、安全、视频生成、飞书集成、其他
  6. 找到想要的技能后,点击技能卡片的非按钮区域查看详情(描述、版本、安装次数、标签);图标、名称、说明、来源文字和空白区域都可以点击
  7. 点击「安装」按钮,一键安装到本地;已安装的技能可直接点击卡片上的「管理」,打开「管理安装位置」弹窗,勾选或取消全局及工作区位置后保存,无需先切换到「我的 Skill」。市场、团队和创作者目录的卡片行为一致;「安装」「管理」「使用」按钮只执行各自操作,不会同时打开详情
  8. 安装完成后可在「我的 Skill」中查看;该页可先按「范围」切换全局或工作区,再使用两个下拉选择器组合筛选:左侧来源下拉默认「全部来源」,也可选市场安装、本地安装、共享;右侧状态下拉默认「全部状态」,也可选活跃、已启用、未启用、未触发,当前来源有问题技能时还会提供「有问题」。选项旁显示非零数量,状态数量会随来源和范围更新;状态下拉在统计报告加载后显示。右侧排序菜单可按触发次数、最后触发或名称排序,并选择正序或倒序

在「我的 Skill」中,复制按钮和未扫描技能的本地查杀入口默认隐藏,把鼠标移到列表行上或键盘聚焦时显示图标。点击盾牌运行本地查杀,扫描中按钮禁用;扫描完成后直接显示最近评分、风险数量或「拦截」,不必悬浮才能查看。扫描失败则显示「无法扫描」,可点击重试。已有结果使用小型 ghost 按钮,点击直接打开最近报告、不重复扫描;关闭报告后结果仍显示,悬浮提示可查看补充信息。这些独立操作不会同时打开 Skill 详情。

英文技能统计使用 Usage、Last used、Used 1 time / Used 2 times 和 Not used yet,统计的是模型实际调用,不是点击或勾选次数。Skill catalog context 是技能目录元数据的估算占用,不是技能全文或实际费用。全局安装只表示存入全局库;工作区可用范围在 My Skills 中管理,跨设备同步仍取决于相应同步设置。

扫描结果 No issues detected by this scan 仅表示本次扫描未检出问题,不代表技能绝对安全。安装和启停不会因本次文案调整而改变。

在「我的 Skill」中停用的技能仍保留在本地库。点击该技能查看详情后,点击「启用」即可恢复使用,不需要重新安装。

由启用插件提供的技能不会在「我的 Skill」中逐个列出,但会出现在对话的技能选择器中并可正常使用。这类技能随插件一起管理;如需查看或停用,请前往「扩展 → 插件」操作对应插件。停用后该插件的 Skills 与 MCP 不再提供给新一轮对话;当前插件页没有直接移除按钮。

在「我的 Skill」的全局范围中,点击「一键整理」会把旧版工作区实体安装收进全局库,并在对应工作区保留软链;单个 Skill 目录和包含多个 Skill 的包目录都会处理。若 .claude/skills/ 下的目录已被项目仓库跟踪,则视为项目源码保留,不会被迁移。

操作步骤:从本地安装技能

  1. 点击侧栏「扩展」→ 第二栏「Skills」
  2. 点击页面右上角的 ···(更多菜单)
  3. 选择安装方式:
    • 从 ZIP 文件安装:选择本地 ZIP 压缩包;ZIP 内若包含多个技能,会自动拆解逐一安装
    • 从文件夹安装:选择本地技能文件夹
  4. 等待安装完成

操作步骤:在对话中让 AI 安装技能

  1. 在对话中提供 Skill 的来源,并明确说“安装这个 Skill”;来源可以是本地文件夹、本地 ZIP、单个 SKILL.md、远程 ZIP 或 SKILL.md URL、Git 仓库地址,或 NewMax 市场中的 Skill 名称
  2. 如果 Git 仓库中的 Skill 不在仓库根目录,同时告诉 AI 所在的子目录;需要指定分支或标签时一并说明
  3. 默认会安装到全局 Skill 库;如果只想在当前工作区启用,请明确说“安装到当前工作区”
  4. AI 会调用 NewMax 内置安装器识别来源、安装单个或多个 Skill,并校验最终的 SKILL.md 路径;只有校验通过后才会报告安装成功
  5. 遇到同名 Skill 时,安装器会返回冲突,不会静默覆盖。需要更新已有 Skill 时,请明确要求覆盖更新

明确安装 Skill 时无需先开启网络搜索,也不需要让 AI 先抓取网页。远程来源的下载、来源识别和包结构校验由内置安装器直接完成;网络搜索开关只用于资料检索,不是安装前置条件。

对话安装不等于运行任意项目的安装脚本。若来源是普通应用或项目工具,而不是有效的 Skill 包,AI 应将它作为项目工具处理,不能把完成 git clone 或依赖安装说成“Skill 已安装”。

GitHub 项目工具和 Skill 的区别

从 GitHub 克隆并配置成功的项目工具,不一定是 NewMax Skill,也不会自动出现在「我的 Skill」中。

NewMax 的直接安装目标只有:

  • 全局:~/.newmax/skills/{技能名}/SKILL.md
  • 工作区:{当前工作区}/.claude/skills/{技能名}/SKILL.md

受支持的多 Skill 包也会安装在以上两个根目录之一,NewMax 会按包结构拆分识别。

~/.claude/skills 是 Claude Code 用户库的只读兼容来源。NewMax 会识别其中已经存在的外部 Skill,但不会把新 Skill 安装到这里;因此“NewMax 已识别”不等于“NewMax 已安装”。

如果一个仓库主要包含应用代码、依赖环境、AGENTS.md,或者只在项目内部提供 .agents/skills、skills/ 等工作流文件,它通常属于需要在仓库上下文中运行的项目工具。安装完成后应把该仓库作为独立工作区打开,并按项目说明在其中使用;仅完成克隆和依赖安装不代表已经安装为 Skill。

操作步骤:更新已安装的本地技能(覆盖更新)

如果你在维护自己的本地技能,改完内容后想更新到 NewMax,不需要先卸载、也不需要手动去改 ~/.newmax/skills/ 目录,直接重新导入同名的包即可:

  1. 进入「扩展 → Skills」页面 → 右上角 ··· 更多菜单 → 选择「从 ZIP 文件安装」或「从文件夹安装」
  2. 选择你更新后的技能包(ZIP 根目录名 / 文件夹名与已安装的技能同名)
  3. 系统检测到同名技能后,会弹出 「覆盖更新 / 取消」 确认框:
    • 点 覆盖更新:用新内容替换旧版本,旧版本里已删除的文件会一并清除(不会残留脏文件);原来的图标和描述若这次没填会自动沿用
    • 点 取消:不做任何改动,旧版本保持原样
  4. 确认后等待完成,技能即更新为最新内容

说明:技能实体只在全局库 ~/.newmax/skills/ 保存一份,工作区通过软链引用。所以覆盖更新会对所有引用该技能的工作区同时生效。多技能包(含 skills/<子技能>/ 结构)会按已存在的子技能逐一提示覆盖。

操作步骤:在对话中启用技能

  1. 在对话输入框左侧工具栏中找到「技能」按钮(右上角显示已选数量的徽章)
  2. 点击后弹出技能快速选择菜单
  3. 可点击菜单底部的分类筛选,只看某一类技能;也可以按 Tab / Shift+Tab 或 ←/→ 切换分类,或继续输入关键词搜索
  4. 选择你需要在本条消息中使用的技能
  5. 已选技能会像 @ 文件一样,以可选中的行内引用显示在正文输入区中;可将引用按文本选中后删除,或把光标移到引用旁按 Backspace / Delete 删除。单击引用不会直接移除;需要多个技能时可再次点击「技能」按钮继续添加
  6. 发送消息后,技能标签显示在消息气泡上方,AI 开始处理时会显示“使用 Skill”的过程记录,选中状态自动清空

技能选择是按消息生效的:发送后即消费,不持续作用于整个对话。需要每条消息都用某个技能时,每次发送前重新勾选即可。

只选择 Skill、不输入其它文字时,也可以直接按 Enter 发送。

操作步骤:通过斜杠命令快速使用技能

  1. 在输入框正文任意位置输入 /(斜杠)
  2. 弹出斜杠菜单;上方「命令」区域显示 /plan、/goal、/compact、/mcp 等内置操作,下方「Skills」区域显示可用技能
  3. 在「Skills」区域内可点击分类筛选,只看某一类 Skill;也可以按 Tab / Shift+Tab 或 ←/→ 切换分类,或继续输入关键词搜索。点击右侧显示当前排序方式的下拉按钮,可选择按名称或按使用频率排序,并选择正序或倒序;默认按名称正序排列。将鼠标移到某个 Skill 行上并点击图钉,可将它固定在所有排序结果顶部,再次点击即可取消置顶。需要新技能时,点击菜单右上角「创建 Skill」
  4. 使用鼠标点击 Skill,或用 ↑/↓ 选择后按 Enter 确认
  5. 选择 Skill 时,当前 /关键词 片段会被移除并关闭面板,选中的技能会像 @ 文件一样显示为正文中的行内引用;选择 /plan 或 /goal 时,输入框会转换为对应命令前缀;选择 /compact 会立即触发上下文压缩;选择 /mcp 会打开只读的服务器状态列表
  6. 可补充具体需求后按 Enter 发送,也可以只保留 Skill 行内引用直接发送

使用频率按本机实际发送消息时启用该 Skill 的次数统计;排序方式、使用次数和置顶列表保存在当前设备,不会同步到其它设备。搜索时仍以关键词匹配度为主,匹配到的置顶 Skill 会优先显示。

操作步骤:卸载技能

  1. 点击侧栏「扩展」→ 第二栏「Skills」
  2. 切换到「我的 Skill」标签
  3. 找到要卸载的技能
  4. 点击技能卡片上的「管理」按钮,在安装位置弹窗中卸载对应位置

卸载后系统会记录,防止自动重新安装。如果该技能被项目或定时任务引用,卸载时会有提示。

操作步骤:发布自己的技能

Skill 详情弹窗:查看描述、版本与安装位置管理

  1. 进入「扩展 → Skills」页面
  2. 点击页面右上角的 ··· 更多菜单
  3. 选择「上传技能」
  4. 选择技能文件/文件夹
  5. 填写技能元数据:
    • 展示名称和描述
    • 分类选择
    • 版本号
    • 图标(上传图片,自动裁剪为 128px 方形)
  6. 提交后等待管理员审核,审核通过后在Skill管理中公开
  7. 可在Skill管理中查看自己发布的技能状态和安装统计

本页目录