快速开始

用 @pluxel/create 创建一个可以直接运行的应用。示例包含 React Todo 页面、提供 HTTP API 的插件和管理插件的 Workbench；先跑起来，再按需要了解插件、配置和宿主。

创建并启动复制锚点链接

先按 mise 入门安装并激活 mise。使用 Node.js 24、pnpm 11 和 Vite+ 创建项目，进入生成目录后安装项目固定的工具链：

mise exec node@24 pnpm@11 viteplus@1.3.0 -- vp create @pluxel my-app --no-install
cd my-app
mise trust
mise install
vp install
vp run setup
vp run dev

vp create @pluxel 调用 @pluxel/create。这里用 --no-install 先生成文件，再由 vp install 安装依赖、vp run setup 准备 Pluxel 工作区。目标目录需要不存在或为空；不需要克隆 Pluxel 源码或全局安装 CLI。

项目初始化 Git 后运行 vp run hooks:install 安装 hk 提交检查。工具职责、常用命令和代理设置见工作区工具链。

确认应用已运行复制锚点链接

vp run dev 通过 Pitchfork 启动 app 服务，命令结束后服务继续运行。用 pitchfork logs app 查看 Vite 打印的 Application 地址并打开。页面标题是 Todo route lab：输入一条待办并点击 Add，再试着勾选完成或删除。

这条操作已经经过完整的应用链路：React 页面请求同一站点的 /api/example/todos，HTTP 插件调用 Todo 插件处理状态。

打开同一日志中打印的 Workbench 地址，可以查看和管理插件。它位于同一应用地址的 /__pluxel/workbench 路径。

示例的待办数据保存在内存中，重启后会重置。需要持久化时再接入数据库。

项目默认启用固定 8088 端口的 HTTP 代理，无需项目外配置。已有 supervisor 的迁移和代理诊断见工作区指南。需要直接调试 Vite 时运行：

pitchfork stop app
vp run @example/host#dev:server

打开这次 Vite 输出的本地地址即可，应用和 API 仍在同一个服务中。结束托管开发会话时使用 pitchfork stop app。

做第一处修改复制锚点链接

打开 host/web/src/client/main.tsx，把页面中的标题改成自己的项目名称：

<h1>我的待办应用</h1>

保存后查看页面更新。接下来按你要修改的内容选择文件：

生成项目中的包暂时使用 @example/* 名称，my-app 是你的目录名。可以先围绕示例开发，再统一替换这些包名。

验证与构建复制锚点链接

在项目根目录运行完整检查：

vp run verify

它会执行格式、lint、类型检查、测试和构建。只需要构建并启动生产版本时：

vp run build
vp run @example/host#start

示例使用同一个应用声明描述固定插件与可选动态来源，开发时支持热更新。配置来源与启动策略见配置插件宿主。

接下来做什么复制锚点链接

• 继续开发这个应用：示例项目结构与开发流程。
• 编写自己的插件：编写第一个插件，再了解插件依赖与生命周期。
• 添加一个功能：HTTP 接口、配置与默认值、Workbench 界面。
• 定位并修改已有功能，或让 coding agent 协助开发：从开发工作流程选择 inspect、devconsole 和测试，再读任务对应的功能指南。