开发指南
本分区适用于 Ithiltir Dash、Ithiltir-node、主题包和文档站的二次开发。部署步骤见 安装部署,运行参数见 配置总览,日常管理见 运维总览。
开发对象
| 对象 | 代码库 | 入口 |
|---|---|---|
| Ithiltir Dash | Ithiltir | 系统架构、源码开发环境、Dash 组件 |
| Ithiltir-node | Ithiltir-node | 源码开发环境、Node 组件、节点上报协议 |
| 主题包 | Ithiltir | 主题开发、主题配置 |
| 文档站 | Ithiltir-docs | 开发准则、构建 |
开发入口
- 开发准则:公共契约、兼容性、测试和文档要求。
- 源码开发环境:Dash、前端开发服务器和 Ithiltir-node 的本地运行命令。
- 构建:Dash 前端、Dash 发布包和 Ithiltir-node 的稳定构建命令。
- 主题开发:建立、打包、上传和验证自定义主题包。
契约位置
| 变更范围 | 文档 |
|---|---|
| Dash HTTP 路由、字段和状态码 | Dash HTTP API、错误语义 |
| Node 命令和上报行为 | Node CLI、节点上报协议 |
| Dash 启动参数和运行时设置 | 配置总览 |
| 指标、磁盘和主题包结构 | 运行时指标结构、磁盘结构、主题包格式 |
修改用户可见行为或公共契约时,同步更新中文和英文文档。