licos-platform-cli 0.4.12__tar.gz → 0.5.1__tar.gz

licos_platform_cli-0.5.1/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.5
+Name: licos-platform-cli
+Version: 0.5.1
+Summary: LICOS platform CLI
+Requires-Python: >=3.10
+Requires-Dist: licos-platform-sdk>=0.6.1
+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 放在命令行参数中：
+
+```bash
+licos-platform user me --token-stdin
+```
+
+输入不含 `Bearer ` 前缀的 Token 并结束标准输入。程序调用时可通过子进程的 `input` 参数传入。
+
+输出为与低代码 `sys_user` 相同的 JSON：用户 ID、账号、姓名、头像、执行企业、
+主部门、全部所属部门、组织任职、主岗位和主职务。部门含名称路径、ID 路径；
+无部门/任职时保持 `[]`/`null`。缺少当前使用者身份或 Token 失效时返回非零退出码，
+不改用项目所有者。Token 和内部服务凭证不回显。

licos_platform_cli-0.5.1/README.md

@@ -0,0 +1,25 @@
+# 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 放在命令行参数中：
+
+```bash
+licos-platform user me --token-stdin
+```
+
+输入不含 `Bearer ` 前缀的 Token 并结束标准输入。程序调用时可通过子进程的 `input` 参数传入。
+
+输出为与低代码 `sys_user` 相同的 JSON：用户 ID、账号、姓名、头像、执行企业、
+主部门、全部所属部门、组织任职、主岗位和主职务。部门含名称路径、ID 路径；
+无部门/任职时保持 `[]`/`null`。缺少当前使用者身份或 Token 失效时返回非零退出码，
+不改用项目所有者。Token 和内部服务凭证不回显。

{licos_platform_cli-0.4.12 → licos_platform_cli-0.5.1}/pyproject.toml

@@ -4,11 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-platform-cli"
-version = "0.4.12"
+version = "0.5.1"
 description = "LICOS platform CLI"
+readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.5.9",
+    "licos-platform-sdk>=0.6.1",
 ]
 
 [project.scripts]

{licos_platform_cli-0.4.12 → licos_platform_cli-0.5.1}/src/licos_platform_cli/help_commands.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import argparse
 from typing import Any, Callable
+from .user_commands import USER_HELP
 
 
 Handler = Callable[[argparse.Namespace], Any]
@@ -370,7 +371,7 @@ DATABASE_HELP = {
 
 KNOWLEDGE_HELP = {
     "topic": "knowledge",
-    "description": "Personal/project knowledge datasets plus enterprise knowledge folders, knowledge bases, documents, retrieval, and object storage.",
+    "description": "Personal/project knowledge datasets plus read-only enterprise knowledge discovery, documents, retrieval, and download links.",
     "runtime": RUNTIME_ENV,
     "rules": [
         "Use SDK from server/runtime code; do not call from browser bundles.",
@@ -379,9 +380,9 @@ KNOWLEDGE_HELP = {
         "Search all accessible datasets by default; pass dataset IDs or names only when the user explicitly asks for specific datasets.",
         "For text imports, the SDK sends UTF-8 text as a text/plain base64 document through the platform API.",
         "Enterprise commands require an enterprise user. Tenant scope and permissions come from the current user token; never pass or invent tenant IDs.",
-        "Enterprise knowledge types are STANDARD, GRAPH, and OBJECT_STORAGE. Capabilities are retrieve, upload, list_files, and batch_delete_files.",
-        "Validate enterprise knowledge references before retrieval, upload, listing, or deletion when an Agent receives IDs from conversation context.",
-        "Use document-url/object-url for temporary access URLs; do not construct storage URLs.",
+        "Enterprise tree supports STANDARD, GRAPH, and OBJECT_STORAGE type filters. Current enterprise APIs support retrieve and list_files only.",
+        "Validate enterprise knowledge references before retrieval or listing when an Agent receives IDs from conversation context. Manage enterprise resources through the platform knowledge IFrame.",
+        "Use document-url/document-download-link for temporary access URLs; do not construct storage URLs.",
     ],
     "sdk": {
         "python": "from licos_platform_sdk import knowledge\nknowledge.add_text('FAQ content', dataset_name='project_docs')\nresults = knowledge.search('How to reset password?')",
@@ -389,168 +390,148 @@ KNOWLEDGE_HELP = {
         "enterprise_python": "from licos_platform_sdk import enterprise_knowledge\nresources = enterprise_knowledge.tree()\nresult = enterprise_knowledge.retrieve('安全规范', 'source-id')",
         "enterprise_node": "import { enterpriseKnowledge } from '@kmlckj/licos-platform-sdk';\nconst resources = await enterpriseKnowledge.tree();\nconst result = await enterpriseKnowledge.retrieve('安全规范', 'source-id');",
     },
-    "commands": {
-        "runtime": {
-            "description": "Show knowledge runtime status and capabilities.",
-            "parameters": [],
-            "example": "licos-platform knowledge runtime",
-        },
-        "model-catalog": {
-            "description": "Show knowledge-related model catalog metadata.",
-            "parameters": [],
-            "example": "licos-platform knowledge model-catalog",
-        },
-        "datasets": {
-            "description": "List knowledge datasets visible to the current project owner.",
-            "parameters": [
-                {"name": "--name", "required": False, "description": "Filter by dataset name."},
-                {"name": "--space-id", "required": False, "description": "Workspace/space ID. Defaults to runtime workspace when available."},
-                {"name": "--page-size", "required": False, "description": "Page size."},
-                {"name": "--page-num", "required": False, "description": "Page number."},
-            ],
-            "example": "licos-platform knowledge datasets --name project_docs",
-        },
-        "create-dataset": {
-            "description": "Create a knowledge dataset.",
-            "parameters": [
-                {"name": "name", "required": True, "description": "Dataset name."},
-                {"name": "--description", "required": False, "description": "Dataset description."},
-                {"name": "--space-id", "required": False, "description": "Workspace/space ID."},
-            ],
-            "example": "licos-platform knowledge create-dataset project_docs --description 'Project documentation'",
-        },
-        "ensure-dataset": {
-            "description": "Find a dataset by name or create it if missing.",
-            "parameters": [
-                {"name": "name", "required": True, "description": "Dataset name."},
-                {"name": "--description", "required": False, "description": "Description used only when creating."},
-            ],
-            "example": "licos-platform knowledge ensure-dataset project_docs",
-        },
-        "add": {
-            "description": "Import raw text, a web URL, or a platform object-storage file reference into a dataset.",
-            "parameters": [
-                {"name": "--dataset-id / --dataset", "required": True, "description": "Target dataset ID or dataset name. Names are created when missing."},
-                {"name": "--content / --url / --source-file-id", "required": True, "description": "Exactly one import source."},
-                {"name": "--name", "required": False, "description": "Document display name."},
-                {"name": "--max-tokens", "required": False, "description": "Max tokens per chunk."},
-                {"name": "--separator", "required": False, "description": "Chunk separator."},
-            ],
-            "example": "licos-platform knowledge add --dataset project_docs --content 'FAQ content' --name faq.txt",
-        },
-        "search": {
-            "description": "Run semantic retrieval. Omit dataset filters to search all accessible datasets.",
-            "parameters": [
-                {"name": "--query", "required": True, "description": "Search query."},
-                {"name": "--dataset-id", "required": False, "description": "Dataset ID. Can repeat."},
-                {"name": "--dataset", "required": False, "description": "Dataset name. Can repeat."},
-                {"name": "--top-k", "required": False, "description": "Result count, default 5."},
-                {"name": "--min-score", "required": False, "description": "Minimum score threshold."},
-            ],
-            "example": "licos-platform knowledge search --query 'How to reset password?' --top-k 5",
-        },
-        "documents": {
-            "description": "List documents in a dataset.",
-            "parameters": [
-                {"name": "dataset_id", "required": True, "description": "Dataset ID."},
-                {"name": "--page", "required": False, "description": "Page number."},
-                {"name": "--size", "required": False, "description": "Page size."},
-            ],
-            "example": "licos-platform knowledge documents dataset-id --page 1 --size 20",
-        },
-        "delete-documents": {
-            "description": "Delete one or more documents from a dataset.",
-            "parameters": [
-                {"name": "dataset_id", "required": True, "description": "Dataset ID."},
-                {"name": "document_id", "required": True, "description": "Document ID. Can repeat."},
-            ],
-            "example": "licos-platform knowledge delete-documents dataset-id doc-1 doc-2",
-        },
-        "enterprise-tree": {
-            "description": "Return the enterprise knowledge resource tree visible to the current enterprise user.",
-            "parameters": [{"name": "--include-type", "type": "enum, repeatable", "required": False, "values": ["STANDARD", "GRAPH", "OBJECT_STORAGE"], "description": "Limit returned knowledge types."}],
-            "returns": "Tree response with status, tenant_id, permission_scope, nodes, capabilities, and children.",
-            "example": "licos-platform knowledge enterprise tree --include-type STANDARD --include-type GRAPH",
-        },
-        "enterprise-search": {
-            "description": "Search visible enterprise knowledge bases by name.",
-            "parameters": [{"name": "--query", "type": "string", "required": True, "description": "Knowledge base name search text."}, {"name": "--include-type", "type": "enum, repeatable", "required": False, "description": "STANDARD, GRAPH, or OBJECT_STORAGE."}, {"name": "--page / --page-size", "type": "integer", "required": False, "description": "One-based pagination; page size maximum is 100."}],
-            "returns": "Platform paged search response containing visible enterprise knowledge resources.",
-            "example": "licos-platform knowledge enterprise search --query 设备手册 --include-type STANDARD",
-        },
-        "enterprise-validate": {
-            "description": "Validate one or more enterprise knowledge IDs against the current user's access and required capability.",
-            "parameters": [{"name": "knowledge_base_id", "type": "string, repeatable", "required": True, "description": "Knowledge base/source ID."}, {"name": "--required-capability", "type": "enum", "required": False, "values": ["retrieve", "upload", "list_files", "batch_delete_files"], "description": "Required operation capability; default retrieve."}],
-            "returns": "Object with valid boolean, required_capability string, and per-ID validation items.",
-            "example": "licos-platform knowledge enterprise validate source-1 --required-capability retrieve",
-        },
-        "enterprise-retrieve": {
-            "description": "Retrieve evidence from explicitly selected enterprise knowledge bases.",
-            "parameters": [{"name": "--query", "type": "string", "required": True, "description": "Natural-language retrieval query."}, {"name": "--source-id", "type": "string", "required": True, "description": "Knowledge base source ID."}],
-            "returns": "Enterprise retrieval response from the platform, including matching evidence and source metadata when available.",
-            "example": "licos-platform knowledge enterprise retrieve --query 安全规范 --source-id source-1",
-        },
-        "enterprise-folders": {
-            "description": "List enterprise knowledge folders.",
-            "parameters": [{"name": "--parent-id", "type": "string", "required": False, "description": "Parent folder ID; omit for root."}, {"name": "--include-children", "type": "flag", "required": False, "description": "Include descendants."}, {"name": "--query", "type": "string", "required": False, "description": "Folder name filter."}],
-            "returns": "Paged folder response.",
-            "example": "licos-platform knowledge enterprise folders --include-children",
-        },
-        "enterprise-create-folder": {
-            "description": "Create an enterprise knowledge folder.",
-            "parameters": [{"name": "name", "type": "string", "required": True, "description": "Folder name."}, {"name": "--parent-id", "type": "string", "required": False, "description": "Parent folder ID."}, {"name": "--description", "type": "string", "required": False, "description": "Folder description."}],
-            "returns": "Created folder resource.",
-            "example": "licos-platform knowledge enterprise create-folder 设备文档 --description 设备说明书",
-        },
-        "enterprise-delete-folder": {
-            "description": "Delete an enterprise knowledge folder after explicit confirmation.",
-            "parameters": [{"name": "folder_id", "type": "string", "required": True, "description": "Folder ID."}, {"name": "--reason", "type": "string", "required": False, "description": "Audit reason."}, {"name": "--hard-delete", "type": "flag", "required": False, "description": "Permanently delete."}, {"name": "--confirm-name", "type": "string", "required": False, "description": "Name required by platform confirmation policy."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Confirm destructive operation."}],
-            "returns": "Platform deletion result.",
-            "example": "licos-platform knowledge enterprise delete-folder folder-id --reason 重建目录 --confirm",
-        },
-        "enterprise-create-knowledge-base": {
-            "description": "Create a STANDARD, GRAPH, or OBJECT_STORAGE enterprise knowledge base.",
-            "parameters": [{"name": "name", "type": "string", "required": True, "description": "Knowledge base name."}, {"name": "--folder-id", "type": "string", "required": False, "description": "Parent folder ID."}, {"name": "--knowledge-type", "type": "enum", "required": False, "values": ["STANDARD", "GRAPH", "OBJECT_STORAGE"], "description": "Knowledge type; default STANDARD."}, {"name": "--description", "type": "string", "required": False, "description": "Knowledge base description."}],
-            "returns": "Created knowledge base with durable source/resource ID.",
-            "example": "licos-platform knowledge enterprise create-knowledge-base 设备手册 --folder-id folder-id --knowledge-type STANDARD",
-        },
-        "enterprise-documents": {
-            "description": "List documents belonging to one enterprise knowledge base.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Knowledge base source ID."}, {"name": "--query", "type": "string", "required": False, "description": "Document search text."}, {"name": "--status", "type": "string", "required": False, "description": "Platform document processing status."}, {"name": "--document-id", "type": "string", "required": False, "description": "Exact document ID filter."}],
-            "returns": "Paged document response with document processing metadata.",
-            "example": "licos-platform knowledge enterprise documents source-id --page 1 --page-size 20",
-        },
-        "enterprise-upload-document": {
-            "description": "Upload a local document to an enterprise knowledge base. Use --chunked for resumable uploads.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Target knowledge base source ID."}, {"name": "file", "type": "path", "required": True, "description": "Readable local file."}, {"name": "--file-name", "type": "string", "required": False, "description": "Override display name."}, {"name": "--content-type", "type": "MIME string", "required": False, "description": "Override inferred MIME type."}, {"name": "--chunked", "type": "flag", "required": False, "description": "Use resumable upload."}, {"name": "--chunk-size", "type": "integer bytes", "required": False, "description": "5 MiB to 100 MiB; default 8 MiB."}],
-            "returns": "Asynchronous processing task/result object. Poll task ID when returned.",
-            "example": "licos-platform knowledge enterprise upload-document source-id ./manual.pdf --chunked",
-        },
-        "enterprise-delete-documents": {
-            "description": "Batch delete up to 100 enterprise knowledge documents after explicit confirmation.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Knowledge base source ID."}, {"name": "document_id", "type": "string, repeatable", "required": True, "description": "Document ID."}, {"name": "--operator / --reason", "type": "string", "required": False, "description": "Audit metadata."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Confirm destructive operation."}],
-            "returns": "Batch deletion result, which may report partial failures.",
-            "example": "licos-platform knowledge enterprise delete-documents source-id doc-1 doc-2 --reason 重复文档 --confirm",
-        },
-        "enterprise-objects": {
-            "description": "Query objects in an OBJECT_STORAGE enterprise knowledge base.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Object-storage knowledge base source ID."}, {"name": "--prefix", "type": "string", "required": False, "description": "Object-key prefix."}, {"name": "--query", "type": "string", "required": False, "description": "Object name search text."}],
-            "returns": "Paged object metadata response.",
-            "example": "licos-platform knowledge enterprise objects source-id --prefix reports/",
-        },
-        "enterprise-upload-objects": {
-            "description": "Upload one or more files to an OBJECT_STORAGE enterprise knowledge base.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Object-storage knowledge base source ID."}, {"name": "file", "type": "path, repeatable", "required": True, "description": "Local files."}, {"name": "--object-key", "type": "string, repeatable", "required": False, "description": "Explicit object key for each file; count must match files."}, {"name": "--prefix", "type": "string", "required": False, "description": "Target object prefix."}, {"name": "--metadata", "type": "JSON object", "required": False, "description": "Upload metadata."}],
-            "returns": "Asynchronous object upload task/result.",
-            "example": "licos-platform knowledge enterprise upload-objects source-id ./a.pdf ./b.pdf --prefix reports/",
-        },
-        "enterprise-object-url": {
-            "description": "Get a temporary URL for one enterprise knowledge object.",
-            "parameters": [{"name": "source_id", "type": "string", "required": True, "description": "Object-storage knowledge base source ID."}, {"name": "object_key", "type": "string", "required": True, "description": "Exact object key."}, {"name": "--inline", "type": "flag", "required": False, "description": "Request inline display instead of download."}],
-            "returns": "Object with temporary url string.",
-            "example": "licos-platform knowledge enterprise object-url source-id reports/manual.pdf --inline",
-        },
-    },
+    "commands": {'runtime': {'description': 'Show knowledge runtime status and capabilities.',
+                 'parameters': [],
+                 'example': 'licos-platform knowledge runtime'},
+     'model-catalog': {'description': 'Show knowledge-related model catalog metadata.',
+                       'parameters': [],
+                       'example': 'licos-platform knowledge model-catalog'},
+     'datasets': {'description': 'List knowledge datasets visible to the current project owner.',
+                  'parameters': [{'name': '--name', 'required': False, 'description': 'Filter by dataset name.'},
+                                 {'name': '--space-id',
+                                  'required': False,
+                                  'description': 'Workspace/space ID. Defaults to runtime workspace when available.'},
+                                 {'name': '--page-size', 'required': False, 'description': 'Page size.'},
+                                 {'name': '--page-num', 'required': False, 'description': 'Page number.'}],
+                  'example': 'licos-platform knowledge datasets --name project_docs'},
+     'create-dataset': {'description': 'Create a knowledge dataset.',
+                        'parameters': [{'name': 'name', 'required': True, 'description': 'Dataset name.'},
+                                       {'name': '--description', 'required': False, 'description': 'Dataset description.'},
+                                       {'name': '--space-id', 'required': False, 'description': 'Workspace/space ID.'}],
+                        'example': "licos-platform knowledge create-dataset project_docs --description 'Project documentation'"},
+     'ensure-dataset': {'description': 'Find a dataset by name or create it if missing.',
+                        'parameters': [{'name': 'name', 'required': True, 'description': 'Dataset name.'},
+                                       {'name': '--description',
+                                        'required': False,
+                                        'description': 'Description used only when creating.'}],
+                        'example': 'licos-platform knowledge ensure-dataset project_docs'},
+     'add': {'description': 'Import raw text, a web URL, or a platform object-storage file reference into a dataset.',
+             'parameters': [{'name': '--dataset-id / --dataset',
+                             'required': True,
+                             'description': 'Target dataset ID or dataset name. Names are created when missing.'},
+                            {'name': '--content / --url / --source-file-id',
+                             'required': True,
+                             'description': 'Exactly one import source.'},
+                            {'name': '--name', 'required': False, 'description': 'Document display name.'},
+                            {'name': '--max-tokens', 'required': False, 'description': 'Max tokens per chunk.'},
+                            {'name': '--separator', 'required': False, 'description': 'Chunk separator.'}],
+             'example': "licos-platform knowledge add --dataset project_docs --content 'FAQ content' --name faq.txt"},
+     'search': {'description': 'Run semantic retrieval. Omit dataset filters to search all accessible datasets.',
+                'parameters': [{'name': '--query', 'required': True, 'description': 'Search query.'},
+                               {'name': '--dataset-id', 'required': False, 'description': 'Dataset ID. Can repeat.'},
+                               {'name': '--dataset', 'required': False, 'description': 'Dataset name. Can repeat.'},
+                               {'name': '--top-k', 'required': False, 'description': 'Result count, default 5.'},
+                               {'name': '--min-score', 'required': False, 'description': 'Minimum score threshold.'}],
+                'example': "licos-platform knowledge search --query 'How to reset password?' --top-k 5"},
+     'documents': {'description': 'List documents in a dataset.',
+                   'parameters': [{'name': 'dataset_id', 'required': True, 'description': 'Dataset ID.'},
+                                  {'name': '--page', 'required': False, 'description': 'Page number.'},
+                                  {'name': '--size', 'required': False, 'description': 'Page size.'}],
+                   'example': 'licos-platform knowledge documents dataset-id --page 1 --size 20'},
+     'delete-documents': {'description': 'Delete one or more documents from a dataset.',
+                          'parameters': [{'name': 'dataset_id', 'required': True, 'description': 'Dataset ID.'},
+                                         {'name': 'document_id', 'required': True, 'description': 'Document ID. Can repeat.'}],
+                          'example': 'licos-platform knowledge delete-documents dataset-id doc-1 doc-2'},
+     'enterprise-tree': {'description': 'Return the enterprise knowledge resource tree visible to the current enterprise user.',
+                         'parameters': [{'name': '--include-type',
+                                         'type': 'enum, repeatable',
+                                         'required': False,
+                                         'values': ['STANDARD', 'GRAPH', 'OBJECT_STORAGE'],
+                                         'description': 'Limit returned knowledge types.'}],
+                         'returns': 'Tree response with status, tenant_id, permission_scope, nodes, capabilities, and children.',
+                         'example': 'licos-platform knowledge enterprise tree --include-type STANDARD --include-type GRAPH'},
+     'enterprise-search': {'description': 'Search visible enterprise knowledge bases by name.',
+                           'parameters': [{'name': '--query',
+                                           'type': 'string',
+                                           'required': True,
+                                           'description': 'Knowledge base name search text.'},
+                                          {'name': '--page / --page-size',
+                                           'type': 'integer',
+                                           'required': False,
+                                           'description': 'One-based pagination; page size maximum is 100.'}],
+                           'returns': 'Platform paged search response containing visible enterprise knowledge resources.',
+                           'example': 'licos-platform knowledge enterprise search --query 设备手册 --include-type STANDARD'},
+     'enterprise-validate': {'description': "Validate one or more enterprise knowledge IDs against the current user's access "
+                                            'and required capability.',
+                             'parameters': [{'name': 'knowledge_base_id',
+                                             'type': 'string, repeatable',
+                                             'required': True,
+                                             'description': 'Knowledge base/source ID.'},
+                                            {'name': '--required-capability',
+                                             'type': 'enum',
+                                             'required': False,
+                                             'values': ['retrieve', 'upload', 'list_files', 'batch_delete_files'],
+                                             'description': 'Required operation capability; default retrieve.'}],
+                             'returns': 'Object with valid boolean, required_capability string, and per-ID validation items.',
+                             'example': 'licos-platform knowledge enterprise validate source-1 --required-capability retrieve'},
+     'enterprise-retrieve': {'description': 'Retrieve evidence from explicitly selected enterprise knowledge bases.',
+                             'parameters': [{'name': '--query',
+                                             'type': 'string',
+                                             'required': True,
+                                             'description': 'Natural-language retrieval query.'},
+                                            {'name': '--source-id',
+                                             'type': 'string',
+                                             'required': True,
+                                             'description': 'Knowledge base source ID.'}],
+                             'returns': 'Enterprise retrieval response from the platform, including matching evidence and '
+                                        'source metadata when available.',
+                             'example': 'licos-platform knowledge enterprise retrieve --query 安全规范 --source-id source-1'},
+     'enterprise-folders': {'description': 'List enterprise knowledge folders.',
+                            'parameters': [{'name': '--parent-id',
+                                            'type': 'string',
+                                            'required': False,
+                                            'description': 'Parent folder ID; omit for root.'},
+                                           {'name': '--include-children',
+                                            'type': 'flag',
+                                            'required': False,
+                                            'description': 'Include descendants.'}],
+                            'returns': 'Paged folder response.',
+                            'example': 'licos-platform knowledge enterprise folders --include-children'},
+     'enterprise-documents': {'description': 'List documents belonging to one enterprise knowledge base.',
+                              'parameters': [{'name': 'source_id',
+                                              'type': 'string',
+                                              'required': True,
+                                              'description': 'Knowledge base source ID.'},
+                                             {'name': '--query',
+                                              'type': 'string',
+                                              'required': False,
+                                              'description': 'Document search text.'}],
+                              'returns': 'Paged document response with document processing metadata.',
+                              'example': 'licos-platform knowledge enterprise documents source-id --page 1 --page-size 20'},
+     'enterprise-folder': {'description': '读取企业目录详情。',
+                           'parameters': [{'name': 'folder-id', 'required': True}],
+                           'example': 'licos-platform knowledge enterprise folder folder-id'},
+     'enterprise-knowledge-base': {'description': '读取企业知识库详情。',
+                                   'parameters': [{'name': 'source-id', 'required': True}],
+                                   'example': 'licos-platform knowledge enterprise knowledge-base source-id'},
+     'enterprise-document': {'description': '读取文件详情，包含原始状态及元数据。',
+                             'parameters': [{'name': 'document-id', 'required': True}],
+                             'example': 'licos-platform knowledge enterprise document document-id'},
+     'enterprise-document-url': {'description': '获取临时原文 URL，不得持久化。',
+                                 'parameters': [{'name': 'document-id', 'required': True}],
+                                 'example': 'licos-platform knowledge enterprise document-url document-id'},
+     'enterprise-document-download-link': {'description': '获取临时下载短链及文件 ID。',
+                                           'parameters': [{'name': 'document-id', 'required': True}],
+                                           'example': 'licos-platform knowledge enterprise document-download-link document-id'},
+     'enterprise-folder-knowledge-bases': {'description': '列出目录下的知识库。',
+                                           'parameters': [{'name': 'folder-id', 'required': True},
+                                                          {'name': '--include-children', 'required': False},
+                                                          {'name': '--page / --page-size', 'required': False}],
+                                           'example': 'licos-platform knowledge enterprise folder-knowledge-bases folder-id'},
+     'enterprise-document-chunks': {'description': '分页读取文件分片，不支持关键词过滤。',
+                                    'parameters': [{'name': 'document-id', 'required': True},
+                                                   {'name': '--page / --page-size', 'required': False}],
+                                    'example': 'licos-platform knowledge enterprise document-chunks document-id'}},
 }
 
 
@@ -860,6 +841,7 @@ ONTOLOGY_HELP = {
 
 
 HELP_TOPICS = {
+    "user": USER_HELP,
     "storage": STORAGE_HELP,
     "database": DATABASE_HELP,
     "knowledge": KNOWLEDGE_HELP,
@@ -891,6 +873,7 @@ def _cmd_help(args: argparse.Namespace) -> dict[str, Any]:
                 "licos-platform help project-config set-database",
                 "licos-platform help ontology",
                 "licos-platform help ontology search",
+                "licos-platform help user me",
             ],
             "topics": sorted(HELP_TOPICS),
         }

{licos_platform_cli-0.4.12 → licos_platform_cli-0.5.1}/src/licos_platform_cli/knowledge_commands.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import argparse
-import json
 from typing import Any, Callable
 
 from licos_platform_sdk import enterprise_knowledge, knowledge
@@ -129,7 +128,6 @@ def _cmd_enterprise_tree(args: argparse.Namespace) -> Any:
 def _cmd_enterprise_search(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.search_knowledge_bases(
         args.query,
-        include_types=args.include_types,
         page=args.page,
         page_size=args.page_size,
     )
@@ -150,7 +148,6 @@ def _cmd_enterprise_folders(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.list_folders(
         parent_id=args.parent_id,
         include_children=args.include_children,
-        query=args.query,
         page=args.page,
         page_size=args.page_size,
     )
@@ -160,64 +157,25 @@ def _cmd_enterprise_folder(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.get_folder(args.folder_id)
 
 
-def _cmd_enterprise_create_folder(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.create_folder(
-        args.name,
-        parent_id=args.parent_id,
-        description=args.description,
-    )
-
-
-def _cmd_enterprise_delete_folder(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.delete_folder(
-        args.folder_id,
-        reason=args.reason,
-        hard_delete=args.hard_delete,
-        confirm_name=args.confirm_name,
-    )
-
-
 def _cmd_enterprise_folder_knowledge_bases(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.list_folder_knowledge_bases(
         args.folder_id,
         include_children=args.include_children,
-        include_types=args.include_types,
-        query=args.query,
         page=args.page,
         page_size=args.page_size,
     )
 
 
-def _cmd_enterprise_create_knowledge_base(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.create_knowledge_base(
-        args.name,
-        folder_id=args.folder_id,
-        description=args.description,
-        knowledge_type=args.knowledge_type,
-    )
-
-
 def _cmd_enterprise_knowledge_base(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.get_knowledge_base(args.source_id)
 
 
-def _cmd_enterprise_delete_knowledge_base(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.delete_knowledge_base(
-        args.source_id,
-        reason=args.reason,
-        hard_delete=args.hard_delete,
-        confirm_name=args.confirm_name,
-    )
-
-
 def _cmd_enterprise_documents(args: argparse.Namespace) -> Any:
     return enterprise_knowledge.list_documents(
         args.source_id,
         page=args.page,
         page_size=args.page_size,
         query=args.query,
-        status=args.status,
-        document_id=args.document_id,
     )
 
 
@@ -230,7 +188,6 @@ def _cmd_enterprise_document_chunks(args: argparse.Namespace) -> Any:
         args.document_id,
         page=args.page,
         page_size=args.page_size,
-        query=args.query,
     )
 
 
@@ -238,86 +195,8 @@ def _cmd_enterprise_document_url(args: argparse.Namespace) -> Any:
     return {"url": enterprise_knowledge.document_original_url(args.document_id, download=args.download)}
 
 
-def _cmd_enterprise_delete_documents(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.batch_delete_documents(
-        args.source_id,
-        args.document_id,
-        operator=args.operator,
-        reason=args.reason,
-    )
-
-
-def _cmd_enterprise_upload_document(args: argparse.Namespace) -> Any:
-    options = {
-        "file_name": args.file_name,
-        "content_type": args.content_type,
-    }
-    if args.chunked:
-        return enterprise_knowledge.upload_document_chunked(
-            args.source_id,
-            args.file,
-            chunk_size=args.chunk_size,
-            **options,
-        )
-    return enterprise_knowledge.upload_document(args.source_id, args.file, **options)
-
-
-def _cmd_enterprise_object_contract(_args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.object_storage_contract()
-
-
-def _cmd_enterprise_objects(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.query_objects(
-        args.source_id,
-        prefix=args.prefix,
-        query=args.query,
-        page=args.page,
-        page_size=args.page_size,
-    )
-
-
-def _parse_json_object(value: str | None, argument: str) -> dict[str, Any] | None:
-    if value is None:
-        return None
-    try:
-        parsed = json.loads(value)
-    except json.JSONDecodeError as exc:
-        raise argparse.ArgumentTypeError(f"{argument} must be valid JSON: {exc.msg}") from exc
-    if not isinstance(parsed, dict):
-        raise argparse.ArgumentTypeError(f"{argument} must be a JSON object")
-    return parsed
-
-
-def _cmd_enterprise_upload_objects(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.upload_objects(
-        args.source_id,
-        args.file,
-        object_keys=args.object_key,
-        prefix=args.prefix,
-        metadata=_parse_json_object(args.metadata, "--metadata"),
-    )
-
-
-def _cmd_enterprise_object(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.get_object(args.source_id, args.object_key)
-
-
-def _cmd_enterprise_object_url(args: argparse.Namespace) -> Any:
-    return {
-        "url": enterprise_knowledge.object_download_url(
-            args.source_id,
-            args.object_key,
-            inline=args.inline,
-        )
-    }
-
-
-def _cmd_enterprise_delete_object(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.delete_object(args.source_id, args.object_key)
-
-
-def _cmd_enterprise_object_task(args: argparse.Namespace) -> Any:
-    return enterprise_knowledge.get_object_upload_task(args.task_id)
+def _cmd_enterprise_document_download_link(args: argparse.Namespace) -> Any:
+    return enterprise_knowledge.document_download_link(args.document_id)
 
 
 def _add_dataset_selector(parser: argparse.ArgumentParser) -> None:
@@ -354,13 +233,6 @@ def _add_enterprise_types(parser: argparse.ArgumentParser) -> None:
     )
 
 
-def _add_enterprise_delete_args(parser: argparse.ArgumentParser) -> None:
-    parser.add_argument("--reason", default=None, help="Audit reason for deleting the resource")
-    parser.add_argument("--hard-delete", action="store_true", default=None, help="Permanently delete the resource")
-    parser.add_argument("--confirm-name", default=None, help="Resource name confirmation required by platform policy")
-    parser.add_argument("--confirm", action="store_true", required=True, help="Confirm this destructive operation")
-
-
 def _add_enterprise_parser(
     knowledge_subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
 ) -> None:
@@ -376,7 +248,6 @@ def _add_enterprise_parser(
 
     search = commands.add_parser("search", help="Search enterprise knowledge bases by name")
     search.add_argument("--query", "-q", required=True)
-    _add_enterprise_types(search)
     _add_page_args(search)
     _set_handler(search, _cmd_enterprise_search)
 
@@ -397,58 +268,28 @@ def _add_enterprise_parser(
     folders = commands.add_parser("folders", help="List enterprise knowledge folders")
     folders.add_argument("--parent-id", default=None)
     folders.add_argument("--include-children", action="store_true", default=None)
-    _add_enterprise_query_args(folders)
+    _add_page_args(folders)
     _set_handler(folders, _cmd_enterprise_folders)
 
     folder = commands.add_parser("folder", help="Get one enterprise knowledge folder")
     folder.add_argument("folder_id")
     _set_handler(folder, _cmd_enterprise_folder)
 
-    create_folder = commands.add_parser("create-folder", help="Create an enterprise knowledge folder")
-    create_folder.add_argument("name")
-    create_folder.add_argument("--parent-id", default=None)
-    create_folder.add_argument("--description", default=None)
-    _set_handler(create_folder, _cmd_enterprise_create_folder)
-
-    delete_folder = commands.add_parser("delete-folder", help="Delete an enterprise knowledge folder")
-    delete_folder.add_argument("folder_id")
-    _add_enterprise_delete_args(delete_folder)
-    _set_handler(delete_folder, _cmd_enterprise_delete_folder)
-
     folder_bases = commands.add_parser(
         "folder-knowledge-bases",
         help="List knowledge bases in an enterprise folder",
     )
     folder_bases.add_argument("folder_id")
     folder_bases.add_argument("--include-children", action="store_true", default=None)
-    _add_enterprise_types(folder_bases)
-    _add_enterprise_query_args(folder_bases)
+    _add_page_args(folder_bases)
     _set_handler(folder_bases, _cmd_enterprise_folder_knowledge_bases)
 
-    create_base = commands.add_parser("create-knowledge-base", help="Create an enterprise knowledge base")
-    create_base.add_argument("name")
-    create_base.add_argument("--folder-id", default=None)
-    create_base.add_argument("--description", default=None)
-    create_base.add_argument(
-        "--knowledge-type",
-        choices=["STANDARD", "GRAPH", "OBJECT_STORAGE"],
-        default="STANDARD",
-    )
-    _set_handler(create_base, _cmd_enterprise_create_knowledge_base)
-
     knowledge_base = commands.add_parser("knowledge-base", help="Get one enterprise knowledge base")
     knowledge_base.add_argument("source_id")
     _set_handler(knowledge_base, _cmd_enterprise_knowledge_base)
 
-    delete_base = commands.add_parser("delete-knowledge-base", help="Delete an enterprise knowledge base")
-    delete_base.add_argument("source_id")
-    _add_enterprise_delete_args(delete_base)
-    _set_handler(delete_base, _cmd_enterprise_delete_knowledge_base)
-
     documents = commands.add_parser("documents", help="List documents in an enterprise knowledge base")
     documents.add_argument("source_id")
-    documents.add_argument("--status", default=None)
-    documents.add_argument("--document-id", default=None)
     _add_enterprise_query_args(documents)
     _set_handler(documents, _cmd_enterprise_documents)
 
@@ -458,7 +299,7 @@ def _add_enterprise_parser(
 
     chunks = commands.add_parser("document-chunks", help="List chunks for one enterprise knowledge document")
     chunks.add_argument("document_id")
-    _add_enterprise_query_args(chunks)
+    _add_page_args(chunks)
     _set_handler(chunks, _cmd_enterprise_document_chunks)
 
     document_url = commands.add_parser("document-url", help="Get a temporary original document URL")
@@ -466,65 +307,10 @@ def _add_enterprise_parser(
     document_url.add_argument("--download", action="store_true", help="Request download disposition")
     _set_handler(document_url, _cmd_enterprise_document_url)
 
-    delete_documents = commands.add_parser("delete-documents", help="Delete enterprise knowledge documents")
-    delete_documents.add_argument("source_id")
-    delete_documents.add_argument("document_id", nargs="+")
-    delete_documents.add_argument("--operator", default=None)
-    delete_documents.add_argument("--reason", default=None)
-    delete_documents.add_argument("--confirm", action="store_true", required=True)
-    _set_handler(delete_documents, _cmd_enterprise_delete_documents)
-
-    upload_document = commands.add_parser("upload-document", help="Upload a document asynchronously")
-    upload_document.add_argument("source_id")
-    upload_document.add_argument("file")
-    upload_document.add_argument("--file-name", default=None)
-    upload_document.add_argument("--content-type", default=None)
-    upload_document.add_argument("--chunked", action="store_true", help="Use resumable chunked upload")
-    upload_document.add_argument(
-        "--chunk-size",
-        type=int,
-        default=enterprise_knowledge.DEFAULT_CHUNK_SIZE,
-        help="Chunk size in bytes; valid range is 5 MiB to 100 MiB",
-    )
-    _set_handler(upload_document, _cmd_enterprise_upload_document)
-
-    object_contract = commands.add_parser("object-contract", help="Get object-storage capability contract")
-    _set_handler(object_contract, _cmd_enterprise_object_contract)
-
-    objects = commands.add_parser("objects", help="Query objects in an object-storage knowledge base")
-    objects.add_argument("source_id")
-    objects.add_argument("--prefix", default=None)
-    _add_enterprise_query_args(objects)
-    _set_handler(objects, _cmd_enterprise_objects)
-
-    upload_objects = commands.add_parser("upload-objects", help="Upload files to an object-storage knowledge base")
-    upload_objects.add_argument("source_id")
-    upload_objects.add_argument("file", nargs="+")
-    upload_objects.add_argument("--object-key", action="append", default=None)
-    upload_objects.add_argument("--prefix", default=None)
-    upload_objects.add_argument("--metadata", default=None, help="JSON object applied to this upload")
-    _set_handler(upload_objects, _cmd_enterprise_upload_objects)
-
-    object_detail = commands.add_parser("object", help="Get object metadata")
-    object_detail.add_argument("source_id")
-    object_detail.add_argument("object_key")
-    _set_handler(object_detail, _cmd_enterprise_object)
-
-    object_url = commands.add_parser("object-url", help="Get a temporary object URL")
-    object_url.add_argument("source_id")
-    object_url.add_argument("object_key")
-    object_url.add_argument("--inline", action="store_true", help="Request inline display disposition")
-    _set_handler(object_url, _cmd_enterprise_object_url)
-
-    delete_object = commands.add_parser("delete-object", help="Delete one object")
-    delete_object.add_argument("source_id")
-    delete_object.add_argument("object_key")
-    delete_object.add_argument("--confirm", action="store_true", required=True)
-    _set_handler(delete_object, _cmd_enterprise_delete_object)
-
-    object_task = commands.add_parser("object-task", help="Get one object upload task")
-    object_task.add_argument("task_id")
-    _set_handler(object_task, _cmd_enterprise_object_task)
+    download_link = commands.add_parser("document-download-link", help="Get a temporary document download link")
+    download_link.add_argument("document_id")
+    _set_handler(download_link, _cmd_enterprise_document_download_link)
+
 
 
 def add_knowledge_parser(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:

{licos_platform_cli-0.4.12 → licos_platform_cli-0.5.1}/src/licos_platform_cli/main.py

@@ -14,6 +14,7 @@ from .oauth_commands import add_oauth_parser
 from .ontology_commands import add_ontology_parser
 from .project_config_commands import add_project_config_parser
 from .storage_commands import add_storage_parser
+from .user_commands import add_user_parser
 
 
 def _print_json(value: Any) -> None:
@@ -38,6 +39,7 @@ def _build_parser() -> argparse.ArgumentParser:
     add_oauth_parser(subparsers)
     add_project_config_parser(subparsers)
     add_ontology_parser(subparsers)
+    add_user_parser(subparsers)
     return parser
 
 

licos_platform_cli-0.5.1/src/licos_platform_cli/user_commands.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import argparse
+import sys
+
+from licos_platform_sdk import get_current_user
+
+
+USER_HELP = {
+    "topic": "user",
+    "description": "查询当前执行使用者，返回与低代码 sys_user 相同的用户、企业和组织任职信息。",
+    "runtime": [
+        {"name": "LICOS_PLATFORM_API_BASE_URL", "description": "平台 API 地址。"},
+        {"name": "LICOS_AI_AGENT_TOKEN", "description": "运行时内部服务凭证，不输出。"},
+        {"name": "LICOS_CURRENT_USER_ID", "description": "未通过标准输入传 Token 时，必须由可信运行时注入的当前用户 ID。"},
+        {"name": "LICOS_WORKSPACE_ID / LICOS_OWNER_WORKSPACE_ID / AGENT_WORKSPACE_ID", "description": "执行工作空间，决定企业范围。"},
+    ],
+    "rules": [
+        "多用户请求传当前使用者 Token；不使用项目所有者代替使用者。",
+        "企业范围按执行工作空间确定，个人或企业外使用者的空组织信息原样返回。",
+        "不缓存结果，不回显 Token；Token 失效直接报错。",
+    ],
+    "sdk": {
+        "python": "from licos_platform_sdk import get_current_user\nsys_user = get_current_user(user_token=token)",
+        "node": "import { getCurrentUser } from '@kmlckj/licos-platform-sdk';\nconst sysUser = await getCurrentUser({ userToken: token });",
+    },
+    "commands": {
+        "me": {
+            "description": "查询当前使用者信息。",
+            "parameters": [
+                {"name": "--token-stdin", "type": "boolean", "required": False, "description": "从标准输入读取当前用户 Token，不含 Bearer 前缀；不通过命令行参数暴露 Token。"},
+                {"name": "--workspace-id", "type": "string", "required": False, "description": "执行工作空间 ID；省略时由项目运行时获取。"},
+            ],
+            "returns": "sys_user 对象：id、username、displayName、avatarUrl、tenantId、tenantName、primaryDepartment、departments、organizationAssignments、primaryPosition、primaryJobTitle。",
+            "example": "licos-platform user me",
+        },
+    },
+}
+
+
+def _me(args: argparse.Namespace):
+    return get_current_user(
+        user_token=sys.stdin.read().strip() if args.token_stdin else None,
+        workspace_id=args.workspace_id,
+    )
+
+
+def add_user_parser(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("user", help="当前使用者及企业组织信息")
+    commands = parser.add_subparsers(dest="user_command", required=True)
+    me = commands.add_parser("me", help="返回与低代码 sys_user 相同的当前用户信息")
+    me.add_argument("--token-stdin", action="store_true", help="从标准输入读取当前使用者 Token")
+    me.add_argument("--workspace-id", help="执行工作空间 ID；默认读取运行时环境")
+    me.set_defaults(handler=_me)

{licos_platform_cli-0.4.12 → licos_platform_cli-0.5.1}/tests/test_cli.py

@@ -36,6 +36,25 @@ def run_cli(*args: str) -> tuple[int, str, str]:
 
 
 class PlatformCliTests(unittest.TestCase):
+    def test_enterprise_help_matches_removed_management_commands(self) -> None:
+        code, output, _ = run_cli("help", "knowledge")
+        self.assertEqual(code, 0)
+        commands = json.loads(output)["commands"]
+        self.assertIn("enterprise-document-download-link", commands)
+        for name in ("create-folder", "upload-document", "delete-documents", "objects"):
+            self.assertNotIn("enterprise-" + name, commands)
+            code, _, error = run_cli("knowledge", "enterprise", name)
+            self.assertEqual(code, 2)
+            self.assertIn("invalid choice", error)
+
+    def test_enterprise_download_link_uses_current_sdk(self) -> None:
+        link = {"documentId": "doc-1", "downloadUrl": "https://files.example/manual.pdf"}
+        with mock.patch.object(knowledge_commands.enterprise_knowledge, "document_download_link", return_value=link) as download:
+            code, output, _ = run_cli("knowledge", "enterprise", "document-download-link", "doc-1")
+        self.assertEqual(code, 0)
+        self.assertEqual(json.loads(output), link)
+        download.assert_called_once_with("doc-1")
+
     def test_help_exposes_storage_commands(self) -> None:
         stdout = io.StringIO()
         with self.assertRaises(SystemExit) as caught, redirect_stdout(stdout):
@@ -61,6 +80,7 @@ class PlatformCliTests(unittest.TestCase):
                 "ontology",
                 "project-config",
                 "storage",
+                "user",
             ],
         )
         self.assertIn("licos-platform help storage", payload["usage"])
@@ -671,88 +691,16 @@ class PlatformCliTests(unittest.TestCase):
         self.assertEqual(json.loads(stdout), {"status": "KNOWLEDGE_TREE_READY"})
         tree.assert_called_once_with(include_types=["STANDARD", "GRAPH"])
 
-    def test_enterprise_knowledge_create_base_forwards_typed_contract(self) -> None:
-        with mock.patch.object(
-            knowledge_commands.enterprise_knowledge,
-            "create_knowledge_base",
-            return_value={"source_id": "source-1"},
-        ) as create:
-            code, stdout, stderr = run_cli(
-                "knowledge",
-                "enterprise",
-                "create-knowledge-base",
-                "设备手册",
-                "--folder-id",
-                "folder-1",
-                "--description",
-                "设备维护说明",
-                "--knowledge-type",
-                "STANDARD",
-            )
-
-        self.assertEqual(code, 0)
-        self.assertEqual(stderr, "")
-        self.assertEqual(json.loads(stdout), {"source_id": "source-1"})
-        create.assert_called_once_with(
-            "设备手册",
-            folder_id="folder-1",
-            description="设备维护说明",
-            knowledge_type="STANDARD",
-        )
-
-    def test_enterprise_knowledge_chunked_upload_forwards_file_options(self) -> None:
-        with mock.patch.object(
-            knowledge_commands.enterprise_knowledge,
-            "upload_document_chunked",
-            return_value={"task_id": "task-1"},
-        ) as upload:
-            code, stdout, stderr = run_cli(
-                "knowledge",
-                "enterprise",
-                "upload-document",
-                "source-1",
-                "manual.pdf",
-                "--file-name",
-                "设备手册.pdf",
-                "--content-type",
-                "application/pdf",
-                "--chunked",
-                "--chunk-size",
-                str(8 * 1024 * 1024),
-            )
-
-        self.assertEqual(code, 0)
-        self.assertEqual(stderr, "")
-        self.assertEqual(json.loads(stdout), {"task_id": "task-1"})
-        upload.assert_called_once_with(
-            "source-1",
-            "manual.pdf",
-            file_name="设备手册.pdf",
-            content_type="application/pdf",
-            chunk_size=8 * 1024 * 1024,
-        )
-
-    def test_enterprise_knowledge_delete_requires_explicit_confirmation(self) -> None:
-        code, stdout, stderr = run_cli(
-            "knowledge",
-            "enterprise",
-            "delete-knowledge-base",
-            "source-1",
-        )
-
-        self.assertEqual(code, 2)
-        self.assertEqual(stdout, "")
-        self.assertIn("--confirm", stderr)
 
     def test_structured_help_describes_enterprise_knowledge_contract(self) -> None:
-        code, stdout, stderr = run_cli("help", "knowledge", "enterprise-upload-document")
+        code, stdout, stderr = run_cli("help", "knowledge", "enterprise-documents")
 
         self.assertEqual(code, 0)
         self.assertEqual(stderr, "")
         payload = json.loads(stdout)
         self.assertEqual(payload["topic"], "knowledge")
-        self.assertEqual(payload["command"], "enterprise-upload-document")
-        self.assertIn("--chunk-size", [item["name"] for item in payload["parameters"]])
+        self.assertEqual(payload["command"], "enterprise-documents")
+        self.assertIn("--query", [item["name"] for item in payload["parameters"]])
 
 
 if __name__ == "__main__":

licos_platform_cli-0.5.1/tests/test_user.py

@@ -0,0 +1,60 @@
+import io
+import json
+import os
+import sys
+import unittest
+from contextlib import redirect_stdout, redirect_stderr
+from pathlib import Path
+from unittest.mock import patch
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[2] / "licos-platform-sdk/src"))
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+from licos_platform_cli import main, user_commands
+
+
+class UserCliTests(unittest.TestCase):
+    def run_cli(self, *args):
+        out, err = io.StringIO(), io.StringIO()
+        with redirect_stdout(out), redirect_stderr(err):
+            code = main.main(args)
+        return code, out.getvalue(), err.getvalue()
+
+    def test_me_outputs_sdk_json_with_chinese(self):
+        with patch.object(user_commands, "get_current_user", return_value={"id": "caller", "displayName": "张三"}) as sdk:
+            code, out, err = self.run_cli("user", "me")
+        self.assertEqual(code, 0)
+        self.assertEqual(err, "")
+        self.assertEqual(json.loads(out), {"id": "caller", "displayName": "张三"})
+        self.assertIn("张三", out)
+        sdk.assert_called_once_with(user_token=None, workspace_id=None)
+
+    def test_stdin_token_is_forwarded_without_echo(self):
+        with patch("sys.stdin", io.StringIO("request-secret\n")), patch.object(
+            user_commands, "get_current_user", return_value={"id": "caller"},
+        ) as sdk:
+            code, out, err = self.run_cli("user", "me", "--token-stdin", "--workspace-id", "space")
+        self.assertEqual(code, 0)
+        self.assertNotIn("request-secret", out + err)
+        sdk.assert_called_once_with(user_token="request-secret", workspace_id="space")
+
+    def test_empty_stdin_fails_in_sdk_without_identity_fallback(self):
+        with patch("sys.stdin", io.StringIO(" \n")), patch.dict(os.environ, {
+            "LICOS_PLATFORM_API_BASE_URL": "https://platform.example", "LICOS_AI_AGENT_TOKEN": "secret",
+            "LICOS_CURRENT_USER_ID": "injected-user", "LICOS_OWNER_USER_ID": "owner",
+        }, clear=True):
+            code, out, err = self.run_cli("user", "me", "--token-stdin")
+        self.assertEqual(code, 1)
+        self.assertEqual(out, "")
+        self.assertIn("不能为空", err)
+
+    def test_structured_help_exposes_command_and_sdk(self):
+        code, out, err = self.run_cli("help", "user")
+        self.assertEqual(code, 0)
+        self.assertEqual(err, "")
+        help_data = json.loads(out)
+        self.assertIn("me", help_data["commands"])
+        self.assertIn("get_current_user", help_data["sdk"]["python"])
+        self.assertIn("getCurrentUser", help_data["sdk"]["node"])
+
+
+if __name__ == "__main__": unittest.main()

licos_platform_cli-0.4.12/PKG-INFO

@@ -1,6 +0,0 @@
-Metadata-Version: 2.5
-Name: licos-platform-cli
-Version: 0.4.12
-Summary: LICOS platform CLI
-Requires-Python: >=3.10
-Requires-Dist: licos-platform-sdk>=0.5.9