修复:技能远端执行的 cwd 落到会话目录,技能看不到会话文件

- runSkill 远端分支 cwd 由技能目录改为会话任务目录(ctx.taskDir),命中 executor 的 session 隔离与虚拟视图:技能在 /workspace/tasks/<sid> 看到的即本会话数据,absolutizeArgs 产出的绝对路径因此有效。此前 cwd 在任务根外走 plain 模式,/workspace/tasks 是镜像空目录,md2pdf/img-utils 这类读写会话文件的技能实际拿不到文件。本地分支行为不变。

- 入口脚本改传绝对路径(run.py/run.sh):cwd 不再是技能目录,相对入口会找不到。

- 依赖安装 ensureDeps 仍以技能目录为 cwd(依赖是技能私有资源,skills 为 :ro)。

- remote-exec 集成测试改为模拟真实会话(拆分虚拟路径/宿主机真实会话/隔离基路径),新增文件读写回归用例;同步 skills/README 与 ARCHITECTURE。
This commit is contained in:
2026-09-11 19:58:30 +08:00
parent 2feda4a210
commit 4e8560982f
4 changed files with 62 additions and 18 deletions
+5 -1
View File
@@ -167,7 +167,9 @@ Skill Manager 会为每个技能生成一个 `.deps_installed` 标记文件,
Agent 调用技能时,传入的文件路径可能是相对路径(相对于任务目录)。Skill Manager 会在执行前自动将相对路径转换为绝对路径,因此**技能脚本无需关心路径解析**,直接使用传入的路径即可。但请注意:
- 如果技能内部需要引用其他文件(如模板、字体),请使用基于脚本所在目录的绝对路径(`os.path.dirname(__file__)`)。
- **运行时的工作目录是「会话任务目录」,不是技能目录**(远端模式下即 executor 隔离视图里的 `/workspace/tasks/<会话>`)。技能进程只能看到当前会话的数据,看不到其他会话。
- 因此技能内部引用**自身资源**(模板、字体、配置等)时,**必须**基于脚本位置取绝对路径,不要依赖 cwd:Python 用 `Path(__file__).resolve().parent`,Shell 用 `"$(dirname "$0")"`。
- 读写会话数据用 `input_args` 里传入的路径即可;相对路径会被预转绝对路径,且在隔离视图里与 Agent 看到的是同一份数据。
---
@@ -191,6 +193,8 @@ cd skills/my-skill
python3 run.py '{"input": "/path/to/test", "output": "/tmp/out"}'
```
> 注意:手工调试时的 cwd 是技能目录,而**线上运行的 cwd 是会话任务目录**(见第 6 节)。所以脚本对自身资源的引用要用 `__file__`/`$0` 定位,手工调试才能与线上行为一致。
如果需要测试依赖安装,可以删除 `.deps_installed` 和 `deps/` 目录后重新执行。
---