Repository navigation
kb init(jiuwenswarm): modules #313
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| --- | ||
| title: "ide-vscode" | ||
| created: 2026-10-05 | ||
| updated: 2026-10-05 | ||
| type: index | ||
| tags: [jiuwenswarm] | ||
| sources: [] | ||
| --- | ||
|
|
||
| # ide-vscode | ||
|
|
||
| - IDE 终端命令镜像执行 (`ide-terminal-command-mirror`) | ||
|
|
||
| ## 代码快速入口（Direct） | ||
| <!-- kb-init:quick-map --> | ||
|
|
||
| 触发词：ide vscode。PR 描述或改动命中下表一行时，先读该行的规则，再读页面其余部分。 | ||
|
|
||
| | PR 描述在做什么 | 精确规则 | 第一批 live 源码 | | ||
| |---|---|---| | ||
| | ide vscode | 入口 | `jiuwenswarm/channels/ide/packages/vscode-extension/src/terminal/TerminalManager.ts`、`jiuwenswarm/channels/ide/packages/vscode-extension/src/ui/ChatPanel.ts` | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| --- | ||
| title: "scripts/ — 构建辅助与 WhatsApp 桥接脚本" | ||
| created: 2026-10-05 | ||
| updated: 2026-10-05 | ||
| type: architecture | ||
| tags: [jiuwenswarm] | ||
| sources: [] | ||
| --- | ||
|
|
||
| # scripts/ — 构建辅助与 WhatsApp 桥接脚本 | ||
|
|
||
| 该模块包含仓库的独立 Node 脚本：扫描 agent 目录生成 workspace/agent-data.json 文件清单（可配合 chokidar 监听增量重新生成），以及一个基于 Baileys 的 WhatsApp WebSocket 桥接服务。桥接脚本是可选的运行时服务，默认不随主程序启动，需手动运行。 | ||
|
|
||
| **入口脚本** | ||
|
|
||
| - `jiuwenswarm/scripts/generate-agent-folders.js` — 定位 agent 根目录（$JIUWENSWARM_ROOT/agent 或 ../resources/agent），递归扫描并写入 workspace/agent-data.json | ||
| - `jiuwenswarm/scripts/whatsapp-bridge.js` — 启动 WhatsApp 桥接：Baileys 连接 + WebSocket 服务（默认 ws://127.0.0.1:19600/ws），扫码登录、收发消息 | ||
|
|
||
| **关键文件** | ||
|
|
||
| - `jiuwenswarm/scripts/watch-folders.js` — 开发辅助：先执行一次生成脚本，再用 chokidar 监听 agent 目录（$JIUWENSWARM_DATA_DIR/agent 或 ~/.jiuwenswarm/agent，回退到 ../resources/agent），变化时重新生 | ||
| - `jiuwenswarm/scripts/generate-agent-folders.js` — 按文件夹分组文件清单，_zh/_en 后缀去重、排序保证输出稳定，失败时写空 JSON | ||
|
Comment on lines
+21
to
+22
There was a problem hiding this comment.
When readers consult this architecture page for folder-watch or reconnect behavior, both descriptions terminate mid-word ( Useful? React with 👍 / 👎. |
||
| - `jiuwenswarm/scripts/whatsapp-bridge.js` — 环境变量 WA_BRIDGE_HOST/PORT/PATH、WA_AUTH_DIR、WA_PRINT_QR 控制行为；广播 status/qr/inbound 消息，处理 send 请求并返回 send_result，非登出断线时 4 秒重 | ||
|
|
||
| **相关文档** | ||
|
|
||
| - `README_CN.md` — 了解仓库整体功能与安装使用入口 | ||
| - `docs/README.md` — 文档总导航，查找脚本相关（如 WhatsApp 频道/agent 目录）的详细文档 | ||
|
|
||
| **调用路径** | ||
|
|
||
| - `jiuwenswarm/scripts/` | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| --- | ||
| title: "NFS 共享工作区脚本 (scripts/nfs/)" | ||
| created: 2026-10-05 | ||
| updated: 2026-10-05 | ||
| type: architecture | ||
| tags: [jiuwenswarm] | ||
| sources: [] | ||
| --- | ||
|
|
||
| # NFS 共享工作区脚本 (scripts/nfs/) | ||
|
|
||
| 提供在多机部署中为 jiuwen_team 共享工作区搭建和拆除 NFS 服务端/客户端的运维脚本。四个脚本均需 sudo 手动执行，默认路径为 ${JIUWEN_TEAM_WORKSPACE_ROOT:-/tmp/jiuwenswarm/shared_workspace/jiuwen_team}。 | ||
|
|
||
| **入口脚本** | ||
|
|
||
| - `scripts/nfs/setup_nfs_server.sh` — 服务端入口：安装 nfs 服务包、写入 /etc/exports.d/jiuwenswarm.exports、exportfs -rav、启用服务并做本地 bind 挂载 | ||
| - `scripts/nfs/setup_nfs_client.sh` — 客户端入口：安装 nfs 客户端包、备份已有本地工作区、mount -t nfs4 并持久化到 /etc/fstab | ||
|
|
||
| **拆除脚本** | ||
|
|
||
| - `scripts/nfs/teardown_nfs_server.sh` — 删除导出文件并 exportfs -rav；可选 --stop-service/--disable-service/--remove-bind-fstab | ||
| - `scripts/nfs/teardown_nfs_client.sh` — umount 挂载点并经内嵌 python3 清理 /etc/fstab 的 nfs4 行（先备份 fstab），支持 --clean-all-server-entries | ||
|
|
||
| **相关文档** | ||
|
|
||
| - `docs/zh/AgentTeam.md` — 了解这些脚本服务的 jiuwen_team 多机协作背景时读 | ||
| - `README_CN.md` — 仓库总体介绍与安装入口 | ||
|
|
||
| **Routes** | ||
|
|
||
| - `scripts/nfs/` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| --- | ||
| title: "scripts/ — 打包构建与冻结产物校验" | ||
| created: 2026-10-05 | ||
| updated: 2026-10-05 | ||
| type: architecture | ||
| tags: [jiuwenswarm] | ||
| sources: [] | ||
| --- | ||
|
|
||
| # scripts/ — 打包构建与冻结产物校验 | ||
|
|
||
| 该模块承载 JiuwenSwarm 的跨平台打包链路（Windows/macOS/Electron/HarmonyOS 的 wheel、exe、dmg、hap 安装包）以及 PyInstaller 冻结入口和冻结产物的校验脚本。构建身份（应用名、版本、平台标识）统一由 build_config.py 从根 pyproject.toml 派生，各平台 wrapper 与 Inno Setup 脚本共享这一单一来源。 | ||
|
|
||
| **从哪里启动打包** | ||
|
|
||
| - `scripts/build-exe.ps1` — Windows exe 打包 wrapper：uv sync → 前端构建 → PyInstaller → Inno Setup 安装包 | ||
| - `scripts/build-electron-exe.ps1` — Windows Electron 桌面端打包（组装 Electron shell + 前端 + 后端 exe，产出 setup 安装包） | ||
| - `scripts/build-electron-exe.sh` — macOS Electron 桌面端打包，产出 DMG | ||
| - `scripts/build-macos.sh` — macOS .app + .dmg 打包，签名/公证按机器身份自动决定 | ||
| - `scripts/build-harmony.sh` — 鸿蒙应用打包：npm build → HNP 嵌入前端 → hvigorw 构建 .hap | ||
| - `scripts/build.sh` — 通用打包入口：编译 web 前端后构建 wheel（另有 build.ps1 / build-exe.bat 对应 Windows 路径） | ||
| - `scripts/jiuwenswarm_exe_entry.py` — PyInstaller 冻结入口：按参数分发主应用或子命令，含 Windows 单实例互斥 | ||
| - `scripts/harmony_entry.py` — HarmonyOS 服务编排入口：启动 AgentServer/Gateway/Web 前端子进程并等待端口就绪 | ||
|
|
||
| **构建配置与共享模块** | ||
|
|
||
| - `scripts/build_config.py` — 从根 pyproject.toml 读取并派生构建身份（ProductNames/BuildConfig），是各平台打包脚本名字与版本的权威来源 | ||
| - `scripts/jiuwenswarm.spec` — PyInstaller 打包配置，Windows/macOS 桌面冻结共用的 spec | ||
| - `scripts/build-runtimes.sh` — Node 运行时解析与绑定的共享 bash 模块（build-macos.sh 与 build-electron-exe.sh source 它） | ||
| - `scripts/build-runtimes.psm1` — node/uv 运行时解析与绑定的 PowerShell 模块（build-exe.ps1 与 build-electron-exe.ps1 共享） | ||
| - `scripts/installer.iss` — Inno Setup 安装脚本，由 build-exe.ps1 传入构建配置调用 | ||
| - `scripts/installer-electron.iss` — Electron 版 Inno Setup 脚本，应用名/版本由 build-electron-exe.ps1 注入 | ||
| - `scripts/build_python_packages.py` — 构建 Python wheel 包（可含前端 dist），build.sh 底层调用 | ||
| - `scripts/build_tui.py` — TUI 二进制构建（跨平台目标解析、输出名、macOS 签名修正） | ||
| - `scripts/update_playwright_mcp_runtime.py` — 生成可复现、免 npm 的 Playwright MCP 运行时归档并提交仓库 | ||
| - `scripts/verify_playwright_mcp_bundle.py` — 冻结产物校验之一：Node 与 Playwright MCP CLI（同类还有 verify_a2ui/gitcode_cli/rsi_bundle） | ||
| - `scripts/openjiuwen_team_mcp_exe_entry.py` — 随包发布的 OpenJiuWen team MCP 服务器的 PyInstaller 入口 | ||
| - `scripts/run_gateway_acp.sh` — 开发/运行辅助：以仓库根为 PYTHONPATH 启动 ACP 连接模块（.cmd 为 Windows 版） | ||
|
|
||
| **相关文档** | ||
|
|
||
| - `README_CN.md` — 安装与整体产品入口，了解打包产物的使用背景 | ||
| - `docs/zh/HarmonyOS_Dev_Workflow_Test_Guide.md` — 涉及鸿蒙打包（build-harmony.sh / build-harmony-hap.sh / harmony_entry.py）时先读 | ||
| - `TESTING.md` — 打包契约测试（如 tests/unit_tests/test_desktop_electron_contract.py）与验证脚本的测试约定 | ||
| - `docs/zh/AutoHarness.md` — 理解 verify_rsi_bundle.py 校验的 RSI native Harness baseline | ||
|
|
||
| **Routes** | ||
|
|
||
| - `scripts/build-electron-exe.ps1` | ||
| - `scripts/build-electron-exe.sh` | ||
| - `scripts/build-exe.bat` | ||
| - `scripts/build-exe.ps1` | ||
| - `scripts/build-harmony-hap.sh` | ||
| - `scripts/build-harmony.sh` | ||
| - `scripts/build-macos.sh` | ||
| - `scripts/build-runtimes.psm1` | ||
| - `scripts/build-runtimes.sh` | ||
| - `scripts/build.ps1` | ||
| - `scripts/build.sh` | ||
| - `scripts/build_config.py` | ||
| - `scripts/build_python_packages.py` | ||
| - `scripts/build_tui.py` | ||
| - `scripts/harmony_entry.py` | ||
| - `scripts/installer-electron.iss` | ||
| - `scripts/installer.iss` | ||
| - `scripts/jiuwenswarm.iss` | ||
| - `scripts/jiuwenswarm.spec` | ||
| - `scripts/jiuwenswarm_exe_entry.py` | ||
| - `scripts/openjiuwen_team_mcp_exe_entry.py` | ||
| - `scripts/reset_trajectory_data.py` | ||
| - `scripts/update_playwright_mcp_runtime.py` | ||
| - `scripts/verify_a2ui_bundle.py` | ||
| - `scripts/verify_gitcode_cli_bundle.py` | ||
| - `scripts/verify_playwright_mcp_bundle.py` | ||
| - `scripts/verify_playwright_mcp_offline.py` | ||
| - `scripts/verify_rsi_bundle.py` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
When a PR changes either of these files, Direct now routes it exclusively to the nearly empty
ide-vscode/_index.md, even though both files were already indexed underide-clients/vscode-extension-src/source-contracts-01.mdandChatPanel.tsis covered byide-clients/feature-depth-vscode.md. Add these prefixes toide-clientsand remove the duplicate owner/page so reviewers receive the existing VS Code knowledge instead of a synonymous split owner.AGENTS.md reference: AGENTS.md:L7-L11
Useful? React with 👍 / 👎.