docs: add complete Chinese documentation

This commit is contained in:
wuyang
2026-07-26 21:32:12 +08:00
parent 66109235e2
commit e2e7a7ba37
24 changed files with 1251 additions and 14 deletions
+48
View File
@@ -0,0 +1,48 @@
# K1412 Agent 中文文档
中文 · [English](README.md)
本目录是 K1412 Agent 的权威技术记录。公开文档门户
<https://agent.k1412.top/doc/> 是同一套设计的精选呈现。行为、基础设施或实验发生变化时,
应在同一个 commit 中同时更新对应的 Markdown 文档和门户摘要。
## 从这里开始
| 文档 | 适合读者 | 回答的问题 |
| --- | --- | --- |
| [架构](architecture.zh-CN.md) | 所有人 | 哪些组件运行在哪里?为什么这样划分边界? |
| [Agent Loop](agent-loop.zh-CN.md) | Agent 研究者、后端工程师 | 上下文、工具、调度、证据、记忆和子 Agent 如何工作? |
| [实验体系](experiments.zh-CN.md) | Agent 研究者 | 如何修改 Loop,同时保持实验可比性和生产安全? |
| [项目历史](project-history.zh-CN.md) | 维护者 | 已经做出了哪些产品和架构决策? |
| [Open WebUI 集成](openwebui-integration.zh-CN.md) | 前端、平台工程师 | 哪些职责属于 Open WebUI,哪些仍由 K1412 负责? |
| [安全模型](security.zh-CN.md) | 安全、平台工程师 | 用户、凭据、工作区和 Docker 如何隔离? |
| [基础设施地图](infrastructure.zh-CN.md) | 运维人员 | 哪些是共享基础设施,哪些属于 Agent 核心? |
| [开发与验证](development.zh-CN.md) | 贡献者 | 如何运行、测试并安全修改系统? |
| [运维手册](operations.zh-CN.md) | 运维人员 | 如何构建、部署、验证、备份和迁移生产环境? |
## 当前产品约定
- 用户只看到一种模式:K1412 Agent Loop。早期的 Chat/Work 双模式已被有意移除。
- Open WebUI 负责账户、会话、审批、对话存储和聊天外壳;K1412 负责 Agent 行为。
- 服务端定义四个模型选项:Luna、Terra、Sol、DeepSeek V4 Pro。模型身份和思考能力
分开显示。
- 每个 Open WebUI 用户都会在专用物理执行主机上获得独立的 Docker 容器、网络和持久卷。
- 生成文件可以通过已鉴权的 Web UI 浏览和下载,内部依赖目录默认隐藏。
- Provider 凭据、内部提示词、Docker 权限、SSH 配置和工具服务凭据都不能在浏览器配置。
## 哪些部分属于实验
稳定的平台边界包括鉴权、用户/工作区隔离、持久存储和公开的 OpenAI 兼容 Runtime API。
计划持续实验的范围包括:
- 上下文选择与压缩;
- 记忆检索与生命周期;
- 工具描述、规范化和路由;
- 并行调度与变更串行化;
- 子 Agent 委派策略;
- 证据和完成门禁;
- 恢复提示词与重试策略;
- 模型路由与各档预算。
每项实验都应在运行事件中记录版本,并在进入生产环境前针对固定任务集完成评测。详见
[实验体系](experiments.zh-CN.md)。