224 lines
13 KiB
Plaintext
224 lines
13 KiB
Plaintext
DS Bot
|
|
Copyright 2026 Fei2411 and the DS Bot contributors
|
|
|
|
This product is licensed under the Apache License, Version 2.0 (see LICENSE).
|
|
|
|
==============================================================================
|
|
Third-party code in this repository
|
|
==============================================================================
|
|
|
|
DeepSeek Harness (https://github.com/deepseek-ai/deepseek-harness)
|
|
MIT License, Copyright (c) 2026 DeepSeek
|
|
|
|
- ds-bot/dev/desktop-linux/launch.mts follows the steps of
|
|
apps/desktop/scripts/dev.ts in DeepSeek Harness and reuses a few of its
|
|
lines (the release record and the Electron launch arguments). It is a
|
|
developer script for screenshots on Linux and is not in the npm package.
|
|
- app/src/host.mjs and app/src/profile.mjs follow
|
|
apps/desktop-host/src/index.ts: the profile boot and the ready, fatal and
|
|
shutdown messages. app/src/office-patch.mjs follows
|
|
apps/desktop-host/src/office.ts: the workspace-dependencies and skill-office
|
|
plugin rows with the payload's Node and the unpacked LibreOffice Kit CLI.
|
|
- ds-bot/src/office/skills/office/SKILL.md adapts the office routing skill
|
|
(assets/office/SKILL.md in @deepseek-ai/dsh-skill-office): the routing body
|
|
is kept, with one added row that routes package checks and in-place edits
|
|
to office-tools.
|
|
- app/scripts/prepare-runtime.mjs and app/scripts/primary-runtime.lock.json are a
|
|
JavaScript port of scripts/primary-runtime/ (prepare.ts, prune-python-tests.ts
|
|
and lock.json): the pinned Python, Node and wheel downloads with checksum
|
|
verification, the wheel test pruning and the Office skill asset copy.
|
|
- app/src/host-process.mjs follows apps/desktop/src/host-process.ts: the
|
|
Host in Electron's Node mode and the shutdown escalation.
|
|
- app/src/main.mjs and app/src/window-frame.mjs follow apps/desktop/src/main.ts
|
|
for the window options (the Windows caption-button overlay, its colors and
|
|
the native theme; the macOS traffic lights and sidebar vibrancy, and the
|
|
opaque fill while the window is minimized or hidden). app/src/preload.cjs adapts
|
|
apps/desktop/src/preload-windows.ts, apps/desktop/src/preload-platform.ts
|
|
and apps/desktop/src/preload-theme.ts: the caption-band marks, the
|
|
fullscreen mark, the caption-color measure and the theme sync.
|
|
- app/src/shell.mjs, app/src/tray.mjs and app/src/background-notice.mjs follow
|
|
apps/desktop/src/tray.ts and apps/desktop/src/background-notice.ts: the
|
|
system tray with its menu, the window that hides instead of closing, and
|
|
the one-time confirmation before it hides.
|
|
- app/src/bot-browser.mjs adapts apps/desktop/src/browser-guests.ts, and
|
|
the browser part of app/src/preload.cjs follows
|
|
apps/desktop/src/preload-browser.ts: the webview leases, the attachment
|
|
checks and fixed guest preferences, the session policy and the new-window
|
|
requests.
|
|
- app/engine/cordis.patch.yml follows the bundle patch of
|
|
@deepseek-ai/dsh-web-app (packages/bundle/web-app/cordis.patch.yml): the
|
|
transport and host-service rows and the agent-plane rows it turns off.
|
|
app/engine/preset-standard.patch.yml copies its standard preset
|
|
(presets/standard.patch.yml), including the plan-mode prompt text,
|
|
without the goal rows.
|
|
- .agents/skills/record-browser-gif/ comes from the skill of the same name
|
|
in DeepSeek Harness (.agents/skills/record-browser-gif/): SKILL.md is
|
|
adapted and translated for this repository; scripts/encode_gif.py and
|
|
scripts/test_encode_gif.py are copied unchanged.
|
|
|
|
Full license text:
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
|
|
Simple Icons (https://simpleicons.org)
|
|
CC0 1.0 Universal, the Simple Icons contributors
|
|
|
|
- ds-bot/src/client/connector-marks.js keeps the single-color brand path of
|
|
each connector service from Simple Icons 16.36.0 (the SI table), the
|
|
Gmail, iCloud and QQ paths for the mailbox rows, and the Telegram, WeChat
|
|
and Discord paths for the IM page.
|
|
|
|
Context7 (https://github.com/upstash/context7)
|
|
MIT License, Copyright (c) Upstash
|
|
|
|
- ds-bot/src/client/connector-marks.js keeps the Context7 connector mark
|
|
from public/context7-icon.svg, without the brand square.
|
|
|
|
MIT license text: see the DeepSeek Harness section above.
|
|
|
|
Microsoft Playwright (https://github.com/microsoft/playwright) and
|
|
Playwright MCP (https://github.com/microsoft/playwright-mcp)
|
|
Apache License, Version 2.0, Copyright (c) Microsoft Corporation
|
|
|
|
- ds-bot/src/host/browser/ follows the browser tools of Playwright MCP:
|
|
the ARIA page snapshot with [ref=eN] element refs, a fresh snapshot
|
|
returned by every action, and the per-action tool set (open, snapshot,
|
|
click, upload, type, select, press, tabs, back, screenshot). The
|
|
session drives the browser through the Playwright API itself
|
|
(ariaSnapshot({ mode: 'ai' }) and the aria-ref locators those refs
|
|
resolve to). The playwright package is not bundled: the plugin loads
|
|
it at run time from the install it is pointed at (playwrightUrl),
|
|
the same way it uses the host's @deepseek-ai/* packages.
|
|
|
|
The license is the same Apache License, Version 2.0 that covers this
|
|
repository; see LICENSE for the text.
|
|
|
|
dsh-im (https://github.com/xmanrui/dsh-im)
|
|
MIT License, Copyright (c) 2026 xmanrui
|
|
|
|
- ds-bot/src/host/im/platforms/telegram.js follows the Telegram Bot API
|
|
mapping of dsh-im's telegram channel (long polling, getFile downloads,
|
|
callback queries, and its send/edit calls), and
|
|
ds-bot/src/host/im/format.js follows the Markdown chunking of
|
|
src/channels/shared/markdown-chunks.mjs and telegram-rich-message.mjs
|
|
there: code fences stay whole where they fit and are re-fenced when
|
|
they must be split.
|
|
- ds-bot/src/host/im/platforms/discord.js follows the gateway and REST
|
|
mapping of dsh-im's discord channel (src/channels/discord/discord-runtime.mjs
|
|
and discord-api.mjs): resume with session_id and resume_gateway_url,
|
|
component presses answered by a deferred update, message chunking.
|
|
- ds-bot/src/host/im/platforms/slack.js follows the Socket Mode handling of
|
|
src/channels/slack/slack-runtime.mjs and slack-api.mjs: every envelope
|
|
ACKed, disconnect frames reconnect, message and app_mention events, and
|
|
file downloads from url_private.
|
|
- ds-bot/src/host/im/platforms/weixin.js follows the iLink mapping of
|
|
src/channels/weixin/weixin-api.mjs and weixin-controller.mjs: the QR
|
|
login poll, getupdates with the get_updates_buf cursor, context_token
|
|
per user, typing tickets, and the AES image download.
|
|
- ds-bot/src/host/im/platforms/wecom.js follows the aibot frame mapping of
|
|
src/channels/wecom/wecom-runtime.mjs and wecom-cards.mjs: subscribe,
|
|
ping, req_id replies, proactive sends and template-card events.
|
|
- ds-bot/src/host/im/platforms/qq.js follows the gateway opcodes and
|
|
message fields of @tencent-connect/qqbot-nodejs
|
|
(https://github.com/tencent-connect/qqbot-nodejs, MIT): app access
|
|
token, hello/heartbeat/identify/resume/reconnect/invalid session,
|
|
C2C and group @ events, passive replies with msg_id and msg_seq.
|
|
- ds-bot/src/host/im/platforms/dingtalk.js follows the stream frames of
|
|
dingtalk-stream (https://github.com/alibaba-dingtalk/dingtalk-stream-nodejs,
|
|
MIT): connections/open, ACKs by messageId, system pings, sessionWebhook
|
|
and the robot OpenAPI fallback.
|
|
- ds-bot/src/host/im/platforms/feishu.js follows the long-connection
|
|
pbbp2 frame protocol of @larksuiteoapi/node-sdk
|
|
(https://github.com/larksuite/node-sdk, MIT): the protobuf frame shape,
|
|
ping/pong, data-frame ACKs with biz_rt, and split-payload reassembly.
|
|
- ds-bot/src/client/im-page.js renders the pairing code with
|
|
qrcode-generator (https://github.com/kazuhikoarase/qrcode-generator,
|
|
MIT, Copyright (c) Kazuhiko Arase).
|
|
|
|
The MIT License text:
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
|
|
No other third-party code is copied into this repository. At run time the
|
|
plugin uses the @deepseek-ai/* packages of the DeepSeek Harness install it
|
|
runs in; they are not bundled. The bundled ds-bot/office.js includes
|
|
@xmldom/xmldom (https://github.com/xmldom/xmldom, MIT License, Copyright (c)
|
|
jindw and contributors) from npm. esbuild is a build tool only. The desktop app
|
|
in app/ installs the pinned @deepseek-ai/* packages, Electron and pnpm from
|
|
npm; they keep their own licenses. The build of its window (app/ui) bundles,
|
|
from npm, React and React DOM (MIT, Copyright (c) Meta Platforms, Inc. and
|
|
affiliates), and react-markdown and remark-gfm with the packages they use
|
|
(MIT, most of them Copyright (c) Titus Wormer; @ungap/structured-clone is ISC,
|
|
Copyright (c) Andrea Giammarchi). Vite is a build tool only.
|
|
|
|
==============================================================================
|
|
Projects that gave us ideas (no code copied)
|
|
==============================================================================
|
|
|
|
We thank these projects for the designs they published. DS Bot learned from
|
|
their ideas; it does not contain their code.
|
|
|
|
- AgentMemoryRepo (https://github.com/AgentMemoryRepo/agentmemoryrepo), MIT:
|
|
the Markdown format of Bot memory (one entry per line with [key: value]
|
|
metadata, a MEMORY.md index that links topic files).
|
|
- OpenAI Codex (https://github.com/openai/codex), Apache-2.0:
|
|
keeping the user's messages next to the summary in a checkpoint, and
|
|
message anchors for searching earlier chat.
|
|
- OpenMausBot (https://github.com/milind-soni/OpenMausBot), Apache-2.0:
|
|
group chat rounds and @mention relays between Bots.
|
|
- Hermes Agent (https://github.com/NousResearch/hermes-agent) and
|
|
Hermes Bot Mode (https://github.com/NousResearch/Hermes-Bot-Mode), MIT:
|
|
one Session per member per group chat, and the list of earlier user
|
|
messages that the plugin, not the model, writes into the handoff.
|
|
- OpenCode (https://github.com/sst/opencode), MIT;
|
|
goose (https://github.com/block/goose), Apache-2.0;
|
|
pi (https://github.com/badlogic/pi-mono), MIT;
|
|
Gemini CLI (https://github.com/google-gemini/gemini-cli), Apache-2.0:
|
|
when to condense a long conversation, and what a handoff note holds.
|
|
- obelisk (https://github.com/tommy0103/obelisk), AGPL-3.0:
|
|
searching a Bot's own chat with a SQLite FTS5 index ranked by BM25.
|
|
- DeepSeek Harness Voice Input plugin
|
|
(packages/experimental/client-ui-voice-input), MIT: the voice chat
|
|
records with the same steps (record, resample to 16 kHz mono, PCM16 WAV)
|
|
before it calls the plugin's speech service.
|
|
|
|
Agent logos (ds-bot/src/client/agent-logos.js)
|
|
The logos name the agent CLI a Bot runs on. Each is a trademark of its owner:
|
|
Claude (Anthropic), Cursor (Anysphere), Gemini (Google), OpenCode (SST),
|
|
Cline (Cline Bot Inc.), Qwen (Alibaba Cloud), Devin (Cognition AI),
|
|
OpenAI (OpenAI). DS Bot is not affiliated with or endorsed by these owners.
|
|
Vector marks from Simple Icons (https://simpleicons.org), CC0-1.0.
|
|
Devin and OpenAI marks from the vendors' application icons.
|