7Tan 使用说明书

一、软件简介

7Tan（7坛 AI 小编「盘古」）是一款完全免费的 AI 智能工作台（全部插件与工具永久免费），把编程写代码、AI 对话、游戏采集发布、内容创作整合在一起，让重复劳动变成一句话指令。编程写代码是全软件的首要能力——从写代码、改代码到测试、部署、上线，AI 全程帮你完成。

1.1 核心能力总览

1.2 典型使用场景

二、💻 编程写代码（首要功能）

7Tan 将编程写代码放在首要位置——这是一款以「AI 全栈开发」为核心能力的智能工作台：用自然语言描述需求，AI 就能帮你写代码、改代码、查代码、测试、构建、部署上线，从需求到交付全流程覆盖。

让 AI 直接帮你写代码、改代码、查代码、部署上线，从需求到交付全流程覆盖。

常用指令示例

帮我写一个 Python 脚本：批量重命名文件夹里的图片
审查一下 D:\project\main.py 有没有问题，并修复
给下面的函数加上类型注解和 docstring
查看当前 Git 仓库状态，然后把修改提交了
为这个 Flask 项目生成 GitHub Actions CI 配置
写一个 pytest 测试用例并运行
分析这段报错堆栈，告诉我原因和修法

三、系统要求与安装

3.1 系统要求

3.2 安装步骤

1. 解压 7tan-editor-free-v1.0.22.zip 到任意目录（路径不要包含中文和空格，如 D:\7tan-editor）；
2. 进入解压后的 7tan-editor 文件夹；
3. 双击 7tan-editor.exe 启动软件；
4. 首次启动会弹出欢迎向导，按提示完成基础配置。

3.3 目录结构说明

7tan-editor/
├── 7tan-editor.exe        # 主程序（双击运行）
├── _internal/             # 运行所需的内置文件（请勿删除）
├── 7Tan使用说明书.md      # 使用说明书（Markdown 版）
├── 7Tan使用说明书.html    # 使用说明书（网页版，双击即可阅读）
└── （运行后自动生成）
    ├── data/              # 数据目录（数据库、日志、插件）
    ├── logs/              # 运行日志
    ├── downloads/         # 下载缓存
    └── config.yaml        # 全局配置文件

四、快速上手（5 分钟）

4.1 启动与登录

1. 双击 7tan-editor.exe 启动；
2. 弹出登录窗口：已有账号直接登录；没有账号点「注册」，注册即可免费使用全部核心功能；
3. 登录后进入主界面。

WEB 版启动与登录（简单说明）

1. 打开：浏览器直接访问 http://127.0.0.1:9900/ 即可使用；若提示无法访问，双击一次「Windows-启动网页版服务.bat」即可（自动启动服务、设置开机自启并打开浏览器），以后开机自动运行，随时直接访问；
2. 登录：与桌面版同一账号，勾选《用户协议》《隐私政策》后登录；没有账号可在登录框点「注册」；
3. 登录成功后即可在浏览器里 AI 对话、编程写代码、查看实时控制台。

4.2 欢迎向导配置（首次）

4.3 第一条指令

在底部输入框输入，例如：

帮我写一个 Python 脚本：把 D:\图片 文件夹里所有 jpg 重命名为 日期_序号.jpg

或：

帮我发布《超能机器人》：资料在 D:\用户目录\下载\新建文件夹 123\11，LOGO 和截图都在里面，
游戏简介不用改，下载包不用下载，直接把下载链接加上发布。

AI 会自动完成：读资料 → 压缩图片 → 登录后台 → 上传 LOGO/截图 → 填表 → 发布 → 验证。

4.4 WEB 版快速上手（浏览器控制台）

7Tan 除了桌面客户端，还自带 WEB 版——与桌面版同一个引擎、同一套账号与数据，用浏览器就能 AI 对话、编程写代码、查看实时控制台、远程操作电脑。

如何使用

1. 直接打开浏览器，访问 http://127.0.0.1:9900/ 即可使用（WEB 服务开机自启，通常已在运行）；
2. 若提示无法访问，说明服务未启动：双击「Windows-启动网页版服务.bat」一次（自动启动服务、设置开机自启并打开浏览器），之后开机自动运行、随时直接访问。

五、主界面指南

六、核心功能详解（AI 对话 / 游戏发布 / 自动化）

6.1 💬 AI 对话

• 输入方式：底部输入框输入自然语言指令，回车发送；
• Markdown 渲染：标题、列表、表格、代码块自动美化；
• 流式输出：AI 回复逐字显示，随时可见进度；
• 思考过程：可展开查看 AI 的推理步骤；
• 历史会话：左侧列表切换，支持重命名、删除、搜索；
• Token 显示：对话右上角显示本次消耗 Token 数。

常用指令示例

帮我发布《XX游戏》：资料在 D:\...\11，LOGO 截图都在里面
抓取 TapTap 首页新游
对比《A》和《B》两款游戏
把这段英文介绍翻译成中文
检查 7Tan 后台今天发布了几款游戏

6.2 🎮 游戏采集与发布（核心）

第一步：准备资料文件夹

D:\用户目录\下载\新建文件夹 123\11\
├── 游戏资料.txt      # 标题、简介、开发商、备案号、下载链接等
├── logo.png          # 游戏 LOGO
└── 1.jpg 2.jpg ...   # 游戏截图（2~5 张）

第二步：一句话指令

我已经把《鬼魂》的资料整理到 D:\用户目录\下载\新建文件夹 123\11，
请帮我到管理后台发布，LOGO 与截图都在里面，其他资料在游戏资料.txt，
简介不用修改，安装包不用下载，把下载链接加上发布。

第三步：AI 自动执行全流程

发布结果示例（AI 汇报）

✅ 发布成功！
标题：鬼魂（ID 994）   栏目：冒险解密
开发商：海南星空跳动科技有限公司   系统要求：5.0
LOGO：已上传（512x512）  截图：5 张
前台链接：https://www.7tan.com/game/994/

6.3 🌐 浏览器与素材工具

• 内置浏览器：软件内置 Chromium，AI 可自动浏览游戏源站；
• 提取 LOGO / 截图：自动识别页面图片并下载；
• 自动截图：对页面自动截取多张高质量预览图；
• OCR 识别：从截图 / 图片中识别文字；
• 图片压缩：发布前自动压缩，节省云存储空间。

6.4 ☁️ 云存储 OSS

用于存放游戏 LOGO、截图、安装包，生成外链供后台引用。

• 支持 阿里云 OSS / 腾讯云 COS / 七牛 Kodo；
• 在「🔧 设置 → OSS 设置」填写 AccessKey、Bucket、域名等；
• AI 发布游戏时会自动上传并获取外链。

6.5 🎬 录屏

• 点击「🎬 录屏」开始录制；再次点击停止并保存；
• 设置中可选择音频设备（麦克风 / 立体声混音）；
• 输出格式：MP4（含音轨）。

6.6 🔊 语音（TTS）

• 支持 AI 语音朗读回复内容；
• 设置中可选音色（女声 / 男声）；
• 依赖系统 TTS 中文语音包；提示「语音引擎未就绪」见 FAQ 第 8 条。

6.7 🔄 自动更新

1. 启动时自动检查更新（也可在「ℹ️ 关于」页点「检查更新」）；
2. 发现新版本提示下载；
3. 下载完成后校验 MD5 + RSA 数字签名（防篡改）；
4. 校验通过后提示重启更新，自动完成替换。

6.8 🧩 插件系统

入口：左侧「🧩 插件市场」。支持：刷新插件列表 / 安装选中插件 / 一键安装全部 / 卸载插件。

6.9 ⏰ 定时任务（调度器）

• 内置任务：每日早间更新（08:00）/ 午间更新（12:00）/ 晚间更新（18:00）；
• 设置中可开启 / 关闭、修改时间、调整每次采集数量；
• 适合定时自动采集与发布新游。

6.10 🖥️ 桌面自动化

• 支持控制微信 / QQ 等桌面软件自动发送消息；
• 内置防发错机制：发送前搜索目标 → 验证聊天窗口 → 确认后发送；
• 使用场景：定时给粉丝群发游戏资讯、自动回复。

👁️ 视力增强（看懂屏幕）：

• desktop_see 看懂屏幕：截图 → 本地画面分析（主色调 / 亮度 / 红绿告警块）→ 双引擎 OCR 全文（Windows OCR + RapidOCR 离线融合，中文识别率大幅提升）→ 输出元素坐标；
• RapidOCR 离线引擎：PP-OCRv4 中文模型，不联网、毫秒级，小字 / 游戏界面 / 复杂背景识别更强，作为 Windows OCR 的自动兜底与融合引擎；
• 视觉模型深度理解（可选）：在 .env 配置 VISION_API_KEY / VISION_BASE_URL / VISION_MODEL（如智谱 GLM-4V-Flash）后，desktop_see 自动调用多模态大模型，输出「画面描述 / 元素列表（按钮·输入框·弹窗）/ 状态（可用·禁用）/ 警告 / 操作建议」；
• 配合 UIA 控件树与模板匹配，实现「看得见、读得懂、点得准」的完整视觉闭环。

6.11 📰 公众号发布

• 一键完成微信公众号图文：填标题 / 作者 → 粘贴正文 → 填摘要 → 上传封面 → 原创声明 → 保存草稿 / 发表；
• 支持图文混排序列（文字 + 图片自动排版）。

6.12 ✒️ 内容创作工具

• 爆款写作：选题生成 → 爆款标题 → 五段式大纲 → 正文撰写 → 金句卡片 → 发布前质检；
• 易经占卦：金钱卦 / 数字卦 / 时间卦，附卦辞爻辞与白话解读；每日一卦；
• 孙子兵法：兵法问答、决策推演、篇章查询、每日兵法；
• 智能翻译：中英文互译。

6.13 🧠 记忆系统

• AI 可将重要信息（经验、配置、知识点）存入持久化记忆；
• 重启后依然保留；支持分类（游戏 / 技能 / 配置 / 通用）、搜索、概览；
• 例如 AI 会记住「上次开发商填错的教训」，下次自动避免。

6.14 🚀 自我进化

• 自我修改：AI 可安全地修改自身代码、配置，实现自我升级；
• 创建插件：AI 可动态编写并注册新插件，扩展能力；
• 自我重启：修改代码后自动重启生效；
• 完整性校验：自动检测核心文件是否被篡改，保证安全。

七、设置详解

入口：左侧「🔧 设置」。

7.1 AI 模型

• 选择已保存的模型配置，或新建（填写 API Key、Base URL、模型名）；
• 支持 DeepSeek / OpenAI 兼容接口；
• 保存后生效，可在对话中直接使用。

7.2 站点设置

7.3 OSS 设置

• 云服务商：阿里云 OSS / 腾讯云 COS / 七牛 Kodo；
• AccessKey / SecretKey / Bucket / Region / 外链域名；
• 可测试连通性，保存后 AI 发布自动使用。

7.4 浏览器设置

• 浏览器类型（默认 Chromium）、是否无头模式；
• HTTP / HTTPS 代理（需要时填写）；
• 下载超时、蜘蛛伪装下载开关。

7.5 更新设置

• 自动检查更新开关；更新通道（stable 稳定版）；
• 更新包下载与签名校验策略。

7.6 安全设置

7.7 Web 服务（浏览器控制面板）

• 软件内置本地 WEB 服务（访问地址 http://127.0.0.1:9900/），Windows 双击「Windows-启动网页版服务.bat」即可打开使用（自动启动服务、设置开机自启并打开浏览器，或命令行 python main.py --web --port 9900），无需安装；macOS / Linux / 鸿蒙 用户下载「其他系统包」，解压后双击 macOS-启动网页版服务.command 或执行 Linux-启动网页版服务.sh，首次运行自动安装依赖并打开浏览器；
• WEB 版与桌面版共用同一套引擎：同一个 AI 主循环、同一批 100+ 工具、同一数据库，编程 / 视觉 / 桌面控制能力与桌面版完全一致；
• 登录 / 注册：左侧栏可直接登录 7坛 账号（与桌面版共用登录态）；登录窗口支持用户协议 / 隐私政策勾选，没有账号可点「去注册」跳转 官网注册；
• 远程访问（API Token）：本机访问无需 Token；局域网 / 公网设备访问时，需在左上角填写 API Token（存放于 data\.api_token）才能操作，防止他人控制你的电脑；
• AI 对话：支持流式回复，每条消息带复制 / 编辑 / 删除按钮；时间显示完整年月日；
• 语音朗读：底部「语音」按钮开启后，Agent 回复（含实时控制台中的 💬 Agent 内容）自动朗读，支持女声（Piper 本地）/ 男声（Edge 在线）切换，与桌面版共用同一个开关；
• 实时控制台：滚动显示系统日志与 Agent 执行过程，TTS 桥接正常时可见 [TTS-Bridge] 朗读记录；
• 开机自启：首次双击「Windows-启动网页版服务.bat」会自动配置开机自启（注册表 HKCU，无需管理员权限），此后每次开机自动运行 WEB 服务，随时直接访问 http://127.0.0.1:9900/ 即可；如需取消，运行 python tools\web_autostart.py --uninstall。
• 服务若意外关闭：重新运行「Windows-启动网页版服务.bat」启动脚本即可恢复。
• 绿色版零依赖：无需安装 Python / Node.js 等任何软件，exe 自带运行环境；用户移动 / 重命名软件目录后，只要再运行一次启动脚本（或 WEB 服务启动过），开机自启路径会自动校准修复。

八、版本说明（完全免费）

8.1 关于「完全免费」

7Tan 软件本体与全部插件（含「爆款写作」）完全免费，开放编程写代码、AI 对话、游戏发布、内容创作、自我进化等全部核心功能，登录即可直接使用，无需付费、无需授权码、无试用次数、无到期限制。

8.2 完整功能一览

九、版本历史（更新记录）

如何查看当前版本

• 打开软件 → 左下角「ℹ️ 关于」页即可看到当前版本号；
• 软件启动时自动检查更新，发现新版本会提示下载；也可在「关于」页手动点「检查更新」。

更新记录

十、常见问题 FAQ

1️⃣ 更新时提示「无法启动更新程序: Read timed out」？

旧版本（≤1.0.7）已知问题：更新解压会卡住本地服务导致超时。升级到 1.0.8 及以上已修复。请手动下载新版安装包升级一次。

2️⃣ 录屏没有声音？

检查「设置 → 录屏 → 音频设备」是否选择了正确的录音设备（如「立体声混音」或麦克风）。若设备不可用软件会提示，请先在 Windows 声音设置中启用录音设备。

3️⃣ 点击历史对话时鼠标变圈圈、界面卡顿？

旧版本加载大量历史消息时性能不佳。1.0.8 已优化（渐进渲染 + 高度同步节流）。若仍卡顿请升级到最新版。

4️⃣ 登录页点「忘记密码」没反应？

1.0.8 已修复（旧版点击会静默报错）。升级后会自动打开浏览器访问：https://www.7tan.com/bbs/77562/

5️⃣ 左侧底部点「刷新」报 404？

1.0.8 已修复 API 域名错误（图片服务器 vs 主站）。升级后刷新会正常返回「会员状态已更新」。

6️⃣ 软件闪退 / 崩溃怎么办？

1. 找到 logs\crash_*.txt（记录崩溃原因）；
2. 查看 logs\app_日期.log 最近报错；
3. 把两个文件发给技术支持，便于定位修复；
4. 常见崩溃（浏览器控件被销毁等）已在后续版本修复，请保持更新。

7️⃣ 登录提示「账号或密码错误」？

1.0.7 已修复错误提示不准确问题。请确认账号密码无误；忘记密码可用登录页「忘记密码」链接找回。

8️⃣ 语音提示「语音引擎未就绪：请检查手机TTS中文语音包」？

该提示来自 易经 AI 占卦 APP（安卓端），不是 7Tan 桌面版。原因是手机系统缺少 TTS 中文语音包。解决：安装 v0.10.0+ 版 APP（已内置离线语音引擎），或给手机安装中文语音包。

9️⃣ 杀毒软件拦截、提示「文件被隔离/删除」怎么办？

第一步 · 从「隔离区」把文件还原回来

如果杀软已经把 7tan-editor.exe 删掉或隔离，双击会提示找不到文件，此时先去还原：

第二步 · 给「整个文件夹」加白名单（关键）

不要只信任 7tan-editor.exe 一个文件 —— 软件还包含 7tan-updater.exe、tools\、_internal\ 等组件， 只信任主程序会在下次自动更新时再次被拦。 请把解压后的整个目录（例如 D:\7tan-editor）加入白名单。

第三步 · 换到独立目录（可选，但推荐）

放在桌面、下载、C:\Program Files 下的程序， 部分安全软件的检查会更严格。建议解压到独立目录，例如 D:\7tan-editor\， 路径不含中文更佳。

关于「未知发布者」提示

7Tan 目前未购买商业代码签名证书，Windows 因此会显示「未知发布者」。 这表示系统不认识发行方，不等于文件有问题。 请以「从官网下载 + 核对 MD5」作为判断依据，文件指纹见 更新中心。

在服务器 / 云主机上运行被拦截？

服务器上除了本机杀软，还可能被服务器侧的安全软件（安全狗、云锁、宝塔安全、主机卫士等） 隔离或删除文件，请把 7Tan 目录加入该安全软件的白名单。 另外，部分虚拟主机不支持运行本地服务（7Tan 需要在本机启动 127.0.0.1:9900 服务）， 如遇无法启动，建议改用云服务器（VPS）。

🔟 忘记后台密码 / 发布时提示登录失败？

检查「设置 → 站点设置」中的后台用户名密码；确认网络可访问后台域名；发布间隔建议保持 30 秒以上。

1️⃣1️⃣ 如何反馈问题 / 求助？

软件左侧底部提供「问题求助 / 投诉建议」入口，或联系官网 https://www.7tan.com 客服。

十一、注意事项与技术支持

注意事项

• 请勿删除 _internal、logs、data 中的文件，可能导致软件异常；
• 重要资料（后台账号、OSS 密钥）请妥善保管；
• 发布游戏请确保资料真实合法，遵守平台规则；
• 更新时保持网络通畅，不要中途关闭；
• 路径建议使用英文，避免中文路径导致个别功能异常。

技术支持