欧斯
AskExe的AI员工操作系统:本地第一内存,身份,任务管弦,以及运行时间胶水,通过克洛德码,Codex,OpenCode管理AI队友,以及新出现的桌面/运行时间堆栈.
当前 npm 软件包 : @askexenow/exe-os v0.9.341. 节点.js >=20 所需经费.
这回购是为了什么
ele-os 让创始人运行一个AI Org而不是单个聊天会话:
- 一个协调员代理通过跟踪任务拥有创始人的对话和代表.
- 专家在与世隔绝的tmux/worktree课程中运行,具有持续的身份,行为和记忆.
- 本地守护进程、MCP服务器、钩子和CLI保持会话、提醒、审查、云同步和诊断连接.
- 客户端数据保持本地第一并加密;启用时云同步为端到端加密.
每个变化都面临困难:
- MCP是唯一的数据接口. 永远不要直接访问 SQLCipher DB .
- 维护客户数据主权. 更新不得覆盖身份,行为,程序,名册,本地内存,或用户配置.
- 在代码,日志,测试,遥测,或bug报告上没有秘密.
- 没有
require()运行时的无害环境管理类型Script 下级src/lib, (中文(简体) ),src/mcp,或src/tui;使用无害环境管理进口. - 每个任务/审查/信息/通知查询都必须经过过滤
session_scope。 。 。 . - 没有硬码员工姓名. 使用角色/配置解析度,而不是 AskExe 的本地名册 .
一览建筑
User / founder
-> coordinator agent session
-> managers / specialists via task DB + tmux sessions
Claude Code / Codex / OpenCode
-> hooks + MCP tools
-> exe daemon
-> encrypted local memory/tasks/identity/behavior store
-> optional E2EE cloud sync
-> gateway / stack integrations
键片 :
- MCP 服务器( U)
src/mcp(中文(简体) ) 曝光支持的工具表面,用于内存,任务,身份,行为,支持,诊断,配置,文档,CRM/raw数据,以及网关行动. - 守护进程( D)
src/lib, (中文(简体) ),src/services(中文(简体) ) 监督会议、计时器、任务执行、对接系统、同步、诊断以及当地状况. - 适应器
src/adapters(中文(简体) ) 通过钩子和发射器行为与克洛德代码, Codex,和OpenCode相融合. - CLI 命令 (
src/bin, (中文(简体) ),src/commands(中文(简体) ) 安装、发射、诊断、更新、释放、飞行前、同步和操作堆栈. - 运行时间/ TUI (
src/runtime, (中文(简体) ),src/tui(中文(简体) ) 是遗留/当前终端运行时间表面; 架构 doc 注意到遗留的 Irk TUI 被冻结, 而产品方向则向本地的exe-building/desktop聊天运行时间移动. - 堆栈部署( O)
deploy(中文(简体) ) 包含编译、清单、可观察性、注册代理、nginx、迁移和客户VPS部署资产.
代理人使用的认知层 :
- 公司程序:整体规则.
- 身份:角色定义和不可谈判.
- 行为/专长:学习的惩戒和技能.
- 经验/记忆:可搜索的历史和决定.
- 后期物品:未来条件内存/再现于靴子上.
重播地图
| 路径 | 目的 |
|---|---|
src/lib/ | 核心守护进程/运行时库:内存,任务,身份,行为,搜索,同步,配置,管弦. |
src/mcp/ | 集成MCP服务器和工具执行. 这是支持的数据/控制边界 . |
src/adapters/ | Claude/Codex/OpenCode 集成钩和适配胶. |
src/bin/ | 通过 CLI 发布的条目 package.json#bin。 。 。 . |
src/commands/ | 命令执行 exe-os,设置/更新/放行流量,诊断等. |
src/runtime/ | 代理运行时间/工具注册文件 . |
src/tui/ | 遗产 Irk TUI表面;除非明确任务,否则避免新产品投资. |
src/gateway/ | 网关/提供者适配器和外部消息集成码. |
deploy/ | 客户堆栈会编集文件,清单,迁移,nginx,可观察性,注册代理,Ansible. |
deploy/stack-manifests/ | 客户的堆栈清单;图像必须用消化器粘贴. |
packages/ | 共享UI/主题/健康/错误页面包. |
tests/ | 维特套房,烟雾测试,部署测试,集成测试,管弦测试. |
scripts/ | 建立锁,警卫,计划检查,堆栈模拟,飞行前帮助器. |
.planning/ARCHITECTURE.md | 当前架构的真实源并运出进度 。 未来行进图属于MCP支持特性记录,而不是标记下. |
release-notes.json | 更新后显示的当前 npm 发布注释 . |
stack.release.json | 用于客户/VPS参与的堆栈发布描述符. |
密钥命令
此软件包发布的客户/操作命令 :
| 命令 | 使用 |
|---|---|
exe | 启动配置的协调员代理 . |
exe-os | 主CLI/dashboard条目. |
exe-os setup | 首次设置向导:加密,许可,团队,钩子,MCP,守护进程. |
exe-os update | 为已安装的系统推荐交互式更新路径 . |
exe-os healthcheck 编号 : exe-healthcheck | 对守护进程、记忆、云/同步、检索和运行时状态进行健康检查. |
exe-doctor | 更深诊断. |
exe-pending-reviews | 显示检讨队列; 在声称工作是闲置/ 空置前使用 . |
exe-pending-messages | 显示待处理的代理信件 . |
exe-config-dump | 仅读有效的配置垃圾堆, 并进行秘密编辑 . |
exe-timers | 计时器健康仪表板. |
exe-search-quality | 检索质量/相关性遥测. |
exe-stack-update | 客户堆栈图像更新流程 。 运行时只获得明确批准. |
exe-preflight | 堆栈/客户生产飞行前检查. |
exe-cloud | 云同步/链接命令. 从不打印代理输出中的恢复短语 . |
有用的本地检查 :
npm run typecheck
npm run lint
npm test
npm run test:daemon-smoke
npm run test:stack-sim
npm run guard:esm-require
npm run check:schema-version
npm run build
发展工作流程
安装依赖性 :
npm install
编码前 :
- 阅读任务简介和源文件.
- 在宽手动 grep 之前可用时使用代码折叠/ MCP 搜索 .
- 保持 diffs 外科手术; 不要重构无关的文件 .
- 不得触摸客户-本地数据,身份,行为,程序,或名册.
标准验证 :
npm run typecheck
npm test
npm run build
定向验证对于小的改变是可以接受的,但放出/相接闸门需要相关的全面检查. 对于运行时间/守护关键工作,也运行:
npm run guard:esm-require
npm run test:daemon-smoke
构建细节 :
npm run build用途scripts/build-lock.sh,然后将运行时间资产复制到dist/并尽可能生成钩子表.npm run deploy在全球构建、 安装此检出, 并重新启动/ 重新注册 。 它干扰了正在运行的MCP会话;不要随意运行.postinstall运行只命令安装行为,因此全局安装会曝光CLI而不覆盖客户数据.
测试和笔记
- 主试跑者:
vitest run。 。 。 . test:publish是需要公布的门子集加上选定的序列式压力/出入口测试.- 触摸支持/bug/地貌上上游路径的测试必须模拟
fetch;从不创建测试的活性支持记录. - Docker/活-DB测试可隔离于
test:publish; 在假设一个缺失的测试是偶然的之前读取脚本注释. - 在合并/释放之前,CI必须是绿色的.
出版和发行
国家预防机制公布大门:
npm run prepublishOnly
运行排版检查,构建,孤儿块挤出,无害环境管理 require() 警卫 计划版本检查 客户准备状态 以及印刷前检查.
用户普通本地软件包更新路径 :
npm install -g @askexenow/exe-os@latest
# or use the interactive path
exe-os update
客户堆栈释放与 npm 包释放是分开的 :
release-notes.json目前音轨为npm v0.9.341.stack.release.json目前描述堆栈/源v0.9.312,并包括用于私人GHCR应用图像消化解析的TODO注释.- 客户堆栈清单/图像必须是SHA256消化装置。 不要向客户发布推广只使用标签的应用程序图像 .
- 生产堆栈更新必须保留命名的 Docker 卷和客户状态; 永远不要使用
docker compose down -v或删除数据卷. - 堆叠图像释放应该通过文件
exe-os release --stack流动、Bob/客户 -- -- 准备情况审计、飞行前、固定图像和健康核查.
业务专栏
- 仅限MCP. 如果 MCP 已断开, 请重新连接它; 不要绕过直接 DB 读取或 ad-hoc 脚本对 SQLCipher .
- 会议范围很重要. 交叉会话任务/审查/消息泄漏是一个P0类错误. 查询过滤器必须包含
session_scope在适用的情况下. - 除非用户更改数据,否则数据是不可改变的. 安装、更新、进口、启动包和堆栈更新必须首先添加/检查-存在.
- 云端点是
https://api.askexe.com。 。 。 . 不引入遗留的云域 . - 关键材料属于Keychain/机密工具. 永远不要日志、打印或承诺恢复短语或主密钥.
- 运行时间 TypeScript 是无害环境管理.
require()在守护进程/ MCP/ TUI 运行时间路径中, 构建后会中断 . - 堆栈状态需要量. WhatsApp auth, Postgres, wiki/CRM/gateway数据, 监视数据,以及其他状态服务在图像交换前需要命名批量.
- 医而后取. 验证守护进程的健康, 待审查, 待审查消息, 任务状态, 和 tmux 状态后再报告代理是闲置/ done/ stuck .
- 合并后构建 . 干净的 git 合并不是构建检查; 运行
npm run build之后合并的工作会影响运出代码. - 没有
:latest以清单/组成. 发布图像必须进行版本化和摘要化,供客户部署.
供审查的安全清单
- 没有秘密,PII,API密钥,恢复短语,或者代码/测试定着/日志输出中的指使.
- 保留了 Auth 中间软件和权限检查 .
- 外部网络连接使用TLS,除非明确只使用局部.
- 遥测/bug-report Egress 校正了秘密和气象.
- 没有添加直接的 DB 访问路径; 所有代理数据通过 MCP 工具流出 .
- 没有硬编码 AskExe 员工姓名、 本地路径或私人名册假设 .
- 制片服务有健康检查,州级服务有耐用量.
许可证
专有. 见 自由主义。 。 。 .