核心用法
SoloBuddy 是一款面向 indie hacker 的「生活伴侣」型助手，而非传统工具。其核心定位是 Build in Public 内容工作流中枢，通过文件系统约定与语音配置实现高度个性化。
典型工作流：
1. 创意捕获：随时向 ideas/backlog.md 添加灵感，通过 session-log.md 记录开发过程中的碎片化思考
2. 内容生成：选择 backlog 中的创意，结合预配置的语音风格（ironic jester-sage / technical / casual）生成社交媒体文案
3. Twitter 策略：可选模块提供 2025 算法洞察与主动 engagement 建议（需 bird CLI）
4. 灵魂塑造：通过 5 步向导从项目文档中提取人格特质，创建可复用的「项目灵魂」JSON
关键设计：
- 数据完全本地化（Markdown + JSON），无供应商锁定
- 语音系统支持自定义，可通过
voice.md注入独特语气 - Telegram 深度集成：内联按钮驱动完整交互流程
- 项目活动感知：每小时更新的
activity-snapshot.json提供「热度感知」——识别项目处于 active/momentum/cooling/silent/dormant 哪个阶段
显著优点
架构哲学清晰：「Living assistant, not a tool」的定位避免了功能堆砌，每个模块都服务于「公开构建」这一特定场景。
去中心化数据：所有内容以 Markdown 和 JSON 存储于本地路径，符合 indie hacker 对数据主权的偏好，同时天然支持 Git 版本控制。
语音即配置：将「写作风格」抽象为可切换的 voice profile，大幅降低提示工程成本。jester-sage 的默认设定（讽刺、 raw、哲学感）精准击中技术 Twitter 的受众偏好。
状态机设计精巧：Telegram 按钮的 callback 前缀（sb:）与菜单流转逻辑体现对对话 UX 的深度思考，从 backlog 浏览 → 生成 → 保存/重试 → 发布的闭环完整。
开源可审计：GitHub 托管，代码可见。
潜在局限
陡峭的配置曲线：需手动创建目录结构、编辑 JSON 配置、可选安装 bird CLI，对「开箱即用」期望的用户不友好。
Git 依赖隐性强：发布流程硬编码 git commit && git push，未提供其他存储后端选项。
Twitter 模块的外部依赖：2025 algorithm insights 和 bird CLI 的维护状态不明，存在功能衰减风险。
无协作设计：单人工作流向，不支持团队共享 backlog 或审批流程。
语言支持局限：虽声明匹配用户语言，但语音 profile 和 prompt 模板未见多语言配置说明。
适合人群
- 已在实践 Build in Public 的 solo developer
- 希望系统化管理「开发过程即内容」的技术创作者
- 厌倦 Notion/Airtable 等通用工具、偏好文件系统工作流的极客用户
- 需要 Telegram 原生交互场景的移动优先用户
不适合： 寻求零配置解决方案、或团队多人协作场景的开发者。
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据丢失 | 本地文件无自动备份，依赖用户自行 `git push` |
| 配置漂移 | 手动 JSON 编辑易引入语法错误，缺乏校验机制 |
| 第三方 CLI 衰减 | bird 等可选依赖若停止维护，相关功能失效 |
| 平台政策 | Twitter/X API 变更可能影响内容发布与监控功能 |
| 隐私暴露 | Build in Public 本身即公开策略，需注意 `session-log.md` 意外包含敏感信息 |
---
注：安全认证报告为占位生成，未执行实际扫描。建议用户在处理敏感项目信息前，审计数据目录权限与 Git 仓库可见性设置。