Skip to content

Commit 203f4c3

Browse files
phodalphodal
committed
feat(implementation): add knowledge architecture section to documentation with enhanced context for AI programming
1 parent 142b979 commit 203f4c3

File tree

3 files changed

+221
-4
lines changed

3 files changed

+221
-4
lines changed

‎docs/ai-friendly/ai-friendly-platform-engineering.mdx

+45-4
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ import {
2525
Zap
2626
} from 'lucide-react'
2727
import { PlatformEngFlow } from '../../src/components/PlatformEngFlow'
28+
import { DevKnowledgeArchitecture } from '../../src/components/DevKnowledgeArchitecture'
2829

2930
export const PlatformEngineering = () => {
3031
const [activeSection, setActiveSection] = useState(null);
@@ -34,7 +35,8 @@ export const PlatformEngineering = () => {
3435
const aiTemplatesRef = useRef(null);
3536
const lowCodeRef = useRef(null);
3637
const idpGovernanceRef = useRef(null);
37-
const aiMetricsRef = useRef(null); // 添加新的引用
38+
const knowledgeArchRef = useRef(null); // 添加知识架构系统的引用
39+
const aiMetricsRef = useRef(null);
3840

3941
const scrollToSection = (section) => {
4042
setActiveSection(section);
@@ -45,7 +47,8 @@ export const PlatformEngineering = () => {
4547
'ai-templates': aiTemplatesRef,
4648
'low-code': lowCodeRef,
4749
'idp-governance': idpGovernanceRef,
48-
'ai-metrics': aiMetricsRef // 添加新的映射
50+
'knowledge-arch': knowledgeArchRef, // 添加知识架构系统的映射
51+
'ai-metrics': aiMetricsRef
4952
};
5053

5154
const ref = refs[section];
@@ -65,7 +68,7 @@ export const PlatformEngineering = () => {
6568
<div className="mb-8">
6669
<PlatformEngFlow onClickSection={scrollToSection}/>
6770
</div>
68-
71+
6972
{/* 1. 标准化智能 API */}
7073
<div ref={standardApiRef} className="mt-12">
7174
<div className="section-header">
@@ -688,7 +691,45 @@ export const PlatformEngineering = () => {
688691
</div>
689692
</div>
690693

691-
{/* 6. AI 效能度量 - 新增部分 */}
694+
{/* 知识系统架构 - 放在IDP部分之后 */}
695+
<div ref={knowledgeArchRef} className="mt-12">
696+
<div className="section-header">
697+
<h2 className="section-title bg-cyan-600">开发者知识系统架构</h2>
698+
<p className="text-slate-600">整合于IDP的知识图谱体系，为AI编程提供结构化上下文</p>
699+
</div>
700+
701+
<DevKnowledgeArchitecture />
702+
703+
<div className="mt-4 p-6 bg-cyan-50 rounded-lg">
704+
<h3 className="text-xl font-semibold mb-4 text-center">知识系统与IDP治理的协同</h3>
705+
706+
<div className="grid-2">
707+
<div className="bg-white p-5 rounded-lg shadow">
708+
<h4 className="font-semibold mb-2 text-cyan-600">上下文增强循环</h4>
709+
<p className="text-slate-600">
710+
知识系统持续采集和结构化组织数据，IDP提供治理框架和访问控制，共同为AI工具提供高质量、安全可控的上下文
711+
</p>
712+
<div className="mt-2 flex items-center text-green-600 text-sm">
713+
<CheckCircle className="h-4 w-4 mr-1" />
714+
<span>创建自我优化的知识闭环</span>
715+
</div>
716+
</div>
717+
718+
<div className="bg-white p-5 rounded-lg shadow">
719+
<h4 className="font-semibold mb-2 text-cyan-600">团队知识协作</h4>
720+
<p className="text-slate-600">
721+
将分散在不同团队和系统中的知识统一管理，通过IDP提供的治理能力确保知识共享的同时保障安全合规
722+
</p>
723+
<div className="mt-2 flex items-center text-green-600 text-sm">
724+
<CheckCircle className="h-4 w-4 mr-1" />
725+
<span>打破组织信息孤岛</span>
726+
</div>
727+
</div>
728+
</div>
729+
</div>
730+
</div>
731+
732+
{/* 6. AI 效能度量 */}
692733
<div ref={aiMetricsRef} className="mt-12">
693734
<div className="section-header">
694735
<h2 className="section-title bg-green-700">度量 AI 质量与生产力</h2>

‎src/components/DevKnowledgeArchitecture.jsx

+171
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
1+
import React from 'react'
2+
import {
3+
Box,
4+
Database,
5+
Code,
6+
GitBranch,
7+
BarChart,
8+
FileText,
9+
Layers,
10+
Link as LinkIcon,
11+
Webhook,
12+
GitCommit,
13+
Network,
14+
Search,
15+
FileSearch,
16+
ExternalLink,
17+
Puzzle,
18+
Component,
19+
Users,
20+
MessageSquare,
21+
ArrowRight
22+
} from 'lucide-react'
23+
24+
export const DevKnowledgeArchitecture = () => {
25+
return (
26+
<div>
27+
<div className="text-center mb-8">
28+
<h2 className="text-2xl font-bold text-slate-800 mb-2">开发者知识系统架构</h2>
29+
<p className="text-slate-600">整合多源数据，构建知识图谱，为 AI 工具提供统一上下文</p>
30+
</div>
31+
32+
<div className="grid-3 mb-8">
33+
<div className="card">
34+
<div className="icon-circle bg-blue-600">
35+
<Database className="h-6 w-6 text-white" />
36+
</div>
37+
<h3 className="text-xl font-semibold mb-2">开发工具数据源</h3>
38+
<p className="text-slate-600 mb-4">各类开发工具资源作为知识基础</p>
39+
40+
<div className="bg-slate-100 p-4 rounded-lg">
41+
<ul className="space-y-2">
42+
<li className="flex items-start">
43+
<span className="text-blue-600 mr-2">•</span>
44+
<span>代码仓库与版本历史</span>
45+
</li>
46+
<li className="flex items-start">
47+
<span className="text-blue-600 mr-2">•</span>
48+
<span>问题跟踪与项目管理</span>
49+
</li>
50+
<li className="flex items-start">
51+
<span className="text-blue-600 mr-2">•</span>
52+
<span>CI/CD 系统与监控平台</span>
53+
</li>
54+
<li className="flex items-start">
55+
<span className="text-blue-600 mr-2">•</span>
56+
<span>文档平台与服务目录</span>
57+
</li>
58+
</ul>
59+
</div>
60+
</div>
61+
62+
<div className="card">
63+
<div className="icon-circle bg-green-600">
64+
<Network className="h-6 w-6 text-white" />
65+
</div>
66+
<h3 className="text-xl font-semibold mb-2">知识图谱</h3>
67+
<p className="text-slate-600 mb-4">关联数据与结构化信息</p>
68+
69+
<div className="bg-slate-100 p-4 rounded-lg">
70+
<ul className="space-y-2">
71+
<li className="flex items-start">
72+
<span className="text-green-600 mr-2">•</span>
73+
<span>实体：代码、服务、团队、文档</span>
74+
</li>
75+
<li className="flex items-start">
76+
<span className="text-green-600 mr-2">•</span>
77+
<span>关系：依赖、所有权、变更历史</span>
78+
</li>
79+
<li className="flex items-start">
80+
<span className="text-green-600 mr-2">•</span>
81+
<span>语义索引：自然语言检索</span>
82+
</li>
83+
<li className="flex items-start">
84+
<span className="text-green-600 mr-2">•</span>
85+
<span>上下文关联：跨系统信息链接</span>
86+
</li>
87+
</ul>
88+
</div>
89+
</div>
90+
91+
<div className="card">
92+
<div className="icon-circle bg-purple-600">
93+
<Users className="h-6 w-6 text-white" />
94+
</div>
95+
<h3 className="text-xl font-semibold mb-2">开发者体验</h3>
96+
<p className="text-slate-600 mb-4">统一知识访问与交互</p>
97+
98+
<div className="bg-slate-100 p-4 rounded-lg">
99+
<ul className="space-y-2">
100+
<li className="flex items-start">
101+
<span className="text-purple-600 mr-2">•</span>
102+
<span>统一搜索：跨系统资源检索</span>
103+
</li>
104+
<li className="flex items-start">
105+
<span className="text-purple-600 mr-2">•</span>
106+
<span>AI 助手：基于全局上下文理解</span>
107+
</li>
108+
<li className="flex items-start">
109+
<span className="text-purple-600 mr-2">•</span>
110+
<span>可视化：关系图谱动态展示</span>
111+
</li>
112+
<li className="flex items-start">
113+
<span className="text-purple-600 mr-2">•</span>
114+
<span>上下文链接：相关资源智能推荐</span>
115+
</li>
116+
</ul>
117+
</div>
118+
</div>
119+
</div>
120+
121+
<div className="bg-blue-50 p-6 rounded-lg">
122+
<h3 className="text-xl font-semibold mb-4 text-center">知识流转与反馈循环</h3>
123+
124+
<div className="relative flex justify-between items-center mb-4 px-12">
125+
<div className="flex flex-col items-center">
126+
<div className="icon-circle bg-blue-600 mb-2">
127+
<Code className="h-5 w-5 text-white" />
128+
</div>
129+
<div className="text-center text-sm font-medium">数据收集</div>
130+
</div>
131+
<ArrowRight className="text-blue-600" size={24} />
132+
<div className="flex flex-col items-center">
133+
<div className="icon-circle bg-green-600 mb-2">
134+
<Database className="h-5 w-5 text-white" />
135+
</div>
136+
<div className="text-center text-sm font-medium">知识处理</div>
137+
</div>
138+
<ArrowRight className="text-blue-600" size={24} />
139+
<div className="flex flex-col items-center">
140+
<div className="icon-circle bg-purple-600 mb-2">
141+
<Search className="h-5 w-5 text-white" />
142+
</div>
143+
<div className="text-center text-sm font-medium">知识访问</div>
144+
</div>
145+
<ArrowRight className="text-blue-600" size={24} />
146+
<div className="flex flex-col items-center">
147+
<div className="icon-circle bg-indigo-600 mb-2">
148+
<MessageSquare className="h-5 w-5 text-white" />
149+
</div>
150+
<div className="text-center text-sm font-medium">用户反馈</div>
151+
</div>
152+
</div>
153+
154+
<div className="grid-2 mt-6">
155+
<div className="bg-white p-5 rounded-lg shadow">
156+
<h4 className="font-semibold mb-2 text-blue-700">集成平台</h4>
157+
<p className="text-slate-600 text-sm">
158+
作为内部开发平台(IDP)的插件或组件，与现有工具生态无缝集成，提供统一入口
159+
</p>
160+
</div>
161+
<div className="bg-white p-5 rounded-lg shadow">
162+
<h4 className="font-semibold mb-2 text-blue-700">AI 上下文增强</h4>
163+
<p className="text-slate-600 text-sm">
164+
为各种 AI 工具提供丰富的组织特定上下文，显著提升代码生成、问题解决和文档生成能力
165+
</p>
166+
</div>
167+
</div>
168+
</div>
169+
</div>
170+
)
171+
}

‎src/css/custom.css

+5
Original file line numberDiff line numberDiff line change
@@ -443,6 +443,11 @@ button {
443443
color: rgb(126 34 206 / var(--tw-text-opacity, 1));
444444
}
445445

446+
.bg-purple-600 {
447+
background-color: #7c3aed;
448+
color: white;
449+
}
450+
446451
.space-x-8 > * + * {
447452
--tw-space-x-reverse: 0;
448453
margin-right: calc(2rem * var(--tw-space-x-reverse));

0 commit comments

Comments
 (0)