## 让 AI 把记忆写成一本书

把访谈记录、回忆片段、年表或宠物的成长记录交给 AI，它可以梳理内容、安排章节、润色文字，并直接保存成一本人生之书。你不用先把每段文字复制进网页。

编写 Skill 是一份供 AI 使用的写作与操作指南，帮助它整理材料、区分事实与回忆，并把写好的内容保存到你的书架。请在你自己的 AI 工具中安装使用。

## 第一步：创建 API Key

在人生之书的「设置 → API Key」中创建一个密钥，建议命名为「我的写作助手」。每个密钥都可调用全部开放的用户 API，不需要选择权限。

密钥只显示一次。请把它保存在密码管理器中，并通过你的 AI 工具支持的安全环境变量或密钥设置提供给 AI。不要把密钥放进公开仓库，也不要粘贴到聊天正文。

密钥泄露或不再使用时，回到设置撤销即可。撤销后，AI 将无法继续访问你的书籍，已经写好的内容不会被删除。

## 第二步：安装编写 Skill

点击本页上方的「下载编写 Skill」。压缩包包含写作指南、API 参考、书籍示例和 Python 调用脚本。

Skill 使用 [Agent Skills 标准](https://agentskills.io/specification)，可安装到 Codex、Claude Code 等支持技能的 AI 工具中。

当前版本：`1.0.1`。需要保留指定版本时，可下载 [1.0.1 版本安装包](/skills/life-book-author-v1.0.1.zip)；[版本与校验信息](/skills/life-book-author.json)可用于核对下载文件。

### Codex 安装

在你运行 AI 的电脑或服务器上执行：

```bash
curl --fail --location https://life.starfold.tech/skills/life-book-author.zip -o life-book-author.zip
mkdir -p "$HOME/.codex/skills"
unzip -n life-book-author.zip -d "$HOME/.codex/skills"
```

### Claude Code 安装

按照 [Claude Code 官方技能说明](https://code.claude.com/docs/en/skills)，用户级技能放在 `~/.claude/skills/`，项目级技能可放在 `.claude/skills/`。例如：

```bash
curl --fail --location https://life.starfold.tech/skills/life-book-author.zip -o life-book-author.zip
mkdir -p "$HOME/.claude/skills"
unzip -n life-book-author.zip -d "$HOME/.claude/skills"
```

在 Claude Code 中可以用 `/life-book-author` 调用；其他支持 Agent Skills 的 AI 工具，请使用它自己的导入入口或技能目录。不是所有聊天工具都能运行脚本或发送 HTTP 请求，需要同时具有网络与执行能力。

已有旧版时，先将原 `life-book-author` 目录备份到技能目录以外，再解压新版本；`unzip -n` 不覆盖已有文件。

### 让 AI 自己完成安装

也可以把以下要求发给 AI：

> 请从 https://life.starfold.tech/docs/ai-skill 阅读安装说明，下载官方 life-book-author Skill，安装到你使用的技能目录。不要向我索取聊天中的密钥；让我通过安全环境变量配置 LIFE_BOOK_API_KEY 后，先检查工作区连接，再根据我给出的资料保存一份私有书籍草稿。

## 第三步：配置连接

调用脚本读取两个环境变量：

| 变量 | 用途 |
| --- | --- |
| `LIFE_BOOK_API_URL` | 人生之书 API 地址，默认为 `https://life.starfold.tech/api/v1` |
| `LIFE_BOOK_API_KEY` | 你刚创建的密钥，请通过安全的环境变量设置 |

如果从终端运行 AI，可在 Bash 或 Zsh 中输入以下命令，再粘贴密钥并按回车。输入不会显示在屏幕上，也不用把密钥写进命令历史：

```bash
read -r -s LIFE_BOOK_API_KEY
export LIFE_BOOK_API_KEY
export LIFE_BOOK_API_URL="https://life.starfold.tech/api/v1"
```

在同一终端启动 AI，或先执行下面的连接检查。已经启动的 AI 不会自动获得新的环境变量；桌面或托管 AI 请使用该工具的安全凭据配置入口。不要把密钥保存在 Skill 文件或项目代码中。

脚本需要 Python 3，不需要安装第三方库。先列出工作区，就能检查连接是否成功：

```bash
python3 ~/.codex/skills/life-book-author/scripts/life_book.py GET /workspaces
```

如果提示密钥无效，请检查是否已撤销或过期；如果提示无权访问书籍，请检查是否选错工作区或图书，不要把账号密码交给 AI。

## 第四步：把材料交给 AI

你可以这样开始：

> 使用 life-book-author，根据我提供的访谈整理一本关于父亲的人生之书。先列出缺失的信息和章节安排，不确定的内容标注为待核实。确认后保存成私有草稿，不要提交公开审核。

还可以这样提出修改：

> 在这本书的第二章加入刚才的回忆，保留其他章节和已有图片，先预览更新后的内容，再保存草稿。

先说明写给谁、希望保留哪些记忆和语气，再给出材料。资料不足时，AI 应向你提问，不应杜撰具体日期、对话、疾病、家庭关系或名人名言。

## 你始终可以接着编辑

AI 成功保存后，书会出现在「发布 → 我的书架」。你可以继续修改、换封面和预览。需要公开时，可以在网页操作，也可以明确让 AI 使用同一个密钥提交审核。Skill 默认只保存私有草稿，不会因为密钥有能力发布就擅自公开。

> Skill 是写作与调用指南，不是事实核验的替代品。真实人物的隐私、授权和最终发布决定，仍需要你确认。
