kb init(jiuwenswarm): modules

knowledge/repos/jiuwenswarm/_index.md

@@ -28,3 +28,4 @@ sources: []
 - [JiuwenSwarm 仓库审查规则](rules.md)
 - [每次审查 jiuwenswarm 的 PR 都先读这份通用审查规则；本仓库自己的约束在 rules 页。](../../general/review/rules.md)
 - [PR 新增或修改测试、或 CI 失败时读。先看 tests/ 下已有的用例（如 tests/unit_tests/a2ui/）和 pytest.ini 的约定；TESTING.md 里有过期路径，不能照抄。](../../general/ci/guides/inspect-existing-tests-first.md)
+- [jiuwenswarm components](components/_index.md)

knowledge/repos/jiuwenswarm/_routes.yaml

@@ -201,3 +201,313 @@ owners:
   - README.md
   - README_CN.md
   - .doc_project_maintainer/
+- owner: launch
+  path: repos/jiuwenswarm/components/launch/_index.md
+  signals:
+  - start_services
+  - jiuwenswarm-start
+  - debug launcher
+  - multi-instance
+  - --dotenv
+  - --name
+  - jiuwenswarm-init
+  - init workspace
+  - dotenv_early
+  - SSE patch
+  - ModelArts
+  - compat alias
+  - desktop
+  - 桌面端
+  - desktop app
+  - 窗口
+  - 关闭行为
+  - 最小化到托盘
+  - 全屏
+  - 自动更新
+  scope_prefixes:
+  - jiuwenswarm/acp/
+  - jiuwenswarm/app.py
+  - jiuwenswarm/channels/acp/
+  - jiuwenswarm/cli/
+  - jiuwenswarm/debug_launcher.py
+  - jiuwenswarm/dotenv_early.py
+  - jiuwenswarm/init_workspace.py
+  - jiuwenswarm/llm_provider_compat_patch.py
+  - jiuwenswarm/llm_sse_patch.py
+  - jiuwenswarm/start_services.py
+  - jiuwenswarm/channels/desktop/
+  - jiuwenswarm/instance_manager/
+- owner: gateway-channels-2
+  path: repos/jiuwenswarm/components/gateway-channels/_index.md
+  signals:
+  - cli
+  - chat
+  - 命令行
+  - CLI 频道
+  - gateway client
+  - websocket
+  - tui
+  - renderer
+  - jsonl
+  - spinner
+  - SIGINT
+  - 受信目录
+  - process_cli
+  - process cli
+  - CLI
+  - REPL
+  - slash command
+  - 斜杠命令
+  - one-shot
+  - machine mode
+  scope_prefixes:
+  - jiuwenswarm/channels/cli/
+  - jiuwenswarm/channels/process_cli/
+- owner: common-core
+  path: repos/jiuwenswarm/components/common-core/_index.md
+  signals:
+  - common
+  - config
+  - 配置
+  - 模型选择
+  - model catalog
+  - mode
+  - 工作区
+  - cron
+  - updater
+  - doctor
+  - hooks
+  - kv cache
+  - ACP
+  - acp
+  - stdio
+  - AcpStdioClient
+  - Codex
+  - Codex CLI
+  - acp_agents
+  - JSON-RPC
+  scope_prefixes:
+  - jiuwenswarm/common/_build_config.py
+  - jiuwenswarm/common/chat_final.py
+  - jiuwenswarm/common/cleanup.py
+  - jiuwenswarm/common/client/
+  - jiuwenswarm/common/coding_memory_paths.py
+  - jiuwenswarm/common/config.py
+  - jiuwenswarm/common/context_keys.py
+  - jiuwenswarm/common/context_window.py
+  - jiuwenswarm/common/cron_session.py
+  - jiuwenswarm/common/cron_team_completion.py
+  - jiuwenswarm/common/debug_dump.py
+  - jiuwenswarm/common/external_cli_catalog.py
+  - jiuwenswarm/common/external_cli_runtime.py
+  - jiuwenswarm/common/git_safe_directory.py
+  - jiuwenswarm/common/hooks_config.py
+  - jiuwenswarm/common/kv_cache_affinity_config.py
+  - jiuwenswarm/common/log_preview.py
+  - jiuwenswarm/common/mcp_config.py
+  - jiuwenswarm/common/media_capability_config.py
+  - jiuwenswarm/common/mode_matrix.py
+  - jiuwenswarm/common/model_catalog.py
+  - jiuwenswarm/common/model_config_validation.py
+  - jiuwenswarm/common/model_errors.py
+  - jiuwenswarm/common/model_migration.py
+  - jiuwenswarm/common/model_selection.py
+  - jiuwenswarm/common/model_vendor_registry.py
+  - jiuwenswarm/common/openrouter_attribution.py
+  - jiuwenswarm/common/permission_tools.py
+  - jiuwenswarm/common/playwright_mcp_runtime.py
+  - jiuwenswarm/common/process_supervision.py
+  - jiuwenswarm/common/projectless_workspace.py
+  - jiuwenswarm/common/protocol_ids.py
+  - jiuwenswarm/common/reasoning_config.py
+  - jiuwenswarm/common/reasoning_injector.py
+  - jiuwenswarm/common/runtime_log_filter.py
+  - jiuwenswarm/common/runtime_workspace.py
+  - jiuwenswarm/common/security/
+  - jiuwenswarm/common/session_message.py
+  - jiuwenswarm/common/stage_timer.py
+  - jiuwenswarm/common/startup_diagnostics.py
+  - jiuwenswarm/common/task_loop_config.py
+  - jiuwenswarm/common/team_artifacts.py
+  - jiuwenswarm/common/todo_snapshot.py
+  - jiuwenswarm/common/tool_display.py
+  - jiuwenswarm/common/tool_ownership.py
+  - jiuwenswarm/common/updater.py
+  - jiuwenswarm/common/updater_restart_helper.py
+  - jiuwenswarm/common/upgrade_executor.py
+  - jiuwenswarm/common/utils.py
+  - jiuwenswarm/common/version.py
+  - jiuwenswarm/common/version_source.py
+  - jiuwenswarm/common/work_mode.py
+  - jiuwenswarm/common/ws_diagnostics.py
+  - jiuwenswarm/common/ws_limits.py
+  - jiuwenswarm/common/acp/
+  - jiuwenswarm/common/config_panel/
+  - jiuwenswarm/common/schema/
+- owner: login-auth
+  path: repos/jiuwenswarm/components/login-auth/_index.md
+  signals:
+  - 登录
+  - 华为账号
+  - Account Kit
+  - OAuth
+  - PKCE
+  - id_token
+  - refresh_token
+  - 免费模型
+  - 积分
+  - APIG
+  - 远端配置
+  - auth
+  scope_prefixes:
+  - jiuwenswarm/common/auth/
+- owner: extensions-plugins
+  path: repos/jiuwenswarm/components/extensions-plugins/_index.md
+  signals:
+  - extension
+  - 扩展
+  - plugin
+  - 应用插件
+  - hook
+  - registry
+  - loader
+  - manifest
+  - yuanrong
+  - openYuanRong
+  - clawee
+  - sandbox
+  - agentos
+  - AgentOS router
+  - 沙箱
+  - ssh relay
+  - ephemeral key
+  - third agent
+  - agent manager
+  - stale cleanup
+  scope_prefixes:
+  - jiuwenswarm/extensions/agent_client/
+  - jiuwenswarm/extensions/application_host.py
+  - jiuwenswarm/extensions/callback_compat.py
+  - jiuwenswarm/extensions/clawee.py
+  - jiuwenswarm/extensions/hook_event.py
+  - jiuwenswarm/extensions/hooks_context.py
+  - jiuwenswarm/extensions/loader.py
+  - jiuwenswarm/extensions/manager.py
+  - jiuwenswarm/extensions/registry.py
+  - jiuwenswarm/extensions/sdk/
+  - jiuwenswarm/extensions/types.py
+  - jiuwenswarm/extensions/yuanrong_frontend_client.py
+  - jiuwenswarm/extensions/agentos/
+  - jiuwenswarm/extensions/video_duplex/
+- owner: observability
+  path: repos/jiuwenswarm/components/observability/_index.md
+  signals:
+  - observability
+  - trajectory
+  - 轨迹
+  - OTLP
+  - trace
+  - span
+  - sink
+  - SQLite
+  - retention
+  - 保留
+  - turn
+  - session delete
+  scope_prefixes:
+  - jiuwenswarm/observability/
+- owner: agent-runtime
+  path: repos/jiuwenswarm/components/agent-runtime/_index.md
+  signals:
+  - runtime
+  - AgentRuntime
+  - session create/switch/fork
+  - session.delete
+  - plan mode
+  - model catalog
+  - permission snapshot
+  - MCP reference
+  - push handler
+  - process CLI
+  - agent definition
+  - 运行时
+  - session
+  - 会话
+  - coordinator
+  - execution
+  - cancel
+  - close_session
+  - scheduler
+  - run_stream
+  scope_prefixes:
+  - jiuwenswarm/runtime/agent_definition.py
+  - jiuwenswarm/runtime/context.py
+  - jiuwenswarm/runtime/events.py
+  - jiuwenswarm/runtime/evolution.py
+  - jiuwenswarm/runtime/host_services.py
+  - jiuwenswarm/runtime/interaction.py
+  - jiuwenswarm/runtime/mcp_references.py
+  - jiuwenswarm/runtime/mode_catalog.py
+  - jiuwenswarm/runtime/model_catalog.py
+  - jiuwenswarm/runtime/permission_catalog.py
+  - jiuwenswarm/runtime/plan.py
+  - jiuwenswarm/runtime/request.py
+  - jiuwenswarm/runtime/service.py
+  - jiuwenswarm/runtime/session_catalog.py
+  - jiuwenswarm/runtime/session_delete.py
+  - jiuwenswarm/runtime/session_input.py
+  - jiuwenswarm/runtime/session_lifecycle.py
+  - jiuwenswarm/runtime/session_provisioner.py
+  - jiuwenswarm/runtime/session/
+- owner: cron-scheduling
+  path: repos/jiuwenswarm/components/cron-scheduling/_index.md
+  signals:
+  - cron
+  - 定时任务
+  - cron job
+  - cron 表达式
+  - etcd
+  - 主备
+  - HA
+  - cron store
+  - work_mode
+  - proactive
+  - 钉钉推送
+  - timezone
+  scope_prefixes:
+  - jiuwenswarm/runtime/cron/
+- owner: symphony-orchestration
+  path: repos/jiuwenswarm/components/symphony-orchestration/_index.md
+  signals:
+  - symphony
+  - graph build
+  - 图谱构建
+  - fingerprint
+  - 能力指纹
+  - evolution
+  - 经验演进
+  - experience candidate
+  - recipe
+  - skill taxonomy
+  - skill retrieval
+  - orchestration
+  - 演化
+  - overlay
+  - 动态图谱
+  - dynamic graph
+  - plan outcome
+  - failure attribution
+  - 失败归因
+  - skill packs
+  scope_prefixes:
+  - jiuwenswarm/symphony/adapter.py
+  - jiuwenswarm/symphony/build.py
+  - jiuwenswarm/symphony/config.py
+  - jiuwenswarm/symphony/experience.py
+  - jiuwenswarm/symphony/graph_state.py
+  - jiuwenswarm/symphony/graph_storage.py
+  - jiuwenswarm/symphony/llm.py
+  - jiuwenswarm/symphony/service.py
+  - jiuwenswarm/symphony/skill_retrieval/
+  - jiuwenswarm/symphony/evolution/
+  - jiuwenswarm/symphony/shared/

knowledge/repos/jiuwenswarm/components/_index.md

@@ -0,0 +1,20 @@
+---
+title: "jiuwenswarm components"
+created: 2026-09-30
+updated: 2026-09-30
+type: index
+tags: [jiuwenswarm]
+sources: []
+---
+
+# jiuwenswarm components
+
+- [启动与多实例管理](launch/_index.md)
+- [Gateway 与频道](gateway-channels/_index.md)
+- [公共基础模块与配置](common-core/_index.md)
+- [登录鉴权与免费模型](login-auth/_index.md)
+- [扩展与插件机制](extensions-plugins/_index.md)
+- [可观测性与轨迹存储](observability/_index.md)
+- [Agent 运行时与会话](agent-runtime/_index.md)
+- [定时任务与调度](cron-scheduling/_index.md)
+- [Symphony 编排与能力图谱](symphony-orchestration/_index.md)

knowledge/repos/jiuwenswarm/components/agent-runtime/_index.md

@@ -0,0 +1,22 @@
+---
+title: "Agent 运行时与会话"
+created: 2026-09-30
+updated: 2026-09-30
+type: index
+tags: [jiuwenswarm]
+sources: []
+---
+
+# Agent 运行时与会话
+
+- [共享 Agent Runtime（jiuwenswarm/runtime）](jiuwenswarm-runtime.md)
+- [Runtime Session 协调器（jiuwenswarm/runtime/session/）](jiuwenswarm-runtime-session.md)
+
+## 代码快速入口（Direct）
+<!-- kb-init:quick-map -->
+
+触发词：runtime、AgentRuntime、session create/switch/fork、session.delete、plan mode、model catalog、permission snapshot、MCP reference、push handler、process CLI、agent definition、运行时。PR 描述或改动命中下表一行时，先读该行的规则，再读页面其余部分。
+
+| PR 描述在做什么 | 精确规则 | 第一批 live 源码 |
+|---|---|---|
+| runtime、AgentRuntime、session create/switch/fork、session.delete、plan mode、model… | 入口 | `jiuwenswarm/runtime/agent_definition.py`、`jiuwenswarm/runtime/context.py`、`jiuwenswarm/runtime/events.py` |

knowledge/repos/jiuwenswarm/components/agent-runtime/jiuwenswarm-runtime-session.md

@@ -0,0 +1,31 @@
+---
+title: "Runtime Session 协调器（jiuwenswarm/runtime/session/）"
+created: 2026-09-30
+updated: 2026-09-30
+type: architecture
+tags: [jiuwenswarm]
+sources: []
+---
+
+# Runtime Session 协调器（jiuwenswarm/runtime/session/）
+
+负责产品层 Session 的生命周期和执行协调，包括注册与关闭会话、调度单次（unary）和流式执行、投递 control 请求，以及取消执行及其子执行。另外维护一个有容量上限的执行登记表，记录排队中、运行中和最近结束的执行，并为每个 Session 提供一个工作调度器。
+
+**从哪里开始读**
+
+- `jiuwenswarm/runtime/session/coordinator.py` — RuntimeSessionCoordinator 是对外入口，提供 register_session、run_unary/submit_unary、run_stream、deliver_control、cancel_execution、c
+
+**关键文件**
+
+- `jiuwenswarm/runtime/session/coordinator.py` — 管理会话记录、执行句柄的创建和取消（含子执行和心跳根）、control 请求的认领与转发，以及会话状态刷新
+- `jiuwenswarm/runtime/session/execution_registry.py` — SessionExecutionRegistry 负责执行状态流转（running/awaiting_control/waiting/terminal），终态记录按容量和 TTL 淘汰
+- `jiuwenswarm/runtime/session/work_scheduler.py` — SessionWorkScheduler 为每个 Session 分配一条 lane（按 generation 区分），负责排队执行、取消排队项、关闭时清空队列
+- `jiuwenswarm/runtime/session/model.py` — 共享模型：会话/执行状态枚举、SessionWorkKind、执行句柄与快照、取消和关闭的结果，以及超时和已结束异常
+
+**相关文档**
+
+- `TESTING.md` — 为本模块新增或修改测试时参考。其中部分路径可能已过期，先对照 tests/ 下已有的用例
+
+**改动路由**
+
+- `jiuwenswarm/runtime/session/`