@kmlckj/licos-ai-cli 1.5.0 → 1.6.0

package/lib/__templates__/workflow/AGENTS.md

@@ -1,39 +1,48 @@
-# 项目上下文
-
-## 技术栈
-
-- **项目类型**: WORKFLOW
-- **运行时**: Python + LangGraph + licos-agent-runtime
-- **入口**: `src/graphs/graph.py`
-
-## 目录结构
-
-```text
-├── config/
-├── scripts/
-├── src/
-│   ├── main.py
-│   └── graphs/
-│       ├── graph.py
-│       ├── state.py
-│       └── nodes/
-└── AGENTS.md
-```
-
-## 项目说明
-
-本文件用于记录用户项目可维护的长期上下文，例如业务目标、节点清单、外部 API 约定、输入输出样例、测试方式和后续注意事项。
-
-维护规则：
-
-- `AGENTS.md` 只是项目索引，输入输出样例必须跟随 `src/graphs/state.py` 和节点实现更新。
-- 工作流存在真实业务节点时，不要把输入输出写成 `{}`，除非它确实没有外部输入也没有返回结果。
-- 涉及文件输入/输出时，schema 使用文件对象字段，例如 `url`、`file_type`、`content`、`name`。节点生成文件时优先写入 `assets/`，并在输出中返回 `/assets/<文件名>`、`assets/<文件名>` 或本地文件路径。运行时会自动把输出文件发布到 Studio 对象存储并补齐签名 URL、`download_url`、`file_id`、`expires_at` 等字段。
-- 不要在节点代码里手写 workspace-file-service 公共 URL、MinIO URL、签名参数或平台文件服务路径；部署后的工作流没有开发态文件服务，文件发布交给运行时统一处理。
-- 如果文档与源码 schema 冲突，应修正文档，不要为了匹配文档清空 `GraphInput` / `GraphOutput`。
-- 可视化条件节点必须在 `graph.py` 的 `add_node(..., metadata={...})` 中保存 `definition.branches`；`branches[].id` 与路由函数返回值一致，`branches[].target` 与 `add_conditional_edges(..., path_map=...)` 目标一致。条件节点函数只透传状态，不要把路由函数同时作为节点函数。
-- 根据画布 QueryDiff 修改已有 Action 节点时，必须以 QueryDiff 的 `node.id` 为准更新同一个节点的 metadata、状态字段和实现文件；只有 QueryDiff 明确是新增节点且用户明确要增加业务步骤时才新增节点。
+# 项目上下文
+
+## 技术栈
+
+- **项目类型**: WORKFLOW
+- **运行时**: Python + LangGraph + licos-agent-runtime
+- **入口**: `src/graphs/graph.py`
+
+## 目录结构
+
+```text
+├── config/
+├── scripts/
+├── src/
+│   ├── main.py
+│   └── graphs/
+│       ├── graph.py
+│       ├── state.py
+│       └── nodes/
+└── AGENTS.md
+```
+
+## 项目说明
+
+本文件用于记录用户项目可维护的长期上下文，例如业务目标、节点清单、外部 API 约定、输入输出样例、测试方式和后续注意事项。
+
+维护规则：
+
+- `AGENTS.md` 只是项目索引，输入输出样例必须跟随 `src/graphs/state.py` 和节点实现更新。
+- 工作流存在真实业务节点时，不要把输入输出写成 `{}`，除非它确实没有外部输入也没有返回结果。
+- 涉及文件输入/输出时，schema 使用文件对象字段，例如 `url`、`file_type`、`content`、`name`。节点生成文件时优先写入 `assets/`，并在输出中返回 `/assets/<文件名>`、`assets/<文件名>` 或本地文件路径。运行时会自动把输出文件发布到 Studio 对象存储并补齐签名 URL、`download_url`、`file_id`、`expires_at` 等字段。
+- 不要在节点代码里手写 workspace-file-service 公共 URL、MinIO URL、签名参数或平台文件服务路径；部署后的工作流没有开发态文件服务，文件发布交给运行时统一处理。
+- 如果文档与源码 schema 冲突，应修正文档，不要为了匹配文档清空 `GraphInput` / `GraphOutput`。
+- 可视化条件节点必须在 `graph.py` 的 `add_node(..., metadata={...})` 中保存 `definition.branches`；`branches[].id` 与路由函数返回值一致，`branches[].target` 与 `add_conditional_edges(..., path_map=...)` 目标一致。条件节点函数只透传状态，不要把路由函数同时作为节点函数。
+- 根据画布 QueryDiff 修改已有 Action 节点时，必须以 QueryDiff 的 `node.id` 为准更新同一个节点的 metadata、状态字段和实现文件；只有 QueryDiff 明确是新增节点且用户明确要增加业务步骤时才新增节点。
 - 禁止保留默认标题“请填写动作内容”作为最终节点标题；Action 节点标题必须稳定、可读并表达业务含义，已有节点的 ID 不能因为标题或内容调整而改变。
 - 默认不创建持久化配置、迁移文件或检查点表。只有用户明确要求本项目断点续跑时，才按 README 中的运行时契约在本项目生成版本化 SQL 迁移，核对目标项目与环境并执行、加入 `config/workflow-runtime.json`，并检查图编译时使用 `workflow_checkpointer()`。
 - 只有用户明确要求人工处理或异步设备回执时，才在本项目启用 `signals.enabled` 并生成 README 指定的增量迁移；普通项目不加等待表或字段。人工和回执共用 `/workflow/instances/{instance_id}/signals`，`/resume` 只处理执行失败。设备下发与等待回执必须分为两个节点，采用稳定 `wait_id` 和外部幂等键；参见 `examples/wait_signal.md`。
 - 有副作用的业务节点在恢复后可能再次执行。写入外部系统必须使用由工作流实例 ID、稳定节点 ID 和业务操作号组成的幂等键；对没有幂等能力的系统，先查询原操作结果，状态不明时停止并交给业务规则处理，不自动重复写入。
+
+
+## 平台调用身份
+
+- `LICOS_CURRENT_USER_ID` 仅表示容器初始化用户，不能作为网页登录身份。
+- 当前用户信息、企业知识库、本体搜索/调用/订阅必须显式传本次用户 Token（Node `userToken` / Python `user_token`）。Token 失效直接返回鉴权错误，不换成容器用户。
+- 普通知识库、模型与积分接口默认使用项目身份；需要按网页登录用户执行时显式传 Token。数据库、存储、可观测性和 OAuth 应用管理使用项目身份。项目归属与平台签发的计费上下文独立保留。
+- CLI 用户操作默认按 `LICOS_CURRENT_USER_ID` 换 Token；HTTP 服务调用 CLI 时使用 `--token-stdin`。Dev CLI 可用 `--identity project` 明确选择项目身份。
+- 每个请求单独传 Token 或创建客户端，不把请求 Token、用户 ID 写进共享环境变量。

package/lib/__templates__/workflow/pyproject.toml

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

package/lib/__templates__/workflow/requirements.txt

@@ -1,3 +1,3 @@
-licos-agent-runtime>=0.3.9
-licos-platform-sdk>=0.6.0
-licos-dev-sdk>=0.4.9
+licos-agent-runtime>=0.5.0
+licos-platform-sdk>=0.7.0
+licos-dev-sdk>=0.6.0

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "@kmlckj/licos-ai-cli",
-  "version": "1.5.0",
-  "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
-  "license": "MIT",
-  "author": "kmlckj",
-  "bin": {
-    "licos": "bin/main"
-  },
-  "files": [
-    "lib",
-    "bin",
-    "!lib/**/node_modules/**",
-    "!lib/**/.pnpm/**",
-    "!lib/**/.pnpm-store/**",
-    "!lib/**/dist/**",
-    "!lib/**/.next/**",
-    "!lib/**/.turbo/**"
-  ],
-  "dependencies": {
-    "@iarna/toml": "^2.2.5",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "change-case": "^5.4.4",
-    "commander": "~12.1.0",
-    "debug": "^4.3.7",
-    "ejs": "^3.1.10",
-    "fast-glob": "^3.3.3",
-    "js-yaml": "^4.1.0",
-    "minimist": "^1.2.5",
-    "shelljs": "^0.10.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  }
-}
+{
+  "name": "@kmlckj/licos-ai-cli",
+  "version": "1.6.0",
+  "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
+  "license": "MIT",
+  "author": "kmlckj",
+  "bin": {
+    "licos": "bin/main"
+  },
+  "files": [
+    "lib",
+    "bin",
+    "!lib/**/node_modules/**",
+    "!lib/**/.pnpm/**",
+    "!lib/**/.pnpm-store/**",
+    "!lib/**/dist/**",
+    "!lib/**/.next/**",
+    "!lib/**/.turbo/**"
+  ],
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "change-case": "^5.4.4",
+    "commander": "~12.1.0",
+    "debug": "^4.3.7",
+    "ejs": "^3.1.10",
+    "fast-glob": "^3.3.3",
+    "js-yaml": "^4.1.0",
+    "minimist": "^1.2.5",
+    "shelljs": "^0.10.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}