Add OpenClaw skills, platform kit, and template docs

Made-with: Cursor

content-manager/content_manager/util/__init__.py

@@ -0,0 +1 @@
+# 工具函数

content-manager/content_manager/util/argparse_zh.py

@@ -0,0 +1,74 @@
+"""argparse 中文错误说明。"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import List
+
+from content_manager.constants import CLI_REQUIRED_ZH
+
+
+def split_required_arg_names(raw: str) -> List[str]:
+    s = raw.replace(" and ", ", ").strip()
+    parts: List[str] = []
+    for chunk in s.split(","):
+        chunk = chunk.strip()
+        if not chunk:
+            continue
+        idx = chunk.find(" --")
+        if idx != -1:
+            left = chunk[:idx].strip()
+            flag_rest = chunk[idx + 1 :].strip().split()
+            if left:
+                parts.append(left)
+            if flag_rest:
+                parts.append(flag_rest[0])
+        else:
+            parts.append(chunk)
+    return [p for p in parts if p]
+
+
+def explain_argparse_error(message: str) -> str:
+    m = (message or "").strip()
+    lines: List[str] = ["【命令参数不完整或写错了】请对照下面修改后再执行。"]
+    if "the following arguments are required:" in m:
+        raw = m.split("required:", 1)[-1].strip()
+        parts = split_required_arg_names(raw)
+        for p in parts:
+            hint = CLI_REQUIRED_ZH.get(p)
+            if not hint and p.startswith("--"):
+                hint = CLI_REQUIRED_ZH.get(p.split()[0], None)
+            lines.append(f"  · {hint or f'还缺这一项：{p}'}")
+        lines.append("  · 查看全部：python main.py -h")
+        lines.append("  · 查看分组：python main.py article -h")
+        return "\n".join(lines)
+    if "one of the arguments" in m and "required" in m:
+        lines.append("  · 本命令要求下面几组参数里「必须选其中一组」，不能都不写。")
+        if "--body-file" in m and "--body" in m:
+            lines.append("  · 请任选其一：--body-file 某文件路径   或   --body \"正文文字\"")
+        else:
+            lines.append(f"  · 说明：{m}")
+        lines.append("  · 查看该子命令：python main.py article add -h")
+        return "\n".join(lines)
+    if "unrecognized arguments:" in m:
+        tail = m.split("unrecognized arguments:", 1)[-1].strip()
+        lines.append(f"  · 多写了不认识的参数：{tail}，请删除或检查拼写。")
+        lines.append("  · 查看用法：python main.py -h")
+        return "\n".join(lines)
+    if "invalid choice:" in m:
+        lines.append(f"  · {m}")
+        return "\n".join(lines)
+    if "expected one argument" in m:
+        lines.append(f"  · {m}")
+        lines.append("  · 提示：--xxx 后面必须跟一个值，不要忘记。")
+        return "\n".join(lines)
+    lines.append(f"  · {m}")
+    lines.append("  · 查看帮助：python main.py -h")
+    return "\n".join(lines)
+
+
+class ZhArgumentParser(argparse.ArgumentParser):
+    def error(self, message: str) -> None:
+        print(explain_argparse_error(message), file=sys.stderr)
+        self.exit(2)

content-manager/content_manager/util/timeutil.py

@@ -0,0 +1,36 @@
+"""时间戳工具。"""
+
+from __future__ import annotations
+
+import time
+from datetime import datetime
+from typing import Any, Optional
+
+
+def now_unix() -> int:
+    return int(time.time())
+
+
+def unix_to_iso(ts: Optional[int]) -> Optional[str]:
+    if ts is None:
+        return None
+    try:
+        return datetime.fromtimestamp(int(ts)).isoformat(timespec="seconds")
+    except (ValueError, OSError, OverflowError):
+        return None
+
+
+def parse_ts_to_unix(val: Any) -> Optional[int]:
+    if val is None:
+        return None
+    if isinstance(val, (int, float)):
+        return int(val)
+    s = str(val).strip()
+    if not s:
+        return None
+    if s.isdigit():
+        return int(s)
+    try:
+        return int(datetime.fromisoformat(s.replace("Z", "+00:00")).timestamp())
+    except ValueError:
+        return None