docs(feishu): 添加富文本组件文档并更新配置说明
feat(config): 重构主机配置加载逻辑以支持多主机和独立模式 docs(readme): 更新安装和运行说明，添加多主机模式配置指南
This commit is contained in:
Yuyao Huang (Sam)
parent
52a9d085f7
commit
6cf2143987
86
README.md
86
README.md
@ -159,12 +159,12 @@ ROUTER_SECRET: your-shared-secret-for-router-host-auth
|
||||
|
||||
### Host Client Configuration (for multi-host mode)
|
||||
|
||||
Create `host_config.yaml` for each host client:
|
||||
Create `host_config.yaml` on each host client machine:
|
||||
|
||||
```yaml
|
||||
NODE_ID: home-pc
|
||||
DISPLAY_NAME: Home PC
|
||||
ROUTER_URL: wss://router.example.com/ws/node
|
||||
ROUTER_URL: ws://192.168.1.100:8000/ws/node
|
||||
ROUTER_SECRET: <shared_secret>
|
||||
|
||||
OPENAI_BASE_URL: https://open.bigmodel.cn/api/paas/v4/
|
||||
@ -179,6 +179,37 @@ SERVES_USERS:
|
||||
- ou_abc123def456
|
||||
```
|
||||
|
||||
#### Determining `ROUTER_URL`
|
||||
|
||||
`ROUTER_URL` is the WebSocket address of the machine running the router (`python main.py`).
|
||||
|
||||
| Scenario | Value |
|
||||
|---|---|
|
||||
| Router and host client on the same LAN | `ws://192.168.x.x:8000/ws/node` |
|
||||
| Router on a public VPS (no TLS) | `ws://your-server-ip:8000/ws/node` |
|
||||
| Router behind a reverse proxy with TLS | `wss://yourdomain.com/ws/node` |
|
||||
|
||||
To find the router machine's LAN IP on Windows: `ipconfig` → look for IPv4 Address under your active adapter.
|
||||
|
||||
The router binds to `0.0.0.0:8000`, so any IP or hostname that reaches that machine on port 8000 will work.
|
||||
|
||||
#### Determining `ROUTER_SECRET`
|
||||
|
||||
`ROUTER_SECRET` is a shared secret that authenticates host client connections. Generate it once on any machine:
|
||||
|
||||
```bash
|
||||
python -c "import secrets; print(secrets.token_hex(32))"
|
||||
```
|
||||
|
||||
Copy the output. Set the **same value** in:
|
||||
- `keyring.yaml` on the router machine (under `ROUTER_SECRET`)
|
||||
- `host_config.yaml` on every host client machine (under `ROUTER_SECRET`)
|
||||
|
||||
If the secrets don't match, the router will reject the connection with code 4001.
|
||||
|
||||
In standalone mode (`python standalone.py`), the secret is auto-generated at startup and never needs to be configured.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Installation & Run
|
||||
@ -191,14 +222,47 @@ source .venv/Scripts/activate # Windows
|
||||
# source .venv/bin/activate # Linux/macOS
|
||||
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### Standalone mode (single machine)
|
||||
|
||||
Runs router + host client in one process. This is the normal setup for personal use.
|
||||
|
||||
```bash
|
||||
cp keyring.example.yaml keyring.yaml
|
||||
# Fill in keyring.yaml, then:
|
||||
python standalone.py
|
||||
```
|
||||
|
||||
### Multi-host mode
|
||||
|
||||
**Router** (public VPS or any reachable machine — runs the Feishu bot):
|
||||
|
||||
```bash
|
||||
# keyring.yaml must have ROUTER_MODE: true and ROUTER_SECRET set
|
||||
python main.py
|
||||
```
|
||||
|
||||
Server listens on `http://0.0.0.0:8000`.
|
||||
**Host client** (your dev machine behind NAT — runs Claude Code):
|
||||
|
||||
Health check: `GET /health`
|
||||
Claude smoke test: `GET /health/claude`
|
||||
Active sessions: `GET /sessions`
|
||||
```bash
|
||||
# Fill in host_config.yaml with ROUTER_URL and ROUTER_SECRET, then:
|
||||
python -m host_client.main
|
||||
```
|
||||
|
||||
Generate a shared secret for `ROUTER_SECRET`:
|
||||
|
||||
```bash
|
||||
python -c "import secrets; print(secrets.token_hex(32))"
|
||||
```
|
||||
|
||||
Set the **same value** in `keyring.yaml` on the router and `host_config.yaml` on each host client.
|
||||
|
||||
### Health check
|
||||
|
||||
```
|
||||
GET /health
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@ -235,27 +299,29 @@ Claude Code slash commands (like `/help`, `/clear`, `/compact`, `/cost`) are pas
|
||||
|
||||
## Features
|
||||
|
||||
### Core Reliability
|
||||
### Prototype Consolidation (Milestone 1)
|
||||
|
||||
#### Core Reliability
|
||||
|
||||
- **Message splitting** - Long responses automatically split into multiple messages instead of getting cut off
|
||||
- **Concurrent handling** - Multiple users can message the bot simultaneously without conflicts
|
||||
- **Session persistence** - Active sessions survive server restarts (saved to disk)
|
||||
- **Direct mode** - Messages go straight to Claude Code, skipping the LLM for faster responses
|
||||
|
||||
### Better Interaction
|
||||
#### Better Interaction
|
||||
|
||||
- **Slash commands** - Direct control via `/new`, `/status`, `/switch`, `/close`, `/direct`, `/smart`
|
||||
- **Multi-session switching** - Multiple projects open simultaneously, switch between them
|
||||
- **Interactive cards** - Session status displayed in Feishu message cards
|
||||
|
||||
### Operational Quality
|
||||
#### Operational Quality
|
||||
|
||||
- **Health checks** - `/health` endpoint shows WebSocket status and can test Claude Code connectivity
|
||||
- **Auto-reconnection** - WebSocket automatically reconnects if the connection drops
|
||||
- **Configurable timeouts** - Each session can have custom idle and execution timeout settings
|
||||
- **Audit logging** - All conversations logged to files for debugging and accountability
|
||||
|
||||
### Security
|
||||
#### Security
|
||||
|
||||
- **User allowlist** - Configure which Feishu users are allowed to use the bot
|
||||
- **Session isolation** - Each user can only see and access their own sessions
|
||||
|
||||
482
docs/feishu/markdown_card.md
Normal file
482
docs/feishu/markdown_card.md
Normal file
@ -0,0 +1,482 @@
|
||||
# 富文本组件
|
||||
|
||||
JSON 2.0 结构卡片的富文本（Markdown）组件支持渲染标题、表情、表格、图片、代码块、分割线等元素。
|
||||
**注意事项**：本文档介绍富文本组件的 JSON 2.0 结构，要查看历史 JSON 1.0 结构，参考[富文本（Markdown）](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-components/content-components/rich-text)。
|
||||
|
||||
|
||||
|
||||
## 注意事项
|
||||
富文本 JSON 2.0 结构不再支持以下差异化跳转语法。你可使用含图标的链接语法（`<link></link>`）替代，如：
|
||||
`<link icon='chat_outlined' url='https://applink.feishu.cn/client/chat/xxxxx' pc_url='' ios_url='' android_url=''>差异化链接</link>`。
|
||||
```json
|
||||
{
|
||||
"tag": "markdown",
|
||||
"href": {
|
||||
"urlVal": {
|
||||
"url": "xxx",
|
||||
"pc_url":"xxx",
|
||||
"ios_url": "xxx",
|
||||
"android_url": "xxx"
|
||||
}
|
||||
},
|
||||
"content":
|
||||
"[差异化跳转]($urlVal)"
|
||||
}
|
||||
```
|
||||
|
||||
## 组件属性
|
||||
|
||||
### JSON 结构
|
||||
|
||||
富文本组件的完整 JSON 2.0 结构如下所示：
|
||||
```json
|
||||
{
|
||||
"schema": "2.0", // 卡片 JSON 结构的版本。默认为 1.0。要使用 JSON 2.0 结构，必须显示声明 2.0。
|
||||
"body": {
|
||||
"elements": [
|
||||
{
|
||||
"tag": "markdown",
|
||||
"element_id": "custom_id", // 操作组件的唯一标识。JSON 2.0 新增属性。用于在调用组件相关接口中指定组件。需开发者自定义。
|
||||
"margin": "0px 0px 0px 0px", // 组件的外边距，JSON 2.0 新增属性。默认值 "0"，支持范围 [-99,99]px。
|
||||
"content": "人员<person id = 'ou_449b53ad6aee526f7ed311b216aabcef' show_name = true show_avatar = true style = 'normal'></person>", // 采用 mardown 语法编写的内容。2.0 结构不再支持 "[差异化跳转]($urlVal)" 语法
|
||||
"text_size": "normal", // 文本大小。默认值 normal。支持自定义在移动端和桌面端的不同字号。
|
||||
"text_align": "left", // 文本对齐方式。默认值 left。
|
||||
"icon": {
|
||||
// 前缀图标。
|
||||
"tag": "standard_icon", // 图标类型。
|
||||
"token": "chat-forbidden_outlined", // 图标的 token。仅在 tag 为 standard_icon 时生效。
|
||||
"color": "orange", // 图标颜色。仅在 tag 为 standard_icon 时生效。
|
||||
"img_key": "img_v2_38811724" // 图片的 key。仅在 tag 为 custom_icon 时生效。
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 字段说明
|
||||
|
||||
富文本组件包含的参数说明如下表所示。
|
||||
|
||||
字段名称 | 是否必填 | 类型 | 默认值 | 说明
|
||||
---|---|---|---|---
|
||||
tag | 是 | String | / | 组件的标签。富文本组件固定取值为 `markdown`。
|
||||
element_id | 否 | String | 空 | 操作组件的唯一标识。JSON 2.0 新增属性。用于在调用[组件相关接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/cardkit-v1/card-element/create)中指定组件。在同一张卡片内，该字段的值全局唯一。仅允许使用字母、数字和下划线，必须以字母开头，不得超过 20 字符。
|
||||
margin | 否 | String | 0 | 组件的外边距。JSON 2.0 新增属性。值的取值范围为 [-99,99]px。可选值：<br>- 单值，如 "10px"，表示组件的四个外边距都为 10 px。<br>- 双值，如 "4px 0"，表示组件的上下外边距为 4 px，左右外边距为 0 px。使用空格间隔（边距为 0 时可不加单位）。<br>- 多值，如 "4px 0 4px 0"，表示组件的上、右、下、左的外边距分别为 4px，12px，4px，12px。使用空格间隔。
|
||||
text_align | 否 | String | left | 设置文本内容的对齐方式。可取值有：<br>* left：左对齐<br>* center：居中对齐<br>* right：右对齐
|
||||
text_size | 否 | String | normal | 文本大小。可取值如下所示。如果你填写了其它值，卡片将展示为 `normal` 字段对应的字号。<br>- heading-0：特大标题（30px）<br>- heading-1：一级标题（24px）<br>- heading-2：二级标题（20 px）<br>- heading-3：三级标题（18px）<br>- heading-4：四级标题（16px）<br>- heading：标题（16px）<br>- normal：正文（14px）<br>- notation：辅助信息（12px）<br>- xxxx-large：30px<br>- xxx-large：24px<br>- xx-large：20px<br>- x-large：18px<br>- large：16px<br>- medium：14px<br>- small：12px<br>- x-small：10px
|
||||
icon | 否 | Object | / | 添加图标作为文本前缀图标。支持自定义或使用图标库中的图标。
|
||||
└ tag | 否 | String | / | 图标类型的标签。可取值：<br>- `standard_icon`：使用图标库中的图标。<br>- `custom_icon`：使用用自定义图片作为图标。
|
||||
└ token | 否 | String | / | 图标库中图标的 token。当 `tag` 为 `standard_icon` 时生效。枚举值参见[图标库](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/enumerations-for-icons)。
|
||||
└ color | 否 | String | / | 图标的颜色。支持设置线性和面性图标（即 token 末尾为 `outlined` 或 `filled` 的图标）的颜色。当 `tag` 为 `standard_icon` 时生效。枚举值参见[颜色枚举值](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/enumerations-for-fields-related-to-color)。
|
||||
└ img_key | 否 | String | / | 自定义前缀图标的图片 key。当 `tag` 为 `custom_icon` 时生效。<br>图标 key 的获取方式：调用[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口，上传用于发送消息的图片，并在返回值中获取图片的 image_key。
|
||||
content | 是 | String | / | Markdown 文本内容。了解支持的语法，参考下文。
|
||||
|
||||
### Demo 示例
|
||||
|
||||
以下 JSON 2.0 结构的示例代码可实现如下图所示的卡片效果：
|
||||
|
||||
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "2.0",
|
||||
"body": {
|
||||
"elements": [
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "# 一级标题",
|
||||
"margin": "0px 0px 0px 0px",
|
||||
"text_align": "left",
|
||||
"text_size": "normal"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "标准emoji 😁😢🌞💼🏆❌✅\n飞书emoji :OK::THUMBSUP:\n*斜体* **粗体** ~~删除线~~ \n这是红色文本<\/font>\n<text_tag color=\"blue\">标签<\/text_tag>\n[文字链接](https:\/\/open.feishu.cn\/document\/server-docs\/im-v1\/message-reaction\/emojis-introduce)\n<link icon='chat_outlined' url='https:\/\/open.feishu.cn' pc_url='' ios_url='' android_url=''>带图标的链接<\/link>\n<at id=all><\/at>\n- 无序列表1\n - 无序列表 1.1\n- 无序列表2\n1. 有序列表1\n 1. 有序列表 1.1\n2. 有序列表2\n```JSON\n{\"This is\": \"JSON demo\"}\n```"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "行内引用`code`"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "数字角标，支持 1-99 数字<number_tag background_color='grey' font_color='white' url='https://open.feishu.cn' pc_url='https://open.feishu.cn' android_url='https://open.feishu.cn' ios_url='https://open.feishu.cn'>1</number_tag>"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "默认数字角标展示<number_tag>1</number_tag>"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "人员<person id = 'ou_449b53ad6aee526f7ed311b216a8f88f' show_name = true show_avatar = true style = 'normal'></person>"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "> 这是一段引用文字\n引用内换行 \n"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 支持的 Markdown 语法
|
||||
|
||||
[卡片 JSON 2.0 结构](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-structure)支持除 `HTMLBlock` 外所有标准的 Markdown 语法和部分 HTML 语法。了解 Markdown 标准语法，请参考 [CommonMark Spec 官方文档](https://spec.commonmark.org/0.31.2/)。你也可以使用 [CommonMark playground](https://spec.commonmark.org/dingus/) 预览 Markdown 效果。
|
||||
|
||||
注意，在卡片的富文本组件中，以下语法的渲染效果与 CommonMark 有差异：
|
||||
|
||||
- 富文本组件支持使用一个 Enter 键作为软换行（Soft Break）；支持两个 Enter 键作为硬换行（Hard Break）。软换行在渲染时可能会被忽略，具体取决于渲染器如何处理；硬换行在渲染时始终会显示为一个新行。
|
||||
|
||||
- 2.0 结构支持以下 HTML 语法：
|
||||
- 开标签 `<br>`
|
||||
- 自闭合标签 `<br/>`
|
||||
- 开标签 `<hr>`
|
||||
- 自闭合标签 `<hr/>`
|
||||
- 闭合标签 `<person></person>`
|
||||
- 闭合标签 `<local_datetime></local_datetime>`
|
||||
- 闭合标签 `<at></at>`
|
||||
- 闭合标签 `<a></a>`
|
||||
- 闭合标签 `<text_tag></text_tag>`
|
||||
- 闭合标签 `<raw></raw>`
|
||||
- 闭合标签 `<link></link>`
|
||||
- 闭合标签 `<font>`，支持嵌套其它标签，如 `red<font color=green>greenagain</font>`。其它标签包括：
|
||||
- 闭合标签 `<local_datetime></local_datetime>`
|
||||
- 闭合标签 `<at></at>`
|
||||
- 闭合标签 `<a></a>`
|
||||
- 闭合标签 `<link></link>`
|
||||
- 闭合标签 `<font></font>`
|
||||
|
||||
以下是一些常见的渲染效果及其对应的 Markdown 或 HTML 语法。
|
||||
|
||||
名称 | 语法 | 效果 | 注意事项
|
||||
---|---|---|---
|
||||
换行 | ```<br>第一行<br />第二行<br>第一行<br>第二行<br>``` | 第一行<br>第二行 | - 如果你使用卡片 JSON 构建卡片，也可使用字符串的换行语法 `\n` 换行。<br>- 如果你使用卡片搭建工具构建卡片，也可使用回车键换行。
|
||||
斜体 | ```<br>*斜体*<br>``` | *斜体* | 无
|
||||
加粗 | ```<br>**粗体** <br>或<br>__粗体__ <br>``` | __粗体__ | - 不要连续使用 4 个 `*` 或 `_` 加粗。该语法不规范，可能会导致渲染不正确。<br>- 若加粗效果未显示，请确保加粗语法前后保留一个空格。
|
||||
删除线 | ```<br>~~删除线~~<br>``` | ~~删除线~~ | 无
|
||||
@指定人 | ```<br><at id=open_id></at><br><at id=user_id></at><br><at ids=id_01,id_02,xxx></at><br><at email=test@email.com></at><br>``` | @用户名 | - 该语法用于在卡片中实现 @ 人的效果，被 @ 的用户将收到提及通知。但对于转发的卡片，用户将不再收到提及通知。<br>- 要在卡片中展示人员的用户名、头像、个人名片等，你可使用[人员](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-components/content-components/user-profile)或[人员列表](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-components/content-components/user-list)组件。但人员和人员列表组件仅作为展示，用户不会收到提及通知。<br>- [自定义机器人](https://open.feishu.cn/document/ukTMukTMukTM/ucTM5YjL3ETO24yNxkjN)仅支持使用 `open_id`、`user_id` @指定人。<br>- 支持使用 `<at ids=id_01,id_02,xxx></at>` 传入多个 ID，使用 `,` 连接。<br>- 了解如何获取 user_id、open_id，参考[如何获取不同的用户 ID](https://open.feishu.cn/document/home/user-identity-introduction/open-id)。
|
||||
@所有人 | ```<br><at id=all></at><br>``` | @所有人 | @所有人需要群主开启权限。若未开启，卡片将发送失败。
|
||||
超链接 | ```<br><a href='https://open.feishu.cn'><br></a><br>``` | [https://open.feishu.cn](https://open.feishu.cn) | - 超链接必须包含 schema 才能生效，目前仅支持 HTTP 和 HTTPS。<br>- 超链接文本的颜色不支持自定义。
|
||||
彩色文本样式 | ```<br>这是一个绿色文本 <br>这是一个红色文本<br>这是一个灰色文本<br>``` | <br><br> | * 彩色文本样式不支持对链接中的文本生效<br>* color 取值：<br>- **default**：默认的白底黑字样式<br>- 卡片支持的颜色枚举值和 RGBA 语法自定义颜色。参考[颜色枚举值](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/enumerations-for-fields-related-to-color)
|
||||
可点击的电话号码 | ```<br>[文本展示的电话号码或其他文案内容](tel://移动端弹窗唤起的电话号码)<br>``` |  | 该语法仅在移动端生效。
|
||||
文字链接 | ```<br>[开放平台](https://open.feishu.cn/)<br>``` | [开放平台](https://open.feishu.cn/) | 超链接必须包含 schema 才能生效，目前仅支持 HTTP 和 HTTPS。
|
||||
差异化跳转链接 | ```<br>{<br>"tag": "markdown",<br>"href": {<br>"urlVal": {<br>"url": "xxx",<br>"pc_url":"xxx",<br>"ios_url": "xxx",<br>"android_url": "xxx"<br>}<br>},<br>"content":<br>"[差异化跳转]($urlVal)"<br>}<br>``` | \- | * 超链接必须包含 schema 才能生效，目前仅支持 HTTP 和 HTTPS。<br>- 仅在 PC 端、移动端需要跳转不同链接时使用。
|
||||
图片 | ```<br><br>``` | | * `hover_text` 指在 PC 端内光标悬浮（hover）图片所展示的文案。<br>* **image_key** 可以调用[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)接口获取。
|
||||
分割线 | ```<br><hr><br>或<br>---<br>``` |  | - 推荐使用 `<hr>` 语法<br>- 分割线必须单独一行使用。即如果分割线前后有文本，你必须在分割线前后添加换行符。
|
||||
飞书表情 | ```<br>:DONE:<br>``` |  | 支持的 Emoji Key 列表可以参看 [表情文案说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message-reaction/emojis-introduce)。
|
||||
标签 | ```<br><text_tag color='red'>标签文本</text_tag><br>``` | | `color`支持的枚举值范围包括：<br>- `neutral`: 中性色<br>- `blue`: 蓝色<br>- `turquoise`: 青绿色<br>- `lime`: 酸橙色<br>- `orange`: 橙色<br>- `violet`: 紫罗兰色<br>- `indigo`: 靛青色<br>- `wathet`: 天蓝色<br>- `green`: 绿色<br>- `yellow`: 黄色<br>- `red`: 红色<br>- `purple`: 紫色<br>- `carmine`: 洋红色
|
||||
有序列表 | ```<br>1. 有序列表1<br>1. 有序列表 1.1<br>2. 有序列表2<br>``` | 1. 有序列表1<br>1. 有序列表 1.1<br>2. 有序列表2 | * 序号需在行首使用<br>* 4 个空格代表一层缩进
|
||||
无序列表 | ```<br>- 无序列表1<br>- 无序列表 1.1<br>- 无序列表2<br>```<br>在卡片 JSON 中，需添加 `\n` 换行符：<br>```<br>\n- 无序列表1\n - 无序列表 1.1\n- 无序列表2\n1. 有序列表1\n<br>``` | - 无序列表1<br>- 无序列表 1.1<br>- 无序列表2 | * 序号需在行首使用<br>* 4 个空格代表一层缩进
|
||||
代码块 | `````markdown<br>```JSON<br>{"This is": "JSON demo"}<br>```<br>````` | ```JSON<br>{"This is": "JSON demo"}<br>``` | * 代码块语法和代码内容需在行首使用<br>* 支持指定编程语言解析。未指定默认为 Plain Text<br>- 四个及以上空格（[缩进式代码块语法](https://spec.commonmark.org/0.30/#indented-code-blocks)）也将触发代码块效果
|
||||
含图标的链接 | ```<br><link icon='chat_outlined' url='https://open.feishu.cn' pc_url='' ios_url='' android_url=''>战略研讨会</link><br>``` |  | 该语法中的字段说明如下所示：<br>- `icon`：链接前缀的图标。仅支持图标库中的图标，枚举值参见[图标库](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/enumerations-for-icons)。图标颜色固定为蓝色。可选。<br>- `url`：默认的链接地址，未按设备配置下述字段时，该配置生效。必填。<br>- `pc_url`：pc 端的链接地址，优先级高于 `url`。可选。<br>- `ios_url`：ios 端的链接地址，优先级高于 `url`。可选。<br>- `android_url`：android 端的链接地址，优先级高于 `url`。可选。
|
||||
人员 | `````markdown<br><person id = 'user_id' show_name = true show_avatar = true style = 'normal'></person><br>````` |  | 该语法中的字段说明如下所示：<br>- `id`：用户的 ID，支持 open_id、union_id 和 user_id。不填、为空、数据错误时展示为兜底的“未知用户”样式。了解更多，参考[如何获取不同的用户 ID](https://open.feishu.cn/document/home/user-identity-introduction/open-id)。<br>- `show_name`：是否展示用户名。默认为 true。<br>- `show_avatar`：是否展示用户头像，默认为 true。<br>- `style`：人员组件的展示样式。可选值有：<br>- `normal`：普通样式（默认）<br>- `capsule`：胶囊样式
|
||||
标题 | ```<br># 一级标题<br>## 二级标题<br>###### 六级标题<br>``` |  | 支持一级到 6 级标题。从一级到六级的字号梯度为 26, 22 , 20, 18, 17, 14px。
|
||||
引用 | ```<br>>[空格]这是一段引用文字\n引用内换行<br>``` |  |
|
||||
行内引用 | ```<br>`code`<br>``` |  |
|
||||
表格 | ```<br>| Syntax | Description |<br>| -------- | -------- |<br>| Paragraph | Text |<br>| Paragraph | Text |<br>| Paragraph | Text |<br>| Paragraph | Text |<br>| Paragraph | Text |<br>| Paragraph | Text |<br>``` |  | - 除标题行外，最多展示五行数据，超出五行将分页展示。不支持自定义。<br>- 该语法仅支持 JSON 2.0 结构。<br>- 单个富文本组件中，最多可放置四个表格。<br>- 表格的富文本语法不支持设置列宽等。要设置列宽、数据对齐方式等，可使用[表格](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-components/content-components/table)组件。
|
||||
数字角标 | `````markdown<br><number_tag>1</number_tag><br>`````<br>`````markdown<br><number_tag background_color='grey' font_color='white' url='https://open.feishu.cn' pc_url='https://open.feishu.cn' android_url='https://open.feishu.cn' ios_url='https://open.feishu.cn'>1</number_tag>````` |  | 数字圆形角标，支持添加 0-99 之间的数字。该语法中的字段说明如下所示：<br>- `background_color`：圆圈内的背景颜色。可选。<br>- `font_color`：数字颜色。可选。<br>- `url`：点击角标时默认的跳转链接，未按设备配置下述字段时，该配置生效。可选。<br>- `pc_url`：点击角标时 PC 端的跳转链接，优先级高于 `url`。可选。<br>- `ios_url`：点击角标时 iOS 端的跳转链接，优先级高于 `url`。可选。<br>- `android_url`：点击角标时 Android 端的跳转链接，优先级高于 `url`。可选。
|
||||
国际化时间 | ```<br><local_datetime millisecond='' format_type='date_num' link='https://www.feishu.com'></local_datetime><br>``` |  | 国际化时间标签。支持自动展示用户当地时区下的时间。该语法中的字段说明如下所示：<br>- `millisecond`：要展示的时间的 Unix 毫秒时间戳。若不填，则：<br>- 对于使用卡片 JSON 发送的卡片，默认展示发送卡片时的时间<br>- 对于使用搭建工具搭建的卡片，默认展示卡片发布的时间<br>- `format_type`：定义时间展示的格式。默认使用数字展示，如：`2019-03-15`。枚举值如下所示：<br>- `date_num`：用数字表示的日期，例如 `2019-03-15`。<br>- `date_short`：不含年份的简写日期，支持多语种自动适配，例如 `3月15日`、`Mar 15`。<br>- `date`：完整国际化日期文案，支持多语种自动适配，例如 `2019年3月15日`、`Mar 15, 2019`。<br>- `week`：完整星期文案，支持多语种自动适配，例如 `星期二`、`Tuesday`。<br>- `week_short`：简写星期文案，支持多语种自动适配，例如 `周二`、`Tue`。<br>- `time`：时间（小时:分钟）文案，例如 `13:42`。<br>- `time_sec`：时间（小时:分钟:秒）文案，例如 `13:42:53`。<br>- `timezone`：设备所属时区，格式为 `GMT±hh:mm`，例如 `GMT+8:00`。<br>- `link`：点击该时间时跳转的链接地址。
|
||||
音频 | ```<br><audio file_key='file_v3_xxx' audio_id='1' show_time=true style='normal' background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/' fallback_pc_url='https://open.feishu.cn/' fallback_ios_url='https://open.feishu.cn/' fallback_android_url='https://open.feishu.cn/' fallback_harmony_url='https://open.feishu.cn/' fallback_text='[音频链接]'></audio><br>```<br>参考本文末尾了解音频语法使用示例。 | - style 为 normal 时：<br><br>- style 为 speak 时：<br> | 富文本内嵌音频播放器。该语法中的字段说明如下所示：<br>- `file_key`：音频文件 key，需通过[上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)获取。详情参考[音频](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-components/content-components/audio)组件。必填。<br>- `audio_id`：音频实例唯一标识，使用方式同[音频](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-json-v2-components/content-components/audio)组件。可选。<br>- `show_time`：是否显示时长。可选，默认值为 false。<br>- `style`：音频样式。可选，支持以下值：<br>- `normal`：默认值，三角形播放按钮样式<br>- `speak`：语音样式<br>- `background_color`：组件背景颜色。可选。支持 default、[颜色枚举值](https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/enumerations-for-fields-related-to-color)和 RGBA 语法自定义颜色。<br>- `fill_color`：图标和时间颜色。可选。支持颜色枚举值和 RGBA 语法自定义颜色。 <br>- `fallback_text`：在低于飞书 V7.49.0 版本客户端上，音频播放器将展示为文字链接。你可设置文本和 URL，引导用户点击链接访问音频。该字段指定显示文本。可选。若不指定，则低版本客户端展示时将丢弃该组件。<br>- `fallback_url`：在低于飞书 V7.49.0 版本客户端上，音频播放器将展示为文字链接。你可设置文本和 URL，引导用户点击链接访问音频。该字段指定文字链接的兜底 URL。若指定`fallback_text`，则必须指定 `fallback_url`。<br>- `fallback_pc_url`：为 PC 端低版本客户端上的音频播放器额外指定 URL，可选。优先级高于兜底的 `fallback_url`。<br>- `fallback_ios_url`：为 iOS 端低版本客户端上的音频播放器额外指定 URL，可选。优先级高于兜底的 `fallback_url`。<br>- `fallback_android_url`：为 Android 端低版本客户端上的音频播放器额外指定 URL，可选。优先级高于兜底的 `fallback_url`。<br>- `fallback_harmony_url`：为原生鸿蒙端低版本客户端上的音频播放器额外指定 URL，可选。优先级高于兜底的 `fallback_url`。
|
||||
|
||||
### 特殊字符转义说明
|
||||
如果要展示的字符命中了 markdown 语法使用的特殊字符（例如 `*、~、>、<` 这些特殊符号），需要对特殊字符进行 HTML 转义，才可正常展示。常见的转义符号对照表如下所示。查看更多转义符，参考 [HTML 转义通用标准](https://www.w3school.com.cn/charsets/ref_html_8859.asp)实现，转义后的格式为 `&#实体编号;`。
|
||||
|
||||
| **特殊字符** | **转义符** | **描述** |
|
||||
| --- | --- | --- |
|
||||
| ` ` | ` ` | 不换行空格 |
|
||||
| ` ` | ` ` | 半角空格 |
|
||||
| ` ` | ` ` | 全角空格 |
|
||||
| `>` | `>` | 大于号 |
|
||||
| `<` | `<` | 小于号 |
|
||||
| `~` | `∼` | 飘号 |
|
||||
| `-` | `-` | 连字符 |
|
||||
| `!` | `!` | 惊叹号 |
|
||||
| `*` | `*` | 星号 |
|
||||
| `/` | `/` | 斜杠 |
|
||||
| `\` | `\` | 反斜杠 |
|
||||
| `[` | `[` | 中括号左边部分 |
|
||||
| `]` | `]` | 中括号右边部分 |
|
||||
| `(` | `(` | 小括号左边部分 |
|
||||
| `)` | `)` | 小括号右边部分 |
|
||||
| `#` | `#` | 井号 |
|
||||
| `:` | `:` | 冒号 |
|
||||
| `+` | `+` | 加号 |
|
||||
| `"` | `"` | 英文引号 |
|
||||
| `'` | `'` | 英文单引号 |
|
||||
| \` | ``` | 反单引号 |
|
||||
| `$` | `$` | 美金符号 |
|
||||
| `_` | `_` | 下划线 |
|
||||
| `-` | `-` | 无序列表 |
|
||||
|
||||
### 代码块支持的编程语言
|
||||
|
||||
富文本组件支持通过代码块语法渲染代码，支持的编程语言如下列表所示，且对大小写不敏感：
|
||||
`````markdown
|
||||
```JSON
|
||||
{"This is": "JSON demo"}
|
||||
```
|
||||
`````
|
||||
- plain_text
|
||||
- abap
|
||||
- ada
|
||||
- apache
|
||||
- apex
|
||||
- assembly
|
||||
- bash
|
||||
- c_sharp
|
||||
- cpp
|
||||
- c
|
||||
- cmake
|
||||
- cobol
|
||||
- css
|
||||
- coffee_script
|
||||
- d
|
||||
- dart
|
||||
- delphi
|
||||
- diff
|
||||
- django
|
||||
- docker_file
|
||||
- erlang
|
||||
- fortran
|
||||
- gherkin
|
||||
- go
|
||||
- graphql
|
||||
- groovy
|
||||
- html
|
||||
- htmlbars
|
||||
- http
|
||||
- haskell
|
||||
- json
|
||||
- java
|
||||
- javascript
|
||||
- julia
|
||||
- kotlin
|
||||
- latex
|
||||
- lisp
|
||||
- lua
|
||||
- matlab
|
||||
- makefile
|
||||
- markdown
|
||||
- nginx
|
||||
- objective_c
|
||||
- opengl_shading_language
|
||||
- php
|
||||
- perl
|
||||
- powershell
|
||||
- prolog
|
||||
- properties
|
||||
- protobuf
|
||||
- python
|
||||
- r
|
||||
- ruby
|
||||
- rust
|
||||
- sas
|
||||
- scss
|
||||
- sql
|
||||
- scala
|
||||
- scheme
|
||||
- shell
|
||||
- solidity
|
||||
- swift
|
||||
- toml
|
||||
- thrift
|
||||
- typescript
|
||||
- vbscript
|
||||
- visual_basic
|
||||
- xml
|
||||
- yaml
|
||||
## 为移动端和桌面端定义不同的字号
|
||||
|
||||
在普通文本组件和富文本组件中，你可为同一段文本定义在移动端和桌面端的不同字号。相关字段描述如下表所示。
|
||||
|
||||
字段 | 是否必填 | 类型 | 默认值 | 说明
|
||||
---|---|---|---|---
|
||||
text_size | 否 | Object | / | 文本大小。你可在此自定义移动端和桌面端的不同字号。
|
||||
└ custom_text_size_name | 否 | Object | / | 自定义的字号。你需自定义该字段的名称，如 `cus-0`、`cus-1` 等。
|
||||
└└ default | 否 | String | / | 在无法差异化配置字号的旧版飞书客户端上，生效的字号属性。建议填写此字段。可取值如下所示。<br>- heading-0：特大标题（30px）<br>- heading-1：一级标题（24px）<br>- heading-2：二级标题（20 px）<br>- heading-3：三级标题（18px）<br>- heading-4：四级标题（16px）<br>- heading：标题（16px）<br>- normal：正文（14px）<br>- notation：辅助信息（12px）<br>- xxxx-large：30px<br>- xxx-large：24px<br>- xx-large：20px<br>- x-large：18px<br>- large：16px<br>- medium：14px<br>- small：12px<br>- x-small：10px
|
||||
└└ pc | 否 | String | / | 桌面端的字号。可取值如下所示。<br>- heading-0：特大标题（30px）<br>- heading-1：一级标题（24px）<br>- heading-2：二级标题（20 px）<br>- heading-3：三级标题（18px）<br>- heading-4：四级标题（16px）<br>- heading：标题（16px）<br>- normal：正文（14px）<br>- notation：辅助信息（12px）<br>- xxxx-large：30px<br>- xxx-large：24px<br>- xx-large：20px<br>- x-large：18px<br>- large：16px<br>- medium：14px<br>- small：12px<br>- x-small：10px
|
||||
└└ mobile | 否 | String | / | 移动端的文本字号。可取值如下所示。<br>**注意**：部分移动端的字号枚举值的具体大小与 PC 端有差异，使用时请注意区分。<br>- heading-0：特大标题（26px）<br>- heading-1：一级标题（24px）<br>- heading-2：二级标题（20 px）<br>- heading-3：三级标题（17px）<br>- heading-4：四级标题（16px）<br>- heading：标题（16px）<br>- normal：正文（14px）<br>- notation：辅助信息（12px）<br>- xxxx-large：26px<br>- xxx-large：24px<br>- xx-large：20px<br>- x-large：18px<br>- large：17px<br>- medium：14px<br>- small：12px<br>- x-small：10px
|
||||
|
||||
具体步骤如下所示。
|
||||
1. 在卡片 JSON 代码的全局行为设置中的 `config` 字段中，配置 `style` 字段，并添加自定义字号：
|
||||
```json
|
||||
{
|
||||
"config": {
|
||||
"style": { // 在此添加并配置 style 字段。
|
||||
"text_size": { // 分别为移动端和桌面端添加自定义字号，同时添加兜底字号。用于在组件 JSON 中设置字号属性。支持添加多个自定义字号对象。
|
||||
"cus-0": {
|
||||
"default": "medium", // 在无法差异化配置字号的旧版飞书客户端上，生效的字号属性。选填。
|
||||
"pc": "medium", // 桌面端的字号。
|
||||
"mobile": "large" // 移动端的字号。
|
||||
},
|
||||
"cus-1": {
|
||||
"default": "medium", // 在无法差异化配置字号的旧版飞书客户端上，生效的字号属性。选填。
|
||||
"pc": "normal", // 桌面端的字号。
|
||||
"mobile": "x-large" // 移动的字号。
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
1. 在普通文本组件或富文本组件的 `text_size` 属性中，应用自定义字号。以下为在富文本组件中应用自定义字号的示例：
|
||||
```json
|
||||
{
|
||||
"elements": [
|
||||
{
|
||||
"tag": "markdown",
|
||||
"text_size": "cus-0", // 在此处应用自定义字号。
|
||||
"href": {
|
||||
"urlVal": {
|
||||
"url": "xxx1",
|
||||
"pc_url": "xxx2",
|
||||
"ios_url": "xxx3",
|
||||
"android_url": "xxx4"
|
||||
}
|
||||
},
|
||||
"content": "普通文本\n标准emoji😁😢🌞💼🏆❌✅\n*斜体*\n**粗体**\n~~删除线~~\n文字链接\n差异化跳转\n<at id=all></at>"
|
||||
},
|
||||
{
|
||||
"tag": "hr"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "上面是一行分割线\n!hover_text\n上面是一个图片标签"
|
||||
}
|
||||
],
|
||||
"header": {
|
||||
"template": "blue",
|
||||
"title": {
|
||||
"content": "这是卡片标题栏",
|
||||
"tag": "plain_text"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 富文本语法使用示例
|
||||
|
||||
### 音频
|
||||
|
||||
以下富文本语法示例代码可实现如下图所示的卡片效果。请将 `file_key` 替换为实际值后再查看效果。获取音频文件 `file_key` 时，请确保调用[上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/create)接口的应用与发送卡片的应用一致。
|
||||
|
||||
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "2.0",
|
||||
"config": {
|
||||
"wide_screen_mode": true,
|
||||
"enable_forward": false,
|
||||
"update_multi": true,
|
||||
"enable_forward_interaction": true,
|
||||
"style": {
|
||||
"color": {
|
||||
"color_0": {
|
||||
"light_mode": "rgba(20,86,240,1.000000)",
|
||||
"dark_mode": "rgba(20,86,240,1.000000)"
|
||||
},
|
||||
"color_1": {
|
||||
"light_mode": "rgba(149,229,153,1.000000)",
|
||||
"dark_mode": "rgba(149,229,153,1.000000)"
|
||||
},
|
||||
"color_2": {
|
||||
"light_mode": "rgba(253,198,196,1.000000)",
|
||||
"dark_mode": "rgba(253,198,196,1.000000)"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"body": {
|
||||
"direction": "vertical",
|
||||
"padding": "12px 12px 12px 12px",
|
||||
"elements": [
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "参数全默认效果示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='1' >",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "显示时间示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='111' show_time=true >",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "自定义颜色 background_color='rgba(20,86,240,1.000000)' fill_color='rgba(253,198,196,1.000000)' 示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='2' show_time=true background_color='color_0' fill_color='color_2'>",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "使用颜色枚举值 background_color='grey-200' fill_color='blue-800' 示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='3' show_time=true background_color='grey-200' fill_color='blue-800'>",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "播放器按钮语音样式（style=speak）示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='5' show_time=true style='speak' >",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "低于飞书 V7.49 版本，设置兜底文本与链接示例：\n<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='6' show_time=true fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "#### 不同字体下，音频播放器大小示例：",
|
||||
"text_align": "left"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "heading-0<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='7' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "heading-0"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "heading-1<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='8' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "heading-1"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "heading-2<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='9' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "heading-2"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "heading-3<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='10' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "heading-3"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "heading<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='11' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "heading"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "normal<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='12' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "normal"
|
||||
},
|
||||
{
|
||||
"tag": "markdown",
|
||||
"content": "notation<audio file_key='file_v3_00or_f2c1276b-9f24-463d-8911-xxxxxxxx' audio_id='13' show_time=true background_color='grey-200' fill_color='blue-800' fallback_url='https://open.feishu.cn/'> fallback_text='[音频链接]'",
|
||||
"text_align": "left",
|
||||
"text_size": "notation"
|
||||
}
|
||||
]
|
||||
},
|
||||
"header": {
|
||||
"title": {
|
||||
"tag": "plain_text",
|
||||
"content": "Markdown 音频播放器示例"
|
||||
},
|
||||
"template": "blue",
|
||||
"padding": "12px 12px 12px 12px"
|
||||
}
|
||||
}
|
||||
```
|
||||
@ -1,97 +1,88 @@
|
||||
"""Host client configuration loader.
|
||||
|
||||
Loads host_config.yaml which contains:
|
||||
- NODE_ID, DISPLAY_NAME
|
||||
- ROUTER_URL, ROUTER_SECRET
|
||||
- LLM config (OPENAI_*)
|
||||
- WORKING_DIR, METASO_API_KEY
|
||||
- SERVES_USERS list
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import os
|
||||
from pathlib import Path
|
||||
from typing import List, Optional
|
||||
|
||||
import yaml
|
||||
|
||||
|
||||
class HostConfig:
|
||||
"""Configuration for a host client node."""
|
||||
|
||||
def __init__(self, config_path: Optional[Path] = None):
|
||||
config_path = config_path or Path(__file__).parent.parent / "host_config.yaml"
|
||||
self._load(config_path)
|
||||
|
||||
def _load(self, config_path: Path) -> None:
|
||||
if not config_path.exists():
|
||||
raise FileNotFoundError(f"Config file not found: {config_path}")
|
||||
|
||||
with open(config_path, "r", encoding="utf-8") as f:
|
||||
data = yaml.safe_load(f) or {}
|
||||
|
||||
self.node_id: str = data.get("NODE_ID", "unknown-node")
|
||||
self.display_name: str = data.get("DISPLAY_NAME", self.node_id)
|
||||
self.router_url: str = data.get("ROUTER_URL", "ws://127.0.0.1:8000/ws/node")
|
||||
self.router_secret: str = data.get("ROUTER_SECRET", "")
|
||||
|
||||
self.openai_base_url: str = data.get(
|
||||
"OPENAI_BASE_URL", "https://open.bigmodel.cn/api/paas/v4/"
|
||||
)
|
||||
self.openai_api_key: str = data.get("OPENAI_API_KEY", "")
|
||||
self.openai_model: str = data.get("OPENAI_MODEL", "glm-4.7")
|
||||
|
||||
self.working_dir: str = data.get("WORKING_DIR", str(Path.home() / "projects"))
|
||||
self.metaso_api_key: Optional[str] = data.get("METASO_API_KEY")
|
||||
|
||||
serves_users = data.get("SERVES_USERS", [])
|
||||
self.serves_users: list[str] = serves_users if isinstance(serves_users, list) else []
|
||||
|
||||
self.capabilities: list[str] = data.get(
|
||||
"CAPABILITIES",
|
||||
["claude_code", "shell", "file_ops", "web", "scheduler"],
|
||||
)
|
||||
|
||||
@classmethod
|
||||
def from_keyring(cls, keyring_path: Optional[Path] = None) -> "HostConfig":
|
||||
"""Create config from keyring.yaml (for standalone mode)."""
|
||||
keyring_path = keyring_path or Path(__file__).parent.parent / "keyring.yaml"
|
||||
if not keyring_path.exists():
|
||||
raise FileNotFoundError(f"keyring.yaml not found: {keyring_path}")
|
||||
|
||||
with open(keyring_path, "r", encoding="utf-8") as f:
|
||||
data = yaml.safe_load(f) or {}
|
||||
|
||||
config = cls.__new__(cls)
|
||||
config.node_id = data.get("NODE_ID", "local-node")
|
||||
config.display_name = data.get("DISPLAY_NAME", "Local Machine")
|
||||
config.router_url = data.get("ROUTER_URL", "ws://127.0.0.1:8000/ws/node")
|
||||
config.router_secret = data.get("ROUTER_SECRET", "")
|
||||
|
||||
config.openai_base_url = data.get(
|
||||
"OPENAI_BASE_URL", "https://open.bigmodel.cn/api/paas/v4/"
|
||||
)
|
||||
config.openai_api_key = data.get("OPENAI_API_KEY", "")
|
||||
config.openai_model = data.get("OPENAI_MODEL", "glm-4.7")
|
||||
|
||||
config.working_dir = data.get("WORKING_DIR", str(Path.home() / "projects"))
|
||||
config.metaso_api_key = data.get("METASO_API_KEY")
|
||||
|
||||
serves_users = data.get("ALLOWED_OPEN_IDS", [])
|
||||
config.serves_users = serves_users if isinstance(serves_users, list) else []
|
||||
|
||||
config.capabilities = ["claude_code", "shell", "file_ops", "web", "scheduler"]
|
||||
|
||||
return config
|
||||
|
||||
|
||||
host_config: Optional[HostConfig] = None
|
||||
|
||||
|
||||
def get_host_config() -> HostConfig:
|
||||
"""Get the global host config instance."""
|
||||
global host_config
|
||||
if host_config is None:
|
||||
host_config = HostConfig()
|
||||
return host_config
|
||||
"""Host client configuration loader.
|
||||
|
||||
Loads host_config.yaml (multi-host mode) or keyring.yaml (standalone mode).
|
||||
|
||||
Fields:
|
||||
- NODE_ID, DISPLAY_NAME
|
||||
- ROUTER_URL, ROUTER_SECRET
|
||||
- OPENAI_BASE_URL, OPENAI_API_KEY, OPENAI_MODEL
|
||||
- WORKING_DIR, METASO_API_KEY
|
||||
- SERVES_USERS / ALLOWED_OPEN_IDS, CAPABILITIES
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pathlib import Path
|
||||
from typing import Optional
|
||||
|
||||
import yaml
|
||||
|
||||
|
||||
def _load_yaml(path: Path) -> dict:
|
||||
if not path.exists():
|
||||
raise FileNotFoundError(f"Config file not found: {path}")
|
||||
with open(path, "r", encoding="utf-8") as f:
|
||||
return yaml.safe_load(f) or {}
|
||||
|
||||
|
||||
class HostConfig:
|
||||
"""Configuration for a host client node."""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
data: dict,
|
||||
*,
|
||||
serves_users_key: str = "SERVES_USERS",
|
||||
default_node_id: str = "unknown-node",
|
||||
default_display_name: str = "",
|
||||
):
|
||||
self.node_id: str = data.get("NODE_ID", default_node_id)
|
||||
self.display_name: str = data.get("DISPLAY_NAME", default_display_name or self.node_id)
|
||||
self.router_url: str = data.get("ROUTER_URL", "ws://127.0.0.1:8000/ws/node")
|
||||
self.router_secret: str = data.get("ROUTER_SECRET", "")
|
||||
|
||||
self.openai_base_url: str = data.get(
|
||||
"OPENAI_BASE_URL", "https://open.bigmodel.cn/api/paas/v4/"
|
||||
)
|
||||
self.openai_api_key: str = data.get("OPENAI_API_KEY", "")
|
||||
self.openai_model: str = data.get("OPENAI_MODEL", "glm-4.7")
|
||||
|
||||
self.working_dir: str = data.get("WORKING_DIR", str(Path.home() / "projects"))
|
||||
self.metaso_api_key: Optional[str] = data.get("METASO_API_KEY")
|
||||
|
||||
serves_users = data.get(serves_users_key, [])
|
||||
self.serves_users: list[str] = serves_users if isinstance(serves_users, list) else []
|
||||
|
||||
capabilities = data.get("CAPABILITIES", ["claude_code", "shell", "file_ops", "web", "scheduler"])
|
||||
self.capabilities: list[str] = capabilities if isinstance(capabilities, list) else []
|
||||
|
||||
if not self.openai_api_key:
|
||||
raise ValueError("OPENAI_API_KEY is required in config but was not set")
|
||||
|
||||
@classmethod
|
||||
def from_file(cls, config_path: Optional[Path] = None) -> "HostConfig":
|
||||
"""Load from host_config.yaml (multi-host mode)."""
|
||||
path = config_path or Path(__file__).parent.parent / "host_config.yaml"
|
||||
return cls(_load_yaml(path), serves_users_key="SERVES_USERS", default_node_id="unknown-node")
|
||||
|
||||
@classmethod
|
||||
def from_keyring(cls, keyring_path: Optional[Path] = None) -> "HostConfig":
|
||||
"""Load from keyring.yaml (standalone mode)."""
|
||||
path = keyring_path or Path(__file__).parent.parent / "keyring.yaml"
|
||||
return cls(
|
||||
_load_yaml(path),
|
||||
serves_users_key="ALLOWED_OPEN_IDS",
|
||||
default_node_id="local-node",
|
||||
default_display_name="Local Machine",
|
||||
)
|
||||
|
||||
|
||||
_host_config: Optional[HostConfig] = None
|
||||
|
||||
|
||||
def get_host_config() -> HostConfig:
|
||||
"""Get the global host config instance (multi-host mode)."""
|
||||
global _host_config
|
||||
if _host_config is None:
|
||||
_host_config = HostConfig.from_file()
|
||||
return _host_config
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user