织林网络 kazari-qwp/Nexarbor

织林 · Nexarbor

把想法连成网络，把网络变成应用。

织林是一个可视化的通用智能体应用开发平台：把智能体、数据、工具和模块拖进同一张画布，通过连接与参数组装应用；也可以直接用自然语言许愿，让制作智能体帮你搭网络、造组件、测试和迭代。

织林工作台：NPC 小镇的居民、地点、道路与能力装配

NPC 小镇工作台实拍：画布按道路频道展示居民与地点，右侧直接查看选中角色的能力。

你为什么会需要这个终端？

当一个应用拥有多个智能体、持续积累的数据和不断增加的能力，清晰的结构，就是继续扩展它的底气。织林把这些关系放到你看得见、改得动的地方。

- 结构一目了然：节点表达对象，连接表达访问关系，模块表达能力。谁能访问什么、能力装在哪里，都有明确的位置；选中一个局部，就能查看配置、追踪依赖，带着问题咨询智能体。
- 能力留在局部组件里：移动、消息、记录、上下文组装各司其职。通过参数与连接组合行为，一个好组件可以服务多个节点、多个网络和多个项目。
- 把耦合挡在架构边界之外：应用规则由组件实现，核心负责通用机制，通信层承接协议，前端负责交互。组件通过声明的依赖与统一的 ctx 接口协作，模型执行器通过适配器接入，让界面、宿主与业务能够分别演进。
- 成果可以持续积累：一个调好的节点、一组协作成员，甚至整个应用，都能成为下次拖入画布的零件。项目保存在自己的文件夹里，版本交给真实 Git 管理，修改有历史，探索有分支。

一套框架，搭出完全不同的应用

从讨论小组、去中心化协作团队，到知识归档系统，再到拥有地点、道路、交易与私人记忆的 NPC 小镇，改变组件、参数和连接方式，就能组织出不同的应用形态。

织林的泛用性来自可组合的能力：同一个记录模块可以管理任务、物品或业务数据；同一个上下文组装器可以服务角色、研究助手或协作成员；同一套网络既能独立运行，也能作为零件装进更大的网络。亚节点进一步把专用能力和连线收进局部，复杂应用也能保有清楚的结构。

优先配置，充分复用，按需扩展。 组件的前端负责把通用能力变成具体效果；真正缺少能力时，再制作新组件。你的组件库和网络预设，会随着每一次搭建变得更有价值。

核心机制：让连接决定行为

节点装配模块，模块提供行为，也可以向智能体提供工具。 能力放在各自的局部，模块之间通过网络协作；调整连接、频道和参数，就能改变应用的行为与访问范围。

类似神经网络的强度传播

连接带有频道、阈值和倍率，节点带有偏置。传播时，连接先检查频道是否匹配、当前强度是否达到阈值；通过后乘以这条边的倍率，接收节点汇总输入后再加上自己的偏置。节点默认求和，也可选择最大值、最小值或平均值。

信号传播示意：频道筛选、阈值阻挡、倍率、节点偏置与同层输入汇总

图中，A 以 tick 频道发出强度 4：B 得到 4 × 1.5 + 1 = 7，C 得到 4 × 0.5 + 2 = 4；D 的入口阈值为 5，因此被阻挡，F 则因频道不匹配而未激活。下一层 E 汇总两路输入，得到 7 × 0.5 + 4 × 2 − 0.5 = 11。

信号采用广度优先、逐层推进、同层异步并行的方式传播。例如 B、C 可以同时响应，再由下一层的 E 汇总输入；后续传播会沿当时的网络拓扑继续进行。信号发出后独立传播，不等待返回结果；调用则由模块显式发起，并将处理结果返回调用者。

频道与拓扑也是程序的一部分

模块通过自己的访问强度和指定频道，取得可达的节点对象列表，再读取这些节点的数据、工具和模块，或调用其操作。列表遵循广度优先顺序，遍历到的对象可以直接使用，无需逐个重新寻路。通过调节网络参数，可以改变模块或信号在某一强度下的访问范围。

上下文组装器就是一个例子：沿 system_prompt 对应频道收集规则和角色设定，沿 inputs 对应频道收集新请求和消息，分别放进系统提示词与新输入。对应频道可达的文本无条件加入；同层文本先于更深层文本，因此可以通过并联和串联文本节点控制内容与顺序。需要动态改变上下文时，调整连接即可。

许愿式编程：说出你想实现的效果

“我想在当前网络里增加一个共享任务板，让这几个成员认领任务，完成后自动记录结果。”

“这个角色为什么需要这个模块？保留现有行为，帮我调整它的参数。”

你可以围绕整个当前网络、选中的节点与连接，或者一个具体模块直接提出需求。网络制作智能体负责组织网络，组件／模块制作智能体负责补齐能力；网络制作可以委托组件制作。咨询和制作共用对话历史，默认继续上次对话，需要时显式新建。

制作过程带着真实环境展开：读取当前网络与选中内容，查阅组件接口和教程，优先复用现有能力，在工作副本中修改，再用当前网络的独立副本测试。对话、源码、验证结果和修改历史都留在工作台里，方便检查与继续迭代。

从“我想实现什么”开始，把搭建、编程与验证连成一条工作流。 你既能亲手拖拽和调参，也能让智能体接手其中的制作步骤。

灵感：让网络定义行动空间

随着模型的推理、规划与工具使用能力增强，智能体能承担更多自主决策。织林由此出发：用图表达信息访问、能力连接与协作边界，让智能体在明确的行动空间里自主选择、组织协作。

像搭积木一样操作

- 搭建网络：拖入节点、工具、模块和网络预设，编辑连接与频道；完整网络也可以作为零件加入另一张网络。
- 配置与复用：模块提供配置表单或自己的前端页面。节点、模块、工具、Skill 和子网都能保存为书签；历史保留独立快照，按配置去重并把最近使用的条目置前。
- 为智能体装配 Skill：工具和 Skills 分栏展示，拖入时递归安装声明的工具、模块与 Skill 依赖。基础概念、网络查看、网络制作、组件制作分成四个入口，详细文档按需读取。
- 整理项目资源：左侧资源栏采用文件夹与路径导航，支持分类、多选、剪切、拖动、归档和恢复；虚拟分类不改变组件本身的存储结构。
- 观察和运行：按频道、类型和模块筛选画布，选择层级或稠密整理；高对比度连线帮助区分频道。查看节点的模块、工具与数据，进入智能体对话，运行脉冲，预览上下文来源，并在对应节点查看缺失模块等错误。
- 借助智能体制作与咨询：围绕当前网络或选中部分提出需求、询问模块用途，建立修改副本，在独立网络副本中验证，再决定是否采用。
- 保存项目版本：在项目文件夹中使用真实 Git，通过 Commit 保存网络、资源和 Agent 上下文位置；支持导入、另存为及版本分支。

左右侧栏可以折叠、调整宽度。代码区按需展开，资源和较重的界面按需加载；切换网络时，加载状态限制在画布区域。

鼠标手势与快捷键

以下为默认操作，可在设置中自定义：

| 操作 | 手势或快捷键 |
| 装配与复用 | 从左侧栏拖入节点或网络预设；把模块、工具、Skill 拖到节点上，递归装配所需依赖。 |
| 查看与移动 | 单击节点或连线，在右侧修改属性；左键拖动节点；双击 Agent 节点打开对话。 |
| 建立连接 | 按住鼠标右键，从起点节点拖到终点节点；右键单击则打开操作菜单。 |
| 多选与扩展选区 | 按住 Shift 点选或框选；Shift＋滚轮向上扩展、向下收缩网络选区。 |
| 加入书签 | 选中节点、连线或子网后按 A，只保存内部连接；按 B，同时保留与外部对象的连接。右键菜单也提供这两种方式。 |
| 复用连线书签 | 将连线书签拖到起点节点，再左键点击终点完成连接；按 Esc 取消。 |
| 管理书签 | 悬停书签时按 A 或 B 删除，按鼠标中键重命名；悬停节点或网络书签时按 S 保存为对应预设。书签与历史可按类型筛选、拖回复用。 |
| 编辑与保存 | Delete 删除选中元素；Ctrl＋Z 撤销；Ctrl＋Y 重做；Ctrl＋S 通过 Git 提交保存当前编辑。 |
| 对话发送 | Ctrl＋Enter 发送，支持粘贴图片、添加文件附件和输入文件地址。 |

咨询与制作 Agent 的入口

- 顶部 Agent 菜单：打开网络 Agent 或模块／工具 Agent。网络 Agent 负责组织网络，模块／工具 Agent 负责制作与修改组件。
- 左侧资源栏：直接选择制作新模块、新工具或网络预设；右键已有模块、工具或预设，可以围绕它咨询，或建立修改分支。
- 画布与右侧属性栏：右键节点或选区，选择“咨询 Agent”，让网络 Agent 结合当前对象讲解和修改；右侧属性栏中的模块、工具也支持右键咨询。

咨询窗口和制作工作室是同一套功能的不同入口，共用对话历史，默认继续上次会话；只有显式点击“新对话”才另开一段。也可以直接要求修改，由 Agent 在工作副本中继续完成。

详细使用方式见 工作台指南。

节点、模块与连接

| 概念 | 职责 |
| 节点 | 网络中的独立对象，可以是 Agent、普通节点、文本、数据或脉冲；拥有自己的配置与装配内容。 |
| 亚节点 | 挂在节点或另一亚节点上的小容器，拥有独立的模块、工具和出边表，没有独立的数据存储与散度。 |
| 模块 | 通过统一的 ctx 接口实现行为，声明操作、配置、状态、依赖及可选的前端页面。 |
| 工具 | 提供给 Agent 使用的能力入口，可以由模块携带；拖入时自动补齐实现模块及依赖，已有装配会去重。 |
| 连接 | 从一个对象到另一个对象的定向接口，按频道、门槛、倍率及访问强度决定可达范围。 |
| 网络预设 | 保存为文件的可复用网络结构，包含配置与关联数据；可声明一个重复单元及其数量。 |

网络不要求保留根节点，也可以为空。节点上的模块默认访问强度与具体模块的授权分别配置；模块可以覆盖节点提供的默认值。

亚节点在画布上显示为更小的矩形，归属关系用无箭头虚线表示。虚线不是业务连接，不单独占用寻路步数。父对象可以本地调用亚节点的模块；两边的模块表和工具表保持独立。是否借用父对象出边、是否向父对象开放自己的出边，由两个开关分别控制，嵌套时逐层生效。

普通访问与信号传播共用频道和强度规则。独立访问可以并行，信号按广度逐层传播、同层异步并行，按当前拓扑继续扩散；节点可选择求和、最大值、最小值或平均值汇总输入。节点锁用于确实需要隐藏中间状态的原子修改，不用来包住整个 Agent 活动或普通消息收发。

模块通过 ctx.network.nodes() 一次取得指定频道可达的广度优先节点对象表，随后直接读取对象的工具、模块和数据，或调用其操作；无需在循环中逐节点重新寻路。工具收集器和上下文组装器均使用这套接口。

参见 模块与访问协议、亚节点与独立出边。

看得见、能配置的上下文

通用上下文组装器将来源分成四类：

| 输入 | 用途 |
| system_prompt | 当前系统指令快照，例如职责和行为规则。 |
| context | 需要进入上下文的资料，按稳定来源和正文变化更新。 |
| inputs | 带稳定事件编号的一次性输入，避免重复投递。 |
| tail | 每次请求重新读取的当前状态快照，例如时间文本。 |

来源可以是直接文本、文本路径，或按指定频道连接的文本节点。对应频道可达的文本无条件加入，顺序遵循广度遍历；通过拓扑控制内容与顺序。组装器可以串联、合并和去重；工作台预览会显示来源、匹配情况和错误，不消费一次性事件。

组装器可以直接装在角色上，也可以装在亚节点上，通过显式准备入口供角色本地调用。时钟、记忆、地点查询各自提供能力；时间显示由普通文本与配置表达，不需要把整套应用规则写进一个角色模块。

参见 上下文组装说明与设计案例。

0.9 运行包

完整解压后运行 Nexarbor.exe，在首页或“设置 → DeepSeek Harness 路径…”中选择本机 Harness。默认上下文 600k、最大输出 50k，直接修改 configs/agent-defaults.json 即可；项目和节点的独立参数优先。

运行包与源码均包含 项目演示/：讨论协作、资料库、小镇各自的初始和最终状态，共六个项目。最终状态保留实际结果、业务数据和会话分块。使用方法见 演示说明 和 0.9 更新说明。

可直接打开的项目

以下项目随当前主分支源码提供；已发布压缩包的内容以对应 Release 为准。

| 项目 | 展示内容 |
| 预设组网与协作 | 初始只有根智能体和管理员；用讨论、执行两个可调人数预设组网，再运行 CSV 转 JSON 项目。 |
| 讨论与协作参考 | 已组装的讨论小组、Git 协作组、任务板与候选验收。 |
| 知识归档与恢复 | 从空知识库开始，按集合建立 CSV、SQLite、RAG、Wiki 独立节点，支持来源、版本、增量和结构化访问；可配置本地向量检索。 |
| 智能体重建小镇 | 居民、道路、时间、并行活动、移动、交易与家庭。 |
| 小镇标准样板 | 新版初始状态，59 个节点、19 个项目内模块；打包流程内置此案例，配合技能按需学习源码和拓扑。 |

复制项目文件夹到自己的工作位置，在客户端打开其中的 nexarbor.json 所在文件夹。首次打开自动初始化 Git 和 打开项目.cmd；配置自己的模型连接后即可运行。项目内包含业务模块、工具声明、文本和预设，不携带 API key 或旧运行会话。

讨论组和执行组各有一个人数参数：在预设右侧填写重复成员数后拖入。制作智能体也能通过 catalog_presets、instantiate_preset 完成相同操作。实例化重新分配节点编号和数据路径，公共资源保留一份。参见 预设数量参数。configs/ 中的示例入口指向这些普通项目。

三项功能兼容性实测已完成，均使用 DeepSeek Flash：

- 讨论与协作：根智能体委托管理员通过两个预设组网，运行 CSV 转 JSON 项目，历史 18 项独立测试全部通过；协作成员对同一候选全员同意后提交。
- 知识归档：完成归档、查询、增量、历史版本、重启恢复及语义检索后沿 Wiki 链接访问原文；归档收尾经过两次额外反馈，最终待处理入库项清零。向量检索实测配置了本地 BGE 模型，源码项目需自行配置模型目录。
- NPC 小镇：从初始状态完成五天、25 个时刻及重启恢复，开场事件未重复投递。

这些结果验证了上述应用流程与恢复能力，不代表任意任务都能一次许愿完成。完整测试记录、时间轴、日志和临时产物保留在本地，不随源码上传。

一个文件夹，一个 Git 项目

没有打开项目时，客户端提供“打开项目文件夹”和“新建项目文件夹”。新建会初始化 Git、项目清单、资源目录及 打开项目.cmd。之后可直接从该文件夹启动客户端。

项目文件夹/ ├─ nexarbor.json 项目清单 ├─ 打开项目.cmd 启动当前项目 ├─ context/ 项目文本资料 ├─ modules/ 当前项目的模块源码 ├─ tools/ 当前项目的工具声明 ├─ node_presets/ 保存的节点模板 ├─ network_presets/ │ ├─ fragments/ 零件网络预设 │ └─ networks/ 已存储的完整网络 ├─ networks/ 网络清单及按版本保存的节点、数据快照 ├─ nodes/ 初始节点定义（也可由 networks/ 内快照携带） ├─ network-resources/ 网络携带的文本等资源 ├─ data/ 项目的初始数据，按需创建 ├─ workspace/ 应用自己的资料、知识库与产物，按需创建 └─ .nexarbor/ ├─ contexts/ 可携带、可纳入 Git 的智能体会话分块 └─ runs/ 本机运行状态与缓存，由客户端自动维护

运行时从项目文件夹读取资源。资源库中的模块或工具需要下载到项目后使用，因此项目可以保留自己的实现版本。

客户端的几个操作分别负责：

- Commit：通过 Git 保存项目版本，包含网络、资源和智能体上下文的日志位置。未变化的内容由 Git 复用。
- 校验并更新网络：检查当前编辑内容，并将其更新到运行网络。
- 另存为 / 导入：导出或恢复完整网络及可携带的上下文；修改后继续运行时可以建立上下文分支。

运行中的网络状态会自动持久化，重新打开项目继续当前状态；Commit 另外保存可回溯的 Git 版本。退出时的工作页面会恢复。复制节点或子网会保留应有的配置和独立数据，重新映射内部连接；保留外联的复制方式仍指向原有外部对象。复制智能体不继承原会话上下文。

安装与启动

运行要求：Windows x64、Git for Windows、已安装的 DeepSeek Harness。可使用 Harness 账户授权或自行配置 API key；不同智能体可独立选择连接和模型。智能体执行统一使用 Harness 原生运行时，当前适配已实测 Harness 0.2.1。

从 Release 页面 下载 Windows x64 运行包，完整解压后双击 Nexarbor.exe。运行包内置 Electron、Python 与基础依赖，启动后即可新建或打开项目文件夹。首次安装与演示项目的具体操作见本文末尾的 Release 安装与演示上手。

模块、工具从资源库下载到当前项目后装配，递归依赖自动补齐。点击“校验并更新网络”使编辑生效，点击 Commit 保存版本。向量检索与本地模型依赖按需安装。

详细要求、Harness 授权位置、资源装配和源码构建见 安装与装配指南。

项目结构

仓库目录按运行机制、界面、组件和应用分开：

Nexarbor/
├─ frontends/
│ ├─ desktop/ Electron 桌面入口、项目选择、Harness 路径设置 │ └─ network-editor/ 网络画布、资源栏、对话和制作界面 ├─ python/datanet/ │ ├─ core/ 图、频道访问、信号、模块调用、事务与持久化 │ ├─ communication/ Python 侧请求协议与通信处理 │ └─ components/ 组件装配的 Python 支持 ├─ communication/ 浏览器请求、HTTP 服务与模块前端桥 ├─ adapters/harness/ │ ├─ framework/ 宿主装配、工具与上下文适配、Harness 配置 │ ├─ runtime/ Harness 侧 Agent 循环及运行资源 │ └─ studio/ 工作台后端、项目管理与两个制作 Agent ├─ extensions/ 通用模块、工具、Skill 与组件前端 ├─ shared/graph/ 网络格式、预设展开与资源装配的公共逻辑 ├─ configs/ │ └─ agent-defaults.json Agent 默认上下文 600k、最大输出 50k ├─ projects/ 可继续制作的应用项目与网络预设 ├─ resources/examples/ │ └─ npc-town/ 随包内置、供 Agent 按需学习的小镇初始样板 ├─ 项目演示/ 三个应用各自的初始／最终状态，共六个项目 ├─ docs/ 安装、架构、模块协议与使用说明 ├─ scripts/ 组件维护、样板校验和运行包构建脚本 ├─ package.json 源码启动、构建与打包入口 ├─ README.md 中文说明 └─ README_EN.md 英文说明

extensions/ 提供通用零件，应用业务实现在各项目的 modules/ 中。projects/ 用于继续搭建和开发；项目演示/ 用于从固定初始状态体验流程，或查看完成后的结果；resources/examples/npc-town/ 是两个制作 Agent 按需研究的内置教材。

发布压缩包在上述运行资源之外，还包含 Nexarbor.exe、Electron 资源、runtime/python/ 和构建后的界面。源码开发与打包步骤见 安装指南，运行包内的 项目演示/ 和 configs/agent-defaults.json 可直接找到。

当前开发源码采用 v8 网络格式与 v3 模块协议。Python 命名空间与 Harness 适配器的内部标识沿用 datanet / datanet-harness；安装和运行入口是 Nexarbor 桌面工作台。

| 层 | 主要目录 | 职责 |
| 核心层 | python/datanet/core/ | 图、归属、访问、信号、事务、模块、输入契约、预设展开与持久化。 |
| 通信层 | python/datanet/communication/、communication/ | 双向 JSON-RPC、HTTP、浏览器请求与模块页面桥。 |
| 前端层 | frontends/network-editor/、frontends/desktop/ | 画布、资源管理、工作台、制作界面和桌面窗口。 |

adapters/harness/ 负责具体宿主的装配与适配；extensions/ 保存框架通用组件，projects/*/modules/ 保存各应用自己的能力；shared/ 放不依赖宿主或界面的公共格式契约。

核心不导入前端或 Harness 实现。通信通过处理函数和端口连接宿主服务，前端通过请求接口使用能力。本地回归检查这些分层边界和通信行为。

参见 架构与阅读入口、组件装配。

验证与进一步阅读

验证覆盖核心权限、信号并行、节点事务、模块依赖、独立存储、上下文装配、Git 项目与客户端交互。本轮还修复了节点会话发送后黑屏、工具停用通知反复列出 UUID，以及整理后切换频道未重新规划连线的问题。框架测试源码、开发实测日志和阶段报告保留在本地开发目录，通过 .gitignore 排除；演示应用自身产出的代码、业务数据与会话作为项目结果保留。发布包包含运行资源、六个演示项目与必要使用文档。

| 想了解的内容 | 文档 |
| 使用桌面工作台 | 客户端指南 |
| 理解核心与三层边界 | 架构说明 |
| 编写模块、调用 ctx | 模块协议 |
| 使用亚节点与私有出边 | 亚节点说明 |
| 组件制作、验证与发布 | 组件工作室 |
| 配置上下文来源 | 上下文组装案例 |
| 配置预设的重复数量 | 预设参数 |

欢迎围绕通用组件、网络预设、编辑体验和核心机制提交 Issue 或 Pull Request。新功能优先考虑能否复用现有组件，通过配置解决；业务逻辑放在组件内，宿主细节留在适配器中。

Release 安装与演示上手

1. 准备运行环境

- Windows x64，以及一个有写入权限的解压目录。
- 安装 Git for Windows，安装时允许从命令行使用 Git。安装后新开终端，执行 git --version 能显示版本即可。
- 安装 DeepSeek Harness，使用 0.2.1 或更新的兼容版本，当前已实测 0.2.1。运行智能体前，需要在 Harness 中完成账户授权，或在 Nexarbor 中配置自己的模型 API 连接；模型调用需要联网，并使用你自己的账户额度或 API 费用。

运行包已经包含 Electron、Python 和基础依赖，无需另外安装 Node.js 或 Python。本地向量检索所需的嵌入模型和可选依赖需另行准备，详见 安装指南。

2. 下载、解压和连接 Harness

1. 打开 GitHub Releases，下载版本对应的 Nexarbor-版本号-win-x64.zip 运行包；例如 0.9.1。请选择 Assets 中的运行包，GitHub 自动生成的 Source code 是源码。
2. 完整解压整个压缩包，保留 Nexarbor.exe、runtime/、configs/ 和 项目演示/ 等目录的相对位置，再双击解压后的 Nexarbor.exe。
3. 在首页点击“选择 DeepSeek Harness 路径…”，或通过“设置 → DeepSeek Harness 路径…”选择本机的 DeepSeek Harness.exe，保存后重新打开项目。该路径保存在本机，更换电脑后选择那台电脑上的安装位置即可。
4. 使用已授权的 Harness 账户，或进入“设置 → 模型与 API”配置模型连接。节点和两个辅助智能体也可以在各自的“模型”页选择连接；API key 不随演示项目分发，更换电脑后需要重新配置。

默认上下文窗口为 600k、最大输出为 50k。需要调整时，用文本编辑器修改解压目录中的 configs/agent-defaults.json，再重新打开项目；项目或节点的独立配置优先，实际可用容量以所选模型为准。

从 0.9.2 起，咨询、制作和网络内智能体不再按模型请求次数自动截断，也不再受运行器启动后的累计请求数／存活时间限制。 单次执行及相关信号、脉冲和模块调用链的等待放宽至 24 小时；旧项目中更小的执行预算在运行时同样放宽。仍可手动停止任务。上下文容量和单次输出长度是独立设置，保持上述默认值。

3. 打开六个演示项目

在解压目录的 项目演示/ 中，可以找到以下六个独立文件夹：

| 应用 | 从头体验 | 查看已完成结果 |
| 讨论与协作 | 应用1-讨论协作-初始：根智能体、管理员及两个小组预设。 | 应用1-讨论协作-最终：已组网的讨论、协作小组，以及 CSV 转 JSON 项目结果。 |
| 资料库 | 应用2-资料库-初始：启动网络与待归档资料。 | 应用2-资料库-最终：CSV、SQLite、RAG、Wiki 集合及归档结果。 |
| NPC 小镇 | 应用3-小镇-初始：尚未开始运行的小镇。 | 应用3-小镇-最终：五天运行后的居民关系、物资、记忆与会话。 |

推荐打开方式：完成上面的 Harness 设置后，进入想体验的文件夹，双击其中的 打开项目.cmd。例如 项目演示/应用3-小镇-初始/打开项目.cmd。讨论协作最终项目首次启动还会通过随附的准备脚本恢复 Git 历史和成员工作区，请保留项目文件完整。

也可以在客户端首页选择“打开项目文件夹”，选中对应的演示文件夹，也就是 nexarbor.json 所在的那一层。如果把演示项目复制到包外的其他位置，优先使用客户端打开文件夹；原附带的启动脚本按运行包的相对位置寻找程序。

4. 开始体验与保存

- 先看结果：打开任意“最终”项目，单击节点查看模块、工具与数据，双击智能体查看会话；也可以右键节点咨询网络智能体。
- 从头运行小镇：打开“小镇-初始”，在左下角运行面板选择“每刻”脉冲，点击“单步”运行一个时刻，或填写时刻数后点击“运行”。一次时刻会触发多个居民活动，完成时间取决于模型响应与工具执行。
- 体验讨论协作与资料库：打开对应“初始”项目，双击入口智能体，结合项目自己的 README 和任务资料发送需求；初始状态与最终状态相互独立，最终项目用于查看已经完成的效果。
- 修改与保存：编辑节点、连接或模块配置后，点击“校验并更新网络”使修改进入运行网络。运行状态会自动持久化；点击 Commit 或按 Ctrl＋S，另外保存一个可回溯的 Git 版本。

建议先复制一份初始项目再尝试修改，保留原始演示便于重新开始。资料库演示不携带本地嵌入模型，使用本地语义检索前需配置模型路径；配置方法及其他安装细节见 安装与装配指南。

许可证

项目许可证尚未确定，后续以仓库提供的 LICENSE 为准。第三方宿主、依赖和相关材料遵循各自许可证。

English README