用途：通过内置 scripts/datalore CLI 完成 Datalore 工作区与笔记本相关任务，包括单元格创建/编辑/运行、文件读写、数据库查询、报表布局与发布等。CLI 为 uv run --script 形式，内联固定 Python 依赖，封装公开的 notebook/user/workspace API，会话上下文保存在 .datalore-session。
主要能力：顶层命令集为 init、workspaces、workspace、notebook、logout。workspace 下管理工作区资源（info、entries、reports、folder、mkdir、create-notebook、rename、move、回收站操作、database query 等）；notebook 下管理内容与附件（cells、cell create/edit/run/outputs、files、file read/upload/delete、kernel status/interrupt、agent stop、worksheet、report、definitions 等）。支持 --json 输出机器可读结果，但 file read/download 与 workspace database query 流式输出原始字节/CSV，不可与 --json 同用。
使用方式：认证优先读取 DATALORE_API_TOKEN，否则使用系统钥匙串中按 scope 保存的凭据；无有效凭据时 init 启动 OAuth PKCE 浏览器登录并保存凭据。初始化需在任务工作区执行，例如 tools/skills/datalore-notebook/scripts/datalore init <notebook-url> --scope notebook_api；工作区会话可加 --access read|create|full 与 --workspace-id，笔记本上下文可用 --notebook-id <ownerId>/<notebookId>。所有命令首次应在宿主环境执行（含 --help），CLI 启动时会做只读钥匙串探测，沙箱内无法运行，不要设置 UV_CACHE_DIR 或在沙箱内重试。
适用场景：需要以 CLI 方式读取或修改 Datalore 笔记本、工作区资源、数据库与报表的自动化任务。限制：授权要求为最低要求，更宽 scope 覆盖更窄 scope（user_full > workspace > notebook_with_workspace_view > notebook_api > user_basic），更高 access 覆盖更低 access（full > create > read）；workspace database query 需 Full 访问；报表读取需 notebook_api，修改/发布在 workspace 会话下需 Full 访问。初始化前会做版本兼容预检，若 CLI 报告技能与 Datalore 部署不兼容，应停止并让用户对齐版本（Datalore 2026.2.x 可安装技能 2026.2.2，或升级到 2026.3+）。旧版无 URL scheme 的钥匙串凭据不会被复用，需重新 init。不要手工编辑 .datalore-session。