licos-platform-cli 0.6.0__tar.gz → 0.6.2__tar.gz

licos_platform_cli-0.6.2/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.5
+Name: licos-platform-cli
+Version: 0.6.2
+Summary: LICOS platform CLI
+Requires-Python: >=3.10
+Requires-Dist: licos-platform-sdk>=0.7.2
+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 起）
+
+`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 服务中：
+
+```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 提示词。

licos_platform_cli-0.6.2/README.md

@@ -0,0 +1,67 @@
+# 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 起）
+
+`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 服务中：
+
+```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 提示词。

{licos_platform_cli-0.6.0 → licos_platform_cli-0.6.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-platform-cli"
-version = "0.6.0"
+version = "0.6.2"
 description = "LICOS platform CLI"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.7.0",
+    "licos-platform-sdk>=0.7.2",
 ]
 
 [project.scripts]

licos_platform_cli-0.6.0/PKG-INFO

@@ -1,40 +0,0 @@
-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`。

licos_platform_cli-0.6.0/README.md

@@ -1,32 +0,0 @@
-# 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`。