pnyn96/mindact-agent

项目介绍

MindAct 被描述为一个个人知识助手：它把 Obsidian 笔记库与 Claude、检索增强生成（RAG）连接起来，索引 Markdown 笔记并回答基于用户自己文档的问题。README 给出的使用入口是 Discord 或 Telegram 机器人，通过斜杠命令完成连接笔记库、同步、提问、记录想法、总结、建议链接、自动打标签和查重等操作。

按照 README 的说法，知识管理部分在本地运行，而 AI 推理步骤需要连接 Claude，因此查询相关的上下文会被发送出去处理。项目以 MIT 许可证发布。

快速使用

README 没有提供基于源码的安装或首次运行流程。系统要求列出 Windows 10/11 与 PowerShell 5.1+ 或 7+，并放置了一个 PowerShell 命令按钮，指向外部的项目页面 安装入口。要按描述使用，需要从该外部页面获取软件，然后配置 Claude API key、笔记库路径和 RAG 参数，再启用 Discord 或 Telegram 机器人并填入 token 配置说明。

README 中没有可核验的命令序列、仓库构建步骤或聊天机器人接入步骤，因此无法根据现有材料还原准确的安装和启动命令。唯一给出的官方入口是外部项目页面 项目页面。

命令与配置

命令列表包括 /start、/connect、/sync、/status、/ask、/capture、/summarize、/link、/graph、/tag 和 /review。README 说明涉及写入笔记库的命令会先请求确认，长时间任务会在聊天中报告进度，缺失的配置项会被明确指出 命令说明。

配置分为 Claude 连接、Obsidian 笔记库路径、RAG 参数、机器人 token 和代理行为几组。默认会索引子文件夹，嵌入模型可以更换，Discord 和 Telegram 集成默认关闭，需要手动开启 配置说明。

使用约束

• 按 README 的系统要求，仅支持 Windows，并依赖 PowerShell。
• AI 推理需要网络访问 Claude，并需要 API key 或受支持的订阅；本地知识文件据称保留在磁盘上。
• README 称核心支持的格式为 Markdown 和标准文本；PDF 与表格的支持情况并不明确。
• README 没有给出安装命令、源码构建步骤、版本历史或可复现的软件获取方式，用户无法确认 PowerShell 按钮下载的内容。
• 仓库的 Topics 混入了 Office 激活、KMS38、Massgrave 等与知识助手无关的条目，和项目描述不一致。

HotRepo 点评

该项目在 2026-11-07 被记录到新项目 TypeScript 榜，当时有 149 星，约一小时内增加 36 星，该窗口内 Fork 数为 0。观察时间很短，也没有拿到全部语言日榜名次，因此不足以说明持续采用情况。功能叙述比较完整，但缺少实现和安装细节，再加上与激活、盗版相关的无关 Topics，是运行外部页面内容前最值得核查的信号。