licos-platform-cli

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

当前使用者（0.5.1 起）

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

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

licos-platform user me --token-stdin

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

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

身份选择（0.6.0 起）

LICOS_CURRENT_USER_ID 表示容器启动时配置的执行用户，项目身份指运行时配置的项目所有者身份。不同命令的默认身份如下：

命令	默认身份	网页登录用户执行
`user me`	按 `LICOS_CURRENT_USER_ID` 换 Token	使用 `--token-stdin`
`knowledge enterprise …`	按 `LICOS_CURRENT_USER_ID` 换 Token	使用 `--token-stdin`，企业范围和权限由平台认证结果确定
`ontology search`、`ontology invoke`	按 `LICOS_CURRENT_USER_ID` 换 Token	使用 `--token-stdin`
普通 `knowledge …`	项目身份	需要用户权限时使用 `--token-stdin`
数据库、对象存储、OAuth 应用管理	项目身份	保持项目身份

用户操作未传 --token-stdin 时，用 LICOS_CURRENT_USER_ID 和运行时服务凭证换 Token；缺少执行用户配置则报错。--token-stdin 优先使用标准输入的 Token，空输入直接报错，不再换取其他身份。

HTTP 服务调用用户接口时，必须从本次认证会话取得 Token，并写入该子进程的标准输入；缺少 Token 时在业务入口返回登录错误。不能依赖容器默认用户，也不能把请求 Token 或用户 ID 写入共享环境变量。例如在 Python 服务中：

import subprocess

# token 来自本次请求的认证会话，不含 "Bearer " 前缀。
result = subprocess.run(
    ["licos-platform", "user", "me", "--token-stdin"],
    input=token,
    text=True,
    capture_output=True,
    check=True,
)

显式传入的 Token 鉴权失败时返回非零退出码，由调用方更新登录凭证，不切换到容器用户或项目所有者。项目所有者和工作空间等资源归属字段单独保留，不用它们冒充调用用户。

编程项目登录身份

有内置登录时使用内置登录会话；没有内置登录时使用当前 LICOS 网页登录。内置登录未登录或过期时不能切换成平台用户。
Node 服务端使用 createProjectAuth({ mode: 'builtin', resolveBuiltinToken }) 或 createProjectAuth({ mode: 'platform' })，每次请求调用 await projectAuth.userToken(request)。内置解析器必须读取已有认证会话并返回用户已授权的 LICOS 凭证。
无内置登录的浏览器用户接口使用 @kmlckj/licos-platform-sdk/browser 的 createProjectUserFetch：平台登录桥领取一次性票据，项目后端兑换 Token。不要直接读取跨域平台 localStorage，不在 URL 中传 Token，不修改全局 fetch。项目级 API 保持原有请求方法。
Python 使用 ProjectAuth；Agent/Workflow 通过 config/licos-auth.json 配置模式，内置登录设置 resolver: "模块:函数"，业务代码使用 ctx.identity.user_token。
当前用户、企业知识库、本体用户操作显式传 userToken/user_token。模型、积分和普通知识库按业务选择用户或项目身份。数据库、对象存储和可观测性继续使用项目身份。
OAuth 接入 SDK 的用户、知识库、模型能力分别申请 project.user、project.knowledge、project.models；新增范围需要用户重新授权。业务自签 JWT 不能直接充当 LICOS Token。
修改已有项目时先接它的现有登录机制，不能用新模板的默认平台模式覆盖。真实 Token 只存在于运行时请求/会话，不写入源代码、共享环境变量或 Agent 提示词。

Metadata

Release files for licos-platform-cli 0.6.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for licos-platform-cli 0.6.2
File	Size	Uploaded
licos_platform_cli-0.6.2.tar.gz	39.4 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for licos-platform-cli 0.6.2
File	Interpreter	ABI	Platform	Reset
licos_platform_cli-0.6.2-py3-none-any.whl 37.9 kB Oct 9, 2026	Python 3	none	any	Details

Total release size: 77.3 kB

Release files / licos_platform_cli-0.6.2.tar.gz

Download URL	licos_platform_cli-0.6.2.tar.gz
Size	39.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`dc506a446ab80b130b86b1bab4cae6d6794b4487c41bb5e9b40a4107c1e9fb2f`
BLAKE2b-256 checksum How to use checksums	`a0c70bc4c154696c4c5e7b1c7c42a116faf41bbca5970791c3907fa6bf3c03eb`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / licos_platform_cli-0.6.2-py3-none-any.whl

Download URL	licos_platform_cli-0.6.2-py3-none-any.whl
Size	37.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`54967e8b2ae84b92eab3327f494ed711f70f5d2b96c1b2e33b80918fa20dbcc5`
BLAKE2b-256 checksum How to use checksums	`84d4e47f3ff35d4fb253845eb755dfabf038d17b00565727b9d43495770a9b36`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`