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

licos_dev_sdk-0.6.2/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: licos-dev-sdk
+Version: 0.6.2
+Summary: LICOS Dev SDK - file generation and model capability clients
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: docxtpl>=0.16
+Requires-Dist: graphviz>=0.20
+Requires-Dist: jinja2>=3.1
+Requires-Dist: licos-platform-sdk>=0.7.2
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: mistune>=3.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pillow>=10.0
+Requires-Dist: pypdf>=5.0
+Requires-Dist: python-barcode>=0.15
+Requires-Dist: python-docx>=1.1
+Requires-Dist: python-pptx>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: qrcode[pil]>=8.0
+Requires-Dist: skia-pathops>=0.9.2
+Requires-Dist: uharfbuzz>=0.50.0
+Requires-Dist: weasyprint>=62.0
+Requires-Dist: xlsxwriter>=3.2
+Provides-Extra: ppt-master
+Requires-Dist: licos-ppt-master-assets==0.0.1; extra == 'ppt-master'
+Description-Content-Type: text/markdown
+
+# licos-dev-sdk
+
+服务端模型和文件工具 SDK。
+
+## 身份选择（0.6.0 起）
+
+`LICOS_CURRENT_USER_ID` 表示容器启动时配置的执行用户。SDK 不用它推断当前网页登录者，也不读取进程级 `LICOS_USER_TOKEN` 作为模型请求凭证。项目身份指运行时配置的项目所有者身份，按接口选择：
+
+| 接口 | 默认身份 | 以网页登录用户执行 |
+| --- | --- | --- |
+| 模型目录、模型详情、端点解析 | 项目身份 | 显式传 `user_token` |
+| LLM、视觉、图片生成、视频生成、语音识别客户端 | 项目身份 | 每次用户请求创建客户端并传 `user_token` |
+| `check_credit_availability` | 项目身份 | 显式传 `user_token` |
+| 可观测性 | 项目身份 | 保持项目身份 |
+| 文档、表格、图片排版等本地文件工具 | 无需用户 Token | 无需用户 Token |
+
+需要以网页登录用户执行时，从本次认证会话取得不含 `Bearer ` 前缀的 Token，并让积分检查和模型调用使用同一用户身份：
+
+```python
+from licos_dev_sdk import LLMClient, check_credit_availability
+
+# token 来自本次请求的认证会话。
+availability = check_credit_availability(user_token=token, resource_code='LLM_INVOKE')
+result = LLMClient(user_token=token).invoke('你好')
+```
+
+用户标识、名称和企业信息来自平台认证结果。项目所有者、工作空间等资源归属字段单独保留；模型实际计费上下文以平台模型详情接口签发的签名为准。
+
+以网页登录用户执行的业务入口缺少 Token 时应返回登录错误，不能省略参数后使用项目身份。不要把请求 Token 或用户 ID 写入 `os.environ`，不要跨用户共享带身份的客户端。显式传入的 Token 为空或失效时直接报错，由调用方更新登录凭证后创建新客户端，不换取容器用户或项目所有者的 Token。
+
+独立 `licos-dev` CLI 的模型和积分命令默认使用 `LICOS_CURRENT_USER_ID`，可用 `--identity project` 选择项目身份；HTTP 服务通过 CLI 代表登录用户执行时使用 `--token-stdin`。SDK 默认身份与 CLI 默认身份不同，调用时按上述接口规则显式选择。
+
+## 编程项目登录身份
+
+- 有内置登录时使用内置登录会话；没有内置登录时使用当前 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_sdk-0.6.2/README.md

@@ -0,0 +1,41 @@
+# licos-dev-sdk
+
+服务端模型和文件工具 SDK。
+
+## 身份选择（0.6.0 起）
+
+`LICOS_CURRENT_USER_ID` 表示容器启动时配置的执行用户。SDK 不用它推断当前网页登录者，也不读取进程级 `LICOS_USER_TOKEN` 作为模型请求凭证。项目身份指运行时配置的项目所有者身份，按接口选择：
+
+| 接口 | 默认身份 | 以网页登录用户执行 |
+| --- | --- | --- |
+| 模型目录、模型详情、端点解析 | 项目身份 | 显式传 `user_token` |
+| LLM、视觉、图片生成、视频生成、语音识别客户端 | 项目身份 | 每次用户请求创建客户端并传 `user_token` |
+| `check_credit_availability` | 项目身份 | 显式传 `user_token` |
+| 可观测性 | 项目身份 | 保持项目身份 |
+| 文档、表格、图片排版等本地文件工具 | 无需用户 Token | 无需用户 Token |
+
+需要以网页登录用户执行时，从本次认证会话取得不含 `Bearer ` 前缀的 Token，并让积分检查和模型调用使用同一用户身份：
+
+```python
+from licos_dev_sdk import LLMClient, check_credit_availability
+
+# token 来自本次请求的认证会话。
+availability = check_credit_availability(user_token=token, resource_code='LLM_INVOKE')
+result = LLMClient(user_token=token).invoke('你好')
+```
+
+用户标识、名称和企业信息来自平台认证结果。项目所有者、工作空间等资源归属字段单独保留；模型实际计费上下文以平台模型详情接口签发的签名为准。
+
+以网页登录用户执行的业务入口缺少 Token 时应返回登录错误，不能省略参数后使用项目身份。不要把请求 Token 或用户 ID 写入 `os.environ`，不要跨用户共享带身份的客户端。显式传入的 Token 为空或失效时直接报错，由调用方更新登录凭证后创建新客户端，不换取容器用户或项目所有者的 Token。
+
+独立 `licos-dev` CLI 的模型和积分命令默认使用 `LICOS_CURRENT_USER_ID`，可用 `--identity project` 选择项目身份；HTTP 服务通过 CLI 代表登录用户执行时使用 `--token-stdin`。SDK 默认身份与 CLI 默认身份不同，调用时按上述接口规则显式选择。
+
+## 编程项目登录身份
+
+- 有内置登录时使用内置登录会话；没有内置登录时使用当前 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_sdk-0.6.0 → licos_dev_sdk-0.6.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-sdk"
-version = "0.6.0"
+version = "0.6.2"
 description = "LICOS Dev SDK - file generation and model capability clients"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.7.0",
+    "licos-platform-sdk>=0.7.2",
     "weasyprint>=62.0",
     "python-docx>=1.1",
     "docxtpl>=0.16",

licos_dev_sdk-0.6.0/PKG-INFO

@@ -1,42 +0,0 @@
-Metadata-Version: 2.4
-Name: licos-dev-sdk
-Version: 0.6.0
-Summary: LICOS Dev SDK - file generation and model capability clients
-Requires-Python: >=3.10
-Requires-Dist: beautifulsoup4>=4.12
-Requires-Dist: docxtpl>=0.16
-Requires-Dist: graphviz>=0.20
-Requires-Dist: jinja2>=3.1
-Requires-Dist: licos-platform-sdk>=0.7.0
-Requires-Dist: matplotlib>=3.9
-Requires-Dist: mistune>=3.0
-Requires-Dist: openpyxl>=3.1
-Requires-Dist: pillow>=10.0
-Requires-Dist: pypdf>=5.0
-Requires-Dist: python-barcode>=0.15
-Requires-Dist: python-docx>=1.1
-Requires-Dist: python-pptx>=1.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: qrcode[pil]>=8.0
-Requires-Dist: skia-pathops>=0.9.2
-Requires-Dist: uharfbuzz>=0.50.0
-Requires-Dist: weasyprint>=62.0
-Requires-Dist: xlsxwriter>=3.2
-Provides-Extra: ppt-master
-Requires-Dist: licos-ppt-master-assets==0.0.1; extra == 'ppt-master'
-Description-Content-Type: text/markdown
-
-# licos-dev-sdk
-
-服务端模型和文件工具 SDK。模型目录、模型调用及积分检查默认使用项目所有者身份。需要以网页登录用户执行时，在本次请求创建客户端并显式传 `user_token`：
-
-```python
-from licos_dev_sdk import LLMClient, check_credit_availability
-
-availability = check_credit_availability(user_token=token, resource_code='LLM_INVOKE')
-result = LLMClient(user_token=token).invoke('你好')
-```
-
-Token 不含 `Bearer ` 前缀。用户信息来自平台认证结果；不从 `LICOS_CURRENT_USER_ID` 或 `LICOS_USER_TOKEN` 推断网页登录身份。Token 失效直接报错，由调用方更新会话。项目资源归属和平台签发的计费上下文保持独立。
-
-可观测性继续使用项目身份；文件生成无需用户 Token。完整约定见仓库的 `tools/IDENTITY.md`。

licos_dev_sdk-0.6.0/README.md

@@ -1,14 +0,0 @@
-# licos-dev-sdk
-
-服务端模型和文件工具 SDK。模型目录、模型调用及积分检查默认使用项目所有者身份。需要以网页登录用户执行时，在本次请求创建客户端并显式传 `user_token`：
-
-```python
-from licos_dev_sdk import LLMClient, check_credit_availability
-
-availability = check_credit_availability(user_token=token, resource_code='LLM_INVOKE')
-result = LLMClient(user_token=token).invoke('你好')
-```
-
-Token 不含 `Bearer ` 前缀。用户信息来自平台认证结果；不从 `LICOS_CURRENT_USER_ID` 或 `LICOS_USER_TOKEN` 推断网页登录身份。Token 失效直接报错，由调用方更新会话。项目资源归属和平台签发的计费上下文保持独立。
-
-可观测性继续使用项目身份；文件生成无需用户 Token。完整约定见仓库的 `tools/IDENTITY.md`。