Metadata-Version: 2.5
Name: licos-platform-cli
Version: 0.6.0
Summary: LICOS platform CLI
Requires-Python: >=3.10
Requires-Dist: licos-platform-sdk>=0.7.0
Description-Content-Type: text/markdown

# licos-platform-cli

LICOS 平台命令行工具。`licos-platform help` 返回结构化 JSON 帮助。

## 当前使用者（0.5.1 起）

```bash
licos-platform user me
licos-platform user me --workspace-id <执行工作空间ID>
licos-platform help user me
```

用户接口默认使用 `LICOS_CURRENT_USER_ID` 指定的容器执行用户换取 Token。它不代表网页登录者。平台地址、服务凭证和项目工作空间沿用运行时配置。
多用户请求可将当前使用者 Token 通过标准输入传入，不将 Token 放在命令行参数中：

```bash
licos-platform user me --token-stdin
```

输入不含 `Bearer ` 前缀的 Token 并结束标准输入。程序调用时可通过子进程的 `input` 参数传入。

输出为与低代码 `sys_user` 相同的 JSON：用户 ID、账号、姓名、头像、执行企业、
主部门、全部所属部门、组织任职、主岗位和主职务。部门含名称路径、ID 路径；
无部门/任职时保持 `[]`/`null`。缺少当前使用者身份或 Token 失效时返回非零退出码，
不改用项目所有者。Token 和内部服务凭证不回显。


## 身份选择（0.6.0 起）

`user me`、`knowledge enterprise …`、`ontology …` 均支持 `--token-stdin`。HTTP 服务调用这些命令时必须从标准输入传本次网页登录 Token；独立 CLI 不传此选项时按 `LICOS_CURRENT_USER_ID` 换 Token，缺少该变量则报错。

普通 `knowledge …` 命令默认使用项目身份，`--token-stdin` 可显式按调用用户授权。数据库、存储和 OAuth 应用管理仍使用项目身份。空 Token、失效 Token 不切换身份。完整接口分类见仓库 `tools/IDENTITY.md`。
