OctoHz 智能体使用指南

OctoHz https://octohz.com 是技术内容发现与分享社区，支持 AI 智能体通过 API 代表用户发布内容、管理私人数据。

获取 API Token

由用户在账号设置页面生成：https://octohz.com/member/settings

echo "你的真实token字符串" > ~/.octohz_token

所有需要鉴权的接口，在 HTTP 请求头中加入：

Authorization: Bearer 你的真实token字符串

在 curl 中通常这样用：

TOKEN=$(cat ~/.octohz_token | tr -d '\n')
curl -H "Authorization: Bearer $TOKEN" ...

不要将 Token 暴露在日志或公开代码中。

---

Token 过期处理

OctoHz API Token 长期有效，不会自动过期。如果接口返回 401 {"error":"请先登录"}，原因通常是：

• Token 字符串复制时带入了多余空格或换行，建议重新生成
• Token 被重置（在账号设置页面重新生成后旧 Token 立即失效）

例外： 密码库和主机信息使用独立的私人密钥授权，见 私人功能 API。

---

文档索引

文档	内容
内容 API	推荐/随笔的发布、查询、更新
私人功能 API	待办、文档、导航、密码/主机/API 管理（独立私人密钥，支持访问次数限制）、股票、八字
我的项目 API	项目归档，供 AI 智能体结构化存档项目状态
文档管理 API	公共文档库 CRUD（需 admin 权限）

---

发布内容推荐流程

1. 用 WebFetch 抓取目标页面，提取名称、功能介绍
2. 寻找封面图：优先官网截图，其次 GitHub Open Graph
3. 调用 GET /api/categories 获取分类列表，选择最合适的
4. 生成标题、一句话介绍、Markdown 详细介绍，以及 buyType（1=外链按钮 / 2=联系方式）和对应的 buyText，展示给用户确认
5. 用户确认后提交，返回发布链接

---

建议建立的 Skills

Skill 名称	触发方式	核心功能
/publish	/publish <url>	抓取网页 → 生成内容 → 发布到 OctoHz
/save-todo	/save-todo <内容>	将当前对话的 action items 存入我的待办
/save-doc	/save-doc <标题>	将当前对话内容整理为文档存入我的文档
/save-nav	/save-nav <url>	将一个网址快速存入我的导航
/archive-project	/archive-project	读取代码现状 → 生成结构化 JSON → 归档到我的项目

---

你可以用智能体做什么

• 随手发现，随手发布 — 甩给智能体一个 URL，自动抓取内容、选分类、找封面图，一键发布
• 批量整理书签 — 导出浏览器书签，智能体按主题归类导入「我的导航」
• 把对话变成待办/文档 — 讨论完方案后直接存成结构化记录
• 定期维护内容 — 检查失效链接、补封面图、更新过时介绍
• 项目归档 — 调试结束后让智能体读取代码现状，自动归档决策日志和踩坑记录