dsh-github-copilot 0.4.0-alpha.87 → 0.4.0-alpha.91
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +3 -0
- package/CHANGELOG.md +12 -0
- package/README.md +109 -406
- package/README.zh.md +109 -417
- package/deployment-baseline.json +8 -1
- package/docs/agent-readiness.md +5 -0
- package/docs/auto-task-routing.md +79 -2
- package/docs/automatic-model-routing.md +168 -379
- package/docs/copilot-compaction.md +8 -0
- package/docs/copilot-usage.md +7 -9
- package/docs/dual-model.md +60 -46
- package/docs/image-input-compatibility.md +50 -79
- package/docs/images/copilot-model-preferences.png +0 -0
- package/docs/images/copilot-search-routing.png +0 -0
- package/docs/model-compatibility-acceptance.md +41 -0
- package/docs/npm-distribution.md +129 -178
- package/docs/official-first-016-alpha2.md +4 -0
- package/docs/official-first-020-rc1.md +4 -0
- package/docs/session-search-routing.md +123 -65
- package/docs/single-route-migration.md +112 -97
- package/lib/client.js +71 -17
- package/lib/client.js.map +1 -1
- package/lib/index.js +243 -45
- package/lib/remote.js +40 -1
- package/lib/types/auto-assessment-evidence.d.ts +46 -0
- package/lib/types/auto-model-host.d.ts +2 -2
- package/lib/types/auto-selection-explanation.d.ts +1 -0
- package/lib/types/auto-task-assessment.d.ts +5 -3
- package/lib/types/auto-task-classifier.d.ts +3 -1
- package/lib/types/pre-step-pressure.d.ts +8 -0
- package/lib/types/turn-selection.d.ts +26 -1
- package/package.json +1 -1
package/README.zh.md
CHANGED
|
@@ -1,495 +1,187 @@
|
|
|
1
1
|
# dsh-github-copilot
|
|
2
2
|
|
|
3
3
|
[](https://github.com/cloga/dsh-github-copilot/actions/workflows/ci.yml)
|
|
4
|
-
[](https://github.com/cloga/dsh-github-copilot/releases/latest)
|
|
4
|
+
[](https://github.com/cloga/dsh-github-copilot/releases)
|
|
6
5
|
[](./LICENSE)
|
|
7
6
|
|
|
8
7
|
[English](./README.md) | **简体中文**
|
|
9
8
|
|
|
10
|
-
|
|
9
|
+
为 DSH 提供 GitHub Copilot 账号模型发现、上下文 Auto 选模和 hosted search。插件复用 DSH 公开的原生适配器与一个 Host 端 OAuth 账号,不修改 Core,也不维护第二套模型目录。
|
|
11
10
|
|
|
12
|
-
|
|
11
|
+
**当前版本:`0.4.0-alpha.91`。支持宿主:官方 DSH / Windows Desktop `0.2.0-rc.2`。** 较早 DSH pin 仅是历史证据,不是当前安装目标。已发布、已安装到 profile、已被运行中的 Host 加载,是三个不同状态。
|
|
13
12
|
|
|
14
|
-
|
|
15
|
-
托管请求在原生图片转换后检查实际 MIME;若与账号明确公布的格式不兼容,
|
|
16
|
-
会在发送前报告具体错误。账号未公布的格式不作猜测,图片转换和历史仍由
|
|
17
|
-
Core 管理。详见[图片兼容性与限制](./docs/image-input-compatibility.md)。
|
|
13
|
+
## 你可以做什么
|
|
18
14
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
15
|
+
| 任务 | 入口 |
|
|
16
|
+
|---|---|
|
|
17
|
+
| 登录并管理账号模型 | **设置 → 模型 → GitHub Copilot → Sign in** |
|
|
18
|
+
| 排除/恢复单个模型 | **Manage → Model preferences** |
|
|
19
|
+
| 自动选择模型 | 选择 **Auto · Balance / Efficiency / Intelligence** |
|
|
20
|
+
| 让受支持子代理跟随父模型 | **插件 → dsh-github-copilot → 详情 → Follow parent model** |
|
|
21
|
+
| 设置搜索主 provider 与最终 fallback | **插件详情 → Web search** |
|
|
22
|
+
| 查看账号 Credits 与上下文证据 | Copilot 会话输入框;原生 Turn Usage 独立保留 |
|
|
25
23
|
|
|
26
|
-

|
|
27
25
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
> 当前文档与安装命令对应版本 `0.4.0-alpha.87`。源码、发布制品、已安装版本和实际加载运行时需分别确认;本地升级和中断会话的重启仍需用户批准。
|
|
31
|
-
|
|
32
|
-
Web search 路由现在优先显示在插件详情页;宿主不支持详情页插槽时才回退到 **设置 → 模型**或独立 Web search section。搜索子 Fiber 仍独立等待 Remote,不影响账号控件和既有搜索安全检查。
|
|
33
|
-
|
|
34
|
-
官方 rc.2 通过原生可实时修改的 `Config` 字段提供路由设置,而不是手工注册设置 namespace。保存会一次更新两个路由叶子,不重新挂载插件,也不修改普通安全设置。旧搜索模型覆盖值仍只能通过独立的显式操作重置。
|
|
35
|
-
|
|
36
|
-
## 兼容基线与待验收目标
|
|
37
|
-
|
|
38
|
-
托管 Copilot 返回 `408 / user_request_timeout` 且确认是读取请求体超时时,会显示 `COPILOT_REQUEST_BODY_TIMEOUT`,并在可观测时给出最终 JSON 的 UTF-8 字节数、有界的纯数字构成统计和 fetch 到响应头的耗时。构成分为会话、工具定义、顶层 system/instructions 和其他/封装;图片块与 opaque replay 是会话内互不重叠的子集。会话剩余部分包括文本/工具历史、封装及未知字段,不代表纯文本量;图片块包含 URL/引用,不是解码后的图片大小。耗时是往返时间,**不是上传时长**;字节不是 token、供应商大小上限或原因证明。缺失、未知结构、超出工作界限的证据明确标为不可用。仅在确认对应错误后才分析,不记录正文、凭证或 replay 内容。原生重试与失败分类保持不变。重试耗尽后,可据此选择**显式**调整原生图片 offload 预算或压缩可压缩历史;工具定义及 opaque replay 仍可能保留。另需检查网络/代理及 [GitHub 服务状态](https://www.githubstatus.com/)。压缩不保证成功,也无法修复网络或服务故障;调大客户端超时不会改变服务端超时。插件不会自动裁剪历史、改配置、切换模型、压缩或新增重试循环,未识别错误仍由原生流程处理。
|
|
39
|
-
|
|
40
|
-
托管 HTTP/SSE 聊天现区分**字节空闲**与**助手输出静默**。Core 原生计时只看助手 chunk,忽略 SSE 心跳;未修改原生适配器的合成测试已复现“仍有字节却超时”。默认连续五分钟无响应头/非空响应体字节仍失败;实际字节进展只允许助手输出静默延长到十分钟,持续心跳也不能无限等待,消费者处理输出的时间不计入空闲。`chatStreamLiveness: false` 恢复纯原生计时;显式 WebSocket/`auto` transport 保持原生行为。这修复已复现的误判机制,不保证消除所有重试或服务端 HTTP 408,也不证明某次生产故障中实际存在心跳。
|
|
41
|
-
|
|
42
|
-
| DSH 表面 | 精确源码 pin | Models UI 接口 |
|
|
43
|
-
|---|---|---|
|
|
44
|
-
| 受控 Desktop `0.1.1-rc.2` 基线 | `cloga-pi-ai-model-api` 上的受控 Core commit [`a772dbb`](https://github.com/cloga/deepseek-harness/commit/a772dbbde82780bff2b9394427e9f0a24cafa1d5) | 独立的 **Settings → GitHub Copilot** section |
|
|
45
|
-
| DSH `0.1.2-rc.1` | Tag commit [`a66e470`](https://github.com/deepseek-ai/deepseek-harness/commit/a66e4702047846cdaa10c66c9d3df3951f5ea70d) | **Settings → Models** provider card |
|
|
46
|
-
| DSH `0.1.3-alpha.1` | Tag commit [`d347e70`](https://github.com/deepseek-ai/deepseek-harness/commit/d347e703908d0406b7a7ef80e3a0e594d86b2215) | **Settings → Models** provider card |
|
|
47
|
-
| 官方 DSH `0.1.5-alpha.1` | Tag commit [`5dda764`](https://github.com/deepseek-ai/deepseek-harness/commit/5dda764ed3aa172535a7967b06ff95d9cbfe536a) | **Settings → Models** provider card |
|
|
48
|
-
| 官方 DSH `0.1.5-alpha.2` | Tag commit [`b2e3b2a`](https://github.com/deepseek-ai/deepseek-harness/commit/b2e3b2a0125854567a4a5fcba75782e42fe84901) | **Settings → Models** provider card |
|
|
49
|
-
| 官方 DSH `0.1.5-rc.1` | Tag commit [`183f08e`](https://github.com/deepseek-ai/deepseek-harness/commit/183f08e9c6dde7e36cd2318eaee70b0da08fb35e) | **Settings → Models** provider card |
|
|
50
|
-
| 官方 DSH `0.1.5-rc.2` | Tag commit [`fb2c4b9`](https://github.com/deepseek-ai/deepseek-harness/commit/fb2c4b9e698e30edb738bca4cf0618587db7d203) | **Settings → Models** provider card |
|
|
51
|
-
| 官方 DSH `0.1.6-alpha.1` | Tag commit [`0a15e36`](https://github.com/deepseek-ai/deepseek-harness/commit/0a15e36e7f82b6ed45af6fa9759f29b40dcd965d) | **Settings → Models** provider card |
|
|
52
|
-
| 官方 DSH `0.1.6-alpha.2` | Tag `dsh-v0.1.6-alpha.2`,commit [`ddefc45`](https://github.com/deepseek-ai/deepseek-harness/commit/ddefc45fbc7f8e46dd73185e68295696d1297887) | **Settings → Models** provider card |
|
|
53
|
-
| 官方 DSH `0.2.0-rc.1`(历史) | Tag `dsh-v0.2.0-rc.1`,commit [`4878cd`](https://github.com/deepseek-ai/deepseek-harness/commit/4878cdabd87d4041bdaff61d04c966883b9fd07a) | **Settings → Models** provider card |
|
|
54
|
-
| 官方 DSH 与 Windows Desktop `0.2.0-rc.2`(当前待验收目标) | Tag `dsh-v0.2.0-rc.2`,commit [`639ed0`](https://github.com/deepseek-ai/deepseek-harness/commit/639ed015397290b3745d163aafe02ffee4aa3f84) | **Settings → Models** provider card |
|
|
55
|
-
|
|
56
|
-
上表保留历史源码 pin;本版本**仅准入并 gate 精确的 `0.2.0-rc.2`**,旧 pin 不代表当前支持。已发布制品的合成 transport fixture 与开发依赖均精确针对 `0.2.0-rc.2` npm 制品。未修改标签源码 fixture 不构建或给 Core 打补丁。已审计签名 Desktop 的共享包清单,证明 peer 所有权而非插件已加载或真实端点。已有公开 Host、Client 与 Remote 接口保留。精确 peer 与 `engines.dsh` 只声明包准入,不是真实兼容性证明;插件不安装 Core 补丁。
|
|
57
|
-
|
|
58
|
-
### Alpha.11 兼容修复(#105)
|
|
59
|
-
|
|
60
|
-
Core `0.1.5-alpha.2` 新增必需的 `ResolvedPiAiProviderProfile.modelErrors`,并在 `PiAiAdapter.modelOf` 无条件读取。插件为自身已校验的账号描述符提供独立的空诊断 Map;被拒绝的模型不会进入 provider。不会修改上游 profile、catalog、prototype 或依赖制品。固定源码的真实 adapter 测试覆盖 resolve、prepare 和合成 stream,旧基线使用同一份插件代码回归。
|
|
61
|
-
|
|
62
|
-
旧 canonical Anthropic inline 请求若含有带内 `system` 消息,会在 probe 之前原样交还 Core,避免把系统权限降为 user turn;此类请求的 inline search 因而有意受限。旧 Responses inline wire 保持既有的显式 system 内容映射为 user 输入文本的行为,并非过滤 system 消息;托管路由始终使用 Core 原生传输。详细边界见 [兼容审计](./docs/agent-readiness.md#core-alpha2-compatibility-follow-up-105-planned-alpha11)。
|
|
63
|
-
|
|
64
|
-
### Alpha.12 发布验证前置依赖修复(#107)
|
|
65
|
-
|
|
66
|
-
首次 alpha.11 发布在打包前停止:真实 Session/Remote fixture 需要 Core 的 `mime-types`,但发布任务只安装了 pi-ai 依赖闭包。CI 与发布流程现在都在运行该 fixture 前显式安装未修改的固定版本 Session Controller 依赖闭包。保留全部测试,不修改 Core 源码或运行中的依赖;alpha.12 以新版本交付相同的运行时兼容修复。
|
|
67
|
-
|
|
68
|
-
### Alpha.17 Provider-aware 搜索路由(#118)
|
|
69
|
-
|
|
70
|
-
bundle 通过在插件详情页配置的自有策略分流搜索(Models 页作为回退):`auto` 优先合格的 Copilot 原生搜索,否则使用配置的默认 Provider;`fixed` 始终使用该 Provider。单独选择账号模型后,火山方舟等非 Copilot 聊天会话也能使用 Copilot 托管搜索。全部通过公开 web 服务组合实现,不改 Core 或预设。源码和合成测试不代表真实 Copilot 搜索、已发布或本机已生效;详见[分流验收范围](docs/session-search-routing.md)。
|
|
71
|
-
|
|
72
|
-
### Alpha.19 DSH 0.1.6 兼容适配(#125)
|
|
73
|
-
|
|
74
|
-
精确固定的 `dsh-v0.1.6-alpha.1` 源码 fixture 现在会等待串行 `agent/created` 初始化完成后,再读取 live Session projection。静态与运行时 gate 同时核对:继续通过 request-header/projection 取状态而不新增同步历史读取;MCP SDK v2 resource cursor;`dsh-ptc-runtime` 与 `dsh-workflow-ptc` 名称;隔离 Node PTC 的空模型环境;异步可取消的 Sandbox/Shell 准备;由应用消费者决定的可选插件启动失败;请求图片缓存移入 DSH cache 但 normalized attachment 路径保持独立;以及 Team task 的 provider-owned 分页。图片预算恢复不会把首个 `IMAGE_OFFLOAD_REQUIRED` 当作成功;fixture 会记录 Core `image/offload` projection,并证明重试后的 Copilot 请求仅发送带映射只读 normalized 路径的占位文本,不再发送图片字节。插件不导入或接管 MCP、PTC、Workflow、Sandbox、Shell、Team 服务。该 tag 没有通用 `HostGrant`/`hostGrants` API,插件也不注册此类耦合。Copilot tool schema 过滤继续移除 `pwsh`、文件与 `run_code` 的不可用提权参数,同时保留 Team 分页字段。本版本仅准备 Draft 兼容 PR,不表示已发布。
|
|
75
|
-
|
|
76
|
-
### Alpha.21 Desktop 共享包所有权修复(#125)
|
|
77
|
-
|
|
78
|
-
Candidate manifest 将 `@deepseek-ai/dsh-authorization` 与 `@deepseek-ai/schemastery` 声明为必需 Host peer,不再作为插件私有 runtime dependency。开发环境仍保留固定依赖,用于 standalone build、单元测试、Host import、Client loader 与 Remote codec 验证。真实 packed-tarball gate 会将全部 dependency/peer 与 hash 固定的 Desktop 0.1.5 实际 runtime descriptor、Desktop 0.1.6 生成 package-set 输入逐项审计,并拒绝打包 Host 共享包、把必需 peer 标为 optional、版本不兼容或新增但未审计的依赖。0.1.6 package-set 是 descriptor 生成的权威输入,但不是已经物化的 Desktop descriptor、live 激活、OAuth 或模型调用证据。本修复保留现有 Settings → Models provider card、认证入口、生命周期适配与图片卸载行为,也不弱化 Desktop validator。
|
|
79
|
-
|
|
80
|
-
### Alpha.22 Client React 所有权修复(#132)
|
|
81
|
-
|
|
82
|
-
实际 built Client 会从 DSH 浏览器 `ModuleLoader` singleton 请求 React。React 不是 Desktop Host shared package,也不应作为 Node profile 的必需 peer 安装。Alpha.22 声明 `dsh.client.external: [\"react\"]`,移除 root React peer,仅在开发依赖中保留 React。Packed verification 现在覆盖全部 required peer 与 Client external,确认真实 built Client 只向 loader 请求 React,并继续要求 authorization/schemastery 使用 Host peer。该修复解决 packaged Desktop 启动错误 `requires missing react@^18.2.0`,不启用 peer 自动安装、不打包第二份 React,也不弱化 Desktop graph validator。实际 packaged Electron 加载仍由下游验收 gate 证明。
|
|
83
|
-
|
|
84
|
-
### Alpha.25 官方优先的 DSH 0.1.6-alpha.2 适配
|
|
85
|
-
|
|
86
|
-
历史基线清单包含 `dsh-v0.1.6-alpha.2`,commit `ddefc45fbc7f8e46dd73185e68295696d1297887`;本版本不再准入此版本。严格 Remote descriptor 提供 alpha.2 所需的 `create()` factory,同时保留旧 Gateway 的 `schema` bridge;两者使用同一个严格 parser,不降级为 `src-json`。执行子代理的 projection 接受原生 `subagent/descriptor` **v3**;rc.1 已经是 v3,旧版 v1 假设属于插件错误,不是本次上游从 v1 升到 v3。插件 projection cache 提升到 **`stateVersion: 2`**,强制从事件重新折叠,不转换历史。未知/v1/v2 descriptor 历史保守拒绝且保持原样;需要继续工作时先审核旧子代理,再显式新建子代理,不能改版本号伪造转换。
|
|
87
|
-
|
|
88
|
-
源码 marker、本地基于 rc.1 的定向测试,以及十五个限定范围精确源码运行时测试(alpha.2 contracts 8、Remote 1、Session-context 6)已通过。完整本地 `pnpm verify` 通过:1373 个 Vitest 测试、2 个预期跳过、176 个 tooling 测试,以及类型检查、构建和 package smoke;pack/tarball 验证也通过。限定范围运行使用补充 resolver、官方 TypeScript `6.0.3`、声明的 `mime-types@3.0.2` 与 `ws@8.21.0` 和共享 Zod `^4.4.3`,不修改源码或依赖制品,不等于完整 official-root-helper 验收。完整 frozen 依赖安装仍被配置 mirror 对 `node-addon-require-builtin@0.1.6` 返回 HTTP 404 阻塞。**CI 验收尚未执行**;不宣称已发布制品兼容、真实 Desktop 激活、OAuth 或模型调用成功。[官方优先矩阵](./docs/official-first-016-alpha2.md) 记录精确官方源码、支持范围、保留差距与移除条件,不因未验证同等能力就断言官方没有该功能。
|
|
89
|
-
|
|
90
|
-
### Alpha.26 官方 DSH 0.2.0-rc.1 适配
|
|
91
|
-
|
|
92
|
-
历史源码目标是官方 tag `dsh-v0.2.0-rc.1`,commit `4878cdabd87d4041bdaff61d04c966883b9fd07a`;独立核实的 Windows Desktop 发布 feed 也报告 `0.2.0-rc.1`(SHA-512 `hPdqeajEHTXYEUOkOX7q1FflGU9jyOkRVDNSPxIDWhNihWjiVal0gtuT5zvtBRlX29VhqfHL31q4owGNp4ee6A==`)。当时未修改源码 fixture 覆盖插件 OAuth 凭据接口、账号模型发现与原生 adapter、reasoning/stream/tool、Web 搜索、Remote codec、Session context 与严格 schema 兼容;另以发布 npm 制品 fixture 验证包/类身份和合成传输。该证据并不证明 Desktop package-set、Electron 加载、真实登录或 profile 升级。
|
|
93
|
-
|
|
94
|
-
### Alpha.39 官方 DSH 0.2.0-rc.2 适配(#170)
|
|
95
|
-
|
|
96
|
-
当前仅准入官方 tag `dsh-v0.2.0-rc.2`、commit `639ed015397290b3745d163aafe02ffee4aa3f84`。其公开 adapter 依赖 pi-ai `^0.87.1`;插件精确固定 `0.87.1`,调整原生 transcript 的请求预算估算,保留相同的公开 stream 对象。安装预检通过公开 `bundlePatchPaths` 按原顺序组合 rc.2 bundle 的数组 patch,仍拒绝无效 manifest 和不支持的路由。签名 Windows Desktop 的 `dsh/desktop-runtime.json`(SHA-256 `29561160fb7825c3968708f5700564f4381a976985fc270ee5dcc42e5a0a3a54`)记录 287 个共享包,插件声明的 peer 与 rc.2 Host graph 匹配。参见[官方优先 rc.2 审查](./docs/official-first-020-rc2.md)。源码、制品及 Desktop peer 证据均不等于插件已加载、真实 Copilot OAuth 或模型调用。
|
|
97
|
-
|
|
98
|
-
安装不会协调旧 profile 内的 DSH Host peer 副本。升级前请检查实际依赖解析,确认 Desktop 解析到随附的 Host 模块版本;旧的 profile-local `@deepseek-ai/dsh-authorization` 可能遮蔽随 Desktop 捆绑的服务,因 Core peer 校验失败而禁用 authorization 及其依赖的账号插件。本包不会删除或替换这些文件。请遵循单独获批的 Desktop 修复流程,并先验证实际模块解析,再将启动故障归因于本插件。详见[0.2.0 官方优先审查](./docs/official-first-020-rc1.md)。
|
|
99
|
-
|
|
100
|
-
## 输入框附近的 Copilot 用量
|
|
101
|
-
|
|
102
|
-
Alpha.33 修正 alpha.32 调用公开 Session hook 时遗漏 selector 参数的问题;该错误可能导致已注册的用量入口在渲染失败后被撤下。必须单独验证符合条件会话中的正向显示,不能用已安装版本收据或登出时不显示代替。本修复只修改插件,不包含 Core 补丁或自动重启。
|
|
103
|
-
|
|
104
|
-
当前会话使用 `github-copilot` 或 `github-copilot-preview` 时,可选的 **Credits / 额度** 控件显示已登录账号本计费周期的已用量及服务端明确提供的剩余额度。控件通过公开 composer dock 增补,不修改原生 Context meter;切换其他 provider 后隐藏。展开可查看预算、重置时间、数据新鲜度并刷新。旧 Client 缺少公开插槽时只停用这一可选功能。
|
|
105
|
-
|
|
106
|
-
Alpha.35 对齐原生统计栏的次级字号、行高和 pill 间距。采用共用可换行横排布局的宿主可将 Credits 直接放在 Cache hit 后,空间不足时再换行;旧版宿主仍保留自己的布局。单个读数超过分配宽度时显示省略号,但无障碍文本、悬停提示和独立详情保留完整内容。插件不会移动原生 DOM 或替换统计组件;详见[响应式布局所有权与验收边界](./docs/copilot-usage.md#responsive-statistics-presentation-alpha35)。
|
|
107
|
-
|
|
108
|
-
数字不是 token 费用估算:旧计费账号显示 **Premium requests / 高级请求**;企业共享池可能只有已用 credits,没有个人剩余量。缺失数据显示不可用,不伪装成零或无限。刷新失败可保留明确标注的同账号历史快照;认证失效或账号变化会清除快照。受支持的原生 adapter 没有通过公开插件契约提供完整的会话 credit 计量,因此不显示这一无法提供数据的区域,也不会用账号余额差值推算。重置时间只在供应方明确提供有效且晚于快照观察时间的下次重置日期时显示;缺失、无效、零值或已过期的重置元数据直接省略,不因此丢弃其他有效的账号用量。
|
|
109
|
-
|
|
110
|
-
Host 使用现有 canonical OAuth grant 有界读取 GitHub 内部额度端点,不增加登录流程、凭据存储、模型传输、设置写入或模型切换。内部接口可能变化或拒绝访问;自定义企业端点不会被猜测。公开企业/组织报表也不被当作个人实时余额接口。详见[数据语义、生命周期与证据边界](./docs/copilot-usage.md)。合成测试不代表真实账号接口可用、账单实时或当前 Desktop 已生效。
|
|
26
|
+
图片来自实际已发布 Client 组件和隔离浏览器中的模拟模型,仅说明界面,不证明真实登录、模型可用性、搜索或 Desktop 已加载。
|
|
111
27
|
|
|
112
28
|
## 安装与登录
|
|
113
29
|
|
|
114
|
-
|
|
30
|
+
使用已校验的固定版本、指定 profile 和获准的包源。不需要 `copilot2api`、外部网关、手工粘贴 GitHub token、占位 key 或另装 `dsh-web-search-provider`。
|
|
115
31
|
|
|
116
|
-
|
|
32
|
+
安装前,解包已核验 checksum 的归档,以绝对路径运行包内**只读组合预检**:
|
|
117
33
|
|
|
118
34
|
```sh
|
|
119
35
|
node package/scripts/check-search-composition.mjs --profile-dir /absolute/profile --home /absolute/DSH_HOME --install-anchor /absolute/dsh/package.json
|
|
120
36
|
```
|
|
121
37
|
|
|
122
|
-
|
|
38
|
+
启动 patch 用重复的 `--patch /absolute/file` 提供。必须得到 `supported: true`;安装器不会自动执行此预检。不支持的/自定义 Web 组合及 `NONEMPTY_DISPOSABLE_PROFILE_ROOT` 均须停止。先保全非空 root,并核对公开组合能否完整重建,再另行批准规范化;不能默认清空。检查实际共享 peer 解析,避免旧 profile-local 包遮蔽官方 Desktop peer。
|
|
123
39
|
|
|
124
|
-
|
|
40
|
+
**独立具名 profile**:
|
|
125
41
|
|
|
126
42
|
```sh
|
|
127
|
-
dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.
|
|
43
|
+
dsh plugin --profile web add https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.91/dsh-github-copilot-0.4.0-alpha.91.tgz
|
|
128
44
|
```
|
|
129
45
|
|
|
130
|
-
Desktop
|
|
131
|
-
|
|
132
|
-
随后打开上表对应的 Models UI,找到 **GitHub Copilot**,点击 **Sign in** 并完成 GitHub device-code 流程。安装会修改指定 profile;是否立即激活取决于该 profile 的常规 reload/restart 策略。
|
|
133
|
-
|
|
134
|
-
### 用户授权流程
|
|
135
|
-
|
|
136
|
-
1. 打开 **设置 → 模型**,找到 **GitHub Copilot**。账号控件嵌入已有配置的 canonical `github-copilot` 卡片,不另显示页脚控制器;没有此类卡片时仍可用页脚 fallback(旧 Core 使用 **Settings → GitHub Copilot**)。已登录时,页面打开会自动确保缺失/idle/过期/error/loading的模型元数据就绪;新鲜 ready 缓存不发发现请求。正常流程无需添加原生 provider 或手动刷新。
|
|
137
|
-
2. 点击 **Sign in with GitHub** 后,验证码区域自动展开,提供醒目的一次性验证码、**Open GitHub verification page**、**Copy code** 和 **Cancel sign-in**。不需要再点一次 **Manage**。识别到 Desktop v1 宿主时,通过现有的同窗口外部导航处理交给系统浏览器,不依赖弹出窗口;网页版仍打开新标签页。如果没有打开,可选中并复制界面显示的验证网址到浏览器。插件无法确认系统浏览器是否已打开。
|
|
138
|
-
3. 复制验证码,打开验证链接,在自己的 GitHub 浏览器会话中完成授权。复制成功/失败均有可访问的反馈;手工复制仍可用。不要把 GitHub token 粘贴到 DSH。
|
|
139
|
-
4. DSH 只在授权进行中轮询。显式 **Start sign-in**(**Sign in with GitHub** 按钮,包括界面切换账号)成功后,无论立即返回还是轮询观察到成功,都只强制执行一次有界发现。验证码和验证链接清除,自动授权区域收起,账号显示 **Signed in、Manage**。手动打开的详情保持展开;取消清除旧验证码。失败仅显示安全的阶段诊断:`COPILOT_AUTHORIZATION_BEGIN_FAILED` 表示授权流程未完成;`COPILOT_ROUTE_REPAIR_FAILED` 表示授权已完成但本地路由修复失败。begin 失败还可以显示固定的“最近观察到的里程碑” (`AUTHORIZATION_REQUESTED`、`INTERACTION_PROMPT_OBSERVED` 或 `INTERACTION_NOTICE_OBSERVED`);它只表示公开 interaction callback 已观察到的进度,不代表失败操作或 credential commit。后者会保留认证,并提示前往 **Manage → Repair model configuration**。这些代码和里程碑不解释或解决底层登录失败,原始 provider 详情不会显示或记录。
|
|
140
|
-
5. 在 **GitHub Copilot** 分组选择接受的模型(稳定路由 ID 为 `github-copilot-preview`)。正常打开/使用会自动维护元数据,无需手动 **Refresh models**。**Manage → Model preferences** 提供搜索、**All / Enabled / Excluded** 筛选,以及逐个立即保存的 **Exclude/Restore** 操作;被排除的精确 ID 会退出托管 picker 与新 turn 的 Auto 候选,暂时不在账号元数据中的排除 ID 仍可恢复。已经选中的模型也可以排除:已准入的原生 turn 在后续工具步骤及重试中保留原模型,新 turn 不得再使用它。固定选择不会自动替换,需要在下一 turn 前另选模型。排除触发父级重绘时,保留已挂载的账号控制器及元数据,不重新启动状态检查或模型发现。排除不会改写历史、切换选择或修改账号权限。发现说明及能力警告收纳在独立的 **Discovery details** 中。
|
|
141
|
-
|
|
142
|
-
偏好读取失败时,已有账号模型仍以只读列表显示,未知排除状态不会伪装成已启用。明确的诊断码区分设置不可用与设置无效;**Retry** 仅重读 Host 状态,不刷新 OAuth 或发现模型。保存失败保留最后确认的状态。单次保存仅返回严格校验的模型偏好,不扫描会话、不读取凭据或完整账号状态。排除设置使用原生动态隐藏 Config 字段及路径级 CAS,保存无需重新挂载插件。原生配置队列、文件锁及 Loader 同步仍可能延迟确认;实际持久化完成前不会显示保存成功。账号模型发现成功不等于偏好设置或模型调用已正常工作。
|
|
143
|
-
|
|
144
|
-
### Auto 模型路由
|
|
145
|
-
|
|
146
|
-
**子代理只需设置一次:** 在插件配置页打开 **Subagent models → Follow parent model** 并保存,即应用于已有和新创建的受支持 Copilot 子代理及 Team mate,无需填写 Session ID 或逐个登记。父会话为固定模型时,子会话从下一轮跟随;父会话为 Auto 时,继承相同偏好并按各自上下文独立选模。正在执行的轮次不变,子会话自己的手动选择仍优先。默认关闭(`github-copilot.followParentModel: false`)。开启意味着接管创建时保存的模型选择,但不清除子会话的显式选择历史。旧 `parentModelFollow` 绑定独立保留,不自动迁移。参见[需求、mockup 与边界](./docs/parent-model-follow.md)。原生 Team 的创建时模型标签不会被改写。
|
|
147
|
-
|
|
148
|
-
托管 GitHub Copilot 分组提供三个平铺的虚拟选择:**Auto · Balance**(均衡)、**Auto · Efficiency**(效率)和 **Auto · Intelligence**(智能)。三档共用精确排除与输入适配后的账号合格模型池。现在依据账号返回的 **Powerful / Versatile / Lightweight** 分类和保守的上下文任务判断选择,不再把推理档位或上下文容量当作品质排名。即使 Intelligence,独立问候也用 Lightweight;简短但困难的推理仍用 Powerful。无法判断的任务,Balance/Efficiency 优先 Versatile,Intelligence 优先 Powerful。上一轮模型仍符合目标分类与输入要求时优先保持它,否则仅在同类候选间稳定等权选择。分类缺失、分类回退均明确说明。没有可容纳候选时保留最大输入预算的原生恢复;没有合格候选则明确失败。同轮工具步骤、重试和自动压缩保持同一决策。图片验证独立保留;搜索、真实模型/Usage 和历史仍由原有服务所有。参见[任务策略与边界](./docs/auto-task-routing.md)及[父子继承边界](./docs/automatic-model-routing.md#requested-parent-to-child-selection-inheritance)。Core picker 仍保持平铺。
|
|
149
|
-
|
|
150
|
-
本地规则也会将独立、单一代码围栏内的 JSON/CSV 转换和行排序识别为常规任务,将近期明确困难任务的精确续接识别为复杂任务;新任务会切断继承。`uncertain` 表示需求尚无法确定,本地依据不足不代表会话没有上下文。
|
|
151
|
-
|
|
152
|
-
语义判断**默认开启**,**仅在本地需求未知时**通过一次有界的辅助模型请求判断上下文任务。可设置 `github-copilot.autoSemanticAssessment: false` 关闭;已有的显式 false 配置会保留,不自动迁移。有界输入优先保留当前和前一条用户请求,但不会忽略上下文省略。它会增加延迟和供应方费用,不计入原生 Chat Usage。失败或判断上下文不完整不会被当作简单任务,而是保留保守本地依据。这次默认开启由用户明确授权,不代表已完成标注语料校准,也不是 GitHub 的私有 Auto 服务。
|
|
153
|
-
|
|
154
|
-
已完成的 Copilot 回复在原生 Usage/时间后显示 **Auto(偏好)**,点信息按钮查看本轮记录的选择原因;只有捕获到明确固定选择才显示**手动**。成功读取但没有保留记录时显示**选择方式未知**,不借当前 picker 推断历史。读取失败则显示**选择记录读取失败 → 重试**;重试只重新读取同一轮记录,不重新调用模型。显式会话 ID/轮次参数不再被 Chat 的自动会话绑定缩减,修复新 master/lead 回复遭遇原生网关参数数量错误的问题。不重复模型名、不另设 Model details 按钮:实际模型仍由原生 Usage 显示,其缺失归属行为未改变。新选择记录仅限当前 Host 内存且有容量上限,重启、释放 Agent 或淘汰后会丢失;兼容历史 Auto 记录仍可读取。公开 assistant-actions slot 只允许插件内部换行,不能改变原生固定高度尾栏。
|
|
155
|
-
|
|
156
|
-
信息按钮展示本轮实际捕获的任务/分类依据、回退和保持原模型/同类分配原因;辅助判断信息收纳在折叠区。旧记录没有详细依据时明确说明未保留原因,不用今天的设置反推。
|
|
157
|
-
|
|
158
|
-
选择标记独立于可选会话投影挂载。投影不可用时,原生已完成回合证据仍允许显示保留的 Auto/手动记录;归属证据不完整会在信息弹层中明确说明。这不会恢复丢失的选择记录,也不证明已安装的更新已在 Desktop 加载。
|
|
159
|
-
|
|
160
|
-
Alpha.79 进一步修复选模读取的 Host 端:通过官方 Remote 服务绑定与方法标记暴露现有决策存储,不再使用会被原生网关拒绝的普通对象。实际 Client→Host 连通回归覆盖源码发现和严格描述符两种方式。这补齐 alpha.76 的 Client 参数修复,不恢复已丢失记录,也不改变 Auto 的选模逻辑。
|
|
161
|
-
|
|
162
|
-
Auto 输入适配通过 Core 原生 TokenMeter 逐条估算消息,包含推理与工具历史,并保留原生当前上下文/工具定义测量值作为下限。缺失或无效的测量会明确报错,不再静默漏算后选模型。这能修复已知估算错误,但不能救回摘要输入已经超出所有合格模型预算的历史;详见[压缩恢复边界](./docs/copilot-compaction.md#existing-oversized-history-and-recovery-limits)。
|
|
163
|
-
|
|
164
|
-
Alpha.63 通过支持官方 Desktop 的原生 ChatNodeStore、移除必须为 JavaScript Map 的错误限制,修复尾栏不显示的问题。不改变 Auto 选择策略,也不能恢复 Host 重启后已丢失的选择原因。
|
|
165
|
-
|
|
166
|
-
**历史加载报错包含 `github-copilot/auto-model-decision`:**alpha.54 阻止新问题事件写入,但升级或重启不会修复已有日志。[显式恢复命令](./docs/automatic-model-routing.md#recovering-affected-histories)使用官方 codec 校验独立修复副本,同时保存原始字节备份。替换实际 Session 日志必须另行批准并先停止所有写入者;插件不会自动迁移历史。
|
|
167
|
-
|
|
168
|
-
如果使用原始 alpha.54 恢复工具后会话从列表消失,请使用修正后的源码恢复工具:它会恢复 Desktop 发现会话所需的独立 zstd 头帧,不删除或改变逻辑历史记录。报告中的 `reframedHeader` 表示此项修复;原工具仅校验逻辑事件,并不足以证明 Desktop 可读。
|
|
169
|
-
|
|
170
|
-
新 Session 继承任一默认 Auto 偏好时,首次解析请求会把准确的虚拟偏好记录为该 Session 的持久选择,请求头仍记录实际模型。后续轮次继续保留该偏好,而不会固定到请求头;显式选择真实模型才切换到固定路由。旧 `auto` ID 保持均衡档。全局默认值变化不会迁移已有具体模型记录的 Session。
|
|
171
|
-
|
|
172
|
-
只有另一个符合条件的表面仍挂载时,切换才保留共享账号状态 owner。最后一个表面卸载或声明替换没有挂载重叠时停止轮询;以后挂载会先读状态,再按需另行确保元数据。状态读取和详情切换本身仍不访问网络,但打开 Models 可以发现缺失/过期的已登录账号元数据。后台凭据/reset 通知清除 Client 状态并只读查询,不在每次 token 事件强制发现;下次打开/使用时再确保元数据。
|
|
173
|
-
|
|
174
|
-
并发的状态重试共用紧凑账号控件尚未完成的读取。旧读取结束后,该控制器才为新的挂载生命周期读取;Remote 没有取消协议,因此永久挂起仍需恢复连接。授权轮询从 500 毫秒退避至 1 秒、再到 2 秒(响应立即返回时首分钟 32 次读取)。状态错误停止轮询并提供显式重试;登录、取消等写操作绝不自动重放。凭据失效通知和有界的首次元数据检查保留原有行为。这些措施只降低插件请求压力,不修复不兼容的 Agent preset 或 Core 全局请求调度。
|
|
175
|
-
|
|
176
|
-
公开的 provider-card slot 只能追加内容,不能替换 Core 的 **Edit/Delete**。原生编辑器仍保留,但正常插件发现流程无需手工定义模型。控件嵌入不等于合并 `github-copilot` 与 `github-copilot-preview`,不会删除配置、改写历史或切换模型选择。若已有卡片与 fallback 都缺少控件,请核对活动 profile 与实际加载的 Host/Client 版本。
|
|
177
|
-
|
|
178
|
-
低强调度的 **Updated … ago** 使用上次成功获取模型列表的时间,而不是打开页面的时间。悬停提示和无障碍标签提供本地完整日期、时间及时区;相对时间只在浏览器内更新,不请求状态或模型。读取缓存、刷新中或失败均保留上次成功时间(仅限仍有效的同账号展示证据);退出/账号失效后清除。没有有效时间戳则不显示;未来时间使用绝对日期,避免错误地显示“几分钟前”。Manage 内不再重复显示时间戳。
|
|
179
|
-
|
|
180
|
-
### Agent 与自动化流程
|
|
181
|
-
|
|
182
|
-
Agent 应把浏览器授权视为需要用户完成的 handoff,而不是自行获取 token 的任务:
|
|
183
|
-
|
|
184
|
-
1. 把固定版本的 release 安装到用户指定的 profile,并按该 profile 的要求 reload/restart。
|
|
185
|
-
2. 引导用户进入 **设置 → 模型 → GitHub Copilot → Sign in with GitHub**。
|
|
186
|
-
3. 请用户打开界面显示的验证链接并输入一次性代码;不得索取、读取、复制、记录或持久化用户的 GitHub token。
|
|
187
|
-
4. 等待用户在浏览器完成授权;已有授权正在进行时,不要重复创建新的登录尝试。
|
|
188
|
-
5. 确认 **Signed in** 并检查自动发现结果,再请用户选择模型。已登录时打开 Models 会自动确保缺失/过期元数据,新鲜 ready 缓存不发请求。错误可使用 **Retry**,有意强制更新时使用 **Manage → Refresh models**,不作为常规设置步骤。状态读取本身不发现;登录、元数据与真实调用成功是独立证据。
|
|
189
|
-
6. 只有用户明确要求断开账号时才使用 **Sign out**;它会删除 Copilot credential record,但保留 route settings。
|
|
190
|
-
|
|
191
|
-
每个新版本默认同时分发到 GitHub Releases 和 npm,两个渠道使用同一份已验证 tarball。应固定版本并核对所用渠道的证据:Release 的 `SHA256SUMS`;从 npm 安装时另核对 `dist.integrity`。Desktop profile 只能通过原生 Desktop 包管理器安装;获准且 registry 可用时输入 `dsh-github-copilot@0.4.0-alpha.87`,不是 URL 或本地文件。Desktop 保留 `desktop` profile,不能通过 DSH CLI 管理。受控离线 CLI 维护仅适用于独立具名 profile,不得作为 Desktop 安装绕行方案。[双渠道发布与 OIDC 要求](./docs/npm-distribution.md)保持不变。
|
|
192
|
-
|
|
193
|
-
**Desktop package 更新与 Web 生命周期边界:**原生 manager 对已安装 package 原位升级返回的 `restart-required` 是权威结果,与移除/重加 plugin bundle 的行为是两个不同问题。涉及服务重编排补丁(`cordis.patch.yml`,如本插件所采用的隔离路由 Web 搜索层)的停用、移除或升级,可能让依赖条目保持 pending,直到完全退出并冷重启 Desktop。若原生 manager 只报告类似 `pending (waiting for service: web)` 的条目,同时本插件已经显示 **Off**,说明请求的停用状态已经落盘;请冷重启 Desktop,不要反复切换或重装插件。其它错误不属于此提示范围,仍需单独排查。
|
|
194
|
-
|
|
195
|
-
pinned public Loader characterization 记录了:使用 bundle 的精确 ID 且 provider 已激活时,分阶段首次添加可能在 routed row 启用后仍令全局 `ctx.web` 和 consumer 不可用;另一独立序列从完整冷加载且正常工作的 Web-routing composition 开始,移除后全局 `ctx.web` 与 consumer 不可用,重加/重试 reconciliation 仍未恢复。较早的临时 harness 使用别名 ID 且没有 active provider,因此其最终添加成功并不等同于精确 bundle fixture。这些是合成 Loader 观察;上述原生 warning 属于运行证据,不代表所有 pending 诊断都可忽略,也不代表 fixture 已证明重启恢复。不要用移除/重加 bundle 作为热升级绕行。详见 [rc.2 生命周期 characterization 与有限的 public API 结论](./docs/web-lifecycle-rc2.md)。
|
|
196
|
-
|
|
197
|
-
**Host TLS trust 边界:**本插件只为额度请求添加系统信任根,不修改 Desktop 进程级信任、登录、模型、搜索或其他请求。之前带有正确环境变量的 Desktop 启动让额度恢复;后续恢复脚本启动没有继承进程变量,尽管 HKCU 保留 `NODE_USE_SYSTEM_CA=1`,额度仍再次失败;正常手动启动后又恢复。更新后的插件在获准升级和重新加载后消除额度请求对该继承链的依赖;仅发布包不会修改当前 Desktop profile、trust store 或进程。
|
|
198
|
-
|
|
199
|
-
不需要运行 `copilot2api`,不需要外部 gateway、placeholder API key、原始 GitHub token 或单独安装 `dsh-web-search-provider`。
|
|
46
|
+
**Desktop** 原生包管理器接受 `dsh-github-copilot@0.4.0-alpha.91`。官方 rc.2 **Desktop 随附的专属 CLI**也支持管理保留 profile;全局/普通 `dsh` shim 不等价。使用前核验实际安装入口,参见[Desktop CLI 核验](./docs/npm-distribution.md#desktop-bundled-cli-on-official-rc2)及独立的[具名 profile 离线流程](./docs/npm-distribution.md#controlled-offline-cli-maintenance-for-standalone-profiles)。两种路径都不授权绕过包源政策、修改 peer 或删除配置。
|
|
200
47
|
|
|
201
|
-
|
|
48
|
+
经批准 reload/restart 后:
|
|
202
49
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
- 保留 canonical `github-copilot` profile 的有意缺失;仅对已有旧配置修复 `compat.supportsStrictMode: false`,并按已核实的历史所有权记录恢复旧 override,不自动删除用户配置。
|
|
207
|
-
- 有界拉取账号 `/models` 元数据,校验端点、权限、工具/流式能力和限额,为 `github-copilot-preview` 提供账号绑定的不可变模型快照;新 ID 不要求新的代码表。
|
|
208
|
-
- 托管路由与尚未迁移的旧 canonical 路由共用唯一 Host OAuth 生命周期;取消失效账号的发现和请求,绝不复制 credential 到 Client。
|
|
209
|
-
- 保留公开 Thinking 摘要和合法的思考强度选择,原生回放及文件投影仍交给既有 adapter。
|
|
210
|
-
- 通过受限的 inline agent-loop interception 与 Responses-only `ctx.web` provider 直连供应方 hosted search。
|
|
50
|
+
1. 打开**设置 → 模型 → GitHub Copilot**,选择 **Sign in with GitHub**。不需要添加原生 provider 或手工定义模型。
|
|
51
|
+
2. 复制一次性验证码,在自己的浏览器完成 GitHub device flow。Desktop 交给系统浏览器;未打开时仍可复制界面中的验证网址。
|
|
52
|
+
3. 等待 **Signed in** 和账号发现完成,再选择模型。打开 Models 和正常使用会确保缺失/过期元数据;**Manage → Refresh models**用于有意强制刷新,不是日常设置前提。
|
|
211
53
|
|
|
212
|
-
|
|
54
|
+
退出须显式操作,只删除 Copilot 凭据记录,保留路由设置。升级保留已有原生 Copilot profile;在[显式单路由迁移](./docs/single-route-migration.md)前,仍可能存在两个分组。安装不迁移会话或默认模型。
|
|
213
55
|
|
|
214
|
-
|
|
56
|
+
**Desktop 生命周期:**停用、移除、升级后的 Web 服务重组可能需要完整冷重启。若插件已 Off,而原生 manager 仅提示 `pending (waiting for service: web)`,不要反复切换或重装。先取得重启许可,遵循[rc.2 生命周期说明](./docs/web-lifecycle-rc2.md)。
|
|
215
57
|
|
|
216
|
-
|
|
58
|
+
## Auto 与模型偏好
|
|
217
59
|
|
|
218
|
-
|
|
60
|
+
三档 Auto 共用账号验证、未排除的合格模型池。输入/图片能力等硬门槛先于任务偏好。
|
|
219
61
|
|
|
220
|
-
|
|
62
|
+
| 任务需求 | Efficiency | Balance | Intelligence |
|
|
63
|
+
|---|---|---|---|
|
|
64
|
+
| 已证实简单 | Lightweight | Lightweight | Lightweight |
|
|
65
|
+
| 常规 | Lightweight | Versatile | Powerful |
|
|
66
|
+
| 复杂 | Powerful | Powerful | Powerful |
|
|
67
|
+
| 未知 | Versatile | Versatile | Powerful |
|
|
221
68
|
|
|
222
|
-
|
|
69
|
+
分类来自认证后的供应方元数据,不按模型名、上下文容量或臆测质量排名。上一模型仍合适时保持,否则在合格分类内稳定等权分配;分类回退明确说明。同一已准入 turn 的工具步骤、重试和压缩保持同一真实模型。
|
|
223
70
|
|
|
224
|
-
|
|
71
|
+
语义判断**默认开启,仅用于本地需求未知的任务**。最多一次辅助请求,**8 秒端到端期限、128 tokens 输出预算**。可用 `github-copilot.autoSemanticAssessment: false` 关闭。超时/无效结果保留未知,再按偏好兜底,不解释为简单,也不换分类模型重试。用户取消和账号失效仍终止请求。辅助调用增加延迟与供应方费用,不计入原生回答 Usage。
|
|
225
72
|
|
|
226
|
-
|
|
73
|
+
回复的选模说明展示捕获的理由和可选的不含内容的辅助里程碑。`uncertain`、`insufficient-evidence` 不等于会话没有上下文。**Selection unknown**表示记录未保留,**Selection unavailable → Retry**表示读取失败;Retry 只重读该 turn,不重新推理。证据有界且仅限 Host 生命周期,重启/淘汰可能丢失。
|
|
227
74
|
|
|
228
|
-
|
|
75
|
+
**模型排除**将精确 ID 移出托管 picker 与新 turn 的 Auto 候选。已选模型也能排除:已准入 turn 保持原模型,但新 turn/直接调用不得使用;固定选择不会静默替换。偏好状态未知时只读,不伪装为已启用。保存采用窄范围原生 CAS,不读凭据、不发现模型、不扫描会话。
|
|
229
76
|
|
|
230
|
-
|
|
77
|
+
详见[任务判断](./docs/auto-task-routing.md)与[路由合同、排除和历史恢复](./docs/automatic-model-routing.md)。
|
|
231
78
|
|
|
232
|
-
|
|
79
|
+
## 子代理与搜索
|
|
233
80
|
|
|
234
|
-
|
|
81
|
+

|
|
235
82
|
|
|
236
|
-
|
|
83
|
+
**Follow parent model**默认关闭,在当前 profile 内作用于托管 Copilot 父会话的受支持原生子代理/Team mate。固定父模型从子会话下一 turn 生效;Auto 父会话传递准确偏好,子会话按自己的上下文选模。子会话的显式选择优先。运行中 turn、root、fork、其它 provider、旧专用策略不被改写;关闭宽泛开关也不移除旧绑定。[父模型跟随合同](./docs/parent-model-follow.md)。
|
|
237
84
|
|
|
238
|
-
|
|
85
|
+
**Web search**仅有两个常规选项:主 provider 与最终 fallback。Auto 在存在对应搜索注册时跟随发起 Chat provider;固定 provider 不随 Chat 模型改变。最多尝试一个不同的最终 fallback,明确提示可能费用;取消或账号 proof 失效不授权 fallback。
|
|
239
86
|
|
|
240
|
-
|
|
87
|
+
Copilot 搜索要求当前账号/协议证据及能力 proof。固定/fallback Copilot 保留非空旧 `searchModel`;否则最多考虑三个账号 Responses 候选。最终用户查询只发送一次,不跨候选重放。设置保存或 Chat 成功不证明 hosted search 可用。[搜索路由与组合](./docs/session-search-routing.md)。
|
|
241
88
|
|
|
242
|
-
|
|
89
|
+
旧 `github-copilot.searchFallback` 只控制独立的 canonical inline 路径,不是路由搜索的第三层 fallback;网页抓取不变。
|
|
243
90
|
|
|
244
|
-
##
|
|
91
|
+
## 用量、请求限制与恢复
|
|
245
92
|
|
|
246
|
-
|
|
93
|
+
**Credits**展示已验证账号计费周期数据,不是上下文 tokens 或会话成本。过期、组织共享及不可用数据保留真实语义。仅额度请求在保持 TLS 验签下合并 Node 与系统 CA;不改变登录、模型、搜索或整个 Desktop 的信任配置。
|
|
247
94
|
|
|
248
|
-
|
|
95
|
+
原生上下文占用与 Turn Usage 由 Core 所有。插件原样转发 usage,包括失败/取消时的零样本。独立上下文说明展示历史证据,不推断当前占用、不替换原生 `0%`。**Turn Usage incomplete**解释缺失样本/生命周期及已记录本地阻断,不编造零用量或部分总和。取消可以保留 usage,但不保证收到供应方最终回执。[用量边界](./docs/copilot-usage.md)。
|
|
249
96
|
|
|
250
|
-
|
|
97
|
+
托管请求准入保留真实输入/输出上限和原生事务。自动压力使用发起 Agent 真正绑定的压缩服务;preset 无引擎时不能借用全局恢复。已超限的手动摘要需另行选择[手动恢复](./docs/manual-compaction-recovery.md),不能承诺预防性准入已解决。
|
|
251
98
|
|
|
252
|
-
|
|
99
|
+
同一轮后续步骤已有托管路由、且没有待切换模型时,已知输入压力会在 Core 开始下次模型尝试之前压缩。原生压缩成功可避免一次无 usage 样本的本地压力拒绝导致整轮 Usage 不可用。首次步骤、待切换模型、新增固定前缀膨胀与最终硬预算拒绝仍保留原有准入;不会修复历史总量或虚构缺失用量。
|
|
253
100
|
|
|
254
|
-
|
|
101
|
+
严格核验的 `408 / user_request_timeout`诊断给出有界请求构成和可观察耗时,不证明供应方 payload 上限或根因。字节不是 tokens,耗时不是上传时长;小型无图请求也可能超时。参见[预算与超时指导](./docs/copilot-compaction.md),不要自动裁剪历史、禁用 proof、切换模型或增加重试。
|
|
255
102
|
|
|
256
|
-
|
|
103
|
+
HTTP/SSE liveness 默认区分 5 分钟字节 idle 和有界的 10 分钟助手输出静默,排除消费者工作;WebSocket/显式 `auto`仍仅使用原生路径。这不修复供应方 HTTP 408。图片按原生实际投影 MIME 证据准入;插件不负责转换,也不按文件名猜格式支持。[图片兼容](./docs/image-input-compatibility.md)。
|
|
257
104
|
|
|
258
|
-
|
|
105
|
+
## 设置与排障
|
|
259
106
|
|
|
260
|
-
|
|
107
|
+
配置位于 `github-copilot`。凭据、endpoint 和静态模型目录不是插件设置。
|
|
261
108
|
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
历史所有权使用有大小限制的 version-2 journal:记录原始 `api`/`models` 修改前后值、准备恢复的目标、namespace revision 与进程 epoch。只有固定公开的 Copilot headers 可进入 journal,不复制任意 header 值、credential payload 或自定义模型扩展。每次写入都检查 namespace revision;当前拥有字段必须仍匹配记录值。冲突时保留 journal 和用户修改,不猜测所有权。删除旧插件新建的 profile 还要求准确 preimage 为空、完整原始形状都属于插件,且没有 base profile、用户新增字段或已设置的 secret。不会把 schema 默认值或新发现模型写回原始设置。这是保守的恢复保障,不是跨 settings namespace 和 credential 存储的原子事务。
|
|
265
|
-
|
|
266
|
-
**升级边界:**没有 postimage/epoch 的旧备份会报告 `conflict`,不会自动接管。显式迁移或移除 marker 前应核对现有 route 与备份;不要通过重新登录或直接删除 marker 强行取得所有权。后续调用不会自动重放已经准备但未提交的启用或恢复写入:Core revision 不仅在重启时、也在 namespace 重新注册时归零,且没有公开的持久化注册身份。因此即使记录中的 epoch/revision 仍匹配,也不能据此证明跨该边界的所有权。稳定的已应用 postimage 可以开始恢复准确 preimage;已经完成且 target 等于准确 preimage 的恢复可以直接清理 journal,不重放写入。旧版按模型投影生成的 target 或无法安全恢复的 preimage 需要人工审核,不自动解释成新的所有权。非插件所有的旧连接字段如需删除,应由用户核对后显式处理。Sign out 本身仍只删除 `llm-pi-ai/github-copilot` credential record,保留 route settings。
|
|
267
|
-
|
|
268
|
-
### 只读状态与显式修复
|
|
269
|
-
|
|
270
|
-
`githubCopilot.status()` 与 Host `describeGitHubCopilotProviderProfile()` 只读取已存状态并规划旧 canonical 配置变更,不写 settings、不刷新 OAuth、不测试网络。状态区分凭据是否已配置,以及旧 route 的 `ready`、`needs-repair`、`not-configured`、`conflict`、`error`。已登录时,`route: not-configured` 通常表示可选的 canonical profile 不存在,是正常单托管路由状态,不是登录错误或修复要求,也不证明托管模型发现已就绪。`ready` 只说明受检查的 canonical 配置无需修复;账号发现与真实模型/搜索调用是独立证据。
|
|
271
|
-
|
|
272
|
-
点击 **Repair model configuration**(Remote `githubCopilot.reconcile()`)只对已有旧 profile 或经过验证的 journal 执行 revision 检查后的修复,不拉取模型列表、不创建缺失 profile,也不强行覆盖冲突。登录、启动及认证刷新时的 reconciliation 同样保留 profile 缺失。浏览器状态轮询为只读;本用户 Start sign-in 成功后,由 UI 另行触发那一次发现。部署时需一起更新 Host 与 Client bundle。
|
|
273
|
-
|
|
274
|
-
### 自动维护账号模型元数据
|
|
275
|
-
|
|
276
|
-
已登录且元数据缺失、idle、过期、error 或 loading 时,打开 Models 会另行调用一次非强制 Remote `githubCopilot.ensureModels()`。error 状态重新打开后可在共享失败冷却结束时重试,但不会在同次挂载内循环重试;loading 只加入已有 Host 请求以观察完成,不额外访问网络。新鲜 ready 缓存不拉取;真正 `unavailable` 且无模型的结果不自动重试。正常使用模型也会确保元数据有效。Host 合并并发调用为一个发现请求,不设周期刷新定时器。默认最大复用窗口为 **24 小时**(`accountModelTtlMs: 86400000`),失败冷却为 **5 分钟**(`accountModelFailureCooldownMs: 300000`),均可在插件 `github-copilot` 设置中配置。显式登录/界面切换账号成功后强制发现一次;**Manage → Refresh models**(`githubCopilot.discoverModels()`)与错误处的 **Retry** 仍可主动使用,必要时通过原生 OAuth 生命周期刷新令牌,不生成聊天请求或切换模型。
|
|
277
|
-
|
|
278
|
-
同账号上次元数据可以在 TTL 刷新、loading 或 error 时继续展示,但这种旧数据显示绝不能授权请求。凭据/账号/权限失效或 proof 到期立即撤销旧请求证据;24 小时只是最大元数据复用窗口,不延长 token。后台凭据/reset 通知清除 Client 状态并读状态,不对每次 token 事件强制发现;下次打开/使用再确保元数据。状态读取和详情切换本身仍只读且无网络请求。
|
|
279
|
-
|
|
280
|
-
创建新的元数据 lease 前,托管路由在前置检查阶段使用 **5 分 30 秒的续期阈值**:覆盖原生 SDK 提前 5 分钟续期的窗口,再留 30 秒准备余量。元数据准备会消耗这段余量,并不保证到后续 lease 创建或发请求时仍有完整的 5 分 30 秒。可复用的 warm 缓存进入该窗口时,先撤下旧缓存,再由现有 single-flight 发现流程完成原生 OAuth 续期、重新校验元数据,之后才准备模型调用;其它调用加入同一 flight,不用 force 绕过失败冷却。原生 `Models.getAuth()` 接收相同的最小有效期预算,续期后仍不足预算就提前失败,不循环刷新。状态读取仍不访问网络。这修复了自身续期可能使 warm-cache 请求报 `OAuth auth derivation failed ... COPILOT_PREVIEW_METADATA_STALE` 的路径。界面 **Updated** 是模型元数据时间,不是 OAuth 刷新时间。账号、权限和接口校验不放松;已经准备好的请求若等待过久跨入续期窗口或失去 proof,仍安全拒绝,不自动重放消息。托管搜索的连续性和探测检查保持独立,凭据通知后仍可能拒绝该次搜索。
|
|
281
|
-
|
|
282
|
-
明确的 `UNKNOWN_MODEL` 结果触发一次有界元数据刷新,不重放失败消息,不自动切换模型;普通 HTTP/网络错误不能猜成模型不存在。账号/token/权限代际检查阻止旧结果覆盖新账号;发现不复制凭据、不改写选择或历史。发现时间、接受/拒绝模型及能力警告仍只是元数据证据,不证明真实调用成功。
|
|
283
|
-
|
|
284
|
-
请求只发往凭据所有者校验过的 HTTPS Copilot 根地址,禁止跨主机跳转,整个响应按字节限为 2 MiB,模型数量和字段长度也有限制。不会采用响应中的任意 endpoint URL、header 或 secret;`supported_endpoints` 只是受支持的相对协议标识。缺失 policy 时,已保存账号可用 ID 仅能作为权限兜底,不能覆盖显式禁用;服务端明确启用的新模型可先于旧 grant ID 列表被发现,不需要篡改该列表。
|
|
285
|
-
|
|
286
|
-
Grant 写入或复用前,Host normalizer 只会把 pi-ai 文档化的 `type`、`refresh`、`access`、有限数值 `expires`、可选 `enterpriseUrl` 和去重后的可选 `availableModelIds` 重建为新的普通 JSON 对象。发现元数据不扩写 OAuth grant,缓存也不能独立授权实际模型请求。
|
|
287
|
-
|
|
288
|
-
## Hosted search
|
|
289
|
-
|
|
290
|
-
`auto` 模式的原生搜索身份来自捕获的发起 Session 有效 request-header/config 或显式 `GenerateOptions`,绝不使用未来全局聊天默认值;固定/兜底 Copilot 搜索则在 Provider 内部根据当前账号元数据解析执行模型,同时保留非空的显式 `github-copilot.searchModel` 覆盖值;不会借用 Chat 模型或另一个 Session 的选择。Core `Agent.options` 仍是激活时的 seed;模型选择覆盖 request/assembly,有效配置在工具调用前记录到 `Session.requestHeader().config`。没有可证明的发起 owner 时,传统搜索不可用。新模型已选择但下一次请求尚未开始时,不能把旧 header 当作当前 prompt 指引。按 owner 隔离的 plan 缓存保留不同模型 Session 的独立性;真实托管搜索冷启动时先非强制确保共享账号元数据,再派生模型事实并检查既有账号/协议/allowlist/probe。显式带标记的 `GenerateOptions` 仍可绑定符合条件的 inline 请求,没有 owner 时可不缓存,但保留所有既有检查。
|
|
291
|
-
|
|
292
|
-
**凭据变化限制:**初次惰性元数据发现期间出现 OAuth 通知时,现有公开状态无法区分发现自身的 token 轮换与外部换号。该次搜索会在 probe/wire 前以 `WEB_PROVIDER_UNAVAILABLE` 保守失败;之后用户/driver 可重新请求并使用已刷新的凭据,不自动重试,也不承诺首次刷新无缝成功。
|
|
293
|
-
|
|
294
|
-
- **旧 canonical inline agent-loop 路径:**仅在旧路由仍配置时,符合条件的 `github-copilot` 请求支持 OpenAI Responses 与 Anthropic Messages 原生搜索候选。
|
|
295
|
-
- **托管账号路由的普通对话:**`github-copilot-preview` 请求直接交给已注册的原生 adapter,不经过自定义 inline wire,以保留该路由的账号证据、回放和附件处理。
|
|
296
|
-
- **通过 `ctx.web.search()` 使用 `github-copilot-hosted`:**只支持账号可用且协议经过核实的 OpenAI Responses 候选,包括符合条件的托管账号模型。
|
|
297
|
-
- **Chat Completions 模型:**可走普通原生 SDK transport,但不会因此宣称 hosted search 可用。
|
|
298
|
-
|
|
299
|
-
### 按会话能力分流搜索
|
|
300
|
-
|
|
301
|
-
新版 bundle 通过插件自有的 web 服务外观层分流,将原官方服务及完整配置保留在命名作用域中,不修改 Core 或会话预设。原生 `web_search` 保留参数校验、查询/来源数量限制、执行中间件、超时和结果展示;有可靠发起会话上下文的直接 `ctx.web.search` 调用也使用相同分流规则。
|
|
302
|
-
|
|
303
|
-
在 **插件 → dsh-github-copilot → 详情**中,**Web search** 卡片通过公开的 `plugins.bundle.config`(按包名索引)设置跨后端搜索路由;搜索路由直接保存在 `github-copilot` 命名空间的 `searchRouting` 路径下,并通过嵌套路径一次完成修订号校验写入。若 bundle slot 不可用,路由卡片回退到 **设置 → 模型**;若 Models footer 也不可用,则回退到 **设置 → Web search**。同一时间只注册一处路由卡片,离开详情页会丢弃未保存的草稿。账号登录、状态及模型刷新仍在 **设置 → 模型**。仅打开页面不会迁移或改写已有设置;已移除的内部托管搜索调参表单不再属于用户配置。卸载本插件后恢复原 web 服务。
|
|
304
|
-
|
|
305
|
-
**Search provider** 主选择器提供 **Auto — follow Chat** 和通过路由外观层实际注册的搜索 Provider;**Fallback provider**(兜底后端)使用同一目录,额外提供 **None — no fallback**。选择项代表搜索后端,不代表单个模型:即使多个账号模型可以执行搜索,Copilot 仍然只有一个搜索后端。普通配置只需选择这两个 Provider,不再要求另选搜索模型。
|
|
306
|
-
|
|
307
|
-
- `searchRouting.searchProvider: auto` 跟随发起 Chat 的 Provider。本插件自有 Copilot 别名保留既有 owner 和模型能力检查;其他 Chat Provider 的原始 ID 必须精确匹配已注册的搜索 Provider ID,不猜名字、后缀或模型家族。这是路由约定,不承诺独立注册的后端一定使用相同模型或账号。
|
|
308
|
-
- 将 `searchProvider` 设为具体 ID,就固定主搜索后端,不再随 Chat 改变。
|
|
309
|
-
- `defaultSearchProvider` 仅在无匹配主后端或主搜索失败时作最终兜底,最多尝试一次;与主后端相同时不重试,成功但结果为空也不触发兜底。`none` 仅关闭兜底,不关闭主搜索。
|
|
310
|
-
- 显式选择 Copilot 或将它作为兜底时,内部按模型 ID 排序,从当前账号路由事实中最多考虑三个符合条件的 Responses 候选。默认要求能力 probe 成功后才发送一次用户的最终查询;元数据本身不是能力证明,最终查询失败也不会跨模型重放。内部选择不改变 Chat 或全局默认模型。其他后端自行管理模型配置(若有)。
|
|
311
|
-
- 已保存的非空 `github-copilot.searchModel` 仍具有优先权;覆盖值无效时不会静默换成其他模型。只读详情提供独立、显式的恢复自动选择操作(`searchModel: ''`);保存 Provider 路由绝不修改该覆盖值。
|
|
312
|
-
|
|
313
|
-
旧 `searchMode: auto/fixed` 配置继续兼容读取,不自动写入。旧 fixed 保留原 default 作为主后端;fixed 加 `none` 继续禁用。用户明确保存后,通过一次带修订号校验的 mutation 在已有的 `github-copilot` 命名空间中同时写入嵌套路径 `searchRouting.searchProvider` 与 `searchRouting.defaultSearchProvider`,不依赖模型发现或账号凭证,并协同维护修订号以避免与独立重置覆盖值发生虚假冲突。稳定的 Remote 引用避免外层页面重渲染重置草稿。发生修订冲突时,应重新加载已保存配置并重新应用所需选择;拒绝或未确认的响应不会被报告为成功。保存只证明配置持久化,不证明真实搜索能力。界面会说明保存将采用选中的最终兜底并可能产生 API 费用;旧的 `github-copilot.searchFallback: none` 失败兜底付费限制保留到明确保存新选择为止。已保存但未注册的 ID 保持显示为不可用,不静默替换。
|
|
314
|
-
|
|
315
|
-
`github-copilot.routeWebSearch: false` 仍委托原始 web 服务。其余情况下,取消、卸载及捕获的账号证明失效都不能触发兜底。通用注册后端必须遵守取消信号,但公开接口没有提供其内部鉴权后、网络发送前的检查钩子;历史 Copilot/DeepSeek 直调路径保留更强的自有发送前保护。两条路径都不会用 Copilot 登录替其他 Provider 提供凭据。
|
|
316
|
-
|
|
317
|
-
目录只包含本路由外观层观察到的注册,不包含直接在其他作用域注册的隐藏后端。列目录不做可用性探测、模型发现、凭据读取或搜索;实际调用时再检查可用性,不再把写死的示例列表当成已安装支持。非标准 web 组合仍需审查,网页抓取不变。详见[实现与验收范围](docs/session-search-routing.md)。
|
|
318
|
-
|
|
319
|
-
请求经过严格 Host 校验后,直接发往 credential 解析出的 HTTPS Copilot endpoint:GitHub-hosted `api.*.githubcopilot.com`,或已接受 GitHub Enterprise credential 对应的 `copilot-api.<signed-in-enterprise-domain>`。Credential 不会经过外部 gateway。
|
|
320
|
-
|
|
321
|
-
默认 `probe: true` 时,搜索 fail closed:当前 route 必须是 canonical Copilot 或本插件拥有的托管账号路由,账号必须允许该模型,所选协议必须支持对应搜索表面,且 bounded capability probe 必须成功。托管模型还必须有当前账号的有效发现证据,不能拿另一个 pi 副本的静态条目代替。显式设置 `probe: false` 只会跳过 capability proof,并信任所选原生协议;route、account、protocol、endpoint 与 authentication 检查仍然生效。底层 hosted-search provider 自身不执行回退;路由外观层可对符合条件的失败使用显式选择的最终兜底后端,但取消和 owner/账号证明失效仍立即终止。请求只要包含任意 Core file block(包括嵌套在 tool-result content 内的文件),也会 fail closed 到 `next()`,由 Core 保留文件投影,避免 hosted-search serializer 静默丢弃文件上下文。
|
|
322
|
-
|
|
323
|
-
搜索 proof 采用惰性验证:attach、settings 更新以及 `llm-pi-ai/github-copilot` 的 `credentials/record-updated` 事件只使缓存计划失效,不启动网络工作。下一次真实且符合条件的请求才重新验证;忽略无关凭据更新,连续事件不会引发重复的提前 probe。失效或卸载会取消正在执行的 proof。如果凭据在 proof 或最终认证解析期间改变,当前请求会 fail closed,避免把账号 A 的 proof 用于账号 B。更新后可重新提交请求;不会自动循环重试,也不会隐式使用 `probe: false`。
|
|
324
|
-
|
|
325
|
-
## 思考摘要与空 Think 条目
|
|
326
|
-
|
|
327
|
-
Thinking 修复包含两部分:托管账号模型通过原生 SDK 传递经过验证的思考强度并保留回放;符合条件的自定义 Responses 路径完整组装公开摘要。自定义路径优先采用请求显式强度,其次采用 provider profile 默认值,仅按所选模型明确声明的映射发送 wire 值,并请求 `summary: "auto"`。无法核实原生映射时交还注册 adapter,不用插件依赖副本猜 Core 的行为。
|
|
328
|
-
|
|
329
|
-
托管模型只提供供应方公布、且当前 SDK 能准确表达的思考等级。默认未选强度时保留供应方默认,不伪造 `off`、`none` 或未公布的 `high`/`max` 能力。存在无法映射的等级时显示 `REASONING_EFFORTS_UNSUPPORTED`,不把这些等级悄悄映射成其它档位;普通默认请求仍可用。显式选择不支持的等级会在模型请求发送前拒绝。兼容旧自定义配置时,`off` 仅保留 Core 的省略参数语义,不承诺关闭服务端推理。
|
|
330
|
-
|
|
331
|
-
Responses 解析器会保留公开的 `reasoning_summary_text`、`reasoning_text` 事件、仅在最终结果出现的摘要以及交错的分段内容,不会因完成快照重复追加已流式输出的文字。空项或仅有密文的项不会变成编造的解释。部分 Copilot Responses 请求仍可能返回加密推理但没有公开文字:[摘要是可选的](https://developers.openai.com/api/docs/guides/reasoning),请求摘要并不保证一定返回。插件不会解密或编造推理。
|
|
332
|
-
|
|
333
|
-
如果 assistant 历史包含 reasoning 块或不透明 `message.source.replayState`,请求会在 **probe 之前**绕过自定义 wire,由 Core 处理。公开摘要不能被重建成原始 `reasoning_text` 输入项,加密回放也由 Core 所有。这会有意限制这类历史中的 inline search;独立的 Responses-only `ctx.web` provider 仍按原有 route/probe 条件提供服务。
|
|
334
|
-
|
|
335
|
-
在通过兼容检查的 Chat 渲染接口上,Client 会隐藏已完成回复中空白或仅含空格的 Think 条目,且只处理该条回复自身记录的 provider 为 `github-copilot` 或托管账号路由 `github-copilot-preview` 的情况;其余显示仍交给 DSH 原生渲染器。真实摘要、答案、工具、图片与操作保持不变。正在运行、已中断、来源不明或非 Copilot 的回复保持原生行为,之后切换模型不会改变历史回复的归属。由于处理的是显示视图而不是搜索传输,它也能覆盖原生/图片请求路径及已加载历史,前提是存在相应的来源记录。
|
|
336
|
-
|
|
337
|
-
过滤只改变临时渲染 props,不改写持久化消息、加密签名、replay-state 块索引或 token 统计,后续请求仍保留原始推理上下文。不使用 DOM 轮询或全页面观察器;卸载插件会撤回该贡献并恢复原生显示。
|
|
338
|
-
|
|
339
|
-
此可选集成使用公开的 `conversation.chat.node` keyed slot 与 `uiConversation` location data。检查会核对当前名为 `AssistantNodeView` 的简单 memo 渲染器;未来改名或压缩后不匹配时保留原样。这是兼容检查,不是模块所有权或安全证明:公开注册器无法区分故意使用相同名称和元数据的替代实现。该集成不会因旧版 Core 缺少它们而阻塞登录。扩展接口缺失、不兼容或存在其他 assistant renderer 时,保留原生输出并给出命名明确的兼容诊断。新增显示行为不代表任何账号模型的真实 transport 已验证;不支持该接口的 Core 仍可能显示空 Think。它不会修改只控制 hosted search 的 `github-copilot.enabled` 设置。
|
|
340
|
-
|
|
341
|
-
## 托管请求预算与 compact
|
|
342
|
-
|
|
343
|
-
托管的 `github-copilot-preview` 路由在模型发送前估算完整原生请求,包括当前 system/工具定义,并分别检查独立输入上限及输入+输出总容量。实际输入预算为 `min(已提供的输入上限, 总容量 − 请求或默认输出预留) − 安全余量`,不把真实模型容量替换成预算数字。输出配置无效或完全没有输入空间时明确失败,不静默删历史、不自动换模型。
|
|
344
|
-
|
|
345
|
-
对于有原生 agent-loop 标记、发起 Session 与已记录请求配置一致、具备 token meter 且官方自动压缩已启用的普通请求,插件在预算的默认 90% 处发出本地估算压力信号。由 Core 执行原有的有界压缩、校验及请求重建,不在已冻结的请求中并发压缩。缺少可选接口时只关闭提前信号,最终原生预算检查仍保留;尊重 `auto: false` 和官方 overflow 重试次数为零的设置。不影响用户自有 canonical 路由或其他供应方。
|
|
346
|
-
|
|
347
|
-
Desktop 中的自动恢复与 Auto 诊断通过 Core 公开的 preset 查询接口读取发起 Agent 当前所属的压缩器,包括隔离分组。已绑定的 preset 没有压缩器时,不借用全局引擎。自动压缩仍走原生压力/错误恢复链路,不调用 `/compact` 或 `/copilot-compact`;分段恢复仍仅用于手动压缩。普通超时和传输错误不会被改判为上下文超限。
|
|
348
|
-
|
|
349
|
-
`purpose: 'compaction'` 的摘要调用绕过提前压力阈值,只检查完整硬预算。没有调用方或适配器已解析的思考等级时,`prefer-low` 从已支持的能力中选择 `minimal` 或 `low`;没有此能力则保持供应方默认。显式或已解析的等级优先。摘要请求的输出上限不被偷偷改写,保持 Core 辅助摘要记录一致;也不会将截断输出当成成功 checkpoint。`enabled` 仍仅控制 hosted search。
|
|
350
|
-
|
|
351
|
-
**仍不保证救回所有已经超限的旧历史。** 默认手动 compact 仍会在模型发送前拒绝超限摘要。另有可单独选择的[手动恢复引擎](./docs/manual-compaction-recovery.md):仅对可分割且工具调用配对完整的托管 Copilot 历史进行有界中间摘要,最终持久事务仍由 Core 负责。它必须**替换**原有压缩服务而非并列安装;仅安装插件不会启用。不可分割的输入、过大的固定前缀或被截断的输出都不会替换历史;不会自动切换模型或偷偷删除历史。
|
|
352
|
-
|
|
353
|
-
选用该恢复引擎且原生 jobs 服务可用时,`/copilot-compact` 会启动属于当前 Session 的后台压缩,不再让 Desktop 的命令 HTTP 请求等待整个摘要完成。使用 `/copilot-compact status` 查询最新任务,或 `/copilot-compact cancel` 请求取消。“已启动”不代表摘要成功,失败仍明确报告。完成后不会唤醒模型或恢复 Goal;原生 `/compact` 不变,任务状态不跨 Host 重启保存。
|
|
354
|
-
|
|
355
|
-
## Copilot Tool 兼容
|
|
356
|
-
|
|
357
|
-
为避免已观察到的无效 Copilot Tool payload,本包会把托管 route 的 `compat.supportsStrictMode` 叶节点设为 `false`,并在所选 provider 为 `github-copilot`,或已确认由本插件挂载的 `github-copilot-preview` 时执行两项仅作用于 Schema 的修复:从 Tool Schema 顶层删除 `sandbox_permissions` 与 `justification`,并把 Core 的多动作 `update_goal` 参数改写为带判别字段的 `oneOf`。这样每种 Goal action 只暴露合法字段:`complete`、`pause`、`resume` 不会携带编辑或阻塞字段,`blocked` 必须提供 `blocked_reason`,只有 `edit` 暴露替换字段。执行仍使用 Core 原本的 Goal Tool 与 Service。非 Copilot prompt assembly 完全不变。
|
|
358
|
-
|
|
359
|
-
Copilot Session 如需更宽的文件或命令权限,必须在调用前选择足够的 standing permission。安装代理还必须遵循:
|
|
360
|
-
|
|
361
|
-
- 初次 `pwsh` 调用不发送 `sandbox_permissions` 和 `justification`。
|
|
362
|
-
- Approval prompt 已关闭或当前已是 `danger-full-access` 时绝不发送。
|
|
363
|
-
- 只有真实 sandbox denial、approval 可用且目标模式更宽时,才能在同一命令的一次重试中发送。
|
|
364
|
-
- 必须完全省略字段,不能发送 null、空值或当前模式。
|
|
365
|
-
|
|
366
|
-
插件不会重写 `$DSH_HOME/AGENTS.md`。安装程序只有取得用户明确同意后,才能把规则合并进用户指令。
|
|
367
|
-
|
|
368
|
-
## 设置
|
|
369
|
-
|
|
370
|
-
插件 `github-copilot` settings section 控制账号元数据新鲜度、托管请求预算与 hosted search;`enabled` 仍只控制 hosted search:
|
|
371
|
-
|
|
372
|
-
插件详情页只提供 **Search provider** 与 **Fallback provider**。账号元数据、请求预算及 hosted-search 安全参数仍作为管理员和兼容工具可用的 schema 设置保留,不再作为普通用户的日常配置项展示。
|
|
373
|
-
|
|
374
|
-
| 键 | 默认值 | 作用范围与含义 |
|
|
109
|
+
| Key | 默认值 | 用途 |
|
|
375
110
|
|---|---:|---|
|
|
376
|
-
| `
|
|
377
|
-
| `
|
|
378
|
-
| `
|
|
379
|
-
| `
|
|
380
|
-
| `
|
|
381
|
-
| `
|
|
382
|
-
| `
|
|
383
|
-
| `
|
|
384
|
-
| `
|
|
385
|
-
| `
|
|
386
|
-
| `
|
|
387
|
-
| `
|
|
388
|
-
| `
|
|
389
|
-
| `
|
|
390
|
-
| `probeTimeoutMs` | `30000` |
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
-
|
|
412
|
-
|
|
413
|
-
-
|
|
414
|
-
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
-
|
|
418
|
-
- **没有 Think 文字:**供应方可能不返回公开摘要,但非空摘要应被完整保留。检查思考强度与命名错误。UI 只在完成后隐藏空条目,不显示加密回放;包含 reasoning/replay 的历史走 Core 原生 transport。
|
|
419
|
-
- **Hosted search 不可用:**显式/兜底 Copilot 应检查账号发现与 probe 诊断,普通设置不再要求手选搜索模型。旧覆盖值在明确恢复自动选择前仍具有优先权。Auto 跟随 Copilot Chat 时仍要求发起模型支持搜索。自定义 inline 仅适用于仍配置的旧 canonical 路由;保存 Provider 选择或普通聊天成功不能证明搜索可用。
|
|
420
|
-
- **仍有旧 endpoint/key:**reconciliation 有意保留非本包所有的字段;按显式迁移审核,不要强删所有权 marker。
|
|
421
|
-
|
|
422
|
-
## Package 入口与源码映射
|
|
423
|
-
|
|
424
|
-
公开 export 为 `.`, `./client`, `./remote`, `./deployment-baseline.json` 和 `./package.json`。
|
|
425
|
-
|
|
426
|
-
- `src/index.ts`:authorization bootstrap、依赖门控 Host 组合、settings、inline interception 与 `ctx.web` 注册。
|
|
427
|
-
- `src/authorization-controller.ts`:Host authorization 与路径级 route reconciliation。
|
|
428
|
-
- `src/copilot-grant.ts`、`src/copilot-auth.ts`:grant normalization 与 Host credential lifecycle。
|
|
429
|
-
- `src/client.ts`、`src/remote.ts`:Models UI 与 Client-safe Remote contract。
|
|
430
|
-
- `src/account-model-catalog.ts`:与模型名称无关的端点、权限、能力与限额解析。
|
|
431
|
-
- `src/account-model-source.ts`、`src/account-model-auth.ts`:有界、可取消的账号元数据发现与原生 OAuth 绑定。
|
|
432
|
-
- `src/preview-route.ts`、`src/preview-provider.ts`、`src/pi-provider-bridge.ts`:托管账号路由、公开 adapter/SDK 组合及跨版本公开事件流边界。
|
|
433
|
-
- `src/current-provider.ts`、`src/model-protocol.ts`、`src/plan.ts`、`src/probe.ts`:所属路由的元数据读取、搜索候选规划与 capability proof,不要求新增 Core 元数据服务。
|
|
434
|
-
- `src/temporary-models.ts`、`src/route-ownership.ts`:识别并保守恢复历史 override;不作为新模型发现的 ID allowlist。
|
|
435
|
-
- `src/responses-reasoning.ts`、`src/responses-reasoning-text.ts`:所选模型的思考等级映射与公开摘要组装。
|
|
436
|
-
- `src/wire.ts`、`src/wire-anthropic.ts`、`src/traditional-search.ts`:hosted-search transport。
|
|
437
|
-
- `deployment-baseline.json`:声明式、机器可读的兼容性/能力证据清单;`scripts/verify-deployment-baseline.mjs` 用源码与测试 marker 检查漂移。
|
|
438
|
-
- `lib/`:构建生成的 release 输出,禁止手工修改。
|
|
111
|
+
| `autoSemanticAssessment` | `true` | 本地未知任务的一次辅助判断 |
|
|
112
|
+
| `followParentModel` | `false` | 受支持子代理跟随,子会话显式选择优先 |
|
|
113
|
+
| `excludedModelIds` | `[]` | Model preferences 保存的精确排除 |
|
|
114
|
+
| `accountModelTtlMs` | `86400000` | 最多复用元数据 24h,不延长 token/proof |
|
|
115
|
+
| `accountModelFailureCooldownMs` | `300000` | 非强制发现失败冷却 5min |
|
|
116
|
+
| `chatStreamLiveness` | `true` | 托管 HTTP/SSE 字节观察 |
|
|
117
|
+
| `chatStreamIdleTimeoutMs` | `300000` | 字节 idle 期限,与搜索独立 |
|
|
118
|
+
| `chatMaxRequestImageBytes` | `20971520` | 原生 20 MiB 出站图片预算,非总 JSON 上限 |
|
|
119
|
+
| `requestBudgetSafetyTokens` | `4096` | 估算输入安全余量 |
|
|
120
|
+
| `requestBudgetPressureRatio` | `0.9` | 启用受支持恢复时的提前压力 |
|
|
121
|
+
| `compactionReasoning` | `prefer-low` | 未解析 effort 时采用受支持低档 |
|
|
122
|
+
| `enabled` / `probe` | `true` / `true` | Hosted search/能力 proof |
|
|
123
|
+
| `providers` | `[]` | 可选显式搜索路由 allowlist |
|
|
124
|
+
| `includeSources` / `stripServerTools` | `true` / `true` | Inline 引用/托管工具 schema 处理 |
|
|
125
|
+
| `idleTimeoutMs` / `probeTimeoutMs` | `300000` / `30000` | 搜索请求/probe 期限 |
|
|
126
|
+
|
|
127
|
+
| 现象 | 安全下一步 |
|
|
128
|
+
|---|---|
|
|
129
|
+
| 无登录控件 | 核对活动 profile 与已加载 Host/Client;不要只为显示登录而添加原生 provider |
|
|
130
|
+
| 已登录但缺模型 | 查看发现诊断,使用 Retry 或有意 Refresh,不反复登录 |
|
|
131
|
+
| 两个 Copilot 分组 | 审核[显式迁移](./docs/single-route-migration.md),不会自动移除 |
|
|
132
|
+
| 选模未知/不可读 | 区分记录丢失与读取失败;Retry 只重读 |
|
|
133
|
+
| 缺失/取消后的 Turn Usage | 查看[用量限制](./docs/copilot-usage.md),不推断零计费 |
|
|
134
|
+
| 历史加载报 `github-copilot/auto-model-decision` | 使用[独立副本、先检查的恢复](./docs/automatic-model-routing.md#recovering-affected-histories);未经批准且未停写不得替换实际历史 |
|
|
135
|
+
| AUTH、Responses replay scope 或 TLS 错误 | 查看[请求诊断](./docs/model-compatibility-acceptance.md#authentication-replay-and-request-diagnostics)及[额度 TLS 边界](./docs/copilot-usage.md#account-data-boundary),不自动丢 replay、重置凭据或关闭 TLS |
|
|
136
|
+
| Hosted search 不可用 | 检查账号/协议/probe 诊断;旧 override 保留至显式 reset |
|
|
137
|
+
|
|
138
|
+
## 所有权与深入阅读
|
|
139
|
+
|
|
140
|
+
DSH Core 所有会话、工具、sandbox、附件、原生计量和其它 provider;`llm-pi-ai`所有 OAuth、token 交换/刷新和普通模型传输。插件以认证后的账号元数据组合公开适配器,受支持的新模型 ID 无需名称路由补丁。凭据仅在 Host,key 为 `llm-pi-ai/github-copilot`。
|
|
141
|
+
|
|
142
|
+
公开接口不能替换 Core Edit/Delete、重构平铺 picker 或把原生 Add 变成单路由强制机制。已退役的[Model roles](./docs/dual-model.md)仅保留兼容。修复须遵循[plugin-only](./AGENTS.md#plugin-only-implementation-boundary)。
|
|
143
|
+
|
|
144
|
+
| 指南 | 范围 |
|
|
145
|
+
|---|---|
|
|
146
|
+
| [兼容验收](./docs/model-compatibility-acceptance.md) | 元数据、reasoning、replay 及公开接口限制 |
|
|
147
|
+
| [当前 official-first](./docs/official-first-020-rc2.md) | 准确 rc.2 seam 与保留差距 |
|
|
148
|
+
| [迁移](./docs/single-route-migration.md) | 新鲜只读就绪证据及显式 config-only 维护 |
|
|
149
|
+
| [分发](./docs/npm-distribution.md) | 同字节 GitHub/npm 发布和合格安装入口 |
|
|
150
|
+
| [Agent 指南](./AGENTS.md)、[贡献](./CONTRIBUTING.md) | owner、任务计划、gate 与交付政策 |
|
|
151
|
+
|
|
152
|
+
版本沿革见[CHANGELOG.md](./CHANGELOG.md)与不可变[Releases](https://github.com/cloga/dsh-github-copilot/releases),不再混入安装步骤。`deployment-baseline.json`保留历史 pin,但不准入为当前支持。
|
|
439
153
|
|
|
440
154
|
## 构建与验证
|
|
441
155
|
|
|
156
|
+
开发使用 Node 24 LTS 和 `package.json`指定的 pnpm;runtime Node 至少 22.19.0。
|
|
157
|
+
|
|
442
158
|
```sh
|
|
443
159
|
pnpm install --frozen-lockfile
|
|
444
160
|
pnpm verify
|
|
445
161
|
pnpm pack --pack-destination artifacts
|
|
162
|
+
pnpm verify:tarball -- artifacts/dsh-github-copilot-<package-version>.tgz
|
|
446
163
|
```
|
|
447
164
|
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
对于可选的思考显示集成,`pnpm verify:reasoning-ui -- <Core checkout>` 会在已安装 Chat 依赖的干净、精确 pin 的 `0.2.0-rc.2` checkout 中,执行合成的原生渲染器、Slot 注册器与历史组装 fixture。它只会独占创建一个临时测试文件,并仅在文件未被修改时清理。这是本地集成/静态渲染证据,不是真实浏览器或 Copilot API 测试;CI 仅覆盖当前目标,不表示本 candidate 已执行验收。
|
|
451
|
-
|
|
452
|
-
### Agent 驱动开发
|
|
453
|
-
|
|
454
|
-
在源码 checkout 中可使用以下只读入口;发现命令无需先安装依赖:
|
|
455
|
-
|
|
456
|
-
```sh
|
|
457
|
-
node scripts/agent.mjs describe --json
|
|
458
|
-
node scripts/agent.mjs doctor --json
|
|
459
|
-
node scripts/agent.mjs plan models --json
|
|
460
|
-
node scripts/agent.mjs attribution "DeepSeek Harness (DSH)"
|
|
461
|
-
```
|
|
462
|
-
|
|
463
|
-
`agent-contract.json` 把 authorization、models、search、client、compatibility、tooling、release 任务映射到负责文件和测试。Plan 返回尚未执行的参数数组,包含当前包版本对应的归档路径。Doctor 仅检查仓库前置条件:退出码 0 表示 preflight 通过,1 表示缺少依赖,2 表示参数或元数据错误。需要纯 JSON 时直接运行 `node`,不要解析 pnpm 的进度日志。
|
|
464
|
-
|
|
465
|
-
署名依据实际工具:DSH 协助的改动使用 `Assisted-by: DeepSeek Harness (DSH)`,不能因为模型来自 Copilot 就添加 Copilot App co-author。保留人类 Git author;`Co-authored-by` 只用于身份经过确认的真实协作者。用户要求交付的工作,在必要评审/CI 和分支保护通过后可合并,无需逐次另行询问。安装到 profile、登出和 worktree checkout 仍需要明确批准。重要更新默认包含合并后的发版交付,按下文规则继续推进,不再重复询问是否发版。
|
|
165
|
+
`pnpm verify`覆盖合同、类型、baseline、build、测试和构建入口 smoke。必需 CI 在 Windows/Linux 使用未修改的官方 rc.2 源码与发布制品。模拟测试通过不证明真实账号/模型/搜索可用。
|
|
466
166
|
|
|
467
|
-
|
|
167
|
+
Agent 从 `node scripts/agent.mjs describe --json`、`doctor --json`及`plan <task> --json`开始;计划仅返回未执行 argv,不授权副作用。完整变更/发布政策见[AGENTS.md](./AGENTS.md)。重要更新必须经受保护合并与双渠道发布;纯文档默认不发包。Profile 安装、退出和中断会话的重启另需许可。
|
|
468
168
|
|
|
469
|
-
|
|
169
|
+
提交以 `Assisted-by` 标明实际使用的工具,不用模型供应商或未经核实的协作者身份。
|
|
470
170
|
|
|
471
|
-
|
|
171
|
+
## Release 与 checksum
|
|
472
172
|
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
只有报告了已发布的 Release 链接、版本、tag/commit 及核验后的制品 SHA-256,才能称为发版交付完成。若被 CI、权限或网络阻塞,必须说明具体原因和待执行步骤,不能把“已合并”或“本地已构建”说成“已发布”。完整规则见 [AGENTS.md](./AGENTS.md#important-update-release-delivery)。
|
|
476
|
-
|
|
477
|
-
## Release 与 checksum 校验
|
|
478
|
-
|
|
479
|
-
`package.json` 声明公开 npm 分发。Release tag 必须严格等于 `v${package.json.version}`。预发布使用 `alpha`、`beta` 或 `rc` 及对应 npm dist-tag,只有稳定版使用 `latest`。Release workflow 执行 frozen install 和完整门禁,只打包一次(重试恢复原始归档),验证 `SHA256SUMS`,发布不可变 GitHub Release,再通过 OIDC 将同一份字节发布到 npm。任一渠道失败都表示交付未完成。首次建包须由获准环境中的维护者完成;staging 要求包已存在,不能代替首次建包。不会批量补发历史版本。
|
|
173
|
+
GitHub Releases 和 npm 分发同一原始已校验 tarball。固定版本并核验 Release SHA-256 或 npm `dist.integrity`;不重打包不可变 Release、不移动/复用 tag。
|
|
480
174
|
|
|
481
175
|
```sh
|
|
482
|
-
curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.
|
|
483
|
-
curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.
|
|
176
|
+
curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.91/dsh-github-copilot-0.4.0-alpha.91.tgz
|
|
177
|
+
curl -LO https://github.com/cloga/dsh-github-copilot/releases/download/v0.4.0-alpha.91/SHA256SUMS
|
|
484
178
|
sha256sum --check SHA256SUMS
|
|
485
179
|
```
|
|
486
180
|
|
|
487
|
-
PowerShell 可以对已下载的同一组文件执行:
|
|
488
|
-
|
|
489
181
|
```powershell
|
|
490
182
|
$expected = (Get-Content .\SHA256SUMS).Split()[0]
|
|
491
|
-
$actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.
|
|
183
|
+
$actual = (Get-FileHash .\dsh-github-copilot-0.4.0-alpha.91.tgz -Algorithm SHA256).Hash.ToLowerInvariant()
|
|
492
184
|
if ($actual -cne $expected) { throw 'Release checksum mismatch' }
|
|
493
185
|
```
|
|
494
186
|
|
|
495
|
-
Checksum
|
|
187
|
+
Checksum 检测损坏/漂移;受保护 workflow 和仓库控制建立发布来源。漏洞请通过[SECURITY.md](./SECURITY.md)私下报告。
|