Agent Skill

让你的 AI Agent 使用轻湖看板

三个纯 Python 文件即装即用：无需 pip、无需 cryptography 轮子、无需平台二进制。Agent 可列出、领取、创建与完成任务，内容始终在本机端到端加密。

skill v1.0.0

按平台安装

选择你的 Agent 平台，在运行 Agent 的机器上执行以下命令。

Skills 目录: ~/.agents/skills

使用跨 Agent 共享目录；仓库级 .zcode/skills 亦可。

第 1 步 · 下载三个文件并运行离线自检

mkdir -p ~/.agents/skills/liteboard && cd ~/.agents/skills/liteboard \
  && curl -fsSL https://board.litelake.cn/skill/SKILL.md       -o SKILL.md \
  && curl -fsSL https://board.litelake.cn/skill/liteboard.py   -o liteboard.py \
  && curl -fsSL https://board.litelake.cn/skill/lite_crypto.py -o lite_crypto.py \
  && python3 ~/.agents/skills/liteboard/liteboard.py doctor --offline

需要 Python 3.9+。Windows 通常只有 `python` 没有 `python3`，下列命令请把 `python3` 换成 `python`。

第 2 步 · 验证安装

python3 ~/.agents/skills/liteboard/liteboard.py --version
# 预期输出：liteboard-skill 1.0.0
python3 ~/.agents/skills/liteboard/liteboard.py doctor --offline

配置

凭据存放在 ~/.lite-lake/lite-board/，不在 Skill 目录内，更新 Skill 不会覆盖。

主密码

由你本人创建并保管该文件；不要 cat、不要 echo、不要粘贴进对话。

主密码

mkdir -p ~/.lite-lake/lite-board
chmod 700 ~/.lite-lake/lite-board
# Ask the user to write the tenant master password into master.key (never echo it).
chmod 600 ~/.lite-lake/lite-board/master.key

API Key 与登录

在 Web 端「设置 → Clients」创建 read_write Client，然后经 stdin 传入 Key；`--api-key` 可用但不推荐。

API Key 与登录

printf '%s\n' "$LITEBOARD_API_KEY" | python3 ~/.agents/skills/liteboard/liteboard.py login --api-key-stdin
# Windows: python ~/.agents/skills/liteboard/liteboard.py login --api-key-stdin

安全规则

不得打印或记录 master.key、API Key、DEK 与 wrapped_dek，也不得放进模型上下文。破坏性操作先与用户确认。AES 为查表实现，非严格常数时间：仅在可信本机运行。

更新

用 `--version` 对比上方版本徽标；发布版本更新时重新执行三条 curl 即可，~/.lite-lake/lite-board/ 中的配置不受影响。