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

{licos_dev_sdk-0.6.1 → licos_dev_sdk-0.6.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: licos-dev-sdk
-Version: 0.6.1
+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.1
+Requires-Dist: licos-platform-sdk>=0.7.2
 Requires-Dist: matplotlib>=3.9
 Requires-Dist: mistune>=3.0
 Requires-Dist: openpyxl>=3.1
@@ -57,3 +57,13 @@ 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.1 → licos_dev_sdk-0.6.2}/README.md

@@ -29,3 +29,13 @@ 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.1 → licos_dev_sdk-0.6.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-sdk"
-version = "0.6.1"
+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.1",
+    "licos-platform-sdk>=0.7.2",
     "weasyprint>=62.0",
     "python-docx>=1.1",
     "docxtpl>=0.16",