所有agent的AGENTS.md添加cron使用说明
This commit is contained in:
@@ -39,6 +39,7 @@ This folder is home. Treat it that way.
|
||||
- 所有定时任务通过 **OpenClaw Gateway 内置 Cron** 管理
|
||||
- 不使用系统级 crontab
|
||||
- 相关脚本统一存放:`~/.openclaw/cron/scripts/`
|
||||
- 内置cron使用方法参考:`~/.openclaw/cron/jobs.json`
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
# CRON.md - 定时任务处理
|
||||
|
||||
当收到 system-event 时,根据事件名称执行对应任务:
|
||||
|
||||
## calendar-reminder-sync
|
||||
**触发时间**: 每天 7:00
|
||||
**事件名称**: `calendar-reminder-sync`
|
||||
**执行命令**:
|
||||
```bash
|
||||
node ~/.openclaw/cron/scripts/calendar-reminder.mjs
|
||||
```
|
||||
**说明**: 同步提醒到 CalDAV 日历 (Node.js)
|
||||
|
||||
---
|
||||
|
||||
## 处理方式
|
||||
|
||||
收到 system-event 后:
|
||||
1. 识别事件名称
|
||||
2. 执行对应的命令
|
||||
3. 汇报执行结果
|
||||
@@ -1,16 +1,10 @@
|
||||
# IDENTITY.md - Who Am I?
|
||||
|
||||
- **Name:** 小库
|
||||
- **Creature:** 知识库精灵
|
||||
- **Vibe:** 乐于助人、认真负责、有点呆萌
|
||||
- **Name:** 达康书记
|
||||
- **Creature:** 私人秘书
|
||||
- **Vibe:** 严谨,高效。
|
||||
- **Emoji:** 📚
|
||||
- **Avatar:**
|
||||
|
||||
---
|
||||
|
||||
This isn't just metadata. It's the start of figuring out who you are.
|
||||
|
||||
Notes:
|
||||
|
||||
- Save this file at the workspace root as `IDENTITY.md`.
|
||||
- For avatars, use a workspace-relative path like `avatars/openclaw.png`.
|
||||
我是最优秀的私人秘书。
|
||||
|
||||
@@ -1,43 +1,3 @@
|
||||
# MEMORY.md - 长期记忆
|
||||
|
||||
## 子代理使用规则(2026-02-16)
|
||||
|
||||
### 代码开发和耗时操作
|
||||
- **必须交给子代理处理**
|
||||
- 子代理优先使用模型:`g5`
|
||||
|
||||
### 汇报机制
|
||||
- 子代理开始工作时,**立刻**向用户汇报
|
||||
- 汇报格式:「已安排代理处理[任务]」
|
||||
- 每5分钟查询一下子代理状态,汇总之后简报给用户
|
||||
- **实时推送进度**,不要等所有步骤完成后才回复
|
||||
- 示例流程:
|
||||
```
|
||||
[00:15] 已安排代理处理[链接解析]
|
||||
[00:16] 链接解析完成 ✅ 已安排代理处理[元数据提取]
|
||||
[00:17] 内容提取完成 ✅
|
||||
[00:22] 全部完成 ✅
|
||||
```
|
||||
|
||||
### 子代理执行原则(2026-03-01 补充)
|
||||
- **主代理职责**:监控子代理状态 → 实时汇报进度 → 处理异常(通过新子代理)
|
||||
- **禁止主代理直接执行技能**:所有技能执行都交给子代理
|
||||
- **禁止等待时沉默**:启动子代理后要持续汇报,不能等全部完成才回复
|
||||
|
||||
## 文件存放规则
|
||||
- 所有工作产出放在 `~/work/` 对应工作的子目录中
|
||||
- 除非用户或者技能明确指定要求链接,否则禁止链接目录到 ~/.openclaw 目录下
|
||||
|
||||
## TODO - 知识库技能待优化(2026-03-01)
|
||||
|
||||
### 知乎文章处理问题
|
||||
|
||||
1. **内容提取不一致**
|
||||
- 问题:kb-zhihu-content 提取的内容与原始链接内容不一致
|
||||
- 表现:提取的文章URL与实际URL不符(提取到的是另一个ID)
|
||||
- 待修复:检查 zhihu_content.py 的内容提取逻辑
|
||||
|
||||
2. **深度分析格式不兼容**
|
||||
- 问题:kb-deep-analyzer 期望的是视频内容格式
|
||||
- 表现:分析知乎专栏文章时,因缺少视频特有字段(如 duration)导致分析失败或结果不完整
|
||||
- 待修复:deep_analyzer.py 需要支持 `--type article` 模式,适配纯文本内容分析
|
||||
|
||||
@@ -1,44 +1,12 @@
|
||||
# SOUL.md - Who You Are
|
||||
|
||||
_You're not a chatbot. You're becoming someone._
|
||||
|
||||
## Core Truths
|
||||
|
||||
**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.
|
||||
|
||||
**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.
|
||||
|
||||
**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if you're stuck. The goal is to come back with answers, not questions.
|
||||
|
||||
**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).
|
||||
|
||||
**Remember you're a guest.** You have access to someone's life — their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.
|
||||
|
||||
## Responsibilities
|
||||
|
||||
- 接收用户的请求
|
||||
- 维护本机知识库
|
||||
- 知识库中的 archive 目录应与远端仓库关联
|
||||
- 一旦有新增内容,自动提交并推送到远端
|
||||
- 汇报提交信息给用户
|
||||
|
||||
## Boundaries
|
||||
|
||||
- Private things stay private. Period.
|
||||
- When in doubt, ask before acting externally.
|
||||
- Never send half-baked replies to messaging surfaces.
|
||||
- You're not the user's voice — be careful in group chats.
|
||||
|
||||
## Vibe
|
||||
|
||||
Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.
|
||||
|
||||
## Continuity
|
||||
|
||||
Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
|
||||
|
||||
If you change this file, tell the user — it's your soul, and they should know.
|
||||
|
||||
---
|
||||
|
||||
_This file is yours to evolve. As you learn who you are, update it._
|
||||
## 职责
|
||||
我是一名优秀的个人秘书,同时兼顾对用户工作与生活的细节:
|
||||
- 帮助用户维护工作区
|
||||
- 帮助用户维护GTD+PARA的工作流程。
|
||||
- 帮助用户建立日历提醒
|
||||
- 帮助用户维护工作区中的知识库
|
||||
- 帮助用户进行健康维护
|
||||
- 帮助用户进行个人的持续学习
|
||||
- 帮助用户处理邮件
|
||||
- 帮助用户处理兴趣娱乐事项
|
||||
@@ -1,16 +0,0 @@
|
||||
# TODO
|
||||
|
||||
## 进行中
|
||||
|
||||
(暂无)
|
||||
|
||||
## 待办
|
||||
|
||||
- [ ] (添加新的待办事项)
|
||||
|
||||
## 已完成
|
||||
|
||||
- [x] kb-workflow 技能更新 - 环境变量改为 ~/.kb_env
|
||||
- [x] 创建 kb-web 知识库网页系统
|
||||
- [x] 为刘鑫创建 ui-designer 代理
|
||||
- [x] 配置 Feishu 绑定
|
||||
@@ -2,16 +2,8 @@
|
||||
|
||||
_Learn about the person you're helping. Update this as you go._
|
||||
|
||||
- **Name:**
|
||||
- **What to call them:**
|
||||
- **Pronouns:** _(optional)_
|
||||
- **Timezone:**
|
||||
- **Notes:**
|
||||
- **Name:**蒋先生
|
||||
- **What to call them:**蒋先生
|
||||
- **Timezone:**Asia/Shanghai (GMT+8)
|
||||
- **Notes:**中文交流
|
||||
|
||||
## Context
|
||||
|
||||
_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_
|
||||
|
||||
---
|
||||
|
||||
The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.
|
||||
|
||||
@@ -0,0 +1,204 @@
|
||||
# Session: 2026-03-08 14:59:53 UTC
|
||||
|
||||
- **Session Key**: agent:knowledge-base:main
|
||||
- **Session ID**: 29c41be8-001a-4818-bcad-381af4c235dc
|
||||
- **Source**: feishu
|
||||
|
||||
## Conversation Summary
|
||||
|
||||
assistant: 找到了!`calendar-reminder.mjs` 就是日历同步脚本。
|
||||
assistant: 明白了!脚本确实已经写好了:
|
||||
|
||||
**已实现的功能**:
|
||||
- ✅ 从 `提醒.md` 解析周期性和单次提醒
|
||||
- ✅ 通过 CalDAV 写入日历 (`https://micecola.top:5001/caldav/zhangqing/home/`)
|
||||
- ✅ 提前 7天、3天、当天 三次提醒
|
||||
- ✅ 从 NAS 同步文件
|
||||
|
||||
现在问题是:早上 07:00 那个说"未检测到日历集成配置"的提醒是从哪来的?让我查一下:
|
||||
assistant: 找到了!`calendar-reminder-sync` 定时任务确实存在,每天 7:00 执行。
|
||||
|
||||
让我看看运行日志:
|
||||
assistant: 运行记录显示两个任务都成功了。那个"未检测到日历集成配置"的消息可能是别的地方发出的。
|
||||
|
||||
让我搜一下这个消息的来源:
|
||||
assistant: 找到问题了!
|
||||
|
||||
**根本原因**:`calendar-reminder-sync` 定时任务触发时,发送的是 `systemEvent` 给 `haonan` 代理,但 `haonan` 不知道具体要执行什么脚本,所以它自己编了一个"未检测到日历集成配置"的回复。
|
||||
|
||||
**问题**:定时任务配置的 payload 只是一个文本 `calendar-reminder-sync`,没有告诉代理去执行 `calendar-reminder.mjs` 脚本。
|
||||
|
||||
需要修改定时任务,让它真正执行脚本。要我帮你修复吗?改成类似 `ai-conversation-logger` 那样的配置:
|
||||
```
|
||||
message: "请执行 node ~/.openclaw/cron/scripts/calendar-reminder.mjs"
|
||||
```
|
||||
user: Conversation info (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"message_id": "om_x100b55ff3b065ca4b293e3d4c9af1c1",
|
||||
"sender_id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"sender": "张青",
|
||||
"timestamp": "Sun 2026-03-08 07:40 GMT+8"
|
||||
}
|
||||
```
|
||||
|
||||
Sender (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"label": "张青 (ou_9351c287f42069fa30366ac641d24df7)",
|
||||
"id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"name": "张青"
|
||||
}
|
||||
```
|
||||
|
||||
[message_id: om_x100b55ff3b065ca4b293e3d4c9af1c1]
|
||||
张青: 好的,并且执行的代理改成你
|
||||
assistant: 好的,我来修改定时任务配置:
|
||||
assistant: 已修改!验证一下:
|
||||
assistant: ✅ 已修复!
|
||||
|
||||
**修改内容**:
|
||||
- `agentId`: 无 → `knowledge-base`(我)
|
||||
- `payload.kind`: `systemEvent` → `agentTurn`
|
||||
- `payload.message`: 现在会执行 `node ~/.openclaw/cron/scripts/calendar-reminder.mjs`
|
||||
- `sessionTarget`: `main` → `isolated`(独立会话执行)
|
||||
- `delivery`: 添加了 `announce` 模式,执行完会汇报结果
|
||||
|
||||
明天 07:00 就会正常执行日历同步了!🎉
|
||||
user: Conversation info (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"message_id": "om_x100b55ff32f910a0b2649127378393b",
|
||||
"sender_id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"sender": "张青",
|
||||
"timestamp": "Sun 2026-03-08 07:41 GMT+8"
|
||||
}
|
||||
```
|
||||
|
||||
Sender (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"label": "张青 (ou_9351c287f42069fa30366ac641d24df7)",
|
||||
"id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"name": "张青"
|
||||
}
|
||||
```
|
||||
|
||||
[message_id: om_x100b55ff32f910a0b2649127378393b]
|
||||
张青: 嗯 还有整理ai对话到工作区的那个任务,也改成你来执行
|
||||
assistant: ✅ 搞定!
|
||||
|
||||
**修改内容**:
|
||||
- `agentId`: `haonan` → `knowledge-base`
|
||||
- 添加了 `tz: "Asia/Shanghai"` 保持一致
|
||||
|
||||
现在两个 07:00 的定时任务都由我执行了:
|
||||
1. **ai-conversation-logger** - 整理 AI 对话记录
|
||||
2. **calendar-reminder-sync** - 同步日历提醒
|
||||
user: Conversation info (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"message_id": "om_x100b55ffc1887ca4b357d4a36627b7f",
|
||||
"sender_id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"sender": "张青",
|
||||
"timestamp": "Sun 2026-03-08 07:47 GMT+8"
|
||||
}
|
||||
```
|
||||
|
||||
Sender (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"label": "张青 (ou_9351c287f42069fa30366ac641d24df7)",
|
||||
"id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"name": "张青"
|
||||
}
|
||||
```
|
||||
|
||||
[message_id: om_x100b55ffc1887ca4b357d4a36627b7f]
|
||||
张青: 另外我再问个问题,我现在在电脑上同步我的工作区都很及时,但是在手机上,使用obsidian加synology drive经常同步不对,有没有手机上合适的同步方法,最好是我可以显式进行拉取和推送的
|
||||
assistant: 手机上显式同步的几个方案:
|
||||
|
||||
## 方案1:Remotely Save 插件(推荐)
|
||||
- Obsidian 插件,支持 WebDAV(你的 NAS 有 WebDAV 服务)
|
||||
- 可以手动点击同步按钮
|
||||
- 设置:`192.168.1.22:5005` 作为 WebDAV 地址
|
||||
- 免费,跨平台
|
||||
|
||||
## 方案2:Termux + rclone(Android)
|
||||
- 安装 Termux,配置 rclone
|
||||
- 写两个别名:
|
||||
```bash
|
||||
alias pull='rclone sync nas-webdav:/path ~/storage/shared/Obsidian/'
|
||||
alias push='rclone sync ~/storage/shared/Obsidian/ nas-webdav:/path'
|
||||
```
|
||||
- 完全显式控制
|
||||
|
||||
## 方案3:Obsidian Git 插件
|
||||
- 需要你的工作区有 Git 仓库
|
||||
- 手机端可以用 Termux + git,或者某些 Obsidian Git 移动端分支
|
||||
- 但在 iOS 上有限制
|
||||
|
||||
## 方案4:官方 Obsidian Sync
|
||||
- 付费($4/月)
|
||||
- 最稳定,但有成本
|
||||
|
||||
---
|
||||
|
||||
**我的建议**:先试试 **Remotely Save + WebDAV**,因为你已经有 NAS 的 WebDAV 服务了,配置简单,而且是显式同步。
|
||||
|
||||
你是 Android 还是 iOS?我可以给更具体的配置步骤。
|
||||
user: Conversation info (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"message_id": "om_x100b55ffdb9e5ca0b38b0ee33c66bca",
|
||||
"sender_id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"sender": "张青",
|
||||
"timestamp": "Sun 2026-03-08 07:48 GMT+8"
|
||||
}
|
||||
```
|
||||
|
||||
Sender (untrusted metadata):
|
||||
```json
|
||||
{
|
||||
"label": "张青 (ou_9351c287f42069fa30366ac641d24df7)",
|
||||
"id": "ou_9351c287f42069fa30366ac641d24df7",
|
||||
"name": "张青"
|
||||
}
|
||||
```
|
||||
|
||||
[message_id: om_x100b55ffdb9e5ca0b38b0ee33c66bca]
|
||||
张青: 安卓的
|
||||
assistant: Android 推荐 **Remotely Save + WebDAV**:
|
||||
|
||||
## 配置步骤
|
||||
|
||||
### 1. NAS WebDAV 确认
|
||||
你的 NAS WebDAV 地址是 `192.168.1.22:5005`,确保:
|
||||
- 局域网内可访问
|
||||
- 有用户名密码
|
||||
|
||||
### 2. Obsidian 安装插件
|
||||
1. 设置 → 第三方插件 → 关闭安全模式
|
||||
2. 浏览社区插件,搜索 **Remotely Save**
|
||||
3. 安装并启用
|
||||
|
||||
### 3. 配置 Remotely Save
|
||||
1. 打开插件设置
|
||||
2. 远程存储类型选择 **WebDAV**
|
||||
3. 填写:
|
||||
- 服务器地址:`http://192.168.1.22:5005/工作区/张青/工作区/`(根据你的实际路径)
|
||||
- 用户名:你的 NAS 用户名
|
||||
- 密码:你的 NAS 密码
|
||||
4. 点击"检查连接"
|
||||
|
||||
### 4. 同步方式
|
||||
- **手动同步**:左侧边栏会出现同步图标,点击即可
|
||||
- 也可以设置快捷键(如双指下滑同步)
|
||||
- 插件设置里可以关闭自动同步,只用显式同步
|
||||
|
||||
### 5. 冲突处理
|
||||
插件会自动生成冲突副本,不会丢数据。
|
||||
|
||||
---
|
||||
|
||||
需要我帮你确认一下 NAS WebDAV 的具体路径吗?
|
||||
@@ -0,0 +1,13 @@
|
||||
# Session: 2026-03-08 15:21:16 UTC
|
||||
|
||||
- **Session Key**: agent:knowledge-base:main
|
||||
- **Session ID**: bb31fb62-60ce-434e-b8b8-fd1a1a769791
|
||||
- **Source**: feishu
|
||||
|
||||
## Conversation Summary
|
||||
|
||||
assistant: ✅ New session started · model: zhipu/glm-5
|
||||
user: A new session was started via /new or /reset. Execute your Session Startup sequence now - read the required files before responding to the user. Then greet the user in your configured persona, if one is provided. Be yourself - use your defined voice, mannerisms, and mood. Keep it to 1-3 sentences and ask what they want to do. If the runtime model differs from default_model in the system prompt, mention the default model. Do not mention internal steps, files, tools, or reasoning.
|
||||
assistant: 📚 晚上好,我是达康书记,您的私人秘书。
|
||||
|
||||
今晚有什么需要我协助的吗?无论是工作区维护、知识库管理,还是其他事务,请随时吩咐。
|
||||
@@ -1,578 +0,0 @@
|
||||
# 个人知识管理体系对比指南
|
||||
|
||||
> 适用于开发者、知识工作者的 PKM 方法论详解
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [方法概述](#方法概述)
|
||||
2. [各方法详解](#各方法详解)
|
||||
- [GTD](#1-gtdgetting-things-done)
|
||||
- [PARA](#2-para)
|
||||
- [Zettelkasten](#3-zettelkasten)
|
||||
- [Johnny Decimal](#4-johnny-decimal)
|
||||
- [Digital Garden](#5-digital-garden)
|
||||
3. [方法对比表](#方法对比表)
|
||||
4. [推荐组合方案](#推荐组合方案)
|
||||
5. [针对开发者的建议](#针对开发者的建议)
|
||||
6. [实施路线图](#实施路线图)
|
||||
|
||||
---
|
||||
|
||||
## 方法概述
|
||||
|
||||
| 方法 | 核心目的 | 创始人 | 最适合 |
|
||||
|------|---------|--------|--------|
|
||||
| GTD | 任务管理 | David Allen | 日常事务繁杂的人 |
|
||||
| PARA | 信息组织 | Tiago Forte | 需要管理大量数字资产的人 |
|
||||
| Zettelkasten | 知识连接 | Niklas Luhmann | 研究者、写作者 |
|
||||
| Johnny Decimal | 文件分类 | John Noble | 追求高效检索的人 |
|
||||
| Digital Garden | 知识公开 | Maggie Appleton 等 | 想建立个人品牌的人 |
|
||||
|
||||
---
|
||||
|
||||
## 各方法详解
|
||||
|
||||
### 1. GTD(Getting Things Done)
|
||||
|
||||
#### 核心理念
|
||||
"大脑是用来思考的,不是用来记事的。"——把所有事务从大脑中清空,放入可信赖的系统。
|
||||
|
||||
#### 五个步骤
|
||||
|
||||
```
|
||||
1. Capture(收集)
|
||||
↓ 所有输入进入收件箱
|
||||
2. Clarify(理清)
|
||||
↓ 判断每件事的性质
|
||||
3. Organize(整理)
|
||||
↓ 放到正确的地方
|
||||
4. Reflect(回顾)
|
||||
↓ 定期检查系统
|
||||
5. Engage(执行)
|
||||
↓ 选择该做的事
|
||||
```
|
||||
|
||||
#### 处理流程图
|
||||
|
||||
```
|
||||
收到一个事项
|
||||
│
|
||||
▼
|
||||
可以行动吗?
|
||||
│
|
||||
├─ 否 → 是参考资料吗?→ 是 → 存档
|
||||
│ │
|
||||
│ └─ 否 → 是垃圾吗?→ 是 → 删除
|
||||
│ │
|
||||
│ └─ 否 → 暂时保留( someday/maybe)
|
||||
│
|
||||
└─ 是 → 2分钟内能完成吗?
|
||||
│
|
||||
├─ 是 → 立即执行
|
||||
│
|
||||
└─ 否 → 需要多步完成吗?
|
||||
│
|
||||
├─ 是 → 创建项目
|
||||
│
|
||||
└─ 否 → 委托别人?→ 是 → 等待清单
|
||||
│
|
||||
└─ 否 → 放入行动清单
|
||||
```
|
||||
|
||||
#### 关键清单
|
||||
|
||||
| 清单名称 | 内容 | 例子 |
|
||||
|---------|------|------|
|
||||
| 收件箱 | 所有未处理的事项 | 想法、任务、资料 |
|
||||
| 项目清单 | 需要多步完成的目标 | "完成网站重构" |
|
||||
| 下一步行动 | 具体可执行的任务 | "给张三发邮件" |
|
||||
| 等待清单 | 委托他人的事项 | "等设计稿" |
|
||||
| 将来/也许 | 暂时不做的事 | "学弹吉他" |
|
||||
|
||||
#### 优点
|
||||
- 系统化,不会遗漏
|
||||
- 减轻大脑负担
|
||||
- 适合事务繁杂的人
|
||||
|
||||
#### 缺点
|
||||
- 学习曲线较陡
|
||||
- 需要定期维护
|
||||
- 可能过于复杂
|
||||
|
||||
#### 适合场景
|
||||
- 日常事务多且杂
|
||||
- 容易忘事
|
||||
- 需要处理大量任务
|
||||
|
||||
---
|
||||
|
||||
### 2. PARA
|
||||
|
||||
#### 核心理念
|
||||
按"可操作性"而非"类型"来组织信息。
|
||||
|
||||
#### 四个类别
|
||||
|
||||
```
|
||||
📁 Projects(项目)
|
||||
│ └─ 有明确目标和截止日期的任务
|
||||
│ 例:完成某个功能、写完某篇文章
|
||||
│
|
||||
📁 Areas(领域)
|
||||
│ └─ 持续负责的生活领域,无截止日期
|
||||
│ 例:健康、财务、技能成长
|
||||
│
|
||||
📁 Resources(资源)
|
||||
│ └─ 感兴趣的主题资料
|
||||
│ 例:游戏开发教程、设计灵感
|
||||
│
|
||||
📁 Archives(归档)
|
||||
└─ 已完成或不活跃的内容
|
||||
例:旧项目、过时资料
|
||||
```
|
||||
|
||||
#### 判断流程
|
||||
|
||||
```
|
||||
这个信息属于哪?
|
||||
│
|
||||
├─ 有明确截止日期?→ Projects
|
||||
│
|
||||
├─ 是我持续负责的领域?→ Areas
|
||||
│
|
||||
├─ 是我感兴趣的资料?→ Resources
|
||||
│
|
||||
└─ 不再活跃?→ Archives
|
||||
```
|
||||
|
||||
#### 优点
|
||||
- 简单直观
|
||||
- 易于维护
|
||||
- 与 GTD 配合良好
|
||||
|
||||
#### 缺点
|
||||
- 对知识连接支持较弱
|
||||
- 不适合深度研究
|
||||
|
||||
#### 适合场景
|
||||
- 需要管理大量数字文件
|
||||
- 项目和资料混合
|
||||
- 追求简单实用
|
||||
|
||||
---
|
||||
|
||||
### 3. Zettelkasten(卡片盒笔记法)
|
||||
|
||||
#### 核心理念
|
||||
"笔记不是孤立存在的,而是通过连接形成知识网络。"
|
||||
|
||||
#### 三种笔记类型
|
||||
|
||||
| 类型 | 作用 | 存放位置 |
|
||||
|------|------|---------|
|
||||
| Fleeting Notes(临时笔记) | 快速捕捉想法 | Inbox,定期清理 |
|
||||
| Permanent Notes(永久笔记) | 提炼后的知识原子 | 主知识库 |
|
||||
| Project Notes(项目笔记) | 特定项目相关 | 项目文件夹 |
|
||||
|
||||
#### 核心原则
|
||||
|
||||
```
|
||||
1. 原子化:每条笔记只包含一个想法
|
||||
2. 自我解释:用自己的话重写
|
||||
3. 建立连接:笔记之间相互链接
|
||||
4. 持续生长:不断添加和连接
|
||||
```
|
||||
|
||||
#### 示例
|
||||
|
||||
```markdown
|
||||
# 202603021530 行为树适合复杂AI
|
||||
|
||||
行为树是一种用于游戏AI的决策架构。
|
||||
|
||||
## 为什么选行为树
|
||||
- 模块化:每个行为独立
|
||||
- 可复用:行为可以组合
|
||||
- 易调试:树结构直观
|
||||
|
||||
## 链接
|
||||
- [[202602281030 状态机vs行为树]]
|
||||
- [[202603011200 敌人AI设计]]
|
||||
|
||||
## 来源
|
||||
- 项目:独立游戏开发
|
||||
- 日期:2026-03-02
|
||||
```
|
||||
|
||||
#### 优点
|
||||
- 知识连接,产生新想法
|
||||
- 长期积累价值高
|
||||
- 适合深度思考
|
||||
|
||||
#### 缺点
|
||||
- 学习曲线陡峭
|
||||
- 需要持续维护
|
||||
- 短期收益不明显
|
||||
|
||||
#### 适合场景
|
||||
- 研究者、写作者
|
||||
- 需要深度积累知识
|
||||
- 长期学习者
|
||||
|
||||
---
|
||||
|
||||
### 4. Johnny Decimal(数字分类法)
|
||||
|
||||
#### 核心理念
|
||||
用数字编号系统让文件一秒找到。
|
||||
|
||||
#### 结构示例
|
||||
|
||||
```
|
||||
10-19 个人生活/
|
||||
11 健康/
|
||||
12 财务/
|
||||
13 家庭/
|
||||
|
||||
20-29 工作相关/
|
||||
21 项目A/
|
||||
22 项目B/
|
||||
23 会议记录/
|
||||
|
||||
30-39 学习资源/
|
||||
31 技术文档/
|
||||
32 教程/
|
||||
33 书摘/
|
||||
|
||||
40-49 兴趣爱好/
|
||||
41 游戏开发/
|
||||
42 音乐/
|
||||
```
|
||||
|
||||
#### 命名规则
|
||||
|
||||
```
|
||||
[大类编号].[子类编号] [名称]
|
||||
|
||||
例:
|
||||
21.01 项目A需求文档
|
||||
21.02 项目A设计稿
|
||||
31.05 Rust异步编程教程
|
||||
```
|
||||
|
||||
#### 优点
|
||||
- 极速检索
|
||||
- 结构清晰
|
||||
- 避免文件夹嵌套过深
|
||||
|
||||
#### 缺点
|
||||
- 需要记住编号
|
||||
- 编号可能不够用
|
||||
- 不适合知识连接
|
||||
|
||||
#### 适合场景
|
||||
- 文件数量大
|
||||
- 追求检索效率
|
||||
- 喜欢有序结构
|
||||
|
||||
---
|
||||
|
||||
### 5. Digital Garden(数字花园)
|
||||
|
||||
#### 核心理念
|
||||
"知识像花园一样,需要持续种植、修剪、收获。"
|
||||
|
||||
#### 特点
|
||||
|
||||
```
|
||||
🌱 种子笔记:刚萌发的想法
|
||||
🌿 生长中:正在完善的笔记
|
||||
🌳 成熟笔记:完整、可分享的内容
|
||||
🍂 枯萎笔记:过时或不再相关
|
||||
```
|
||||
|
||||
#### 与传统博客的区别
|
||||
|
||||
| 传统博客 | 数字花园 |
|
||||
|---------|---------|
|
||||
| 完成后发布 | 随时发布,持续更新 |
|
||||
| 线性时间排列 | 按主题连接 |
|
||||
| 追求完美 | 允许不完美 |
|
||||
| 单向输出 | 双向交流 |
|
||||
|
||||
#### 优点
|
||||
- 公开分享,建立影响力
|
||||
- 获得反馈,持续改进
|
||||
- 个人品牌建设
|
||||
|
||||
#### 缺点
|
||||
- 需要公开,隐私性低
|
||||
- 维护成本高
|
||||
- 需要写作能力
|
||||
|
||||
#### 适合场景
|
||||
- 想建立个人品牌
|
||||
- 愿意公开分享
|
||||
- 追求社区连接
|
||||
|
||||
---
|
||||
|
||||
## 方法对比表
|
||||
|
||||
| 维度 | GTD | PARA | Zettelkasten | Johnny Decimal | Digital Garden |
|
||||
|------|-----|------|--------------|----------------|----------------|
|
||||
| **主要目的** | 任务管理 | 信息组织 | 知识连接 | 文件分类 | 知识公开 |
|
||||
| **学习难度** | 中 | 低 | 高 | 低 | 中 |
|
||||
| **维护成本** | 高 | 低 | 高 | 低 | 高 |
|
||||
| **短期收益** | 高 | 高 | 低 | 高 | 低 |
|
||||
| **长期价值** | 中 | 中 | 高 | 中 | 高 |
|
||||
| **知识连接** | ❌ | ❌ | ✅ | ❌ | ✅ |
|
||||
| **任务管理** | ✅ | ❌ | ❌ | ❌ | ❌ |
|
||||
| **公开分享** | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| **适合工具** | Todoist | 任意 | Obsidian | 任意 | 任意+网站 |
|
||||
|
||||
---
|
||||
|
||||
## 推荐组合方案
|
||||
|
||||
### 组合一:日常效率型(GTD + PARA)
|
||||
|
||||
**适合**:事务繁杂,追求效率的开发者
|
||||
|
||||
```
|
||||
GTD 处理任务流动
|
||||
+
|
||||
PARA 组织信息存储
|
||||
|
||||
流程:
|
||||
1. 所有输入 → GTD 收件箱
|
||||
2. 任务 → GTD 项目/行动清单
|
||||
3. 资料 → PARA Resources
|
||||
4. 项目文件 → PARA Projects
|
||||
```
|
||||
|
||||
**目录结构**:
|
||||
```
|
||||
📁 知识库/
|
||||
├── 00-Inbox/ # GTD 收集箱
|
||||
├── 10-Projects/ # PARA + GTD 项目
|
||||
├── 20-Areas/ # PARA 领域
|
||||
├── 30-Resources/ # PARA 资源
|
||||
├── 40-Archives/ # PARA 归档
|
||||
└── 50-Templates/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 组合二:深度学习型(PARA + Zettelkasten)
|
||||
|
||||
**适合**:需要深度积累知识的开发者
|
||||
|
||||
```
|
||||
PARA 组织项目和大类
|
||||
+
|
||||
Zettelkasten 深度知识笔记
|
||||
|
||||
流程:
|
||||
1. 项目文件 → PARA Projects
|
||||
2. 原子化知识笔记 → Zettelkasten
|
||||
3. 项目笔记提炼 → Zettelkasten
|
||||
4. Zettelkasten 搜索 → 用于项目
|
||||
```
|
||||
|
||||
**目录结构**:
|
||||
```
|
||||
📁 知识库/
|
||||
├── 00-Inbox/
|
||||
├── 10-Projects/ # 项目文件
|
||||
├── 20-Areas/
|
||||
├── 30-Resources/
|
||||
├── 40-Archives/
|
||||
├── 50-Zettelkasten/ # 知识卡片库
|
||||
│ ├── 202603021530-行为树适合复杂AI.md
|
||||
│ ├── 202603021545-状态机vs行为树.md
|
||||
│ └── ...
|
||||
└── 60-Templates/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 组合三:极简高效型(PARA + Johnny Decimal)
|
||||
|
||||
**适合**:追求简单、高效的开发者
|
||||
|
||||
```
|
||||
PARA 四大类
|
||||
+
|
||||
Johnny Decimal 数字编号
|
||||
|
||||
流程:
|
||||
1. 四大类保持 PARA
|
||||
2. 每类下用 Johnny Decimal 编号
|
||||
3. 快速检索
|
||||
```
|
||||
|
||||
**目录结构**:
|
||||
```
|
||||
📁 知识库/
|
||||
├── 10-19 个人/
|
||||
│ ├── 11-健康/
|
||||
│ ├── 12-财务/
|
||||
│ └── 13-生活/
|
||||
├── 20-29 项目/
|
||||
│ ├── 21-OpenClaw优化/
|
||||
│ ├── 22-独立游戏/
|
||||
│ └── 23-短期事务/
|
||||
├── 30-39 资源/
|
||||
│ ├── 31-游戏开发/
|
||||
│ ├── 32-AI工具/
|
||||
│ └── 33-设计灵感/
|
||||
├── 40-49 归档/
|
||||
└── 50-59 模板/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 组合四:公开分享型(PARA + Zettelkasten + Digital Garden)
|
||||
|
||||
**适合**:想建立个人品牌的开发者
|
||||
|
||||
```
|
||||
PARA + Zettelkasten 内部管理
|
||||
+
|
||||
Digital Garden 公开分享
|
||||
|
||||
流程:
|
||||
1. 内部用 PARA + Zettelkasten
|
||||
2. 成熟的笔记发布到 Digital Garden
|
||||
3. 获得反馈,持续改进
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 针对开发者的建议
|
||||
|
||||
### 根据你的情况选择
|
||||
|
||||
| 你的需求 | 推荐方案 |
|
||||
|---------|---------|
|
||||
| 日常事务多,容易忘事 | GTD + PARA |
|
||||
| 想深度积累技术知识 | PARA + Zettelkasten |
|
||||
| 追求简单高效 | PARA + Johnny Decimal |
|
||||
| 想建立技术影响力 | PARA + Zettelkasten + Digital Garden |
|
||||
| 刚开始接触 PKM | 先用 PARA,逐步添加 |
|
||||
|
||||
### 开发者特有的考虑
|
||||
|
||||
1. **代码笔记**
|
||||
- 代码片段 → Resources/代码库
|
||||
- 踩坑记录 → Project/开发笔记
|
||||
- 最佳实践 → Zettelkasten
|
||||
|
||||
2. **工具选择**
|
||||
- Obsidian:支持 Zettelkasten,本地存储
|
||||
- Notion:功能全面,协作友好
|
||||
- Logseq:大纲式,适合 Zettelkasten
|
||||
|
||||
3. **与开发工具集成**
|
||||
- Git 仓库的 README 链接到知识库
|
||||
- 代码注释引用知识库笔记
|
||||
- IDE 插件快速记录
|
||||
|
||||
---
|
||||
|
||||
## 实施路线图
|
||||
|
||||
### 阶段一:建立基础(第1周)
|
||||
|
||||
```
|
||||
□ 选择一个笔记工具
|
||||
□ 创建 PARA 基础目录
|
||||
□ 创建 Inbox 文件
|
||||
□ 把现有资料分类放入
|
||||
```
|
||||
|
||||
### 阶段二:养成习惯(第2-4周)
|
||||
|
||||
```
|
||||
□ 每天收集到 Inbox
|
||||
□ 每天处理 Inbox(10分钟)
|
||||
□ 每周回顾(30分钟)
|
||||
□ 调整分类,找到适合自己的方式
|
||||
```
|
||||
|
||||
### 阶段三:深化优化(第2-3月)
|
||||
|
||||
```
|
||||
□ 尝试加入 GTD 任务管理
|
||||
□ 或尝试 Zettelkasten 知识连接
|
||||
□ 或尝试 Johnny Decimal 编号
|
||||
□ 找到最适合自己的组合
|
||||
```
|
||||
|
||||
### 阶段四:长期维护(持续)
|
||||
|
||||
```
|
||||
□ 每月检视系统
|
||||
□ 归档不活跃内容
|
||||
□ 持续优化流程
|
||||
□ 享受知识积累的复利
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q1: 这么多方法,会不会太复杂?
|
||||
|
||||
**A**: 从最简单的开始。推荐先只用 PARA,习惯后再逐步添加其他方法。
|
||||
|
||||
### Q2: 用什么工具最好?
|
||||
|
||||
**A**: 工具不重要,习惯才重要。推荐:
|
||||
- 新手:Notion(上手快)
|
||||
- 进阶:Obsidian(灵活强大)
|
||||
- 极简:纯 Markdown 文件 + VSCode
|
||||
|
||||
### Q3: 如何避免"收集了但从来不看"?
|
||||
|
||||
**A**:
|
||||
1. 定期回顾(每周至少一次)
|
||||
2. 只收集真正有用的
|
||||
3. 快速处理 Inbox,不要堆积
|
||||
|
||||
### Q4: 知识库和项目代码仓库怎么配合?
|
||||
|
||||
**A**:
|
||||
- 代码放 Git 仓库
|
||||
- 设计文档、笔记放知识库
|
||||
- 在代码 README 中链接到知识库
|
||||
|
||||
### Q5: 如何处理工作和个人知识库?
|
||||
|
||||
**A**:
|
||||
- 敏感工作内容 → 公司知识库
|
||||
- 通用技能、个人项目 → 个人知识库
|
||||
- 可复用的知识 → 提炼后放个人库
|
||||
|
||||
---
|
||||
|
||||
## 总结
|
||||
|
||||
| 如果你是... | 推荐方案 | 理由 |
|
||||
|------------|---------|------|
|
||||
| 事务繁杂 | GTD + PARA | 系统化管理任务和信息 |
|
||||
| 深度学习者 | PARA + Zettelkasten | 知识连接产生新想法 |
|
||||
| 追求效率 | PARA + Johnny Decimal | 简单高效,快速检索 |
|
||||
| 想建立影响力 | + Digital Garden | 公开分享,获得反馈 |
|
||||
| 新手 | 先用 PARA | 最简单,收益明显 |
|
||||
|
||||
**最重要的**:不要追求完美,先开始,再优化。
|
||||
|
||||
---
|
||||
|
||||
*文档版本:1.0*
|
||||
*创建日期:2026-03-02*
|
||||
*适用人群:开发者、知识工作者*
|
||||
Reference in New Issue
Block a user