# dsh-enhancements — DeepSeek Harness 增强插件集

把 DeepSeek Harness 升级为 **Codex 级智能助手** 的全部开发成果归档于此：
插件源码、桌面应用壳脚本、视觉桥接补丁、文档与规划。

> 由本机 agent 会话持续开发，随开发进度同步推送到 GitHub / Gitea。

## 目录结构

```
dsh-enhancements/
├── README.md              # 本文件
├── docs/
│   ├── PLAN.md            # 总体规划（Codex 化路线图）
│   └── mmx-image-bridge-PATCH.md  # 聊天发图→mmx 视觉识别 桥接补丁说明
├── plugins/               # 每个插件一个目录（源码 + 说明）
│   └── dsh-usage/         # 用户头像 + API 消耗面板
├── presets/               # Agent 预设（落盘形式，重启可用）
├── tools/                 # 辅助脚本
│   ├── dl-gh.mjs          # 用 node fetch 下载 gh CLI（沙箱内 curl 被禁时的替代）
│   └── gh-download/       # 下载缓存（不入库，见 .gitignore）
└── assets/                # 图标等资源
    └── dsh.ico            # DeepSeek 鲸鱼图标（托盘/快捷方式用）
```

## 已包含

- **桌面应用壳**：`C:\Users\a1703\.dsh\bin\dsh-app.ps1`（托盘 + Edge 独立窗口）与桌面快捷方式 `DeepSeek Harness.lnk` —— 见 docs/ 说明
- **视觉桥接**：聊天窗口发图 → MiniMax M3（NVIDIA 托管）识别
- **dsh-usage 插件**：侧边栏底部 🐋 用户头像 → DeepSeek 官方余额 API 消耗面板

## 安全说明

- 本仓库**绝不包含**任何 API Key、Token、密码。
- 部署机上的凭据位于 `%DSH_HOME%\.credentials.yaml`，由运行时读取，不入库。
- Gitea 等远程地址的凭据使用系统凭据管理器，不写入 `.git/config`。

## 快速开始（新机器）

1. 安装 Node.js ≥ 18（带全局 fetch）
2. 把 `tools/dl-gh.mjs` 下载的 gh 解压到 PATH，或直接用 git
3. 按 `docs/PLAN.md` 各阶段说明启用插件