mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-18 09:53:20 +08:00
oliver
3595f49c86
Business skills depend on this sibling skill instead of the plugin source tree; update the auth standard docs accordingly. Co-authored-by: Cursor <cursoragent@cursor.com>
60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
---
|
||
name: uds-skill-auth
|
||
description: UDS 技能认证公共库。其它依赖 UDS 登录的 skill 必须安装本 skill，通过其 scripts/uds_skill_auth.py 取凭证或出站调用。需现场已安装 uds-auth 插件且用户已扫码登录。
|
||
---
|
||
|
||
# uds-skill-auth（认证公共 Skill）
|
||
|
||
本 skill **不是业务能力**，而是给其它 skill 用的公共库。
|
||
|
||
## 现场依赖
|
||
|
||
```text
|
||
1. 安装并启用 uds-auth 插件
|
||
2. 安装本 skill（uds-skill-auth）到 skills 目录
|
||
3. 用户扫码登录
|
||
4. 再安装/使用业务 skill（如通讯录、发信等）
|
||
```
|
||
|
||
## 给其它 Skill 用
|
||
|
||
业务 skill 的 Python 脚本里，把本 skill 的 `scripts/` 加入 `sys.path` 后：
|
||
|
||
```python
|
||
from uds_skill_auth import resolve, request, UdsAuthError
|
||
|
||
# Mode Creds：拿到 empNo + token（可写进程内 EMP_NO/AUTH_VALUE）
|
||
creds = resolve()
|
||
|
||
# Mode Outbound（推荐）：Host 代贴鉴权头
|
||
out = request("POST", "https://icenterapi.zte.com.cn/...", headers={...}, body={...})
|
||
```
|
||
|
||
定位本 skill 目录的推荐写法（与业务 skill 同级安装时）：
|
||
|
||
```python
|
||
from pathlib import Path
|
||
import sys
|
||
|
||
def load_uds_skill_auth():
|
||
here = Path(__file__).resolve().parent
|
||
# .../skills/<业务skill>/scripts → .../skills/uds-skill-auth/scripts
|
||
for skills_root in [here.parents[1], *here.parents]:
|
||
candidate = skills_root / "uds-skill-auth" / "scripts"
|
||
if (candidate / "uds_skill_auth.py").is_file():
|
||
sys.path.insert(0, str(candidate))
|
||
import uds_skill_auth
|
||
return uds_skill_auth
|
||
raise RuntimeError("未找到 uds-skill-auth，请先安装该 skill")
|
||
```
|
||
|
||
也可设置环境变量 `UDS_AUTH_HELPERS` 指向本 skill 的 `scripts` 绝对路径。
|
||
|
||
## 环境变量（Agent 已注入，勿教模型打印密钥）
|
||
|
||
- `DSH_SESSION_ID` — 当前会话
|
||
- `DSH_WEB_URL` — Harness Web 地址（用于拼 `/uds-auth`）
|
||
|
||
## 标准文档
|
||
|
||
完整契约见插件仓库：`uds-auth/docs/skill-auth-standard.zh.md`。
|