@kmlckj/licos-ai-cli 1.7.25 → 1.8.0

package/lib/__templates__/agent/SDK.md

@@ -1,39 +1,43 @@
-# 查阅项目实际使用的 SDK
-
-功能说明、API、配置字段、默认值和限制统一查 SDK 文档，按任务读取，不复制进本项目规则或业务提示词。
-
-## 1. 确认项目解释器
-
-先看 scripts/runtime.sh：显式 PYTHON_BIN 优先；否则项目有 .venv 时用 .venv/bin/python；没有时用当前运行环境的 python。不要用全局环境替代项目环境。
-
-以下命令以项目虚拟环境为例，按实际解释器替换命令开头：
-
-```bash
-.venv/bin/python -c 'from importlib.metadata import version; from importlib.resources import files; print(version("licos-agent-runtime")); print(files("licos_agent_runtime").joinpath("docs"))'
-```
-
-## 2. 先读索引，再读相关主题
-
-打开上一步目录中的 index.md，按本次需求选择文档。索引包括配置、Loop/Graph 扩展、状态与多智能体、文件技能、数据库准备、运行协议和验收。只读相关章节，再按真实签名实现。
-
-也可以直接打印索引：
-
-```bash
-.venv/bin/python -c 'from importlib.resources import files; print(files("licos_agent_runtime").joinpath("docs/index.md").read_text(encoding="utf-8"))'
-```
-
-其他依赖 SDK 同样查对应包的实际版本、文档和签名。包内资源可通过 importlib.resources 定位，包描述可通过 importlib.metadata.metadata 查看，不猜 site-packages 路径。
-
-## 3. 跨项目接入文档
-
-跨项目调用智能体、工作流或向网页持续交付结果时，先读 Runtime 包内 `docs/project-integration.md`。Platform SDK 完整接口文档通过实际解释器定位：
-
-```bash
-.venv/bin/python -c 'from importlib.metadata import version; from importlib.resources import files; print(version("licos-platform-sdk")); print(files("licos_platform_sdk").joinpath("docs/project-runtime.md"))'
-```
-
-## 4. 老项目兼容
-
-老版本没有索引时列出其实际文档、查看包描述及源码签名，不从另一版本复制 API。确需新能力时按 [UPGRADING.md](UPGRADING.md) 制定升级与验收步骤；不因查文档自动升级。
-
-[README.md](README.md) 介绍项目结构；[examples/README.md](examples/README.md) 介绍模板示例接入；[DATABASE.md](DATABASE.md) 记录持久化准备；AGENTS.md 记录本项目已实现内容和用户决定。
+# 查阅项目实际使用的 SDK
+
+功能说明、API、配置字段、默认值和限制统一查 SDK 文档，按任务读取，不复制进本项目规则或业务提示词。
+
+## 1. 确认项目解释器
+
+先看 scripts/runtime.sh：显式 PYTHON_BIN 优先；否则项目有 .venv 时用 .venv/bin/python；没有时用当前运行环境的 python。不要用全局环境替代项目环境。
+
+以下命令以项目虚拟环境为例，按实际解释器替换命令开头：
+
+```bash
+.venv/bin/python -c 'from importlib.metadata import version; from importlib.resources import files; print(version("licos-agent-runtime")); print(files("licos_agent_runtime").joinpath("docs"))'
+```
+
+## 2. 先读索引，再读相关主题
+
+打开上一步目录中的 index.md，按本次需求选择文档。索引包括配置、Loop/Graph 扩展、状态与多智能体、文件技能、数据库准备、运行协议和验收。只读相关章节，再按真实签名实现。
+
+也可以直接打印索引：
+
+```bash
+.venv/bin/python -c 'from importlib.resources import files; print(files("licos_agent_runtime").joinpath("docs/index.md").read_text(encoding="utf-8"))'
+```
+
+其他依赖 SDK 同样查对应包的实际版本、文档和签名。包内资源可通过 importlib.resources 定位，包描述可通过 importlib.metadata.metadata 查看，不猜 site-packages 路径。
+
+## 3. 跨项目接入文档
+
+跨项目调用智能体、工作流或向网页持续交付结果时，先读 Runtime 包内 `docs/project-integration.md`。Platform SDK 完整接口文档通过实际解释器定位：
+
+```bash
+.venv/bin/python -c 'from importlib.metadata import version; from importlib.resources import files; print(version("licos-platform-sdk")); print(files("licos_platform_sdk").joinpath("docs/project-runtime.md"))'
+```
+
+## 4. 老项目兼容
+
+老版本没有索引时列出其实际文档、查看包描述及源码签名，不从另一版本复制 API。确需新能力时按 [UPGRADING.md](UPGRADING.md) 制定升级与验收步骤；不因查文档自动升级。
+
+[README.md](README.md) 介绍项目结构；[examples/README.md](examples/README.md) 介绍模板示例接入；[DATABASE.md](DATABASE.md) 记录持久化准备；AGENTS.md 记录本项目已实现内容和用户决定。
+
+## 通用模型服务
+
+使用时序、表格等全局模型时，查实际安装 `licos-dev-sdk` 的 `docs/model-services.md`，通过 `ModelServiceClient` 读取模型输入输出定义再调用。外部模型授权由平台配置。

package/lib/__templates__/agent/UPGRADING.md

@@ -5,7 +5,7 @@
 ## 1. 记录基线与实际版本
 
 - 读取项目 `AGENTS.md`、入口、业务工具、模型配置、认证配置、事件订阅、依赖及锁文件，记录当前可用接口和真实业务用例。
-- 使用 `scripts/runtime.sh` 所选的项目解释器检查安装包版本，不能用其他全局 Python 环境的版本代替。当前模板依赖为 Runtime >=0.6.31、Platform SDK >=0.9.8、Dev SDK >=0.6.15，Python >=3.11；以项目的依赖声明、锁文件和实际安装结果为准。
+- 使用 `scripts/runtime.sh` 所选的项目解释器检查安装包版本，不能用其他全局 Python 环境的版本代替。当前模板依赖为 Runtime >=0.6.32、Platform SDK >=0.9.8、Dev SDK >=0.6.15，Python >=3.11；以项目的依赖声明、锁文件和实际安装结果为准。
 - 更新 `requirements.txt`、`pyproject.toml` 及项目实际使用的锁文件，保留原有业务依赖。在项目环境安装并检查依赖；不要把“修改了版本声明”当成“预览或部署已升级”。
 - 修改前保留可回退的源码版本，核对部署配置和数据库 Schema。不要将用户凭证保存进备份、源码或日志。
 

package/lib/__templates__/agent/pyproject.toml

@@ -1,15 +1,15 @@
-[project]
-name = "<%= appName %>"
-version = "0.1.0"
-description = "LICOS LangGraph agent project"
-requires-python = ">=3.11"
-dependencies = [
-    "licos-agent-runtime>=0.6.31",
-    "licos-platform-sdk>=0.9.8",
-    "licos-dev-sdk>=0.6.15",
-]
-
-[tool.uv]
-[[tool.uv.index]]
-url = "https://mirrors.aliyun.com/pypi/simple/"
-default = true
+[project]
+name = "<%= appName %>"
+version = "0.1.0"
+description = "LICOS LangGraph agent project"
+requires-python = ">=3.11"
+dependencies = [
+    "licos-agent-runtime>=0.6.33",
+    "licos-platform-sdk>=0.9.8",
+    "licos-dev-sdk>=0.7.0",
+]
+
+[tool.uv]
+[[tool.uv.index]]
+url = "https://mirrors.aliyun.com/pypi/simple/"
+default = true

package/lib/__templates__/agent/requirements.txt

@@ -1,3 +1,3 @@
-licos-agent-runtime>=0.6.31
-licos-platform-sdk>=0.9.8
-licos-dev-sdk>=0.6.15
+licos-agent-runtime>=0.6.33
+licos-platform-sdk>=0.9.8
+licos-dev-sdk>=0.7.0