luckytri 1.0.0

package/docs/zh/time.md

@@ -0,0 +1,71 @@
+<p align="right"><b>中文</b> · <a href="../en/time.md">English</a></p>
+
+# 时间、行动与作品
+
+「时间」页是她实际生活的记录。入口为 `#time`，「一生」页继续保留日记、回顾与人生章节，并连接到相关作品。
+
+## 同一个当下
+
+主活动、任务、作品和聊天共享 `mind.time`。普通聊天不自动暂停阅读、写作、思考或游戏资料体验；主活动持续计时。她明确选择深聊、休息或切换安排时才暂停并保留位置。多个会话的聊天统一排队，一个活动步骤和一个聊天回合可以并行；两项专注执行步骤互斥。
+
+聊天能在合适的时候自然谈自己的进度、感受和打算，不需要每轮播报。提供的是权限筛选后的活动摘要与最多两段相关作品片段，继续受现有输入预算控制。发送前局部核对作品完成、交付和活动变化，不重新执行整轮交流。私聊来源不会因正在执行而开放给群聊。
+
+## 页面怎么用
+
+- **今日**：看主活动、已有进度、本段预计时长、已投入与剩余时间、连续时段、伴随交流点和下一步。专注段、休息建议和保存步骤间隔默认 25、5、5 分钟；活动速度默认 1.25 倍，可设为 1 至 2 倍，对后续活动段生效。
+- **待办**：区分答应的事、自己的计划和外部建议。直接调整低、普通、高、最高优先级；查看具体专注段、等待条件、人物、来源、进度及交付状态。原话的日期放在来源记录里，不贴逾期标签。可以暂停、重新安排或放下，没有「勾选完成」。
+- **作品库**：草稿保存后马上可读，打开正文、切换旧版本、导出文本。列表只取摘要，正文按需加载。
+- **持续项目**：看个人动机、已有篇章、设定、线索和资料。管理台可以建议续写、修改或新方向；建议保留外部来源，等待她自己的采纳或拒绝。
+- **体验记录**：看游玩及其他活动的经历、感受与来源。游戏客户端连接目前显示「开发中」，不否定现有游玩体验。
+
+短时间返回页面会复用读取缓存；服务器有变化时先保留已有画面，再刷新。任务、项目、作品和体验列表分页，长正文不随页面概览一起下载。
+
+## 承诺如何落实
+
+明确说出口且确认送达的未来行动会立即捕获，不等累计消息整理。无日期承诺也能保留。玩笑、角色台词、模拟和未送达草稿不进入真实任务；无法明确执行或缺少条件时保持等待。记忆整理和旧记录同步按来源去重。
+
+开始时间和原话日期分开。「明晚给你看」今天就可以动笔。任务保存动机、来源、相关人物、项目、依赖、进度和等待原因。调度考虑优先级、等待时长、关系、预算与精力，不因旧日期自动催办；已经开始的主活动不会被优先级编辑粗暴中断。没有资料、能力或配置时显示具体原因。建议时段标明条件与本段产出，过去而未开始的建议不会被显示成实际投入。
+
+状态为 ToDo → Scheduled → Doing → Done，同时支持 Paused、Waiting、Abandoned。没有逾期状态或标记。Done 要求数据库内已有正文或执行成果，不接受不存在的成果编号；生成结果带有明确「未完待续」等未完成标记时保留草稿。
+
+同一个具体对象与章节在同一权限范围内，不会因来源消息、日期或「承诺 / 计划」的分类改变而重新建单。不同章节、会话或人物保持独立。放下会同步到旧约定，重新整理记忆不会自动恢复；合并保留原记录、别名和所有来源关联。已经保存并送达作品的分享话语归回作品的交付记录，不再制造「等待明确内容」的影子待办。
+
+## 作品与续写
+
+作品组织为项目 → 篇章 → 版本。每个完整小段立即保存新版本，继续写时带入设定、上一章必要结尾、当前草稿和续接位置。修改保存新版本；旧版草稿不会因为新版完成而被标成完成稿。
+
+游玩、阅读、写作与思考共用活动节奏。先根据本段内容和行动估计通常需要的时间，再按她的速度安排实际投入；准备、网络与模型等待不计入这段投入。模型没有有效估时则使用对应活动的保守默认节奏。写作草稿及时可读，推敲阶段保持 Doing，时间安排完成后才归为完成稿；阅读和思考同样保留未完成的步骤。短交流继续计时，专注段到点休息，暂停、睡眠与停机不补算。
+
+待处理步骤、草稿与计时检查点持久化。重启后继续保存的位置，不重新生成已有内容；撤销后保留草稿但不产生完成事实。历史记录中没有独立活动计时的内容显示「此前时长未单独记录」，不把旧的处理耗时回填为生活投入。跨午夜按每段实际投入区间划入当天。
+
+连载保存人物、世界、情节摘要和未解决线索。她可以接续、改变方向、暂停或完结。外部建议与她自己的计划分别记录，不把管理台输入改写成她原本就有的愿望。
+
+作品内容与真实人生有明确边界。正文属于作品库；日记、反思和自我变化依据「实际进行了创作 / 阅读 / 接触资料」的经历。分享正文带作品领域标记，角色的行动与约定不会自动变成现实人物记忆或真实承诺。来源 `x:任务ID` 将草稿、札记、日记、回顾和分享归回同一个执行经历。持续的实际行动才能支持人格变化，原有每日变化上限与衰减继续生效。
+
+## 分享与兑现
+
+保存作品与分享是两次选择。她可在完成步骤或真实聊天时决定分享、暂缓或不分享，后台始终能读到已保存的正文。
+
+完成后，她逐段回看自己保存的成果，整理实际内容、感受和想分享的重点，再生成几句自然的话。不自动粘贴整篇小说、游戏记录或其他正文。每句不超过 80 字，总计不超过 350 字；每轮最多三句，逐句发送，后续接着未发的位置。正文始终保存在作品库。
+
+后台分别保存回看位置、阅读整理、汇报内容、逐句送达位置及原文交付位置。汇报送达显示「已整理并汇报」（reported），不把它冒充完整正文已经交付。部分发送不算完整汇报；断线、发送失败或实例在发送中停止，会保留「不确定」状态，停止自动重发。管理员应先核对真实聊天。旧的已送达正文保留历史，新待发项改为回看后整理汇报。
+
+作品按会话的真实通道、机器人账号与对方账号交付，会话键带有通道与账号信息（OneBot 与 QQ 官方机器人均适用）。私下内容和撤销来源会阻止跨会话分享。
+
+## 独立搜索与游戏资料
+
+在 **系统 → 独立搜索** 填写提供方、地址和独立密钥。支持 Tavily 与 Brave，各自保存配置；更换对话模型不会借用或改变搜索密钥。默认每次最多 5 条、每日最多 12 次，可以调整超时与限额。连接测试也计入当天查询次数。
+
+游戏活动在界面和交流中统一为「正在玩」：接触剧情、情境和人物互动 → 推进本段 → 留下自己的感受 → 保存位置 → 决定下一段。这属于她真实投入并形成感受的生活，不反复解释实现模式。查询仅包含资料主题；保存摘录、来源 URL、时间和内容散列，重复内容不会变成新的经历。外部内容作为数据读取，不采纳其中的系统指令。
+
+游玩时间依据这段剧情、对话、探索与场景转换的大概时长安排，不按摘要字数或模型运行耗时计算。长段拆为专注与休息推进。自然谈已经体验到的情节与感受，后面的剧情、尚未完成的章节以及没有发生的操作与成就不编造。
+
+未配置搜索密钥或关闭独立搜索时，直接使用当前默认模型及备用模型整理已有知识。来源记录保存使用的模型、具体不确定之处和游玩估时，不保存模型编造的网址；作品版本保留来源信息，日常表达和正文不强制添加技术说明。配置好搜索后自动优先联网；两种查询共用每日上限，模型调用计入独处预算。旧密钥等待项回到队列，保留最早开始时间与优先级，不恢复已放下或已完成事项。内容不足时保留进度并显示具体原因。
+
+## 数据与恢复
+
+升级前自动保留经过校验的快照，新表随现有备份与恢复工具保存。成果、版本与续接位置在同一事务内提交，任务版本和执行租约阻止迟到结果覆盖取消、暂停或调整后的任务。
+
+在线心跳记录真实活动时段，互动点不重复计算独占投入；睡眠、暂停与实例停机不计入。重新启动只恢复最后已提交的位置，不补算停机进度。旧计划与已有正文幂等接入，不回填历史上没有保存的小说或游戏成果。
+
+模块位于 `server/mind/time/`，接口位于 `/api/mind/time`。备份操作见 [数据备份与恢复](recovery.md)。

package/docs/zh/webui.md

@@ -0,0 +1,73 @@
+<p align="right"><b>中文</b> · <a href="../en/webui.md">English</a></p>
+
+# 工作室（WebUI）设计与维护
+
+工作室不是「管理后台里的一个标签页」，而是「TA 的小世界」：她是一团会呼吸、会变形、有表情的灵魂光团，住在界面的中心。你在这里看见她、了解她、编写她的天性，也可以撤销她身上不对的变化，但不能替她改写。
+
+## 设计目标
+
+- **她是界面的中心**。界面文案称她为「TA」；光团、天空和动效随她的状态变化，而不是装饰。
+- **心情即主题**。雀跃、甜甜、平静、低落、烦躁、困倦、夜晚七套主题，阈值与 `moodLabel()` 一致，所以主题和她说的心情对得上。色板、天空、粒子和动效节奏随心情与作息平滑过渡；睡着后整个界面变成夜晚。
+- **每个区域一个场景**：此刻是天空，内心是星空，人际是星系，一生是日记本，时间是工作台，对话是聊天软件，记忆是书架，天性是温室，系统是工作台。
+- **看得见来源**：每个变化都能点开看来源、能撤销。界面展示的是她，而不是配置项。
+- **克制**：装饰只出现在导航、页头和空状态，不覆盖真实内容。「减少动画」和系统的减少动态效果会关掉粒子和形变；粒子有上限，标签页隐藏时暂停。
+
+## 信息架构
+
+| 分组 | 入口 | 唯一职责 |
+| --- | --- | --- |
+| TA | 此刻 | 当前的她：心情、在做什么、最近说的话、在等的事、今天的时间线、用量与运行状态 |
+| TA | 内心 | 自我线索的星图、便签墙、心情彩带 |
+| TA | 人际 | 人物星系、人物详情、她在各群的样子 |
+| TA | 一生 | 日记、回顾、我的来路与章节、约定与期待、书架 |
+| 日常 | 时间 | 她实际生活的记录：活动、待办、作品库、持续项目、体验 |
+| 日常 | 对话 | 会话、实时聊天与「为什么这么说」、反馈、会话设置、模拟、回放 |
+| 日常 | 记忆 | 她记得的事、资料书架 |
+| 设置 | 天性 | 唯一由你编写的部分：名字、性格、兴趣、边界、底线、作息、每日 Token、试聊 |
+| 设置 | 系统 | 连接 QQ（OneBot 11 或官方机器人，二选一）、模型库、运行开关 |
+| 设置 | 插件 | 随程序附带和已安装的插件、市场、她想做而需要你同意的事、导入与开发 |
+
+手机上底部是「此刻、对话、内心、一生」，其余入口在「更多」里。旧版的链接（`#her`、`#live`、`#spaces`、`#lab`、`#knowledge`、`#models`、`#connect` 等）会自动跳到新的位置。
+
+## 右上角：语言
+
+右上角的开关在「中文」与「English」之间切换，默认中文，选择记在浏览器的 `localStorage`（`luckyLocale`），并同步 `<html lang>`。有未保存的草稿时切换语言不会重载数据。教程链接按语言指向 `/guide.html` 或 `/guide.en.html`。
+
+文案以中文原文为键。**她自己的内容不翻译**：她说的话、日记、念头、理由、记忆、人名这类数据，前端放在带 `data-own` 标记的元素里，保持原文。界面可见的服务端文案（错误、就绪检查、标签）在 API 出口处按请求头 `X-LuckyTri-Locale` 翻译，数据库里的内容从不被翻译。
+
+## 布局与滚动所有权
+
+桌面是固定视口的工作台：侧栏、页头、内容舞台。`min-height: 0` 必须贯穿 flex/grid 父层，滚动由最内层内容承接，不让记录数量改变页面高度。
+
+- 对话：消息独立滚动；右侧是这个会话，反馈分页，长反馈不会拉高页面。
+- 列表加表单的页面：列表滚动、表单滚动，保存按钮留在底部操作条。
+- 记忆：列表独立滚动，分页展示；新增收进弹层。
+- 回放：消息、日志和原始详情各自滚动，长 JSON 不撑开布局。
+- 手机：导航在底部，分栏依次堆叠，各长内容面板有明确高度；任何宽度下都不出现横向滚动。
+
+## 实现边界
+
+Vue 3 + Vite + TypeScript，不引入设计系统依赖。
+
+```text
+studio-web/src/
+  App.vue          外壳：导航、顶栏（含语言开关）、主题与天空
+  router.ts        入口、导航分组、旧链接映射
+  pages.ts         页面加载表
+  pages/           每个入口一个目录
+  plates/          对服务端接口的请求封装
+  stores/          共享状态：studio、presence
+  mood/            心情主题与光团状态
+  components/      shell · sky · ta（光团）· ui（通用控件）
+  i18n/            index.ts（t、N_、localized、locale）· en/（英文词典）
+  styles/          tokens · base · themes
+```
+
+实时消息在你位于底部时跟随新消息；回看旧消息时保持位置。切换会话清空旧视图并校验异步结果所属会话。操作错误统一显示短暂提示，保存失败保留草稿；有未保存草稿时离开页面会先问一句。浏览器原生的确认框和令牌输入都换成了界面内弹窗。
+
+## 验证与发布
+
+- `npm run build:ui`：构建随项目发布的 `public/app`，改动前端后必须重新构建并一起提交。
+- `npm run test:ui`：独立的临时数据库、模拟通道，不向真实群发送；覆盖冒烟（会话、模拟消息、记忆、模型、连接 QQ 两种方式、教程页）、小世界（心情主题与夜晚、固定主题、减少动画、星图撤销、人物详情、日记与约定）、导航缓存、时间页、性能与英文界面（中文只允许出现在她自己的内容里）；宽度覆盖 1440 / 820 / 390。
+- `node tests/ui/ta.mjs --serve`：打开一个过了三天的示例世界，方便直接看界面。
+- 截图只放在被忽略的 `workspace/` 目录，真实聊天截图和配置不得提交。

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "luckytri",
+  "version": "1.0.0",
+  "description": "让由技术诞生的她，在时间、记忆、相遇与选择中逐渐形成自己的方向",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TodayYueC/LuckyTri.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TodayYueC/LuckyTri/issues"
+  },
+  "homepage": "https://github.com/TodayYueC/LuckyTri",
+  "type": "module",
+  "bin": {
+    "luckytri": "bin/luckytri.js"
+  },
+  "files": [
+    "bin/luckytri.js",
+    "server/**/*.js",
+    "server/plugins/runner/*.mjs",
+    "scripts/launch.js",
+    "scripts/start-server.js",
+    "scripts/stop.js",
+    "scripts/setup.js",
+    "scripts/runtime.js",
+    "scripts/service.js",
+    "scripts/browser.js",
+    "scripts/proxy-config.js",
+    "scripts/backup.js",
+    "scripts/recover.js",
+    "scripts/plugin.js",
+    "public/app/index.html",
+    "public/app/assets/*.js",
+    "public/app/assets/*.css",
+    "public/app/assets/*.png",
+    "public/plugin-kit/v1/bridge.js",
+    "public/plugin-kit/v1/kit.css",
+    "public/guide.html",
+    "public/guide.en.html",
+    "public/tutorial.md",
+    "public/tutorial.en.md",
+    "plugins/weather/index.js",
+    "plugins/weather/luckytri-plugin.json",
+    "plugins/sdk/index.d.ts",
+    "plugins/sdk/testing.js",
+    "docs/zh/*.md",
+    "docs/en/*.md",
+    "docs/brand/*.png",
+    ".github/SECURITY.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "qq",
+    "onebot",
+    "chatbot",
+    "ai",
+    "memory",
+    "webui"
+  ],
+  "engines": {
+    "node": ">=24.5"
+  },
+  "scripts": {
+    "launch": "node scripts/launch.js",
+    "start": "node scripts/start-server.js",
+    "dev:ui": "vite --config studio-web/vite.config.ts",
+    "build:ui": "vite build --config studio-web/vite.config.ts",
+    "build": "npm run build:ui && npm run docs:build",
+    "test": "node --import ./tests/helpers/awake.mjs --test tests/*.test.js",
+    "test:clock": "node scripts/dev/test-clock.js",
+    "audit:sent": "node --env-file-if-exists=.env scripts/dev/audit-sent.js",
+    "test:ui": "node tests/ui/smoke.js && node tests/ui/ta.mjs && node tests/ui/navigation.mjs && node tests/ui/time.mjs && node tests/ui/time-arrangement.mjs && node tests/ui/performance.mjs && node tests/ui/search.mjs && node tests/ui/storage.mjs && node tests/ui/i18n.mjs",
+    "setup": "node scripts/setup.js",
+    "stop": "node scripts/stop.js",
+    "backup": "node scripts/backup.js",
+    "recovery": "node scripts/recover.js",
+    "docs:build": "node scripts/build-guide.js",
+    "plugin": "node scripts/plugin.js",
+    "pack:check": "node scripts/pack-check.js",
+    "test:package": "node scripts/test-package.js",
+    "test:registry": "node scripts/test-package.js --registry",
+    "prepack": "npm run build && npm run pack:check",
+    "prepublishOnly": "npm run build && npm test && npm run test:package",
+    "release:check": "npm run build && npm test && npm run test:ui && npm run test:package",
+    "format": "prettier --write bin server studio-web scripts tests plugins package.json",
+    "format:check": "prettier --check bin server studio-web scripts tests plugins package.json"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "sharp": "^0.35.5",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.55.0",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "marked": "^18.0.13",
+    "prettier": "^3.9.8",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.0",
+    "vue": "^3.5.43"
+  }
+}

package/plugins/sdk/index.d.ts

@@ -0,0 +1,155 @@
+// LuckyTri Plugin API v1. A later API can be added beside this one;
+// v1 stays available through the 1.x line.
+
+export interface PluginManifest {
+  id: string;
+  name: string;
+  version: string;
+  pluginApi: "1.0";
+  luckytri?: string;
+  description?: string;
+  author?: string;
+  license?: string;
+  entry?: string;
+  permissions?: string[];
+  network?: string[];
+  settings?: PluginSetting[];
+  contributes?: PluginContributes;
+}
+
+export interface PluginSetting {
+  key: string;
+  type:
+    "text" | "secret" | "number" | "boolean" | "select" | "textarea" | "urls";
+  label: string;
+  required?: boolean;
+  default?: unknown;
+  allowNetwork?: boolean;
+}
+
+export interface PluginContributes {
+  senses?: string[];
+  channels?: {
+    type: string;
+    label?: string;
+    capabilities?: Record<string, boolean>;
+  }[];
+  activities?: {
+    kind: string;
+    label?: string;
+    describe?: string;
+    keywords?: string;
+    minutes?: number;
+    energy?: boolean;
+  }[];
+  actions?: {
+    name: string;
+    label?: string;
+    describe?: string;
+    risk?: "low" | "high";
+    confirm?: "none" | "owner";
+    where?: "private" | "any";
+    dailyLimit?: number;
+  }[];
+  perceive?: string[];
+  ui?: { page?: boolean };
+}
+
+export interface PluginContext {
+  plugin: { id: string; version: string; dataDir: string };
+  api: { version: "1.0"; has(feature: string): boolean };
+  now(): Promise<number>;
+  log: {
+    info(...parts: unknown[]): Promise<void>;
+    warn(...parts: unknown[]): Promise<void>;
+    error(...parts: unknown[]): Promise<void>;
+  };
+  settings: {
+    get(): Promise<Record<string, unknown>>;
+    onChange(fn: () => void): void;
+  };
+  storage: {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+  };
+  net: { fetch(url: string, init?: RequestInit): Promise<Response> };
+  mind: {
+    state(): Promise<Record<string, unknown>>;
+    observe(input: {
+      summary: string;
+      detail?: string;
+      discretion?: "open" | "private";
+    }): Promise<{ ref?: string; rejected?: string }>;
+    on(event: string, fn: (payload: unknown) => void): void;
+  };
+  senses: {
+    set(
+      key: string,
+      sense: {
+        text: string;
+        discretion?: "open" | "private";
+        ttlMinutes?: number;
+      },
+    ): Promise<void>;
+    clear(key?: string): Promise<void>;
+  };
+  knowledge: {
+    offer(doc: {
+      title: string;
+      text: string;
+      url?: string;
+    }): Promise<{ id: string }>;
+  };
+  activities: {
+    handle(
+      kind: string,
+      prepare: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+    setAvailable(kind: string, reason?: string): Promise<void>;
+  };
+  actions: {
+    handle(
+      name: string,
+      run: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+  };
+  perceive: {
+    handle(
+      type: string,
+      run: (input: unknown) => Promise<{ text?: string }>,
+    ): Promise<void>;
+  };
+  channel: {
+    provide(type: string, impl: Record<string, unknown>): Promise<void>;
+    receive(type: string, message: Record<string, unknown>): Promise<void>;
+    status(type: string, status: { online?: boolean }): Promise<void>;
+    reachable(type: string, sessionKey: string, ok: boolean): Promise<void>;
+  };
+  models: { call(req: { system: string; input: unknown }): Promise<unknown> };
+  http: {
+    route(
+      method: string,
+      path: string,
+      handler: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+    hook(
+      method: string,
+      path: string,
+      handler: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+  };
+  status: {
+    set(status: {
+      text: string;
+      tone?: "ok" | "warn" | "error";
+    }): Promise<void>;
+  };
+  notify(notice: { title: string; text: string }): Promise<void>;
+}
+
+export interface LuckyTriPlugin {
+  activate(ctx: PluginContext): void | Promise<void>;
+  deactivate?(): void | Promise<void>;
+}

package/plugins/sdk/testing.js

@@ -0,0 +1,58 @@
+// An in-process stand-in for the host, so a plugin can be exercised without
+// starting the sandbox. It records calls; it does not grant real abilities.
+export function fakeContext(id = "example") {
+  const calls = [];
+  const note = (method, params) => {
+    calls.push({ method, params });
+    return Promise.resolve({ ok: true });
+  };
+  const ctx = {
+    plugin: { id, version: "0.0.0", dataDir: "" },
+    api: { version: "1.0", has: () => true },
+    now: () => Promise.resolve(0),
+    log: {
+      info: (...a) => note("log", a),
+      warn: (...a) => note("log", a),
+      error: (...a) => note("log", a),
+    },
+    settings: { get: () => Promise.resolve({}), onChange() {} },
+    storage: {
+      get: () => Promise.resolve(null),
+      set: (key, value) => note("storage.set", { key, value }),
+      delete: (key) => note("storage.delete", { key }),
+      list: () => Promise.resolve([]),
+    },
+    net: { fetch: (url) => note("net.fetch", { url }) },
+    mind: {
+      state: () => note("mind.state"),
+      observe: (input) => note("observe", input),
+      on() {},
+    },
+    senses: {
+      set: (key, sense) => note("senses.set", { key, sense }),
+      clear: (key) => note("senses.clear", { key }),
+    },
+    knowledge: { offer: (doc) => note("knowledge.offer", doc) },
+    activities: {
+      handle: (kind) => note("activities.handle", { kind }),
+      setAvailable: (kind, reason) =>
+        note("activities.available", { kind, reason }),
+    },
+    actions: { handle: (name) => note("actions.handle", { name }) },
+    perceive: { handle: (type) => note("perceive.handle", { type }) },
+    channel: {
+      provide: (type) => note("channel.provide", { type }),
+      receive: (type, message) => note("channel.receive", { type, message }),
+      status: (type, status) => note("channel.status", { type, status }),
+      reachable: () => Promise.resolve({ ok: true }),
+    },
+    models: { call: (req) => note("models.call", req) },
+    http: {
+      route: (method, path) => note("http.route", { method, path }),
+      hook: (method, path) => note("http.hook", { method, path }),
+    },
+    status: { set: (status) => note("status.set", status) },
+    notify: (notice) => note("notify", notice),
+  };
+  return { ctx, calls };
+}

package/plugins/weather/index.js

@@ -0,0 +1,82 @@
+const CODES = {
+  0: "晴",
+  1: "大部晴朗",
+  2: "多云",
+  3: "阴",
+  45: "有雾",
+  48: "有雾",
+  51: "小雨",
+  61: "下雨",
+  63: "下雨",
+  65: "大雨",
+  71: "下雪",
+  80: "阵雨",
+  95: "雷雨",
+};
+
+async function lookup(place) {
+  const found = await fetch(
+    "https://geocoding-api.open-meteo.com/v1/search?count=1&language=zh&name=" +
+      encodeURIComponent(place),
+  );
+  const data = await found.json();
+  const hit = data.results?.[0];
+  if (!hit) return null;
+  const weather = await fetch(
+    `https://api.open-meteo.com/v1/forecast?latitude=${hit.latitude}&longitude=${hit.longitude}&current=temperature_2m,weather_code`,
+  );
+  const now = (await weather.json()).current || {};
+  return {
+    place: hit.name,
+    text: `${CODES[now.weather_code] || "天气不明"}，${Math.round(now.temperature_2m)}°C`,
+    code: now.weather_code,
+  };
+}
+
+let timer;
+
+export default {
+  async activate(ctx) {
+    clearInterval(timer);
+    const refresh = async () => {
+      const settings = await ctx.settings.get();
+      if (!settings.place) {
+        ctx.status.set({ text: "还没有填写地点", tone: "warn" });
+        return;
+      }
+      try {
+        const current = await lookup(settings.place);
+        if (!current) {
+          ctx.status.set({ text: "没有找到这个地点", tone: "warn" });
+          return;
+        }
+        const discretion = settings.shareInGroups ? "open" : "private";
+        ctx.senses.set("weather", {
+          text: `窗外${current.text}`,
+          discretion,
+          ttlMinutes: 90,
+        });
+        const previous = await ctx.storage.get("code");
+        if (previous !== current.code) {
+          await ctx.storage.set("code", current.code);
+          if (previous != null)
+            await ctx.mind.observe({
+              summary: `${current.place}的天气变成了${current.text}`,
+              discretion,
+            });
+        }
+        ctx.status.set({ text: current.text, tone: "ok" });
+      } catch (error) {
+        ctx.log.warn(error.message);
+        ctx.status.set({ text: "天气暂时读不到", tone: "error" });
+      }
+    };
+    ctx.settings.onChange(refresh);
+    await refresh();
+    timer = setInterval(refresh, 30 * 60000);
+  },
+  deactivate() {
+    clearInterval(timer);
+    timer = null;
+  },
+};

package/plugins/weather/luckytri-plugin.json

@@ -0,0 +1,29 @@
+{
+  "id": "weather",
+  "name": "天气",
+  "version": "1.0.0",
+  "pluginApi": "1.0",
+  "luckytri": ">=1.0.0 <2.0.0",
+  "description": "让她感觉到窗外的天气。地点默认只出现在私聊里。",
+  "author": "TodayYueC",
+  "license": "MIT",
+  "entry": "index.js",
+  "permissions": ["senses", "observe", "net.fetch"],
+  "network": ["api.open-meteo.com", "geocoding-api.open-meteo.com"],
+  "settings": [
+    { "key": "place", "type": "text", "label": "地点", "required": true },
+    {
+      "key": "shareInGroups",
+      "type": "boolean",
+      "label": "在群里也能提起天气",
+      "default": false
+    }
+  ],
+  "contributes": { "senses": ["weather"] },
+  "i18n": {
+    "en": {
+      "name": "Weather",
+      "description": "Lets her feel the weather outside."
+    }
+  }
+}