npm - @harmonyos-arkts/d2h - Versions diffs - 0.1.20 → 0.1.21 - Mend

@harmonyos-arkts/d2h 0.1.20 → 0.1.21

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 (151) hide show

package/opencode/interactive-tools/package.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "name": "@harmonyos-arkts/d2h-interactions-mvp",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "./server.mjs",
+  "exports": {
+    "./server": "./server.mjs",
+    "./tui": "./tui.tsx"
+  },
+  "engines": {
+    "opencode": ">=1.19.3 <2",
+    "node": ">=22.5 <25"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "1.19.3",
+    "solid-js": "^1.9.12"
+  },
+  "devDependencies": {
+    "@opentui/core": "0.4.5",
+    "@opentui/solid": "0.4.5"
+  }
+}

package/opencode/interactive-tools/panel.ts ADDED Viewed

@@ -0,0 +1,40 @@
+/** Shared trusted UI: VS Code Webview and the local review preview use the same renderer. */
+export function interactionHtml(nonce: string): string {
+  return `<!doctype html>
+<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; script-src 'nonce-${nonce}'; connect-src 'self'">
+<title>d2h · 迁移工作台</title><style>
+:root{color-scheme:dark;--bg:var(--vscode-editor-background,#14171c);--fg:var(--vscode-editor-foreground,#e9edf3);--muted:var(--vscode-descriptionForeground,#a7b0c0);--line:var(--vscode-panel-border,#313844);--accent:var(--vscode-button-background,#346dff);--card:var(--vscode-sideBar-background,#1b2028)}
+*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--fg);font:14px/1.65 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}button,input,textarea{font:inherit}button{cursor:pointer}button:disabled{opacity:.45;cursor:default}button:focus-visible,input:focus-visible,textarea:focus-visible{outline:2px solid var(--accent);outline-offset:3px}header{padding:22px 30px;border-bottom:1px solid var(--line);display:flex;align-items:center;gap:14px;flex-wrap:wrap}.brand{font-size:23px;font-weight:650}.badge{font-size:12px;padding:3px 10px;background:#29436c;border-radius:20px}.layout{display:grid;grid-template-columns:220px minmax(0,1fr);min-height:620px}aside{padding:28px 18px;background:var(--card);border-right:1px solid var(--line)}.step{display:block;border:0;background:transparent;color:var(--muted);width:100%;text-align:left;padding:14px 12px;border-radius:8px;margin-bottom:6px}.step.active{background:var(--accent);color:white}.number{display:inline-flex;width:25px;height:25px;align-items:center;justify-content:center;margin-right:8px;border:1px solid currentColor;border-radius:50%}main{padding:28px 36px;max-width:1100px;width:100%;margin:auto}h1{font-size:27px;line-height:1.3;margin:8px 0 12px}h2{font-size:16px;margin:0 0 10px}.muted{color:var(--muted)}.eyebrow{font-size:12px;letter-spacing:1.5px;color:var(--muted)}.panel{margin:22px 0;padding:20px;background:var(--card);border:1px solid var(--line);border-radius:10px}.check{display:grid;grid-template-columns:1fr auto;gap:6px;padding:13px 0;border-bottom:1px solid var(--line)}.check:last-child{border-bottom:0}.detail{font-size:13px;color:var(--muted)}.choice{display:flex;gap:12px;padding:16px 0;border-bottom:1px solid var(--line);align-items:flex-start}.choice:last-child{border-bottom:0}.choice input{margin-top:6px;accent-color:var(--accent);width:17px;height:17px}.choice strong{display:block}.notice{padding:12px 15px;border-left:3px solid #e2ac5b;background:var(--card);margin:18px 0}.actions{display:flex;align-items:center;gap:12px;flex-wrap:wrap;padding-top:18px;border-top:1px solid var(--line)}button.primary{background:var(--accent);color:#fff;border:0;border-radius:7px;padding:11px 22px}.secondary{background:transparent;color:var(--fg);border:1px solid var(--line);border-radius:7px;padding:10px 17px}textarea{width:100%;min-height:90px;background:var(--bg);color:var(--fg);border:1px solid var(--line);border-radius:7px;padding:12px;resize:vertical}.binding{font-size:12px;overflow-wrap:anywhere}.status{margin-left:auto}.good{color:#87d9b0}pre{white-space:pre-wrap;overflow-wrap:anywhere;font:inherit}#error{color:#ffb1a8;min-height:24px}.empty{padding:60px 0}.footer{font-size:12px;margin-top:20px;color:var(--muted)}@media(max-width:650px){.layout{grid-template-columns:1fr}aside{display:flex;flex-wrap:wrap;padding:10px;border-right:0}.step{width:auto;padding:8px}.number{display:none}main{padding:20px}header{padding:16px}.brand{font-size:20px}}
+</style></head><body><header><span class="brand">d2h</span><span>迁移工作台</span><span class="badge" id="mode">交互式工具 MVP</span><select id="session" aria-label="原会话" style="max-width:320px;background:var(--card);color:var(--fg);padding:6px;border:1px solid var(--line)"></select><span class="status muted" id="state">正在连接宿主</span></header>
+<div class="layout"><aside id="steps" aria-label="迁移交互步骤"></aside><main><div class="eyebrow">ANDROID → HARMONYOS</div><div id="content"></div><div id="error" role="alert"></div></main></div>
+<script nonce="${nonce}">
+(()=>{
+const labels={environment:'确认环境',architecture:'选择架构',scope:'选择实施范围',report:'查看报告'};
+const $=id=>document.getElementById(id);let snapshot=[],allItems=[],sessionId='',currentId=new URLSearchParams(location.search).get('request')||'',sending=false,lastSnapshot='',lastPending='';
+const drafts={};let vscode;try{vscode=typeof acquireVsCodeApi==='function'?acquireVsCodeApi():undefined}catch{}
+if(vscode){const state=vscode.getState();Object.assign(drafts,state?.drafts||{});sessionId=state?.sessionId||''}
+const esc=value=>String(value??'').replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
+function send(message){if(vscode){vscode.postMessage(message)}else{fetch('action',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(message)}).then(async r=>{const data=await r.json();if(!r.ok)throw Error(data.error||'提交失败');if(data.error)throw Error(data.error);}).catch(e=>{sending=false;$('error').textContent=e.message;render()})}}
+function render(){
+const item=snapshot.find(x=>x.request.id===currentId)||snapshot.find(x=>x.status==='等待确认')||snapshot.at(-1);if(item)currentId=item.request.id;
+$('steps').innerHTML=Object.entries(labels).map(([step,label],i)=>{const row=snapshot.filter(x=>x.request.step===step).at(-1);return '<button class="step '+(item?.request.step===step?'active':'')+'" data-step="'+step+'" '+(!row?'disabled':'')+'><span class="number">'+(i+1)+'</span>'+label+'<div class="detail">'+esc(row?.status||'尚未请求')+'</div></button>'}).join('');
+if(!item){$('state').textContent='等待 Agent 请求';$('content').innerHTML='<div class="empty"><h1>由对话进入工作台</h1><p class="muted">Agent 调用 d2h_interact 后，这里展示环境、架构、范围或报告。提交结果返回原工具，无需手动输入“继续”。</p><button class="secondary" id="refresh">刷新请求</button></div>';return}
+const r=item.request,done=item.status!=='等待确认';const saved=drafts[r.id]||{selected:r.step==='architecture'?r.workflow.architectures.filter(c=>c.selected).slice(0,1).map(c=>c.id):r.step==='scope'?r.workflow.scopes.filter(c=>c.selected).map(c=>c.id):[],reason:''};drafts[r.id]=saved;
+$('mode').textContent=r.workflow.demo?'演示数据 · 不执行迁移':'交互式工具';$('state').textContent=item.status;
+let body='';if(r.step==='environment'){body='<div class="panel">'+r.workflow.checks.map(c=>'<div class="check"><strong>'+esc(c.label)+'</strong><span class="'+(c.status==='ready'?'good':'muted')+'">'+esc({ready:'已检查',missing:'缺失',unverified:'待验证'}[c.status])+'</span><div class="detail">'+esc(c.detail)+'</div></div>').join('')+'</div>'}
+if(r.step==='architecture'||r.step==='scope'){const choices=r.step==='architecture'?r.workflow.architectures:r.workflow.scopes;body='<div class="panel">'+choices.map(c=>'<label class="choice"><input name="choice" type="'+(r.step==='architecture'?'radio':'checkbox')+'" value="'+esc(c.id)+'" '+(saved.selected.includes(c.id)?'checked':'')+' '+(done?'disabled':'')+'><span><strong>'+esc(c.label)+'</strong><span class="detail">'+esc(c.detail)+'</span></span></label>').join('')+'</div>'}
+if(r.step==='report'){body='<div class="panel"><pre>'+esc(r.workflow.report)+'</pre></div>'}
+const blocked=r.step==='environment'&&r.workflow.checks.some(c=>c.status!=='ready');
+$('content').innerHTML='<h1>'+esc(labels[r.step])+'</h1><p class="muted">'+esc(r.workflow.title)+'</p><div class="binding muted">原会话 '+esc(r.sessionId)+' · 输入版本 '+esc(r.revision.slice(0,12))+'</div>'+body+(r.step==='scope'?'<div class="notice">提交的是范围草稿。主 Agent 仍需校验依赖、修订计划并 reconcile；不会直接修改计划或启动开发。</div>':'')+(r.step==='report'?'<div class="notice">确认结束本次交互，不表示构建、设备测试或迁移验收通过。</div>':'')+'<label for="reason">'+(r.step==='scope'?'选择原因（必填）':'补充说明（可选）')+'</label><textarea id="reason" '+(done?'disabled':'')+' placeholder="保留你的选择、约束和理由">'+esc(saved.reason)+'</textarea>'+(blocked?'<p class="notice">仍有缺失或未验证项，不能确认通过。可取消后更新检查报告，再发起确认。</p>':'')+'<div class="actions"><button class="primary" id="submit" '+(done||blocked||sending?'disabled':'')+'>'+(done?esc(item.status):sending?'正在提交…':r.step==='report'?'确认并返回对话':'提交并继续原会话')+'</button><button class="secondary" id="cancel" '+(done||sending?'disabled':'')+'>取消本次交互</button></div><div class="footer">关闭窗口可稍后重开；取消才会返回取消结果。原工具取消或超时后，本请求失效。</div>';
+}
+function save(){const r=snapshot.find(x=>x.request.id===currentId)?.request;if(!r)return;drafts[r.id]={selected:[...document.querySelectorAll('input[name="choice"]:checked')].map(n=>n.value),reason:$('reason')?.value||''};vscode?.setState({drafts,sessionId})}
+function bindSession(){const ids=[...new Set(allItems.map(x=>x.request.sessionId))];if(!ids.includes(sessionId))sessionId=allItems.find(x=>x.status==='等待确认')?.request.sessionId||ids.at(-1)||'';snapshot=allItems.filter(x=>x.request.sessionId===sessionId);$('session').innerHTML=ids.map(id=>'<option value="'+esc(id)+'" '+(id===sessionId?'selected':'')+'>'+esc(id)+'</option>').join('')}
+$('session').addEventListener('change',()=>{save();sessionId=$('session').value;currentId='';lastPending='';bindSession();render();vscode?.setState({drafts,sessionId})});
+document.addEventListener('input',save);document.addEventListener('change',save);
+document.addEventListener('click',e=>{const b=e.target.closest('button');if(!b||b.disabled)return;if(b.dataset.step){save();currentId=snapshot.filter(x=>x.request.step===b.dataset.step).at(-1)?.request.id;render();return}if(b.id==='refresh'){send({type:'ready'});return}if(['submit','cancel'].includes(b.id)){save();const item=snapshot.find(x=>x.request.id===currentId),r=item.request,d=drafts[r.id];if(b.id==='submit'&&r.step==='scope'&&!d.reason.trim()){$('error').textContent='请填写选择原因';return}sending=true;$('error').textContent='';send({type:'submit',id:r.id,revision:r.revision,action:b.id==='cancel'?'cancel':'accept',selected:b.id==='cancel'?[]:d.selected,reason:d.reason});render()}});
+function receive(data){if(data.type==='snapshot'){const signature=JSON.stringify(data.items);if(signature===lastSnapshot)return;lastSnapshot=signature;allItems=data.items;bindSession();const next=(snapshot.find(x=>x.request.id===currentId&&x.status==='等待确认')||snapshot.find(x=>x.status==='等待确认'))?.request.id;if(next&&next!==lastPending){currentId=next;lastPending=next}sending=false;render()}if(data.type==='error'){sending=false;render();$('error').textContent=data.message}}
+window.addEventListener('message',e=>receive(e.data));if(!vscode){async function poll(){try{const r=await fetch('snapshot');receive(await r.json())}catch(e){$('state').textContent='连接中断'}setTimeout(poll,700)}poll()}else{send({type:'ready'})}render();
+})();
+</script></body></html>`;
+}

package/opencode/interactive-tools/prepare-demo.mjs ADDED Viewed

@@ -0,0 +1,17 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { demoWorkflow } from '../../dist/opencode/interactive-tools/demo-workflow.js';
+const root = path.dirname(fileURLToPath(import.meta.url));
+const project = path.resolve(process.argv[2] || path.join(root, '../../../validation/interactive-tools-mvp', `opencode-${Date.now()}`));
+const config = path.join(project, '.opencode');
+fs.mkdirSync(config, { recursive: true });
+for (const [file, data] of [
+  [path.join(config, 'opencode.json'), { $schema: 'https://opencode.ai/config.json', plugin: [pathToFileURL(path.join(root, 'server.mjs')).href] }],
+  [path.join(config, 'tui.json'), { $schema: 'https://opencode.ai/tui.json', plugin: [path.join(root, 'tui.tsx')] }],
+  [path.join(project, 'workflow.json'), demoWorkflow],
+]) { fs.writeFileSync(file, JSON.stringify(data, null, 2), { flag: 'wx' }); }
+console.log(project);
+console.log('在这个目录运行 opencode，再输入 /d2h-demo 可体验四步交互（不调用模型）。');
+console.log('真实 Agent 工具调用：d2h_interact({ workflowPath: <workflow.json 绝对路径>, step: environment|architecture|scope|report })');

package/opencode/interactive-tools/prepare-progress-demo.mjs ADDED Viewed

@@ -0,0 +1,13 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+// Development checkout fixture, never used by the real progress reader.
+const root = path.dirname(fileURLToPath(import.meta.url));
+const project = path.resolve(process.argv[2] || path.join(root, '../../../validation/interactive-tools-mvp', `progress-${Date.now()}`));
+execFileSync(process.execPath, [path.join(root, 'prepare-demo.mjs'), project], { stdio: 'ignore' });
+const plan = project + '-migration/.migration/page-specs';
+execFileSync(process.platform === 'win32' ? 'python' : 'python3', [path.join(root, '../../scripts/tests/interactive-progress-fixture.py'), plan], { stdio: 'inherit' });
+fs.writeFileSync(path.join(project, '.opencode/d2h-progress.json'), JSON.stringify({ schema: 'd2h-progress-config/v1', plan: path.join(plan, 'pages.json'), demo: true }, null, 2), { flag: 'wx' });
+console.log(`演示项目：${project}\n启动：opencode "${project}"\n进入后：/d2h-progress-demo\n侧栏隐藏时：/d2h-progress\n预期：Spec 实现 1/3，验收 0/3；全部是演示数据，不调用模型。`);

package/opencode/interactive-tools/progress.ts ADDED Viewed

@@ -0,0 +1,118 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFile } from 'node:child_process';
+import { interactionRoot } from './core.ts';
+type Ratio = { total: number; accepted: number; percent: number | null; unplanned: number };
+export interface DashboardSnapshot {
+  schema: 'd2h-dashboard/v1'; captured_at: string;
+  activity: { label: string };
+  plan: { milestone: string; specs: Array<{ spec_id: string; scope?: string[] }> };
+  execution: { candidate: string | null; tasks: Record<string, { implementation: string }> };
+  derived: {
+    relevant_specs: string[]; running: string[];
+    tasks: Record<string, { accepted: boolean; blocked_by: string[]; external_blockers: string[] }>;
+    validation_debt: { specs: string[] };
+    delivery_progress: { selected: Ratio | null; full: Ratio | null };
+  };
+}
+export interface ProgressSummary {
+  phase: string; milestone: string; total: number; implemented: number; accepted: number;
+  running: string[]; blocked: number; validationDebt: number; selected: Ratio | null; full: Ratio | null;
+}
+export interface ProgressState {
+  status: 'loading' | 'ready' | 'missing' | 'error';
+  snapshot?: DashboardSnapshot; summary?: ProgressSummary; demo?: boolean;
+  checkedAt?: string; error?: string;
+}
+function readJson(file: string): any {
+  const stat = fs.lstatSync(file);
+  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 16 * 1024 * 1024) { throw new Error('进度输入必须为小于 16 MiB 的普通 JSON 文件'); }
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+export function workflowAsset(relative: string): string {
+  for (const prefix of ['../../workflow/', '../../../workflow/']) {
+    const file = fileURLToPath(new URL(prefix + relative, import.meta.url));
+    if (fs.existsSync(file)) { return file; }
+  }
+  throw new Error('未找到 D2H 公共 workflow 工具，请重新安装完整 D2H 包');
+}
+export function summarizeProgress(data: DashboardSnapshot): ProgressSummary {
+  if (data.schema !== 'd2h-dashboard/v1' || !data.activity || !Array.isArray(data.derived?.relevant_specs)
+      || !data.execution?.tasks || !data.derived.tasks || !Array.isArray(data.derived.running)) { throw new Error('无效的 d2h 进度快照'); }
+  const ids = data.derived.relevant_specs;
+  if (new Set(ids).size !== ids.length || ids.some(id => !data.execution.tasks[id] || !data.derived.tasks[id])) { throw new Error('进度 Spec 身份不一致'); }
+  return {
+    phase: data.activity.label, milestone: data.plan.milestone, total: ids.length,
+    implemented: ids.filter(id => data.execution.tasks[id].implementation === 'implemented').length,
+    accepted: ids.filter(id => data.derived.tasks[id].accepted === true).length,
+    running: data.derived.running.map(id => `${id} · ${data.plan.specs.find(spec => spec.spec_id === id)?.scope?.[0] ?? id}`),
+    blocked: ids.filter(id => data.derived.tasks[id].blocked_by.length || data.derived.tasks[id].external_blockers.length).length,
+    validationDebt: data.derived.validation_debt.specs.length,
+    selected: data.derived.delivery_progress.selected, full: data.derived.delivery_progress.full,
+  };
+}
+export async function loadProgress(project: string, signal?: AbortSignal): Promise<ProgressState | undefined> {
+  const root = fs.realpathSync(project);
+  const configFile = path.join(root, '.opencode', 'd2h-progress.json');
+  const configured = fs.existsSync(configFile);
+  const config = configured ? readJson(configFile) : undefined;
+  if (configured && (!config || typeof config !== 'object' || Array.isArray(config)
+      || config.schema !== 'd2h-progress-config/v1' || typeof config.plan !== 'string'
+      || (config.demo !== undefined && typeof config.demo !== 'boolean'))) { throw new Error('无效的 .opencode/d2h-progress.json'); }
+  const candidates = config ? [path.resolve(root, config.plan)] : [
+    path.join(path.dirname(interactionRoot(root)), 'page-specs', 'pages.json'),
+    path.join(root, '.migration', 'page-specs', 'pages.json'),
+  ].filter(file => fs.existsSync(file));
+  if (!candidates.length) { return undefined; }
+  if (candidates.length > 1) { throw new Error('发现多个计划目录，请在 .opencode/d2h-progress.json 指定 plan'); }
+  const planFile = candidates[0]; const plan = readJson(planFile);
+  const source = config?.features ?? plan.feature_source?.path;
+  if (typeof source !== 'string' || !source) { throw new Error('计划缺少 feature_source.path'); }
+  const features = path.resolve(root, source);
+  const execution = config?.execution ? path.resolve(root, config.execution) : path.join(path.dirname(planFile), 'execution.json');
+  readJson(features); readJson(execution);
+  const stdout = await new Promise<string>((resolve, reject) => {
+    execFile(process.platform === 'win32' ? 'python' : 'python3', [
+      workflowAsset('spec_runtime.py'), 'dashboard', '--plan', planFile,
+      '--features', features, '--execution', execution,
+    ], { cwd: root, encoding: 'utf8', timeout: 10_000, maxBuffer: 16 * 1024 * 1024, signal, windowsHide: true },
+    (error, output, stderr) => {
+      if (error) { reject(new Error(`进度派生失败：${String(stderr || output || error.message).slice(0, 800)}`)); }
+      else { resolve(output); }
+    });
+  });
+  const snapshot = JSON.parse(stdout) as DashboardSnapshot;
+  return { status: 'ready', snapshot, summary: summarizeProgress(snapshot), demo: config?.demo === true, checkedAt: new Date().toISOString() };
+}
+/** Keep the last valid projection visible, but never present it as fresh after an error. */
+export class ProgressReader {
+  current: ProgressState = { status: 'loading' };
+  private pending?: Promise<ProgressState>;
+  constructor(private readonly project: string, private readonly signal?: AbortSignal) {}
+  refresh(): Promise<ProgressState> {
+    if (this.pending) { return this.pending; }
+    this.pending = this.update().finally(() => { this.pending = undefined; });
+    return this.pending;
+  }
+  private async update(): Promise<ProgressState> {
+    try {
+      const next = await loadProgress(this.project, this.signal);
+      this.current = next ?? { ...this.current, status: this.current.snapshot ? 'error' : 'missing', error: '尚未发现 pages.json；请建立计划或配置 d2h-progress.json' };
+    } catch (error) {
+      this.current = { ...this.current, status: 'error', error: error instanceof Error ? error.message : String(error) };
+    }
+    return this.current;
+  }
+}
+export function progressHtml(state: ProgressState): string {
+  if (!state.snapshot) { throw new Error(state.error ?? '尚无可展示的计划进度'); }
+  let html = fs.readFileSync(workflowAsset('assets/dashboard.html'), 'utf8');
+  const payload = JSON.stringify(state.snapshot).replaceAll('<', '\\u003c').replaceAll('\u2028', '\\u2028').replaceAll('\u2029', '\\u2029');
+  html = html.replace('/*__D2H_SNAPSHOT__*/null', () => payload);
+  if (state.demo) { html = html.replace('<body>', '<body><div style="position:relative;z-index:5;text-align:center;background:#fff3cd">演示数据 · 不代表真实应用开发或验收结果</div>'); }
+  return html;
+}

package/opencode/interactive-tools/server-legacy.mjs ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // Entry point for older harmony-acp/OpenCode loaders that enumerate plugin functions.
2	+ export { D2hInteractiveTools as default } from './server.mjs';

package/opencode/interactive-tools/server.mjs ADDED Viewed

@@ -0,0 +1,40 @@
+import { tool } from '@opencode-ai/plugin';
+import { interactionCapability, requestInteraction, scopeChange } from './core.ts';
+/** V1 server plugin. UI is supplied by a separate host adapter; this tool waits in the original turn. */
+export const D2hInteractiveTools = async () => ({
+  tool: {
+    d2h_interact_capabilities: tool({
+      description: '只读检查当前项目、会话是否有活跃交互界面；unsupported 时跳过看板询问，改用当前对话。不是用户授权。',
+      args: {},
+      async execute(_args, context) {
+        return JSON.stringify(interactionCapability(context.directory, context.sessionID));
+      },
+    }),
+    d2h_interact: tool({
+      description: '在宿主工作台请求用户确认环境、选择架构/实施范围或查看报告。仅在当前会话有活跃界面时读取工作流并等待用户；界面不可用立即返回 unsupported，调用方改用当前对话。取消时停止当前流程。不会修改计划或开发代码。',
+      args: {
+        workflowPath: tool.schema.string().describe('已有 d2h-interactive-workflow/v1 JSON 的绝对路径；实际数据必须来自当前报告，不得伪造 ready 状态'),
+        step: tool.schema.enum(['environment', 'architecture', 'scope', 'report']),
+      },
+      async execute(args, context) {
+        const outcome = await requestInteraction(context.directory, args.workflowPath, context.sessionID,
+          context.messageID, args.step, context.abort, request => {
+            context.metadata({ title: `d2h · ${args.step} · 等待用户`, metadata: { d2hInteractionId: request.id } });
+          });
+        if (outcome.status === 'unsupported') {
+          return JSON.stringify({ ...outcome, message: '跳过看板交互，改用当前会话询问；已有授权可复用，普通报告无需确认。未获得任何新的用户授权。' });
+        }
+        const { request, decision: result } = outcome;
+        const choices = args.step === 'architecture' ? request.workflow.architectures : args.step === 'scope' ? request.workflow.scopes : [];
+        return JSON.stringify({ ...result, step: args.step,
+          selectedOptions: choices.filter(choice => result.selected.includes(choice.id)),
+          ...(args.step === 'scope' && result.action === 'accept' ? { scopeDraft: scopeChange(request, result) } : {}),
+          ...(args.step === 'report' && result.action === 'accept' ? { report: request.workflow.report } : {}),
+        });
+      },
+    }),
+  },
+});
+export default { id: 'd2h.interactions.server', server: D2hInteractiveTools };

package/opencode/interactive-tools/tui.tsx ADDED Viewed

@@ -0,0 +1,230 @@
+/** @jsxImportSource @opentui/solid */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createSignal, For, Show, onCleanup } from 'solid-js';
+import type { TuiPluginModule } from '@opencode-ai/plugin/tui';
+import { listInteractions, interactionStatus, submitDecision, stepLabels } from './core.ts';
+import type { Interaction, Decision } from './core.ts';
+import { demoWorkflow, demoReport } from './demo-workflow.ts';
+import { createInteraction, waitForDecision, scopeChange, registerInteractionHost } from './core.ts';
+import { startInteractionBrowser, openInteractionBrowser } from './browser-host.ts';
+import { ProgressReader } from './progress.ts';
+const plugin: TuiPluginModule = {
+  id: 'd2h.interactions',
+  async tui(api) {
+    if (!/^1\.19\./.test(api.app.version)) {
+      api.ui.toast({ variant: 'error', message: 'd2h MVP 仅验证 OpenCode 1.19.x；未启用交互界面' });
+      return;
+    }
+    const project = api.state.path.directory;
+    const [active, setActive] = createSignal<Interaction>();
+    let previousRoute = api.route.current;
+    const [rows, setRows] = createSignal<Interaction[]>([]);
+    const [selected, setSelected] = createSignal<string[]>([]);
+    const [reason, setReason] = createSignal('');
+    const [cursor, setCursor] = createSignal(0);
+    const [editingReason, setEditingReason] = createSignal(false);
+    const [error, setError] = createSignal('');
+    const [tick, setTick] = createSignal(0);
+    const progressReader = new ProgressReader(project, api.lifecycle.signal);
+    const [progress, setProgress] = createSignal(progressReader.current);
+    const refreshProgress = async () => {
+      const next = await progressReader.refresh();
+      if (!api.lifecycle.signal.aborted) { setProgress({ ...next }); }
+    };
+    let browser: ReturnType<typeof startInteractionBrowser> | undefined;
+    const openBrowser = async () => {
+      const request = active();
+      if (!request) { setError('请先打开一个交互请求'); return; }
+      try {
+        browser ??= startInteractionBrowser().catch(cause => { browser = undefined; throw cause; });
+        const host = await browser;
+        if (api.lifecycle.signal.aborted) { return; }
+        await openInteractionBrowser(host.urlFor(request));
+        api.ui.toast({ variant: 'info', message: '已打开当前会话的网页工作台；提交后原流程继续' });
+      } catch (cause) { setError(`打开网页失败：${String(cause)}`); }
+    };
+    api.lifecycle.onDispose(async () => { if (browser) { await (await browser).close(); } });
+    const openProgress = async () => {
+      await refreshProgress();
+      if (!progressReader.current.snapshot) { api.ui.toast({ variant: 'info', message: progressReader.current.error ?? '尚无计划进度' }); return; }
+      try {
+        browser ??= startInteractionBrowser().catch(cause => { browser = undefined; throw cause; });
+        const host = await browser;
+        if (!api.lifecycle.signal.aborted) { await openInteractionBrowser(host.progressUrlFor(() => progressReader.current)); }
+      } catch (cause) { api.ui.toast({ variant: 'error', message: String(cause) }); }
+    };
+    const currentSession = () => api.route.current.name === 'session' ? String(api.route.current.params?.sessionID ?? '') : '';
+    const refresh = () => { setRows(listInteractions(project)); setTick(value => value + 1); };
+    const options = () => active()?.step === 'architecture' ? active()!.workflow.architectures : active()?.step === 'scope' ? active()!.workflow.scopes : [];
+    const toggleOption = (index: number) => {
+      const request = active(); const choice = options()[index];
+      if (!request || !choice) { return; }
+      if (request.step === 'architecture') { setSelected([choice.id]); }
+      else { setSelected(old => old.includes(choice.id) ? old.filter(id => id !== choice.id) : [...old, choice.id]); }
+    };
+    const close = () => { api.route.navigate(previousRoute.name, 'params' in previousRoute ? previousRoute.params : undefined); };
+    const open = (request?: Interaction) => {
+      if (api.route.current.name !== 'd2h.interactions') { previousRoute = api.route.current; }
+      const next = request ?? rows().filter(r => interactionStatus(r) === '等待确认' && (!currentSession() || r.sessionId === currentSession())).at(0);
+      setActive(next);
+      setSelected(next?.step === 'architecture' ? next.workflow.architectures.filter(c => c.selected).slice(0, 1).map(c => c.id) : next?.step === 'scope' ? next.workflow.scopes.filter(c => c.selected).map(c => c.id) : []);
+      setReason(''); setError(''); setCursor(0); setEditingReason(false); refresh();
+      api.route.navigate('d2h.interactions');
+    };
+    const submit = (action: 'accept' | 'cancel') => {
+      const request = active();
+      if (!request) { return; }
+      try {
+        submitDecision(project, request.id, request.revision, action, action === 'accept' ? selected() : [], reason());
+        api.ui.toast({ variant: 'success', message: action === 'accept' ? '结果已返回原工具，等待原会话继续' : '已取消本次交互' });
+        setActive(undefined); close();
+      } catch (cause) { setError(String(cause)); }
+    };
+    const pendingFor = (sessionId: string) => rows().filter(request => {
+      try { return request.sessionId === sessionId && interactionStatus(request) === '等待确认'; } catch { return false; }
+    });
+    api.slots.register({ order: 40, slots: { sidebar_content(_context, value) {
+      return <box flexDirection="column" paddingTop={1} paddingBottom={1}>
+        <text fg={api.theme.current.primary}>d2h 开发进度{progress().demo ? ' · 演示' : ''}</text>
+        <Show when={progress().status === 'error'}><text fg={api.theme.current.error}>{progress().snapshot ? '读取失败 · 上次数据已过期' : '读取失败 · 尚无有效进度'}</text></Show>
+        <Show when={progress().summary} fallback={<text>{progress().status === 'loading' ? '正在读取执行账本…' : '尚未接入有效计划'}</text>}>{summary => <>
+          <text>{summary().phase}</text>
+          <text>{`里程碑：${summary().milestone}`}</text>
+          <text>{`Spec 实现：${summary().implemented}/${summary().total}`}</text>
+          <text>{`Spec 验收：${summary().accepted}/${summary().total}`}</text>
+          <text>{summary().selected ? `选用范围验收：${summary().selected!.accepted}/${summary().selected!.total}` : '选用范围验收：—（无逐项追踪）'}</text>
+          <text>{`在途 ${summary().running.length} · 阻塞 ${summary().blocked} · 验证债务 ${summary().validationDebt}`}</text>
+          <For each={summary().running.slice(0, 2)}>{task => <text>{`正在执行：${task}`}</text>}</For>
+          <text>{`采集 ${progress().snapshot!.captured_at.slice(11, 19)} UTC`}</text>
+        </>}</Show>
+        <text>{`本会话待确认：${pendingFor(value.session_id).length}`}</text>
+        <box onMouseDown={() => { void openProgress(); }}><text fg={api.theme.current.primary}>[查看详细看板]</text></box>
+        <box onMouseDown={() => {
+          const request = pendingFor(value.session_id)[0];
+          if (request) { open(request); } else { api.ui.toast({ variant: 'info', message: '当前会话没有待确认事项' }); }
+        }}><text fg={api.theme.current.primary}>[处理待确认事项]</text></box>
+        <box onMouseDown={() => { void refreshProgress(); }}><text>[刷新进度]</text></box>
+      </box>;
+    } } });
+    void refreshProgress();
+    const progressTimer = setInterval(() => { void refreshProgress(); }, 3000);
+    api.lifecycle.onDispose(() => clearInterval(progressTimer));
+    api.route.register([{
+      name: 'd2h.interactions',
+      render: () => {
+        const popMode = api.mode.push('d2h.interactions'); onCleanup(popMode);
+        return <box flexDirection="column" height="100%" padding={1} gap={0}>
+          <text height={1} fg={api.theme.current.primary}>d2h 迁移工作台 · OpenCode V1</text>
+          <text height={1}>{(() => { tick(); const r = active(); return r ? `${stepLabels[r.step]} · ${interactionStatus(r)}${r.workflow.demo ? ' · 演示数据' : ''}` : '等待中的交互请求'; })()}</text>
+          <text height={1}>{active() ? `原会话 ${active()!.sessionId} · ${active()!.revision.slice(0, 12)}` : '选择请求后提交；不会发送新的 prompt'}</text>
+          <text height={2} fg={api.theme.current.primary}>{options().length ? '↑/↓ 移动高亮，Enter / Ctrl+O 勾选；Tab 切换到原因输入。' : '本页无需选择：↑/↓ 滚动内容，Enter / Ctrl+S 确认继续。'}</text>
+          <box flexDirection="column" flexGrow={1} minHeight={1}>
+            <Show when={options().length > 0} fallback={<scrollbox flexGrow={1} minHeight={1} focused={!editingReason()} onKeyDown={key => {
+              if (['return', 'linefeed'].includes(key.name)) { key.preventDefault(); submit('accept'); }
+            }}>
+            <box flexDirection="column" gap={0}>
+              <Show when={active()} keyed fallback={<For each={rows().filter(r => interactionStatus(r) === '等待确认')}>{request =>
+                <box onMouseDown={() => open(request)}><text>{`${stepLabels[request.step]} · ${request.sessionId} · 点击打开`}</text></box>
+              }</For>}>{request => <>
+                <text>{request.workflow.title}</text>
+                {request.step === 'environment' ? <For each={request.workflow.checks}>{check => <text>{`[${check.status}] ${check.label}：${check.detail}`}</text>}</For> : null}
+                {request.step === 'report' ? <text>{request.workflow.report}</text> : null}
+              </>}</Show>
+            </box>
+          </scrollbox>}>
+              <select flexGrow={1} minHeight={1} focused={!editingReason()} selectedIndex={cursor()}
+                options={options().map(choice => ({ name: `${selected().includes(choice.id) ? '[x]' : '[ ]'} ${choice.label}`, description: choice.detail, value: choice.id }))}
+                showDescription={false} showScrollIndicator={true} wrapSelection={true}
+                onChange={index => setCursor(index)} onSelect={index => toggleOption(index)} />
+              <text height={2}>{options()[cursor()]?.detail ?? ''}</text>
+            </Show>
+          </box>
+          <text height={1}>{editingReason() ? '正在输入原因 · Tab 返回内容/选项' : '原因输入未聚焦 · 按 Tab 输入（范围确认必填）'}</text>
+          <box height={1} flexShrink={0}><input width="100%" focused={editingReason()} onMouseDown={() => setEditingReason(true)} placeholder="填写原因后 Ctrl+S 提交" value={reason()} onInput={value => setReason(value)} onSubmit={() => submit('accept')} /></box>
+          <Show when={error()}><text height={2} fg={api.theme.current.error}>{error()}</text></Show>
+          <box height={1} flexShrink={0} onMouseDown={() => { void openBrowser(); }}><text fg={api.theme.current.primary}>[在浏览器打开工作台 Ctrl+B]</text></box>
+          <box height={1} flexShrink={0} flexDirection="row" gap={2}>
+            <box onMouseDown={() => submit('accept')}><text fg={api.theme.current.primary}>[提交并继续 Ctrl+S]</text></box>
+            <box onMouseDown={() => submit('cancel')}><text>[取消 Ctrl+X]</text></box>
+            <box onMouseDown={close}><text>[稍后处理 Esc]</text></box>
+          </box>
+          <text height={1}>范围只生成草稿；不会直接修改计划或启动开发。</text>
+        </box>;
+      },
+    }]);
+    api.keymap.registerLayer({ mode: 'd2h.interactions', bindings: [
+      { key: 'ctrl+s', cmd: () => submit('accept'), desc: '提交结果' },
+      { key: 'ctrl+x', cmd: () => submit('cancel'), desc: '取消交互' },
+      { key: 'escape', cmd: close, desc: '稍后处理' },
+      { key: 'tab', cmd: () => setEditingReason(value => !value), desc: '切换内容与原因输入' },
+      { key: 'ctrl+o', cmd: () => toggleOption(cursor()), desc: '勾选当前选项' },
+      { key: 'ctrl+b', cmd: () => { void openBrowser(); }, desc: '在浏览器打开当前工作台' },
+    ] });
+    api.keymap.registerLayer({ commands: [{ name: 'd2h.open', title: 'd2h: 打开迁移工作台', category: 'd2h', namespace: 'palette', slashName: 'd2h', run: () => open() }] });
+    api.keymap.registerLayer({ commands: [
+      { name: 'd2h.progress', title: 'd2h: 显示/隐藏进度侧栏', category: 'd2h', namespace: 'palette', slashName: 'd2h-progress', run: () => {
+        if (api.route.current.name === 'session') { api.keymap.dispatchCommand('session.sidebar.toggle'); }
+        else { api.ui.toast({ variant: 'info', message: '进入一条对话后运行 /d2h-progress，可显示或隐藏右侧进度栏' }); }
+      } },
+      { name: 'd2h.board', title: 'd2h: 在浏览器查看开发进度', category: 'd2h', namespace: 'palette', slashName: 'd2h-board', run: () => { void openProgress(); } },
+      { name: 'd2h.progress-demo', title: 'd2h: 体验进度侧栏（仅演示项目，无模型）', category: 'd2h', namespace: 'palette', slashName: 'd2h-progress-demo', async run() {
+        await refreshProgress();
+        if (!progress().demo) { api.ui.toast({ variant: 'info', message: '此入口仅适用于明确标记 demo 的演示项目；正式项目直接进入任务对话' }); return; }
+        try {
+          const result = await api.client.session.create({ directory: project, title: 'd2h 进度侧栏体验（无模型）' });
+          if (!result.data) { throw new Error('未能创建演示会话'); }
+          api.route.navigate('session', { sessionID: result.data.id });
+          api.ui.toast({ variant: 'info', message: '演示会话不调用模型；窄终端输入 /d2h-progress 显示右侧进度栏' });
+        } catch (cause) { api.ui.toast({ variant: 'error', message: String(cause) }); }
+      } },
+    ] });
+    // Explicit local fixture driver: tests the host without calling a model or changing user configuration.
+    api.keymap.registerLayer({ commands: [{ name: 'd2h.demo', title: 'd2h: 演示四步交互（不迁移）', category: 'd2h', namespace: 'palette', slashName: 'd2h-demo', async run() {
+      const file = path.join(project, `d2h-demo-${Date.now()}.json`);
+      fs.writeFileSync(file, JSON.stringify(demoWorkflow, null, 2), { flag: 'wx' });
+      const sid = currentSession() || 'demo-tui-no-model';
+      const results: Decision[] = [];
+      for (const step of ['environment', 'architecture', 'scope', 'report'] as const) {
+        const request = createInteraction(project, file, sid, 'demo-driver', step);
+        open(request);
+        try {
+          const decision = await waitForDecision(request, api.lifecycle.signal);
+          results.push(decision);
+          fs.writeFileSync(file + '.results.json', JSON.stringify(results, null, 2));
+          if (decision.action === 'cancel') { return; }
+          if (step === 'scope') {
+            fs.writeFileSync(file + '.scope-draft.json', JSON.stringify(scopeChange(request, decision), null, 2));
+            fs.writeFileSync(file, JSON.stringify({ ...demoWorkflow, report: demoReport(results) }, null, 2));
+          }
+        }
+        catch (cause) { api.ui.toast({ variant: 'error', message: String(cause) }); return; }
+      }
+      api.ui.toast({ variant: 'success', message: '演示完成；未调用模型、未执行迁移' });
+    } }] });
+    let host: ReturnType<typeof registerInteractionHost> | undefined;
+    let hostSession = '', lastHeartbeat = 0;
+    const publishHost = () => {
+      const sid = currentSession() || (api.route.current.name === 'd2h.interactions' ? active()?.sessionId ?? '' : '');
+      if (sid !== hostSession) { host?.dispose(); host = undefined; hostSession = sid; lastHeartbeat = 0; }
+      if (sid && Date.now() - lastHeartbeat >= 3000) {
+        if (host) { host.heartbeat(); } else { host = registerInteractionHost(project, sid); }
+        lastHeartbeat = Date.now();
+      }
+    };
+    try { publishHost(); } catch (cause) { setError(String(cause)); }
+    const timer = setInterval(() => {
+      try { publishHost(); refresh(); const sid = currentSession(); const next = rows().find(r => interactionStatus(r) === '等待确认' && r.sessionId === sid);
+        const current = active();
+        if (current && interactionStatus(current) !== '等待确认') {
+          setActive(undefined);
+          if (api.route.current.name === 'd2h.interactions') { close(); }
+        }
+        if (next && !active() && api.route.current.name === 'session') { open(next); }
+      } catch (cause) { setError(String(cause)); }
+    }, 700);
+    api.lifecycle.onDispose(() => { clearInterval(timer); host?.dispose(); });
+  },
+};
+export default plugin;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/d2h",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Install Android-to-HarmonyOS migration agents and skills into OpenCode or DevEco Code",
   "type": "module",
   "bin": {
@@ -13,11 +13,19 @@
     "agents/",
     "AGENTS.md",
     "schemas/",
+    "workflow/",
+    "contracts/",
     "opencode/",
     ".claude-plugin/",
     "install-opencode.sh",
     "scripts/check-environment.mjs",
     "docs/environment-check.md",
+    "docs/incremental-spec-evaluation-design.md",
+    "docs/spec-plan-guide.md",
+    "docs/workflow-decoupling.md",
+    "docs/architecture-plan-guide.zh-CN.md",
+    "docs/architecture-plan-performance.md",
+    "docs/architecture-plan-two-project-evaluation.md",
     "README.md",
     "LICENSE"
   ],