@qilin-agent/experimental-badge-skill-bundle 0.0.0-stage → 3.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kkutysllb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,37 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/experimental/badge-skill-bundle/README.md
+/:
+  en: 03f3fdb01ff12aef
+  zh: fd906d3dcef5e434
+/qilin-agent-experimental-badge-skill-bundle:
+  en: d97765e88e4e0513
+  zh: ce7c12ba53ff2c75
+/qilin-agent-experimental-badge-skill-bundle/summary:
+  en: 32cab7a79174addd
+  zh: 6ae1b3fb44ece2a2
+/qilin-agent-experimental-badge-skill-bundle/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 988e839059414d27
+/qilin-agent-experimental-badge-skill-bundle/use-this-package:
+  en: 2f80f2febc725b26
+  zh: 2635598bcbaf5926
+/qilin-agent-experimental-badge-skill-bundle/understand-the-implementation:
+  en: 5d85006caaa66a8d
+  zh: e8ea8d0bf3038341
+/qilin-agent-experimental-badge-skill-bundle/further-exploration:
+  en: 40a04e47bc259b06
+  zh: 908f83461226d56c
+/qilin-agent-experimental-badge-skill-bundle/model-experience:
+  en: d7582f9dd705117a
+  zh: 7acb379daa469f5d
+/qilin-agent-experimental-badge-skill-bundle/model-experience/kv-cache-effect:
+  en: 1b2209bbbf869b1a
+  zh: 5b9de62271343e4e
+/qilin-agent-experimental-badge-skill-bundle/known-limitations-and-deferred-work:
+  en: 6c6e181ad900ece5
+  zh: 4d6063075f1ee8a6
+/qilin-agent-experimental-badge-skill-bundle/known-limitations-and-deferred-work/dev-note:
+  en: 279d01435256cd2a
+  zh: 83780964e5de2f54

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+---
+description: "Offer the powered-by-qilin badge as a discoverable skill."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @qilin-agent/experimental-badge-skill-bundle
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Offer the experimental qilin badge skill to Agents whose presets load skills. The shared provider adds no model tool. It ships switched off in Web and Desktop. Select it in Plugins to enable it.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## Use this package
+
+In Web or Desktop, open Plugins and enable **qilin badge skill** in Official. Switch it off to remove its profile layer.
+
+The switch adds or removes a Host-wide skill provider for existing and new Agents. Presets that expose skill loading can use the badge; minimal keeps its tool catalog unchanged.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Implementation details — click to expand</summary>
+
+[`cordis.patch.yml`](cordis.patch.yml) contributes the `skill-badge` provider row on the Host. Later root patches can disable that row; an override alone does not select the bundle. The [profile composer](../../boot/app-boot/README.md) owns patch ordering and errors.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+[Capability implementation](../skill-badge/README.md)
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through the [capability implementation](../skill-badge/README.md), which owns model context and results.
+
+#### KV Cache effect
+
+The layer adds no request content directly; the capability implementation owns cache effects from tools, prompts, and results.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- A preset must include skill discovery and loading to use the badge. The minimal preset does not gain skill tools from this bundle.
+
+-----
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Maintainer context — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,78 @@
+---
+description: "提供可发现的 powered-by-qilin 徽章技能。"
+kind: "package-bundle"
+---
+
+# @qilin-agent/experimental-badge-skill-bundle
+
+[English](README.md) | 中文
+
+## 概述
+
+向预设支持技能加载的智能体提供实验性 qilin 徽章技能。共享提供者不添加模型工具。 Web 和 Desktop 随附此功能，默认关闭。在插件页选择它即可启用。
+
+## 目录
+
+- [使用此包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与暂缓工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用此包
+
+在 Web 或 Desktop 中打开插件页，在官方分组启用 **qilin 徽章技能**。关闭后移除其配置层。
+
+开关为已有和新建智能体添加或移除 Host 级技能提供方。提供技能加载能力的预设可以使用徽章；minimal 的工具目录保持不变。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<details>
+<summary>实现细节 — 点击展开</summary>
+
+[`cordis.patch.yml`](cordis.patch.yml) 在 Host 上添加 `skill-badge` 提供者行。后续根级补丁可以禁用该行；单独的覆盖不会选中组合包。[配置组合器](../../boot/app-boot/README.zh.md) 负责补丁顺序和错误处理。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+[能力实现](../skill-badge/README.zh.md)
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响，通过[能力实现](../skill-badge/README.zh.md) 贡献模型上下文和结果。
+
+#### KV Cache 影响
+
+此配置层不直接添加请求内容；能力实现负责工具目录、提示和结果的缓存影响。
+
+## 已知限制与暂缓工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- 预设必须支持技能发现和加载才能使用徽章。此 bundle 不会为 minimal 预设添加技能工具。
+
+-----
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者上下文 — 点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: skill-badge
+      name: '@qilin-agent/experimental-skill-badge'

package/icon.svg

@@ -0,0 +1 @@
+<svg width="36" height="36" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" stroke-width="1"><path d="M12.5303 6.53027L8.80273 10.2578C8.54967 10.5109 8.31796 10.7439 8.10645 10.9141C7.88375 11.0932 7.616 11.2602 7.27344 11.3145C7.09229 11.3431 6.90771 11.3431 6.72656 11.3145C6.384 11.2602 6.11625 11.0932 5.89355 10.9141C5.68204 10.7439 5.45033 10.5109 5.19727 10.2578L3.46973 8.53027L4.53027 7.46973L6.25781 9.19727C6.53457 9.47402 6.70036 9.63859 6.83398 9.74609C6.95637 9.84453 6.98241 9.83644 6.96094 9.83301C6.98679 9.83709 7.01321 9.83709 7.03906 9.83301C7.01759 9.83644 7.04363 9.84453 7.16602 9.74609C7.29964 9.63859 7.46543 9.47402 7.74219 9.19727L11.4697 5.46973L12.5303 6.53027Z" fill="#658EFF"></path><path d="M14.5996 8C14.5996 4.35492 11.6451 1.40039 8 1.40039C4.35492 1.40039 1.40039 4.35492 1.40039 8C1.40039 11.6451 4.35492 14.5996 8 14.5996C11.6451 14.5996 14.5996 11.6451 14.5996 8ZM15.9004 8C15.9004 12.363 12.363 15.9004 8 15.9004C3.63695 15.9004 0.0996094 12.363 0.0996094 8C0.0996094 3.63695 3.63695 0.0996094 8 0.0996094C12.363 0.0996094 15.9004 3.63695 15.9004 8Z" fill="#658EFF"></path></svg>

package/lib/index.js

@@ -0,0 +1 @@
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,3 @@
+/** DSH badge skill profile layer; runtime entries are declared in cordis.patch.yml. */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "qilin badge skill",
+    "description": "Offer the powered-by-qilin badge as a discoverable skill."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "qilin 徽章技能",
+    "description": "提供可发现的 powered-by-qilin 徽章技能。"
+  }
+}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@qilin-agent/experimental-badge-skill-bundle",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Offer the powered-by-qilin badge as a discoverable skill.",
+  "version": "3.1.4",
+  "icon": "./icon.svg",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/experimental/badge-skill-bundle"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "cordis.patch.yml",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@qilin-agent/experimental-skill-badge": "3.1.4"
+  },
+  "peerDependencies": {
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "js-yaml": "^4.2.0",
+    "@qilin-agent/kylin-plugin-include": "~1.0.8",
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "qilin": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  }
 }