dsh-gui-hanhua
DeepSeek Harness 界面信息汉化插件：工具调用卡片、插件列表、命令菜单与权限选择器显示中文，保留英文原名。
xizrsams
@xizrsams
⬇ 2
★ 1
main
安装
dsh plugin --profile web add github:xizrsams/dsh-gui-hanhua
需要可复现安装时，可在仓库后追加 #commit 固定提交。
DeepSeek Harness 界面信息汉化插件：工具调用卡片、插件列表、命令菜单与权限选择器显示中文，保留英文原名。
该插件未提供要点说明，请参考仓库 README。
chinesedeepseek-harnessdsh-plugini18nlocalization
- 安装并启动 DeepSeek Harness：
npx @deepseek-ai/dsh web - 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
- 用 dsh plugins list 确认已安装，必要时重启 Harness 生效
插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。
| 代码仓库 | github.com/xizrsams/dsh-gui-hanhua |
| 许可证 | MIT |
| 主要语言 | main |
| 下载量 | 2 |
| GitHub 星标 | 1 |
| 最近推送 | 2026-08-19 |
| 收录日期 | 2026-09-19 |
| 分类 | 界面增强 |
事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。
以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。
# 🌏 dsh-gui-hanhua
### DeepSeek Harness 界面信息汉化插件
> **语言永远不会成为 Agent 的门槛。**
>
> **Language should never be a barrier for Agents.**
**📌 当前版本：v1.1.0**
一款**常驻型**汉化插件，让 DeepSeek Harness 的界面开口说中文——AI 工具卡片、插件列表、命令面板、权限选项，全部显示中文（同时保留英文原名）。
[English Docs](./README.en.md)
---
## ✨ 功能特性
| | 功能 | 说明 |
|---|---|---|
| 🃏 | **工具卡片汉化** | 对话中 AI 工具调用卡片显示中文名 + 一句话说明（如 `pwsh` → 执行 PowerShell） |
| 📦 | **插件列表汉化** | 设置 → 插件：230+ 插件的中文名称，保留英文原名 |
| ⌨️ | **命令面板双语** | `/` 菜单显示**英文命令名 + 中文说明**——`/plan` → 计划模式：进入或退出计划模式（先规划后执行） |
| 🔐 | **权限选择器双语** | `Read Only（只读）` / `Workspace Write（工作区写入）` / `Full access（完全访问）` |
| 🎛️ | **总开关 + 分项开关** | 一键开启/关闭全部汉化，或按功能独立控制 |
| 💾 | **配置持久化** | 字典自动保存到 `settings.yaml`，重启自动恢复 |
| 🤖 | **AI 自动识别** | 一键打开新对话，让 Agent 自动分析并汉化未汉化的插件 |
| 🩺 | **AI 自检** | 一键让 Agent 检查插件文件、配置与注册状态，自动修复问题 |
---
## 📸 界面展示
**插件主页面** —— 总开关、五项功能开关与智能功能
[图片: 插件主页面]
**插件面板全面汉化** —— 230+ 插件的中文名称与说明
[图片: 插件面板汉化]
**命令面板全面双语** —— 英文命令名 + 中文说明
[图片: 命令面板双语]
**工作区写入权限汉化** —— `Read Only（只读）` / `Workspace Write（工作区写入）` / `Full access（完全访问）`
[图片: 权限选择器双语]
**Agent 预设汉化** —— 预设名称与说明显示中文（anchored-standard → 锚定标准模式（实验））
[图片: Agent 预设汉化]
---
## 🚀 安装方法
1. 将本目录复制到 DSH profile 的 node_modules：
```powershell
# 以桌面版 profile 为例：
Copy-Item .\dsh-gui-hanhua -Recurse "$env:USERPROFILE\.dsh\profiles\web-desktop\node_modules\"
```
2. 在 `cordis.patch.yml` 注册插件（web-desktop 与 web 两个 profile 都可用）：
```yaml
- insert:
- id: gui-hanhua
name: 'dsh-gui-hanhua'
disabled: false
```
3. **重启 DeepSeek Harness** —— 插件自动加载（常驻插件，无需手动运行）。
4. 打开 **设置 → GUI汉化设置** 即可管理全部功能。
> 💡 无需构建：客户端为手写 bundle——client 端改动刷新页面即可，host 端改动需重启。
---
## ⚙️ 配置说明
所有配置位于 `settings.yaml` 的 `gui-hanhua` 段：
| 字段 | 说明 |
|---|---|
| `flags.master` | 汉化功能总开关 |
| `flags.toolCards` | 工具卡片汉化 |
| `flags.pluginList` | 插件列表汉化 |
| `flags.commandMenu` | 命令面板双语说明 |
| `flags.persist` | 修改持久化到磁盘 |
| `tools` / `plugins` / `commands` | 翻译字典（每条含 `zh` / `desc` / `enabled`） |
全部可在设置页可视化编辑：搜索、新增、删除、启用/禁用。
---
## 🧠 智能功能（AI 驱动）
设置页提供两个 AI 按钮——点击后**打开新对话**并自动向 Agent 发送任务提示词：
| 按钮 | Agent 会做什么 |
|---|---|
| **自动识别** | 扫描当前已安装但未汉化的插件/工具，设计中文名与说明，写入 `settings.yaml`——插件即时生效 |
| **AI 自检** | 检查注册状态、文件完整性、配置完整性与冲突；能修复的直接修复，其余给出建议 |
> ⚠️ 两种功能都会**消耗 token**；写文件时需您在场确认授权。
---
## 🔧 工作原理
- **客户端**（`client.js`）：手写 ModuleLoader bundle——注册设置页、工具卡片/插件列表/命令执行行槽位、权限双语字典。
- **宿主端**（`index.js`）：注册 `gui-hanhua` 设置命名空间、持久化字典，并通过 `vendor/dsh-commands-hanhua.js` 向 `dsh-commands` 注入只读双语钩子（命令说明）。
- **安全优先**：所有补丁幂等、失败仅告警、插件未加载时行为与原版完全一致；插件自身出错也绝不影响 GUI 其他部分。
---
## ❓ 常见问题
- **卡片没汉化？** 确认总开关与对应分开关已开启，且字典中存在该条目并已启用。
- **设置入口不见了？** 检查 `cordis.patch.yml` 中 gui-hanhua 行是否有 `disabled: true`。
- **命令说明不显示？** 确认「命令面板汉化」开关开启，且字典中存在该命令。
- **界面乱码？** 多为文件编码问题——运行「AI 自检」，让 Agent 检查并修复相关文件。
---
## 🤝 参与贡献
本项目为二次开发友好设计：
- 默认字典（`DEFAULT_TOOLS` / `DEFAULT_COMMANDS` / `DEFAULT_PLUGINS`）集中定义，一处修改全局生效；
- AI 任务提示词（`buildAutoPrompt` / `buildSelfCheckPrompt`）可自由定制；
- 界面文案全部内联，无外部资源依赖；
- 部署即复制 + 注册，无需构建。
欢迎提交 Issue 与 Pull Request！
---
## 📄 开源许可
[MIT](./LICENSE) © 2026
---
## 📝 更新日志 / Changelog
### v1.1.0（2026-08-19）——当前版本
**新功能**：
- **Agent 预设汉化**：预设名称与说明显示中文（含「Agent预设汉化」开关，字典可在 settings.yaml 的 `gui-hanhua.presets` 段维护）
- **AI 自动识别 / AI 自检覆盖 Agent 预设**：自动扫描 `~/.dsh/.agent-presets/` 目录并汉化未汉化的预设
- **版本检查与自动更新**：启动/手动对比 GitHub 仓库版本（旧/当前/领先三态识别），发现新版本自动弹窗确认，确认后自动下载并覆盖插件文件（覆盖前自动备份 `.bak`）
**修复的 Bug**：
- 移除不兼容的 `z.object().partial()`（曾导致插件加载失败、dsh 启动崩溃）
- schema 构建增加兜底：任何失败自动退回宽松结构，插件永不再因自身问题崩溃
- AI 任务提示词中的硬编码用户路径通用化（隐私修复）
### v1.0.0（2026-08-18）
**新功能**：
- 工具卡片 / 插件列表 / 命令面板 / 权限选择器汉化
- 总开关 + 分项开关 + 配置持久化
- 翻译字典可视化编辑（搜索 / 增删 / 启用禁用 / 导入导出 / 恢复默认）
- 智能功能：AI 自动识别（自动汉化未汉化插件）、AI 自检（检查并修复插件问题）
- 常驻加载（web-desktop / web 双 profile 支持）
**语言永远不会成为 Agent 的门槛**
**🚀 还会持续更新的！**
数据来源：公开的 DeepSeek Harness 插件目录与各插件 GitHub 仓库。本站为独立第三方目录，与 DeepSeek、幻方（High-Flyer）及插件作者均无隶属或背书关系。
