AI导哈

人工智能员工基础框架

一个本地运行的AI员工基础框架，通过Obsidian知识库和Python监听脚本实现工作自动化管理。

  • by DoniaBatool
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 DoniaBatool/Personal-AI-Employee

使用说明

个人人工智能员工-铜级（数字全职员工基金会）

该项目是 青铜级 的 个人AI员工/数字全职员工 概念从 Personal AI Employee Hackathon 0_ Building Autonomous FTEs in 2026.md.

目标是建立 基础层 a 数字FTE（全职等效）：一名在自己的机器上运行的人工智能员工，监视你的输入（电子邮件、文件等），并使用人工智能推理引擎通过本地黑曜石保险库来组织你的工作和生活。

这种人工智能并不是“只是一个聊天机器人”，而是表现得像一个 初级运营员工 即：

  • 自动唤醒 当重要的事情发生时（新的电子邮件、文件或消息）。
  • 撰写任务和摘要 进入你的黑曜石金库。
  • 保留一个工作项目收件箱 (Needs_Action)以及已完成工作的历史(Done).

本README主要关注 青铜级 基金会以及该回购协议是如何构建的。

1.什么是数字全职员工？

A. 数字FTE 是一个定制的人工智能代理，你可以像雇佣人类员工一样“雇佣”它，但是：

  • 全天候工作（每周168小时） 而不是每周40小时。
  • 成本很低 一个人类全职员工。
  • 可以是 立即复制 一旦设计完成（复制设置、技能和观察者）。

对于这个青铜级别，我们实施了 最小可行数字FTE:

  • 当地的黑曜石金库充当 仪表板和长期记忆.
  • 一个或多个 监视器脚本 （Python）充当 感官.
  • AI引擎（例如Claude Code）充当 大脑在保险库中读写标记。

更高的级别（银/金/白金）通过更多的集成和自动化扩展了这一点，但该项目的重点是获得 坚实的工作基础.

2.本次回购的青铜级范围

根据黑客马拉松规范， 青铜级 包括：

  • 黑曜石拱顶 至少：
    • Dashboard.md
    • Company_Handbook.md
  • 一个可用的Watcher脚本 （例如Gmail监视器或文件系统监视器）。
  • Claude Code或其他法学硕士 成功读取和写入保险库。
  • 基本文件夹结构 保险库内：
    • Inbox/ （可选，具体取决于您的设计）
    • Needs_Action/
    • Done/
  • 所有AI逻辑表示为 代理技能 或可重复的提示，而不仅仅是临时聊天。

此存储库的结构支持该基础（代码、观察者和文档），因此您可以在以后发展到银牌、金牌和白金级别。

3.技术栈概述

本项目中使用的核心组件：

  • AI推理引擎

    • 主要的，重要的 克劳德代码 （通过终端/CLI）。
    • 替代方案：通过可以在vault中读/写文件的工具公开的任何LLM。

  • 知识库和UI

    • 黑曜石 （本地首个Markdown库）。
    • 商店：
      • Dashboard.md （高级状态）。
      • Company_Handbook.md （人工智能员工的规则和政策）。
      • Needs_Action/, Done/, Plans/等作为文件夹。

  • 观察者（Python）

    • 在后台运行的小型Python脚本：
      • 例子： 文件系统监视器 将新文件移动或复制到 Needs_Action/.
      • 例子： Gmail观察程序 这会将重要的未读电子邮件转化为标记任务。

  • 自动化与操作系统

    • Python 3.13+
    • macOS（达尔文） 为了发展。
    • 可选： cron, pm2，或另一个进程管理器来保持观察者的活动。

  • （扩展可选）MCP服务器

    • 对于更高层， 模型上下文协议（MCP） 可以添加服务器用于：
      • 发送电子邮件。
      • 浏览器自动化（支付、仪表板）。
      • 日历集成。

对于铜牌，你只需要 黑曜石+克劳德代码+Python观察者 开始吧。

4.高层架构

在较高层次上，系统遵循以下循环：

  1. 感知（观察者）

    • Python脚本监视外部源代码：
      • 电子邮件（Gmail API）。
      • WhatsApp（通过网络自动化）。
      • 文件系统文件夹（例如“drop”文件夹）。
    • 当有趣的事情发生时，观察者会创建一个 markdown任务文件 黑曜石拱顶，通常在 Needs_Action/.

  2. 推理（克劳德代码/法学硕士）

    • AI在vault上定期运行（手动或通过cron）。
    • 它从以下位置读取文件 Needs_Action/, Inbox/, Accounting/等等。
    • 它
      • 总结项目。
      • 制定计划(Plans/*.md).
      • 更新 Dashboard.md.
      • 从逻辑上移动项目 Needs_Action/ 到 Done/ 随着工作的完成。

  3. 操作（可选MCP/手动）

    • 在青铜级别中，大多数实际的“操作”（回复电子邮件、发送付款）是 仍然手动:
      • 人工智能起草工作或建议步骤。
      • 你执行最后的动作。
    • 对于未来的层级，MCP服务器将允许AI自动执行某些操作。

  4. 人在环（HITL）

    • 你回顾了人工智能在《黑曜石》中产生了什么。
    • 您可以更正、批准或拒绝决定。
    • 您的编辑将更新vault并指导AI的未来行为。

从视觉上看，你可以把它想象成：

  • 守望者→ 黑曜石(Needs_Action/) → 克劳德代码→ 黑曜石(Dashboard, Done/) → You

5.存储库结构（青铜级）

本项目的典型结构：

  • Personal AI Employee Hackathon 0_ Building Autonomous FTEs in 2026.md

    • 原始黑客马拉松架构和规则（规范文件）。

  • watchers/

    • Python观察器脚本（例如。 file_watcher.py, gmail_watcher.py, base_watcher.py).
    • 负责 检测事件 和 编写标记任务 进入保险库。

  • README.md

    • 此文件解释了项目、架构以及如何使用/扩展它。

你也会有一个 黑曜石保险库文件夹 磁盘上的某个地方（通常在此仓库之外）有：

  • Dashboard.md
  • Company_Handbook.md
  • Needs_Action/
  • Done/
  • Plans/
  • Logs/ （可选）

6.青铜级别如何端到端工作

示例流程 文件系统监视器:

  1. 您将新文件（例如发票PDF或客户简报）放入 关注的文件夹.
  2. 这 文件监视器脚本 检测新文件。
  3. 观察者：
    • 将文件复制或移动到您的黑曜石保险库中 Needs_Action/FILE_<name>.
    • 创建一个小的markdown元数据文件（例如。 FILE_<name>.md)这描述了需要做什么。
  4. 下次你跑步的时候 克劳德代码 对保险库：
    • 它看到了新的 Needs_Action 项目。
    • 它可以：
      • 总结它们。
      • 添加TODO和下一步。
      • 更新 Dashboard.md 带有“新项目：查看文件_”.
  5. 您打开Obsidian，查看仪表板和任务，并完成它们。
  6. 完成后，AI（或您）将任务文件从 Needs_Action/ 到 Done/.

同样的模式也适用于 Gmail 和 WhatsApp:

  • 观察者转换 消息 进入 markdown任务文件.
  • 人工智能对这些markdown文件而不是原始API进行推理。

7.设置自己的铜牌等级

先决条件（高级）
请参阅完整的黑客马拉松规范以获取详细链接，但总结如下：

  • 安装：
    • 克劳德代码
    • 黑曜石
    • Python 3.13+
  • 创建黑曜石拱顶，例如。 AI_Employee_Vault，包括：
    • Dashboard.md
    • Company_Handbook.md
    • Needs_Action/, Done/ 文件夹。
  • 配置 一个观察者 （文件系统或Gmail）写入保险库 Needs_Action/.
  • 跑 克劳德代码 指向vault目录并测试：
    • 阅读 Needs_Action/.
    • 将更新写入 Dashboard.md.

一旦这个循环端到端工作，你就实现了 青铜级.

8.这个可以在哪里使用？（用例和行业）

相同的核心架构（观察者→ 金库→ AI推理→ 可选操作）可以应用于许多领域：

  • 独立创始人和自由职业者

    • 跟踪客户电子邮件、发票和截止日期。
    • 每周“CEO简报”，总结收入、逾期任务和风险。

  • 机构和服务业务

    • 从电子邮件、WhatsApp和表单中收集线索，并将其整合到一个表单中 Needs_Action 排队。
    • 自动起草回复、建议和后续序列（您在发送前批准）。

  • 教育与培训

    • 观察分配文件夹或LMS导出。
    • 总结学生的进步、迟到的提交情况，并生成每周报告。

  • 财务与会计（轻量级）

    • 查看银行CSV导出或会计文件。
    • 突出显示异常交易、定期订阅或潜在的节省。

  • 客户支持

    • 将新的工单/电子邮件转化为结构化的降价任务。
    • 根据中的规则提出响应和标记优先级 Company_Handbook.md.

  • 个人生产力

    • 将笔记、截图、PDF收集到一个文件中 Needs_Action 溪流。
    • 为您的个人生活和项目生成总结和行动列表。

在所有这些情况下 主要优势 是：

  • 本地优先隐私 （你的数据存储在机器上的黑曜石中）。
  • 永远在线的观察者 自动捕捉重要事件。
  • 一致的执行 中定义的规则 Company_Handbook.md.

9.如何超越铜牌

一旦青铜级基础稳定，您可以通过以下方式发展项目：

  • 添加 更多观察者:
    • WhatsApp、领英、脸书、Instagram、X（推特）、日历等。
  • 推出 MCP服务器:
    • 实际发送电子邮件、安排会议或在社交媒体上发帖。
  • 实施 Ralph Wiggum环:
    • 一种持久模式，使AI不断迭代，直到任务真正完成。
  • 添加a 每周“周一上午CEO简报会”:
    • 使用黑曜石简报文件自动审核任务和交易。

此自述文件仍将作为 高级概述，而随着项目的发展，可以在单独的markdown文件中添加银/金/白金级别的更详细文档。

10.总结

  • 这个项目是 青铜级基金会 a 个人AI员工/数字全职员工.
  • 它结合了：
    • 守望者 （Python）用于感知，
    • 黑曜石 作为存储器和UI，
    • 克劳德代码/法学硕士 作为推理大脑。
  • 其设计目的是：
    • 本地优先, 隐私意识，以及 可扩展的 到更高的层次。

如果有人只读这个 README.md，他们应该明白：

  • 项目是什么 （当地自主的人工智能员工基金会），
  • 它是如何建造的 （技术栈和架构），
  • 它今天能做什么 （青铜层特征），
  • 如何扩展 （在许多行业实现完全自主的数字全职员工）。

相关 MCP