@neurocode-ai/web 1.18.8

package/src/content/docs/zh-cn/server.mdx

@@ -0,0 +1,284 @@
+---
+title: 服务器
+description: 通过 HTTP 与 opencode 服务器交互。
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+`opencode serve` 命令运行一个无界面的 HTTP 服务器，暴露一个 OpenAPI 端点供 opencode 客户端使用。
+
+---
+
+### 用法
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### 选项
+
+| 标志            | 描述                  | 默认值           |
+| --------------- | --------------------- | ---------------- |
+| `--port`        | 监听端口              | `4096`           |
+| `--hostname`    | 监听的主机名          | `127.0.0.1`      |
+| `--mdns`        | 启用 mDNS 发现        | `false`          |
+| `--mdns-domain` | mDNS 服务的自定义域名 | `opencode.local` |
+| `--cors`        | 额外允许的浏览器来源  | `[]`             |
+
+`--cors` 可以多次传递：
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### 认证
+
+设置 `OPENCODE_SERVER_PASSWORD` 以使用 HTTP 基本认证保护服务器。用户名默认为 `opencode`，也可以设置 `OPENCODE_SERVER_USERNAME` 来覆盖它。这适用于 `opencode serve` 和 `opencode web`。
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### 工作原理
+
+当你运行 `opencode` 时，它会启动一个 TUI 和一个服务器。TUI 是与服务器通信的客户端。服务器暴露一个 OpenAPI 3.1 规范端点。该端点也用于生成 [SDK](/docs/sdk)。
+
+:::tip
+使用 opencode 服务器以编程方式与 opencode 交互。
+:::
+
+这种架构让 opencode 支持多个客户端，并允许你以编程方式与 opencode 交互。
+
+你可以运行 `opencode serve` 来启动一个独立的服务器。如果你已经在运行 opencode TUI，`opencode serve` 会启动一个新的服务器。
+
+---
+
+#### 连接到现有服务器
+
+当你启动 TUI 时，它会随机分配端口和主机名。你也可以传入 `--hostname` 和 `--port` [标志](/docs/cli)，然后用它来连接对应的服务器。
+
+[`/tui`](#tui) 端点可用于通过服务器驱动 TUI。例如，你可以预填充或运行一个提示词。此方式被 OpenCode [IDE](/docs/ide) 插件所使用。
+
+---
+
+## 规范
+
+服务器发布了一个 OpenAPI 3.1 规范，可在以下地址查看：
+
+```
+http://<hostname>:<port>/doc
+```
+
+例如，`http://localhost:4096/doc`。使用该规范可以生成客户端或检查请求和响应类型，也可以在 Swagger 浏览器中查看。
+
+---
+
+## API
+
+opencode 服务器暴露以下 API。
+
+---
+
+### 全局
+
+| 方法  | 路径             | 描述                     | 响应                                 |
+| ----- | ---------------- | ------------------------ | ------------------------------------ |
+| `GET` | `/global/health` | 获取服务器健康状态和版本 | `{ healthy: true, version: string }` |
+| `GET` | `/global/event`  | 获取全局事件（SSE 流）   | 事件流                               |
+
+---
+
+### 项目
+
+| 方法  | 路径               | 描述         | 响应                                          |
+| ----- | ------------------ | ------------ | --------------------------------------------- |
+| `GET` | `/project`         | 列出所有项目 | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET` | `/project/current` | 获取当前项目 | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### 路径和 VCS
+
+| 方法  | 路径    | 描述                    | 响应                                        |
+| ----- | ------- | ----------------------- | ------------------------------------------- |
+| `GET` | `/path` | 获取当前路径            | <a href={typesUrl}><code>Path</code></a>    |
+| `GET` | `/vcs`  | 获取当前项目的 VCS 信息 | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### 实例
+
+| 方法   | 路径                | 描述         | 响应      |
+| ------ | ------------------- | ------------ | --------- |
+| `POST` | `/instance/dispose` | 销毁当前实例 | `boolean` |
+
+---
+
+### 配置
+
+| 方法    | 路径                | 描述                 | 响应                                                                                     |
+| ------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | 获取配置信息         | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | 更新配置             | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | 列出提供商和默认模型 | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### 提供商
+
+| 方法   | 路径                             | 描述                    | 响应                                                                                |
+| ------ | -------------------------------- | ----------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | 列出所有提供商          | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | 获取提供商认证方式      | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | 使用 OAuth 授权提供商   | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | 处理提供商的 OAuth 回调 | `boolean`                                                                           |
+
+---
+
+### 会话
+
+| 方法     | 路径                                     | 描述                       | 说明                                                                              |
+| -------- | ---------------------------------------- | -------------------------- | --------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | 列出所有会话               | 返回 <a href={typesUrl}><code>Session[]</code></a>                                |
+| `POST`   | `/session`                               | 创建新会话                 | 请求体：`{ parentID?, title? }`，返回 <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | 获取所有会话的状态         | 返回 `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`            |
+| `GET`    | `/session/:id`                           | 获取会话详情               | 返回 <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id`                           | 删除会话及其所有数据       | 返回 `boolean`                                                                    |
+| `PATCH`  | `/session/:id`                           | 更新会话属性               | 请求体：`{ title? }`，返回 <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | 获取会话的子会话           | 返回 <a href={typesUrl}><code>Session[]</code></a>                                |
+| `GET`    | `/session/:id/todo`                      | 获取会话的待办事项列表     | 返回 <a href={typesUrl}><code>Todo[]</code></a>                                   |
+| `POST`   | `/session/:id/init`                      | 分析应用并创建 `AGENTS.md` | 请求体：`{ messageID, providerID, modelID }`，返回 `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | 在某条消息处分叉现有会话   | 请求体：`{ messageID? }`，返回 <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | 中止正在运行的会话         | 返回 `boolean`                                                                    |
+| `POST`   | `/session/:id/share`                     | 分享会话                   | 返回 <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id/share`                     | 取消分享会话               | 返回 <a href={typesUrl}><code>Session</code></a>                                  |
+| `GET`    | `/session/:id/diff`                      | 获取本次会话的差异         | 查询参数：`messageID?`，返回 <a href={typesUrl}><code>FileDiff[]</code></a>       |
+| `POST`   | `/session/:id/summarize`                 | 总结会话                   | 请求体：`{ providerID, modelID }`，返回 `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | 回退消息                   | 请求体：`{ messageID, partID? }`，返回 `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | 恢复所有已回退的消息       | 返回 `boolean`                                                                    |
+| `POST`   | `/session/:id/permissions/:permissionID` | 响应权限请求               | 请求体：`{ response, remember? }`，返回 `boolean`                                 |
+
+---
+
+### 消息
+
+| 方法   | 路径                              | 描述                       | 说明                                                                                                                                                                 |
+| ------ | --------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | 列出会话中的消息           | 查询参数：`limit?`，返回 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                       |
+| `POST` | `/session/:id/message`            | 发送消息并等待响应         | 请求体：`{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`，返回 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | 获取消息详情               | 返回 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                             |
+| `POST` | `/session/:id/prompt_async`       | 异步发送消息（不等待响应） | 请求体：与 `/session/:id/message` 相同，返回 `204 No Content`                                                                                                        |
+| `POST` | `/session/:id/command`            | 执行斜杠命令               | 请求体：`{ messageID?, agent?, model?, command, arguments }`，返回 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | 运行 shell 命令            | 请求体：`{ agent, model?, command }`，返回 `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### 命令
+
+| 方法  | 路径       | 描述         | 响应                                          |
+| ----- | ---------- | ------------ | --------------------------------------------- |
+| `GET` | `/command` | 列出所有命令 | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### 文件
+
+| 方法  | 路径                     | 描述                 | 响应                                                                                |
+| ----- | ------------------------ | -------------------- | ----------------------------------------------------------------------------------- |
+| `GET` | `/find?pattern=<pat>`    | 在文件中搜索文本     | 包含 `path`、`lines`、`line_number`、`absolute_offset`、`submatches` 的匹配对象数组 |
+| `GET` | `/find/file?query=<q>`   | 按名称查找文件和目录 | `string[]`（路径）                                                                  |
+| `GET` | `/find/symbol?query=<q>` | 查找工作区符号       | <a href={typesUrl}><code>Symbol[]</code></a>                                        |
+| `GET` | `/file?path=<path>`      | 列出文件和目录       | <a href={typesUrl}><code>FileNode[]</code></a>                                      |
+| `GET` | `/file/content?path=<p>` | 读取文件             | <a href={typesUrl}><code>FileContent</code></a>                                     |
+| `GET` | `/file/status`           | 获取已跟踪文件的状态 | <a href={typesUrl}><code>File[]</code></a>                                          |
+
+#### `/find/file` 查询参数
+
+- `query`（必需）— 搜索字符串（模糊匹配）
+- `type`（可选）— 将结果限制为 `"file"` 或 `"directory"`
+- `directory`（可选）— 覆盖搜索的项目根目录
+- `limit`（可选）— 最大结果数（1–200）
+- `dirs`（可选）— 旧版标志（`"false"` 仅返回文件）
+
+---
+
+### 工具（实验性）
+
+| 方法  | 路径                                        | 描述                               | 响应                                         |
+| ----- | ------------------------------------------- | ---------------------------------- | -------------------------------------------- |
+| `GET` | `/experimental/tool/ids`                    | 列出所有工具 ID                    | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET` | `/experimental/tool?provider=<p>&model=<m>` | 列出指定模型的工具及其 JSON Schema | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP、格式化器和 MCP
+
+| 方法   | 路径         | 描述                | 响应                                                     |
+| ------ | ------------ | ------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | 获取 LSP 服务器状态 | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | 获取格式化器状态    | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | 获取 MCP 服务器状态 | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | 动态添加 MCP 服务器 | 请求体：`{ name, config }`，返回 MCP 状态对象            |
+
+---
+
+### 代理
+
+| 方法  | 路径     | 描述               | 响应                                        |
+| ----- | -------- | ------------------ | ------------------------------------------- |
+| `GET` | `/agent` | 列出所有可用的代理 | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### 日志
+
+| 方法   | 路径   | 描述                                                        | 响应      |
+| ------ | ------ | ----------------------------------------------------------- | --------- |
+| `POST` | `/log` | 写入日志条目。请求体：`{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| 方法   | 路径                    | 描述                                           | 响应         |
+| ------ | ----------------------- | ---------------------------------------------- | ------------ |
+| `POST` | `/tui/append-prompt`    | 向提示词追加文本                               | `boolean`    |
+| `POST` | `/tui/open-help`        | 打开帮助对话框                                 | `boolean`    |
+| `POST` | `/tui/open-sessions`    | 打开会话选择器                                 | `boolean`    |
+| `POST` | `/tui/open-themes`      | 打开主题选择器                                 | `boolean`    |
+| `POST` | `/tui/open-models`      | 打开模型选择器                                 | `boolean`    |
+| `POST` | `/tui/submit-prompt`    | 提交当前提示词                                 | `boolean`    |
+| `POST` | `/tui/clear-prompt`     | 清除提示词                                     | `boolean`    |
+| `POST` | `/tui/execute-command`  | 执行命令（`{ command }`）                      | `boolean`    |
+| `POST` | `/tui/show-toast`       | 显示提示消息（`{ title?, message, variant }`） | `boolean`    |
+| `GET`  | `/tui/control/next`     | 等待下一个控制请求                             | 控制请求对象 |
+| `POST` | `/tui/control/response` | 响应控制请求（`{ body }`）                     | `boolean`    |
+
+---
+
+### 认证
+
+| 方法  | 路径        | 描述                                         | 响应      |
+| ----- | ----------- | -------------------------------------------- | --------- |
+| `PUT` | `/auth/:id` | 设置认证凭据。请求体必须匹配提供商的数据结构 | `boolean` |
+
+---
+
+### 事件
+
+| 方法  | 路径     | 描述                                                              | 响应             |
+| ----- | -------- | ----------------------------------------------------------------- | ---------------- |
+| `GET` | `/event` | 服务器发送事件流。第一个事件是 `server.connected`，之后是总线事件 | 服务器发送事件流 |
+
+---
+
+### 文档
+
+| 方法  | 路径   | 描述             | 响应                          |
+| ----- | ------ | ---------------- | ----------------------------- |
+| `GET` | `/doc` | OpenAPI 3.1 规范 | 包含 OpenAPI 规范的 HTML 页面 |

package/src/content/docs/zh-cn/share.mdx

@@ -0,0 +1,127 @@
+---
+title: 分享
+description: 分享您的 OpenCode 对话。
+---
+
+OpenCode 的分享功能允许您创建指向 OpenCode 对话的公开链接，方便与团队成员协作或向他人寻求帮助。
+
+:::note
+共享的对话对任何拥有链接的人都是公开可访问的。
+:::
+
+---
+
+## 工作原理
+
+当您分享一段对话时，OpenCode 会：
+
+1. 为您的会话创建一个唯一的公开 URL
+2. 将您的对话历史同步到我们的服务器
+3. 通过可分享的链接使对话可访问 — `opncd.ai/s/<share-id>`
+
+---
+
+## 分享模式
+
+OpenCode 支持三种分享模式，用于控制对话的共享方式：
+
+---
+
+### 手动模式（默认）
+
+默认情况下，OpenCode 使用手动分享模式。会话不会自动共享，但您可以使用 `/share` 命令手动分享：
+
+```
+/share
+```
+
+这将生成一个唯一的 URL 并复制到您的剪贴板。
+
+要在[配置文件](/docs/config)中显式设置手动模式：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### 自动分享
+
+您可以在[配置文件](/docs/config)中将 `share` 选项设置为 `"auto"`，为所有新对话启用自动分享：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+启用自动分享后，每个新对话都会自动共享并生成链接。
+
+---
+
+### 禁用
+
+您可以在[配置文件](/docs/config)中将 `share` 选项设置为 `"disabled"`，完全禁用分享功能：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+要在团队中对特定项目强制执行此设置，请将其添加到项目的 `opencode.json` 文件中并提交到 Git。
+
+---
+
+## 取消分享
+
+要停止分享对话并将其从公开访问中移除：
+
+```
+/unshare
+```
+
+这将移除分享链接并删除与该对话相关的数据。
+
+---
+
+## 隐私
+
+分享对话时需要注意以下几点。
+
+---
+
+### 数据留存
+
+共享的对话在您明确取消分享之前将一直保持可访问状态。这包括：
+
+- 完整的对话历史
+- 所有消息和回复
+- 会话元数据
+
+---
+
+### 建议
+
+- 仅分享不包含敏感信息的对话。
+- 分享前请检查对话内容。
+- 协作完成后请取消分享。
+- 避免分享包含专有代码或机密数据的对话。
+- 对于敏感项目，请完全禁用分享功能。
+
+---
+
+## 企业版
+
+对于企业部署，分享功能可以：
+
+- 出于安全合规考虑**完全禁用**
+- **限制**为仅通过 SSO 身份验证的用户可用
+- **自托管**在您自己的基础设施上
+
+[了解更多](/docs/enterprise)关于在您的组织中使用 OpenCode 的信息。

package/src/content/docs/zh-cn/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: "代理技能"
+description: "通过 SKILL.md 定义可复用的行为"
+---
+
+代理技能让 OpenCode 能够从你的仓库或主目录中发现可复用的指令。
+技能通过原生的 `skill` 工具按需加载——代理可以查看可用技能，并在需要时加载完整内容。
+
+---
+
+## 放置文件
+
+为每个技能名称创建一个文件夹，并在其中放入 `SKILL.md`。
+OpenCode 会搜索以下位置：
+
+- 项目配置：`.opencode/skills/<name>/SKILL.md`
+- 全局配置：`~/.config/opencode/skills/<name>/SKILL.md`
+- 项目 Claude 兼容：`.claude/skills/<name>/SKILL.md`
+- 全局 Claude 兼容：`~/.claude/skills/<name>/SKILL.md`
+- 项目代理兼容：`.agents/skills/<name>/SKILL.md`
+- 全局代理兼容：`~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## 了解发现机制
+
+对于项目本地路径，OpenCode 会从当前工作目录向上遍历，直到到达 git 工作树根目录。
+在此过程中，它会加载 `.opencode/` 中所有匹配的 `skills/*/SKILL.md`，以及匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。
+
+全局定义也会从 `~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和 `~/.agents/skills/*/SKILL.md` 中加载。
+
+---
+
+## 编写 frontmatter
+
+每个 `SKILL.md` 必须以 YAML frontmatter 开头。
+仅识别以下字段：
+
+- `name`（必填）
+- `description`（必填）
+- `license`（可选）
+- `compatibility`（可选）
+- `metadata`（可选，字符串到字符串的映射）
+
+未知的 frontmatter 字段会被忽略。
+
+---
+
+## 验证名称
+
+`name` 必须满足：
+
+- 长度为 1–64 个字符
+- 仅包含小写字母和数字，可用单个连字符分隔
+- 不以 `-` 开头或结尾
+- 不包含连续的 `--`
+- 与包含 `SKILL.md` 的目录名称一致
+
+等效的正则表达式：
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## 遵循长度规则
+
+`description` 必须为 1-1024 个字符。
+请保持描述足够具体，以便代理能够正确选择。
+
+---
+
+## 使用示例
+
+创建 `.opencode/skills/git-release/SKILL.md`，内容如下：
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## 识别工具描述
+
+OpenCode 会在 `skill` 工具描述中列出可用技能。
+每个条目包含技能名称和描述：
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+代理通过调用工具来加载技能：
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## 配置权限
+
+在 `opencode.json` 中使用基于模式的权限来控制代理可以访问哪些技能：
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| 权限    | 行为                     |
+| ------- | ------------------------ |
+| `allow` | 技能立即加载             |
+| `deny`  | 对代理隐藏技能，拒绝访问 |
+| `ask`   | 加载前提示用户确认       |
+
+模式支持通配符：`internal-*` 可匹配 `internal-docs`、`internal-tools` 等。
+
+---
+
+## 按代理覆盖权限
+
+为特定代理授予与全局默认值不同的权限。
+
+**自定义代理**（在代理 frontmatter 中）：
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**内置代理**（在 `opencode.json` 中）：
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## 禁用技能工具
+
+为不需要使用技能的代理完全禁用技能功能：
+
+**自定义代理**：
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**内置代理**：
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+禁用后，`<available_skills>` 部分将被完全省略。
+
+---
+
+## 排查加载问题
+
+如果某个技能没有显示：
+
+1. 确认 `SKILL.md` 文件名全部为大写字母
+2. 检查 frontmatter 是否包含 `name` 和 `description`
+3. 确保技能名称在所有位置中唯一
+4. 检查权限设置——设为 `deny` 的技能会对代理隐藏