Compare commits
5
Commits
fcc9ebc519
...
2a760ab8a4
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2a760ab8a4 | ||
|
|
955e550b29 | ||
|
|
76a0e9ad86 | ||
|
|
767caa8574 | ||
|
|
5d5482891f |
@@ -61,7 +61,7 @@ PUBLIC_IP=1.2.3.4 \
|
|||||||
- `.env`:`EXECUTOR_TOKEN`、`WXBOT_TOKEN`、`AGENT_PORT` 等部署变量。
|
- `.env`:`EXECUTOR_TOKEN`、`WXBOT_TOKEN`、`AGENT_PORT` 等部署变量。
|
||||||
- `config.yml`:模型平台、登录账号、MCP 服务、公网前缀。
|
- `config.yml`:模型平台、登录账号、MCP 服务、公网前缀。
|
||||||
|
|
||||||
`image_task` / `video_task` 两个 MCP 服务复用 `BIGMODEL_KEY`(智谱与 BigModel 是同一个 key);未配置 `BIGMODEL_KEY` 时它们以 `enable: false` 写入配置。
|
`image_task` / `video_task` 两个 MCP 服务复用 `BIGMODEL_KEY`(智谱与 BigModel 是同一个 key);未配置 `BIGMODEL_KEY` 时它们以 `mode: disable` 写入配置。
|
||||||
|
|
||||||
`AUTH_USER` / `AUTH_PASSWORD` 不传时默认是 `admin` / `admin`,首次部署务必改掉。
|
`AUTH_USER` / `AUTH_PASSWORD` 不传时默认是 `admin` / `admin`,首次部署务必改掉。
|
||||||
|
|
||||||
@@ -110,6 +110,16 @@ mcp_servers:
|
|||||||
|
|
||||||
接入栈外的 MCP 服务:在设置页添加 `url` / `headers`,或在 `config.yml` 的 `mcp_servers` 追加一项。服务不可达时 core 只在启动日志里告警,不影响 Web 主流程,但对应工具不会下发给模型。
|
接入栈外的 MCP 服务:在设置页添加 `url` / `headers`,或在 `config.yml` 的 `mcp_servers` 追加一项。服务不可达时 core 只在启动日志里告警,不影响 Web 主流程,但对应工具不会下发给模型。
|
||||||
|
|
||||||
|
每个服务可用 `mode` 控制「工具是否下发给模型」:
|
||||||
|
|
||||||
|
| `mode` | 连接/发现 | 进 tools 数组 | 进技能清单 | 谁可以调用 |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| `advertise`(默认) | ✓ | ✓ | ✗ | 模型与技能 |
|
||||||
|
| `skill` | ✓ | ✗ | ✓ | `skill` 工具与 `lab` |
|
||||||
|
| `disable` | ✗ | ✗ | ✗ | 无人 |
|
||||||
|
|
||||||
|
`skill` 用于「能力包在技能后面」的场景:工具照常发现并注册,只是不进模型的 tools 数组,改为以技能形式暴露——`{"list":"all"}` 能看到它,`{"get":"<名>"}` 直接返回 MCP 原始的 `description` + `input_schema`,`{"run":"<名>","args":{…}}` 转发给服务。不用在 `skills/` 里建目录。旧字段 `enable` 已废弃,`mode: silent` 已移除(启动会报错并提示改用 `skill`)。
|
||||||
|
|
||||||
工具发现只在启动时做一次,因此发现失败后会自动按 **2s / 20s / 1min 重试 3 次**(覆盖 compose 并行拉起与宿主机重启后的容器乱序);成功后工具在下一轮请求即可用,三次都失败则需重启 core。三个 MCP 服务都配了 `/health` 健康检查,`docker ps` 可直接看状态。
|
工具发现只在启动时做一次,因此发现失败后会自动按 **2s / 20s / 1min 重试 3 次**(覆盖 compose 并行拉起与宿主机重启后的容器乱序);成功后工具在下一轮请求即可用,三次都失败则需重启 core。三个 MCP 服务都配了 `/health` 健康检查,`docker ps` 可直接看状态。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -186,7 +196,7 @@ mcp_servers:
|
|||||||
| `model_profiles` | prompt + 工具名单组合;模型用 `profile: <名>` 引用 |
|
| `model_profiles` | prompt + 工具名单组合;模型用 `profile: <名>` 引用 |
|
||||||
| `tools_deny` | 全局工具黑名单,默认屏蔽元工具 `lab` |
|
| `tools_deny` | 全局工具黑名单,默认屏蔽元工具 `lab` |
|
||||||
| `auth` | 登录账号、`secret`、有效期;留空则不启用认证 |
|
| `auth` | 登录账号、`secret`、有效期;留空则不启用认证 |
|
||||||
| `mcp_servers` | 外部 MCP 服务:`url`、`headers`、`enable`、`timeout_ms`、工具名单 |
|
| `mcp_servers` | 外部 MCP 服务:`url`、`headers`、`mode`(advertise / skill / disable)、`timeout_ms`、工具名单 |
|
||||||
| `public_link` | 公网临时链接前缀与有效期 |
|
| `public_link` | 公网临时链接前缀与有效期 |
|
||||||
| `agent` | 温度、最大工具迭代、重试、语言、压缩阈值、空闲收口、历史裁剪 |
|
| `agent` | 温度、最大工具迭代、重试、语言、压缩阈值、空闲收口、历史裁剪 |
|
||||||
| `memory` | 日记注入条数、保留期、空闲收口阈值 |
|
| `memory` | 日记注入条数、保留期、空闲收口阈值 |
|
||||||
@@ -253,7 +263,7 @@ platforms:
|
|||||||
| `terminal` | 执行 shell 命令;默认在会话目录,超时可终止 |
|
| `terminal` | 执行 shell 命令;默认在会话目录,超时可终止 |
|
||||||
| `fetch` | 抓取 HTTP/HTTPS 并转 Markdown;带 SSRF 防护与分段续读 |
|
| `fetch` | 抓取 HTTP/HTTPS 并转 Markdown;带 SSRF 防护与分段续读 |
|
||||||
| `mint_public_link` | 为会话内文件签发短期公网链接 |
|
| `mint_public_link` | 为会话内文件签发短期公网链接 |
|
||||||
| `skill` | 技能 `list` / `get` / `run` |
|
| `skill` | 技能:`{"list":"all"}` / `{"get":"<名>"}` / `{"run":"<名>","args":{...}}`(动词作键,三选一) |
|
||||||
| `db` | 操作会话本地 `data.db`:`exec`、`query`、`insert`、`tables`、`schema` |
|
| `db` | 操作会话本地 `data.db`:`exec`、`query`、`insert`、`tables`、`schema` |
|
||||||
| `schedule` | 定时任务 `get` / `list` / `create` / `update` / `delete` |
|
| `schedule` | 定时任务 `get` / `list` / `create` / `update` / `delete` |
|
||||||
| `profile` | 用户画像 `list` / `set` / `add` / `remove` |
|
| `profile` | 用户画像 `list` / `set` / `add` / `remove` |
|
||||||
@@ -271,13 +281,15 @@ platforms:
|
|||||||
```text
|
```text
|
||||||
skills/my-skill/
|
skills/my-skill/
|
||||||
├── SKILL.md # 必需:描述、input_schema、可选 required / visit_url
|
├── SKILL.md # 必需:描述、input_schema、可选 required / visit_url
|
||||||
├── run.py | run.sh # 必需:入口,唯一命令行参数是 JSON 字符串
|
├── run.py | run.sh # 入口,唯一命令行参数是 JSON 字符串
|
||||||
├── requirements.txt # 可选:Python 依赖
|
├── requirements.txt # 可选:Python 依赖
|
||||||
└── install.sh # 可选:系统层安装脚本,镜像构建期执行
|
└── install.sh # 可选:系统层安装脚本,镜像构建期执行
|
||||||
```
|
```
|
||||||
|
|
||||||
- `SKILL.md` 的 `description` 会进入 system prompt,模型启动时就知道有哪些技能。
|
- `SKILL.md` 的 `description` 会进入 system prompt,模型启动时就知道有哪些技能。
|
||||||
- `input_schema.required` 在 `skill op=run` 前校验。
|
- `input_schema.required` 在 `{"run":"<名>","args":{...}}` 前校验。
|
||||||
|
- MCP 工具不用建目录:给该服务配 `mode: skill`,平台会自动把它暴露成技能(`get` 返回 MCP 原始的
|
||||||
|
`input_schema`,`run` 转发),见上文「同栈 MCP 服务」。
|
||||||
- 入口脚本以绝对路径启动;远端执行时 cwd 是会话目录,本地开发时是技能目录。相对路径参数会先按会话目录转成绝对路径。
|
- 入口脚本以绝对路径启动;远端执行时 cwd 是会话目录,本地开发时是技能目录。相对路径参数会先按会话目录转成绝对路径。
|
||||||
- `requirements.txt` 的依赖由 `agent-executor-init` 安装到 `skills/deps`;技能容器通过 `PYTHONPATH` 可见。
|
- `requirements.txt` 的依赖由 `agent-executor-init` 安装到 `skills/deps`;技能容器通过 `PYTHONPATH` 可见。
|
||||||
- `install.sh` 在镜像构建期以 root 执行,用于必须落在系统层的依赖。改完需要重建 executor 镜像。
|
- `install.sh` 在镜像构建期以 root 执行,用于必须落在系统层的依赖。改完需要重建 executor 镜像。
|
||||||
|
|||||||
+16
-3
@@ -158,6 +158,11 @@ POST /api/sessions/:id/messages
|
|||||||
白名单、`tools_deny` 黑名单(**deny 赢**;profile 不配 deny 时继承全局 `tools_deny`)。
|
白名单、`tools_deny` 黑名单(**deny 赢**;profile 不配 deny 时继承全局 `tools_deny`)。
|
||||||
`tools_allow: []` = 零工具(纯文本组合)。过滤只影响"模型看得到什么",名单外工具若真被调用,
|
`tools_allow: []` = 零工具(纯文本组合)。过滤只影响"模型看得到什么",名单外工具若真被调用,
|
||||||
`executeTool` 仍会执行(不误杀)。
|
`executeTool` 仍会执行(不误杀)。
|
||||||
|
- MCP 服务按 `mcp_servers[].mode` 参与:`advertise`(默认)进 `toolDefs` 下发;`skill` 只进
|
||||||
|
`toolIndex`(`mcp.hasTool` 为真,`lab` 可调),且由 `skills.js` 自动
|
||||||
|
包装成技能(`mcp.skillTools()` / `getSkillTool()`,get 返回注册表里的原始 inputSchema);
|
||||||
|
`disable` 连 `tools/list` 都不发。旧字段 `enable` 已废弃,`mode: silent` 已移除,
|
||||||
|
出现即报配置错(不静默忽略)。
|
||||||
- `executeTool(baseCtx, name, args)`:先查 `HANDLERS` 表,未命中再交给 MCP 注册表。
|
- `executeTool(baseCtx, name, args)`:先查 `HANDLERS` 表,未命中再交给 MCP 注册表。
|
||||||
`ctx = {sessionId, taskDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回
|
`ctx = {sessionId, taskDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回
|
||||||
`{text, image_rel}`(由 engine 转成 `image_ref` 块)。
|
`{text, image_rel}`(由 engine 转成 `image_ref` 块)。
|
||||||
@@ -167,9 +172,17 @@ POST /api/sessions/:id/messages
|
|||||||
`source_path`,且只限同一用户的会话。写侧显式拒绝——否则会造出字面 `@task-x` 目录。
|
`source_path`,且只限同一用户的会话。写侧显式拒绝——否则会造出字面 `@task-x` 目录。
|
||||||
- `checkToolArgs` + `unwrapToolArgs`:前者做结构性预检并生成 `errAck`,后者按 schema 逐层剥掉
|
- `checkToolArgs` + `unwrapToolArgs`:前者做结构性预检并生成 `errAck`,后者按 schema 逐层剥掉
|
||||||
弱模型多包的信封。两者都是纯函数并已导出,便于回归验证。
|
弱模型多包的信封。两者都是纯函数并已导出,便于回归验证。
|
||||||
- 技能(`tools/skills.js`):`SKILL.md` front matter 提供 `description`/`input_schema`;
|
- 技能(`tools/skills.js`):`SKILL.md` front matter 提供 `description`/`input_schema`。
|
||||||
`input_schema.required` 在 `run` 前校验;相对路径参数按会话目录转绝对路径;入口一律用绝对路径
|
工具参数是「动词作键」:`{"list":"all"}` / `{"get":"<名>"}` / `{"run":"<名>","args":{...}}`,
|
||||||
(远端 cwd 是会话目录)。配了 executor 就走 `remote-exec`,否则本地 `spawn`。
|
三者恰好给一个(无法用 `required` 表达,校验在 `toolSkill` 里做)。`input_schema.required` 在
|
||||||
|
`run` 前校验;相对路径参数按会话目录转绝对路径;入口一律用绝对路径(远端 cwd 是会话目录)。
|
||||||
|
配了 executor 就走 `remote-exec`,否则本地 `spawn`。旧形状 `{op, name, input_args}` 仅由
|
||||||
|
`toolSkill` 兜底翻译(存量技能文档里还写着它),不再对外文档化。
|
||||||
|
模型可见的技能清单是 `listCallableSkills`(目录技能 + `mode=skill` 的 MCP 工具,同名时目录胜出);
|
||||||
|
设置页的技能 API 仍只用 `listSkills`(按目录增删改),两者不要混用。
|
||||||
|
mode=skill 的 MCP 技能在 `runSkill` 里位于 `absolutizeArgs` **之前**:直接 `mcp.callTool` 转发
|
||||||
|
(不落沙箱,也不需要密钥),因此 URL 与含 `/` 的 prompt 不会被当路径改写;同样不跑
|
||||||
|
`input_schema.required` 校验(参数与 MCP 工具自己的 `op` 相关,交给服务管)。
|
||||||
- MCP(`mcp.js`):启动时 `initialize` → `notifications/initialized` → `tools/list`;与内置或已有
|
- MCP(`mcp.js`):启动时 `initialize` → `notifications/initialized` → `tools/list`;与内置或已有
|
||||||
MCP 工具重名时加 `<服务名>__` 前缀;请求随带 `X-Session-Dir`、`X-Public-Base`;
|
MCP 工具重名时加 `<服务名>__` 前缀;请求随带 `X-Session-Dir`、`X-Public-Base`;
|
||||||
`content` 里的 `ui_card` 块不进模型上下文,转成 SSE `ui_card` 事件。
|
`content` 里的 `ui_card` 块不进模型上下文,转成 SSE `ui_card` 事件。
|
||||||
|
|||||||
@@ -78,7 +78,9 @@ auth: # users 留空 = 不启用登
|
|||||||
role: admin # admin=管理员(全部设置 + 用户管理);user 或缺省=普通用户(仅账户页)
|
role: admin # admin=管理员(全部设置 + 用户管理);user 或缺省=普通用户(仅账户页)
|
||||||
# model: qwen-tp/qwen3.8-flash # 选填:该用户新建会话时锁定的模型(内部键「平台名/模型id」)
|
# model: qwen-tp/qwen3.8-flash # 选填:该用户新建会话时锁定的模型(内部键「平台名/模型id」)
|
||||||
|
|
||||||
# MCP 服务列表(仓库自带的 mcp/ 三个服务,或栈外服务):每项 {name?, url, headers?, enable?(默认 true), timeout_ms?, tools_allow?, tools_deny?}。
|
# MCP 服务列表(仓库自带的 mcp/ 三个服务,或栈外服务):每项 {name?, url, headers?, mode?(默认 advertise), timeout_ms?, tools_allow?, tools_deny?}。
|
||||||
|
# mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始 input_schema,run 转发);
|
||||||
|
# disable=不连接、不发现。旧字段 enable 已废弃;mode: silent 已移除(改用 skill),写进配置会启动报错。
|
||||||
mcp_servers: []
|
mcp_servers: []
|
||||||
|
|
||||||
public_link:
|
public_link:
|
||||||
|
|||||||
+15
-4
@@ -121,7 +121,9 @@ const DEFAULTS = {
|
|||||||
},
|
},
|
||||||
// 登录认证:{users:[{user,password}], secret?, ttl_ms?};null / users 空 = 不启用。
|
// 登录认证:{users:[{user,password}], secret?, ttl_ms?};null / users 空 = 不启用。
|
||||||
auth: null,
|
auth: null,
|
||||||
// 外部 MCP 服务列表(无默认值):{name?, url, headers?, enable?(默认 true), timeout_ms?(默认 60s)}。
|
// 外部 MCP 服务列表(无默认值):{name?, url, headers?, mode?(默认 advertise), timeout_ms?(默认 60s)}。
|
||||||
|
// mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始
|
||||||
|
// input_schema,run 直接转发);disable=不加载。
|
||||||
mcp_servers: [],
|
mcp_servers: [],
|
||||||
// 公网临时链接:base_url 非空才启用 mint_public_link;容器配 VIRTUAL_HOST 时以它为准。
|
// 公网临时链接:base_url 非空才启用 mint_public_link;容器配 VIRTUAL_HOST 时以它为准。
|
||||||
public_link: { base_url: '', ttl_ms: 1800000 },
|
public_link: { base_url: '', ttl_ms: 1800000 },
|
||||||
@@ -340,7 +342,7 @@ function parseAndValidate(rawText, configPath) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization);
|
// MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization);
|
||||||
// enable 缺省 true,显式 false 时启动不加载该服务的工具(见 mcp.init);
|
// mode 缺省 advertise,见下方三态校验(工具是否下发 / 是否加载,见 mcp.init);
|
||||||
// timeout_ms 为该服务单次 tools/call 的最大等待,缺省 60s(长任务服务如视频生成可调大)。
|
// timeout_ms 为该服务单次 tools/call 的最大等待,缺省 60s(长任务服务如视频生成可调大)。
|
||||||
if (!Array.isArray(cfg.mcp_servers)) cfg.mcp_servers = [];
|
if (!Array.isArray(cfg.mcp_servers)) cfg.mcp_servers = [];
|
||||||
for (const s of cfg.mcp_servers) {
|
for (const s of cfg.mcp_servers) {
|
||||||
@@ -348,8 +350,17 @@ function parseAndValidate(rawText, configPath) {
|
|||||||
if (!s.name) {
|
if (!s.name) {
|
||||||
try { s.name = String(new URL(s.url).hostname.split('.')[0]); } catch (_) { s.name = 'mcp'; }
|
try { s.name = String(new URL(s.url).hostname.split('.')[0]); } catch (_) { s.name = 'mcp'; }
|
||||||
}
|
}
|
||||||
// 容错 YAML 里写成字符串 "false" / "off" 的情况,统一归一为布尔
|
// 旧字段 enable 已废弃且不静默忽略:未知键会被无声丢弃,那样「以为关了」的服务会照常连上、
|
||||||
s.enable = !(s.enable === false || s.enable === 'false' || s.enable === 'off' || s.enable === 0);
|
// 照常烧额度。宁可启动即报错,把迁移动作逼到明面上。
|
||||||
|
if (s.enable !== undefined) {
|
||||||
|
throw new Error('mcp_servers 的 enable 已废弃,请改用 mode: advertise | skill | disable');
|
||||||
|
}
|
||||||
|
// 三态:advertise(默认,工具下发给模型)/ skill(不下发,改为以技能形式暴露)/
|
||||||
|
// disable(不连接、不发现)。拼错要报错而不是回落默认,否则又是一次静默降级。
|
||||||
|
const mode = String(s.mode == null ? '' : s.mode).trim().toLowerCase();
|
||||||
|
if (!mode) s.mode = 'advertise';
|
||||||
|
else if (mode === 'advertise' || mode === 'skill' || mode === 'disable') s.mode = mode;
|
||||||
|
else throw new Error('mcp_servers 的 mode 只能是 advertise / skill / disable,收到:' + mode);
|
||||||
const headers = {};
|
const headers = {};
|
||||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = String(v);
|
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = String(v);
|
||||||
s.headers = headers;
|
s.headers = headers;
|
||||||
|
|||||||
+37
-13
@@ -1,8 +1,10 @@
|
|||||||
// 极简 MCP 客户端(Streamable HTTP:JSON-RPC over HTTP,无状态,响应可能是 SSE 帧包裹的 JSON)。
|
// 极简 MCP 客户端(Streamable HTTP:JSON-RPC over HTTP,无状态,响应可能是 SSE 帧包裹的 JSON)。
|
||||||
// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?, enable?, timeout_ms?, tools_allow?, tools_deny?}。
|
// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?, mode?, timeout_ms?, tools_allow?, tools_deny?}。
|
||||||
// 启动时 init() 对每个服务调 tools/list 发现工具(enable: false 的服务跳过加载;配了 tools_allow/tools_deny
|
// 启动时 init() 对每个服务调 tools/list 发现工具(mode: disable 的服务跳过加载;配了 tools_allow/tools_deny
|
||||||
// 时按名单过滤),发现失败的服务按 2s / 20s / 1min 再试 3 次(容器并行启动/重启后的乱序兜底),转成 OpenAI function 格式,
|
// 时按名单过滤),发现失败的服务按 2s / 20s / 1min 再试 3 次(容器并行启动/重启后的乱序兜底),转成 OpenAI function 格式,
|
||||||
// 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型;
|
// 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型;
|
||||||
|
// mode: skill 的服务工具照常注册进 toolIndex(lab 可调),不追加进
|
||||||
|
// toolDefs,而是由 tools/skills.js 自动包装成技能(get 返回注册表里的原始 input_schema)。
|
||||||
// 工具调用经 tools/call 转发给对应服务。
|
// 工具调用经 tools/call 转发给对应服务。
|
||||||
// 与内置工具严格分离:本模块不碰内置定义;MCP 工具默认沿用原始名,
|
// 与内置工具严格分离:本模块不碰内置定义;MCP 工具默认沿用原始名,
|
||||||
// 仅当与内置工具或其他 MCP 工具重名时加「服务名__」前缀。
|
// 仅当与内置工具或其他 MCP 工具重名时加「服务名__」前缀。
|
||||||
@@ -14,7 +16,7 @@ const log = require('./log');
|
|||||||
const CALL_TIMEOUT_MS = 60000;
|
const CALL_TIMEOUT_MS = 60000;
|
||||||
|
|
||||||
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
||||||
const toolIndex = new Map(); // 发送名 -> { server, tool }(服务配置 + 原始工具名)
|
const toolIndex = new Map(); // 发送名 -> { server, tool, def }(服务配置 + 原始工具名 + 原始契约)
|
||||||
let builtinNames = new Set();
|
let builtinNames = new Set();
|
||||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
|
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
|
||||||
|
|
||||||
@@ -141,22 +143,25 @@ async function loadServer(s) {
|
|||||||
let tools = all;
|
let tools = all;
|
||||||
if (Array.isArray(s.tools_allow)) tools = tools.filter(t => s.tools_allow.includes(t && t.name));
|
if (Array.isArray(s.tools_allow)) tools = tools.filter(t => s.tools_allow.includes(t && t.name));
|
||||||
if (Array.isArray(s.tools_deny)) tools = tools.filter(t => !s.tools_deny.includes(t && t.name));
|
if (Array.isArray(s.tools_deny)) tools = tools.filter(t => !s.tools_deny.includes(t && t.name));
|
||||||
|
let hidden = 0;
|
||||||
for (const t of tools) {
|
for (const t of tools) {
|
||||||
if (!t || !t.name) continue;
|
if (!t || !t.name) continue;
|
||||||
let name = t.name;
|
let name = t.name;
|
||||||
if (builtinNames.has(name) || toolIndex.has(name)) name = s.name + '__' + name;
|
if (builtinNames.has(name) || toolIndex.has(name)) name = s.name + '__' + name;
|
||||||
toolIndex.set(name, { server: s, tool: t.name });
|
// 先进索引:mode=skill 的工具同样要能被 lab 调到,只是不下发。
|
||||||
toolDefs.push({
|
// 索引里连规范化后的契约一起留住,技能 get 时原样返回(单一份真相,不会跟 MCP 实现漂移)。
|
||||||
type: 'function',
|
const def = {
|
||||||
function: {
|
|
||||||
name,
|
name,
|
||||||
description: t.description || t.title || '',
|
description: t.description || t.title || '',
|
||||||
parameters: t.inputSchema || t.input_schema || { type: 'object', properties: {} },
|
parameters: t.inputSchema || t.input_schema || { type: 'object', properties: {} },
|
||||||
},
|
};
|
||||||
});
|
toolIndex.set(name, { server: s, tool: t.name, def });
|
||||||
|
if (s.mode === 'skill') { hidden++; continue; }
|
||||||
|
toolDefs.push({ type: 'function', function: def });
|
||||||
}
|
}
|
||||||
let msg = s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : '');
|
let msg = s.name + ': 发现 ' + tools.length + ' 个工具' + (s.sessionId ? ' (session)' : '');
|
||||||
if (tools.length !== all.length) msg += '(服务端共 ' + all.length + ' 个,已按 tools_allow/tools_deny 过滤)';
|
if (tools.length !== all.length) msg += '(服务端共 ' + all.length + ' 个,已按 tools_allow/tools_deny 过滤)';
|
||||||
|
if (hidden) msg += '(mode=skill:' + hidden + ' 个以技能形式暴露,不下发给模型)';
|
||||||
log.info('mcp', msg);
|
log.info('mcp', msg);
|
||||||
// 配了名单却一个都没过滤中,十有八九是名单里的名字跟 tools/list 返回不一致;
|
// 配了名单却一个都没过滤中,十有八九是名单里的名字跟 tools/list 返回不一致;
|
||||||
// 不 warn 的话排查时只能对着「发现 0 个工具」干瞪眼。
|
// 不 warn 的话排查时只能对着「发现 0 个工具」干瞪眼。
|
||||||
@@ -213,9 +218,9 @@ async function init(cfg) {
|
|||||||
const servers = (cfg && cfg.mcp_servers) || [];
|
const servers = (cfg && cfg.mcp_servers) || [];
|
||||||
const failed = [];
|
const failed = [];
|
||||||
for (const s of servers) {
|
for (const s of servers) {
|
||||||
// enable: false 时启动不加载该服务(不建工具表;配置保留,改回 true 重启后恢复)
|
// mode: disable 时启动不加载该服务(不建工具表;配置保留,改回 advertise 重启后恢复)
|
||||||
if (s.enable === false) {
|
if (s.mode === 'disable') {
|
||||||
log.info('mcp', s.name + ': enable=false,跳过工具加载');
|
log.info('mcp', s.name + ': mode=disable,跳过工具加载');
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if (!(await loadServer(s))) failed.push(s);
|
if (!(await loadServer(s))) failed.push(s);
|
||||||
@@ -228,6 +233,25 @@ function toolDefinitions() { return toolDefs; }
|
|||||||
|
|
||||||
function hasTool(name) { return toolIndex.has(name); }
|
function hasTool(name) { return toolIndex.has(name); }
|
||||||
|
|
||||||
|
// mode=skill 的工具:不进 tools 数组,由 skills.js 包装成技能(list/get/run)。
|
||||||
|
// 名字一律用最终可调用名(含重名时的 server__ 前缀),否则模型拿到的是调不通的名字。
|
||||||
|
function skillTools() {
|
||||||
|
const out = [];
|
||||||
|
for (const [name, e] of toolIndex) {
|
||||||
|
if (!e || !e.server || e.server.mode !== 'skill' || !e.def) continue;
|
||||||
|
out.push({ name, description: e.def.description, parameters: e.def.parameters, server: e.server.name, tool: e.tool });
|
||||||
|
}
|
||||||
|
return out;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 只认 mode=skill:advertise 的工具已经直接下发给模型,不必再绕技能这一层。
|
||||||
|
function getSkillTool(name) {
|
||||||
|
const key = String(name == null ? '' : name).trim();
|
||||||
|
const e = toolIndex.get(key);
|
||||||
|
if (!e || !e.server || e.server.mode !== 'skill' || !e.def) return null;
|
||||||
|
return { name: key, description: e.def.description, parameters: e.def.parameters, server: e.server.name, tool: e.tool };
|
||||||
|
}
|
||||||
|
|
||||||
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
|
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
|
||||||
// 超时取该服务的 timeout_ms(config.js 里归一化 + 夹过区间);这里再兜一次底,
|
// 超时取该服务的 timeout_ms(config.js 里归一化 + 夹过区间);这里再兜一次底,
|
||||||
// 兼容没走配置加载的调用方(如测试里手搓的 cfg)。
|
// 兼容没走配置加载的调用方(如测试里手搓的 cfg)。
|
||||||
@@ -271,4 +295,4 @@ async function notifyTool(name, args, timeoutMs, extraHeaders) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
module.exports = { init, toolDefinitions, hasTool, callTool, notifyTool };
|
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool };
|
||||||
|
|||||||
@@ -1098,6 +1098,8 @@ label.icon-btn { cursor: pointer; }
|
|||||||
.modal .mpe-num { display: flex; align-items: center; gap: 5px; flex: none; font-size: 12.5px; color: var(--gray); }
|
.modal .mpe-num { display: flex; align-items: center; gap: 5px; flex: none; font-size: 12.5px; color: var(--gray); }
|
||||||
.modal .mpe-num input { width: 92px; padding: 5px 8px; margin: 0; font-size: 13px; border: 1px solid #dde1ea; border-radius: 8px; background: #fff; color: var(--ink); }
|
.modal .mpe-num input { width: 92px; padding: 5px 8px; margin: 0; font-size: 13px; border: 1px solid #dde1ea; border-radius: 8px; background: #fff; color: var(--ink); }
|
||||||
.modal .mpe-num input:focus { border-color: var(--active); }
|
.modal .mpe-num input:focus { border-color: var(--active); }
|
||||||
|
/* MCP 的 mode 三态下拉:独立成行(弹窗内容宽仅 ~320px,与超时框同排会撑破),内层 select 用 .modal select 的全宽样式 */
|
||||||
|
.modal .mpe-field { display: block; margin-top: 14px; font-size: 12.5px; color: var(--gray); }
|
||||||
.modal .mpe-ck { display: flex; align-items: center; gap: 5px; font-size: 12.5px; color: var(--gray); }
|
.modal .mpe-ck { display: flex; align-items: center; gap: 5px; font-size: 12.5px; color: var(--gray); }
|
||||||
.modal .mpe-ck input { width: 15px; height: 15px; padding: 0; margin: 0; border: none; background: none; accent-color: var(--active); cursor: pointer; }
|
.modal .mpe-ck input { width: 15px; height: 15px; padding: 0; margin: 0; border: none; background: none; accent-color: var(--active); cursor: pointer; }
|
||||||
.modal .mpe-del { flex: none; border: none; background: none; margin: 0; padding: 2px 7px; cursor: pointer; color: var(--gray-light); font-size: 18px; line-height: 1.2; }
|
.modal .mpe-del { flex: none; border: none; background: none; margin: 0; padding: 2px 7px; cursor: pointer; color: var(--gray-light); font-size: 18px; line-height: 1.2; }
|
||||||
|
|||||||
@@ -335,8 +335,14 @@
|
|||||||
</div>
|
</div>
|
||||||
<div class="mpe-cks" style="margin-top:14px">
|
<div class="mpe-cks" style="margin-top:14px">
|
||||||
<label class="mpe-num">单次调用超时<input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="默认 60000">ms</label>
|
<label class="mpe-num">单次调用超时<input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="默认 60000">ms</label>
|
||||||
<label class="mpe-ck"><input type="checkbox" id="mce-enable" checked>启用</label>
|
|
||||||
</div>
|
</div>
|
||||||
|
<label class="mpe-field">工具暴露
|
||||||
|
<select id="mce-mode">
|
||||||
|
<option value="advertise">advertise(下发给模型)</option>
|
||||||
|
<option value="skill">skill(以技能形式暴露)</option>
|
||||||
|
<option value="disable">disable(不加载)</option>
|
||||||
|
</select>
|
||||||
|
</label>
|
||||||
<div class="btn-row mpe-foot">
|
<div class="btn-row mpe-foot">
|
||||||
<button class="ghost-btn danger hidden" id="mce-del-btn" onclick="mcpUI.del()">删除服务</button>
|
<button class="ghost-btn danger hidden" id="mce-del-btn" onclick="mcpUI.del()">删除服务</button>
|
||||||
<button class="primary-btn" onclick="mcpUI.save()">保存</button>
|
<button class="primary-btn" onclick="mcpUI.save()">保存</button>
|
||||||
|
|||||||
@@ -182,6 +182,10 @@ async function openFilePreview(name, sizeText) {
|
|||||||
try {
|
try {
|
||||||
if (!desk) { await pvRenderLegacy(name, r, my); return; }
|
if (!desk) { await pvRenderLegacy(name, r, my); return; }
|
||||||
let node = null, tb = { refresh: false, popup: false };
|
let node = null, tb = { refresh: false, popup: false };
|
||||||
|
// blob URL 不能在此登记到 pvState:show() 内部先调 pvClearBody(),那会把"刚建的"这个也一并撤销,
|
||||||
|
// 于是 img/iframe 真正去取时 URL 已失效(Chrome 报 net::ERR_FILE_NOT_FOUND;Safari 撤回更宽松才没暴露)。
|
||||||
|
// 统一等 show() 之后登记,陈旧序号则立即撤销防泄漏。
|
||||||
|
let newBlobUrl = null;
|
||||||
if (kind === 'html') {
|
if (kind === 'html') {
|
||||||
const fr = document.createElement('iframe');
|
const fr = document.createElement('iframe');
|
||||||
fr.className = 'pv-frame';
|
fr.className = 'pv-frame';
|
||||||
@@ -190,13 +194,13 @@ async function openFilePreview(name, sizeText) {
|
|||||||
node = fr;
|
node = fr;
|
||||||
} else if (kind === 'pdf') {
|
} else if (kind === 'pdf') {
|
||||||
const u = URL.createObjectURL(await r.blob());
|
const u = URL.createObjectURL(await r.blob());
|
||||||
pvState.blobUrl = u; pvState.url = u;
|
newBlobUrl = u;
|
||||||
const fr = document.createElement('iframe');
|
const fr = document.createElement('iframe');
|
||||||
fr.className = 'pv-frame'; fr.title = String(name); fr.src = u; // 不加 sandbox:内建查看器插件需要 unrestricted 帧
|
fr.className = 'pv-frame'; fr.title = String(name); fr.src = u; // 不加 sandbox:内建查看器插件需要 unrestricted 帧
|
||||||
node = fr; tb = { refresh: false, popup: true };
|
node = fr; tb = { refresh: false, popup: true };
|
||||||
} else if (kind === 'img') {
|
} else if (kind === 'img') {
|
||||||
const u = URL.createObjectURL(await r.blob());
|
const u = URL.createObjectURL(await r.blob());
|
||||||
pvState.blobUrl = u; pvState.url = u;
|
newBlobUrl = u;
|
||||||
const im = document.createElement('img');
|
const im = document.createElement('img');
|
||||||
im.className = 'pv-img'; im.src = u; im.alt = String(name);
|
im.className = 'pv-img'; im.src = u; im.alt = String(name);
|
||||||
im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop()));
|
im.addEventListener('click', () => openImageViewer(u, String(name).split('/').pop()));
|
||||||
@@ -206,6 +210,10 @@ async function openFilePreview(name, sizeText) {
|
|||||||
if (node.__tb) { tb = node.__tb; delete node.__tb; }
|
if (node.__tb) { tb = node.__tb; delete node.__tb; }
|
||||||
}
|
}
|
||||||
show(node, tb);
|
show(node, tb);
|
||||||
|
if (newBlobUrl) {
|
||||||
|
if (my === pvSeq) pvState.blobUrl = pvState.url = newBlobUrl;
|
||||||
|
else { try { URL.revokeObjectURL(newBlobUrl); } catch (_) {} }
|
||||||
|
}
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
if (my === pvSeq) desk ? show(pvInfoNode(name, sizeText, '预览失败:' + e.message), { refresh: false, popup: false }) : toast('预览失败:' + e.message);
|
if (my === pvSeq) desk ? show(pvInfoNode(name, sizeText, '预览失败:' + e.message), { refresh: false, popup: false }) : toast('预览失败:' + e.message);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -840,7 +840,7 @@
|
|||||||
'<div class="session-main">' +
|
'<div class="session-main">' +
|
||||||
'<div class="session-name">' + esc(s.name) +
|
'<div class="session-name">' + esc(s.name) +
|
||||||
(s.has_md ? '' : ' <span class="badge cancelled">缺 SKILL.md</span>') +
|
(s.has_md ? '' : ' <span class="badge cancelled">缺 SKILL.md</span>') +
|
||||||
(s.entry ? ' <span class="badge active">' + s.entry + ' 入口</span>' : '') +
|
(s.entry ? ' <span class="badge active">' + (s.entry === 'mcp' ? 'mcp 后端' : s.entry + ' 入口') + '</span>' : '') +
|
||||||
'</div>' +
|
'</div>' +
|
||||||
'<div class="skill-desc">' + esc(s.description || '') + '</div>' +
|
'<div class="skill-desc">' + esc(s.description || '') + '</div>' +
|
||||||
'<div class="session-meta"><span>' + s.file_count + ' 个文件</span>' +
|
'<div class="session-meta"><span>' + s.file_count + ' 个文件</span>' +
|
||||||
@@ -1416,11 +1416,13 @@
|
|||||||
} catch (e) { toast('删除失败:' + e.message); }
|
} catch (e) { toast('删除失败:' + e.message); }
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- 页:MCP 服务(增/改/删;name / url / 多 headers / timeout_ms / enable) ----------
|
// ---------- 页:MCP 服务(增/改/删;name / url / 多 headers / timeout_ms / mode) ----------
|
||||||
// 与模型池共用 PATCH /api/config 的细粒度 edit 接口:
|
// 与模型池共用 PATCH /api/config 的细粒度 edit 接口:
|
||||||
// · 新增 = append 到 mcp_servers;
|
// · 新增 = append 到 mcp_servers;
|
||||||
// · 删 = delete mcp_servers[pi];
|
// · 删 = delete mcp_servers[pi];
|
||||||
// · 改 = setIn mcp_servers[pi].(name|url|timeout_ms|enable);headers 是普通键值对象,整体 setIn 一次到位。
|
// · 改 = setIn mcp_servers[pi].(name|url|timeout_ms|mode);headers 是普通键值对象,整体 setIn 一次到位。
|
||||||
|
// mode 三态:advertise(默认,工具下发给模型) / skill(不下发,以技能形式暴露) / disable(不加载):
|
||||||
|
// 默认值不写进文件——选 advertise 时删键,回落到 config.js 的缺省。
|
||||||
// 运行配置(cg.effective.mcp_servers)即文件刚解析后的视图,按 pi 直接定位;重启后才会重新发现工具。
|
// 运行配置(cg.effective.mcp_servers)即文件刚解析后的视图,按 pi 直接定位;重启后才会重新发现工具。
|
||||||
let mcpEdit = null; // 工作态:{ idx, headers:[{key, value, masked}] };idx=-1 为新增
|
let mcpEdit = null; // 工作态:{ idx, headers:[{key, value, masked}] };idx=-1 为新增
|
||||||
const MCP_HEADER_MASK = '*****'; // 与后端 routes/config.js 的掩码保持一致
|
const MCP_HEADER_MASK = '*****'; // 与后端 routes/config.js 的掩码保持一致
|
||||||
@@ -1449,16 +1451,20 @@
|
|||||||
? '<div class="restart-bar"><span>配置已写入,重启后生效</span><button class="primary-btn" onclick="sUI.restartNow()">重启服务</button></div>'
|
? '<div class="restart-bar"><span>配置已写入,重启后生效</span><button class="primary-btn" onclick="sUI.restartNow()">重启服务</button></div>'
|
||||||
: '';
|
: '';
|
||||||
box.innerHTML = banner + SET.cfgMcp.map(mcpCardHtml).join('') +
|
box.innerHTML = banner + SET.cfgMcp.map(mcpCardHtml).join('') +
|
||||||
'<div class="empty-tip">点卡片编辑 MCP 服务,启用后启动时发现其工具并追加到内置工具之后。</div>';
|
'<div class="empty-tip">点卡片编辑 MCP 服务。advertise 的工具启动时发现并追加到内置工具之后;skill 不下发,改为以技能形式暴露(skill 工具里 get 拿到原始 input_schema)。</div>';
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
const b = $('mcp-list');
|
const b = $('mcp-list');
|
||||||
if (b && (!ctx || ctx())) b.innerHTML = '<div class="empty-tip">加载失败:' + esc(e.message) + '</div>';
|
if (b && (!ctx || ctx())) b.innerHTML = '<div class="empty-tip">加载失败:' + esc(e.message) + '</div>';
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
// MCP 卡:头部 = 名称 + url + enable 状态;体内 = headers 键值列表。整卡点击进入编辑。
|
// MCP 卡:头部 = 名称 + url + mode 状态;体内 = headers 键值列表。整卡点击进入编辑。
|
||||||
function mcpCardHtml(s, pi) {
|
function mcpCardHtml(s, pi) {
|
||||||
const off = s.enable === false;
|
const mode = s.mode || 'advertise';
|
||||||
const stateHtml = off ? '<span class="model-card-state off">已禁用</span>' : '<span class="model-card-state idle">启用</span>';
|
const stateHtml = mode === 'disable'
|
||||||
|
? '<span class="model-card-state off">已禁用</span>'
|
||||||
|
: mode === 'skill'
|
||||||
|
? '<span class="model-card-state idle">以技能暴露</span>'
|
||||||
|
: '<span class="model-card-state idle">启用</span>';
|
||||||
const entries = Object.entries(s.headers || {});
|
const entries = Object.entries(s.headers || {});
|
||||||
// header 值等同密码对待:后端 effective 已脱敏为固定短掩码,这里透传展示;若收到未脱敏原文也一律替换,不外显
|
// header 值等同密码对待:后端 effective 已脱敏为固定短掩码,这里透传展示;若收到未脱敏原文也一律替换,不外显
|
||||||
const maskVal = (v) => { const str = String(v == null ? '' : v); if (!str) return '--'; return str.includes('*') ? esc(str) : MCP_HEADER_MASK; };
|
const maskVal = (v) => { const str = String(v == null ? '' : v); if (!str) return '--'; return str.includes('*') ? esc(str) : MCP_HEADER_MASK; };
|
||||||
@@ -1490,7 +1496,7 @@
|
|||||||
$('mce-url').value = add ? '' : (s.url || '');
|
$('mce-url').value = add ? '' : (s.url || '');
|
||||||
// 运行配置里的 timeout_ms 已被 config.js 填上缺省值,所以这里显示的就是当前生效值(没配则为 60000)。
|
// 运行配置里的 timeout_ms 已被 config.js 填上缺省值,所以这里显示的就是当前生效值(没配则为 60000)。
|
||||||
$('mce-timeout').value = add || s.timeout_ms == null ? '' : String(s.timeout_ms);
|
$('mce-timeout').value = add || s.timeout_ms == null ? '' : String(s.timeout_ms);
|
||||||
$('mce-enable').checked = add ? true : (s.enable !== false);
|
$('mce-mode').value = add ? 'advertise' : (s.mode || 'advertise');
|
||||||
$('mce-del-btn').classList.toggle('hidden', add);
|
$('mce-del-btn').classList.toggle('hidden', add);
|
||||||
renderMcpHeaders();
|
renderMcpHeaders();
|
||||||
$('mcp-edit-modal').classList.remove('hidden');
|
$('mcp-edit-modal').classList.remove('hidden');
|
||||||
@@ -1530,7 +1536,7 @@
|
|||||||
const edits = [];
|
const edits = [];
|
||||||
const name = $('mce-name').value.trim();
|
const name = $('mce-name').value.trim();
|
||||||
const url = $('mce-url').value.trim();
|
const url = $('mce-url').value.trim();
|
||||||
const enable = $('mce-enable').checked;
|
const mode = $('mce-mode').value;
|
||||||
// 超时:留空 = 不写入该项(沿用缺省 60s)。区间在 UI 先把一道,
|
// 超时:留空 = 不写入该项(沿用缺省 60s)。区间在 UI 先把一道,
|
||||||
// 比写进 YAML 再被 config.js 静默夹掉好排查(两边上限保持 600000 一致)。
|
// 比写进 YAML 再被 config.js 静默夹掉好排查(两边上限保持 600000 一致)。
|
||||||
const tmoRaw = $('mce-timeout').value.trim();
|
const tmoRaw = $('mce-timeout').value.trim();
|
||||||
@@ -1545,7 +1551,7 @@
|
|||||||
if (!url) throw new Error('请填写 url');
|
if (!url) throw new Error('请填写 url');
|
||||||
const obj = { url };
|
const obj = { url };
|
||||||
if (name) obj.name = name;
|
if (name) obj.name = name;
|
||||||
if (!enable) obj.enable = false;
|
if (mode !== 'advertise') obj.mode = mode;
|
||||||
if (tmo != null) obj.timeout_ms = tmo;
|
if (tmo != null) obj.timeout_ms = tmo;
|
||||||
const headers = {};
|
const headers = {};
|
||||||
for (const r of mcpEdit.headers) {
|
for (const r of mcpEdit.headers) {
|
||||||
@@ -1560,7 +1566,10 @@
|
|||||||
if (!url) throw new Error('请填写 url');
|
if (!url) throw new Error('请填写 url');
|
||||||
if (name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
if (name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
||||||
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
||||||
if (!!cur.enable !== enable) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'enable'], value: enable });
|
// mode:默认值不写进文件(选 advertise 就删键)
|
||||||
|
if ((cur.mode || 'advertise') !== mode) edits.push(mode === 'advertise'
|
||||||
|
? { path: ['mcp_servers', mcpEdit.idx, 'mode'], op: 'delete' }
|
||||||
|
: { path: ['mcp_servers', mcpEdit.idx, 'mode'], value: mode });
|
||||||
// 超时:清空 = 删掉该键(回落到缺省);后端 deleteIn 支持嵌套键,无键时是空操作。
|
// 超时:清空 = 删掉该键(回落到缺省);后端 deleteIn 支持嵌套键,无键时是空操作。
|
||||||
const curTmo = cur.timeout_ms == null ? null : Number(cur.timeout_ms);
|
const curTmo = cur.timeout_ms == null ? null : Number(cur.timeout_ms);
|
||||||
if (tmo !== curTmo) edits.push(tmo == null
|
if (tmo !== curTmo) edits.push(tmo == null
|
||||||
|
|||||||
@@ -10,7 +10,7 @@ const multer = require('multer');
|
|||||||
const YAML = require('yaml');
|
const YAML = require('yaml');
|
||||||
const engine = require('../engine');
|
const engine = require('../engine');
|
||||||
const llm = require('../llm');
|
const llm = require('../llm');
|
||||||
const { extractDescription, listSkills, formatSkillListForPrompt } = require('../tools/skills');
|
const { extractDescription, listCallableSkills, formatSkillListForPrompt } = require('../tools/skills');
|
||||||
const { sanitizeName } = require('./files');
|
const { sanitizeName } = require('./files');
|
||||||
|
|
||||||
const router = express.Router();
|
const router = express.Router();
|
||||||
@@ -77,9 +77,9 @@ function absInSkill(dir, rel) {
|
|||||||
// 技能发生任何变更(创建/重命名/删除/文件增删改都经过本模块)后,
|
// 技能发生任何变更(创建/重命名/删除/文件增删改都经过本模块)后,
|
||||||
// 重建 system prompt 的 “可用技能” 段落(llm.setSkillListText):
|
// 重建 system prompt 的 “可用技能” 段落(llm.setSkillListText):
|
||||||
// 模型立即感知新技能或改名,无需重启。fire-and-forget:扫描失败不影响 API 响应,
|
// 模型立即感知新技能或改名,无需重启。fire-and-forget:扫描失败不影响 API 响应,
|
||||||
// skill op=list 仍是实时兑底。
|
// skill {"list":"all"} 仍是实时兜底。
|
||||||
function refreshSkillPrompt() {
|
function refreshSkillPrompt() {
|
||||||
listSkills({ cfg: engine.getConfig() })
|
listCallableSkills({ cfg: engine.getConfig() })
|
||||||
.then(list => llm.setSkillListText(formatSkillListForPrompt(list)))
|
.then(list => llm.setSkillListText(formatSkillListForPrompt(list)))
|
||||||
.catch(() => {});
|
.catch(() => {});
|
||||||
}
|
}
|
||||||
@@ -119,7 +119,8 @@ router.get('/', wrap(async (req, res) => {
|
|||||||
let description = '(缺 SKILL.md)';
|
let description = '(缺 SKILL.md)';
|
||||||
let hasMd = false;
|
let hasMd = false;
|
||||||
try {
|
try {
|
||||||
description = extractDescription(await fsp.readFile(path.join(dir, 'SKILL.md'), 'utf8'));
|
const content = await fsp.readFile(path.join(dir, 'SKILL.md'), 'utf8');
|
||||||
|
description = extractDescription(content);
|
||||||
hasMd = true;
|
hasMd = true;
|
||||||
} catch (_) {}
|
} catch (_) {}
|
||||||
const files = listSkillFiles(dir);
|
const files = listSkillFiles(dir);
|
||||||
|
|||||||
@@ -178,10 +178,10 @@ function dumpPromptBundle() {
|
|||||||
// 启动时先发现各 MCP 服务的工具(单个服务失败只警告,不阻止启动),
|
// 启动时先发现各 MCP 服务的工具(单个服务失败只警告,不阻止启动),
|
||||||
// 并对技能列表做快照(注入 system prompt,见 llm.setSkillListText),完成后开始监听。
|
// 并对技能列表做快照(注入 system prompt,见 llm.setSkillListText),完成后开始监听。
|
||||||
mcp.init(cfg).then(async () => {
|
mcp.init(cfg).then(async () => {
|
||||||
// 技能列表快照:模型直接感知已有技能,免先 skill op=list 探索;
|
// 技能列表快照:模型直接感知已有技能,免先 {"list":"all"} 探索;
|
||||||
// 此处失败不阻塞启动,skill op=list 仍可做实时兑底。
|
// 此处失败不阻塞启动,{"list":"all"} 仍可做实时兜底。
|
||||||
try {
|
try {
|
||||||
const list = await skills.listSkills({ cfg });
|
const list = await skills.listCallableSkills({ cfg });
|
||||||
llm.setSkillListText(skills.formatSkillListForPrompt(list));
|
llm.setSkillListText(skills.formatSkillListForPrompt(list));
|
||||||
log.info('startup', ' skills=' + (list.length ? list.map(s => s.name).join(', ') : '(none)'));
|
log.info('startup', ' skills=' + (list.length ? list.map(s => s.name).join(', ') : '(none)'));
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
@@ -193,7 +193,8 @@ mcp.init(cfg).then(async () => {
|
|||||||
log.info('startup', ' workspace_root=' + cfg.workspace_root);
|
log.info('startup', ' workspace_root=' + cfg.workspace_root);
|
||||||
log.info('startup', ' data_root=' + cfg.data_root);
|
log.info('startup', ' data_root=' + cfg.data_root);
|
||||||
log.info('startup', ' models=' + cfg.models.map(m => m.id + '@' + m.url).join(', '));
|
log.info('startup', ' models=' + cfg.models.map(m => m.id + '@' + m.url).join(', '));
|
||||||
const mcpList = (cfg.mcp_servers || []).map(s => s.name + '@' + s.url + (s.enable === false ? '(禁用)' : '')).join(', ');
|
const mcpList = (cfg.mcp_servers || []).map(s => s.name + '@' + s.url +
|
||||||
|
(s.mode === 'disable' ? '(禁用)' : s.mode === 'skill' ? '(技能)' : '')).join(', ');
|
||||||
log.info('startup', ' mcp_servers=' + (mcpList || '(none)'));
|
log.info('startup', ' mcp_servers=' + (mcpList || '(none)'));
|
||||||
log.info('startup', ' auth=' + (auth.enabled ? 'login: ' + cfg.auth.users.map(u => u.user).join(', ') : '(disabled)'));
|
log.info('startup', ' auth=' + (auth.enabled ? 'login: ' + cfg.auth.users.map(u => u.user).join(', ') : '(disabled)'));
|
||||||
log.info('startup', ' wxbot=' + (cfg.wxbot.url && cfg.wxbot.token ? cfg.wxbot.url : '(未启用)'));
|
log.info('startup', ' wxbot=' + (cfg.wxbot.url && cfg.wxbot.token ? cfg.wxbot.url : '(未启用)'));
|
||||||
|
|||||||
@@ -337,29 +337,25 @@
|
|||||||
"type": "function",
|
"type": "function",
|
||||||
"function": {
|
"function": {
|
||||||
"name": "skill",
|
"name": "skill",
|
||||||
"description": "Use the skills installed on this server. A skill is a directory under the skill root whose SKILL.md defines its purpose and input_schema.\n\nop=list No arguments.\nop=get Requires name.\nop=run Requires name; input_args optional (default {}).\n\nop=list: lists all installed skills with a one-line description each, read live from the skill root; use it to choose among skills or to confirm what is installed. An empty skill set returns an empty list — that is not an error.\nop=get: returns the full raw SKILL.md (front matter included): purpose, input_schema, and usage notes. Call it before op=run with a skill you have not used in this conversation. A nonexistent skill returns an error.\nop=run: executes the skill with input_args validated against its input_schema (a validation error names the missing fields). The entry script receives a JSON string as its only CLI argument, so input_args must be a JSON object.\n- Returns the skill's combined stdout+stderr as plain text after it exits; exit 0 with no output yields '(无输出)'. A non-zero exit raises an error containing the output and [exit code: N].\n- Direct output files via arguments: relative paths in input_args are resolved against the session working directory; do not rely on the skill's cwd.\n- Default timeout 120 seconds: the process group is killed and the error includes partial output collected so far (a timeout is not a skill failure).",
|
"description": "Run or inspect the skills installed on this server. A skill is a directory under the skill root whose SKILL.md defines its purpose and input_schema.\n\nPass EXACTLY ONE verb key:\n{\"list\":\"all\"} List every installed skill with a one-line description, read live from the skill root; an empty list is not an error.\n{\"get\":\"<name>\"} Return the skill's full raw SKILL.md (front matter included): purpose, input_schema and usage notes. Call it before run for a skill you have not used in this conversation.\n{\"run\":\"<name>\",\"args\":{...}} Execute the skill; args are key/value pairs matching its input_schema, and may be omitted for skills that take none.\n\nrun returns the skill's combined stdout+stderr as plain text after it exits (exit 0 with no output yields '(无输出)'); a non-zero exit raises an error containing the output and [exit code: N]. Relative paths in args are resolved against the session working directory, so pass output paths explicitly and never rely on the skill's cwd. Default timeout 120 seconds: the process group is killed and the error includes partial output collected so far (a timeout is not a skill failure).",
|
||||||
"parameters": {
|
"parameters": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"required": [
|
|
||||||
"op"
|
|
||||||
],
|
|
||||||
"properties": {
|
"properties": {
|
||||||
"op": {
|
"list": {
|
||||||
"type": "string",
|
"type": "string",
|
||||||
"enum": [
|
"description": "Scope of the listing. The only scope today is \"all\" (every installed skill)."
|
||||||
"list",
|
|
||||||
"get",
|
|
||||||
"run"
|
|
||||||
],
|
|
||||||
"description": "Operation to perform on skills."
|
|
||||||
},
|
},
|
||||||
"name": {
|
"get": {
|
||||||
"type": "string",
|
"type": "string",
|
||||||
"description": "Name of the skill (subdirectory name under the skill root directory). Required with op=get and op=run."
|
"description": "Skill name (subdirectory name under the skill root): return its SKILL.md."
|
||||||
},
|
},
|
||||||
"input_args": {
|
"run": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Skill name: execute it with args."
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"description": "Dictionary of input arguments for the skill. Keys and values should match the skill's input_schema (call op=get first if unsure). Example: {\"input\": \"file.md\", \"output\": \"out.pdf\"}. Used only with op=run; omit it for skills that take no arguments."
|
"description": "Only with run: the skill's input arguments, e.g. {\"input\": \"file.md\", \"output\": \"out.pdf\"}. Omit it for skills that take no arguments."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1498,11 +1498,18 @@ function toolDb(ctx, args) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// skill:技能三件套(list_skills/get_skill_info/run_skill)合并后的单工具(op 分派)。
|
// skill:技能三件套(list/get/run)合并后的单工具(依据 docs/tool-design.md §一)。
|
||||||
// 同一标识空间(name)+ 同一生命周期(live 扫目录,无常驻状态可增删)→ 合并,
|
// 参数形状是「动词作键、技能名作值」,三者恰好给一个:
|
||||||
// 依据 docs/tool-design.md §一;技能不是「无持久状态」的动作,run 不必单独成工具。
|
// {list:"all"} / {get:"<名>"} / {run:"<名>", args:{...}}
|
||||||
// input_args 仅 op=run 用且可缺省:runSkill 把 null 视作 {},真正缺哪些字段由
|
// list 的值是范围而非布尔:将来技能分类落地时直接扩成 {list:"<分类>"},调用形状不变,
|
||||||
// 各技能 input_schema 校验点名报错(工具层再 gate 一层是双重门槛,无益)。
|
// 模型不用学第二套写法。今天只认 "all" 且报错点名——静默返回全部会让错拼的分类名
|
||||||
|
// 看起来「能用」,将来接分类时更难排查。
|
||||||
|
// {list:"all"} 的清单 = 目录技能 + mode=skill 的 MCP 工具;get/run 对两者一视同仁:
|
||||||
|
// 目录技能读 SKILL.md,MCP 技能直接回注册表里的原始 input_schema。
|
||||||
|
// args 仅 run 用且可缺省:runSkill 把 null 视作 {},真正缺哪些字段由各技能 input_schema
|
||||||
|
// 校验点名报错(工具层再 gate 一层是双重门槛,无益)。
|
||||||
|
// 旧形状 {op, name, input_args} 仍接受:存量技能文档的调用示例里写的是它,模型 get 到
|
||||||
|
// 旧示例就会照着发;仅作兼容兜底,不再对外文档化(文档只体现新形状)。
|
||||||
// visit_url(front matter 可选):页面产物类技能声明访问路径模板,run 成功后在本层拼
|
// visit_url(front matter 可选):页面产物类技能声明访问路径模板,run 成功后在本层拼
|
||||||
// public_link.base_url(与 mint_public_link 同源)追加完整「访问地址」——技能进程跑在
|
// public_link.base_url(与 mint_public_link 同源)追加完整「访问地址」——技能进程跑在
|
||||||
// executor 隔离视图里不知道公网前缀,AI 拿到相对路径就会原样转给用户,而相对路径打不开。
|
// executor 隔离视图里不知道公网前缀,AI 拿到相对路径就会原样转给用户,而相对路径打不开。
|
||||||
@@ -1524,23 +1531,67 @@ async function runSkillWithVisit(ctx, name, inputArgs) {
|
|||||||
: rel + '(站内路径:public_link.base_url 未配置,拼不出公网前缀)');
|
: rel + '(站内路径:public_link.base_url 未配置,拼不出公网前缀)');
|
||||||
}
|
}
|
||||||
|
|
||||||
async function toolSkill(ctx, args) {
|
const SKILL_USAGE = 'skill 用法:{"list":"all"} / {"get":"<技能名>"} / {"run":"<技能名>","args":{...}},三者恰好给一个';
|
||||||
const op = String(args.op || '').trim().toLowerCase();
|
|
||||||
const name = String(args.name || '').trim();
|
// 技能名必须是单 token:它要原样塞进 {run:"<名>"} 的值里,空格与等号会让日志与
|
||||||
|
// 报错里的表达产生歧义('/' 与 '..' 由 skills.skillDir 拦下)。
|
||||||
|
function skillNameArg(value, verb) {
|
||||||
|
if (typeof value !== 'string' || !value.trim()) {
|
||||||
|
throw new Error('skill ' + verb + ' 需要一个技能名字符串,收到:' + JSON.stringify(value).slice(0, 60) + '。' + SKILL_USAGE);
|
||||||
|
}
|
||||||
|
const name = value.trim();
|
||||||
|
if (/[\s=]/.test(name)) throw new Error('技能名不能含空格或等号:"' + name + '"');
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
|
||||||
|
// list/get 带非空 args 一律报错而不是静默丢弃:否则模型会以为参数生效了。
|
||||||
|
function rejectSkillArgs(a, verb) {
|
||||||
|
if (!a.args || typeof a.args !== 'object' || !Object.keys(a.args).length) return;
|
||||||
|
throw new Error(verb + ' 不接受 args,只有 run 才带参数。' + SKILL_USAGE);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 旧形状 {op, name, input_args} 的等价翻译(兼容存量技能文档,见上方注释)。
|
||||||
|
async function legacyToolSkill(ctx, a) {
|
||||||
|
const op = String(a.op == null ? '' : a.op).trim().toLowerCase();
|
||||||
|
const name = String(a.name == null ? '' : a.name).trim();
|
||||||
switch (op) {
|
switch (op) {
|
||||||
case 'list':
|
case 'list':
|
||||||
return JSON.stringify(await skills.listSkills(ctx), null, 2);
|
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||||
case 'get': {
|
case 'get':
|
||||||
if (!name) throw new Error('op=get 缺少必填参数 name');
|
if (!name) throw new Error('op=get 缺少技能名。' + SKILL_USAGE);
|
||||||
|
return skills.getSkillInfo(ctx, name);
|
||||||
|
case 'run':
|
||||||
|
if (!name) throw new Error('op=run 缺少技能名。' + SKILL_USAGE);
|
||||||
|
return runSkillWithVisit(ctx, name, a.input_args);
|
||||||
|
default:
|
||||||
|
throw new Error('未知的 op:"' + op + '"。' + SKILL_USAGE);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function toolSkill(ctx, args) {
|
||||||
|
const a = args || {};
|
||||||
|
const verbs = ['list', 'get', 'run'].filter(k => a[k] !== undefined && a[k] !== null && a[k] !== false);
|
||||||
|
if (!verbs.length) {
|
||||||
|
// 三个动词键都没给时才回落到旧形状:两种都给时以新形状为准。
|
||||||
|
if (a.op !== undefined || a.name !== undefined || a.input_args !== undefined) return legacyToolSkill(ctx, a);
|
||||||
|
throw new Error(SKILL_USAGE);
|
||||||
|
}
|
||||||
|
if (verbs.length > 1) {
|
||||||
|
throw new Error('skill 一次只能给一个动词键,收到 ' + verbs.join(' + ') + '。' + SKILL_USAGE);
|
||||||
|
}
|
||||||
|
const verb = verbs[0];
|
||||||
|
if (verb === 'list') {
|
||||||
|
const scope = String(a.list).trim().toLowerCase();
|
||||||
|
if (scope !== 'all') throw new Error('list 目前只支持 "all"(技能分类尚未提供),收到:"' + scope + '"');
|
||||||
|
rejectSkillArgs(a, 'list');
|
||||||
|
return JSON.stringify(await skills.listCallableSkills(ctx), null, 2);
|
||||||
|
}
|
||||||
|
const name = skillNameArg(a[verb], verb);
|
||||||
|
if (verb === 'get') {
|
||||||
|
rejectSkillArgs(a, 'get');
|
||||||
return skills.getSkillInfo(ctx, name);
|
return skills.getSkillInfo(ctx, name);
|
||||||
}
|
}
|
||||||
case 'run': {
|
return runSkillWithVisit(ctx, name, a.args);
|
||||||
if (!name) throw new Error('op=run 缺少必填参数 name');
|
|
||||||
return runSkillWithVisit(ctx, name, args.input_args);
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
throw new Error('未知的 op:"' + op + '"。可用:list / get(需 name)/ run(需 name,input_args 可选)');
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// lab:全工具统一入口(元工具,tools 数组收缩到 1 个仍可达内置 + MCP 全部能力)。
|
// lab:全工具统一入口(元工具,tools 数组收缩到 1 个仍可达内置 + MCP 全部能力)。
|
||||||
|
|||||||
+65
-19
@@ -3,7 +3,10 @@
|
|||||||
// 一次性处理——镜像已带的包跳过,缺的装进 skills/deps,运行期经 executor 容器 env 的 PYTHONPATH 可见。
|
// 一次性处理——镜像已带的包跳过,缺的装进 skills/deps,运行期经 executor 容器 env 的 PYTHONPATH 可见。
|
||||||
// 技能统一存放于技能根目录(cfg.skills_root,所有任务/会话共享;容器内挂 ./skills → /workspace/skills),每个技能一个子目录:
|
// 技能统一存放于技能根目录(cfg.skills_root,所有任务/会话共享;容器内挂 ./skills → /workspace/skills),每个技能一个子目录:
|
||||||
// <skill>/SKILL.md(必须)、run.py | run.sh(入口)、requirements.txt、install.sh(可选)。
|
// <skill>/SKILL.md(必须)、run.py | run.sh(入口)、requirements.txt、install.sh(可选)。
|
||||||
// 入口脚本约定接收一个 JSON 字符串作为唯一命令行参数(含全部 input_args)。
|
// 入口脚本约定接收一个 JSON 字符串作为唯一命令行参数(含全部 args)。
|
||||||
|
// 后端两种:脚本(run.py/run.sh,落 executor 沙箱执行)与 MCP(core 直接 mcp.callTool 转发,
|
||||||
|
// 不经沙箱——凭证留在 core)。MCP 技能不落目录:服务配成 mode=skill 时由平台自动暴露,
|
||||||
|
// 参数契约直接取注册表里的原始 input_schema。
|
||||||
const fs = require('fs');
|
const fs = require('fs');
|
||||||
const fsp = require('fs').promises;
|
const fsp = require('fs').promises;
|
||||||
const path = require('path');
|
const path = require('path');
|
||||||
@@ -11,6 +14,8 @@ const { spawn } = require('child_process');
|
|||||||
const YAML = require('yaml');
|
const YAML = require('yaml');
|
||||||
const log = require('../log');
|
const log = require('../log');
|
||||||
const rexec = require('../remote-exec');
|
const rexec = require('../remote-exec');
|
||||||
|
// mode=skill 的 MCP 工具在 get/run 时由 core 直接转发;mcp.js 只依赖 ./log,不成环。
|
||||||
|
const mcp = require('../mcp');
|
||||||
|
|
||||||
class SkillNotFoundError extends Error {
|
class SkillNotFoundError extends Error {
|
||||||
constructor(msg) { super(msg); this.name = 'SkillNotFoundError'; }
|
constructor(msg) { super(msg); this.name = 'SkillNotFoundError'; }
|
||||||
@@ -48,7 +53,7 @@ function extractDescription(content) {
|
|||||||
return line || '(无描述)';
|
return line || '(无描述)';
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- 3.1 skill op=list ----------
|
// ---------- 3.1 skill list ----------
|
||||||
async function listSkills(ctx) {
|
async function listSkills(ctx) {
|
||||||
const root = skillsRoot(ctx);
|
const root = skillsRoot(ctx);
|
||||||
if (!fs.existsSync(root)) {
|
if (!fs.existsSync(root)) {
|
||||||
@@ -65,20 +70,49 @@ async function listSkills(ctx) {
|
|||||||
try { content = await fsp.readFile(mdPath, 'utf8'); } catch (_) { continue; }
|
try { content = await fsp.readFile(mdPath, 'utf8'); } catch (_) { continue; }
|
||||||
// frontmatter 可选 required: true —— 进 system prompt 时行首标 **required**(配合模板里的强制条款)
|
// frontmatter 可选 required: true —— 进 system prompt 时行首标 **required**(配合模板里的强制条款)
|
||||||
let required = false;
|
let required = false;
|
||||||
try { required = parseFrontMatter(content).required === true; } catch (_) {}
|
try {
|
||||||
|
required = parseFrontMatter(content).required === true;
|
||||||
|
} catch (_) {}
|
||||||
out.push({ name: e.name, description: extractDescription(content), required: required });
|
out.push({ name: e.name, description: extractDescription(content), required: required });
|
||||||
}
|
}
|
||||||
out.sort((a, b) => a.name.localeCompare(b.name));
|
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||||
return out;
|
return out;
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- system prompt 注入:可用技能列表 ----------
|
// ---------- MCP 技能(mode=skill)----------
|
||||||
|
// mode=skill 的服务:工具不进 tools 数组,而是自动成为技能。既省掉每轮的 schema 开销,
|
||||||
|
// 又不用在 skills_root 里建目录、手抄一份参数说明——get 直接返回注册表里的原始 input_schema。
|
||||||
|
// 目录技能优先:同名时目录技能胜出并打 warn。手写包装可以遮住自动版,迁移期也不会撞车。
|
||||||
|
|
||||||
|
// MCP 的 description 常是多段文本;清单里只取第一行,完整内容留给 get。
|
||||||
|
function firstLine(s) {
|
||||||
|
const line = String(s == null ? '' : s).split(/\r?\n/).map(l => l.trim()).find(Boolean);
|
||||||
|
return line || '(无描述)';
|
||||||
|
}
|
||||||
|
|
||||||
|
// 模型可见的技能全集 = 目录技能 + mode=skill 的 MCP 工具。
|
||||||
|
// 设置页的技能 API 只用 listSkills(它按目录增删改),不要混用这个函数。
|
||||||
|
async function listCallableSkills(ctx) {
|
||||||
|
const dir = await listSkills(ctx);
|
||||||
|
const taken = new Set(dir.map(s => s.name));
|
||||||
|
const out = dir.slice();
|
||||||
|
for (const t of mcp.skillTools()) {
|
||||||
|
if (taken.has(t.name)) {
|
||||||
|
log.warn('skills', 'MCP 工具 ' + t.name + ' 与目录技能同名,按目录技能处理(mode=skill 的这份被遮蔽)');
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
out.push({ name: t.name, description: firstLine(t.description), required: false });
|
||||||
|
}
|
||||||
|
out.sort((a, b) => a.name.localeCompare(b.name));
|
||||||
|
return out;
|
||||||
|
}
|
||||||
|
|
||||||
// 把技能列表格式化成 “## Available Skills” 段落(每行 `- [**required** ]名字: 描述`;
|
// 把技能列表格式化成 “## Available Skills” 段落(每行 `- [**required** ]名字: 描述`;
|
||||||
// listSkills 已按名字 localeCompare 排序,行序恒定,不破坏前缀缓存;
|
// listSkills 已按名字 localeCompare 排序,行序恒定,不破坏前缀缓存;
|
||||||
// 参数查 op=get,执行 op=run;描述如需实时复核仍可查 op=list)。
|
// 参数查 get,执行 run;描述如需实时复核仍可查 list)。
|
||||||
// 由 llm.setSkillListText 拼入 system prompt:启动时快照(server.js)与技能变更后
|
// 由 llm.setSkillListText 拼入 system prompt:启动时快照(server.js)与技能变更后
|
||||||
// (routes/skills.js 的创建/重命名/删除/文件变更)调用,让模型直接感知已装技能,
|
// (routes/skills.js 的创建/重命名/删除/文件变更)调用,让模型直接感知已装技能,
|
||||||
// 省掉先 op=list 探索的往返。
|
// 省掉先 list 探索的往返。
|
||||||
function formatSkillListForPrompt(list) {
|
function formatSkillListForPrompt(list) {
|
||||||
if (!list || !list.length) return '';
|
if (!list || !list.length) return '';
|
||||||
const lines = list.map(s => {
|
const lines = list.map(s => {
|
||||||
@@ -89,14 +123,16 @@ function formatSkillListForPrompt(list) {
|
|||||||
return '## Available Skills\n' + lines.join('\n');
|
return '## Available Skills\n' + lines.join('\n');
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- 3.2 skill op=get ----------
|
// ---------- 3.2 skill get ----------
|
||||||
async function getSkillInfo(ctx, skillName) {
|
async function getSkillInfo(ctx, skillName) {
|
||||||
const dir = skillDir(ctx, skillName);
|
const dir = skillDir(ctx, skillName);
|
||||||
const mdPath = path.join(dir, 'SKILL.md');
|
const mdPath = path.join(dir, 'SKILL.md');
|
||||||
if (!fs.existsSync(mdPath)) {
|
if (fs.existsSync(mdPath)) return fsp.readFile(mdPath, 'utf8');
|
||||||
|
// mode=skill 的 MCP 技能没有目录:直接返回注册表里的原始契约(description + input_schema),
|
||||||
|
// 模型看到的就是服务端实际声明的参数,不存在手抄副本漂移的问题。
|
||||||
|
const t = mcp.getSkillTool(skillName);
|
||||||
|
if (t) return JSON.stringify({ name: t.name, description: t.description, input_schema: t.parameters }, null, 2);
|
||||||
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
throw new SkillNotFoundError('技能不存在或缺少 SKILL.md:' + skillName);
|
||||||
}
|
|
||||||
return fsp.readFile(mdPath, 'utf8');
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- 参数路径预处理 ----------
|
// ---------- 参数路径预处理 ----------
|
||||||
@@ -123,7 +159,7 @@ function absolutizeArgs(inputArgs, baseDir) {
|
|||||||
return out;
|
return out;
|
||||||
}
|
}
|
||||||
|
|
||||||
// 按 input_schema 校验 input_args(仅校验 required 字段存在且非空)。
|
// 按 input_schema 校验技能参数(仅校验 required 字段存在且非空)。
|
||||||
function validateArgs(fm, inputArgs, skillName) {
|
function validateArgs(fm, inputArgs, skillName) {
|
||||||
const schema = fm && fm.input_schema;
|
const schema = fm && fm.input_schema;
|
||||||
if (!schema || !Array.isArray(schema.required)) return;
|
if (!schema || !Array.isArray(schema.required)) return;
|
||||||
@@ -135,7 +171,7 @@ function validateArgs(fm, inputArgs, skillName) {
|
|||||||
|
|
||||||
// 前台执行技能入口,带超时与取消支持;成功 resolve stdout,失败 reject SkillExecutionError。
|
// 前台执行技能入口,带超时与取消支持;成功 resolve stdout,失败 reject SkillExecutionError。
|
||||||
// 配了 executor:入口命令拼成单条 shell 行(参数单引号转义,JSON payload 安全)交远端执行,
|
// 配了 executor:入口命令拼成单条 shell 行(参数单引号转义,JSON payload 安全)交远端执行,
|
||||||
// cwd 由调用方给出(op=run 传会话目录以命中 session 隔离与虚拟视图);
|
// cwd 由调用方给出(run 传会话目录以命中 session 隔离与虚拟视图);
|
||||||
// 技能依赖的 PYTHONPATH 由 executor 容器 env 提供,core 不感知依赖层。
|
// 技能依赖的 PYTHONPATH 由 executor 容器 env 提供,core 不感知依赖层。
|
||||||
function runEntry(ctx, entry, args, cwd, timeoutMs) {
|
function runEntry(ctx, entry, args, cwd, timeoutMs) {
|
||||||
const cfg = ctx.cfg;
|
const cfg = ctx.cfg;
|
||||||
@@ -199,24 +235,34 @@ function runEntry(ctx, entry, args, cwd, timeoutMs) {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- 3.3 skill op=run ----------
|
// ---------- 3.3 skill run ----------
|
||||||
async function runSkill(ctx, skillName, inputArgs) {
|
async function runSkill(ctx, skillName, inputArgs) {
|
||||||
// 非对象参数会在 absolutizeArgs 的 Object.entries 里静默错位成垃圾键值(如字符串→索引对象),显式拦下。
|
// 非对象参数会在 absolutizeArgs 的 Object.entries 里静默错位成垃圾键值(如字符串→索引对象),显式拦下。
|
||||||
if (inputArgs != null && (typeof inputArgs !== 'object' || Array.isArray(inputArgs))) {
|
if (inputArgs != null && (typeof inputArgs !== 'object' || Array.isArray(inputArgs))) {
|
||||||
throw new SkillExecutionError('input_args 必须是对象(键值参数),收到:' + JSON.stringify(inputArgs).slice(0, 80), 1);
|
throw new SkillExecutionError('技能参数必须是对象(键值参数),收到:' + JSON.stringify(inputArgs).slice(0, 80), 1);
|
||||||
}
|
}
|
||||||
const dir = skillDir(ctx, skillName);
|
const dir = skillDir(ctx, skillName);
|
||||||
if (!fs.existsSync(dir)) throw new SkillNotFoundError('技能不存在:' + skillName);
|
if (!fs.existsSync(dir)) {
|
||||||
|
// mode=skill 的 MCP 技能:直接转发。同样不做 absolutizeArgs——URL 与含 '/' 的 prompt
|
||||||
|
// 会被当成路径改写坏;也不做 validateArgs,参数与 MCP 工具自己的 op 相关。
|
||||||
|
const t = mcp.getSkillTool(skillName);
|
||||||
|
if (t) {
|
||||||
|
log.info('skills', '执行 MCP 技能 ' + t.name + ' → ' + t.server + '/' + t.tool);
|
||||||
|
return mcp.callTool(t.name, inputArgs || {}, ctx);
|
||||||
|
}
|
||||||
|
throw new SkillNotFoundError('技能不存在:' + skillName);
|
||||||
|
}
|
||||||
|
|
||||||
const mdPath = path.join(dir, 'SKILL.md');
|
const mdPath = path.join(dir, 'SKILL.md');
|
||||||
if (!fs.existsSync(mdPath)) throw new SkillNotFoundError('技能缺少 SKILL.md:' + skillName);
|
if (!fs.existsSync(mdPath)) throw new SkillNotFoundError('技能缺少 SKILL.md:' + skillName);
|
||||||
|
|
||||||
// 先把相对路径参数按会话任务目录转成绝对路径(缺任务目录时退回进程当前目录)。
|
let fm = {};
|
||||||
|
try { fm = parseFrontMatter(await fsp.readFile(mdPath, 'utf8')); } catch (_) {}
|
||||||
|
|
||||||
|
// 以下是脚本后端(run.py / run.sh):先把相对路径参数按会话任务目录转成绝对路径(缺任务目录时退回进程当前目录)。
|
||||||
const args = absolutizeArgs(inputArgs || {}, ctx.taskDir || process.cwd());
|
const args = absolutizeArgs(inputArgs || {}, ctx.taskDir || process.cwd());
|
||||||
const payload = JSON.stringify(args);
|
const payload = JSON.stringify(args);
|
||||||
|
|
||||||
let fm = {};
|
|
||||||
try { fm = parseFrontMatter(await fsp.readFile(mdPath, 'utf8')); } catch (_) {}
|
|
||||||
validateArgs(fm, args, skillName);
|
validateArgs(fm, args, skillName);
|
||||||
|
|
||||||
let entry, cmdArgs;
|
let entry, cmdArgs;
|
||||||
@@ -243,4 +289,4 @@ async function runSkill(ctx, skillName, inputArgs) {
|
|||||||
return runEntry(ctx, entry, cmdArgs, execCwd, timeoutMs);
|
return runEntry(ctx, entry, cmdArgs, execCwd, timeoutMs);
|
||||||
}
|
}
|
||||||
|
|
||||||
module.exports = { listSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
module.exports = { listSkills, listCallableSkills, getSkillInfo, runSkill, skillsRoot, parseFrontMatter, extractDescription, formatSkillListForPrompt };
|
||||||
|
|||||||
@@ -25,6 +25,9 @@
|
|||||||
- 跨 op 共享的参数放顶层,description 说明哪些 op 用它;
|
- 跨 op 共享的参数放顶层,description 说明哪些 op 用它;
|
||||||
- op 专属参数也放顶层,description 说明 `op=X 时必填`;
|
- op 专属参数也放顶层,description 说明 `op=X 时必填`;
|
||||||
- 仅当参数结构在工具定义时无法确定时,才用自由对象 `{ "type": "object" }`。
|
- 仅当参数结构在工具定义时无法确定时,才用自由对象 `{ "type": "object" }`。
|
||||||
|
- 动词 + 单 token 标识可以折叠成「动词作键、标识作值」(技能的 `{"get":"<名>"}` 即此形)。
|
||||||
|
多个动词互斥时 `required` 表达不了,必须在代码里校验,并在报错里回显全部合法形态;
|
||||||
|
取值范围暂只有一个时(如 `{"list":"all"}`)仍用字符串而非布尔,便于后续扩成分类等子集。
|
||||||
|
|
||||||
### 四、条件必填
|
### 四、条件必填
|
||||||
|
|
||||||
|
|||||||
@@ -303,7 +303,7 @@ function buildServer() {
|
|||||||
|
|
||||||
server.tool(
|
server.tool(
|
||||||
"image_task",
|
"image_task",
|
||||||
`Manages asynchronous image generation tasks.
|
`AI image generation.
|
||||||
|
|
||||||
op=create Submit a new task. Returns a task_id immediately; generation runs in background.
|
op=create Submit a new task. Returns a task_id immediately; generation runs in background.
|
||||||
Requires prompt.
|
Requires prompt.
|
||||||
|
|||||||
@@ -336,7 +336,7 @@ function buildServer() {
|
|||||||
|
|
||||||
server.tool(
|
server.tool(
|
||||||
"video_task",
|
"video_task",
|
||||||
`Manages asynchronous video generation tasks.
|
`AI video generation.
|
||||||
|
|
||||||
op=create Submit a new task. Returns a task_id immediately; generation runs asynchronously.
|
op=create Submit a new task. Returns a task_id immediately; generation runs asynchronously.
|
||||||
Requires at least one of prompt or image_url.
|
Requires at least one of prompt or image_url.
|
||||||
|
|||||||
+7
-5
@@ -11,7 +11,7 @@
|
|||||||
# 输入(都可选):
|
# 输入(都可选):
|
||||||
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
|
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
|
||||||
# image_task / video_task 复用 BIGMODEL_KEY(智谱即 BigModel);
|
# image_task / video_task 复用 BIGMODEL_KEY(智谱即 BigModel);
|
||||||
# 未配 BIGMODEL_KEY 时这两个服务写为 enable: false
|
# 未配 BIGMODEL_KEY 时这两个服务写为 mode: disable
|
||||||
# AUTH_USER / AUTH_PASSWORD 登录账号(默认 admin / admin,请自行改掉)
|
# AUTH_USER / AUTH_PASSWORD 登录账号(默认 admin / admin,请自行改掉)
|
||||||
# PUBLIC_IP / AGENT_PORT 对外地址与端口,写进 public_link.base_url;
|
# PUBLIC_IP / AGENT_PORT 对外地址与端口,写进 public_link.base_url;
|
||||||
# PUBLIC_IP 不配置则自动探测公网 IP
|
# PUBLIC_IP 不配置则自动探测公网 IP
|
||||||
@@ -211,19 +211,21 @@ EOF
|
|||||||
url: "http://mcp_image_task:3000/mcp"
|
url: "http://mcp_image_task:3000/mcp"
|
||||||
headers:
|
headers:
|
||||||
Authorization: "Bearer $BIGMODEL_KEY"
|
Authorization: "Bearer $BIGMODEL_KEY"
|
||||||
|
mode: skill # 不下发给模型,以技能形式暴露(skill 工具里 list/get/run)
|
||||||
- name: video_task
|
- name: video_task
|
||||||
url: "http://mcp_video_task:3000/mcp"
|
url: "http://mcp_video_task:3000/mcp"
|
||||||
headers:
|
headers:
|
||||||
Authorization: "Bearer $BIGMODEL_KEY"
|
Authorization: "Bearer $BIGMODEL_KEY"
|
||||||
|
mode: skill
|
||||||
EOF
|
EOF
|
||||||
else
|
else
|
||||||
cat <<'EOF'
|
cat <<'EOF'
|
||||||
- name: image_task
|
- name: image_task
|
||||||
url: "http://mcp_image_task:3000/mcp"
|
url: "http://mcp_image_task:3000/mcp"
|
||||||
enable: false # 未配 BIGMODEL_KEY:只注册不加载,工具不发给模型
|
mode: disable # 未配 BIGMODEL_KEY:不连接、不发现;补上 key 后重跑本脚本
|
||||||
- name: video_task
|
- name: video_task
|
||||||
url: "http://mcp_video_task:3000/mcp"
|
url: "http://mcp_video_task:3000/mcp"
|
||||||
enable: false # 未配 BIGMODEL_KEY:只注册不加载,工具不发给模型
|
mode: disable # 未配 BIGMODEL_KEY:不连接、不发现;补上 key 后重跑本脚本
|
||||||
EOF
|
EOF
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -235,7 +237,7 @@ public_link:
|
|||||||
EOF
|
EOF
|
||||||
} > "$CONFIG_YML"
|
} > "$CONFIG_YML"
|
||||||
|
|
||||||
info "平台: ${enabled_plats[*]:-无};图像/视频 MCP: $([ -n "$BIGMODEL_KEY" ] && echo 启用 || echo 未配置(enable: false))"
|
info "平台: ${enabled_plats[*]:-无};图像/视频 MCP: $([ -n "$BIGMODEL_KEY" ] && echo 启用 || echo 未配置(mode: disable))"
|
||||||
|
|
||||||
# ============================================================
|
# ============================================================
|
||||||
# 3. 汇总
|
# 3. 汇总
|
||||||
@@ -246,7 +248,7 @@ echo " 访问地址 : http://${PUBLIC_IP:-<公网IP>}:${AGENT_PORT}"
|
|||||||
echo " 账号 : $AUTH_USER"
|
echo " 账号 : $AUTH_USER"
|
||||||
echo " 密码 : $AUTH_PASSWORD"
|
echo " 密码 : $AUTH_PASSWORD"
|
||||||
echo " 平台 : ${enabled_plats[*]:-(无)}"
|
echo " 平台 : ${enabled_plats[*]:-(无)}"
|
||||||
echo " 图像/视频: $([ -n "$BIGMODEL_KEY" ] && echo "image_task / video_task 已启用" || echo "未配置(enable: false)")"
|
echo " 图像/视频: $([ -n "$BIGMODEL_KEY" ] && echo "image_task / video_task 已启用" || echo "未配置(mode: disable)")"
|
||||||
echo " MCP 服务 : web_search / image_task / video_task(同栈,随 compose 启动)"
|
echo " MCP 服务 : web_search / image_task / video_task(同栈,随 compose 启动)"
|
||||||
echo " 微信接入 : WXBOT_TOKEN 已就位(compose 注入 core 与 wxbot 两侧;wxbot 无需配置文件)"
|
echo " 微信接入 : WXBOT_TOKEN 已就位(compose 注入 core 与 wxbot 两侧;wxbot 无需配置文件)"
|
||||||
echo "---------------------------------------------"
|
echo "---------------------------------------------"
|
||||||
|
|||||||
+31
-8
@@ -8,9 +8,9 @@
|
|||||||
|
|
||||||
技能是一个自包含的目录,通常存放在技能根目录(默认为 `skills/`)下。每个技能包含一个描述文件(`SKILL.md`)和一个可执行入口(`run.py` 或 `run.sh`)。Agent 通过以下流程使用技能:
|
技能是一个自包含的目录,通常存放在技能根目录(默认为 `skills/`)下。每个技能包含一个描述文件(`SKILL.md`)和一个可执行入口(`run.py` 或 `run.sh`)。Agent 通过以下流程使用技能:
|
||||||
|
|
||||||
1. 调用 `skill`(op=list)查看所有可用技能的名称和简介;
|
1. 调用 `skill` 的 `{"list":"all"}` 查看所有可用技能的名称和简介;
|
||||||
2. 调用 `skill`(op=get)获取某个技能的详细说明;
|
2. 调用 `skill` 的 `{"get":"<技能名>"}` 获取某个技能的详细说明;
|
||||||
3. 调用 `skill`(op=run)执行技能,传入所需参数。
|
3. 调用 `skill` 的 `{"run":"<技能名>","args":{...}}` 执行技能,传入所需参数。
|
||||||
|
|
||||||
技能可以处理任何任务,例如文件格式转换、数据处理、网页抓取等。
|
技能可以处理任何任务,例如文件格式转换、数据处理、网页抓取等。
|
||||||
|
|
||||||
@@ -57,10 +57,10 @@ visit_url: /app/{task_id}/ # 可选:页面类技能的访问路径模板
|
|||||||
```
|
```
|
||||||
|
|
||||||
- `name`:技能名称,应与目录名一致。
|
- `name`:技能名称,应与目录名一致。
|
||||||
- `description`:一句话描述技能功能,用于 `skill` op=list 展示。
|
- `description`:一句话描述技能功能,用于 `{"list":"all"}` 的清单展示。
|
||||||
- `input_schema`:输入参数的 JSON Schema 定义,用于参数校验和文档生成。
|
- `input_schema`:输入参数的 JSON Schema 定义,用于参数校验和文档生成。
|
||||||
- `output_schema`:输出结果的描述(可选)。
|
- `output_schema`:输出结果的描述(可选)。
|
||||||
- `visit_url`:(可选)页面类技能声明的访问路径模板,`{task_id}` 占位执行时替换为会话 id。`op=run` 成功后由 core(tools/executor.js)拼上 `public_link.base_url`,在输出末尾追加一行「访问地址:<完整 URL>」——技能进程跑在 executor 隔离视图里不知道公网地址,完整链接只能 core 补;AI 拿到相对路径会原样转给用户,而相对路径打不开。
|
- `visit_url`:(可选)页面类技能声明的访问路径模板,`{task_id}` 占位执行时替换为会话 id。`run` 成功后由 core(tools/executor.js)拼上 `public_link.base_url`,在输出末尾追加一行「访问地址:<完整 URL>」——技能进程跑在 executor 隔离视图里不知道公网地址,完整链接只能 core 补;AI 拿到相对路径会原样转给用户,而相对路径打不开。
|
||||||
- 若未提供 Front Matter,系统会尝试从正文第一行提取描述。
|
- 若未提供 Front Matter,系统会尝试从正文第一行提取描述。
|
||||||
|
|
||||||
### 3.2 正文内容
|
### 3.2 正文内容
|
||||||
@@ -80,13 +80,36 @@ visit_url: /app/{task_id}/ # 可选:页面类技能的访问路径模板
|
|||||||
- 自动处理某某
|
- 自动处理某某
|
||||||
|
|
||||||
## 使用说明
|
## 使用说明
|
||||||
通过 `skill`(op=run)调用,参数:
|
通过 `skill` 的 `{"run":"<技能名>","args":{...}}` 调用,参数:
|
||||||
- `input`:某某路径(必填)
|
- `input`:某某路径(必填)
|
||||||
- `output`:某某路径(可选,默认与输入同名)
|
- `output`:某某路径(可选,默认与输入同名)
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### 3.3 MCP 后端技能(不建目录)
|
||||||
|
|
||||||
|
把 `config.yml` 里某个 MCP 服务配成 `mode: skill` 即可:它的每个工具会自动成为技能,不需要
|
||||||
|
`SKILL.md`,也不需要入口脚本。
|
||||||
|
|
||||||
|
- `{"list":"all"}` 里出现工具名,描述取 MCP `description` 的第一行;
|
||||||
|
- `{"get":"<工具名>"}` 直接返回 MCP 原始的 `description` + `input_schema`(单一来源,不会与
|
||||||
|
实现漂移);
|
||||||
|
- `{"run":"<工具名>","args":{…}}` 把 `args` 原样透传成 MCP 的 `arguments`,由 core 直接转发。
|
||||||
|
|
||||||
|
几个约束:
|
||||||
|
|
||||||
|
- 参数校验交给 MCP 服务,core 不做 `input_schema.required` 预检(MCP 工具的参数常与它自己的
|
||||||
|
`op` 相关,静态必填列表会误伤)。
|
||||||
|
- `args` **不做相对路径改写**:服务拿到什么就是什么。URL、含 `/` 的 prompt 因此不会被改坏,
|
||||||
|
但本地文件路径也不会被自动补全——需要公网 URL 的先用 `mint_public_link`。
|
||||||
|
- 不经过沙箱,所以不需要密钥:凭证留在 core 的 `mcp_servers[].headers` 里。
|
||||||
|
- 工具名用**最终可调用名**(与内置工具重名时会被加 `<服务名>__` 前缀,见 `app/AGENTS.md`)。
|
||||||
|
- 与目录技能同名时目录技能优先,自动暴露的那份被遮蔽并打 `warn`。
|
||||||
|
- 启动日志会打印 `mode=skill` 的工具数量,便于确认暴露是否生效。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 4. 入口脚本
|
## 4. 入口脚本
|
||||||
|
|
||||||
### 4.1 格式要求
|
### 4.1 格式要求
|
||||||
@@ -176,7 +199,7 @@ Agent 调用技能时,传入的文件路径可能是相对路径(相对于
|
|||||||
|
|
||||||
- **运行时的工作目录是「会话任务目录」,不是技能目录**(远端模式下即 executor 隔离视图里的 `/workspace/tasks/<会话>`)。技能进程只能看到当前会话的数据,看不到其他会话。
|
- **运行时的工作目录是「会话任务目录」,不是技能目录**(远端模式下即 executor 隔离视图里的 `/workspace/tasks/<会话>`)。技能进程只能看到当前会话的数据,看不到其他会话。
|
||||||
- 因此技能内部引用**自身资源**(模板、字体、配置等)时,**必须**基于脚本位置取绝对路径,不要依赖 cwd:Python 用 `Path(__file__).resolve().parent`,Shell 用 `"$(dirname "$0")"`。
|
- 因此技能内部引用**自身资源**(模板、字体、配置等)时,**必须**基于脚本位置取绝对路径,不要依赖 cwd:Python 用 `Path(__file__).resolve().parent`,Shell 用 `"$(dirname "$0")"`。
|
||||||
- 读写会话数据用 `input_args` 里传入的路径即可;相对路径会被预转绝对路径,且在隔离视图里与 Agent 看到的是同一份数据。
|
- 读写会话数据用 `args` 里传入的路径即可;相对路径会被预转绝对路径,且在隔离视图里与 Agent 看到的是同一份数据。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -228,7 +251,7 @@ input_schema:
|
|||||||
---
|
---
|
||||||
|
|
||||||
## 使用说明
|
## 使用说明
|
||||||
通过 `skill`(op=run)调用,参数:
|
通过 `skill` 的 `{"run":"<技能名>","args":{...}}` 调用,参数:
|
||||||
- `text`:要回显的文本(必填)
|
- `text`:要回显的文本(必填)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -31,7 +31,7 @@ visit_url: /app/{task_id}/
|
|||||||
|
|
||||||
## 初始化
|
## 初始化
|
||||||
|
|
||||||
调用 `skill(name="data-page", op="run")`,无需参数。它会把以下文件复制到 `.app/`:
|
调用 `skill {"run":"data-page"}`,无需参数。它会把以下文件复制到 `.app/`:
|
||||||
|
|
||||||
- `table.html` / `dashboard.html` / `kanban.html` —— 三个数据页模板
|
- `table.html` / `dashboard.html` / `kanban.html` —— 三个数据页模板
|
||||||
- `nav.html` —— 多页导航首页模板(静态卡片,无 config)
|
- `nav.html` —— 多页导航首页模板(静态卡片,无 config)
|
||||||
@@ -80,7 +80,7 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
|
|||||||
|
|
||||||
1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。
|
1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。
|
||||||
2. **创建表并录入数据**:用 `db` 工具完成。
|
2. **创建表并录入数据**:用 `db` 工具完成。
|
||||||
3. **初始化**:调用 `skill(name="data-page", op="run")`。
|
3. **初始化**:调用 `skill {"run":"data-page"}`。
|
||||||
4. **为每个要生成的页面写 config 文件**(见下一节)。**不要读也不要改模板本身**。
|
4. **为每个要生成的页面写 config 文件**(见下一节)。**不要读也不要改模板本身**。
|
||||||
5. **选定入口页 `.app/index.html`**(index 是副本,允许编辑;模板本体不动):
|
5. **选定入口页 `.app/index.html`**(index 是副本,允许编辑;模板本体不动):
|
||||||
- **用到 ≥2 个模板页** → `cp .app/nav.html .app/index.html`,改标题为业务名,并把未启用页面的卡片删掉(没配过的页点开会报 no such table)。子页标题左侧的「‹」返回键链回此导航页。
|
- **用到 ≥2 个模板页** → `cp .app/nav.html .app/index.html`,改标题为业务名,并把未启用页面的卡片删掉(没配过的页点开会报 no such table)。子页标题左侧的「‹」返回键链回此导航页。
|
||||||
|
|||||||
@@ -25,7 +25,7 @@ def main():
|
|||||||
try:
|
try:
|
||||||
args = json.loads(sys.argv[1])
|
args = json.loads(sys.argv[1])
|
||||||
if not isinstance(args, dict):
|
if not isinstance(args, dict):
|
||||||
raise ValueError('input_args 必须是 JSON 对象')
|
raise ValueError('技能参数必须是 JSON 对象')
|
||||||
if args:
|
if args:
|
||||||
print('本技能无参数,收到:' + json.dumps(args, ensure_ascii=False),
|
print('本技能无参数,收到:' + json.dumps(args, ensure_ascii=False),
|
||||||
file=sys.stderr)
|
file=sys.stderr)
|
||||||
|
|||||||
@@ -87,7 +87,7 @@ output_schema:
|
|||||||
- `grid`:把同一目录下多张图拼成一张 contact sheet(缩略图网格)
|
- `grid`:把同一目录下多张图拼成一张 contact sheet(缩略图网格)
|
||||||
|
|
||||||
## 使用说明
|
## 使用说明
|
||||||
通过 `skill`(op=run)调用,参数 `input_args`:
|
通过 `skill` 的 `{"run":"img-utils","args":{...}}` 调用,参数:
|
||||||
- `action`:操作类型(必填)
|
- `action`:操作类型(必填)
|
||||||
- `input`:输入图片或目录(必填;相对会话工作目录的路径即可,会自动转绝对路径)
|
- `input`:输入图片或目录(必填;相对会话工作目录的路径即可,会自动转绝对路径)
|
||||||
- `output`:输出路径(建议给全;不给时自动生成 `<原名>_<动作>.<原扩展名>`,绝不覆盖原图)
|
- `output`:输出路径(建议给全;不给时自动生成 `<原名>_<动作>.<原扩展名>`,绝不覆盖原图)
|
||||||
|
|||||||
@@ -66,7 +66,7 @@ output_schema:
|
|||||||
|
|
||||||
## 调用方式
|
## 调用方式
|
||||||
|
|
||||||
通过 `skill`(op=run)调用,参数:
|
通过 `skill` 的 `{"run":"x2pdf","args":{...}}` 调用,参数:
|
||||||
- `input`:输入文件路径(必填)
|
- `input`:输入文件路径(必填)
|
||||||
- `output`:PDF 输出路径(可选,默认与输入同名)
|
- `output`:PDF 输出路径(可选,默认与输入同名)
|
||||||
- `css`:自定义 CSS 文件路径(可选,仅 md/html/txt)
|
- `css`:自定义 CSS 文件路径(可选,仅 md/html/txt)
|
||||||
|
|||||||
Reference in New Issue
Block a user