aicrosschat 0.8.6 → 0.8.8

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.
Files changed (3) hide show
  1. package/README.md +28 -0
  2. package/package.json +1 -1
  3. package/relay/ui.html +38 -5
package/README.md CHANGED
@@ -170,6 +170,34 @@ npm run smoke # 16 项,等价于 node relay/smoke.mjs
170
170
  > 早先文档里提到的 `test-core.mjs`、`test-integration.mjs`、`test-two-instances.mjs` 已不存在;双实例结果属于历史记录,当前仓库不再提供该驱动脚本,**不作为可复现声明**。
171
171
 
172
172
 
173
+ ## 进度共享与任务颗粒度(协作约定)
174
+
175
+ 跨机协作最大的成本不是算力,而是**等一个不知道卡在哪的任务**。所以把下面两条当作协议的一部分:
176
+
177
+ ### 1. 任务颗粒度:一个任务 = 一个可验收的交付单元
178
+
179
+ - 派活前先拆:一个任务应当能在**一次执行**内完成、并且有一个**可判定通过/不通过的结果**(文件、测试输出、指标、链接)。
180
+ - 不要把一个多日目标直接丢给成员;拆成「可并行 / 有依赖」的子任务,用 `dependsOn` 串起来(见上文)。
181
+ - 派发时写清四件事:**目标**(做什么)、**范围**(`paths`,避免重叠)、**验收标准**(怎样算完成)、**回报点**(何时发 status)。
182
+ - 主控侧:板上一个任务对应一个可验收结果;不要把“调研 + 实现 + 发布”塞进同一个任务。
183
+
184
+ ### 2. 进度共享:关键节点必须发 `status`,不要静默
185
+
186
+ 执行方在下列节点发一条 `team_say(kind=status, taskId=…)`,一条一两句即可:
187
+
188
+ | 节点 | 内容 |
189
+ |---|---|
190
+ | 开工 | 认领后说明预期做法与预计耗时 |
191
+ | 遇到阻塞 | 卡在哪、需要谁提供什么(同时用 `kind=blocker` 更醒目) |
192
+ | 长任务中途 | 每完成一个阶段发一次(建议不超过 15 分钟或每 25% 进度一次) |
193
+ | 完成 | 用 `team_done(taskId, 摘要)` 收口;`answer` 只是汇报,不关闭任务 |
194
+
195
+ - **不要用“我在做了”代替具体进展**:写“已完成 X,正在 Y,预计 Z 前给结果”。
196
+ - 主控收到 `status` 后如无新指令可只记录不回;需要改方向时再 `team_say(kind=task)` 追加。
197
+ - 如果任务预计会超过原估时,先发 status 再继续,别等到超时。
198
+
199
+ > 这两条是约定而非强制校验:插件不会因为没发 status 拦截你,但审计/复盘会把“静默超时”和“颗粒度过大”当作协作问题记录下来。
200
+
173
201
  ## 其他客户端接入(非 DSH)
174
202
 
175
203
  协议在 relay 层,所以参与者不必是 DSH。两种接入方式:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aicrosschat",
3
- "version": "0.8.6",
3
+ "version": "0.8.8",
4
4
  "description": "跨机 DSH 协作插件:一台机器派活,其他机器各自干活,通过共享结构化事件时间线交换任务与结果;默认不打扰,可开圆桌模式。",
5
5
  "type": "module",
6
6
  "private": false,
package/relay/ui.html CHANGED
@@ -69,12 +69,16 @@
69
69
  <h1>crosschat</h1>
70
70
  <span class="chip">tail <b id="head">-</b></span>
71
71
  <span class="chip">签名 <b id="signed">-</b></span>
72
- <span class="chip" id="peers">在线 -</span>
72
+ <span class="chip" id="peers">最近活跃 -</span>
73
73
  <span style="flex:1"></span>
74
74
  <span class="chip" id="status">连接中…</span>
75
75
  </header>
76
76
 
77
77
  <main>
78
+ <section>
79
+ <h2>成员</h2>
80
+ <div class="col" id="roster"></div>
81
+ </section>
78
82
  <section>
79
83
  <h2>任务板</h2>
80
84
  <div class="col"><h3>进行中(claimed)</h3><div id="col-claimed"></div></div>
@@ -128,15 +132,24 @@
128
132
  const esc = text => String(text ?? '').replace(/[&<>"]/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]))
129
133
  const hhmmss = ts => new Date(ts || Date.now()).toLocaleTimeString('zh-CN', { hour12: false })
130
134
 
131
- // 与 plugin/lib/tasks.js 等价的三态折叠
135
+ // 与 plugin/lib/tasks.js 等价的三态折叠(含依赖与就绪判定)
132
136
  function foldTasks(events) {
133
137
  const board = new Map()
134
138
  for (const event of [...events].sort((a, b) => a.seq - b.seq)) {
135
139
  if (!event.taskId) continue
136
140
  const task = board.get(event.taskId)
137
141
  if (event.kind === 'task') {
138
- if (!task) board.set(event.taskId, { id: event.taskId, state: 'open', owner: null, round: 1, title: event.text, paths: event.paths || [] })
139
- else if (task.state === 'done') board.set(event.taskId, { ...task, state: 'open', owner: null, round: task.round + 1, title: event.text, paths: event.paths || task.paths })
142
+ if (!task) {
143
+ board.set(event.taskId, {
144
+ id: event.taskId, state: 'open', owner: null, round: 1,
145
+ title: event.text, paths: event.paths || [], dependsOn: event.dependsOn || [],
146
+ })
147
+ } else if (task.state === 'done') {
148
+ board.set(event.taskId, {
149
+ ...task, state: 'open', owner: null, round: task.round + 1,
150
+ title: event.text, paths: event.paths || task.paths, dependsOn: event.dependsOn || task.dependsOn,
151
+ })
152
+ }
140
153
  } else if (task) {
141
154
  if (event.kind === 'claim' && task.state === 'open') {
142
155
  board.set(event.taskId, { ...task, state: 'claimed', owner: event.name || event.from, paths: [...new Set([...(task.paths || []), ...(event.paths || [])])] })
@@ -147,7 +160,25 @@
147
160
  }
148
161
  }
149
162
  }
150
- return [...board.values()]
163
+ return [...board.values()].map(task => ({
164
+ ...task,
165
+ ready: (task.dependsOn || []).every(id => board.get(id)?.state === 'done'),
166
+ }))
167
+ }
168
+
169
+ function renderRoster(events) {
170
+ const profiles = new Map()
171
+ for (const event of events) if (event.kind === 'profile') profiles.set(event.from, event.text)
172
+ const host = $('roster')
173
+ if (profiles.size === 0) {
174
+ host.innerHTML = '<div class="meta" style="color:var(--dim);font-size:11px">(还没有成员声明能力)</div>'
175
+ return
176
+ }
177
+ host.innerHTML = [...profiles.entries()].map(([node, text]) => `
178
+ <div class="task" style="border-left-color:var(--answer)">
179
+ <div class="id">${esc(node)}</div>
180
+ <div class="title">${esc(text)}</div>
181
+ </div>`).join('')
151
182
  }
152
183
 
153
184
  function renderBoard(tasks) {
@@ -161,6 +192,7 @@
161
192
  <div class="task ${task.state}">
162
193
  <div class="id">${esc(task.id)} <span style="color:var(--dim);font-weight:400">r${task.round}</span></div>
163
194
  ${task.owner ? `<div class="meta">@${esc(task.owner)}</div>` : ''}
195
+ ${task.dependsOn?.length ? `<div class="meta">deps: ${esc(task.dependsOn.join(', '))}${task.ready === false ? ' · 等待中' : ''}</div>` : ''}
164
196
  ${task.paths?.length ? `<div class="meta">${esc(task.paths.join(', '))}</div>` : ''}
165
197
  <div class="title">${esc(task.title)}</div>
166
198
  </div>`).join('')
@@ -197,6 +229,7 @@
197
229
  $('signed').textContent = health.signed ? '开' : '关'
198
230
  $('peers').innerHTML = '在线 ' + (peers.peers || []).map(p => `<b>${esc(p.node)}</b>`).join('、')
199
231
  $('status').textContent = '已连接'
232
+ renderRoster(page.events || [])
200
233
  renderBoard(foldTasks(page.events || []))
201
234
  renderLog(page.events || [])
202
235
  } catch (error) {