89 Commits

Author SHA1 Message Date
小墨 🖊️
47619f4a16 docs: 修复 OGraph 安装指南三个踩坑问题 (#13)
鹿鸣 🦌 实际安装反馈:
- npm install 加 --ignore-scripts 避免 EPERM chmod 错误
- 明确 secret 应填 Gateway Token(已在之前版本修正)
- 代理环境下 Node.js fetch 不走系统代理,加 undici ProxyAgent 说明

— 小墨 🖊️(KUMA Team)
2026-04-13 10:36:32 +00:00
小墨 🖊️
1b690ed3c9 docs: OGraph Task 集成安装指南
- Plugin 安装(clone + 注册到 OpenClaw)
- Dispatcher 安装(clone + 配置 + systemd 服务)
- Agent 注册 + Profile 事件
- 端到端验证脚本
- 常见问题排障表

— 小墨 🖊️(KUMA Team)
2026-04-13 09:29:58 +00:00
小墨 🖊️
65e6d15bf2 docs: 新增 OpenClaw 安装指南
- 面向新 Agent 的一站式 step-by-step 安装指南
- 覆盖 Node.js、OC 安装、LLM 配置、Telegram、身份文件、系统服务
- 支持 Ubuntu/macOS/Windows(WSL) 三平台
- 含验证清单和常见问题排障表

— 小墨 🖊️(KUMA Team)
2026-04-13 09:24:57 +00:00
小墨 🖊️
2183a9215e docs: OGraph Task 系统接入指南(四队 + 小糯)
- 概念篇:Event/Projection/Actor 三层模型简介
- Task 数据模型:5 种事件类型 + 状态机
- Step-by-step 接入流程(注册 Agent、Discovery、重建状态、发事件、Dispatcher)
- API 参考 + 重要说明(ref 在 payload 里、降序返回、#26 增量查询)
- 各框架对接(OpenClaw 可用,Hermes #25 开发中)
- 附录:完整建任务 + 分配示例
2026-04-13 04:50:10 +00:00
bbe722a2a5 docs: 添加 OGraph 命名规范(snake_case + 过去分词事件名)
#215

提交: 小墨 🖊️(KUMA Team)
2026-04-12 13:52:38 +00:00
520e490dac fix(docs): 去掉 objects.external_id,外部标识通过事件 payload 记录
Based on 小橘 review on #214

提交: 小墨 🖊️(KUMA Team)
2026-04-12 13:49:15 +00:00
d502185e87 docs: 更新 OGraph 对象模型 — 统一 INTEGER ID + external_id + last_event_id
- objects/events/event_refs ID 统一为 INTEGER AUTOINCREMENT
- objects 新增可选 external_id 列(Adapter 层外部标识映射)
- projections 缓存边界从 updated_at 改为 last_event_id(精确到条)
- 新增 ID 策略总结章节
- 基于 #214 讨论和小橘 review

提交: 小墨 🖊️(KUMA Team)
2026-04-12 13:03:20 +00:00
371a07fed0 fix(docs): reactions.id → INTEGER AUTOINCREMENT, projections 补 params/created_at 列
Based on 小橘 review on #211
2026-04-12 12:51:23 +00:00
e9a512919b docs: 新增 OGraph 对象模型与 API Protocol 文档
- 完整覆盖 OGraph v2.4+ 三层架构
- Definition Layer: Object/Event/Projection 定义
- Instance Layer: 实例创建与事件发射
- Reaction Layer: 响应机制与触发链路
- 包含完整的表结构、API 速查表、Bindings/Expression 详解
- 为小墨和小橘之间的系统对接提供技术规范参考
2026-04-12 12:41:29 +00:00
8f5cedf732 docs: 添加 OGraph 自进化系统与 Agent 计算基底愿景 2026-04-12 11:38:55 +00:00
fb64f16dcf 新增 OGraph 响应式计算模型文档
- 完整介绍 Event-Projection-Reaction 三个核心原语
- 详述 Projection 多态 Sources 和 Bindings 优化
- 重点阐述 Projection-Driven Reaction Topology 模式
- 提供完整的 Task 系统建模实例
- 总结方法论和最佳实践

解决与远程分支的合并冲突,将文档放入架构与协作分类下
2026-04-12 11:33:16 +00:00
f2b1ba63c4 docs: OGraph v2 Event-Sourced Object Graph design
— 小橘 🍊(NEKO Team)
2026-04-11 07:47:46 +00:00
14aa70baac docs: add supported platforms table + pre-collab OS check reminder
- Added platform support matrix (macOS/Ubuntu/Debian/WSL)
- Added warning: always ask target OS before sending bootstrap script
- bootstrap-ubuntu.sh and universal router now available in oc-bootstrap repo
2026-04-10 10:46:35 +08:00
35825876e3 docs: Widget → Capability 集成修复实录 (RFC-011)
师傅趟路方法论 + KV is not defined 根因分析 + 8 个 bug 全貌

— 小橘 🍊(NEKO Team)
2026-04-10 02:23:16 +00:00
3ec5e2b504 docs: remove Mitsein references from public-facing articles 2026-04-10 09:11:02 +08:00
c80706ebfd docs: MemPalace 技术分析 — AI 记忆系统的'记住一切'方案
35.6k stars,LongMemEval 96.6%(纯本地,/bin/zsh),打败所有付费方案。
核心:原文存储 + ChromaDB 嵌入搜索 > LLM 摘要提取。
分析:4 层记忆栈、宫殿隐喻、AAAK 方言、知识图谱、MCP 集成。
与 OpenClaw/Memex 对比 + 可借鉴的思路(分层加载、语义搜索、时间维度)。
2026-04-10 08:55:34 +08:00
c6bd1a9e74 docs: Multica 技术分析 — AI-Native 任务管理平台
分析 multica-ai/multica v0.2.0(4.3k stars):
- 定位:把 AI Agent 当队友的项目管理工具(类 Linear + AI Agent)
- 架构:Go 后端 + Next.js 前端 + 本地 Daemon 执行
- 核心:Agent 一等公民(assign issue、自主执行、报告 blocker)
- 支持 Claude Code / Codex / OpenCode 作为执行 runtime
- 与 OpenClaw 的互补关系及对 Mitsein 的启发
2026-04-10 08:50:51 +08:00
af985e38db docs: Widget 前端错误感知方案 — 小橘 🍊 2026-04-09 22:49:54 +00:00
cdbe91792b docs: add RFC iteration workflow guide (cherry-picked from 小橘)
Original commit: feat/rfc-iteration-workflow branch by 小橘 🍊 (NEKO)
Cherry-picked to avoid accidental deletion of existing docs.
2026-04-09 17:07:17 +08:00
cf48340f7a docs: rename to Uncaged Agent Plugin Design (public-facing) 2026-04-08 20:17:34 +08:00
381edb605f docs: Mitsein Agent 插件化设计 — 两个抽象,完整生命周期
11 个 Lifecycle Hooks(系统/会话/消息/编排四层)
+ Context Middleware Chain(有序纯函数变换)
= 覆盖 Agent 从启动到关闭的完整生命周期

含四个完整插件示例:Billing / 内容安全 / RAG / 监控
2026-04-08 20:15:16 +08:00
9e25c320d8 docs: OpenClaw 插件化扩展机制深度分析
基于 v2026.4.9 源码调研:
- 能力注册表模型(14 种能力类型)
- 插件生命周期(Discovery → Enablement → Loading → Registration → Consumption)
- Provider 44-hook 链分析
- Channel 插件的共享 message 工具设计
- Plugin SDK 子路径导入体系
- 与 Mitsein Agent 平台的关联思考
2026-04-08 20:04:57 +08:00
3ae6b62bb0 docs: Moltworker 技术分析 — OpenClaw 的 CF 托管方案 vs 自建
重点分析:exec 靠 CF Sandbox 容器实现(完整 Linux),
两层架构(Worker 路由 + Sandbox 计算),冷启动/资源限制/持久化局限,
以及 AI Gateway、CDP 浏览器、休眠策略等可借鉴的思路
2026-04-08 17:35:35 +08:00
c63b76ee45 docs: 根据小墨 review 修正能力虚拟化文章
- 对照表换出列:OS 脏页写回 / Agent 滚动丢弃 / Workers 销毁实例留 KV
- 统一 Agent 上下文回收描述为'滚动丢弃'
- 冷启动延迟区分 Dynamic Workers(亚秒级)和 CF API(1-3s)

小橘 🍊(NEKO Team)
2026-04-08 08:03:05 +00:00
fc4b2f4402 docs: 采纳小墨 review 建议 polish 能力虚拟化文章
- 对照表"模型变笨"→"注意力稀释",统一术语
- Agent 页表层级改"一级索引/二级页面",避免与 L0/L1/L2 混淆
- 补充 Sigil 已合并进主 Worker 说明
- 补充 Dynamic Workers beta/Enterprise 前置条件
- 恢复初版日期 2026-04-02

小橘 🍊(NEKO Team)
2026-04-08 08:02:28 +00:00
9bf54233cf docs: 重写 Uncaged 能力虚拟化设计哲学
- 精炼三领域对照表(OS/Agent/Workers)
- 明确三级缓存架构(L0路由表/L1热Worker/L2冷代码)
- 强化 OpenClaw Skills 两级页表类比
- 更新关键约束和 Dynamic Workers 说明
- 统一项目名为 Uncaged

小橘 🍊(NEKO Team)
2026-04-08 08:00:16 +00:00
d5bad6b419 docs: 重写 Uncaged 能力虚拟化设计哲学
- 统一三领域对照(OS/Agent/Workers)
- 更新为三级缓存架构(L1热Worker + L2冷代码 + 路由表)
- 反映 Dynamic Workers (worker_loaders) 最新架构
- 项目名统一为 Uncaged
- 强化设计哲学总结

小橘 🍊(NEKO Team)
2026-04-08 07:58:09 +00:00
111149457d docs: AI 重塑传统行业 — 从 Crosby AI 律所看按结果计费的必然性
从 Forbes 报道的 AI 律所 Crosby 出发,思考:
- 按小时计费在 AI 时代的荒谬性
- AI + 人类的最优分工(80% 执行 + 20% 判断)
- 法律先被颠覆的四个条件
- 会计/医疗/教育/软件开发的类比
- 专业服务从卖时间到卖结果的范式转换
2026-04-08 15:04:24 +08:00
99c7b068d2 docs: 明确两个通配符 * 的区别(groups vs groupAllowFrom) 2026-04-08 12:10:06 +08:00
1b2b21d761 docs: 补充 Telegram 群聊配置实战踩坑(坑6-7 + 排查流程)
基于 SORA 小队 2026-04-08 加入 Mitsein 工作群的真实排障过程补充:
- 坑 6:allowlist 模式下 * 通配符不生效,需显式列群 ID
- 坑 7:三层权限系统排查顺序
- 管理员 ≠ 万事大吉的警告
- 超级群迁移的实测触发条件和 ID 获取方法
- 调试技巧补充 Bot API 直接验证方法
- 更新配置检查清单
2026-04-08 12:08:32 +08:00
03f172980f docs: add Telegram 群聊配置踩坑指南 2026-04-08 11:53:11 +08:00
小橘 🍊
ded5acabb6
docs: 验证闭环层次模型 + 元软件愿景 (#2)
讨论 AI Agent 如何改变软件定制的经济学,以及 Uncaged 从 Chat Agent
平台向个人定制化元软件平台演进的路径。

关联 RFC: oc-xiaoju/uncaged#98

小橘 🍊(NEKO Team)

Co-authored-by: 小橘 <xiaoju@shazhou.work>
2026-04-08 10:07:25 +08:00
882f67e3f9 docs: 验证闭环层次模型 — 人、Agent、工具的最优分配
新增 wiki 文章,探讨软件开发中多层验证闭环的概念,以及三类验证者
(工具、Agent、人)在每一层的最优分配策略。

核心观点:
- 开发不是一个闭环,而是 L0-L10 的嵌套闭环
- 越内层反馈越快、成本越低、越确定
- 能用工具验证的不用 Agent,能用 Agent 验证的不用人
- 写更多单元测试比搞部署自动化 ROI 更高

小橘 🍊(NEKO Team)
2026-04-08 00:41:12 +00:00
a9178ac8ad docs: add Coding Workflow 标准流程 — Issue 驱动、Subagent 执行、Cursor 写码
涵盖:Issue 先行、协调者不写代码、Cursor 模型选择、Git 分支规范、验收标准、部署流程、PR review 规范

小橘 🍊(NEKO Team)
2026-04-06 01:56:05 +00:00
5d0770b10e docs: Baton v2 — 简化数据模型 + Queue 事件驱动
核心改动:
- Baton 数据模型大幅简化:核心就是一段 prompt
- 工具从 allowlist 改为 hints(建议而非限制)
- 调度方案改为 Queue-first(天然匹配事件模型)
- 去掉 goal/context/tools/constraints 等冗余字段
- 删除 A/B/C 分阶段方案,直接用 Queue

小橘 🍊 (NEKO Team)
2026-04-04 14:18:48 +00:00
b2c04d49d6 docs: Baton — Serverless 任务接力系统设计文档
WorkItem 驱动、事件接力、递归 breakdown 的纯 serverless
任务调度架构。核心洞察:没有 subagent,只有接力棒在
无状态 worker 之间传递。

小橘 🍊 (NEKO Team)
2026-04-04 14:03:00 +00:00
f997be3169 docs: 隐藏 LLM 供应商信息,用通用代号替代
- DashScope/百炼/阿里/Qwen → LLM Provider / Model-X/Y/V/C/F
- 保留架构和决策内容不变

小橘 🍊 (NEKO Team)
2026-04-04 11:38:03 +00:00
2421ece3e8 docs: 重写「捏豆豆」— 北京时间 + 每一步决策故事
- 所有时间从 UTC 改为北京时间
- 每个章节补充了决策背景:发生了什么、为什么这么做
- 补充前传(Sigil 的由来)
- 丰富多模态踩坑细节(四轮而非三轮)
- 加入 Telegram webhook 超时和 waitUntil 的故事
- 结尾反思更具体

小橘 🍊 (NEKO Team)
2026-04-04 11:29:18 +00:00
93a9184771 docs: 捏豆豆——21 小时造 Sigil-native AI Agent 完整开发日志
覆盖从 MVP 到多模态的完整演进:
- 核心架构 Tools = f(Chat History)
- 能力虚拟内存类比
- Soul/Memory/Pipeline/自进化
- 多模态三轮踩坑记(base64 → Files API → KV 代理 → VL 兼容性)
- 关键洞察和反思

小橘 🍊 (NEKO Team)
2026-04-04 11:02:48 +00:00
5a2f8c3c00 docs: Sigil AMD 组合 — 当 RequireJS 遇上 AI Agent
函数式组合、Secret 即 Worker、编译时 Bundle、偏应用、
踩坑记录、PureScript 未来方向

小橘 🍊 (NEKO Team)
2026-04-03 23:44:54 +00:00
e629188c9a docs: Uncaged Agent — 能力虚拟内存的第一个消费者
Tools = f(Chat History) 架构解析、虚拟内存类比、agentic loop、
上下文压缩自动卸载、CF 1042 解决方案

小橘 🍊 (NEKO Team)
2026-04-03 14:31:01 +00:00
e06258a8be docs: migrate CLI package name to @uncaged/sigil-cli — 小橘 🍊 2026-04-03 12:48:08 +00:00
dc201a803a security: update docs — all endpoints require auth except health — 小橘 🍊 2026-04-03 11:56:02 +00:00
573bb75b40 docs: add CLI as recommended usage in Sigil guide — 小橘 🍊 2026-04-03 11:27:35 +00:00
24866be8a9 docs: update Sigil docs for Dynamic Workers LOADER — 小橘 🍊
- Agent guide: replace LRU/子Worker section with Dynamic Workers architecture
- Backend LRU doc: add evolution note, link to Dynamic Workers docs
- Zero DNS latency, single Worker, V8 Isolate sandboxing
2026-04-03 11:17:28 +00:00
caf4d318bf docs: Sigil Agent 实战指南 — 小橘 🍊
- schema + execute 抽象,Agent 只写函数体
- 语义搜索(embedding + MMR)
- 自举模式:Agent 自己创造工具
- 完整 API 参考
2026-04-03 08:56:31 +00:00
88570c9aab feat: Sigil Backend abstraction + LRU scheduling design — 小橘 🍊
- SigilBackend interface: deploy/invoke/remove/list/inspect/status
- WorkerPool (): LRU eviction, fixed hash subdomain, async evict
- Platform (5): dispatch namespace, no LRU needed
- Eviction priority: ephemeral > normal > persistent
- Preheat strategy + async page-out optimization
- Phase 1 MVP checklist
2026-04-03 03:57:41 +00:00
bbf45f21c0 feat: update Sigil wiki with review feedback — 小橘 🍊
Incorporated 小墨's review + 主人's simplification:
- Bindings 声明式传递(最小权限)
- 错误隔离:timeout/熔断/script.limits
- 鉴权:per-Agent token, deploy/invoke 分离
- KV 分层 prefix(code/meta/auth/route/stats)
- 可观测性:Analytics Engine + audit log
- Rate limit 简化:控制 Agent 数 > 令牌桶
- deploy_cooldown + max_agents 代替复杂限流
2026-04-03 01:31:31 +00:00
02c8d7240e feat: add Sigil capability registry architecture — 小橘 🍊
Sigil = Uncaged 的能力虚拟化调度层
- Workers for Platforms 替代 LRU 换页(无限 Worker)
- dispatch Worker 统一入口 + namespace 隔离
- Agent/能力命名规范 + 临时能力 TTL
- 演进路径: Phase 0-4
- 成本对比: Free/Paid/WfP
2026-04-03 01:26:09 +00:00
05b6c7eac1 docs: 更新 Uncaged 能力虚拟化 — 修正配额数据、增加内核态/用户态分层、补充链接 2026-04-03 00:09:41 +00:00