@deepseek-ai/dsh-personalized-recommendations 0.0.0-stage → 0.2.2-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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/personalized-recommendations/README.md
+/:
+  en: d7cf0e812c2b84ef
+  zh: 959798411569393e
+/deepseek-ai-dsh-personalized-recommendations:
+  en: 4f78733960cd89fa
+  zh: da27faf83f5e53bd
+/deepseek-ai-dsh-personalized-recommendations/summary:
+  en: 5508a30d24f41f16
+  zh: dae436e8131b1b65
+/deepseek-ai-dsh-personalized-recommendations/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: ce40cab8e7534137
+/deepseek-ai-dsh-personalized-recommendations/use-this-package:
+  en: 391782dd00ef7700
+  zh: 346ae3ac63482b92
+/deepseek-ai-dsh-personalized-recommendations/understand-the-implementation:
+  en: e386724a57fffa9b
+  zh: 865f1db569dcafc8
+/deepseek-ai-dsh-personalized-recommendations/further-exploration:
+  en: 0e308f273a226d6c
+  zh: 2b13028f9abb32e2
+/deepseek-ai-dsh-personalized-recommendations/model-experience:
+  en: 8c3ddb0d6cbd0d6b
+  zh: 603f48a0df45ee7d
+/deepseek-ai-dsh-personalized-recommendations/model-experience/kv-cache-effect:
+  en: 9ee776745fc68e18
+  zh: 126dcac4b16b31dd
+/deepseek-ai-dsh-personalized-recommendations/known-limitations-and-deferred-work:
+  en: 965570522f569e46
+  zh: 63a608a10cdd6b80
+/deepseek-ai-dsh-personalized-recommendations/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 8ec3e73528ddb1a6

package/README.md

@@ -1,3 +1,88 @@
-# Temporary Holding Version
+---
+description: "Enable personalized page proposals and built-in plugin recommendations below answers with one experimental bundle."
+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.
+# @deepseek-ai/dsh-personalized-recommendations
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Get an optional card below an answer for two kinds of need: a page or small tool you want to keep, and a built-in plugin that provides a capability you ask about. Nothing is built or enabled until you click Create or Enable on the card. Enable Personalized recommendations on the Web or Desktop Plugins page; shipped profiles leave it disabled. Its page lists both features and their card rows, each with its own switch.
+
+## 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
+
+Open Plugins → More → Experimental plugins and enable Personalized recommendations. Enabling pins it to the main Plugins list; disabling returns it to the secondary page only. While the bundle is on, its page lists six rows in this order, each with its own switch:
+
+| Row | Package | Contributes |
+|---|---|---|
+| Action cards | [`action-cards`](../action-cards/README.md) | The card tool, card state, user actions and status notices |
+| Action card display | [`client-ui-action-cards`](../client-ui-action-cards/README.md) | The card frame below answers |
+| Personalized pages | [`creation-recommendations`](../creation-recommendations/README.md) | Page proposals and their background creation |
+| Personalized page cards | [`client-ui-creation-recommendations`](../client-ui-creation-recommendations/README.md) | The page card body |
+| Plugin recommendations | [`plugin-recommendations`](../plugin-recommendations/README.md) | Built-in plugin recommendations and enabling |
+| Plugin recommendation cards | [`client-ui-plugin-recommendations`](../client-ui-plugin-recommendations/README.md) | The plugin card body |
+
+Switch off Personalized pages or Plugin recommendations to keep only the other feature: the switched-off feature withdraws its skill and card kind, and its earlier cards accept only Not now. Both features need the Action cards row; switching it off stops both until it is on again. Without a card body row, a card shows its proposal title and brief with Not now only. The Action cards row's `queuedMessageLimit` field sets how many queued next-turn messages make the card tool refuse the current turn's card. The Plugins page has no settings page for that row, so change the field with an `id: action-cards` override in the profile's `cordis.patch.yml`.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<details>
+<summary>Maintainer details — click to expand</summary>
+
+The static `cordis.patch.yml` inserts the six rows with their package-owned ids and no configuration. This bundle is the only layer that declares these ids, so the plugin manager addresses each row by its id and the Plugins page can switch it. Both feature plugins inject `actionCards` and register their card kinds with it; the three browser rows register the card frame and the two card bodies. `src/index.ts` exports nothing.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+[Action cards](../action-cards/README.md) · [Personalized pages](../creation-recommendations/README.md) · [Plugin recommendations](../plugin-recommendations/README.md) · [Plugin manager page](../../client/ui-plugin-manager/README.md)
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through the two features' skills, the shared `propose_action` tool and the card status notice, which the row packages document.
+
+#### KV Cache effect
+
+Enabling the bundle adds the two skills' catalog entries to requests; the card tool joins the declarations only after a card skill loads, as described on the [action cards](../action-cards/README.md#model-experience) page.
+
+## Known Limitations and Deferred Work
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- The bundle page lists every row the patch inserts, including the four card rows that only support the two features; it cannot mark a row as supporting or hide it.
+- Each feature's own limitations are on its page: [Personalized pages](../creation-recommendations/README.md#known-limitations-and-deferred-work) and [Plugin recommendations](../plugin-recommendations/README.md#known-limitations-and-deferred-work).
+
+-----
+
+<a id="dev-note"></a>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,88 @@
+---
+description: "用一个实验性 Bundle 在回答下方启用个性化页面提议和内置插件推荐。"
+kind: "package-bundle"
+---
+
+# @deepseek-ai/dsh-personalized-recommendations
+
+[English](README.md) | 中文
+
+## 概述
+
+针对两类需求在回答下方提供一张可选卡片：想要长期使用的页面或小工具，以及能提供你所问能力的内置插件。在卡片上点击创建或启用之前，不会生成或开启任何内容。在 Web 或 Desktop 的插件页面启用个性化推荐；发布的 profile 默认禁用它。它的页面列出两项功能及其卡片行，每行都有自己的开关。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [了解实现](#understand-the-implementation)
+- [延伸阅读](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与后续工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+打开插件 → 更多 → 实验性插件，启用个性化推荐。启用后它固定显示在插件主列表；关闭后只回到二级页。Bundle 开启期间，它的页面按以下顺序列出六行，每行都有自己的开关：
+
+| 行 | 包 | 提供 |
+|---|---|---|
+| 操作卡片 | [`action-cards`](../action-cards/README.zh.md) | 卡片工具、卡片状态、用户操作和状态通知 |
+| 操作卡片显示 | [`client-ui-action-cards`](../client-ui-action-cards/README.zh.md) | 回答下方的卡片框架 |
+| 个性化页面 | [`creation-recommendations`](../creation-recommendations/README.zh.md) | 页面提议及其后台创建 |
+| 个性化页面卡片 | [`client-ui-creation-recommendations`](../client-ui-creation-recommendations/README.zh.md) | 页面卡片正文 |
+| 插件推荐 | [`plugin-recommendations`](../plugin-recommendations/README.zh.md) | 内置插件推荐和启用 |
+| 插件推荐卡片 | [`client-ui-plugin-recommendations`](../client-ui-plugin-recommendations/README.zh.md) | 插件卡片正文 |
+
+关闭个性化页面或插件推荐即可只保留另一项功能：被关闭的功能撤下它的 Skill 和卡片种类，它之前的卡片只接受“暂不需要”。两项功能都需要操作卡片行；关闭它后两项功能都停止，直到重新开启。缺少卡片正文行时，卡片只显示提案标题、说明和“暂不需要”。操作卡片行的 `queuedMessageLimit` 字段规定排队等待下一轮的消息达到多少条时，卡片工具拒绝本轮的卡片。插件页面没有为该行提供设置页，请在 profile 的 `cordis.patch.yml` 中用 `id: action-cards` 覆盖项修改该字段。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 了解实现
+
+<details>
+<summary>维护者细节 — 点击展开</summary>
+
+静态 `cordis.patch.yml` 以各包自有的 id 插入这六行，不带配置。只有本 Bundle 声明这些 id，因此插件管理器按 id 定位每一行，插件页面可以开关它。两个功能插件都注入 `actionCards` 并向它注册卡片种类；三个浏览器端行注册卡片框架和两种卡片正文。`src/index.ts` 不导出任何内容。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 延伸阅读
+
+[操作卡片](../action-cards/README.zh.md) · [个性化页面](../creation-recommendations/README.zh.md) · [插件推荐](../plugin-recommendations/README.zh.md) · [插件管理页面](../../client/ui-plugin-manager/README.zh.md)
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响来自两项功能的 Skill、共享的 `propose_action` 工具和卡片状态通知，由各行所在的包说明。
+
+#### KV Cache 效果
+
+启用本 Bundle 会在请求中加入两个 Skill 的目录条目；卡片工具只在加载卡片 Skill 后才加入声明，见[操作卡片](../action-cards/README.zh.md#model-experience)页面。
+
+## 已知限制与后续工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+- Bundle 页面列出补丁插入的每一行，包括只为两项功能提供支持的四个卡片行；页面不能把某行标为辅助行，也不能隐藏它。
+- 两项功能各自的限制见其页面：[个性化页面](../creation-recommendations/README.zh.md#known-limitations-and-deferred-work)和[插件推荐](../plugin-recommendations/README.zh.md#known-limitations-and-deferred-work)。
+
+-----
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文 — 点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+- insert:
+    - id: action-cards
+      name: '@deepseek-ai/dsh-action-cards'
+    - id: client-ui-action-cards
+      name: '@deepseek-ai/dsh-client-ui-action-cards'
+    - id: creation-recommendations
+      name: '@deepseek-ai/dsh-creation-recommendations'
+    - id: client-ui-creation-recommendations
+      name: '@deepseek-ai/dsh-client-ui-creation-recommendations'
+    - id: plugin-recommendations
+      name: '@deepseek-ai/dsh-plugin-recommendations'
+    - id: client-ui-plugin-recommendations
+      name: '@deepseek-ai/dsh-client-ui-plugin-recommendations'

package/docs/DETAIL.md

@@ -0,0 +1 @@
+![Personalized recommendations feature preview](preview.svg)

package/docs/DETAIL.zh.md

@@ -0,0 +1 @@
+![个性化推荐功能预览](preview.zh.svg)