Linux.do Agent 是一款专为 Linux.do 论坛设计的 AI 智能助手用户脚本。本脚本基于 Linux.do 社区讨论 中的内容进行改造和增强。它集成了 OpenAI 格式的对话能力，并深度结合 Discourse 论坛 API，为您提供智能搜索、内容总结、话题分析等通过自然语言交互的高级功能。
-
🤖 多 API 管理与自动切换
- 支持配置多个 OpenAI 兼容接口（OpenAI, Groq, DeepSeek, OpenRouter 等）。
- 故障转移 (Failover)：当主 API 请求失败时，自动尝试下一个可用的 API，确保服务高可用。
- 可视化配置：在设置面板中轻松添加、编辑、测试和切换 API。
-
💬 智能对话与多会话管理
- 多会话支持：同时管理多个对话窗口，状态自动持久化（跨页面刷新不丢失）。
- Markdown 渲染：完美支持代码高亮、表格、公式等 Markdown 格式。
- JSON 自动修复：内置强大的 JSON 修复逻辑，即使模型输出格式有误也能自动纠正，极大提高稳定性。
- Force Final 机制：智能检测请求超时或最大轮数，强制模型生成最终回复，防止任务卡死。
-
🛠️ 深度集成 Discourse 工具 Agent 内置了多种针对 Linux.do 论坛的专用工具，模型可自动调用：
- 搜索 (discourse.search)：智能搜索论坛内容。
- 看帖 (discourse.getTopicAllPosts)：读取指定话题的全部楼层内容进行总结。
- 用户分析 (discourse.getUserSummary)：获取用户画像、热门帖子、最近动态。
- 趋势 (discourse.listTopTopics/listLatestTopics)：查看全站热门或最新话题。
- 分类/标签 (discourse.getCategories/getTagTopics)：按板块或标签筛选内容。
-
🖥️ 现代化 UI 体验
- 悬浮球 (FAB)：可拖动、自动吸附、记忆位置，不遮挡页面内容。
- 快捷键：支持
Alt + A快速呼出/隐藏面板。 - 暗色/亮色主题：支持自动跟随系统或手动切换。
- 首先安装用户脚本管理器插件，如 Tampermonkey (推荐) 或 Violentmonkey。
- 访问 GreasyFork 脚本页面。
- 点击“安装此脚本”按钮。
- 下载本仓库中的
linuxdo-agent.user.js文件。 - 在浏览器中打开 Tampermonkey 管理面板 -> 工具 -> 导入，选择该文件。
安装后，点击页面右下角的 🤖 悬浮球 打开面板，点击顶部的 ⚙️ 设置 按钮即可进行配置。
您必须至少配置一个可用的 OpenAI 兼容 API 才能使用。
- 点击 "+ 添加 API"。
- Base URL: 接口地址（例如
https://api.openai.com/v1或其它中转地址）。 - Model: 模型名称（例如
gpt-4o-mini,deepseek-chat）。 - API Key: 您的 API 密钥。
- 点击 "测试" 按钮验证连通性，然后保存。
- Temperature: 控制回答的随机性（0-1）。
- Max turns: 最大对话轮数，防止死循环。
- API Fallback: 建议开启，当主 API 报错时自动尝试备用 API。
在对话框中，您可以直接用自然语言下达指令：
- "帮我搜索一下最近关于‘Docker’的高赞帖子"
- "总结一下 https://linux.do/t/topic/12345 这篇文章的主要观点"
- "查看用户 @始皇 的最近动态和热门回复"
- "最近有什么关于 Python 的热门讨论吗？"
Agent 会自动分析您的意图，必要时调用论坛接口获取数据，并给出最终回复。
- 本地存储：您的 API Key 和聊天记录仅存储在您浏览器的 Tampermonkey 本地存储中（通过
GM_setValue），不会上传到任何第三方服务器（除了发送给您配置的 LLM API 用于生成回答）。 - API 请求：脚本会且仅会向您自己在设置中配置的
Base URL发送请求。请确保您使用可信的 API 服务商。
欢迎提交 Issue 反馈 Bug 或建议新功能！ 如果您觉得好用，请给个 Star ⭐️ 支持一下！
本项目采用 GPL-3.0 开源协议。
如果您想参与本项目开发：
- 克隆本仓库：
git clone https://github.com/YOLO-9257/linuxdo-agent.git
- 修改代码（主要逻辑在
linuxdo-agent.user.js）。 - 在浏览器中加载修改后的脚本进行测试。