dsh-fou 0.2.0 → 0.3.0

package/client.js

@@ -185,6 +185,10 @@ window.__ModuleLoader__.load({
       pillCrossHint: '点一下进入会话列表（滚轮切会话）',
       pillListHint: '展开会话列表（直接选）',
       pillSlotHint: '切换应用（点一下换下一个）',
+      firstRunHint: '滚轮切功能 · Shift+滚轮切应用 · 右键开间 · 对会话说「给我一份 checklist」',
+      deskTitle: '桌布',
+      settingsTitle: '设置',
+      addNoSession: '先开一个会话，我才好替你说话',
       noSession: '没有活动会话',
       noSessionHint: '打开一个会话后，就能从这里发消息',
       noScope: '会话作用域不可用',
@@ -268,6 +272,10 @@ window.__ModuleLoader__.load({
       pillCrossHint: 'Click to scrub sessions (wheel to switch)',
       pillListHint: 'Open session list (pick directly)',
       pillSlotHint: 'Switch app (click to cycle)',
+      firstRunHint: 'Scroll to switch pane · Shift+scroll to switch app · Right-click for the pane · Say "give me a checklist"',
+      deskTitle: 'Tablecloth',
+      settingsTitle: 'Settings',
+      addNoSession: 'Open a session first, then I can speak for you',
       noSession: 'No active session',
       noSessionHint: 'Open a session and you can message it from here',
       noScope: 'Session scope unavailable',
@@ -1185,6 +1193,23 @@ window.__ModuleLoader__.load({
       // 切换只用**点击左栏**，不用滚轮 —— 滚轮已经归三态了，不能再分一个含义。
       const [pillApp, setPillApp] = React.useState(null);
       const [pillAppTick, setPillAppTick] = React.useState(0);
+      // 首次教学（2026-11-10）：localStorage 里没有 fou.seen.v1 就显示一句怎么用。
+      const SEEN_KEY = 'fou.seen.v1';
+      const [learning, setLearning] = React.useState(() => {
+        try {
+          return window.localStorage.getItem(SEEN_KEY) !== '1';
+        } catch (error) {
+          return false;
+        }
+      });
+      const markSeen = React.useCallback(() => {
+        try {
+          window.localStorage.setItem(SEEN_KEY, '1');
+        } catch (error) {
+          /* storage unavailable */
+        }
+        setLearning(false);
+      }, []);
       // 横滚（2026-11-09）：简讯放不下才滚。用 ref 量真实宽度，别靠字数猜。
       const pillTextRef = React.useRef(null);
       const [pillOverflow, setPillOverflow] = React.useState(false);
@@ -1216,6 +1241,12 @@ window.__ModuleLoader__.load({
        *  硬挂载（sheet.mount）不属于这三种，单独记 'mount'（三个图标都不亮）。 */
       const sheetMode = sheet ? (sheet.mount ? 'mount' : modeOfUrl(sheet.url)) : 'browse';
 
+      // 桌面（2026-11-10）：右键 → 打开桌面。用 ref 让"React 之外"的右键处理器能调它。
+      // ⚠ 必须**声明在使用之前** —— openDesk 一赋值就读它。
+      //   2026-11-10 踩过 TDZ：`Cannot access before initialization`，
+      //   整个 CourierBar 崩掉，浮游直接从页面上消失（用户："浮游坏了"）。
+      const deskOpenRef = React.useRef(null);
+
       /** 三个模式图标点下去：换页（同一个框，换内容）。 */
       const openModeSheet = (want) => {
         const params = new URLSearchParams();
@@ -1253,6 +1284,46 @@ window.__ModuleLoader__.load({
         setMode('panel');
       };
 
+      // ── 桌面（2026-11-10 用户："右键打开一个桌面"）
+      //
+      // 它是**摊开的菜单**：原来右键里藏着的（浏览/编辑/挂板/挂靠/设置），
+      // 全摆在这一页的图标上。判据：**不告诉用户有什么，把东西摆出来让他看见。**
+      //
+      // 坞条目通过 URL 传过去（桌面是 iframe，读不到浮游的 React 状态）。
+      // ⚠ URL 有长度上限，但坞条目一般 <10 个，够用。
+      const openDesk = () => {
+        const params = new URLSearchParams();
+        if (activeId) {
+          params.set('notify', activeId);
+          params.set('notifyName', activeTitle || '');
+        }
+        const items = dockEntries
+          .map((entry) => ({
+            id: entry.id,
+            label: entry.label || entry.id,
+            icon: entry.icon || '',
+          }))
+          .filter((item) => item.id !== 'fou.hop');
+        if (items.length > 0) params.set('dock', JSON.stringify(items));
+        const qs = params.toString();
+        const url = '/dsh-fou/desk.html' + (qs ? '?' + qs : '');
+        setRecentOpen(false);
+        setMenuTab(null);
+        setSheet({ url, title: t('deskTitle') });
+        setMode('panel');
+      };
+      deskOpenRef.current = openDesk;
+
+      // 设置页（2026-11-10 用户第 1 条）：点 ⚙ 打开一**页**，不是一个菜单。
+      // 判据：**菜单回答"能做什么"，设置页回答"现在是什么"。**
+      const openSettings = () => {
+        setRecentOpen(false);
+        setMenuTab(null);
+        setMenu(null);
+        setSheet({ url: '/dsh-fou/settings.html?mode=' + encodeURIComponent(mode), title: t('settingsTitle') });
+        setMode('panel');
+      };
+
       // 把"打开这个 url"的能力交给 factory 里的链接右键处理器（它活在 React 之外）。
       // 挂载时注册，卸载时撤销；同时把"坞还没出来时收到的请求"补开一次。
       React.useEffect(() => {
@@ -1432,6 +1503,17 @@ window.__ModuleLoader__.load({
           return;
         }
         event.preventDefault();
+        // ── 右键 = 打开桌面（2026-11-10 用户："右键打开一个桌面"）
+        //
+        // 原来的右键菜单被**摊开**成了桌面上的图标（浏览/编辑/挂板/插件/设置）。
+        // 判据：**菜单是"告诉你有几项"，桌面是"把东西摆出来"。**
+        // ——而桌面能留白，菜单不能。
+        const open = deskOpenRef.current;
+        if (typeof open === 'function') {
+          open();
+          return;
+        }
+        // 兜底（正常不会走到）：桌面还没挂上时，退回旧菜单
         const box = { w: 196, h: 320 };
         setMenuTab(null);
         setMenu({
@@ -1938,6 +2020,92 @@ window.__ModuleLoader__.load({
             return;
           }
 
+          // 「设置页动了一下」（2026-11-10 用户第 1 条）：设置页是 iframe，
+          // 它只负责"显示当前值 + 报动作"，真正的改动在这里做。
+          if (data.type === 'fou:setting') {
+            const action = typeof data.action === 'string' ? data.action : '';
+            if (action === 'mode') {
+              const next = typeof data.value === 'string' ? data.value : '';
+              if (next === 'orb' || next === 'pill' || next === 'panel') {
+                setMode(next);
+                saveMode(next);
+              }
+              return;
+            }
+            if (action === 'reset') {
+              resetPos();
+              return;
+            }
+            if (action === 'collapse') {
+              collapse();
+              return;
+            }
+            return;
+          }
+
+          // 「桌面点了一个图标」（2026-11-10）：桌面是 iframe，它只负责"被点"，
+          // 真正的动作在这里执行 —— 因为它要动浮游自己的状态（形态 / 开间）。
+          //
+          // ⚠ 只用**已存在**的函数与状态（openModeSheet / dockEntries / setSheet / setMode /
+          //   setMenu / setMenuTab）。设置仍走旧菜单 —— 它是浮游自身的开关，不需要"摆出来"。
+          if (data.type === 'fou:desk') {
+            const action = typeof data.action === 'string' ? data.action : '';
+            if (action === 'browse' || action === 'edit' || action === 'panels') {
+              setMenu(null);
+              setMenuTab(null);
+              openModeSheet(action === 'panels' ? 'form' : action);
+              return;
+            }
+            if (action === 'dock') {
+              const id = typeof data.id === 'string' ? data.id : '';
+              if (!id) return;
+              const entry = dockEntries.find((item) => item && item.id === id);
+              if (!entry) return;
+              setMenu(null);
+              setMenuTab(null);
+              // 硬挂载优先（2026-11-08）：有 mount 就挂进开间，是活的界面；
+              // 没有 mount 才退回 run（遥控 / 让它自己弹窗）。
+              if (typeof entry.mount === 'function') {
+                setSheet({ mount: entry, title: entry.label });
+                setMode('panel');
+                return;
+              }
+              if (typeof entry.run === 'function') {
+                try {
+                  entry.run();
+                } catch (error) {
+                  /* 坏条目不能弄坏桌面 */
+                }
+              }
+              return;
+            }
+            if (action === 'setting') {
+              openSettings();
+              return;
+            }
+            // ➕ 挂载插件（2026-11-10 用户第 3 条）：
+            // **不写一句"你可以这样做"，而是**替他说出口**。
+            // 桌布上点 ➕ → 浮游给当前会话发一条消息 → agent 收到就去做。
+            // 判据：文字的引导要求用户自己做一步；界面的引导是替他把那步做了。
+            if (action === 'addPlugin') {
+              const id = activeIdRef.current;
+              if (!id) {
+                setFailure(t('addNoSession'));
+                setMode('panel');
+                return;
+              }
+              const say = notifyRef.current;
+              if (typeof say === 'function') {
+                void say(
+                  id,
+                  '浮游的桌布上还空着一个位置。帮我把插件挂上去 —— 先读 skill `fou-mount`，再按里面的模板接一个。'
+                );
+              }
+              return;
+            }
+            return;
+          }
+
           // 「记住一件东西」：编辑器的 [保存] 落稿后回报，记进"最近编辑"，
           // 让"最近"记的是**稿**，而不是"我打开过编辑器"（2026-11-08）。
           if (data.type === 'fou:remember') {
@@ -2148,7 +2316,14 @@ window.__ModuleLoader__.load({
       })();
 
       const latest = rows.length > 0 ? rows[rows.length - 1] : null;
-      const pillText = latest ? pickBrief(latest.text) || t('hint') : t('hint');
+      // 首次安装的一次性教学（2026-11-10「引导四格」的「用户·主动」）：
+      // 装好后第一次打开，胶囊不显示"暂无会话"，而是显示一句怎么用；
+      // 一滚轮就写标记，从此不再出现。**不弹窗、不打扰** —— 它只在"用户第一次看它"时说话。
+      const pillText = learning
+        ? t('firstRunHint')
+        : latest
+          ? pickBrief(latest.text) || t('hint')
+          : t('hint');
       // 简讯排版（2026-11-09 用户）：开头是**会话名**，中间只留一个「·」，
       // 结尾留空隔 —— 这样滚起来每一段都像"一条信息"，有整体感。
       // 会话名太长就截短：胶囊空间有限，名字只是"定位"，不是内容。
@@ -2219,6 +2394,8 @@ window.__ModuleLoader__.load({
         const el = mode === 'orb' ? bubbleRef.current : pillWrapRef.current;
         if (!el) return undefined;
         const onWheel = (event) => {
+          // 首次教学：任何一次滚轮都算"看过了"。
+          if (learning) markSeen();
           // 列表浮层自己会滚 —— 在它的范围内**不劫持**滚轮。
           // 判据：任何"浮在上面"的可滚动区域，必须在它自己的范围内接管滚轮。
           // （否则滚列表 = 滚胶囊，列表永远滚不动。）

package/desk.html

@@ -0,0 +1,291 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>桌布 · 浮游</title>
+<style>
+  /* ── 白布 ──────────────────────────────────────────────
+     2026-11-10 用户："右键打开一个桌面。" → 后改名「桌布」：
+     "截至目前 它是铺在 DSH 上的。即使以后独立了，它也要铺在 Windows 上。"
+     —— 所以「桌布」不是"桌面"，它是**一层布**，盖在别的东西上。
+     这一页**不是菜单**，是**摊开的菜单**：原来右键里藏的东西，全摆在这儿。
+
+     三条判据（用户定的）：
+       ① 空白本身是内容 —— 桌布不填满，留白就是"还能放"。
+       ② 图标是可点的，不是文字说明 —— 点一下比读一句快。
+       ③ 分组靠间距，不靠标题 —— 用户："我们用设计做说明。"
+  */
+  :root {
+    --ink: #1f2937;
+    --dim: #6b7280;
+    --line: #e5e7eb;
+    --card: #ffffff;
+    --hover: #f3f4f6;
+    --accent: #2563eb;
+  }
+  * { box-sizing: border-box; }
+  html, body { height: 100%; margin: 0; }
+  body {
+    font: 13px/1.5 -apple-system, "Segoe UI", "Microsoft YaHei", system-ui, sans-serif;
+    color: var(--ink);
+    /* 白布：极浅的暖灰，不是纯白 —— 纯白在毛玻璃上会发灰 */
+    background: linear-gradient(180deg, #fbfbfc 0%, #f7f8fa 100%);
+    display: flex;
+    flex-direction: column;
+    overflow: auto;
+  }
+
+  header {
+    flex: none;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 10px 14px 8px;
+    border-bottom: 1px solid var(--line);
+    background: rgba(255, 255, 255, .7);
+    backdrop-filter: blur(8px);
+    position: sticky;
+    top: 0;
+    z-index: 2;
+  }
+  header .title { font-weight: 600; font-size: 13px; }
+  header .grow { flex: 1; }
+  header .hint { color: var(--dim); font-size: 11px; }
+
+  main {
+    flex: 1;
+    padding: 18px 14px 36px;
+    display: flex;
+    flex-direction: column;
+    gap: 26px;
+  }
+
+  /* 一组图标 */
+  .group { display: flex; flex-direction: column; gap: 10px; }
+  /* 组与组之间没有标题，只有一条极淡的分隔 + 间距（判据③） */
+  .grid {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 10px;
+  }
+
+  .tile {
+    width: 84px;
+    height: 84px;
+    border: 0;
+    border-radius: 14px;
+    background: var(--card);
+    box-shadow: 0 1px 2px #0000000a, 0 4px 14px #0000000d;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 6px;
+    cursor: pointer;
+    color: var(--ink);
+    font: inherit;
+    transition: transform .12s ease, box-shadow .12s ease, background .12s ease;
+    padding: 6px;
+  }
+  .tile:hover {
+    background: #fff;
+    transform: translateY(-1px);
+    box-shadow: 0 2px 4px #0000000f, 0 8px 22px #00000014;
+  }
+  .tile:active { transform: translateY(0) scale(.985); }
+  .tile .ico { font-size: 24px; line-height: 1; }
+  .tile .nm {
+    font-size: 11px;
+    color: var(--dim);
+    max-width: 72px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  /* ➕ 磁贴：虚线边 —— 它不是一个东西，是一个位置（"还能放"的那个口子） */
+  .tile-add {
+    background: transparent;
+    border: 1.5px dashed #cfd6e0;
+    box-shadow: none;
+  }
+  .tile-add:hover {
+    background: #fff;
+    border-color: var(--accent);
+    box-shadow: 0 2px 8px #2563eb1a;
+  }
+  .tile-add .ico { color: var(--accent); font-size: 26px; }
+  .tile-add .nm { color: var(--accent); }
+
+  /* 插件图标：给一点颜色，因为它们是"别人的东西" */
+  .tile.plugin { background: #fff; }
+  .tile.plugin .ico { filter: saturate(1.1); }
+
+  /* 空组：不画空盒子，只留一句灰话（判据①） */
+  .empty { color: var(--dim); font-size: 11.5px; padding: 2px 2px 0; }
+
+  /* 右下角：给"还能放什么"留一个视觉上的口子 */
+  .tail {
+    margin-top: auto;
+    padding-top: 18px;
+    color: #b6bcc6;
+    font-size: 11px;
+    text-align: center;
+  }
+  .tail code {
+    background: #eef1f5;
+    padding: 1px 5px;
+    border-radius: 4px;
+    color: #4b5563;
+  }
+</style>
+</head>
+<body>
+<header>
+  <span class="title">桌布</span>
+  <span class="grow"></span>
+  <span class="hint" id="hint"></span>
+</header>
+
+<main id="main">
+  <!-- ① 功能 -->
+  <div class="group" id="gFunc">
+    <div class="grid">
+      <button class="tile" data-act="browse" title="回到最近打开的那一页">
+        <span class="ico">👁</span><span class="nm">浏览</span>
+      </button>
+      <button class="tile" data-act="edit" title="编辑即保存、发送即落稿">
+        <span class="ico">✏️</span><span class="nm">编辑</span>
+      </button>
+      <button class="tile" data-act="panels" title="盛放挂表的地方">
+        <span class="ico">📌</span><span class="nm">挂板</span>
+      </button>
+    </div>
+  </div>
+
+  <!-- ② 插件（从浮游传进来） -->
+  <div class="group" id="gPlug" style="display:none">
+    <div class="grid" id="plugGrid"></div>
+  </div>
+
+  <!-- ③ 设置（只留一个入口 —— 点了回浮游自己的设置菜单） -->
+  <div class="group" id="gSet">
+    <div class="grid">
+      <button class="tile" data-act="setting" title="浮游自身的设置：复位位置 / 收起 / 躲鼠标">
+        <span class="ico">⚙</span><span class="nm">设置</span>
+      </button>
+    </div>
+  </div>
+
+  <div class="tail" id="tail"></div>
+</main>
+
+<script>
+(function () {
+  'use strict';
+
+  // ── 和浮游通信 ──────────────────────────────────────────
+  // 协议（2026-11-10）：`type` 以 `fou:` 开头，挂板/桌布会被浮游原样转发。
+  function tell(action, extra) {
+    var msg = { type: 'fou:desk', action: action };
+    if (extra) for (var k in extra) msg[k] = extra[k];
+    try {
+      window.parent.postMessage(msg, window.location.origin);
+    } catch (e) { /* 不在浮游里就静默 */ }
+  }
+
+  // ── 读浮游传进来的坞条目 ────────────────────────────────
+  // URL: ?dock=<encodeURIComponent(JSON)>
+  // 形如 [{"id":"song.dock","label":"地颂","icon":"♫"}, …]
+  function readDock() {
+    try {
+      var q = new URLSearchParams(location.search).get('dock');
+      if (!q) return [];
+      var arr = JSON.parse(q);
+      if (!Array.isArray(arr)) return [];
+      return arr.filter(function (x) {
+        return x && typeof x.id === 'string' && x.id !== '';
+      });
+    } catch (e) {
+      return [];
+    }
+  }
+
+  function paintDock() {
+    var dock = readDock();
+    var grid = document.getElementById('plugGrid');
+    var group = document.getElementById('gPlug');
+    if (!dock.length) {
+      // 没有插件：给一个 ➕（2026-11-10 用户第 3 条）。
+      // 判据：**不是写一句"你可以这样做"，是给一个能点的东西。**
+      // 点击 → 浮游给当前会话发一条消息，让 agent 去做（它知道自己会什么）。
+      group.style.display = '';
+      grid.innerHTML = '';
+      var add = document.createElement('button');
+      add.className = 'tile tile-add';
+      add.dataset.act = 'addPlugin';
+      add.title = '添加插件 —— 会请会话说一声，让 agent 帮你挂';
+      var ai = document.createElement('span');
+      ai.className = 'ico';
+      ai.textContent = '＋';
+      var an = document.createElement('span');
+      an.className = 'nm';
+      an.textContent = '挂载插件';
+      add.appendChild(ai);
+      add.appendChild(an);
+      grid.appendChild(add);
+      return;
+    }
+    group.style.display = '';
+    grid.innerHTML = '';
+    dock.forEach(function (item) {
+      var b = document.createElement('button');
+      b.className = 'tile plugin';
+      b.dataset.act = 'dock';
+      b.dataset.id = item.id;
+      b.title = String(item.label || item.id);
+      var ico = document.createElement('span');
+      ico.className = 'ico';
+      ico.textContent = String(item.icon || '●');
+      var nm = document.createElement('span');
+      nm.className = 'nm';
+      nm.textContent = String(item.label || item.id);
+      b.appendChild(ico);
+      b.appendChild(nm);
+      grid.appendChild(b);
+    });
+  }
+
+  // ── 点击 ────────────────────────────────────────────────
+  document.addEventListener('click', function (event) {
+    var el = event.target;
+    while (el && el !== document.body) {
+      if (el.classList && el.classList.contains('tile')) break;
+      el = el.parentNode;
+    }
+    if (!el || el === document.body) return;
+    var act = el.dataset.act;
+    if (!act) return;
+    if (act === 'dock') tell('dock', { id: el.dataset.id });
+    else tell(act);
+  });
+
+  // ── 空白态的教学：只在"什么都没有"时说话 ────────────────
+  function paintTail() {
+    var dock = readDock();
+    var tail = document.getElementById('tail');
+    document.getElementById('hint').textContent = '点图标即可';
+    if (!dock.length) {
+      tail.textContent = '桌布是留白的 —— 它不填满，因为还能放。';
+    } else {
+      tail.textContent = '';
+    }
+  }
+
+  paintDock();
+  paintTail();
+})();
+</script>
+</body>
+</html>

package/docs/20-/346/214/202/346/235/277/345/215/217/350/256/256.md

@@ -1,35 +1,124 @@
 # 挂板协议
 
-> 建立：2026-11-06 16:25 ｜ 提出：用户 ｜ 性质：📸 **快照**（必须覆盖，写水位）
-> 水位：2026-11-06 16:25
-> 上游：`00-总纲.md` §三 ｜ 上游依赖：`10-坞协议.md`（准入）
-> **管什么**：挂什么、怎么挂、挂上去之后怎么活
-> **不管什么**：坞怎么准入（看 10）；表怎么收集人输入（看 30）
+> 建立：2026-11-06 16:25 ｜ **重写：2026-11-10 14:55**（补"给 Agent 的第一章"）
+> 性质：📸 **快照**（必须覆盖，写水位）｜ **水位：2026-11-10 14:55**
+> **重写原因**：2026-11-10 的「**在场者测试**」—— 一台什么都不知道的新机器，五轮才用上挂板，
+> 且造出了**纯 html 而不是挂表**。根因：**这份协议是"给我们看的技术规格"，不是"给 Agent 的操作指引"。**
+> **本文的检验标准**：**只给这份文档、撤掉所有人，一个 Agent 能不能做对。**
+> 上游：`00-总纲.md` §三
 
 ---
 
-## 一、一句话
+## 第零章 ⭐ 给 Agent 的（读完这一章就够动**手**了）
+
+## 0.1 三个词（先立词汇）
+
+| 词 | 定义 |
+|---|---|
+| **挂板** | **专门用来盛放挂表的界面**。它是容器，不是内容。 |
+| **挂表** | **一张能交互、能提交反馈的表** —— 能勾选、能写备注、点提交后**有东西落盘**。 |
+| **链接** | **把一张挂表挂上挂板的动作**。（"把它挂上去"） |
+
+> **⚠ 最容易错的一点**：**"一张漂亮的 HTML 页面"不是挂表。**
+> **挂表必须能**交互 + 提交 + 落盘**。少了提交链，它就只是网页。**
+
+## 0.2 当用户这么说，你要这么做
+
+| 用户说 | 你做 |
+|---|---|
+| **"用挂表问我"** / **"做个表给我填"** / **"列出来我勾"** | **造一张挂表** → **链接到挂板** → 告诉用户"已挂到挂板，打开看" |
+| **"给我一份 checklist，我们对照着打勾、写评语"** | 造**清单型**挂表（多行勾选 + 每行备注） |
+| **"一份验收表，逐项验收并评价，另有评论区我要打字"** | 造**验收型**挂表（勾选网格 + 大文本区） |
+| **"批注表，我要按段落批注"** | 造**批注型**挂表（分段落 + 每段一个文本区） |
+| **"挂板上有什么"** | 列挂板上的表（调 `/dsh-fou/panels`） |
+| **"在浮游里打开这个链接"** | 挂一个 `kind:"url"` 条目（见 §三） |
+
+**→ 用户说的可能是**任何说法**。**你的判断依据不是"他用了哪个词"，是"他要一张能填的表"。**
+
+## 0.3 三个示范句（给用户看的，你照着理解意图）
+
+> **① "给我一份 check list，我们要对照着打勾，写评语。"**
+> **② "一份验收表，逐项验收并评价，另有评论区我要打字。"**
+> **③ "批注表，我要按段落批注。"**
+
+**——这三个句式覆盖三种交互形态。用户说别的，你也照这三种的骨架变。**
+
+## 0.4 挂表长什么样（**照抄这一份，别自己发明**）
+
+**参考实现**：`accept.html`（同仓库根目录，19 KB，**是唯一被验证过的挂表**）。
+
+**它由五条链组成，一条都不能少**：
+
+| # | 链 | 在 `accept.html` 里对应 |
+|---|---|---|
+| **1** | **标题 + 说明** | `<h1 id="sheetTitle">` + `.note` |
+| **2** | **可勾选的行**（每行：勾选 + 备注） | `<table id="grid">` |
+| **3** | **自由文本区**（可多个，如 评论区/优化区/话痨区） | 三个 `<textarea>` |
+| **4** | **[提交] 按钮 → POST** | `fetch('/dsh-fou/accept', {method:'POST', …})` |
+| **5** | **草稿自动存**（localStorage，刷新不丢） | `saveDraft()` / `loadDraft()` |
+
+**第 4 条是最容易漏的** —— **漏了它，你得到的就是"纯 html"，不是挂表。**
+
+> # **判据：没有"提交后落盘"的表，不算挂表。**
+
+## 0.5 怎么算做对了（当场能验）
+
+1. **挂板里能看到它**（打开挂板 → 有这一条，标着「验收表 / 批注表 / 清单」之类）
+2. **能勾、能写字**（鼠标点得动）
+3. **点提交 → 有回应**（页面提示已保存 / 或生成了文件）
+4. **`D:\dsh-work\_挂板\` 下多了文件**（`.json` + `.md`）
+
+**四条全中才算成。** 只中前两条 = 你造的只是个网页。
+
+## 0.6 做错了怎么办
+
+| 现象 | 原因 | 怎么修 |
+|---|---|---|
+| **挂板里是个纯网页，勾不了** | **自己发明了 HTML 结构** | 回去照 §0.4 五条链重做，或直接复制 `accept.html` 改内容 |
+| **能勾，但点提交没反应** | **没有 POST 那一步** | 加 `fetch` 到 `/dsh-fou/accept`（或你自己的路由） |
+| **提交了，但没文件** | **POST 的 body 格式不对** | 照 `accept.html` 的提交体抄 |
+| **挂板里根本没有** | **只生成了文件，没链接到挂板** | 调 `POST /dsh-fou/hang` 把它挂上去（见 §三） |
+| **刷新后填的东西没了** | 没做草稿自动存 | 加 `localStorage` 存/读 |
+
+---
+
+## 第一章 一句话
 
 > **挂板的能力是「挂」；它只管挂得住、看得见，不管挂的是什么。**
 
 ---
 
-## 二、形式开放（核心决定）
+## 第二章 形式开放（核心决定）
 
 **挂件类型**：
 
 | kind | 内容 | 落盘 |
 |---|---|---|
-| `html` | 一页 HTML | ✅ 存内容 |
+| `html` | 一页 HTML（**挂表就在这一类**） | ✅ 存内容 |
 | `md` / `text` / `json` | 文本 | ✅ 存内容 |
 | `path` 类（md/html 用 `path`） | **只读引用一个文件** | ❌ **不复制**，改了就变 |
 | **`url`** | **只记地址** | ❌ **不复制，永远最新** |
 
 **认不出的 `kind` 一律当 `text`，不报错** —— **"挂"不该因为格式失败。**
 
+## 挂表是 `html` 的一个**子集**（2026-11-10 明确）
+
+**挂表 = `kind:"html"` 且 `form: true`。**
+
+```json
+{ "id": "…", "title": "…", "kind": "html", "file": "x.html",
+  "form": true, "formKind": "accept" }
+```
+
+**`formKind` 是**自由文本**（`accept` / `annotate` / `review` / `reply` / 你自己起的名字都行）
+—— 挂板只拿它做首标签，**认不出的照样显示原值，不会隐藏。**
+
+> # **我们定的只是"进门的规矩"，不是"屋里的摆法"。**
+> **——鼓励用户创造自己的挂表。**
+
 ---
 
-## 三、外部 URL 可作为挂件（2026-11-06 新增）
+## 第三章 外部 URL 可作为挂件
 
 **契约**：
 
@@ -47,24 +136,16 @@ body: { "title": "任意标题", "kind": "url", "url": "http://127.0.0.1:端口/
 3. **任何 HTTP 地址都可以**（本机服务 / 外网页面）
 4. **同一 `id` 重挂 = 覆盖**（不重复出现）
 
-**已验证的实例（2026-11-06 16:00）**：
+**验证过的实例（2026-11-06）**：
 
 | 挂件 | 地址 | 用途 |
 |---|---|---|
 | `pedia-docs-8799` | `http://127.0.0.1:8799/` | 百科的官方文档搜索（649 篇） |
 | `accept-*` | `/dsh-fou/accept?sheet=…` | 验收表（本插件自己的页面） |
 
-**这就是"官方浮窗做不到、挂板能做到"的那条**：**官方浮窗只装文件；挂板能装 URL 与活页面。**
-
 ---
 
-## 四、链接入口（2026-11-06 新增，待实现）
-
-**需求（用户原话）**：
-
-> **"左键单击/右键选择 URL 直接在浮游中打开。我预估这是低本高收的。"**
-
-**契约（要有，先定）**：
+## 第四章 链接入口：右键「在浮游打开」
 
 > **任何在 DSH 界面里可右键的链接，菜单里应有一项「在浮游打开」；**
 > **选中后，等价于调一次 `hang({ kind:'url', url: <该链接> })`。**
@@ -75,37 +156,40 @@ body: { "title": "任意标题", "kind": "url", "url": "http://127.0.0.1:端口/
 |---|---|---|
 | 多标签 | ✅ | ✅（挂板可并列） |
 | 退出保存 | ✅ | ✅（index.json） |
-| 标签页↔浮窗互转 | ✅ | ✅（挂板本身就是浮游里的） |
 | **换会话还在吗** | ❌ **没了** | ✅ **还在** |
 
 > **差异只有一条，但它是根：右栏跟会话，浮游跟人。**
 
-**实现约束（先写死，防止越界）**：
+**实现约束**：
 
-1. **只做右键，不做左键单击** —— 左键单击会破坏"点链接用浏览器打开"的预期
-2. **不改官方菜单的既有三项**（在侧边栏打开 / 外部浏览器 / 复制链接）
-3. 若官方将来自己加「在浮游打开」，**让官方**（见总纲 §三④ 协议先行）
+1. **只做右键，不做左键单击**
+2. **不改官方菜单的既有三项**
+3. 若官方将来自己加「在浮游打开」，**让官方**（见总纲 §三④）
+
+**✅ 已实现（2026-11-08）**：真实目标家族是 `url`（值 `{sessionId,url}`）/ `file` / `directory` / `image` / `tab` / `session`；`resolve` 收到的是 **`value` 直接体**。
 
 ---
 
-## 五、挂上去之后怎么活（L2）
+## 第五章 挂上去之后怎么活（L2）
 
 **两条约定，别的一条都不用管**：
 
-### 5.1 结果落盘：挂件自己 POST 自己的路由
+## 5.1 结果落盘：挂件自己 POST 自己的路由
 
 **挂板不帮忙存档** —— 它不知道你的数据长什么样。
 
-### 5.2 要通知会话：发一条 `fou:` 开头的消息
+**挂表的参考实现**：`POST /dsh-fou/accept` → 写成 `<时间>.json` + `<时间>.md`，并更新 `latest`。
+
+## 5.2 要通知会话：发一条 `fou:` 开头的消息
 
 ```js
 window.parent.postMessage({ type: 'fou:your-event', … }, window.location.origin);
 ```
 
-- **`type` 必须以 `fou:` 开头** —— **挂板会原样往上转一层**给浮游
+- **`type` 必须以 `fou:` 开头** —— 挂板会原样往上转一层给浮游
 - **已知可用**：`fou:accept-saved`（{ notify, notifyName, summary, mdPath }）
 
-### 5.3 通知对象从哪来：URL 参数
+## 5.3 通知对象从哪来：URL 参数
 
 **浮游打开挂板时会带** `?notify=<会话id>&notifyName=<名字>`，**挂板自动转给 `url` 挂件**。
 
@@ -113,7 +197,7 @@ window.parent.postMessage({ type: 'fou:your-event', … }, window.location.origi
 
 ---
 
-## 六、五条纪律
+## 第六章 五条纪律
 
 1. **软依赖** —— 挂板不在，你的东西照样能用
 2. **不替你容错** —— 挂件内部报错由挂件自己负责
@@ -123,11 +207,23 @@ window.parent.postMessage({ type: 'fou:your-event', … }, window.location.origi
 
 ---
 
-## 七、已知未做
+## 第七章 已知未做
 
 | # | 事 | 状态 |
 |---|---|---|
-| 1 | **链接右键「在浮游打开」** | 🔴 **契约定好，未实现** |
-| 2 | 挂件「Open with」（用外部应用打开） | 🔴 未做（抄官方的，见「游窗对」§三） |
-| 3 | 错误兜底四种（找不到/太大/非文本/服务不可用） | 🟡 提示很薄 |
-| 4 | 挂件排序 / 分组 | 🔴 现在只有"最新在前" |
+| 1 | **界面空白态提示**（浏览/挂表/挂载三处，各给一句可复制的命令） | 🔴 未做（见 `60-设计-引导四格.md`） |
+| 2 | **checklist / 评分表模板**（补齐第三、四种交互形态） | 🔴 未做 |
+| 3 | 挂件「Open with」（用外部应用打开） | 🔴 未做 |
+| 4 | 错误兜底四种（找不到/太大/非文本/服务不可用） | 🟡 提示很薄 |
+| 5 | 挂件排序 / 分组 | 🔴 现在只有"最新在前" |
+
+---
+
+## 附录：在场者测试（怎么检验这份协议是否完整）
+
+> **撤掉所有在场者，只给这份文档，让一个什么都不知道的 Agent 做一遍。**
+> **它做对了 → 协议完整；它做错了 → 错的那一步就是协议的空白。**
+
+**2026-11-10 实测结论**：旧版协议**失败**（造出纯 html）。
+**根因**：协议里没写"挂表必须有提交链"、没写"照抄 `accept.html`"、没写"怎么算做对"。
+**本章（第零章）就是补这三样。**

package/index.js

@@ -23,6 +23,8 @@ const ROUTES = {
   sheet: '/dsh-fou/sheet',
   panels: '/dsh-fou/panels',
   panelsPage: '/dsh-fou/panels.html',
+  deskPage: '/dsh-fou/desk.html',
+  settingsPage: '/dsh-fou/settings.html',
   panel: '/dsh-fou/panel',
   hang: '/dsh-fou/hang',
   editor: '/dsh-fou/editor.html',
@@ -41,6 +43,8 @@ const MAX_PANEL_BYTES = 4 * 1024 * 1024
 const HERE = dirname(fileURLToPath(import.meta.url))
 const TABLE_FILE = join(HERE, 'accept.html')
 const PANELS_FILE = join(HERE, 'panels.html')
+const DESK_FILE = join(HERE, 'desk.html')
+const SETTINGS_FILE = join(HERE, 'settings.html')
 const EDITOR_FILE = join(HERE, 'editor.html')
 const VIEW_FILE = join(HERE, 'view.html')
 const DRAFT_DIR_NAME = '_草稿'
@@ -670,6 +674,38 @@ export function apply(ctx, config) {
           }
         },
       ],
+      [
+        // 桌面（2026-11-10 用户："右键打开一个桌面"）
+        // 它是"摊开的菜单"：原来右键里藏着的东西，全摆在这一页上。
+        ROUTES.deskPage,
+        async (req, res) => {
+          if (req.method !== 'GET') {
+            sendJSON(res, 405, { error: '只支持 GET' })
+            return
+          }
+          try {
+            sendHTML(res, 200, await readFile(DESK_FILE, 'utf8'))
+          } catch (error) {
+            sendHTML(res, 500, '<h1>桌面页缺失</h1><p>' + DESK_FILE + '</p>')
+          }
+        },
+      ],
+      [
+        // 设置页（2026-11-10 用户第 1 条）：点 ⚙ 打开的是"一页"，不是"一个菜单"。
+        // 判据：菜单回答"能做什么"，设置页回答"现在是什么"。
+        ROUTES.settingsPage,
+        async (req, res) => {
+          if (req.method !== 'GET') {
+            sendJSON(res, 405, { error: '只支持 GET' })
+            return
+          }
+          try {
+            sendHTML(res, 200, await readFile(SETTINGS_FILE, 'utf8'))
+          } catch (error) {
+            sendHTML(res, 500, '<h1>设置页缺失</h1><p>' + SETTINGS_FILE + '</p>')
+          }
+        },
+      ],
       [
         ROUTES.panels,
         async (req, res) => {

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "dsh-fou",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "description": "A floating container layer over DSH: chat without leaving the page, travel between sessions, and open anything — a web page, a file, or a plugin's own UI — in one pane. · 浮游：DSH 之上的一层悬浮容器 —— 不离开当前位置，就能碰到别处。",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DSL-Orange/dsh-fou.git"
+  },
+  "homepage": "https://github.com/DSL-Orange/dsh-fou#readme",
+  "bugs": {
+    "url": "https://github.com/DSL-Orange/dsh-fou/issues"
+  },
+  "license": "MIT",
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
@@ -16,6 +25,8 @@
     "panels.html",
     "editor.html",
     "view.html",
+    "desk.html",
+    "settings.html",
     "cordis.patch.yml",
     "locale/*.json",
     "README.md",

package/panels.html

@@ -30,6 +30,9 @@
   iframe { flex:1; border:0; background:#fff; }
   pre { flex:1; margin:0; padding:14px 16px; overflow:auto; white-space:pre-wrap; overflow-wrap:anywhere; font:12.5px/1.6 ui-monospace,Consolas,"Cascadia Mono",monospace; background:#fff; }
   .empty { margin:auto; color:var(--dim); text-align:center; padding:24px; line-height:1.9; }
+  .empty .say { margin:6px auto; max-width:420px; padding:5px 10px; border:1px dashed var(--line); border-radius:8px; color:#1f2937; background:#fafbfd; font-size:12px; }
+  .empty .also { margin-top:10px; font-size:11px; }
+  .empty b { color:#111827; }
   .empty code { background:#eef1f5; padding:1px 5px; border-radius:4px; }
   .err { color:#b91c1c; padding:14px 16px; }
 </style>
@@ -47,8 +50,12 @@
   <div class="body" id="body">
     <div class="empty" id="empty">
       挂板是空的。<br />
-      把东西挂上来即可 —— <code>html</code> / <code>md</code> / <code>json</code> / <code>纯文本</code> 都行。<br />
-      <span style="font-size:11px">（宿主接口：<code>POST /dsh-fou/hang</code>）</span>
+      <b>对任意会话说下面任一句</b>，就能得到一张能填、能提交的表：
+      <div class="say">「给我一份 check list，我们对照着打勾、写评语」</div>
+      <div class="say">「一份验收表，逐项验收并评价，另有评论区我要打字」</div>
+      <div class="say">「批注表，我要按段落批注」</div>
+      <div class="also">也可以说「把这份内容挂到挂板上」——任何 <code>html</code> / <code>md</code> / <code>json</code> / 纯文本都行。</div>
+      <span style="font-size:10px;opacity:.5">（技术接口：<code>POST /dsh-fou/hang</code>）</span>
     </div>
   </div>
 </main>

package/settings.html

@@ -0,0 +1,185 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>设置 · 浮游</title>
+<style>
+  /* ── 设置页（2026-11-10 用户第 1 条）
+     原来点 ⚙ 弹的是"右键页"（一个菜单），这是错的：
+       · 菜单是"动作列表"，设置是"一组当前值"。
+       · 动作点完就消失；设置要**显示现在的状态**。
+     判据：**菜单回答"能做什么"，设置页回答"现在是什么"。**
+
+     用户自己也说了："尽管它现在会很空旷。"
+     —— 空旷是对的：设置项少，说明浮游自己该做的决定少。
+  */
+  :root {
+    --ink: #1f2937;
+    --dim: #6b7280;
+    --line: #e5e7eb;
+    --card: #fff;
+    --accent: #2563eb;
+  }
+  * { box-sizing: border-box; }
+  html, body { height: 100%; margin: 0; }
+  body {
+    font: 13px/1.6 -apple-system, "Segoe UI", "Microsoft YaHei", system-ui, sans-serif;
+    color: var(--ink);
+    background: linear-gradient(180deg, #fbfbfc 0%, #f7f8fa 100%);
+    overflow: auto;
+  }
+
+  header {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 10px 14px 8px;
+    border-bottom: 1px solid var(--line);
+    background: rgba(255, 255, 255, .7);
+    backdrop-filter: blur(8px);
+    position: sticky;
+    top: 0;
+    z-index: 2;
+  }
+  header .title { font-weight: 600; font-size: 13px; }
+  header .grow { flex: 1; }
+  header .hint { color: var(--dim); font-size: 11px; }
+
+  main { padding: 14px; display: flex; flex-direction: column; gap: 14px; }
+
+  .sec {
+    background: var(--card);
+    border-radius: 12px;
+    box-shadow: 0 1px 2px #0000000a, 0 4px 14px #0000000d;
+    overflow: hidden;
+  }
+  .sec > .label {
+    padding: 9px 14px 4px;
+    color: var(--dim);
+    font-size: 11px;
+    letter-spacing: .04em;
+  }
+  .row {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 10px 14px;
+    border-top: 1px solid #f1f3f6;
+  }
+  .row:first-of-type { border-top: 0; }
+  .row .name { flex: 1; }
+  .row .desc { color: var(--dim); font-size: 11px; }
+
+  /* 三选一：形态 */
+  .choice { display: flex; gap: 6px; }
+  .choice button {
+    border: 1px solid var(--line);
+    background: #fff;
+    color: var(--ink);
+    border-radius: 8px;
+    padding: 5px 12px;
+    font: inherit;
+    font-size: 12px;
+    cursor: pointer;
+    transition: all .12s ease;
+  }
+  .choice button:hover { border-color: #c7cfda; }
+  .choice button.on {
+    border-color: var(--accent);
+    color: var(--accent);
+    background: #eff4ff;
+    font-weight: 600;
+  }
+
+  /* 动作按钮 */
+  .act {
+    border: 1px solid var(--line);
+    background: #fff;
+    border-radius: 8px;
+    padding: 5px 12px;
+    font: inherit;
+    font-size: 12px;
+    cursor: pointer;
+    color: var(--ink);
+  }
+  .act:hover { background: #f7f8fa; border-color: #c7cfda; }
+
+  /* 说明 */
+  .foot {
+    color: #b6bcc6;
+    font-size: 11px;
+    text-align: center;
+    padding: 6px 0 20px;
+    line-height: 1.8;
+  }
+  .foot code { background: #eef1f5; padding: 1px 5px; border-radius: 4px; color: #4b5563; }
+</style>
+</head>
+<body>
+<header>
+  <span class="title">设置</span>
+  <span class="grow"></span>
+  <span class="hint" id="hint"></span>
+</header>
+
+<main>
+  <!-- 位置 -->
+  <div class="sec">
+    <div class="label">位置</div>
+    <div class="row">
+      <span class="name">把它送回原处
+        <div class="desc">拖动过后忘了在哪，点这个</div>
+      </span>
+      <button class="act" data-act="reset">复位位置</button>
+    </div>
+  </div>
+
+  <div class="foot" id="foot">
+    这里只剩一件事 —— 因为它别处做不到。<br>
+    形态在胶囊上滚一下就有，收起就是切到球。
+  </div>
+</main>
+
+<script>
+(function () {
+  'use strict';
+
+  function tell(action, extra) {
+    var msg = { type: 'fou:setting', action: action };
+    if (extra) for (var k in extra) msg[k] = extra[k];
+    try { window.parent.postMessage(msg, window.location.origin); } catch (e) { /* 不在浮游里 */ }
+  }
+
+  // 当前形态从 URL 来：?mode=orb|pill|panel
+  function currentMode() {
+    try { return new URLSearchParams(location.search).get('mode') || ''; } catch (e) { return ''; }
+  }
+
+  function paintMode() {
+    var cur = currentMode();
+    var btns = document.querySelectorAll('#modeChoice button');
+    for (var i = 0; i < btns.length; i++) {
+      var on = btns[i].dataset.mode === cur;
+      btns[i].classList.toggle('on', on);
+    }
+    document.getElementById('hint').textContent = cur ? '' : '点一下就换';
+  }
+
+  document.addEventListener('click', function (event) {
+    var el = event.target;
+    var btn = null;
+    while (el && el !== document.body) {
+      if (el.tagName === 'BUTTON') { btn = el; break; }
+      el = el.parentNode;
+    }
+    if (!btn) return;
+    if (btn.dataset.mode) { tell('mode', { value: btn.dataset.mode }); return; }
+    if (btn.dataset.act) { tell(btn.dataset.act); return; }
+  });
+
+  paintMode();
+})();
+</script>
+</body>
+</html>