edgeone 1.5.9 → 1.6.0

package/edgeone-dist/libs-pages-agent-toolkit/README.md

@@ -0,0 +1,8 @@
+# pages-agent-toolkit wheel
+
+此目录存放 `pages-agent-toolkit` 的 Python wheel 文件，随 CLI npm 包一起发货。
+
+构建期通过 PEP 508 `pages-agent-toolkit @ file://...` 语法让 uv/pip 直接读本地文件，
+绕开 PyPI index 解析（该包仅发布在内网 PyPI）。
+
+由 `npm run prepare:agent-toolkit-wheel` 自动准备，不要手动修改。

package/edgeone-dist/libs-pages-blob-python/README.md

@@ -0,0 +1,38 @@
+# libs-pages-blob-python
+
+这个目录存放随 `@tencent/edgeone` npm 包一起发布的 `pages-blob-python` wheel 文件。
+
+## 为什么要打进 CLI？
+
+`pages-blob-python` 发布在公司内部 PyPI 镜像上，外网用户的 pip/uv 默认 index
+解析不到。把 wheel 随 CLI 发货，用户执行 `npm install -g @tencent/edgeone`
+时就已经拿到了 wheel；`edgeone pages build` 构建 agent-python 项目时，CLI
+会用 PEP 508 `pages-blob-python @ file://...` 语法把这个本地 wheel 注入到
+`.edgeone/agent-python/lib/`，整个过程不需要联到内网 PyPI。
+
+## 目录内容
+
+- `pages_blob_python-<version>-py3-none-any.whl`：随构建打入的 pure-Python wheel
+- `README.md`：本说明
+
+## 如何更新 wheel？
+
+不要手动把 wheel 放到这里。统一通过 CI 脚本拉取：
+
+```bash
+cd packages/tef-cli
+node scripts/prepare-pages-blob-wheel.js
+```
+
+脚本会从内网 artifactory 下载指定版本的 wheel 覆盖写入当前目录。本地开发时
+若脚本无法访问源（例如外网），脚本会检测已有 wheel 是否满足版本约束，满足
+则跳过；不满足则报错退出。
+
+## 运行时行为
+
+参见 `src/pages/builder/impls/agent-python.ts` 的 `getPagesBlobWheelPath()`
+和 `AGENT_PLATFORM_DEPS` 装配逻辑。两种 CLI 形态都要覆盖：
+
+- **bundled**（`edgeone-dist/cli.js`）：wheel 随 npm 包发货，在 CLI 根目录下
+  的 `libs-pages-blob-python/`
+- **source**（ts-node/vitest）：同一路径，仓库自带