大风 OS 开发者中心

本站是仓库文档的只读投影. 规则的执行以 pytest 硬门 + lint 为准, 不以本站文字为准. 单一事实源: windypos/docs/architecture/ + tests/df_os/ + tools/manifest_lint/

一句话心智模型

写一个大风 OS 应用 ≈ 写一个 Android 应用: 填 manifest 注册 → 调 kernel 域服务干活 → 听域事件响应业务 → 自己的数据放私有 schema (df_app_*) → 要共享的数据升格进 kernel 域. 卸载时私有空间清空, 流经域的数据 (券/审计/事件) 合法留下.

为什么有这么多规则

平台上应用会持续增长, 短期营销应用随上随下. 最大的成本是沟通和遵循 — 一个不守规矩的 App 会让系统混乱到不可管理. 所以:

1. 规则 = 代码, 不是约定. 每条铁律都有 pytest sentinel + lint CLI 双门, CI 拒 merge. 文档只是投影.
2. 例外必须显式. 唯一通道是仓库根 .hardrule_exemptions.yaml, 5 字段全必填, 有到期日, 过期违规复活.
3. 走对路比走老路省力. 用脚手架起新 App, 合规是默认值.

开发一个新 App 的最短路径

# 1. 起骨架 (合规 manifest 默认生成)
python tools/new_app.py --id df-app-xxx --type ui --lifecycle campaign

# 2. 本地过门 (CI 会再跑一遍, 本地先过省 PR 往返)
python -m pytest tests/df_os/test_manifest_hardgate.py -q
python tools/manifest_lint/consistency.py

# 3. 开发 → PR → CI 全绿 → merge → 部署

任何一步红了, 报错信息里写了违反哪条铁律和怎么修. 不要绕, 绕不过去的.

快速导航

你想做什么	看哪页
了解全部铁律和执行点	平台宪法
开发新 App	App 开发指南
调别的服务的数据/功能	通信与数据共享
做一个促销/活动 App	Campaign 生命周期
manifest 字段怎么填	Manifest 规范
数据同步/ETL	数据与 ETL 规范
我是 AI Agent	AI 协作入口 或直接读 /llms.txt