mirror of https://github.com/hansjone/oclaw.git synced 2026-10-17 02:03:25 +08:00

oliver 3595f49c86 Ship uds-skill-auth as a distributable skill for field UDS credential helpers.

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>

2026-09-08 23:35:28 +08:00

1.9 KiB

Raw Blame History

name	description
uds-skill-auth	UDS 技能认证公共库。其它依赖 UDS 登录的 skill 必须安装本 skill，通过其 scripts/uds_skill_auth.py 取凭证或出站调用。需现场已安装 uds-auth 插件且用户已扫码登录。

uds-skill-auth（认证公共 Skill）

本 skill 不是业务能力，而是给其它 skill 用的公共库。

现场依赖

1. 安装并启用 uds-auth 插件
2. 安装本 skill（uds-skill-auth）到 skills 目录
3. 用户扫码登录
4. 再安装/使用业务 skill（如通讯录、发信等）

给其它 Skill 用

业务 skill 的 Python 脚本里，把本 skill 的 scripts/ 加入 sys.path 后：

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 同级安装时）：

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。

1.9 KiB Raw Blame History Unescape Escape