墨韵 Inkgram
免费下载

使用指南

从首次登录到群组运营，按顺序读完大约十分钟。内容对应 v0.16.0 标准版。

一、准备 API 凭据并登录

软件以正式客户端身份连接 Telegram，需要你自己的官方 API 凭据。

  1. 打开 my.telegram.org，用手机号登录，进入 API development tools 创建一个应用，记下 api_id 与 api_hash。
  2. 在 Inkgram-0.16.0.exe 所在文件夹新建 .env.local（记事本「另存为」，文件类型「所有文件」，编码 UTF-8），写入： 
    TG_API_ID=你的api_id
TG_API_HASH=你的api_hash
TG_PROXY=auto
  3. 运行程序。扫码登录：用手机 Telegram 的「设置 → 设备 → 连接桌面设备」扫描；二维码有效期约 30 秒，过期点「刷新二维码」。手机号登录：填写带国家码的号码（如 +86），验证码可能发到已登录设备的「Telegram」服务通知而不是短信；开启两步验证的账号会再要一次密码。
  4. 需要多个账号时，点左上角当前账号 → 「添加账号」；下载记录、分组、订阅按账号分别保存。
安全提示 .env.local 与登录会话 .session 等同于账号凭证，只保存在本机，不要外传。

二、代理：通常不用配

Telegram 的 MTProto 走裸 TCP，浏览器读的「系统代理」对 socket 不生效，所以软件自己处理：读取 Windows 系统代理设置，探测哪个端口真的是 SOCKS5（Clash 的混合端口一次命中；HTTP / SOCKS 分离的会试相邻端口），只有 HTTP 端口时在本地架一层转发；什么都没探到就直连（TUN / 虚拟网卡模式下正好合适）。

  • 换了代理软件不用重启：登录页、主界面错误提示下方和「设置 → 连接代理」都有「重新检测代理」。
  • 视频预览提示 Proxy server unreachable 时，是代理连接失败而非文件损坏，在预览错误页点「重新检测代理并连接」。
  • 手动指定：「设置 → 连接代理」支持自动检测、SOCKS5、HTTP CONNECT 与 MTProto 代理链接，先「测试连接」再「保存并连接」。也可在 .env.local 里写 TG_PROXY=off（强制直连）或 TG_PROXY=socks5://127.0.0.1:7897。
  • 网络断开时窗口顶部会出现红色横幅，说明是电脑没网还是 Telegram 连接中断，恢复后自动收起。

三、下载与续传

  1. 在左侧会话列表打开频道、群组或私聊，切换到媒体视图，按视频 / 图片 / 音频 / 文件筛选，勾选后「下载选中」。首次会让你选择保存目录，之后可在会话头部或「设置 → 下载与存储」更改。
  2. 也可以：粘贴 t.me 消息链接；在聊天里拖动框选多条消息后下载附件；搜索结果里勾选「全选已加载」批量下载。
  3. 「下载管理」显示每个任务的进度，支持暂停、继续、「继续全部」「取消全部」和「清理」。未完成的文件以 .part 保存，重启软件后也能续传；不带 .part 的文件一定是完整的。
  4. 同时下载数默认 3，可在设置调整；调太高容易触发 Telegram 限流。

想让软件自动收集某个频道的资料：「任务中心 → 群组订阅」选择模板、来源与筛选条件，先「试运行并查看原因」再启用（自动执行属于订阅功能）。

四、收藏夹备份与迁移

  1. 打开左侧「收藏夹」，点「备份与迁移」→「导出」，选择一个空目录，按需勾选「同时下载附件」。导出生成 manifest.json（每条消息的正文、链接、转发来源和附件信息）和 files/。
  2. 切换或登录另一个账号，在同一入口选择「导入到此账号」，选中该目录。内容作为新消息发送到该账号的收藏夹，附件重新上传，可附「来源：群组名」。
  3. 已导入条目记录在目录内，重复运行只补发未发过的；导出和导入都可随时停止，遇到限流自动等待。
提醒 导出目录可能包含私密内容，请勿分享给不信任的人。

五、群组运营投放（订阅）

入口：左侧「运营」，或群组右键「定时投放到此群」。投放由本机调度器执行，需软件保持运行且当前账号已登录，属于自动化权益。

  1. 新建投放计划，选择自己管理的群组 / 频道（最多 30 个）。
  2. 编写可轮换的素材（最多 100 条，支持配图）。做联盟带货时先填写京东联盟 ID，素材里的京东链接可一键转成推广链接。
  3. 设置每轮间隔（最低 30 分钟）、每日次数、投放时段、目标之间的间隔（最少 20 秒），按需开启「发新一条前删除上一条」或静默发送。
  4. 在「短链与数据」生成短链和可选落地页，查看点击、独立访客、地区，并手动登记转化金额；投放记录可导出 CSV。

遇到限流自动等待，被 Telegram 拒绝时暂停全部投放并提示。频繁发送重复内容仍可能被判为骚扰，请控制频率、避免夸大宣传，只在获得授权的群组投放。

六、精简模式（只读）

在「设置 → 高级设置」开启后，软件只保留浏览、搜索和下载，隐藏输入框、转发、发送计划、投放、资料修改等所有会改动 Telegram 的入口，后端同时拒绝这些操作；访客的阅读也不会同步为已读。适合把账号借给别人看资源，或放在公用电脑上。

部署给访客时，用环境变量 TG_LITE_MODE=1 启动程序，这时无法从界面关闭精简模式。例如在 PowerShell 中：

$env:TG_LITE_MODE = "1"; .\Inkgram-0.16.0.exe

想在浏览器里提供只读浏览，可以看看 网页版。