Install
openclaw skills install @thcjp/archive-tool-freeopenclaw skills install @thcjp/archive-tool-free核心功能: 本技能提供中文交互、化工作流场景等能力。
本工具将外部内容保存为智能快照,捕获完整内容(而非仅链接),生成摘要与语义标签,支持语义搜索与主动召回。免费版面向个人用户,提供核心的归档、检索与召回能力。
| 工具 | 做什么 | 与本工具的区别 |
|---|---|---|
| 本工具 | 保存外部内容为快照 | 捕获完整内容,永久保存 |
| 书签 | 仅保存 URL | 本工具保存完整内容与元数据 |
| 记忆系统 | Agent 上下文记忆 | 本工具是持久化归档 |
| 笔记应用 | 演进式笔记 | 本工具保存不可变快照 |
| 知识库 | 已处理的知识 | 本工具保存原始素材 |
输出: 返回核心规则的执行结果,包含操作状态和输出数据。
| 类型 | 提取内容 |
|---|---|
| 文章/网页 | 全文、作者、日期、关键引用 |
| 视频 | 标题、创作者、时长、提到的关键时间点 |
| 推文/帖子 | 全文、作者、上下文、媒体 |
| PDF/论文 | 标题、作者、摘要、引用参考 |
| 图片 | 描述、来源、提供的上下文 |
| 想法/笔记 | 原始文本 + 时间戳 + 相关条目 |
输出: 返回内容类型与提取规则的执行结果,包含操作状态和输出数据。
用input_params参数进行配置。
输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:智能内容快照工具、支持完整内容提取、语义标签与主动召、适合个人用户、内容归档工具、将外部内容保存为、智能快照、语义标签、语义搜索与主动召、捕获的不只是链接、而是完整内容与上、Use、when、SEO、关键词分析、排名提升、搜索流量优化时使、不适用于黑帽、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。用户发现一篇有用的文章,希望完整保存以便日后查阅。
# 本技能的核心实现逻辑
# 请参考上方使用说明进行配置和调用
echo "implementation_ready"
归档后的文件内容:
本文探讨了 SaaS 产品的定价策略,包括价值定价、竞争定价与免费增值模式...
(文章全文)
### 场景二:语义搜索归档内容
用户询问"我之前保存过关于定价的内容吗?"
```bash
# 语义搜索(按含义而非关键词)
# 用户问:"我保存过关于定价的内容吗?"
# 工具搜索归档库,按语义匹配
# 用户问:"上个月那篇关于定价的文章"
# 工具模糊匹配时间 + 主题
# 用户问:"项目 Y 的所有资料"
# 工具按项目筛选
用户正在研究某话题时,工具自动浮现相关归档内容。
用户正在研究"AI 智能体定价"...
工具主动提示:
"你在 3 个月前研究 SaaS 定价时保存过这篇文章,可能相关:
- [2026-02-16] SaaS 定价策略研究
- [2026-01-20] 免费增值模式分析"
# 创建归档目录(首次使用)
mkdir -p ~/archive/items ~/archive/projects
存储结构:
~/archive/
├── memory.md # HOT 区:最近条目,不超过100行
├── index.md # 主题/标签索引
├── items/ # 单个归档条目
├── projects/ # 按项目归集
└── history.md # 搜索/访问历史
result = "ready"
# 归档时执行:
# 1. 提取完整内容(不只 URL)
# 2. 生成 2-3 行摘要
# 3. 识别关键引用/数据点
# 4. 询问"这是什么用的?" - 记录 WHY
# 5. 基于内容 + 历史分配语义标签
result = "ready"
# 语义搜索
archive search "定价策略"
# 按项目筛选
archive search --project my-project
# 按时间范围
archive search --from 2026-01 --to 2026-03
结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。
每个归档条目以 Markdown 文件存储:
items/{date}_{slug}.md
---
type: article # 类型: article|video|post|paper|image|note
url: original-url # 原始 URL
archived: 2026-02-16 # 归档日期
why: "研究用途说明" # 为什么归档
tags: [标签1, 标签2] # 语义标签
project: my-project # 所属项目
---
## 摘要
2-3 行内容摘要...
## 关键要点
- 要点1
- 要点2
## 完整内容
完整原文...
result = "ready"
# 归档索引
## 最近添加
- [SaaS 定价策略](items/2026-02-16-pricing-strategy.md) - 定价,saas,策略
- [AI 智能体调研](items/2026-02-15-ai-agent-research.md) - ai,agent,调研
## 按标签
### #定价
- [免费增值模式](items/2026-01-20-freemium.md)
### #ai
## 按项目
### my-project
result = "ready"
当用户研究某话题时:
1. 检查归档库是否有相关条目
2. 仅在真正相关时浮现(每次最多 1-2 条)
3. 附带上下文:"你 3 个月前研究 X 时保存了这条"
index.md。记录"为什么"归档(用途)能帮助后续判断相关性。当你研究定价时,工具能优先浮现"用于定价研究"的条目,而非所有含"价格"的条目。
本工具捕获完整内容,即使原始链接失效,归档中仍保留全文、摘要与关键引用,不会丢失信息。
语义搜索按"含义"匹配,如搜索"提升团队效率"能找到标题为"组织效能优化"的条目,即使没有完全匹配的关键词。
不会。工具仅在内容"真正相关"时浮现,每次会话最多 1-2 条,并附带上下文说明("你 3 个月前研究 X 时保存了这条")。
免费版提供核心归档与检索能力,适合个人用户。如需团队共享归档、自动摘要生成、归档版本控制、API 访问等高阶能力,请升级至专业版。
归档库是纯 Markdown 文件,直接备份目录或纳入 Git 管理即可:
cd ~/archive && git add . && git commit -m "归档更新"
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Markdown 编辑器 | 可选 | 可选 | Obsidian / VS Code 等 |
| Git | 版本控制 | 推荐 | 系统包管理器(备份归档) |
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。