eidolon-assistant 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

eidolon-assistant 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

eidolon-assistant 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

eidolon-assistant 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/10/28。

角色语音助手 WONJU080/eidolon-assistant

DeepSeek Harness

WONJU0807 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

用语音唤醒角色闲聊，并代你操作电脑执行任务

29.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/11/2 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add WONJU080/eidolon-assistant

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么[目录]—

dsh 原生插件 · chat

暂无时间戳·判据 →

装得上吗[实装验证]—

本站尚未做安装检查

暂无时间戳·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/03·判据 →

还在维护吗[仓库]✓

活跃：最近一次提交在 7 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令发起外部网络请求

查看扫描证据（共 4 处，展示前 4 条）

发起网络请求
desktop/electron/main.ts:65
const request = http.get(url, { timeout: timeoutMs }, (response) => {
发起网络请求
desktop/electron/main.ts:85
const request = http.request(
执行外部命令来自配置/变量
desktop/electron/main.ts:166
const proc = spawn(python, args, {
发起网络请求
desktop/src/lib.ts:2
const response = await fetch(`${base}${path}`, {

扫描于 2026/11/3（1 天前） · 范围全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

基于 DeepSeek Harness 的 macOS 语音角色助手，能控制你的 dsh 并扮演角色，创意来自 Eidolon-SC

README

由 DeepSeek 最新模型翻译生成

本项目创意来自： Sallyn0225/eidolon-sc 本项目演示视频： https://www.bilibili.com/video/BV1FQnD6AEgE/ Eidolon Assistant 一个 macOS 语音角色助手：你说话，角色回应；需要操作电脑时，交给本机 DeepSeek Harness 执行。角色有自己的声音、人设和唤醒词。你可以和角色闲聊，也可以让它查资料、读写文件、运行命令。任务开始前角色会用角色口吻向你确认；执行结果用日语台词 + 中文字幕汇报。主界面这是源码项目，不是一键安装的 .app。需要 macOS、Python、Node.js、DeepSeek Harness，并自己填写 API key。部署步骤在下面的「部署（重点）」；完整手册见 INSTALL.md。玩法 - 语音唤醒：说「拉姆」唤醒默认角色；切换角色后使用该角色的中文唤醒词。 - 聊天 + 任务：闲聊直接回答；说「帮我查一下明天的天气」「把桌面上的文件整理一下」会进入任务流程。 - 先确认再执行：删除、覆盖、运行命令等操作会先问你是否允许；拒绝就不执行。 - 随时打断：说话中可以按「中断」停止 TTS 和任务。 - 看原始过程：原始面板能看到 Harness 实际执行的命令和输出，不只是角色的总结。

展开完整文档（README 剩余 1 节）

本项目创意来自： Sallyn0225/eidolon-sc

本项目演示视频： https://www.bilibili.com/video/BV1FQnD6AEgE/

Eidolon Assistant

一个 macOS 语音角色助手：你说话，角色回应；需要操作电脑时，交给本机 DeepSeek Harness 执行。

角色有自己的声音、人设和唤醒词。你可以和角色闲聊，也可以让它查资料、读写文件、运行命令。
任务开始前角色会用角色口吻向你确认；执行结果用日语台词 + 中文字幕汇报。

主界面

这是源码项目，不是一键安装的 .app。
需要 macOS、Python、Node.js、DeepSeek Harness，并自己填写 API key。
部署步骤在下面的「部署（重点）」；完整手册见 INSTALL.md。

玩法

- 语音唤醒：说「拉姆」唤醒默认角色；切换角色后使用该角色的中文唤醒词。
- 聊天 + 任务：闲聊直接回答；说「帮我查一下明天的天气」「把桌面上的文件整理一下」会进入任务流程。
- 先确认再执行：删除、覆盖、运行命令等操作会先问你是否允许；拒绝就不执行。
- 随时打断：说话中可以按「中断」停止 TTS 和任务。
- 看原始过程：原始面板能看到 Harness 实际执行的命令和输出，不只是角色的总结。
- 多角色：拉姆蕾萨尔和二阶堂希罗可切换；每个角色有自己的声音、唤醒词、人设和回应方式。
- 角色包：.eidolon 文件可导入/导出，可以自己做角色或分享别人的角色。
- 语音设置：设置里可选麦克风、看实时电平、调 VAD 阈值、静音判定和唤醒灵敏度。

角色

仓库自带两个可导入角色：

characters/
├── ramlethal.eidolon # 拉姆蕾萨尔，默认导入 └── hiro.eidolon # 二阶堂希罗

- 拉姆蕾萨尔：默认角色，安装时自动导入。
- 二阶堂希罗：进入 设置 → 角色 → 导入 .eidolon，选择 characters/hiro.eidolon。

角色包只以 .eidolon 形式保存，不再把 sheet.md、character.toml、头像散落在仓库里。
想制作新角色，看 docs/CHARACTER-AUTHORING-PROMPT.md。

部署（重点）

先准备

- macOS 13 或更新版本（主要在 Apple Silicon 上测试）。
- Python 3.12+。
- Node.js 20+。
- 已安装并登录 DeepSeek Harness 桌面版。
- DeepSeek、阿里云百炼（DashScope）、Fish Audio 三个 API key。

三步启动

1. 下载并安装依赖（自动建 venv、装 npm、下载 KWS 模型、导入默认角色）
git clone https://github.com/WONJU080/eidolon-assistant.git eidolon-assistant
cd eidolon-assistant
./scripts/setup.sh

2. 填 API key（二选一） open -e config/local.env 或从已有 .env 导入： ./scripts/import_keys.sh /path/to/your.env

3. 启动 ./scripts/run.sh

setup.sh 只需要跑一次。 它做的是：

1. 检查 Python/Node 版本；
2. 创建 .venv，安装 backend；
3. 安装 desktop/node_modules；
4. 构建桌面端；
5. 下载 KWS 唤醒模型；
6. 创建 config/local.env（权限 600）；
7. 把 characters/ramlethal.eidolon 导入到运行目录。

更细的逐步说明、手动安装和故障排查在 INSTALL.md。

第一次启动

1. macOS 会询问麦克风权限：允许 Eidolon Assistant/Electron（用 backend.sh 时是 Terminal）。
2. 在输入框发一句「你好」，确认角色能回复。
3. 按「开始听」说一句「拉姆」，确认唤醒和语音。
4. 打开 设置 → 麦克风与唤醒，选输入设备，确认实时电平。
5. 打开 设置 → 角色，可导入希罗并切换。

密钥

仓库里没有真实密钥。config/local.env 被 .gitignore 忽略。

CHAT_LLM_BASE_URL=https://api.deepseek.com/v1
CHAT_LLM_MODEL=deepseek-chat
CHAT_LLM_API_KEY=...
DASHSCOPE_API_KEY=...
FISH_AUDIO_API_KEY=...

- 模板：config/local.env.example
- 导入已有 .env：./scripts/import_keys.sh /path/to/your.env
- 文件权限应为 600；不要提交、截图或上传。
- 没有 key 时 app 仍能启动，但对应服务不可用。

常用命令

./scripts/run.sh # 构建并启动 Electron 桌面应用 ./scripts/dev.sh # 开发模式（热更新） ./scripts/backend.sh --port 8799 # 只启动 backend，浏览器打开 http://127.0.0.1:8799/ ./scripts/check.sh # 检查依赖/模型/角色/配置 ./scripts/test.sh # 运行测试和构建

简单原理

角色层负责对话、判断、确认和转达；真正的文件/命令/网页操作由本机 DeepSeek Harness 执行。
语音识别走 DashScope，TTS 走 Fish Audio，聊天走 DeepSeek；密钥只存本地。

注意

- 只支持 macOS；目前主要在 Apple Silicon 上验证。
- 不是签名或公证过的 app，没有 DMG，没有首启向导，也没有自动更新。
- 任务操作要求 DeepSeek Harness 已安装并登录；本项目不包含它。
- 角色头像和人设来自原作品；公开分发前请确认版权。
- 默认音色来自原项目的 Fish Audio reference id；分享角色包时建议换成你自己的音色 id。
- 角色包只支持 character.toml、sheet.md、assets/ 图片、README/LICENSE。

开发与测试

./scripts/test.sh

会运行 43 个 backend 测试、TypeScript 检查和桌面端构建。

更多内部资料：

- INSTALL.md — 第一次安装
- docs/development/HANDOFF_PROMPT.md — 项目背景
- docs/P0-VERIFICATION.md — 语音/ACP 验证
- docs/CHARACTER-AUTHORING-PROMPT.md — 角色制作提示词

License

当前仓库还没有添加 LICENSE。公开使用或分发前请先确定代码许可证；角色图片、角色人设和 KWS 模型分别受原作品或模型许可证约束。