fix: 修复文档多处问题 & feat: 新增相关文档推荐功能 #86

Open
wqer wants to merge 92 commits from z2_cc/gitlink_help_center:master into master

92 Commits

Author SHA1 Message Date
z2_cc f1feb47e42 Update HiAgent简介.md 2026-05-14 15:48:55 +08:00
赵昌 d18c56c27d feat: add bookmark/favorites feature with sidebar list
Remove unused GitLinkAction and ShareButton components.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 19:23:14 +08:00
赵昌 c35ceb7bb5 feat: add '去 GitLink 试试' action button linking docs to platform
Each doc now shows a contextual button linking to the corresponding
GitLink platform page, bridging documentation to real usage.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 18:58:50 +08:00
赵昌 891c3ebaed simplify: keep only copy-link button in ShareButton
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 18:49:11 +08:00
赵昌 9075878f88 feat: add share buttons (WeChat QR, QQ, copy link) to doc pages
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 18:44:56 +08:00
赵昌 1860d1219a refactor: move RecentDocs to top of sidebar for better visibility
RecentDocs section now appears below the logo at the top of the
sidebar, making recent browsing history immediately visible and easy
to click.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 18:10:33 +08:00
赵昌 53c3e2f60f refactor: move RecentDocs from footer to sidebar
RecentDocs now appears at the bottom of the sidebar instead of the
page footer, making it more accessible during navigation.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 18:04:03 +08:00
赵昌 4900daa7bc feat: add recent docs browsing history feature
Track recently visited doc pages in localStorage and display them
at the bottom of each doc page for quick re-access.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 17:51:25 +08:00
赵昌 b00f5e189c remove: RelatedDocuments feature deemed redundant with sidebar navigation
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 17:02:57 +08:00
z2_cc 8961c59f01 chore: remove superpowers docs from tracking and add to gitignore 2026-05-13 16:38:19 +08:00
刘焱 6d8a231d52 Merge branch 'master' of https://gitlink.org.cn/z2_cc/gitlink_help_center 2026-05-13 16:33:06 +08:00
刘焱 80251304b3 fix: 移除无效的 BUILD_DATE 缓存破坏,确保流水线构建使用最新代码 2026-05-13 16:32:46 +08:00
赵昌 b282d4bd82 feat: add breadcrumb navigation to doc pages
Implement custom breadcrumb component that replaces default Docusaurus
DocBreadcrumbs with one that uses doc ID path segments. Shows hierarchy
like "帮助中心 > 代码库管理 > 仓库创建" and links intermediate
categories to the first doc in each category.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 16:24:47 +08:00
刘焱 c72985df89 feat: 反馈数据后端化,添加管理统计面板
- 新增 api/feedback/store.js 基于 JSON 文件的反馈数据存储
- 新增 POST /api/feedback 提交接口,GET /api/feedback/stats 和 /recent 管理接口
- DocFeedback 组件提交反馈时同步发送到后端
- 新增 /admin/index.html 管理面板,支持查看统计数据和最近反馈
- Dockerfile 添加数据卷持久化,流水线添加 -v 挂载
2026-05-13 16:22:14 +08:00
刘焱 09e90abe31 fix: 增加文档反馈区域底部间距,避免被遮挡 2026-05-13 15:56:56 +08:00
赵昌 78a953da84 cleanup: remove unused prev/next navigation styles and code
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 15:49:07 +08:00
z2_cc fd5f0988c0 fix: move ChatButton above BackToTop to avoid overlap 2026-05-13 15:44:18 +08:00
赵昌 3f976b15df feat: 增强相关文档为跨分类智能推荐
- 新增关键词提取引擎,从文档标题提取2-gram中文关键词
- 跨分类推荐:在其他分类中搜索主题相关的文档
- 保留同分类上/下一篇导航和文档列表
- 首页自动隐藏模块

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 15:42:53 +08:00
赵昌 3b8f8603a4 feat: 增强相关文档推荐功能,增加分类导航与文档计数
- 新增同分类"上一篇/下一篇"导航,便于顺序阅读
- 显示当前分类名称及文档计数
- 卡片增加编号标识
- 首页等根级页面自动隐藏模块

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 15:30:32 +08:00
z2_cc e5f7b9e3d9 fix: use env-file for DEEPSEEK_API_KEY in pipeline
Pipeline secret interpolation doesn't work inside string values.
Use --env-file on the server instead.
2026-05-13 15:28:32 +08:00
刘焱 ecc30f5994 feat: 文档反馈增加改进建议输入框
点击"没帮助"后弹出输入框,用户可输入改进建议并提交
2026-05-13 15:14:30 +08:00
刘焱 ef749d9995 完善 2026-05-13 15:08:16 +08:00
z2_cc e724a74f46 feat: add DEEPSEEK_API_KEY to pipeline and include design docs
- Pass DEEPSEEK_API_KEY env var in docker run command
- Add design spec and implementation plan
2026-05-13 15:05:11 +08:00
z2_cc 391a83a11d fix: fix Chinese token filter regex for BM25 search
\W in regex matches Chinese characters, causing all Chinese tokens
to be filtered out. Replaced with \p{P} (Unicode punctuation) to
correctly preserve Chinese tokens while filtering punctuation.
2026-05-13 15:05:11 +08:00
z2_cc 423e40b3dc feat: integrate AI chat assistant into Layout 2026-05-13 15:05:11 +08:00
z2_cc 9b1836a543 feat: add pm2 config and update Dockerfile for API server 2026-05-13 15:05:11 +08:00
z2_cc cba879b7f3 feat: add Express API server with chat endpoint and static proxy 2026-05-13 15:05:11 +08:00
z2_cc 11c79472ce feat: add ChatDrawer side panel with streaming SSE 2026-05-13 15:05:11 +08:00
z2_cc 3ac6ec586a feat: add runtime search indexer with BM25 2026-05-13 15:05:11 +08:00
z2_cc ed3cf2e8e2 feat: add ChatButton floating action button 2026-05-13 15:05:11 +08:00
z2_cc c7a89f9997 feat: add ChatMessage component with source links 2026-05-13 15:05:11 +08:00
z2_cc d28b46c86f feat: add build-time doc index generator
Created scripts/generate-doc-index.js that:
- Scans all .md files under docs/
- Extracts titles, breadcrumbs, and URLs
- Strips Markdown syntax and tokenizes content with jieba
- Outputs structured index to static/doc-index.json

Also added static/doc-index.json to .gitignore
2026-05-13 15:05:11 +08:00
z2_cc bec48dca72 feat: add DeepSeek Chat API streaming wrapper 2026-05-13 15:05:11 +08:00
z2_cc 6a9b9e2cc6 feat: add BM25 search algorithm 2026-05-13 15:05:11 +08:00
刘焱 d02a240205 fix: Dockerfile 优化构建层缓存策略,确保代码变更触发重新构建 2026-05-13 14:52:44 +08:00
刘焱 913380b3ff chore: rebuild docker image - force cache invalidation 2026-05-13 14:44:43 +08:00
z2_cc 7c850d72a6 fix: 修正 robots.txt 中 sitemap 指向 GitLink 域名
将 sitemap 从 boxyhq.com 改为 help.gitlink.org.cn

Closes #142204
2026-05-13 10:18:33 +08:00
z2_cc d3859b8022 fix: 修复 intro.md 中个人主页建站卡片链接
将 /个人主页建站/建站流程 改为 /个人主页建站/站点创建流程

Closes #142203
2026-05-13 10:17:49 +08:00
z2_cc 1064582310 fix: 移除未使用的依赖
移除 or、react-modal、docusaurus-gtm-plugin、@docusaurus/plugin-client-redirects

Closes #142202
2026-05-13 10:16:58 +08:00
z2_cc 03f74720e3 fix: 删除 BoxyHQ 模板残留的 _index.js
Closes #142201
2026-05-13 10:16:58 +08:00
z2_cc ffeeac639e fix: 清理约 12MB 模板残留图片
- 删除 static/images/ 整个目录(BoxyHQ/Retraced 模板图片约 11.5MB)
- 删除 static/img/ 中的 Docusaurus 模板图片约 524KB
- 删除 reposyncer 目录中重复的 .png 版本文件约 832KB

Closes #142195
2026-05-13 10:16:58 +08:00
刘焱 f91fecea8c chore: trigger CI/CD rebuild to deploy new features 2026-05-13 10:11:12 +08:00
刘焱 272f28e237 feat: 添加文档反馈、回到顶部按钮和公告横幅功能
- 文档底部新增「有帮助/没帮助」反馈区域,localStorage 防重复投票
- 页面右下角新增回到顶部悬浮按钮,滚动超300px淡入,品牌蓝设计
- 顶部新增公告横幅,由 static/announcement.json 驱动,关闭后不再显示
2026-05-13 09:45:56 +08:00
z2_cc 8a28ddc4ec 流水线增加push触发器,代码提交时自动构建 2026-05-12 23:24:39 +08:00
z2_cc 8eb6ee635a refactor: delete .devops/触发器yaml示范.yml 2026-05-12 23:24:31 +08:00
z2_cc e1170941e5 feat: .devops/触发器yaml示范.yml 2026-05-12 23:21:27 +08:00
z2_cc 8d99e4743a refactor: delete .devops/未命名项目.yml 2026-05-12 23:21:26 +08:00
z2_cc 036a3a2660 feat: .devops/未命名项目.yml 2026-05-12 23:20:20 +08:00
z2_cc 34669d17f9 流水线ssh命令增加容错处理,容器不存在时不中断后续部署 2026-05-12 23:06:59 +08:00
z2_cc 744762ff7a 修复流水线镜像推送地址和部署拉取地址 2026-05-12 22:39:36 +08:00
z2_cc 9078e9e0b9 Dockerfile改用npm ci替代yarn install以使用package-lock.json 2026-05-12 22:28:33 +08:00
z2_cc e85402037d 升级搜索插件解决Docusaurus 3.x构建兼容性问题 2026-05-12 22:11:29 +08:00
z2_cc ac8bc96874 Dockerfile使用阿里云私有仓库node基础镜像 2026-05-12 21:05:53 +08:00
z2_cc e38aaa81d6 更新Dockerfile镜像源并完善.gitignore规则
Dockerfile切换为ustc镜像源,去除多余空格;
.gitignore新增忽略.claude/目录和Office临时文件
2026-05-12 20:42:29 +08:00
z2_cc 8295c389f5 Update Dockerfile 2026-05-12 20:34:33 +08:00
z2_cc 115851b1a3 Update Dockerfile 2026-05-12 20:29:14 +08:00
z2_cc cbc31a2ebb Update Dockerfile 2026-05-12 20:26:17 +08:00
z2_cc d60bcf574f refactor: .devops/构建流水线.yml 2026-05-12 20:16:42 +08:00
z2_cc 919d6ee7ee Update Dockerfile 2026-05-12 20:15:28 +08:00
z2_cc c00441ee1b Update Dockerfile 2026-05-12 20:08:39 +08:00
z2_cc 51779a0c6e Update Dockerfile 2026-05-12 19:56:09 +08:00
z2_cc 2a4f831933 refactor: .devops/构建流水线.yml 2026-05-12 19:51:56 +08:00
z2_cc 90d10d72a1 refactor: .devops/构建流水线.yml 2026-05-12 19:43:44 +08:00
z2_cc 0cd41d2627 refactor: .devops/构建流水线.yml 2026-05-12 19:35:42 +08:00
z2_cc 6f97fe6a23 refactor: .devops/构建流水线.yml 2026-05-12 19:29:39 +08:00
赵昌 1cee9b1599 feat: 新增相关文档推荐功能及修复版本化文档图片路径
- 新增 RelatedDocuments 组件,在文档底部展示同分类下的相关文档链接
- 通过 Docusaurus theme swizzle 将组件注入到 DocItem/Footer
- 修复 versioned_docs 中建站工具.md 的图片路径

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-12 19:28:51 +08:00
z2_cc 1521c09548 refactor: .devops/构建流水线.yml 2026-05-12 19:24:33 +08:00
z2_cc 77a3d29118 refactor: .devops/构建流水线.yml 2026-05-12 19:24:31 +08:00
z2_cc 3cb0e9a621 refactor: .devops/构建流水线.yml 2026-05-12 19:24:29 +08:00
z2_cc ed394d1130 refactor: .devops/构建流水线.yml 2026-05-12 19:17:33 +08:00
z2_cc 1511908209 refactor: .devops/构建流水线.yml 2026-05-12 19:16:36 +08:00
z2_cc 1d8592bda2 refactor: .devops/构建流水线.yml 2026-05-12 19:16:34 +08:00
z2_cc d7499f16b8 refactor: .devops/构建流水线.yml 2026-05-12 19:10:40 +08:00
z2_cc 44f680f4f5 refactor: .devops/构建流水线.yml 2026-05-12 19:09:06 +08:00
z2_cc 9cf5bf0711 refactor: .devops/构建流水线.yml 2026-05-12 16:11:51 +08:00
z2_cc 0aeed9863a feat: .devops/构建流水线.yml 2026-05-12 15:31:54 +08:00
z2_cc 9fa871fdfb refactor: delete .devops/未命名项目.yml 2026-05-12 15:31:53 +08:00
z2_cc 4d72f69abd refactor: .devops/未命名项目.yml 2026-05-12 15:13:02 +08:00
z2_cc 7fb16cd093 Delete .devops/帮助中心.yml 2026-05-12 15:07:20 +08:00
z2_cc 7ea842441c refactor: .devops/帮助中心.yml 2026-05-12 15:06:08 +08:00
z2_cc 98aefaab83 Update 帮助中心.yml 2026-05-12 15:04:27 +08:00
z2_cc 1deae21c6a refactor: .devops/帮助中心.yml 2026-05-12 15:00:09 +08:00
z2_cc a551e2a707 refactor: .devops/帮助中心.yml 2026-05-12 14:58:33 +08:00
z2_cc ce83a843f3 refactor: .devops/帮助中心.yml 2026-05-12 14:58:32 +08:00
刘焱 05cbfdea79 完善 2026-05-11 20:49:56 +08:00
z2_cc a11d78dfeb refactor: .devops/帮助中心.yml 2026-05-11 16:29:25 +08:00
z2_cc ed47da0f58 refactor: .devops/帮助中心.yml 2026-05-11 16:29:18 +08:00
z2_cc 35829aaf6b refactor: .devops/帮助中心.yml 2026-05-07 16:32:27 +08:00
z2_cc da79361874 refactor: .devops/帮助中心.yml 2026-05-07 16:28:56 +08:00
z2_cc 550dab92d3 feat: .devops/帮助中心.yml 2026-05-07 16:12:06 +08:00
赵昌 93068dc829 fix: 修复文档多处问题
- 代码提交.md: 复制粘贴错误修复
- 分支管理.md: 错别字修复
- 成员管理.md: 章节标题重复修复
- 提交第一行代码.md: 标题层级修复
- 维基页面管理.md, 模板导入及导出.md: 图片语法修复
- 平台公告.md: 补充空白页面
- 建站工具.md: 统一图片路径
2026-05-07 11:50:03 +08:00
刘焱 cf5af8a880 修改完善 2026-05-07 11:36:51 +08:00