dsh-zh-more

Readme

# dsh-zh-more — DSH 中文增强补全

> 把 DeepSeek Harness（DSH）Web 界面里"官方汉化管不到"的英文，变成一眼能看懂的中文：
> **斜杠命令名**和**设置 → 插件列表**的插件卡片，三种显示模式随意切换。

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-4d7fff)](https://github.com/topics/dsh-plugin)

## 它解决什么问题

DSH 官方中文界面把大部分文案都翻译了，但两处还是英文：

1. **斜杠命令菜单**：命令名是机器标识（`/compact`、`/goal` 等），官方不会翻译；
2. **设置 → 插件 → 插件列表**：每张插件卡片只显示英文模块名（`session`、`sandbox-policy`…），不知道是干什么用的。

本插件把这两处变成中文，并保留英文信息不丢失。

## 三种显示模式

在 **设置 → 翻译设置** 中选择（记住选择，切换即时生效）：

| 模式 | 命令菜单 | 插件列表 |
|---|---|---|
| **只显示中文**（默认） | `压缩对话`，说明行带 `/compact · 压缩较早的对话历史` | `会话核心` + 一句话用途 |
| **中英都显示** | `压缩对话 /compact` | `定时器服务` + `Cordis 定时任务调度 · timer` |
| **不翻译** | `compact`（原样） | `timer`（原样，无说明） |

- 只在界面语言为「中文」时生效；切回英文界面自动还原，不影响任何功能；
- 命令名仅是**显示**上的中文化，实际执行仍用英文命令（输入 `/compact` 照常可用）；
- 插件卡片展开后仍可看到完整英文包名，搜索英文名也不受影响。

## 插件列表：分类标签栏 + 备注徽章

在 **设置 → 插件 → 插件列表** 页面顶部新增了**分类标签栏**，按"它是干什么的"从非专业用户视角分类，点一下即筛选：

| 标签 | 包含内容 |
|---|---|
| **全部** | 所有插件 |
| **系统** | DSH 运行基础：会话、存储、Agent、任务、网络、调度等 |
| **界面** | 界面显示与交互（对话、设置、侧边栏、主题、语言等） |
| **模型** | 大模型接入、默认模型、模型选择 |
| **工具** | Agent 使用的工具：文件、命令、联网、技能、子智能体、工作流 |
| **安全** | 沙箱、审批、权限、凭据 |
| **增强** | 中文增强、费用统计、远程访问、语音等附加功能 |

每张插件卡片右上角还有一个**备注徽章**，一眼看出插件来源：

- **官方**（蓝色）：DeepSeek Harness 官方组件（`@deepseek-ai/*`）
- **自研**（绿色）：自己写的插件（默认为本插件与 dsh-image-inline，可在 `SELF_MADE` 表里改）
- **第三方**（橙色）：社区作者开发的插件

> 标签栏与徽章独立于"翻译模式"：即使选择「不翻译」，分类筛选和来源徽章仍然可用；徽章归属可按需编辑 `lib/client.js` 里的 `SELF_MADE` 集合与 `CATEGORY_OVERRIDE` 表。

## 安装

```sh
# 从 GitHub 安装（免构建，纯 ESM）
dsh plugin --profile web add github:Como44/dsh-zh-more
```

也可以通过 DSH 插件市场（dsh-market / awesome-dsh-plugin 目录）搜索 `dsh-zh-more` 一键安装。

> 装完重启一次 `dsh web` 即可。插件挂载后，浏览器**硬刷新（Ctrl+Shift+R）**页面生效。

## 使用

1. 设置 → 语言 → 中文；
2. 设置 → 翻译设置 → 选择显示模式；
3. 输入框按 `/` 看命令菜单，设置 → 插件 → 插件列表 看效果。

## 自定义词典

所有翻译都维护在 `lib/client.js` 顶部的两个表里，编辑后刷新页面即生效：

- `COMMAND_NAMES`：命令名 → 中文名；
- `PLUGIN_INFO`：完整插件包名 → `[中文名, 一句话用途]`。

## 工作原理

纯**浏览器端**插件（另有空主机半身用于挂载）。用 MutationObserver 在中文界面下改写：

- 命令菜单行的命令名文本与说明行前缀；
- 插件卡片标题与用途说明行（title 独占一行、说明自动换行的两行式布局）。

原文本保存在元素 `data-dsh-zh-more-orig` 属性中，界面切英文或模式关闭时完整还原。无网络请求、不碰凭据与会话数据。

## 兼容性

- 面向 DSH `0.1.0-rc.6` Web profile（当前官方版本）；
- 与 [deepseek-harness-zh_pro](https://github.com/magian1127/deepseek-harness-zh_pro)（界面残留英文补全）互补使用，互不冲突；"不翻译"模式只关闭本插件的汉化，zh_pro 的补全可在其"增强设置"里单独关闭。

## 卸载

```sh
dsh plugin --profile web remove dsh-zh-more
```

## License

[MIT](LICENSE) © 2026 Como44