feat(local): 声明技能 Python 依赖,并放开「缺包自装进 skills/deps」
本地没有 agent-executor-init,技能的 requirements.txt 从来没人读: document-photo-to-pdf(numpy/Pillow/pymupdf)与 image-process(Pillow) 在本机只是碰巧用户的 python 里已经装了。 - 两个技能补 requirements.txt,一律不写版本号:服务端 init 用 pip install --no-index --dry-run 探测,pin 到与镜像不同的版本会让探测失败, 反而往 skills/deps 装一份旧的(PYTHONPATH 优先级高于系统 site-packages) - start.sh 起 core 时注入 AGENT_SKILLS_DEPS(该目录本来就在 PYTHONPATH 里), 把路径交给模型;terminal 与技能子进程都继承 core 的 env,装完下次运行即生效 - env-local.txt 把「永远不要自己装任何东西」换成「缺包时 --target 装进共享依赖层, 别动系统 Python」。用 --target 是因为 pip 对它的 PEP 668 拦截明确豁免, Homebrew 那种 externally-managed 解释器也能装 - 文档同步:local/README 已知限制、docs/local-mode.md 新增 4.13 记录取舍 服务端不受影响:这三行在 executor 镜像里都已满足(实测 --no-index --dry-run 均 exit 0),init 只写一个 gitignore 里的 .deps_installed 就跳过。
This commit is contained in:
+5
-2
@@ -138,8 +138,11 @@ git pull
|
||||
- **Windows 暂不支持**:本机执行走 `spawn('/bin/sh')` 与 `process.kill(-pid)`,都是 POSIX 语义。
|
||||
- **`mint_public_link` 不可用**:`public_link.base_url` 未配置(本地生成的链接只有本机能打开),
|
||||
模型调用该工具会得到明确的「未配置」错误。
|
||||
- **技能依赖**:有 `requirements.txt` 的技能需要自己把包装进 `skills/deps`
|
||||
(服务器上这一步由 `agent-executor-init` 在构建期完成)。默认只保证纯标准库技能可用。
|
||||
- **技能依赖不预装**:本地没有 `agent-executor-init`,`skills/*/requirements.txt` 不会在启动时
|
||||
自动安装。技能缺包时会报 `ModuleNotFoundError`,模型会把缺的包 `pip install --target`
|
||||
进 `skills/deps`(`AGENT_SKILLS_DEPS` 指向它,且已在该进程的 `PYTHONPATH` 里,装完下次
|
||||
运行即生效)。需要系统库的包(如 `weasyprint` 依赖 pango/cairo)pip 装不了,得自己
|
||||
`brew install`。
|
||||
- **首个 `npm install` 要联网**:启动器会自动选源、换源重试、并把装好的依赖缓存到
|
||||
`~/.cache/agent-local/`;之后重启 / 换 clone 都是本地解压,不需要网络。真要手动指定源:
|
||||
`NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh`。中途失败留下的半成品
|
||||
|
||||
@@ -813,6 +813,10 @@ check_mcp() {
|
||||
}
|
||||
|
||||
start_core() {
|
||||
# PYTHONPATH 把技能共享依赖层 skills/deps 放进 python 的搜索路径(与服务器上 executor 容器
|
||||
# 的 PYTHONPATH 对齐,那边由 compose 注入)。本地没有 agent-executor-init 替我们装包,
|
||||
# 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:模型在 terminal 里发现技能缺包时,
|
||||
# 按提示词里的写法 pip install --target "$AGENT_SKILLS_DEPS" 即可,技能下次运行就能 import。
|
||||
( cd "$ROOT/app" && exec env \
|
||||
PORT="$PORT" \
|
||||
HOST="$HOST_ADDR" \
|
||||
@@ -821,6 +825,7 @@ start_core() {
|
||||
AGENT_LOCAL_PICK=1 \
|
||||
ASR_URL="$ASR_URL" \
|
||||
PYTHONPATH="$ROOT/skills/deps" \
|
||||
AGENT_SKILLS_DEPS="$ROOT/skills/deps" \
|
||||
node server/server.js >>"$LOG" 2>&1 ) &
|
||||
CORE_PID=$!
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user