@kmlckj/licos-ai-cli 1.8.4 → 1.8.6

package/lib/__templates__/workflow/AGENTS.md

@@ -1,6 +1,6 @@
 # 项目上下文
 
-功能用法查 [SDK.md](SDK.md)，结构与接入见 [README.md](README.md)。本文件只记录当前项目事实。
+功能用法查 项目实际安装版本的 SDK 文档，结构与接入见 [README.md](README.md)。本文件只记录当前项目事实。
 
 ## 当前项目
 

package/lib/__templates__/workflow/DATABASE.md

@@ -1,6 +1,6 @@
 # 工作流持久化接入
 
-用户明确要求保存执行状态、跨重启恢复或持久化等待时，先查 [SDK.md](SDK.md) 中当前版本的工作流协议。工作流与智能体有各自配置和存储契约，不能直接复制对方的配置或 SQL。
+用户明确要求保存执行状态、跨重启恢复或持久化等待时，先查 项目实际安装版本的 SDK 文档 中当前版本的工作流协议。工作流与智能体有各自配置和存储契约，不能直接复制对方的配置或 SQL。
 
 1. 记录用户需求和保存方式，核对当前项目、环境、已有 Schema 与迁移历史。
 2. 阅读 SDK docs/workflow-runtime.md 的表、执行权、检查点和信号约束，根据本项目所需功能编写独立版本化 SQL。

package/lib/__templates__/workflow/README.md

@@ -4,7 +4,6 @@ LICOS 编程工作流项目，基于 Python、LangGraph 和 licos-agent-runtime
 
 ## 文档入口
 
-- [SDK.md](SDK.md)：按项目实际版本查功能、API、配置和限制。
 - [AGENTS.md](AGENTS.md)：本项目真实业务、节点索引、用户选择和验收记录。
 - [DATABASE.md](DATABASE.md)：用户选择持久化后的接入步骤。
 - [UPGRADING.md](UPGRADING.md)：已有项目兼容和升级步骤。
@@ -29,7 +28,7 @@ pyproject.toml
 模板输入为 topic 字符串，输出为 answer 字符串，仅演示图执行，不调用模型或外部系统。持久化与等待均未开启。
 
 1. 先读项目说明、实际图和依赖，确定业务输入输出与成功标准。
-2. 按 SDK.md 查对应版本的工作流说明，选择节点和配置，保留已有业务、身份及稳定入口。
+2. 查对应版本的工作流说明，选择节点和配置，保留已有业务、身份及稳定入口。
 3. 新增节点时同步 Schema、图中注册与连线、metadata、配置和 AGENTS.md；不要把真实业务输入输出简化为空。
 4. 按实际图输入构造用例，复用 Preview 验证参数、画布和运行结果。功能用法不在本 README 另维护。
 

package/lib/__templates__/workflow/UPGRADING.md

@@ -3,7 +3,7 @@
 默认保持原版本；需要新能力时再制定升级方案。不要重新初始化覆盖业务图、登录、配置或数据。
 
 1. 记录实际包版本、依赖/锁文件、入口、节点、Schema、外部接口和已启用保存方式。
-2. 按 [SDK.md](SDK.md) 比对版本能力，保留原运行接口和业务输入输出；缺少新接口的旧项目继续原功能，鉴权或服务错误不能当作“不支持”忽略。
+2. 按 项目实际安装版本的 SDK 文档 比对版本能力，保留原运行接口和业务输入输出；缺少新接口的旧项目继续原功能，鉴权或服务错误不能当作“不支持”忽略。
 3. 合并必要改动，保持节点 ID、类型、路由和原用户授权。图或状态变化要处理旧检查点与未完成实例，不能只改版本号后重跑外部操作。
 4. 持久化变更按 [DATABASE.md](DATABASE.md) 检查并显式迁移，不自动开启或清空数据库。
 5. 在实际项目解释器和 Preview 中核对参数、画布、真实业务结果及本次新增能力；需要重启恢复时实际验证。

package/lib/__templates__/workflow/examples/wait_signal.md

@@ -1,6 +1,6 @@
 # 人工处理与设备回执节点示例
 
-此示例仅用于用户明确要求持久化等待的项目。先按 [SDK.md](../SDK.md) 的工作流文档，为**该项目**启用 `durability`、`signals` 和项目数据库迁移。示例中的外部接口应替换为项目真实的 WMS/MES/PLC 接口。
+此示例仅用于用户明确要求持久化等待的项目。先按 项目实际安装版本的 SDK 文档 的工作流文档，为**该项目**启用 `durability`、`signals` 和项目数据库迁移。示例中的外部接口应替换为项目真实的 WMS/MES/PLC 接口。
 
 ```python
 from uuid import NAMESPACE_URL, uuid5

package/lib/__templates__/workflow/pyproject.toml

@@ -4,9 +4,9 @@ version = "0.1.0"
 description = "LICOS LangGraph workflow project"
 requires-python = ">=3.12"
 dependencies = [
-    "licos-agent-runtime>=0.6.36",
-    "licos-platform-sdk>=0.9.8",
-    "licos-dev-sdk>=0.7.3",
+    "licos-agent-runtime>=0.6.38",
+    "licos-platform-sdk>=0.9.9",
+    "licos-dev-sdk>=0.7.4",
 ]
 
 [tool.uv]

package/lib/__templates__/workflow/requirements.txt

@@ -1,3 +1,3 @@
-licos-agent-runtime>=0.6.36
-licos-platform-sdk>=0.9.8
-licos-dev-sdk>=0.7.3
+licos-agent-runtime>=0.6.38
+licos-platform-sdk>=0.9.9
+licos-dev-sdk>=0.7.4

package/lib/__templates__/workflow/template.config.js

@@ -1,7 +1,6 @@
 const description = `Workflow（工作流项目）：\`licos init \${LICOS_PROJECT_PATH} --template workflow\`
 - 适用：Python + LangGraph 工作流项目
 - README.md 说明结构与接入，AGENTS.md 记录项目实际实现和用户选择
-- 功能、API、配置及限制按 SDK.md 查当前安装版本文档，不复制功能全集
 - DATABASE.md 与 UPGRADING.md 分别说明持久化准备和已有项目升级`;
 
 const config = {
@@ -39,7 +38,6 @@ const config = {
     console.log('\nConfiguration:');
     console.log('  - Runtime: licos-agent-runtime');
     console.log('  - Framework: LangGraph');
-    console.log('  - SDK documentation for the installed version: SDK.md');
     console.log(`  - Port: ${_context.port}`);
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmlckj/licos-ai-cli",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
   "license": "MIT",
   "author": "kmlckj",

package/lib/__templates__/agent/SDK.md

@@ -1,43 +0,0 @@
-# 查阅项目实际使用的 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__/nextjs/SDK.md

@@ -1,19 +0,0 @@
-# 查阅当前项目的 SDK
-
-平台功能、方法、参数和限制以项目实际安装包文档为准；此文件记录查阅与接入位置。
-
-先检查本项目 package.json 和锁文件。安装完成后，在项目根目录执行：
-
-```sh
-node --input-type=module -e 'import { fileURLToPath } from "node:url"; console.log(fileURLToPath(new URL("./docs/project-runtime.md", import.meta.resolve("@kmlckj/licos-platform-sdk"))))'
-```
-
-同目录的 `project-runtime-api.md` 列出完整接口。旧包不存在该文档时查实际安装包的 README 与声明文件，说明能力差异，不静默升级。
-
-服务端接入放在 `src/app/api/` 路由或 `src/lib/` 的服务端模块；浏览器组件放在 `src/components/`。
-
-接入步骤与协议见上述 SDK 文档；开发约束沿用项目规则。这里只维护本模板的目录与文档入口。
-
-## 通用模型服务
-
-全局模型目录、输入输出定义和调用使用服务端 `@kmlckj/licos-dev-sdk` 的 `ModelServiceClient`，查实际安装包 README 和类型声明。浏览器通过项目自身后端调用，外部模型授权由平台配置。

package/lib/__templates__/nuxt-vue/SDK.md

@@ -1,19 +0,0 @@
-# 查阅当前项目的 SDK
-
-平台功能、方法、参数和限制以项目实际安装包文档为准；此文件记录查阅与接入位置。
-
-先检查本项目 package.json 和锁文件。安装完成后，在项目根目录执行：
-
-```sh
-node --input-type=module -e 'import { fileURLToPath } from "node:url"; console.log(fileURLToPath(new URL("./docs/project-runtime.md", import.meta.resolve("@kmlckj/licos-platform-sdk"))))'
-```
-
-同目录的 `project-runtime-api.md` 列出完整接口。旧包不存在该文档时查实际安装包的 README 与声明文件，说明能力差异，不静默升级。
-
-服务端接入放在 `server/api/` 与 `server/` 模块；浏览器页面与组件使用当前 Nuxt 目录结构。
-
-接入步骤与协议见上述 SDK 文档；开发约束沿用项目规则。这里只维护本模板的目录与文档入口。
-
-## 通用模型服务
-
-全局模型目录、输入输出定义和调用使用服务端 `@kmlckj/licos-dev-sdk` 的 `ModelServiceClient`，查实际安装包 README 和类型声明。浏览器通过项目自身后端调用，外部模型授权由平台配置。

package/lib/__templates__/vite/SDK.md

@@ -1,19 +0,0 @@
-# 查阅当前项目的 SDK
-
-平台功能、方法、参数和限制以项目实际安装包文档为准；此文件记录查阅与接入位置。
-
-先检查本项目 package.json 和锁文件。安装完成后，在项目根目录执行：
-
-```sh
-node --input-type=module -e 'import { fileURLToPath } from "node:url"; console.log(fileURLToPath(new URL("./docs/project-runtime.md", import.meta.resolve("@kmlckj/licos-platform-sdk"))))'
-```
-
-同目录的 `project-runtime-api.md` 列出完整接口。旧包不存在该文档时查实际安装包的 README 与声明文件，说明能力差异，不静默升级。
-
-服务端接入放在 `server/`，浏览器代码放在 `src/`。保留模板的代理和子路径配置。
-
-接入步骤与协议见上述 SDK 文档；开发约束沿用项目规则。这里只维护本模板的目录与文档入口。
-
-## 通用模型服务
-
-全局模型目录、输入输出定义和调用使用服务端 `@kmlckj/licos-dev-sdk` 的 `ModelServiceClient`，查实际安装包 README 和类型声明。浏览器通过项目自身后端调用，外部模型授权由平台配置。

package/lib/__templates__/workflow/SDK.md

@@ -1,43 +0,0 @@
-# 查阅项目实际使用的 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，按本次需求选择文档。索引区分智能体、编程工作流和公共接口；工作流先读 workflow-authoring.md 与 workflow-runtime.md。只读相关章节，再按真实签名实现。
-
-也可以直接打印索引：
-
-```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/wait_signal.md) 介绍模板示例接入；[DATABASE.md](DATABASE.md) 记录持久化准备；AGENTS.md 记录本项目已实现内容和用户决定。
-
-## 通用模型服务
-
-使用时序、表格等全局模型时，查实际安装 `licos-dev-sdk` 的 `docs/model-services.md`，通过 `ModelServiceClient` 读取模型输入输出定义再调用。外部模型授权由平台配置。