深色
风格
视觉表达
S 循环切换
经典
稳定的技术默认风格
信号流
突出动态流向
蓝图
工程评审
编辑风格
适合发布与上线说明
动态
演示
导出
导出图表
便携、整洁的输出
E
分享
分享卡片
1200×630 PNG
路径分享卡片
1200×630 PNG
可达范围分享卡片
1200×630 PNG
复制分享卡片
复制 PNG 到剪贴板
复制图表
复制 PNG 到剪贴板
图像
PNG
无损图像
JPEG
紧凑图像
WebP
现代图像格式
矢量与动效
SVG
可编辑矢量图
WebM
6 秒动效
Mica Code Desktop 运行时架构
←
引导视图
探索此系统
沿精选路径逐步查看,而不改变源图表。
节点
下一步
→
▶
播放故事
#
复制此刻
显示全部
Mica Code Desktop 运行时架构
由 Archify 生成的架构图。
Electron 外壳 · main · 无 preload · 架构组件
Electron 外壳
main · 无 preload
config-web 配置页 · 跨源 iframe · 架构组件
config-web 配置页
跨源 iframe
Renderer 页面 · React · transport.js · 架构组件
Renderer 页面
React · transport.js
运行时 · HTTP /api/invoke · 无认证 HTTP 端口(等价宿主 shell)
运行时
HTTP /api/invoke
Host 业务核心 · chat · terminals · files · 无认证 HTTP 端口(等价宿主 shell)
Host 业务核心
chat · terminals · files
mica 子进程 · app-server · commit · 架构组件
mica 子进程
app-server · commit
PTY 终端 · node-pty 真终端 · 架构组件
PTY 终端
node-pty 真终端
本机数据 · userData · 会话文件 · 架构组件
本机数据
userData · 会话文件
LLM API · 模型 · MCP servers · 架构组件
LLM API
模型 · MCP servers
loadURL 加载页面
拉起运行时
HTTP · SSE
invoke 分发
spawn 子进程
模型 · MCP 请求
拉起配置页
userData · 会话文件
PTY 会话
无认证 HTTP 端口(等价宿主 shell)
图例
前端
后端
数据库
外部系统
就绪
章节 01 / 01
引导章节
图表指南
探索此系统
×
正在检查已编译语义
01
查找任意节点
搜索标签、职责、类型和稳定 ID。
/
02
追踪路径
查看两个语义节点如何按编写方向连接。
R
03
查看完整系统
打开带实时视口和稳定节点的语义雷达。
M
04
比较语义类型
统计角色、显示流量并比较直接编写的连接。
L
05
播放引导故事
浏览已编写的章节和真实关系。
P
06
进入演示模式
让实时图表占满视口,同时不改变导出。
F
E
导出
T
主题
S
风格
0
重置
+
放大
-
缩小
Esc
关闭
查找节点
×
⌕
/
没有匹配的节点
语义护照
已验证来源
编写可达范围
上游
0
下游
0
×
复制链接
关系
路径探测
选择起点节点
查找起点
复制链接
清除
在图表中选择两个语义节点
←
▶
旅程
→
总览
先选择来源,再选择目标;方向很重要。
语义透镜
比较系统角色
×
最多选择两种语义类型。选择一种可显示其真实流量;选择两种只比较直接编写的关系。
选择一种类型以检查其节点和相连关系。
复制链接
清除
语义雷达
正在构建总览
打开雷达
×
点击节点
拖动平移
语义雷达需要更多地图可见空间。
路径
地图
透镜
阅读
100%
三层边界
• Electron 外壳只做容器:拉运行时、loadURL、徽标与服务器导航
• 运行时是零依赖 Node HTTP:/api/invoke 调用面 + /api/events SSE
• 同一页面服务桌面、浏览器与手机,window.mica 由 transport.js 建立
Host 业务核心
• chat / terminals / files / git / stats 只跑在运行时进程里
• 每个 chat 会话派生一个常驻 mica app-server 子进程
• 终端是真 PTY(node-pty),空闲 8 小时回收
配置页与安全边界
• 配置页是跨源 iframe 内嵌的 config-web,无 preload
• 运行时无认证:连上端口就等于拿到宿主 shell,默认 0.0.0.0
• ELECTRON_RUN_AS_NODE 在派生子进程之前剥离