doc/README.md

Rama main · réplica de lectura del repositorio original.

# 文档导航

[项目首页](../README.md) · [English](../README.en.md)

## 按角色选择入口

| 角色 | 先做 | 入口 |
| --- | --- | --- |
| 插件作者 | 从 starter 跑通 `list / check / pack`，交付完整发布目录 | [独立作者接入](plugin-development.md) |
| 部署者 | 把完整发布目录放入 `incoming`，执行 build 并请求实际端点 | [插件产物一键部署](first-deployment.md) |
| 站点维护者 | 处理源码发版、锁与记录诊断、失败重试和迁移 | [部署与管理](../deploy/README.md) |

第一次使用不需要读完所有文档。作者先看起步包 README；部署者只处理发布目录，不需要作者源码；恢复和高级配置属于维护路径。

## 体验与导览

1. [登录、授权与问答体验](getting-started.md)：使用 auth/example 验证实际功能。
2. [图文导览](quick-tour.md)：查看页面与操作效果。

## 开发插件

- [插件声明与实例配置](plugin-configuration.md)
- [kit 接口](../packages/plugin-kit/README.md)
- [内部工作区开发](plugin-development.md#内部工作区开发)
- [复制完整问答应用](plugin-development.md#复制完整问答应用到独立仓库)
- [会话管理](conversation-management.md)
- [聊天风格](../plugins/builtin/dsh-example/skills/dsh-chat-style/SKILL.md)

## 部署与维护

- [框架配置与默认值](framework-configuration.md)：站点参数、入口固定的 source/archives 形态与凭据规则。
- [源码部署与失败收敛](../deploy/README.md)：按需构建、锁、失败后重跑普通 build 与一次性站点迁移。
- [独立 CLI 交付](../packages/plugin-manager/DELIVERY.md)：手工清单组合、Node/Compose 操作；随工具包可离线阅读。
- [Docker 镜像与网络](../integrations/docker/README.md)
- [数据与产物迁移](migration.md)
- [宿主兼容](host-compatibility.md)
- [发布物验证记录](../packages/plugin-manager/VERIFICATION.md)

## 查询与维护规则

[FAQ](FAQ.md)负责故障判别，[架构](architecture.md)说明职责，[版本管理](versioning.md)说明模板与发行同步，[AGENTS.md](../AGENTS.md)规定开发约束。历史版本内容见各 Release，不用旧版本说明代替当前操作文档。