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

licos_dev_cli-0.6.2/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: licos-dev-cli
+Version: 0.6.2
+Summary: LICOS Dev CLI - generate files and call model capabilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: licos-dev-sdk>=0.6.2
+Description-Content-Type: text/markdown
+
+# licos-dev CLI
+
+## 身份选择（0.6.0 起）
+
+`LICOS_CURRENT_USER_ID` 表示容器启动时配置的执行用户，不代表网页登录者。模型目录、LLM、视觉、图片生成、视频生成、语音识别和 `credit-check` 命令支持以下身份选项：
+
+| 选项 | 调用身份 |
+| --- | --- |
+| `--identity user`（默认） | 用 `LICOS_CURRENT_USER_ID` 和运行时服务凭证换取执行用户 Token |
+| `--identity project` | 使用运行时配置的项目所有者身份，不要求 `LICOS_CURRENT_USER_ID` |
+| `--token-stdin` | 优先使用标准输入传入的本次用户 Token，不再按容器用户换 Token；不能与 `--identity project` 同时使用 |
+
+用户标识、名称和企业信息来自平台认证结果。项目所有者、工作空间等资源归属字段单独保留；模型实际计费上下文以平台模型详情接口签发的签名为准。
+
+```bash
+licos-dev credit-check --identity project
+licos-dev model-catalog --identity user
+```
+
+HTTP 服务代表网页登录用户调用这些命令时，必须从本次认证会话取得 Token，通过 `--token-stdin` 写入子进程标准输入，不含 `Bearer ` 前缀。例如在 Python 服务中：
+
+```python
+import subprocess
+
+# token 来自本次请求的认证会话。
+result = subprocess.run(
+    ["licos-dev", "credit-check", "--token-stdin"],
+    input=token,
+    text=True,
+    capture_output=True,
+    check=True,
+)
+```
+
+以网页登录用户执行的业务入口缺少 Token 时应返回登录错误；不能依赖容器默认用户，也不能把请求 Token 或用户 ID 写入共享环境变量。默认用户模式缺少 `LICOS_CURRENT_USER_ID`、标准输入为空或显式 Token 鉴权失败时均返回非零退出码，不切换身份。Token 失效由调用方更新登录凭证后重新调用。
+
+文档、图片排版等本地文件工具不需要用户身份选项。
+
+直接使用 `licos-dev-sdk` 时，模型和积分接口默认是项目身份；需要按用户执行时传 `user_token`。CLI 的默认 `--identity user` 仅适用于独立命令行调用。
+
+## 编程项目登录身份
+
+- 有内置登录时使用内置登录会话；没有内置登录时使用当前 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_dev_cli-0.6.2/README.md

@@ -0,0 +1,49 @@
+# licos-dev CLI
+
+## 身份选择（0.6.0 起）
+
+`LICOS_CURRENT_USER_ID` 表示容器启动时配置的执行用户，不代表网页登录者。模型目录、LLM、视觉、图片生成、视频生成、语音识别和 `credit-check` 命令支持以下身份选项：
+
+| 选项 | 调用身份 |
+| --- | --- |
+| `--identity user`（默认） | 用 `LICOS_CURRENT_USER_ID` 和运行时服务凭证换取执行用户 Token |
+| `--identity project` | 使用运行时配置的项目所有者身份，不要求 `LICOS_CURRENT_USER_ID` |
+| `--token-stdin` | 优先使用标准输入传入的本次用户 Token，不再按容器用户换 Token；不能与 `--identity project` 同时使用 |
+
+用户标识、名称和企业信息来自平台认证结果。项目所有者、工作空间等资源归属字段单独保留；模型实际计费上下文以平台模型详情接口签发的签名为准。
+
+```bash
+licos-dev credit-check --identity project
+licos-dev model-catalog --identity user
+```
+
+HTTP 服务代表网页登录用户调用这些命令时，必须从本次认证会话取得 Token，通过 `--token-stdin` 写入子进程标准输入，不含 `Bearer ` 前缀。例如在 Python 服务中：
+
+```python
+import subprocess
+
+# token 来自本次请求的认证会话。
+result = subprocess.run(
+    ["licos-dev", "credit-check", "--token-stdin"],
+    input=token,
+    text=True,
+    capture_output=True,
+    check=True,
+)
+```
+
+以网页登录用户执行的业务入口缺少 Token 时应返回登录错误；不能依赖容器默认用户，也不能把请求 Token 或用户 ID 写入共享环境变量。默认用户模式缺少 `LICOS_CURRENT_USER_ID`、标准输入为空或显式 Token 鉴权失败时均返回非零退出码，不切换身份。Token 失效由调用方更新登录凭证后重新调用。
+
+文档、图片排版等本地文件工具不需要用户身份选项。
+
+直接使用 `licos-dev-sdk` 时，模型和积分接口默认是项目身份；需要按用户执行时传 `user_token`。CLI 的默认 `--identity user` 仅适用于独立命令行调用。
+
+## 编程项目登录身份
+
+- 有内置登录时使用内置登录会话；没有内置登录时使用当前 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_dev_cli-0.6.0 → licos_dev_cli-0.6.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-cli"
-version = "0.6.0"
+version = "0.6.2"
 description = "LICOS Dev CLI - generate files and call model capabilities"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-dev-sdk>=0.6.0",
+    "licos-dev-sdk>=0.6.2",
     "click>=8.1",
 ]
 

licos_dev_cli-0.6.0/PKG-INFO

@@ -1,25 +0,0 @@
-Metadata-Version: 2.4
-Name: licos-dev-cli
-Version: 0.6.0
-Summary: LICOS Dev CLI - generate files and call model capabilities
-Requires-Python: >=3.10
-Requires-Dist: click>=8.1
-Requires-Dist: licos-dev-sdk>=0.6.0
-Description-Content-Type: text/markdown
-
-# licos-dev CLI
-
-模型目录、模型调用和 `credit-check` 支持：
-
-- `--identity user`（默认）：用 `LICOS_CURRENT_USER_ID` 指定的容器执行用户换取 Token。
-- `--identity project`：使用项目身份。
-- `--token-stdin`：从标准输入读取本次请求的用户 Token，不含 `Bearer ` 前缀。不能与 `--identity project` 同时使用。
-
-`LICOS_CURRENT_USER_ID` 不是网页登录者。HTTP 服务调用 CLI 时，必须为用户操作使用 `--token-stdin`。缺少用户 ID、空 Token 或鉴权失败均报错，不切换到其他身份。
-
-```bash
-licos-dev credit-check --identity project
-licos-dev model-catalog --identity user
-```
-
-文档、图片排版等本地文件工具不需要用户身份选项。完整约定见仓库的 `tools/IDENTITY.md`。

licos_dev_cli-0.6.0/README.md

@@ -1,16 +0,0 @@
-# licos-dev CLI
-
-模型目录、模型调用和 `credit-check` 支持：
-
-- `--identity user`（默认）：用 `LICOS_CURRENT_USER_ID` 指定的容器执行用户换取 Token。
-- `--identity project`：使用项目身份。
-- `--token-stdin`：从标准输入读取本次请求的用户 Token，不含 `Bearer ` 前缀。不能与 `--identity project` 同时使用。
-
-`LICOS_CURRENT_USER_ID` 不是网页登录者。HTTP 服务调用 CLI 时，必须为用户操作使用 `--token-stdin`。缺少用户 ID、空 Token 或鉴权失败均报错，不切换到其他身份。
-
-```bash
-licos-dev credit-check --identity project
-licos-dev model-catalog --identity user
-```
-
-文档、图片排版等本地文件工具不需要用户身份选项。完整约定见仓库的 `tools/IDENTITY.md`。