pi-web-ui 的扩展面只有两块插件与主题。它们的共同点是免重建、免重启——你不用改它的源码也不用重新打包放对位置、刷新页面就能生效。本文从一个最小目标出发给自己加一个顶栏标签页顺带把插件目录结构、安装与回滚、以及主题的覆盖规则讲清楚。想先看看同类插件的中文清单与安装形态可以对照 完整插件清单与汉化避坑指南。扩展面只有两块插件与主题插件负责往界面里加东西主题负责改配色。两者都放在数据目录下互不干扰也都能单独回退。先把这一点记住pi-web-ui 的布局始终来自它内置的那份样式表主题只是在其之上覆盖一组 CSS 变量所以任何主题都不会因为布局变化而失效。更多同类插件的安装形态可以顺手看 完整插件清单与汉化避坑指南。插件就是一个目录外加两个可选入口插件本质上是可选 UI 组件一个额外的顶栏标签页背后是它自己的客户端视图此外还可以带一个服务端入口以及供智能体调用的工具。它落在数据目录的插件文件夹下路径形如dataDir/plugins/id/默认是~/.pi-web/plugins/。一个插件就是一个目录里面至少要有manifest.json插件的声明。index.mjs可选服务端入口。client/entry.mjs可选客户端视图入口。没有插件目录就等于没有插件界面里什么都不会出现——不存在「装了一半」的中间态。从仓库里的最小模板抄起仓库里保留着一个最小插件模板它同时充当测试夹具包含服务端入口、客户端视图以及双向消息协议是动手写自己插件最省事的起点。写完之后把它放进插件目录或者用命令行从 GitHub、从本地目录装进去都可以。装、更新、回滚CLI 与界面两条路安装可以走命令行以 GitHub 仓库为源是最常见的形式也支持指定分支、子目录甚至可以指向本地目录做开发。也可以直接手工把一个插件目录拷进插件文件夹效果一样。界面里同样有插件市场列出可维护的插件提供安装、更新、卸载控件也允许你把自己的第三方插件源添加进去。装完之后不需要重启服务在跑就刷新浏览器插件会被自动接管新插件在顶栏出现为一个标签页服务没在跑就在下次启动时加载。想临时藏起来又不想卸载可以用设置里的界面插件开关它按客户端保存纯视觉随时能再打开。旧版本会自动留一份快照更新用同源的强制重装插件的本地配置会被保留。这里有两个要提前知道的点一是强制重装只保护插件自己的那份配置文件插件目录里其它本地状态不在保护范围内升级前最好备份二是升级本身可回滚——每次强制安装都会把被替换的旧版本快照存进数据目录下的plugin-backups/只保留最新三份且拷贝失败会自动回滚。需要撤销时用pi-web-ui plugins --rollback id想知道哪些插件落后了pi-web-ui plugins --check-updates会比对记录的提交与远端指针并打印出精确的更新命令。插件能带来什么标签页、服务端能力与智能体工具除了自己的页面插件还能注册斜杠命令这类命令在服务端执行、不消耗 token也可以注册带独立停止按钮的后台任务声明一份设置表单订阅运行、工具与会话事件并从自己的客户端包访问宿主。也就是说插件既能是「一个额外的标签页」也能是「给智能体补一组能力」。主题就是一份只改变量的 CSS主题是一个纯调色板覆盖文件只设置 CSS 变量。内置主题随包分发有二十多个调色板你放在数据目录主题文件夹里的任何 CSS 文件都会自动出现在主题菜单里不需要重启也不需要重建文件名去掉.css就是它在菜单里的 id。主题的合并规则是用户主题与内置主题同名时用户主题胜出你没有列出的变量会回落到默认的深色值。让终端和代码高亮跟着主题一起变要让终端也可读主题里必须设置终端相关的一组变量包括 ANSI 调色板与终端背景终端画布和它的容器会自动跟随。另一个容易被忽略的是代码语法高亮内置的是一份偏深色的高亮样式浅色主题必须在自己的文件里覆盖.hljs语法色否则代码会看不清深色主题可以跳过这一步。主题 id 必须由字母、数字、下划线或连字符组成不能带点或斜杠——服务端有一道防路径穿越的校验。想把自己的主题贡献进仓库规则同样简单单个 CSS 文件、为终端设好相关变量、浅色主题覆盖语法色。社区目录与自动安装别误解这一步社区插件目录有一个默认地址它只写可安装列表、并不会安装插件把它设成空或关闭即可停用。只有在配合「启动时自动安装」这个开关时目录里的条目才会在启动阶段被装进去——这是给无头或容器化预置准备的路径普通使用不需要打开。另外插件的代码是在安装时从源仓库拉取的一个社区条目只是一个指针它的许可、issue 与发布节奏都归作者所有需要锁定版本就在源里带上引用。需要一并说明的是该插件在本站的静态安全扫描中被评为 高危安装期即执行代码、命令参数由运行时变量拼接目前没有任何人工复核。请把它当成一条待核实的提示而不是安全承诺。总结插件管「多出一块界面与能力」主题管「换一套配色」两者都免重建、免重启且可回滚安装前想先比对同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。适合与不适合适合想给自己工作流加一个专属标签页的人需要把内部工具挂到同一个工作台、并用命令行统一安装与回滚的团队想把界面改成顺眼配色、并让终端与代码高亮一起跟上的用户用容器做无头预置、需要在启动阶段把插件装好的人。不适合指望社区目录一开就自动装好插件、不愿动手确认的人插件里存了自定义状态却没做备份、又频繁强制重装的人需要跨端严格锁定同一份主题产物的团队因为主题是按浏览器选择保存的只想要默认外观、不想维护任何 CSS 的人。标签pi-web-ui、DeepSeek Harness、插件扩展、主题定制本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。