应用 Deep links

生成 ghapp 链接，预填会话和自动化，并区分 GitHub task 与本地 session ID。

Deep links 让浏览器、文档或其他工具直接打开 Copilot app 的目标页面。公开链接使用官方 ghapp:// scheme；github-app:// 与 gh:// 仅作为兼容形式接受。

编码两层 URL

浏览器使用托管 launcher：

https://github.com/copilot/app/launch?open=ENCODED_APP_LINK

先编码 app link 内各查询参数的值，再对完整 app link 使用 encodeURIComponent 或等价函数，放进 open。例如：

ghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests

launcher 尝试交给应用，不能交接时显示后备页面。不要在 URL 提示中加入密钥或敏感用户资料。

页面与工作项

App link	目标
`ghapp://`	New
`ghapp://chats`、`ghapp://mywork`、`ghapp://recent`	Chats、My work、Recent Workspaces
`ghapp://github.com/OWNER/REPO`	打开或克隆仓库
`ghapp://github.com/OWNER/REPO/issues/NUMBER`	已添加项目中的 Issue
`ghapp://github.com/OWNER/REPO/pull/NUMBER`	已添加项目中的 PR，保留可选尾部路径
`ghapp://github.com/OWNER/REPO/tasks/TASK_ID`	继续 GitHub agent task
`ghapp://sessions/SESSION_ID`	打开应用本地工作区或会话
`ghapp://clone/OWNER/REPO`、`ghapp://repo/OWNER/REPO`	确认后克隆或进入仓库设置

TASK_ID 必须是 GitHub task ID，不能使用 runtime session ID 或应用本地 session ID。查询串和 hash 在打开时保留。

新会话参数

ghapp://session/new 和 ghapp://session/new/OWNER/REPO 都会在创建前显示确认。

参数	规则
`repo`	`OWNER/REPO`；无路径仓库形式必填，有路径形式可省略
`pr`	正整数 PR 编号，不能与 branch 同用
`branch`	新会话 base branch，不能与 pr 同用
`prompt`	可选初始提示
`mode`	`plan`、`interactive` 或 `autopilot`

自动化链接

ghapp://automations 打开列表；ghapp://automations/AUTOMATION_ID 打开任务，追加 /RUN_ID 打开某次运行。这两种默认指向 local；云端需加 ?mode=cloud，也可显式使用 mode=local。

ghapp://automations/new 只预填创建对话框，用户确认后才创建，支持：

参数	规则
`name`、`prompt`	任务名称与提示
`trigger`	`manual`、`hourly`、`daily`、`weekly`；`interval` 是参数别名
`time`	daily/weekly 的本地 24 小时 `HH:mm`；daily 可逗号分隔或重复，但所有时间分钟必须相同
`day`	weekly 的 `0`–`6` 或星期名称，0 为周日；别名 `schedule_day`，可逗号分隔或重复

无效 trigger、time、day 值会被忽略。应用 UI 支持的 CRON、Issue、PR 触发器并未出现在此 deep link 参数清单中，不能据 UI 能力自行构造 URL 参数。

插件表单

ghapp://plugins/install?source=... 的 source 必填，格式为 PLUGIN@MARKETPLACE。ghapp://plugins/marketplace/add?source=... 的 source 必填，为 OWNER/REPO 或 Git URL；都需编码参数值。

这些链接经过确认后打开 Customize → Plugins 的预填表单，仍需在应用中确认才会安装插件或添加 marketplace，不是静默执行入口。