<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>马仕的赛博空间 | 专注 AI 与技术分享</title>
    <link>https://macin.top/</link>
    <description>AI, Web3, VPS, 计算机软硬件, 网络技术教程</description>
    <language>zh-CN</language>
    <copyright>All rights reserved 2026, 马仕</copyright>
    <lastBuildDate>Thu, 20 Aug 2026 08:05:57 GMT</lastBuildDate>
    <generator>Hexo</generator>
    <image>
      <url>https://macin.top/img/ast.webp</url>
      <title>马仕的赛博空间 | 专注 AI 与技术分享</title>
      <link>https://macin.top/</link>
    </image>
    <atom:link href="https://macin.top/rss2.xml" rel="self" type="application/rss+xml"/>
    <item>
      <title>wardrobe 开源的电子衣柜，专门用来整理衣服，拍张照就能自动识别衣服、抠出单品图，还能生成你穿上身的模拟效果图</title>
      <link>https://macin.top/posts/6222e3a5/</link>
      <description>一个开源工具，专门用来整理衣服。它用上了 OpenAI 的图像能力，拍张照就能自动识别衣服、抠出单品图，还能生成你穿上身的模拟效果图。 基于 GPT-Image 技术，把衣服照片自动提取、分类、生成穿搭预览，数据全存在本地。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90/">开源</category>
      <pubDate>Thu, 20 Aug 2026 01:55:20 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="wardrobe"><a href="#wardrobe" class="headerlink" title="wardrobe"></a>wardrobe</h1><blockquote><p>一个开源工具，专门用来整理衣服。它用上了 OpenAI 的图像能力，拍张照就能自动识别衣服、抠出单品图，还能生成你穿上身的模拟效果图。</p><p>基于 GPT-Image 技术，把衣服照片自动提取、分类、生成穿搭预览，数据全存在本地。</p></blockquote><p>Github地址</p><p><a href="https://github.com/tandpfun/wardrobe">https://github.com/tandpfun/wardrobe</a></p><h2 id="能干什么"><a href="#能干什么" class="headerlink" title="能干什么"></a>能干什么</h2><ul><li>自动识别照片里的每件衣服，用 OpenAI Responses API 做检测</li><li>抠出干净的单品图，背景去掉，只剩衣服本身</li><li>可选生成”上身效果”——把你的脸和身材合成进去，看搭配效果</li><li>支持拖拽上传、粘贴图片、手动编辑、重新生成、审核确认</li><li>所有原始图、生成图、任务记录、JSON 数据库都存本地 <code>data/</code> 目录，不上传云端</li></ul><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><p>需要 Node.js 环境，步骤不复杂：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/tandpfun/wardrobe.git</span><br><span class="line">cd wardrobe</span><br><span class="line">npm install</span><br><span class="line">cp .env.example .env</span><br><span class="line"># 填入 OPENAI_API_KEY，放一张自己的 PNG 参考图到 data/model-reference.png</span><br><span class="line">npm run dev</span><br></pre></td></tr></table></figure><p>然后浏览器开 <code>localhost:5173</code> 就行。没填 API key 和参考图的话，导入功能锁着，用不了。</p><hr><p>两个自动化技能（给 AI 工具用的）</p><p>项目自带 Codex 技能脚本，适合让 AI 代理批量操作：</p><ul><li><code>$import-clothes</code>：指定文件夹，自动提取、生成模特图、入库</li><li><code>$generate-outfits</code>：从已有衣服里挑搭配，生成成套上身效果图</li></ul>]]>
      </content:encoded>
    </item>
    <item>
      <title>yuwen-publish-precheck 一个发布前审稿技能，专门帮做自媒体的人在发抖音、小红书、视频号之前，先过一遍稿子有没有踩线</title>
      <link>https://macin.top/posts/258d48b3/</link>
      <description>- 审稿子：不是简单扫违禁词，是结合上下文判断。比如&quot;月入过万&quot;写个人经历没事，绑着卖课链接就违规，它能分出这个区别。 - 给改法：不改你的语气，只拆违规的实质。上面那个例子，&quot;吃了两周瘦八斤&quot;改成&quot;把奶茶换成它，酸甜解馋&quot;，钩子保住了，风险去掉了。 - …</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E8%A7%86%E9%A2%91/">视频</category>
      <pubDate>Thu, 20 Aug 2026 01:53:43 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="yuwen-publish-precheck"><a href="#yuwen-publish-precheck" class="headerlink" title="yuwen-publish-precheck"></a>yuwen-publish-precheck</h1><blockquote><p>专门帮做自媒体的人在发抖音、小红书、视频号之前，先过一遍稿子有没有踩线。</p><p>把你的稿子扔进去，它告诉你哪句能发、哪句要改、怎么改，还能记住你每次踩的坑，越用越准。</p></blockquote><p>Github地址</p><p><a href="https://github.com/yuwen-cool/yuwen-publish-precheck">https://github.com/yuwen-cool/yuwen-publish-precheck</a></p><h2 id="特性"><a href="#特性" class="headerlink" title="特性"></a>特性</h2><ul><li>审稿子：不是简单扫违禁词，是结合上下文判断。比如”月入过万”写个人经历没事，绑着卖课链接就违规，它能分出这个区别。</li><li>给改法：不改你的语气，只拆违规的实质。上面那个例子，”吃了两周瘦八斤”改成”把奶茶换成它，酸甜解馋”，钩子保住了，风险去掉了。</li><li>记教训：你说”以后盯着这个词”、”这种说法我实测能过”，它存进你电脑本地，下次自动生效。数据不上传，存在你自己的 <code>data/</code> 文件夹里。</li><li>复盘限流：被限流了丢给它，做四类归因分析，教训固化成规则。</li><li>辟谣：遇到”赚钱必须写成赚米”这种自我审查谣言，会告诉你官方早澄清了，不用改。</li></ul><p>覆盖抖音、小红书、视频号，通用内容+医疗健康+金融理财有专门规则包。42条规则全部锚定官方来源，72条原文引文带链接能点开查。</p><hr><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><p>零依赖，要Python 3，完全本地跑。</p><p>一键装： 把这句发给Cursor、Claude Code或其他支持Agent Skills的工具：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">请安装这个 skill：https://github.com/yuwen-cool/yuwen-publish-precheck.git</span><br></pre></td></tr></table></figure><p>手动装：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/yuwen-cool/yuwen-publish-precheck.git ~/.cursor/skills/yuwen-publish-precheck</span><br></pre></td></tr></table></figure><p>装好第一句，复制就行：</p><ul><li>“审一下这篇口播稿能不能发抖音：（贴稿子）”</li><li>“改成小红书能发的版本”</li><li>“这条被限流了，帮我复盘”</li></ul><p>首次用会花一分钟建档（常发平台、行业、商业模式），之后不再重复问。</p><p>升级： 在目录里 <code>git pull</code>，你的个人数据不被Git跟踪，物理上碰不到，不会覆盖。</p><hr><h2 id="说明"><a href="#说明" class="headerlink" title="说明"></a>说明</h2><p> 不承诺100%过审，平台内部模型、账号状态这些看不见的因素没人能打包票。也不教谐音、拆字、遮挡这些绕审技巧，那是把小风险换大风险。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>docuseal 开源的电子签名工具，在线签字、PDF 表单、自动发邮件，一套全齐</title>
      <link>https://macin.top/posts/d30a3de0/</link>
      <description>开源的电子签名工具，对标 DocuSign，想省钱又要安全签合同？这玩意儿能自己架服务器，PDF 表单、在线签字、自动发邮件，一套全齐。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/Web/">Web</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90/">开源</category>
      <category domain="https://macin.top/tags/PDF/">PDF</category>
      <pubDate>Thu, 20 Aug 2026 01:52:22 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="docuseal"><a href="#docuseal" class="headerlink" title="docuseal"></a>docuseal</h1><blockquote><p>开源的电子签名工具，对标 DocuSign，想省钱又要安全签合同？这玩意儿能自己架服务器，PDF 表单、在线签字、自动发邮件，一套全齐。</p></blockquote><p>Github地址</p><p><a href="https://github.com/docusealco/docuseal">https://github.com/docusealco/docuseal</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>拖拖拽拽做 PDF 表单，12 种字段：签名、日期、文件上传、复选框这些</li><li>一份合同可以发给多个人签，按顺序或者一起签都行</li><li>签完自动盖电子章，还能验真假</li><li>邮件 SMTP 自动发提醒，不用手动催</li><li>文件存本地、S3、谷歌云、Azure 随便选</li><li>手机打开不费劲，界面自适应</li><li>UI 支持 7 种语言，签字界面 14 种语言</li><li>有 API 和 Webhook，能接进自己系统</li></ul><h2 id="怎么跑起来"><a href="#怎么跑起来" class="headerlink" title="怎么跑起来"></a>怎么跑起来</h2><p>最快就一行 Docker：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">docker run --name docuseal -p 3000:3000 -v.:/data docuseal/docuseal</span><br></pre></td></tr></table></figure><p>默认 SQLite 够用，生产环境配个 <code>DATABASE_URL</code> 切 PostgreSQL 或 MySQL。要 HTTPS 自定义域名就下 docker-compose.yml，DNS 指过去 Caddy 自动搞证书：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">curl https://raw.githubusercontent.com/docusealco/docuseal/master/docker-compose.yml &gt; docker-compose.yml</span><br><span class="line">sudo HOST=your-domain.com docker compose up</span><br></pre></td></tr></table></figure><p>Heroku、Railway、DigitalOcean、Render 也都能一键部署，按钮在 README 里点就行。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>YunX 安卓端的网盘解析下载工具，专门解决各种网盘分享链的提取和下载问题</title>
      <link>https://macin.top/posts/9b2c2000/</link>
      <description>一款安卓端的网盘解析下载工具，专门解决各种网盘分享链的提取和下载问题。粘贴网盘分享链接，解析出真实下载地址，然后用多线程分段下载把文件拽到本地。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/os/">os</category>
      <category domain="https://macin.top/categories/os/android/">android</category>
      <category domain="https://macin.top/tags/%E5%85%8D%E8%B4%B9/">免费</category>
      <category domain="https://macin.top/tags/%E4%B8%8B%E8%BD%BD/">下载</category>
      <category domain="https://macin.top/tags/OS/">OS</category>
      <category domain="https://macin.top/tags/Android/">Android</category>
      <category domain="https://macin.top/tags/%E5%BF%85%E5%A4%87APP/">必备APP</category>
      <category domain="https://macin.top/tags/%E5%BA%94%E7%94%A8%E6%8E%A8%E8%8D%90/">应用推荐</category>
      <pubDate>Thu, 20 Aug 2026 01:29:07 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="YunX"><a href="#YunX" class="headerlink" title="YunX"></a>YunX</h1><blockquote><p>一款安卓端的网盘解析下载工具，专门解决各种网盘分享链的提取和下载问题。粘贴网盘分享链接，解析出真实下载地址，然后用多线程分段下载把文件拽到本地。</p></blockquote><p>Github地址</p><p><a href="https://github.com/CYQawa/YunX">https://github.com/CYQawa/YunX</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>支持夸克、UC、迅雷、百度、123云盘、139和彩云这几家的分享链接，自动识别提取码</li><li>下载用Range分片并发，最多32线程同时拉，断点续传也有，中途断了不用从头再来</li><li>百度和迅雷取完链会自动清理临时转存，夸克则是等下载完或你手动删任务才清理，省得网盘里一堆垃圾</li><li>登录方式各家不同：夸克&#x2F;UC&#x2F;百度&#x2F;139走WebView扫Cookie，迅雷用密码或短信，123云盘拿账号密码换JWT</li><li>凭证能备份，用你自己设的口令派生密钥，AES-GCM加密存着，换机或重装不怕重新登录</li><li>剪贴板监控开着，复制了分享链接回到App会弹窗问要不要直接粘贴解析</li></ul><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><ol><li>先去”网盘”页把要用的账号登了</li><li>“解析”页粘贴分享链接，带不带提取码都行</li><li>浏览分享内容，点文件拿到直链</li><li>“下载”页看进度，暂停、继续、删任务、打开文件都行</li></ol><p>自己编译的话： minSdk 21，targetSdk 34。<code>git clone https://github.com/CYQawa/YunX.git</code> 下来，Android Studio直接开。作者用AndroidIDE写的，其他安卓构建环境理论上也能跑。</p><h2 id="提醒一句"><a href="#提醒一句" class="headerlink" title="提醒一句"></a>提醒一句</h2><p>百度网盘慎用，有风控封号风险。项目AGPL-3.0协议开源，仅供学习交流，别拿去做商业买卖。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>Escrcpy 手机投屏到电脑</title>
      <link>https://macin.top/posts/79cfec6e/</link>
      <description>今天介绍的这款手机投屏到电脑的软件叫：Escrcpy，是一款开源免费的软件，软件干净简洁，无广告零套路。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/os/">os</category>
      <category domain="https://macin.top/categories/os/android/">android</category>
      <category domain="https://macin.top/tags/%E5%85%8D%E8%B4%B9/">免费</category>
      <category domain="https://macin.top/tags/OS/">OS</category>
      <category domain="https://macin.top/tags/Android/">Android</category>
      <category domain="https://macin.top/tags/%E5%BF%85%E5%A4%87APP/">必备APP</category>
      <category domain="https://macin.top/tags/%E5%BA%94%E7%94%A8%E6%8E%A8%E8%8D%90/">应用推荐</category>
      <pubDate>Thu, 20 Aug 2026 01:15:32 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p><strong>软件介绍</strong></p><p>今天介绍的这款手机投屏到电脑的软件叫：<strong>Escrcpy</strong>，是一款开源免费的软件，软件干净简洁，无广告零套路。</p><p><img src="/img/Escrcpy/1.webp" alt="图片"></p><p>投屏类的软件一定要<strong>两台设备都在同一局域网内</strong>，不在同一局域网不支持同屏。</p><p>软件分为有线投屏和无线投屏，不过不管是有线还是无级，都要确保已打开【开发者选项】和【USB调试】。</p><p><img src="/img/Escrcpy/2.webp" alt="图片"></p><p><img src="/img/Escrcpy/3.webp" alt="图片"></p><p><strong>无线连接：</strong></p><p>如果没有数据线，我们还可以无线连接。可以在“无线调试”里使用二维码配对设备，然后扫描二维码配对。</p><p><img src="/img/Escrcpy/4.webp" alt="图片"></p><p><img src="/img/Escrcpy/5.webp" alt="图片"></p><p>在Escrcpy中，点击下面的【扫码连接】按钮，然后就是上右图里扫描连接接即可。</p><p><img src="/img/Escrcpy/6.webp" alt="图片"></p><p><strong>有线连接</strong></p><p>有线连接就比较简单了，手机使用数据线连接电脑后，在电脑中就能查看到手机设备。点击【开始镜像】即能手机投屏到电脑中。</p><p><img src="/img/Escrcpy/7.webp" alt="图片"></p><p><strong>主要功能</strong></p><p>Escrcpy这款软件支持多手机投屏，有多设备连接、启动APP、屏幕旋转、开关屏幕等等功能。</p><p><strong>多设备连接</strong>，通过有线或者无线连接到Escrcpy后，可以同时在电脑端里显示多部手机设备的连接，便于我们操作。</p><p><img src="/img/Escrcpy/8.webp" alt="图片"></p><p>**启动APP：**在电脑端有个【启动APP】的功能，点击这里，然后选择自己需要启动的APP，即能启动手机里的APP软件。</p><p><img src="/img/Escrcpy/9.webp" alt="图片"></p><p>下面是启动的动图：</p><p><img src="/img/Escrcpy/1.gif" alt="图片"></p><p>**屏幕旋转：**手机端的打开APP基本都是竖屏的，如果软件自带能横屏还好，如果无法横屏，那么只能用软件来实现。</p><p><img src="/img/Escrcpy/10.webp" alt="图片"></p><p>而Escrcpy就自带了旋转屏幕的功能，选择横屏，则手机端立马就横屏使用。</p><p>**息屏且保持控制：**点击按钮，可以开启屏幕和息屏操作，这样就可以愉快的通过电脑操控手机摸鱼了。</p><p><img src="/img/Escrcpy/11.webp" alt="图片"></p><p>**其他功能：**除了上面介绍的功能之外，软件还有音量控制、截取屏幕、安装APP、文件管理等等实用功能。</p><p><img src="/img/Escrcpy/12.webp" alt="图片"></p><p>其中的<strong>文件管理功能</strong>就是可以上传和下载手机端的资源，挺方便的！</p><p><img src="/img/Escrcpy/13.webp" alt="图片"></p><p>其他的大家自己去体验，软件就介绍到这里啦！</p><p>手机投屏Escrcpy</p><p>夸克：<a href="https://pan.quark.cn/s/e162c52a8bad">https://pan.quark.cn/s/e162c52a8bad</a></p><p>百度：<a href="https://pan.baidu.com/s/58Rr_KKlTU6H_vAmmb2u8Mg">https://pan.baidu.com/s/58Rr_KKlTU6H_vAmmb2u8Mg</a></p><p>迅雷：<a href="https://pan.xunlei.com/s/VOtO6idO4sK_rrqnINu5UvC-A1?pwd=n7g2#">https://pan.xunlei.com/s/VOtO6idO4sK_rrqnINu5UvC-A1?pwd=n7g2#</a></p>]]>
      </content:encoded>
    </item>
    <item>
      <title>DeepSeek Harness 实操教程！（万字长文）</title>
      <link>https://macin.top/posts/59de1e22/</link>
      <description>npx @deepseek-ai/dsh plugin --profile web remove dsh-find-plugin npx @deepseek-ai/dsh plugin --profile web remove dshmarket</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/ai/">ai</category>
      <category domain="https://macin.top/categories/ai/deepseek/">deepseek</category>
      <category domain="https://macin.top/tags/%E6%95%99%E7%A8%8B/">教程</category>
      <category domain="https://macin.top/tags/%E6%A8%A1%E5%9E%8B/">模型</category>
      <category domain="https://macin.top/tags/AI/">AI</category>
      <category domain="https://macin.top/tags/AI%E7%BC%96%E7%A8%8B/">AI编程</category>
      <category domain="https://macin.top/tags/deepseek/">deepseek</category>
      <pubDate>Thu, 20 Aug 2026 01:02:39 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p>前两天，DeepSeek 正式公布了V4-Pro，随后又直接把 Agent 框架开源了。</p><p>这个项目叫 <code>DeepSeek Harness</code>，简称 <code>dsh</code>。</p><p><img src="/img/deepseek_harness/35.webp" alt="图片"></p><p>如果你平时只在 DeepSeek 网页里聊天，可以把这次的变化理解成：</p><blockquote><p>以前的 AI 主要坐在聊天框里回答问题，现在它开始走进你指定的电脑文件夹，自己查看文件、执行命令、整理计划，在得到允许后还能修改内容。</p></blockquote><p>它开始面对一个真实项目：里面有文件、有结构，也有可能被改动的内容。</p><p><img src="/img/deepseek_harness/36.webp" alt="图片"></p><p>不过先把预期放稳。</p><p>官方把当前版本标成了<strong>技术预览</strong>。</p><p>简单说，它已经可以安装和研究，但仍在快速变化，后续可能出现无法兼容旧配置的更新。</p><p>第一次使用，先拿测试文件夹练手，别急着把整个工作目录交给它。</p><h2 id="它到底是什么"><a href="#它到底是什么" class="headerlink" title="它到底是什么"></a><strong>它到底是什么</strong></h2><p>Harness 这个词直译过来有“挽具、套具”的意思。</p><p>放到 AI 领域，可以理解成一套把模型、工具和工作环境连接起来的系统。</p><p>模型负责思考，工具负责行动，工作区决定它能看到什么。</p><p>三样东西接起来，AI 才能从“告诉你怎么做”，走到“在指定范围里帮你做”。</p><p>DeepSeek Harness 自带一个 Web UI。</p><p><img src="/img/deepseek_harness/37.webp" alt="图片"></p><p>Web UI 就是可以在浏览器里打开的操作页面，外观接近我们熟悉的聊天工具。</p><p>底层依然运行在你的电脑上，浏览器只是操作窗口。</p><p>官方还用了一个专业说法：<strong>一切皆插件</strong>。</p><p>普通用户先把它理解成“以后可以继续加能力”就够了。</p><p>模型、文件操作、命令行、会话和其他工具都能通过模块进行组合。</p><p>至于 Cordis、Bundle、Profile 这些词，基础安装阶段完全不用管。</p><h2 id="开始前，认识这-6-个词"><a href="#开始前，认识这-6-个词" class="headerlink" title="开始前，认识这 6 个词"></a><strong>开始前，认识这 6 个词</strong></h2><p>下面会出现几个技术词，先看一遍，后面的安装会顺很多。</p><p><strong>1. Node.js</strong></p><p>运行 dsh 需要的一套基础环境，你可以把它理解成 dsh 的发动机。</p><p>安装 Node.js 不代表你要学编程。</p><p><img src="/img/deepseek_harness/38.webp" alt="图片"></p><p><strong>2. PowerShell</strong></p><p>Windows 自带的命令窗口，我们只会在里面复制几条命令，不需要手写代码。</p><p><img src="/img/deepseek_harness/39.webp" alt="图片"></p><p><strong>3. npm</strong></p><p>Node.js 自带的软件包管理工具，负责下载和管理程序。</p><p><strong>4. npx</strong></p><p>npx 也会随 Node.js 一起安装。</p><p>它可以临时下载并运行 dsh，所以本教程不要求你先手动安装 Harness。</p><p><strong>5. API Key</strong></p><p>一串通常以 <code>sk-</code> 开头的密钥。</p><p>Harness 要拿着它去调用 DeepSeek 模型，它相当于模型接口的通行证，需要保密，也会产生 API 用量。</p><p><img src="/img/deepseek_harness/40.webp" alt="图片"></p><p><strong>6. 工作区</strong></p><p>你允许 Harness 处理的电脑文件夹。Agent 读取文件、创建文档或执行命令，都会围绕这个目录进行。</p><p><img src="/img/deepseek_harness/41.webp" alt="图片"></p><p>认识这些就够了。</p><h2 id="从零开始安装"><a href="#从零开始安装" class="headerlink" title="从零开始安装"></a><strong>从零开始安装</strong></h2><h3 id="第-1-步：安装-Node-js"><a href="#第-1-步：安装-Node-js" class="headerlink" title="第 1 步：安装 Node.js"></a><strong>第 1 步：安装 Node.js</strong></h3><p>打开浏览器，搜索 Node.js ，找到官网进入下载页面。</p><p><img src="/img/deepseek_harness/42.webp" alt="图片"></p><p>截至 2026 年 8 月 15 日，Node.js 官网提供的长期支持版是 24.x。</p><p>DeepSeek Harness 当前源码要求 Node.js <code>22.19.0</code> 及以上的 22.x，或者 24.0.0 及以上版本。</p><p>普通用户直接选择 <strong>24.x LTS</strong> 就可以，LTS 的意思是“长期支持版”，通常比追最新测试功能更省心。</p><p>Windows 用户下载对应的安装程序后，双击打开，没有特殊需求时，安装向导保持默认选项，一路继续即可。</p><p>安装完成后，先把已经打开的 PowerShell 或终端全部关闭，旧窗口可能还识别不到刚安装的 Node.js。</p><p>现在重新打开 PowerShell：</p><ol><li>点击 Windows 开始菜单；</li><li>输入 <code>PowerShell</code>；</li><li>打开“Windows PowerShell”。</li></ol><p><img src="/img/deepseek_harness/43.webp" alt="图片"></p><p>在窗口里依次粘贴下面两条命令，每粘贴一条就按一次回车：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">node --version</span><br><span class="line">npm --version</span><br></pre></td></tr></table></figure><p><img src="/img/deepseek_harness/44.webp" alt="图片"></p><p>第一条会显示 Node.js 版本，第二条会显示 npm 版本。</p><p>你的版本号不一定和我的一样，只要第一条显示 <code>v24...</code>，或者显示不低于 <code>v22.19.0</code> 的版本；第二条也能显示数字，这一步就通过了。</p><p>如果出现“无法将 node 识别为命令”之类的提示，先关闭 PowerShell 再打开一次。</p><p>仍然无效时，重新安装 Node.js，然后重启电脑再检查。</p><h3 id="第-2-步：准备-DeepSeek-API-Key"><a href="#第-2-步：准备-DeepSeek-API-Key" class="headerlink" title="第 2 步：准备 DeepSeek API Key"></a><strong>第 2 步：准备 DeepSeek API Key</strong></h3><p>接下来准备模型密钥。</p><p>打开 DeepSeek 开放平台的 API Key 页面，登录自己的 DeepSeek 开放平台账号。</p><p>找到创建 API Key 的入口，新建一条密钥，然后复制保存，密钥以 <code>sk-</code> 开头。</p><p><img src="/img/deepseek_harness/45.webp" alt="图片"></p><p>这里有三个容易混淆的地方：</p><ul><li>API Key 不是 DeepSeek 网页版的账号密码；</li><li>Harness 调用的是 DeepSeek API，会按照 API 的实际用量计费；</li><li>账户余额不足时，调用可能返回 402 错误。</li></ul><p>所以创建密钥后，顺手检查一下开放平台余额，具体价格会调整，发布文章时以官方页面通知为准。</p><p>密钥暂时放在密码管理器或安全的临时位置，下一步会粘贴到 Harness。</p><p><strong>不要把完整密钥发给别人，也不要让它出现在截图里。</strong></p><h3 id="第-3-步：创建一个测试文件夹"><a href="#第-3-步：创建一个测试文件夹" class="headerlink" title="第 3 步：创建一个测试文件夹"></a><strong>第 3 步：创建一个测试文件夹</strong></h3><p>现在给 Harness 准备一个单独的工作区。</p><p>打开 Windows 文件资源管理器，进入一个容易找到的位置，比如“文档”。</p><p>新建文件夹，并把它命名为 <code>test1</code>。</p><p>双击进入这个文件夹。</p><p>第一次测试建议使用空文件夹，这样即便选错设置或误操作，也不会碰到日常文件。</p><h3 id="第-4-步：直接在这个文件夹里打开-PowerShell"><a href="#第-4-步：直接在这个文件夹里打开-PowerShell" class="headerlink" title="第 4 步：直接在这个文件夹里打开 PowerShell"></a><strong>第 4 步：直接在这个文件夹里打开 PowerShell</strong></h3><p>保持文件资源管理器停留在 <code>test1</code> 文件夹。</p><p>点击窗口上方显示文件路径的地址栏，把里面的路径文字选中，然后改成<code>powershell </code>，按回车。</p><p><img src="/img/deepseek_harness/46.webp" alt="图片"></p><p>Windows 会打开一个 PowerShell 窗口，而且当前位置已经是 <code>test1</code>。</p><p>不要关闭这个 PowerShell，下一步就在这里执行。</p><h3 id="第-5-步：运行-Harness"><a href="#第-5-步：运行-Harness" class="headerlink" title="第 5 步：运行 Harness"></a><strong>第 5 步：运行 Harness</strong></h3><p>把下面这一整行复制到 PowerShell，然后按回车：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh web</span><br></pre></td></tr></table></figure><p>这条命令可以拆成三部分理解：</p><ul><li><code>npx</code>：帮你临时下载并运行程序；</li><li><code>@deepseek-ai/dsh</code>：DeepSeek 官方发布的软件包；</li><li><code>web</code>：启动浏览器操作页面。</li></ul><p>第一次运行需要准备相关文件，等待时间会比后面长。</p><p>由于我已经安装好了，所以这里直接给我运行的地址。</p><p><img src="/img/deepseek_harness/47.webp" alt="图片"></p><p>如果终端询问是否继续下载或安装，按照屏幕提示确认即可，不同 npm 版本的提示文字可能略有区别。</p><p>等待过程中不要连续重复粘贴命令，也不要关闭窗口。</p><p>看到终端打印出访问地址时，说明本地服务已经启动。官方默认地址是：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">http://127.0.0.1:3080</span><br></pre></td></tr></table></figure><p><code>127.0.0.1</code> 指的是你当前这台电脑。</p><p>它看起来像网址，实际连接的是本机正在运行的 Harness 服务。</p><h3 id="第-6-步：在浏览器里打开-Harness"><a href="#第-6-步：在浏览器里打开-Harness" class="headerlink" title="第 6 步：在浏览器里打开 Harness"></a><strong>第 6 步：在浏览器里打开 Harness</strong></h3><p><strong>现在不要关 PowerShell。</strong></p><p>只要 PowerShell 被关闭，网页也会跟着<strong>失去连接</strong>。</p><p>打开 Chrome、Edge 或你常用的浏览器，把终端打印的地址复制到地址栏。默认情况下就是：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">http://127.0.0.1:3080</span><br></pre></td></tr></table></figure><p>按回车后，应该会进入 DeepSeek Harness 的 Web UI。</p><p><img src="/img/deepseek_harness/48.webp" alt="图片"></p><p>如果浏览器显示无法访问，先回到 PowerShell 看看程序是否还在运行、终端有没有红色错误。</p><p>到这一步，Harness 已经在电脑上跑起来了，但它还没有模型，也没有选中工作区，所以暂时不能开始对话。</p><h3 id="第-7-步：把-DeepSeek-模型接进来"><a href="#第-7-步：把-DeepSeek-模型接进来" class="headerlink" title="第 7 步：把 DeepSeek 模型接进来"></a><strong>第 7 步：把 DeepSeek 模型接进来</strong></h3><p>如果是初次打开网页的话，它回首先提示你去添加你的API Key，后续可以在设置里面改。</p><p>如果后续要修改的话，在 Harness 页面中打开：</p><p><strong>设置 → 模型</strong></p><p>找到 DeepSeek 对应的卡片，把第 2 步准备好的 API Key 粘贴进去，然后保存。</p><p><img src="/img/deepseek_harness/49.webp" alt="图片"></p><p>保存后不需要重启 Harness，模型配置会在下一次请求时生效。</p><p>如果页面要求选择模型，就从当前列出的 DeepSeek 模型中选择一个，模型名称会随着服务更新而变化，以你页面里的实际选项为准。</p><p>API Key 保存后，页面只会显示脱敏信息，不会重新展示完整密钥。</p><p>密钥会保存在 <code>$DSH_HOME/.credentials.yaml</code> 中，这个路径是配置存放位置，普通用户不需要现在去修改它。</p><p><img src="/img/deepseek_harness/50.webp" alt="图片"></p><p>这里显示的是我已经添加好了其他的模型 API。</p><h3 id="第-8-步：选中刚才的测试文件夹"><a href="#第-8-步：选中刚才的测试文件夹" class="headerlink" title="第 8 步：选中刚才的测试文件夹"></a><strong>第 8 步：选中刚才的测试文件夹</strong></h3><p>模型配置好以后，回到主页面，点击 <strong>选择工作区</strong>。</p><p>添加并选中刚刚创建的 <code>test1</code> 文件夹。</p><p><img src="/img/deepseek_harness/51.webp" alt="图片"></p><p>为什么还要再选一次？</p><p>因为“从哪个文件夹启动 Harness”和“当前会话允许操作哪个工作区”是两层设置，新的 Web UI 在添加工作区前不会自动选中任何目录。</p><p>选中后，原本不可用的消息输入框会开放。</p><p>现在检查下面四项：</p><ul><li>PowerShell 里的 dsh 仍在运行；</li><li>浏览器能正常打开 Harness 页面；</li><li>DeepSeek 模型已经保存并处于可选择状态；</li><li>当前工作区显示为 <code>test1</code>，消息输入框可以点击。</li></ul><p>四项都满足，安装和基础配置就完成了。</p><p>到这里，你已经可以开始正式使用了。</p><h2 id="安装完成后，怎样关闭和再次启动"><a href="#安装完成后，怎样关闭和再次启动" class="headerlink" title="安装完成后，怎样关闭和再次启动"></a><strong>安装完成后，怎样关闭和再次启动</strong></h2><p>Harness 运行时，PowerShell 窗口需要保持打开。</p><p>想停止服务时，回到 PowerShell，按<code>Ctrl + C</code>，或者直接关掉窗口也行。</p><p>关闭后，浏览器里的 Harness 页面将会无法继续连接，这是正常现象。</p><p>下次使用时，不需要从头安装 Node.js。</p><p>只要重新进入 <code>test1</code> 文件夹，在地址栏输入 <code>powershell</code>，再运行：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh web</span><br></pre></td></tr></table></figure><p>然后打开终端给出的本地地址即可。</p><p>模型与密钥设置会保存在 dsh 的配置目录中，正常情况下不需要每次重新填写。</p><p>当前产品仍在技术预览阶段；若升级后配置行为发生变化，以新版官方文档为准。</p><h2 id="如果安装卡住，按这个顺序排查"><a href="#如果安装卡住，按这个顺序排查" class="headerlink" title="如果安装卡住，按这个顺序排查"></a><strong>如果安装卡住，按这个顺序排查</strong></h2><p>连续操作时先不要到处改设置。对照自己卡在哪一步：</p><h3 id="1-node-version-没有结果"><a href="#1-node-version-没有结果" class="headerlink" title="1. node --version 没有结果"></a><strong>1. <code>node --version</code> 没有结果</strong></h3><p>Node.js 没安装成功，或者旧 PowerShell 没刷新环境。</p><p>先关闭 PowerShell，重新打开；仍然失败，再重新安装 Node.js，并重启电脑。</p><h3 id="2-npm-version-没有结果"><a href="#2-npm-version-没有结果" class="headerlink" title="2. npm --version 没有结果"></a><strong>2. <code>npm --version</code> 没有结果</strong></h3><p>npm 会跟着 Node.js 一起安装。</p><p>只装好了 Node 却没有 npm 时，优先重新运行 Node.js 安装程序。</p><h3 id="3-npx-deepseek-ai-dsh-web-一直下载失败"><a href="#3-npx-deepseek-ai-dsh-web-一直下载失败" class="headerlink" title="3. npx @deepseek-ai/dsh web 一直下载失败"></a><strong>3. <code>npx @deepseek-ai/dsh web</code> 一直下载失败</strong></h3><p>先看终端给出的具体错误。</p><p>常见影响因素包括网络连接、npm 下载源和代理设置。</p><p>不要根据别人的旧教程随意安装同名 Python 包，它们解决不了官方 npm 包的下载问题。</p><h3 id="4-3080-页面打不开"><a href="#4-3080-页面打不开" class="headerlink" title="4. 3080 页面打不开"></a><strong>4. 3080 页面打不开</strong></h3><p>确认 PowerShell 没有被关闭，并检查终端实际输出的地址。</p><p>如果提示 3080 端口被占用，可以换到 8080：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh --profile web --port 8080</span><br></pre></td></tr></table></figure><p>再访问终端打印的新地址。</p><h3 id="5-页面打开了，输入框仍是灰色"><a href="#5-页面打开了，输入框仍是灰色" class="headerlink" title="5. 页面打开了，输入框仍是灰色"></a><strong>5. 页面打开了，输入框仍是灰色</strong></h3><p>依次检查：</p><ol><li>模型 API Key 是否保存；</li><li>是否选择了一个可用模型；</li><li>是否添加并选中了工作区。</li></ol><p>官方 Web UI 在没有选中工作区时会禁用输入框。</p><h3 id="6-模型提示-401-或-MISSING-CREDENTIAL"><a href="#6-模型提示-401-或-MISSING-CREDENTIAL" class="headerlink" title="6. 模型提示 401 或 MISSING_CREDENTIAL"></a><strong>6. 模型提示 401 或 <code>MISSING_CREDENTIAL</code></strong></h3><p>401 一般表示密钥认证失败。重新检查 API Key 是否复制完整。</p><p><code>MISSING_CREDENTIAL</code> 表示当前模型没有找到可用凭据，回到“设置 → 模型”重新保存密钥。</p><h3 id="7-模型提示-402"><a href="#7-模型提示-402" class="headerlink" title="7. 模型提示 402"></a><strong>7. 模型提示 402</strong></h3><p>DeepSeek 官方错误码中，402 表示余额不足。前往开放平台检查余额和充值状态。</p><h2 id="第一次实操"><a href="#第一次实操" class="headerlink" title="第一次实操"></a><strong>第一次实操</strong></h2><p>安装完成不代表要立刻拿真实项目上手。</p><p><code>test1</code> 现在还是空的，Agent 没有东西可读。</p><p>我们先放入两个简单文本文件。</p><h3 id="1-创建“说明-txt”"><a href="#1-创建“说明-txt”" class="headerlink" title="1. 创建“说明.txt”"></a><strong>1. 创建“说明.txt”</strong></h3><p>打开 Windows 记事本，粘贴：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">这是我的第一个 Harness 测试文件夹。</span><br><span class="line">目标是测试 AI 能否读取文件、整理待办，并在确认后生成一份项目概览。</span><br></pre></td></tr></table></figure><p>选择“文件 → 另存为”，保存到 <code>test1</code>，文件名填写：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">说明.txt</span><br></pre></td></tr></table></figure><h3 id="2-创建“待办-txt”"><a href="#2-创建“待办-txt”" class="headerlink" title="2. 创建“待办.txt”"></a><strong>2. 创建“待办.txt”</strong></h3><p>再新建一个记事本文档，粘贴：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br></pre></td><td class="code"><pre><span class="line">1. 了解 Harness 是什么</span><br><span class="line">2. 完成基础安装</span><br><span class="line">3. 测试只读分析</span><br><span class="line">4. 测试生成项目概览</span><br></pre></td></tr></table></figure><p>保存到同一个文件夹，文件名填写：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">待办.txt</span><br></pre></td></tr></table></figure><p>这样我们就有了一组自己完全知道答案的测试材料。</p><p>Agent 总结得对不对，可以直接对照原文检查。</p><h2 id="第一个任务：只允许读取，不允许修改"><a href="#第一个任务：只允许读取，不允许修改" class="headerlink" title="第一个任务：只允许读取，不允许修改"></a><strong>第一个任务：只允许读取，不允许修改</strong></h2><p>回到 Harness 页面，新建会话，把下面这段完整粘贴进去：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br></pre></td><td class="code"><pre><span class="line">请先只读取当前工作区中的文件。</span><br><span class="line"></span><br><span class="line">完成以下任务：</span><br><span class="line">1. 列出你实际读取到的文件名；</span><br><span class="line">2. 用三句话概括这个测试项目的目标；</span><br><span class="line">3. 把“待办.txt”里的事项按顺序整理出来；</span><br><span class="line">4. 列出你无法确认的信息。</span><br><span class="line"></span><br><span class="line">限制：</span><br><span class="line">- 不要创建、删除、移动或修改任何文件；</span><br><span class="line">- 不要安装软件或依赖；</span><br><span class="line">- 不要执行会改变电脑环境的命令；</span><br><span class="line">- 如果信息不足，直接说明，不要猜测。</span><br></pre></td></tr></table></figure><p>这段提示词故意写得比较完整，因为第一次任务的目标不是考 AI 猜谜，而是确认三件事：</p><ul><li>它能不能看到正确的文件；</li><li>它能不能遵守只读要求；</li><li>它的回答能不能和原始内容对上。</li></ul><p>如果页面出现操作确认，先看清楚它准备做什么。</p><p>读取两个文本文件不需要安装依赖，也不应该修改其他目录。请求明显超出任务范围时，先拒绝，再让它解释原因。</p><p>任务完成后，不要只看回答写得像不像。</p><p>打开 <code>说明.txt</code> 和 <code>待办.txt</code>，逐条核对文件名、目标和待办顺序。</p><h2 id="第二个任务：确认计划后，只新建一个文件"><a href="#第二个任务：确认计划后，只新建一个文件" class="headerlink" title="第二个任务：确认计划后，只新建一个文件"></a><strong>第二个任务：确认计划后，只新建一个文件</strong></h2><p>只读结果可信，再进入写入测试。</p><p>继续发送：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br></pre></td><td class="code"><pre><span class="line">根据刚才读取到的内容，准备在当前工作区新建“项目概览.md”。</span><br><span class="line"></span><br><span class="line">文件只包含四部分：</span><br><span class="line">1. 项目目标；</span><br><span class="line">2. 已有文件及用途；</span><br><span class="line">3. 当前待办；</span><br><span class="line">4. 无法确认的信息。</span><br><span class="line"></span><br><span class="line">先把执行计划和准备写入的完整内容发给我。</span><br><span class="line">在我回复“确认创建”之前，不要写入文件。</span><br><span class="line">不要修改“说明.txt”和“待办.txt”，也不要创建其他文件。</span><br></pre></td></tr></table></figure><p>看到计划后，先自己检查内容。</p><p>确认没有编造、没有漏项，也没有准备修改其他文件，再回复：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">确认创建。完成后告诉我你实际新建了哪个文件，不要做其他改动。</span><br></pre></td></tr></table></figure><p>执行结束后，回到 Windows 文件资源管理器。</p><p>正常情况下，<code>dsh-first-run</code> 中会多出一个 <code>项目概览.md</code>。用记事本或任意 Markdown 编辑器打开它，检查内容是否和刚才确认的版本一致。</p><p>这里的“正常情况下”只是待验证的预期。最终是否创建成功、是否弹出权限确认、用了多久、有没有多改文件，都要以真实操作记录为准。</p><h2 id="以后给-Harness-下任务，记住这个公式"><a href="#以后给-Harness-下任务，记住这个公式" class="headerlink" title="以后给 Harness 下任务，记住这个公式"></a><strong>以后给 Harness 下任务，记住这个公式</strong></h2><p>任务越模糊，Agent 自己补充的假设就越多。</p><p>普通用户不需要学习复杂的提示词技巧，只要把下面五件事写清楚：</p><ol><li><strong>目标</strong>：最后想得到什么；</li><li><strong>范围</strong>：允许查看或修改哪里；</li><li><strong>限制</strong>：哪些事情绝对不能做；</li><li><strong>步骤</strong>：是否要先给计划、等待确认；</li><li><strong>验收</strong>：完成后如何检查。</li></ol><p>可以复制这份模板：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br></pre></td><td class="code"><pre><span class="line">目标：XXX</span><br><span class="line"></span><br><span class="line">允许范围：只处理XXX</span><br><span class="line"></span><br><span class="line">禁止事项：</span><br><span class="line">- 不要XXX；</span><br><span class="line">- 不要XXX</span><br><span class="line"></span><br><span class="line">执行方式：</span><br><span class="line">先检查现状并给出计划。</span><br><span class="line">涉及写文件、删除内容、安装软件或运行高风险命令时，先等待我确认。</span><br><span class="line"></span><br><span class="line">交付物：XXX</span><br><span class="line"></span><br><span class="line">验收条件：XXX</span><br><span class="line"></span><br><span class="line">遇到不确定信息时直接列出，不要自行猜测。</span><br></pre></td></tr></table></figure><h2 id="四个普通人能直接改写的用法"><a href="#四个普通人能直接改写的用法" class="headerlink" title="四个普通人能直接改写的用法"></a><strong>四个普通人能直接改写的用法</strong></h2><h3 id="整理一批文档"><a href="#整理一批文档" class="headerlink" title="整理一批文档"></a><strong>整理一批文档</strong></h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">只读取“本周资料”文件夹，按主题列出文件清单和每份文件的核心内容。</span><br><span class="line">先输出整理建议，不要移动、重命名或删除文件。</span><br></pre></td></tr></table></figure><h3 id="检查知识库"><a href="#检查知识库" class="headerlink" title="检查知识库"></a><strong>检查知识库</strong></h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">只读取当前 Markdown 知识库，找出重复主题、可能失效的内部链接和缺少索引的文件。</span><br><span class="line">先生成检查报告，不要修改任何笔记。</span><br></pre></td></tr></table></figure><h3 id="帮项目补说明文档"><a href="#帮项目补说明文档" class="headerlink" title="帮项目补说明文档"></a><strong>帮项目补说明文档</strong></h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">阅读当前项目，拟一份 README 大纲。</span><br><span class="line">说明每一部分的信息来自哪个文件。</span><br><span class="line">先发大纲给我确认，不要直接修改 README.md。</span><br></pre></td></tr></table></figure><h3 id="帮忙定位报错"><a href="#帮忙定位报错" class="headerlink" title="帮忙定位报错"></a><strong>帮忙定位报错</strong></h3><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">检查当前项目的报错。</span><br><span class="line">先尝试复现并说明原因，只给出修复方案，不要修改代码。</span><br><span class="line">需要安装依赖或改变环境时，先向我确认。</span><br></pre></td></tr></table></figure><h2 id="三条安全边界，比提示词更重要"><a href="#三条安全边界，比提示词更重要" class="headerlink" title="三条安全边界，比提示词更重要"></a><strong>三条安全边界，比提示词更重要</strong></h2><h3 id="第一条：工作区里放什么，它就可能看到什么"><a href="#第一条：工作区里放什么，它就可能看到什么" class="headerlink" title="第一条：工作区里放什么，它就可能看到什么"></a><strong>第一条：工作区里放什么，它就可能看到什么</strong></h3><p>本地启动不等于模型离线。</p><p>只要你连接的是云端模型 API，模型请求仍会发送给相应提供方，工作区中被读取并放入模型上下文的内容，也可能随请求发送。</p><p>所以不要把密码、私钥、客户数据、身份证件、私人照片或公司机密放进测试工作区。</p><h3 id="第二条：出现确认框，先看动作"><a href="#第二条：出现确认框，先看动作" class="headerlink" title="第二条：出现确认框，先看动作"></a><strong>第二条：出现确认框，先看动作</strong></h3><p>当操作在当前权限策略下需要审批时，Web UI 会先询问用户。</p><p>审批机制只是最后一道提醒，看到确认框时，要看它准备读取哪里、修改什么、执行哪条命令。</p><h3 id="第三条：重要目录先备份"><a href="#第三条：重要目录先备份" class="headerlink" title="第三条：重要目录先备份"></a><strong>第三条：重要目录先备份</strong></h3><p>以后把 Harness 用到真实项目时，至少满足一项：</p><ul><li>项目已经提交 Git；</li><li>文件有可恢复备份；</li><li>使用的是可以随时删除的副本。</li></ul><p>Agent 说“任务完成”只代表它结束了当前操作，不代表每一处修改都正确。最终还要由人检查文件和差异。</p><h2 id="模型和会话"><a href="#模型和会话" class="headerlink" title="模型和会话"></a><strong>模型和会话</strong></h2><h3 id="更换模型"><a href="#更换模型" class="headerlink" title="更换模型"></a><strong>更换模型</strong></h3><p>在“设置 → 模型”中可以配置 DeepSeek，也可以添加其他提供方或 OpenAI 兼容接口。</p><p>“提供方”就是提供模型 API 的服务商。</p><p><img src="/img/deepseek_harness/52.webp" alt="图片"></p><p>第一次上手，先把 DeepSeek 官方模型跑通，不必同时配置 Anthropic、OpenAI、Azure 或其他网关。</p><p>选择新模型后，它会成为新会话的默认模型。</p><p>已经发送过消息的旧会话会保留原来的模型记录，切换后没有变化时，新建会话再试。</p><h3 id="自定义提供方"><a href="#自定义提供方" class="headerlink" title="自定义提供方"></a><strong>自定义提供方</strong></h3><p>公司网关或自建模型可以通过“添加自定义提供方”接入。</p><p>需要填写 Provider ID、Base URL、API 协议、凭据和模型名称。</p><p>把这些词翻译一下：</p><ul><li><strong>Provider ID</strong>：这条模型线路的内部名字，要用小写，保存后不能直接改名；</li><li><strong>Base URL</strong>：模型接口地址；</li><li><strong>API 协议</strong>：Harness 应该用哪种格式和模型通信；</li><li><strong>模型名称</strong>：服务端实际提供的模型 ID。</li></ul><p>普通用户没有自建模型时，可以跳过整段。</p><h3 id="图片输入"><a href="#图片输入" class="headerlink" title="图片输入"></a><strong>图片输入</strong></h3><p>官方模型配置文档写明，DeepSeek 自身的 chat-completions 路由按纯文本处理，不能靠修改 Harness 设置把它变成图片模型。</p><p>如果上传图片时直接被拒绝，先检查当前模型是否真的声明并支持图片输入。</p><h2 id="下面是进阶区，根据能力学习"><a href="#下面是进阶区，根据能力学习" class="headerlink" title="下面是进阶区，根据能力学习"></a><strong>下面是进阶区，根据能力学习</strong></h2><p>完成 Web UI、只读任务和单文件写入测试后，你已经走通了 Harness 的基础用法。</p><p>后面的 Headless、Python SDK 和插件开发，是给自动化或开发需求准备的。</p><h3 id="Headless：不打开网页，直接跑一次任务"><a href="#Headless：不打开网页，直接跑一次任务" class="headerlink" title="Headless：不打开网页，直接跑一次任务"></a><strong>Headless：不打开网页，直接跑一次任务</strong></h3><p>Headless 可以理解成“无界面模式”。</p><p>它接收一条任务，运行一个新的持久会话，打印最终回答，然后退出。</p><p>在目标项目文件夹中运行：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh --profile headless &quot;只读分析当前项目，并概括主要目录和待办。不要修改文件。&quot;</span><br></pre></td></tr></table></figure><p>命令从哪个文件夹运行，哪个文件夹就是默认工作区，没有浏览器确认过程时，更要提前写清范围和限制。</p><h3 id="Python-SDK：把-Harness-接进自己的程序"><a href="#Python-SDK：把-Harness-接进自己的程序" class="headerlink" title="Python SDK：把 Harness 接进自己的程序"></a><strong>Python SDK：把 Harness 接进自己的程序</strong></h3><p>SDK 可以理解成给程序员使用的一套调用接口。</p><p>开发者可以在 Python 代码中启动 Harness、指定工作区、运行任务并读取结果。</p><p>当前官方快速上手文档列出的支持环境是：</p><ul><li>Linux x64；</li><li>Linux arm64；</li><li>macOS 14 及以上的 arm64。</li></ul><p>官方内置示例依赖 POSIX 终端，并明确说明不支持 Windows agent。</p><p>Windows 普通用户先使用 Web UI 或 Headless，不要照抄 Python 示例排错。</p><h3 id="插件：给-Harness-增加一个功能"><a href="#插件：给-Harness-增加一个功能" class="headerlink" title="插件：给 Harness 增加一个功能"></a><strong>插件：给 Harness 增加一个功能</strong></h3><p>先说清楚，最近 GitHub 上确实冒出了不少带 <code>dsh-plugin</code> 标签的项目，但这个标签里也混有和 Harness 无关的仓库。</p><p><strong>不要把标签数量当成“已经有多少可放心安装的插件”。</strong></p><p>下面只介绍我能核对到安装说明、重启方法和卸载命令的社区项目；它们不是 DeepSeek 官方插件，也不等于经过安全审计。</p><p><img src="/img/deepseek_harness/53.webp" alt="图片"></p><p>插件可以理解成给 Agent 安装一个小扩展：</p><blockquote><p>“</p><p>它可能多一个界面按钮、一个搜索工具，或一种新的工作方式。它不是浏览器扩展，更不是“装了就一定变聪明”的魔法包。</p></blockquote><p>这里有两个够用的词：</p><ul><li><strong>Profile</strong>：一套可以直接启动的 Harness 组合。我们前面启动的是 <code>web</code>，所以插件都要装进 <code>web</code> 这个组合；</li><li><strong>Bundle</strong>：插件作者打包好的一组插件和配置。普通用户不用自己制作它。</li></ul><h4 id="先装一个社区插件市场：把“找插件”放到界面里"><a href="#先装一个社区插件市场：把“找插件”放到界面里" class="headerlink" title="先装一个社区插件市场：把“找插件”放到界面里"></a><strong>先装一个社区插件市场：把“找插件”放到界面里</strong></h4><p>对于第一次装插件的人，我更建议先装 dsh-market。</p><p><img src="/img/deepseek_harness/54.webp" alt="图片"></p><p>它本身就是一个社区插件，装好后会在 Harness 的“设置”里增加“Plugin Market（插件市场）”入口，用来查看插件介绍、来源和安装过程。</p><p>它的优点不是“绝对安全”，而是把原本要在命令行里辨认的包名、来源和安装进度放进了界面。</p><p>市场作者也明确提醒：<strong>列表收录不等于背书，插件仍是第三方代码。</strong></p><p>按下面连续操作。</p><p>前提是你已经按本文前面的步骤成功启动过一次 <code>dsh web</code>。</p><p><strong>第 1 步：先停止正在运行的 Harness。</strong></p><p>回到运行 <code>npx @deepseek-ai/dsh web</code> 的 PowerShell 窗口，按一次 <code>Ctrl + C</code>。看到命令可以再次输入，就表示服务已停。</p><p><strong>第 2 步：仍在你的测试文件夹里，安装插件市场。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh plugin --profile web add dshmarket</span><br></pre></td></tr></table></figure><p><img src="/img/deepseek_harness/55.webp" alt="图片"></p><p>社区项目的原始文档通常把这条命令简写成 <code>dsh plugin --profile web add dshmarket</code>。</p><p>本文前面没有要求你全局安装 <code>dsh</code>，所以统一在前面加上 <code>npx @deepseek-ai/dsh</code>；后面的插件命令也沿用这个写法。</p><p>安装过程中，如果终端提示要运行某个依赖的构建脚本，不要凭感觉一路确认。</p><p>先记下包名，到插件项目的 GitHub 页面查看它为什么需要该脚本；不确定就先按 <code>Ctrl + C</code> 取消。</p><p>市场项目说明它会默认拦截这类脚本并要求显式允许，但这不是替你审计代码。</p><p><strong>第 3 步：重新启动 Harness。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh web</span><br></pre></td></tr></table></figure><p>重新在浏览器打开本地页面后，进入<strong>设置 → Plugin Market（插件市场）</strong>。如果页面没有新入口，不要只刷新网页；先确认你停掉并重新启动的是 <code>web</code> 服务。</p><p><img src="/img/deepseek_harness/56.webp" alt="图片"></p><p><strong>第 4 步：第一次只做“查看”，不要急着安装。</strong></p><p>打开某个插件的详情页，先检查四件事：</p><ol><li>它具体增加什么功能，而不是只看名字；</li><li>作者和源代码仓库是谁；</li><li>安装时是否要求额外允许构建脚本；</li><li>它会不会读取文件、调用网络、操作终端，或者要求你填写额外的 Key。</li></ol><p>尤其是远程 SSH、自动执行终端命令、云同步、上传文件和通知类插件，第一次不要装进装有真实资料的工作区。</p><p>先在本文创建的 <code>test1</code> 测试文件夹里试。</p><h4 id="从一个功能开始，不要直接装“全家桶”"><a href="#从一个功能开始，不要直接装“全家桶”" class="headerlink" title="从一个功能开始，不要直接装“全家桶”"></a><strong>从一个功能开始，不要直接装“全家桶”</strong></h4><p>有一个开源项目，提供任务看板、Git 图、皮肤等 Web UI 扩展，并且支持单独安装。</p><p><img src="/img/deepseek_harness/57.webp" alt="图片"></p><p>它同时记录了不同 pnpm 安装布局、依赖构建脚本和版本门槛带来的排障方式。</p><p>这恰好说明一个原则：<strong>功能越多，依赖越多，普通用户的排错成本也越高。</strong></p><p>所以不建议第一次就安装它的 <code>dsh-web-ui-all</code> 聚合包。</p><p>我这里做一个简单演示。</p><p><img src="/img/deepseek_harness/58.webp" alt="图片"></p><p>观察发现UI已经发生了改变，右下角也新增了一个桌宠。</p><p>后续，等你已能在插件市场里判断来源、会重启服务、会卸载后，再从单个插件项目的 README 复制对应包名安装。</p><p>不要使用它文档里的“从 GitHub 仓库安装（开发调试）”方案：那需要 <code>git</code>、<code>pnpm</code>、克隆源码和手动构建，是给插件开发和排错准备的，不是普通用户的安装路径。</p><h4 id="不想用了，怎样卸载和回退"><a href="#不想用了，怎样卸载和回退" class="headerlink" title="不想用了，怎样卸载和回退"></a><strong>不想用了，怎样卸载和回退</strong></h4><p>插件装错或不喜欢，先停掉 <code>dsh web</code>，然后用 <code>remove</code> 卸载。</p><p>比如卸载上面两个演示插件：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh plugin --profile web remove dsh-find-plugin</span><br><span class="line">npx @deepseek-ai/dsh plugin --profile web remove dshmarket</span><br></pre></td></tr></table></figure><p>之后重新启动：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh web</span><br></pre></td></tr></table></figure><p>如果卸载后界面仍有残留，不要反复安装覆盖。先重启服务；仍有问题时，可以执行下面这条命令查看 <code>web</code> 组合是否还挂着插件配置：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">npx @deepseek-ai/dsh --profile web --dump-config</span><br></pre></td></tr></table></figure><p>这份输出是排错信息，不要原样发到公开群里；配置和路径信息可能泄露你电脑的使用环境。</p><p>插件市场还提供了备份、导出日志等功能，但它的备份可能包含 Profile 配置甚至凭据形态，没看清提示前不要上传到公开网盘或群聊。</p><p>最后再强调一次：官方插件机制支持从本地、npm 和 GitHub 等来源组合插件；</p><p>从 GitHub 安装时，构建脚本可能在 Agent 沙箱之外直接运行。</p><p>只安装可信来源；真要从 GitHub 安装，最好固定到具体 commit，而不是永远追踪最新代码。</p><p>想学习自己开发插件，再从官方的插件教程开始。</p><p><img src="/img/deepseek_harness/59.webp" alt="图片"></p><h2 id="常见使用问题"><a href="#常见使用问题" class="headerlink" title="常见使用问题"></a><strong>常见使用问题</strong></h2><h3 id="提示-UNKNOWN-MODEL"><a href="#提示-UNKNOWN-MODEL" class="headerlink" title="提示 UNKNOWN_MODEL"></a><strong>提示 <code>UNKNOWN_MODEL</code></strong></h3><p>当前会话找不到对应模型，重新选择已配置的模型，或者把缺少的模型添加到自定义提供方。</p><h3 id="获取模型列表返回-401"><a href="#获取模型列表返回-401" class="headerlink" title="获取模型列表返回 401"></a><strong>获取模型列表返回 401</strong></h3><p>先检查 API Key。</p><p>自定义提供方的模型发现会调用 <code>GET /models</code>；目标服务没有提供这个接口时，需要手动填写模型。</p><h3 id="换模型后，旧会话仍在用原模型"><a href="#换模型后，旧会话仍在用原模型" class="headerlink" title="换模型后，旧会话仍在用原模型"></a><strong>换模型后，旧会话仍在用原模型</strong></h3><p>这是会话记录的设计，新建会话，再选择新模型。</p><h3 id="图片在发送前被拒绝"><a href="#图片在发送前被拒绝" class="headerlink" title="图片在发送前被拒绝"></a><strong>图片在发送前被拒绝</strong></h3><p>当前模型没有声明图片能力，DeepSeek 自身的 chat-completions 路由是纯文本，不能通过普通设置改变。</p><h3 id="Windows-上-Python-示例无法运行"><a href="#Windows-上-Python-示例无法运行" class="headerlink" title="Windows 上 Python 示例无法运行"></a><strong>Windows 上 Python 示例无法运行</strong></h3><p>当前官方示例不支持 Windows agent，改用 Web UI、Headless，或者换到官方列出的 Linux、macOS 环境。</p><p>看到这里，相信你已经可以基本上掌握 Harness 的使用了。</p><p>现在再把这些词拆开看，其实也没有那么难懂。</p><p>安装一个运行环境，准备一把 API Key，在空文件夹里打开本地页面，再明确告诉它：这一次只读，别改。</p><p>普通人真正需要学会的，不是背下多少命令。</p><p>而是在 AI 准备动手前，习惯先告诉他，工作目录是哪儿，准备读取哪些文件，要做的操作是什么，如何停止一个任务。</p><p>DeepSeek 这次开源的，不只是又一个聊天框。</p><p>它是把一个会做事的助手，放到了你电脑上，可以让更多的人体验到AI来帮你操作电脑文件的便捷。</p><p>第一轮，别急着把它塞进正在赶工的项目，也别急着装一堆插件。</p><p>先让它待在一个随时可以清空的小文件夹里，完成一件你知道正确答案的小事。</p><h2 id="最后想说的话"><a href="#最后想说的话" class="headerlink" title="最后想说的话"></a><strong>最后想说的话</strong></h2><p>Harness 或许是一个非常有趣的的系统，里面的插件也很不错。</p><p>但我认为，有个缺点：<strong>对普通用户不友好。</strong></p><p>或许，DeepSeek 团队有自己想法。</p><p>Harness 也许不是一个现在就能让所有人用得舒服的产品。</p><p>插件应该怎么组合，AI Agent 应该如何扩展，模型和工具之间又应该建立怎样的关系。</p><p>这些问题，可能还没有标准答案。</p><p><strong>因为没有答案，所以才值得有人去尝试。</strong></p><p>很多真正重要的东西，在最开始的时候，本来就不会很好用。</p><p>技术需要时间，产品需要迭代，生态更需要一群人不断试错。</p><p>如果你把 DeepSeek Harness 当成一个面向普通用户的成熟产品，它确实还有很长的路要走。</p><p>不妨把它看成 DeepSeek 对未来 AI Agent 形态的一次探索。</p><p>或许就变得有意思了。</p><p>至少，他们又往前走了一步。</p><p>就像他们的 Slogan 所说的：</p><p>探索未至之境。</p><p>希望 DeepSeek 继续保持这份探索的勇气。</p><p>也希望有一天。</p><p>我们现在觉得复杂、晦涩、难以上手的东西。</p><p>能够真正变成普通人也可以轻松使用的工具。</p><p>这条路可能还很远。</p><p>但总要有人先出发。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>CrystalDiskInfo，BatteryHealth，CPU-Z</title>
      <link>https://macin.top/posts/2037ac1/</link>
      <description>国外好多软件公司开发的工具是完全免费，而且没有广告没有弹窗，有些一维护就是十几二十年，我就好奇了，没有收益他们完全靠一腔热情维护吗？</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <pubDate>Thu, 20 Aug 2026 00:55:21 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p>国外好多软件公司开发的工具是完全免费，而且没有广告没有弹窗，有些一维护就是十几二十年，我就好奇了，没有收益他们完全靠一腔热情维护吗？</p><p>其实不是的，他们的软件有赞赏入口，外国人习惯了好用就给作者赞赏。这些赞赏其实已经足够用于维护软件的开发了。</p><p>今天推荐的这款软件也是国外的软件，免费了近20年，非常好用，有需要的小伙伴及时收藏！</p><p><strong>软件介绍</strong></p><p>今天给大家带来三款电脑硬件检测工具，一款是硬盘检测，一款是电池健康查看，一款是CPU检测工具。</p><h1 id="第一款：CrystalDiskInfo"><a href="#第一款：CrystalDiskInfo" class="headerlink" title="第一款：CrystalDiskInfo"></a>第一款：CrystalDiskInfo</h1><p>CrystalDiskInfo这款工具我第一次见它是在图吧工具箱里，它有集成硬件这个栏目里，非常好用。</p><p>软妹扒了扒这款软件的历史，发现这款软件于2008年上线，至今已经16年了，依旧免费，依旧有维护。</p><p><img src="/img/crystaldiskinfo/4.webp" alt="图片"></p><p>软件可查看HDD 机械硬盘和 SSD 固态硬盘的健康状态，可查看硬盘的固件版本、读取量、写入量、序列号、接口参数等等。</p><p>用这款软件可以查看硬盘是否为全新、是否有坏道等等，是好多搞机的小伙伴必备的工具。</p><h1 id="第二款：BatteryHealth"><a href="#第二款：BatteryHealth" class="headerlink" title="第二款：BatteryHealth"></a>第二款：BatteryHealth</h1><p>BatteryHealth是一款电脑端的电池健康查看器，软件大小仅38k，非常非常小。</p><p><img src="/img/crystaldiskinfo/5.webp" alt="图片"></p><p>可查看你电脑里的电池状态，也可查看制造商、损砂、循环次数等等。</p><p>BatteryHealth绿色、小巧，打开即可查看，非常方便！</p><h1 id="第三款：CPU-Z"><a href="#第三款：CPU-Z" class="headerlink" title="第三款：CPU-Z"></a>第三款：CPU-Z</h1><p>CPU-Z也是一款由法国人开发的完全免费的CPU检测工具，这款工具其实在图吧工具箱里也有，单独推荐的目的是提供独立版，让有单独需要的小伙伴收藏。</p><p><img src="/img/crystaldiskinfo/6.webp" alt="图片"></p><p>软件可识别处理器型号、主板制造商、型号、BIOS版本，还可以识别内存类型、容量、通道模型等等 。</p><p>另外软件还有基准跑分的功能，可测试CPU基准跑分和稳定性测试。</p><p><img src="/img/crystaldiskinfo/7.webp" alt="图片"></p><p>这款工具挺出名的，也被不少作者集成在自己的软件中，有需要的小伙伴及时收藏。</p><p>三款硬件检测工具</p><p>夸克：<a href="https://pan.quark.cn/s/06367fb56260">https://pan.quark.cn/s/06367fb56260</a></p><p>百度：<a href="https://pan.baidu.com/s/5NY96FdKzu1RAzBiFyfSp2A">https://pan.baidu.com/s/5NY96FdKzu1RAzBiFyfSp2A</a> </p><p>迅雷：<a href="https://pan.xunlei.com/s/VP-PH3ZiQfenev4guUHj4oPhA1?pwd=4rq3#">https://pan.xunlei.com/s/VP-PH3ZiQfenev4guUHj4oPhA1?pwd=4rq3#</a></p>]]>
      </content:encoded>
    </item>
    <item>
      <title>quick-search 开源的 Android 全局搜索工具，把应用、联系人、文件、日程、笔记、设置和网络搜索塞进了同一个搜索框</title>
      <link>https://macin.top/posts/5ab5ff69/</link>
      <description>最低 Android 7.0，目标版本 Android 15。三个渠道：Google Play 自动更新，F-Droid 仓库更新，GitHub Releases 下 APK。想自己编译的话，标准版带 Play 服务用 ./gradlew assembleStandardRelease，纯净版用 …</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90/">开源</category>
      <category domain="https://macin.top/tags/Android/">Android</category>
      <pubDate>Wed, 19 Aug 2026 09:09:54 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="quick-search"><a href="#quick-search" class="headerlink" title="quick-search"></a>quick-search</h1><blockquote><p>一款 Android 全局搜索工具，把应用、联系人、文件、日程、笔记、设置和网络搜索塞进了同一个搜索框。</p></blockquote><p>Github地址</p><p><a href="https://github.com/teja2495/quick-search">https://github.com/teja2495/quick-search</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><p>搜应用支持模糊匹配和缩写，长按能调出应用快捷方式。联系人搜索整合了 WhatsApp、Telegram、Signal 这些第三方通话入口，一个联系人存了多个号码也能分别处理。文件搜索覆盖图片、视频、文档，系统设置和应用内的设置项也能直接搜到。</p><p>工具层面内置了计算器、单位换算、货币汇率、世界时钟，日期时间支持自然语言解析，比如输”3天后是几号”这种。AI 搜索接入了 Gemini、OpenAI、Claude、Groq 多家 API，可以选模型，也能塞个人上下文做个性化回答。自定义 AI 工具需要自备 API key。</p><p>搜索引擎预设了 25 个，Google、YouTube、DuckDuckGo、Perplexity 这些都在，支持自定义快捷键触发，比如打 <code>ggl</code> 空格走 Google 搜索。浏览器也能加进搜索引擎列表。</p><p>界面可以调主题、字体大小、搜索框位置，支持 Material You 取色，能换背景图加模糊。有悬浮窗模式，在其他应用上层呼出搜索。桌面小部件和快捷设置磁贴都给了，还能设成默认启动器。触发词功能挺实用，给常用结果绑个关键词，输完按空格直接跳。</p><p>数据存在本地，权限按需申请，API key 加密存。没广告，没埋点。</p><h2 id="怎么装"><a href="#怎么装" class="headerlink" title="怎么装"></a>怎么装</h2><p>最低 Android 7.0，目标版本 Android 15。三个渠道：Google Play 自动更新，F-Droid 仓库更新，GitHub Releases 下 APK。想自己编译的话，标准版带 Play 服务用 <code>./gradlew assembleStandardRelease</code>，纯净版用 <code>./gradlew assembleFdroidRelease</code>。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>insect-world 一个在浏览器里运行的3D昆虫图鉴，每只虫都是浏览器实时生成的代码模型，能转能看能解剖，还能做题测验</title>
      <link>https://macin.top/posts/688e7c39/</link>
      <description>本地跑：npm install 后 npm run dev，主站开5178端口，带一个 /preview.html 的模型调试台。npm test 跑4000多个测试，npm run build 做类型检查加vite构建，npm run deploy 发布到Cloudflare Pages（要先 npx …</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/Web/">Web</category>
      <category domain="https://macin.top/tags/%E6%B5%8F%E8%A7%88%E5%99%A8/">浏览器</category>
      <category domain="https://macin.top/tags/%E6%A8%A1%E5%9E%8B/">模型</category>
      <pubDate>Wed, 19 Aug 2026 09:07:23 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="insect-world"><a href="#insect-world" class="headerlink" title="insect-world"></a>insect-world</h1><blockquote><p>一个在浏览器里运行的3D昆虫图鉴，名字叫”昆虫世界”。作者用代码直接生成昆虫模型，仓库里一个模型文件都没有，全是TypeScript现算出来的几何体。</p></blockquote><p>Github地址</p><p><a href="https://github.com/xr843/insect-world">https://github.com/xr843/insect-world</a></p><p>在线体验</p><p><a href="https://insect-world.pages.dev/">https://insect-world.pages.dev/</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><p>3种昆虫、14个目，每只虫都是浏览器实时生成的代码模型，能转能看能解剖，还能做题测验。</p><p>核心看点是”零资产”建模。不用买模型、不用扫标本，靠参数化代码描述昆虫的身体结构——头胸腹三段、三对足、两对翅、分节的附肢，这些规律性的东西写成可调参数，加一个新物种就添一份描述文件。三角面数从一万三到三万六不等，构建时间30到90毫秒，首屏JS压缩后约424KB，物种代码点到谁下谁。</p><p>交互方面。左侧图鉴列表点选或上下键翻页，中间3D展台拖转滚轮缩放，彩色圆点是部位标注，点开会讲这是啥结构。工具条四个按钮都有真响应：聚焦把镜头怼到具体部位，剖切是真实的裁剪平面切开模型，分层让外骨骼变半透明，对比能在底部浮出对照条。右侧详解带分步讲解，每步镜头自动移到讲的位置；小测能答题、判对错、给解释、算得分。</p><p>两套主题切换。默认”标本台”是冷灰绿档案衬板配青铜铭牌，切”博物馆之夜”变成展厅黑底、黄铜骨架、聚光灯打亮标本，金属鞘翅和薄膜虹彩在暗底上比较出效果。</p><p>数据层有中英双语，但英文是AI翻译的未校订版，学名拉丁二名法是两边唯一可靠的对应锚点。图鉴文案也是AI写的，作者明确说不能当学术引用。</p><h2 id="部署使用"><a href="#部署使用" class="headerlink" title="部署使用"></a>部署使用</h2><p>本地跑：<code>npm install</code> 后 <code>npm run dev</code>，主站开5178端口，带一个 <code>/preview.html</code> 的模型调试台。<code>npm test</code> 跑4000多个测试，<code>npm run build</code> 做类型检查加vite构建，<code>npm run deploy</code> 发布到Cloudflare Pages（要先 <code>npx wrangler login</code>）。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>VoxWeave 在 Windows 本机运行的 RVC 变声工具，装完就能在电脑上把声音换成别的音色，支持录好的文件和实时说话两种场景</title>
      <link>https://macin.top/posts/e20eb526/</link>
      <description>一款在 Windows 本机运行的 RVC 变声工具，不用联网就能处理音频和实时麦克风变声。装完就能在电脑上把声音换成别的音色，支持录好的文件和实时说话两种场景。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/Windows/">Windows</category>
      <pubDate>Wed, 19 Aug 2026 09:05:41 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="VoxWeave"><a href="#VoxWeave" class="headerlink" title="VoxWeave"></a>VoxWeave</h1><blockquote><p>一款在 Windows 本机运行的 RVC 变声工具，不用联网就能处理音频和实时麦克风变声。装完就能在电脑上把声音换成别的音色，支持录好的文件和实时说话两种场景。</p></blockquote><p>Github地址</p><p><a href="https://github.com/CheshireMew/VoxWeave">https://github.com/CheshireMew/VoxWeave</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>转语音、歌曲、视频：输出不覆盖原文件，视频会多一条变声音轨</li><li>实时麦克风变声：选好播放设备，说话直接变声输出，有三档延迟可选</li><li>批量处理：扔进去整个文件夹，自动排队，重复内容会跳过</li><li>接脚本或别的工具：本机开了 HTTP&#x2F;WebSocket 接口，返回标准 JSON</li></ul><h2 id="快速开始"><a href="#快速开始" class="headerlink" title="快速开始"></a>快速开始</h2><h3 id="1-使用-EXE"><a href="#1-使用-EXE" class="headerlink" title="1. 使用 EXE"></a>1. 使用 EXE</h3><p>双击 <code>VoxWeave.exe</code> 后，程序会先发现现有 VoxWeave 数据、RVC 环境及 FFmpeg。找到已有环境就直接复用；否则自动选择空间充足的非系统盘创建 <code>VoxWeave</code> 数据目录。只有找不到合适磁盘时才要求手动选择。EXE 所在目录保存数据目录指针和运行组件检查结果；可能很大的运行组件、模型、缓存、日志和任务产物保存在数据目录。NVIDIA 完整首次安装要求至少 12 GiB 可用空间。</p><p>程序会自动检查检测到的运行环境。完整环境可直接使用；只缺 FFmpeg 时，“补全缺失组件”只补 FFmpeg；现有 RVC 自检不通过时，程序会弹窗说明安装内容、保存位置和空间要求，用户确认后才下载锁定版本的 Python 3.12、RVC 和 FFmpeg。模型库为空时，程序会自动扫描现有 RVC 的 <code>assets\weights</code> 和索引目录；仍然没有模型时，会弹窗询问是否下载“青年男声 + 学姐女声”两款入门音色。取消确认不会产生下载任务，其余中文音色仍可在模型库按需选择。</p><h3 id="2-从源码运行"><a href="#2-从源码运行" class="headerlink" title="2. 从源码运行"></a>2. 从源码运行</h3><p>源码开发需要 Python 3.12 和 Git。运行数据必须放在源码目录之外；Python 环境、pip 缓存、临时文件、数据库、日志、下载和任务产物都会进入这个数据目录。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/CheshireMew/VoxWeave.gitcd VoxWeave.\scripts\bootstrap.ps1 -DataRoot D:\Tools\VoxWeave</span><br></pre></td></tr></table></figure><p>如果你已经有锁定兼容版本的 RVC 环境，可以在首次配置时一并声明：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">.\scripts\bootstrap.ps1 `</span><br><span class="line">  -DataRoot D:\Tools\VoxWeave `</span><br><span class="line">  -RvcRoot E:\path\to\Retrieval-based-Voice-Conversion-WebUI `</span><br><span class="line">  -RvcPython E:\path\to\Retrieval-based-Voice-Conversion-WebUI\.venv\Scripts\python.exe `</span><br><span class="line">  -Ffmpeg D:\path\to\ffmpeg.exe `</span><br><span class="line">  -Ffprobe D:\path\to\ffprobe.exe</span><br></pre></td></tr></table></figure><p><code>requirements.lock</code> 是 Windows&#x2F;Python 3.12 的已验收依赖集合，首次配置和 CI 使用同一约束文件。源码目录只保留一个被 Git 忽略的 <code>.voxweave.local.json</code> 数据目录指针。</p><h3 id="3-启动源码桌面端"><a href="#3-启动源码桌面端" class="headerlink" title="3. 启动源码桌面端"></a>3. 启动源码桌面端</h3><p>直接双击仓库根目录的 <code>VoxWeave.vbs</code>，即可无控制台窗口启动。需要查看启动错误时，在 PowerShell 中运行：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">.\scripts\run.ps1</span><br></pre></td></tr></table></figure><p><code>VoxWeave.bat</code> 只负责把旧快捷方式转交给 <code>VoxWeave.vbs</code>，随后立即退出。源码更新后，先用 <code>.\scripts\voxweave.ps1 service stop</code> 正常关闭旧服务，再重新启动桌面端。</p><h3 id="4-没有-RVC-环境时安装运行组件"><a href="#4-没有-RVC-环境时安装运行组件" class="headerlink" title="4. 没有 RVC 环境时安装运行组件"></a>4. 没有 RVC 环境时安装运行组件</h3><p>先启动桌面端，让本机服务可用；然后在新的 PowerShell 窗口提交安装任务：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">.\scripts\voxweave.ps1 --json execute runtime.install --arguments &#x27;&#123;&#125;&#x27;</span><br></pre></td></tr></table></figure><p>安装任务把锁定的 Python、RVC 源码、FFmpeg 和必需推理资源放入数据目录，只安装 VoxWeave 实际使用的推理、实时音频、模型检查和语音分析依赖，不安装 RVC 网页界面、训练面板、Gradio 或 TensorBoard。默认不会下载许可证无法确认的人声分离权重；WeSpeaker ONNX 权重按 CC-BY-4.0 安装。完整边界见 第三方说明。</p><h3 id="5-完成第一次转换"><a href="#5-完成第一次转换" class="headerlink" title="5. 完成第一次转换"></a>5. 完成第一次转换</h3><ol><li>在“模型库”下载推荐模型、扫描本机目录，或添加你有权使用的 <code>.pth</code> 和可选 <code>.index</code>。</li><li>打开“转换工作台”，选择输入文件、输出位置和目标模型。</li><li>先生成试听，确认音高、F0、索引率等参数，再开始完整转换。</li><li>在“任务中心”查看进度；完成后可播放或打开最终产物。</li></ol><p>VoxWeave 默认不覆盖已有输出。提交任务时会固化输入文件、模型和索引身份，执行前后再次验证；结果清单记录最终文件及 SHA-256，避免重试时悄悄换用已经变化的素材或模型。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>Handwriting-sim-rs 手写效果模拟器，选字体、信纸背景，软件会自动排版，然后给每个字的笔画加上随机偏移、旋转这些扰动，让最终效果自然且不会重复</title>
      <link>https://macin.top/posts/4ff93e/</link>
      <description>手写效果模拟器，选字体、信纸背景，软件会自动排版，然后给每个字的笔画加上随机偏移、旋转这些扰动，让最终效果自然且不会重复</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E6%A8%A1%E6%8B%9F%E5%99%A8/">模拟器</category>
      <category domain="https://macin.top/tags/%E5%AD%97%E4%BD%93/">字体</category>
      <pubDate>Wed, 19 Aug 2026 09:03:36 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="Handwriting-sim-rs"><a href="#Handwriting-sim-rs" class="headerlink" title="Handwriting-sim-rs"></a>Handwriting-sim-rs</h1><blockquote><p>是用 Rust 重写的”手写模拟器”。以前有个 Python 版本，这个新版本在性能上提升很明显，核心渲染速度能快 10 到 30 倍。界面用的是 Slint 框架，没有独立显卡的老机器也能跑，Windows、macOS、Linux 三个平台都支持。</p></blockquote><p>Github地址</p><p><a href="https://github.com/bamboostrip/Handwriting-sim-rs">https://github.com/bamboostrip/Handwriting-sim-rs</a></p><h2 id="主要功能"><a href="#主要功能" class="headerlink" title="主要功能"></a>主要功能</h2><ul><li>文本输入支持多段落、空行，回车分段，基本的排版操作都有</li><li>段落可以左对齐、居中、右对齐，或者首行缩进两字符</li><li>能导入 docx 文件，自动识别原文的对齐方式和缩进设置</li><li>字体支持 ttf、ttc、otf 格式；背景图支持 png、jpg、webp、bmp</li><li>字间距、行距、字号都能调，而且每个参数都能单独加随机波动</li><li>笔画扰动分三种：水平偏移、垂直偏移、旋转角度，强度自己控制</li><li>页面边距上下左右独立可调</li><li>预览时可以开边界提示线，看清实际渲染范围</li><li>错字模拟：设置 0 到 30% 的错字率，写错的字会被单线、双线、斜线或叉号划掉，然后在旁边重写</li><li>停止输入 300 毫秒后自动刷新预览，不卡界面</li><li>多页自动分页，支持翻页浏览</li><li>预设系统可以保存整套参数，也兼容旧版 Python 版本的预设格式</li><li>导出支持 PNG 序列或 300 DPI 的位图 PDF</li></ul><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><p>本地跑的话，装好 Rust 工具链后直接：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">cargo run           # 启动图形界面</span><br><span class="line">cargo test          # 跑测试</span><br><span class="line">cargo build --release   # 编译优化后的版本</span><br></pre></td></tr></table></figure><p>编译出来的可执行文件是便携的，往哪放都行，只要同目录下有 presets、backgrounds、fonts 这几个文件夹就能正常工作。项目也配了 GitHub Actions，推 v 开头的标签会自动在三个平台打包发布。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>barehands 开源的手势控制界面，用摄像头捕捉手部动作，让你直接用手操作屏幕上的内容。不需要头盔、手柄或手套</title>
      <link>https://macin.top/posts/ef3ccb08/</link>
      <description>一个靠普通摄像头实现手势追踪的界面系统，能把笔记、图片、3D模型变成浮在空中的玻璃卡片，用手捏、扔、拉、放大缩小来操控，还能接AI当大脑。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90/">开源</category>
      <pubDate>Wed, 19 Aug 2026 09:00:42 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="barehands"><a href="#barehands" class="headerlink" title="barehands"></a>barehands</h1><blockquote><p> 一个靠普通摄像头实现手势追踪的界面系统，能把笔记、图片、3D模型变成浮在空中的玻璃卡片，用手捏、扔、拉、放大缩小来操控，还能接AI当大脑。</p></blockquote><p>Github地址</p><p><a href="https://github.com/jaredrhod/barehands">https://github.com/jaredrhod/barehands</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>摄像头捕捉手部动作，实时追踪手指位置</li><li>屏幕上的内容以透明卡片形式悬浮，像贴在你视频画面上</li><li>捏住拖拽移动卡片，双手张开合拢缩放，甩手扔出去</li><li>特定手势：拍手清屏、”爪子”隔空抓物（手张开→握拳，东西飞过来）、两指横拖把3D模型拆成爆炸图</li><li>接AI后，屏幕上的圆环会显示AI状态（思考&#x2F;空闲&#x2F;说话），AI也能主动往屏幕上投内容</li><li>支持Obsidian笔记库直接导入，图片、3D模型分文件夹管理</li><li>有透明渲染模式，能套进OBS直播，拍短视频或开直播都能用</li></ul><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/jaredrhod/barehandscd barehands</span><br><span class="line">python3 server.py</span><br></pre></td></tr></table></figure><p>然后浏览器开 <code>127.0.0.1:8794/stage.html</code>，允许摄像头权限，挥手就行。Windows 用 <code>python</code> 不是 <code>python3</code>。依赖全是现成的东西：Python标准库、Google MediaPipe（手部识别）、three.js（3D渲染），首次运行自动从CDN拉。</p><p>已经在用Claude Code的，直接丢一句：”clone这个项目，读barehands.md，给我配好”，AI自己会搞定配置和接线。</p><p>配置在 <code>barehands.json</code> 里改，加笔记库路径、媒体文件夹，一行一个轨道球。AI那边写文件到 <code>state/</code> 目录就能控制圆环表情，调用 <code>bin/board.sh</code> 就能往屏幕上发内容。有详细排查手册调手势灵敏度，怕误触可以自己改阈值</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>NAS 传文件慢？一个工具测出真实速度 MySpeed</title>
      <link>https://macin.top/posts/dc564459/</link>
      <description>一款免费网络测速工具，可检测当前网页设备访问 NAS 之间的传输速度，支持上传、下载、网络抖动及延迟等多项指标数据。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <pubDate>Wed, 19 Aug 2026 08:53:15 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p>MySpeed：</p><p>一款免费网络测速工具，可检测当前网页设备访问 NAS 之间的传输速度，支持上传、下载、网络抖动及延迟等多项指标数据。</p><p><img src="/img/MySpeed/1.webp" alt="图片"></p><p>项目开源地址：</p><p><a href="https://github.com/ljw98/MySpeed">https://github.com/ljw98/MySpeed</a></p><h3 id="安装"><a href="#安装" class="headerlink" title="安装"></a>安装</h3><figure class="highlight yaml"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br></pre></td><td class="code"><pre><span class="line"><span class="attr">services:</span></span><br><span class="line">  <span class="attr">myspeed:</span></span><br><span class="line">    <span class="attr">image:</span> <span class="string">ghcr.io/ljw98/myspeed:latest</span></span><br><span class="line">    <span class="attr">container_name:</span> <span class="string">myspeed</span></span><br><span class="line">    <span class="attr">ports:</span></span><br><span class="line">      <span class="bullet">-</span> <span class="number">8080</span><span class="string">:8080</span></span><br><span class="line">    <span class="attr">restart:</span> <span class="string">always</span></span><br></pre></td></tr></table></figure><h3 id="使用"><a href="#使用" class="headerlink" title="使用"></a>使用</h3><p>浏览器中输入 <code>http://NAS的IP:8080</code> 就能看到界面</p><p><img src="/img/MySpeed/2.webp" alt="图片"></p><p>相比旧版本，最新版本整体更加简洁克制了</p><p><img src="/img/MySpeed/3.webp" alt="图片"></p><p>使用很简单，点击“开始测试”就可以测速</p><p><img src="/img/MySpeed/4.webp" alt="图片"></p><p>水面上升动画指示测试进度，外部圆环实时显示当前速度</p><p><img src="/img/MySpeed/5.webp" alt="图片"></p><p>支持网络抖动、延迟、上传和下载等数据</p><p><img src="/img/MySpeed/6.webp" alt="图片"></p><p>自动识别（百兆&#x2F;千兆&#x2F;2.5G&#x2F;万兆&#x2F;25G），直观展示当前网络接口速率</p><p><img src="/img/MySpeed/7.webp" alt="图片"></p><p>响应式布局，手机端打开也能正常使用</p><p><img src="/img/MySpeed/8.webp" alt="图片"></p><h3 id="总结"><a href="#总结" class="headerlink" title="总结"></a>总结</h3><p>MySpeed 是一款基于 LibreSpeed 重构的自建测速工具，重写了底层代码并优化了前端界面。部署很简单，打开网页点一下就能测出上传、下载、延迟和抖动，还能自动识别百兆到 25G 的网口速率。对 NAS 玩家来说，网速测试工具属于必装应用，既可以测试内网传输速度，也能检测外网访问速率。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>进程守护，我找到你了，进程管理Procexp</title>
      <link>https://macin.top/posts/efc64d8c/</link>
      <description>今天总共给大家推荐三款Windows小工具，一款进程守护工具，一款是获取弹窗信息软件，一款是进程管理工具。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <pubDate>Wed, 19 Aug 2026 06:22:09 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p><strong>软件介绍</strong></p><p>今天总共给大家推荐三款Windows小工具，一款进程守护工具，一款是获取弹窗信息软件，一款是进程管理工具。</p><h1 id="第一款：进程守护"><a href="#第一款：进程守护" class="headerlink" title="第一款：进程守护"></a>第一款：进程守护</h1><p>这款软件叫“守护服务”，但我更喜欢叫它“进程守护”，因为它可以添加想要守护的进程，即使进程崩溃了，还可以自动的启动。</p><p>软件的界面长得下面这样：</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/1.webp" alt="图片"></p><p>使用很简单，点击【新增】，然后填写“服务名称”和“服务路径”，这里的“服务名称”就是进程的名称，“服务路径”就是软件的安装路径。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/2.webp" alt="图片"></p><p>填写好后点【确定】即可。看看我把阿里网盘的进程结束掉，然后过了一会，阿里网盘又自动的启动了！</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/1.gif" alt="图片"></p><p>这软件的用途可以守护指定的进程，防止程序长久中断！</p><h1 id="第二款：我找到你了"><a href="#第二款：我找到你了" class="headerlink" title="第二款：我找到你了"></a>第二款：我找到你了</h1><p>“我找到你了”可以获取窗口弹窗信息的软件，这款软件是前些天有小伙伴说他的电脑广告经常弹出，不知道是哪款软件导致的弹窗。</p><p><strong>点击下面，支持软妹：</strong></p><p>这时候用“我找到你了”这款工具，就可以锁定弹窗的原凶，找出到底是哪款软件导致的弹窗。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/3.webp" alt="图片"></p><p>软件使用很简单，打开软件后，鼠标移动到哪款应用程序上，软件就会显示该应用程序所在的路径。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/2.gif" alt="图片"></p><p>看看我移动到了资源管理器中，其运行路径就在软件中显示C盘所在的路径。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/4.webp" alt="图片"></p><p>找到路径后按F9就是暂停，按F10就可以打开应用程序的路径。还可以点【关闭进程】结束进程。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/5.webp" alt="图片"></p><p>对于弹窗软件来说，找到了路径就能知道是哪款软件导致的弹窗，找到元凶就能知道怎么处理。</p><h1 id="第三款：进程管理Procexp"><a href="#第三款：进程管理Procexp" class="headerlink" title="第三款：进程管理Procexp"></a>第三款：进程管理Procexp</h1><p>Procexp是一款进程管理软件，软件是绿色单文件版，大小只有940K，非常小巧。</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/6.webp" alt="图片"></p><p>相比系统自带的任务管理器来说，Procexp功能会更加强大，其不仅有结束进程和进程树，还可以置顶窗口，重启、挂起、属性和在线搜索功能</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/7.webp" alt="图片"></p><p>虽然这类的工具不一定是人人都喜欢，但是有用得着的小伙伴还是会觉得不错！</p><p><img src="/img/%E8%BF%9B%E7%A8%8B%E5%AE%88%E6%8A%A4/8.webp" alt="图片"></p><p>三款小工具：</p><p>百度：<a href="https://pan.baidu.com/s/1o8aFIZfLkSmWxxLsRvMwUg?pwd=8888">https://pan.baidu.com/s/1o8aFIZfLkSmWxxLsRvMwUg?pwd=8888</a> 提取码：8888</p><p>夸克：<a href="https://pan.quark.cn/s/a87dd0130405">https://pan.quark.cn/s/a87dd0130405</a></p><p>阿里：<a href="https://www.alipan.com/s/eFb4yDWP3Xk">https://www.alipan.com/s/eFb4yDWP3Xk</a></p>]]>
      </content:encoded>
    </item>
    <item>
      <title>淮教鞭，ClipHist</title>
      <link>https://macin.top/posts/6c1e917f/</link>
      <description>在推荐这款软件之前，我一直疑惑到底是“剪贴板”还是“剪切板”，然后问了问AI，AI告诉我是“剪贴板”，其实操作时是有个剪切的功能，然后很容易让我们以为是剪切板。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <pubDate>Wed, 19 Aug 2026 06:16:18 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p><strong>软件介绍</strong></p><p>今天推荐两款软件，一款电子教鞭工具，一款是剪贴板工具。</p><h1 id="第一款：淮教鞭"><a href="#第一款：淮教鞭" class="headerlink" title="第一款：淮教鞭"></a>第一款：淮教鞭</h1><p>淮教鞭是一款电子教鞭工具，这款软件适合上网课的老师，可以在讲解的时候演示，还可以标注，把屏幕当黑板使用。</p><p>软件非常小，解压后也才804 KB，软件的功能包括画笔、框选、文字、图片、图形等等。</p><p><img src="/img/%E6%B7%AE%E6%95%99%E9%9E%AD/4.webp" alt="图片"></p><p>在讲课期间，可随时的标注，这样课程讲解时比较容易让学生看懂。</p><p><img src="/img/%E6%B7%AE%E6%95%99%E9%9E%AD/1.gif" alt="图片"></p><p>这款软件非常小巧，而且功能一点也不比其他同类的差。上次有小伙伴说我推荐的电子教鞭只有一款，而这款他不喜欢，所以这次再给大家带来一款。</p><h1 id="第二款：ClipHist"><a href="#第二款：ClipHist" class="headerlink" title="第二款：ClipHist"></a>第二款：ClipHist</h1><p>在推荐这款软件之前，我一直疑惑到底是“剪贴板”还是“剪切板”，然后问了问AI，AI告诉我是“剪贴板”，其实操作时是有个剪切的功能，然后很容易让我们以为是剪切板。</p><p>言归正传，ClipHist这款剪贴板历史工具可以记录你复制过的内容，比系统的只支持25个记录下比，这款可以查找你历史所有数据。</p><p><img src="/img/%E6%B7%AE%E6%95%99%E9%9E%AD/1.webp" alt="图片"></p><p>打开软件以后，我们按“Alt+C”可以调到软件的面板，然后我们就可以看到历史的复制记录。</p><p>支持记录文本、图片、链接等等，支持搜索，输入关键词可查找出所有包括关键词的记录。</p><p><img src="/img/%E6%B7%AE%E6%95%99%E9%9E%AD/2.webp" alt="图片"></p><p>软件还支持收藏，收藏后在收藏项里可以查看.</p><p><img src="/img/%E6%B7%AE%E6%95%99%E9%9E%AD/3.webp" alt="图片"></p><p>软件功能挺多的，比系统自带的要强上好几倍，有需要的小伙伴及时收藏！</p><p>电子教鞭和剪贴板工具</p><p>夸克：<a href="https://pan.quark.cn/s/76f2d5228c03">https://pan.quark.cn/s/76f2d5228c03</a></p><p>百度：<a href="https://pan.baidu.com/s/14BHV6q3Q2v7rApAGmq-wnQ?pwd=8888">https://pan.baidu.com/s/14BHV6q3Q2v7rApAGmq-wnQ?pwd=8888</a> 提取码: 8888</p><p>迅雷：<a href="https://pan.xunlei.com/s/VOl9yAjqLa6uXuKsJrlbWMCGA1?pwd=dgu4#">https://pan.xunlei.com/s/VOl9yAjqLa6uXuKsJrlbWMCGA1?pwd=dgu4#</a></p>]]>
      </content:encoded>
    </item>
    <item>
      <title>MiniMax Music 3 开源模型本地部署教程与实测</title>
      <link>https://macin.top/posts/1babd79/</link>
      <description>MiniMax 推出最新开源音乐生成模型 MiniMax Music 3。该模型支持通过单句歌词或文本描述，直接生成最长 5 分钟的完整歌曲，涵盖人声演唱、旋律编曲以及乐器伴奏。本次开源开放了完整的模型权重，支持通过 ComfyUI 进行本地部署。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/ai/">ai</category>
      <category domain="https://macin.top/categories/ai/minimax/">minimax</category>
      <category domain="https://macin.top/tags/%E6%95%99%E7%A8%8B/">教程</category>
      <category domain="https://macin.top/tags/%E6%A8%A1%E5%9E%8B/">模型</category>
      <category domain="https://macin.top/tags/AI/">AI</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B/">开源模型</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90/">开源</category>
      <category domain="https://macin.top/tags/minimax/">minimax</category>
      <category domain="https://macin.top/tags/AI%E9%9F%B3%E4%B9%90/">AI音乐</category>
      <category domain="https://macin.top/tags/%E9%9F%B3%E4%B9%90%E7%94%9F%E6%88%90/">音乐生成</category>
      <pubDate>Wed, 19 Aug 2026 05:59:10 GMT</pubDate>
      <content:encoded>
        <![CDATA[<p>MiniMax 推出最新开源音乐生成模型 <strong>MiniMax Music 3</strong>。该模型支持通过单句歌词或文本描述，直接生成最长 5 分钟的完整歌曲，涵盖人声演唱、旋律编曲以及乐器伴奏。本次开源开放了完整的模型权重，支持通过 ComfyUI 进行本地部署。</p><hr><h2 id="核心特性"><a href="#核心特性" class="headerlink" title="核心特性"></a>核心特性</h2><ul><li><strong>完整歌曲生成</strong>：单次推理即可直接生成长达 5 分钟的成品歌曲。</li><li><strong>全流程覆盖</strong>：自动合成人声（主唱&#x2F;和声）、乐器伴奏及编曲架构。</li><li><strong>开源权重部署</strong>：提供完整精度与低显存量化版本，适配不同硬件环境。</li><li><strong>高效推理性能</strong>：在 24GB 显存环境下，生成 60 秒音频约需 20 秒，生成 4<del>5 分钟完整歌曲约需 1</del>2 分钟。</li></ul><hr><h2 id="本地部署指南"><a href="#本地部署指南" class="headerlink" title="本地部署指南"></a>本地部署指南</h2><h3 id="1-环境准备-ComfyUI"><a href="#1-环境准备-ComfyUI" class="headerlink" title="1. 环境准备 (ComfyUI)"></a>1. 环境准备 (ComfyUI)</h3><p>确保已安装最新版本的 ComfyUI。若已安装旧版本，请先完成软件升级，以保证对 MiniMax Music 3 模型节点的正常识别与兼容。</p><ul><li>官方下载:【<a href="https://comfy.org/">点击前往</a>】</li></ul><hr><h3 id="2-模型下载与文件存放结构"><a href="#2-模型下载与文件存放结构" class="headerlink" title="2. 模型下载与文件存放结构"></a>2. 模型下载与文件存放结构</h3><p>MiniMax Music 3 运行需要 4 个核心模型文件（包含 Diffusion 模型、文本编码器与 VAE 自编码器）。请将下载好的文件放置于对应的 ComfyUI 目录中：</p><p>Plaintext</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br></pre></td><td class="code"><pre><span class="line">ComfyUI/</span><br><span class="line">└── models/</span><br><span class="line">    ├── diffusion_models/</span><br><span class="line">    │   ├── minimax_music3_dit_fp16.safetensors                 # 满血版（全精度）</span><br><span class="line">    │   └── minimax_music3_dit_int8_convrot.safetensors         # 低显存推荐（量化版）</span><br><span class="line">    ├── text_encoders/</span><br><span class="line">    │   └── minimax_music3_text_encoder_pruned_int8_convrot.safetensors</span><br><span class="line">    └── vae/</span><br><span class="line">        └── minimax_music3_dav.safetensors</span><br></pre></td></tr></table></figure><h4 id="模型下载链接："><a href="#模型下载链接：" class="headerlink" title="模型下载链接："></a>模型下载链接：</h4><p>1、diffusion_models </p><p>minimax_music3_dit_fp16.safetensors （全精度 满血版）</p><p>【<a href="https://huggingface.co/Comfy-Org/MiniMax-Music-3/resolve/main/diffusion_models/minimax_music3_dit_fp16.safetensors">点击前往</a>】或 【<a href="https://pan.quark.cn/s/d4b4f572b306">网盘下载</a>】、 【<a href="https://git.cloudeop.com/repo.php?id=726d8169">备用下载</a>】</p><p>minimax_music3_dit_int8_convrot.safetensors （低显存用户选择）</p><p>【<a href="https://huggingface.co/Comfy-Org/MiniMax-Music-3/resolve/main/diffusion_models/minimax_music3_dit_int8_convrot.safetensors">点击前往</a>】或 【<a href="https://pan.quark.cn/s/d4b4f572b306">网盘下载</a>】、 【<a href="https://git.cloudeop.com/repo.php?id=726d8169">备用下载</a>】</p><p>2、text_encoders </p><p>minimax_music3_text_encoder_pruned_int8_convrot.safetensors</p><p>【<a href="https://huggingface.co/Comfy-Org/MiniMax-Music-3/resolve/main/text_encoders/minimax_music3_text_encoder_pruned_int8_convrot.safetensors">点击前往</a>】或 【<a href="https://pan.quark.cn/s/28ac5d7b75de">网盘下载</a>】、 【<a href="https://git.cloudeop.com/repo.php?id=726d8169">备用下载</a>】</p><p>3、vae 编码器</p><p>minimax_music3_dav.safetensors</p><p>深入探索订阅高效网页应用与在线工具获取博客建站与内容托管服务申请知识产权与专利保护</p><p>【<a href="https://huggingface.co/Comfy-Org/MiniMax-Music-3/resolve/main/vae/minimax_music3_dav.safetensors">点击前往</a>】或 【<a href="https://pan.quark.cn/s/0e238994b17f">网盘下载</a>】、 【<a href="https://git.cloudeop.com/repo.php?id=726d8169">备用下载</a>】</p><hr><h3 id="3-工作流导入与使用"><a href="#3-工作流导入与使用" class="headerlink" title="3. 工作流导入与使用"></a>3. 工作流导入与使用</h3><p>下载对应的 ComfyUI 工作流 JSON 文件，直接将其拖入 ComfyUI 画布界面即可加载。</p><p>工作流下载：</p><p>1、国外网盘：【<a href="https://pan.cloudeop.com/s/39565917A4147380">点击下载</a>】</p><p>2、国内网盘：【<a href="https://pan.quark.cn/s/d343f31b371c">点击下载</a>】</p><hr><h2 id="提示词与歌词配置示例"><a href="#提示词与歌词配置示例" class="headerlink" title="提示词与歌词配置示例"></a>提示词与歌词配置示例</h2><p>在工作流的文本输入节点中，填入 <strong>Style Prompt（曲风与编曲描述）</strong> 以及 <strong>Lyrics（歌词与段落标记）</strong>：</p><h3 id="示例-1：流行舞曲风格（Upbeat-Dance-Pop）"><a href="#示例-1：流行舞曲风格（Upbeat-Dance-Pop）" class="headerlink" title="示例 1：流行舞曲风格（Upbeat Dance-Pop）"></a>示例 1：流行舞曲风格（Upbeat Dance-Pop）</h3><p><strong>Style Prompt:</strong></p><blockquote><p>Upbeat modern Chinese Mandopop dance-pop, around 108 BPM, extremely catchy and addictive, bright and energetic but slightly nostalgic. A youthful, warm male lead vocal with a clean intimate tone. Punchy modern pop drum groove, deep rounded bass, bright synth plucks, warm electric piano, and rhythmic claps.</p></blockquote><p><strong>Lyrics:</strong></p><p>Plaintext</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br><span class="line">20</span><br><span class="line">21</span><br></pre></td><td class="code"><pre><span class="line">[Intro]</span><br><span class="line">今晚的风 吹过你的脸</span><br><span class="line">灯亮了一点 心跳快一点</span><br><span class="line"></span><br><span class="line">[Verse 1]</span><br><span class="line">城市的霓虹还没睡</span><br><span class="line">我们沿着街一直追</span><br><span class="line">你说今天不想回</span><br><span class="line">我说那就再走一回</span><br><span class="line"></span><br><span class="line">[Pre Chorus]</span><br><span class="line">别问明天会怎样</span><br><span class="line">别管时间有多忙</span><br><span class="line">这一刻就在身旁</span><br><span class="line">就让心跳替我们回答</span><br><span class="line"></span><br><span class="line">[Chorus]</span><br><span class="line">今晚别睡 别睡 别睡</span><br><span class="line">让月亮陪我们到天黑</span><br><span class="line">今晚别睡 别睡 别睡</span><br><span class="line">有你在身边什么都对</span><br></pre></td></tr></table></figure><hr><h3 id="示例-2：抒情流行风格（Mandopop-Ballad）"><a href="#示例-2：抒情流行风格（Mandopop-Ballad）" class="headerlink" title="示例 2：抒情流行风格（Mandopop Ballad）"></a>示例 2：抒情流行风格（Mandopop Ballad）</h3><p><strong>Style Prompt:</strong></p><blockquote><p>Sweet youthful female vocal, clear, delicate and airy Chinese pop voice, warm and innocent tone. Modern Chinese Mandopop ballad, 72 BPM, warm acoustic pop production. Soft felt piano, delicate acoustic guitar, warm electric piano, subtle bass, light brushed drums, gentle strings.</p></blockquote><p><strong>Lyrics:</strong></p><p>Plaintext</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br><span class="line">15</span><br><span class="line">16</span><br><span class="line">17</span><br><span class="line">18</span><br><span class="line">19</span><br></pre></td><td class="code"><pre><span class="line">[Intro]</span><br><span class="line">窗外的雨 下了一整夜</span><br><span class="line">我突然想起 你说过的话</span><br><span class="line">“累了就回来吧”</span><br><span class="line"></span><br><span class="line">[Verse 1]</span><br><span class="line">小时候总觉得 家门永远不会关</span><br><span class="line">总以为长大以后 就能走得很远很远</span><br><span class="line">你站在门口看着我 手里还提着那盏灯</span><br><span class="line">我说别送了 其实只是不想看见你的眼神</span><br><span class="line"></span><br><span class="line">[Pre-Chorus]</span><br><span class="line">我也学会了说没事 学会把眼泪藏起来</span><br><span class="line">却忘了那个最爱我的人 也会慢慢变老</span><br><span class="line"></span><br><span class="line">[Chorus]</span><br><span class="line">你还在等我回家吗</span><br><span class="line">还会不会站在门前</span><br><span class="line">像小时候一样 等我喊一声妈妈</span><br></pre></td></tr></table></figure>]]>
      </content:encoded>
    </item>
    <item>
      <title>img2threejs：单张图片转 Three.js 代码 3D 模型</title>
      <link>https://macin.top/posts/b08adf6e/</link>
      <description>img2threejs 把单张图片转成 Three.js 代码模型：通过代码重建图像，硬表面物体（耳机盒、机械载具）最拿手，输出带层级结构可动画的 TypeScript 代码。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E5%9B%BE%E7%89%87/">图片</category>
      <category domain="https://macin.top/tags/3D%E5%BB%BA%E6%A8%A1/">3D建模</category>
      <category domain="https://macin.top/tags/%E6%A8%A1%E5%9E%8B/">模型</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/">开源项目</category>
      <category domain="https://macin.top/tags/Three-js/">Three.js</category>
      <pubDate>Mon, 17 Aug 2026 07:27:55 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="img2threejs"><a href="#img2threejs" class="headerlink" title="img2threejs"></a>img2threejs</h1><blockquote><p>一张图丢进去，吐出来一段 TypeScript 代码，浏览器里跑起来就是个带层级结构、能动画的 3D 模型，省 token 也省事儿。</p></blockquote><p>Github地址</p><p><a href="https://github.com/hoainho/img2threejs">https://github.com/hoainho/img2threejs</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>硬表面物体最拿手：耳机盒、枪械、刀具、机械载具这类棱角分明的物体，还原度比较高</li><li>细节不糊弄：会专门盘点照片里的螺丝、倒角、磨损痕迹、发光标志这些小东西，缺了不往下走</li><li>分阶段做，一步一验：从粗模到结构、外形精修、材质、灯光、交互，每层做完都要对比原图检查，不行就返工</li><li>省token：机器干机器的活（验证、打包、写规范），人眼只负责最后看对比图打勾或打叉，不把算力浪费在反复重读代码上</li><li>角色也能做，但偏风格化：有人体比例和面部特征的分析流程，不过单张照片别指望100%像真人</li></ul><h2 id="怎么用"><a href="#怎么用" class="headerlink" title="怎么用"></a>怎么用</h2><p>Python 3.10以上就行，零依赖：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/hoainho/img2threejs.git ~/.claude/skills/img2threejs</span><br></pre></td></tr></table></figure><p>然后在Claude Code这类支持视觉的AI助手环境里，贴张图，打指令：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.</span><br></pre></td></tr></table></figure><p>之后跟着流程走：分析图片适不适合→写规格说明书→代码生成→浏览器渲染→对比原图→过就下一层，不过就改。每一步都有脚本管状态，人只看最终的左右对比图。</p><p>想手动跑也行，按顺序执行forge目录下的Python脚本，从探查图片、评估复杂度、写规范、验证、生成代码一路下来。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>lapian-notes：AI 辅助电影拉片笔记工具</title>
      <link>https://macin.top/posts/be1d9991/</link>
      <description>lapian-notes 开源 AI 电影拉片工具：导入影片自动抽帧配字幕，AI 生成剧情泳道时间轴、结构树与观众情绪曲线，数据存本地边播边写笔记。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/AI%E5%B7%A5%E5%85%B7/">AI工具</category>
      <category domain="https://macin.top/tags/AI/">AI</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/">开源项目</category>
      <category domain="https://macin.top/tags/%E7%94%B5%E5%BD%B1%E5%88%86%E6%9E%90/">电影分析</category>
      <pubDate>Mon, 17 Aug 2026 07:26:58 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="lapian-notes"><a href="#lapian-notes" class="headerlink" title="lapian-notes"></a>lapian-notes</h1><blockquote><p>这是个把电影拆碎了学的工具，导入片子后自动抽帧、配字幕，打包发给 AI 分析，最后生成剧情时间轴、结构树和情绪曲线，全程数据存在本地，不用上传服务器。</p></blockquote><p>Github地址</p><p><a href="https://github.com/bkingfilm/lapian-notes">https://github.com/bkingfilm/lapian-notes</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li>自动抽帧建时间轴：导入影片后每秒抽一帧，生成带截图的全片时间轴，不用手动拖进度条截图</li><li>AI 分析包一键打包：把截图和字幕打包成 ZIP，直接丢给 ChatGPT、Claude 这些 AI 去分析，不绑定任何 AI 服务，也不需要 API Key</li><li>剧情泳道图：AI 返回结果后，按电影自己的多条剧情线铺开，主线支线并行显示，同一段落被多条线复用时会自动生成引用卡</li><li>结构树 + 情绪曲线：段落按主线&#x2F;支线&#x2F;情感线&#x2F;信息线分组，同时画出观众投入强度的起伏曲线，哪里拖沓哪里紧凑一目了然</li><li>段落深拆：觉得某段值得细究，单独打包发给 AI，能拆到场次和镜头级别，包括剧本小节、视听手法</li><li>播放器联动：笔记里任何时间点——段落、剧本小节、字幕行——点一下就跳转到对应画面播放，”播放本段”到结束自动暂停，真正实现边播边记</li><li>手动精修：每个段落都能编辑，功能定位、关键节拍、剧本还原、创作意图这些字段都有</li><li>导出分享：整份笔记可以导出 Markdown、剧本正文，或者把泳道时间轴导出成长图发给别人</li></ul><h2 id="快速开始"><a href="#快速开始" class="headerlink" title="快速开始"></a>快速开始</h2><ol><li><strong>下载</strong>：点本页面绿色的「Code」按钮，选「Download ZIP」</li><li><strong>解压</strong>：双击或右键解压下载的压缩包</li><li><strong>启动</strong>：</li></ol><ul><li>Windows：双击文件夹里的 <code>run.bat</code></li><li>Mac：双击文件夹里的 <code>run.command</code>。第一次系统可能提示”无法打开”，在文件上<strong>按住 Control 点击 → 打开 → 打开</strong>，只需要这一次，以后直接双击</li></ul><p>第一次启动会自动准备运行环境和程序组件（电脑上没装过 Node.js 也没关系，会自动下载便携版，共约几分钟；之后每次都是秒开），完成后浏览器自动打开工具页面。使用期间保持那个黑色服务窗口开着；用完关掉它就是退出。</p><h2 id="免责声明"><a href="#免责声明" class="headerlink" title="免责声明"></a>免责声明</h2><ul><li>工具仅供个人学习和研究电影叙事使用，请使用你拥有合法访问权的影片</li><li>网络字幕搜索功能从公开字幕站获取字幕，字幕版权归原作者所有，请勿用于任何商业用途</li></ul>]]>
      </content:encoded>
    </item>
    <item>
      <title>handdraw-story-video：手绘插图转动画视频</title>
      <link>https://macin.top/posts/40046f5d/</link>
      <description>handdraw-story-video 将手绘故事插图转化为 35-45 秒动画视频：逐行显示画面与渐变色彩效果，默认 40 秒 720×960 30fps 竖屏格式，适合短视频创作。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E8%A7%86%E9%A2%91/">视频</category>
      <category domain="https://macin.top/tags/%E5%8A%A8%E7%94%BB%E7%94%9F%E6%88%90/">动画生成</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/">开源项目</category>
      <category domain="https://macin.top/tags/%E6%89%8B%E7%BB%98/">手绘</category>
      <pubDate>Mon, 17 Aug 2026 07:26:06 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="handdraw-story-video"><a href="#handdraw-story-video" class="headerlink" title="handdraw-story-video"></a>handdraw-story-video</h1><blockquote><p>将手绘的故事插图转化为时长 35 到 45 秒的动画视频，其中包含逐行显示画面和渐变色彩效果。</p></blockquote><p>Github地址</p><p><a href="https://github.com/xiejunjie524/handdraw-story-video">https://github.com/xiejunjie524/handdraw-story-video</a></p><h2 id="特点"><a href="#特点" class="headerlink" title="特点"></a>特点</h2><ul><li>默认 40 秒、720×960、30 fps，适合竖屏平台</li><li>每幕使用一张独立彩色母图，本地提取完全对齐的线稿</li><li>线稿和颜色统一从左向右推进，不重复调用生图模型</li><li>支持可选故事字幕和画面内道具文字</li><li>自动检查时长、重复素材、字幕行数与字号范围</li><li>不绑定生图服务、音乐来源或私有 API</li></ul><h2 id="环境要求"><a href="#环境要求" class="headerlink" title="环境要求"></a>环境要求</h2><ul><li>Python 3.10+  Python 3.10 及以上版本</li><li>Node.js 18+  Node.js 18 及以上版本</li><li>FFmpeg</li><li>HyperFrames  超帧</li><li>GSAP 3（通过 npm 安装，遵守其许可条款）</li></ul><h2 id="快速开始"><a href="#快速开始" class="headerlink" title="快速开始"></a>快速开始</h2><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br></pre></td><td class="code"><pre><span class="line">git clone https://github.com/xiejunjie524/handdraw-story-video.git</span><br><span class="line">cd handdraw-story-videopython -m venv .venv</span><br><span class="line"># Windows: .venv\Scripts\activate</span><br><span class="line"># macOS/Linux: source .venv/bin/activate</span><br><span class="line">pip install -r requirements.txtnpm install gsap</span><br></pre></td></tr></table></figure><ol><li>复制模板并填写故事：</li></ol><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">cp templates/story-template.json story.json</span><br></pre></td></tr></table></figure><ol><li>每幕只生成一张 1K 彩色母图，再提取对齐线稿：</li></ol><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python scripts/make_lineart.py assets/images/scene-01-color.png assets/images/scene-01-line.png</span><br></pre></td></tr></table></figure><ol><li>准备 HyperFrames 目录和 GSAP：</li></ol><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">mkdir -p hyperframes/assets/vendorcp node_modules/gsap/dist/gsap.min.js hyperframes/assets/vendor/gsap.min.js</span><br></pre></td></tr></table></figure><p>Windows PowerShell 可使用：  Windows PowerShell 可以使用：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">New-Item -ItemType Directory -Force hyperframes/assets/vendor | Out-Null</span><br><span class="line">Copy-Item node_modules/gsap/dist/gsap.min.js hyperframes/assets/vendor/gsap.min.js</span><br></pre></td></tr></table></figure><ol><li>把图片和已获授权的 BGM 放到 <code>hyperframes/assets/</code>，确保路径与 <code>story.json</code> 一致，然后生成页面：</li></ol><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">python scripts/build_story.py story.json hyperframes/index.html --check-assetsnpx hyperframes check hyperframes/index.html --jsonnpx hyperframes render hyperframes/index.html --output renders/story-v1.mp4 --workers 1</span><br></pre></td></tr></table></figure><p>不要覆盖旧成片；每次使用新的输出文件名。</p><h2 id="故事配置"><a href="#故事配置" class="headerlink" title="故事配置"></a>故事配置</h2><p>最小场景结构：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">&#123;  &quot;id&quot;: &quot;scene-1&quot;,  &quot;duration&quot;: 5,  &quot;caption_lines&quot;: [&quot;凌晨四点，&quot;, &quot;他总会经过那家早餐店。&quot;],  &quot;line_image&quot;: &quot;assets/images/scene-01-line.png&quot;,  &quot;color_image&quot;: &quot;assets/images/scene-01-color.png&quot;,  &quot;crop&quot;: &#123;&quot;scale&quot;: 1, &quot;x&quot;: 0, &quot;y&quot;: 0&#125;&#125;</span><br></pre></td></tr></table></figure><p>完整字段和分镜规则见 docs&#x2F;story-spec.md，可运行示例见 examples&#x2F;soy-milk-at-4am&#x2F;story.json。</p>]]>
      </content:encoded>
    </item>
    <item>
      <title>light-ocr：本地 OCR 工具，Node.js/C++ 直接调用</title>
      <link>https://macin.top/posts/fac33b3e/</link>
      <description>light-ocr 本地 OCR 工具：Node.js 与 C++ 使用，无需联网安装即用，识别图片文字返回内容、置信度与位置坐标，macOS 15+ 支持 Core ML 硬件加速。</description>
      <author>马仕</author>
      <category domain="https://macin.top/categories/tools/">tools</category>
      <category domain="https://macin.top/categories/tools/software/">software</category>
      <category domain="https://macin.top/tags/tools/">tools</category>
      <category domain="https://macin.top/tags/software/">software</category>
      <category domain="https://macin.top/tags/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/">开源项目</category>
      <category domain="https://macin.top/tags/OCR/">OCR</category>
      <category domain="https://macin.top/tags/Node-js/">Node.js</category>
      <pubDate>Mon, 17 Aug 2026 07:24:53 GMT</pubDate>
      <content:encoded>
        <![CDATA[<h1 id="light-ocr"><a href="#light-ocr" class="headerlink" title="light-ocr"></a>light-ocr</h1><blockquote><p>一个跑在本地的 OCR 工具，给 Node.js 和 C++ 用。不用联网，装完就能直接识别图片里的文字，返回内容、置信度和位置坐标。</p></blockquote><p>Github地址</p><p><a href="https://github.com/arcships/light-ocr">https://github.com/arcships/light-ocr</a></p><h2 id="功能特性"><a href="#功能特性" class="headerlink" title="功能特性"></a>功能特性</h2><ul><li><strong>本地处理。</strong> 图片和 OCR 结果始终留在本机。</li><li><strong>只需安装一个包。</strong> 模型和当前平台的预编译组件会随 npm 包一起安装。</li><li><strong>直接得到可用结果。</strong> 每一行都包含识别文字、置信度和原图位置。</li><li><strong>默认使用硬件加速。</strong> Auto 在 macOS 15+ Apple Silicon 上优先使用 Core ML，在下表的 Linux 和 Windows 版本中优先使用 WebGPU。</li><li><strong>适合应用内调用。</strong> 识别任务在 JavaScript 主线程之外执行，并支持队列、取消和明确释放资源。</li><li><strong>识别大图中的小字。</strong> 可选的 <code>tiled</code> 模式可以保留高分辨率图片中的小字和密集文字。</li></ul><h2 id="快速开始"><a href="#快速开始" class="headerlink" title="快速开始"></a>快速开始</h2><p>支持 Node.js 22 和 24。</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br><span class="line">9</span><br><span class="line">10</span><br><span class="line">11</span><br><span class="line">12</span><br><span class="line">13</span><br><span class="line">14</span><br></pre></td><td class="code"><pre><span class="line">npm install @arcships/light-ocr</span><br><span class="line">import &#123; createEngine &#125; from &quot;@arcships/light-ocr&quot;;</span><br><span class="line">import &#123; readFile &#125; from &quot;node:fs/promises&quot;;</span><br><span class="line"></span><br><span class="line">const engine = await createEngine();</span><br><span class="line">const result = await engine.recognizeEncoded(</span><br><span class="line">  await readFile(&quot;image.jpg&quot;),</span><br><span class="line">);</span><br><span class="line"></span><br><span class="line">for (const line of result.lines) &#123;</span><br><span class="line">  console.log(line.text, line.confidence, line.box);</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line">await engine.close();</span><br></pre></td></tr></table></figure><p><code>createEngine()</code> 会根据当前平台自动选择合适的执行方式。如果应用已经完成图片解码，<code>recognize()</code> 也可以直接接收 <code>GRAY8</code>、<code>RGB8</code>、<code>BGR8</code> 和 <code>RGBA8</code> 像素数据。</p>]]>
      </content:encoded>
    </item>
  </channel>
</rss>
