@bolloon/bolloon-agent 0.1.35 → 0.1.36

package/.playwright-mcp/page-2026-06-16T07-51-45-706Z.yml

@@ -0,0 +1,130 @@
+- generic [ref=e2]:
+  - complementary [ref=e3]:
+    - generic [ref=e4]:
+      - button "收起侧边栏" [ref=e5] [cursor=pointer]:
+        - img [ref=e6]
+      - generic [ref=e8]:
+        - generic [ref=e9]: ◈
+        - generic [ref=e10]: Bolloon
+    - generic [ref=e11]:
+      - generic [ref=e13]: 智能体
+      - button "新建智能体" [ref=e14] [cursor=pointer]:
+        - img [ref=e15]
+        - generic [ref=e16]: 新建智能体
+      - list [ref=e17]:
+        - listitem [ref=e18]:
+          - generic [ref=e19] [cursor=pointer]:
+            - img [ref=e20]
+            - generic [ref=e22]: 💬
+            - generic "undefined" [ref=e23]
+            - generic [ref=e24]:
+              - generic "2 个会话" [ref=e25]: "2"
+              - button "配置智能体 (钱包 / 工具)" [ref=e26]:
+                - img [ref=e27]
+              - button "×" [ref=e30]
+          - list
+        - listitem [ref=e31]:
+          - generic [ref=e32] [cursor=pointer]:
+            - img [ref=e33]
+            - generic [ref=e35]: 💬
+            - generic "undefined" [ref=e36]
+            - generic [ref=e37]:
+              - generic "3 个会话" [ref=e38]: "3"
+              - button "配置智能体 (钱包 / 工具)" [ref=e39]:
+                - img [ref=e40]
+              - button "×" [ref=e43]
+        - listitem [ref=e44]:
+          - generic [ref=e45] [cursor=pointer]:
+            - img [ref=e46]
+            - generic [ref=e48]: 💬
+            - generic "undefined" [ref=e49]
+            - generic [ref=e50]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e51]:
+                - img [ref=e52]
+              - button "×" [ref=e55]
+        - listitem [ref=e56]:
+          - generic [ref=e57] [cursor=pointer]:
+            - img [ref=e58]
+            - generic [ref=e60]: 💬
+            - generic "undefined" [ref=e61]
+            - generic [ref=e62]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e63]:
+                - img [ref=e64]
+              - button "×" [ref=e67]
+        - listitem [ref=e68]:
+          - generic [ref=e69] [cursor=pointer]:
+            - img [ref=e70]
+            - generic [ref=e72]: 💬
+            - generic "undefined" [ref=e73]
+            - generic [ref=e74]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e75]:
+                - img [ref=e76]
+              - button "×" [ref=e79]
+        - listitem [ref=e80]:
+          - generic [ref=e81] [cursor=pointer]:
+            - img [ref=e82]
+            - generic [ref=e84]: 💬
+            - generic "undefined" [ref=e85]
+            - generic [ref=e86]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e87]:
+                - img [ref=e88]
+              - button "×" [ref=e91]
+        - listitem [ref=e92]:
+          - generic [ref=e93] [cursor=pointer]:
+            - img [ref=e94]
+            - generic [ref=e96]: 💬
+            - generic "undefined" [ref=e97]
+            - generic [ref=e98]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e99]:
+                - img [ref=e100]
+              - button "×" [ref=e103]
+    - generic "拖动调整上方/下方高度" [ref=e104]
+    - generic [ref=e105]:
+      - generic [ref=e106] [cursor=pointer]:
+        - generic [ref=e107]:
+          - generic [ref=e108]: ▼
+          - generic [ref=e109]: P2P 好友
+        - generic [ref=e110]:
+          - button "⊞ 展开" [ref=e111]
+          - button "我的 ID" [ref=e112]
+          - button "+ 好友" [ref=e113]
+      - list [ref=e114]:
+        - listitem [ref=e115]:
+          - generic [ref=e116] [cursor=pointer]:
+            - button "▾" [ref=e117]
+            - generic [ref=e118]: 👤
+            - generic "undefined" [ref=e119]
+            - generic [ref=e120]: 4 ch · 2026/6/16
+            - button "📤" [ref=e121]
+        - listitem [ref=e122]:
+          - generic [ref=e123] [cursor=pointer]:
+            - button "▾" [ref=e124]
+            - generic [ref=e125]: 👤
+            - generic "undefined" [ref=e126]
+            - generic [ref=e127]: 2026/6/16
+            - button "📤" [ref=e128]
+        - listitem [ref=e129]:
+          - generic [ref=e130] [cursor=pointer]:
+            - button "▾" [ref=e131]
+            - generic [ref=e132]: ❔
+            - generic "undefined" [ref=e133]
+            - generic [ref=e134]: 陌生 peer
+            - button "📤" [ref=e135]
+    - generic [ref=e139]: 已连接
+  - main [ref=e140]:
+    - generic [ref=e141]:
+      - heading "小白" [level=1] [ref=e144]
+      - generic [ref=e145]:
+        - button "切换主题" [ref=e146] [cursor=pointer]:
+          - img [ref=e147]
+        - button "API 配置" [ref=e153] [cursor=pointer]:
+          - img [ref=e154]
+        - button "钱包管理" [ref=e157] [cursor=pointer]:
+          - img [ref=e158]
+        - button "326" [ref=e162] [cursor=pointer]:
+          - img [ref=e163]
+          - generic [ref=e166]: "326"
+    - generic [ref=e170]:
+      - textbox "输入消息..." [ref=e171]
+      - button "发送 (Enter)" [ref=e172] [cursor=pointer]:
+        - img [ref=e173]

package/.playwright-mcp/page-2026-06-16T07-56-44-116Z.yml

@@ -0,0 +1,131 @@
+- generic [ref=e2]:
+  - complementary [ref=e3]:
+    - generic [ref=e4]:
+      - button "收起侧边栏" [ref=e5] [cursor=pointer]:
+        - img [ref=e6]
+      - generic [ref=e8]:
+        - generic [ref=e9]: ◈
+        - generic [ref=e10]: Bolloon
+    - generic [ref=e11]:
+      - generic [ref=e13]: 智能体
+      - button "新建智能体" [ref=e14] [cursor=pointer]:
+        - img [ref=e15]
+        - generic [ref=e16]: 新建智能体
+      - list [ref=e17]:
+        - listitem [ref=e18]:
+          - generic [ref=e19] [cursor=pointer]:
+            - img [ref=e20]
+            - generic [ref=e22]: 💬
+            - generic "undefined" [ref=e23]
+            - generic [ref=e24]:
+              - generic "2 个会话" [ref=e25]: "2"
+              - button "配置智能体 (钱包 / 工具)" [ref=e26]:
+                - img [ref=e27]
+              - button "×" [ref=e30]
+          - list
+        - listitem [ref=e31]:
+          - generic [ref=e32] [cursor=pointer]:
+            - img [ref=e33]
+            - generic [ref=e35]: 💬
+            - generic "undefined" [ref=e36]
+            - generic [ref=e37]:
+              - generic "3 个会话" [ref=e38]: "3"
+              - button "配置智能体 (钱包 / 工具)" [ref=e39]:
+                - img [ref=e40]
+              - button "×" [ref=e43]
+        - listitem [ref=e44]:
+          - generic [ref=e45] [cursor=pointer]:
+            - img [ref=e46]
+            - generic [ref=e48]: 💬
+            - generic "undefined" [ref=e49]
+            - generic [ref=e50]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e51]:
+                - img [ref=e52]
+              - button "×" [ref=e55]
+        - listitem [ref=e56]:
+          - generic [ref=e57] [cursor=pointer]:
+            - img [ref=e58]
+            - generic [ref=e60]: 💬
+            - generic "undefined" [ref=e61]
+            - generic [ref=e62]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e63]:
+                - img [ref=e64]
+              - button "×" [ref=e67]
+        - listitem [ref=e68]:
+          - generic [ref=e69] [cursor=pointer]:
+            - img [ref=e70]
+            - generic [ref=e72]: 💬
+            - generic "undefined" [ref=e73]
+            - generic [ref=e74]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e75]:
+                - img [ref=e76]
+              - button "×" [ref=e79]
+        - listitem [ref=e80]:
+          - generic [ref=e81] [cursor=pointer]:
+            - img [ref=e82]
+            - generic [ref=e84]: 💬
+            - generic "undefined" [ref=e85]
+            - generic [ref=e86]:
+              - generic "3 个会话" [ref=e87]: "3"
+              - button "配置智能体 (钱包 / 工具)" [ref=e88]:
+                - img [ref=e89]
+              - button "×" [ref=e92]
+        - listitem [ref=e93]:
+          - generic [ref=e94] [cursor=pointer]:
+            - img [ref=e95]
+            - generic [ref=e97]: 💬
+            - generic "undefined" [ref=e98]
+            - generic [ref=e99]:
+              - button "配置智能体 (钱包 / 工具)" [ref=e100]:
+                - img [ref=e101]
+              - button "×" [ref=e104]
+    - generic "拖动调整上方/下方高度" [ref=e105]
+    - generic [ref=e106]:
+      - generic [ref=e107] [cursor=pointer]:
+        - generic [ref=e108]:
+          - generic [ref=e109]: ▼
+          - generic [ref=e110]: P2P 好友
+        - generic [ref=e111]:
+          - button "⊞ 展开" [ref=e112]
+          - button "我的 ID" [ref=e113]
+          - button "+ 好友" [ref=e114]
+      - list [ref=e115]:
+        - listitem [ref=e116]:
+          - generic [ref=e117] [cursor=pointer]:
+            - button "▾" [ref=e118]
+            - generic [ref=e119]: 👤
+            - generic "undefined" [ref=e120]
+            - generic [ref=e121]: 4 ch · 2026/6/16
+            - button "📤" [ref=e122]
+        - listitem [ref=e123]:
+          - generic [ref=e124] [cursor=pointer]:
+            - button "▾" [ref=e125]
+            - generic [ref=e126]: 👤
+            - generic "undefined" [ref=e127]
+            - generic [ref=e128]: 2026/6/16
+            - button "📤" [ref=e129]
+        - listitem [ref=e130]:
+          - generic [ref=e131] [cursor=pointer]:
+            - button "▾" [ref=e132]
+            - generic [ref=e133]: ❔
+            - generic "undefined" [ref=e134]
+            - generic [ref=e135]: 陌生 peer
+            - button "📤" [ref=e136]
+    - generic [ref=e140]: 已连接
+  - main [ref=e141]:
+    - generic [ref=e142]:
+      - heading "小白" [level=1] [ref=e145]
+      - generic [ref=e146]:
+        - button "切换主题" [ref=e147] [cursor=pointer]:
+          - img [ref=e148]
+        - button "API 配置" [ref=e154] [cursor=pointer]:
+          - img [ref=e155]
+        - button "钱包管理" [ref=e158] [cursor=pointer]:
+          - img [ref=e159]
+        - button "326" [ref=e163] [cursor=pointer]:
+          - img [ref=e164]
+          - generic [ref=e167]: "326"
+    - generic [ref=e171]:
+      - textbox "输入消息..." [ref=e172]
+      - button "发送 (Enter)" [ref=e173] [cursor=pointer]:
+        - img [ref=e174]

package/Bolloon.md

@@ -26,14 +26,18 @@
 
 | 路径 | 职责 |
 |---|---|
-| `src/agents/pi-sdk.ts` | PiAgent 主类 / ReAct 循环 / 工具注册 / SessionStart/Stop hook 接入点 |
+| `src/agents/pi-sdk.ts` | PiAgent 主类 / ReAct 循环 / 工具注册 / SessionStart/Stop/PreToolUse hook 接入点 |
+| `src/agents/permission-mode.ts` | **本轮新增** — 3 种 permission mode (default/acceptEdits/bypassPermissions) + 解析 |
+| `src/agents/pre-tool-validator.ts` | **本轮新增** — PreToolUse 4 步链式校验 (modeGate/blacklist/shell-guard/schema) |
 | `src/pi-ecosystem-judgment/` | **判断力系统核心**：注入门 / 蒸馏 / 演化 / 自适应扫描 / 监控门 |
+| `src/context-compaction/` | **本轮新增** — 5 层上下文压缩流水线 (Budget Reduction / Snip / Microcompact / Context Collapse / Auto-Compact) |
+| `src/bootstrap/context-hierarchy.ts` | **本轮新增** — Bolloon.md 4 级层次 (Managed / User / Project / Local) |
 | `src/web/server.ts` | Web server 主入口 (port 54188), 所有 REST API |
 | `src/web/client.js` | 前端 (timeline panel, 反向引用链接, 自适应 tab) |
 | `src/network/` | P2P 网络层 (iroh-bootstrap, p2p-direct) |
 | `src/constraint-runtime/` | Workflow / 技能注册 / 会话持久化 |
 | `src/social/` | 全局共享上下文 / 智能体心跳 / 协作任务 |
-| `src/bootstrap/` | **本轮新增** — 启动上下文收集 / SessionStart/Stop/cron 入口 |
+| `src/bootstrap/` | 启动上下文收集 / SessionStart/Stop/cron 入口 |
 | `~/.bolloon/` | 用户数据目录 (本机资产, 不进 git) |
 
 ## 关键设计意图
@@ -80,7 +84,7 @@ AI 回复下方挂极简 `📎 参考 N 条原则` 链接（不展开内嵌）
 - `human-values/usage.jsonl` — 注入门使用记录
 - `human-values/violations.jsonl` — 监控门违规记录
 - `human-values/evolution.jsonl` — 类 B 自适应演化日志
-- `persona.json` — 主人身份
+- `persona.json` — 用户身份
 - `sessions/<channel>/` — 每个 channel 的会话持久化
 - `skills/` — 用户级 skills (与 .bolloon/skills/ 项目级并存)
 
@@ -97,7 +101,44 @@ AI 回复下方挂极简 `📎 参考 N 条原则` 链接（不展开内嵌）
 
 - **类 B 自适应**每天 0:00 跑 1 次，重启 bolloon 期间不补跑
 - **Context 缓存 24h**——中途改 Bolloon.md / persona / git commit 后, 重启才生效
-- **PreToolUse hook 还没接**——agent 仍能调 `rm -rf`（已有 shell-guard 基础, hook 形式未接）
+- **PreToolUse 4 步链已接** — `onPreToolUse` 串接 modeGate + blacklist + shell-guard + schema;
+  shell 工具永远走 shell-guard, bypassPermissions 仍受路径黑名单约束
+- **5 层压缩**: 同步层 (Budget Reduction / Snip / Microcompact) 在 `buildContext` 跑;
+  异步层 (Context Collapse / Auto-Compact) feature flag 默认关闭, 后续接 LLM 后启用
+- **Bolloon.md 4 级层次** — 同时识别 Managed / User / Project / Local, 兼容旧 Bolloon.md;
+  按 `managed → user → project → local` 顺序拼接到 system prompt, 截断优先保 managed
 - **Stop hook 写 session 摘要**——不重复写完整 session 持久化（已存在）
 - **跨 channel Context**——目前不分 channel, 单 channel 维度
 - **embedding 检索**——上轮做了软相似度 (bigram) 兜底, 真 embedding 等 5k+ 条库再做
+
+## 3 个吸收自 Claude Code 的子系统 (本轮新增)
+
+### 5 层上下文压缩 (src/context-compaction/)
+严格对齐论文 5 个 shaper, 由便宜到重:
+1. **Budget Reduction** (总是跑) — 截断 > 4000 字符的单条消息
+2. **Snip** (`BOLLOON_SNIP_ENABLED=1` 开启) — 裁掉老 history, 保留最近 20 对
+3. **Microcompact** (总是跑) — 折叠老 tool_result, 保留最近 3 条完整
+4. **Context Collapse** (`BOLLOON_CONTEXT_COLLAPSE=1` 开启) — 读时虚拟投影, 折叠前 5 对
+5. **Auto-Compact** (兜底) — LLM 摘要, 缓存到 `~/.bolloon/sessions/compaction-cache/`
+
+**关键不变量**: 第 1-3 层不破坏 messageHistory 内存结构, 第 4 层读时投影, 第 5 层破坏性.
+
+### Bolloon.md 4 级层次 (src/bootstrap/context-hierarchy.ts)
+| 优先级 | 路径 | 用途 |
+|---|---|---|
+| 1 | `/etc/bolloon/Bolloon.md` | Managed (企业 IT 部署预留) |
+| 2 | `~/.bolloon/Bolloon.md` | User (用户级, 跨项目) |
+| 3 | `<cwd>/Bolloon.md` (兼容 Bolloon.md / `.claude/rules/*.md`) | Project (项目级) |
+| 4 | `<cwd>/CLAUDE.local.md` | Local (个人覆盖, .gitignore) |
+
+按 `managed → user → project → local` 顺序拼接到 system prompt 顶部, 截断时反向砍,
+**优先保 managed** (bolloon 自身约束).
+
+### PreToolUse + 权限模式 (src/agents/permission-mode.ts + pre-tool-validator.ts)
+3 种 mode: `default` (默认) / `acceptEdits` (跳过 edit_* 黑名单) / `bypassPermissions` (跳过非 shell 黑名单).
+
+4 步链: `modeGate → blacklistGate (6 模式危险命令) → shellGuardGate (路径黑名单) → schemaGate (stub)`.
+
+**关键约束**: shell 工具永远走 shell-guard, bypassPermissions 仍受 `.bolloon/` / `pi-sdk.ts` / `shell-guard.ts` / `.env` 路径黑名单保护.
+
+环境变量: `BOLLOON_PERM_MODE=default|acceptEdits|bypassPermissions` (运行时切换).

package/Dive-into/CITATION.cff

@@ -0,0 +1,17 @@
+cff-version: 1.2.0
+message: "If you use this work, please cite it as below."
+title: "Dive into Claude Code: The Design Space of Today's AI Agent System"
+# TODO: Update authors
+authors:
+  - name: "To be updated"
+date-released: 2026-04-11
+url: "https://github.com/VILA-Lab/Dive-into-Claude-Code"
+license: CC-BY-NC-SA-4.0
+preferred-citation:
+  type: article
+  title: "Dive into Claude Code: The Design Space of Today's AI Agent System"
+  # TODO: Update authors
+  authors:
+    - name: "To be updated"
+  year: 2026
+  url: "https://arxiv.org/abs/2604.14228"

package/Dive-into/LICENSE

@@ -0,0 +1,25 @@
+Attribution-NonCommercial-ShareAlike 4.0 International
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+For the full license text, please see:
+https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode