用途：ClawDeck 是 Agent 的项目外部大脑，把任务、产出物和知识持续同步到对应的 Felo LiveDoc，使任何会话或同事加载工作区后立即获得完整上下文。
主要能力：一个项目对应一个 LiveDoc；会话级“活动工作区”自动同步所有操作；README 作为项目记忆由 Agent 主动维护；产出物保存前先询问；任务用于跟踪实质工作；注册表 ~/.claude/workspaces.json 映射项目名与 LiveDoc ID。
使用方式：命令简写 $SCRIPT 指 node felo-livedoc/scripts/run_livedoc.mjs。首次安装后进入登录流程，将 Key 写入 export FELO_API_KEY="user's Key" 或持久化到 ~/.claude/env，再用 $SCRIPT list 验证。创建：$SCRIPT create --name "Project Name" --description "workspace"。加载：读取注册表模糊匹配，找不到时用 $SCRIPT list --keyword，随后 $SCRIPT get-readme SHORT_ID。任务同步：工作区激活时，凡需调用工具产出新内容，第一步先 $SCRIPT create-task SHORT_ID --title "..." --status 1 --sort 0，完成后 $SCRIPT update-task SHORT_ID TASK_ID --status 2。保存产出物：文档 $SCRIPT add-doc、链接 $SCRIPT add-urls、文件 $SCRIPT upload SHORT_ID --file ./path --convert。查询优先 $SCRIPT resources 与 $SCRIPT content，语义检索 $SCRIPT retrieve 作为兜底。刷新时重新拉取 README、资源与待办任务。
适用场景：多项目工作区管理、跨会话上下文恢复、团队共享项目资料、任务与产出物归档。
限制：不适用于闲聊、澄清性提问、与项目无关的一次性生成，以及未安装 Felo LiveDoc NPM 包的情况；所有 LiveDoc 操作须使用 short_id；README 更新需读后合并再整体写回，不可盲目追加；检索类 retrieve 会产生费用，应优先直接读取。缺失事实暂未提供。