
AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载本指南聚焦 OperitAndroid 端 AI Agent构建系统重构的第 6 个步骤——pixi 与资产准备入口。该步骤为仓库引入 pixi 作为宿主工具链编排器统一 Node.js、pnpm、JDK、Python 的固定版本管理并为 web-chat、toolpkg、MCP bridge 三类 JavaScript 资产建立可追溯的生产入口与机器可读清单。读完本文你将掌握这套单一 pixi task 结构化清单 构建前校验方案的设计意图、任务划分、验收标准以及它与当前仓库源码现状的对应关系。说明本文依据 docs/TODO/refactor_building_sys/6_PixiAndAssetPreparation.md 展开该文档属于构建系统重构工作草稿status: draft完成记录为未开始文中涉及的新入口均以预期实现 / 计划表述并结合当前仓库真实文件佐证现状。本步骤在重构总计划中的定位重构总计划docs/TODO/refactor_building_sys/index.md将构建拆分为 14 个可独立审查的最小步骤其核心目标是为 JavaScript assets、外部二进制、Android 模块、APK 变体和补丁发布建立唯一且可审计的构建输入。第 6 步依赖第 5 步工具目录迁移并作为第 7 步Android 能力契约的前置。它在流水线中的位置处于环境与依赖准备段落阶段职责对应 pixi task预期environment_prepare准备固定工具链并输出环境报告env-reportdependency_prepare执行 pnpm 冻结安装并确认 Gradle 输入js-installasset_prepare生成 web-chat、toolpkg、bridge assets 和清单js-webchat/js-toolpkg/js-bridgeartifact_verify校验 AAR、JAR、JNI、models 与 subpackartifact-verify总计划要求每个阶段只调用一个 pixi task并通过结构化报告交付状态与产物verify、build、qa、release等 profile 显式选择上述阶段。第 6 步正是把这一约束落到实现层的关键步骤。旧实现情况当前仓库的真实现状盘点原文档首先盘点旧实现情况这些描述与当前仓库文件一一对应可作为改造前的基线证据仓库没有pixi.toml——搜索整个仓库pixi 仅出现在重构计划文档中根目录与各子项目均无 pixi 配置文件。ci/README.md记录了 candidate 检查与 Android 依赖准备流程但没有 pixi 任务入口——ci/README.md 目前描述的是 GitHub merge candidate 契约base candidate^1、head candidate^2、本地检查命令python3 -B ci/script/check_repo_hygiene.py等以及 Android 依赖准备JVM lane 只下载libs.zip完整 Android lane 下载libs.zip、subpack.zip、jniLibs.zip三个固定归档由 download_android_dependencies.sh 和 prepare_android_dependencies.py 处理。这些流程靠 CI workflow 直接编排尚未抽象为可复用的 pixi task。web-chat、toolpkg 和 MCP bridge 没有统一的 assets 生产入口——当前 web-chat 的构建与资产同步靠 npm scripts 串联根 package.json 的build:webchat为npm --prefix web-chat run build npm --prefix web-chat run sync:android-assetsweb-chat/package.json 提供buildvite build、typechecktsc --noEmit、sync:android-assets等脚本。真正的资产拷贝逻辑在 web-chat/scripts/sync-to-android-assets.mjs先检查web-chat/dist是否存在再删除并重建app/src/main/assets/web-chat目录把 dist 全部内容拷贝进去。JS assets 没有路径、大小、SHA-256 和生产任务清单——当前没有任何js-assets.json之类的清单文件资产内容无法在构建前做机器可读校验。开发文档要求全局安装工具并修改持久化环境配置——工具链版本Node.js、pnpm、JDK、Python没有统一声明来源脚本依赖开发者本机环境这正是 pixi 要解决的痛点。此外当前仓库还残留着文档提到的另一处现状根 package.json 使用 npm 风格脚本npm --prefix而 pnpm-workspace.yaml 目前只声明了tools/mcp_bridge一个 package——这与第 2 步pnpm workspace 与锁文件计划的三包 workspaceweb-chat、tools/mcp_bridge、examples/github尚有差距说明从 npm 到 pnpm 的统一迁移仍在推进中。预期的新实现情况pixi 统一编排的设计目标原文档给出了 5 条明确的目标状态构成整套方案的设计骨架pixi 固定 Node.js、pnpm、JDK、Python 和可稳定管理的宿主工具——工具链版本由 pixi.toml 声明并锁定杜绝最新版本式动态描述第 1 步 基线契约 已要求记录工具链精确版本及来源。ci/script/提供环境报告、冻结安装、JS assets 生产和制品校验入口——即下文将要展开的env-report、js-install、js-webchat、js-toolpkg、js-bridge、artifact-verify六类入口。Android 构建启动前必须通过 JS assets 清单与外部制品清单校验——Gradle 不再直接接触 npm/pnpm 与制品下载校验前移到 pixi 阶段。脚本不修改 shell profile、注册表或系统级环境变量——构建环境保持可重复、可清理不污染宿主机。外部 CI 只调用与本机相同的 pixi task——本地开发与远程 CI 共用同一套入口从源头消除本地能过、CI 挂掉的偏差同时要求每个 pixi task保持单一职责并提供稳定命令、退出码和结构化报告。这套设计的关键词是单一事实来源 可审计输入与总计划同一类输入只能有一个受版本控制的事实来源的执行约束完全一致。入口任务清单六个 pixi task 的职责划分原文档第 2 条计划明确要求实现六个入口逐一展开其职责env-report输出环境报告对应流水线阶段environment_prepare。报告应包含工具链精确版本Node.js、pnpm、JDK、Python、宿主工具供 CI 与本地共享同一份可读的版本证据。js-install执行 pnpm 冻结安装对应dependency_prepare。冻结安装不会修改 lockfile是第 2 步的验收标准之一js-install必须继承这一约束保证依赖树与锁文件严格一致。js-webchat构建 web-chat 前端并生产其 Android assets。对应现有流程是npm --prefix web-chat run build npm --prefix web-chat run sync:android-assets与 sync-to-android-assets.mjs 的拷贝逻辑未来将纳入 pixi 编排并登记到清单。js-toolpkg生产 toolpkg 资产。tools/example_packages/sync_example_packages.py 是当前核心生产者它已具备相当成熟的资产管线能力支持normal/test两种同步模式SYNC_MODES按DEBUG_APP_PACKAGE com.ai.assistance.operit.debug与RELEASE_APP_PACKAGE com.ai.assistance.operit区分目标应用包只同步{.js, .toolpkg}后缀文件通过OPERIT_APP_PACKAGE环境变量选择目标并维护热重载状态文件.sync_example_packages_hot_reload_state.json与本地同步状态.sync_example_packages_local_state.json——脚本已内置hashlib用于哈希计算为未来清单登记打好了基础。js-bridge生产 MCP bridge 资产。当前 tools/mcp_bridge 使用 npm 串联 build、bundle、copy第 2 步现状描述第 5 步计划将其迁入tools_built-in/后再接入本任务统一生产。artifact-verify校验外部制品AAR、JAR、JNI、models、subpack对应流水线阶段artifact_verify。当前实现基础是 prepare_android_dependencies.py 的严格解包校验限制成员数量、解压大小、压缩比和文件类型拒绝越界路径、重复成员及符号链接只验证本次实际解出的文件。资产清单机制js-assets.json与js-assets-check原文档第 3、4 条计划是本步骤的核心创新点建立js-assets.json记录四类元数据生产任务由哪个 pixi task 产出、相对路径相对仓库根或 assets 根、大小、SHA-256。这张清单让每个 JS asset 都能追溯到源码、lockfile 和生产任务验收标准第 2 条配合第 3 步 外部制品清单 对外部二进制的登记形成完整的构建输入证据链。增加js-assets-check在生成后比对三者的差异生成结果、Git 工作树、assets 清单。只要任一处不一致文件缺失、大小不符、hash 不符、清单过期任务就明确终止而不是带着脏输入继续构建——这与总计划文件缺失、hash 不符……直接终止的硬约束一致。这套机制的实战价值在于APK 内的 web-chat 页面、toolpkg 包、bridge 脚本不再是无记录的拷贝产物而是可审计、可复现、可回滚的构建输入。修改作用域动什么、不动什么原文档明确划定了边界防止重构扩散到无关模块计划修改pixi.toml及对应锁定文件工具链声明ci/script/新入口脚本ci/README.md流程文档同步更新package.json移除 npm 串联入口web-chat/scripts/资产生产脚本纳入统一编排tools/example_packages/sync_example_packages.py接入 pixi 任务tools_built-in/mcp_bridge/第 5 步迁入后的 bridge 生产路径本步骤不修改Android feature moduleGradle 变体身份APK 发布与补丁逻辑注意当前仓库尚无pixi.toml、tools_built-in/等目标路径它们属于计划产物tools/example_packages/sync_example_packages.py与tools/mcp_bridge目前仍位于tools/下等待第 5 步迁移。实施计划与验收标准原文档给出 7 条实施计划可归纳为四段式推进工具链落地由 pixi 提供第 1 步已确认的宿主工具版本复用config/build-system/中的版本元数据不重复声明。入口实现完成env-report、js-install、js-webchat、js-toolpkg、js-bridge、artifact-verify六个入口并保证单一职责、稳定命令、明确退出码和结构化报告——不把多个独立阶段隐藏在一个不透明命令中计划第 7 条。清单与校验建立js-assets.json实现js-assets-check差异报告。编排与文档为 Android 构建定义前置顺序先 JS assets 校验、再外部制品校验、最后 Gradle为每个脚本补齐--help、参数说明、输出格式与退出条件并为后续流水线契约保留稳定 task 名称。配套的 5 条验收标准是判断是否完成的硬指标本机和外部 CI 使用同一 pixi taskJS assets 都能追溯到源码、lockfile 和生产任务Gradle 文件不安装 Node 或 Python 依赖也不直接调用 npm、pnpm 或制品下载脚本结束后不会改变宿主机持久化配置输入或 hash 不一致时任务明确终止其中Gradle 不装依赖、不直接调用包管理器这一条呼应了总计划的执行约束Gradle 不安装 JS 或 Python 依赖不下载业务制品也不发布网络资产。当前 ci/README.md 描述的libs.zip/subpack.zip/jniLibs.zip下载与 STT 模型 assets 获取按 stt-model-assets.properties 校验 SHA-256 后生成正是这类构建前准备职责未来都应在 pixi 阶段完成后再放行 Gradle。现状约束与后续衔接完成记录原文档明确标注状态未开始。完成前需要记录依赖安装与 assets 构建结果——本文所有新实现内容均为计划需在完成代码修改、文档同步与验证后方可在一级标题末尾添加[DONE]。Agent 执行约束文档 frontmatter 中的For_Agent声明未经用户明确授权不执行编译、构建、测试或发布命令index.md进一步说明该字段只限制 Agent 当前会话的命令执行不参与 profile 选择也不改变构建脚本行为。前置依赖本步骤依赖第 5 步工具目录迁移完成ci/script/、ci/tools/、tools_built-in/目录职责划分完成后继续进入第 7 步Android 能力契约并最终由第 13 步构建流水线契约与平台适配把各阶段边界交付给可视化 CI 与 GitHub Actions。这套pixi 固定环境 单一职责 task 清单校验的设计最终服务于总计划最根本的目标让 Operit 的每一次 Android 构建都从一组可审计、可复现、来源唯一的输入出发。赞分享AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载相关推荐ChongqingAscend/distiluse-base-multilingual-cased性能评估跨语言语义任务中的卓越表现ChongqingAscend/distiluse base multilingual cased性能评估跨语言语义任务中的卓越表现 想要在跨语言文本理解和语Pixi 容器化部署实战使用 pixi-docker 镜像与多阶段构建将 Conda 环境带入生产环境Pixi 容器化部署实战使用 pixi docker 镜像与多阶段构建将 Conda 环境带入生产环境 将 Pixi 管理的 Conda 环境带入生产环境的一开发工具CLI包管理器任务调度MicroPython on Zephyr 端口入门环境准备、固件构建与快速上手实践MicroPython on Zephyr 端口入门环境准备、固件构建与快速上手实践 本文以 MicroPython 仓库中 Zephyr 端口入门教程 ht嵌入式语言运行时编程语言解释器编译器物联网系统编程上一篇Tabby启动优化快速启动和响应时间改进下一篇Codewhale web 上手教程三步把终端编码 Agent 搬进浏览器创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考