简体中文 | English
Rust 原生、本地优先的 LLM 编码 Harness:数据落在一个 DuckDB 文件里,事件可追踪, 规格驱动开发的门禁由程序执行。原生 GUI、TUI、CUI、Web、SSH 多前端共享同一套应用服务。
- 本地优先:单文件 DuckDB 持久化,数据可随时带走;不强制账户与联网。
- 事件可追踪:工具执行按“意图—执行—登记”留痕;默认追踪级别
redacted,凭据不落日志与事件。 - 多前端:GUI/TUI/CUI/Web/SSH 共享同一应用服务;桌面界面原生渲染,不内嵌浏览器引擎。
- 规格驱动:需求、任务与验收三方追溯,门禁由测试与脚本强制执行。
版本 0.1.0(2026-11-16 发布);变更与已知限制见 CHANGELOG.md。
M0—M6、M8 与四端对等收口已实现,M7 SSH 服务端已实现。M9 的 5.5 小时稳定性长跑 尚无合格数据,真实 LLM 供应商的客户端装配未交付。逐项进度、未完成原因与证据位置见 项目状态快照,权威账本是 tasks.md 与 checklist.md,已知限制见 compatibility.md。
| 平台 | 定位 |
|---|---|
| Windows 11 amd64 | 唯一验收目标(x86_64-pc-windows-gnullvm,ADR-073) |
| Windows ARM64 | 构建交付目标(ADR-043):CI 结果仅作平台证据,不进验收 |
| FreeBSD | 完整平台证据通道(硬门禁):CI 随 main 全量构建、测试与门禁,任一失败即红;不作验收结论 |
| NetBSD | CI 每周定时与手动触发运行,仅平台证据(ADR-082) |
| OpenBSD/DragonFly | 手工占位;与 NetBSD 同为 SSH 远程开发目标(作为被连入端,不要求原生工具链) |
性能分位数目前仅取自 Windows 通道。平台口径详见 ADR-013 与 compatibility.md。
需要 Rust 1.100.0(rust-toolchain.toml 已锁定)、LLVM 系列工具链(rustc gnullvm + llvm-mingw,安装见 python .github/scripts/setup-windows-llvm.py)与 Python 3;
不使用任何 GNU 工具链。
# 首次构建前拉取并校验 DuckDB 动态库(SHA256)
python .github/scripts/fetch-duckdb.py
cargo build --locked --workspace
cargo test --locked --workspace
# 环境自检
cargo run -p whcode-bin --release -- doctor
# 界面:Windows 默认 GUI;--tui 终端界面;--cli 命令行
cargo run -p whcode-bin --release --
cargo run -p whcode-bin --release -- --tui
cargo run -p whcode-bin --release -- --cli task list --session <会话 ID>
# Web(默认 HTTPS,自签证书;--tls off 回到明文)
cargo run -p whcode-bin --release -- serve --web
cargo run -p whcode-bin --release -- serve --web --tls off无参数启动时,Windows 默认打开原生 GUI;加 --tui 进入终端界面(1—6 切换视图,
q 退出),加 --cli 使用命令行。TUI 在伪终端(Git Bash/mintty)或控制台 QuickEdit
选择模式下收不到键盘输入,请用 Windows Terminal 或 conhost 运行;
完整键位与视图说明见 tui.md。
没有可用控制台时(CI、管道、重定向),程序不启动界面,打印提示后以退出码 0 结束。
| 入口 | 启动 | 说明 |
|---|---|---|
| GUI | whcode(Windows 默认)或 whcode gui |
原生只读界面,不内嵌浏览器引擎 |
| TUI | whcode --tui |
六视图只读,写操作两段确认,见 tui.md |
| CUI | whcode --cli <子命令> 或直接 whcode <子命令> |
--json 统一信封与稳定退出码,见 cui-manual.md |
| Web | whcode serve --web |
默认仅回环,入站 TLS 默认启用,见 web-deployment-security.md |
| SSH | whcode serve --ssh |
受限入口,不默认授予系统 Shell;四平台现场验收延后 |
- docs/guides/README.md:全部指南的索引(构建、TUI、CUI、Web、 并发与性能、资源预算、工程过程)
- specs/001-whcode-harness/:需求基线、任务、验收清单与接口契约
- docs/adr/:架构决策记录
- docs/matrices/:平台矩阵、决策台账、兼容性与能力对等矩阵
- docs/guides/project-status.md:项目状态快照
接受 Issue 与 PR,贡献流程与每 PR 必过的核对清单见 CONTRIBUTING.md。 提交即表示同意以 BSD-2-Clause 授权本项目。项目由 FreeBSD 中文社区维护, 欢迎讨论 BSD 移植、中文本地化与终端体验。
请勿通过公开 Issue 报告安全漏洞,报告渠道与安全不变量见 SECURITY.md。
BSD-2-Clause © 2026 FreeBSD 中文社区(FreeBSD Chinese Community)。