<h1 align="center">dsh-status-card</h1>
<p align="center"> <strong>为 DeepSeek Harness 的每次 Agent 回复添加精美、动态的 dsh-ui 状态卡片</strong> </p>
<p align="center"> 简体中文 · <a href="./README_EN.md">English</a> </p>
功能
- 在每次 Agent 回复正文开头输出内联
dsh-ui状态卡片。 - 通过
ctx.systemPrompt.section()注入格式指令，不追加用户或助手对话历史。 - 使用 emoji 代替 Material Icons。
- 内置六款模板：A 软萌活力、B 极简专注、C 专业工作、D 星舰科技、E 温暖陪伴、F 开发者终端。
- 支持启用开关、自定义卡片标题和自定义 GenUI JSON 模板。
- 设置页提供实时卡片预览和自定义模板校验。
- 自动检测浏览器首选语言：首选语言以
zh开头时，设置界面、内置模板和系统提示注入使用中文；其他语言统一使用英文。 - 自定义模板限制为 64 KiB，必须包含非空
items数组。
六款模板预览
<table> <tr> <td width="50%"><strong>A · 软萌活力</strong><br><img src="./docs/images/templates/zh/template-a.svg" alt="模板 A 软萌活力中文预览" width="560"></td> <td width="50%"><strong>B · 极简专注</strong><br><img src="./docs/images/templates/zh/template-b.svg" alt="模板 B 极简专注中文预览" width="560"></td> </tr> <tr> <td width="50%"><strong>C · 专业工作</strong><br><img src="./docs/images/templates/zh/template-c.svg" alt="模板 C 专业工作中文预览" width="560"></td> <td width="50%"><strong>D · 星舰科技</strong><br><img src="./docs/images/templates/zh/template-d.svg" alt="模板 D 星舰科技中文预览" width="560"></td> </tr> <tr> <td width="50%"><strong>E · 温暖陪伴</strong><br><img src="./docs/images/templates/zh/template-e.svg" alt="模板 E 温暖陪伴中文预览" width="560"></td> <td width="50%"><strong>F · 开发者终端</strong><br><img src="./docs/images/templates/zh/template-f.svg" alt="模板 F 开发者终端中文预览" width="560"></td> </tr> </table>
> 展示图根据当前内置 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({
name: 'status-card',
order: 90,
text: () => buildStatusCardInstruction(settings),
})插件不调用 agent.inject()、不注册 systemPrompt.context()，也不追加 user/message 或 assistant/message，因此状态卡片格式指令不会积累进对话历史。
开发与测试
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)