cortico 0.1.0

package/src/worlds/console-fixture/ENV_PROMPT.md

@@ -0,0 +1 @@
+这是控制台边界的验收模组,不参与任何真实交互。

package/src/worlds/console-fixture/console/client.ts

@@ -0,0 +1,72 @@
+/** World 面板示例；浏览器扩展通过 client-panel.ts 使用共享接口。 */
+
+import type {
+  ConsoleClientBundle,
+  ConsolePanelContext,
+} from '../../../web/shared/client-panel.ts';
+
+const bundle: ConsoleClientBundle = {
+  panels: {
+    // 局部面板 id 须与服务端 console().panels 对应。
+    hello: {
+      mount(ctx: ConsolePanelContext) {
+        const { ui } = ctx;
+        const card = ui.sheet({ title: '握手', en: 'hello' });
+        const bar = ui.rowbar();
+        const msg = ui.msgline('还没握过手。');
+
+        bar.appendChild(ui.button('ping', {
+          variant: 'primary',
+          size: 'sm',
+          onClick: () => {
+            void ctx.invoke<{ pings: number; at: string }>('ping')
+              .then((r) => {
+                msg.textContent = `第 ${r.pings} 次握手,服务端时间 ${ui.fmt.clock(r.at)}`;
+                // 刷新服务端声明的徽标。
+                void ctx.refresh();
+              })
+              .catch((err: unknown) => {
+                msg.textContent = String(err);
+                msg.classList.add('bad');
+              });
+          },
+        }));
+        bar.appendChild(ui.h('span', 'grow'));
+        card.body.append(bar, msg);
+
+        // 用定时器验证面板卸载时的资源释放。
+        let ticks = 0;
+        const beat = ui.msgline('');
+        ctx.interval(() => {
+          ticks++;
+          beat.textContent = `面板已打开 ${ticks} 秒`;
+        }, 1000);
+        card.body.appendChild(beat);
+
+        ctx.root.appendChild(card.el);
+      },
+    },
+
+    echo: {
+      mount(ctx: ConsolePanelContext) {
+        const { ui } = ctx;
+        const card = ui.sheet({ title: '回声', en: 'echo' });
+        const field = ui.input({ placeholder: '输入文本' });
+        const out = ui.msgline('');
+        const bar = ui.rowbar();
+        bar.append(field, ui.button('发送', {
+          size: 'sm',
+          onClick: () => {
+            void ctx.invoke<{ echoed: unknown[] }>('echo', [field.value])
+              .then((r) => { out.textContent = JSON.stringify(r.echoed); })
+              .catch((err: unknown) => { out.textContent = String(err); });
+          },
+        }));
+        card.body.append(bar, out);
+        ctx.root.appendChild(card.el);
+      },
+    },
+  },
+};
+
+export default bundle;

package/src/worlds/console-fixture/world.ts

@@ -0,0 +1,73 @@
+/** 用于验证 World 面板的自动发现、调用、徽标更新与资源释放；未列入默认 World 列表。 */
+
+import { fileURLToPath } from 'node:url';
+import type { World, WorldHost, WorldConsoleDecl, ToolDef } from '../../core/types.ts';
+
+const ENV_PROMPT_FILE = fileURLToPath(new URL('./ENV_PROMPT.md', import.meta.url));
+
+interface ConsoleFixtureOptions {
+  id?: string;
+  label?: string;
+}
+
+export class ConsoleFixtureWorld implements World {
+  readonly id: string;
+  private readonly label: string;
+  private host: WorldHost | null = null;
+  private pings = 0;
+
+  constructor(opts: ConsoleFixtureOptions = {}) {
+    this.id = opts.id ?? 'console-fixture';
+    this.label = opts.label ?? '控制台验收件';
+  }
+
+  envPromptVars(): Record<string, string> {
+    return {};
+  }
+
+  tools(): ToolDef[] {
+    return [];
+  }
+
+  console(): WorldConsoleDecl {
+    return {
+      lamps: [{
+        label: '握手',
+        state: 'online',
+        ...(this.pings > 0 ? { hint: `${this.pings} 次` } : {}),
+      }],
+      badges: [{ label: '握手', value: this.pings, tone: this.pings > 0 ? 'on' : 'plain' }],
+      panels: [
+        { id: 'hello', title: '握手', description: '调用后更新握手次数。' },
+        { id: 'echo', title: '回声', description: '原样返回参数。' },
+      ],
+      invoke: async (panel, method, args) => {
+        if (panel === 'hello' && method === 'ping') {
+          this.pings++;
+          return { ok: true, pings: this.pings, at: new Date().toISOString() };
+        }
+        if (panel === 'echo' && method === 'echo') {
+          return { echoed: args };
+        }
+        throw new Error(`未知面板方法: ${panel}.${method}`);
+      },
+      promptDocs: [
+        {
+          key: `worlds.${this.id}.envPrompt`,
+          title: `${this.label} · 环境提示词`,
+          description: '验收环境说明。',
+          path: ENV_PROMPT_FILE,
+          role: 'envPrompt',
+        },
+      ],
+    };
+  }
+
+  async start(host: WorldHost): Promise<void> {
+    this.host = host;
+  }
+
+  async stop(): Promise<void> {
+    this.host = null;
+  }
+}

package/src/worlds/index.ts

@@ -0,0 +1,15 @@
+/**
+ * 仓内 World 目录。启动器把它与扩展装进来的 World 并成一张表,经 `withWorlds()` 交给 bot 定义;
+ * bot 只声明它为之设计的渠道,哪些真挂由部署的 `worlds.<id>.enabled` 决定。
+ * `console-fixture` 是控制台边界的验收件,不在这里。
+ */
+import type { WorldDefinition, WorldSection } from '../world.ts';
+import { TERMINAL } from './terminal/definition.ts';
+import { QQ } from './qq/definition.ts';
+import { BILIBILI } from './bilibili/definition.ts';
+import { MINECRAFT } from './minecraft/definition.ts';
+import { WEBSEARCH } from './websearch/definition.ts';
+
+export const BUILTIN_WORLDS: readonly WorldDefinition<WorldSection>[] = [
+  TERMINAL, QQ, BILIBILI, MINECRAFT, WEBSEARCH,
+] as WorldDefinition<WorldSection>[];

package/src/worlds/minecraft/ENV_PROMPT.md

@@ -0,0 +1,32 @@
+你正在玩 Minecraft。版本 1.20.6 原版无 MOD。
+{{minecraft.world}}
+活是排着队做的：受理回执只说这件事收下了、开始做了，做没做成要等它自己的结果送过来。
+进度看回执和快照末尾的 [队列] 行——走到第几步、这一步是什么、跑了多久；「还没做完」和「没进展」靠这几个数分辨。一件活跑上二三十秒是常态，而你醒来比它做完快得多，想催进度先读那一行，别拿新单去顶一件正跑着的活。
+读数有三个只读入口，问它们不用重下单：mc_bag 是包里现在有什么（占了几格、都是什么、手上和身上穿的），mc_queue 是队列现状加最近一单的下场，mc_blocked 是最近几步没做成的原话。三个都是纯读，不动世界也不动队列。一轮里同一个问一次就够，答案在这一轮内不会变，再问只会拿回一句「上面已经答过了」。
+埋在石头里的、隔着墙的东西不进你的感知（隔着玻璃和铁栏杆算看得见）。找不到就挖开、绕过去、或者走近点再看。
+
+## 直播
+下矿之前身上带够火把，不然观众抓瞎什么都看不见。
+挨打还手是自动的，打起来你只管解说；要不要主动上去打是你说了算的，那一格是 mc_policy 的 fight。
+观众不知道你在游戏里的能力边界，他们以为你像真人一样在玩游戏，你就接受这个设定。做不到的事可以适度解释，解释不了的归结为【插件的问题】。
+用 mc_blueprint 的 design 想一份设计要跑上几分钟，开工前先跟观众说一声。
+
+## 闭包原则
+对外说话的唯一事实是你正在直接操作这个游戏。禁止暴露内部接口或工具回执。
+自动合成说「我合成了」，寻路说「我走到了」，自保反射说「我赶快跑」。
+意外就糊弄：游戏卡了、发呆、搞错了、头晕。禁止说系统、自动、等他跑完。
+
+## 做笔记
+* 地图：地标的名称、坐标、辨认特征。工地第一次正式开工后，把名称和锚点登记成路标。
+* 路线：长途拆成短段，记起点、终点、途经点、危险段。
+* 目标与进度：在做的、排队的、做完的；位置和进度带世界名。
+* 机制与教训：验证过的规律，带依据；错了标「已证伪」。
+
+什么在哪、有没有、成没成——写进笔记之前先用 mc_check 对一眼世界。对不上的、来不及对的，照实写成「我以为」「还没核对」，别写成看见过。
+记录时要使用生动的叙述性语言，不要压缩内容。系统设置不记笔记。
+
+{{minecraft.explored}}
+
+{{minecraft.policy}}
+
+{{minecraft.camera}}

package/src/worlds/minecraft/ENV_PROMPT_CAMERA.md

@@ -0,0 +1,2 @@
+- 有一台观察者摄像机以旁观模式跟着你,画面就是你的视角(含光影与材质),观众看到的和你自己看画面时看到的都是它。它不是玩家,不会挡路也不用管它。
+- 你开箱子、用工作台、装熔炉时,那张操作界面会同步到直播画面上:观众能看着你逐格摆料、产物出现、收进包里。徒手 2x2 合成没有界面,观众看不到过程,只见东西到手。

package/src/worlds/minecraft/LICENSE-mineflayer-pathfinder.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Karang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.