dsh-status-card

为 DeepSeek Harness 的每次 Agent 回复添加精美、动态的 dsh-ui 状态卡片

简体中文 · English

## 功能 - 在每次 Agent 回复正文开头输出内联 `dsh-ui` 状态卡片。 - 通过 `ctx.systemPrompt.section()` 注入格式指令，不追加用户或助手对话历史。 - 使用 emoji 代替 Material Icons。 - 内置六款模板：A 软萌活力、B 极简专注、C 专业工作、D 星舰科技、E 温暖陪伴、F 开发者终端。 - 支持启用开关、自定义卡片标题和自定义 GenUI JSON 模板。 - 设置页提供实时卡片预览和自定义模板校验。 - 自动检测浏览器首选语言：首选语言以 `zh` 开头时，设置界面、内置模板和系统提示注入使用中文；其他语言统一使用英文。 - 自定义模板限制为 64 KiB，必须包含非空 `items` 数组。 ## 六款模板预览

A · 软萌活力	B · 极简专注
C · 专业工作	D · 星舰科技
E · 温暖陪伴	F · 开发者终端

> 展示图根据当前内置 A–F 模板的结构、文案、状态值和视觉语义生成；模型回复中的实际卡片由 GenUI 按当前界面主题渲染。 ## 前置要求 - 已安装 DeepSeek Harness。 - `pnpm` 可从终端运行。 - Web profile 已安装并启用 [`@omdsh-dev/dsh-genui`](https://github.com/omdsh-dev/dsh-genui)。该插件已经发布到 **dsh-market 插件市场**，请先在市场中搜索并安装它，再安装本插件。本项目通过 `dsh.client.inject` 使用 GenUI，但不会把 GenUI 作为 pnpm 依赖自动拉取。这样可以避免安装状态卡插件时解析 GitHub 传递依赖；GenUI 仍是运行状态卡片所需的前置插件。 > 如果 GenUI 未安装，状态卡片格式指令仍会注入，但聊天中的 `dsh-ui` 围栏不会被渲染。请先安装并启用 GenUI，再开始新会话。 ## 从 GitHub 安装 ### 1. 安装 GenUI 可以直接打开 **dsh-market 插件市场**，搜索 `@omdsh-dev/dsh-genui` 并点击安装；也可以使用命令行： ```sh dsh plugin --profile web add "git+https://github.com/omdsh-dev/dsh-genui.git" ``` ### 2. 安装状态卡片插件推荐固定到稳定 Release： ```sh dsh plugin --profile web add "git+https://github.com/liqiming-whu/dsh-status-card.git#v0.2.1" ``` 安装最新主分支： ```sh dsh plugin --profile web add "git+https://github.com/liqiming-whu/dsh-status-card.git" ``` 安装完成后重启 `dsh web`，并在浏览器中硬刷新页面。 ## 从 Release 安装包安装从 [Releases](https://github.com/liqiming-whu/dsh-status-card/releases) 下载 `dsh-status-card-0.2.1.tgz`，然后执行： ```sh dsh plugin --profile web add ./dsh-status-card-0.2.1.tgz ``` ## 使用打开 **设置 → 状态卡片**： 1. 启用或关闭回复状态卡片。 2. 修改卡片标题。 3. 从模板库选择 A–F。 4. 选择“自定义模板”以编辑严格的 GenUI JSON。 5. 在设置页查看实时预览，校验通过后保存。浏览器端会读取 `navigator.languages`（并以 `navigator.language` 作为回退），把检测结果同步到 DSH Settings：首选语言以 `zh` 开头时使用中文，否则使用英文。设置页会立即按浏览器语言显示，对应语言的系统提示和模板将在模型请求中使用。设置会通过 DSH Settings 服务持久化。**安装插件、切换浏览器语言或修改设置后，请新建一个会话才能生效；已有会话不保证应用新的状态卡片配置。** ## 注入机制插件注册系统提示段： ```ts ctx.systemPrompt.section({ name: 'status-card', order: 90, text: () => buildStatusCardInstruction(settings), }) ``` 插件不调用 `agent.inject()`、不注册 `systemPrompt.context()`，也不追加 `user/message` 或 `assistant/message`，因此状态卡片格式指令不会积累进对话历史。 ## 开发与测试 ```sh git clone https://github.com/liqiming-whu/dsh-status-card.git cd dsh-status-card pnpm install pnpm run check pnpm pack ``` 测试覆盖非历史注入、设置面板、A–F 与自定义模板、自定义 JSON 校验、客户端 bundle 纯度，以及 Host/浏览器构建。 ## 说明设置页预览由本插件本地实现，不跨插件导入 GenUI 客户端值，以遵守 DSH 客户端 bundle 纯度约束。聊天中的真实 `dsh-ui` 围栏由 GenUI 渲染。 ## License [MIT](./LICENSE)