feat(local): 技能不再因缺 python3 整体隐藏;缺解释器时先问用户再装
A1:link_skills 恒指向仓库 skills。原来没有 python3 就把 skills_root 指到空目录, 把所有技能一起藏掉——但技能不一定是 Python 的(office 是 SKILL.md + terminal 里调 officecli,跟 python3 无关),一刀切会误伤。而 run.py 类技能缺解释器时 skills.js 的 runEntry 对 spawn error 有处理,模型拿到「技能入口启动失败:spawn python3 ENOENT」, 干净可读,不需要靠藏清单避险。状态页/终端文案同步改成「python3 未安装:Python 技能 会失败,非 Python 技能不受影响」。 B2:env-local 允许模型装运行时,但必须先问用户;仍禁止 sudo 与装系统包。 macOS 的 /usr/bin/python3 是 CLT 桩,真装要走 brew 或官方安装器,耗时长且可能改 PATH / 要管理员权限,这种改动不能默许自主执行。 文档同步:docs/local-mode 4.4 重写(记录为什么不再切换)、4.13 补 B2 理由、 验证表该行标为待复测;local/README 的可选能力表与已知限制同步。
This commit is contained in:
+5
-3
@@ -65,12 +65,13 @@ cd agent
|
||||
| 能力 | 需要 | 没有时的表现 |
|
||||
|---|---|---|
|
||||
| 语音输入 | `ffmpeg` + 设置页给 `asr` 填上游(`X-ASR-Base-Url` / `X-ASR-Model`) | 麦克风入口自动隐藏(`/api/asr/status` 返回 `enabled:false`),`mcp_asr` 子进程也不启动 |
|
||||
| 技能 | `python3` | 技能清单为空,其余功能不受影响 |
|
||||
| 技能 | `python3`(仅 Python 类技能需要) | 技能清单照常显示;调 `run.py` 类技能报「入口启动失败」,`office` 这类非 Python 技能不受影响 |
|
||||
| 网页搜索 | 无 | 装了 Node 就有(内置免费后端) |
|
||||
| 图片 / 视频生成 | 设置页给对应 MCP 填上游 key | 调用时报明确的缺参错误 |
|
||||
|
||||
装完 `ffmpeg` / `python3` 之后**重跑一次 `./local/start.sh`** 即可生效——这两项都不写进配置,
|
||||
靠「起不起子进程 / 软链指向哪 / 注入什么环境变量」切换。
|
||||
装完 `ffmpeg` 之后**重跑一次 `./local/start.sh`** 即可生效。`python3` 稍特殊:技能清单本来就在,
|
||||
只要新装的解释器落在 core 启动时 `PATH` 已包含的目录里(如 brew 的 `/opt/homebrew/bin`)就无需重启;
|
||||
换了目录就重跑脚本。这三项都不写进配置,靠「起不起子进程 / 注入什么环境变量」切换。
|
||||
|
||||
## 配置放哪
|
||||
|
||||
@@ -141,6 +142,7 @@ git pull
|
||||
- **技能依赖不预装**:本地没有 `agent-executor-init`,`skills/*/requirements.txt` 不会在启动时
|
||||
自动安装。技能缺包时会报 `ModuleNotFoundError`,模型会把缺的包装进 `skills/deps`
|
||||
(`AGENT_SKILLS_DEPS` 指向它,且已在该进程的 `PYTHONPATH` 里,装完下次运行即生效)。
|
||||
连 `python3` 都没有时,技能清单仍是完整的,模型会先问你、得到同意后才装解释器。
|
||||
需要系统库的包(如 `weasyprint` 依赖 pango/cairo)pip 装不了,得自己 `brew install`。
|
||||
- **首个 `npm install` 要联网**:启动器会自动选源、换源重试、并把装好的依赖缓存到
|
||||
`~/.cache/agent-local/`;之后重启 / 换 clone 都是本地解压,不需要网络。真要手动指定源:
|
||||
|
||||
+12
-7
@@ -2,7 +2,7 @@
|
||||
# local/start.sh —— 本机(macOS / Linux)一键启动 agent-core。
|
||||
#
|
||||
# 这个脚本只负责「把容器部署的形状换成本机形状」,不改任何业务逻辑:
|
||||
# 1. 探测环境(node 必需;ffmpeg 决定能不能语音;python3 决定技能可不可用)
|
||||
# 1. 探测环境(node 必需;ffmpeg 决定能不能语音;python3 决定 Python 技能能否执行)
|
||||
# 2. 首次运行:选工作目录 + 生成 local/config.local.yml
|
||||
# 3. 起 core(+ 四个同栈 MCP 子进程),就绪后打开浏览器
|
||||
# 4. 守护:core 退出就拉起来
|
||||
@@ -353,8 +353,8 @@ ui_checks() {
|
||||
else ui_step "Node.js 缺失或版本过低:$NODE_HINT" bad; fi
|
||||
if [ "$NPM_OK" = 1 ]; then ui_step 'npm 可用(装依赖用)' ok
|
||||
else ui_step 'npm 缺失:随 Node.js 一起装,重装 Node 即可' bad; fi
|
||||
if [ "$PY_OK" = 1 ]; then ui_step "python3 ${PY_VER}(技能可用)" ok
|
||||
else ui_step 'python3 未安装(可选,技能清单为空)' warn; fi
|
||||
if [ "$PY_OK" = 1 ]; then ui_step "python3 ${PY_VER}(Python 技能可用)" ok
|
||||
else ui_step 'python3 未安装(Python 技能会失败;office 等非 Python 技能不受影响)' warn; fi
|
||||
if [ "$FF_OK" = 1 ]; then ui_step "ffmpeg ${FF_VER}(语音可用)" ok
|
||||
else ui_step 'ffmpeg 未安装(可选,麦克风入口隐藏)' warn; fi
|
||||
if [ "$PORT_FREE" = 1 ]; then ui_step "端口 $PORT 可用" ok
|
||||
@@ -415,10 +415,15 @@ EOF
|
||||
say "工作目录:$ws"
|
||||
}
|
||||
|
||||
# ---------- 技能目录:用软链切换,不动配置 ----------
|
||||
# ---------- 技能目录:软链到仓库 skills,不动配置 ----------
|
||||
# 为什么不再按 python3 有无切换成空目录:技能不一定是 Python 的。office 就是
|
||||
# SKILL.md + scripts/office,模型在 terminal 里调 `office <cmd>`,跟 python3 无关;
|
||||
# 一刀切会把这类技能一并藏起来。而 Python 技能缺解释器时,skills.js 的 runEntry 对
|
||||
# spawn 的 error 有处理,模型拿到的是「技能入口启动失败:spawn python3 ENOENT」,
|
||||
# 干净可读,不会崩也不会挂住——没必要靠藏清单来避险。
|
||||
link_skills() {
|
||||
link="$RUNTIME/skills"
|
||||
if [ "$PY_OK" = 1 ]; then dest="$ROOT/skills"; else dest="$RUNTIME/empty-skills"; mkdir -p "$dest"; fi
|
||||
dest="$ROOT/skills"
|
||||
rm -f "$link" 2>/dev/null || true
|
||||
# 万一上次留下了真目录(老版本行为),先挪走再建软链
|
||||
if [ -d "$link" ] && [ ! -L "$link" ]; then rm -rf "$link"; fi
|
||||
@@ -957,7 +962,7 @@ fi
|
||||
|
||||
if link_skills; then
|
||||
if [ "$PY_OK" = 1 ]; then ui_step '技能:已启用(python3 就绪)' ok
|
||||
else ui_step '技能:已关闭(未安装 python3,装好后重跑脚本即可)' warn; fi
|
||||
else ui_step '技能已暴露,但 python3 未安装:Python 技能会执行失败' warn; fi
|
||||
else
|
||||
ui_step '技能目录软链创建失败,技能不可用' warn
|
||||
fi
|
||||
@@ -1028,7 +1033,7 @@ while :; do
|
||||
if [ "$PY_OK" = 1 ]; then
|
||||
say '技能:已启用(python3 就绪)'
|
||||
else
|
||||
say '技能:已关闭(未安装 python3;装好后重跑本脚本即可)'
|
||||
say '技能:已暴露,但 python3 未安装——Python 技能调用会失败,其余照常'
|
||||
fi
|
||||
if [ "$FIRST_RUN" = 1 ]; then
|
||||
printf '\n首次使用:左下角「用户区」→ 设置 → 模型池,添加平台和 API Key,然后点「重启」。\n'
|
||||
|
||||
Reference in New Issue
Block a user