@kadaliao/dsh-bots 0.7.1 → 0.9.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 +255 -45
- package/README.zh-CN.md +182 -31
- package/client.js +2622 -246
- package/index.js +2472 -133
- package/lib/activity.mjs +221 -0
- package/lib/cards.mjs +582 -0
- package/lib/channels/discord.mjs +91 -11
- package/lib/channels/feishu.mjs +37 -9
- package/lib/channels/slack.mjs +26 -8
- package/lib/channels/telegram.mjs +37 -6
- package/lib/channels.mjs +399 -89
- package/lib/memory.mjs +37 -0
- package/lib/prompt.mjs +221 -20
- package/lib/settings.mjs +41 -2
- package/lib/store.mjs +60 -6
- package/lib/threads.mjs +460 -0
- package/lib/tickets.mjs +726 -0
- package/lib/usage.mjs +53 -7
- package/lib/watchdog.mjs +216 -0
- package/package.json +1 -1
package/README.zh-CN.md
CHANGED
|
@@ -3,7 +3,9 @@
|
|
|
3
3
|
[English](README.md) | 简体中文
|
|
4
4
|
|
|
5
5
|
把 Grok bot 搬进 DeepSeek Harness:一支能互相协作的 bot 团队。每个 bot 有自己的**头像、人设、模型、技能、能力、应用、定时任务和记忆**,
|
|
6
|
-
也有自己的会话;bot
|
|
6
|
+
也有自己的会话;bot 之间**私信协作**,其中一个是**调度员**,负责拆解需求、分派、跟进、汇报。
|
|
7
|
+
分派出去的每件工作都是一个**任务**,bot 在专门的会话里做,所以一个 bot 可以同时做好几件事。
|
|
8
|
+
和 bot 聊天就像在飞书群里:想到什么随时发,每条消息的回复都收在它自己的**话题**里。
|
|
7
9
|
|
|
8
10
|
它适合两种场景:
|
|
9
11
|
|
|
@@ -50,9 +52,118 @@
|
|
|
50
52
|
|
|
51
53
|
bot 默认用你说话的语言回答;中文提问就是中文协作。
|
|
52
54
|
|
|
55
|
+
上面 Atlas 发给三位队友的每条消息都开了一个任务,三个任务同时进行;Forge 那句话就是它对自己任务的汇报。
|
|
56
|
+
|
|
57
|
+
## 聊天:一件事一个话题
|
|
58
|
+
|
|
59
|
+
和 bot 聊天就像在飞书群里:想发几条发几条、什么时候发都行,每条消息的回复都收在它自己的话题里。
|
|
60
|
+
|
|
61
|
+
<!-- screenshot: chat with topics -->
|
|
62
|
+
|
|
63
|
+
- **每条消息都是一个话题。** 发出去立刻显示,bot 接手之前标着 **排队中**。对它的回复、它引出的工作的所有动静都收在它下面。
|
|
64
|
+
消息下方的话题条显示回复数、最新一条、在做这件事的任务(带实时状态),有没看的内容就亮一个点;点开,话题在聊天旁边展开。
|
|
65
|
+
看不见的话题有了新回复,输入框上方会出现 **N 个话题有新回复**,点一下就过去。
|
|
66
|
+
- **可以回复任何一条消息。** 鼠标移到消息上点 **回复**,你写的话就进那条消息的话题。话题里的任务还没结束(或者一天内刚完成)时,
|
|
67
|
+
这条话直接交给做任务的 bot;调度员只收到一条提示,不会被唤醒。
|
|
68
|
+
- **调度员一两步之内就回应每一条消息**,因为它不在自己的会话里干活:交给合适的队友,没有合适的就开一个任务交给自己,
|
|
69
|
+
然后马上空出来。连发两件事会同时推进,不会因为来了新消息就丢掉旧的。接着说某件进行中的事的消息,
|
|
70
|
+
会并进那个任务,并归入它的话题(**已归入「…」**)。
|
|
71
|
+
- **干活的 bot 直接回复你**,在请求来的那个话题里,给出完整结果。只有调度员把一件事拆给几个 bot、需要汇总结果时,
|
|
72
|
+
才会让汇报先回到它那里,再由它回复你。
|
|
73
|
+
- 0.9 之前的消息照旧留在主时间线里。
|
|
74
|
+
|
|
75
|
+
## 任务:分派出去的工作各有各的会话
|
|
76
|
+
|
|
77
|
+
一个 bot 把工作交给队友,这件工作就成了一个**任务**。队友在专门的会话里做每个任务,所以同一个 bot 可以同时做好几个任务而不串台,
|
|
78
|
+
它自己的会话也始终空着,你随时能找它。任务不用你亲手建:你把事情交给调度员(或任何一个 bot),由它去建。
|
|
79
|
+
|
|
80
|
+
<!-- screenshot: tasks view -->
|
|
81
|
+
|
|
82
|
+
- **汇报**:做任务的 bot 汇报时注明状态:**完成**(附上结果)、**提问**(需要有人回答)、**受阻**(做不下去了),
|
|
83
|
+
或者**进展**——进展只记在任务上,不打扰任何人。完成、提问和受阻原文发给你,发在请求来的那个话题或聊天里;
|
|
84
|
+
发起的 bot 只收到一条提示,不会被唤醒。发起的 bot 要求汇报先回给它时(为了汇总几份结果),汇报立刻送到它那里,由它转告;
|
|
85
|
+
子任务的汇报、以及不来自任何聊天的任务(比如定时任务开出的)的汇报也是这样。
|
|
86
|
+
任务结束后才发来的汇报,或者所属任务已经结束的子任务发来的汇报,只记在任务上。
|
|
87
|
+
做任务的 bot 写的其他内容都留在任务自己的会话里。
|
|
88
|
+
- **子任务**:做任务的 bot 可以找队友帮忙,这会开一个子任务,子任务的汇报回到发起它的那个任务里。
|
|
89
|
+
- **同时做几个**:同一时间最多做 4 个任务,多出来的排队,前面的做完再开始。已经开始的任务收到人发来的新消息(跟进、回答)时,
|
|
90
|
+
可以多占一个名额,新来的工作挤不掉它;bot 发给它的消息(调度员的也一样)要等有名额空出来,在那之前任务显示为 **排队中**。
|
|
91
|
+
等你回答、卡住了或失败的任务,会话空下来后就让出名额。
|
|
92
|
+
- **阶段**:**进行中**、**排队中**、**等你回答**(它提了问题)、**卡住了**(见下文「看门狗」)、
|
|
93
|
+
**失败**(出了错,或报了受阻还没人回应)、**已完成**、**已停止**。
|
|
94
|
+
- 侧栏的 **任务** 分三栏:**需要你处理**(等你回答、卡住了、失败)、**进行中**(进行中、排队中)、**最近完成**(已完成、已停止)。
|
|
95
|
+
点开一个任务,能看到执行的 bot、发起方、来源、交代的内容、汇报、相关任务和这个任务的用量,
|
|
96
|
+
还有 **打开会话**、**重试**、**标为完成**、**停止** 几个按钮,以及一个给任务发消息的输入框(比如回答它的提问);
|
|
97
|
+
**标为完成** 和 **停止** 都会结束任务,并让 bot 立刻停下手上的活。
|
|
98
|
+
每个 bot 的 **任务** 标签页列出它手上的工作。
|
|
99
|
+
- **bot 之间的消息不抢戏**:在 bot 的聊天里,分派、汇报和 bot 之间的消息连在一起,收成你和它对话下面安静的一组;
|
|
100
|
+
来自某个话题的任务,相关的这些消息显示在那个话题里。
|
|
101
|
+
**设置 → 聊天 → Bot 之间的消息** 决定显示多少,每台设备都一样:**一行**(默认:谁把什么交给谁、进度和时间,点一下打开任务)、
|
|
102
|
+
**简短**(再加消息的前两行)、**完整**(整条消息,委派附任务卡片)。bot 回复你的话和主对话一样排版,不再套框。
|
|
103
|
+
- **实时状态**:bot 干活时,聊天里会写出它此刻在做什么、做了多久("运行 `npm test` · 42 秒"、"思考中 · 8 秒",再加第几步和总用时);
|
|
104
|
+
列表里的这个 bot、**任务** 里和任务详情页里它的任务、以及正在进行的分派那一行也一样。状态会自己往前走:有活在跑时,
|
|
105
|
+
面板每一两秒刷新一次。只显示工具名和它在处理什么的简短摘要(命令的第一行、文件名、搜索词),会截断,
|
|
106
|
+
并去掉密钥和 token;工具返回的内容一概不显示。
|
|
107
|
+
- **删除一个 bot** 时,它在做的任务会停止并归档;它发起的任务也会停止,但仍留在 **任务** 里,标为已停止,之后还能重试。
|
|
108
|
+
- **设置 → 任务**:同时进行的任务数(4)、多少分钟没动静算卡住(20)、任务完成多少小时后归档会话(24)。
|
|
109
|
+
|
|
110
|
+
### 调度员只调度
|
|
111
|
+
|
|
112
|
+
调度员有两种工作方式,在它的 **资料** 页 **调度方式** 里选,对整个团队生效:
|
|
113
|
+
|
|
114
|
+
- **只调度**(默认):听懂需求、把工作分派出去、跟进进度,自己不动手。这时它不执行命令、不写不改文件、不联网搜索、
|
|
115
|
+
不用子代理和工作流、不作图、不做 Office 文档,但仍能读文件、使用技能。需要这些能力的事,没有合适的队友时,
|
|
116
|
+
它就交给自己:在一个单独的任务里用全部工具去做,它自己的会话始终空着等你。**能力** 一栏会标出只调度时关掉的项,
|
|
117
|
+
点 **重新打开** 可以逐项放回(即使放回了命令,它也不能 `sleep`,命令要么在 30 秒内跑完,要么放到后台跑)。
|
|
118
|
+
它从不等队友:分派完就结束这一轮,有事需要它时会自动唤醒,所以新请求不会被手上的活堵住;
|
|
119
|
+
它忙的时候进来的消息,会在下一步一起处理,各自在自己的话题里得到回应。既然只管调度,用轻量、快速的模型就够了,
|
|
120
|
+
**模型** 一栏也会这样提示;Bots 不会替你换模型。只调度时,任何 bot 把工作交给队友都会开任务,不只调度员。
|
|
121
|
+
- **亲自动手**:0.7 的做法。调度员小事自己顺手做掉;bot 在自己的会话里给队友发消息,消息直接进队友自己的会话,不开任务。
|
|
122
|
+
已经开出的任务照常进行、照常汇报。
|
|
123
|
+
|
|
124
|
+
团队里除了调度员至少还有一个 bot,「只调度」才生效;只有调度员一个 bot 时,它自己干活。
|
|
125
|
+
|
|
126
|
+
### 聊天与讨论串
|
|
127
|
+
|
|
128
|
+
任务会记住它来自哪个聊天:私聊、Slack 讨论串、Discord 子区或回复链、飞书话题或回复链、Telegram 话题,或者面板。
|
|
129
|
+
|
|
130
|
+
- **结果回到请求来的地方。** 做任务的 bot 自己把结果发到这个任务来自的聊天;聊天应用属于别的 bot 时,开头署上它的名字(`【Forge】`),
|
|
131
|
+
所以从两个聊天各派一件事,结果各回各的聊天。如果调度员的某一轮同时涉及好几个聊天或话题,它会用 `bot_reply` 分别回复,
|
|
132
|
+
这一轮开的任务也要说明是给哪一个的。这一轮剩下的普通回复只留在面板里,标着 **未发出**;每个聊天和话题都已经回复过的话就不显示。
|
|
133
|
+
- **讨论串里的跟进直接交给任务。** 在 Slack 讨论串、Discord 子区或回复链、飞书话题或回复链、Telegram 话题里,
|
|
134
|
+
你之后在同一个讨论串里说的话,直接交给从这里开出的任务;调度员只收到一条提示,不会被唤醒。
|
|
135
|
+
在会话归档之前,已完成的任务收到这样的消息也会接着做;已停止的任务不会。
|
|
136
|
+
在 Slack、Discord 和飞书的群里,bot 会在你那条消息下面回复,所以群里每个请求都自成一个讨论串。
|
|
137
|
+
- **私聊里的跟进交给调度员。** 私聊(以及没有讨论串的群)是一整段对话,新请求也从这里来,所以新消息交给调度员;
|
|
138
|
+
只有一个任务在这里提了问题、还在等回答时,这条消息才交给那个任务。有两个或更多任务在等回答时,消息仍交给调度员,
|
|
139
|
+
由它判断是在回答哪一个。
|
|
140
|
+
- 以 `@handle` 开头的消息,仍然直接进那个 bot 自己的会话。
|
|
141
|
+
|
|
142
|
+
### 看门狗
|
|
143
|
+
|
|
144
|
+
Bots 每 5 分钟按固定规则检查一遍进行中的任务,不靠模型判断:
|
|
145
|
+
|
|
146
|
+
- 任务的会话空闲、后台没有在跑的东西(命令、子代理、子任务),而且 20 分钟没有动静,就请它汇报一次进度;
|
|
147
|
+
再过 20 分钟还没汇报,就标为 **卡住了**,并通知发起的 bot。
|
|
148
|
+
- 某一步遇到临时错误(HTTP 408、429 或 5xx,连接断开或被拒),15 秒后让任务继续,再失败就等 30 秒、再等 60 秒;
|
|
149
|
+
连续第四次失败,或者遇到其他错误,任务就 **失败**,并通知发起的 bot。
|
|
150
|
+
- 一个 bot 要求回报的任务全都有了结果(已完成、失败、已停止或卡住了),它却一直没开口(标着 **未发出** 的回复不算),
|
|
151
|
+
就提醒它一次,让它告诉请求方。发起方如果是一个已经结束的任务,就不再提醒;直接回复了你的任务也不需要提醒。
|
|
152
|
+
- Harness 重启后,做到一半的任务会收到一条说明:先检查已经做过的事(文件、命令、发出去的消息),不要重复,再接着做。
|
|
153
|
+
会话已经不在的任务,带着同一条说明从原来的交代重新开始;交代没送进会话的任务,会重新收到交代。
|
|
154
|
+
排队的任务和等名额的消息,有空位时再开始、再送达;同一条消息不会投递两次。
|
|
155
|
+
|
|
156
|
+
### bot 向你提问
|
|
157
|
+
|
|
158
|
+
bot 可以停下来问你一道选择题(Harness 的 `ask_user_question`)。问题会以卡片的形式出现在输入框上方,
|
|
159
|
+
bot 的聊天页和任务详情页都有,同时这个 bot 或任务会被标为需要你处理。点一个选项,或者输入自己的回答即可;
|
|
160
|
+
在 Harness 的会话里回答也行,先到的那个回答生效。如果这件事是从聊天应用里发起的,bot 还会在那个聊天里说一声:
|
|
161
|
+
它正在 DeepSeek Harness 里等你回答。回答要在 Harness 里给,不能在聊天里直接答。权限确认和计划审阅仍在会话里处理,
|
|
162
|
+
卡片上有入口。Harness 重启后,还没回答的问题不会保留。
|
|
163
|
+
|
|
53
164
|
## 充分利用 Harness 已有的能力
|
|
54
165
|
|
|
55
|
-
Bot
|
|
166
|
+
Bot 在普通的 Harness 会话里工作,所以 Harness 能做的它都能做,不需要重复造轮子:
|
|
56
167
|
|
|
57
168
|
- **能力**:联网搜索、读写文件、运行命令与代码、Office 文档、AI 作图、子代理与工作流、交付文件……在「资料」页按能力开关,
|
|
58
169
|
比如让审查 bot 不能运行命令;
|
|
@@ -80,13 +191,15 @@ Bot 就是一个普通的 Harness 会话,所以 Harness 能做的它都能做
|
|
|
80
191
|
| 自定义 | 任意本地(stdio)或远程(Streamable HTTP)MCP 服务 |
|
|
81
192
|
|
|
82
193
|
- **定时任务**:就是 Harness 的定时任务,也出现在「自动化」页面;
|
|
83
|
-
- **AI 头像**:装了 [图片插件](../images) 就能按 bot 的人设生成头像。
|
|
194
|
+
- **AI 头像**:装了 [图片插件](../images) 就能按 bot 的人设生成头像。bot 自己也能做:让调度员给团队换一批头像,
|
|
195
|
+
说清楚想要的样子就行,也可以指给它一张本地图片。bot 画头像是在后台进行的,不耽误它回你的话:画的时候头像上有一圈在转,
|
|
196
|
+
画好就换上;画好了(或没画成、为什么)bot 会收到通知并告诉你。Harness 重启会丢掉正在画的头像。
|
|
84
197
|
- **图标**:应用库里每个应用都用它自己的官方 logo(有 App 的用 App Store 图标,没有的用官网或官方仓库里的 logo)。
|
|
85
198
|
这些 logo 是各自所有者的商标,只用来标明是哪个服务。
|
|
86
199
|
|
|
87
200
|
## 每个 bot 用自己的模型
|
|
88
201
|
|
|
89
|
-
在 bot 的 **资料 → 模型**
|
|
202
|
+
在 bot 的 **资料 → 模型** 里选它的会话(包括它做任务的会话)用哪个模型:按提供方分组,模型支持思考强度时还能选强度。
|
|
90
203
|
除了 Harness 里已有的模型,**模型来源** 还能添加:
|
|
91
204
|
|
|
92
205
|
- **自定义端点**:任意 OpenAI 兼容(Chat Completions 或 Responses)、Anthropic 兼容或 Gemini 的 Base URL,
|
|
@@ -101,28 +214,32 @@ Bot 就是一个普通的 Harness 会话,所以 Harness 能做的它都能做
|
|
|
101
214
|
|
|
102
215
|
## 话题:对话不会无限变长
|
|
103
216
|
|
|
104
|
-
bot
|
|
217
|
+
bot 自己的会话就是一个**话题**。新话题是一段全新的会话(旧会话归档,bot 的定时任务一起搬过去),
|
|
105
218
|
bot 知道的事靠记忆延续。下面几种情况会开新话题:
|
|
106
219
|
|
|
107
220
|
- 在面板或聊天应用里发送 `/new`(也可以是 `/clear`、`/新话题`),后面跟的文字会发到新话题里;
|
|
108
221
|
或者点输入框下方的 **新话题**;
|
|
109
|
-
-
|
|
222
|
+
- 处理下一个请求前自动开:闲置超过 **6 小时**,或对话的提示已经达到 **128K tokens**(可在设置里调,
|
|
110
223
|
0 表示关闭)。如果队友的回复可能还在路上,即使对话很长也不会被切断。
|
|
111
224
|
|
|
112
225
|
对话接近模型上限时,Harness 自己仍会压缩;话题在那之前很久就让每次调用保持小而便宜。
|
|
226
|
+
任务的会话不算话题,任务结束它也就结束了。发起任务的 bot 即使已经换了新话题,任务的汇报照样送到它那里。
|
|
113
227
|
|
|
114
228
|
## 记忆
|
|
115
229
|
|
|
116
230
|
每个 bot 都有跨话题保留的**笔记**,团队还有一份所有 bot 都会读的共享笔记:
|
|
117
231
|
|
|
118
|
-
-
|
|
232
|
+
- **每做完一件事**,一次简短的模型调用会在 bot 的**工作日志**里写一行(要做什么、结果如何),
|
|
119
233
|
并增补、更正或删除笔记:偏好、人物、决定、做法、教训。所有 bot 都该知道的事写进团队笔记。
|
|
234
|
+
在 bot 自己的会话里,每个**回合**(bot 从收到一个请求到重新空闲为止做的所有事)结束后写一次;
|
|
235
|
+
任务则在结束时写一次。
|
|
120
236
|
- **bot 自己**也会记:你让它记住什么时它用 `memory_save` 保存,用 `memory_forget` 删除,
|
|
121
|
-
用 `memory_search`
|
|
237
|
+
用 `memory_search` 查笔记、团队工作日志、每日摘要和任务(标题和汇报)。在任务的会话里,除了笔记,
|
|
238
|
+
只查得到这个任务、它的所属任务和子任务的工作日志与任务,查不到每日摘要。
|
|
122
239
|
- **每天夜里**(默认 03:00)**整理**一次:结合最近的工作日志,合并、更正、精简每个 bot 的笔记和共享笔记,
|
|
123
240
|
并把当天的工作写成团队的**每日摘要**。**立即整理** 可以马上运行。
|
|
124
|
-
-
|
|
125
|
-
|
|
241
|
+
- 话题或任务的会话开始时,bot 会读到自己的笔记、团队笔记、最近几条工作日志和最新的每日摘要;
|
|
242
|
+
你在面板里改了记忆、或每晚整理之后,下一个回合会重新读一次。同一个话题里,提示词中的记忆部分保持不变,模型对整段对话的
|
|
126
243
|
提示缓存照常命中(话题里学到的东西本来就在这段对话里)。很短的往来(一句确认、给队友的一行回复)只记一行
|
|
127
244
|
工作日志,不调用模型。
|
|
128
245
|
- bot 的 **记忆** 标签页和侧栏的 **团队记忆** 能看到全部内容,可以添加、修改、置顶或删除笔记。
|
|
@@ -135,10 +252,11 @@ bot 知道的事靠记忆延续。下面几种情况会开新话题:
|
|
|
135
252
|
|
|
136
253
|
## 用量
|
|
137
254
|
|
|
138
|
-
侧栏的 **用量** 统计 bot
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
255
|
+
侧栏的 **用量** 统计 bot 的每一次模型调用(它们的对话——包括做任务的会话——记忆工作,以及 Harness
|
|
256
|
+
压缩它们的上下文),可按 bot、模型、用途、定时任务、任务和日期(今天按小时)查看,并和上一期对比。
|
|
257
|
+
**回合** 和 **最近的回合** 统计的是回合(见「记忆」:一个请求,来自你、聊天应用、定时任务或其他 bot,
|
|
258
|
+
直到 bot 重新空闲);一个任务有一个或多个回合,**按任务** 把它们加在一起,任务详情页里也有它自己的用量。
|
|
259
|
+
费用是估算:用你填的价格,或 LiteLLM 公开价格表(**价格**);没有价格的模型只显示 tokens。
|
|
142
260
|
|
|
143
261
|

|
|
144
262
|
|
|
@@ -241,8 +359,8 @@ Slack 走 Socket Mode:由 Harness 主动连到 Slack,电脑不需要公网
|
|
|
241
359
|
也可以在面板里移除任何人;面板还会统计被忽略的消息数。
|
|
242
360
|
- **配对等同于你自己的登录**:配对的人能让 bot 做你能做的任何事,包括它们的能力和应用在这台 Mac 上允许的操作。
|
|
243
361
|
只配对你自己或你信任的人;如果配对了别人,请在拥有该聊天应用的 bot 上关掉有风险的能力。
|
|
244
|
-
-
|
|
245
|
-
Telegram 收到纯文本(去掉 Markdown 标记);Discord、Slack 和飞书会显示 Markdown 格式。在 Slack 频道里,回复发在你那条消息的讨论串里。
|
|
362
|
+
- **回复发到哪里**:发到请求来自的那个聊天;任务的结果发到这个任务来自的聊天(见[聊天与讨论串](#聊天与讨论串))。
|
|
363
|
+
在面板里发的消息,回复留在面板。Telegram 收到纯文本(去掉 Markdown 标记);Discord、Slack 和飞书会显示 Markdown 格式。在 Slack 频道里,回复发在你那条消息的讨论串里。
|
|
246
364
|
- **定时汇报**:拥有聊天应用的 bot 的定时任务会把结果发给第一个配对的人(可在面板里关闭),
|
|
247
365
|
于是「工作日早上九点 Atlas 给你做简报」会直接出现在你手机上。
|
|
248
366
|
- **一个 Token 只能在一处使用**:同一个聊天 Bot Token 同时只能连在一个 Harness 的一个 bot 上。
|
|
@@ -252,17 +370,25 @@ Slack 走 Socket Mode:由 Harness 主动连到 Slack,电脑不需要公网
|
|
|
252
370
|
|
|
253
371
|
## 原理
|
|
254
372
|
|
|
255
|
-
- 每个 bot
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
373
|
+
- 每个 bot 有一个自己的普通 Harness 会话,位于 **Bots** 工作区(默认 `~/.dsh/bots/workspace`,可用 `workdir` 改);
|
|
374
|
+
它做的每个任务另有一个会话(`ticket-<id>`),也在这个工作区里。任务结束超过设置里的小时数后,它的会话在 Harness 里归档。
|
|
375
|
+
- 会话运行时,bot 的人设和团队名单加入系统提示词;它自己的技能、能力限制和应用只作用于它自己的会话。
|
|
376
|
+
任务的会话里,提示词还会说明这是哪个任务、谁发起的、怎么汇报。修改即时生效;新增或修改应用在下次会话启动时连接。
|
|
377
|
+
- 「只调度」模式下,`bot_send_message` 在 bot 自己的会话里调用就开一个任务并立刻返回;在任务的会话里调用,
|
|
378
|
+
要么带状态向发起方汇报,要么开一个子任务。「亲自动手」模式下,从 bot 自己的会话发出的消息放进对方的收件箱并唤醒它,
|
|
379
|
+
和 0.7 一样。同一对 bot 10 分钟内最多互发 16 条(新开的任务和追加给任务的消息都算),防止无限对话。
|
|
380
|
+
- 所有会话都能用 `bot_list`、`bot_create`、`bot_update`、`bot_delete`、`bot_send_message`、`bot_reply`、`bot_recall`、
|
|
381
|
+
`bot_ticket`、`bot_schedule` 管理 bot 和任务,以及 `memory_save`、`memory_forget`、`memory_search`。
|
|
382
|
+
`bot_reply` 把答复发到指定的聊天;`bot_recall` 分页读取任务、任务的汇报或会话,以及聊天讨论串,让 bot 去查而不是猜;
|
|
383
|
+
`bot_ticket` 停止、关闭或重试自己发起的任务,或者请它汇报进度。参数见 [API.md](API.md)。
|
|
384
|
+
在 bot 或任务的会话里启动的子代理,以那个 bot 或任务的身份使用这些工具;追溯不到来源(启动它的会话已经不在)的子代理会被拒绝。
|
|
385
|
+
- bot 的记忆是它系统提示词里的一段,在话题或任务的会话开始时读取(面板里改了记忆或每晚整理后,在下一个回合开始时重读),
|
|
386
|
+
回合进行中不会变。bot 的 Agent 空闲时回合结束;记忆总结读的是这个回合的过程(提示、回复、工具调用和简短的工具结果),
|
|
387
|
+
任务则读它各个回合的过程。用量来自 bot 会话的 `assistant/message` 和 `compaction/summary` 事件,
|
|
263
388
|
再加上插件自己的记忆调用。
|
|
264
389
|
- 聊天应用不是 MCP 服务:Host 为每个聊天应用保持一个连接(Telegram 用长轮询,Discord 用 Gateway,Slack 用 Socket Mode,飞书用长连接),
|
|
265
|
-
随你添加、修改、关闭或删除应用而启动和停止,并把配对者的消息作为用户提示交给 bot,开头标着 `[Telegram · 名字]
|
|
390
|
+
随你添加、修改、关闭或删除应用而启动和停止,并把配对者的消息作为用户提示交给 bot,开头标着 `[Telegram · 名字] (thread <key>)`;
|
|
391
|
+
讨论串里的跟进则交给那个讨论串的任务(见[聊天与讨论串](#聊天与讨论串))。`bot_reply` 用的就是这个 key。
|
|
266
392
|
|
|
267
393
|
## Open Computer Use
|
|
268
394
|
|
|
@@ -271,13 +397,15 @@ Slack 走 Socket Mode:由 Harness 主动连到 Slack,电脑不需要公网
|
|
|
271
397
|
|
|
272
398
|
## 存储与外发
|
|
273
399
|
|
|
274
|
-
- `~/.dsh/cache/bots/`(`bots.json` 和 `
|
|
275
|
-
`channels.json`(每个聊天应用的配对者,以及每个聊天处理过的最后一条消息)、`
|
|
276
|
-
|
|
277
|
-
`
|
|
400
|
+
- `~/.dsh/cache/bots/`(`bots.json`、`channels.json` 和 `tickets.json` 只有你自己的账户能读):`bots.json`(bot,含应用里填的 Key 和聊天 Bot Token)、`messages.jsonl`(时间线)、
|
|
401
|
+
`channels.json`(每个聊天应用的配对者,以及每个聊天处理过的最后一条消息)、`tickets.json`(任务:交代的内容、汇报,
|
|
402
|
+
以及它们来自的聊天讨论串;已归档的任务保留最新的 500 个)、`avatars/`、`skills/`(从 GitHub 导入的技能)、
|
|
403
|
+
`memory/`(笔记、工作日志、每日摘要)、`usage.jsonl` 和 `tasks.jsonl`(每次调用和每个回合的 tokens,保留 400 天)、
|
|
404
|
+
`topics.json`、`settings.json`、`price-catalog.json`。`tickets.json` 读不出来(比如权限不对)时,Bots 不会启动,
|
|
405
|
+
并在 Harness 日志里说明原因,这样文件不会被覆盖;文件损坏时,会改名保存为 `tickets.json.corrupt-<时间>`,任务从空白开始。
|
|
278
406
|
- 自定义端点和借用的 Codex 登录写在 Harness 自己的模型设置(`llm-pi-ai`)和凭据库里。使用 Codex 登录时,
|
|
279
407
|
Harness 刷新得到的令牌会写回 `~/.codex/auth.json`。
|
|
280
|
-
- 除了 bot
|
|
408
|
+
- 除了 bot 自身会话(你配置的模型)、记忆整理(把回合或任务的过程和 bot 的笔记发给 bot 的模型或记忆模型)、LiteLLM 价格表(每周从 GitHub 下载一次)、你连接的应用、生成头像时的图片模型、导入技能时访问 GitHub,
|
|
281
409
|
以及连接聊天应用后访问飞书 / Lark、Telegram、Slack、Discord 的 API(给配对者的回复、正在输入提示、给陌生人的那一句提示),不向外发送任何内容。
|
|
282
410
|
|
|
283
411
|
## 安装
|
|
@@ -299,10 +427,33 @@ git+https://github.com/kadaliao/dsh-plugins.git#main&path:/plugins/bots
|
|
|
299
427
|
|
|
300
428
|
安装后刷新一次页面。想要 AI 头像,再装上[图片插件](../images)。
|
|
301
429
|
|
|
430
|
+
## 从 0.8 升级
|
|
431
|
+
|
|
432
|
+
- 不用做什么:bot、任务、记忆、定时任务、聊天应用和配对都原样保留。时间线 `messages.jsonl` 多了话题相关的字段,
|
|
433
|
+
以前的消息照旧留在主时间线。
|
|
434
|
+
- 升级前开出、来自某个聊天或面板的任务,之后汇报时也直接回复你,和新任务一样。
|
|
435
|
+
- 「只调度」的调度员在自己的会话里不再联网搜索(搜索交给任务,没有合适的队友就交给自己);在它的 **能力** 一栏点 **重新打开** 可以放回。
|
|
436
|
+
|
|
437
|
+
## 从 0.7 升级
|
|
438
|
+
|
|
439
|
+
- bot、记忆、定时任务、话题、聊天应用和配对都原样保留;0.8 新增 `tickets.json` 存放任务。
|
|
440
|
+
- 已经有 bot 的团队会切到「只调度」:调度员不再自己干活,
|
|
441
|
+
它自己的会话里也不再有[调度员只调度](#调度员只调度)里列出的那些工具,bot 之间分派的工作都变成任务。
|
|
442
|
+
Bots 面板会提示一次,带 **打开它的资料页** 和 **知道了** 两个按钮;团队里除了调度员还有别的 bot 时才会出现。
|
|
443
|
+
- 想改回原来的做法:打开调度员的 **资料** 页,在 **调度方式** 里选 **亲自动手**。立即对整个团队生效;
|
|
444
|
+
已经开出的任务照常进行、照常汇报。选了任何一种方式,那条提示也就不再出现。
|
|
445
|
+
- 发往聊天应用的回复跟着请求走(见[聊天与讨论串](#聊天与讨论串));0.7 里是发到最近一次请求来自的聊天。
|
|
446
|
+
- **用量** 里,0.7 叫「任务」的那一项现在叫「回合」(**回合**、**最近的回合**),数字不变;
|
|
447
|
+
**按任务** 从升级后的第一个任务开始统计。
|
|
448
|
+
|
|
302
449
|
## 限制
|
|
303
450
|
|
|
304
451
|
- 仅 Web 界面。
|
|
305
|
-
- 暂无 bot 群聊,bot
|
|
452
|
+
- 暂无 bot 群聊,bot 之间通过任务和私信协作。
|
|
453
|
+
- 在群聊里,bot 只听 @ 它(或回复它)的消息,不旁听群里的其他对话;0.8 没有改变这一点。
|
|
454
|
+
- 讨论串的历史从 0.8 开始:升级前的消息不属于任何讨论串,所以用 `bot_recall` 读某个聊天讨论串时,只能看到升级以后的内容。面板话题从 0.9 开始。
|
|
455
|
+
- 话题只在面板里有。聊天应用里,由应用自己的讨论串、话题和回复链起这个作用;私聊仍是一整段对话,新消息交给调度员。
|
|
456
|
+
- 看门狗只看时间和状态,不判断任务的方向对不对。
|
|
306
457
|
- 费用是估算,网关、订阅和折扣的实际计费会不同;可以填自己的价格。
|
|
307
458
|
- 目前只能借用 Codex CLI 的登录;其他订阅请在 Harness 支持的情况下,到 设置 → 模型 里登录。
|
|
308
459
|
- 团队模板引用的 Harness 技能,你没装的会被跳过;可以之后再从 GitHub 导入或让 bot 自己写。
|