liang-desktop-pet (liang-harness-plugin)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# Liang Desktop Pet

一个非官方的 DeepSeek Harness 人物交互项目，提供独立 Electron 桌面版和可直接安装到 Harness Web profile 的 Cordis 插件。人物可拖动，点击后打开对话框，并支持四种 Harness 模式、六档人物语气和公开思考摘要。

![应用截图](docs/screenshot.png)

> [!IMPORTANT]
> 本项目不是 DeepSeek 官方产品，也不代表图中人物本人。代码与人物素材采用不同授权，公开再分发前请阅读 [ASSETS_LICENSE.md](ASSETS_LICENSE.md)。

## 下载

前往 [GitHub Releases](https://github.com/Flycat43/liang-desktop-pet/releases) 下载对应系统的安装包。首次打开未签名版本时，系统可能提示来源未知。

- [`liang-harness-plugin.tgz`](https://github.com/Flycat43/liang-desktop-pet/releases/latest/download/liang-harness-plugin.tgz)：Harness 插件版的固定下载地址，安装说明见 [插件中文说明书](plugins/liang-harness-plugin/MANUAL.zh-CN.md)。
- `Liang Desktop Pet-*`：独立 Electron 桌面版。

每次发布还会附带 `SHA256SUMS-plugin.txt`，用于校验插件包与中文说明书。

插件市场维护者可查看 [安装源、权限边界与审核说明](plugins/liang-harness-plugin/MARKETPLACE.md)。

安装插件版：

```bash
npx @deepseek-ai/dsh plugin --profile web add /绝对路径/liang-harness-plugin.tgz
npx @deepseek-ai/dsh web
```

## 功能

### Harness 插件版

- 正式 `dsh.bundle` + `dsh.client` 插件包，安装后自动加入 web profile
- 直接调用 Harness 当前会话服务发送任务和订阅输出
- 在 Harness 页面内显示可拖动人物，不覆盖其他应用
- 六档渐变人物、四种任务模式、公开思考摘要和系统语音朗读

### Electron 桌面版

- 透明无边框桌面窗口，不强制置顶
- 左下角按钮可在人物桌宠与 Harness 完整界面之间双向切换
- Harness 完整界面支持顶部拖动及关闭、最小化、放大或还原
- 点击人物开关对话框，拖动人物移动窗口
- 多会话创建、切换、删除和清空
- 标准、PTC、极简、创造四种处理模式
- 小梁至梁祖六档人物、措辞和男声音色
- 可展开的公开思考摘要
- 自动朗读、上下文开关和上下文条数设置
- 在设置中选择 Harness 工作区

## 环境

- Node.js 22.12 或更高版本
- 可用的 DeepSeek API Key
- macOS、Windows 或 Linux

项目依赖中已包含 DeepSeek Harness。首次使用前，建议先在终端运行一次官方配置界面：

```bash
npx @deepseek-ai/dsh web
```

在 Harness 中完成模型与 API Key 配置后关闭网页，再启动桌面应用。不要把 API Key 写进源码或提交到 GitHub。

## 本地运行

```bash
git clone https://github.com/Flycat43/liang-desktop-pet.git
cd liang-desktop-pet
npm ci
npm start
```

打开人物对话框，进入“设置”，选择允许 Harness 读取和修改的工作目录。

## 打包

```bash
# macOS: DMG + ZIP
npm run dist:mac

# Windows: NSIS 安装器 + 便携版 EXE
npm run dist:win

# Linux: AppImage
npm run dist:linux
```

产物位于 `dist/`。建议在对应操作系统上构建对应安装包。

## 自动发布

仓库包含 GitHub Actions。推送版本标签后会在三个系统上构建，并把安装包、固定名称插件包和 SHA-256 校验文件上传到 GitHub Releases：

```bash
git tag v0.2.0
git push origin v0.2.0
```

默认构建未配置商业代码签名。macOS Gatekeeper 和 Windows SmartScreen 可能提示来源未知；正式分发时应配置 Apple Developer ID、公证和 Windows 代码签名证书。

## 安全与隐私

- Harness 可以执行命令并修改所选工作区。请优先使用有 Git 版本控制的目录。
- Electron 桌面版在开启朗读时会把最终文本发送至 Microsoft Edge Read Aloud 服务；Harness 插件版使用浏览器系统语音，不新增语音服务请求。
- 会话记录保存在 Electron 本地存储中，不会提交到仓库。

## 授权

源代码使用 [MIT License](LICENSE)。人物 PNG 不属于 MIT 授权，详见 [ASSETS_LICENSE.md](ASSETS_LICENSE.md)。第三方依赖见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。