Yihong89/dsh-companion

Name: Yihong89/dsh-companion
Author: Yihong89

Plugin插件 Native原生 ⭐ 2 Search & Web Access搜索与联网 Dev Workflow开发与代码工作流 Sessions & Context会话与上下文

A fully customizable companion Agent (DeepSeek Harness plugin) — name, personality, and voice are all configured by you in conversation; no need to fork the repo or publish a new package. Voice is generated by Qwen3-TTS (self-hosted on a Mac mini) and played in the browser — cross-platform (macOS / Windows / Chrome / Edge / Safari), no server TTS or API key required.

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-companion is a DeepSeek Harness plugin offering a fully customizable companion agent. Core capability: configure name, personality, and voice per session via a 👤 button, with every reply synthesized by a locally deployed Qwen3-TTS and played in the browser across platforms. It supports built-in or text-described voices, session-specific scheduled greetings, and speak/cheer tools. Use it when you need a personalized, session-isolated companion without forking or republishing. Caveat: a Qwen3-TTS service must be running on a mac mini host, and voice previews are generated on demand with no caching.

dsh-companion 是 DeepSeek Harness 插件，提供会话内可定制的陪伴 Agent。核心能力：通过 👤 按钮配置名称、性格与人设，每次回复由 Qwen3-TTS 本地合成并由浏览器播放，支持内置或文字描述的音色，以及按会话保存的定时问候、speak/cheer 工具与打气卡片。适用于需要长期自定义人设、按会话独立运行的轻量交互场景。前提是 mac mini 上需部署 TTS 服务。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-companion（Yihong89/dsh-companion）
仓库：https://github.com/Yihong89/dsh-companion
本站详情页：https://www.yhbd.top/plugins/yihong89-dsh-companion/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 2 · 最近提交 2026-08-17 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
Only 2 stars - very few users, little community feedback星标只有 2，几乎没人在用，遇到问题缺少社区反馈

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:Yihong89/dsh-companion

把 Yihong89/dsh-companion 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.6 KB · 缓存于 2026-08-25 04:53:48 · 4.6 KB

dsh-companion

一个完全可自定义的陪伴 Agent（DeepSeek Harness 插件）——名字、性格、声音都由你在对话里配置，不需要 fork 仓库或发布新包。声音由 Qwen3-TTS（本地部署在 mac mini 上）生成，浏览器播放——跨平台（macOS / Windows / Chrome / Edge / Safari），无需服务器 TTS 或 API key。

任意人设 · 任意声音 · 每个会话自己的定时问候 · 零构建

亮点

会话内配置：会话标题旁的 👤 按钮打开配置窗口——填名字、性格设定，选一个内置音色（点击试听）或直接用文字描述一个全新的声音，Qwen3-TTS 会按你的描述生成。保存立刻生效，不用重启。
每个会话独立：人设按会话保存，不同会话可以是完全不同的搭档；新会话在第一次保存前使用一个通用的默认人设（小助手）。
自动朗读每一句回复：搭档每次回话都会说出口，用的是这个会话保存的声音。
speak / cheer 模型工具：搭档可随时要求把某句念出来，或弹出 💛 打气卡片。
每个搭档自己的定时问候：在配置窗口里加一个或多个时间（HH:MM），到点会用这个搭档的人设生成一句问候，只送进这一个会话——不会影响其他会话。

架构

浏览器 (dsh web GUI)                 mac mini (dsh host)
┌─────────────────────┐   /dsh-companion/tts     ┌──────────────────────────┐
│  client.js            │ ───────────────────────► │ dsh-companion 插件 (Node) │
│  fetch WAV → <audio>  │                          │  代理 → 127.0.0.1:3091   │
└─────────────────────┘                          └──────────┬───────────────┘
                                                            │ http
                                              ┌─────────────▼─────────────┐
                                              │ tts_service.py (FastAPI)  │
                                              │ Qwen3-TTS-12Hz-1.7B-      │
                                              │ VoiceDesign (MPS)         │
                                              └───────────────────────────┘

人设/声音/问候时间存在 $DSH_HOME/state/dsh-companion/personas/<sessionId>.json，按会话读写；系统提示词按会话动态渲染（一个 preset composition 每进程只挂载一次，被所有会话共享，所以人设不能写死在插件启动时的闭包里）。问候调度也是按会话独立跑的一套小定时器，不是所有会话共用一个全局时间表。

安装

1. mac mini 上部署 TTS 服务（只需一次）

brew install portaudio ffmpeg sox
/usr/local/bin/python3.12 -m venv ~/qwen-tts-venv
~/qwen-tts-venv/bin/pip install -U qwen-tts
# 把 tts_service.py 放到 ~/tts_service.py，然后：
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.dsh.sister-tts.plist

2. 安装插件

dsh plugin --profile web add github:Yihong89/dsh-companion

Bundle patch 有意为空——插件只在预设里显式写了 name: dsh-companion 行时才激活（即 companion 预设 ~/.dsh/.agent-presets/companion/agent.cordis.yml）。

3. 创建 `companion` 预设

~/.dsh/.agent-presets/companion/agent.cordis.yml：

- insert:
    - id: dsh-companion
      name: dsh-companion

用这个预设新建会话后，点会话标题旁的 👤 按钮即可开始配置。

命令

命令	作用
`/speak on\|off`	开关自动朗读
`/speak <text>`	立刻把文字念出来
`/cheer [text]`	立刻送一句打气（朗读 + 💛 卡片）；不写文字用内置语库