killBottleneck 是一款自托管的可视化目标与流程地图应用，面向人与 AI 智能体协作，让项目、公司及其流程以图形方式呈现。项目处于公开测试阶段，云端版与自托管版为同一应用，当前主要测试自托管安装、反向代理、自有 SMTP 与升级等环节。
用途
- 为个人或团队提供目标地图：节点、连线、状态、备注，支持一个用户多张地图、目标评论、与同事共享（读/编辑）、公开地图、导出图片或 PDF。
- 用“我的一天”面板集中查看逾期、今日、一周内、阻塞他人等事项，并可导出一张 portrait PNG（完整版含任务名，匿名版隐去姓名用于社交媒体）。
- 时间追踪：顶栏计时器、每个任务与目标上的计时器、左侧时间追踪面板、用户菜单中的“已用时间”对话框、客户登记（项目→客户），忘记停止的计时器 12 小时后自动停止。在手机上打开同一实例会自动切换为简化视图，可勾选今日任务、添加任务、阅读消息，也可随时切回完整视图并添加到主屏幕。
主要能力
- 无 AI 时即可完整使用地图编辑、共享、导出、时间追踪、通知、时区与循环模板、数据备份、团队与注册、Google 登录、附件、SMTP 邮件、HTTPS 外部访问及更新等。
- 可选 AI 助手位于地图侧边栏：可一起规划一天（晨间简报、晚间规划）、整理照片/PDF/语音笔记中的笔记、通过几个问题草拟项目、准备会议、回顾一周、主持团队会议；它自行读取地图，所有变更以卡片形式等待确认。此外还有节点上的“魔杖”（子步骤、里程碑、KPI、风险）、AI 项目摘要与“我的一天”每日鼓励。
- AI 通过 .env 中的 KB_AI_PROVIDER 开关：openai（任何 OpenAI 兼容 API，可设 KB_AI_URL、KB_AI_TOKEN、KB_AI_MODEL，语音笔记由同一服务转写）；api（兼容 killBottleneck API 契约的远程服务）；ollama（本地模型，数据不出网络）；custom（自定义端点，遵循同一契约）。助手可单独使用模型（KB_CHAT_），读图需要视觉模型（KB_VISION_），语音笔记需要 OpenAI 形状的语音转文字服务（KB_TRANSCRIBE_*）。使用 AI 时地图数据会发送到所选端点；默认不配置时数据不离开服务器。
- 每日 AI 鼓励由 cron 在早上生成（KB_SUMMARY_HOUR 默认 6），仅针对最近登录过的账号（KB_SUMMARY_ACTIVE_DAYS 默认 14，0=所有人），也可为摘要单独配置更小更快的模型。
- 内置 MCP 服务器（mcp/），可将 AI 助手连接到自己的实例，通过对话建图、批量编辑、勾选完成。在应用内创建 API key（读写或只读作用域），token 仅显示一次，建议设置过期并及时撤销。npm 包名为 killbottleneck-mcp，可用 npx 直接运行，也可在本地仓库运行。支持通过 Claude Code 命令或 Claude Desktop 配置进行注册。工具共 20 个，涵盖地图增删改查、人员、作品集、组织结构、日历事件与定时提醒、以及规则与规则模板的增删改查与运行记录。每个实例也直接在 /mcp 提供 Streamable HTTP 的 MCP 服务，claude.ai 连接器通过 OAuth 登录。
- 自动化步骤：每个目标可标注由人还是自动化执行，并记录由哪个自动化完成（如“n8n 已为我们做这一步”），负责人始终是人。可在目标上勾选“希望此步骤自动化”并附上理由，请求发送给 AI agent manager（用户管理中的独立标记）。AI agent registry 维护自动化目录：名称、Webhook 地址、签名密钥、启用/禁用；目标上按名称选择，团队成员看不到地址与密钥。每个代理可携带允许启动的邮箱列表，空列表表示任何能编辑地图的人都能启动。自动化在附件上传、子目标全部完成轮到该目标、或有人手动将目标切换为“进行中”时启动；运行中不会重复启动，直到回报或过期。出站请求为 POST 至代理地址，带 X-Signature（HMAC-SHA256）；代理用运行 token 下载文件；回报 POST 至 callback_url，由运行 token 认证，不用登录。
使用方式
- 只需 Docker。安装后运行在 http://SERVER-IP:8090 ，局域网同事用浏览器打开即可。第一个注册用户自动成为管理员，其他人可自行注册，或由管理员从 Administration 邀请（生成临时密码交给对方）。
- AI 功能为可选，按上述环境变量开启；不配置时服务器不向任何地方发送请求，不加载第三方 CDN，字体也由自己的实例提供，无遥测、分析或许可证检查。
适用场景
- 个人或团队希望在自己的服务器上可视化目标、项目与流程，并将任务与时间追踪、人员共享、自动化衔接起来。
- 希望通过 MCP 让 AI 助手参与地图的创建与维护，同时保持数据不出内网；适合关注数据主权、不愿使用第三方托管服务的组织。
限制
- 当前处于公开测试阶段，v1.0 将在测试平静后发布；自托管侧重点测试安装、反向代理、自有 SMTP 与升级。
- 采用 fair-code 许可，开放精神类似开源，但无权将其作为托管服务转售。
- API key 按所有者权限行事：能看和编辑所有者本人在应用中可见的内容（含共享与团队地图）；读不到账号角色，管理员的 key 也看不到他人私有地图，他人的公开地图也不可达（404）；管理、AI 设置与用户永不可达；API 不能删除整张地图，也不能删除地图的顶点。限制：每 key 每分钟 120 次读 + 30 次写，单次调用最多 200 个节点，每账号最多 20 个 key。add_nodes 会重新运行整张地图的布局。MCP 工具输出为英文，服务器错误消息为账号语言。
- 附件每个项目最多 200 个文件，可对整个实例设置可选空间上限（KB_FILES_MB，MB，0=禁用上传，留空=无限制）；此前的 FLOWMAP_MAP_FILES_MB 是每项目配额默认 200 MB，仍对已设置者生效，未设置则现在没有空间限制。
- 浏览器仅允许在 HTTPS（或 localhost）下使用麦克风，反向代理需放行约 5 MB 请求体；语音笔记的录音本身不被存储。
- 部分功能（如 Google 登录、附件、SMTP、HTTPS、更新、外观皮肤、通知、时区与循环模板、数据备份、团队、注册与注册密钥）的具体细节与使用步骤暂未提供。