深色
风格
视觉表达
S 循环切换
经典
稳定的技术默认风格
信号流
突出动态流向
蓝图
工程评审
编辑风格
适合发布与上线说明
动态
演示
导出
导出图表
便携、整洁的输出
E
分享
分享卡片
1200×630 PNG
路径分享卡片
1200×630 PNG
可达范围分享卡片
1200×630 PNG
复制分享卡片
复制 PNG 到剪贴板
复制图表
复制 PNG 到剪贴板
图像
PNG
无损图像
JPEG
紧凑图像
WebP
现代图像格式
矢量与动效
SVG
可编辑矢量图
WebM
6 秒动效
Desktop × 考勤核算 (attendance-tally):React 视图桥接、CAS/只读保护与 userActionOnly 闭环
←
引导视图
探索此系统
沿精选路径逐步查看,而不改变源图表。
节点
下一步
→
▶
播放故事
#
复制此刻
显示全部
Desktop × 考勤核算 (attendance-tally):React 视图桥接、CAS/只读保护与 userActionOnly 闭环
由 Archify 生成的时序图。
getTaskContext() + callStateTool(attendance_view_state)
origin='ui' 只读调用 attendance_view_state(section)
返回 revision + snapshot;UI 校 mayAct 只读横幅与 dirty 防切页丢稿
用户点确认/计算 → submitAction(toolId, args, expectedRevision)
核对 taskBinding + actionToolIds 白名单 → 持久化交互回执
签发 PluginActionReceipt 并触发对应工具执行
capabilities.begin 注入 userActionReceipt → 调 confirm / calculate
可选发布/拉取客户模型:经 Host 代理连接 attendance-model-registry
CAS 校验 revision → 返回新 revision + workflow.nextAction (或准入前 completed 拒绝)
PluginCallJournal.settle → 主任务消费 nextAction 打开下一阶段视图
阶段 1: window.aida 宿主桥接、attendance_view_state 拉取与 mayAct / dirty 边界保护
阶段 2: 用户点击门禁按钮 → submitAction 回执签发 → expectedRevision CAS 校验
阶段 3: workflow.nextAction 自动推进视图、准入前确定性拒绝与模型库发布
考勤 React UI · app.tsx · useTask · 时序参与者
考勤 React UI
app.tsx · useTask
Desktop PluginHost · window.aida · Lease · 时序参与者
Desktop PluginHost
window.aida · Lease
Python 考勤 Worker · task_provider · Workbench · 时序参与者
Python 考勤 Worker
task_provider · Workbench
Agent / Local Kernel · ActionReceipt · NextAction · 时序参与者
Agent / Local Kernel
ActionReceipt · NextAction
考勤模型库服务 · attendance-model-registry · 时序参与者
考勤模型库服务
attendance-model-registry
图例
请求
返回
安全
异步追踪
就绪
章节 01 / 01
引导章节
图表指南
探索此系统
×
正在检查已编译语义
01
查找任意节点
搜索标签、职责、类型和稳定 ID。
/
02
追踪路径
查看两个语义节点如何按编写方向连接。
R
03
查看完整系统
打开带实时视口和稳定节点的语义雷达。
M
04
比较语义类型
统计角色、显示流量并比较直接编写的连接。
L
05
播放引导故事
浏览已编写的章节和真实关系。
P
06
进入演示模式
让实时图表占满视口,同时不改变导出。
F
E
导出
T
主题
S
风格
0
重置
+
放大
-
缩小
Esc
关闭
查找节点
×
⌕
/
没有匹配的节点
语义护照
已验证来源
编写可达范围
上游
0
下游
0
×
复制链接
关系
路径探测
选择起点节点
查找起点
复制链接
清除
在图表中选择两个语义节点
←
▶
旅程
→
总览
先选择来源,再选择目标;方向很重要。
语义透镜
比较系统角色
×
最多选择两种语义类型。选择一种可显示其真实流量;选择两种只比较直接编写的关系。
选择一种类型以检查其节点和相连关系。
复制链接
清除
语义雷达
正在构建总览
打开雷达
×
点击节点
拖动平移
语义雷达需要更多地图可见空间。
路径
地图
透镜
阅读
100%
前端只读与未保存输入保护 (app.tsx / use-task.ts)
• 历史卡片打开旧视图时 mayAct=false,顶部渲染黄色只读提示并禁用所有提交入口
• 编辑缓冲区 dirtyCount > 0 时若主任务后台切换 requestedView,UI 暂留原页面防丢稿并提供放弃切换按钮
userActionOnly 回执 × expectedRevision CAS
• attendance_task_confirm / calculate / publish 声明 userActionOnly: true,无宿主签发 userActionReceipt 直接拒绝
• AttendanceTaskWorkbench 强制比对 expectedRevision === self.revision,并发或过期提交立即拦截
准入前确定性拒绝与模型库连接
• calculation_rejection.py 对缺规则基线等准入前零写入拒绝标记 executionState='completed',避免 Host 误判 unknown
• attendance-model-registry 声明 suggestedBaseUrl,跨会话复用已确认 RuleModel 与 CalculationModel 快照