# dsh-awesome-plugins

**Repository Path**: ezemeti/dsh-awesome-plugins

## Basic Information

- **Project Name**: dsh-awesome-plugins
- **Description**: DeepSeek Harness (DSH) 官方 Web 客户端的实用插件合集：记忆（长期/短期/教训）、日程待办、提示词模板、图像识别、应用抽屉，AI 工具 + 客户端管理面板双入口。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-20
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DSH Awesome Plugins — DeepSeek Harness 实用插件合集

> 为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh web`）提供开箱即用的能力增强：记忆、日程待办、提示词模板、图像识别、应用抽屉。每个插件均提供 **AI 工具 + 客户端管理面板** 双入口。

## ✨ 功能总览

| 插件 | 功能 | 数据存储 | 入口 |
| --- | --- | --- | --- |
| `dsh-memory-plugin` | 长期 / 短期 / 教训 三层记忆 | Markdown 文件 | 聊天工具 + 管理面板 |
| `dsh-schedule-plugin` | 日程 / 待办管理 | SQLite | 聊天工具 + 管理面板 |
| `dsh-prompt-plugin` | 提示词模板快捷插入（`{}` 占位符） | Markdown 文件 | 应用抽屉 |
| `dsh-vision-plugin` | 图像理解（智谱 GLM-4.6V-Flash） | 无 | 聊天工具 |
| `dsh-plugin-apps` | 插件应用抽屉（侧边栏统一入口） | 无 | 侧边栏 |

## 🚀 快速开始

以下安装方式基于 DSH 的 profile 插件机制（详见官方文档）。

```bash
# 1. 克隆本仓库
git clone https://gitee.com/ezemeti/dsh-awesome-plugins.git

# 2. 进入你的 DSH profile 目录（示例为 web）
cd ~/.dsh/profiles/web

# 3. 以本地依赖方式安装所需插件（示例安装记忆插件）
pnpm add "dsh-memory-plugin@link:D:/path/to/dsh-awesome-plugins/dsh-memory-plugin"

# 4. 在 profile 的 package.json 中，将插件加入 dsh.profile.bundles 列表
# 5. 重启 dsh web，刷新浏览器即可在侧边栏 / 应用抽屉看到入口
```

> `dsh-plugin-apps`（应用抽屉）是侧边栏统一入口，建议优先安装，其余插件会出现在它的抽屉中。

## 📦 插件详解

### dsh-memory-plugin — 三层记忆

AI 可长期记忆用户偏好与事实，并记录每日事件与自身教训：

- **长期记忆**：单个 `long-term.md`，整文件读写（`memory_long_read` / `memory_long_write`）
- **短期记忆**：按日期 `short/YYYY-MM-DD.md`，一天一个文件（`memory_short_create` / `list` / `get` / `update` / `delete`）
- **教训记忆**：`lessons/` 目录，一条一个文件，AI 自用，用户只读可删（`memory_lesson_create` / `list` / `get` / `update` / `delete`）

管理面板三个标签页：长期记忆（整文件编辑器）、短期记忆（日期导航 + 增删改查）、教训记忆（只读 + 删除）。

### dsh-schedule-plugin — 日程 / 待办

SQLite 持久化，支持两类记录：

- **日程**（`schedule_*`）：带时间的计划安排
- **待办**（`todo_*`）：无时间要求的待办事项

均支持搜索、状态 / 优先级 / 标签过滤、排序，客户端面板可视化增删改查。

### dsh-prompt-plugin — 提示词模板

管理带 `{}` 占位符的提示词模板，快捷插入到对话输入框。工具：`prompt_list` / `prompt_get` / `prompt_create` / `prompt_update` / `prompt_delete`。

### dsh-vision-plugin — 视觉识别

调用智谱 `GLM-4.6V-Flash` 多模态模型，让 AI 看懂图片。工具：`view_image`（本地路径）、`view_image_file`（上传文件）。需配置智谱 API Key。

### dsh-plugin-apps — 应用抽屉

提供侧边栏统一入口（`apps.entry` / `apps.panel` 插槽），承载本集合中带管理面板的插件应用。

## 🏗 架构说明

所有插件基于 [Cordis](https://github.com/cordiverse/cordis) 框架，遵循 DSH「everything is a plugin」理念：

- 服务端通过 `ctx.tools.register(defineTool(...))` 暴露 AI 工具，通过 `ctx.webServer.register(...)` 提供 HTTP API，通过 `ctx.systemPrompt.section(...)` 注入使用说明
- 客户端通过 `ctx.slots.inject("apps.entry" | "apps.panel")` 注册应用入口与面板

## 📄 许可证

[MIT](./LICENSE)