kcode-pi 0.1.0

package/vendor/kingdee-skills/ok-cosmic/scripts/script_utils.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: NOASSERTION
+"""Small CLI helpers shared by ok-cosmic scripts."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import Callable, Optional
+
+
+class FriendlyArgumentParser(argparse.ArgumentParser):
+    """ArgumentParser that reports concise failures instead of dumping usage."""
+
+    def error(self, message: str) -> None:
+        self.exit(1, f"✖️ 参数错误: {message}\n提示: 使用 --help 查看参数。\n")
+
+
+def run_cli(main_func: Callable[[], Optional[int]]) -> int:
+    """Run a CLI entrypoint and convert uncaught exceptions to failure text."""
+
+    try:
+        result = main_func()
+        if isinstance(result, int):
+            return result
+        return 0
+    except SystemExit as e:
+        code = e.code
+        if code is None:
+            return 0
+        if isinstance(code, int):
+            return code
+        print(f"✖️ 执行失败: {code}", file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        print("✖️ 执行已取消", file=sys.stderr)
+        return 130
+    except Exception as e:
+        print(f"✖️ 执行失败: {e}", file=sys.stderr)
+        return 1

package/vendor/kingdee-skills/ok-cosmic/scripts/sqlite_cache.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: NOASSERTION
+"""Shared SQLite JSON cache helpers for ok-cosmic scripts."""
+
+import json
+import os
+import re
+import sqlite3
+import sys
+import time
+from typing import Any, Dict, Iterable, Optional, Sequence
+
+
+IDENTIFIER_RE = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
+
+
+def resolve_graph_db_path(config: Dict[str, Any], missing_message: str) -> str:
+    """Resolve graph.dbPath relative to ok-cosmic.json's directory."""
+    graph_config = config.get("graph", {})
+    if not isinstance(graph_config, dict):
+        graph_config = {}
+
+    db_path = str(graph_config.get("dbPath", "")).strip()
+    if not db_path:
+        raise ValueError(missing_message)
+
+    raw_db_path = os.path.expanduser(db_path)
+    if os.path.isabs(raw_db_path):
+        return os.path.normpath(raw_db_path)
+
+    base_dir = str(config.get("__config_dir__", "")).strip() or os.getcwd()
+    return os.path.normpath(os.path.abspath(os.path.join(base_dir, raw_db_path)))
+
+
+def _validate_identifier(value: str, label: str) -> str:
+    if not IDENTIFIER_RE.match(value):
+        raise ValueError(f"{label} 不是安全的 SQLite 标识符: {value}")
+    return value
+
+
+class JsonSqliteCache:
+    """Small SQLite cache storing JSON payload + updated_at with TTL."""
+
+    def __init__(
+        self,
+        db_path: str,
+        *,
+        table_name: str,
+        key_column: str,
+        create_sql: str,
+        ttl: int = 600,
+        check_same_thread: bool = True,
+        init_error_message: str = "初始化缓存表失败",
+        write_error_message: str = "写入缓存失败",
+    ):
+        self.db_path = db_path
+        self.table_name = _validate_identifier(table_name, "table_name")
+        self.key_column = _validate_identifier(key_column, "key_column")
+        self.ttl = ttl
+        self.init_error_message = init_error_message
+        self.write_error_message = write_error_message
+        self._conn = sqlite3.connect(self.db_path, check_same_thread=check_same_thread)
+        self._conn.execute("PRAGMA journal_mode=WAL")
+        self._conn.execute("PRAGMA busy_timeout=5000")
+        self._conn.row_factory = sqlite3.Row
+        self._init_db(create_sql)
+
+    def _init_db(self, create_sql: str) -> None:
+        try:
+            self._conn.execute(create_sql)
+            self._conn.commit()
+        except Exception as e:
+            print(f" (DEBUG) {self.init_error_message}: {e}", file=sys.stderr)
+
+    def get(self, key: str) -> Optional[Dict[str, Any]]:
+        try:
+            row = self._conn.execute(
+                f"SELECT payload, updated_at FROM {self.table_name} WHERE {self.key_column} = ?",
+                (key,),
+            ).fetchone()
+            if not row or (time.time() - row["updated_at"] > self.ttl):
+                return None
+            return json.loads(row["payload"])
+        except Exception:
+            return None
+
+    def set_payload(
+        self,
+        key: str,
+        payload: Dict[str, Any],
+        *,
+        extra_columns: Optional[Sequence[str]] = None,
+        extra_values: Optional[Sequence[Any]] = None,
+    ) -> None:
+        extra_columns = tuple(extra_columns or ())
+        extra_values = tuple(extra_values or ())
+        if len(extra_columns) != len(extra_values):
+            raise ValueError("extra_columns 和 extra_values 数量不一致")
+        for column in extra_columns:
+            _validate_identifier(column, "extra_column")
+
+        columns = (self.key_column, *extra_columns, "payload", "updated_at")
+        placeholders = ", ".join("?" for _ in columns)
+        column_sql = ", ".join(columns)
+        values = (
+            key,
+            *extra_values,
+            json.dumps(payload, ensure_ascii=False),
+            int(time.time()),
+        )
+
+        try:
+            self._conn.execute(
+                f"""
+                INSERT OR REPLACE INTO {self.table_name}
+                ({column_sql})
+                VALUES ({placeholders})
+                """,
+                values,
+            )
+            self._conn.commit()
+        except Exception as e:
+            print(f" (DEBUG) {self.write_error_message}: {e}", file=sys.stderr)
+
+    def remove(self, key: str) -> None:
+        try:
+            self._conn.execute(
+                f"DELETE FROM {self.table_name} WHERE {self.key_column} = ?",
+                (key,),
+            )
+            self._conn.commit()
+        except Exception:
+            pass
+
+    def close(self) -> None:
+        try:
+            self._conn.close()
+        except Exception:
+            pass
+
+    def __del__(self):
+        self.close()

package/vendor/kingdee-skills/ok-cosmic/setup/ok-cosmic.json

@@ -0,0 +1,13 @@
+{
+  "graph": {
+    "dbPath": "/path/to/your-current-project/ok-cosmic-knowledge.db"
+  },
+  "route": {
+    "apiUrl": "",
+    "timeoutSeconds": 10
+  },
+  "extensionRepos": [
+    "/path/to/your-extension-project-1",
+    "/path/to/your-extension-project-2"
+  ]
+}

package/vendor/kingdee-skills/ok-cosmic/setup/setup-mac.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# ok-cosmic-knowledge 离线 API 知识图谱构建工具
+# 用法: ./setup-mac.sh [参数]
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+JAR_FILE="$SCRIPT_DIR/setup.jar"
+
+if ! command -v java &> /dev/null; then
+    echo "错误: 未找到 java 命令，请安装 JDK 8+"
+    exit 1
+fi
+
+if [ ! -f "$JAR_FILE" ]; then
+    echo "请确认发布包完整，或重新获取包含 setup.jar 的安装包"
+    exit 1
+fi
+
+java -jar "$JAR_FILE" "$@"

package/vendor/kingdee-skills/ok-cosmic/setup/setup-windows.bat

@@ -0,0 +1,53 @@
+@echo off
+setlocal
+REM ok-cosmic-knowledge 离线 API 知识图谱构建工具
+REM 用法: setup-windows.bat [参数]
+
+chcp 65001 >nul 2>nul
+
+set "SCRIPT_DIR=%~dp0"
+set "JAR_FILE=%SCRIPT_DIR%setup.jar"
+set "EXIT_CODE=0"
+set "PAUSE_ON_EXIT="
+
+REM Explorer 双击通常通过 cmd.exe /c 启动，执行结束后窗口会立即关闭。
+echo %CMDCMDLINE% | findstr /I /C:" /c " >nul && set "PAUSE_ON_EXIT=1"
+
+if not exist "%JAR_FILE%" (
+    echo 错误: setup.jar 文件不存在: "%JAR_FILE%"
+    echo 请确认发布包完整，或重新获取包含 setup.jar 的安装包
+    set "EXIT_CODE=1"
+    goto end
+)
+
+where java >nul 2>nul
+if errorlevel 1 (
+    echo 错误: 未找到 java 命令，请先安装 JRE/JDK 并配置 PATH。
+    set "EXIT_CODE=1"
+    goto end
+)
+
+pushd "%SCRIPT_DIR%" >nul 2>nul
+if errorlevel 1 (
+    echo 错误: 无法进入脚本目录: "%SCRIPT_DIR%"
+    set "EXIT_CODE=1"
+    goto end
+)
+
+java -jar "%JAR_FILE%" %*
+set "EXIT_CODE=%ERRORLEVEL%"
+popd >nul
+
+:end
+if defined PAUSE_ON_EXIT (
+    echo.
+    if "%EXIT_CODE%"=="0" (
+        echo 执行完成，按任意键关闭窗口...
+    ) else (
+        echo 执行失败，退出码: %EXIT_CODE%
+        echo 按任意键关闭窗口...
+    )
+    pause >nul
+)
+
+exit /b %EXIT_CODE%

package/vendor/kingdee-skills/ok-ksql/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: "ok-ksql"
+description: "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill。适用于数据库执行脚本、历史数据修复、批量更新、字段回填、影响范围查询、备份和回滚；默认生成 PostgreSQL 语法，生成前必须依赖 $ok-cosmic 的元数据能力验证表名和字段名，不生成 Java。"
+---
+
+# KSQL 数据修复
+
+用于生成数据库执行的 KSQL/SQL 数据修复、批量数据变更、历史数据修复、字段回填、影响范围查询、备份和回滚脚本。
+
+## 路径约定
+
+- `<SKILL_ROOT>` = 当前 `SKILL.md` 所在目录（即 `skills/ok-ksql/`）
+- `<SKILL_ROOT>/scripts/ksql_lint.py` = 最终 SQL 静态检查脚本。
+
+## 依赖关系
+
+- 本 Skill 不自带、不复制、不生成元数据脚本。
+- 表名、`dbKey`、字段类型、枚举/状态值、基础资料落库字段确认，统一依赖 `$ok-cosmic` 的元数据查询能力。
+- 如果 `$ok-cosmic` 不可用，且用户也没有提供已确认的元数据结果，必须停止并列出待确认项。
+
+## 必读规则
+
+处理任何 KSQL/SQL 数据修复请求时，必须先完整读取 [references/ksql-datafix.md](references/ksql-datafix.md)，并按其中“确认卡片”模板输出。
+
+## 辅助脚本
+
+- 最终 SQL 文件生成后，优先运行 `python3 <SKILL_ROOT>/scripts/ksql_lint.py <SQL文件>` 做静态检查。
+- 若 lint 输出 `ERROR`，必须修复 SQL 后再交付；若输出 `WARN`，必须按偏好修复或在结果中说明保留原因。
+- `ksql_lint.py` 会检查高风险项：无 `WHERE` 的 `UPDATE/DELETE`、非备份场景 `SELECT *`、备份语句/备份表命名、时间戳一致性、`EXISTS` 偏好、`NULL` 判断和 PostgreSQL 多表更新风格。
+
+## Step 0. 依赖预检
+
+1. 先使用 `$ok-cosmic` 完成其 Step 0 配置预检。
+2. 若 `$ok-cosmic` 预检返回 `ERROR`，不得生成最终 KSQL；只说明缺失配置，并把需要用户补齐的信息列入“待确认项”。
+3. 生成最终 KSQL 前，必须通过 `$ok-cosmic` 的元数据能力确认表名和字段名；具体命令以 `$ok-cosmic` 的脚本路由为准。
+
+## 工作流硬约束
+
+1. 先拆解自然语言意图，明确目标对象、操作类型、目标字段、条件字段、新值来源和风险边界。
+2. 必须通过 `$ok-cosmic` 元数据能力（`cosmic-form-metadata.py --sql`）精确确认每个单据的表名和每个数据库字段名；用户给中文或英文都必须查。
+3. 写 SQL 前必须先判断所有参与表的 `dbName` 是否一致；一致才按普通单库 SQL 处理，不一致就是分库/跨库场景。
+4. 分库/跨库场景不得直接生成普通更新 SQL；必须先让用户确认 dblink / postgres_fdw / 导出导入临时表等处理方式。
+5. 所有表名、`dbKey`、`dbName`、枚举值、状态值、基础资料落库字段全部确认后，才允许生成最终 KSQL。
+6. 任一字段、表名或 `dbName` 未确认时，只输出待确认项，不生成最终 KSQL。
+7. 每条 `update` 前必须先写对应查询语句，查询条件和关联范围必须与 `update` 保持一致。
+8. 备份必须使用 `select * into` 做整表备份；备份语句不加 `where`；备份表名必须以 `bak_` 开头、以当前生成时间 `yyyyMMddHHmm` 结尾，精确到分钟。
+9. 查询/验证语句禁止 `select *`；备份语句例外且必须 `select * into`。
+10. 禁止无 `where` 的 `update` / `delete`。
+11. 单据主键一般是 `fid`；分录表主键一般是 `fentryid`；分录表一般通过 `fid` 与单据主表关联。
+12. 本 Skill 只生成数据库执行脚本，不生成 Java 插件代码。
+13. 所有确认卡片均为 `✔️` 后，最终必须在用户桌面生成 SQL 文本文件；任一卡片为 `✖️` 时，不生成文件。
+14. 默认使用 PostgreSQL 语法生成 SQL；除非用户明确指定其他数据库方言，否则不要输出其他方言写法。
+15. SQL 可读性偏好：成员关系/半连接条件默认使用 `IN`（值列表或子查询），避免使用 `EXISTS`；只有 `IN` 会改变语义或无法表达时才保留 `EXISTS`，并说明原因。
+16. 最终 SQL 文件生成后必须尽量运行 `ksql_lint.py`；如因环境限制无法运行，最终回复中说明未运行原因。
+
+## 输出要求
+
+最终输出必须使用确认卡片形式，并包含：
+
+1. 意图拆解
+2. 元数据确认
+3. 待确认项
+4. 影响范围查询
+5. 备份语句
+6. 更新前确认查询
+7. 正式执行语句
+8. 执行后验证语句
+9. 回滚语句
+10. 风险点与执行顺序
+11. 桌面文件产物
+
+所有确认卡片均为 `✔️` 后，才允许输出最终 KSQL，并在用户桌面生成 `.txt` 文件；任一卡片为 `✖️` 时，停止并说明需要补充的信息。
+
+## 桌面文件产物
+
+- 路径：`~/Desktop/ksql_<业务缩写>_<当前生成时间yyyyMMddHHmm>.txt`
+- 内容：完整 SQL 执行脚本，至少包含影响范围查询、整表备份、更新前确认查询、正式执行语句、执行后验证语句和回滚语句。
+- 时间：文件名里的分钟必须取当前生成时间，与备份表名时间戳保持一致。
+- 风格：SQL 文件使用 `-- ============================================` 分隔章节；文件开头写业务标题、关键条件和执行前提醒；SQL 关键字大写；文件末尾补充“字段映射（来自元数据）”。
+- 禁止：待确认项非空、任一确认卡片为 `✖️` 时，不得创建桌面文件。
+- 检查：文件生成后运行 `python3 <SKILL_ROOT>/scripts/ksql_lint.py <SQL文件>`，无 `ERROR` 后再交付。

package/vendor/kingdee-skills/ok-ksql/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "ok ksql"
+  short_description: "苍穹KSQL数据修复脚本生成"
+  default_prompt: "使用 $ok-ksql 按PostgreSQL语法生成数据库执行的KSQL数据修复脚本，并依赖 $ok-cosmic 先确认元数据字段后再输出备份、更新、验证和回滚。"
+
+policy:
+  allow_implicit_invocation: true

package/vendor/kingdee-skills/ok-ksql/manifest.json

@@ -0,0 +1,14 @@
+{
+  "name": "ok-ksql",
+  "version": "0.1.1",
+  "description": "金蝶云苍穹 KSQL/SQL 数据修复与批量数据变更 Skill，默认生成 PostgreSQL 语法，依赖 ok-cosmic 元数据能力，面向数据库执行脚本生成、影响范围确认、备份、验证和回滚。",
+  "author": "Cosmic",
+  "references": [
+    "references/"
+  ],
+  "ignore": [
+    ".DS_Store",
+    "__pycache__/",
+    "*.pyc"
+  ]
+}