@suifei/dsh-ai-team 0.3.18 → 0.3.19

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.19 — 2026-11-10
+
+- 新增 `team askHuman`：Agent 必须把每个 Human 决策问题、选项、推荐项逐条提交；
+- 收件箱决策项直接展开问题/选项/推荐，不再要求翻报告或 Thread；
+- 顶部增加「待你处理 · N」一键入口；
+- Thread 中 @Human 的普通消息仍自动生成决策项。
+
 ## 0.3.18 — 2026-11-10
 
 - 打开 Project 时回填已有 Thread 中对 Human 的拍板请求到收件箱；

package/README.md

@@ -87,7 +87,7 @@ dsh --profile ai-team --no-open --port 33271
 - **主对话**：Human 的一句话进入 Main stream，Project owner 拆 Task；顶部「团队动态」直接显示正在推进的 Task 和运行中的成员，点击 Task 可打开 Thread。
 - **看板**：四列；进行中的卡片显示 accountable owner 与执行者；数量只统计 active Task。
 - **态势**：四象限——需要你、团队在做、等待受阻、最近完成。点击条目打开对应 Task 的 Thread。
-- **收件箱**：跨 Project 聚合；失败、需要你决定、关注 Task 的完成报告，以及 Agent 在 Thread 里明确请你拍板的消息都在这里。
+- **收件箱**：跨 Project 聚合；顶部「待你处理 · N」一键进入；决策项直接展开全部问题与选项，不用再翻 Thread/报告。
 - **直接对话**：点击成员名字直接打开该 Agent 的 DSH 原生 Session；没有 session 会先激活；打不开时落到成员资料，资料里有「直接对话」按钮。
 - **成员任务**：成员资料里点「他的任务」，查看他 owner/assignee 的 Task。
 - **成员资料**：点「⋯」改名、职责、personality、provider/model、运行配方、notes、skills、re-distill、离队/人才库。
@@ -102,7 +102,7 @@ dsh --profile ai-team --no-open --port 33271
 | Task | 唯一 accountable owner；pending / in_progress / pending_acceptance / done / cancelled |
 | Thread | append-only；回复带 `baseSeq`，旧基线会被拒并说明变化 |
 | 验收 | maker 不能验收；QA 硬门禁；`qaChecklist` 逐项通过 |
-| 收件箱 | Human/Agent 各自拉取；跨 Project 聚合；Thread 中提到 Human 会自动生成决策项 |
+| 收件箱 | Human/Agent 各自拉取；跨 Project 聚合；顶部待办入口；`askHuman` 结构化问题与选项直接展开 |
 | 关注 | 关注 Task；完成后收到 `followed_task_update` |
 | 默认成员 | 新 Project 初始化墨渊 / 青岚 / 白砚；可改名、改职责、改个性、改模型 |
 | 成员 | 持久 session；点击名字直接对话；「⋯」资料里有任务视图与直接对话 |

package/client.js

@@ -277,6 +277,7 @@ window.__ModuleLoader__.load({
 			discussSent: '已发送给 Project owner。',
 			taskSent: '已创建 Task。',
 			sendFailed: '发送失败：{message}',
+			pendingHuman: '待你处理',
 			inboxUnread: '收件箱，{n} 条未读',
 			dismiss: '关闭提示',
 			retry: '重试',
@@ -578,6 +579,7 @@ window.__ModuleLoader__.load({
 			discussSent: 'Sent to the Project owner.',
 			taskSent: 'Task created.',
 			sendFailed: 'Send failed: {message}',
+			pendingHuman: 'Needs you',
 			inboxUnread: 'Inbox, {n} unread',
 			dismiss: 'Dismiss',
 			retry: 'Retry',
@@ -904,6 +906,7 @@ window.__ModuleLoader__.load({
 			.at-top { height: 40px; flex: 0 0 auto; display: flex; align-items: center; gap: 8px; min-width: 0; padding: 0 12px; border-bottom: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-1); }
 			.at-brand { color: var(--dsw-alias-label-primary); font-size: 12px; font-weight: 500; white-space: nowrap; }
 			.at-spike { display: inline-flex; align-items: center; height: 20px; padding: 0 6px; border: 1px solid var(--dsw-alias-border-l3); border-radius: var(--dsw-radius-xs); color: var(--dsw-alias-label-tertiary); font-size: 10px; line-height: 16px; letter-spacing: .04em; text-transform: uppercase; white-space: nowrap; }
+			.at-pending { margin-left: auto; height: 24px; padding: 0 8px; border: 1px solid var(--dsw-alias-state-warning-primary); border-radius: var(--dsw-radius-sm); background: var(--dsw-alias-bg-base); color: var(--dsw-alias-state-warning-primary); font: inherit; font-size: 11px; line-height: 16px; cursor: pointer; white-space: nowrap; }
 			.at-topproject { margin-left: auto; min-width: 0; color: var(--dsw-alias-label-tertiary); font-size: 11px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 			.at-mobile { display: none; position: relative; min-width: 0; }
 			.at-mobilesummary { display: inline-flex; align-items: center; gap: 6px; min-height: 28px; padding: 0 8px; border: 1px solid var(--dsw-alias-border-l2); border-radius: var(--dsw-radius-sm); color: var(--dsw-alias-label-secondary); font-size: 11px; cursor: pointer; list-style: none; }
@@ -947,6 +950,11 @@ window.__ModuleLoader__.load({
 			.at-inboxitem { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; padding: 11px 13px; border: 1px solid var(--dsw-alias-border-l2); border-radius: var(--dsw-radius-sm); background: var(--dsw-alias-bg-layer-2); }
 			.at-inboxitem.at-inboxdone { opacity: 0.62; }
 			.at-inboxbody { min-width: 0; flex: 1; }
+			.at-inboxquestions { margin: 6px 0 2px; padding-left: 20px; color: var(--dsw-alias-label-secondary); font-size: 12px; line-height: 19px; }
+			.at-inboxquestions li { margin: 3px 0; }
+			.at-inboxquestion { display: block; color: var(--dsw-alias-label-primary); }
+			.at-inboxoptions { display: block; color: var(--dsw-alias-label-tertiary); font-size: 11px; }
+			.at-inboxrecommend { display: block; color: var(--dsw-alias-state-business-primary); font-size: 11px; }
 			.at-inboxtitle { color: var(--dsw-alias-label-primary); font-size: 13px; line-height: 20px; }
 			.at-inboxmeta { color: var(--dsw-alias-label-tertiary); font-size: 11px; line-height: 16px; }
 			.at-inboxstate { color: var(--dsw-alias-label-caption); font-size: 10.5px; }
@@ -2950,10 +2958,18 @@ window.__ModuleLoader__.load({
 								h('div', { className: 'at-inboxbody' },
 									h('div', { className: 'at-inboxtitle' },
 										item.type === 'decision_required'
-											? t('inboxDecisionTitle')
+											? (item.ref?.title || t('inboxDecisionTitle'))
 											: item.type === 'followed_task_update'
 												? tf(t, 'inboxCompletedTitle', { title: item.ref?.title ?? item.ref?.taskId ?? '' })
 												: t('inboxItemTitle')),
+									Array.isArray(item.ref?.questions) && item.ref.questions.length
+										? h('ol', { className: 'at-inboxquestions' }, item.ref.questions.map((question, index) => h('li', { key: question.id ?? index },
+											h('span', { className: 'at-inboxquestion' }, question.text),
+											Array.isArray(question.options) && question.options.length
+												? h('span', { className: 'at-inboxoptions' }, question.options.join(' / '))
+												: null,
+											question.recommendation ? h('span', { className: 'at-inboxrecommend' }, '推荐：' + question.recommendation) : null)))
+										: null,
 									h('div', { className: 'at-inboxmeta' },
 										item.projectName ? item.projectName + ' · ' : '',
 										item.ref?.category ? item.ref.category + ' · ' : '',
@@ -3024,6 +3040,7 @@ window.__ModuleLoader__.load({
 				h('div', { className: 'at-top' },
 					h('span', { className: 'at-brand' }, t('panel')),
 					h('span', { className: 'at-spike', title: t('spikeTitle') }, t('spike')),
+					inboxUnread > 0 ? h('button', { className: 'at-pending', type: 'button', onClick: switchInbox }, t('pendingHuman') + ' · ' + unread) : null,
 					h('details', { className: 'at-mobile', ref: mobileRef },
 						h('summary', { className: 'at-mobilesummary', 'aria-label': t('menuAria') }, h(Ico, { name: 'menu', size: 14 }), h('span', null, t('menu'))),
 						h('div', { className: 'at-mobilepop' }, h(LeftPanel, leftProps))),

package/index.js

@@ -34,7 +34,7 @@ export const name = 'ai-team';
 /** The workbench only makes sense where the Web carrier exists. */
 export const inject = ['webServer', 'permissionPresets', 'sandboxPolicy'];
 
-const VERSION = '0.3.18';
+const VERSION = '0.3.19';
 const PROJECT_ID = 'prj_main';
 const HUMAN_ID = 'mem_human';
 

package/lib/host/member-tools.js

@@ -7,7 +7,7 @@
  */
 import { taskCard } from './views.js';
 
-const ACTIONS = ['tasks', 'members', 'inbox', 'recall', 'create', 'member', 'evolve', 'distill', 'note', 'skill', 'claim', 'submit', 'thread', 'reply', 'accept', 'requestChanges'];
+const ACTIONS = ['tasks', 'members', 'inbox', 'recall', 'create', 'askHuman', 'member', 'evolve', 'distill', 'note', 'skill', 'claim', 'submit', 'thread', 'reply', 'accept', 'requestChanges'];
 
 function failure(error) {
 	return {
@@ -53,7 +53,7 @@ function rosterText(state) {
 export function createTeamTool(options) {
 	return {
 		name: 'team',
-		description: 'Read and act on the AI Team board. The Project owner can create tasks with action=create and must set resultDefinition and ownerId. Use members for the exact roster id/name/role; use tasks for ids/revisions. Use recall to search your notes/skills and your past Tasks/Threads. Use member to inspect a colleague, evolve for only your own personality, distill (Project owner/Human) or note/skill for durable memory. Claim before working; read a Thread before replying; submit evidence before acceptance.',
+		description: 'Read and act on the AI Team board. The Project owner can create tasks with action=create and must set resultDefinition and ownerId. Use members for the exact roster id/name/role; use tasks for ids/revisions. When Human must decide something, call askHuman with every question and options—do not bury questions in a report. Use recall to search your notes/skills and your past Tasks/Threads. Claim before working; read a Thread before replying; submit evidence before acceptance.',
 		parameters: {
 			type: 'object',
 			properties: {
@@ -72,6 +72,20 @@ export function createTeamTool(options) {
 				assigneeId: { type: 'string', description: 'Optional assignee id from members for create.' },
 				qaRequired: { type: 'boolean', description: 'Require a QA member to accept this task.' },
 				qaChecklist: { type: 'array', items: { type: 'string' }, description: 'QA checklist items; all must pass before acceptance.' },
+				questions: {
+					type: 'array',
+					description: 'Human decision questions for askHuman; include every question instead of pointing at a report.',
+					items: {
+						type: 'object',
+						properties: {
+							text: { type: 'string', description: 'The question.' },
+							options: { type: 'array', items: { type: 'string' }, description: 'Optional answer choices.' },
+							recommendation: { type: 'string', description: 'Optional recommended answer.' },
+							blocking: { type: 'string', description: 'What this decision blocks.' },
+						},
+						required: ['text'],
+					},
+				},
 				personality: { type: 'string', description: 'New working personality for evolve/distill.' },
 				reason: { type: 'string', description: 'Why the personality changed.' },
 				memberId: { type: 'string', description: 'Target member for member/distill/note/skill.' },
@@ -216,6 +230,18 @@ export function createTeamTool(options) {
 					});
 					return { ok: true, task: taskCard(options.getState(), result.task) };
 				}
+				if (args.action === 'askHuman') {
+					if (!Array.isArray(args.questions) || args.questions.length === 0) {
+						return failure({ code: 'E_INVALID_ARGUMENT', message: 'questions is required; list every question Human must answer' });
+					}
+					const result = await command('decision.request', {
+						title: typeof args.title === 'string' && args.title.trim() !== '' ? args.title.trim() : '需要你决策',
+						taskId: typeof args.taskId === 'string' && args.taskId !== '' ? args.taskId : null,
+						questions: args.questions,
+						source: 'team',
+					});
+					return { ok: true, item: result.item, duplicate: result.duplicate === true };
+				}
 				if (args.action === 'inbox') {
 					const items = Object.values(state.inbox ?? {})
 						.filter((item) => item.memberId === member.id && !['resolved', 'dismissed', 'superseded'].includes(item.state));

package/lib/host/service.js

@@ -232,6 +232,7 @@ export class TeamService {
 			case 'task.follow': return await this.follow(command, payload);
 			case 'thread.post': return await this.postThread(command, payload);
 			case 'inbox.ack': return await this.ack(command, payload);
+			case 'decision.request': return await this.requestDecision(command, payload);
 			default: fail(ERRORS.INVALID_ARGUMENT, `unknown command: ${String(command.type)}`);
 		}
 	}
@@ -889,6 +890,59 @@ export class TeamService {
 		return { thread: outcome.thread, entry: outcome.entry };
 	}
 
+	/** Surface an explicit Human decision request with all questions inline. */
+	async requestDecision(command, payload) {
+		const humanId = this.state.humanMemberId
+			?? Object.values(this.state.members ?? {}).find((member) => member.kind === 'human')?.id
+			?? null;
+		if (humanId === null) fail(ERRORS.NOT_FOUND, 'Human member not found');
+		const raw = Array.isArray(payload.questions) ? payload.questions : [];
+		if (raw.length === 0 || raw.length > 20) fail(ERRORS.INVALID_ARGUMENT, 'questions must contain 1..20 items');
+		const questions = raw.map((question, index) => {
+			if (typeof question === 'string') return { id: `q${index + 1}`, text: question.trim() };
+			if (question === null || typeof question !== 'object') fail(ERRORS.INVALID_ARGUMENT, `questions[${index}] must be a string or object`);
+			const text = typeof question.text === 'string' ? question.text.trim() : '';
+			if (text === '') fail(ERRORS.INVALID_ARGUMENT, `questions[${index}].text is required`);
+			const options = Array.isArray(question.options) ? question.options.filter((option) => typeof option === 'string' && option.trim() !== '').slice(0, 12) : [];
+			return {
+				id: typeof question.id === 'string' && question.id !== '' ? question.id : `q${index + 1}`,
+				text,
+				...(options.length ? { options } : {}),
+				...(typeof question.recommendation === 'string' && question.recommendation !== '' ? { recommendation: question.recommendation } : {}),
+				...(typeof question.blocking === 'string' && question.blocking !== '' ? { blocking: question.blocking } : {}),
+			};
+		});
+		const title = typeof payload.title === 'string' && payload.title.trim() !== '' ? payload.title.trim() : '需要你决策';
+		const taskId = typeof payload.taskId === 'string' ? payload.taskId : null;
+		const duplicate = Object.values(this.state.inbox ?? {}).find((item) =>
+			item.memberId === humanId
+			&& item.type === 'decision_required'
+			&& item.ref?.title === title
+			&& item.ref?.taskId === taskId
+			&& !['resolved', 'dismissed', 'superseded'].includes(item.state));
+		if (duplicate !== undefined) return { item: duplicate, duplicate: true };
+		const item = createInboxItem({
+			memberId: humanId,
+			type: 'decision_required',
+			ref: {
+				taskId,
+				title,
+				questions,
+				...(typeof payload.source === 'string' && payload.source !== '' ? { source: payload.source } : {}),
+			},
+			requiresDecision: true,
+		}, { at: this.now() });
+		await this.ledger.append({
+			type: 'inbox/item-created',
+			payload: { itemId: item.id, ...item },
+			actor: command.actor,
+			correlationId: command.correlationId,
+			projectId: command.projectId,
+			at: this.now(),
+		});
+		return { item, duplicate: false };
+	}
+
 	async ack(command, payload) {
 		const state = this.state;
 		const item = state.inbox?.[payload.itemId];

package/lib/host/waker.js

@@ -165,7 +165,7 @@ export function planWakes(state, result, actor = {}) {
 			null,
 			'human_message',
 			`human_message:${event.seq ?? event.payload?.seq}`,
-			`你是 Project owner。Human 在 Main stream 说：“${body}”。本轮必须先用 team action=members 查看成员，再用 action=create 创建至少一个 Task；ownerId 必须使用成员 id，写明可验证的 resultDefinition。可用成员：${roster || '无'}。如果需求很大或外部链接只是参考，先创建“调研/澄清/拆解”Task，不要直接开始实现；如果确实无法创建，必须明确说明原因。resultDefinition 只写验收标准，不要写“等待 Human 验收”；不要只读文件或只回一段话结束。`,
+			`你是 Project owner。Human 在 Main stream 说：“${body}”。本轮必须先用 team action=members 查看成员，再用 action=create 创建至少一个 Task；ownerId 必须使用成员 id，写明可验证的 resultDefinition。可用成员：${roster || '无'}。如果需求很大或外部链接只是参考，先创建“调研/澄清/拆解”Task，不要直接开始实现；如果确实无法创建，必须明确说明原因。需要 Human 拍板时，必须调用 team action=askHuman，把每个问题和选项逐条放进 questions，不要只写“见报告/§6/已提交 Human”。resultDefinition 只写验收标准，不要写“等待 Human 验收”；不要只读文件或只回一段话结束。`,
 		);
 	}
 	if (event?.type === 'inbox/item-created') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suifei/dsh-ai-team",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "type": "module",
   "description": "文渊阁 (Wenyuan Pavilion) — AI Team mode for DeepSeek Harness: concurrent projects, owned tasks, threads, inbox and an append-only team ledger",
   "license": "MIT",