Skip to content

Commit e6cf9c5

Browse files
SnailclimbSnailclimb
committed
docs: improve guides and legacy redirects
1 parent 43b3c85 commit e6cf9c5

11 files changed

Lines changed: 350 additions & 270 deletions

File tree

‎docs/.vuepress/sidebar/index.ts‎

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -493,10 +493,6 @@ export default sidebar({
493493
prefix: "distributed-system/",
494494
collapsible: true,
495495
children: [
496-
{
497-
text: "分布式系统知识体系",
498-
link: "/distributed-system/",
499-
},
500496
{
501497
text: "分布式系统入门",
502498
link: "distributed-system-intro",
@@ -613,10 +609,6 @@ export default sidebar({
613609
prefix: "high-performance/",
614610
collapsible: true,
615611
children: [
616-
{
617-
text: "高性能系统知识体系",
618-
link: "/high-performance/",
619-
},
620612
{
621613
text: "⭐高性能系统设计高频面试题",
622614
link: "high-performance-system-interview-questions",
@@ -668,10 +660,6 @@ export default sidebar({
668660
prefix: "high-availability/",
669661
collapsible: true,
670662
children: [
671-
{
672-
text: "高可用系统知识体系",
673-
link: "/high-availability/",
674-
},
675663
{
676664
text: "⭐高可用系统面试题总结",
677665
link: "high-availability-system-interview-questions",

‎docs/.vuepress/theme.ts‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,52 @@ const docsearchOptions =
2525
const MIN_META_DESCRIPTION_LENGTH = 150;
2626
const MAX_META_DESCRIPTION_LENGTH = 160;
2727

28+
// Keep high-value legacy URLs found in Search Console working after file moves.
29+
// The redirect plugin normalizes directory-style sources to `index.html`.
30+
const legacyRedirects = {
31+
"/ai/ai-coding/cc-glm5.1.html": "/ai-coding/cases/cc-glm5.1.html",
32+
"/ai/ai-coding/trae-m2.7.html": "/ai-coding/cases/trae-m2.7.html",
33+
"/ai/llm-basis/ai-ide.html": "/ai-coding/practices/ai-ide.html",
34+
"/category/分布式系统/": "/distributed-system/",
35+
"/cs-basics/data-structure/bloom-filter/":
36+
"/cs-basics/data-structure/bloom-filter.html",
37+
"/cs-basics/network/osi&tcp-ip-model.html":
38+
"/cs-basics/network/osi-and-tcp-ip-model.html",
39+
"/database/mysql/mysql知识点&面试题总结/":
40+
"/database/mysql/mysql-questions-01.html",
41+
"/distributed-system/protocol/gossip-protocl.html":
42+
"/distributed-system/protocol/gossip-protocol.html",
43+
"/distributed-system/theorem&algorithm&protocol/cap&base-theorem.html":
44+
"/distributed-system/protocol/cap-and-base-theorem.html",
45+
"/distributed-system/theorem&algorithm&protocol/paxos-algorithm.html":
46+
"/distributed-system/protocol/paxos-algorithm.html",
47+
"/distributed-system/theorem&algorithm&protocol/raft-algorithm.html":
48+
"/distributed-system/protocol/raft-algorithm.html",
49+
"/distributed-system/理论&算法/paxos&raft算法/":
50+
"/distributed-system/protocol/",
51+
"/high-performance/读写分离&分库分表/":
52+
"/high-performance/read-and-write-separation-and-library-subtable.html",
53+
"/interview-preparation/java-interview-plan.html":
54+
"/interview-preparation/backend-interview-plan.html",
55+
"/java/basis/why-there-only-value-passing-in-java/":
56+
"/java/basis/why-there-only-value-passing-in-java.html",
57+
"/java/collection/arraylist-source-code/":
58+
"/java/collection/arraylist-source-code.html",
59+
"/java/collection/concurrent-hash-map-source-code/":
60+
"/java/collection/concurrent-hash-map-source-code.html",
61+
"/java/collection/hashmap-source-code/":
62+
"/java/collection/hashmap-source-code.html",
63+
"/java/concurrent/java并发进阶常见面试题总结/":
64+
"/java/concurrent/java-concurrent-questions-02.html",
65+
"/java/jvm/jvm-parameters-intro/": "/java/jvm/jvm-parameters-intro.html",
66+
"/system-design/basis/naming/": "/system-design/basis/naming.html",
67+
"/system-design/framework/netty/": "/system-design/framework/netty.html",
68+
"/system-design/security/advantages&disadvantages-of-jwt.html":
69+
"/system-design/security/advantages-and-disadvantages-of-jwt.html",
70+
"/zh-CN/jwt-authentication-pros-and-cons/":
71+
"/system-design/security/advantages-and-disadvantages-of-jwt.html",
72+
};
73+
2874
const segmentDisplayNames = {
2975
ai: "AI",
3076
"ai-coding": "AI 编程",
@@ -231,6 +277,9 @@ export default hopeTheme({
231277
codeTabs: true,
232278
mermaid: true,
233279
gfm: true,
280+
linksCheck: {
281+
build: "error",
282+
},
234283
include: {
235284
resolvePath: (file, cwd) => {
236285
if (file.startsWith("@"))
@@ -447,6 +496,10 @@ export default hopeTheme({
447496
changefreq: "monthly",
448497
},
449498

499+
redirect: {
500+
config: legacyRedirects,
501+
},
502+
450503
// The upstream copyright plugin can throw during hydration if `#app` is unavailable.
451504
// Keep it disabled until the plugin adds a null-safe mount path.
452505
copyright: false,

‎docs/ai/agent/harness-engineering.md‎

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,26 @@
11
---
2-
title: Harness Engineering：六层检查框架、上下文管理与工程实践
3-
description: 深度解析 Harness Engineering，梳理 Agent = Model + Harness 的核心定义，拆解 OpenAI、Anthropic、Stripe 等一线团队的实战经验与踩坑教训。
2+
title: Harness 是什么？Harness Engineering 六层架构与 Agent 工程实践
3+
description: Harness 是什么？本文从 Agent = Model + Harness 出发，讲解 Agent Harness 的六层架构、上下文管理、工具调用、验证闭环与故障恢复，并结合 OpenAI、Anthropic、Stripe 等团队的工程实践说明设计取舍。
44
category: AI 应用开发
55
head:
66
- - meta
77
- name: keywords
8-
content: Harness Engineering,AI Agent,智能体,Claude Code,Codex,AGENTS.md,上下文工程,Agent架构
8+
content: Harness是什么,Harness Engineering,Agent Harness,Harness架构,Harness工程,AI Agent,智能体,Claude Code,Codex,AGENTS.md,上下文工程,Agent架构
99
---
1010

11+
Agent Harness 是运行在大模型外部的一套执行系统。它负责组织上下文、提供工具和执行环境，并把权限控制、状态管理、结果验证与失败恢复接入任务流程。Harness Engineering 研究的就是这套系统应该怎样设计。
12+
1113
Can.ac 的一次编码评测中，同一个模型仅替换文件编辑接口，得分就从 6.7% 升到 68.3%。模型参数没有变化，差别出在接口提供了什么操作、怎样返回结果，以及错误能否被下一步利用。
1214

1315
这类差异也解释了常见的 Agent 故障：重复调工具、忽略约束或在长任务中丢失状态，往往不能只靠换模型或补一句提示词解决。工具接口、执行环境、反馈和恢复机制同样决定任务能否继续。
1416

15-
Harness Engineering 讨论的就是这套模型外部系统。下文先拆开它的组件与分层，再对照 OpenAI、Anthropic、Stripe 和 Mitchell Hashimoto 的实现取舍。
17+
后文先看 Harness 的组件与分层，再对照 OpenAI、Anthropic、Stripe 和 Mitchell Hashimoto 的实现取舍。
1618

17-
## Harness 基本概念
19+
## Harness 是什么？
1820

19-
### Harness 到底是什么？
21+
### Agent = Model + Harness
2022

21-
可以先记住一个工程上的划分：Agent = Model + Harness。模型负责推理和生成；Harness 管理系统提示词、工具调用、文件系统、沙箱、编排逻辑、钩子中间件、反馈回路和约束。
23+
工程上常用 `Agent = Model + Harness` 区分两部分。模型负责推理和生成；Harness 管理系统提示词、工具调用、文件系统、沙箱、编排逻辑、钩子中间件、反馈回路和约束。
2224

2325
模型本身不会保存跨会话状态，也无法执行命令或读取测试结果。Harness 要把任务状态、操作入口、执行环境和安全边界接起来，使模型输出转成可验证的动作。
2426

0 commit comments

Comments
 (0)