LIghtJUNction/rstrbot-implementation

Dernière activité source enregistrée: 29 octobre 2026 à 00:46

Catalogue SkillsMP mis à jour: 5 novembre 2026 à 19:57

skills collectés: 2

Étoiles GitHub: 0
Forks GitHub: 0

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/LIghtJUNction/rstrbot-implementation.

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# RstrBot 面向个人与小团队的私有 AI 工作区：在自己的服务器上管理对话、模型、工具、知识、记忆和计划任务。Rust 核心提供统一业务 API；React / TypeScript WebUI 与模型、工具、平台插件通过明确协议协作。 **当前版本 0.2.0 是开发预览。第二阶段蓝图包含的完整产品范围尚未全部实现或通过验收。** 本仓库保留原始设计、52 项需求以及 215 个需求族 / 287 条原验收映射；已实现范围与缺口见 [验收追踪](docs/ACCEPTANCE.md)。本版重做 WebUI，并加入邮箱、Google 登录和多 Passkey 管理。配置步骤见 [账户与登录指南](docs/AUTHENTICATION.md)，改动与验证见 [0.2.0 报告](docs/IMPROVEMENTS_0_2_0.md)；旧回执只代表各自记录的版本。 ## 0.2.0 界面与账号体系 - **统一工作台。** 深炭色、暖白与低饱和金色；工作、知识、连接、工作区与账号分组导航。重做登录、聊天与表单视觉层次，保留浅色主题、中英文和移动端。 - **独立账户与安全页。** 不依赖工作区成员身份，可以管理邮箱、密码、Google 绑定和多枚 Passkey；实例认证配置与普通用户设置分开。 - **邮箱验证与恢复。** 管理员配置 SMTP，用户验证或更换邮箱；验证后可用邮箱和密码登录。旧邮箱在新地址确认前保持有效，单次重置链接不能覆盖后来的密码变更。 - **Google 登录。** 管理员配置 OAuth Web 客户端，用户在已有账户中显式绑定后使用 Google 登录。不依据相同邮箱自动关联账户；安全设置使用密码或 Passkey 再次确认。 - **多 Passkey 与换绑。** 支持具备用户验证能力的实体 FIDO2 密钥和浏览器/系统提供的同步凭据。可添加、重命名、删除和原子换绑；新凭据验证成功前保留旧凭据。 - **保留原有撤权与缓存保护。** 模型、工具与投递仍使用实时授权检查；新认证方式产生相同类型的可撤销会话，不绕过工作区与私有资源权限。验证使用本地 SMTP、真实 HTTP、SQLite/PostgreSQL、浏览器虚拟认证器和实际签名的 OIDC 测试令牌。真实 Google 项目、真实邮件投递和实体硬件/手机云同步需要部署环境实机验收。准确数量与执行边界见 [0.2.0 回执](docs/evidence/v0.2.0/)，不代表整个设计包已经完成。 ## 交付内容 | 内容 | 用途与当前边界 | | --- | --- | | Rust 服务与三个独立 worker | Linux 上可运行的核心、OpenAI 兼容模型插件、diagnostic 测试插件和 Webhook 出站插件 | | WebUI | 初始化、多方式登录、账户安全、认证与邮件配置、多工作区、聊天及模型/插件/知识/记忆/计划任务/成员/预算/备份页面 | | SQLite / PostgreSQL 存储 | 使用共同的权限、资源、事件、预算与恢复逻辑；Valkey 为可选缓存 | | 四种语言 SDK | Rust、Python、TypeScript、C# 源码，沿用相同协议向量，0.1.1 有四语言 Linux 通过记录；历史构建的执行结果以对应回执为准；新版本 CI 重新执行共同协议向量 | | Tauri 2 桌面工程 | 本机 sidecar 与远程 HTTPS 工作区源码；本次没有已验证的桌面安装器，Windows 本机插件路径尚未支持 | | 设计与验证资料 | 原蓝图、API/插件协议、运维说明、CI 配置、测试脚本与实际测试回执 | 已提供的执行链路包括模型流输出、只读工具调用和续轮、取消/撤权、运行事件恢复、UTF-8 文本/Markdown 检索、显式长期记忆、一次/间隔/时区计划任务、受管理员授权的 Webhook 投递及持久回执。模型费用缺失时保留“未知”；发送结果不确定时保留 `unknown` 并禁止自动重放。 52 项需求中仍保留 **9 项未实现**：旧插件兼容（RB-020）、旧 HTTP/数据/界面兼容（RB-021）、OpenCode/Pi 加载（RB-022）、群聊策略（RB-027）、子代理（RB-030）、技能资源与沙箱（RB-034）、媒体与文件传输（RB-037）、可视化编排（RB-048）、外部工作流与搜索（RB-049）。此外，通用副作用工具审批、向量索引等部分实现需求中的完整能力也尚未交付。当前本机插件是管理员安装的可信程序，进程隔离不等于恶意代码沙箱。 ## 使用 Linux 运行包解压对应版本的 `RstrBot-<版本>-linux-x86_64-<构建类型>.zip` 完整运行包，保留四个可执行文件彼此相邻，以及相邻的 `web/` 目录。它是核心服务与 WebUI 的可执行归档，不是原生桌面安装器。运行已构建的 Rust 核心和这三个 worker 不需要安装 Node.js、Python 或 .NET。需要可写且仅自己可访问的数据目录、正常的系统网络配置，以及匹配架构的 glibc 运行环境。运行包面向 Linux x86_64；准确的构建环境、二进制摘要和执行范围见随包 `MANIFEST.json` 与对应版本回执。GitHub Actions 的 Browser acceptance 工作流提供 `linux-debug-development-preview` 调试归档；调试归档不是优化发行版。0.1.1 的历史验证环境为 glibc 2.39；这条历史记录不替代当前版本的目标环境验收。其他发行版、较旧 glibc、ARM 或 Alpine/musl 应在目标环境重新构建与运行验收；不能把一个 Linux 包视为所有 Linux 环境的安装证明。调试构建与优化构建由文件名及 `MANIFEST.json` 的 `profile` 区分，调试包不作为性能验收结果。在解压目录执行： ```sh chmod u+x rstrbot rstrbot-openai rstrbot-diagnostic rstrbot-webhook ./rstrbot --data-dir "$HOME/.local/share/rstrbot" ``` 打开 <http://localhost:8787>（本机 Passkey 使用 `localhost`，不要用 IP 作为 RP）。首次启动需要本机初始化凭据；在另一个终端读取： ```sh cat "$HOME/.local/share/rstrbot/bootstrap.token" ``` 将凭据填入初始化页面，创建管理员账户和第一个工作区。凭据有效期为 15 分钟，尚未初始化时重新启动会生成新凭据；它不写入访问 URL。完成初始化后使用账户登录。服务在前台运行，Ctrl-C 请求正常退出。数据根可以通过 `--data-dir /absolute/path` 单独指定。配置、数据库和密钥均保存在数据根，升级程序文件时保留这份数据。一个数据根同时只允许一个核心或维护命令，已经启动服务时执行备份/恢复等本机命令应先停止服务。 ### 接入第一个模型在“模型”中新建配置，选择 **OpenAI 兼容**，填写供应商的 API base URL、实际模型 ID、API Key 和输出上限。API Key 写入后加密保存，普通读取只返回是否已配置。模型页面的“测试”会真的调用配置的供应商，可能产生费用。供应商、价格与调用权限由部署者配置；本包不包含外部服务账户或密钥。如果只想检查本机链路，选择 **诊断测试（非 AI）**，模型 ID 可填 `diagnostic`，不需要外部 API Key。它返回明确标注的确定性测试内容。要检查工具续轮，在“插件”中新建并启用 `diagnostic` 包的工作区实例，然后在聊天中发送 `/diagnostic/tool hello`。这个结果只证明执行链路，不代表真实模型质量或商业端点已经连通。默认只允许公开 HTTPS 模型端点。本地模型需要实例管理员同时启用 `--allow-private-network` 和该模型的私网访问选项。普通工作区成员不能通过模型参数扩大网络访问范围。更换模型供应商或完整 API 地址时，必须重新填写密钥，或明确勾选“清除已保存密钥”。已有密钥不会自动转发到新地址；私网访问授权同样绑定实例管理员批准的供应商和目标。Webhook 的保存令牌遵守相同规则。 ### 开始使用 - 在聊天页选择模型，创建会话并发送消息；进行中的运行可停止。重置保留历史并开始新的上下文代次，分支会建立新会话。 - 在“知识库”导入 UTF-8 文本或 Markdown。当前检索为词法检索，引用显示来源片段；PDF/Office、图片和音视频尚不支持。 - 在“长期记忆”显式保存可编辑内容，按需停用或归档。它不会自动把全部聊天写成永久记忆。 - 计划任务需要先有模型与结果会话。一次任务使用绝对时间，日历任务使用指定 IANA 时区；错过的任务按 `skip` 策略处理。 - 实例管理员创建账户，再由有权限的工作区成员添加角色。私有资源按创建者及当前成员资格授权，工作区所有者不会自动获得其他成员的私聊内容。 - 管理员批准并启用 Webhook 路由后，可在“机器人与渠道”中显式发送，并查看自己的投递历史。发送请求使用固定幂等键；不确定时保留原操作。`accepted` 只表示目标 HTTP 服务接受；不表示接收人阅读，也不声明目标支持幂等。接口与回执语义见 [HTTP 契约](docs/API_CONTRACT.md)。共享会话只自动检索共享知识、共享记忆和共享工具实例，也只能选择共享代理。私有会话仍可使用本人获准的私有资料。共享计划任务可供成员查看，只有任务所有者能改变其执行配置；有管理权限的人可以删除共享任务。退出登录、凭据过期或修改密码会取消相应凭据发起的对话运行；独立授权的计划任务继续检查所有者当前权限，不依赖某次浏览器登录。 ## 从源码构建 `mise.toml` 固定 Rust 1.99.1、Node.js 24.22.1、Python 3.15.2 和 .NET SDK 10.0.403。C# SDK 与完整协议检查需要 .NET 10 SDK；运行 Rust 服务和 WebUI 不需要 .NET。已经安装相应 Rust 工具链、Node.js 24、本机 C 编译/链接工具以及 OpenSSL 库和头文件时： ```sh npm --prefix web ci npm --prefix web run build cargo build --workspace --bins --locked ./target/debug/rstrbot --web-dir web/dist ``` 0.2.0 的 WebAuthn 使用 OpenSSL，JWT 校验使用 AWS-LC。源码构建依赖说明见 [rust-openssl](https://docs.rs/openssl/latest/openssl/) 与 [AWS-LC 平台要求](https://aws.github.io/aws-lc-rs/requirements/index.html)。例如 Debian/Ubuntu 需要 `pkg-config` 与 `libssl-dev`；Linux 动态链接的运行包也需要与构建匹配的 OpenSSL 运行库，准确依赖以二进制的 `ldd` 输出为准。构建优化版本与可执行归档： ```sh cargo build --release --workspace --bins --locked python3 scripts/package.py --profile release ``` 打包脚本只收集已构建的程序、静态页面与说明；包含嵌入式 [开发者教程](docs/DEVELOPER_TUTORIALS.md) 和两份项目开发技能，供离线查阅。它不会构建桌面安装器，也不应包含真实数据根、数据库、会话、密钥或个人凭据。平台名、构建类型、文件摘要以产物清单为准。桌面是独立工作区，不会随核心构建自动安装 GTK/WebKit/Tauri 依赖。桌面准备与本机编译步骤见 [桌面工程说明](docs/DESKTOP.md)。远程连接只打开明确指定的 HTTPS 工作区，不启动本机核心；本机模式使用相同的核心程序和业务页面。 ## 数据库、部署与备份默认 SQLite 适合单核心安装。首次部署前可通过 `RSTRBOT_DATABASE_URL` 选择 PostgreSQL；初始化页面直接显示两种数据库选项，支持测试已有 SQLite 文件或空 PostgreSQL schema，连接测试只读，不执行迁移，拒绝选择已有无关 schema。当前核心实际连接仍需初始建表权限；独立迁移角色、RLS 和多核心部署还没有完成验收。 Valkey 可选。配置 `RSTRBOT_VALKEY_URL` 后会显示 `connecting`、`available` 或 `degraded` 等实际状态，缓存中断不会成为授权或预算事实来源。运行 `rstrbot check` 可检查数据库和恢复状态；这个命令明确不测试供应商连通性。远程访问应通过 HTTPS 反向代理，把核心 HTTP 端口限制在代理能够访问的范围。`--secure-cookie` 仅添加 Cookie 安全属性，不为核心端口提供 TLS。默认 loopback 启动适合本机使用；非 loopback 启动要求明确设置安全 Cookie。Host/Origin 转发规则与具体部署步骤见 [运维说明](docs/OPERATIONS.md)。当前 `--secure-cookie`、`--allow-private-network` 的正向设置会保存到配置；省略标志不会把已有 `true` 关闭。关闭时应先停止服务，明确编辑数据根中受保护的 `config.json`，把相应字段设为 `false` 后重新启动。`valkey_url` 同样可通过受保护配置设为 `null` 清除。不要把数据库密码、供应商密钥或初始化凭据提交到 Git。本机数据库备份需要先停止服务，并写入新的文件： ```sh ./rstrbot --data-dir "$HOME/.local/share/rstrbot" backup \ --output /absolute/protected/path/rstrbot-db.json ``` 备份包含数据库事实，包括会话中保存的文本附件，因此必须保护备份内容；**不包含** `secrets.key` 和外部附件、插件数据，需要分别受保护地保存。登录会话令牌不导出，恢复只能进入空目标并默认暂停外部执行。恢复原密钥、核对未知费用及外部投递回执后，再由管理员明确退出恢复模式；恢复不会自动重发不确定的消息。完整恢复与账户密码救援步骤见 [运维说明](docs/OPERATIONS.md)。 ## 验证与支持范围 ```sh cargo fmt --all -- --check cargo clippy --workspace --all-targets --locked -- -D warnings cargo test --workspace --all-targets --locked npm --prefix web test python3 tests/plugin_conformance.py python3 tests/plugin_mcp.py python3 tests/integration.py --output test-results/integration.json python3 tests/delivery_integration.py --output test-results/delivery.json python3 tests/delivery_session_revocation.py --output test-results/delivery-session-revocation.json python3 tests/stream_persistence.py --output test-results/stream-persistence.json python3 tests/history_recovery.py --output test-results/history-recovery.json python3 tests/shared_context_privacy.py --output test-results/shared-context-privacy.json python3 tests/schedule_authority.py --output test-results/schedule-authority.json python3 tests/session_revocation.py --output test-results/session-revocation.json python3 tests/model_target_authority.py --output test-results/model-target-authority.json python3 tests/model_test_revocation.py --output test-results/model-test-revocation.json python3 tests/identity_integration.py --output test-results/identity.json ``` 运行测试前先构建程序和 WebUI。PostgreSQL 行为测试使用一次性的测试 schema；参数与环境变量见测试脚本和 CI 配置，勿指向生产数据库。四 SDK 缺少运行时会被记录为 `not_executed`，使用 `--require-all` 才会把缺失项作为失败。核心测试不会自动验证独立的 Tauri 工程。当前回执保存到 [docs/evidence/v0.2.0](docs/evidence/v0.2.0/)，记录环境、二进制摘要和检查结果；[docs/evidence](docs/evidence/) 中其余记录保留为历史。旧回执只适用于它记录的二进制；CI 工作流存在不代表 GitHub Actions 已运行成功。本地 HTTP 测试使用 diagnostic 和模拟上游，不能替代真实收费供应商或聊天平台账号测试。浏览器验收入口见 [tests/browser](tests/browser/README.md)，包含原有真实聊天、工具、分页、撤权、迟到响应和缓存保护回归；另有账户安全与 WebAuthn 虚拟认证器验证，覆盖邮箱、多个凭据及换绑。准确数量见 0.2.0 的两份浏览器回执。当前没有桌面安装/升级/签名回执，没有 Windows 插件 named pipe / 进程树验收，也没有读屏和全部浏览器兼容性验收。已执行与未执行的区别、全部功能缺口见 [52 项验收追踪](docs/ACCEPTANCE.md)。 ## 项目导航 | 路径 | 内容 | | --- | --- | | `src/` | HTTP API、运行引擎、计划任务、知识处理、投递、状态与 CLI | | `crates/rstrbot-store/` | SQLite / PostgreSQL、认证授权、事件、操作记录、预算与备份 | | `crates/rstrbot-plugin/` | Unix worker 宿主、公开 Rust SDK 和三个独立插件程序 | | `web/` | React / TypeScript 前端与聚焦测试 | | `desktop/` | Tauri 2 启动器和 sidecar 资源准备脚本 | | `sdk/` | 四种语言协议实现、示例与一致性向量 | | `tests/` | 真实进程、HTTP、MCP、缓存恢复和投递验证入口 | | `docs/blueprint/` | 保留原始设计、研究、52 项需求与完整需求映射 | | `docs/` | [开发者教程](docs/DEVELOPER_TUTORIALS.md)、[API 契约](docs/API_CONTRACT.md)、[插件协议](docs/PLUGIN_PROTOCOL.md)、[WebUI](docs/UI.md)、[运维](docs/OPERATIONS.md)、[桌面](docs/DESKTOP.md)、[验收](docs/ACCEPTANCE.md) | | `.agents/skills/` | 本项目开发技能与插件开发技能 | ## 许可项目的发布许可见 [LICENSE](LICENSE)，第三方依赖及引用材料保留各自许可与来源。原始设计包和引用的研究材料不表示本项目拥有第三方项目代码或品牌。

Chargement du README du dépôt…

Skills dans ce dépôt

classification en attente

skill

métier

description

mis à jour

rstrbot-development

non classé

Use when changing RstrBot core, web UI, API, persistence, deployment, or repository documentation.

Langue du texte source : Plusieurs langues

2026-10-29

rstrbot-plugin-development

non classé

Use when building, reviewing, or documenting RstrBot executable plugins or language SDKs.

Langue du texte source : anglais

2026-10-29

Affichage de 2 skills collectés sur 2.