← 返回列表
需源码安装
Chatterfly × DeepSeek Harness 研究
暂不能直接安装（需源码编译或环境不满足）：仓库缺少 package.json，无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/9/22 · 已提供中文文档
# 关于腾讯 Chatterfly 与 DeepSeek Harness 集成的研究与可复现笔记
综合分
30
GitHub 分
30
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add leozw77/Chatterfly-DSH-Research仓库缺少 package.json，无法用 dsh 插件安装命令安装，改用 GitHub 源安装
信任档位：已验证本站已于 1 天前真实安装成功
- 是什么
- dsh 原生插件 · chat
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 3 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/24
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/22（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包Chatterfly-DSH-Research（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
仓库缺少 package.json，无法用 dsh 插件安装命令安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 15:33:36
用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成Chatterfly × DeepSeek Harness 研究
腾讯 Chatterfly（Windows）与 DeepSeek Harness（DSH）隐藏/实验集成的公开研究记录、复现说明与辅助工具。
研究日期：2026-09-22
本仓库记录一次从 Chatterfly 的实验语音模式出发，定位本地 127.0.0.1:3080 任务接口、发现腾讯随客户端分发的 DSH 插件，并最终跑通：
~~~text
语音指令
↓
Chatterfly voiceinput.exe
↓
127.0.0.1:3080/chatterfly/v1/*
↓
Tencent dsh-ime / dsh-chatterfly-web
↓
DeepSeek Harness
↓
DeepSeek 官方模型
↓
Agent 工具 / 文件 / Shell
~~~
实际验证中，一句语音“帮我用 Python 写一个从 1 数到 10 的小代码”成功进入 Harness，会话使用 deepseek-official / deepseek-flash，并在工作区生成了 count_1_to_10.py。
为什么值得记录
Chatterfly 官方已经公开宣传“听懂需求、帮你执行任务”和“AI 指令，快速执行任务”，但在本次研究开始时，公开信息主要停留在产品功能层。
本次研究进一步确认 Windows 客户端内存在一套完整的 DeepSeek Harness 集成：
- Chatterfly 会向本机 127.0.0.1:3080 提交任务；
- 客户端安装目录随附 dsh-ime.tgz 与 dsh-chatterfly-web.tgz；
- 随附安装脚本会把这两个插件安装进 DSH profile；
- 插件暴露 /chatterfly/v1/health、/tasks、/events 等接口；
- 任务能创建/恢复 DSH Session，并实际调用模型与 Agent 工具；
- 健康接口公开能力位包括 approval、questions、deliverables、resume。
这意味着它不是“语音转文字 + 调一次模型”，而是一个面向桌面 Agent 的输入入口。
已验证环境
| 项目 | 本次验证值 |
|---|---|
| Chatterfly 主程序 | 1.0.0.5406 |
| voice input 组件 | 1.0.0.3621 |
| 腾讯 dsh-ime manifest | 1.0.8 |
| DeepSeek Harness | 0.1.5-rc.2 |
| Node.js | 24.19.0 |
| Windows | Windows 11 |
| DSH 监听 | 127.0.0.1:3080 |
| 模型 | deepseek-official / deepseek-flash |
| reasoning effort | low |
这些版本只是本次验证快照。Chatterfly 与 DSH 都可能快速迭代。
观察到的本地协议
任务提交：
~~~http
POST /chatterfly/v1/tasks
Host: 127.0.0.1:3080
Content-Type: application/json
~~~
请求体至少包含：
~~~json
{
"new_session": false,
"text": "",
"token": "",
"user_id": "1"
}
~~~
响应会携带 task_id。
已确认/识别的接口：
~~~text
/chatterfly/v1/health
/chatterfly/v1/tasks
/chatterfly/v1/events
/chatterfly/v1/answers
/chatterfly/v1/cancel
~~~
Harness 会话 URL 还会出现：
~~~text
http://127.0.0.1:3080/?chatterflySession=
~~~
重要： 本仓库不研究、不绕过、不伪造 Chatterfly 的本地 token。token 被视为不透明值；研究工具默认对它脱敏。
官方插件在本机的位置
在本次版本中，Chatterfly 安装目录包含：
~~~text
C:\Program Files (x86)\Chatterfly\\dsh-ime\
├─ manifest.json
├─ plugins\
│ ├─ dsh-ime.tgz
│ └─ dsh-chatterfly-web.tgz
└─ scripts\
├─ check-env.mjs
├─ install-dsh-ime.mjs
└─ spawn-cli.mjs
~~~
本仓库不会重新分发这些腾讯文件。辅助脚本只会在用户自己的已安装 Chatterfly 中寻找它们。
复现思路
1. 准备 DSH
官方 DeepSeek Harness：
https://github.com/deepseek-ai/deepseek-harness
DSH 默认 Web 端口就是 3080。本次验证使用 0.1.5-rc.2。
需要 Node.js、DSH 与 pnpm 可用。
2. 检查 Chatterfly 是否包含官方 payload
~~~powershell
pwsh ./scripts/Find-ChatterflyDshPayload.ps1
~~~
如果能找到 manifest、两个 tgz 与安装脚本，说明当前安装包包含这套集成。
3. 安装官方 Chatterfly 插件到 DSH
推荐先检查环境：
~~~powershell
pwsh ./scripts/Install-OfficialIntegration.ps1 -CheckOnly
~~~
然后执行安装（示例）：
~~~powershell
pwsh ./scripts/Install-OfficialIntegration.ps1 -Root D:\chatgpt\DeepSeekHarness -DshBin dsh
~~~
脚本不会从网络下载腾讯插件，只调用本机 Chatterfly 自带的 install-dsh-ime.mjs。
4. 配置 DeepSeek API Key
更推荐通过 DSH Web 的 Models/Settings 页面配置。
也可以使用本仓库的本地输入脚本：
~~~powershell
pwsh ./scripts/Set-DeepSeekApiKey.ps1 -DshHome D:\chatgpt\DeepSeekHarness\home
~~~
脚本不会把 Key 输出到终端。
5. 启动 DSH 并检查健康状态
~~~powershell
pwsh ./scripts/Test-Integration.ps1
~~~
健康接口成功时会返回类似：
~~~json
{
"ok": true,
"plugin": "chatterfly",
"protocol": 1
}
~~~
6. 触发 Chatterfly 的 DSH/实验语音模式
本仓库不提供修改腾讯程序文件的补丁，也不包含腾讯二进制。
如果你的 Chatterfly 构建已经暴露相应实验入口，语音任务应进入 DSH Web 会话，并由 Agent 执行。
真实验证结果
一次成功任务：
~~~text
语音：
“帮我用 Python 写一个从 1 数到 10 的小代码”
~~~
Harness 记录：
~~~text
provider: deepseek-official
model: deepseek-flash
reasoningEffort: low
~~~
生成文件：
~~~python
for i in range(1, 11):
print(i)
~~~
这证明链路已经越过“任务卡片/假请求”阶段，进入真实模型调用和工具执行。
公开资料与先例检索
截至 2026-09-22，我对公开网页和 GitHub 做了针对性检索，包括：
- dsh-ime
- dsh-chatterfly-web
- /chatterfly/v1/tasks
- /chatterfly/v1/events
- chatterflySession
截至 2026-09-22，未在公开渠道发现对上述技术链路的完整公开复现或证明。
公开产品层资料：
- Chatterfly 官方网站：https://chatterfly.tencent.com/
- IT之家 2026-09-18 对 Chatterfly “AI 指令、快速执行任务”的报道：https://www.ithome.com/1/004/273.htm
- DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness
仓库内容
~~~text
docs/
architecture.md
discovery-timeline.md
protocol-notes.md
scripts/
Find-ChatterflyDshPayload.ps1
Install-OfficialIntegration.ps1
Set-DeepSeekApiKey.ps1
Test-Integration.ps1
examples/
settings.low-cost.yaml
tools/
task_probe.py
~~~
安全与隐私
请不要提交以下内容：
- DeepSeek API Key；
- Chatterfly token；
- .credentials.yaml；
- DSH session 原始日志；
- 含个人信息的语音转写；
- 腾讯 DLL / EXE / TGZ；
- 从腾讯二进制中大段复制出的实现代码。
.gitignore 已覆盖常见敏感文件，但提交前仍应人工检查。
版权与商标
本仓库只发布原创研究记录与辅助脚本，不重新分发腾讯或 DeepSeek 的专有/第三方文件。
“腾讯”“Chatterfly”“DeepSeek”“DeepSeek Harness”等名称与商标归各自权利人所有。本项目与腾讯、DeepSeek 官方均无隶属或授权关系。
License
本仓库原创代码与文档使用 MIT License。第三方文件不属于本许可范围。