fde-console 0.0.0-stage → 2.9.68

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 (85) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +128 -2
  3. package/README.zh-CN.md +130 -0
  4. package/assets/icon.svg +9 -0
  5. package/cordis.patch.yml +7 -0
  6. package/lib/agentActivity.js +1180 -0
  7. package/lib/agentContext.js +146 -0
  8. package/lib/agentTranscript.js +1398 -0
  9. package/lib/analyze.js +625 -0
  10. package/lib/attribute.js +205 -0
  11. package/lib/backup.js +366 -0
  12. package/lib/desktopAgents.js +123 -0
  13. package/lib/diary.js +333 -0
  14. package/lib/dingtalk.js +412 -0
  15. package/lib/feishu.js +580 -0
  16. package/lib/giteaClient.js +810 -0
  17. package/lib/giteeClient.js +372 -0
  18. package/lib/githubClient.js +361 -0
  19. package/lib/heatmap.js +99 -0
  20. package/lib/imNotify.js +378 -0
  21. package/lib/inbox.js +438 -0
  22. package/lib/instanceLock.js +122 -0
  23. package/lib/jobs.js +56 -0
  24. package/lib/learn.js +1388 -0
  25. package/lib/learnImport.js +283 -0
  26. package/lib/learnSeeds.js +97 -0
  27. package/lib/learnSeedsAiEng.js +77 -0
  28. package/lib/mcpCore.js +135 -0
  29. package/lib/members.js +160 -0
  30. package/lib/migration.js +403 -0
  31. package/lib/overview.js +376 -0
  32. package/lib/postmortem.js +148 -0
  33. package/lib/radarIgnore.js +134 -0
  34. package/lib/redact.js +76 -0
  35. package/lib/router.js +246 -0
  36. package/lib/routes-gitea.js +262 -0
  37. package/lib/routes-setup.js +40 -0
  38. package/lib/scorecard.js +111 -0
  39. package/lib/sessionRef.js +227 -0
  40. package/lib/sessionSnapshot.js +67 -0
  41. package/lib/sessionSuggest.js +186 -0
  42. package/lib/settings.js +783 -0
  43. package/lib/setupCheck.js +330 -0
  44. package/lib/ssrfGuard.js +145 -0
  45. package/lib/store.js +564 -0
  46. package/lib/storeDb.js +418 -0
  47. package/lib/taskEvents.js +243 -0
  48. package/lib/webhookOut.js +125 -0
  49. package/lib/weekly.js +439 -0
  50. package/lib/workSearch.js +220 -0
  51. package/locale/en.json +6 -0
  52. package/locale/zh.json +6 -0
  53. package/package.json +46 -4
  54. package/plugin/adapter.js +157 -0
  55. package/plugin/client.js +282 -0
  56. package/plugin/index.mjs +116 -0
  57. package/plugin/static.js +99 -0
  58. package/scripts/backup-data.js +41 -0
  59. package/scripts/mcp-server.mjs +68 -0
  60. package/scripts/migrate-data.js +301 -0
  61. package/scripts/migrate-storage.js +47 -0
  62. package/scripts/seed-demo.js +200 -0
  63. package/scripts/write-agent-context.js +43 -0
  64. package/test/helpers/appAssembler.js +1078 -0
  65. package/web/client/fde-client.js +292 -0
  66. package/web/css/app.css +1510 -0
  67. package/web/index.html +69 -0
  68. package/web/js/api.js +72 -0
  69. package/web/js/app.js +313 -0
  70. package/web/js/icons.js +48 -0
  71. package/web/js/mock.js +1150 -0
  72. package/web/js/state.js +7 -0
  73. package/web/js/ui.js +276 -0
  74. package/web/js/views/activity.js +410 -0
  75. package/web/js/views/agents.js +892 -0
  76. package/web/js/views/board.js +1656 -0
  77. package/web/js/views/learn.js +530 -0
  78. package/web/js/views/members.js +344 -0
  79. package/web/js/views/onboarding.js +103 -0
  80. package/web/js/views/overview.js +508 -0
  81. package/web/js/views/radar.js +1359 -0
  82. package/web/js/views/search.js +149 -0
  83. package/web/js/views/settings.js +1351 -0
  84. package/web/js/views/topology.js +471 -0
  85. package/web/mock.json +2363 -0
@@ -0,0 +1,344 @@
1
+ // F5 成员进度 + 成员名册管理:六列表格 + 状态徽标(working/idle/stale→超阈值升红)+ 进度条 + 汇总卡 + 10s 轮询
2
+ // 名册管理:manual:true 行可编辑/删除(弹层表单,400/409 错误码+文案直出);manual:false 行只读徽标
3
+ import { apiGet, apiPost, apiPatch, apiDel } from '../api.js';
4
+ import { esc, toast, openModal, confirmModal, icon, fmtSec, fmtAgo, fmtFull, avatarColor, initials, startPolling, dueBadge, busyBtn } from '../ui.js';
5
+
6
+ let rootEl = null;
7
+ let stopPoll = null;
8
+ let cache = { members: [], warnSec: 14400, dangerSec: 86400 };
9
+ let memTab = 'agent'; // 分组:硅基(agent) | 人类(human),记忆上次选择
10
+ try { if (localStorage.getItem('fde-members-tab') === 'human') memTab = 'human'; } catch (e) { /* localStorage 不可用则用默认 */ }
11
+
12
+ // busyBtn:提交/点击型操作的 busy 锁(SPEC-UX v2.1 §4-E)——进入即 disabled、finally 恢复、异常必解锁。
13
+ // 注意:ui.js 并行岗将导出同名实现,集成时换 ui.js 导出(签名一致)
14
+
15
+ export async function render(el) {
16
+ rootEl = el;
17
+ el.innerHTML = `
18
+ <div class="stats" id="mem-stats"><div class="loading">加载中…</div></div>
19
+ <div class="panelbox">
20
+ <h4 class="panel-title">
21
+ <span>成员进度</span>
22
+ <span class="muted small" id="mem-rule"></span>
23
+ <span class="spacer"></span>
24
+ <button type="button" class="btn small" id="mem-add">${icon('plus')}新增成员</button>
25
+ <button type="button" class="btn ghost small" id="mem-refresh">${icon('refresh-cw')}刷新</button>
26
+ </h4>
27
+ <div class="seg" id="mem-tabs" role="tablist" aria-label="成员分组" style="margin:0 14px 10px">
28
+ <button type="button" class="seg-btn" data-tab="agent" role="tab">硅基 <span class="n" id="mem-tab-agent" style="opacity:.65;margin-left:2px"></span></button>
29
+ <button type="button" class="seg-btn" data-tab="human" role="tab">人类 <span class="n" id="mem-tab-human" style="opacity:.65;margin-left:2px"></span></button>
30
+ <span id="mem-src-health" style="margin-left:auto;align-self:center;margin-right:14px"></span>
31
+ </div>
32
+ <div class="table-wrap">
33
+ <table class="table">
34
+ <thead><tr>
35
+ <th style="width:19%">成员</th><th>状态</th><th style="width:24%">当前任务 / 进度</th>
36
+ <th>时效</th><th>今日产出</th><th id="mem-th-sess">会话</th><th style="width:14%">操作</th>
37
+ </tr></thead>
38
+ <tbody id="mem-tbody"><tr><td colspan="${memTab === 'agent' ? 7 : 6}" class="muted">加载中…</td></tr></tbody>
39
+ </table>
40
+ </div>
41
+ </div>`;
42
+ el.querySelector('#mem-refresh').addEventListener('click', refresh);
43
+ el.querySelector('#mem-add').addEventListener('click', () => openMemberModal());
44
+ el.querySelector('#mem-tabs').addEventListener('click', (e) => {
45
+ const b = e.target.closest('[data-tab]');
46
+ if (!b || b.getAttribute('data-tab') === memTab) return;
47
+ memTab = b.getAttribute('data-tab');
48
+ try { localStorage.setItem('fde-members-tab', memTab); } catch (e2) { /* 忽略 */ }
49
+ renderAll();
50
+ });
51
+ // 行内操作走事件委托:轮询只重绘 tbody,监听挂在 tbody 元素上不丢失
52
+ el.querySelector('#mem-tbody').addEventListener('click', onRowClick);
53
+ await refresh();
54
+ if (!rootEl) return;
55
+ stopPoll = startPolling(refresh, 10000);
56
+ }
57
+
58
+ export function destroy() {
59
+ rootEl = null;
60
+ if (stopPoll) { stopPoll(); stopPoll = null; }
61
+ }
62
+
63
+ async function refresh() {
64
+ const root = rootEl;
65
+ if (!root) return;
66
+ try {
67
+ // 时效阈值取自 /api/settings(gitea.staleWarnSec / staleDangerSec)
68
+ const [members, settings] = await Promise.all([apiGet('/api/members'), apiGet('/api/settings').catch(() => null)]);
69
+ if (!rootEl) return;
70
+ cache.members = members || [];
71
+ cache.warnSec = (settings && settings.gitea && settings.gitea.staleWarnSec) || 14400;
72
+ cache.dangerSec = (settings && settings.gitea && settings.gitea.staleDangerSec) || 86400;
73
+ renderAll();
74
+ drawSourceHealth(); // 桌面源健康徽标(独立轻探针,失败静默不拖垮成员表)
75
+ } catch (e) {
76
+ const tbody = root.querySelector('#mem-tbody');
77
+ if (tbody) tbody.innerHTML = `<tr><td colspan="${memTab === 'agent' ? 7 : 6}" class="loading err">${esc(e.message)}</td></tr>`;
78
+ toast(e.message);
79
+ }
80
+ }
81
+
82
+ // 桌面源健康徽标(N/N 源正常,title 逐源 detail;与智能体动态页同款语义)——
83
+ // 治「桌面源故障时成员静默缺席无信号」(2026-11-03 评审尾巴)
84
+ function drawSourceHealth() {
85
+ const root = rootEl;
86
+ if (!root) return;
87
+ const elH = root.querySelector('#mem-src-health');
88
+ if (!elH) return;
89
+ apiGet('/api/members/source-health').then((list) => {
90
+ if (!rootEl) return;
91
+ const sources = Array.isArray(list) ? list.filter((s) => s && s.enabled !== false) : [];
92
+ const target = root.querySelector('#mem-src-health');
93
+ if (!target) return;
94
+ if (!sources.length) { target.innerHTML = ''; return; }
95
+ const okCnt = sources.filter((s) => s.ok).length;
96
+ const allOk = okCnt === sources.length;
97
+ const title = sources.map((s) => `${s.id}:${s.ok ? '正常' : (s.detail || '失败')}`).join('\n');
98
+ target.innerHTML = `<span class="badge ${allOk ? 'b-alive' : 'st-stale'}" title="${esc(title)}&#10;最近扫描:${esc(fmtFull(sources[0].scannedAt))}">${okCnt}/${sources.length} 源正常</span>`;
99
+ }).catch(() => { /* 探针失败不拖垮成员表,徽标维持空白 */ });
100
+ }
101
+
102
+ function onRowClick(e) {
103
+ const btn = e.target.closest('[data-act]');
104
+ if (!btn) return;
105
+ const row = btn.closest('tr[data-id]');
106
+ const m = cache.members.find((x) => x.id === (row && row.dataset.id));
107
+ if (!m) return;
108
+ if (btn.dataset.act === 'edit') openMemberModal(m);
109
+ else if (btn.dataset.act === 'del') deleteMember(m);
110
+ }
111
+
112
+ async function deleteMember(m) {
113
+ const ok = await confirmModal(`ID:${m.id},该操作不可恢复。`, { title: `删除成员「${m.name}」?` });
114
+ if (!ok) return;
115
+ try {
116
+ await apiDel(`/api/members/${encodeURIComponent(m.id)}`);
117
+ toast('成员已删除', 'success');
118
+ refresh();
119
+ } catch (e) {
120
+ toast(e.message); // 409 MEMBER_IMMUTABLE(派生条目不可删)红色 toast 直出
121
+ }
122
+ }
123
+
124
+ function isDanger(m) {
125
+ return m.status === 'stale' && !!(m.currentTask && m.currentTask.sinceUpdateSec > cache.dangerSec);
126
+ }
127
+
128
+ function renderAll() {
129
+ const root = rootEl;
130
+ if (!root) return;
131
+ const ms = cache.members;
132
+ const nAgent = ms.filter((m) => m.kind === 'agent').length;
133
+ const nHuman = ms.filter((m) => m.kind === 'human').length;
134
+ const nWorking = ms.filter((m) => m.status === 'working' && m.enabled !== false).length;
135
+ const nIdle = ms.filter((m) => m.status === 'idle' && m.enabled !== false).length;
136
+ const nDanger = ms.filter(isDanger).length;
137
+ const nStale = ms.filter((m) => m.status === 'stale').length;
138
+
139
+ root.querySelector('#mem-stats').innerHTML = `
140
+ <div class="stat"><b>${ms.length}</b><span>成员(智能体 ${nAgent} · 人类 ${nHuman})</span></div>
141
+ <div class="stat"><b style="color:var(--green)">${nWorking}</b><span>工作中</span></div>
142
+ <div class="stat"><b>${nIdle}</b><span>空闲</span></div>
143
+ <div class="stat"><b style="color:${nDanger > 0 ? 'var(--red)' : 'var(--yellow)'}">${nStale}</b>
144
+ <span>超时预警${nDanger > 0 ? `(${nDanger} 个已危险)` : ''}</span></div>`;
145
+ root.querySelector('#mem-rule').textContent =
146
+ `时效规则:进行中 ${fmtSec(cache.warnSec)} 无更新预警 · ${fmtSec(cache.dangerSec)} 无更新危险(阈值取自设置)`;
147
+
148
+ // 分组 tab:硅基 | 人类(表格只渲染当前组;汇总卡保持全量口径)。
149
+ // v2.9.68:会话列仅对硅基有意义(人类不产生本机 agent 会话,恒「无会话」= 噪音)——人类 tab 整列隐藏
150
+ const rows = ms.filter((m) => (memTab === 'agent' ? m.kind === 'agent' : m.kind === 'human'));
151
+ const thSess = root.querySelector('#mem-th-sess');
152
+ if (thSess) thSess.hidden = memTab !== 'agent';
153
+ const tabAgent = root.querySelector('#mem-tab-agent');
154
+ const tabHuman = root.querySelector('#mem-tab-human');
155
+ if (tabAgent) tabAgent.textContent = nAgent;
156
+ if (tabHuman) tabHuman.textContent = nHuman;
157
+ root.querySelectorAll('#mem-tabs .seg-btn').forEach((b) => {
158
+ b.classList.toggle('on', b.getAttribute('data-tab') === memTab);
159
+ b.setAttribute('aria-selected', b.getAttribute('data-tab') === memTab ? 'true' : 'false');
160
+ });
161
+
162
+ root.querySelector('#mem-tbody').innerHTML = rows.map(memberRow).join('') ||
163
+ `<tr><td colspan="${memTab === 'agent' ? 7 : 6}" class="muted">${memTab === 'agent' ? '暂无硅基成员' : '暂无人类成员'}</td></tr>`;
164
+ }
165
+
166
+ function statusBadge(m) {
167
+ if (m.enabled === false) return '<span class="badge st-off">已停用</span>';
168
+ if (m.status === 'working') return '<span class="badge st-working">工作中</span>';
169
+ if (m.status === 'stale') {
170
+ return isDanger(m) ? '<span class="badge st-danger">超时危险</span>' : '<span class="badge st-stale">超时预警</span>';
171
+ }
172
+ return '<span class="badge st-idle">空闲</span>';
173
+ }
174
+
175
+ // 本批任务日报:diaryToday 两态轻提醒(只提示不阻断)——
176
+ // 仅真人行渲染(日报是人的过程留痕,智能体已有会话/提交观测,agent 行不出标记避免整屏噪音);
177
+ // 无进行中任务不提醒;amber=今日未填,绿=已填。写入口在任务详情「日报」区
178
+ function diaryBadge(m) {
179
+ if (m.kind !== 'human' || !m.currentTask) return '';
180
+ if (m.currentTask.status === 'done') return '';
181
+ return m.diaryToday
182
+ ? '<span class="badge b-diary-ok" title="今日已填写任务日报">已填</span>'
183
+ : '<span class="badge b-diary-miss" title="今日尚未填写任务日报(轻提醒,不阻断)">今日未填日报</span>';
184
+ }
185
+
186
+ // 操作列:manual:true → 编辑/删除;manual:false → 只读徽标(智能体 / Gitea 同步)
187
+ function actionsCell(m) {
188
+ if (m.manual !== true) {
189
+ const badge = m.kind === 'agent'
190
+ ? '<span class="badge b-agent">智能体</span>'
191
+ : '<span class="badge b-ro">Gitea 同步</span>';
192
+ return `<td class="mem-actions-cell">${badge}</td>`;
193
+ }
194
+ return `
195
+ <td class="mem-actions-cell"><span class="mem-actions">
196
+ <button type="button" class="btn ghost xs" data-act="edit">${icon('pencil')}编辑</button>
197
+ <button type="button" class="btn danger xs" data-act="del">${icon('trash')}删除</button>
198
+ </span></td>`;
199
+ }
200
+
201
+ function memberRow(m) {
202
+ const color = avatarColor(m.id);
203
+ const kindLabel = (m.kind === 'human' ? '人类' : '智能体') + (m.role ? ` · ${esc(m.role)}` : '') +
204
+ (m.giteaLogin ? ` · <span class="mono">${esc(m.giteaLogin)}</span>` : '');
205
+ const ct = m.currentTask;
206
+ const off = m.enabled === false;
207
+
208
+ let taskCell = '<span class="muted">—</span>';
209
+ let timeCell;
210
+ let progClass = '';
211
+ if (isDanger(m)) progClass = ' danger';
212
+ else if (m.status === 'stale') progClass = ' warn';
213
+
214
+ if (ct) {
215
+ const pct = Math.round((Number(ct.progress) || 0) * 100);
216
+ taskCell = `
217
+ <div class="task-line">${esc(ct.title)} ${dueBadge(ct.dueDate)}
218
+ <span class="mono muted" title="${esc(ct.id)}">${esc(ct.id.length > 14 ? ct.id.slice(0, 13) + '…' : ct.id)}</span></div>
219
+ <div class="prog"><span class="${progClass.trim()}" style="width:${pct}%"></span></div>`;
220
+ const updCls = isDanger(m) ? 'st-danger' : (m.status === 'stale' ? '' : 'st-working');
221
+ const updStyle = isDanger(m) ? 'color:var(--red)' : (m.status === 'stale' ? 'color:var(--yellow)' : 'color:var(--green)');
222
+ timeCell = `已进行 ${fmtSec(ct.ageSec)}<br><span style="${updStyle}">最近更新 ${fmtSec(ct.sinceUpdateSec)}前</span>`;
223
+ } else {
224
+ timeCell = `上次活跃 ${fmtAgo(m.lastActivityAt)}`;
225
+ }
226
+
227
+ const outCell = `${Number(m.todayCommits) || 0} 提交 · ${Number(m.openPrs) || 0} PR` +
228
+ (m.weekDone ? `<br><span class="muted">本周完成 ${m.weekDone}</span>` : '');
229
+
230
+ let sessCell = '';
231
+ if (memTab === 'agent') {
232
+ // 会话列仅硅基 tab 渲染(人类不产生本机 agent 会话)
233
+ sessCell = '<span class="badge b-dead">无会话</span>';
234
+ if (m.session) {
235
+ // 桌面 agent 会话是长 UUID(workbuddy),截 13 字符展示,全文走 title
236
+ const sid = m.session.id || '';
237
+ const sidShort = sid.length > 14 ? sid.slice(0, 13) + '…' : sid;
238
+ sessCell = m.session.alive
239
+ ? `<span class="badge b-alive mono" title="${esc(sid)}">${esc(sidShort)}</span>`
240
+ : `<span class="badge b-dead mono" title="${esc(sid)}">${esc(sidShort)} 已退出</span>`;
241
+ }
242
+ }
243
+
244
+ return `
245
+ <tr data-id="${esc(m.id)}"${off ? ' class="row-off"' : ''}>
246
+ <td><div class="member-cell">
247
+ <span class="avatar" style="background:${color}">${esc(initials(m.name))}</span>
248
+ <div><b>${esc(m.name)}</b><div class="muted" style="font-size:11px">${kindLabel}</div></div>
249
+ </div></td>
250
+ <td><span class="st-line">${statusBadge(m)}${diaryBadge(m)}</span></td>
251
+ <td>${taskCell}</td>
252
+ <td style="font-size:12px">${timeCell}</td>
253
+ <td style="font-size:12px">${outCell}</td>
254
+ ${memTab === 'agent' ? `<td>${sessCell}</td>` : ''}
255
+ ${actionsCell(m)}
256
+ </tr>`;
257
+ }
258
+
259
+ // 成员新增/编辑弹层(同一表单;编辑时 id 只读 + enabled 停用开关;错误码+文案直出弹层内)
260
+ function openMemberModal(member = null) {
261
+ const isEdit = !!member;
262
+ const box = document.createElement('div');
263
+ box.innerHTML = `
264
+ <form id="member-form">
265
+ <div class="form-row"><label class="req">ID(唯一,小写字母开头)</label>
266
+ <input name="id" maxlength="32" ${isEdit ? `readonly value="${esc(member.id)}"` : 'placeholder="如 wang.lei"'} required></div>
267
+ <div class="form-row"><label class="req">名称</label>
268
+ <input name="name" maxlength="50" required value="${esc(member ? member.name : '')}" placeholder="如 王磊"></div>
269
+ <div class="form-row"><label>角色</label>
270
+ <input name="role" maxlength="50" value="${esc(member ? member.role : '')}" placeholder="如 前端 / 测试"></div>
271
+ <div class="form-row"><label>Gitea 账号(用于动态流归人)</label>
272
+ <input name="giteaLogin" maxlength="50" value="${esc(member ? member.giteaLogin : '')}" placeholder="如 wanglei"></div>
273
+ ${isEdit ? `
274
+ <div class="form-row"><label>启用状态</label>
275
+ <span class="switch-line">
276
+ <button type="button" class="switch${member.enabled === false ? ' off' : ''}" id="mem-enabled"
277
+ aria-pressed="${member.enabled !== false}" aria-label="成员启停开关"></button>
278
+ <span class="muted small" id="mem-enabled-tip">${member.enabled === false ? '已停用' : '已启用'}</span>
279
+ </span></div>` : ''}
280
+ <div class="form-err" id="member-form-err"></div>
281
+ <div class="modal-actions">
282
+ <span class="spacer"></span>
283
+ <button type="button" class="btn ghost" data-act="cancel">取消</button>
284
+ <button type="submit" class="btn">${isEdit ? '保存修改' : '新增成员'}</button>
285
+ </div>
286
+ </form>`;
287
+ const m = openModal({ title: isEdit ? `编辑成员 · ${member.name}` : '新增成员', body: box });
288
+ const errEl = box.querySelector('#member-form-err');
289
+ const showErr = (err) => {
290
+ errEl.textContent = `${err && err.code ? err.code : 'ERROR'}: ${(err && err.message) || String(err)}`;
291
+ errEl.classList.add('show');
292
+ };
293
+
294
+ box.querySelector('[data-act=cancel]').addEventListener('click', m.close);
295
+
296
+ const sw = box.querySelector('#mem-enabled');
297
+ if (sw) {
298
+ sw.addEventListener('click', () => {
299
+ const on = sw.getAttribute('aria-pressed') !== 'true';
300
+ sw.setAttribute('aria-pressed', String(on));
301
+ sw.classList.toggle('off', !on);
302
+ box.querySelector('#mem-enabled-tip').textContent = on ? '已启用' : '已停用';
303
+ });
304
+ }
305
+
306
+ box.querySelector('#member-form').addEventListener('submit', (e) => {
307
+ e.preventDefault();
308
+ const f = e.target;
309
+ // busy 锁:await 期间提交按钮 disabled,双击只发一次(§4-E)
310
+ busyBtn(f.querySelector('[type=submit]'), async () => {
311
+ // form.id/form.name 与 HTMLElement 内建属性冲突,必须走 elements.namedItem
312
+ const val = (n) => f.elements.namedItem(n).value;
313
+ errEl.classList.remove('show');
314
+ const id = val('id').trim();
315
+ const name = val('name').trim();
316
+ const role = val('role').trim();
317
+ const giteaLogin = val('giteaLogin').trim();
318
+ try {
319
+ if (!isEdit) {
320
+ // id 规则与后端 lib/members.js 一致(pattern 属性在部分引擎的 v-flag 下会抛 SyntaxError 且静默失效)
321
+ if (!/^[a-z][a-z0-9.-]{0,31}$/.test(id)) {
322
+ showErr({ code: 'MEMBER_INVALID', message: 'id 必填且须匹配 ^[a-z][a-z0-9.-]{0,31}$(小写字母开头,可含小写字母/数字/点/连字符)' });
323
+ return;
324
+ }
325
+ }
326
+ if (isEdit) {
327
+ await apiPatch(`/api/members/${encodeURIComponent(member.id)}`, {
328
+ name, role, giteaLogin: giteaLogin || null,
329
+ enabled: sw ? sw.getAttribute('aria-pressed') === 'true' : true
330
+ });
331
+ toast('成员已更新', 'success');
332
+ } else {
333
+ await apiPost('/api/members', { id, name, role, giteaLogin: giteaLogin || null });
334
+ toast('成员已新增', 'success');
335
+ }
336
+ m.close();
337
+ refresh();
338
+ } catch (err) {
339
+ showErr(err); // 400 MEMBER_INVALID / 409 MEMBER_EXISTS 等错误码+文案直出
340
+ toast(err.message);
341
+ }
342
+ });
343
+ });
344
+ }
@@ -0,0 +1,103 @@
1
+ // v2.9.26 Onboarding 向导(开源 star 生死线:30 秒看到自己的数据)。
2
+ // 首次访问(localStorage fde-onboard-done 缺失)自动弹一次;侧栏「设置」入口可重开(onboardingRedo 事件)。
3
+ // 三步:①欢迎与定位一句话 ②本机 agent 源检测(GET /api/agent-activity 的 sources[],逐源点亮)+
4
+ // Gitea 连接态(GET /api/overview.gitea.ok)③下一步引导(看板建任务 / 智能体页看会话)。
5
+ // 全只读:不写任何 config/data,唯一持久化=localStorage 已读标记。
6
+ import { apiGet } from '../api.js';
7
+ import { esc, icon, openModal } from '../ui.js';
8
+
9
+ const AGENT_LABEL = { zcode: 'ZCode', claude: 'Claude Code', dsh: 'DSH', workbuddy: 'WorkBuddy', codex: 'Codex / ChatGPT 桌面', opencode: 'OpenCode' };
10
+ const DONE_KEY = 'fde-onboard-done';
11
+
12
+ export function shouldShowOnboarding() {
13
+ try {
14
+ return localStorage.getItem(DONE_KEY) !== '1';
15
+ } catch (e) {
16
+ return false; // 无 localStorage 环境不骚扰
17
+ }
18
+ }
19
+
20
+ export function openOnboarding() {
21
+ const box = document.createElement('div');
22
+ box.className = 'ob-box';
23
+ box.innerHTML = `
24
+ <div class="ob-step" data-step="1">
25
+ <div class="ob-hero">${icon('bot')}</div>
26
+ <h3>你的本地 AI agent 团队,现在有了驾驶舱</h3>
27
+ <p class="muted">看见(谁在干活)→ 理解(干了什么)→ 归因(成果挂任务)→ 验收(时间轴留痕)。<br>
28
+ 所有数据只读自本机,不上传任何字节。</p>
29
+ <p class="muted small">检测到的 agent 会话库与团队 Git 动态会自动出现在对应页面,无需任何配置。</p>
30
+ </div>
31
+ <div class="ob-step" data-step="2" hidden>
32
+ <h3>正在扫描本机 agent……</h3>
33
+ <div class="ob-scan" id="ob-scan"><div class="loading">检测中…</div></div>
34
+ </div>
35
+ <div class="ob-step" data-step="3" hidden>
36
+ <h3>一切就绪 🎉</h3>
37
+ <p class="muted">三条最常用的路:</p>
38
+ <div class="ob-next">
39
+ <button type="button" class="btn" data-nav="#/board">${icon('kanban')}看板:建任务、验收成果</button>
40
+ <button type="button" class="btn" data-nav="#/agents">${icon('bot')}智能体:谁在干什么</button>
41
+ <button type="button" class="btn" data-nav="#/overview">${icon('layout-dashboard')}总览:活跃热力图与报告</button>
42
+ </div>
43
+ <p class="muted small">想让 agent 的提交自动挂到任务?看 <b>docs/ATTRIBUTION.md</b> 三条约定。</p>
44
+ </div>
45
+ <div class="ob-foot">
46
+ <button type="button" class="btn ghost" id="ob-skip">跳过</button>
47
+ <span class="spacer"></span>
48
+ <button type="button" class="btn" id="ob-next">下一步</button>
49
+ </div>`;
50
+ const m = openModal({ title: '欢迎使用 FDE 指挥台', body: box, onClose: markDone });
51
+ const steps = [...box.querySelectorAll('.ob-step')];
52
+ let cur = 0;
53
+
54
+ function markDone() {
55
+ try { localStorage.setItem(DONE_KEY, '1'); } catch (e) { /* 无 localStorage 忽略 */ }
56
+ }
57
+
58
+ function show(i) {
59
+ cur = i;
60
+ steps.forEach((s, k) => { s.hidden = k !== i; });
61
+ const next = box.querySelector('#ob-next');
62
+ next.textContent = i === 2 ? '完成' : '下一步';
63
+ next.hidden = i === 1; // 扫描步无按钮
64
+ box.querySelector('#ob-skip').textContent = i === 2 ? '关闭' : '跳过';
65
+ if (i === 1) scan();
66
+ }
67
+
68
+ async function scan() {
69
+ const host = box.querySelector('#ob-scan');
70
+ let sources = [];
71
+ let giteaOk = null;
72
+ try {
73
+ const aa = await apiGet('/api/agent-activity');
74
+ sources = Array.isArray(aa.sources) ? aa.sources : [];
75
+ } catch (e) { /* 检测失败按全未知渲染 */ }
76
+ try {
77
+ const ov = await apiGet('/api/overview');
78
+ giteaOk = !!(ov && ov.gitea && ov.gitea.ok);
79
+ } catch (e) { giteaOk = null; }
80
+ const okCount = sources.filter((s) => s && s.ok === true).length;
81
+ const row = (label, ok, detail) => `
82
+ <div class="ob-src">
83
+ <span class="dot ${ok === true ? '' : ok === false ? 'err' : ''}"></span>
84
+ <span class="ob-src-name">${esc(label)}</span>
85
+ <span class="muted small">${esc(detail || '')}</span>
86
+ </div>`;
87
+ host.innerHTML =
88
+ sources.map((s) => row(AGENT_LABEL[s.id] || s.id, s.ok, s.ok === true ? `${s.detail || '已检测到'}——点智能体页看它的会话` : s.ok === false ? '已安装但读不到会话(路径可配)' : '未检测到(装了就会亮)')).join('') +
89
+ row('团队 Git(Gitea)', giteaOk, giteaOk === true ? '已连接,提交会自动归因到任务' : giteaOk === false ? '未连接——设置页配置组织后生效' : '状态未知');
90
+ host.insertAdjacentHTML('beforeend',
91
+ `<p class="muted small">检测到 ${okCount}/${sources.length} 个 agent 源。没装的不会报错,装了自动亮。</p>`);
92
+ }
93
+
94
+ box.querySelector('#ob-next').addEventListener('click', () => {
95
+ if (cur >= 2) { markDone(); m.close(); return; }
96
+ show(cur + 1);
97
+ });
98
+ box.querySelector('#ob-skip').addEventListener('click', () => { markDone(); m.close(); });
99
+ box.querySelectorAll('[data-nav]').forEach((b) => {
100
+ b.addEventListener('click', () => { markDone(); m.close(); location.hash = b.dataset.nav; });
101
+ });
102
+ show(0);
103
+ }