@monkey-mini-app/dsh-mini-app 0.1.0

package/skills/monkey-mini-app/templates/agentrun/manifest.json

@@ -0,0 +1,9 @@
+{
+  "id": "com.example.agentrun",
+  "name": "任务执行器",
+  "description": "让模型干一个多步活，实时展示过程，可取消",
+  "version": "0.1.0",
+  "entry": "ui.tsx",
+  "theme": { "followsHost": true },
+  "acronym": "RW"
+}

package/skills/monkey-mini-app/templates/agentrun/ui.tsx

@@ -0,0 +1,125 @@
+import { useEffect, useState } from "react";
+
+import {
+  ActivityFeed,
+  AppShell,
+  Badge,
+  Button,
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+  Icon,
+  Input,
+  PageHeader,
+  Stepper,
+} from "@monkey-mini-app/ui";
+import { useDashboardApi } from "@monkeyagent/host";
+
+type Step = { phase: string; name?: string; turn?: number; text?: string; at: number };
+type Run = { goal: string; status: string; steps: Step[]; result: string; startedAt: number };
+type TimelineItem = { id: string; title: string; description?: string; time?: string };
+
+export default function Ui() {
+  const { call } = useDashboardApi();
+  const [goal, setGoal] = useState("");
+  const [run, setRun] = useState<Run | null>(null);
+  const [running, setRunning] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  // ⭐ 关键：UI 不直接拿 agent 事件 —— 每 300ms 轮询 runStatus（后端 onEvent 已写进 storage）
+  useEffect(() => {
+    const poll = async () => {
+      const r = (await call("runStatus", {})) as Run;
+      setRun(r);
+      setRunning(r?.status === "running");
+    };
+    void poll();
+    const id = setInterval(() => void poll(), 300);
+    return () => clearInterval(id);
+  }, [call]);
+
+  async function start() {
+    setError(null);
+    try {
+      await call("start", { goal });
+    } catch (e) {
+      setError(String((e as Error)?.message || e));
+    }
+  }
+
+  const items: TimelineItem[] = (run?.steps ?? []).map((s, i) => ({
+    id: String(i),
+    title: s.phase === "tool" ? `调用工具 ${s.name ?? ""}` : s.phase === "turn" ? `第 ${s.turn} 轮` : s.phase === "done" ? "完成" : s.phase,
+    description: s.text ?? (s.phase === "tool" ? "结束" : undefined),
+    time: new Date(s.at).toLocaleTimeString("zh-CN"),
+  }));
+  const statusTone = run?.status === "done" ? "default" : run?.status === "error" || run?.status === "cancelled" ? "destructive" : "secondary";
+
+  return (
+    <AppShell header={<PageHeader title="任务执行器" description="模型跑多步活 · 实时过程 · 可取消" />}>
+      <div className="flex h-full min-h-0 max-w-3xl flex-col gap-3 overflow-y-auto">
+        <Card>
+          <CardHeader>
+            <CardTitle>目标</CardTitle>
+            <CardDescription>给一个多步目标，模型会拆解并用工具逐步完成</CardDescription>
+          </CardHeader>
+          <CardContent className="flex flex-col gap-2">
+            <Input value={goal} placeholder="例如：读 packages/ui/src 下组件，总结导出清单写到 storage" onChange={(e) => setGoal(e.target.value)} />
+            <div className="flex items-center gap-2">
+              <Button onClick={() => void start()} disabled={running || !goal.trim()}>
+                <Icon.Play size={16} strokeWidth={2} /> 开始
+              </Button>
+              {running && (
+                <Button variant="outline" onClick={() => void call("cancel", {})}>
+                  <Icon.Square size={16} strokeWidth={2} /> 取消
+                </Button>
+              )}
+              <div className="ml-auto">
+                <Badge variant={statusTone}>{run?.status ?? "idle"}</Badge>
+              </div>
+            </div>
+            {error && <p className="text-sm" style={{ color: "var(--destructive)" }}>{error}</p>}
+          </CardContent>
+        </Card>
+
+        {run && (
+          <>
+            {/* ⭐ 关键：用 Stepper 展示「进行到第几步 + 每步状态」 */}
+            <Card>
+              <CardHeader><CardTitle>进度</CardTitle></CardHeader>
+              <CardContent>
+                <Stepper
+                  steps={[
+                    { id: "s1", title: "理解" },
+                    { id: "s2", title: "执行" },
+                    { id: "s3", title: "总结" },
+                  ]}
+                  current={run.steps.length >= 2 ? 2 : run.steps.length}
+                  orientation="horizontal"
+                />
+              </CardContent>
+            </Card>
+
+            <Card className="min-h-0 flex-1 overflow-hidden">
+              <CardHeader><CardTitle>过程</CardTitle><CardDescription>工具调用 / 轮次时间线</CardDescription></CardHeader>
+              <CardContent className="max-h-72 overflow-y-auto">
+                <ActivityFeed items={items} />
+              </CardContent>
+            </Card>
+
+            {run.result && (
+              <Card>
+                <CardHeader><CardTitle>结果</CardTitle></CardHeader>
+                <CardContent>
+                  <pre className="whitespace-pre-wrap text-sm">{run.result}</pre>
+                </CardContent>
+              </Card>
+            )}
+          </>
+        )}
+      </div>
+    </AppShell>
+  );
+}

package/skills/monkey-mini-app/templates/insights/lib/sample.ts

@@ -0,0 +1,17 @@
+export type FeedItem = { title: string; link?: string };
+
+// 内置样例源：默认不走网络，保证离线也能跑起来（教"采样走通全链路"）
+export const SAMPLE_ITEMS: FeedItem[] = [
+  { title: "TypeScript 5.7 发布：更快的类型检查与更好的模块解析", link: "https://example.com/ts57" },
+  { title: "Vite 6 默认启用 Rolldown 路线图", link: "https://example.com/vite6" },
+  { title: "React 19：Actions 与 useOptimistic 正式稳定", link: "https://example.com/react19" },
+  { title: "CSS 原生嵌套全面落地", link: "https://example.com/css-nest" },
+  { title: "Node.js 24 默认启用 SQLite 内置模块", link: "https://example.com/node24" },
+  { title: "WebGPU 在 Safari 的进展与局限", link: "https://example.com/webgpu-safari" },
+  { title: "Rust 1.85：async 生成器仍在打磨", link: "https://example.com/rust185" },
+  { title: "Bun 逐步兼容 npm 生态", link: "https://example.com/bun" },
+  { title: "新一版 ECMAScript 提案：RegExp 增强", link: "https://example.com/es-proposal" },
+  { title: "AI 编程助手对代码质量的实证研究", link: "https://example.com/ai-code" },
+  { title: "PostgreSQL 18 的并行查询改进", link: "https://example.com/pg18" },
+  { title: "移动端 3D 渲染的实用技巧", link: "https://example.com/mobile3d" },
+];

package/skills/monkey-mini-app/templates/insights/main.api.ts

@@ -0,0 +1,101 @@
+import { defineDashboard } from "@monkeyagent/dashboard";
+
+import { type FeedItem, SAMPLE_ITEMS } from "./lib/sample";
+
+type Digest = { headline: string; bullets: string[] };
+type Payload = { items: FeedItem[]; digest: Digest | null; at: number };
+type Progress = { running: boolean; step: string; done: number; total: number; error?: string };
+
+const DIGEST_SCHEMA = {
+  type: "object",
+  properties: {
+    headline: { type: "string" },
+    bullets: { type: "array", items: { type: "string" } },
+  },
+  required: ["headline", "bullets"],
+};
+
+function parseDigest(raw: string): Digest {
+  let value: { headline?: unknown; bullets?: unknown };
+  try {
+    value = JSON.parse(raw);
+  } catch {
+    throw new Error("模型没有返回 JSON：" + String(raw).slice(0, 180));
+  }
+  const headline = String(value?.headline ?? "").trim();
+  const bullets = Array.isArray(value?.bullets)
+    ? value.bullets.map((b) => String(b).trim()).filter(Boolean).slice(0, 3)
+    : [];
+  if (!headline || bullets.length !== 3) throw new Error("摘要格式不对");
+  return { headline, bullets };
+}
+
+// ⭐ 关键：长耗时任务 —— 只跑采样走通全链路（这里取前 8 条），批次设上限，
+//         并在每步之间检查 ctx.signal（用户点停止即中断）。进度经 storage 暴露给 UI 轮询。
+async function runRefresh(ctx): Promise<Payload> {
+  const items = SAMPLE_ITEMS.slice(0, 8);
+  const report = async (partial: Partial<Progress>) => {
+    await ctx.storage.set("progress", { running: true, step: "refresh", done: 0, total: 3, ...partial });
+  };
+  try {
+    // 1) 采样拉取（这里用内置样例；真实场景换成 ctx.http 拉 RSS）
+    await report({ step: "fetch·sample 8/8", done: 1 });
+    // ⭐ 关键：每步之间检查取消信号
+    if (ctx.signal?.aborted) throw new Error("cancelled");
+    await sleep(300, ctx.signal);
+
+    // 2) 模型摘要（schema 软约束"只回 JSON"；返回仍是 string，再 JSON.parse）
+    await report({ step: "summarize#1/1", done: 2 });
+    const raw = await ctx.llm(
+      "根据这些标题写一条中文 headline，以及恰好 3 条中文 bullets。不要前言：\n" + items.map((i) => "- " + i.title).join("\n"),
+      { schema: DIGEST_SCHEMA },
+    );
+    if (ctx.signal?.aborted) throw new Error("cancelled");
+    const digest = parseDigest(raw);
+
+    const payload: Payload = { items, digest, at: Date.now() };
+    await ctx.storage.set("latest", payload);
+    await ctx.storage.set("progress", { running: false, step: "done", done: 3, total: 3 });
+    return payload;
+  } catch (cause) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    await ctx.storage.set("progress", { running: false, step: "failed", done: 0, total: 3, error: message });
+    throw new Error("摘要失败：" + message);
+  }
+}
+
+export default defineDashboard({
+  name: "今日摘要",
+  description: "拉取公开头条，整理成三条要点",
+  api: {
+    async latest(ctx): Promise<Payload> {
+      return (await ctx.storage.get("latest")) || { items: SAMPLE_ITEMS, digest: null, at: 0 };
+    },
+
+    // fire-and-forget：立即返回"已启动"，实际工作在后台，UI 用 scanStatus 轮询
+    async scan(ctx) {
+      void runRefresh(ctx);
+      return { ok: true };
+    },
+
+    async scanStatus(ctx): Promise<Progress> {
+      return (await ctx.storage.get("progress")) || { running: false, step: "idle", done: 0, total: 3 };
+    },
+
+    // 也可直接 await 调用（不用后台轮询）
+    async refresh(ctx) {
+      return runRefresh(ctx);
+    },
+  },
+});
+
+function sleep(ms: number, signal?: AbortSignal) {
+  return new Promise<void>((resolve) => {
+    if (signal?.aborted) return resolve();
+    const t = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+      clearTimeout(t);
+      resolve();
+    }, { once: true });
+  });
+}

package/skills/monkey-mini-app/templates/insights/manifest.json

@@ -0,0 +1,9 @@
+{
+  "id": "com.example.insights",
+  "name": "今日摘要",
+  "description": "公开头条 + 模型整理成三条要点",
+  "version": "0.1.0",
+  "entry": "ui.tsx",
+  "theme": { "followsHost": true },
+  "acronym": "ZY"
+}

package/skills/monkey-mini-app/templates/insights/ui.tsx

@@ -0,0 +1,138 @@
+import { useEffect, useState } from "react";
+
+import {
+  AppShell,
+  Badge,
+  Button,
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+  DetailPanel,
+  Icon,
+  PageHeader,
+  Progress,
+} from "@monkey-mini-app/ui";
+import { useDashboardApi } from "@monkeyagent/host";
+
+type Digest = { headline: string; bullets: string[] };
+type Item = { title: string; link?: string };
+type Payload = { items: Item[]; digest: Digest | null; at: number };
+type Progress = { running: boolean; step: string; done: number; total: number; error?: string };
+
+export default function Ui() {
+  const { call } = useDashboardApi();
+  const [data, setData] = useState<Payload | null>(null);
+  const [progress, setProgress] = useState<Progress | null>(null);
+  const [selected, setSelected] = useState<Item | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const load = async () => setData((await call("latest", {})) as Payload);
+
+  async function run() {
+    setError(null);
+    try {
+      await call("scan", {}); // fire-and-forget 启动，立即返回
+      // ⭐ 关键：长任务进度 —— UI 轮询 scanStatus 直到 running=false
+      const iv = setInterval(async () => {
+        const p = (await call("scanStatus", {})) as Progress;
+        setProgress(p);
+        if (!p.running) {
+          clearInterval(iv);
+          await load();
+        }
+      }, 300);
+      // 兜底：一段时间后强制停轮询（防止 progress 卡在 running）
+      setTimeout(() => clearInterval(iv), 60_000);
+    } catch (e) {
+      setError(String((e as Error)?.message || e));
+    }
+  }
+
+  useEffect(() => {
+    void load();
+  }, [call]);
+
+  const digest = data?.digest;
+  const items = data?.items ?? [];
+  const pct = progress && progress.total ? Math.round((progress.done / progress.total) * 100) : 0;
+
+  return (
+    <AppShell
+      header={
+        <PageHeader
+          title="今日摘要"
+          description="公开头条 · 模型整理成三条要点"
+          actions={<Button disabled={progress?.running} onClick={() => void run()}><Icon.Sparkles size={16} strokeWidth={2} /> 整理</Button>}
+        />
+      }
+    >
+      <div className="grid h-full min-h-0 grid-cols-1 gap-3 md:grid-cols-[1fr_360px]">
+        {/* 主从：左列表 */}
+        <Card className="min-h-0 overflow-hidden">
+          <CardHeader>
+            <CardTitle>来源</CardTitle>
+            <CardDescription>点击看详情</CardDescription>
+            {progress?.running && (
+              <div className="flex items-center gap-2">
+                <Progress value={pct} className="flex-1" />
+                <span className="text-xs text-muted-foreground">{progress.step}</span>
+              </div>
+            )}
+            {error && <p className="text-sm" style={{ color: "var(--destructive)" }}>{error}</p>}
+          </CardHeader>
+          <CardContent className="flex flex-col min-h-0 flex-1 gap-1 overflow-y-auto">
+            {items.map((it, i) => (
+              <button
+                key={it.title + i}
+                onClick={() => setSelected(it)}
+                className="flex items-center justify-between gap-2 rounded-lg px-3 py-2 text-left text-sm transition-colors hover:bg-muted/50"
+              >
+                <span className="min-w-0 flex-1 truncate">{it.title}</span>
+                <Icon.ChevronRight size={16} strokeWidth={2} className="shrink-0 text-muted-foreground" />
+              </button>
+            ))}
+          </CardContent>
+        </Card>
+
+        {/* 主从：右详情（选中某条才开，关掉即清） */}
+        <DetailPanel
+          open={Boolean(selected)}
+          onOpenChange={(o) => { if (!o) setSelected(null); }}
+          title={selected?.title ?? digest?.headline ?? "摘要"}
+          description={selected ? selected.title : "模型整理的要点"}
+        >
+          <div className="flex flex-col gap-3">
+            <Card>
+              <CardHeader>
+                <CardTitle>{digest?.headline || "还没有摘要"}</CardTitle>
+                <CardDescription>{data?.at ? "更新于 " + new Date(data.at).toLocaleString("zh-CN") : "点「整理」用模型生成"}</CardDescription>
+              </CardHeader>
+              <CardContent>
+                {digest?.bullets?.length ? (
+                  <ol className="flex flex-col gap-2 pl-5 m-0">
+                    {digest.bullets.map((b, i) => (
+                      <li key={i} className="text-sm leading-relaxed">{b}</li>
+                    ))}
+                  </ol>
+                ) : (
+                  <span className="text-sm text-muted-foreground">还没有要点，先点「整理」。</span>
+                )}
+              </CardContent>
+            </Card>
+            {selected && (
+              <Card>
+                <CardHeader><CardTitle className="text-sm">选中条目</CardTitle></CardHeader>
+                <CardContent>
+                  <p className="text-sm">{selected.title}</p>
+                  {selected.link ? <a href={selected.link} target="_blank" rel="noreferrer" className="text-xs text-primary hover:underline w-fit">阅读原文</a> : null}
+                </CardContent>
+              </Card>
+            )}
+          </div>
+        </DetailPanel>
+      </div>
+    </AppShell>
+  );
+}

package/skills/monkey-mini-app/templates/jira/main.api.ts

@@ -0,0 +1,115 @@
+import { defineDashboard } from "@monkeyagent/dashboard";
+
+// ⭐ 关键：列表/看板数据项的"key"字段很重要 —— 拖拽/更新都用它定位（还记得 idKey="key" 的坑）。
+//         Jira 仿真：改状态/负责人/优先级、加评论、AI 记工时。
+export type Issue = {
+  key: string;                       // 例如 "BUG-104"
+  type: "Story" | "Task" | "Bug" | "Epic";
+  summary: string;
+  status: "To Do" | "In Progress" | "Done" | "Blocked";
+  priority: "P0" | "P1" | "P2" | "P3";
+  assignee: string;
+  reporter: string;
+  points: number;
+  comments: { author: string; text: string; at: number }[];
+  createdAt: number;
+  updatedAt: number;
+};
+
+const SEED: Issue[] = [
+  { key: "BUG-104", type: "Bug", summary: "看板拖拽到列后状态未持久化", status: "In Progress", priority: "P0", assignee: "陈", reporter: "李", points: 3, comments: [{ author: "陈", text: "复现：跨列拖拽后刷新丢失", at: Date.now() - 864e5 }], createdAt: Date.now() - 3 * 864e5, updatedAt: Date.now() - 3600e3 },
+  { key: "STORY-21", type: "Story", summary: "支持按负责人筛选看板", status: "To Do", priority: "P1", assignee: "王", reporter: "陈", points: 5, comments: [], createdAt: Date.now() - 2 * 864e5, updatedAt: Date.now() - 2 * 864e5 },
+  { key: "TASK-88", type: "Task", summary: "表格视图增加优先级排序", status: "Done", priority: "P2", assignee: "李", reporter: "王", points: 2, comments: [], createdAt: Date.now() - 6 * 864e5, updatedAt: Date.now() - 8 * 3600e3 },
+  { key: "BUG-77", type: "Bug", summary: "详情弹层评论不刷新最新一条", status: "Blocked", priority: "P1", assignee: "陈", reporter: "李", points: 3, comments: [], createdAt: Date.now() - 5 * 864e5, updatedAt: Date.now() - 864e5 },
+  { key: "STORY-9", type: "Story", summary: "状态汇总色板支持自定义主题", status: "In Progress", priority: "P1", assignee: "王", reporter: "陈", points: 8, comments: [], createdAt: Date.now() - 1 * 864e5, updatedAt: Date.now() - 3600e3 },
+  { key: "TASK-5", type: "Task", summary: "AI 工时记录入口", status: "To Do", priority: "P0", assignee: "陈", reporter: "李", points: 2, comments: [], createdAt: Date.now() - 864e5, updatedAt: Date.now() - 864e5 },
+];
+
+async function load(ctx): Promise<Issue[]> {
+  const issues = await ctx.storage.table("issues").get("all");
+  return Array.isArray(issues) ? issues : SEED;
+}
+async function save(ctx, issues: Issue[]) {
+  await ctx.storage.table("issues").set("all", issues);
+}
+function touch(i: Issue): Issue {
+  return { ...i, updatedAt: Date.now() };
+}
+
+export default defineDashboard({
+  name: "Jira 看板",
+  description: "看板/表格双视图 · 状态与评论编辑 · AI 记工时",
+  api: {
+    async list(ctx) {
+      const issues = await load(ctx);
+      return { issues };
+    },
+    // ⭐ 关键：乐观更新 + 持久化 —— 拖拽/改字段先改内存再落库；UI 拿 key 定位
+    async update(ctx, args?: { key?: string; patch?: Partial<Issue> }) {
+      const key = args?.key;
+      if (!key) throw new Error("缺少 key");
+      const issues = await load(ctx);
+      let found = false;
+      const next = issues.map((i) => {
+        if (i.key !== key) return i;
+        found = true;
+        return touch({ ...i, ...(args?.patch ?? {}) });
+      });
+      if (!found) throw new Error("issue 不存在：" + key);
+      await save(ctx, next);
+      return next.find((i) => i.key === key);
+    },
+    async comment(ctx, args?: { key?: string; text?: string }) {
+      const text = String(args?.text ?? "").trim();
+      if (!text) throw new Error("评论不能为空");
+      const key = args?.key;
+      const issues = await load(ctx);
+      let found = false;
+      const next = issues.map((i) => {
+        if (i.key !== key) return i;
+        found = true;
+        return touch({ ...i, comments: [...i.comments, { author: "我", text, at: Date.now() }] });
+      });
+      if (!found) throw new Error("issue 不存在");
+      await save(ctx, next);
+      return next.find((i) => i.key === key);
+    },
+    // 状态汇总：按 status 计数（简约色板用）
+    async summary(ctx) {
+      const issues = await load(ctx);
+      const byStatus: Record<string, number> = {};
+      for (const i of issues) byStatus[i.status] = (byStatus[i.status] || 0) + 1;
+      return { byStatus, total: issues.length };
+    },
+    // ⭐ 关键：AI 记工时 —— 用 ctx.llm(schema) 把 issue 的近期变动生成一条 worklog 草稿，用户确认后再存
+    async worklogDraft(ctx, args?: { key?: string }) {
+      const key = args?.key;
+      const issues = await load(ctx);
+      const issue = issues.find((i) => i.key === key);
+      if (!issue) throw new Error("issue 不存在");
+      const activity = issue.comments.map((c) => `${c.author}: ${c.text}`).join("；") || "（无评论）";
+      const raw = await ctx.llm(
+        `为 Jira ${issue.key}「${issue.summary}」写一条简洁中文 worklog（当天在做什么、进展、下一步）。状态: ${issue.status}。近期动态: ${activity}`,
+        { schema: { type: "object", properties: { note: { type: "string" } }, required: ["note"] } },
+      );
+      const parsed = JSON.parse(raw) as { note?: string };
+      return { note: String(parsed.note ?? "").trim() || issue.summary };
+    },
+    // 确认后存成一条评论（worklog 前缀）
+    async logWork(ctx, args?: { key?: string; note?: string; minutes?: number }) {
+      const key = args?.key;
+      const minutes = Number(args?.minutes ?? 0) || 0;
+      const note = String(args?.note ?? "").trim();
+      const issues = await load(ctx);
+      let found = false;
+      const next = issues.map((i) => {
+        if (i.key !== key) return i;
+        found = true;
+        return touch({ ...i, comments: [...i.comments, { author: "我", text: `[worklog] ${minutes}min · ${note}`, at: Date.now() }] });
+      });
+      if (!found) throw new Error("issue 不存在");
+      await save(ctx, next);
+      return next.find((i) => i.key === key);
+    },
+  },
+});

package/skills/monkey-mini-app/templates/jira/manifest.json

@@ -0,0 +1,9 @@
+{
+  "id": "com.example.jira",
+  "name": "Jira 看板",
+  "description": "看板/表格双视图 · 状态与评论编辑 · AI 记工时",
+  "version": "0.1.0",
+  "entry": "ui.tsx",
+  "theme": { "followsHost": true },
+  "acronym": "JB"
+}