From a20f6e4d38e563a9d07e594b1499fad83730ebb3 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:35 +0800 Subject: [PATCH 01/17] New translations readme.md (Chinese Simplified) [ci skip] --- zh-cn/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 zh-cn/README.md diff --git a/zh-cn/README.md b/zh-cn/README.md new file mode 100644 index 0000000..c50998b --- /dev/null +++ b/zh-cn/README.md @@ -0,0 +1,11 @@ +# Manboster Documentation + +This is the documentation repository of Manboster. + +[Manboster Contributing Guideline](https://github.com/manboster/manboster/blob/master/CONTRIBUTING.md) also applies to this repository. + +If you want to get more information about Manboster, please go to [the main repository](https://github.com/manboster/manboster) + +## License + +We use [CC-BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) as our documentation's license. From 0271870f3cba79ba42b546c7edbe6540e4a223d2 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:36 +0800 Subject: [PATCH 02/17] New translations index.md (Chinese Simplified) [ci skip] --- zh-cn/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/zh-cn/index.md b/zh-cn/index.md index 8286070..926ff9f 100644 --- a/zh-cn/index.md +++ b/zh-cn/index.md @@ -4,7 +4,7 @@ layout: home hero: name: Manboster text: 你的曼波虾头小助手！ - tagline: + tagline: Manboster is a personal AI Agent like Hermes Agent, OpenClaw, PicoClaw, Memoh and IronClaw. Apart from claws, we forged it with a shell more secure. So it features pluggable tool call, built-in zero trust gatekeeper, Hachimi guard model and more than you think. actions: - theme: brand text: 快速开始 @@ -18,14 +18,14 @@ hero: features: - icon: ⚡️ title: 快速又敏捷 - details: 感谢 Golang 的语言特性，我们的 Manboster 生来就可以游刃有余的处理聊天信息，它在空载的时候只占 40MB 的内存！ + details: Thanks to Golang, Manboster is born with genes that is fast and multithreaded. Also, it consumes only 40MB memory in your machine when idle. - icon: 🔐 title: 安全 - details: Manboster 内置零信任守门人系统，如果你不许模型做什么，守门人会死死守住让它动都动不了。 + details: Manboster features built in Zero Trust design. If you disallow the LLM to do anything, it won't do anything due to the limitation of Gatekeeper. - icon: ⚖️ title: 内置守卫 - details: Manboster 内置 Hachimi（哈吉米），一个通常跑在本地的小模型。你可以让 Hachimi 帮你处理模型的工具调用请求。除非是可疑或危险情况，Hachimi 不会来打扰你。 + details: Manboster 内置 Hachimi（哈吉米），一个通常跑在本地的小模型。你可以让 Hachimi 帮你处理模型的工具调用请求。除非是可疑或危险情况，Hachimi 不会来打扰你。 You can handle all requests to Hachimi, it will help you handle LLM's tool call requests properly unless it's unsure or unsafe. - icon: 🔧 - title: 开箱即用 - details: 只需要下载一个可执行文件，双击打开就能用了！当然，我们也在开发一个全新的基于 WebSocket 技术的管理面板，敬请期待～ + title: Easy to use + details: Out of the box, only one executable file. Just download and click to start. Also, we are working on websocket-based web panel, stay tuned! --- From 98c7a91826369b42d9c08a4fe20a38e149c5c8d0 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:37 +0800 Subject: [PATCH 03/17] New translations index.md (Chinese Simplified) [ci skip] --- zh-cn/docs/configure/index.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/zh-cn/docs/configure/index.md b/zh-cn/docs/configure/index.md index e69de29..a3a9805 100644 --- a/zh-cn/docs/configure/index.md +++ b/zh-cn/docs/configure/index.md @@ -0,0 +1,3 @@ +# Manboster Configuration Documentation + +This document aims to help you manually manage your `config.yaml`. From 1e028ad22490209ccbcb9dcc2672b542f8d578d6 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:38 +0800 Subject: [PATCH 04/17] New translations container.md (Chinese Simplified) [ci skip] --- zh-cn/docs/container.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/zh-cn/docs/container.md b/zh-cn/docs/container.md index 647da82..4e9d056 100644 --- a/zh-cn/docs/container.md +++ b/zh-cn/docs/container.md @@ -2,12 +2,9 @@ 本文档旨在帮助您在容器中运行 Manboster，使其易于部署和获取。 -> [!NOTE] -> 此翻译部分内容由 Gemini 3.1 Pro 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - ## 容器镜像在哪里？ -Manboster 的容器镜像是通过 GitHub Actions 自动生成的。它发布在 ghcr (GitHub Container Registry) 上。 +Manboster 的容器镜像是通过 GitHub Actions 自动生成的。它发布在 ghcr (GitHub Container Registry) 上。 It is published in ghcr. 官方容器镜像地址为： @@ -39,7 +36,7 @@ docker run -dit -v ./manboster-data:/app/manboster/ --restart=unless-stopped --n podman run -dit -v ./manboster-data:/app/manboster/ --restart=unless-stopped --name manboster-container ghcr.io/manboster/manboster ``` -如果您想启动配置 TUI（终端用户界面），请在 Manboster 停止后运行以下命令，否则会提示运行错误： +如果您想启动配置 TUI，请在 Manboster 停止后运行以下命令，否则会提示运行错误： ```shell # 如果您使用的是 Docker： @@ -51,7 +48,7 @@ podman stop manboster-container podman run --remove -it -v ./manboster-data:/app/manboster/ ghcr.io/manboster/manboster manboster config ``` -别忘了在配置完成后重新启动它们！ +Don't forget to get them up! 如果您使用的是 Docker Compose 或 Podman Compose，您可以将以下内容添加到 `docker-compose.yml` 文件的 `services` 字段中： @@ -87,7 +84,7 @@ docker compose up -d podman compose up -d ``` -如果您想启动配置 TUI，请在 Manboster 停止后运行以下命令，否则会提示运行错误： +如果您想启动配置 TUI（终端用户界面），请在 Manboster 停止后运行以下命令，否则会提示运行错误： ```shell # Docker Compose @@ -99,4 +96,4 @@ podman compose stop manboster podman compose run --rm manboster manboster config ``` -别忘了在配置完成后重新启动它们！ +Don't forget to get them up! From ba3b614f54aab81eb89cb775242319eaaff0d1c4 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:39 +0800 Subject: [PATCH 05/17] New translations architecture.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/architecture.md | 130 ++++++++++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 zh-cn/docs/contribute/architecture.md diff --git a/zh-cn/docs/contribute/architecture.md b/zh-cn/docs/contribute/architecture.md new file mode 100644 index 0000000..8e9d3cb --- /dev/null +++ b/zh-cn/docs/contribute/architecture.md @@ -0,0 +1,130 @@ +# Manboster Architecture Documentation + +In this document, we will introduce Manboster's file structure and explain why it is that. It may help you add new features or fix new bugs in a proper way. + +## File Tree Overview + +This is a tree for Manboster application currently, it provides a comprehensive architecture preview of the Manboster: + +``` +├── build -> This is the build repo +│   └── manboster +├── build.sh +├── cmd +│   ├── manbodev +│   └── manboster -> The entrypoint of Manboster +├── internal +│   ├── chat -> Where is the chat provider lives +│   │   ├── all -> Aonoymous import chat providers here +│   │   ├── feishu +│   │   ├── registry.go +│   │   ├── telegram +│   │   └── web +│   ├── cli -> The cli interface of Manboster & Manbodev +│   │   ├── helper -> Helper function for the Client Interface +│   │   ├── manbodev +│   │   ├── manboster +│   │   │   ├── app -> Main application entrypoint using Cobra(or plain text response) +│   │   │   ├── ctx -> Daemon context +│   │   │   ├── daemon -> Commands related to daemon +│   │   │   ├── init.go +│   │   │   └── interact -> Interactive User Interface for Manboster (Mainly onboard and edit configuration) +│   │   └── provider -> Interactive Interface Providers Instance +│   │   └── huh +│   ├── config -> Configuration parser & helper functions +│   │   ├── model -> Model Information collected in database +│   │   ├── prompt -> where the Default Prompt stores +│   ├── database -> Database module +│   │   └── types -> ORM Types +│   ├── downloader -> Download helper with checkpoint and speed hints +│   ├── engine -> The main engine of Manboster +│   │   ├── chatdata -> Chat Data Manager(Compact, write it to database) +│   │   ├── command -> Command Handler +│   │   ├── distribute.go -> Distribute chat message based on its type +│   │   ├── engine.go -> The declaration +│   │   ├── gatekeeper -> Gatekeeper Module +│   │   ├── gateway -> Gateway Module (With retries, send message & get message) +│   │   ├── handler -> Message Handler Module +│   │   ├── handler.go -> The main message handler loop lies +│   │   ├── hook -> Hooks manager +│   │   ├── load.go -> Load SessionID +│   │   ├── onboard -> Onboard manager, used when first run +│   │   ├── processor -> Preprocess messages received from Chat Provider and decide whether to handle or not +│   │   ├── runner -> Runner for cronjob handler +│   │   ├── runner.go -> Runner for main message session handler +│   │   ├── safeguard -> Evaluation tools for checking permission +│   │   └── soul -> The system prompt building module +│   ├── fs -> A helper module for storage file in disk for caching +│   ├── hachimi -> The Hachimi module +│   │   ├── all -> All providers registrar +│   ├── i18n -> i18n module +│   │   ├── keys -> i18n variable keys defined in Manboster Application +│   │   ├── locales -> i18n json stored in here +│   │   │   ├── en -> Languages... +│   │   │   └── zh-cn +│   ├── llm -> llm providers module +│   │   ├── all -> llm provider registrar +│   │   ├── oai_compat -> provider +│   │   ├── openrouter +│   │   └── universal +│   ├── loader -> provider loader & app loader +│   │   ├── chat.go -> load chat providers +│   │   ├── hachimi.go -> load hachimi providers +│   │   ├── llm.go -> load llm providers +│   │   ├── load.go -> load application +│   │   ├── loader.go +│   │   ├── model.go -> load models +│   │   ├── run_chat.go -> polling chats +│   │   ├── skill.go -> load skills +│   │   └── tool.go -> load tools +│   ├── plugin -> WASM plugin module (TODO) +│   ├── repository -> ORM Repository middleware +│   │   ├── types -> DTO Types +│   ├── session -> Session Manager +│   ├── skill -> skills compatibility layer +│   ├── tool -> Tool provider +│   │   ├── all -> tool registrar +│   │   ├── browser +│   │   ├── ... +│   │   └── vision +│   ├── util -> utilities used in Manboster +│   ├── vault -> vault services used in Manboster (TODO) +│   └── wasm -> wasm applications used in Manboster (TODO) +├── sdk -> Manboster Software Development Kit for go wasm plugins (TODO) +└── spec -> definitions of types + ├── chat + ├── cli + ├── config + ├── llm + ├── plugin + └── schema +``` + +## How a Manboster Application starts + +Its execution flows like this: + +``` +`/cmd/manboster/main.go`(check i18n) -> `/internal/cli/manboster/app` -> `/internal/loader` -> `/internal/engine` +``` + +1. Manboster's entrypoint file is `/cmd/manboster/main.go`. It will first activate i18n and then continue. +2. Then it will activate cobra and handle you to different commands. (Next is the description of `main`.) +3. `/internal/loader` loads Chat Providers(open new goroutines to poll, initialize and more), LLM Providers, Tool Providers and more. +4. If loaded, loader will open engine and wait for the message feed. + +## How a message was handled in Manboster Engine + +Its execution flows like this: + +``` +Chat Provider -> PreProcessor -> distribute.go -> handler.go -> handler -> chatProvider.Send ... +``` + +1. Chat Provider triggers a message event +2. Our PreProcessor checks out whether this message should be processed or not +3. distribute.go distribute messages to handler or other places based on its type +4. Handler will handle text, image and tool call and more. +5. Once end, we will make responses via `chatProvider.Send` and send back messages + +We use Channels to help us manage incoming message from chat providers. It ensures the sequence of messages. And we defined session type in `/internal/session`, so you can get a preview in there. From 52ddb4ed4ed457ab5238481a5cbe5b743a84832e Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:40 +0800 Subject: [PATCH 06/17] New translations index.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/index.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 zh-cn/docs/contribute/index.md diff --git a/zh-cn/docs/contribute/index.md b/zh-cn/docs/contribute/index.md new file mode 100644 index 0000000..fdde488 --- /dev/null +++ b/zh-cn/docs/contribute/index.md @@ -0,0 +1,15 @@ +# Manboster Contribute Documentation + +Welcome to the Manboster Contribute Documentation! + +Before contributing this repository, we strongly recommend you to read it! + +## First Read + +- [Manboster Contributing Guideline](https://github.com/manboster/manboster/blob/master/CONTRIBUTING.md) + +## Then Read + +- [Project Architecture](/docs/contribute/architecture.md) +- [How to start](/docs/contribute/start.md) +- [Versioning](/docs/contribute/versioning.md) From c53c1fd15f3fbd0592d4210ac847136194170033 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:41 +0800 Subject: [PATCH 07/17] New translations packaging.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/packaging.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 zh-cn/docs/contribute/packaging.md diff --git a/zh-cn/docs/contribute/packaging.md b/zh-cn/docs/contribute/packaging.md new file mode 100644 index 0000000..70bc1a4 --- /dev/null +++ b/zh-cn/docs/contribute/packaging.md @@ -0,0 +1,24 @@ +# Manboster Packaging Documentation + +This is a documentation for packagers of Manboster, intending to introducing Manboster's releases and how it is assembled. + +## Release Channels + +It's suggested to contain these channels in your package: + +| Channel | Versions Contained | +| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Stable | Stable Versions (i.e. v0.1.0, v0.2.0,...) | +| Beta | Beta Versions (i.e. v0.1.0-beta.1, v0.1.0-rc, ...) | +| Canary(optional) | Canary Versions (GitHub Tag `canary`) | + +For better experience, a `canary` version is good to go. + +## Release Version Standards + +Based on the [Contributing Guideline], we have 3 types of releasing: + +1. Stable release: Tagged as `v0.x.x`, this is the stable and safe version for all users +2. Release Candidate: Tagged as `v0.x.x-rc`, this is a version with features frozen and only accept bug fixes. +3. Beta: Tagged as `v0.x.x-beta.1`, `v0.x.x-beta.x`, this is a version with experimental features and not stable as well. +4. Canary: Tagged as `canary`, it provides latest developer preview of this application. From 506bf9bcb970bc23945cc965c61f58df48d65532 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:42 +0800 Subject: [PATCH 08/17] New translations providers.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/providers.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 zh-cn/docs/contribute/providers.md diff --git a/zh-cn/docs/contribute/providers.md b/zh-cn/docs/contribute/providers.md new file mode 100644 index 0000000..16d49ef --- /dev/null +++ b/zh-cn/docs/contribute/providers.md @@ -0,0 +1,3 @@ +# Manboster Providers Documentation + +This documentation aims to describe providers in Manboster and explains why we need it and guides you through the definition of types and functions. From 908dcced52c941561ab22f549c8ab3ec9d888e3e Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:43 +0800 Subject: [PATCH 09/17] New translations start.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/start.md | 62 ++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 zh-cn/docs/contribute/start.md diff --git a/zh-cn/docs/contribute/start.md b/zh-cn/docs/contribute/start.md new file mode 100644 index 0000000..6462004 --- /dev/null +++ b/zh-cn/docs/contribute/start.md @@ -0,0 +1,62 @@ +# Start to contribute Manboster? + +This document guides you contribute Manboster in ease. + +## Fork the repo + +Fork the Manboster repository to your GitHub account. + +## Clone the repo down you your machine + +Use this command to clone Manboster (git required and configure SSH keys in advance) + +```shell +git clone git@github.com:/your-username/manboster.git +``` + +## Install development dependencies + +When modifying Manboster, you need to install development dependencies or you can't run Manboster. + +Install [the Go Programming Language](https://go.dev/) and Makefile is enough. + +Use this command to install modules: + +```shell +go mod download +``` + +And use `make` to start developing: + +```shell +make run (params) +``` + +## Pick a good-first-issue to fix + +If you're first to contribute, don't hesitate to get some `good-first-issues` from [our issues](https://github.com/manboster/manboster/issues) list. + +## Open a new branch + +We strongly recommend you to do that. + +Use this command to open a new branch to fix this problem: + +```shell +git branch fix/your-branch-name +git checkout fix/your-branch-name +``` + +## Fix the code + +We don't care what AI Agent you are using, but we will reject AI slops with no value. + +## Push & Open a new pull request + +Use this to push it back to your repository: + +```shell +git push origin fix/your-branch-name +``` + +Then [open a new pull request](https://github.com/manboster/manboster/pulls/new) to us. From 3b1bbbb32ebde7052b98b9cf40dd55a35cc63e29 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:44 +0800 Subject: [PATCH 10/17] New translations versioning.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/versioning.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 zh-cn/docs/contribute/versioning.md diff --git a/zh-cn/docs/contribute/versioning.md b/zh-cn/docs/contribute/versioning.md new file mode 100644 index 0000000..8720e34 --- /dev/null +++ b/zh-cn/docs/contribute/versioning.md @@ -0,0 +1,29 @@ +# The versioning and branch standard of Manboster + +## Versioning + +Manboster versioning is based on `SemVer`. And we use these git tags to release: + +`v1.0.0` means the stable version + +`v1.0.0-rc` means the RC(Release candidate) version + +`v1.0.0-beta` means the Beta version + +`v1.0.0-alpha` means the Alpha version + +`nightly-2026xxxx` means the Nightly version, `2026xxxx` means its release date + +`canary` means the developing canary version + +For more information, read [the guideline](https://github.com/manboster/manboster/blob/master/CONTRIBUTING.md). + +## Branch Standard + +We only open 3 branches: + +`master`: the main branch of current stable version (when versioning, it will be merged) + +`0.x.0-fix`: the fixing version branch (used for last version's safety patches) + +`dev`: the developing branch of the next version From 2d64610c86c3825367e341a3d900fe23738a4ed8 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:45 +0800 Subject: [PATCH 11/17] New translations gatekeeper.md (Chinese Simplified) [ci skip] --- zh-cn/docs/gatekeeper.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/zh-cn/docs/gatekeeper.md b/zh-cn/docs/gatekeeper.md index 8eeb9fb..fa3398a 100644 --- a/zh-cn/docs/gatekeeper.md +++ b/zh-cn/docs/gatekeeper.md @@ -3,27 +3,27 @@ > [!NOTE] > 此翻译部分内容由 Kimi K2.6 和 Gemini 3.1 Pro 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - ## Manboster 中的 Gatekeeper 是什么？ -Gatekeeper 是 Manboster 中一个 **强制启用、内置的安全模块** 。它默认基于可配置的**零信任架构**运行，作为系统操作的安全中间层。虽然你可以随时自定义其安全策略，但 Gatekeeper 模块本身已深度集成到系统中，**无法被禁用**。 +Gatekeeper 是 Manboster 中一个 **强制启用、内置的安全模块** 。它默认基于可配置的**零信任架构**运行，作为系统操作的安全中间层。虽然你可以随时自定义其安全策略，但 Gatekeeper 模块本身已深度集成到系统中，**无法被禁用**。 Operating on a configurable Zero Trust architecture by default, it acts as a secure intermediary for system operations. While you can customize its security policies at any time, the Gatekeeper module itself is deeply integrated into the system and cannot be disabled. ## 执行流程 当系统处理工具调用请求时，Gatekeeper 会执行严格的验证与授权流程： -1. 系统接收到云端大语言模型的响应消息。如果其中包含工具调用请求，该请求会立即被路由到 Gatekeeper 模块。 +1. The system receives a response message from the cloud LLM. If it contains a tool call request, it is immediately routed to the Gatekeeper module. 2. Gatekeeper 根据已定义的工具声明，验证请求参数。 -3. Gatekeeper 评估用户的访问权限级别。如果用户未达到该工具的最低权限要求，请求将被自动拒绝。 +3. Gatekeeper 评估用户的访问权限级别。如果用户未达到该工具的最低权限要求，请求将被自动拒绝。 If the user does not meet the tool's minimum permission requirements, the request is automatically rejected. 4. 如果权限充足，Gatekeeper 会检查授权缓存，查看用户此前是否已批准过该操作。 -5. 如果缓存中无授权记录，Gatekeeper 会向用户展示决策表单。 -6. 授权表单的有效期为 **10 分钟**。如果用户在此期间未采取任何操作，该工具调用将被自动拒绝。 +5. If no cached approval exists, Gatekeeper surfaces a decision form to the user. +6. 授权表单的有效期为 **10 分钟**。如果用户在此期间未采取任何操作，该工具调用将被自动拒绝。 If the user takes no action within this window, the tool call is automatically rejected. 7. 用户可选择以下操作： - - **批准（Approve）：** 批准接下来 10 分钟内的所有工具调用，或批准该特定工具 30–120 分钟（具体时长取决于工具的安全等级）。 - - **委托给 Hachimi（Delegate to Hachimi）：** 交由 Hachimi 安全模块处理这一次请求，或允许它在接下来一小时内自动处理所有请求。如果 Hachimi 判定请求安全，将自动执行。 - - **拒绝（Reject）：** 拒绝该特定工具 15 分钟，或在当前会话期间屏蔽所有工具调用。 -8. 如果获得批准，流程将继续执行。如果用户手动拒绝，系统将中止操作并返回"用户手动拒绝"错误。 +- **批准（Approve）：** 批准接下来 10 分钟内的所有工具调用，或批准该特定工具 30–120 分钟（具体时长取决于工具的安全等级）。 +- **委托给 Hachimi（Delegate to Hachimi）：** 交由 Hachimi 安全模块处理这一次请求，或允许它在接下来一小时内自动处理所有请求。如果 Hachimi 判定请求安全，将自动执行。 If Hachimi deems a request safe, it will proceed automatically. +- **拒绝（Reject）：** 拒绝该特定工具 15 分钟，或在当前会话期间屏蔽所有工具调用。 + +8. If approved, the process continues. 如果获得批准，流程将继续执行。如果用户手动拒绝，系统将中止操作并返回"用户手动拒绝"错误。 > [!NOTE] > 在当前会话中屏蔽工具调用**仅作用于该特定会话**；其他活跃的聊天会话完全不受影响。 From 558bcd4bea36c68df1c222e22a0681206ca01e1f Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:46 +0800 Subject: [PATCH 12/17] New translations hachimi.md (Chinese Simplified) [ci skip] --- zh-cn/docs/hachimi.md | 35 ++++++++++++++++------------------- 1 file changed, 16 insertions(+), 19 deletions(-) diff --git a/zh-cn/docs/hachimi.md b/zh-cn/docs/hachimi.md index bc4cc16..e60d3bf 100644 --- a/zh-cn/docs/hachimi.md +++ b/zh-cn/docs/hachimi.md @@ -1,17 +1,10 @@ # Hachimi（哈吉米）简介 -> [!NOTE] -> 此翻译部分内容由 Kimi K2.6 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - ## 什么是"Hachimi"？ Hachimi（哈吉米）是一个主要运行在**设备端**的防护模型（你也可以更换提供商；如果选择 "gguf"，则会使用 `llama.cpp` 和 FFI 技术在本地运行 Hachimi）。 -你可以把 Hachimi 理解为云端大语言模型的"法官"——它在本地执行前先进行判断。它能有效降低单一模型产生的幻觉问题，但无法应对高级且复杂的提示词工程攻击。 - -## 如何开启？ - -在安装向导中，系统会询问你是否要启用 Hachimi。如果当时没有启用，你也可以稍后通过 `./manboster config` 管理器（`配置 > Hachimi`）来开启。 +Imagine that the Hachimi is the judge of the cloud LLM, it acts as a guard model in your local machine before executing. It effectively reduces the hallucination caused by a single model but it could not tackle advanced and complex prompt engineering. ## 如何查看它的工作状态？ @@ -23,22 +16,26 @@ Hachimi（哈吉米）是一个主要运行在**设备端**的防护模型（你 `🐱` 代表 Hachimi 的状态，猫 emoji 旁边的表情符号表示 Hachimi 的激活状态：`➖` 表示 Hachimi 在此次工具调用中未激活，`✅` 表示 Hachimi 认为该请求安全，或你手动允许了 Hachimi 标记的可疑/不安全报告，`❓` 表示 Hachimi 认为该请求可疑但是你忽略了所有可疑内容，`❌` 表示你拒绝了 Hachimi 标记的可疑或不安全请求。 +## 如何开启？ + +On setup wizard, the wizard will prompt that whether you want to enable it or not. 在安装向导中，系统会询问你是否要启用 Hachimi。如果当时没有启用，你也可以稍后通过 `./manboster config` 管理器（`配置 > Hachimi`）来开启。 + ## 系统要求 -如果运行默认模型 `Qwen3 Guard Gen 0.6B` 并选择 `medium`（中等）上下文，你的机器至少需要 **768MB** 可用内存。建议预留 **1GB** 以上可用内存。 +如果运行默认模型 `Qwen3 Guard Gen 0.6B` 并选择 `medium`（中等）上下文，你的机器至少需要 **768MB** 可用内存。建议预留 **1GB** 以上可用内存。 It's more better when it's more than 1GB memory available. Hachimi 模型的内存占用取决于运行模型的大小和上下文长度，你可以将模型本身的占用估算为 **文件大小的 1.2 倍**。 -不同上下文长度的内存占用如下表所示： +And the context length occupations is on the table below: -| 上下文长度 | 内存占用（平均） | -|-----------|----------------| -| Low（1k tokens） | 150MB | -| Medium（2k tokens） | 250MB | -| High（4k tokens） | 450MB | -| x-High（8k tokens） | 850MB | +| 上下文长度 | Memory Occupation | +| ----------------- | ----------------- | +| Low（1k tokens） | 150MB | +| Medium（2k tokens） | 250MB | +| High（4k tokens） | 450MB | +| x-High（8k tokens） | 850MB | -上下文长度越长，Hachimi 能够理解的内容就越多。如果评估消息过长（超过上下文长度限制），则会回退到人工处理。 +The context length is longer, the more things Hachimi can understand. If the evaluate message is too long (more than the limitation of the context length), it will fallback to human. 例如，你正在使用 `Qwen3 Guard Gen 0.6B`，模型文件大小为 `400MB`，并选择了 `medium` 上下文长度。 @@ -54,9 +51,9 @@ Hachimi 模型的内存占用取决于运行模型的大小和上下文长度， ## Hachimi 的角色 > [!WARNING] -> Hachimi 帮助你判断云端大语言模型的工具调用请求是否安全。它确实有助于降低决策成本，让工作流更加顺畅。然而，受限于 Transformer 大语言模型的能力，你不能将所有事情都绝对地交给它处理。 +> Hachimi helps you decide cloud LLM's tool call requests safe or not. It truly helps reduce the cost of decision and make workflows more fluently. However, as the limitation of the transformer LLM, you couldn't absolutely handle anything to it. -在工具选择时，你可以选择 `由 Hachimi 处理` 或 `全部交由 Hachimi 处理 1 小时` 来激活 Hachimi。你也可以发送 `/reset` 命令来重置工具调用处理状态。 +在工具选择时，你可以选择 `由 Hachimi 处理` 或 `全部交由 Hachimi 处理 1 小时` 来激活 Hachimi。你也可以发送 `/reset` 命令来重置工具调用处理状态。 You can also send `/reset` command to reset tool call handle status. 当 Hachimi 认为某个请求可疑或不安全时，gatekeeper 将挂起该请求流程，请用户选择允许或拒绝。 From 2517227165923b04e120a6fba53adf5a59ac77ac Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:47 +0800 Subject: [PATCH 13/17] New translations index.md (Chinese Simplified) [ci skip] --- zh-cn/docs/index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/zh-cn/docs/index.md b/zh-cn/docs/index.md index 8b93559..eb8c6e6 100644 --- a/zh-cn/docs/index.md +++ b/zh-cn/docs/index.md @@ -1,8 +1,5 @@ # Manboster 文档 -> [!NOTE] -> 此翻译部分内容由 Gemini 3.1 Pro 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - 欢迎来到 Manboster 文档！ ## 从哪开始？ @@ -13,3 +10,7 @@ - [Hachimi(哈吉米)简介](/zh-cn/docs/hachimi.md) - [Gatekeeper 简介](/zh-cn/docs/gatekeeper.md) + +## Want to make a contribution? + +- Go to [Manboster Contribute Documentation](/docs/contribute/index.md) From d3c8107bd2e7a4b0e1f8f4cf7a5fe9b1d91014d9 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:49 +0800 Subject: [PATCH 14/17] New translations quickstart.md (Chinese Simplified) [ci skip] --- zh-cn/docs/quickstart.md | 49 +++++++++++++++++++--------------------- 1 file changed, 23 insertions(+), 26 deletions(-) diff --git a/zh-cn/docs/quickstart.md b/zh-cn/docs/quickstart.md index be2ed96..51b741d 100644 --- a/zh-cn/docs/quickstart.md +++ b/zh-cn/docs/quickstart.md @@ -1,10 +1,7 @@ # 快速开始 -> [!NOTE] -> 此翻译部分内容由 Gemini 3.1 Pro 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - > [!WARNING] -> 提示：Manboster 目前正处于不稳定阶段并且我们正在给它增加功能中，并不建议您生产使用，建议等待2026年9月的 `v1.0.0` 发布后再尝试生产端使用。 +> 提示：Manboster 目前正处于不稳定阶段并且我们正在给它增加功能中，并不建议您生产使用，建议等待2026年9月的 `v1.0.0` 发布后再尝试生产端使用。 It's not production-ready until `v1.0.0` releases in about September 2026. ## 你是 Go 开发者吗？ @@ -15,7 +12,7 @@ go install github.com/manboster/manboster/cmd/manboster@latest ``` -如果你对 Go 不太了解，没关系，请继续往下看。 +If you don't know what's this, go ahead. ## 你是苹果 Mac 用户吗？ @@ -31,7 +28,7 @@ brew install MZWNET/tap/manboster ## 你是 AOSC OS 用户吗？ -如果您正在使用 [AOSC OS](https://aosc.io/)（有时也称为 Anthon OS, 安同OS），我们很高兴地告诉您，Manboster 将加入其软件仓库，并由我们仓库所有者来维护。如果您使用的是 AOSC OS，只需使用包管理器 `oma` 安装即可。 +如果您正在使用 [AOSC OS](https://aosc.io/)（有时也称为 Anthon OS, 安同OS），我们很高兴地告诉您，Manboster 将加入其软件仓库，并由我们仓库所有者来维护。如果您使用的是 AOSC OS，只需使用包管理器 `oma` 安装即可。 If you are using AOSC, just install it with the package manager `oma`. ```shell oma install manboster @@ -46,22 +43,22 @@ oma install manboster 前往 [Releases 页面](https://github.com/manboster/manboster/releases) 下载适合你电脑的二进制文件。 -发布包里有包含针对各种不同架构和平台的文件，下载前看仔细了。 +The artifact contains different architecture and platform so you may carefully download suitable binary files. 文件名的格式大概是这样的：`manboster-{版本号}-{渠道}-{commit哈希}-{平台}-{架构}(.exe)` -| 文件名后缀 (平台 & 架构) | 对应的平台与架构系统 | 常见设备举例 | -| --- | --- | --- | -| darwin-arm64 | macOS (arm64 芯片) | Apple Silicon (M 芯片) 的 Mac | -| darwin-amd64 | macOS (x86_64 芯片) | 较老的 Intel 芯片 Mac | -| win-amd64 | Windows (x86_64 芯片) | 绝大多数 Intel / AMD 架构的台式机或笔记本 | -| win-arm64 | Windows (ARM 芯片) | 搭载高通 / 联发科芯片的轻薄本 | -| linux-arm64 | Linux (ARM 芯片) | 瑞芯微 / 全志 等开发板或设备 | -| linux-amd64 | Linux (x86_64 芯片) | 普通的 Intel / AMD 服务器或 PC | -| linux-riscv64 | Linux (RISC-V 64 芯片) | RISC-V 架构设备 | +| 文件名后缀 (平台 & 架构) | 对应的平台与架构系统 | 常见设备举例 | +| ------------------------------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------- | +| darwin-arm64 | macOS (arm64 芯片) | Apple Silicon (M 芯片) 的 Mac | +| darwin-amd64 | macOS (x86_64 芯片) | 较老的 Intel 芯片 Mac | +| win-amd64 | Windows (x86_64 芯片) | 绝大多数 Intel / AMD 架构的台式机或笔记本 | +| win-arm64 | windows with arm chip | Qualcomm / MediaTek Desktop/Laptop | +| linux-arm64 | Linux (ARM 芯片) | RockChip / AllWinner /... | +| linux-amd64 | Linux (x86_64 芯片) | 普通的 Intel / AMD 服务器或 PC | +| linux-riscv64 | Linux (RISC-V 64 芯片) | ... | > [!NOTE] -> 提示：如果你是个小白，而且用的是 Windows，无脑选 `win-amd64` 就对了，这能解决 99% 的情况。如果实在跑不起来，再试试别的。 +> If you don't know anything and you're using Windows, download `win-amd64` type. It will help in most times. If it would't work, download another one. ## 校验下载文件的 SHA256 哈希值（可选但推荐） @@ -72,44 +69,44 @@ oma install manboster 如果你用的是 macOS 或 Linux，请使用 `sha256` 或 `shasum -a 256` 命令。 -当然，你也可以用各种图形化小工具来计算 SHA256 哈希值，然后和 GitHub 上官方提供的值对比一下，看看对不对得上。 +Otherwise, you can also use GUI applications to calculate SHA256 sum and check them with assets specified on GitHub. ## 启动程序 -如果迫不及待想尝鲜，直接双击运行它，跟着配置向导走就行了。 +If you want to try it out, just double-click it and start configuration wizard. -你需要准备好以下几样东西： +You may parpare: 1. 你的双手和聪明的脑子 🧠 2. 一个 API Key。如果你还没有，可以看看[这篇 OpenRouter 的教程文章](https://openrouter.ai/docs/cookbook/coding-agents/openclaw-integration#manual-configuration)学习如何获取。 3. 如果你想用 Telegram 作为聊天平台，那你还需要通过 @BotFather 申请一个 Bot Token。 -配置向导搞定后，你可以打开终端输入 `./manboster start`，让它作为守护进程在后台默默运行。或者简单点，直接双击启动它也行。 +配置向导搞定后，你可以打开终端输入 `./manboster start`，让它作为守护进程在后台默默运行。或者简单点，直接双击启动它也行。 Or just double-click it to start. 如果你使用的是后台守护进程模式，可以通过以下命令来管理它： -启动后台服务： +Start the daemon: ```shell ./manboster start ``` -停止后台服务： +Stop the daemon: ```shell ./manboster stop ``` -重启后台服务： +Restart the daemon: ```shell ./manboster restart ``` -查看运行状态： +Checkout the daemon status ```shell ./manboster status @@ -127,7 +124,7 @@ oma install manboster ## 停止程序 -如果是双击启动的，直接用鼠标关掉应用窗口就行。 +If you start it with double-click, just close it with your pointer. 如果是用 `./manboster start` 启动的，只需运行 `./manboster stop` 然后稍微等它一下。 From e4499df20ef5f0ddd7acbccfdde60c23026b4654 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Sun, 21 Jun 2026 17:51:50 +0800 Subject: [PATCH 15/17] New translations why.md (Chinese Simplified) [ci skip] --- zh-cn/docs/why.md | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/zh-cn/docs/why.md b/zh-cn/docs/why.md index fef96ab..343effa 100644 --- a/zh-cn/docs/why.md +++ b/zh-cn/docs/why.md @@ -1,9 +1,6 @@ # 为什么选择 Manboster？ -> [!NOTE] -> 此翻译部分内容由 Kimi K2.6 提供，如果有任何疏忽和遗漏，欢迎[向我们提交PR](https://github.com/manboster/docs/pull/new)进行修改！ - -## 太长不看（TL;DR） +## TL;DR 如果你正在寻找一个**既轻量又比其他 AI Agent 更安全**的 AI Agent，来试试 Manboster 吧。 @@ -17,13 +14,13 @@ ## 1. 快速且轻量 -Manboster 使用 [Golang](https://go.dev/) 构建。Golang 是一门为云原生而生的语言，其代码可以编译为机器码，省去了运行时解析的时间。 +Manboster 使用 [Golang](https://go.dev/) 构建。Golang 是一门为云原生而生的语言，其代码可以编译为机器码，省去了运行时解析的时间。 Golang is a language built for cloud-native, its code can be complied into machine code, saving the time of parsing. 我们与竞品如 [OpenClaw](https://github.com/openclaw/openclaw)、[Cahciua](https://github.com/menci/Cahciua) 和 [Cybergroupmate](https://github.com/archeb/cybergroupmate)（使用 JavaScript/TypeScript 编写），或 [Astrbot](https://github.com/AstrBotDevs/AstrBot)（使用 Python 编写）相比，有着**轻量且快速**的优势。 OpenClaw（至少旧版本）由于 Node.js 的限制是单线程的，而 Manboster 所幸得益于 Golang 的并发特性，天生自带多线程基因。 -Manboster 在空闲时，在 MacBook Air M4 上占用约 40～50MB 内存。当加载 Hachimi 模型时（默认模型配置 + x-high 上下文），在 MacBook Air M4 上占用约 1GB～1.1GB 内存。Hachimi 模型释放后，内存占用会回到空闲水平。 +Manboster 在空闲时，在 MacBook Air M4 上占用约 40～50MB 内存。当加载 Hachimi 模型时（默认模型配置 + x-high 上下文），在 MacBook Air M4 上占用约 1GB～1.1GB 内存。Hachimi 模型释放后，内存占用会回到空闲水平。 When a Hachimi model was loaded (default model configuration with x-high context), it consumes 1GB~1.1GB memory on a MacBook Air M4. After Hachimi model was released, it comes back to idle memory occupation. ## 2. 安全，内置防护 @@ -31,29 +28,29 @@ Manboster 采用**零信任设计**，我们不会让云端大语言模型破坏 关于这一点，请参阅 [Hachimi](/zh-cn/docs/hachimi.md)（一个运行在本地、用于评判云端 LLM 行为的小型防护模型）和 [Gatekeeper](/zh-cn/docs/gatekeeper.md)（控制工具调用请求的模块）的介绍。 -与竞品相比，Hachimi 是所有 AI 代理中最具创新性的亮点。但请谨记：Hachimi 能够降低决策成本并有效减少云端 LLM 的幻觉，但它**无法应对高级且复杂的提示工程攻击**，因此请不要绝对信任它。 +Compared to competitor products, Hachimi is the most innovative point in all AI agents. But remind that Hachimi reduces the cost of decision and takes effect in reducing cloud LLM hallucination, but it could not tackle advanced and complex prompt engineering so do not trust it absolutely. ## 3. 易于使用 开箱即用，只有一个可执行文件，没有烦人的依赖，全平台可用。 -只需[前往 Releases 页面](https://github.com/manboster/manboster/releases)，下载后双击即可。它会打开一个精美的 TUI（终端用户界面）窗口，通过 Manboster 配置向导帮助你完成上手。 +只需[前往 Releases 页面](https://github.com/manboster/manboster/releases)，下载后双击即可。它会打开一个精美的 TUI（终端用户界面）窗口，通过 Manboster 配置向导帮助你完成上手。 It will open a pretty TUI(Terminal User Interface) window, helping you to onboard by Manboster Configuration Wizard. ![](/zh-cn/docs/assets/onboard.png) 此外，你也可以通过 `./manboster config` 在 TUI 中进行配置。 -想要卸载？直接移到垃圾桶即可。想要更新？下载新版本替换旧版本即可。想要清理所有数据？直接删除 `~/.manboster` 即可。 +If you want to uninstall it, just move it to trash. If you want to update it, just download a newer version and replace the older version. If you want to clean everything, just delete `~/.manboster` completely. ## 4. 可插拔工具 -Manboster 内置了大量实用的工具，你可以轻松启用或禁用它们。 +Manboster 内置了大量实用的工具，你可以轻松启用或禁用它们。 You can enable or disable them easily. 如果你没有选择任何工具，你可以把它当作普通的 AI 聊天机器人使用；随着工具的添加，Manboster 会长出爪子，帮助你完成更多任务。 ## 5. 古法编程 -在 AI 时代，vibe coding（氛围编程，AI 辅助编程）几乎无处不在。然而，Manboster 的核心安全模块使用的是古法编程撰写的。既然用了AI，那么 AI 都做了什么呢？它们根据指令填充了辅助函数，协助人类审查了安全架构，或是增强了 Manboster 的系统提示词。我们始终确保安全性是 Manboster 的首要重点，因此，为了避免 AI 产生“幻觉”而引发风险，我们没有使用 AI 来进行 vibe coding。 +In the era of the AI, vibe coding is used almost everywhere. However, Manboster's core security module was written by human. What did the AIs do? They filled the helper functions via the instruction, helped human review the safety architecture or enhanced the system prompt of Manboster. 在 AI 时代，vibe coding（氛围编程，AI 辅助编程）几乎无处不在。然而，Manboster 的核心安全模块使用的是古法编程撰写的。既然用了AI，那么 AI 都做了什么呢？它们根据指令填充了辅助函数，协助人类审查了安全架构，或是增强了 Manboster 的系统提示词。我们始终确保安全性是 Manboster 的首要重点，因此，为了避免 AI 产生“幻觉”而引发风险，我们没有使用 AI 来进行 vibe coding。 ## 6. 兼容技能与 MCP From 9ef6466d34495b1af10f160e54c006094ab16234 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Mon, 22 Jun 2026 21:24:36 +0800 Subject: [PATCH 16/17] New translations packaging.md (Chinese Simplified) [ci skip] --- zh-cn/docs/contribute/packaging.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/zh-cn/docs/contribute/packaging.md b/zh-cn/docs/contribute/packaging.md index 70bc1a4..74335a9 100644 --- a/zh-cn/docs/contribute/packaging.md +++ b/zh-cn/docs/contribute/packaging.md @@ -21,4 +21,29 @@ Based on the [Contributing Guideline], we have 3 types of releasing: 1. Stable release: Tagged as `v0.x.x`, this is the stable and safe version for all users 2. Release Candidate: Tagged as `v0.x.x-rc`, this is a version with features frozen and only accept bug fixes. 3. Beta: Tagged as `v0.x.x-beta.1`, `v0.x.x-beta.x`, this is a version with experimental features and not stable as well. -4. Canary: Tagged as `canary`, it provides latest developer preview of this application. +4. Canary: Tagged as `canary`, it provides latest developer preview of Manboster. + +## Release Artifact Standards + +After `v0.2.0`, we have unify the overall release artiface of Manboster, it would be that: + +``` +checksums.txt +manboster_0.2.0_darwin_amd64.tar.gz +manboster_0.2.0_darwin_arm64.tar.gz +manboster_0.2.0_linux_amd64.tar.gz +manboster_0.2.0_linux_arm64.tar.gz +manboster_0.2.0_linux_riscv64.tar.gz +manboster_0.2.0_windows_amd64.zip +manboster_0.2.0_windows_arm64.zip +``` + +Its structure would be like `manboster_{version}_{platform}_{architecture}.tar.gz(for windows it's .zip)`. + +For canary, it would be like `{version}_{commithash}`. + +Inside this compress there is a `manboster(.exe)` executable file so just move it to executable. + +Also, you can define `MANBOSTER_HOME` variable to determine Manboster's home, it will create a `.manboster` in that directory but in next version we will remove `.manboster` and use it directly. + +checksums.txt contains sha256 checksum for Manboster. From c97ad86169444cbfaa4cdadae534e837693d9639 Mon Sep 17 00:00:00 2001 From: Manboster Bot Date: Mon, 22 Jun 2026 21:24:37 +0800 Subject: [PATCH 17/17] New translations quickstart.md (Chinese Simplified) [ci skip] --- zh-cn/docs/quickstart.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/docs/quickstart.md b/zh-cn/docs/quickstart.md index 51b741d..39d1b63 100644 --- a/zh-cn/docs/quickstart.md +++ b/zh-cn/docs/quickstart.md @@ -28,7 +28,7 @@ brew install MZWNET/tap/manboster ## 你是 AOSC OS 用户吗？ -如果您正在使用 [AOSC OS](https://aosc.io/)（有时也称为 Anthon OS, 安同OS），我们很高兴地告诉您，Manboster 将加入其软件仓库，并由我们仓库所有者来维护。如果您使用的是 AOSC OS，只需使用包管理器 `oma` 安装即可。 If you are using AOSC, just install it with the package manager `oma`. +If you are using [AOSC OS](https://aosc.io/) (or named Anthon OS sometimes), we are happy to say that Manboster is now in its software repository and maintained by the repository owner. If you are using AOSC, just install it with the package manager `oma`. ```shell oma install manboster