@deepseek-ai/dsh-webhook-github 0.1.5-rc.2 → 0.1.6-alpha.1
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/README.i18n.yaml +1 -1
- package/README.zh.md +14 -14
- package/package.json +12 -12
package/README.i18n.yaml
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/webhook/webhook-github/README.md
|
|
5
5
|
README.md: 9c2b20f4abbc183fd5aa78454ce3b2c9266aa79c
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: 8dae90aaa7a1d6df6d50e3170f841e986ce6e97d
|
package/README.zh.md
CHANGED
|
@@ -9,15 +9,15 @@ kind: "package-reference"
|
|
|
9
9
|
|
|
10
10
|
## 概述
|
|
11
11
|
|
|
12
|
-
`dsh-webhook-github` 会在注入的 `ctx.webServer` 上注册一条精确 HTTP 路由。它限制并验证 GitHub 原始 JSON body,投影提供方无关的交付,调用 `ctx.webhookRuntime.dispatch()
|
|
12
|
+
`dsh-webhook-github` 会在注入的 `ctx.webServer` 上注册一条精确 HTTP 路由。它限制并验证 GitHub 原始 JSON body,投影提供方无关的交付,调用 `ctx.webhookRuntime.dispatch()`,并在不等待规则或会话的情况下返回 `202`。部署需要为通用 webhook 运行时提供经过身份验证的 GitHub 入口时,请使用它。
|
|
13
13
|
|
|
14
14
|
## 目录
|
|
15
15
|
|
|
16
16
|
- [配置](#configuration)
|
|
17
17
|
- [HTTP 约定](#http-contract)
|
|
18
18
|
- [专用监听器组合](#dedicated-listener-composition)
|
|
19
|
-
- [
|
|
20
|
-
- [
|
|
19
|
+
- [模型体验](#model-experience)
|
|
20
|
+
- [已知限制与延期工作](#known-limitations-and-deferred-work)
|
|
21
21
|
- [开发备注](#dev-note)
|
|
22
22
|
|
|
23
23
|
-----
|
|
@@ -47,9 +47,9 @@ kind: "package-reference"
|
|
|
47
47
|
| `405` | 方法不是 `POST`。 |
|
|
48
48
|
| `413` | 声明或流式 body 超过 `maxBodyBytes`。 |
|
|
49
49
|
| `415` | media type 不是 `application/json`。 |
|
|
50
|
-
| `503` | 凭据或 webhook
|
|
50
|
+
| `503` | 凭据或 webhook 运行时不可用。 |
|
|
51
51
|
|
|
52
|
-
`202`
|
|
52
|
+
`202` 不表示任何规则已经匹配,也不表示已创建会话。GitHub 事件特定字段的验证属于各规则;适配器只保证通过身份验证的通用 JSON。
|
|
53
53
|
|
|
54
54
|
<a id="dedicated-listener-composition"></a>
|
|
55
55
|
## 专用监听器组合
|
|
@@ -57,22 +57,22 @@ kind: "package-reference"
|
|
|
57
57
|
普通 Web profile 已经拥有 `ctx.webServer`。把另一个 `dsh-host-webserver` 和此适配器挂载到仅隔离 `webServer` 的 group 内;适配器仍会继承凭据与 `webhookRuntime`。[GitHub 评审指南](../../../docs/user/guide/github-review.zh.md)在 TLS 反向代理后使用 `127.0.0.1:3081/github`,而 UI 继续位于端口 3080。
|
|
58
58
|
|
|
59
59
|
<a id="model-experience"></a>
|
|
60
|
-
##
|
|
60
|
+
## 模型体验
|
|
61
61
|
|
|
62
|
-
通过 `dsh-webhook` 间接产生影响:此适配器不贡献提示词或工具 schema
|
|
62
|
+
通过 `dsh-webhook` 间接产生影响:此适配器不贡献提示词或工具 schema;匹配规则拥有会话请求与模型可见文本。
|
|
63
63
|
|
|
64
|
-
#### KV Cache
|
|
64
|
+
#### KV Cache 影响
|
|
65
65
|
|
|
66
|
-
相互独立。身份验证与 HTTP
|
|
66
|
+
相互独立。身份验证与 HTTP 分发不触碰模型请求;任何新会话前缀都属于消费它的规则与运行时。
|
|
67
67
|
|
|
68
|
-
##
|
|
68
|
+
## 已知限制与延期工作
|
|
69
69
|
|
|
70
70
|
<a id="known-limitations-and-deferred-work"></a>
|
|
71
71
|
|
|
72
|
-
- **无 TLS
|
|
73
|
-
- **仅通用 payload
|
|
74
|
-
-
|
|
75
|
-
-
|
|
72
|
+
- **无 TLS**:注入的开发 WebServer 通常只监听 loopback,并位于 TLS 反向代理或 tunnel 后。
|
|
73
|
+
- **仅通用 payload 验证**:规则负责验证自己消费的 GitHub 事件字段。
|
|
74
|
+
- **不向提供方确认下游工作**:`202` 先于任意规则调用与会话创建。
|
|
75
|
+
- **不支持表单编码**:GitHub 必须发送 `application/json`;`application/x-www-form-urlencoded` 会被拒绝。
|
|
76
76
|
|
|
77
77
|
|
|
78
78
|
<a id="dev-note"></a>
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-webhook-github",
|
|
3
3
|
"description": "Signed GitHub HTTP webhook adapter for the DeepSeek Harness webhook runtime",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.6-alpha.1",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -32,24 +32,24 @@
|
|
|
32
32
|
],
|
|
33
33
|
"license": "MIT",
|
|
34
34
|
"peerDependencies": {
|
|
35
|
+
"@deepseek-ai/dsh-credentials": "^0.1.6-alpha.1",
|
|
36
|
+
"@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
|
|
37
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
35
38
|
"@deepseek-ai/cordis": "^4.0.2",
|
|
36
|
-
"@deepseek-ai/dsh-
|
|
37
|
-
"@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
|
|
38
|
-
"@deepseek-ai/dsh-session": "^0.1.5-rc.2",
|
|
39
|
-
"@deepseek-ai/dsh-webhook": "^0.1.5-rc.2"
|
|
39
|
+
"@deepseek-ai/dsh-webhook": "^0.1.6-alpha.1"
|
|
40
40
|
},
|
|
41
41
|
"dependencies": {
|
|
42
42
|
"@octokit/webhooks": "^14.2.0",
|
|
43
|
-
"@deepseek-ai/
|
|
44
|
-
"@deepseek-ai/
|
|
43
|
+
"@deepseek-ai/schemastery": "^3.18.2",
|
|
44
|
+
"@deepseek-ai/dsh-util-values": "^0.1.6-alpha.1"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"@deepseek-ai/cordis": "^4.0.2",
|
|
48
48
|
"@deepseek-ai/cordis-plugin-include": "^1.0.7",
|
|
49
|
-
"@deepseek-ai/
|
|
50
|
-
"@deepseek-ai/dsh-
|
|
51
|
-
"@deepseek-ai/dsh-
|
|
52
|
-
"@deepseek-ai/dsh-
|
|
53
|
-
"@deepseek-ai/
|
|
49
|
+
"@deepseek-ai/cordis-plugin-loader": "^1.0.3",
|
|
50
|
+
"@deepseek-ai/dsh-credentials": "^0.1.6-alpha.1",
|
|
51
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
52
|
+
"@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
|
|
53
|
+
"@deepseek-ai/dsh-webhook": "^0.1.6-alpha.1"
|
|
54
54
|
}
|
|
55
55
|
}
|