> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuneplane.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 把一次运行分享给别人

> 给没有账号的人一个只读链接，看一次运行或一次对比。

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
curl -X POST https://tuneplane.your-company.com/api/job/share \
  -H "Authorization: Bearer $TUNEPLANE_CLIENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "run-4f2a91", "expires_hours": 24}'
```

返回一个 token。`https://tuneplane.your-company.com/share/<token>` 不需要登录就能打开这次运行。

在控制台里，用[作业详情页](/zh-Hans/console/job-detail)或[对比页](/zh-Hans/console/review)上的
**Share**。分享链接是为平台之外那场对话准备的：一个没有账号的同事、一个供应商、一个想看曲线但
不想学一套控制台的主管。

## 也可以分享一次对比

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
curl -X POST https://tuneplane.your-company.com/api/compare/share \
  -H "Authorization: Bearer $TUNEPLANE_CLIENT_TOKEN" \
  -d '{"job_ids": ["run-4f2a91", "run-8b1c02"], "expires_hours": 72}'
```

两到四次运行。链接打开在 `/share/compare/<token>`。

## 收到链接的人看到什么

| 分享的对象 | 他们能看到                    |
| ----- | ------------------------ |
| 一次运行  | 训练曲线、验证样本、配置、超参、硬件、环境和日志 |
| 一次对比  | 记分卡、主曲线和配置差异             |

他们不能提交任何东西、不能改任何东西、看不到别的运行，也到不了任何数据集内容。分享路由是一套独立
的只读面，不是把按钮藏起来的你的会话。

## 有效期

`expires_hours` 默认 24，上限 90 天。控制台提供几个预设；API 接受那个范围里的任何值。

选够这场对话用的最短有效期。一个 30 天的链接比需要它的那场讨论活得更久，而没人会记得去吊销它。

## 列出与吊销

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
curl -H "Authorization: Bearer $TUNEPLANE_CLIENT_TOKEN" \
  "https://tuneplane.your-company.com/api/job/shares?job_id=run-4f2a91"

curl -X DELETE -H "Authorization: Bearer $TUNEPLANE_CLIENT_TOKEN" \
  "https://tuneplane.your-company.com/api/job/share?token=<token>"
```

作业页会列出它现有的链接、各自由谁创建、什么时候过期。吊销立刻生效，不用等它自己过期。

## 确认成功

用一个隐私窗口打开链接。你应该看到这次运行，而且没有侧边栏。

创建和吊销分享链接都会记进[审计轨迹](/zh-Hans/console/audit)，带上人和对象。分享链接是唯一一个把
数据挪到平台鉴权之外的功能，所以它也是最需要留痕的那个。

## 下一步

[对比多次运行](/zh-Hans/console/review) · [作业详情](/zh-Hans/console/job-detail) ·
[审计轨迹](/zh-Hans/console/audit)