@umacloud/knowledge 1.0.16 → 1.0.18

package/design-systems/soft-warm.md

@@ -2,7 +2,7 @@
 id: soft-warm
 title: Soft Warm
 domain: design-systems
-category: soft-warm.md
+category: design-systems
 difficulty: intermediate
 tags: [borders, color, component, design-systems, palette, patterns, radius, soft]
 quality_score: 70

package/design-systems/tech-utility.md

@@ -2,7 +2,7 @@
 id: tech-utility
 title: Tech Utility
 domain: design-systems
-category: tech-utility.md
+category: design-systems
 difficulty: intermediate
 tags: [color, component, design-systems, motion, palette, patterns, spacing, tech]
 quality_score: 70

package/development/00-governance/document-template.md

@@ -1,14 +1,14 @@
 ---
 id: document-template
-title: document-template
+title: 知识库标准文档模板
 domain: development
 category: 00-governance
 difficulty: intermediate
-tags: [development, document, template, 失败模式, 执行步骤, 检查清单, 目标, 适用范围]
+tags: [文档模板, template, 知识库, 写作规范, standard, governance, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# document-template
+# 知识库标准文档模板
 
 ```yaml
 id: KB-DEV-XXXX

package/development/01-standards/golang-complete.md

@@ -5,8 +5,8 @@ domain: development
 category: 01-standards
 difficulty: intermediate
 tags: [complete, development, golang, 并发模型, 性能优化, 接口设计, 标准库精选, 核心语法]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 91
+last_updated: 2026-06-29
 ---
 # Go 语言完整工程指南
 

package/development/01-standards/python-design-patterns.md

@@ -5,8 +5,8 @@ domain: development
 category: 01-standards
 difficulty: intermediate
 tags: [agent, checklist, design, development, patterns, python, python特有模式, 创建型模式]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 92
+last_updated: 2026-06-29
 ---
 # Python设计模式完整知识体系
 

package/development/01-standards/typescript-advanced-types.md

@@ -5,8 +5,8 @@ domain: development
 category: 01-standards
 difficulty: intermediate
 tags: [advanced, development, types, typescript, 与框架集成, 内置工具类型, 基础类型系统回顾, 完整指南]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 91
+last_updated: 2026-06-29
 ---
 # TypeScript 高级类型系统完整指南
 

package/development/09-maturity/quarterly-audit-template.md

@@ -1,16 +1,14 @@
 ---
 id: quarterly-audit-template
-title: quarterly-audit-template
+title: 季度审计模板
 domain: development
 category: 09-maturity
 difficulty: intermediate
-tags: [audit, development, quarterly, template, 季度审计模板]
+tags: [审计, audit, 季度审计, 模板, 成熟度, 治理, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# quarterly-audit-template
-
-## 季度审计模板
+# 季度审计模板
 
 ### 审计概览
 - 审计周期：

package/development/11-ui-excellence/ui-aesthetic-system.md

@@ -1,16 +1,14 @@
 ---
 id: ui-aesthetic-system
-title: ui-aesthetic-system
+title: UI美学系统总册
 domain: development
 category: 11-ui-excellence
 difficulty: intermediate
-tags: [aesthetic, development, system, ui美学系统总册]
+tags: [ui, 美学系统, aesthetic, 设计系统, 视觉规范, 前端, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# ui-aesthetic-system
-
-## UI美学系统总册
+# UI美学系统总册
 
 ### 目标
 - 让界面同时满足“好看、好用、好做、可持续演进”。

package/development/13-implementation-assets/knowledge-gates-execution.md

@@ -1,16 +1,14 @@
 ---
 id: knowledge-gates-execution
-title: knowledge-gates-execution
+title: 知识门禁执行手册
 domain: development
 category: 13-implementation-assets
 difficulty: intermediate
-tags: [development, execution, gates, knowledge, 知识门禁执行手册]
+tags: [知识门禁, gates, 执行, 落地, 治理, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# knowledge-gates-execution
-
-## 知识门禁执行手册
+# 知识门禁执行手册
 
 ### 目标
 - 把开发知识规则接入发布链路，避免知识与交付脱节。

package/development/api-contract-and-versioning-guide.md

@@ -1,16 +1,14 @@
 ---
 id: api-contract-and-versioning-guide
-title: api-contract-and-versioning-guide
+title: API 契约与版本治理指南
 domain: development
-category: api-contract-and-versioning-guide.md
+category: 01-standards
 difficulty: intermediate
-tags: [and, api, contract, development, guide, versioning, 契约与版本治理指南]
+tags: [api, 契约, contract, 版本治理, versioning, 兼容性, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# api-contract-and-versioning-guide
-
-## API 契约与版本治理指南
+# API 契约与版本治理指南
 
 ### 目标
 - 保证前后端与外部调用方在接口演进中保持稳定兼容。

package/development/api-governance-complete.md

@@ -1,16 +1,14 @@
 ---
 id: api-governance-complete
-title: api-governance-complete
+title: API治理完整知识库
 domain: development
-category: api-governance-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [api, api治理完整知识库, complete, development, governance]
+tags: [api, 治理, governance, 契约优先, 版本, 网关, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# api-governance-complete
-
-## API治理完整知识库
+# API治理完整知识库
 
 ### 1. 契约优先
 - 接口先定义契约，再进入实现。

package/development/backend-engineering-complete.md

@@ -1,16 +1,14 @@
 ---
 id: backend-engineering-complete
-title: backend-engineering-complete
+title: 后端工程完整知识库
 domain: development
-category: backend-engineering-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [backend, complete, development, engineering, 后端工程完整知识库]
+tags: [后端, backend, 分层架构, 服务设计, 工程规范, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# backend-engineering-complete
-
-## 后端工程完整知识库
+# 后端工程完整知识库
 
 ### 1. 分层架构
 - 路由层只做协议适配与参数接收。

package/development/concurrency-reliability-complete.md

@@ -1,16 +1,14 @@
 ---
 id: concurrency-reliability-complete
-title: concurrency-reliability-complete
+title: 并发与稳定性完整知识库
 domain: development
-category: concurrency-reliability-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, concurrency, development, reliability, 并发与稳定性完整知识库]
+tags: [并发, concurrency, 稳定性, reliability, 线程, 锁, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# concurrency-reliability-complete
-
-## 并发与稳定性完整知识库
+# 并发与稳定性完整知识库
 
 ### 1. 并发模型
 - 共享资源必须定义并发访问策略。

package/development/database-engineering-complete.md

@@ -1,16 +1,14 @@
 ---
 id: database-engineering-complete
-title: database-engineering-complete
+title: 数据库工程完整知识库
 domain: development
-category: database-engineering-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, database, development, engineering, 数据库工程完整知识库]
+tags: [数据库, database, 数据模型, 索引, 事务, 性能, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# database-engineering-complete
-
-## 数据库工程完整知识库
+# 数据库工程完整知识库
 
 ### 1. 数据模型设计
 - 核心表必须定义主键、唯一约束、审计字段。

package/development/engineering-effectiveness-complete.md

@@ -1,16 +1,14 @@
 ---
 id: engineering-effectiveness-complete
-title: engineering-effectiveness-complete
+title: 工程效能完整知识库
 domain: development
-category: engineering-effectiveness-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, development, effectiveness, engineering, 工程效能完整知识库]
+tags: [工程效能, effectiveness, 研发效率, 流程标准化, devex, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# engineering-effectiveness-complete
-
-## 工程效能完整知识库
+# 工程效能完整知识库
 
 ### 1. 流程标准化
 - 从需求到发布定义统一流程节点。

package/development/engineering-standards-deep-dive.md

@@ -1,16 +1,14 @@
 ---
 id: engineering-standards-deep-dive
-title: engineering-standards-deep-dive
+title: 开发环节深度知识库
 domain: development
-category: engineering-standards-deep-dive.md
+category: 01-standards
 difficulty: intermediate
-tags: [deep, development, dive, engineering, standards, 开发环节深度知识库]
+tags: [工程规范, engineering-standards, 开发规范, 分层, 编码标准, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# engineering-standards-deep-dive
-
-## 开发环节深度知识库
+# 开发环节深度知识库
 
 ### 目标
 - 让实现质量稳定、可回归、可协作，避免“个人风格驱动”。

package/development/frontend-engineering-complete.md

@@ -1,16 +1,14 @@
 ---
 id: frontend-engineering-complete
-title: frontend-engineering-complete
+title: 前端工程完整知识库
 domain: development
-category: frontend-engineering-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, development, engineering, frontend, 前端工程完整知识库]
+tags: [前端, frontend, 组件化, 模块边界, 工程规范, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# frontend-engineering-complete
-
-## 前端工程完整知识库
+# 前端工程完整知识库
 
 ### 1. 分层与模块边界
 - 页面层负责编排，组件层负责复用，服务层负责数据访问。

package/development/performance-capacity-complete.md

@@ -1,16 +1,14 @@
 ---
 id: performance-capacity-complete
-title: performance-capacity-complete
+title: 性能与容量完整知识库
 domain: development
-category: performance-capacity-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [capacity, complete, development, performance, 性能与容量完整知识库]
+tags: [性能, performance, 容量, capacity, 性能预算, 压测, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# performance-capacity-complete
-
-## 性能与容量完整知识库
+# 性能与容量完整知识库
 
 ### 1. 性能预算
 - 定义核心接口 P95、P99、吞吐量目标。

package/development/refactor-migration-complete.md

@@ -1,16 +1,14 @@
 ---
 id: refactor-migration-complete
-title: refactor-migration-complete
+title: 重构与迁移完整知识库
 domain: development
-category: refactor-migration-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, development, migration, refactor, 重构与迁移完整知识库]
+tags: [重构, refactor, 迁移, migration, 技术债, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# refactor-migration-complete
-
-## 重构与迁移完整知识库
+# 重构与迁移完整知识库
 
 ### 1. 重构触发条件
 - 缺陷密度持续偏高。

package/development/refactoring-and-techdebt-playbook.md

@@ -1,16 +1,14 @@
 ---
 id: refactoring-and-techdebt-playbook
-title: refactoring-and-techdebt-playbook
+title: 重构与技术债治理手册
 domain: development
-category: refactoring-and-techdebt-playbook.md
+category: 02-playbooks
 difficulty: intermediate
-tags: [and, development, playbook, refactoring, techdebt, 重构与技术债治理手册]
+tags: [重构, refactoring, 技术债, tech-debt, 治理, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# refactoring-and-techdebt-playbook
-
-## 重构与技术债治理手册
+# 重构与技术债治理手册
 
 ### 目标
 - 在不影响业务连续性的前提下，持续降低系统复杂度与维护成本。

package/development/security-in-development-complete.md

@@ -1,16 +1,14 @@
 ---
 id: security-in-development-complete
-title: security-in-development-complete
+title: 开发安全完整知识库
 domain: development
-category: security-in-development-complete.md
+category: 01-standards
 difficulty: intermediate
-tags: [complete, development, security, 开发安全完整知识库]
+tags: [安全, security, 安全左移, 开发安全, 漏洞, development]
 quality_score: 70
 last_updated: 2026-06-15
 ---
-# security-in-development-complete
-
-## 开发安全完整知识库
+# 开发安全完整知识库
 
 ### 1. 安全左移
 - 在需求与设计阶段完成威胁建模。

package/devops/01-standards/docker-complete.md

@@ -5,8 +5,8 @@ domain: devops
 category: 01-standards
 difficulty: intermediate
 tags: [complete, compose, devops, docker, dockerfile, 实战, 最佳实践, 核心概念]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 90
+last_updated: 2026-06-29
 ---
 # Docker 完整指南
 

package/devops/01-standards/terraform-complete.md

@@ -5,8 +5,8 @@ domain: devops
 category: 01-standards
 difficulty: intermediate
 tags: [complete, devops, terraform, 实战配置, 工作流, 核心概念, 概述, 模块设计]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 90
+last_updated: 2026-06-29
 ---
 # Terraform 完整指南
 
@@ -1491,7 +1491,7 @@ jobs:
         uses: actions/github-script@v7
         with:
           script: |
-            const output = `#### Terraform Plan 📋
+            const output = `#### Terraform Plan
             \`\`\`
             ${{ steps.plan.outputs.stdout }}
             \`\`\`

package/frontend/01-standards/i18n-and-localization.md

@@ -62,4 +62,4 @@ last_updated: 2026-06-19
 - [ ] locale 检测+切换持久化；后端邮件/通知可本地化；多语言 SEO(hreflang)。
 
 ---
-**参考**：ICU MessageFormat、`Intl` API、react-i18next/vue-i18n、CLDR 复数规则、RTL 逻辑属性、hreflang。
+**参考**：ICU MessageFormat、`Intl` API、react-i18next/vue-i18n、CLDR 复数规则、RTL 逻辑属性、hreflang。数据导出/生成文档（CSV/Excel/PDF）的中文不乱码见 `backend/01-standards/cjk-in-exports-and-documents.md`。

package/frontend/01-standards/react-hooks-complete.md

@@ -5,8 +5,8 @@ domain: frontend
 category: 01-standards
 difficulty: intermediate
 tags: [complete, frontend, hooks, react, typescript, 常见陷阱, 性能优化, 最佳实践]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 90
+last_updated: 2026-06-29
 ---
 # React Hooks 深度指南
 
@@ -327,12 +327,12 @@ function Parent() {
   const [count, setCount] = useState(0);
   const [text, setText] = useState('');
   
-  // ❌ 不好:每次渲染都创建新函数
+  // [避免] 不好:每次渲染都创建新函数
   // const handleClick = () => {
   //   console.log('Clicked');
   // };
   
-  // ✅ 好:缓存函数引用
+  // [推荐] 好:缓存函数引用
   const handleClick = useCallback(() => {
     console.log('Clicked');
   }, []);
@@ -360,12 +360,12 @@ function Parent() {
 import React, { useState, useMemo } from 'react';
 
 function ProductList({ products, filter, sortBy }) {
-  // ❌ 不好:每次渲染都重新计算
+  // [避免] 不好:每次渲染都重新计算
   // const filteredProducts = products
   //   .filter(p => p.name.includes(filter))
   //   .sort((a, b) => a[sortBy] - b[sortBy]);
   
-  // ✅ 好:缓存计算结果
+  // [推荐] 好:缓存计算结果
   const filteredProducts = useMemo(() => {
     console.log('重新计算过滤和排序');
     return products
@@ -837,26 +837,26 @@ function LoginForm() {
 ### 规则 1: 只在顶层调用 Hooks
 
 ```javascript
-// ❌ 错误:在循环中调用
+// [避免] 错误:在循环中调用
 function BadComponent({ items }) {
   items.forEach(item => {
     const [state, setState] = useState(item); // 错误!
   });
 }
 
-// ✅ 正确:在顶层调用
+// [推荐] 正确:在顶层调用
 function GoodComponent({ items }) {
   const [states, setStates] = useState(items);
 }
 
-// ❌ 错误:在条件语句中调用
+// [避免] 错误:在条件语句中调用
 function BadComponent({ condition }) {
   if (condition) {
     const [value, setValue] = useState(0); // 错误!
   }
 }
 
-// ✅ 正确:条件逻辑在 Hook 内部
+// [推荐] 正确:条件逻辑在 Hook 内部
 function GoodComponent({ condition }) {
   const [value, setValue] = useState(0);
   
@@ -871,12 +871,12 @@ function GoodComponent({ condition }) {
 ### 规则 2: 只在 React 函数中调用
 
 ```javascript
-// ❌ 错误:在普通函数中调用
+// [避免] 错误:在普通函数中调用
 function handleClick() {
   const [count, setCount] = useState(0); // 错误!
 }
 
-// ✅ 正确:在组件或自定义 Hook 中调用
+// [推荐] 正确:在组件或自定义 Hook 中调用
 function MyComponent() {
   const [count, setCount] = useState(0);
   
@@ -918,12 +918,12 @@ const ChildComponent = memo(({ data, onClick }) => {
 ### 2. 正确使用依赖数组
 
 ```javascript
-// ❌ 缺少依赖
+// [避免] 缺少依赖
 useEffect(() => {
   fetchData(userId);
 }, []); // 缺少 userId 依赖
 
-// ✅ 完整依赖
+// [推荐] 完整依赖
 useEffect(() => {
   fetchData(userId);
 }, [userId]);
@@ -932,7 +932,7 @@ useEffect(() => {
 ### 3. 避免内联函数和对象
 
 ```javascript
-// ❌ 每次渲染都创建新函数/对象
+// [避免] 每次渲染都创建新函数/对象
 function Parent() {
   const [count, setCount] = useState(0);
   
@@ -944,7 +944,7 @@ function Parent() {
   );
 }
 
-// ✅ 使用 useCallback 和 useMemo
+// [推荐] 使用 useCallback 和 useMemo
 function Parent() {
   const [count, setCount] = useState(0);
   
@@ -988,7 +988,7 @@ function VirtualizedList({ items }) {
 ### 陷阱 1: 闭包陷阱
 
 ```javascript
-// ❌ 错误:闭包捕获旧值
+// [避免] 错误:闭包捕获旧值
 function Counter() {
   const [count, setCount] = useState(0);
   
@@ -1000,7 +1000,7 @@ function Counter() {
   }, []);
 }
 
-// ✅ 正确:使用函数式更新
+// [推荐] 正确:使用函数式更新
 function Counter() {
   const [count, setCount] = useState(0);
   
@@ -1015,7 +1015,7 @@ function Counter() {
   }, []);
 }
 
-// ✅ 或使用 ref
+// [推荐] 或使用 ref
 function Counter() {
   const [count, setCount] = useState(0);
   const countRef = useRef(count);
@@ -1034,7 +1034,7 @@ function Counter() {
 ### 陷阱 2: 无限循环
 
 ```javascript
-// ❌ 错误:导致无限循环
+// [避免] 错误:导致无限循环
 function BadComponent() {
   const [items, setItems] = useState([]);
   
@@ -1043,7 +1043,7 @@ function BadComponent() {
   }, [items]); // 依赖 items,导致循环
 }
 
-// ✅ 正确:使用函数式更新
+// [推荐] 正确:使用函数式更新
 function GoodComponent() {
   const [items, setItems] = useState([]);
   
@@ -1056,11 +1056,11 @@ function GoodComponent() {
 ### 陷阱 3: 直接修改状态
 
 ```javascript
-// ❌ 错误:直接修改状态
+// [避免] 错误:直接修改状态
 const [user, setUser] = useState({ name: 'Alice' });
 user.name = 'Bob'; // 不会触发重新渲染
 
-// ✅ 正确:创建新对象
+// [推荐] 正确:创建新对象
 setUser({ ...user, name: 'Bob' });
 ```
 
@@ -1068,16 +1068,16 @@ setUser({ ...user, name: 'Bob' });
 
 ## 最佳实践
 
-1. **✅ 使用函数式更新**: `setCount(prev => prev + 1)`
-2. **✅ 保持依赖数组完整**: 使用 eslint-plugin-react-hooks
-3. **✅ 拆分复杂状态**: 多个 useState 而非一个巨大对象
-4. **✅ 自定义 Hook 复用逻辑**: 避免复制粘贴
-5. **✅ 命名规范**: use 开头的自定义 Hook
-6. **✅ 合理使用 useMemo/useCallback**: 不要过度优化
-7. **✅ 错误边界**: 处理渲染错误
-8. **✅ 清理副作用**: useEffect 返回清理函数
-9. **✅ 测试 Hooks**: 使用 @testing-library/react-hooks
-10. **✅ TypeScript 支持**: 为 Hook 添加类型
+1. **[推荐] 使用函数式更新**: `setCount(prev => prev + 1)`
+2. **[推荐] 保持依赖数组完整**: 使用 eslint-plugin-react-hooks
+3. **[推荐] 拆分复杂状态**: 多个 useState 而非一个巨大对象
+4. **[推荐] 自定义 Hook 复用逻辑**: 避免复制粘贴
+5. **[推荐] 命名规范**: use 开头的自定义 Hook
+6. **[推荐] 合理使用 useMemo/useCallback**: 不要过度优化
+7. **[推荐] 错误边界**: 处理渲染错误
+8. **[推荐] 清理副作用**: useEffect 返回清理函数
+9. **[推荐] 测试 Hooks**: 使用 @testing-library/react-hooks
+10. **[推荐] TypeScript 支持**: 为 Hook 添加类型
 
 ---
 

package/frontend/01-standards/vue3-complete.md

@@ -5,8 +5,8 @@ domain: frontend
 category: 01-standards
 difficulty: intermediate
 tags: [complete, frontend, pinia, router, vue3, 响应式系统原理, 性能优化, 概述]
-quality_score: 70
-last_updated: 2026-06-15
+quality_score: 91
+last_updated: 2026-06-29
 ---
 # Vue 3 完整知识体系