✨ 功能特性

📸 界面展示

插件主页面 —— 总开关、五项功能开关与智能功能

插件面板全面汉化 —— 230+ 插件的中文名称与说明

命令面板全面双语 —— 英文命令名 + 中文说明

工作区写入权限汉化 —— Read Only（只读） / Workspace Write（工作区写入） / Full access（完全访问）

Agent 预设汉化 —— 预设名称与说明显示中文（anchored-standard → 锚定标准模式（实验））

🚀 安装方法

1. 将本目录复制到 DSH profile 的 node_modules：

   # 以桌面版 profile 为例：
   Copy-Item .\dsh-gui-hanhua -Recurse "$env:USERPROFILE\.dsh\profiles\web-desktop\node_modules\"

2. 在 cordis.patch.yml 注册插件（web-desktop 与 web 两个 profile 都可用）：

   - insert:
       - id: gui-hanhua
         name: 'dsh-gui-hanhua'
         disabled: false

3. 重启 DeepSeek Harness —— 插件自动加载（常驻插件，无需手动运行）。
4. 打开 设置 → GUI汉化设置 即可管理全部功能。

💡 无需构建：客户端为手写 bundle——client 端改动刷新页面即可，host 端改动需重启。

⚙️ 配置说明

所有配置位于 settings.yaml 的 gui-hanhua 段：

全部可在设置页可视化编辑：搜索、新增、删除、启用/禁用。

🧠 智能功能（AI 驱动）

设置页提供两个 AI 按钮——点击后打开新对话并自动向 Agent 发送任务提示词：

⚠️ 两种功能都会消耗 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 © 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 支持）