{"id":32023951,"url":"https://github.com/57ws/ai-win11-administrator","last_synced_at":"2025-10-16T10:08:17.623Z","repository":{"id":295905547,"uuid":"989369928","full_name":"57ws/AI-win11-Administrator","owner":"57ws","description":"Let the LLM control the computer autonomously,让大模型自主操作电脑","archived":false,"fork":false,"pushed_at":"2025-06-23T14:54:59.000Z","size":231,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-28T02:43:51.300Z","etag":null,"topics":["ai","good-first-issue","json","llms","python3","windows-11"],"latest_commit_sha":null,"homepage":"https://github.com/liluoyi666/AI-win11-Administrator.git","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/57ws.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-24T00:53:20.000Z","updated_at":"2025-08-27T15:57:20.000Z","dependencies_parsed_at":"2025-09-28T02:44:05.699Z","dependency_job_id":"e0559a0e-05e6-4b85-9774-4ae75b9f6922","html_url":"https://github.com/57ws/AI-win11-Administrator","commit_stats":null,"previous_names":["liluoyi666/let-llm-control-win11","liluoyi666/ai-win11-administrator","57ws/ai-win11-administrator"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/57ws/AI-win11-Administrator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/57ws%2FAI-win11-Administrator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/57ws%2FAI-win11-Administrator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/57ws%2FAI-win11-Administrator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/57ws%2FAI-win11-Administrator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/57ws","download_url":"https://codeload.github.com/57ws/AI-win11-Administrator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/57ws%2FAI-win11-Administrator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279176204,"owners_count":26119639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","good-first-issue","json","llms","python3","windows-11"],"created_at":"2025-10-16T10:08:14.703Z","updated_at":"2025-10-16T10:08:17.615Z","avatar_url":"https://github.com/57ws.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# AI-win11-管理员\n\n## 项目概述\n本项目旨在让大语言模型（LLM）能够操作Windows 11系统。让AI输出特地格式的json，解析json中的指令，对指令进行执行，允许AI执行各种任务。这为自动化操作Windows 11系统提供了可能，使得一些重复性的任务可以由AI自动完成，提高工作效率。\n***这将把AI的能力发挥到极致***\n\u003c/br\u003e\n\n双 AI 架构原理是利用两个 AI 进行互相监督协同工作，一个 AI 负责生成指令，另一个负责确认指令是否应该执行并提出意见。这种架构能更好地应对复杂的任务和情况，且大大提升安全性。且双AI架构能极大提升用户在交互时的体验。\n***AI安全性与趣味性将有巨大提升***\n\n\n## 目录\n\n- [项目概述](#项目概述)\n- [项目结构](#项目结构)\n- [核心特性](#核心特性)\n- [AI命令格式与命令执行的原理](#ai命令格式与命令执行的原理)\n- [单AI架构与双AI架构](#单ai架构与双ai架构)\n- [GUI软件设计与功能介绍](#gui软件设计与功能介绍)\n- [项目愿景](#项目愿景)\n- [当前情况](#当前状况)\n- [本地部署方法](#本地部署方法)\n- [贡献](#贡献)\n- [许可证](#许可证)\n- [开发者留言](#开发者留言)\n\n## 项目结构\n```\nAI-win11-Administrator:\n    main.py             # 启动GUI\n\n    more_Types/         # 更多操作类型\n\n    logs/:              # 日志\n        log_ai_executor.txt     # 执行者AI日志\n        log_ai_supervisor.txt   # 监察者AI日志\n    \n    brain/:             # 核心功能实现\n        prompts/:               # AI提示词\n            String.py                   # 通用字符串\n            String_chat.py              # 聊天提示词模板\n            String_work.py              # 工作提示词模板\n        json_parser.py          # json解析器\n        LLM_api.py              # api\n        log_editor.py           # 日志服务\n        powershell.py           # 命令行\n    \n    Control_Center/:    # 中央控制系统\n        GUI.py                  # GUI\n        new_GUI.py              # 新GUI\n        status.py               # 系统状态类\n        thread_chat.py          # 聊天线程\n        thread_work.py          # 工作线程\n    \n    Role_Settings/      # AI个性化角色设定(开发中)\n\n```\n\n## 核心特性\n- **结构化JSON执行PowerShell命令**：通过特定格式的JSON，LLM可以方便地执行PowerShell命令，实现对系统的操作。\n- **安全的虚拟机环境**：将程序部署在虚拟机中，增加了系统的安全性，避免因错误操作对主机系统造成影响。\n- **多数据类型接口**：支持多种数据类型的接口，为LLM提供更丰富的数据处理能力。\n- **单AI模式与双AI模式自由切换**：根据安全需求与经济条件选择模式，以适应不同用户需求。\n\u003c/br\u003e\n\n## AI命令格式与命令执行的原理\n### 运行流程\n```\nwhile True:\n    AI通过上一轮系统返回的消息，生成json\n    系统解析json中的指令，并执行\n    保留执行时系统返回的信息，下一轮返回给AI\n```\n\n### 命令格式\nAI的输出需包含以下格式的json，系统会检测AI的输出，并将提取出命令，在计算机中执行：\n```json\n{\n    \"type\": \"操作类型\",\n    \"相关命令\",   \n    \"add_log\": \"执行操作时顺便写入日志\"\n}\n```\n任何情况下都必须存在type键，其他键具体由type决定。add_log不存在不影响操作执行，add_log存在也不会影响任何类型的操作。记入日志时会自动添加时间以及换行，无需手动添加。日志文件由系统自动维护。\n### 命令执行原理\n系统通过thread_work.py的核心执行循环，接收 LLM 的响应并解析其中的 JSON。根据 JSON 中的type键，调用相应的操作方法。例如，如果type为powershell，则调用PowerShellSession类的execute_command方法执行相应的 PowerShell 命令；如果type为read_log，则调用log类的read方法读取日志。\n\u003c/br\u003e\n\n## 单AI架构与双AI架构\n### 单AI架构\n单 AI 架构是指整个系统中只有一个 AI解析指令和执行操作。\n它直接接收用户的留言，根据内置的规则和操作手册，将用户的需求转化为具体的操作命令，并通过 PowerShell 接口执行这些命令。\n\n### 双AI架构\n\n设定两个AI：执行者AI与监察者AI，执行者负责编写命令以完成用户的目标，监察者当前负责决定是否应该执行执行者的命令，并为执行者提供思路与解决方案。\n双方的日志分别独立，执行者的所有输出对监察者完全公开，监察者的输出只有部分向执行者分开。\n后续为了平衡执行者和监察者的操作权限，还会进行进一步的平衡性调整，进一步修改其可执行命令。\n双AI架构有利于提示系统稳定性与安全性，在后续开发与用户的交流对话模式下，双AI也可以提升用户在交流中趣味性。\n\u003c/br\u003e\n\n## GUI软件设计与功能介绍\n### 聊天与工作状态\n初始进入GUI为聊天状态，可与AI进行聊天，可提前保存工作留言，以及进入工作状态。进入工作状态后，你无法与AI直接进行交流，但可继续追加工作留言，与AI保持交流。\n在工作期间，你可以随时切换为聊天状态与AI交流，即便反复进行状态切换，AI的记忆和powershell的状态都会长期保存，从而确保AI操作的连续性，灵活性，可控性。\n\n### 工作留言机制\n在工作期间AI无法与你直接交流，但可以通过留言获取用户的任务以及提示。留言队列可以保存最新的三条用户留言，并在工作状态时呈现给AI。\n在聊天状态时用户可以提前进行留言追加，在工作状态开启后AI将会得到用户的留言。在工作状态时，用户也可以进行该操作，实现在工作中途给AI传递信息。\n用户的留言会实时追加到留言列表中，且自带时间信息，确保AI了解信息的时效。\n\n### GUI布局设计\n左侧为日志信息流显示区，在工作时显示AI生成的指令以及AI操作后返回的信息，在聊天时显示AI的聊天信息，当然也包括用户发送的信息以及本系统的提示信息，且这些信息都附带了时间信息。\n右侧为控制面板，可切换当前状态，切换AI个数，追加工作留言。并显示工作状态信息。\n\u003c/br\u003e\n\n## 项目愿景\n### 原始计划\n- **起步阶段**：让LLM能够操作PowerShell，确保程序稳定运行。\n- **初期阶段**：将程序转移到虚拟机，增加更多操作语法和安全设置。\n- **中期阶段**：增加更多数据类型接口，尝试让LLM自主完成某些简单项目。\n- **最终阶段**：实现非虚拟机部署，让LLM安全稳定地完成人类50%的计算机任务。\n\u003c/br\u003e\n\n### 分支计划\n- **起步阶段**：实现双AI命令执行系统稳定运行。\n- **初期阶段**：实现工作状态与对话状态的自由切换，既可与用户对话，也可以操作计算机。\n- **中期阶段**：开发可视化窗口以及软件，增加更多数据类型接口，设计AI虚拟形象。\n- **最终阶段**：完成为一集成：自动化工作，休闲聊天，电脑安全管控等功能的多功能AI桌面助手。\n\u003c/br\u003e\n\n## 当前状况\n- **单AI架构初步运行成功**\n- **增加了文件读写方法，实现100行文本一次写入**\n- **修改了json解析器，大大降低报错率**\n- **双AI架构初步运行成功**\n- **能够一次检测多个json，并按顺序运行，大大提高操作效率**\n- **开发完成GUI以及聊天功能**\n\u003c/br\u003e\n\n## 本地部署方法\n### 环境准备\n确保你的系统满足以下要求：\n- **操作系统**：Windows 11\n- **Python版本**：Python 3.x\n- **依赖库**：根据`requirements.txt`文件安装所需的依赖库。可以使用以下命令进行安装：\n```bash\npip install -r requirements.txt\n```\n\n### 配置API密钥\n根据你使用的LLM模型，配置相应的API密钥。例如，如果你使用的是DeepSeek模型，需要设置`DEEPSEEK_API_KEY`环境变量：\n```bash\nexport DEEPSEEK_API_KEY=your_api_key\n```\n\n### 启动项目\n在项目根目录下，运行以下命令启动项目：\n```bash\npython main.py\n```\n\n### 运行主循环\n在`main.py`文件中，你可以设置一些参数，如`max_rounds`和`msg`，来控制主循环的运行。例如：\n\n```python\nmsg = '''\n如果刚开始进入命令行，你会出现在该项目的主文件夹中。\n你需要做：...\n'''\n\nxxx = main_cycle_single(log_path=r\"logs/log_ai_executor.txt\")\nxxx.cycle(max_rounds=30, msg=msg)\n```\n\n## 贡献\n### 如果你想完全理解代码，可按照该顺序查看代码：\n1. `brain/LLM_api.py`\n2. `brain/String.py`\n3. `brain/powershell.py`\n4. `Control_Center/thread_work.py`\n\n### 如果你想为这个项目做出贡献，请遵循以下步骤：\n1. Fork这个仓库。\n2. 创建一个新的分支：`git checkout -b feature/your-feature-name`。\n3. 提交你的更改：`git commit -m 'Add some feature'`。\n4. 推送至分支：`git push origin feature/your-feature-name`。\n5. 提交Pull Request。\n\u003c/br\u003e\n\n```\nThis Markdown document provides both English and Chinese versions, with links at the beginning of each version to allow users to switch between languages easily.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F57ws%2Fai-win11-administrator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F57ws%2Fai-win11-administrator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F57ws%2Fai-win11-administrator/lists"}