weifuwu 0.87.0 → 0.89.0

package/content/apps/multi.md

@@ -1,44 +0,0 @@
-# 应用编排 · apps
-
-## 概述
-
-父应用嵌子应用：registerApp/hApp + app:* 边界事件——子应用独立状态。后端：ws 广播。
-
-
-## 用到的页面模式
-- （无）
-
-## 用到的组件
-- [Card](../components/card.md)
-- [Button](../components/button.md)
-- [Input](../components/input.md)
-- [Tag](../components/tag.md)
-- [Tabs](../components/tabs.md)
-
-## 源码
-
-> `examples/apps/multi/` ——完整可运行（随 npm 包发布）
-
-## 目录结构
-
-| 文件 | 职责 |
-|------|------|
-| `app.tsx` | 前端：registerApp 注册 2 个子应用 + 父应用工作台（h(App, {appId}) 嵌入） |
-| `server.ts` | 独立入口（:3303——纯前端编排无后端 API） |
-| `main.tsx` | 独立前端入口 |
-
-## 改造指南（新手从跑起来到改成自己的）
-
-- 1. 加子应用：app.tsx 里 registerApp('my-app', (props, ctx) => h(MyComp, {})) + 父树 h(App, { appId: 'my-app' })
-- 2. 子应用传参：h(App, { appId, props: {...} })——app:update 边界事件（见 content/capabilities/app-node.md）
-- 3. 观察边界事件：stream.subscribe 过滤 e.entity === 'app'（工作台已展示）
-
-## 质量标准
-
-- [x] 子应用独立状态
-- [x] 边界事件观测
-- [x] 零控制台错误
-
-## 验证
-
-> agent-browser 走查：打开 showcase `/apps/multi`（活体嵌入）——列表/新建/保存/删除全流程 + 控制台零错误

package/content/apps/todo.md

@@ -1,51 +0,0 @@
-# 任务管理 · apps
-
-## 概述
-
-经典 CRUD 应用：列表/详情/新建——多页路由 + createStore 跨页状态 + 表单受控。后端：MemorySql 持久化。
-
-
-## 用到的页面模式
-- （无）
-
-## 用到的组件
-- [Button](../components/button.md)
-- [Input](../components/input.md)
-- [Checkbox](../components/checkbox.md)
-- [Form](../components/form.md)
-- [Tag](../components/tag.md)
-- [EmptyState](../components/emptystate.md)
-- [PageHeader](../components/pageheader.md)
-
-## 源码
-
-> `examples/apps/todo/` ——完整可运行（随 npm 包发布）
-
-## 目录结构
-
-| 文件 | 职责 |
-|------|------|
-| `app.tsx` | 前端：路由表 + 页面组件（TodoList/TodoNew）+ createStore + hash 桥接 |
-| `api.ts` | 后端：registerTodoApi(app, sql)——CRUD 路由（独立/嵌入共享） |
-| `server.ts` | 独立入口：MemorySql + ui + 前端服务（:3300） |
-| `main.tsx` | 独立前端入口：createTodoApp + hashchange 桥接 |
-
-## 改造指南（新手从跑起来到改成自己的）
-
-- 1. 改数据模型：编辑 api.ts 的 SQL 表结构（todos 表字段）——MemorySql 与 postgres() 同契约，换库只改 server.ts 一行
-- 2. 加页面：app.tsx 的路由表加一行 { path, render } + 新建页面组件（组件写法见 guides/component-model.md）
-- 3. 改交互/状态：页面组件内 let + ctx.render()（render-only——见 guides/render-only.md）
-- 4. 换样式：组件文档「用法示例」+ layout 原语（wf-* 类，零手写 CSS）
-- 5. 接真实后端：server.ts 把 createMemorySql() 换成 postgres()（见 content/backend/sql.md）
-
-## 质量标准
-
-- [x] 键盘可达
-- [x] 375/768 无溢出
-- [x] 亮暗主题
-- [x] loading/error/empty 态
-- [x] 零控制台错误
-
-## 验证
-
-> agent-browser 走查：打开 showcase `/apps/todo`（活体嵌入）——列表/新建/保存/删除全流程 + 控制台零错误

package/content/backend/ai.md

@@ -1,28 +0,0 @@
-# ctx.ai（chat/stream/agent/approve） · backend
-
-## 概述
-
-AI 对话全链路：流式 token / 工具调用 / HITL 审批——wf: 协议对页面透明
-
-## 装配
-
-中间件注入键：`ctx.ai`
-
-## 活体端点
-
-```bash
-curl /api/chat
-```
-
-## 关联组件
-- [AiChat](../components/aichat.md)
-- [ToolCallCard](../components/toolcallcard.md)
-- [ApprovalCard](../components/approvalcard.md)
-
-## 文档素材
-
-来源：`docs/ai-contract.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/auth.md

@@ -1,20 +0,0 @@
-# 认证（ctx.auth/user） · backend
-
-## 概述
-
-登录态/会话/权限——userSystem 集成
-
-## 装配
-
-中间件注入键：`ctx.auth`
-
-## 关联组件
-- [AuthPage](../components/authpage.md)
-
-## 文档素材
-
-来源：`content/guides/saas-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/email.md

@@ -1,23 +0,0 @@
-# 邮件（ctx.email） · backend
-
-## 概述
-
-Mailer 契约——演示用内存捕获回显（mock 输出可读）
-
-## 装配
-
-中间件注入键：`ctx.email`
-
-## 活体端点
-
-```bash
-curl /api/demo/email
-```
-
-## 文档素材
-
-来源：`content/guides/saas-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/graphql.md

@@ -1,23 +0,0 @@
-# GraphQL · backend
-
-## 概述
-
-app.graphql(handler)——SDL + resolvers map 绑定
-
-## 装配
-
-中间件注入键：`—`
-
-## 活体端点
-
-```bash
-curl /api/demo/graphql
-```
-
-## 文档素材
-
-来源：`content/guides/server-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/http.md

@@ -1,23 +0,0 @@
-# HTTP 原语 · backend
-
-## 概述
-
-Request/Response 标准接口 + SSE + CORS + 静态服务
-
-## 装配
-
-中间件注入键：`—`
-
-## 活体端点
-
-```bash
-curl /api/demo/http
-```
-
-## 文档素材
-
-来源：`content/guides/server-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/limit.md

@@ -1,23 +0,0 @@
-# rateLimit（ctx.limit） · backend
-
-## 概述
-
-限流中间件——超额返回 429（演示端点轻阈值）
-
-## 装配
-
-中间件注入键：`ctx.limit`
-
-## 活体端点
-
-```bash
-curl /api/demo/limit
-```
-
-## 文档素材
-
-来源：`content/guides/saas-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/middleware.md

@@ -1,17 +0,0 @@
-# ctx 注入链 · backend
-
-## 概述
-
-中间件面注入 ctx.sql/redis/ui/api/auth/ws/limit/email/queue/cron/ai——装配即依赖注入
-
-## 装配
-
-中间件注入键：`ctx.*`
-
-## 文档素材
-
-来源：`content/guides/middleware.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/queue.md

@@ -1,23 +0,0 @@
-# 任务队列（ctx.queue） · backend
-
-## 概述
-
-QueueClientModule——池命令 + 阻塞 worker（注入 Redis 模式）
-
-## 装配
-
-中间件注入键：`ctx.queue`
-
-## 活体端点
-
-```bash
-curl /api/demo/queue
-```
-
-## 文档素材
-
-来源：`content/guides/saas-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/redis.md

@@ -1,26 +0,0 @@
-# ctx.redis（自研 RESP 协议层） · backend
-
-## 概述
-
-RedisClient 实现 Redis 契约——缓存/计数/发布订阅；演示用 MemoryRedis
-
-## 装配
-
-中间件注入键：`ctx.redis`
-
-## 活体端点
-
-```bash
-curl /api/demo/redis
-```
-
-## 关联组件
-- [Table](../components/table.md)
-
-## 文档素材
-
-来源：`content/guides/data-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/router.md

@@ -1,23 +0,0 @@
-# Router 与请求 · backend
-
-## 概述
-
-Trie 路由 + 路径参数 :id + 通配符 + 方法分发——showcase 自身就是活体证明
-
-## 装配
-
-中间件注入键：`ctx.route`
-
-## 活体端点
-
-```bash
-curl /api/demo/router
-```
-
-## 文档素材
-
-来源：`content/guides/server-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/schedule.md

@@ -1,23 +0,0 @@
-# 定时任务（ctx.schedule/cron） · backend
-
-## 概述
-
-cron 表达式调度——演示：日志计数端点
-
-## 装配
-
-中间件注入键：`ctx.schedule`
-
-## 活体端点
-
-```bash
-curl /api/demo/cron
-```
-
-## 文档素材
-
-来源：`content/guides/saas-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/sql.md

@@ -1,27 +0,0 @@
-# ctx.sql（自研 PG 协议层） · backend
-
-## 概述
-
-PgConnection 实现 Sql 契约——演示用 MemorySql（零 docker），文档说明换 postgres() 一行代码
-
-## 装配
-
-中间件注入键：`ctx.sql`
-
-## 活体端点
-
-```bash
-curl /api/demo/sql
-```
-
-## 关联组件
-- [Form](../components/form.md)
-- [Table](../components/table.md)
-
-## 文档素材
-
-来源：`content/guides/data-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/sse.md

@@ -1,26 +0,0 @@
-# SSE 事件流 · backend
-
-## 概述
-
-Server-Sent Events——服务端推送（流式回复/进度/通知）；wire-fake chat 即活体
-
-## 装配
-
-中间件注入键：`—`
-
-## 活体端点
-
-```bash
-curl /api/chat
-```
-
-## 关联组件
-- [AiChat](../components/aichat.md)
-
-## 文档素材
-
-来源：`content/guides/realtime-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/backend/ws.md

@@ -1,26 +0,0 @@
-# WebSocket · backend
-
-## 概述
-
-app.ws(path, handler)——双向实时（聊天/推送/协作）
-
-## 装配
-
-中间件注入键：`ctx.ws`
-
-## 活体端点
-
-```bash
-curl /ws/echo
-```
-
-## 关联组件
-- [AiChat](../components/aichat.md)
-
-## 文档素材
-
-来源：`content/guides/realtime-guide.md`（迁移至本节——P3）
-
-## 验证
-
-> curl 活体端点断言响应（P2 填充具体断言）

package/content/capabilities/app-node.md

@@ -1,21 +0,0 @@
-# 多应用（registerApp/hApp） · capabilities
-
-## 概述
-
-注册表 + 独立状态 + app:* 边界事件——应用编排
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/registry.ts`
-
-## 平台自证
-
-- multi 应用模板
-
-## 相关纪律
-
-`AGENTS.md §3.3`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/app-node` ——（P1 填充）

package/content/capabilities/data.md

@@ -1,21 +0,0 @@
-# ctx.data 数据管道 · capabilities
-
-## 概述
-
-get/set/has + 并发合并——SSR/hydration/SPA 三场景自动适配
-
-## 框架源码
-
-`src/client/ui-dom/`
-
-## 平台自证
-
-- （P2：示例页）
-
-## 相关纪律
-
-`AGENTS.md §3.4`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/data` ——（P1 填充）

package/content/capabilities/events.md

@@ -1,21 +0,0 @@
-# 事件流（stream） · capabilities
-
-## 概述
-
-DOM↔事件流全链路因果可回放——__wf_tail 实时观测
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/events.ts`
-
-## 平台自证
-
-- __wf_tail 观测面板
-
-## 相关纪律
-
-`AGENTS.md §6`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/events` ——（P1 填充）

package/content/capabilities/hooks.md

@@ -1,22 +0,0 @@
-# hooks 族 · capabilities
-
-## 概述
-
-useMedia/useInView/useChat/usePopup…——事件驱动重渲染
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/`
-
-## 平台自证
-
-- 懒渲染
-- 弹层
-
-## 相关纪律
-
-`AGENTS.md §4.2`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/hooks` ——（P1 填充）

package/content/capabilities/i18n.md

@@ -1,21 +0,0 @@
-# i18n 中间件 · capabilities
-
-## 概述
-
-locale/setLocale/t + 页面级重渲染（demo 专用 AppMiddleware）
-
-## 框架源码
-
-`src/client/ui-dom/i18n.ts`
-
-## 平台自证
-
-- 中英切换
-
-## 相关纪律
-
-`AGENTS.md §4`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/i18n` ——（P1 填充）

package/content/capabilities/popup.md

@@ -1,21 +0,0 @@
-# usePopup 弹窗基座 · capabilities
-
-## 概述
-
-portal + 定位 + 外部点击/Escape + 会话级模态——新弹层一律复用
-
-## 框架源码
-
-`src/client/ui-dom/popup.ts`
-
-## 平台自证
-
-- Drawer/代码抽屉/下拉
-
-## 相关纪律
-
-`AGENTS.md §5.4`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/popup` ——（P1 填充）

package/content/capabilities/render-only.md

@@ -1,23 +0,0 @@
-# render-only 状态 · capabilities
-
-## 概述
-
-只有 ctx.render() 一种触发——状态是普通对象（let/createStore），无 $ Proxy 无隐式触发
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/router.ts`
-
-## 平台自证
-
-- 搜索框
-- 主题切换
-- 应用页内嵌 router
-
-## 相关纪律
-
-`AGENTS.md §4`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/render-only` ——（P1 填充）

package/content/capabilities/router.md

@@ -1,22 +0,0 @@
-# UIRouter 路由 · capabilities
-
-## 概述
-
-pathname 路由 + :param + layout 包裹复用 + 隔离模式（页面内嵌子路由）
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/router.ts`
-
-## 平台自证
-
-- showcase 八域导航
-- app demo 嵌入
-
-## 相关纪律
-
-`AGENTS.md §3.5`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/router` ——（P1 填充）

package/content/capabilities/self-id.md

@@ -1,21 +0,0 @@
-# selfId 精准刷新 · capabilities
-
-## 概述
-
-自定义组件 ID——任意位置 render([id]) 跨组件精准定位
-
-## 框架源码
-
-`src/client/ui-dom/vdom3/`
-
-## 平台自证
-
-- （示例页）
-
-## 相关纪律
-
-`AGENTS.md §4.3`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/self-id` ——（P1 填充）

package/content/capabilities/store.md

@@ -1,21 +0,0 @@
-# createStore + useExternal · capabilities
-
-## 概述
-
-共享状态原语：普通对象 + subscribe/set/update/notify——跨组件通道
-
-## 框架源码
-
-`src/client/ui-dom/store.ts`
-
-## 平台自证
-
-- 主题/语言偏好跨页同步
-
-## 相关纪律
-
-`AGENTS.md §4.5`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/store` ——（P1 填充）

package/content/capabilities/theme.md

@@ -1,21 +0,0 @@
-# 主题系统 · capabilities
-
-## 概述
-
---wf-* token 双层（亮/暗/自动）+ ThemeSwitch + localStorage 持久化
-
-## 框架源码
-
-`src/layout/_tokens.css`
-
-## 平台自证
-
-- ThemeSwitch 全站
-
-## 相关纪律
-
-`AGENTS.md §8`
-
-## 验证
-
-> agent-browser 走查：打开 `/capabilities/theme` ——（P1 填充）