liqiming-whu/dsh-status-card

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。该插件已经发布到 dsh-market 插件市场，请先在市场中搜索并安装它，再安装本插件。

本项目通过 dsh.client.inject 使用 GenUI，但不会把 GenUI 作为 pnpm 依赖自动拉取。这样可以避免安装状态卡插件时解析 GitHub 传递依赖；GenUI 仍是运行状态卡片所需的前置插件。

如果 GenUI 未安装，状态卡片格式指令仍会注入，但聊天中的 dsh-ui 围栏不会被渲染。请先安装并启用 GenUI，再开始新会话。

从 GitHub 安装

1. 安装 GenUI

可以直接打开 dsh-market 插件市场，搜索 @omdsh-dev/dsh-genui 并点击安装；也可以使用命令行：

dsh plugin --profile web add "git+https://github.com/omdsh-dev/dsh-genui.git"

2. 安装状态卡片插件

推荐固定到稳定 Release：

dsh plugin --profile web add "git+https://github.com/liqiming-whu/dsh-status-card.git#v0.2.1"

安装最新主分支：

dsh plugin --profile web add "git+https://github.com/liqiming-whu/dsh-status-card.git"

安装完成后重启 dsh web，并在浏览器中硬刷新页面。

从 Release 安装包安装

从 Releases 下载 dsh-status-card-0.2.1.tgz，然后执行：

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 服务持久化。安装插件、切换浏览器语言或修改设置后，请新建一个会话才能生效；已有会话不保证应用新的状态卡片配置。

注入机制

插件注册系统提示段：

ctx.systemPrompt.section({yaml
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