跳转至

项目

项目是一个具体的东西 —— 自己做的软件、别人的仓库 —— 讲它解了哪些问题，每个问题只留它自己那一种方案；问题之间互相牵连，一个怎么解会牵制另一个，读者拿走的是整个东西怎么造。在板块的那根轴上它在最具体那头；一个通用问题讲几种方案的是文章。一个项目一个目录，按领域分组；只为这个项目写的操作手册、截图跟着项目放。

讲多深都算，粗讲的钩子以「粗讲：」开头：

  • 粗讲一页：它是什么、解决谁的什么问题、主路径怎么跑通，照粗讲项目讲三四段，不套论文骨架；读的 commit 写进脚注，不另开维护记录；讲完的追问在正文后开「追问」一节 —— 活例 Teable
  • 细讲一组：从这个领域最简单的做法出发，一步步遇到了什么问题、所以引入了什么功能，每一步贴源码模版和实跑效果，照细讲项目；读的哪个 commit、实验怎么跑写进维护
  • 粗讲要细讲：在同一个目录里长，入口那页按细讲重写，地址不变

按领域

知识库

  • wiki 介绍 —— 这个 wiki 自己的事：目标与计划、怎么当远程 skill 用、板块怎么分、用到的技术一项一页（对象存储部署、自建 git-lfs 后端、打码），文末能力时间线按日期列出在 Zensical 之上加过的每项功能，附当时的需求原话和改了哪里
  • Docmost —— 粗讲：不是一个人用的在线记事本，是自托管的团队 wiki；主路径是每页一份 Yjs 文档，经 Hocuspocus 实时合并多人改动，停笔 10 秒连同 JSON 和纯文本一起落库；开源版模型不参与，AI 在闭源 ee 子模块；追问两条：不是 Office 套件，Bases 要付费、ppt 只有演示模式；和 git 仓库加 Zensical 比，差在谁来写、谁来读
  • TiddlyWiki —— 粗讲：整个 wiki 可以只是一个 HTML 文件；打开时从文件里的 JSON 读出全部 tiddler，内核和界面也是 tiddler；存盘把模板渲染成新文件，浏览器里兜底是下载副本，写回原文件靠服务器或扩展

AI 角色扮演

  • 梨园 Liyuan —— 领域是 AI 角色扮演，它把角色扮演从一次生成改成 agent 循环；以网页版 ChatGPT 为 baseline，按设定、状态、长对话、分支、正文、定制、数据七条功能线讲问题和功能，每步配源码模版和实跑效果，结论是能搬走的设计
  • 酒馆 SillyTavern —— 领域是 AI 角色扮演，它把网页版 ChatGPT 的一段 system prompt 换成每轮重拼的上下文；按角色卡、世界书、现拼 prompt、喂各种模型、重来分叉、聊久了、群聊、自加规则八条功能线讲问题和功能，每步配源码模版和实跑效果，结论是能搬走的设计
  • PawzoChat —— 粗讲：和梨园、酒馆不是一类，不是角色扮演前端，是把角色接进微信、QQ 当联系人的 AI 伙伴引擎；只借酒馆的卡格式，主路径是连发停 7 秒才合成一轮、回复按反斜线切成几条气泡

Agent 与评测

  • DeepSeek Harness —— DeepSeek Harness 拆解：领域是 agent harness，以 pi 为 baseline，按插件、会话日志、拼 prompt、压缩、工具与沙箱、多 agent 六条线讲问题和功能，配源码模版和实跑；重心是请求从会话日志现算
  • OpenAI Evals —— OpenAI Evals 拆解：领域是大模型评测框架，以 for 循环评测脚本为 baseline，按登记、判分、被测对象、多轮、跑和记五条线讲问题和功能，配源码模版；重心是一个 eval 等于数据加 YAML 里选一个模板类
  • 搭建 AI 助手 —— 给常驻 Agent 接输入输出通道；已落地的第一条是不装邮件服务、自己在 25 端口说 SMTP，第二条是 Caddy 换 key 的 API 中转（已接 DeepSeek）
  • DeepSeek 视频问答 —— 粗讲：给 agent 挂的 skill，模型不收视频，就把录像拆成带时间标签的帧逐帧做卡片、拼成 30 秒一段；提问时 TF-IDF 粗筛、模型挑段、开推理深读，答案带时刻，准不准由人回放片段核对

开发工具

  • Teable —— 粗讲：不是又一个在线表格，是套了表格外壳的 Postgres；程序管结构和联动计算，模型只填 AI 字段；重心是改一格后跨表连锁重算；追问两条：更像 Airtable，计算字段不靠触发器、在应用层算
  • Coolify —— 粗讲：和 Podman 不在一层，它不是容器引擎，是坐在 Docker 之上的自托管 Heroku；主路径是 SSH 进目标机起 helper 容器构建镜像，用带 Traefik label 的 compose 拉起
  • Pyodide —— 粗讲：不是把 Python 翻译成 JS，是把 CPython 解释器编译成 WebAssembly；Python 的 import 是同步的、下载只能异步，所以包要先 loadPackage 解进内存文件系统，.so 提前 dlopen
  • Frappe Gantt —— 粗讲：给网页用的甘特图组件，只画图、改内存里的任务，不存也不排期；主路径是日期和像素按列宽互换，拖一条任务时依赖它的下游跟着平移，存回后端靠 on_date_change 交给用的人

硬件

演示