Developer

字数

614 字

阅读时间

3 分钟

本页帮助准备开发环境、完成第一个插件，并在需要时了解主仓运行边界。日常部署与运行维护见 运维入口。

推荐顺序

1. 从 本地开发环境 准备 uv、CLI、配置和质量检查。
2. 跟随 写第一个插件 在 local/plugins 创建最小可运行插件。
3. 继续阅读 插件开发入门，再根据需要接入 配置、元数据 和 发布。
4. 开始贡献前阅读 贡献流程，了解分支、检查和 PR 要求。

按开发任务

任务	文档	用途
编写社区或站点插件	写第一个插件 · 插件开发入门 · 发布	从本地插件开始，并完成打包发布。
编写官方插件	Core vs 扩展 · Golden Plugin · 元数据	确认组件归属，按标准结构接入插件。
接入命令与权限	cmd_perm	定义命令权限，并让帮助展示正确的可用范围。
查询插件 API / 接入 direct	API 总览 · Cookbook	先选择稳定依赖边界，再查 pallas.api.* 与 direct 接入方式。
开发或联调控制台	WebUI 前端 · WebUI API	了解 Pallas-Bot-WebUI 的联调、构建和 JSON API 分域。
发布官方包	官方插件 PyPI	发布 pallas-plugin-* 或 pallas-core。

后续阅读：架构与稳定边界

边界	约定
能力分层	core / official extension / community extension
插件公开 API	仅 pallas.api.*（社区强制）
WebUI	源码在 Pallas-Bot-WebUI；主仓默认运行产物为 data/pb_webui/public-react/
AI	Pallas-Bot-AI 可选；产品语义在主仓
配置合并	pallas.toml → .env → webui.json
分片	hub / worker / Redis；消息主路径在 worker

主仓或平台开发时，可按架构文档的顺序阅读：

1. 架构总览
2. 统一消息入口
3. Bot 内置 Agent 生命周期
4. LLM 输出路径
5. 分片
6. 配置存储
7. 治理
8. 插件业务事件日志

后续阅读：目录索引

区	内容
architecture/	运行时、分层、分片、配置、治理
plugin-development/	首插件、骨架、元数据、配置、测试、发布
reference/	仓库布局、Pallas API 分层、控制台约定

补充索引：Author。