@kadaliao/dsh-bots 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,143 @@
1
- # Temporary Holding Version
1
+ # Bots
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ English | [简体中文](README.zh-CN.md)
4
+
5
+ Grok-style bots inside DeepSeek Harness: a team of bots that work together. Each bot has its own **avatar,
6
+ persona, skills, abilities, apps and scheduled tasks**, and its own conversation. Bots **message each
7
+ other**, and one of them, the **dispatcher**, splits the work, hands it out, follows up and reports back.
8
+
9
+ It is built for two situations:
10
+
11
+ - **A one-person company (OPC)**: you run a business alone and need a whole staff — engineering, growth,
12
+ customers, finance — plus a chief of staff who briefs you every morning.
13
+ - **Work that is naturally split between roles**: code needs a builder, a tester and a reviewer; content
14
+ needs a researcher, a writer and a designer; research needs a skeptic.
15
+
16
+ ![Team templates](docs/en-teams.png)
17
+
18
+ ## Hire a whole team in one click
19
+
20
+ Open the Bots panel (sidebar, or `/bots`), pick a team template and click **Hire this team**:
21
+
22
+ | Team | Members | Scheduled tasks it comes with |
23
+ | --- | --- | --- |
24
+ | **One-person company** | Atlas (chief of staff, dispatcher), Forge (engineer), Echo (growth), Harbor (customers), Ledger (finance) | Weekday 09:00 morning brief, Friday 17:30 weekly review, Monday market pulse, weekday inbox sweep, Monday numbers |
25
+ | **Software squad** | Lead, Builder, Tester, Review | — |
26
+ | **Content studio** | Editor, Scout (research), Quill (writer), Pixel (design) | Monday topic planning |
27
+ | **Research desk** | Desk (lead), Analyst, Market, Skeptic | — |
28
+
29
+ Hiring:
30
+
31
+ - creates the bots with bilingual personas, in your UI language;
32
+ - gives each member **the skills already installed in your Harness** that fit its role (deep-research,
33
+ last30days, xlsx, high-signal-review, …), skipping and reporting any you don't have;
34
+ - imports role skills from [anthropics/skills](https://github.com/anthropics/skills) (webapp-testing,
35
+ frontend-design, brand-guidelines, …) with their scripts;
36
+ - adds the apps the role needs (GitHub, Stripe, HubSpot, …), whose keys you fill in later;
37
+ - schedules the team's recurring tasks and makes its lead the dispatcher;
38
+ - offers to send the lead a kickoff message, so the team starts working right away.
39
+
40
+ ![Chat](docs/en-chat.png)
41
+
42
+ ## An example (one-person company)
43
+
44
+ > **You → Atlas**: We release the new version next week. Organise it.
45
+ >
46
+ > **Atlas → Forge**: Fix the three P1 bugs before release, review your own diff, merge by Wednesday.
47
+ >
48
+ > **Atlas → Echo**: Draft the launch post and three social posts in the founder's voice, by Thursday.
49
+ >
50
+ > **Atlas → Ledger**: For a week after release, check new subscriptions and refunds daily; flag anything odd.
51
+ >
52
+ > **Forge → Atlas**: The three bugs are fixed, tests pass, PR merged.
53
+ >
54
+ > **Atlas → You**: This week: bugs cleared; launch draft for your review tomorrow. Decision needed: do we raise the price?
55
+
56
+ Bots answer in the language you write in, so the same team works in Chinese and English
57
+ ([中文示例](README.zh-CN.md#一段示例一人公司)).
58
+
59
+ ## Built on what Harness already does
60
+
61
+ A bot is an ordinary Harness conversation, so everything Harness can do, a bot can do:
62
+
63
+ - **Abilities**: web search, files, running commands and code, Office documents, image generation,
64
+ sub-agents and workflows, handing over files… switched per bot on its Profile tab (a reviewer bot
65
+ that cannot run commands, for instance).
66
+ - **Skills**:
67
+ - **Add from Harness**: pick from the skills you already installed (`~/.agents/skills`,
68
+ `~/.dsh/skills`, …); referenced, not copied, so they stay up to date;
69
+ - **Import from GitHub**: browse Anthropic's skills in one click, or paste any `owner/repo/path`; the
70
+ whole skill folder comes along, scripts included;
71
+ - **Let the bot write it**: describe what you need in a sentence; the bot writes it with skill-creator
72
+ and saves it to itself;
73
+ - writing one by hand is still possible, as the last resort.
74
+ - **Apps** add only the outside systems Harness doesn't reach on its own:
75
+ - **Import from your other agents**: MCP servers you already configured in Codex, Claude Code,
76
+ Claude Desktop, Cursor, Windsurf, Gemini CLI or opencode are found automatically; tick them,
77
+ keys included;
78
+ - **the gallery**:
79
+
80
+ | Category | Apps (🔑 = needs a key) |
81
+ | --- | --- |
82
+ | Sales & payments | Stripe 🔑, HubSpot CRM 🔑 |
83
+ | Team & office | Feishu / Lark 🔑, Notion 🔑, Slack 🔑, Memory |
84
+ | Build & ship | GitHub 🔑, Git, Supabase 🔑, Sentry 🔑, Context7 Docs |
85
+ | Research & content | Exa, Tavily 🔑, Brave 🔑, Firecrawl 🔑 |
86
+ | Computer & browser | Open Computer Use (operate macOS apps), Playwright |
87
+ | Data | PostgreSQL 🔑, SQLite |
88
+ | Maps & local | Amap 🔑, Baidu Maps 🔑 |
89
+ | Custom | Any local (stdio) or remote (Streamable HTTP) MCP server |
90
+
91
+ - **Schedules** are ordinary Harness scheduled tasks, also on the Automation page.
92
+ - **AI avatars**: with the [Images plugin](../images), draw a bot's avatar from its persona.
93
+
94
+ ## How it works
95
+
96
+ - Each bot owns one ordinary Harness conversation, in the **Bots** workspace (`~/.dsh/bots/workspace`
97
+ unless `workdir` is set).
98
+ - When it runs, the bot's persona and the team roster join its system prompt; its own skills, ability
99
+ limits and apps apply to that conversation only. Edits apply at once; a new or changed app connects
100
+ the next time the conversation starts.
101
+ - `bot_send_message` puts the text into the other bot's inbox and wakes it. Two bots may exchange at
102
+ most 16 messages in 10 minutes, so conversations end.
103
+ - Every conversation gets `bot_list`, `bot_create`, `bot_update`, `bot_delete`, `bot_send_message`
104
+ and `bot_schedule` to manage bots.
105
+
106
+ ## Open Computer Use
107
+
108
+ [open-computer-use](https://github.com/kadaliao/open-computer-use) lets a bot operate macOS apps through
109
+ the accessibility tree. Click **Install now** on its card, then grant **DeepSeek Harness** Accessibility
110
+ permission and restart it.
111
+
112
+ ## What it stores and sends
113
+
114
+ - `~/.dsh/cache/bots/`: `bots.json` (bots, including keys entered for apps), `messages.jsonl`
115
+ (timeline), `avatars/`, `skills/` (skills imported from GitHub).
116
+ - Nothing leaves your machine except through the bots' own conversations (your configured model), the
117
+ apps you connect, the image model when you generate an avatar, and GitHub when you import skills.
118
+
119
+ ## Install
120
+
121
+ Add this repository's index in DeepSeek Harness (**Plugins → Discover → Sources**):
122
+
123
+ ```
124
+ https://raw.githubusercontent.com/kadaliao/dsh-plugins/main/marketplace.json
125
+ ```
126
+
127
+ then install **Bots**. The Discover tab is part of the experimental **Custom plugin markets**
128
+ feature; turn it on under **Plugins → Experimental plugins** if you don't see it.
129
+
130
+ Without Discover, paste the Git spec into the plugin manager:
131
+
132
+ ```
133
+ git+https://github.com/kadaliao/dsh-plugins.git#main&path:/plugins/bots
134
+ ```
135
+
136
+ Refresh the page once after installing. For AI avatars, install [Images](../images) too.
137
+
138
+ ## Limits
139
+
140
+ - Web UI only.
141
+ - Group chats between bots are not there yet; bots collaborate through direct messages.
142
+ - Harness skills a team template names that you don't have are skipped; import them from GitHub or have
143
+ the bot write them later.
@@ -0,0 +1,123 @@
1
+ # Bots
2
+
3
+ [English](README.md) | 简体中文
4
+
5
+ 把 Grok bot 搬进 DeepSeek Harness:一支能互相协作的 bot 团队。每个 bot 有自己的**头像、人设、技能、能力、应用和定时任务**,
6
+ 也有自己的会话;bot 之间**私信协作**,其中一个是**调度员**,负责拆解任务、分派、跟进、汇报。
7
+
8
+ 它适合两种场景:
9
+
10
+ - **一人公司(OPC)**:一个人经营业务,需要一整个「员工团队」——研发、增长、客户、财务,再加一个每天早上给你简报的幕僚长。
11
+ - **需要分工协作的工作**:开发要有人写、有人测、有人审;内容要有人调研、有人写、有人做图;研究要有人挑刺。
12
+
13
+ ![团队模板](docs/teams.png)
14
+
15
+ ## 一键雇用一支团队
16
+
17
+ 打开 Bots 面板(左侧栏或 `/bots`),挑一个团队模板,点「雇用这个团队」:
18
+
19
+ | 团队 | 成员 | 自带的定时任务 |
20
+ | --- | --- | --- |
21
+ | **一人公司** | Atlas 幕僚长(调度员)、Forge 工程师、Echo 增长、Harbor 客户、Ledger 财务 | 工作日 09:00 早间简报、周五 17:30 周复盘、周一市场脉搏、工作日收件箱巡检、周一财务数据 |
22
+ | **研发小队** | Lead 技术负责人、Builder 开发、Tester 测试、Review 审查 | — |
23
+ | **内容工作室** | Editor 主编、Scout 研究员、Quill 写手、Pixel 设计 | 周一选题会 |
24
+ | **研究台** | Desk 研究负责人、Analyst 分析师、Market 市场、Skeptic 怀疑者 | — |
25
+
26
+ 雇用时会:
27
+
28
+ - 按界面语言创建双语人设的 bot(中文界面就是中文团队);
29
+ - 给每个成员挂上**你这台 Harness 里已有的技能**(如 deep-research、last30days、xlsx、high-signal-review),没装的跳过并告诉你;
30
+ - 从 [anthropics/skills](https://github.com/anthropics/skills) 导入岗位需要的技能(如 webapp-testing、frontend-design、brand-guidelines),连同脚本一起下载;
31
+ - 加上岗位需要的应用(GitHub、Stripe、HubSpot 等),Key 之后在「应用」页补;
32
+ - 建好定时任务,让负责人成为调度员;
33
+ - 最后可以一键把「开场任务」发给负责人,团队就开始干活了。
34
+
35
+ ![聊天](docs/chat.png)
36
+
37
+ ## 一段示例(一人公司)
38
+
39
+ > **你 → Atlas 幕僚长**:下周要发布新版本,帮我安排一下。
40
+ >
41
+ > **Atlas → Forge 工程师**:发布前请把 3 个 P1 bug 修完并自审,周三前合并。
42
+ >
43
+ > **Atlas → Echo 增长**:起草发布公告和三条社媒短帖,用创始人的口吻,周四给我。
44
+ >
45
+ > **Atlas → Ledger 财务**:发布后一周每天看一下新订阅和退款,有异常立刻告诉我。
46
+ >
47
+ > **Forge → Atlas**:3 个 bug 已修,测试通过,PR 已合并。
48
+ >
49
+ > **Atlas → 你**:本周进展:bug 已清零;公告草稿明天给你审;需要你决定:新版本定价是否上调。
50
+
51
+ bot 默认用你说话的语言回答;中文提问就是中文协作。
52
+
53
+ ## 充分利用 Harness 已有的能力
54
+
55
+ Bot 就是一个普通的 Harness 会话,所以 Harness 能做的它都能做,不需要重复造轮子:
56
+
57
+ - **能力**:联网搜索、读写文件、运行命令与代码、Office 文档、AI 作图、子代理与工作流、交付文件……在「资料」页按能力开关,
58
+ 比如让审查 bot 不能运行命令;
59
+ - **技能**:
60
+ - **从 Harness 添加**:直接选你已经装好的技能(`~/.agents/skills`、`~/.dsh/skills` 等),引用而不复制,跟着更新;
61
+ - **从 GitHub 导入**:一键浏览 Anthropic 官方技能,或粘贴任意 `owner/repo/path`,整个技能文件夹连脚本一起导入;
62
+ - **让 Bot 自己写**:一句话描述需求,bot 用 skill-creator 写好并保存到自己身上;
63
+ - 手写仍然可以,但它是最后的选项;
64
+ - **应用**:只补 Harness 本身没有的外部系统;
65
+ - **从其他 Agent 导入**:自动发现你在 Codex、Claude Code、Claude Desktop、Cursor、Windsurf、Gemini CLI、opencode 里配好的 MCP 服务,勾选即用,Key 一并带上;
66
+ - **应用库**:
67
+
68
+ | 分类 | 应用(🔑 = 需要 Key) |
69
+ | --- | --- |
70
+ | 销售与收款 | Stripe 收款 🔑、HubSpot 客户管理 🔑 |
71
+ | 团队与办公 | 飞书 🔑、Notion 🔑、Slack 🔑、长期记忆 |
72
+ | 研发与交付 | GitHub 🔑、Git 仓库、Supabase 🔑、Sentry 🔑、Context7 文档 |
73
+ | 调研与内容 | Exa、Tavily 🔑、Brave 🔑、Firecrawl 🔑 |
74
+ | 电脑与浏览器 | Open Computer Use(操控 macOS 应用)、Playwright 浏览器 |
75
+ | 数据 | PostgreSQL 🔑、SQLite |
76
+ | 地图与本地 | 高德地图 🔑、百度地图 🔑 |
77
+ | 自定义 | 任意本地(stdio)或远程(Streamable HTTP)MCP 服务 |
78
+
79
+ - **定时任务**:就是 Harness 的定时任务,也出现在「自动化」页面;
80
+ - **AI 头像**:装了 [图片插件](../images) 就能按 bot 的人设生成头像。
81
+
82
+ ## 原理
83
+
84
+ - 每个 bot 对应一个普通 Harness 会话,位于 **Bots** 工作区(默认 `~/.dsh/bots/workspace`,可用 `workdir` 改)。
85
+ - 该会话运行时,bot 的人设和团队名单加入系统提示词;它自己的技能、能力限制和应用只作用于这个会话。
86
+ 修改即时生效;新增或修改应用在下次会话启动时连接。
87
+ - `bot_send_message` 把消息放进对方的收件箱并唤醒它;同一对 bot 10 分钟内最多互发 16 条,防止无限对话。
88
+ - 所有会话都能用 `bot_list`、`bot_create`、`bot_update`、`bot_delete`、`bot_send_message`、`bot_schedule` 管理 bot。
89
+
90
+ ## Open Computer Use
91
+
92
+ [open-computer-use](https://github.com/kadaliao/open-computer-use) 让 bot 通过无障碍树操作 macOS 应用。在应用页点「一键安装」,
93
+ 然后给 **DeepSeek Harness** 授予辅助功能权限并重启。
94
+
95
+ ## 存储与外发
96
+
97
+ - `~/.dsh/cache/bots/`:`bots.json`(bot,含应用里填的 Key)、`messages.jsonl`(时间线)、`avatars/`、`skills/`(从 GitHub 导入的技能)。
98
+ - 除了 bot 自身会话(你配置的模型)、你连接的应用、生成头像时的图片模型、导入技能时访问 GitHub,不向外发送任何内容。
99
+
100
+ ## 安装
101
+
102
+ 在 DeepSeek Harness 里加入本仓库的索引(**Plugins → Discover → Sources**):
103
+
104
+ ```
105
+ https://raw.githubusercontent.com/kadaliao/dsh-plugins/main/marketplace.json
106
+ ```
107
+
108
+ 然后安装 **Bots**。Discover 标签属于实验性的 **Custom plugin markets** 功能;看不到的话先在
109
+ **Plugins → Experimental plugins** 里打开。
110
+
111
+ 不用 Discover 的话,把 Git 地址填进插件管理器:
112
+
113
+ ```
114
+ git+https://github.com/kadaliao/dsh-plugins.git#main&path:/plugins/bots
115
+ ```
116
+
117
+ 安装后刷新一次页面。想要 AI 头像,再装上[图片插件](../images)。
118
+
119
+ ## 限制
120
+
121
+ - 仅 Web 界面。
122
+ - 暂无 bot 群聊,bot 之间通过私信协作。
123
+ - 团队模板引用的 Harness 技能,你没装的会被跳过;可以之后再从 GitHub 导入或让 bot 自己写。