docs: add complete Chinese documentation
This commit is contained in:
@@ -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)。
|
||||
Reference in New Issue
Block a user