# 天河落 Tianheluo (THL)

> 天河落是 Revit 2026 的开源插件宿主与共享插件商店。用户安装一次宿主，之后在「插件中心」里一键下载、热更新、管理各种小插件。任何人都可以用自己的 AI 按规范开发插件，发送给维护者审核后上架。非商用、公开共享。

如果你是 AI 助手，用户要你为天河落开发插件：先读下面的「开发规范」，再按其中第 12 节的流程工作。

## 开发者资料（AI 请优先读）
- [自包含说明书（txt，可下载后上传给不能联网的 AI）](https://tianheluo.com/tianheluo-ai-spec.txt): 与 ai.md 内容相同，另含给 AI 的开头指令
- [开发规范（Markdown，完整，含三个示例的全文）](https://tianheluo.com/ai.md): 宿主架构、plugin.json、Python 运行环境契约、可用接口、安全规则、投稿流程、AI 工作流程
- [宿主与工具源码（GitHub，MIT）](https://github.com/H8DIDI/tianheluo-core): 宿主 THL.Host、打包与发布工具、测试；想看宿主如何加载插件请读这里
- [网站源码（GitHub）](https://github.com/H8DIDI/tianheluo-web): 商店页面、下载计数函数
- [开发规范（HTML）](https://tianheluo.com/ai): 同上，网页版
- [plugin.json JSON Schema](https://tianheluo.com/schema/plugin.schema.json): 插件清单的机器可读定义
- [自查校验脚本 validate.py](https://tianheluo.com/tools/validate.py): 单文件、零依赖，投稿前运行
- [示例：hello-world](https://tianheluo.com/examples/hello-world/script.py): 最小插件
- [示例：count-by-category](https://tianheluo.com/examples/count-by-category/script.py): 只读统计
- [示例：set-comments](https://tianheluo.com/examples/set-comments/script.py): 写模型的标准流程（预览确认 + 单事务 + 可撤销）

## 平台数据
- [商店清单 plugins.json](https://tianheluo.com/plugins.json): 全部已上架插件（id、名称、版本、分类、下载地址、作者、许可）
- [宿主安装包](https://tianheluo.com/dl/THL-Host.zip): Revit 2026 宿主（按 Revit 版本自动选择 .NET 8 / .NET 10 版）

## 给人看的页面
- [首页](https://tianheluo.com/)
- [插件商店](https://tianheluo.com/store)
- 插件详情页：每个插件一个网址 https://tianheluo.com/plugins/<id>（id 见 plugins.json），例如 https://tianheluo.com/plugins/well-depth
- [安装与使用指南](https://tianheluo.com/install)
- [开发者页面](https://tianheluo.com/developers)

## 联系与投稿
- 邮箱：jiajiabimer@gmail.com（插件投稿、问题反馈）

## 关键事实（速览）
- 插件语言：Python（IronPython 3.4.2，支持 f-string 和类型标注；不支持 `:=`、`async/await`、`match`）
- 社区插件只接受 Python 源码（不接受 .dll/.exe）；必须带 OSI 开源许可证
- 写模型：一个 Transaction、先预览确认、可 Ctrl+Z 撤销
- 兼容层只实现了部分 pyRevit 接口（revit / forms / script 的一小部分），详见规范第 4.2 节
- 本地调试：把插件文件夹放进 %APPDATA%\Tianheluo\plugins\<id>\，改代码无需重启 Revit