察元AI OS · vv3.2.12 · 更新于 2026-10-17

察元AI OS · 产品手册

察元AI OS(前身「察元AI超级智能体」产品线)是以 harness(驾驭层)为核的插件化 AI 桌面操作系统:智能体统一管理、全局记忆一份全端共享、模型 / 工具 / 技能归一化托管。本手册按「安装 → 桌面上手 → AI 能力 → harness 驾驭层 → 桌面灵宠 → 安全保密 → 远程协同 → 协同」组织,供使用与采购评估参考。

一、定位:harness 驾驭层 + AI 服务的「现场」

察元AI OS 把 AI 能力做进操作系统层,核是 harness(驾驭层):对话本体保持各家最强的 CLI 与 dsh harness 会话原样,察元在底下统一做「装、配、记、控、看」——16 家智能体统一管理,全局记忆一份共享,模型 / 工具 / 技能归一化托管,全部经统一 MCP 控制面开放整机能力。它不是一个聊天 App,而是「让 Agent 住在你机器上的系统层」——默认桌面就是灵宠工坊小镇,每只灵宠是一个智能体的化身。

层级内容
harness 驾驭层智能体统一管理(16 家注册表 / 自动发现 / 统一工作台)、全局记忆(一份全端共享 + AGENTS.md / CLAUDE.md 投影注入)、归一化(模型 / 技能 / MCP 工具 / 权限 / 审计统一托管)
桌面环境锁屏 / Dock / 多窗口 / Spotlight / 通知中心 / 壁纸体系 / 多用户
内置应用20+:终端、文件管理器、浏览器、备忘、日历、提醒、文生图、画图、Monaco、媒体、PDF 等
AI 能力对话(dsh harness)、模型服务(本地五件套)、知识库(混合检索 RAG + 知识图谱)、智能体(16 家注册表)
可编程面MCP 控制面 70+ 工具、应用商店(技能包/插件/MCP 插件/智能体/技能,能力广场 6600+)、智能体原生窗口、创造模式
桌面灵宠默认场景桌面 / 全屏漫游与状态动画 / 灵宠商店(场景·形象·元素 400+ 在线内容)/ 宠物群聊 v2(搜索·Reaction·纪要·多步骤编排)
安全保密回环端口、T0/T1/T2 权限门、双层审计、凭据加密、隐私三红线
远程协同远程分享/控制、WebRTC 高清镜像、剪贴板双向同步、手机 viewer、多用户 Web 访问、自建云中继
交付形态桌面安装包 / Docker / Android App / 手机 H5 / dsh 插件

二、安装

  1. 选包:macOS dmg(arm64 / x64,隐原标题栏原生红绿灯);Windows NSIS exe;Linux deb + AppImage(UOS 20 推荐 deb,缺 libfuse2 时勿用 AppImage);Docker 用 docker-compose 服务器栈。
  2. 轻量版 / 全量版:轻量版不含模型权重,本地模型可应用内一键下载;全量版(models 版)内置五件套(Qwen3.5-4B 对话、bge-m3 嵌入、bge-reranker 精排、whisper-small-int8 语音识别、piper 中文 TTS),离线开箱即用。
  3. 零依赖:不向系统安装 node / pnpm——Electron 以 ELECTRON_RUN_AS_NODE 充当 Node 运行时,pnpm 整包内置。
  4. 首次启动:开机动画 → 欢迎 / 向导页 → 进入桌面;已装本地模型时免向导自动注入——启动约 1.5 秒自动加载已装对话模型并应用到全部智能体,无需走完向导。统一模型设置向导仍可从 设置 → 模型 重跑(四步把默认模型应用到全部智能体)。

平台矩阵:x86_64 / aarch64 / 龙芯 loongarch64;银河麒麟 V10、统信 UOS 20 实测适配;引擎覆盖 darwin-arm64 / linux-x64 / linux-arm64 / win-x64。

图:统一模型设置向导:讲清「模型代理 = 唯一出口」,四步把默认模型应用到全部智能体;已装模型则免向导自动注入

更新:应用内检查更新(也向 aidooo.com 上报心跳与版本比对,断网静默跳过),或重新下载安装包覆盖。

三、桌面十分钟上手

图:察元AI OS 桌面实拍:默认灵宠工坊场景(商店动态场景「鲸背小镇」)+ 两只灵宠 + Dock 任务栏

四、模型服务

图:模型设置:66 家厂商目录 / 本地模型十类 / API 密钥加密落盘

察元自建 llama.cpp / whisper.cpp / piper 四平台静态二进制,统一经 OpenAI 兼容代理(本机 52581)对外;模型显式加载 / 卸载,加载器执行内存预算硬底线——任何时刻推理占用不超过总内存的 45%。

免向导自动注入:插件启动约 1.5 秒自动加载已装的第一个对话模型(CHATOP_NO_PRELOAD=1 可退出),随后在 dsh 拉起前自动写入本地模型路由并注入预签的虚拟 Key——对话界面下拉即可选本地模型,全程无需向导。顶栏模型状态列表按用途分类(含决策模型),谁在跑一眼可见。

五、知识库与知识图谱

图:知识库应用:多库管理(产品手册库 / 公司制度库…),文档批量导入带 OCR

导入 → 抽取 → 切分 → 嵌入 → 落库,全部在本机完成;数据库是每库一个的 SQLite 单文件($DSH_HOME/storages/chatop-kb/<kbId>/kb.db)。

  1. 导入:doc / docx / xlsx / pdf / html / txt / 图片(OCR)。批量导入支持断点续传、幂等重试与去重。
  2. 切分:结构感知:保留标题路径,500-800 token 块 + 重叠。
  3. 检索:向量 KNN(sqlite-vec,缺失时纯 JS 暴力扫)+ FTS5 BM25(trigram 支持中文子串)→ RRF 融合 → 可选 bge-reranker 精排 → 邻块扩窗。
  4. 作答:流式输出带 [1][2] 脚注引用,可下载源文件回查原文。

图:知识图谱:文档↔实体二部图,随文档导入自动构建——点击实体关联相关文档,点击文档回看实体与源文件

知识图谱(纯离线零依赖):在 chunk 文本上做轻量统计抽取——英文词 + 中文 2~4 字 gram,停用词与边界虚词过滤,被更长高频词包含的短 gram 自动吸收;全局词频 top-N 实体与 ready 文档连成二部图,无需任何模型参与。图谱是组织记忆的导航图:顺着实体把散在多份文档里的同一件事一网打尽。

嵌入四级降级:用户指定 → 本地运行时(探测模型服务)→ 云端 OpenAI 兼容端点(Key 经凭证引用)→ 纯 FTS 关键词。任何环境都有可用检索。

图:引用式问答:混合检索作答,[1][2] 脚注引用,搜索到的文件一键回查原文

问答台是对话式多轮交互:会话级可选模型,出处文件列在每轮输出下方,点开即见片段原文与路径。对外共享:除 agent 工具(kb_search / kb_list / kb_read_doc)与管理面 API 外,固定端口 52582 提供只读服务——察元AI Office 的知识库客户端即从此接入。

六、harness 驾驭层:统一管理 · 全局记忆 · 归一化

图:应用商店「智能体」页签:16 家命令行智能体一键安装 / 升级,安装态自动识别,官方图标自动下载

察元不自研对话运行时:对话本体是 dsh harness 会话与各家 CLI TUI,察元补的是 harness 驾驭层——「入口无处不在 + MCP 工具面 + 全局记忆 + 归一化托管」。智能体注册表内置 16 家:Claude Code、Codex、OpenCode、OpenClaw、Gemini CLI、Aider、Goose、Qwen Code、Kimi Code、Crush、Cursor CLI、Copilot CLI、Droid、Amp、Grok Build、CodeBuddy——每家的 npm 包 / 二进制 / 配置路径 / 技能目录 / MCP 落点都经官方源核实。

6.1 统一管理:装、升、发现、看,一个入口

6.2 全局记忆:所有智能体共用一份记忆

6.3 归一化配置托管:配一次,全家生效

6.4 技能与 MCP 共享:装一次,家家都有

图:应用商店「MCP 插件」:察元能力广场 / 精选目录 / 自定义源,一键安装自动同步到各智能体配置

图:技能包商店(aidooo 商城):按行业分组浏览,免费一键装、付费扫码购,已购跨机恢复

七、桌面灵宠:小镇、群聊与商店

图:灵宠工坊桌面:每只灵宠对应一个智能体,状态动画映射真实工作节奏

7.1 灵宠工坊(默认场景桌面)

7.2 宠物档案

7.3 宠物群聊 v2

图:宠物群聊 v2:多只灵宠围绕你的命题接续讨论,🔍 搜索 / 表情 Reaction / 📝 纪要工具条齐备

7.4 灵宠商店:400+ 在线内容

图:灵宠商店·场景页签:2K 精细场景与动态场景免费领取,滚动自动加载

图:灵宠商店·形象页签:30+ 职业装扮,领取后建宠物栏即刻可选

八、安全保密(重点章节)

8.1 数据不出域:全部服务回环监听

服务端口(均 127.0.0.1)
dsh 管理面(主实例)52584(多用户形态每用户一会话,52601 段)
模型 OpenAI 兼容代理52581
知识库对外只读服务52582
MCP 控制面 HTTP52583

知识库文档、对话记录、模型权重、智能体配置全部本地磁盘;离线五步法面向涉密内网、隔离工位、舰船 / 野外场景(帮助中心「离线使用」章)。Docker 形态同样保留回环语义(容器内转发器让来源仍是 127.0.0.1)。

8.2 行动边界:T0/T1/T2 权限门

8.3 审计

控制面审计(shell/audit.jsonl,工具调用含 source 与 decision 四值)与管理员跨界审计(root/audit.jsonl)分立落盘;远程协助的云中继操作审计独立存放(route-audit.jsonl)。

8.4 凭据与沙箱

8.5 隐私三红线

九、远程协同与多形态

9.1 远程分享与远程控制

9.2 高清镜像与剪贴板同步(v3)

9.3 手机 viewer 与多用户 Web 访问

9.4 交付形态

十、与察元家族协同

十一、常见问题