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

package/README.md

@@ -0,0 +1,57 @@
+# @monkey-mini-app/dsh-mini-app
+
+给 [DeepSeek Harness](https://github.com/deepseek-ai) 加一条 **「小程序」跑道**：让模型可以在对话里直接创建、运行、打开一个个小的 React 应用（`manifest.json` + `ui.tsx` + `main.api.ts`），它们以独立窗口的形式停在侧栏。
+
+![home](./assets/home.png)
+*安装后侧栏多出「小程序」入口。*
+
+## 它能做什么
+
+- 模型（或你）用一行 `mini_app_register` 就能**秒建一个 mini-app**，Host 在本机把它跑起来。
+- 侧栏「小程序」面板是个**应用画廊**：打开、切换、钉到侧边、设置主题。
+- 每个 mini-app 有独立的 `ui.tsx`（UI）+ `main.api.ts`（`ctx.llm`/`ctx.http`/`ctx.bash`/`ctx.agent`/`ctx.storage`…）。
+- 打包即用：一个 dsh 插件就带齐 Host（AppsManager / git / Hono / UI 编译 / tools）+ React 面板 + 生成 skill。
+
+![apps](./assets/apps-list.png)
+*小程序画廊（5 个示例 app）。*
+
+![demo](./assets/demo-app.png)
+*打开一个 mini-app（能力实验室：LLM / Agent / 工具 / 网络 / 命令）。*
+
+![side](./assets/sidebar-mode.png)
+*mini-app 钉到侧栏（待办）：对话在左、应用在右。*
+
+![complex](./assets/complex-demo-app.png)
+*复杂 mini-app（AI 热点雷达：多源聚合 + LLM 分析 + 图表）。*
+
+## 安装
+
+```bash
+dsh plugin --profile web add @monkey-mini-app/dsh-mini-app
+```
+
+然后打开 dsh web：
+
+```bash
+dsh web --no-open   # http://127.0.0.1:3080 ；apps host 默认 :17880
+```
+
+首次启动会自动初始化运行时配置（写出完整 `host.json`），侧栏即出现「小程序」入口。
+
+## 使用
+
+1. **打开**：侧栏点「小程序」→ 打开任一 app。
+2. **生成**：让模型「做一个 xxx 小程序」，模型会按内置 skill 生成 `manifest.json` + `ui.tsx` + `main.api.ts`（模板在 `skills/monkey-mini-app/templates/`）。
+3. **调用**：mini-app 的 `main.api.ts` 用 `defineDashboard({ api })` 暴露方法；`ui.tsx` 用 `useDashboardApi()` 的 `call(method, args)` 调它们。
+4. **调试**：`mini_app_call` 冒烟、`mini_app_reload` 重编译、`mini_app_open` 打开。
+
+## UI 组件库：参考而非规范
+
+`@monkey-mini-app/ui` 提供现成组件（表格 / 表单 / 图表 / 弹窗 / 编辑器…），**是用来省事的，不是强制**。合适的场景直接用；需要独特视觉或自由发挥时，**用原生元素 + Tailwind classes 自行实现**也行（可混用）。详见 skill。
+
+## 技术备注
+
+- **插件入口**：导出 `apply(ctx, config?)`（Cordis）、常量 `name="monkey-mini-app"`、`inject=["tools"]`，以及 `DshCapabilities` / `DshLifecycle` / `DshThemeResource`。
+- **client**：`@monkey-mini-app/dsh-mini-app/client` 导出 `FooterButton` / `createMiniAppPanel` / `appFrameUrl` / `appsOrigin`。
+- **deps**：`@monkey-mini-app/host` / `panel` / `ui` 为运行时 `require`（external，不打进去），发布后仍从 npm 解析。
+- **运行时配置**：首启自动 bootstrap 写完整 `host.json`（缺才建）；`host.json` 已存在但损坏仍 fail loud。

package/lib/index.d.ts

@@ -6,8 +6,9 @@ type DshPluginConfig = {
 /** Locate runtimeRoot from plugin config only when provided; else bootstrap seed path. */
 declare function resolveRuntimeRoot(config?: DshPluginConfig): AbsolutePath;
 /**
- * Runtime load: read host.json, no field defaults.
- * Missing file fails loud with an install/init hint.
+ * Runtime load: read host.json.
+ * A missing file is bootstrapped on first run (so `dsh plugin add` just works);
+ * a present-but-corrupt host.json still fails loud (never silently patched).
  */
 declare function loadPluginHostConfig(config?: DshPluginConfig): HostConfig;
 

package/lib/index.js

@@ -2,12 +2,12 @@
 import { createHost } from "@monkey-mini-app/host";
 
 // src/apply-config.ts
+import { mkdirSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import path from "path";
 import {
   asAbsolutePath,
   bootstrapHostConfig,
-  createHostI18n,
   HostConfigError,
   loadHostConfig,
   WorkspacePaths
@@ -31,11 +31,6 @@ function resolveRuntimeRoot(config = {}) {
   }
   return bootstrapHostConfig({}).runtimeRoot;
 }
-function missingConfigError(file, cause) {
-  const i18n = createHostI18n("zh-CN");
-  const message = `${i18n.t("config.missingFile", { path: file })} ${i18n.t("config.missingHint")}`;
-  return new HostConfigError(message, { code: "HOST_CONFIG_NOT_FOUND", cause });
-}
 function loadPluginHostConfig(config = {}) {
   const runtimeRoot = resolveRuntimeRoot(config);
   const paths = new WorkspacePaths(runtimeRoot);
@@ -43,7 +38,12 @@ function loadPluginHostConfig(config = {}) {
     return loadHostConfig(paths);
   } catch (cause) {
     if (cause instanceof HostConfigError && cause.code === "HOST_CONFIG_NOT_FOUND") {
-      throw missingConfigError(paths.hostConfigFile(), cause);
+      const cfg = bootstrapHostConfig({ runtimeRoot });
+      mkdirSync(cfg.runtimeRoot, { recursive: true });
+      mkdirSync(paths.appsDir(), { recursive: true });
+      writeFileSync(paths.hostConfigFile(), `${JSON.stringify(cfg, null, 2)}
+`);
+      return cfg;
     }
     throw cause;
   }
@@ -729,7 +729,7 @@ var DshCapabilities = class {
 };
 
 // src/lifecycle.ts
-import { cpSync, mkdirSync } from "fs";
+import { cpSync, mkdirSync as mkdirSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import path3 from "path";
 
@@ -928,7 +928,7 @@ function registerListCtxTools(ctx, defineTool = null) {
   }
 }
 function installSkillDir(src, dest) {
-  mkdirSync(path3.dirname(dest), { recursive: true });
+  mkdirSync2(path3.dirname(dest), { recursive: true });
   cpSync(src, dest, { recursive: true });
 }
 function defaultSkillDest() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monkey-mini-app/dsh-mini-app",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DeepSeek Harness plugin: mini-app host wiring, panel, and skills",
   "type": "module",
   "main": "./lib/index.js",
@@ -23,7 +23,8 @@
     "lib",
     "cordis.patch.yml",
     "tsup.config.ts",
-    "skills"
+    "skills",
+    "assets"
   ],
   "scripts": {
     "build": "rm -rf lib && tsup",

package/skills/monkey-mini-app/SKILL.md

@@ -83,6 +83,15 @@ mini_app_reload({ appId })  // { ok, errors, compiled, committed? }
 
 ## UI（@monkey-mini-app/ui）
 
+**组件库是「参考 / 便利」，不是硬性规范。** 它只是帮你省掉重复造轮子——合适的场景直接用，但**别为了用组件而用**。允许完全自由的发挥：
+
+- **先判断**：这个 UI 有没有现成组件？**有且合适 → 用**（省 token、风格统一）；**没有、或要独特视觉/交互、或用户明确要「自由发挥」→ 用原生元素（`div`/`span`/`button`/`input`/`table`/`svg`…）+ Tailwind classes 自行实现**，不用迁就组件库去硬凑。
+- **可混用**：骨架（卡片/页头/弹窗）用库组件，细节或视觉特殊处用原生 + Tailwind。
+- **自由发挥的边界**：原生元素 + Tailwind 随意；但 UI 仍**只能** import `react` / `@monkey-mini-app/ui` / `@monkeyagent/host` / 相对 `./lib`（编译器限制，**不能 import 任意 npm 包**）。需要图表/图标/编辑器等能力时从 `@monkey-mini-app/ui` 拿，或自己用 CSS/SVG 实现。
+- **不用管的**：`UiProvider` host 自动包裹；布局用 Tailwind classes（库里没有 Stack/Text 这类布局件）。
+
+下面是「常用姿势」示例，**不是唯一写法**——复杂/特殊 UI 完全可以全手写。
+
 ```tsx
 import { useEffect, useState } from "react";
 import { Button, Input, Card, CardContent, CardHeader, CardTitle, Textarea } from "@monkey-mini-app/ui";

package/skills/monkey-mini-app/references/contracts/donut-chart.md

@@ -11,8 +11,10 @@
 | field | type | required | note |
 |---|---|:---:|---|
 | `center` | `string \| undefined` |  |  |
+| `className` | `string \| undefined` |  |  |
 | `config` | `ChartConfig` | ✓ |  |
 | `data` | `Slice[]` | ✓ |  |
+| `size` | `number \| undefined` |  |  |
 
 ## Types
 

package/skills/monkey-mini-app/references/contracts/gauge.md

@@ -10,5 +10,7 @@
 
 | field | type | required | note |
 |---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
 | `label` | `string \| undefined` |  |  |
+| `size` | `number \| undefined` |  |  |
 | `value` | `number` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/progress-ring.md

@@ -10,4 +10,6 @@
 
 | field | type | required | note |
 |---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `size` | `number \| undefined` |  |  |
 | `value` | `number` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/radar-chart.md

@@ -10,9 +10,11 @@
 
 | field | type | required | note |
 |---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
 | `config` | `ChartConfig` | ✓ |  |
 | `data` | `{ label: string; value: number; }[]` | ✓ |  |
 | `dataKey` | `string \| undefined` |  |  |
+| `size` | `number \| undefined` |  |  |
 
 ## Types
 

package/skills/monkey-mini-app/references/contracts/sparkline.md

@@ -10,4 +10,5 @@
 
 | field | type | required | note |
 |---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
 | `data` | `{ value: number; }[]` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/stacked-bar-chart.md

@@ -10,6 +10,7 @@
 
 | field | type | required | note |
 |---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
 | `config` | `ChartConfig` | ✓ |  |
 | `data` | `Record<string, string \| number>[]` | ✓ |  |
 | `keys` | `string[]` | ✓ |  |