Microi Agent

Microi Agent 是基于DeepSeek Harness官方桌面源码的吾码AI工作台，提供Windows与macOS下载、版本校验，以及与VS Code、CLI共享的吾码能力。从 1.3.8 起采用官方桌面宿主；下载按钮显示各平台已发布的可下载版本；手动安装包与自动更新频道分别记录，不能把源码版本或手动发行当作频道升级。

macOS 按芯片分别选择下载：Intel x64 1.4.7 已签名、公证并通过实包启动验收；Apple Silicon 继续使用已发布的 1.3.6 Universal。两个入口分别读取各自的更新清单，新 ARM 包仍须另行构建和真机验收。

MICROI AGENT HARNESS

让 AI 在完整业务底座上工作

代码、吾码账号、AI 中转站、MCP 与 30+ 成熟引擎，在一个桌面工作台协同。

下载 Windows 完整版 v1.4.6 Microsoft Store 已发布

macOS Intel x64 · 频道准备中下载 macOS Apple Silicon Mac App Store 尚未开放下载

微软签名 EXE 在线安装器商店版 1.3.3 · Windows 10 2004+ / 11 · x64 · 需联网

官网 Windows 完整 EXE 当前未签名；微软签名在线安装器提供商店版。macOS Intel x64 1.4.7 已完成 Developer ID 签名、Apple 公证及实包启动验收；Apple Silicon 继续使用 1.3.6 Universal，两个入口分别读取自己的频道。Mac 商店尚未开放下载。

官方账号登录即用 AI 中转站
多端桌面Windows 与 macOS
原生能力MCP · Skills · Harness

官方桌面 · 吾码能力29 项图像工具 · 项目群与十一岗协作

PRODUCT TOUR

从对话到完整交付，都在一个工作台

浅色与深色主题 · 自适应宽屏 · 真实任务轨迹

官方桌面首页macOS Intel 1.4.7 · 真实发行 App

AI 员工项目群十一岗位 · 分别绑定模型 · 需求材料共享

历史任务工作区历史界面 · 轨迹、文件与后台任务

图像能力示例历史界面 · 上传、参数、生成与下载

登录与连接

使用吾码账号，或连接自己的模型与业务租户。

选择能力

对话、数据、图像、视频、音乐与应用统一进入。

完成交付

Harness 执行任务，吾码引擎承接权限、数据与业务。

macOS Intel 1.4.7 发行与验收（2026-11-11）

Intel x64 1.4.7 使用当前 DeepSeek 官方桌面宿主，保留吾码账号、MCP、Skills、AI 员工和 Office 能力。App 与 DMG 均已通过 Developer ID 签名、Apple 公证、票据及 Gatekeeper 检查；ZIP 和只读挂载的 DMG 内 App 与实测 App 的哈希一致。

实际发行 App 完成两次独立进程启动、生产 Harness/Worker、未登录引导、输入与技能资产、宽窄窗口及明暗主题等 11 项基础原生检查，另完成真实官方账号登录、冷启动保留及局部退出 5 项检查。这些结果不代替员工真实模型、完整商业流程、Windows 或 Apple Silicon 验收。

Intel x64 文件	大小	SHA-256
DMG 手动安装包	314990109 字节	`2ed4ed15f29e27a84f71afe6ffbd3010ba8d6f83c9655989cb5a31d1aa0be523`
ZIP 自动更新包	391922307 字节	`76534a2c516d1470457683e2cb7c3895bac13be4db6ce707aac54e4041644ff5`

顶部新增 macOS Intel 专属入口，只读取 x64/latest-mac.yml。原有 Mac 永久入口及其 generic latest-mac.yml 继续保留 1.3.6 Universal，供 Apple Silicon 使用；Windows 下载入口和频道保持独立。浏览器 UA 不用于判断芯片，避免 Apple Silicon 被误导到 Intel 包。

已安装 1.3.6 的 Intel 用户请手动安装本页 Intel DMG；旧 Universal 频道不会自动升级到单架构包。安装 1.4.7 后使用 Intel 专属自动更新频道。本轮仅补发 Mac 包，原 Windows 1.4.7 安装包保留原字节；在 Mac 上通过测试不代表重新打包或验收了 Windows。

1.4.7 发行与验收（2026-11-08）

Windows Microi Agent 1.4.7 已通过官方 MCP 发布，下载资源版本为 v1.4.9；最新更新清单、历史版本、不可变归档及公开安装包均已独立回读。上游更新至 DeepSeek Harness 0.2.2-rc.1 候选版，保留吾码账号、MCP、模型配置、数字员工、VS Code、CLI 与安装更新功能。macOS 继续提供 1.3.6，本轮清单保持原始字节，新 Mac 包留给 MacBook 单独验收。

当前 Windows 安装包的原生门禁 22/22 通过，覆盖真实登录、普通模型会话、租户隔离、岗位模型、群聊与冷启恢复，以及未安装员工中心时的提示、创建阻断和连接管理入口。缺应用验收使用已授权的独立临时会话，验后已精确注销并验证原凭据被拒绝；没有卸载应用或改动该连接的业务数据。

配套 AI 员工中心 1.2.7 已在官方应用商城发布，并完成授权演示租户的安装和增量验收。1.2.6 将本人未结束的工作置首，其余按创建时间从新到旧排列；全部结束后，群头打开最新工作会话。1.2.7 保留嵌入页面的当前导航，宿主同步尺寸、主题或恢复窗口时不会再次覆盖本地页面；首次进入、真正切换宿主路由或身份及菜单入口改变时才采用宿主入口。顺序交接、测试返工与实际工作文件已有真实业务回执；1.2.7 的导航回归与这些付费执行记录分别保存。

Windows 1.4.7 不可变安装包为未签名 EXE，266956841 字节，SHA-256：62ddd2f480d1730cd555644d614512d59cdfd0c26d22f7eeeacbc37c22513ee2。本轮结论对应该安装包及授权测试目标，不替代新 Mac 包或其它客户设备验收。

1.4.6 发行与使用（2026-11-07）

Windows Microi Agent 1.4.6 已发布到官方下载频道，配套 AI 员工中心 1.2.5 已在官方应用商城发布并完成授权租户的安装与回读。顶部 Windows 按钮进入永久 latest 入口，版本记录保留本次不可变安装包；macOS 当前继续提供 1.3.6，新 Mac 包的构建、签名、公证和设备验收单独进行。

个人群聊列表：置顶与归档仅影响当前用户；普通群按最后消息倒序，新群按创建时间排序，归档后可从「已归档群聊」恢复，原有消息继续保留。
员工模型跨群复用：同一租户、同一负责人的员工配置一次后，已有群与新群继承；冲突的历史绑定保留原值，等待负责人明确保存，不静默替换模型。
顺序工作链：岗位按产品、架构、开发、测试交接，测试可以将缺陷退回开发后复测；实际工作会话、文件与交付状态分别核对，负责人仍须验收成果。

本轮已在真实 Windows 安装环境核对账号登录、租户隔离、岗位模型、群聊偏好及冷启恢复，并完成含测试返工的顺序工作链。官方 PC 8.9.6 同时修复通用微应用深链页签标题，保留菜单自定义标题，内部导航与语言切换不会退回通用标题。以上结论对应本轮包与授权测试目标，不替代其它客户设备或新 Mac 包验收。

Windows 1.4.6 不可变安装包为未签名 EXE，266392526 字节，SHA-256：f6cd14cab19cf8c12343005b3cb2dc5f3188cc1eac1991d7fae532a8a5f8904a。软件版本 1.4.6 与下载资源版本 v1.4.8 分别记录；渠道清单、不可变包与归档入口已独立完整回读。SHA-256 用于校验完整性，不能代替可信发布者签名。

1.4.5 历史验收记录与使用说明

以下保留 1.4.5 早期候选的验收记录：安装包生成后，5 次真实安装与 8 项离线安装态检查通过，当时真实在线业务与下载渠道另验。当前可下载版本以顶部各平台下载和更新频道为准，不能用这份早期记录判断当前发布状态。

安装检查覆盖新装、覆盖安装及旧版升级，并核对完整程序文件、旧目录保留和安装后的恢复状态。离线检查覆盖首次启动、登录入口、侧栏与设置、明暗主题、宽窄窗口及合成旧历史的显示和刷新保留；不代表真实账号、模型推理、手机连接或客户数据已完成验收。

本节保留 1.4.5 发行时的验收记录：当时官方 API 受官网服务故障影响，在线业务与独立 11 项后端专项尚未完成验证；配套后端版本为 v8.6.7，独立发布的工具与应用版本分别为 CLI / VS Code 6.1.5、AI 员工中心 1.2.2。这些历史状态不表示当前服务仍然故障，也不代表当前工具版本；开发工具升级及实际加载版本的核对方法见 MCP 指南。

功能	使用方式与改进
官方连接	使用 `https://api.microi.net`、`OsClient=iTdos`。账号、模型和媒体业务经托管接口引擎处理，独立读取并行执行，不再排在长耗时媒体任务后；客户 MCP 保留自己的服务器地址
MiniMax M3.1 Flash	模型管理补齐 `MiniMax-M3.1-Flash` 的目录与请求参数。获取模型后按供应商实际权限选择；已有提供商和自定义模型配置继续保留
批量岗位模型	在群成员区打开批量配置，选择提供商和模型，应用到全部员工或仅尚未配置模型的员工。保存时检查群版本，避免覆盖其他人的同时修改
紧凑界面	项目、成员和 MCP 连接采用更紧凑的排版。操作通知显示在右下角，群说明收进提示图标；模型刷新状态不改变弹窗高度
历史消息	向上滚动按页读取，使用稳定游标跨月、跨年继续加载。员工消息与平台聊天分别兼容旧数据，避免一次加载全部历史
顺序工作链	发送需求时选择顺序执行，按产品、架构、开发、测试依次处理。员工使用同一个普通 Agent 工作会话，群里显示交接进度，点击可打开实际工作会话

顺序工作链在前一岗位的真实执行轮次结束后交给下一岗。测试发现缺陷会交回指定前序岗位，完成修复后重新测试；遇到缺少资料、权限或中断则暂停，由负责人补充后继续。群聊天中的方案回复与普通 Agent 会话中的实际执行分别记录，任务完成后仍需负责人验收交付物。

历史消息的新 MongoDB 分区需要配套后端、托管接口和前端升级：数据库按年、集合按月组织，发送确认仍以持久提交为准。断网或响应丢失时保留原请求标识，先核对已保存结果；不会自动生成新请求重复执行收费模型。平台聊天和 AI 员工的线上分区结果需要分别验证。

本次 1.4.5 使用官方 DeepSeek Harness 0.2.1-rc.3，上游提交为 22ddee3792402c3e70ec5f86a63c3e3e895a2f60，吾码源码冻结于 205cda7。模型版本与桌面上游版本分别核对。同步只进入隔离源码缓存，通过吾码维护的严格补丁重放；账号、MCP、员工、模型目录、VS Code、CLI 与安装发布功能均属于永久保留范围，补丁或回归失败时停止升级。

Microi Agent 1.4.2 更新说明

Microi Agent 1.4.2 修复未配置模型时的消息确认、紧凑群聊、弹窗跳动与统一设置，并同步官方上游；同时修复普通会话自动标题误收思考块及历史消息重新编辑后出现重复活动会话的问题。配套 AI 员工中心 1.2.0 已完成官方发布与独立下载验证；开发工具与桌面独立发行，本次桌面发行不代表重新发布 CLI 或 VS Code 插件。源码、安装包、原生运行、真实目录升级、下载渠道和官网页面分别核对，实际发行结果见本页更新日志。

1.4.2 修复范围与入口

用户反馈	本轮行为	使用与验收边界
1. 消息显示「发送未确认」，群聊疏松	用户消息先独立取得 SQL 持久化确认；未配置模型的岗位返回明确失败，不回滚已保存的用户消息。项目、消息、成员改为更紧凑的三栏布局	消息已保存不等于岗位推理完成；未知结果保留原请求标识，先只读核对，不盲目重复发送或付费推理
2. 刷新模型目录使弹窗跳高	模型目录状态预留固定区域，加载、失败、空目录与保存错误不改变弹窗高度；已有可用选项仍可选择	长内容在弹窗内部滚动，错误继续可读，不以隐藏提示换取稳定
3. 功能区与多个设置入口混乱	AI 员工、插件与自动化任务位于任务/工作区上方；其余工具统一进入一个设置入口	MCP、吾码 AI、审查、采集、环境服务、账号、关于与手机配对继续保留；使用官方设置分区，不复制第二套设置壳
4. 同步最新版 Harness	同步官方 `0.2.1-rc.2`，提交 `687f282e8625c6b8d11ff58211a90524be2e4317`	广告中的 V4.1 是模型名称，不是 Harness 软件版本；官方预发布基线不代表吾码最终包已经通过验收
5. 同步不能覆盖吾码二开	继续分开管理官方纯净归档、可重建候选和吾码差异层，精确校验每个上游接缝	吾码账号、MCP、员工、Skills、VS Code、CLI、打包及更新渠道都纳入保留清单；补丁或验收失败时停止推进

从底部「设置」进入服务器连接与模型管理，在「AI 员工」明确选择已登录的业务 MCP，再按岗位配置提供方和模型。关于、吾码官网、QQ群 51050055 与手机配对收在设置的帮助分区。没有配置模型时不伪造岗位在线或方案回复；“兄弟们在不在”也应由实际可用模型按岗位上下文回答。

员工正文与预算（1.4.2）：使用官方 SDK 的文本、思考和实际结束状态，不再要求模型输出客户端随机标记。仅在实际收到完整 stop 后回报文本；独立思考通道不写群消息，普通文本开头的标准思考块仅在完整闭合后剥离，正文内部 Markdown、代码、引用和标签示例不作全局改写。空白、未闭合思考或整份“最终正文”占位保留核对状态，不写员工成果，也不自动重调已开始的推理。供应商实际用量继续保留，缺失字段仍为未知；实际追加的回答指引计入完整保守输入估算，保留原上下文预留及显式输出限制，预算不足在推理前提示。本次设置生命周期修复已有本地真实 React 回归，完整构建、新包、同包真实认证、原生、真实目录升级与渠道原件分别见下方发行表。
自动会话标题（1.4.2）：自动标题仅处理模型返回内容开头完整闭合的标准 <think> 思考块，拒绝未闭合或空标题并使用原有回退；不在标题中展示该前缀思考。历史提供方标题在重建投影时使用同一边界，保留用户命名、原始事件及正常标题内容；不会为此追加模型请求。
设置与欢迎引导（1.4.2）：只有吾码官方桌面标记 officialDesktop === true 时，自动出现的上游欢迎引导才不接管账号或模型设置；保留显式打开的模型配置与显式欢迎流程。登录尚未完成时保持原表单和 owner，不因后台自动步骤卸载并取消登录。本地真实 React 回归不等于真实密码认证，同包原生结果仍须独立验收。
长记录群聊消息（1.4.2）：多条长回复陆续到达、用户已滚离底部时，消息条目仍保留自身高度，正常滚动可阅读完整 Markdown；继续保留离屏内容延迟布局。浅色、深色的实际群聊组件回归覆盖消息高度、相邻消息位置、唯一消息身份、可见性与整份官方 Markdown 语义；源码回归、安装态原生与下载发布分别留证，不能互相代替。
历史消息重新编辑（1.4.2）：官方会话没有安全原地回退能力，重新编辑采用保留审计的安全分支；新分支中的编辑请求获得明确持久接收确认后才归档旧分支，活动侧栏仅保留一条当前会话。结果未知时不归档、不重复发送；归档失败只重试归档。显式创建分支与撤回沿用原行为。同包普通会话和独立冷启已验证侧栏计数 4 → 4、旧会话归档恢复及新分支持久化；该原生恢复例的附件为空，非空附件的正文、附件与工作区恢复目前由离线回归覆盖，不冒称非空附件原生恢复已通过。

Windows 1.4.2（2026-10-18）

Windows 软件版本为 1.4.2，对应下载资源版本为 v1.4.3。本次 1.4.2 已进入 Windows latest 频道，顶部下载选择规则见“安装、签名与平台兼容”；macOS 最后可用版本为 1.3.6；本轮发布前后按最新清单独立核对，本轮不发布新 Mac 包。

本轮产品源码冻结于 5593e92117b5cb4bb9f18d15ab9d5d9217ccd3ad（C11），受保护输入 1132 文件 / SHA-256 1efaef4c7623f0804d2dea9f946093710f20404baa2ccc8df518118cb2aecd9f；资格流水、完整包与同包八项原生已取得实际通过原件。真实 D 升级及两个默认快捷方式已分别通过，【Windows 下载渠道已完成发布与双入口完整回读；官网按下述模式 6 流程独立发布】。Mac 新包仍须在 MacBook 独立构建、签名、公证和原生验收。以下 1.4.1 使用说明及历史发行证据继续保留。

1.4.1 修复范围与使用说明

原反馈	已修复行为	使用与兼容边界
1. 启动画面仍显示 Harness	启动与加载画面使用 Microi Agent	安装新版后直接显示吾码产品名称
2. 关于窗口为系统提示框、链接无法使用	改为独立关于窗口，提供版本、吾码官网、使用文档与更新记录、QQ群 51050055 和复制、关闭操作；安装器发布者与产品说明同步为吾码	关于页不再展示 dsh / DeepSeek 产品链接，第三方版权与许可继续保留在安装包 NOTICE / LICENSE
3. 登录一直“连接中”，多连接读取慢	减少多连接加载的重复等待；登录显示阶段、耗时、取消及可读错误，并约束请求整体超时	临时网络故障与账号失效分别恢复。响应结果未知时保留提示，不盲目重复登录或清空其它连接
4. 每张 MCP 卡片都有恢复品牌按钮	MCP 页面右上方只保留一个「恢复 Microi Agent 品牌」	各连接仍可将自身名称和 Logo 应用到本机软件左上角，不修改客户系统标题
5. 全屏两侧空隙过大	吾码功能页随可用窗口铺开，长路径和窄屏内容可换行	宽屏充分使用可用区域，窄窗口可通过侧栏与抽屉访问功能，浅深主题均保持可读
6. 首页仍显示预览版	保留「探索未至之境」，移除首页预览版标记	原有吾码 AI 入口和通用 Office 能力保留，不恢复旧 PPT 模板 dock 或独立 PPT 菜单
7. AI 员工无法进入	明确选择一套已登录的吾码 MCP 后进入所选租户；不要求先登录吾码官方账号，也不会默认选择首个客户	群、成员、消息及运行历史归所选租户。员工中心、数据库和权限需要通过该租户真实预检；缺少应用时显示安装指引，由有权管理员单独处理
8. 解压后出现目录错误 145 / 183	完整解压后对实际所选应用目录建立同盘恢复快照，不再依赖旧注册表是否存在卸载命令才处理旧目录	正常多层自选路径受支持；未知文件保留，危险根目录拒绝。不能安全切换时集成日志会指出阶段、路径与恢复状态，不承诺绕过真实占用或权限错误
9. 旧上游同步入口可能覆盖二次开发	已删除 `同步dsh-desktop上游.md`，后续只按 `同步DeepSeek官方上游.md` 更新官方源码	同步更新需保留吾码已有功能及 VS Code、CLI、MCP 和商店通道；检查失败时停止升级

另外修复了个别模型把思考过程混入员工消息的问题，群聊显示员工的正式回复。异常或输出截断时提示核对，不自动重复执行；正常文档内容继续保留。完整修复与验收说明见下方更新日志。

安装器可能留下 安装目录.microi-backup-会话编号 恢复目录，其中包含旧程序和额外文件。请按安装日志核对路径，在新版本正常且额外文件已取回后再由管理员清理；安装尚未完成时不要先删除备份。卷根、Windows 目录或用户资料目录本身不能作为整目录切换的应用目录，应选择专用子文件夹。

本轮实际通过范围见下方 v1.4.1 更新日志。Windows 本机和隔离验收环境的结果不替代任意客户电脑、macOS 新包、实体手机或公网通路验收。

1.4.0 历史发行说明（2026-10-16）

Windows Microi Agent 1.4.0 已完成最终安装包验收并发布到官方下载渠道，macOS 稳定版继续为 1.3.6。顶部下载按钮读取各平台实际 latest；软件版本 1.4.0 与下载资源版本 v1.4.1 分别记录。员工中心 1.1.9 已完成官方 V3 与应用商城发布，所选客户租户仍须由有权管理员独立安装、预检和验收。

本次 Windows 包冻结于 f953982f，22 项原生场景、完整九项补充、独立 SignalR 通路、字体与视觉四场景，以及官方 PC 页面整份验收均通过。此前被拒绝候选和首次失败原件保留，没有拼接部分通过项。客户物理设备、macOS 新包、实体手机与公网连接仍不在本次验收结论内。

AI 员工与对话工作流

项目群聊与多智能体协同

员工中心 1.2.5 已于 2026-11-07 发布到官方应用商城，并在授权演示租户完成安装及业务回读；配套 Windows 1.4.6 已完成本轮真实模型业务验收并发布到官方下载频道。本次群聊修复中，普通群按最后一条消息倒序，无消息的新群按创建时间排序；置顶排在最前，归档群可从「已归档群聊」恢复，历史消息继续保留。置顶和归档只影响当前用户的列表。

这次修复将模型绑定保存在员工上：同一租户、同一负责人的员工配置一次后，已有群和新建群都继承。修改一个员工只更新该员工，其他员工保持原配置。旧群中唯一一致的模型可以直接继承；如果已有群的同一员工绑定不同模型，则保留各群原值，待负责人明确保存后统一。提供商被删除或模型不可用时仍明确提示，不自动换模型。

「AI员工」默认采用项目群聊布局：左侧为项目群，中央为消息与需求材料，右侧为原十个AI岗位加独立技术总监，共十一个岗位，以及自己和已加入的吾码用户。每个项目保留独立的成员和消息；员工模型跨群复用需要上方说明的配套修复。原任务、成果及验收流程继续从任务入口使用。

在「设置 → 服务器连接（MCP）」登录所需服务器，再在「AI员工」明确选择任意一个已登录的 MCP 连接；也可明确选择已登录的吾码官方账号。项目群与「任务与验收」共用同一选择，不要求先登录官方账号，也不会自动选中第一个客户。软件记住用户明确选择的连接和项目群；连接过期或移除后保留恢复入口，不切换到其它租户。新群默认初始化十一个岗位，已有群保留原成员；群数据属于所选租户和登录用户。此处设置路径为 1.4.2 候选新入口，1.4.1 仍使用原功能区。
点击右侧员工，打开独立的「岗位模型设置」弹窗，分别选择本机 Harness 已配置的提供方和模型。多个岗位可绑定不同配置；没有模型时可点击「打开模型设置」，配置后返回刷新目录。后台刷新不会锁住已有可用选项，保存成功后回读岗位绑定；供应商被删除或模型失效时明确报错，不静默回退。非群管理员可查看绑定，不能代替群主管理配置。
输入需求或添加文本材料，发送后由岗位身份分别形成草稿。例如产品经理整理需求，技术总监提出架构，测试工程师编写测试方案。需要指定某岗时点名。1.4.2 候选不再为“在线”问候生成固定回复；岗位必须使用实际已配置模型回答，缺少模型时明确提示配置，不把角色在席当成服务健康。发送立即显示等待状态，服务端确认持久化后才显示已发送并清空草稿；明确业务拒绝时保留输入并显示原因，网络结果未知时保留原请求标识，先只读核对是否已保存。
按准确账号邀请同租户吾码用户；对方接受邀请后才成为群成员并读取消息。普通成员可参与聊天，群配置由群主维护。邀请不等于发送外部通知。
群消息按游标增量读取，可向前加载历史；查看旧消息时新回复不会把阅读位置强行拉回底部。本机负责调用岗位模型，因此本机服务、当前 MCP 登录和提供方须可用；它与原有云端后台任务是两个执行入口。关闭电脑不能声称项目群仍由本机执行。

群聊模型调用复用官方Harness模型路由和本机凭据，云端只保存模型标识，不上传模型Key。岗位草稿禁用终端、文件和外部工具；“测试方案”不能当成已经执行测试。执行前先在同一桌面实例的多个 Worker 间共享本机模型容量，取得执行名额后再领取云端租约，避免先领取却无法执行。RPC 超时不等于模型终态；响应未知时保留核对状态，重启只恢复安全的待回报，不自动重复调用已开始的模型。

达到输出上限的草稿标为 Uncertain，保留核对入口，不自动重试，也不当作完整成果。员工请求默认且最高输出预算为 16,384 Token，预算、路由和实际派发在官方 prepareCall 的同一次准备调用中确认，再按当前配置上限和剩余上下文进一步收紧；保留用户的思考设置。预算不足时在派发前明确拒绝。这个请求预算不是厂商输出能力或计费封顶；输出截断的异常契约与十一岗位实际成功推理分别验证。

失败诊断仅保留允许公开的错误分类、HTTP 状态、耗时、用量和脱敏请求标识，不回显供应商响应正文、岗位提示词、Token 或模型密钥。诊断不能确定结果时继续保留核对状态，不把 RPC 失败、输出截断或尚未回报当作允许自动重新推理的依据。

1.4.2 候选通过官方 SDK 区分文本与思考，并且必须实际收到 finish: stop 才能回报员工正文。思考通道不进入群消息；普通文本仅剥离开头已完整闭合的标准 <think> 思考块，开头思考未闭合、空白或整份模板占位时提示核对，不自动重复已开始的推理。正文内部的 Markdown、代码、引用和标签示例不作全局改写，原始文本也不会逐段写入群消息。真实验收须同时确认保存内容和界面显示，不以“回复成功”替代内容检查。

新运行只从用户所选且仍有效的 MCP 连接、当前明确选中的项目群领取。没有选群时不会在后台自动领取其它群的新任务；切换群或连接后停止领取旧群新任务。旧群已经开始的运行按原连接安全收尾，已有加密成果保留并按原范围重报，不因离群丢失，也不因此重复调用模型；结果未知时仍保留核对状态。

当前材料上传支持有界文本文件（如Markdown、TXT、JSON、CSV）；不把未接入解析的Word或PDF当作已经读取。真实模型输出、协议模拟测试和用户设备验收分别记录。

需求材料可以先用「仅发送消息」保存，再发下一条需求让岗位协作。云端将同群最近 30 条历史中的有效文本材料加入各岗位输入，优先完整保留当前需求和新附件，按内容摘要去重；容量不足会明确报错，不静默截断当前材料。验收同时检查发送后的持久化记录和每个真实模型任务的输入，不能用上传成功或回复非空代替材料已送达。

消息保存、实时同步与历史迁移

已发布的 Microi Agent 1.4.1 配合 AI 员工中心 1.1.9 使用。1.4.2 候选的新发送状态协议需要 员工中心 1.2.0。

员工中心 1.2.0 已完成官方 V3 与商城发布，并将私有源码通过授权下载后重新安装依赖，133 项测试、类型检查与正式构建均通过，三个编译产物与线上原字节一致。这些结果不替代最终桌面包验收。

所选租户需要独立安装兼容版本，并通过实际权限与数据库预检。只看到版本号、菜单或 HTTP 成功不等于该租户已就绪；预检失败会显示升级或兼容性说明，不伪装成旧协议成功。安装和升级由有权管理员在对应租户执行，软件不会自动给所有客户安装应用，也不会借用另一连接的凭据。

操作	保存与读取行为
发送消息	SQL 事务先保存消息与可靠发件箱；`Ack` 返回持久化确认，界面不等待 MongoDB 投影或模型完成。网络结果未知时保留原请求标识，不能盲目重发。
查看消息	MongoDB 提供消息查询投影；不可用时明确显示 `SqlFallback`，保留可靠 SQL 读取和待同步状态。`cursor` 只补取新增或较早消息，不在每次发送后整页重读。
查看材料	列表先读取文件名、附件标识和内容摘要；点击附件后才按当前群、消息及附件读取正文，权限校验不因延迟加载而省略。
收到通知	SignalR 仅发送群标识、版本和变更类型提示，不携带正文或凭据；客户端随后从当前明确选择的连接权威回读。旧连接、旧群及迟到请求不能覆盖当前页面。

1.4.2 候选将用户消息确认与岗位模型准备分开：未配置模型的岗位产生可审计的失败状态，其余已配置岗位正常排队，已保存的消息继续可读。为失败岗位补齐配置后，由有权用户显式重试原运行；已经开始调用或结果未知的运行不自动重放。发送响应丢失时，以同群、当前用户及原请求标识进行只读核对；MongoDB 投影尚未同步不能被解释成消息不存在，不能换新请求标识重复发送。

员工中心自 1.1.8 起将附件副本按规范四字段数组的 JSON 文本保存，并核对完整消息摘要，1.1.9 保留此修复。旧副本若在嵌套序列化中丢失字段，不能猜测解码或跳过校验；先由当前群有管理权限者进行授权只读审计。修复仅限 SQL 完整摘要与发件箱一致、原独占租约仍有效，且 Mongo 中的同群、同消息、同负责人、时间、序号及其它非附件内容全部匹配的已知缺陷形态；只更新派生附件字段并完整回读核对，不把固定标识更新当作跨存储的原子事务。未知形态、真实内容冲突或诊断不兼容时停止修复，继续保留 SQL 读取，不改需求原文、不重发消息或模型调用，也不扫描全部群或客户。1.4.1 发行时已独立验证实际附件的持久 ACK、延迟正文及后续十一岗位输入材料；1.4.2 的同包重验仍见本页发行表，纯文本消息通过不能替代附件链路通过。

SignalR 断线后显示重连或定时同步状态，并用有限轮询补齐；连接正常时仍定期权威核对，不能把“已连接”当作消息已保存。界面切换连接、群或退出页面时移除旧事件监听，后台只维护明确选中群的有界同步。群消息事件与 Harness 插件的长连接心跳是两个协议，各自需要独立验收。

实时同步要验证桌面实际使用的请求和订阅路径：管理工具中的操作执行成功，不能单独证明订阅端已收到变更通知；通知暂时未到时仍须通过授权回读补齐。修复期间官方系统完成同源 SDK 的 HTTP 请求、群订阅、续期、断线重连及非成员拒绝验证；1.4.1 最终安装包曾以两个实际登录的独立实例验证业务 SignalR 通路；1.4.2 的实际通路结果仍须独立回读。官方 PC 页面也独立验证员工群订阅和权威增量读取。这些结果不替代其它租户或客户设备验收。

旧群可能存在尚未进入新消息投影的历史。具备群管理权限时，在回退提示旁点击「迁移历史消息到 MongoDB」：每次仅检查当前群最多三批、每批 50 条，再同步最多 20 条并回读结果。界面显示已检查、已入队、已同步及待同步数量，未完成可点击「继续迁移历史消息」。失败保留已确认游标；切换连接后不继续处理旧群。此操作补建或修复投影，保留原消息标识、正文和时间，不重发消息、不调用员工模型，也不扫描其它客户或全部群。

账号恢复与业务连接

应用登录使用吾码官网账号，与模型供应商的登录和 API Key 分开。官方账号支持 https://api.microi.net，历史 https://api.itdos.com 连接单独保存；切换来源不会复用另一来源的凭据。模型设置仍可添加各类供应商，使用 DeepSeek 模型时可保留其供应商登录。

账号过期时显示「重新登录」，表单继续可用。临时网络失败时可刷新或重试，不清除其它已保存连接；登录状态读取失败不再遮住登录入口。客户租户返回“未安装或未启用 AI 员工中心”时，可切回官方账号，或由该租户管理员从应用商城安装/更新员工中心；软件不会自动修改客户数据库。没有可用岗位时禁止建空群，从「任务与验收」初始化团队后再创建。

在同一 MCP 连接中更换账号时，即使连接名称和已登录标记不变，也会按新的会话代次清理旧账号的群、消息、任务详情、岗位编辑与未发送草稿；旧请求晚到不能把旧内容写回。若服务器会话已更换、但后续凭据保存失败，仍执行这项清理并保留失败提示，不把登录标为成功，也不自动切换到其它连接。

原任务、成果与验收

在「服务器连接（MCP）」登录所需租户，或使用已登录的官方连接；「AI员工」明确选择一次后，项目群与「任务与验收」读取同一连接下当前负责人的团队。未登录会显示连接入口，失效选择不会自动转向其它租户。
从「任务与验收」进入原员工工作台，在「岗位团队」查看已有岗位的职责与交付成果，通过「岗位设置」调整名称、补充要求和启用状态。在「新建任务」填写成果目标、参考资料与可核验的验收标准，先保存草稿，再派发执行。点击任务名称或「详情」立即打开右侧抽屉，加载时显示骨架；读取详情不等待整页统计刷新。抽屉可关闭，迟到请求不会重新打开已关闭的详情或覆盖新连接。
云端任务无需本机常驻；派发后提交后台执行。任务依次显示排队、执行、待验收及已验收状态。打开成果，填写验收意见后接受或退回；后续岗位只能把已验收任务选为前置成果，最多五项。
在「目标与节奏」设置有界的每日目标，在「执行设置」查看日 Token 预算与本机节点。未知供应商 usage 按保守预留计入预算；界面中的预算不是供应商计费的绝对封顶。

成果是可审阅草稿。代码、测试计划、财务、招聘或营销文字不代表代码已经部署、测试已经执行、款项已支付、人员已录用或消息已发送。真实执行需要对应工具授权、日志、产物与回读。

Harness 和 OpenClaw 的关系

Microi Agent 的本机开发会话由 DeepSeek Harness 执行；吾码小龙虾的员工领取、续租、受限岗位调用及回传协议已经迁入桌面差异层。Harness 不能替代 OpenClaw 的全部渠道、Gateway、设备节点及 cron 协议，不能因为有对话、技能或定时能力就称为完整 OpenClaw 已内置。OpenClaw 官方仓库、定时任务说明。

「本机 · OpenClaw 受限节点」需要已有 Gateway 与本机配置。准备岗位仅新增当前租户/负责人独立的十岗目录，保留默认 Agent、模型及密钥；岗位明确禁用工具，只生成草稿。准备后按 Gateway 的要求重启服务，再连接节点。停止节点会停止接单，正在执行和待回传的成果继续保留；失败报告使用原请求重放。Gateway、网络和有效登录必须持续可用，不能把短时自动测试称作连续 24 小时验收。

对话历史、编辑与撤回

输入框按 ↑ 回填已成功发送的提示词，按 ↓ 向后浏览并恢复未发送草稿。多行文本在开头/末尾才进入历史；输入法、选区、附件及候选菜单优先处理各自操作。
已发送用户消息提供「编辑」「撤回」。编辑从该消息之前的已完成轮次分叉并重新发送；撤回将消息恢复为草稿。原会话保留在历史中，新会话的模型上下文不再包含被替换的消息。
已执行的文件修改不会随撤回自动恢复。图片随草稿恢复；目前带文件附件的消息会明确提示在新会话重新添加文件，避免静默丢失附件。子智能体消息通过父会话继续处理。
正式包内置吾码 Skills；在干净工作区输入 /microi 进入吾码流程，不再依赖开发机安装目录。业务服务器仍须独立登录与授权。

首页、品牌与桌面功能区

1.4.0 起继续保留官方工作区与预设选择、吾码 AI 能力入口和 29 项图像能力，并移除独立「PPT模板」菜单、专用 PPT dock 及其模板管理入口。1.4.2 候选把「审查」「Microi吾码」「服务器连接（MCP）」「采集引擎」「环境与服务管理」集中到设置，原业务仍可使用。通用 Office 文档处理能力继续保留，Word、Excel 和 PowerPoint 可通过已授权的通用 Office 流程处理；移除专用 PPT 入口不等于移除 PowerPoint 文件能力。1.3.9 及以前日志中的 16 模板和个人模板属于历史功能记录。

1.4.2 候选侧栏依次为品牌、新会话、常用功能、任务/工作区与底部账号及单一设置入口；常用功能只有 AI 员工、插件与自动化任务，其余分区在设置中统一访问。Ctrl+, 仍打开完整设置，帮助分区提供吾码官网、QQ 群 51050055、关于与手机配对。该顺序按本轮需求更新，旧版“工作区在功能区上方”的布局保留在历史记录。员工群缩小行高、头像与间距，保持消息主体的可用空间；窄屏通过项目列表与成员抽屉访问两侧内容。任务详情及岗位模型弹窗保留键盘、关闭后焦点恢复和浅深主题。

十一个岗位具有各自的 SVG 角色图标与轻量配色，自己及普通用户使用独立的通用人物图标；头像颜色只帮助区分身份，不代表在线状态、模型可用或成果已完成。员工消息与任务区优先使用系统中文界面字体，采用官方浅深主题颜色，保持正文、气泡和侧栏层次可读。历史 1.4.0 安装包完成 1440 / 390 像素浅深主题的字体与视觉专项，原生截图见本页 1.4.0 记录；该历史结果及 1.3.9 截图均不替代 1.4.2 新包验收。

连接应用中的「应用到 Microi Agent」把当前应用的 Logo 和名称应用到软件左上角，只保存本机设置，不修改客户业务系统标题。「恢复 Microi Agent 品牌」清除本机品牌设置。「关于」独立显示软件版本，并保留历史、更新与回退入口；1.4.2 候选中的关于与手机连接统一从设置的帮助分区进入。

安装、签名与平台兼容

页面顶部的 Windows 按钮优先提供版本记录中较新的已发布不可变安装包；自动更新频道达到同版或更高版本后，按钮改用永久 latest 入口，后续频道升版无需再改官网。手动下载可用不表示自动更新已经推进；未取得发布与完整文件回读证据的候选不加入版本记录。旧版归档和当前安装包的 SHA-256 可在下方展开“版本记录”后查看；版本越多会自动分页。

macOS 的 Intel x64 与 Apple Silicon 下载入口分别读取对应清单，版本只按有效频道显示；没有有效 Intel 清单时显示准备状态，不显示假版本。无 arch 参数的原 Mac 入口保持 generic 1.3.6 Universal，不会自动切换成单架构 Intel 包。更新元数据由 Windows latest.yml、macOS generic latest-mac.yml、Intel x64 独立频道和版本目录提供；Intel 1.4.7 同时保留不可变版本清单。macOS 自动更新使用 ZIP，DMG 用于手动安装。

本次发行记录（2026-10-18）：Windows 1.4.2 对应下载资源 v1.4.3；【渠道 Completed；完整 EXE 与清单回读通过；资源提交第 15 版，发行清单 SHA-256 19fc3bbba1b041455070a35b498d8ba514de33fa9de8c80fde619346febbf33d】。Mac 最新渠道 1.3.6 / 清单 SHA-256 ac9fab14113ab5ddd48b14c75aab865b867b912c102ad3b7fb96e38eec154a06 已在发布前后完整回读并保留，不能由 Windows 结果推进。

Windows 1.4.2 不可变安装包为未签名 EXE，264631649 字节，SHA-256：e0bb17a31d453e3c496cc0168be07bec5bbb81b329d01530ea22fa4af2a222de；发行清单与验收摘要绑定同一产品源码与八份原生原件。已取得渠道 Completed，并独立完整下载核对安装包与清单。

历史发行记录（2026-10-17）：Windows 1.4.1 已完成原生矩阵的九次安装执行（七次新版、两次旧版前置），以及本机真实 1.3.8 安装目录到 1.4.1 的覆盖升级；新程序与旧快照文件均逐项核对 SHA-256。最终包的 22 项原生场景、产品 UI 12 项与补充连接专项通过。官方下载和永久 latest 的完整安装包字节 / SHA-256 回读相符。macOS 继续提供已签名、公证的 1.3.6 Universal 包，本轮保留 Mac 更新清单原字节，未发布 Mac 新包。

本次 Windows 1.4.1 不可变安装包为未签名 EXE，266,510,695 字节，SHA-256：03bfb220f43c95000f1b8e6df2e02595589792cc5ef23b823c24a052b54a1c32；发行清单与验收摘要可独立回读。资源归档路径的 v1.4.2 是下载资源版本，软件实际版本为 1.4.1。SHA-256 校验完整性，不代替可信发布者签名或客户设备验收。

历史 Windows 1.3.9 不可变安装包为未签名 EXE，289,552,267 字节，SHA-256：b6a76a4e72ac889682a6f68ca07cf58e737ad33c0ea2543c66c693aa352baa47；发行清单与验收摘要可独立回读。资源归档路径的 v1.4.0 是下载资源版本，软件实际版本为 1.3.9。完整审计证据保留于内部源码仓库，公开清单不包含凭据或本地路径。

历史 1.3.7 阶段提供了一键原生验收工具，解压并双击 一键验收.cmd。它自动回读安装后的全部文件 SHA-256，运行六项真实 NSIS 故障回归，再从完整产品主入口启动两次，检查 Worker 与 Harness 重启；结果 ZIP 位于工具 result 目录，失败也会保存证明。工具只导出证明 JSON 和测试截屏，不导出测试 Profile 或凭据。该阶段的记录为：六项 NSIS 夹具已在 Wine 通过，Windows 原生升级与启动当时仍待验收；当时自动更新 latest 和 macOS 签名公证版均保持 1.3.6。这些历史状态不代表当前下载版本，后续发行结果见本页对应版本记录。

Windows 启动恢复说明：针对 1.3.1 在客户电脑上 IPv4、IPv6 回环 HTTP 连接均超时的问题，新增当前 Harness 私有命名管道恢复，并保留认证、Cookie、WebSocket、工作区和会话。本包未签名；构建、自动回归和 MacBook 上真实 Harness/Electron 验证已通过，客户 Windows 原生安装与启动仍待确认。请使用顶部 Windows 按钮下载最新测试包；失败时提供新版 harness.log，无需先卸载插件或删除工作区。

当前 Windows 版本以页面顶部为准；SHA256 证明文件完整性，不证明发布者身份。内部源码根目录双击 一键打包Windows.cmd 或执行 powershell -ExecutionPolicy Bypass -File .\一键打包Windows.ps1 即可打包；Auto 模式发现 Microsoft Artifact Signing 或本机证书配置时自动签名，否则明确提示后继续生成未签名包。-Signing Signed 才会在缺少凭据时失败。商店版由商店更新，不下载或安装官网 EXE；官网 Windows 1.3.6 测试包仍为未签名 EXE，商店 MSIX 1.3.3 由微软签名。普通 Microsoft 帐号不能直接签官网 EXE。微软分发说明
Windows 商店版 1.3.3 已发布：2026 年 10 月 3 日复查，Microsoft 后台显示“在 Microsoft Store 中”，中国区公开产品页已显示 Microi Agent 的名称、发行者、截屏与介绍；商店 MSIX 由微软签名分发。请在 Windows 设备打开 Microsoft Store 查看获取入口。本机 Mac 的产品页没有获取按钮，Windows 原生获取、安装与启动仍待验收；商店发布不会改变官网 EXE 的未签名状态。
免费微软签名 EXE 在线安装器：可直接下载 Microi Agent 商店在线安装器。这个小型 EXE 由 Microsoft Store 生成并签名，运行时联网检查设备条件、下载并安装当前商店版（当前为 1.3.3.0），后续由商店更新。它不包含官网 1.3.6 完整安装包，也不会给该完整 EXE 增加签名。采用微软官方 Store Web Installer，无需购买代码签名证书；官网下载入口继续提供最新版完整包。
如果旧安装包提示 Failed to decompress files 或 Error opening output file(s)，请从本页顶部重新下载 Windows latest 安装包后运行；不要重复启动下载目录中缓存的旧安装包。新版安装器改用能处理内置中文技能文件名的解压方式，覆盖安装会保留工作区和会话数据。
如果已退出应用仍提示“无法关闭”，旧安装器可能把长路径或文件复制失败误报成应用正在运行。新版使用当次发行的兼容卸载器完成升级；工作区、会话和用户配置保持不变。如果新版仍失败，请使用下面的诊断入口，不要反复重装。
1.2.6 修复了已重现的长路径清理问题，但仍有客户报告“旧版本文件清理失败（错误码 2）”。该数字是卸载器退出码，不能直接判断哪个文件失败、是否被占用或缺少权限，也不能据此认为所有客户的升级问题已解决。
Windows 1.2.8 安装事务：针对安装盘与系统临时盘不同、旧文件搬运及回滚出现 Win32=33 的情况，新版先将完整新程序解压到安装盘的同级暂存目录，再切换旧、新目录。旧文件备份仅在同盘重命名，不再逐文件复制到系统临时盘；切换失败会尝试恢复旧目录，未恢复的备份保留在 安装目录.microi-backup-会话编号，不会随临时目录删除。成功后清理本次旧程序备份；仍被锁定的残留路径写入日志。请勿手工删除失败日志所指的恢复备份。已覆盖真实字节锁、跨盘安装、中文长路径和失败回滚；客户电脑仍需安装验收。
Windows 1.2.9 启动探测：本机请求的超时现在同时覆盖 TCP 连接和响应头，避免单次连接卡住整个启动流程。Harness 已输出认证地址而 Node 探测失败时，再使用页面同样的 Chromium 网络通道验证；只有收到实际 HTTP 响应且 Harness 已提供本次认证信息才继续加载页面。两条通道都失败时保留各自错误，恢复页显示“本地服务未响应”，不会把重复的超时记录丢掉或据此建议卸载插件。开发验收使用安装包内 Node/Harness，覆盖普通模式、安全模式、Node 超时下的真实 Chromium 页面加载和双通道不响应；这些测试不等同于客户设备已验收。
Windows 1.3.1 回环恢复：客户确认 1.2.9 仍在 127.0.0.1 上出现 Node 与 Chromium 双通道连接超时。新版连续确认两次连接失败后，只重启一次 Harness 到新的 IPv6 回环地址 ::1；仍须取得本次认证信息并收到真实 HTTP 响应才加载页面，不监听公网地址、不绕过认证。IPv6 不可用时停止重试并保留具体错误。本机 HTTP 端口避开浏览器禁止端口，自动选到禁止端口时有界重选，显式配置和真实权限、占用错误继续报错。日志增加实际应用版本、监听地址和子进程内 HTTP 自检，便于区分监听失败与桌面连接失败。请从顶部永久下载入口升级，若仍失败，请提供新 harness.log；开发环境通过不能代替该客户 Windows 安装和启动确认。
安装仍失败时：Windows 1.2.7 起已将诊断集成进安装器。失败窗口提供「复制安装日志」和「打开日志」，无需下载独立诊断工具。日志保存在 %LOCALAPPDATA%\Microi Agent\installer-logs\；目录不可写时使用 %TEMP%\Microi-Agent-installer-logs\，退出安装后仍保留。日志包含实际失败步骤、文件路径、迁移的 Win32 错误、卸载器或 7-Zip 退出码、回滚错误，以及只读文件访问和 Restart Manager 占用 PID 检查。请把复制的日志提供给支持人员；本机测试通过仍不代表该客户设备已通过验收。
“工作区服务连接已断开”与云端账号未登录是不同问题。新版修复了旧空凭据保险库导致服务退出的情况；对损坏或其他 Windows 用户加密的凭据会保留原文件并报告具体错误，不会静默清空凭据。安装成功后还应打开「Microi吾码」和「AI 员工」检查本机服务连接。
macOS 1.4.7 为 Intel x64 包，1.3.6 继续提供 Universal 通用架构供 Apple Silicon 使用，最低要求 macOS 13.5。两个版本均有各自的 Developer ID 签名、公证与发行记录；不能据 Intel 新包声明 ARM 新版可用。内部打包以当前源码根脚本及《macOS一键打包.md》为准，分别按目标架构执行并验收，不把单架构文件改名为 Universal，也不以一台 Intel Mac 的运行代替 Apple Silicon 原生验收。
当前 Electron 桌面应用不能直接生成 iOS/Android 安装包。Mac App Store 版采用独立 App Sandbox 客户端，提供本地提示词管理和桌面配对会话；Node/Harness、Shell、项目文件、插件与 MCP 在已配对的桌面或其服务端执行。1.3.2（构建 1.3.3）已于 2026 年 10 月 2 日提交，最近一次后台核对为等待审核；2026 年 10 月 3 日公开入口仍尚未开放商店下载；商店入口为 Mac App Store。需要完整本机开发能力时，仍使用本页顶部的已签名、公证 DMG。商店版本由 App Store 更新，不安装站外更新或插件。

Windows 版本与下载选择

当前 Windows 安装包只发布 x64。商店 MSIX 的实际清单最低版本为 10.0.19041.0（Windows 10 2004）；包声明允许安装不等同于客户设备已完成运行验收。建议使用维护中的 Windows 11，或已获得适用安全更新的 Windows 10。

系统与架构	微软签名在线安装器 / 商店版	官网完整 EXE
Windows 11 x64、Windows 10 2004 及以上 x64（含 22H2）	满足包声明的系统条件；需联网，仍受商店可用性、账户、地区和管理员策略约束	提供本页顶部已发布的 Windows x64 完整安装包；签名状态与原生验收范围以对应发行记录为准
Windows 10 2004 之前的 x64（含 1809 / 1909）	不满足当前商店包最低版本，不能用在线安装器绕过	当前 Electron / Node 以 Windows 10 为运行基线，但这些旧构建未验收；不承诺兼容，建议先升级系统
Windows 7 / 8 / 8.1、32 位 Windows（x86）	不支持当前应用	不支持；当前 Electron 已不支持 Windows 7 / 8 / 8.1，包内 Node 和原生组件为 x64
Windows 11 ARM64	系统支持 x64 仿真，但本产品尚未完成 ARM 设备验收；没有 ARM64 原生包	x64 仿真兼容性待验收；Windows 10 ARM 仅提供 x86 仿真，不能运行当前 x64 包
Windows LTSC / Server / 受管理企业设备	依具体系统构建、商店服务与策略而定；LTSC 2019 的 17763 低于当前包要求，Server 尚无已验收的商店安装路径	需独立验证桌面环境、权限和组件；Server Core 不作为桌面客户端支持目标

商店在线安装器必须连接 Microsoft 服务；离线环境不能用它完成安装。企业安全策略或 get.microsoft.com 访问限制可能阻止下载、安装。可按组织批准的分发方式使用官网完整包，但这不会获得微软签名，也不保证通过 S 模式、WDAC、AppLocker 或其它应用控制策略。不要关闭安全软件、导入自签名根证书或降低策略来冒充公信签名。

上面的兼容范围依据微软 MSIX 平台规则、Electron 系统要求、Node 24 平台要求和Windows ARM 仿真说明。Windows 真机安装、旧版升级、Harness、终端、登录、Skills、MCP 和商店更新需在对应系统分别验收；Mac/Wine 打包和网页检查不能替代这些结果。

Windows 商店版隐私政策

本政策适用于 Microsoft Store 分发的 Microi Agent 桌面版。应用提供 AI 对话、项目工具、MCP 和吾码业务连接；项目、会话、本机配置与日志默认保存在当前用户的数据目录。商店负责应用更新，应用不会用官网 EXE 替换商店安装。

登录吾码账号时，账号信息和认证请求发送到用户选择的吾码服务器。使用 AI、MCP、图片、音频或视频服务时，用户提交的提示词、附件及任务所需的项目内容发送到所选服务；具体保存期限、额度和访问权限由这些服务及所属租户决定。配置第三方模型、MCP 或业务连接前，请了解其隐私政策与权限。应用不内置广告追踪 SDK；本声明不表示用户选择的云服务不收集或保存数据。

AI 对文件、命令和业务数据的访问遵循当前任务授权和工具确认。敏感文件应避免主动提交到不可信服务；用户可在应用内删除会话、断开连接及清除登录状态，清理本机数据前请备份需要保留的内容。云端账号或数据的删除请求请联系对应服务；吾码官方服务的隐私与支持联系邮箱为 admin@microi.net。

Mac App Store 客户端

提示词功能无需登录：在「提示词」新建、编辑、复制条目，也可主动选择 JSON 文件导入或导出。删除条目后可撤销；导入前检查数量、格式和长度，格式错误时保留原有库。

继续桌面会话的操作为：在完整版 Microi Agent 打开「连接手机」，复制配对链接，在商店版「连接桌面」粘贴，然后在原桌面确认连接。之后选择工作区和会话，发送任务、查看回复并回答执行确认。原桌面需保持运行；公网链接必须为 HTTPS，局域网可使用私有 HTTP 地址。执行权限、模型配置和业务服务器沿用原桌面配置。

Mac App Store 客户端隐私政策

本政策适用于独立商店沙盒客户端。开发者不通过这个客户端收集分析、广告、追踪或崩溃遥测数据；客户端不内置这些收集 SDK。提示词默认只保存在本机应用容器中，只有用户主动导出时才写入所选文件，不自动上传提示词库。

连接由用户主动提供的桌面配对链接建立。连接地址、一次性配对口令、登录会话和交互内容仅发往所选择的配对目标；公网使用 HTTPS。已配对桌面及其配置的 AI、MCP 和业务服务可能按各自配置保存会话、项目和日志；请同时了解这些服务的隐私政策与访问权限。本声明不表示用户自行选择的服务不收集或保存数据。

「断开并清除登录状态」会清除客户端的配对网站会话存储；不会删除另一桌面的历史会话、项目或业务数据。提示词可在客户端删除或导出；卸载和清理应用容器前请先备份需要保留的条目。文件权限仅用于用户主动选择的提示词导入、导出，不授予访问整个项目目录的权限。隐私问题可通过本页的官方技术支持入口联系开发者。

安装后依次「打开项目 → 登录吾码账号 → 添加业务服务器 → 初始化项目 / 拉取资源」，即可开始开发。AI 使用的是你的官方中转额度，实际可用模型与额度以账号页面为准。停止任务或退出后保留历史记录，后续可在新任务中引用历史继续。

在「服务器连接（MCP）」卡片点击「应用到 Microi Agent」，会读取该应用的 SysLogo、SysShortTitle / SysTitle，并将 Logo 与名称应用到 Microi Agent 左上角。品牌设置只保存在当前电脑的 Electron 本机配置中，不会上传文件、修改业务系统的 sys_config，也不会把 Microi Agent 写回租户；「恢复 Microi Agent 品牌」只清除本机品牌设置。

开源基础、版权与后续同步

1.3.6 完整版的 dsh-desktop 基线为 beb6821af66d5980b2526ecb63b2df29badf4a1f，Harness 使用 0.2.1-alpha.1、官方 tag dsh-v0.2.1-alpha.1，源码基线为 5badb15009ae1756c3afe0ae0cef1faafc290ccc。这是官方当时最新的 alpha 代码；上一个完整版使用 desktop 97e02f8bf773 与 Harness 0.1.5-rc.2。内部 .microi-upstream.json 同时记录 Git 来源、npm 版本和 integrity，后续同步须保留吾码差异层并通过补丁、回归和真实界面门禁。

从 1.3.8 起，生产宿主改为 DeepSeek 官方桌面源码，锁定提交 d743267388641bc76f17c45ce8b4c231aed1d32c，Harness 0.2.1-alpha.2 与 Electron 44.7.0。旧 dsh-desktop 保留为历史和迁移回归资料，正式打包入口使用 apps/official-desktop/。

1.4.2 候选将官方基线同步至 0.2.1-rc.2（tag dsh-v0.2.1-rc.2），对应提交 687f282e8625c6b8d11ff58211a90524be2e4317。该基线属于官方预发布软件；V4.1 Flash 等名称属于模型，不是桌面版本。候选基线须在归档、完整文件树、锁文件、每个精确接缝及吾码保留功能全部核对后，才进入最终安装包验收与渠道发布。

官方源码、吾码业务、装配补丁分别维护：apps/official-desktop/.upstream/source 是经过归档哈希与完整树校验的纯净缓存，.build/source 是可重新生成的构建候选；二者不进入 Git。apps/official-desktop/microi、client-plugin、model-plugin 提供窄接缝，并复用 apps/microi-code/microi、src/main/microi-* 与 packages/microi-code-* 的既有业务。VS Code、CLI 与桌面继续共用协议和实现。

同步DeepSeek官方上游.md 是新同步入口。scripts/official-overlay.mjs 与维护的会话插槽补丁必须对锁定源码准确重放；上游目标缺失、内容变化或匹配数量异常即中止。同步检查保护吾码文件的完整指纹，禁止用官方仓库覆盖吾码业务目录；修改上游锁之前需要在隔离候选完成全部门禁。同步dsh-desktop上游.md 已删除；历史派生模块与许可只保留发行追溯，不再作为同步入口。

补丁无法重放、测试失败或界面验收不通过时都不会推进上游基线。每次同步都要按补丁意图清单重新验证登录、AI 中转、LicenseType、服务器连接、AI 列表、数据分析、插件安装、功能区、关于页、移动连接、Windows/macOS 构建和更新源。

吾码桌面业务优先通过 microi_itdos 接口引擎实现，接口引擎实在缺少所需底层原子能力时才修改后端源码。当前账号版本直接读取现有 platform-current-user 返回的 sys_user.LicenseType；更新目录由 https://api.microi.net/microi-code/updates/ 下的匿名接口引擎提供，安装包二进制由 HDFS 流式上传。Windows/macOS 安装包内置固定版本并校验过 SHA-256 的 cloudflared，互联网连接不再在首次使用时从 GitHub 临时下载约 50 MB 可执行文件。

当前桌面基于 DeepSeek Harness 官方源码，遵守其许可证并保留版权声明。既有派生模块仍保留 dsh-desktop Copyright (c) 2026 DataElement 与 MIT License，以及历史 dsh-desktop 仓库链接。更换生产宿主不删除历史派生代码的署名。吾码账号、AI 中转站、服务器连接、MCP、Skills、AI 员工项目群、采集和环境服务管理继续由 Microi Agent 差异层维护。

展开完整的开发、安装、调试与上游同步手册

同一套 AI 能力，四种使用入口

传统低代码把开发从“写大量代码”变成了“手动建表、逐个添加字段、拖拽控件、配置菜单、拼界面 JSON、设计打印模板和工作流”。Microi吾码进一步把这些操作变成自然语言，并提供四个互补入口：

Microi Agent 桌面工作台：内置 DeepSeek Harness，用吾码官方账号直接开始 AI 开发，支持 Windows / macOS 的原生安装包。
VS Code 插件：适合需要资源树、编辑器按钮、Diff、可视化状态、远程执行和逐行调试的用户。
@microi.net/cli：产品展示名为 microi.net/cli，适合 Codex、DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder、Comate、Claude Code、Trae 或普通终端用户。
多宿主 AI Plugin：同样来自 @microi.net/cli；包根同时携带 Codex/WorkBuddy/CodeBuddy 清单、DeepSeek Harness 原生 bundle、同源 MCP、CLI 和全套 Microi Skills。

四个入口位于同一个独立的 Microi.Agent 仓库，复用连接、认证、同步、MCP 和 AI 知识注入代码。业务项目共用连接配置、Token 与同步基线；桌面的官方 AI 账号单独管理。可以只安装一种，也可以同时使用。

你描述业务目标，AI 通过插件内置的 Microi MCP、平台知识库和 Skills，完成业务蓝图、数据模型、表单字段、菜单权限、接口引擎、V8 事件、数据源、界面引擎、打印引擎、工作流、定时任务、前端微服务以及自动化测试。

这意味着，无论是 OA、ERP、MES、CRM、WMS、项目管理、售后服务、商城、预约、物联网，还是高度定制的行业系统，都可以从一段业务需求开始，由 AI 按 Microi 平台规范规划、生成、验证并持续迭代。

对业务人员，它是一套以自然语言为主要交互方式、无需手写代码的系统开发方案；对专业研发人员，AI 生成的 V8、前端源码、元数据和测试仍然可查看、可调试、可 Git 管理、可人工接管。

text

自然语言需求
    ↓
业务蓝图 / 现有系统 / 实时数据库结构
    ↓
Manifest 全系统规划 + dry-run 预演
    ↓
用户确认后通过 MCP 写入 Microi
    ↓
表单 · 菜单 · 权限 · V8 · 页面 · 打印 · 流程 · 微服务
    ↓
远端回读 · 系统验收 · E2E · 压测 · 本地/远端同步

可以直接这样对 AI 说

text

请为当前租户创建一套设备维保系统：包含客户、设备、保养计划、工单、配件、
巡检记录和知识库；设计管理员、调度员、工程师三类角色；工单支持派单、接单、
处理、验收、回访和超时提醒；生成 PC 后台、移动端字段布局、运营驾驶舱、工单
打印模板、审批流与 Playwright 验收用例。先读取现有蓝图和数据库，给出 dry-run
计划，确认后再写入，最后验证系统并报告同步状态。

也可以从任意局部开始：

“把这份需求文档整理成业务蓝图和完整系统 Manifest。”
“为客户表补齐联系人子表、查询条件、列表列、统计字段和移动端卡片字段。”
“生成一个销售运营驾驶舱，包含核心指标、趋势图、排行榜和待办列表。”
“设计一张 A4 工单打印模板，包含设备信息、处理明细、图片和签字区。”
“把这个复杂弹窗改成可维护的前端微服务，并在 Microi 中发布。”
“检查当前系统的表、字段、接口、菜单、工作流和蓝图是否发生漂移。”

AI 如何交付一套完整系统

插件把“自然语言”与“真实平台能力”连接起来，不依赖 AI 猜测表结构，也不只是生成一段无法落地的示例代码。

发现事实：读取当前服务器、OsClient、业务蓝图、数据库结构、菜单、接口引擎以及已有 Web / UniApp / MicroService 应用。
理解业务：梳理角色、业务域、数据关系、状态机、权限、流程、页面、打印和验收标准。
生成计划：将需求转换为完整 Manifest，通过 microi_plan_system 或 microi_generate_system dryRun:true 预演，不直接写入。
确认执行：用户确认后，创建或升级表、字段、模块、权限、接口、事件、数据源、页面、打印、工作流和任务。
补齐定制界面：常规业务优先使用表单引擎和界面引擎；复杂交互通过前端微服务实现，并保留完整源码。
回读与验收：验证每个资源是否真实存在、字段和菜单配置是否完整、工作流拓扑是否正确、远端代码是否生效。
自动化交付：生成并运行 Playwright E2E、网络与资源守卫，按需执行性能测试，再检查本地与远端同步状态。

所有关键写入工具都保留确认、审计、超时回读与幂等保护。全系统生成默认先 dry-run；真实写入需要明确的 confirmExecution，避免一句含糊的对话直接改动业务系统。

核心能力

能力	说明
自然语言生成完整系统	从需求直接生成业务蓝图、Manifest、表、字段、表单布局、菜单树、权限、接口、事件、数据源、页面、打印、工作流、任务和测试。
内置 Microi MCP Server	VSIX、CLI npm 包与 Codex Plugin 都打包同一 MCP Server，普通用户无需克隆 `microi.mcp`；一键配置后，AI 可直接读取和操作当前 Microi 租户。
DeepSeek Harness 原生 Bundle	npm 包声明 `dsh.bundle.patch`，通过 DSH 官方 profile/plugin 协议加载 `@deepseek-ai/dsh-mcp-client`，复用同一多连接路由器，不维护第二套 Microi API。
110+ 个平台工具	当前源码已超过 110 个注册工具，覆盖系统发现、低代码建模、V8、页面、打印、流程、微服务、测试、文件、Redis 和 MongoDB 日志等能力；精确清单以运行时 `tools/list` 为准。
AI 知识库与 Skills 自动注入	自动生成 `AGENTS.md`、`CLAUDE.md`、Copilot/Cursor 指令、V8 类型定义和 `microi.skills/`，AI 无需反复“喂文档”。
实时数据库理解	AI 可通过 MCP 查询实时表结构，也可按需读取每个 OsClient 的 `.microi-db-schema.md` 快照；大型数据库不会塞满公共指令文件。
V8 全资源本地化	接口引擎、表单事件、字段事件、模块按钮/Tab、模块 Join/Where、工作流节点代码均可拉取为本地 `.js` 文件。
远程执行与调试	VS Code 提供 DAP 可视化调试；CLI 与 Codex Plugin 通过同源 MCP/Skill 完成远程执行、堆栈诊断、最小补丁和复测，UI 形态不同但不复制远端实现。
安全同步与冲突检测	支持单文件推送、服务器一键同步、远端 Diff、同步结果下钻和双端修改冲突拦截。
前端微服务全生命周期	创建、拉取、构建、发布、同步私有源码、维护路由清单并检查源码冲突。
AI 模型统一配置	在插件中维护模型库，并分别同步到 Claude Code、Codex 和 GitHub Copilot；内置 DeepSeek、通义千问、MiniMax、腾讯混元、OpenRouter 等快捷预设。
Playwright E2E	生成 Microi 专用测试工程、登录与接口辅助方法、冒烟测试、契约测试、网络守卫、视觉与资源检查，并打开 HTML 报告。
性能压力测试	对接口引擎、V8 事件和表 CRUD 执行并发/升压测试，输出 RPS、平均耗时、P95/P99、错误率、趋势与错误 Top。
多服务器 / 多租户	同一工作区可管理多个服务器和 OsClient，连接、Token、MCP 配置和本地目录彼此隔离；VS Code、CLI 与 Codex Plugin 共用这些数据。

MCP 工具覆盖哪些平台能力

插件内置 MCP 不是一个“万能写入接口”，而是一组按 Microi 业务对象设计、带参数校验与安全边界的专业工具。

领域	代表能力 / 工具
系统与结构发现	`microi_get_status`、`microi_get_db_schema`、字段、模块、角色、接口、事件和应用清单读取
业务架构蓝图	`microi_get_blueprint_schema`、列表/详情、历史读取、结构化比较、CAS 保存、校验与审计回滚
全系统 Manifest	`microi_get_manifest_schema`、`microi_plan_system`、`microi_generate_system`、`microi_validate_system`
表单与数据模型	创建表、添加/批量更新字段、关联字段修复、字段控件配置、表属性更新、结构缓存刷新
菜单与权限	创建菜单模块、维护列表/搜索/统计/移动端字段、按钮与 Tab、角色和菜单权限
V8 与接口引擎	创建/读取/保存/执行接口引擎，表单与字段事件，模块按钮代码，工作流节点 V8，匿名访问配置
数据源与业务数据	SQL/V8/JSON 数据源，表数据查询/新增/修改/种子数据，文件上传
平台管理员数据控制面	`microi_get_administrative_capabilities` 实时复核 DiyToken、当前租户主库与有效管理员角色；`microi_admin_table_data` 在当前租户执行受确认的通用单表查询/单行增改删，访问密钥拒绝、秘密字段脱敏
界面引擎	从自然语言生成、校验和保存 Page Engine 页面；支持当前哈希、历史、比较、导出与审计回滚
AI 平台治理	门户、身份与权限、配置、功能开关、发布审批/执行/回滚、服务流量、Trace、日志生命周期、可观测告警、组件资产、页面源码桥接、协作和可恢复导入
打印引擎	从自然语言生成、校验和保存 hiprint 打印模板与运行数据结构
工作流与任务	工作流包、拓扑检查、条件路线测试、节点 V8、定时任务
在线 AI 应用	发现 Web / UniApp / MicroService，读取完整源码上下文，创建、同步和发布前端微服务
测试与验收	Playwright 上下文、E2E 计划、系统后置验收、页面/打印/菜单配置校验
运行维护	Redis 统计、SCAN、读取、删除、替换、重命名、TTL；MongoDB 日志查询与写入

Codex 大工具集兼容

部分 Codex 版本不会稳定注入超大 MCP 工具集。插件会为 Codex 配置 microi_codex 单入口：AI 可先用 list_tools / describe_tool 发现全部原始工具，再通过同一入口调用；参数校验、写入确认、审计和远端回读不会被绕过。

如果当前 Codex 仍未注入工具，MCP 还提供 microi://codex/status、microi://codex/tools 和通用 action 资源模板作为兼容通道。其它兼容客户端继续使用完整 MCP 工具集。

支持的 AI 客户端

执行插件命令 Microi: 初始化AI配置 或 CLI 命令 microi ai init 后，工具会针对不同 AI 客户端生成各自能够自动识别的指令与 MCP 配置。

AI 客户端	项目知识与规则	MCP 配置	模型配置
GitHub Copilot / VS Code Agent	`.github/copilot-instructions.md`、V8 typings、Skills	`.vscode/mcp.json`	支持同步吾码模型库到 Copilot Provider
Cursor	`.cursorrules`、`.cursor/rules/microi-skills.mdc`、V8 typings	`.cursor/mcp.json`	使用 Cursor 自身模型能力
Trae	`AGENTS.md`、Skills、V8 typings	`.trae/mcp.json`	首次使用需开启项目级 MCP
Claude Code	`CLAUDE.md`、Skills	工作区根 `.mcp.json`	支持检测/安装 Claude Code，并同步模型库
Codex	`AGENTS.md`、Skills	`~/.codex/config.toml`	支持同步 Provider、模型目录与环境配置
DeepSeek Harness	`AGENTS.md`、工作区 Skills	`@microi.net/cli` profile bundle	`microi dsh install` 默认安装到 `web` 与 `headless` profile
WorkBuddy	`AGENTS.md`；npm 包内含 WorkBuddy Plugin 与全套 Skills	`.workbuddy/mcp.json`	保存/重载后可用自然语言自动调用 MCP
CodeBuddy	`.codebuddy/skills/microi/SKILL.md`、`.codebuddy/rules/microi.md`	工作区根 `.mcp.json`	也可安装包内 `microi@microi-net` 原生插件
Qoder	`.qoder/skills/microi/SKILL.md`、`AGENTS.md`	工作区根 `.mcp.json`	当前会话可用 `/skills reload` 刷新
百度 Comate	`.agents/skills/microi/SKILL.md`、`.comate/skills/microi/SKILL.md`	`.comate/mcp.json`	自动发现项目 Skills

各宿主路径依据其官方协议实现：

WorkBuddy MCP、Skills 与插件系统
CodeBuddy Skills、MCP 与插件规范
Qoder Skills、MCP 与 AGENTS.md 规则兼容
百度 Comate Skills 与 MCP.json
DeepSeek Harness profile/plugin 协议与 DSH MCP Client

VS Code 插件和 CLI 都支持本地 stdio MCP；远程 SSE 与可视化生命周期管理当前由插件提供：

本地 stdio MCP：推荐方式，由 AI 客户端自动启动 VSIX 或 CLI 包内置的 MCP Server。
远程 SSE MCP：适合团队共享，需要提前部署远程 MCP 服务。
一键诊断：真实执行 initialize、tools/list 和 microi_get_status，区分“配置已存在”与“当前真的可调用”。
生命周期管理：在 Microi 侧栏启动、停止、重启、查看输出、查看配置、启用/禁用或移除 MCP Server。

Codex 已打开的会话通常不会热加载新增 MCP。首次生成配置后，请新开 Codex 对话或重载 Codex；其他客户端也可能要求首次批准新 MCP Server。
WorkBuddy 官方项目 MCP 路径是 .workbuddy/mcp.json；CodeBuddy 与 Qoder 使用根 .mcp.json；Comate 使用 .comate/mcp.json。CLI 和 VS Code 插件会一次性幂等生成这些文件，但不能绕过各宿主的工作区信任、插件授权或重载机制。
DeepSeek Harness 不读取上述 .mcp.json。它使用 $DSH_HOME/profiles/<profile>/package.json 中的 bundle 层；安装完成后工具名为 mcp__microi__microi_codex，再由同源路由器发现和调用完整 Microi MCP 工具集。

零配置知识库：AI 自动理解 Microi

插件把稳定知识、专项规范和实时业务结构分层管理：

公共知识层：V8 API、_Where 语法、上下文变量、表单事件、HTTP/缓存/数据库/Office 等稳定知识。
Skills 规范层：低代码建模、V8、表单布局、菜单按钮、界面引擎、打印引擎、UniApp、前端微服务、E2E、性能测试和全系统交付规范。
实时事实层：当前 OsClient 的数据库、菜单、接口、事件、应用与蓝图，优先通过 MCP 查询。
本地快照层：.microi-db-schema.md 与本地 V8/前端源码，便于离线分析、Diff 和 Git 管理。

即使只是一个空目录，也可以通过 VS Code 插件或 CLI 直接初始化。工具会生成或维护：

text

工作区根目录/
├── AGENTS.md
├── CLAUDE.md
├── .github/copilot-instructions.md
├── .cursorrules
├── .cursor/rules/microi-skills.mdc
├── microi.skills/
├── .vscode/mcp.json
├── .cursor/mcp.json
├── .trae/mcp.json
├── .mcp.json
└── Microi-V8-Engine/
    ├── .microi-typings/v8-engine.d.ts
    ├── jsconfig.json
    └── {服务器}/{OsClient.Type.Network}/
        ├── .microi-db-schema.md
        ├── 接口引擎/
        ├── 表单引擎/
        ├── 模块引擎/
        ├── 流程引擎/
        └── AI应用/

MCP 配置、Token 文件、Windows DPAPI 凭据保险库、数据库快照和运行态元数据会加入本地 Git exclude，避免把个人服务器信息误提交给团队。工具升级 Skills 时使用逐文件 hash 判断：自动生成且用户未修改的文件可以安全升级，本地已经改过的文件会被保留。

快速开始：任选 VS Code 或纯命令行

两种入口都要求拥有可访问的 Microi吾码服务器与帐号。最终生成的 AGENTS.md、Skills、MCP 配置和 Microi-V8-Engine/ 目录一致。

方案 A：VS Code 插件

要求 VS Code 1.85.0 或更高版本。

在扩展市场搜索 Microi吾码，或从扩展面板安装 v8-engine-x.x.x.vsix。
打开 Microi: 插件配置，输入 API Base URL 和 OsClient，点击“检测服务器，登录并保存连接”。
输入帐号、密码；服务端开启验证码时一并输入。凭据以 VS Code SecretStorage 为主，并在 Windows 当前工作区镜像为 DPAPI CurrentUser 加密的 Microi-V8-Engine/.microi-workspace-secrets.dpapi.json，供 CLI/MCP 在验签密钥变化后静默续登；不会写入明文配置或 MCP 环境。
执行 Microi: 初始化AI配置，生成 AI 指令、Skills、V8 typings、jsconfig.json 和 MCP 配置。
如需复查，执行 Microi MCP: 诊断 MCP 可调用性。
需要人工编辑、Git 管理或远程调试时，在服务器节点执行 “拉取此服务器代码”。

方案 B：任意 AI 编程软件 / 纯命令行

要求 Node.js 18.18.0 或更高版本。npm 首次公开发布后安装：

bash

npm install -g @microi.net/cli

CLI 首次发布前，从 Microi.Agent 源码目录本地安装也能完成同样验证：

bash

npm install -g ./Microi.Agent/plugins/microi

进入准备作为 AI 工作区的目录并运行：

bash

microi init --pull

命令会按顺序完成：添加服务器连接、提示输入帐号和密码、在需要时保存验证码图片并提示输入、登录、注入 AI/Skills/typings、配置 MCP，并在显式传入 --pull 时拉取全部 V8 资源和数据库结构。密码不会进入命令行、日志、明文配置或 MCP 环境；Windows 需要自动续登时只写入当前用户 DPAPI 加密的工作区保险库。

如果只初始化 AI 和 MCP、暂不拉取代码：

bash

microi init

首次写入 Codex MCP 后，已经打开的对话继续使用已加载工具且不被强制结束；新增工具在下一次自然新建对话或宿主重启时生效。

在一个完全空白的工作区，可以直接对 DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder、Comate、Trae、Cursor、Claude Code 或 Codex 说：

text

安装 @microi.net/cli@latest，在当前工作区初始化 Microi吾码插件；
添加 API 地址为 <地址>、OsClient 为 <租户> 的服务器连接并配置 MCP；
登录后拉取该连接的所有 V8 代码和数据库结构，最后运行 doctor 验证。

因为第一句话已经明确给出可信 npm 包名，具备终端权限的 Agent 可以直接执行 npx --yes @microi.net/cli@latest init --workspace <工作区> --pull。账号、密码和验证码仍通过交互输入，不得写进对话或命令参数。初始化后生成的宿主路由 Skill 会识别更短的“帮我初始化 Microi吾码插件”“拉取某服务器/MCP 的所有 V8 代码”等说法。

方案 C：Codex Plugin

Codex Plugin 已合并在 @microi.net/cli 中，marketplace 固定名为 microi-net，选择器为 microi@microi-net。安装器默认非交互执行，可直接让 AI 执行：

bash

npx --yes @microi.net/cli@latest codex install --yes

自动安装流程

因此在全新 Codex 的空目录里，用户可以直接说“通过 @microi.net/cli@latest 安装吾码 Codex 插件”。具备终端和网络权限的 Codex 会执行上面的确定性命令：npm 仅负责下载，CLI 将包内完整插件复制到当前用户的 ~/.codex/microi-net-marketplace/plugins/microi（设置 CODEX_HOME 时使用对应目录），注册 Codex 官方支持的本地 marketplace，再安装、启用 microi@microi-net。Codex 下次自然启动后，“插件”页面显示 Microi吾码，来源为 microi-net；当前任务不必重载即可继续。

安装后验收

已安装 CLI 时也可运行 microi codex status --json 检测、运行 microi codex install 安装。--yes 只兼容旧版无人值守脚本，不再是允许继续工作的授权开关。

非阻塞自动更新

版本检查和自动升级与“Microi吾码本次工作进度”同属强制基础规范，适用于所有模型和 AI 宿主。每次新建或接续吾码任务，AI 必须读取 workspace-conventions/SKILL.md，首次说明用“Microi吾码开发工具版本”报告实际 CLI、官方 latest、自动更新状态及 Skills/MCP 同步结果。未知项写“检测中/待回读”，不能猜测版本或把已安装新版说成当前会话已热加载。

VS Code 扩展激活、Codex Router 启动以及任一常规 microi 命令都会轻量投递：

bash

microi update --background --workspace "<工作区绝对路径>" --json

更新器只从 npm 官方 registry 查询和安装 @microi.net/cli，随后幂等更新 Codex 插件、检测到的 DeepSeek Harness profile bundle、工作区 AI 指令、Skills 与 MCP，并执行 doctor / codex status / dsh status。运行中的 VS Code Extension Host、CLI、Codex Router、DSH 会话和 MCP 不被终止或强制重载；新版 MCP 写入 ~/.microi/runtime/versions/<version>，原子切换 current.json 后仅供新进程使用。

从 CLI 6.2.3 起，更新检查还区分以下结果：

检查对象	完成条件
全部 Skills	正文、参考文件、脚本及随包资产均进入文件清单与摘要检查，包含最新 UI 规则；复制或路径写入失败会明确返回失败，后台保留重试状态
多个工作区	每个已连接工作区独立判断是否需要同步；A 已完成不代表 B 已更新。源码检出及本地自定义继续按归属保护处理
Codex 插件	旧 CLI 保留已安装的较新插件；同版还检查内容是否完整，不能仅凭版本号报告成功

新版默认不再鼓励大标题、大圆角和大间距，具体按 Microi.UI 设计规范的任务密度执行。包和文件已更新说明新版规则可供 AI 读取；当前模型是否已经读取、当前会话是否自然加载了新 MCP，仍需分别核对。连接、模型与非吾码插件配置保持原值。

AI 不能只检查版本或临时运行 npx @latest 就声称全局 CLI 已升级。更新后须回读版本、工作区 Skills 与 MCP provider，并重新读取更新后的基础规范与本任务 Skill。尚未配置服务器连接的目录不生成项目 AI/MCP 文件；客户 API、数据库和业务应用的部署继续遵守各自授权边界。

bash

microi version --json
npm view '@microi.net/cli' version --json --prefer-online --registry=https://registry.npmjs.org/
microi doctor --workspace "<工作区绝对路径>" --json

Codex/DSH 的 microi_codex action="profiles" 也会返回 toolchain：当前进程 loadedVersion、工作区 workspaceSkillsVersion 和 automaticUpdate 状态。latestObservedVersion 必须结合 checkedAt 阅读，它是历史检查结果；appliesToWorkspace=false 时不能用共享状态证明本目录已同步。缺失、损坏或正在更新均可继续当前工作，待后台回读补齐结果。

断网、权限不足、Windows EBUSY 文件占用或宿主暂不支持热更新时，状态写入 ~/.microi/updater/status.json 并在后台延后重试。界面可以非模态提示“立即重试/查看日志”，但用户不处理也不影响当前、正在进行或新建工作。设置 microi.automaticUpdates=false 可显式关闭 VS Code 端自动检查，已有功能仍照常使用。

从开发工具 5.8.0 起，更新器会从已安装的 Node.js 目录查找 npm，包括插件安装的 ~/.microi/nodejs、Homebrew、Volta 和 NVM；使用绝对入口启动，并为 npm 子进程补齐 Node.js 路径。macOS 从 Dock 启动 VS Code 未继承终端 PATH 时，也能完成更新。日志中的 spawnSync npm ENOENT 表示本机未找到 npm 入口；先更新扩展，再在吾码设置中安装本地 Node.js，或安装官方 Node.js。查看 ~/.microi/updater/status.json 可确认实际结果，安装新版扩展不要求中断当前工作。

开发仓库先运行 npm run codex:build，再用 microi codex install --yes --source ./Microi.Agent 验收仓库 marketplace；重启 ChatGPT/Codex 桌面端后，来源显示为 Microi.Net。npm 安装器生成用户本地 marketplace 所使用的模板见 codex/marketplace.npm.json。

安装后在新 Codex 任务中先调用 microi_codex 的 profiles 动作。它会读取 Microi-V8-Engine/.microi-config.json；未初始化时，使用插件内置 scripts/microi-cli.js init --workspace <工作区>。多连接时把 profiles 返回的稳定 name 传给后续工具调用。

npm 包完成 CLI 下载与用户本地 marketplace 安装，不会自动进入 ChatGPT/Codex 通用公开插件目录；通用目录仍需按 OpenAI 官方 Plugin 提交流程审核。

方案 D：DeepSeek Harness 原生 Profile Bundle

DeepSeek Harness 已安装并且 dsh、pnpm 可用时，可让 AI 直接执行：

bash

npx --yes @microi.net/cli@latest dsh install

这不是把 .mcp.json 复制给 DSH：@microi.net/cli 自身声明 "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }，安装器按官方命令 dsh plugin --profile <name> add <package> 将同一 npm 包加入 profile。默认同时覆盖官方 web、headless profile；只安装一个自定义 profile 时使用 microi dsh install --profile <名称>。

安装后运行 microi dsh status --json，必须同时回读依赖、已安装版本、bundle patch 文件和 dsh.profile.bundles 激活状态。新增 bundle 需要新建 DSH 会话；安装器不会终止当前会话或伪称旧会话已经热加载。开发仓库使用 microi dsh install --source ./Microi.Agent --force 验收本地包，公开用户则要等包含 cordis.patch.yml 的新版 @microi.net/cli 正式发布。

方案 E：WorkBuddy / CodeBuddy 原生 Plugin（可选）

@microi.net/cli 包根包含 .workbuddy-plugin/plugin.json、.codebuddy-plugin/plugin.json、两个 marketplace 清单、根 .mcp.json 和全套 skills/。先运行 microi plugin path --json 获取真实 packageRoot。CodeBuddy CLI 可把该目录添加为本地 marketplace 并安装 microi@microi-net；WorkBuddy 可在插件页添加可信 marketplace，或导入本地 Skill。宿主级插件用于跨项目自动发现；单个项目只执行 microi init 也能获得原生 MCP、规则和项目 Skills。

开始自然语言开发

在 Copilot、Cursor、Trae、Claude Code、Codex、DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder 或 Comate 中描述系统需求即可。插件和 CLI 都建议让 AI 明确执行以下流程：

text

先读取当前租户状态、业务蓝图、数据库结构和已有在线应用；
整理完整方案并 dry-run；
我确认后再真实写入；
写入后回读验证、生成 E2E 测试，并检查同步状态。

三端能力与交互边界

CLI 与多宿主 Plugin 的目标是让用户无需先安装 IDE，也能完整启用 Microi 的 AI 开发能力，不是把编辑器 UI 生硬复制到终端或对话。各端连接后均通过同一套 MCP 与 Skills 完成平台建模、V8、页面、打印、工作流、微服务和验收。

能力	VS Code 插件	`@microi.net/cli` 命令行	Codex / DeepSeek Harness Plugin（同一 `@microi.net/cli`）
多服务器连接、帐号/密码/验证码登录	可视化表单	交互式命令行	内置 CLI + `profiles` 路由
AI 指令、Skills、typings、MCP 初始化	支持	支持	自带全套 Skills/MCP，也可注入工作区
V8/字段/模块/流程/数据库结构拉取	资源树操作	`microi pull`	内置 CLI 或 MCP
远端差异检查、单文件显式推送	Diff/同步结果视图	`microi sync status` / `microi push`	CLI + Codex 原生 diff/patch
平台建模与写入	AI 通过 MCP	AI 通过同一 MCP	`microi_codex` 路由同一原工具
接口引擎远程执行	编辑器按钮；AI MCP	AI MCP	MCP + `v8-debugging` Skill
调试交互	DAP 断点/变量/Step	结构化执行与诊断	结构化执行、补丁、复测；不复制 DAP UI
前端微服务构建、发布	可视化命令	AI 通过 MCP/终端	`microi-microservice` Skill + MCP/终端
MCP 进程启停与输出	可视化管理	AI 客户端管理；`doctor` 诊断	宿主管理；同源路由器报告连接状态

CLI 常用命令

命令	作用
`microi init [--pull]`	一次完成连接、登录、AI/MCP 初始化；可选全量拉取
`microi profile list`	查看连接、稳定 `mcpName` 及登录状态
`microi profile add` / `remove`	添加或删除服务器连接
`microi auth login` / `status` / `logout`	管理工作区登录 Token
`microi ai init`	生成或更新 AI 指令、Skills、typings 与 MCP
`microi mcp init`	幂等更新各 AI 客户端 MCP 配置
`microi update --background`	后台更新 CLI、Codex/DSH 插件与工作区 AI/MCP；失败延后且不阻断工作
`microi dsh install [--profile <名称>]`	按 DSH 官方协议安装/升级 `web`、`headless` 或指定 profile bundle
`microi dsh status [--profile <名称>] --json`	回读 DSH CLI、profile 依赖、版本、patch 与激活状态
`microi pull --profile <连接/OsClient/mcpName> --scope all`	按连接拉取全部资源；也可选 `api/form/module/workflow/schema`
`microi plugin path --json`	查看 npm 包根、DeepSeek Harness bundle 和其它宿主插件清单
`microi sync status --scope all`	读取本地与远端差异
`microi push <file>`	显式推送一个已拉取的 V8 文件
`microi doctor`	检查 Node、工作区、Profile、Token、AI 与 MCP 文件

通用选项包括 --workspace <目录>、--profile <序号/OsClient/名称/mcpName> 和 --json。profile list --json 会返回可直接用于选择服务器的稳定 mcpName。远端写入仍遵循显式策略；保存本地文件不会自动推送。

CLI 与 VS Code 插件同时使用

两者共用 Microi-V8-Engine/.microi-config.json、.microi-mcp-tokens.json 和各服务器 .microi-meta.json。
MCP 配置采用幂等合并，只替换 Microi 管理的 server，保留用户已有的其他 MCP；内容未变化时不重写。
Windows 下 CLI、插件和 MCP 通过当前工作区 DPAPI 密文保险库共享静默续登凭据；macOS 使用系统 Keychain，并在 Token 文件内保存不含明文的引用。VS Code SecretStorage 仍是插件主存储。其它平台不允许退化为明文或伪加密文件；三者继续共用最新 Token 文件。
本地 V8 文件和同步基线是共同事实源。切换工具前先执行差异检查，任何一端都不要在冲突未处理时强行拉取或推送。
多个终端或编辑器同时操作同一工作区时，不要并发推送同一个资源。

V8 本地开发、执行与调试

插件与 CLI 共用以下 V8 资源；编辑器内执行和逐行调试界面由插件提供：

接口引擎代码。
表单前端/后端 V8 事件。
字段 V8Code、KeyupV8Code、模板事件等代码。
模块按钮、批量按钮、表单按钮、页面按钮与 Tab 显隐代码。
工作流节点 V8 事件。

表单事件文件采用“实时字段 Label（EventType）”命名。SubmitFormV8 为 前端表单提交前V8事件（SubmitFormV8）.js，OutFormV8 为 前端表单提交后V8事件（OutFormV8）.js；插件拉取时会迁移旧名“前端表单提交V8事件/前端表单退出V8事件”，并同步更新 .microi-meta.json。

典型人工开发闭环：

从左侧服务器、表或模块节点拉取资源。
在 .js 文件中输入 V8. 获得类型提示和智能补全。
保存文件；保存只会更新“本地已修改”状态，不会静默覆盖远端。
执行“推送当前文件到数据库”或服务器“一键同步”；插件会为接口引擎和 V8 事件维护语义版本，服务端只在代码内容真实变化时写入新的代码版本记录。
对接口引擎执行“远程执行”或“远程逐行调试”。
在“同步结果”视图查看本地、远端和冲突差异。

远程执行

对接口引擎文件执行 Microi: 远程执行当前接口引擎，在参数面板填写 JSON：

使用目标服务器的真实 V8 环境和登录态。
输出结果与 console.log 记录到 Microi Output。
异常会尽量定位到对应源代码行。

远程逐行调试

执行 Microi: 远程逐行调试当前接口引擎，支持：

行断点与启动时暂停。
Continue、Step Over、Step In、Step Out。
局部变量、作用域与表达式求值。
调试控制台和停止会话。

也可以使用 launch.json：

json

{
  "type": "microi-v8-remote",
  "request": "launch",
  "name": "Microi V8 远程调试",
  "program": "${file}",
  "params": {},
  "stopOnEntry": true
}

本地与远端同步

每个服务器都有独立 .microi-meta.json 基线。同步检查会区分：

本地未推送：本地文件较新或尚未建立远端基线。
服务器端已修改：远端较新，本地未改。
冲突：同一资源本地和远端都发生修改。
已同步：正文和同步基线一致。

“一键同步此服务器代码”会在无冲突时先推送本地较新的文件，再拉取服务器最新代码；存在冲突时停止自动操作并展示冲突列表。首次空目录拉取可以直接执行，已有本地内容时会先提示检测同步状态，避免强制覆盖。

同步结果支持：

按服务器或接口/表单/模块/流程分类检查。
下钻到资源 Key、名称、文件路径和时间。
连续打开 VS Code Diff，不必每次重新扫描。
前端微服务文本 Diff 与二进制 SHA-256 状态检查。
重新检测和清空结果。

前端微服务与复杂定制页面

三个以上字段、复杂联动、上传、表格、Tab、步骤条、代码编辑器或长期维护的弹窗，不需要在 V8 中拼接大段 HTML。AI 可以创建或扩展一个 MicroService，由 Microi 宿主以标准方式打开。

插件提供完整的本地微服务工作流：

操作	说明
创建前端微服务	生成项目元数据、基础源码、`.microi-micro-app.json` 和路由清单
拉取服务器前端微服务	获取在线 AI 应用的私有源码到本地
构建	执行项目构建并检查 `dist` 产物
推送	上传构建产物并更新 Microi 微服务元数据
构建并推送	一次完成构建、版本更新和发布
同步源码到在线 AI 应用	保存可继续被在线 AI 或其他开发者维护的私有源码
查看同步状态	比较本地与远端源码，识别本地修改、远端修改和冲突

前端微服务统一放在当前租户的 AI应用/{appKey}/。microi.routes.json 作为路由事实源，发布与迁移时会保留必要的历史菜单 URL / 组件路径兼容信息。

Playwright E2E 自动化测试

在 Codex、WorkBuddy、DSH 等 AI 宿主中进行 PC 后台、UniApp/H5、本地预览、登录交互和截图验收时，默认使用当前宿主的内置浏览器，并复用已经登录的目标标签页。用户明确指定浏览器时按指定执行；只有宿主没有内置浏览器、必要能力不受支持，或有界诊断确认无法完成必要操作时，才降级到本地 Edge/Chrome，并说明原因。新开发的吾码后台和本机地址同样适用，不能因本机装有浏览器就默认打开它。

独立运行的 CI、Playwright Test 或 VS Code 测试进程继续使用项目明确配置的浏览器矩阵；它们的外部浏览器参数不代表 AI 宿主交互验收的默认选择。浏览器之间不自动复制登录会话，平台权限、安全拒绝和用户接管要求仍须分别遵守。

插件会把自动化工程生成到目标前端项目的 .microi-e2e/，不污染业务源码目录。

命令	作用
`Microi: 初始化端到端自动化测试（Playwright E2E）`	生成配置、Microi helpers、环境变量示例和基础测试
`Microi: 运行端到端自动化测试（Playwright E2E）`	运行项目的 `test:e2e`
`Microi: 打开端到端测试报告（Playwright Report）`	打开 HTML 报告

初始化时会读取当前连接，并尝试通过后端获取菜单路由与接口引擎上下文，写入 .microi-playwright-context.json。生成的基础用例覆盖：

公共页面和接口引擎冒烟。
DosResult 接口契约。
登录 Token 注入与认证会话。
API 4xx/5xx、空响应、字符串 null 和无效 JSON 守卫。
图片加载、第三方占位资源、横向溢出和明显“开发中/请求失败”文案检查。
Desktop 与 Mobile 两套浏览器项目。

性能压力测试

打开 Microi: 性能测试，可直接复用当前 Microi 连接测试：

目标	说明
接口引擎	真实调用 `/apiengine/{ApiEngineKey}`，支持 JSON 参数、并发、总次数、持续时间、升压和超时
V8 事件	读取已有表单事件或执行临时代码，通过 `ExecuteV8Event` 隔离测试
表 CRUD	对测试表执行新增、查询、修改、删除闭环，真实触发服务端 V8 事件

报告展示完成数、成功/失败、RPS、平均耗时、P95、P99、错误率、每秒趋势和错误 Top，并可保存到工作区 .microi-performance/。表 CRUD 会产生真实写入，建议使用测试表并保持“每次迭代后删除测试行”开启。

多服务器与身份管理

同一工作区可保存多个服务器 / OsClient Profile。
服务器标题优先从 SysShortTitle / SysTitle 获取。
每个 Profile 独立保存 Token 和本地资源目录；Windows 自动续登凭据仅存于 VS Code SecretStorage 与当前工作区 DPAPI CurrentUser 密文保险库，CLI/MCP 不接收明文密码参数。
VS Code/MCP Token 默认访问期为 20 天，租户显式配置优先。Token 临近失效时自动刷新；服务端验签密钥变化时按 Profile 从保险库自动续登并原子更新 Token/MCP，只有保险库缺失或解密失败才提示人工登录。
“Token 签名验证失败”不等同于“Token 已过期”。同一 OsClient 的 Product/Internal、Product/Internet 等 SaaS 运行记录必须共用一个 AuthSecret；后端在 JWT 初始化前做 CAS 收敛，只有可信后端写入新的唯一 AuthSecretRotateVersion 才轮换密钥，避免升级或实例切换让刚登录的 Token 失效。
支持有验证码和无验证码登录。
MCP Server key、显示名称和设备标识会转换为安全的 ASCII 传输格式，兼容中文 Windows 主机名与不同 AI 客户端。
Windows 工作区会自动启用当前 Git 仓库的 core.longpaths=true，降低深层 V8 目录的长路径问题。

VS Code 插件配置项

在 VS Code 设置中搜索 microi：

设置项	默认值	说明
`microi.apiBaseUrl`	`""`	单连接模式的 Microi 后端 API 地址
`microi.profiles`	`[]`	多服务器连接配置列表
`microi.osClient`	`""`	单连接模式的默认 OsClient
`microi.localDir`	`""`	本地同步目录；留空使用工作区 `Microi-V8-Engine/`
`microi.showConsoleOnExecute`	`true`	远程执行时自动显示 Output
`microi.playwright.defaultBaseUrl`	`http://127.0.0.1:5180`	Playwright 默认前端地址
`microi.playwright.defaultApiBaseUrl`	`""`	Playwright 默认 API；留空使用当前连接
`microi.playwright.defaultOsClient`	`""`	Playwright 默认 OsClient；留空使用当前连接
`microi.playwright.browserChannel`	`""`	浏览器 channel，例如 `msedge`
`microi.playwright.appType`	`uniapp-h5`	`uniapp-h5`、`pc-vue` 或 `web`

VS Code 插件完整命令清单

按 Ctrl+Shift+P（macOS：Cmd+Shift+P），输入 Microi 查看命令。

连接、AI 与 MCP

命令
`Microi: 插件配置`
`Microi: 登录`
`Microi: 退出登录`
`Microi: 切换 OsClient`
`Microi: 初始化AI配置`
`Microi: 配置 MCP（AI 工具连接）`
`Microi MCP: 刷新 MCP 状态`
`Microi MCP: 诊断 MCP 可调用性`
`Microi MCP: 启动全部 MCP 服务器`
`Microi MCP: 启动 MCP 服务器`
`Microi MCP: 停止 MCP 服务器`
`Microi MCP: 重启 MCP 服务器`
`Microi MCP: 显示 MCP 输出`
`Microi MCP: 显示 MCP 配置`
`Microi MCP: MCP 服务器选项（启用/禁用）`
`Microi MCP: 显示已安装 MCP 服务器`
`Microi MCP: 删除 MCP 配置`

V8、资源与同步

命令
`Microi: 新增接口引擎`
`Microi: 新建表单V8事件文件`
`Microi: 新建流程节点V8事件文件`
`Microi: 新建按钮V8事件文件`
`Microi: 拉取此服务器代码`
`Microi: 一键同步此服务器代码`
`Microi: 拉取此表字段V8事件`
`Microi: 拉取此模块子树`
`Microi: 搜索引擎文件`
`Microi: 拉取数据库结构到AI知识库`
`Microi: 推送当前文件到数据库`
`Microi: 与远程版本对比`
`Microi: 查看同步状态`
`Microi: 检测同步冲突`
`Microi: 查看同步差异`
`Microi: 重新检测同步状态`
`Microi: 清空同步结果`
`Microi: 打开文件`
`Microi: 在资源管理器中打开`
`Microi: 复制 ApiEngineKey`
`Microi: 刷新`

执行与调试

命令
`Microi: 远程执行当前接口引擎`
`Microi: 远程逐行调试当前接口引擎`
`Microi: 停止调试会话`

前端微服务

命令
`Microi: 创建前端微服务`
`Microi: 拉取服务器前端微服务`
`Microi: 构建前端微服务`
`Microi: 推送前端微服务到数据库`
`Microi: 构建并推送前端微服务`
`Microi: 同步微服务源码到在线 AI 应用`
`Microi: 查看前端微服务同步状态`

测试

命令
`Microi: 性能测试`
`Microi: 初始化端到端自动化测试（Playwright E2E）`
`Microi: 运行端到端自动化测试（Playwright E2E）`
`Microi: 打开端到端测试报告（Playwright Report）`

CLI 与 Codex Plugin 命名、打包与发布

开发工具 6.0.0 发行候选（2026-10-17）

本轮升级共用的 MCP 与 Skills：建模工具提供真实执行进度和安全 DDL 摘要；可信写前校验失败可明确区分未执行，写入结果不确定时先精确回读并停止重放。同步更新历史日志/版本按需读取、可调整侧栏和主题密度等平台知识，并保留已核验的 CLI 登录与会话恢复修复。这里的 5.9.9 → 6.0.0 仅记录 2026-10-17 开发工具独立进位的候选过程，不声明当前 CLI 或桌面渠道版本；平台 API/PC 需配套 8.5.11；开发工具和平台渠道分别验收。本段记录候选内容，实际发布以 npm、两个扩展市场的原始制品回读为准；不生成新桌面安装包。

包名与产物边界

唯一 AI/npm 包名为 @microi.net/cli，安装后暴露命令 microi，包根同时包含 .codex-plugin/plugin.json、.codebuddy-plugin/plugin.json、.workbuddy-plugin/plugin.json、DeepSeek Harness 的 dsh.bundle / cordis.patch.yml、对应 marketplace、MCP、路由器与全套 Skills。现有未带 scope 的 microi.net 是另一项已发布的前端库，继续保持原用途，不能在兼容版本中改造成 CLI。

一套 Microi.Agent 输出桌面工作台、VS Code 扩展和 CLI / AI Plugin。Microi Agent 安装包使用独立桌面版本，由吾码 HDFS 公有桶分发；其余产品沿用现有发布链路：VS Code 扩展发布到 Visual Studio Marketplace 与 Open VSX；@microi.net/cli 只向 npm 发布一次，同时服务 CLI、Codex、DeepSeek Harness、WorkBuddy、CodeBuddy、Qoder、Comate 等宿主。bump-version.js 同时更新扩展、单一 npm 包、各宿主 manifest/marketplace 和 bundled Skills；任一版本不一致都会在外部写入前停止。

发布顺序与失败边界

三个分发目标不支持跨站事务，发布按以下边界执行：

身份校验：npm run publish 优先使用 NPM_TOKEN，其次读取 publish-tokens.local.json 中的 npm Granular Access Token；都不可用时，在版本递增和构建前执行一次交互式 npm login。
固定顺序：授权完成后自动构建，先发布 @microi.net/cli，再发布 Visual Studio Marketplace 与 Open VSX。
失败可补发：任一目标失败不会撤销已完成目标；原始 npm tarball 与 VSIX 会保留，可用同一版本补发。
精准回读：上传命令成功即结束该目标。只有上传报错或执行补发时，才短时回读对应目标，排除“服务端已写入、客户端收到 5xx 或断线”的不确定状态。
主动验收：诊断全部公开状态时运行 npm run publish:verify；严格发布使用 npm run publish:preflight:all 与 npm run publish:strict。

上传前会读取实际生成的 VSIX，保存完整文件清单、字节数、SHA-256 和敏感文件扫描回执到工作区 .tmp/development-tools-releases/<版本>/。归档中的 MCP 输出与全部构建输入、Skills 全部文件均须与本次源码指纹一致；超过 64 MiB、私有签名资料、凭据或安装包混入会立即停止。新发行和断点补发使用同一门禁，vsce ls 的工作树清单不能代替实际 ZIP 检查。npm Token 只绑定官方 HTTPS registry，临时 npmrc 仅保存 ${NPM_TOKEN} 引用；发布子进程同时固定大小写两种 userconfig/registry 变量，覆盖外层 npm run 继承的旧配置。

本地构建与安装验收

bash

cd Microi.Agent
npm install
npm run cli:typecheck
npm run build
npm run cli:test
npm run codex:test
npm run dsh:test
python %USERPROFILE%/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/microi
npm run package
node scripts/test-cli-package.js
node scripts/test-codex-plugin-package.js
npm install -g ./plugins/microi
microi --help

只生成并校验 VSIX 与同时包含 CLI/Codex/DeepSeek Harness Plugin 的单一 npm tarball，不改版本也不上传：

bash

node publish.js --package-only --no-bump

首次发布到 npm

登录 npmjs.com，创建免费公开组织 microi.net；组织名会成为 @microi.net scope。若由个人 scope 发布，则 npm 用户名必须正好是 microi.net。
推荐在 npmjs.com 的 Access Tokens 中生成 Granular Access Token：Packages and scopes 只选择 @microi.net/cli（或最小必要的 @microi.net scope）、权限设为 Read and write，开启 Bypass 2FA 并设置有效期。包的 Publishing access 必须允许“2FA 或启用 Bypass 2FA 的 Granular Token”；若设为 disallow tokens，则只能交互发布。把 Token 放入环境变量 NPM_TOKEN，或填写到已忽略的 publish-tokens.local.json 的 npm 字段，禁止写入被 Git 跟踪的文件。脚本只把 Token 传给 npm 子进程，临时 npmrc 只保存 ${NPM_TOKEN} 占位符，不落盘明文。
为两个插件市场准备 PAT。本机可设置环境变量 VSCE_PAT / OVSX_PAT，或把 publish-tokens.example.json 复制为已被 Git 忽略的 publish-tokens.local.json。没有可用 npm Token 或登录会话时，默认发布会在流程最前面执行一次 npm login --registry=https://registry.npmjs.org/，完成后全自动继续。不要再使用 publish-tokens.json。
如果仓库曾跟踪过 publish-tokens.json，应把其中的 PAT 视为已泄露：先在两个平台废弃并重新生成，把新 PAT 放入环境变量或 publish-tokens.local.json，再删除旧文件并执行 git rm --cached publish-tokens.json。发布脚本遇到该旧路径会主动停止。
回到 Microi.Agent 执行 npm run publish:preflight。脚本会检查 @microi.net/cli 的 registry/scope 权限，并调用 vsce verify-pat 与 ovsx verify-pat；仅缺 npm 登录时不会阻断两个扩展市场。要求全部目标在版本递增前通过时，执行 npm run publish:preflight:all。
先运行 npm run package 检查本地产物；确认后执行 npm run publish。
正常上传命令成功返回后不做公开 registry/市场回读。看到 npm 发布完成、Visual Studio Marketplace 发布完成 或 Open VSX Registry 发布完成 即结束对应目标；只有上传命令报错或执行补发时才精确确认该版本是否已存在。如需主动诊断全部公开状态，执行 npm run publish:verify，或手工复核：

bash

npm view @microi.net/cli version
npx vsce show Microi.v8-engine --json
npx ovsx get Microi.v8-engine --metadata
npm install -g @microi.net/cli
microi --help

npm 新 scope 或新版本刚发布后，公共 registry 可能短时间不同步。只有显式执行 npm run publish:verify 时，诊断命令才会使用 --prefer-online 做有限重试；这不会触发重复上传，也不影响已成功返回的发布结果。

Open VSX 等市场偶尔会在已经接收 VSIX 后向客户端返回 503 Service Unavailable。脚本遇到这类上传错误会短时回读当前精确版本：若已找到该版本，就显示“异常后回读确认”并按成功继续，不会重复上传；若仍无法确认，则干净地报告部分完成并给出补发命令，不再输出未捕获的 Node.js 调用栈。

如果 npm 因登录取消、scope、权限或上传错误而不可发布，默认流程仍继续处理两个扩展市场，并在项目根保留一个同版本 tarball。不要再次执行 npm run publish。在源码和原始 tarball 未改变时补发唯一 npm 包：

bash

npm run publish:cli:resume

如果 npm 单包已发布、扩展市场未完成，执行 npm run publish:extensions:resume。只补一个扩展市场使用 publish:vsce:resume 或 publish:ovsx:resume。补发不递增版本、不重新构建，而是复用当次保留的原始 VSIX；上传前只确认所选市场的精确版本，若已公开则直接跳过重复上传，不回读其它目标。

补发只适用于“同一份源码和产物的当次发布被中断”。如果失败后又修改了代码，必须重新完整发布下一版，不能用相同版本号发布不同产物。

发布 @microi.net/cli 只完成 CLI 下载与用户本地 marketplace 安装能力，不会自动进入 ChatGPT/Codex 通用公开插件目录；公开目录需另按 OpenAI 官方 Plugin 提交流程审核。

正式发布是外部不可逆操作。不要把 npm Token、服务器 Token 或任何登录密码写入被 Git 跟踪的文件；本机 Token 应限制到单包、最小权限并定期轮换。CI 优先使用 npm Trusted Publishing（OIDC），避免长期保存发布 Token。

使用截图

Microi 连接配置 Microi 运行调试

常见问题

MCP 显示已配置，但 AI 仍说没有工具

先执行 Microi MCP: 诊断 MCP 可调用性。它会验证配置、进程启动、initialize、tools/list 和只读状态调用，而不只是检查 JSON 文件是否存在。

如果诊断成功但 Codex 当前对话仍没有工具，请新开对话或重载 Codex；当前会话通常不会热加载新 MCP。还可以使用 microi_codex 单入口或 MCP 资源兼容通道。

保存文件后为什么远端没有变化

当前版本采用显式发布策略：保存只标记本地变更。请执行 “推送当前文件到数据库”，或在服务器节点执行 “一键同步此服务器代码”。这样可以避免普通保存动作无提示地覆盖远端生产代码。

拉取会不会覆盖本地代码

首次空目录可以直接拉取；已有同步基线或本地文件时，插件会先提示检测同步状态。建议先查看同步结果，处理冲突后再一键同步，不要直接强行拉取。

空工作区可以使用吗

可以。打开任意空文件夹执行 Microi: 初始化AI配置，或在该目录运行 microi init，都会生成 Skills、AI 指令、V8 typings 和 jsconfig.json；添加服务器并登录后，还会生成对应的 MCP 配置。无需提前克隆 Microi 源码或 microi.skills。

不安装 VS Code，能否完整使用吾码 AI 开发能力

可以。安装 @microi.net/cli 后运行 microi init --pull；Codex 等宿主读取项目 MCP，DeepSeek Harness 另执行 microi dsh install 加载原生 profile bundle。当前对话继续使用已加载版本，新增能力在下一次自然新建对话或宿主启动时接管，不要求立即重载才能继续工作。所谓“完整 AI 开发能力”指自然语言建模、V8、页面、打印、流程、微服务、测试和回读验收；资源树、编辑器 Diff 和断点调试是 IDE 交互能力，只在 VS Code 插件中提供。

CLI 和 VS Code 插件会不会冲突

不会各建一套配置。两者共用连接、Token、MCP、源码和同步基线。新版共存协议包含：配置/Token 原子写入与未知字段保留；MCP 中写入来源和版本，两者版本不同时由较新版本保持内置 Server 路径；Skills 和 AI 指令 manifest 拒绝被旧 bundle 降级；microi doctor 可显示当前 MCP 提供者版本。

已经安装的历史旧版本无法被新代码“隔空修改”，但新版会把 MCP 运行文件放入用户目录的版本隔离目录。已经启动的旧进程继续使用旧文件，新进程读取新版本；若旧全局包仍被历史任务占用，更新器只延后，不会结束任务。两端可以交替操作，但仍不应同时推送同一个远程资源；推送前必须做差异检查。

`npm install -g @microi.net/cli` 提示包不存在

先用 npm view @microi.net/cli version --registry=https://registry.npmjs.org/ 回读官方版本，核对当前 registry；新版本发布后的缓存传播可能短暂延迟。开发阶段可在仓库根目录执行 npm install -g ./Microi.Agent/plugins/microi。若自动更新日志是 spawnSync npm ENOENT，请按上面的“非阻塞自动更新”检查本机 Node.js/npm，而不是重复登录 npm。

远程执行与调试不可用

确认当前文件属于已拉取的接口引擎，而不是普通 JavaScript 文件。
确认目标 Profile 已登录且 Token 有效。
检查 Microi Output 中的后端错误。
远程逐行调试需要服务器部署对应的 V8 调试能力；不能使用时仍可先远程执行和查看日志。

数据库结构很大，会不会拖慢 AI

公共 AI 指令不会内嵌全部业务表。实时结构由 MCP 按需查询，本地结构则按 OsClient 单独保存在 .microi-db-schema.md。即使数据库有数百张表，也不会把完整 schema 强塞进每次对话上下文。

License

MIT

更新日志

v1.4.7 - (2026-11-11) macOS Intel

补发官方桌面宿主的 Intel x64 1.4.7，App、DMG 完成 Developer ID 签名、Apple 公证、票据与 Gatekeeper 检查；归档成员、最终副本与实测 App 的哈希一致。
实包基础原生 11 项、官方账号登录与冷启动恢复 5 项通过，覆盖实际启动、宽窄窗口和明暗主题；这些结果不代替员工模型商业流程或其它系统的验收。
Apple Silicon 保留已发布的 1.3.6 Universal 与原 generic Mac 频道；Windows 入口不变，不将 Intel 包推入原 Mac 通用频道，也不声称本轮已完成新 ARM 包验收。
官网依据显式 arch=x64 参数选择独立 Intel 频道，并校验清单版本与包文件架构；下载资源 v1.5.0 提供不可变 DMG、ZIP 与校验摘要。旧 1.3.6 Intel 用户手动安装新版后使用专属自动更新频道。

v1.4.6 - (2026-11-07)

配套员工中心 1.2.5：群聊个人置顶、归档和恢复，员工模型在同租户、同负责人范围跨群复用；缺应用时显示真实安装指引，安装仍由有权管理员单独完成。
完成本轮 Windows 安装态原生业务验收，包括真实模型回复、群聊历史与偏好、双用户冷启恢复，以及带测试返工的顺序工作链；中间失败和未知结果继续保留，不自动重复付费推理。
Windows 软件 1.4.6 对应下载资源 v1.4.8，正式 latest、版本目录、不可变安装包与归档入口均已回读。完整 EXE 为 266392526 字节，SHA-256 f6cd14cab19cf8c12343005b3cb2dc5f3188cc1eac1991d7fae532a8a5f8904a，未签名；macOS 1.3.6 的现有下载与清单保持不变。
官方 PC 8.9.6 修复微应用通用深链的页签标题，保留已有菜单标题、内部导航及中英文切换后的页签；官网文档独立发布，不代表重新发布后端、NuGet、CLI 或 VS Code 插件。

v1.4.5 - 验收中（2026-10-25）

上游同步与二开保留：使用官方 0.2.1-rc.3 / 22ddee3，吾码源码 205cda7；包装层 1,370 项与核心 120 项回归通过。仍通过隔离源码和严格补丁维护吾码差异，保留账号、MCP、员工、模型、VS Code、CLI 及安装发布能力。
Windows 新包与安装：新包为 266,171,017 字节；5 次真实安装检查通过，包含实际 1.3.8 升级。四次完整包文件核对、三次旧目录快照核对通过，注册表和快捷方式已恢复，真实用户 APPDATA 顶层元数据未变。
安装态离线检查：6 项桌面基础检查与 2 项合成 V4 历史检查通过，覆盖明暗主题、1,440 / 800 像素窗口、29 个 AI 工具入口、8 个菜单及刷新后历史保留。手机配对页可达，未连接实体设备；旧 PPT 模板入口不再出现。合成历史不等于真实用户聊天迁移验收。
尚待完成：真实在线业务、独立 11 项后端专项验收、新包正式资源与 Windows latest 发布。macOS 新包需在 MacBook 独立构建、签名、公证与原生验收；当前已有下载和 Mac 频道继续保留。

新包 SHA-256：cd1811a2fdb03153efb8d44691e237dce873468258bf4206ab46375353421111。此校验值用于识别本轮安装候选，尚无本轮正式下载链接；旧版本记录和验收证据不改标为 1.4.5。

v1.4.2 - (2026-10-18)

本条为 2026-10-18 已归档的 Windows 1.4.2 发行记录：下载资源 v1.4.3 已取得渠道 Completed，完整安装包与发行清单已回读，Windows 原生、官网模式 6 和公开浏览器原件已归档核对。结论仅对应当时的源码、安装包和验收环境，不代表当前频道状态，也不替代后续版本或其它客户设备验收。下方 1.4.1 及更早记录按当时原件保留；macOS 原生验收等未完成项仍分别标明。

1. 发送确认与紧凑群聊：修复岗位缺少模型导致整条用户消息回滚的问题，将消息持久确认与岗位执行状态分开；明确业务拒绝与网络未知分别处理，未知先以原请求标识只读核对。项目、消息、成员与编辑器收紧为紧凑三栏，保留触控、键盘、窄屏与浅深主题。
2. 模型弹窗稳定：模型目录刷新、空数据、错误与保存结果使用预留区域，不因提示显隐改变窗口高度；已有选项可继续选择，长内容在窗口内滚动。附件预览及同类错误区域一并检查。
3. 统一设置：AI 员工、插件与自动化任务置于任务/工作区上方；其余吾码工具、审查、模型与账号设置，以及帮助、关于和手机配对集中到官方设置分区。保留现有功能，替代旧版侧栏功能区顺序。
4. 官方上游同步：官方基线为 DeepSeek Harness 0.2.1-rc.2、提交 687f282e8625c6b8d11ff58211a90524be2e4317，保留吾码登录、MCP、员工、会话操作、Skills、开发工具及发行边界；模型营销版本不作为软件基线。
5. 吾码差异保护与发布：仍以 同步DeepSeek官方上游.md 和锁定原始归档为唯一维护入口，每个 overlay 接缝失败关闭；产品源码、最终安装包、原生与真实服务验收、官方云应用、下载资源、官网模式 6 与 Git 回读分别保存独立证据。Windows、Mac、开发工具与商店分别记录，未验收项不写成已完成。
6. 原生正文、预算与未知用量：使用官方 SDK 的文本、思考及实际 stop 终态，不要求模型复述随机标记；思考通道隔离，普通文本只处理开头完整闭合的标准思考块，正文内部 Markdown 不作全局改写。空白、未闭合思考或整份结果只有“最终正文”（包括简单 Markdown 外壳）时明确拒绝写入，不把模板当成果。实际回答指引计入完整保守输入估算，保留原上下文预留、用户显式输出限制与 thinking / reasoning 设置，预算不足在派发前拒绝；此估算不是供应商精确 Token 计数。保留实际 usage，缺失字段仍为未知，不补成零用量；已经开始或结果未知的请求不自动再次付费推理。
7. Markdown 与岗位签到验收：整份 Markdown 按消息身份、语义树及真实 DOM 核对，先普通滚动到目标消息，再执行原有可见性与完整内容断言。签到只接受当前岗位本人的明确肯定回复；引用、代码、请求、假设、否定及仅描述其他岗位在线均不能当作本人在线。正常文档中的标记示例与实际正文继续保留，不以关键词包含或删除断言通过验收。
8. 微应用开发命令补全与并发修改保护：仅在确认 Vite 且缺少 dev 时补充默认开发命令，保留已有命令。Windows 只对替换时的 EPERM / EACCES / EBUSY 最多尝试 4 次，按 20 / 40 / 80 毫秒有限退避；每次核对原文件完整字节和文件身份，发现可观察的并发编辑、替换或删除立即停止并保留用户内容。不删除目标、不强制覆盖，也不宣称这是跨进程原子 CAS；17 项错误与并发回归通过，不等于客户机器已验收。
9. 普通会话标题与历史投影：修复提供方把开头思考块混入自动标题的问题，完整闭合的标准前缀才剥离，异常或空正文继续走原回退。历史投影重建时只处理提供方自动标题，保留用户命名及原始事件；不追加标题生成请求、不全局删除正文里的标签示例。该接缝纳入官方上游同步保护，新增共享助手兼容 LF / CRLF，官方原始源码仍逐文件按完整 SHA-256 校验，漂移时停止。
10. 设置生命周期与账号 owner：仅在吾码官方桌面严格标记为 true 时隔离上游自动欢迎候选，保留显式模型配置与显式引导的原行为。新增真实 React 组件回归覆盖步骤延迟注册与会话 ready 两个触发，确认待完成登录表单、模型输入节点及编辑值不被自动卸载；夹具使用本地内存桥，真实认证与新包原生仍待独立验收。
11. 长记录群聊消息高度与全文阅读：修复纵向消息日志中长回复被 flex 压缩为零高、正文叠挤的问题，消息保留自身高度，原 content-visibility 离屏渲染策略保持。使用实际群聊组件及官方 Markdown 渲染，覆盖 24 条短消息、附件和 11 条异步长回复；浅色、深色旧行为各有 1 项失败，修复后连同原回归共 21 项通过。验收仍按唯一消息身份普通滚动至目标，保留可见性与完整语义树 / DOM 正文断言；位置在正常绘制两帧后使用同一轮矩形测量。后续同步上游须保留消息高度约束、离屏渲染和这些回归，不删减可见性或全文断言。上述组件回归不替代新包、同包原生及真实升级验收。
12. 历史消息编辑与活动会话：重新编辑通过安全分支保留审计，新分支编辑请求持久接收后再归档旧分支，避免活动侧栏留下两个同名会话；结果未知时不归档、不重复发送，归档失败只重试归档。显式创建分支（fork）与撤回（retract）保持原行为。C11 同包普通会话与独立冷启已回读侧栏计数 4 → 4、旧分支归档与恢复、新分支持久化；原生恢复例为空附件，非空附件恢复仅有离线覆盖。离线 RED/GREEN、原生、真实 D 与下载发布仍保持独立证据边界。

发行项目	本轮实际状态
产品源码与回归	最终来源 `5593e92117b5cb4bb9f18d15ab9d5d9217ccd3ad`（C11）；受保护输入 1132 文件，SHA-256 `1efaef4c7623f0804d2dea9f946093710f20404baa2ccc8df518118cb2aecd9f`。本轮 full 7 门、wrapper 1134、core 115、root 原 35 段串联＋119、targeted 44 均有完整通过终态；此前候选的失败、取消和未采用记录保留，不写成首次全通过。本地 React、长消息及编辑保护 RED/GREEN 是源码证据，真实认证与同包原生另列
Windows 1.4.2 完整包	C11 实际 package Job 宿主与 end 均为 0，剩余 PID 为空、stop 为 0；未签名 x64 安装器 264631649 字节 / SHA-256 `e0bb17a31d453e3c496cc0168be07bec5bbb81b329d01530ea22fa4af2a222de`；不可变安装包。包已生成不代表下载渠道已经发布，客户设备验收仍单列
同包 EXE 与 ASAR	EXE 246302720 字节 / SHA-256 `ad24b7c33db3280004330029e04a7995e31d72c2af679e5d3374aab9d282c440`；ASAR 183631686 字节 / SHA-256 `ac579eca217ec6ae36974c5d4331b0bd865dfca8f88d99a4d9b9a2f50c9d1a69`；三个 provenance 副本均为 282 字节 / SHA-256 `a8eeb22ef2081f158cde7dc0eeab2d61dfbef04ee4aa01d4df7142a1bb893701`，均绑定 C11、1132 个受保护输入且 dirty=false；公开安全引用【C11 / P1132 / provenance SHA-256 a8eeb22ef2081f158cde7dc0eeab2d61dfbef04ee4aa01d4df7142a1bb893701】已核对
同一包完整原生	本 C11 同包八份原始门禁已回读通过，严格 22 项聚合通过；产品 UI 12 项、群聊原件 10 项、默认入口 3 项及 MCP35 的 4 项与原件分别绑定，不拼接旧包；普通编辑及独立冷启另核对侧栏和归档恢复。公开安全引用【原生聚合 SHA-256 666b2f98d2a892df2f348300cdb39f219ee0c0b35941547c9ac0fcd2ae03db9a】、测试工具实际版本【同包隔离验收 run-142-final-20261018-v13，普通编辑采用 hover-v2 与独立 cold-readonly】已核对
真实 1.4.1 → 1.4.2 升级	ROOT 已取得实际 D 目录升级 PASS 回执：8196 个新文件匹配、8280 个旧文件原样保留；首次快捷方式检查发现两默认入口仍指向另一个已有安装目录；随后使用同包正常重装，独立确认桌面与开始菜单均指向本次 D 目录的 1.4.2。两个阶段原件均保留，未手工改注册表或快捷方式。完整升级、快捷方式、启动与数据保护引用【实际升级 e40a287dcb3281397a81a2d07792b7e917124e131525f82521ea2c10f6ae5c8f；正常重装 fcef3f796cd857f949739f2fab401f69e782cbecbbe673895ddcc15a0c7fe364；独立快捷方式回读 646da80bb60612cb90136e0e861e3c70086bd00dd34cbbf70f32e11d2a3e67a1】已核对
AI 员工中心 1.2.0	已独立完成官方 V3 与商城发布、授权下载私有源码后的 133 项测试、类型检查和正式构建回读。已验收来源 `2700b655acff0752d3b604c7e10f04fa6dff1231` 的 61 个云文件与 C11 的 cloud tree `91122bc5627b53f1ab24c3be918baf9130b8de48` 完全一致，本轮复用原始资格、不重复发布；该证明不替代桌面原生或客户租户授权升级
下载资源、官网模式 6、公开浏览器	v1.4.3；渠道 Completed；完整 EXE 与清单回读通过；资源提交第 15 版，发行清单 SHA-256 19fc3bbba1b041455070a35b498d8ba514de33fa9de8c80fde619346febbf33d；发行清单。随后使用原 `Microi一键编译发布.sh` 输入 `6` 发布官网：模式 6 终态【本页由原脚本的官网模式构建与发布，实际命令退出和镜像摘要另存最终源码交接回执】，公开页面及四场景浏览器【1440/390 × 浅深主题在官网实际切换后独立检查，结果另存最终源码交接回执】；这两项在实际执行前不能写为已通过
开发工具独立版本	本机 MCP 与工作区 Skills 于 2026-10-18 14:06Z 读回 6.0.1；开发工具和 Windows 桌面独立发行，不冒称本轮重新发布 npm 或扩展市场。新官网责任 Skill 合并正文仍待提交与分发，全局 6.0.1 不因此自动包含本轮新正文；桌面 embedded 内容随 C11 最终包单独核对
macOS	最新渠道 1.3.6 / 清单 SHA-256 `ac9fab14113ab5ddd48b14c75aab865b867b912c102ad3b7fb96e38eec154a06`，【双 API 入口完整 GET 与最后发布后源回读确认原清单字节保持，Windows 发布未改写 Mac 渠道】。本轮不发布新 Mac 包，仍须在 MacBook 独立构建、签名、公证及原生验收

v1.4.1 - (2026-10-17)

本轮发行绑定：Windows x64 软件 1.4.1，下载资源 v1.4.2，最终产品源码 39a0fb9c；员工中心继续使用 1.1.9。官网按钮保持永久 latest，独立读取 Windows 与 Mac 实际发布版本。下载资源和版本记录均已完成发布；两域永久 latest、冷查询、固定与版本 CDN 入口及发行清单已独立回读。Mac 1.3.6 更新清单保持原字节。
安装目录切换 145 / 183：修复旧安装目录已有大量文件、注册表仍有安装位置但缺少卸载命令时，解压成功后无法切换新目录的问题。完成解压后根据实际目标建立同盘快照，不先删除未知文件；切换失败保留新暂存与旧备份、集成复制日志及明确阶段。特殊目录、占用、权限和未知冲突仍严格报错，不以强删完成安装。
真实安装覆盖：最终 EXE 原生矩阵共九次安装执行，包含七次新版安装及两次旧版前置，覆盖新装、覆盖升级、同版重装、缺少卸载元数据及已注册祖先目录等路径；安装文件逐项哈希核对，注册表与快捷方式复原。另对本机真实 1.3.8 → 1.4.1 完成覆盖升级，NSIS 返回 0；8276 项新文件与四项原厂附加文件、8193 项旧快照文件逐项核对，双注册表视图、元数据和旧额外文件保留。未读取或修改 Roaming 正文，不能由此推断其它客户机器也已通过。
登录性能与恢复：同一份未变化的受保护凭据不再被多连接反复解密，外部替换、删除与损坏继续失效校验。请求超时覆盖完整请求过程，页面显示阶段、耗时、取消与可读错误；同身份恢复协调、账号切换及迟到响应均保留会话边界。默认官网与历史官方地址分别保存凭据，不跨来源借用。
登录实测范围：api.microi.net 默认官网登录本次完整可见耗时 7548 毫秒。在 35 条目录专项中，34 条为本机受控连接夹具、一条为真实业务连接；目录可见 64 毫秒、真实业务 UI 登录 3913 毫秒、显式选择后员工入口 214 毫秒。受控慢配置在 15441 毫秒显示错误并保留操作入口。上述是本机单次实测，分别计算，不是所有请求的 SLA 或 35 套客户服务器实测。
员工业务连接：项目群与任务区使用用户明确选择的已登录 MCP；官方账号保持未登录时，真实业务连接仍可进入员工页。不自动选中首个客户、不并行探测未选连接、不凭官方计费登录授予业务权限。缺少员工应用、非群成员及权限不足分别显示可操作提示，不自动安装或修改客户系统。
十一岗位终稿兼容：修复 MiniMax 等供应商把思考内容放入普通文本字段时，原始思考被误当员工终稿的问题。逐调用随机边界仅接受完整且唯一的正式正文，原始增量不逐段写入项目群；重复边界、缺失边界、截断或长度异常保留核对状态，禁止自动再次调用模型。真实十一岗位的持久记录和界面气泡均检查正式正文；文档中合法的标签示例不被全局删除。
模型预算与未知结果：协议说明计入实际输入预算，保留用户的 thinking / reasoning 设置。超长输出不继续扩张缓冲，正常结束后保留供应商实际用量；未提供 usage 时继续标记未知并按保守预留处理。随机边界生成失败也会释放本机执行名额，不遗留容量占用。两份模型提供方配置不等于两家供应商全面兼容，本轮十一岗真实模型为 MiniMax 路由。
桌面品牌与关于：实际包内启动组件使用 Microi Agent；关于为独立窗口，显示 1.4.1、吾码官网、文档与 QQ 群 51050055，可复制群号和关闭，不再展示 dsh / DeepSeek 产品链接。第三方法律材料保留，安装器发布者与说明为吾码。启动品牌通过实际安装 ASAR 中页面引用的编译资源与 Boot 组件验证，未把未捕获的短暂启动画面伪造为截图。原生菜单项不能稳定观测时，报告明确使用相同回调的契约与真实侧栏窗口验证，不假称已点击原生菜单。
布局与首页：工作区继续位于功能区上方；MCP 页面只保留一个全局恢复品牌按钮。吾码账号、MCP、采集及环境服务页面适配全屏可用宽度，长目录可换行。首页保留「探索未至之境」并去除预览版；旧 PPT 模板菜单与 dock 不恢复，通用 Office 能力与历史不删除。
上游与开发工具保护：唯一同步指南为 同步DeepSeek官方上游.md，旧 dsh 同步文档已删除。官方锁、完整树、overlay 与吾码保护区仍独立校验，目标漂移或测试失败即停止同步；桌面、VS Code、CLI、MCP 与商店发行边界保持。开发工具入口与同源实现保留，本轮不把桌面发布等同于 npm / Marketplace 新版发布。
可重复的最终包验收：源码回归 457 / 457、核心专项 114 / 114；本轮最终实际安装包的 13 份完整原始报告经严格聚合为 22 / 22 原生场景，覆盖密码 UI 登录、失效恢复、临时错误、多连接隔离、缺应用、权限拒绝、项目群、十一岗位模型、附件、历史、普通会话与真实冷启动。保留首次失败和被拒绝候选，未拼接部分通过项。
产品 UI 与插件长连接：实际包产品 UI 12 / 12，20 张 PNG 均核对 SHA-256，人工复核关于、全屏、窄屏与首页；主题及原剪贴板均恢复。覆盖 1440 / 1920 / 3840 / 390 像素浅深主题，390 为 CDP 视口模拟。本包 Harness 插件事件流实测 320009 毫秒、21 次心跳；该长连接不替代其它租户的 SignalR 或公网通路验收。

发行项目	本轮实际状态
Windows 完整包	Microi Agent 1.4.1 x64，未签名 EXE，266,510,695 字节
安装包 SHA-256	`03bfb220f43c95000f1b8e6df2e02595589792cc5ef23b823c24a052b54a1c32`
产品源码	`39a0fb9cf7b6cc72e1b78b992d300de02ad89bed`；后续文档或交接提交不改写此构建来源
下载资源与清单	v1.4.2；公开发行清单；两域清单、不可变资产及永久入口解析出的三次完整 EXE 下载均核对字节与 SHA-256，固定 / 版本 CDN 页面及引用资源完整回读
员工应用	1.1.9；业务租户须单独预检与授权安装，未自动更新所有客户
macOS	已发布 1.3.6 Universal 保持；本轮未发布或原生验收新 Mac 包
商店与设备范围	Windows 商店 1.3.3 不随官网 EXE 升版；客户物理设备、实体手机和公网通路未据此宣称通过

v1.4.0 - (2026-10-16)

员工界面与连接：任务详情改为立即可达的右侧抽屉，岗位模型改为独立弹窗；紧凑三栏、浅深主题、窄屏与键盘操作同步维护。任一已登录 MCP 都可明确选作员工连接，群与任务共享选择，失效不自动切租户。同连接更换账号时按会话代次清理旧内容和草稿，后续凭据保存失败也保留失败提示并通知界面刷新。
消息性能与恢复：员工中心 1.1.9 已完成官方 V3 与应用商城终态，保留 SQL 可靠发件箱、发送 Ack、MongoDB 消息投影、游标增量及附件正文延迟读取。管理员可主动有界迁移本群旧历史，失败保留进度并继续；SignalR 只作变更提示，权威回读与断线补齐保留。修复期间官方系统的 SDK/云端验证不等于本轮桌面最终包验收。
桌面入口调整：移除专用 PPT 菜单、dock 和模板管理入口，通用 Office 能力保留。已有工作区、会话、采集、环境服务与模型配置继续维护。
升级边界：所选租户须独立完成员工中心兼容版本、权限和数据库预检；不自动安装全部客户，不拿官方发布源或另一租户凭据替代目标端验收。1.3.9 历史原生验收不能证明本轮新增行为。
真实官方主题回归（组件层）：此前 49 项组件夹具手写了上游并不存在的主题变量，遗漏了实装界面的透明气泡与侧栏层次问题。现已使用锁定官方主题的真实语义颜色，区分助手、自发消息和主区背景，并维护头像、按钮状态与任务详情骨架。
主题证据与边界：测试加载完整官方主题原字节（23,492 字节，SHA-256：809b20ae477324fdf5181a2d338655a19919cabbf1b0e60adc149908462c5a66），校验锁定来源、文件哈希及 Git 换行保护。真实 React 组件共 55 项通过，覆盖浅深主题、390 像素窄屏及键盘操作，控制台与页面错误为零；新增 9 项主题合同检查。以上使用有界数据和推理夹具，不能代替最终安装包的原生界面或真实模型验收。
领取范围与离群收尾（本次冻结包）：新运行仅绑定所选 MCP 与当前显式群，未选群时不自动领取别群。切换群或连接后，旧群已经开始的运行安全收尾，已保存的加密成果继续按原范围重报；未知结果不当完成，不自动重放推理。本轮 f953982f 安装包按独立范围重验，未沿用已拒绝候选的通过项；未知结果仍禁止自动重放。
本机模型容量修复（本次冻结包）：884361a1 源码的 1.4.0 实际安装候选在十一岗模型验收中出现 2 项 Succeeded、9 项 Uncertain；Worker 按 3 并发领取，而本机 Harness 容量为 2。此候选已停止发行。新源码改为同一桌面实例内由主进程统一协调多个 Worker，领取云端任务前先取得最多 2 个本机执行名额。未知结果保留核对状态，不当成完成，也不自动重复推理。后续 f953982f 候选已分别完成四轮安装、十一岗位真实模型和原生实时通路验收；这些本机结果不能代替客户物理设备验收。
模型截断、预算与安全诊断：max-tokens 保留为 Uncertain，不把截断文字当完整成果，也不自动重新推理。员工请求默认且最高预算为 16,384 Token，由官方 prepareCall 同次确认预算与派发，按已配置上限和剩余上下文收紧，保留用户思考设置；失败只保留白名单诊断，不回显响应正文或密钥。异常契约通过实际 SDK 与回归验证，本轮十一岗位真实推理另有全部成功终态和材料证明，不把模拟异常用例说成真实模型截断验收。
角色头像与中文排版（已完成候选字体专项）：十一个岗位使用独立 SVG 图标及淡色身份背景，普通用户与自己保留可辨识图标；身份配色不作为在线或模型执行状态。同一 f953982f 实装候选完成 1440 / 390 像素、浅色 / 深色四种字体场景，实际点击任务详情抽屉和岗位模型弹窗，聊天、任务及弹窗的字体栈一致，并由 Chromium 读回系统中文字体；12 张原生截图、页面及网络无错误。它不替代完整九项补充验收或最终公开截图。
附件投影修复（官方云端与候选层）：附件采用规范四字段数组的 JSON 字符串投影，完整消息摘要仍参与读回。旧嵌套字段丢失不能无损解码；只读管理权限审计、业务摘要、原租约和固定消息的全部非附件内容一致后，才允许修复已知形态的派生附件字段并完整回读。未知冲突或诊断被拒绝继续 SQL 兜底，不重发消息、模型或扫描客户。此前纯文本 Mongo 验证未能证明实际文件附件；本轮新包已实际 UI 上传附件、按 SQL 持久 ACK 显示消息、延迟读取附件正文并比对哈希，后续十一岗位运行材料也分别验证前文附件正文。官方源的修复与发布不代表已自动安装全部客户。
本轮源码回归（本次冻结包）：冻结源码 f953982f218282d7c0da1a759b8303bdeafe33bc 的 379 项源码回归全通过。鉴权专项 32 项验证明确注销、迟到登录/续签/业务响应及异步凭据写入不会恢复旧会话；选择与游标专项 94 项、连接标签专项 5 项分别验证对应边界。同名连接按实际服务器、租户与环境消歧，不能靠列表顺序猜测。以上不是客户设备或最终安装包的验收。
SDK 全链兼容（本次冻结包）：同一冻结源码完成 VS Code/CLI 的 32 段正式测试及 16 项守卫，全部通过；本轮新生成 CLI 与冻结 CLI 的 355,258 字节、SHA-256 及完整字节均相同。七个运行时复制文件、193 份知识文件、22 个渐进披露 Skill 与 68 个 Skill 的独立校验通过，原桌面源码指纹未变。SDK 回归不代替桌面安装、云端升级、渠道或官网发布。
5.9.6 源码整合与 SDK（独立于桌面发行包）：整合源码 01d57ff47775619a988cf1e76ba457b8a0e4b293 正常合并独立 5.9.6 变更，保留 f953982f 的鉴权、API 和官方桌面源码；公开知识输入固定为 3a88258c 已提交正文。新的 32 段正式 SDK 测试、16 项守卫及鉴权 32 项全部通过，CLI 重新生成后的 355,765 字节与该整合冻结源完整字节一致。它是独立源码兼容结果；Windows 安装包构建来源始终为 f953982f，不据此将包内 CLI 标为 5.9.6 或 5.9.7。npm / 开发工具的 5.9.7 发行属于独立渠道，不能归因于本次桌面构建。
新安装包的 22 项原生验收（本次冻结包）：f953982f Windows 1.4.0 实装候选的 13 份完整原始报告通过严格聚合，共 22 项场景全部通过，涵盖真实密码登录、失效恢复、多连接隔离、十一岗位真实模型、前文附件材料、群历史、普通会话和冷启动；模型材料证明及至少 320 秒插件事件流另有同包哈希绑定。连接切换时界面忙碌导致的两次首次失败保留原件和等待前置，只有完整重跑的通过报告进入聚合。客户物理设备、Mac、实体手机及公网连接不在本次结论内。
实际原生 SignalR 通路（本次冻结包）：同一 f953982f 安装包以两个独立用户目录和实际登录的实例验证群变更，发送端仅发送一条无模型消息；接收端不接触发送 ACK，收到真实 Worker → 主进程 → renderer 的 SignalR 连接与更高版本提示后，自动显示同一持久消息。运行记录不变，没有复制令牌、页面重载或新增模型调用，页面、控制台及网络错误为零；没有用插件 HMR / SSE 代替业务 Hub 证明。该整份通过报告与后续云端 1.1.9 空分页兼容修复分别记录。
完整九项补充验收（本次冻结包）：员工中心 1.1.9 修复空增量页的来源判别后，新的完整九项原生报告及 renderer 健康守卫全部通过，桌面二进制来源仍为 f953982f。覆盖旧会话无 PPT、八项功能菜单、通用 Office、仅命名 MCP 的共享连接、任务详情、十一岗位模型弹窗、持久 ACK / Mongo / 附件延迟读取、本群有界历史迁移，以及浅深主题与窄屏。实际单次 UI 消息的持久 ACK 为约 913 毫秒，这是本机一次测量，不是服务时延承诺或模型完成时间。旧自有群的 24 条消息标识与正文哈希、11 个运行及成员保持一致，迁移后来源为 Mongo、待同步为零。此前整份失败报告及红色提示截图原字节保留，不从中拼接通过项。官方 PC 页面整份资格与资源 v1.4.1 终态另行通过，下方列出发行绑定。
旧候选撤回与重验：358e484f 候选的注销操作曾重新采用共享存储中的旧令牌，原生 SignalR/Hub 通路也未完成验收。旧候选的安装、群聊及其他诊断原件继续保留；原有 21/22 部分结果不能补作新包的 22 项商业验收。新的 f953982f 安装包已按独立原件完成上述 22 项场景；独立实时通路、完整九项补充及官方云端 1.1.9 已分别通过；官方 PC 页面与 CDN 已另行完成真实终态，旧失败原件不改写。
合成旧会话样本修正：此前验收样本虽通过文件格式读取，却只有用户消息而缺少完整回合生命周期，重启后被官方列表元数据识别为空白会话。这不能用来判断用户历史丢失。新样本通过锁定官方写入器、严格读取器、会话校验和列表元数据规则验证为非空；它只修正验收前置，不复制真实用户会话或凭据，本次新包的旧工作区、会话打开与重启场景已独立通过；原坏样本及其失败报告继续保留。
官方 PC 页面整份验收：通过真实密码登录、应用导航和已有群历史验证，11 个实际运行及回复与标准工具权威读回一致，三个应用资源均完整读取并校验 SHA-256；员工群真实订阅取得成功确认，页面、控制台及网络错误为零。此次仅读取员工业务，没有新增群消息、任务、模型或配置；正常登录、Hub 连接 / 订阅及私有图片访问仍可能登记平台运输或访问审计，不能声称所有远端写入为零。自身 60 项导航统计独立前后核对无变化。此前被严格策略拒绝的整份报告保留，最终资格没有拼接失败报告。

原生视觉资格与截图

同一 f953982f 最终安装包另完成 1440 / 390 像素 × 浅色 / 深色四场景纯界面观察，每场景连续约 30 秒无红色提示、控制台、页面、网络错误或横向溢出，结束后恢复原“跟随系统”主题。该观察没有员工桥接读取、发送消息、调用模型或保存模型配置；它不为此前红色提示推定原因，也不改写旧截图。

以下三张是实际安装包原生原图，已通过标准 HDFS 上传和完整公网字节 / SHA-256 回读。群聊图保留产品当前可见的 M3 思考文本与中文最终内容，不声称已折叠或隐藏；全部 QA 内容为合成验收材料，任务示例数字不是真实凭据，也不是安全配置建议。截图对应本轮 f953982f 最终安装包；下载按钮继续从公开 latest 读取各平台实际版本。

Microi Agent 1.4.0实际多岗位项目群

Microi Agent 1.4.0岗位模型弹窗

Microi Agent 1.4.0任务详情抽屉

发行字段	已验证结果
软件版本	Windows 1.4.0，2026-10-16 发布；顶部按钮读取各平台永久 latest
冻结源码提交	Windows 包：`f953982f218282d7c0da1a759b8303bdeafe33bc`；SDK 源码整合 `01d57ff` 独立记录
Windows 安装包	不可变安装包，266,517,004 字节；SHA-256：`5f39653d339a56056a1967cfcc79622ea4830fa0040761ad272135b0036cf014`
原生与线上证明	四轮 NSIS、22 项原生、完整九项补充、独立 SignalR、字体与视觉四场景、官方 PC 页面整份通过；客户物理设备未覆盖
员工中心与租户	官方 1.1.9 V3 / 商城已完成；受控旧群迁移回读通过，客户仍须独立安装与预检
下载资源与清单	资源 `v1.4.1` 已 Completed；公开发行清单；两来源 latest、冷查询及三次完整安装包回读相符
macOS	已发布稳定版 1.3.6 保留，更新清单原字节未变；新版须 MacBook 独立构建、签名、公证及真机验收

v1.3.9 - (2026-10-14)

2026-10-15 后续使用反馈涉及任务详情、岗位模型入口和员工消息性能。本轮 1.4.0 草稿单独记录这些修复与新消息协议；下列 1.3.9 原生证明保留当时的实际范围，不覆盖新抽屉、MCP 选择或 MongoDB/SignalR 行为。

吾码应用登录：替换官方桌面原有的 DeepSeek 应用登录和首次引导入口，接入吾码账号表单、稍后设置和实时登录状态；供应商登录仍保留于模型设置。
过期与网络恢复：失效会话可直接重新登录；网络状态读取失败仍保留表单和重试入口。旧请求晚到不会删除新登录会话，账号显示以当前服务器身份为准。两个官方来源的凭据分别加密保存，不跨来源复用。
员工连接隔离：默认选择吾码官方账号；多个客户连接需要明确选择。未安装员工中心时显示恢复步骤，禁止无效建群；零岗位时提供团队初始化入口。客户账号的失败不会清除官方登录状态。
岗位模型目录刷新：在模型设置中新建供应商后，返回已打开的员工项目群即可选择，无需重载整页。打开岗位配置、显式刷新及页面恢复时读取本机最新目录；删除的配置显示不可用，保留岗位原标识、草稿与附件。旧账号和旧请求不能覆盖新目录，临时读取失败提供重试。
需求文档发送与历史共享：修复附件上传成功后因多余元数据被主进程拒绝的问题，发送仍执行原有严格字段校验，失败保留草稿并使用原请求标识重试。员工中心 1.1.5 让后续消息复用同群近期已保存材料，保留当前文档优先、内容去重、权限、幂等和模型调用租约；每岗输入须通过独立标准 MCP 只读核验正文、文件名及摘要。
工作区与吾码反馈：工作区恢复到功能区上方，两区独立滚动；底部账号、关于和手机入口保持可达。反馈统一为吾码官网及 QQ 群 51050055，完整设置、插件、自动化任务与模型供应商继续保留。
长时间运行的插件事件流：为闲时插件事件流增加 15 秒心跳，关闭最后连接或退出插件时清理定时器，保留原插件事件协议。封装门禁检查最终 ASAR 实际加载的代码及摘要；原生验收额外读取真实桌面协议连接至少 320 秒，不能用短时单位测试、页面刷新或忽略网络错误代替。
持续维护与验收门禁：上述差异进入独立吾码覆盖层，严格校验官方源文件指纹后整体重放。发布要求最终实装二进制绑定的 22 项原生场景及原始报告、截图哈希；单个 passed: true、已登录的开发环境或旧安装包不能提升 latest。本次最终安装包的全部 22 项场景已通过，下载版本仍以顶部渠道回读为准；macOS 继续独立验收和发布。
最终包实际验证：Windows 全新安装、同版本重装、从 1.3.6 升级及升级后再装四轮通过；中文、跨盘路径的 8,193 个安装文件逐项校验，注册与快捷方式恢复通过。最终 ASAR 的 19,491 项运行清单与 11 份吾码入口原字节一致。
真实协作与持久化：实际应用保持项目群打开时新增两个 MiniMax 配置，十一岗位分别保存绑定；全员在线回应不调用模型，十一岗方案均完成真实推理。仅消息保存的需求文档经标准 MCP 独立核验，全部岗位输入均含前文正文、文件名及摘要；继续完成超过一百条消息、分页、成员权限、重启历史、普通会话编辑撤回及冷启动。
真实持续连接：最终实装程序经桌面协议和 Node fetch 连续读取同一插件事件流 320 秒，收到 22 次心跳，零读取或解码错误、零刷新；保留原控制台与网络守卫。
回归与交付边界：官方桌面核心 114 项、包装与发行门禁 153 项通过；VS Code/CLI 完整回归及文档同步补验通过。旧业务 1,852 项通过、9 项平台跳过以完全相同 Git 输入的历史回归记录保留，不冒称本轮重跑。以上 Windows 结果来自隔离实装环境，不代替客户物理电脑、实体手机、公网连接或新 macOS 包的验收。

v1.3.8 - (2026-10-13)

后续用户实测发现，本版验收未覆盖“首次使用、官方会话过期与多个客户连接”组合，导致登录入口、侧栏和员工连接存在缺口。1.3.9 的实际安装验收还发现，附件上传检查不足以证明发送成功，也未证明后续岗位实际收到前文文档。下面保留当时的验证范围；不能把上传成功或模型回复非空当成文档协作已经通过。上述路径均须由最终新包重新验收。

转向 DeepSeek 官方桌面：生产装配采用官方 d743267388641bc76f17c45ce8b4c231aed1d32c、Harness 0.2.1-alpha.2 与 Electron 44.7.0。旧 dsh-desktop 退出正式宿主链；吾码业务保持独立插件、主进程和协议层，VS Code、CLI 与 MCP 继续共用实现。
AI 员工项目群：项目列表、持久消息与成员列表组成三栏工作台。十个岗位可分别指定本机供应商和模型；需求材料、岗位回复和历史按项目共享，精确账号邀请需要本人接受。旧任务、目标、交接和成果验收保留。文本需求材料目前支持 Markdown、TXT、JSON、CSV。
可靠执行与权限：群成员身份来自当前 DiyToken；服务端拒绝伪造身份、非成员访问及越权改配置。执行采用领取、开始确认、心跳和原成果回报，断线只恢复同一结果，不自动重复推理；本机模型密钥不上传群服务。点名“在线”表示角色在席，不能代替模型健康检查。
保留桌面二开：沿用吾码账号与中转、MCP、能力中心、采集、环境服务、PPT 模板和个人模板。动态应用 Logo/名称、关于版本、手机连接、工作区审查、提示词历史及持久消息编辑/撤回接入官方插槽。保留用户目录和安装身份，以及历史派生模块许可证。
上游保护与构建：新增《同步DeepSeek官方上游.md》、锁定归档/完整树校验、精确重放补丁和产品源码指纹。新一键脚本使用官方桌面装配；macOS 按 Intel x64 / Apple Silicon arm64 本机分别构建，不能将单架构产物标成 Universal。构建缓存与产物不修改已跟踪源码。
已验证范围：官方桌面核心 111 项、群行为 30 项、浏览器 14 项、会话操作 15 项和真实 Windows 安装事务六类故障回归通过；api.microi.net 真实独立会话完成邀请、接受、共享历史与非成员拒绝。完整产品十岗真实模型、最终安装器、CDN 最新清单仍按各自收据验收；当前段落不代表这些发行门禁已经完成。macOS 下载继续按其独立、实际已发布版本显示。

开发工具 v5.8.6 - (2026-10-09)

修复微应用完整源码拉取的 20 MB 限制：原先上传已成功，但另一位开发者拉取 tools/node-22/node.exe 时复用了 AI 上下文预览限额，导致工程下载失败。新版先取私有源码清单，再逐文件流式下载和校验，完整保留大二进制文件、中文文件与空文件。
保护协作源码：所有文件下载完成并通过大小、SHA-256 及远端清单复核后才应用；下载失败、内容损坏或另一台电脑在下载期间更新源码时停止操作并清理临时文件。本地改动及原有三方比较、推送 CAS 继续保留。
兼容与升级范围：更新 Microi吾码 VS Code 扩展即可使用新的 IDE 拉取流程；@microi.net/cli 同版本分发配套 Skills。沿用现有 GetApplicationContext / GetApplicationFile 接口，本次不修改服务端协议、桌面安装包版本或用户业务数据。AI 上下文预览继续保留自身阅读预算。
自动回归：旧源码已复现原报错；新回归覆盖超过 20 MB 的二进制工程实际落盘、Unicode、空文件、分块响应、哈希错误、清单变化、本地保护、路径校验及临时文件清理。发行渠道结果以实际发布回读为准，客户原工程仍需更新后复验。

v1.3.7 - (2026-10-07)

修复 Windows 升级目录切换失败：针对 1.3.6 安装日志中的 Win32=5，新增 5/32/33 有界重试；持续拒绝目录切换时，仅在本次成功创建的目标目录内做同盘文件迁移，不复制整包到系统临时盘。
完善中途失败恢复：逐项记录迁移意图，回滚时不覆盖旧文件或未知冲突；保留旧备份与未恢复暂存。回滚读到 EOF/短记录即停止，目录句柄关闭后才清理空目录。成功才提交并清理本次暂存。
保留吾码二开与上游同步保护：安装事务及真实 NSIS 回归进入受保护差异层；员工工作台、MCP、内置 Skills、对话历史、编辑与撤回保持。
测试与发行范围：1764 项单元回归通过、11 项平台条件跳过，类型检查及真实三方合并保护通过；最终 NSIS 源码六项故障夹具在 Wine 通过，覆盖中文长路径、短暂/持续错误 5、部分迁移失败及未知冲突。已提供未签名 Windows x64 手动测试候选和一键原生验收工具；Windows 真机升级/启动待验收，自动 latest 与 macOS 1.3.6 保持不变。

v1.3.6 - (2026-10-06)

修复正常入口启动失败：1.3.5 的桌面 main 误用 Electron Helper，触发 Harness 原生加载器的运行时指纹拒绝。新版在所有平台真实执行安装包内独立 Node，保留 Windows 隐藏控制台、HTTP 探测、私有管道、Worker 和插件。
纠正此前验收范围：1.3.5 的打包测试直接启动了包内 Node，未覆盖完整应用正常入口，因此不能证明用户正常打开应用成功。新增永久保护的完整应用门禁；最终签名 macOS 包在 Intel Mac 上两次启动、真实 Worker IPC、员工连接引导及 Harness 重启通过。Apple Silicon 原生和 Windows 真机运行仍需独立验收。
二开保护与回归：固定 Node 选择器、正式入口用例和发布门禁纳入三方同步保护；1,764 项回归通过（10 项平台条件跳过），类型检查、生产构建和界面回归通过。历史故障、旧安装包、商店渠道和用户工作区保持原有更新规则。
新版发布：macOS Universal DMG/ZIP 已签名公证；Windows x64 EXE 为未签名公开测试。共 7 个 CDN 文件完整回读，大小与 SHA256/SHA512 一致；永久下载入口与自动更新指向 1.3.6。
1.3.6 Windows 固定更新清单 · macOS 固定更新清单。

v1.3.5 - (2026-10-05)

dsh-desktop 与 Harness 上游同步：推进两套上游准确提交记录，升级到 Harness 0.2.1-alpha.1；保留吾码十岗员工、账号与中转站、MCP、Skills、品牌、更新渠道及安装/启动恢复。
对话与权限兼容：编辑/撤回适配新版会话选择、显式持有和分叉协议；上下键历史与 /microi 继续可用；同级沙盒权限请求直接沿用当前模式，真正提升权限仍要求有效模式与非空理由。
构建与二开保护：33 份补丁在干净安装中重放；PPT 使用可从源码重建的 16 模板、192 预览管线；Office 按目标系统和 Mac 架构隔离，避免混入宿主二进制。回归、真实界面与安装包验证结果记录在内部发行证明中；Windows 客户设备原生安装和启动仍需独立验收。
验收与发行：1,757 项回归通过，10 项平台条件跳过；13 项界面回归、1 项实际安装包原生组件及 Harness 首页验收通过。另完成安装包启动恢复、私有管道 HTTP/WebSocket 和独立 Worker 验收；Mac 构建辅助门禁定向检查 6 项通过。Windows EXE、Mac DMG/ZIP、两份更新清单及发行资料共 7 个 CDN 文件已完整回读，大小、SHA-256 与 SHA-512 均与本地一致。
1.3.5 固定更新清单与 macOS 清单。历史安装包与版本清单继续保留。

版本、日期和条目格式沿用平台更新日志。安装包版本与 CLI 版本分别管理；历史故障、修复尝试和客户验证边界继续保留。

Windows 免费签名在线安装器 - (2026-10-03)

增加免费可信下载：官网提供 Microsoft Store 生成的微软签名 EXE 在线安装器，安装当前商店版 1.3.3.0，继续保留商店产品页和官网完整安装包入口。完整 EXE 1.3.4 的签名状态不变。
系统适用范围：明确当前商店包最低 Windows 10 2004 / 19041、x64；列出旧 Windows、32 位、ARM、LTSC、Server、离线和企业策略的限制。包条件与 Windows 真机验收分开记录。

v1.3.4 - (2026-10-03)

员工工作台：整理任务、十岗团队、目标与执行设置，提供登录引导、任务筛选、草稿派发、已验收前置成果、成果及审计记录。岗位设置与日预算同步保留，刷新不会覆盖输入中的预算。
吾码小龙虾节点迁入：OpenClaw 受限岗位支持领取、续租、停止接单及结果持久化后幂等回传，配置按租户和负责人隔离；保留已有默认 Agent。完整 Gateway 仍需独立配置，云端成果是待审核草稿。
对话交互：上下键浏览已发送提示词并恢复未发送草稿；已发送消息可编辑、撤回并在分叉会话继续，保留原会话。文件改动不会自动撤销；文件附件须在新会话重新添加。
账号与技能：重整登录表单及员工页面的排版、间距和窄窗口布局；安装包内置 Skills，干净工作区可发现 /microi。
二开保护与验证：上游同步脚本保护补丁、员工节点、Skills 和专项测试；旧版失败对照及修复版回归通过。1,045 项回归通过、10 项平台条件跳过，18 项定向回归、4 项界面验收、1 项实际打包应用的原生组件/Harness 验收及 2 项真实云端成果验收通过。客户 Windows 原生安装、完整 OpenClaw Gateway 与连续 24 小时运行仍待验收。
发布渠道：官网 Windows x64 EXE 与 macOS Universal DMG/ZIP 更新为 1.3.4。macOS 已通过 Developer ID 签名、公证、装订及 Gatekeeper；Windows EXE 未签名。Windows 商店仍为独立 1.3.3 MSIX；Mac 沙盒商店版仍按 Apple 审核进度发布。

文件	大小	SHA256
Universal DMG	381,574,856 字节	`d54a27349627fd9015319d4239ddd120bb9a3d1b3960676be02bec2402d5c5c6`
Universal ZIP	426,242,249 字节	`967739c2e8f72e81f6dfe6478c9a7f8dfff8dfa857e25caf22c0312ac4048f74`
Windows x64 EXE	155,006,058 字节	`f220d69e9f4cebc3f05c7e79a031a9cabbd71fce0ccad33d54c775dbadf3b7b3`

Windows 1.3.4 固定更新清单 · macOS 1.3.4 固定更新清单。历史版本继续保留。

Windows 商店 v1.3.3 已发布 - (2026-10-03)

商店状态更新：Microsoft 后台已显示“在 Microsoft Store 中”，中国区公开产品页已展示 Microi Agent、Microi吾码发行者及产品素材；顶部商店入口同步标注“已发布”。请在 Windows 设备查看获取入口；本机 Mac 未显示获取按钮，Windows 原生获取、安装与启动仍待验收。
下载渠道保留：商店 MSIX 由微软签名分发并通过商店更新；官网 Windows 1.3.2 EXE 仍为未签名测试包。官网 macOS 1.3.2 完整签名公证 DMG 继续可用，独立沙盒 Mac App Store 1.3.2（构建 1.3.3）仍等待 Apple 审核。

Windows 商店 v1.3.3 / Mac App Store 送审 - (2026-10-02)

两个商店正式提交：Windows x64 MSIX 1.3.3 已通过包验证并进入 Microsoft 认证；Mac App Store 1.3.2（构建 1.3.3）正在等待 Apple 审核。均设为审核通过后免费自动发布，审核期间商店入口可能尚未开放下载。
官网增加商店入口：顶部 Windows、macOS 下载按钮下分别提供 Microsoft Store、Mac App Store 链接与实际审核状态，官网已有 EXE、签名公证 DMG 下载继续可用。更新日志仍位于本文最下方。
商店更新与隐私：Windows 商店版停用站外更新清单、下载和 EXE 安装，仅打开本产品商店页；已补充商店隐私政策。Mac 商店版继续采用独立沙盒客户端，完整本机开发能力使用签名公证 DMG。
验证与素材：Windows 商店更新隔离及普通安装更新行为的 9 项回归、TypeScript 检查通过；MSIX 的 15,563 个文件完成解包哈希核对。商店上传高清 Logo 和实际客户端截屏；客户 Windows 原生安装与启动仍待验证。

Windows v1.3.2 公开测试 - (2026-10-01)

开放最新 Windows 测试下载：官网永久入口、最新更新清单、版本目录与官方下载资源均已更新为 Windows x64 1.3.2；旧版本及 macOS Universal 1.3.2 签名公证文件继续保留。下载资源应用采用独立的 v1.3.3 发布记录，桌面程序版本为 1.3.2。
保留验证边界：1022 项回归通过、10 项平台条件跳过，生产构建及 MacBook 上真实私有管道 HTTP、Cookie 和 WebSocket 验证通过；客户 Windows 原生安装及启动仍待确认。EXE 未签名，Microsoft Store 免费签名仍待账号和应用审核。
下载与校验：Windows x64 测试安装包，154,982,105 字节；SHA256：e83b901c911d78e2e03d1feb018e51709f76ca20650ef7fd10cdcac7b8b4cf47。Windows 1.3.2 更新清单归档。发布后已完整下载并核对大小、SHA256 和 SHA512。

v1.3.2 - (2026-10-01)

macOS Universal 更新并完成签名公证：支持 Intel 与 Apple Silicon；应用与 DMG 均通过 Developer ID 签名、Apple 公证、票据装订及 Gatekeeper 验证。发布后的更新清单按最终文件重新计算 SHA512，保留 macOS 1.2.2 及全部历史归档。
修复本机 TCP 双栈失败后的启动恢复：只有 IPv4 与 IPv6 的实际 HTTP 探测均失败时，才使用当前 Harness 的私有管道；保留原认证、Cookie、中文请求和 WebSocket 事件流。1022 项回归通过；真实 Harness/Electron 在普通与安全模式通过私有管道进入工作台。Windows x64 1.3.2 候选 EXE 已构建，客户 Windows 原生安装及启动仍待验收。
Windows 免费签名进度：Microsoft Store 公司账号已进入身份审核；MSIX 身份、商店签名与应用审核尚未完成，公开 Windows 下载及自动更新继续保持 1.3.1。普通 Microsoft 帐号不能给官网 EXE 提供受信任的代码签名；未签名候选包不标为可信发行。
macOS 下载与校验：通过 microi_itdos 发布官方应用 v1.3.2，开发工具 5.8.0 的修复与发布见下一项。

文件	用途	大小
Universal DMG	手动安装	380,707,421 字节
Universal ZIP	自动更新	424,992,762 字节

DMG SHA256：2bb4ba682de125cfefae90251527ff48b97d8ce504f0f1f4110998e661f9d675。
ZIP SHA256：7726972144f5b118faaf81fe1b023da174b67c92b789a131e2bc1aeb31ffef62。
1.3.2 macOS 更新清单归档。

开发工具 v5.8.0 - (2026-10-01)

修复 macOS GUI 自动更新找不到 npm：更新器从本机已安装的 Node.js 目录发现 npm，使用绝对入口，并为子进程补齐路径；明确区分本机运行时缺失和官方 registry 网络故障。更新过程继续保留现有工作、MCP 与会话。
合并并同步开发知识：合并其他电脑推送的 Skills、MCP 和工作流配置更新；npm、Visual Studio Marketplace、Open VSX 均已回读为 5.8.0。本机 VSIX 已安装；使用 VS Code 自带 Electron 和不含 npm 的 GUI 路径执行真实更新器，最终状态为 completed，全局 CLI 为 5.8.0。

v1.3.1 - (2026-10-01)

合并另一台电脑的端口修复：合并 GitLab master 提交 084e075，保留双方代码及开发工具 5.7.8。本机 Harness 与手机配对监听避开浏览器禁止端口；自动命中时最多重选 32 次，显式配置禁止端口立即报错，真实占用和权限错误继续保留。
保留回环连接恢复和二开：继续保留 1.3.0 的受限 IPv6 回环恢复、双通道实际 HTTP 验证、监听诊断、吾码品牌、工作区、会话与本机配置；1.3.0 安装包保持归档，macOS Universal 1.2.2 签名发行与清单保持原样。
重新测试并构建：合并后类型检查、生产构建通过，串行 Vitest 1018 项通过、10 项按平台条件跳过。真实 Harness/Chromium 通过 8 项检查，普通/安全模式共四次冷启动约 4.3–11.9 秒；构建前后 1484 个源码和资源输入哈希一致。客户 Windows 原生安装与启动仍待确认。
Windows 下载与校验：通过 microi_itdos 发布官方下载应用 v1.3.1；本包未签名，安装包 154,956,328 字节，SHA-256 为 2d76b5d148ea8d26da41d1877a95293837737cee36d95cc80df091befc1feb3c。不可变 EXE与更新清单归档可独立校验。

v1.3.0 - (2026-10-01)

修复 IPv4 双通道连接失败后的启动恢复：在已公布认证地址、Node 与 Chromium 两条通道连续两次连接失败时，只重启一次到新的 IPv6 ::1 回环端口。真实 HTTP 500 不触发网络地址切换，也不能作为就绪；普通模式与安全模式遵守相同规则。
补齐监听与版本诊断：日志记录实际应用版本、平台、监听地址、地址族及子进程内 HTTP 自检。探测不发送 Cookie、不跟随重定向，不把启动地址中的 Token 写入新增诊断。IPv6 不可用时保留明确错误，不无限循环或误导用户卸载插件。
保留二开与并发成果：合并 GitLab master 的 1.2.9 修复及交接记录，保留本机 Skills 同步；保护新增运行代码、依赖补丁与回归文件，继续保留工作区、会话、账号、品牌及 MCP。官网下载永久 latest 入口，版本日志移至本页最下方；同期已发布的 macOS Universal 1.2.2 签名发行与清单继续保留。
完成开发验收：类型检查与生产构建通过，串行 Vitest 1013 项通过、10 项按平台条件跳过；真实 Harness 与 Chromium 覆盖普通/安全模式各自的 Node 失败和 IPv4 双通道失败，共四次冷启动。该真实页面验收在 MacBook 上执行，客户 Windows 原生安装与启动仍待确认。
发布 Windows x64 安装包：通过 microi_itdos 发布官方下载应用 v1.3.0，安装包 154,963,108 字节，SHA-256 为 3a269fb188d526d33eb48334788e7c6a16bf20795d252ecfbace24e9d0956b63。本包未签名；不可变 EXE与更新清单归档可独立校验。

v1.2.9 - (2026-10-01)

Windows 启动超时与恢复页修复。
2026-10-01 发布。客户日志显示普通模式、安全模式均输出了 Harness 地址，换端口后仍出现 ETIMEDOUT；进程最后的 SIGTERM 是桌面超时处理主动终止，不能据此认定插件崩溃。
本机 HTTP 探测增加独立计时器，覆盖 TCP 连接及响应头等待，避免单次请求阻塞整个启动流程。
已取得本次 Harness 认证地址而 Node 探测失败时，使用 Chromium 网络通道复核；收到实际有效 HTTP 响应后才加载页面，500 错误仍按失败处理。探测限定当前 127.0.0.1 地址和端口，不发送 Cookie、不跟随跳转。
合并滚动日志时保留不同启动尝试的重复错误，恢复页同时参考本次错误快照。本地服务超时显示实际错误，不再误报第三方插件失败。
保留 MacBook 同期提交的 Windows 跨平台试验打包入口，通过 Git 合并交付。
验收：合并后 128 个测试文件、1015 项通过、1 项仅适用 macOS 的检查跳过，类型检查通过。使用安装包内 Node/Harness 与实际 Chromium 页面验收普通模式和安全模式，注入客户观测到的 Node 超时后仍能加载页面；真实安装目录分别约 10.7 秒和 7.8 秒完成该验收。1.2.8 → 1.2.9 升级覆盖 D 盘中文长路径、C 盘临时目录与真实字节范围锁，安装约 66.8 秒，15553 个文件校验通过。
上述数据来自开发验收环境，客户 Windows 11 设备仍需下载安装后确认；没有把单元测试通过表述为所有客户、所有插件或 AI 员工完整业务均已验收。
Windows 安装包 SHA-256：3b30b1e7adb57f8d7910dc500f977d0913937f88aa3852247379a181a5691a41。该版通过“版本记录”中的历史归档下载；固定文件、不可变归档、发行时更新清单及版本目录均已独立回读校验。顶部 latest 按钮下载实时最新版，不保证仍为 1.2.9。

v1.2.8 - (2026-09-30)

同盘安装事务与安全回滚。
2026-09-30 发布。针对安装目录在 D 盘、临时目录在 C 盘，旧文件搬运及回滚出现 Win32=33 的实际场景，安装器改为：先在安装盘同级目录完整解压新程序 → 同盘重命名旧目录为备份 → 切换新目录 → 成功后清理旧程序备份。
切换失败尝试恢复旧目录；未恢复的备份保留在安装盘，不会被 TEMP 清理。日志记录仍被锁定的残留路径。真实跨盘安装、字节锁、中文长路径和失败回滚已覆盖；此版解决安装事务问题，后续仍收到 Harness 启动超时反馈，启动问题继续在 1.2.9 修复。

v1.2.3～1.2.7 - (2026-09-30)

安装故障定位与诊断集成。
这几版于 2026-09-30 逐步发布，属于反复定位过程中形成的修复；客户随后仍反馈安装失败，不能将早期本机回归结果当成最终结论。
v1.2.7：安装器内置持久日志、复制安装日志和打开日志；记录失败步骤、具体文件、退出码、Win32 错误、回滚结果、只读访问和占用 PID；已能提供具体失败证据，后续定位到跨盘旧文件搬运与字节锁问题；诊断直接集成安装器，无需独立工具。
v1.2.6：修复已重现的中文长路径清理和相关卸载问题；客户仍反馈“旧版本文件清理失败（错误码 2）”；该值是卸载器退出码，不能直接等同于 Windows 文件不存在。
v1.2.5：改用内置兼容解压器，补充安装目录进程识别与清理；同步工作区凭据兼容处理；继续覆盖解压、旧版卸载和文件占用场景，尚未消除后续跨盘迁移失败。
v1.2.4：修复安装包解压与输出文件错误，调整安装打包流程；客户仍报告“无法关闭应用”，随后继续排查旧程序处理路径。
v1.2.3：修复已退出应用仍被安装器误判“无法关闭”的路径；后续出现解压和旧文件清理失败，继续修复，没有要求用户反复结束不存在的进程。
安装失败日志保存在 %LOCALAPPDATA%\Microi Agent\installer-logs\；不可写时使用 %TEMP%\Microi-Agent-installer-logs\。退出安装后仍可读取、复制，不要手工删除日志所指的恢复备份。

v1.2.0～1.2.2 - (2026-09-29～2026-09-30)

功能区、AI 员工与启动诊断。
2026-09-29～09-30 发布。
v1.2.2：Windows 采用直连本机地址的 Harness 探测，保留连接错误并尝试新端口；安全模式失败不直接归咎第三方插件；恢复页入口改为 QQ 群 51050055 与吾码官网；修复永久下载入口和更新清单。
v1.2.1：AI 员工任务接入云端草稿与后台排队执行，复用员工中心；任务派发使用稳定请求标识，重试前查询执行状态。
v1.2.0：修复安装包内 UI 依赖未更新导致旧品牌、AI 员工菜单缺失；完善七岗团队、任务派发、产物验收与协同交接入口。
“工作区服务连接已断开”与云端未登录分别处理：旧空凭据存储迁移后不应终止本机服务；损坏或其他 Windows 用户加密的凭据保留原文件并报告具体错误，不静默清空。安装后应实际打开「Microi吾码」「AI 员工」验证服务连接。多智能体协同仍需使用真实授权账号、模型和业务任务完成执行、交接、验收闭环；菜单可见不代表整个业务已完成验收。

v1.1.9 - (2026-09-28)

更名 Microi Agent 与小龙虾能力整合。
2026-09-28 发布。产品名称、桌面品牌、源码根目录与官网入口改为 Microi Agent；文档入口迁至 /doc/v8-engine/microi-agent.html，原入口保留兼容跳转。吾码小龙虾 README 顶部标注已合并至 Microi Agent。
功能区新增 AI 员工、采集引擎、环境与服务管理，复用现有云端能力。AI 聊天、技能管理、定时任务等已有 Harness / OpenClaw 能力不重复实现。采集会话隔离凭据和浏览器上下文；不以入口迁移宣称 OpenClaw 的所有节点协议及业务已完整移植。
原应用 ID、用户数据目录及部分构建、下载路径继续沿用旧技术名称，保障历史安装、会话和更新兼容；界面展示使用 Microi Agent。

v1.1.4～1.1.7 - (2026-09-27)

macOS、性能与签名边界。
2026-09-27 发布，09-28 补充发布说明。
v1.1.7：发布 Intel / Apple Silicon 通用 DMG 与 ZIP；未签名、未公证版本通过 DMG 手动升级，避免 ZIP 自动安装停滞；补充 macOS 权限、签名、公证、MAS 与移动端能力边界。
v1.1.6：修复 macOS 更新失败后的恢复流程，保留原安装与用户数据。
v1.1.5：优化 Markdown 渲染及解析范围，减少会话页面重复处理。
v1.1.4：改善渲染性能和跨架构 macOS 构建流程。
当时发布的 macOS 通用包为 1.1.7；Windows 新版发布不会自动提高 Mac 清单版本。后续 Mac 包需在 MacBook 构建、校验并单独上传，再更新对应清单；macOS 1.2.2 和 1.3.2 的签名发行记录保留在本页日志，当前版本以页首为准。

v1.1.0～1.1.3 - (2026-09-20～2026-09-24)

应用品牌、工作进程与 Mac 打包。
2026-09-20～09-24 更新。
v1.1.3：服务器卡片的应用 Logo、名称正确应用到桌面左上角，只读租户配置并保存本机设置；移除租户系统标题修改及 Logo 上传。Mac cloudflared 下载支持校验、续传和本地文件；一键打包使用隔离工作树，避免生成资源、版本及锁文件污染源码。Mac 1.1.3 DMG / ZIP 曾单独归档。
v1.1.2：工作进程断开时及时拒绝挂起请求，按需重建，避免 ERR_IPC_CHANNEL_CLOSED 主进程弹窗；关于版本独立加载，底部区域与手机连接对齐。
v1.1.1：统一 macOS Dock 图标留白；插件安装增加超时与诊断；完善 CLI/MCP 的 macOS Keychain 凭据兼容及测试。
v1.1.0：修复 PPT 与吾码能力区互斥、账号资源自适应；默认浅色主题，新增修改文件审查侧栏和跨平台更新元数据。
同步完善官网：删除重复的 Windows/macOS 下载卡片及顶部历史版本链接；版本归档默认折叠并分页，下载入口固定 latest，按钮版本动态获取。历史 CLI 的本机 Keychain 补丁可能被全局重装覆盖，后续应使用已有原生兼容能力的官方 CLI，并重新验证凭据存储；平台 Token 不能替代模型服务账号。

v1.0 系列 - (2026-09-18～2026-09-20)

桌面工作台基础。
2026-09-18～09-20 建立正式桌面版本；1.0.8 为已保留的早期 macOS 归档。
v1.0.9：启动后及每小时检查更新，结果持续可见；完善首页自适应、主题层级、更新桥接与 Mac 构建指引。
v1.0.8：保留早期 macOS Intel 安装包归档，不作为当前 latest。
v1.0.7：完善嵌入式工作区和桌面能力衔接。
v1.0.6：桌面原生图片、音乐、视频工作台及 29 项图像工具；补齐上传、模型参数、异步恢复、结果下载与明暗主题布局。
v1.0.5：完整展开图像能力目录，完善 Windows 打包、签名降级及更新清单。
v1.0.4：扩展首页 AI 能力、官方中转站和 MCP 模型来源。
v1.0.3：增加首页能力卡片、模型来源及个人中心；latest 上传使用暂存后切换，并校验 CDN 缓存回读。
v1.0.2：修复关于版本、折叠侧栏手机入口和服务器连接布局；补齐登录、个人中心、应用品牌入口及上游差异保护。
v1.0.1：恢复桌面壳、更新流程与版本入口。
v1.0.0：首个正式编号版本，工作区、会话、桌面 UI 与吾码功能基础集成。
前期 0.1.0 / 0.2.0 为桌面预览和基于 dsh-desktop 重建阶段。未取得可靠发行证据的版本不补造发布记录。

文档维护 - (2026-10-01)

2026-10-01。
补齐本页完整产品更新历史并恢复桌面右侧「当前页大纲」，保留小屏布局和折叠归档。内部源码根目录新增维护交接文档，记录历次需求、已验证结果、失败尝试、构建发布流程及尚待客户/Mac 真机验收事项；官网文档变化不额外提高桌面版本号。

v1.2.2 - (2026-10-01)

macOS Universal 签名与公证发行：支持 Intel 与 Apple Silicon，最低 macOS 13.5。App 与 DMG 已完成 Developer ID Application 签名、Apple 公证和票据装订，Gatekeeper 验证通过；公网下载文件已完整回读并校验大小与 SHA-256。

文件	用途	大小
Universal DMG	手动安装	380,982,170 字节
Universal ZIP	自动更新	425,475,466 字节

DMG SHA-256：273cb60b06d032e9f3f7951ade0d50c96e978b160a3eee0de28efc9ed8c9a3e4
ZIP SHA-256：577f637fad51837b46f604edf09dafec09a6cccb0574e88bee35ae61875e9a24
1.2.2 更新清单归档。旧版未签名安装包继续保留在版本记录中。

Microi Agent ​

让 AI 在完整业务底座上工作

从对话到完整交付，都在一个工作台

登录与连接

选择能力

完成交付

macOS Intel 1.4.7 发行与验收（2026-11-11） ​

1.4.7 发行与验收（2026-11-08） ​

1.4.6 发行与使用（2026-11-07） ​

1.4.5 历史验收记录与使用说明 ​

1.4.2 修复范围与入口 ​

1.4.1 修复范围与使用说明 ​

AI 员工与对话工作流 ​

项目群聊与多智能体协同 ​

消息保存、实时同步与历史迁移 ​

账号恢复与业务连接 ​

原任务、成果与验收 ​

Harness 和 OpenClaw 的关系 ​

对话历史、编辑与撤回 ​

首页、品牌与桌面功能区 ​

安装、签名与平台兼容 ​

Windows 版本与下载选择 ​

Windows 商店版隐私政策 ​

Mac App Store 客户端 ​

Mac App Store 客户端隐私政策 ​

开源基础、版权与后续同步 ​

同一套 AI 能力，四种使用入口 ​

可以直接这样对 AI 说 ​

AI 如何交付一套完整系统 ​

核心能力 ​

MCP 工具覆盖哪些平台能力 ​

Codex 大工具集兼容 ​

支持的 AI 客户端 ​

零配置知识库：AI 自动理解 Microi ​

快速开始：任选 VS Code 或纯命令行 ​

方案 A：VS Code 插件 ​

方案 B：任意 AI 编程软件 / 纯命令行 ​

方案 C：Codex Plugin ​

自动安装流程 ​

安装后验收 ​

非阻塞自动更新 ​

方案 D：DeepSeek Harness 原生 Profile Bundle ​

方案 E：WorkBuddy / CodeBuddy 原生 Plugin（可选） ​

开始自然语言开发 ​

三端能力与交互边界 ​

CLI 常用命令 ​

CLI 与 VS Code 插件同时使用 ​

V8 本地开发、执行与调试 ​

远程执行 ​

远程逐行调试 ​

本地与远端同步 ​

前端微服务与复杂定制页面 ​

Playwright E2E 自动化测试 ​

性能压力测试 ​

多服务器与身份管理 ​

VS Code 插件配置项 ​

VS Code 插件完整命令清单 ​

连接、AI 与 MCP ​

V8、资源与同步 ​

执行与调试 ​

前端微服务 ​

测试 ​

CLI 与 Codex Plugin 命名、打包与发布 ​

开发工具 6.0.0 发行候选（2026-10-17） ​

包名与产物边界 ​

发布顺序与失败边界 ​

本地构建与安装验收 ​

首次发布到 npm ​

使用截图 ​

常见问题 ​

MCP 显示已配置，但 AI 仍说没有工具 ​

保存文件后为什么远端没有变化 ​

拉取会不会覆盖本地代码 ​

空工作区可以使用吗 ​

不安装 VS Code，能否完整使用吾码 AI 开发能力 ​

CLI 和 VS Code 插件会不会冲突 ​

npm install -g @microi.net/cli 提示包不存在 ​

远程执行与调试不可用 ​

数据库结构很大，会不会拖慢 AI ​

相关链接 ​

Microi Agent

macOS Intel 1.4.7 发行与验收（2026-11-11）

1.4.7 发行与验收（2026-11-08）

1.4.6 发行与使用（2026-11-07）

1.4.5 历史验收记录与使用说明

1.4.2 修复范围与入口

1.4.1 修复范围与使用说明

AI 员工与对话工作流

项目群聊与多智能体协同

消息保存、实时同步与历史迁移

账号恢复与业务连接

原任务、成果与验收

Harness 和 OpenClaw 的关系

对话历史、编辑与撤回

首页、品牌与桌面功能区

安装、签名与平台兼容

Windows 版本与下载选择

Windows 商店版隐私政策

Mac App Store 客户端

Mac App Store 客户端隐私政策

开源基础、版权与后续同步

同一套 AI 能力，四种使用入口

可以直接这样对 AI 说

AI 如何交付一套完整系统

核心能力

MCP 工具覆盖哪些平台能力

Codex 大工具集兼容

支持的 AI 客户端

零配置知识库：AI 自动理解 Microi

快速开始：任选 VS Code 或纯命令行

方案 A：VS Code 插件

方案 B：任意 AI 编程软件 / 纯命令行

方案 C：Codex Plugin

自动安装流程

安装后验收

非阻塞自动更新

方案 D：DeepSeek Harness 原生 Profile Bundle

方案 E：WorkBuddy / CodeBuddy 原生 Plugin（可选）

开始自然语言开发

三端能力与交互边界

CLI 常用命令

CLI 与 VS Code 插件同时使用

V8 本地开发、执行与调试

远程执行

远程逐行调试

本地与远端同步

前端微服务与复杂定制页面

Playwright E2E 自动化测试

性能压力测试

多服务器与身份管理

VS Code 插件配置项

VS Code 插件完整命令清单

连接、AI 与 MCP

V8、资源与同步

执行与调试

前端微服务

测试

CLI 与 Codex Plugin 命名、打包与发布

开发工具 6.0.0 发行候选（2026-10-17）

包名与产物边界

发布顺序与失败边界

本地构建与安装验收

首次发布到 npm

使用截图

常见问题

MCP 显示已配置，但 AI 仍说没有工具

保存文件后为什么远端没有变化

拉取会不会覆盖本地代码

空工作区可以使用吗

不安装 VS Code，能否完整使用吾码 AI 开发能力

CLI 和 VS Code 插件会不会冲突

`npm install -g @microi.net/cli` 提示包不存在

远程执行与调试不可用

数据库结构很大，会不会拖慢 AI

相关链接

License

更新日志

v1.4.7 - (2026-11-11) macOS Intel

v1.4.6 - (2026-11-07)

v1.4.5 - 验收中（2026-10-25）