@deepseek-ai/dsh-skill-badge 0.1.1-rc.2 → 0.1.2-alpha.2
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 +2 -2
- package/README.md +102 -6
- package/README.zh.md +103 -7
- package/package.json +7 -7
package/README.i18n.yaml
CHANGED
|
@@ -2,5 +2,5 @@
|
|
|
2
2
|
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/skill/skill-badge/README.md
|
|
5
|
-
README.md:
|
|
6
|
-
README.zh.md:
|
|
5
|
+
README.md: fe5c97af8b7bfb149de998402825092d770b3cef
|
|
6
|
+
README.zh.md: e489f1330621436dbd4402d410b797d59b04affa
|
package/README.md
CHANGED
|
@@ -1,16 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "The bundled 'powered by dsh' badge skill for users and maintainers enabling, using, or debugging the optional badge provider."
|
|
3
|
+
kind: "package-reference"
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
# @deepseek-ai/dsh-skill-badge
|
|
2
7
|
|
|
3
8
|
English | [中文](README.zh.md)
|
|
4
9
|
|
|
5
|
-
|
|
10
|
+
## Summary
|
|
11
|
+
|
|
12
|
+
Agents can load the official "powered by dsh" badge skill from this bundled provider and follow its instructions for adding attribution badges to documents, pull requests, and other content produced with DeepSeek Harness. The provider has no configuration, and the shipped CLI composition includes the plugin disabled, so deployments enable it explicitly. The skill ships both Markdown snippets and a packaged PNG for systems that cannot reliably import remote images.
|
|
13
|
+
|
|
14
|
+
## Table of Contents
|
|
15
|
+
|
|
16
|
+
- [Use this package](#use-this-package)
|
|
17
|
+
- [Understand the implementation](#understand-the-implementation)
|
|
18
|
+
- [Further Exploration](#further-exploration)
|
|
19
|
+
- [Model Experience](#model-experience)
|
|
20
|
+
- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
|
|
21
|
+
- [Dev Note](#dev-note)
|
|
22
|
+
|
|
23
|
+
-----
|
|
24
|
+
|
|
25
|
+
<a id="use-this-package"></a>
|
|
26
|
+
## Use this package
|
|
27
|
+
|
|
28
|
+
Enable the plugin to make the `dsh-badge` skill available in the session skill catalog; the model can then load it like any other skill and follow its instructions for adding a "powered by dsh" badge.
|
|
29
|
+
|
|
30
|
+
### When to choose it
|
|
31
|
+
|
|
32
|
+
Choose this provider when content produced with DeepSeek Harness should carry official attribution badges, and the deployment wants the badge skill available to agents without storing it in a local skill directory. Skip it when the badge is irrelevant to the deployment — the plugin is disabled by default and adds nothing until enabled.
|
|
33
|
+
|
|
34
|
+
### Enable the plugin
|
|
35
|
+
|
|
36
|
+
The plugin has no configuration. Add its composition row to a composition; the shipped CLI composition carries the row as `disabled: true`, so enable it explicitly there.
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
- name: '@deepseek-ai/dsh-skill-badge'
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
After enabling, `dsh-badge` appears in the available skills of the session catalog. The skill covers remote Markdown badges (Shields.io-based) and a packaged PNG badge asset for targets that cannot fetch remote images reliably.
|
|
43
|
+
|
|
44
|
+
### What the badge skill provides
|
|
45
|
+
|
|
46
|
+
- **Markdown snippets.** Instructions for embedding the official badge markup in documents, pull requests, and merge requests.
|
|
47
|
+
- **Packaged PNG asset.** A `dsh-badge.png` resource (726×120 source, rendered at 121×20) that works where remote images cannot be imported.
|
|
48
|
+
|
|
49
|
+
### Observable success and failures
|
|
50
|
+
|
|
51
|
+
Enabling the plugin makes `dsh-badge` appear in the catalog and loadable by name; disabling or omitting the row keeps it out of every catalog. Because the provider is immutable, discovery always succeeds with exactly one skill and never reports partial results.
|
|
52
|
+
|
|
53
|
+
-----
|
|
6
54
|
|
|
7
|
-
|
|
55
|
+
<a id="understand-the-implementation"></a>
|
|
56
|
+
## Understand the implementation
|
|
8
57
|
|
|
9
|
-
|
|
58
|
+
<details>
|
|
59
|
+
<summary>Implementation internals — click to expand</summary>
|
|
10
60
|
|
|
61
|
+
This section explains how the bundled provider is wired; the observable behavior is fully covered in [Use this package](#use-this-package).
|
|
62
|
+
|
|
63
|
+
### Design concept
|
|
64
|
+
|
|
65
|
+
The provider is an immutable, synchronously registered skill source: it registers one fixed candidate at the bundled skill rank (600) under the provider name `dsh-badge`, exposes its packaged `assets/` directory as the skill's directory resource base, and reads the skill body from the packaged `assets/dsh-badge.md` file on every load.
|
|
66
|
+
|
|
67
|
+
### Source map
|
|
68
|
+
|
|
69
|
+
| File | Role |
|
|
70
|
+
|---|---|
|
|
71
|
+
| [`src/index.ts`](src/index.ts) | Plugin entry and the immutable provider: one candidate, resource base, body load |
|
|
72
|
+
| [`src/invariant.ts`](src/invariant.ts) | Invariant companion |
|
|
73
|
+
| [`assets/`](assets/) | Packaged skill body (`dsh-badge.md`) and PNG asset (`dsh-badge.png`) |
|
|
74
|
+
|
|
75
|
+
</details>
|
|
76
|
+
|
|
77
|
+
-----
|
|
78
|
+
|
|
79
|
+
<a id="further-exploration"></a>
|
|
80
|
+
## Further Exploration
|
|
81
|
+
|
|
82
|
+
Read these pages when the package-level contract is not enough. They move from the registry this provider registers on to how the skill reaches the model and why the provider ships as it does.
|
|
83
|
+
|
|
84
|
+
- [Skill subsystem reference](../../../docs/subsystems/skills.md) — the registry and provider contract this provider implements.
|
|
85
|
+
- [skill package](../skill/README.md) — the registry the provider registers on, and the shared rendering of loaded skills.
|
|
86
|
+
- [tool-skill package](../tool-skill/README.md) — how the badge skill reaches the session catalog and the model.
|
|
87
|
+
- [Web preview product badge Agent Note](../../../.agents/notes/implemented/feature/2026-08-05-web-preview-product-badge.md) — why the provider ships disabled and the asset decisions.
|
|
88
|
+
|
|
89
|
+
-----
|
|
90
|
+
|
|
91
|
+
<a id="model-experience"></a>
|
|
11
92
|
## Model Experience
|
|
12
93
|
|
|
13
|
-
Indirectly, through
|
|
94
|
+
Indirectly, through `dsh-tool-skill`, which renders the provider's catalog entry and the selected skill body to the model.
|
|
14
95
|
|
|
15
96
|
#### KV Cache effect
|
|
16
97
|
|
|
@@ -18,5 +99,20 @@ Disabled by default, the plugin changes no request. When enabled, its catalog en
|
|
|
18
99
|
|
|
19
100
|
## Known Limitations and Deferred Work
|
|
20
101
|
|
|
21
|
-
-
|
|
22
|
-
|
|
102
|
+
<a id="known-limitations-and-deferred-work"></a>
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
These limits define what the bundled provider does not do. They are current package constraints, not a task backlog.
|
|
106
|
+
|
|
107
|
+
- **One fixed skill, no runtime customization** — the provider contributes exactly the `dsh-badge` skill; deployments that need another badge variant author their own skill instead.
|
|
108
|
+
- **Remote Markdown relies on Shields.io** — the remote badge markup embeds a Shields.io image; use the packaged PNG when the target cannot fetch remote images reliably.
|
|
109
|
+
|
|
110
|
+
<a id="dev-note"></a>
|
|
111
|
+
### Dev Note
|
|
112
|
+
|
|
113
|
+
<details>
|
|
114
|
+
<summary>Working context for maintainers — click to expand</summary>
|
|
115
|
+
|
|
116
|
+
None.
|
|
117
|
+
|
|
118
|
+
</details>
|
package/README.zh.md
CHANGED
|
@@ -1,22 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "随包附带的「powered by dsh」徽章 skill，供启用、使用或排查该可选徽章提供方的用户与维护者阅读。"
|
|
3
|
+
kind: "package-reference"
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
# @deepseek-ai/dsh-skill-badge
|
|
2
7
|
|
|
3
8
|
[English](README.md) | 中文
|
|
4
9
|
|
|
5
|
-
|
|
10
|
+
## 概述
|
|
11
|
+
|
|
12
|
+
agent（智能体）可以通过该内置提供方加载官方「powered by dsh」徽章 skill（技能），并遵循其指令，给文档、pull request 以及其他用 DeepSeek Harness 生成的内容添加署名徽章。该提供方没有配置，随附 CLI（命令行界面）组合以禁用状态包含该插件，因此部署方需要显式启用。该 skill 同时提供 Markdown 片段和随包分发的 PNG，供无法可靠导入远程图片的系统使用。
|
|
13
|
+
|
|
14
|
+
## 目录
|
|
15
|
+
|
|
16
|
+
- [使用本包](#use-this-package)
|
|
17
|
+
- [理解实现](#understand-the-implementation)
|
|
18
|
+
- [进一步探索](#further-exploration)
|
|
19
|
+
- [模型体验](#model-experience)
|
|
20
|
+
- [已知限制与延期工作](#known-limitations-and-deferred-work)
|
|
21
|
+
- [开发备注](#dev-note)
|
|
22
|
+
|
|
23
|
+
-----
|
|
24
|
+
|
|
25
|
+
<a id="use-this-package"></a>
|
|
26
|
+
## 使用本包
|
|
27
|
+
|
|
28
|
+
启用插件即可让 `dsh-badge` skill 出现在会话 skill 目录中；随后模型可以像加载任何其他 skill 一样加载它，并遵循其指令添加「powered by dsh」徽章。
|
|
29
|
+
|
|
30
|
+
### 何时选择
|
|
31
|
+
|
|
32
|
+
当用 DeepSeek Harness 生成的内容应携带官方署名徽章、且部署方希望该徽章 skill 对 agent 可用而无需存入本地 skill 目录时，选择此提供方。当徽章与部署无关时，请跳过——插件默认禁用，启用前不增加任何东西。
|
|
33
|
+
|
|
34
|
+
### 启用插件
|
|
35
|
+
|
|
36
|
+
该插件没有配置。把它的组合行加入组合即可；随附 CLI 组合以 `disabled: true` 携带该行，因此在那里需要显式启用。
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
- name: '@deepseek-ai/dsh-skill-badge'
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
启用后，`dsh-badge` 会出现在会话目录的可用 skill 中。该 skill 覆盖远程 Markdown 徽章（基于 Shields.io）和随包分发的 PNG 徽章资源，后者用于无法可靠获取远程图片的目标环境。
|
|
43
|
+
|
|
44
|
+
### 徽章 skill 提供什么
|
|
45
|
+
|
|
46
|
+
- **Markdown 片段。** 在文档、pull request 与 merge request 中嵌入官方徽章标记的指令。
|
|
47
|
+
- **随包分发的 PNG 资源。** `dsh-badge.png`（726×120 源图，按 121×20 渲染），在无法导入远程图片的环境中可用。
|
|
48
|
+
|
|
49
|
+
### 可观察的成功与失败
|
|
50
|
+
|
|
51
|
+
启用插件会使 `dsh-badge` 出现在目录中并可凭名称加载；禁用或省略该行则它不会出现在任何目录中。由于提供方不可变，发现始终成功且恰好返回一个 skill，绝不会报告部分结果。
|
|
52
|
+
|
|
53
|
+
-----
|
|
6
54
|
|
|
7
|
-
|
|
55
|
+
<a id="understand-the-implementation"></a>
|
|
56
|
+
## 理解实现
|
|
8
57
|
|
|
9
|
-
|
|
58
|
+
<details>
|
|
59
|
+
<summary>实现细节——点击展开</summary>
|
|
10
60
|
|
|
61
|
+
本节解释内置提供方如何接线；可观察行为已在[使用本包](#use-this-package)中完整说明。
|
|
62
|
+
|
|
63
|
+
### 设计理念
|
|
64
|
+
|
|
65
|
+
该提供方是一个不可变、同步注册的 skill 来源：它以 `dsh-badge` 作为提供方名称、按内置 skill rank（600）注册一个固定候选项，把随包分发的 `assets/` 目录作为该 skill 的目录资源基底公开，并在每次加载时从随包分发的 `assets/dsh-badge.md` 文件读取 skill 正文。
|
|
66
|
+
|
|
67
|
+
### 源码地图
|
|
68
|
+
|
|
69
|
+
| 文件 | 职责 |
|
|
70
|
+
|---|---|
|
|
71
|
+
| [`src/index.ts`](src/index.ts) | 插件入口与不可变提供方：一个候选项、资源基底、正文加载 |
|
|
72
|
+
| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件 |
|
|
73
|
+
| [`assets/`](assets/) | 随包分发的 skill 正文（`dsh-badge.md`）与 PNG 资源（`dsh-badge.png`） |
|
|
74
|
+
|
|
75
|
+
</details>
|
|
76
|
+
|
|
77
|
+
-----
|
|
78
|
+
|
|
79
|
+
<a id="further-exploration"></a>
|
|
80
|
+
## 进一步探索
|
|
81
|
+
|
|
82
|
+
当包级约定不够用时阅读以下页面。它们从该提供方注册到的注册表逐步进入 skill 如何到达模型，以及该提供方为何如此发布。
|
|
83
|
+
|
|
84
|
+
- [skill 子系统参考](../../../docs/subsystems/skills.zh.md)——该提供方实现的注册表与提供方约定。
|
|
85
|
+
- [skill 包](../skill/README.zh.md)——该提供方注册到的注册表，以及已加载 skill 的共享渲染。
|
|
86
|
+
- [tool-skill 包](../tool-skill/README.zh.md)——徽章 skill 如何到达会话目录与模型。
|
|
87
|
+
- [Web 预览产品徽章 Agent Note](../../../.agents/notes/implemented/feature/2026-08-05-web-preview-product-badge.zh.md)——该提供方为何默认禁用，以及资源决策。
|
|
88
|
+
|
|
89
|
+
-----
|
|
90
|
+
|
|
91
|
+
<a id="model-experience"></a>
|
|
11
92
|
## 模型体验
|
|
12
93
|
|
|
13
|
-
通过
|
|
94
|
+
通过 `dsh-tool-skill` 间接影响模型；该包会把该提供方的目录条目和所选 skill 的正文渲染给模型。
|
|
14
95
|
|
|
15
96
|
#### KV Cache 影响
|
|
16
97
|
|
|
17
98
|
该插件默认禁用，不会改变任何请求。启用后，其目录条目和任何已加载正文都会在各自插入点改变提供方的 KV 前缀。
|
|
18
99
|
|
|
19
|
-
##
|
|
100
|
+
## 已知限制与延期工作
|
|
101
|
+
|
|
102
|
+
<a id="known-limitations-and-deferred-work"></a>
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
这些限制说明内置提供方不做什么。它们是当前包约束，不是任务积压。
|
|
106
|
+
|
|
107
|
+
- **固定一个 skill，无运行时自定义**——提供方恰好贡献 `dsh-badge` 这一个 skill；需要其他徽章变体的部署请自行编写 skill。
|
|
108
|
+
- **远程 Markdown 依赖 Shields.io**——远程徽章标记内嵌 Shields.io 图片；目标环境无法可靠获取远程图片时，请使用随包分发的 PNG。
|
|
109
|
+
|
|
110
|
+
<a id="dev-note"></a>
|
|
111
|
+
### 开发备注
|
|
112
|
+
|
|
113
|
+
<details>
|
|
114
|
+
<summary>维护者的工作上下文——点击展开</summary>
|
|
115
|
+
|
|
116
|
+
无。
|
|
20
117
|
|
|
21
|
-
|
|
22
|
-
- 远程 Markdown 使用 Shields.io；当目标环境无法可靠获取远程图片时，请使用随包分发的 PNG。
|
|
118
|
+
</details>
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-skill-badge",
|
|
3
3
|
"description": "Bundled dsh badge skill provider for DeepSeek Harness",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.2-alpha.2",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -32,13 +32,13 @@
|
|
|
32
32
|
],
|
|
33
33
|
"license": "MIT",
|
|
34
34
|
"peerDependencies": {
|
|
35
|
-
"@deepseek-ai/dsh-
|
|
36
|
-
"@deepseek-ai/
|
|
37
|
-
"@deepseek-ai/
|
|
35
|
+
"@deepseek-ai/dsh-skill": "^0.1.2-alpha.2",
|
|
36
|
+
"@deepseek-ai/cordis": "^4.0.2",
|
|
37
|
+
"@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
|
-
"@deepseek-ai/dsh-invariants": "^0.1.
|
|
41
|
-
"@deepseek-ai/dsh-skill": "^0.1.
|
|
42
|
-
"@deepseek-ai/cordis": "^4.0.
|
|
40
|
+
"@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
|
|
41
|
+
"@deepseek-ai/dsh-skill": "^0.1.2-alpha.2",
|
|
42
|
+
"@deepseek-ai/cordis": "^4.0.2"
|
|
43
43
|
}
|
|
44
44
|
}
|