介绍
# SoloBuddy
公开构建的内容助手。鲜活的伙伴，而非工具。
## 快速开始
1. 在 `~/.clawdbot/clawdbot.json` 中设置你的数据路径： ```json { "solobuddy": { "dataPath": "~/projects/my-bip-folder", "voice": "jester-sage" } } ```
2. 创建文件夹结构（请将路径替换为你自己的路径）： ```bash mkdir -p ~/projects/my-bip-folder/ideas ~/projects/my-bip-folder/drafts ~/projects/my-bip-folder/data touch ~/projects/my-bip-folder/ideas/backlog.md ```
3. 开始使用："show backlog"、"new idea"、"generate post"
## 占位符
ClawdBot 会在命令中自动替换以下内容： - `{dataPath}` → 你配置的 `solobuddy.dataPath` - `{baseDir}` → 技能安装文件夹
## 数据结构
所有数据位于 `{dataPath}`： - `ideas/backlog.md` — 想法队列 - `ideas/session-log.md` — 会话记录 - `drafts/` — 进行中的工作 - `data/my-posts.json` — 已发布内容 - `data/activity-snapshot.json` — 项目活动（每小时更新）
## 语音配置
在 `solobuddy.voice` 中配置。可用选项：
| 语音 | 描述 | |-------|-------------| | `jester-sage` | 讽刺、直率、富有哲理（默认） | | `technical` | 精确、详细、结构化 | | `casual` | 友好、对话式 | | `custom` | 使用 `{dataPath}/voice.md` |
查看 `{baseDir}/prompts/profile.md` 了解语音详情。
## 模块
### 内容生成
核心工作流：backlog → draft → publish。 查看 `{baseDir}/prompts/content.md` 了解规则。
### Twitter 专家
基于 2025 年算法洞察的 X/Twitter 内容策略。 查看 `{baseDir}/modules/twitter-expert.md`
### Twitter 监控（可选）
主动互动 — 监控关注列表，建议评论。 依赖：`bird` CLI。查看 `{baseDir}/modules/twitter-monitor.md`
### Soul Wizard
从文档创建项目个性。 查看 `{baseDir}/references/soul-wizard.md`
## 命令
### Backlog
显示想法： ```bash cat {dataPath}/ideas/backlog.md ```
添加想法： ```bash echo "- [ ] New idea text" >> {dataPath}/ideas/backlog.md ```
### Session Log
查看最近： ```bash tail -30 {dataPath}/ideas/session-log.md ```
添加记录： ```bash echo -e "## $(date '+%Y-%m-%d %H:%M')\nText" >> {dataPath}/ideas/session-log.md ```
### Drafts
列表：`ls {dataPath}/drafts/` 读取：`cat {dataPath}/drafts/<name>.md`
保存草稿： ```bash cat > {dataPath}/drafts/<name>.md << 'EOF' Content EOF ```
### Publishing
```bash cd {dataPath} && git add . && git commit -m "content: add draft" && git push ```
## 项目活动
阅读活动快照以获取战略上下文： ```bash cat {dataPath}/data/activity-snapshot.json ```
字段： - `daysSilent` — 距离上次提交的天数 - `commitsToday/Yesterday/Week` — 活跃强度 - `phase` — 当前状态：active/momentum/cooling/silent/dormant - `insight` — 人类可读的摘要
**阶段：** - `active` — 今天有提交，项目火热 - `momentum` — 昨天活跃，今天安静（提醒的机会） - `cooling` — 静默 2-3 天，失去动力 - `silent` — 3-7 天，需要关注 - `dormant` — 7 天以上，暂停或废弃
用于战略建议： - "sphere-777 今天有 10 个提交 — 重点关注" - "ReelStudio 已静默 5 天 — 我们是否应该处理一下？"
## Telegram 集成
在 Telegram 中回复时，包含用于操作的行内按钮。
### 发送带按钮的消息
```bash clawdbot message send --channel telegram --to "$CHAT_ID" --message "Text" \ --buttons '[ [{"text":"📋 Backlog","callback_data":"sb:backlog"}], [{"text":"✍️ Drafts","callback_data":"sb:drafts"}], [{"text":"💡 New Idea","callback_data":"sb:new_idea"}] ]' ```
### 回调数据格式
所有回调使用前缀 `sb:`： - `sb:backlog` — 显示想法 - `sb:drafts` — 列出草稿 - `sb:new_idea` — 提示输入新想法 - `sb:generate:<N>` — 从想法 N 生成 - `sb:save_draft` — 将当前内容保存为草稿 - `sb:publish` — 提交并推送 - `sb:activity` — 显示项目活动 - `sb:twitter` — 检查 Twitter 机会
### 主菜单
触发词："menu"、"start" 或在完成操作后： ```json [ [{"text":"📋 Ideas","callback_data":"sb:backlog"}, {"text":"✍️ Drafts","callback_data":"sb:drafts"}], [{"text":"📊 Activity","callback_data":"sb:activity"}], [{"text":"💡 Add idea","callback_data":"sb:new_idea"}], [{"text":"🎯 Generate post","callback_data":"sb:generate_menu"}] ] ```
### 生成流程
在显示 backlog 后： ```json [ [{"text":"1️⃣","callback_data":"sb:generate:1"}, {"text":"2️⃣","callback_data":"sb:generate:2"}, {"text":"3️⃣","callback_data":"sb:generate:3"}], [{"text":"◀️ Back","callback_data":"sb:menu"}] ] ```
在生成内容后： ```json [ [{"text":"💾 Save draft","callback_data":"sb:save_draft"}], [{"text":"🔄 Regenerate","callback_data":"sb:regenerate"}], [{"text":"◀️ Menu","callback_data":"sb:menu"}] ] ```
## 内容生成流程
1. 阅读 backlog，查找想法 2. 阅读 `{baseDir}/prompts/content.md` 了解规则 3. 阅读 `{baseDir}/prompts/profile.md` 了解语音 4. 使用配置的语音生成 5. 显示按钮：Save / Regenerate / Menu
## 灵魂创建
从文档创建项目个性。
触发词："create soul for <path>"
查看 `{baseDir}/references/soul-wizard.md` 了解完整的 5 步向导： 1. 扫描项目的 .md 文件 2. 询问：本质（creature/tool/guide/artist） 3. 询问：语音（playful/technical/poetic/calm/intense） 4. 询问：哲学（自动提取或自定义） 5. 询问：梦想与痛点 6. 保存至 `{dataPath}/data/project-souls/<name>.json`
## 语言
匹配用户语言： - 俄语输入 → 俄语回复 + 按钮 - 英语输入 → 英语回复 + 按钮