跳转到内容

附录 A 案例集

来自《个人产品实践》 · 原稿更新 2026-11-09 · 服务器只读阅读视图

具体记录按章归类,正文只留规律并指向这里。

A.1 第 1 章 个人工作台

A.1.1 每天重复的任务要分“长期模板”和“当天完成状态”,不要复制出很多任务

每日重复任务应有稳定模板和按日期归属的完成实例;今天完成不能让明天自动完成,也不应无限复制任务模板。跨午夜、新建/修改模板和历史日历回看都要验证数据一致。

A.1.2 账单分类先分清消费与人际转账,再做展示

转账是支付形式而不是消费类型:人际资金转移、给商户转账购物和退款在统计中应分别处理。先由交易语义决定收支归属,再决定图表如何显示;模糊记录保留待确认状态。

A.1.3 个人工具优先服务 AI 执行、人阅读与核对

个人工作台是人查看、校对和决定的入口;Agent 负责重复导入、分析与整理。先复用现有数据真源和受控操作接口,不为每个入口再嵌一个独立 AI 或制造平行数据库。

A.1.4 产品里的估算值,需要单位、来源和可修正性

模型估算、参考数据库值和传感器实测值应区别展示,标明单位、来源、缺失条件和可修正入口。发现一次食物估算错误,要检查同类输入是否存在系统性偏差,不能只改被指出的数字。

A.1.5 把工作台融入 Obsidian:原生可操作,但不能制造第二套数据

Obsidian 里希望直接操作记账、日计划和学习摘要,但不应各自建立第二套真源。先复用工作台数据接口做最小可编辑面板,验收跨端保存、离线冲突和原始学习材料回查,不将设计讨论写成已上线。

A.1.6 构建成功的“完整 MVP”,若 WebDAV 和绑定安全都没验,仍只是纸面成果

个人工作台页面与模块完整、构建成功,只是代码存在的证据,不等于 MVP 可安全使用。WebDAV 认证与跨账号权限、CORS/HTTPS、绑定凭据生命周期、数据读写和恢复都需真实测试;Base64 放在 URL 不是加密。

A.2 第 2 章 学习平台

A.2.1 家庭任务奖励:先用“家长确认的记录”验证闭环,而不是先做支付系统

家庭任务激励先做“派任务→孩子上传证据→家长审核→奖励记录”的闭环。一次任务和每日任务都可复用现有家庭关系与权限;记账奖励不是钱包余额,不自动支付、提现或引入商城。

A.2.2 旧学习计划不显示在“今天”,但仍要供 AI 制定新计划时参考

学习计划需要区分今天的可见任务与未完成的历史证据。过期任务应供 AI 排新计划时参考,但不能冒充今天新建的任务;今天没有计划就展示真实空态,不能因旧任务存在而虚假显示“今日计划”。

A.2.3 家长学情报告:学生表达感受可以自报,学习事实必须有证据

家长学情预览要将客观证据与学生自述分开:答题、有效计时和完成状态只能从可信数据来;学生的感受和鼓励话语可以自述。发送前让学生审阅,未达复习标准的任务不能仅凭一句“完成了”标掌握。

A.2.4 冷启动验收:成功保存画像,还要看学生第一次看见什么话

冷启动先问年级、想改善的科目等最小信息,跳过也有默认行为。后端画像保存成功只是第一步,还需验证学生第一次看到的按钮是否明显、AI 说的话是否清楚、手机返回后能否继续。

A.2.5 上传文件后自动摘要和归一标签:便利不等于可以任意命名

上传素材后可由 AI 生成名称、知识点和摘要,但须绑定原文件及版本,并将标签归一到稳定词表。请求返回 HTTP 200 不等于得到有效文本;空正文、解析失败和输出预算耗尽要有明确状态及回退。

A.2.6 为弟弟做的学习产品能不能通用化:真正的取舍是“先稳核心,再复用能力”

给初中生用的学习工具与成人自学可复用任务、笔记和计时,但家长协同、考试、奖励不一定能直接推广。当前真实学习闭环未稳定前,应先收缩范围修好核心,再用明确需求决定是否扩年龄层。

A.2.7 同一个学习账号切换“课业/兴趣”,公共能力可以复用,业务数据和 AI 上下文不能串

学习账号切换“课业/兴趣”,可共用登录、日历、资源检索和页面组件,但计划、知识点、统计、会话历史、记忆与工具权限必须按学习空间分隔。前端切 Tab 不足以隔离数据,后端查询和写入也需验证 space ID。

A.2.8 试卷作答:分式、作文和复习状态要分开设计

数学分式输入、作文长文本、拍照答题不应被同一个小输入框限制;试卷状态要区分未开始、进行中、已交卷、复习。答得快不必然敷衍,要结合正确率、内容证据和题目难度。

A.2.9 学习画像有“知识点标签”不等于能持续追踪同一个知识点的掌握度

同一知识点若只是自由文本标签,不同写法就难跨错题、课程与会话累计掌握度。先用小范围稳定 knowledge_point_id 串联题目、学习证据和复习结果,再验证掌握变化;“模型认识这个词”不能替代数据库身份一致。

A.2.10 测试结果和功能状态不能混淆:当年曾把“修复代码”与“用户确认验收”拆成两个节点

修复代码、自动测试通过、合并部署、用户实际确认是不同状态。Issue 要保留复现、目标版本、截图和链接;台账不能只凭文档名就说问题已解决,要回读实际代码和部署。

A.4 第 4 章 Research 与 Video

A.4.1 飞书知识卡片多发几轮还显示星号与原始标签:生成 JSON 成功不代表客户端正确排版

飞书知识卡片模型生成 JSON 正确,客户端却显示星号或原始标签时,应分别检查生成内容、转卡片结构、发送 API 和最终客户端渲染。服务器接收成功不等于真实排版正确;飞书/Telegram 等不同渠道须单独验收。

A.4.2 飞书推送迁到 Telegram:目标地址改了,任务 Prompt 还在调用飞书

迁移调研推送从飞书到 Telegram,要同时改调度目标、Prompt 中的发送工具、卡片格式、授权和常驻进程。Telegram Web 登录成功不等于 Bot 网关在线;发送成功也不代表新平台阅读体验更好,需在真实客户端验收。

A.4.3 B站课程助手:不能止于推荐一个视频链接,还要选集、读内容、测学会没有

课程助手要走“定位合适单集→拿到真实字幕/转写→根据该集内容提问→根据学生回答调整”。合集标题只能帮助选集,不能编造视频里的教学内容;先做好一个渠道再扩其他平台。

A.7 第 7 章 其他探索

A.7.1 一分钟手机产品 Demo:合成学生数据不等于真实学习效果

一分钟产品 Demo 可以使用清晰标注的合成学生账号演示“计划→学习→证据→学情”。画面步骤要真的可操作,剪掉等待不等于允许剪掉失败;不能拿模拟成绩声称真实学生效果或用户转化。

A.7.2 macOS 行内润色:先保证写回安全,再评建议质量

2026-11-05 的 StylePolish v2 原型尝试把建议直接画在输入文字上:AX 监听与防抖、透明波浪线、悬停卡片、逐条采纳/忽略、坐标不可用时回退列表。复用已有 AX、Keychain、差异算法与打包流程;UTF-16 定位、原文核对和陈旧请求拒写的学习点已在《前端与交互设计》4.4,不另复制一套。

当时 23 项测试、release 构建和未签名打包通过,PR #4 待审。合成 NSTextView 曾部分通过,但最终复测被焦点切换阻断;微信、飞书、浏览器和备忘录等真实 App 的完整兼容性、输入法、多屏和真实模型质量仍未验。功能清单、合成截图和 CI 不能替代真实输入框安全写回。这是历史进度,本次没有核对 PR 当前状态。

2026-11-05 后续审查发现 Unicode 规范等价可能绕过 Swift String 相等核对:单字符 é 与 e 加组合重音被认为相等,UTF-16 长度却不同,旧偏移可能误写。修复任务把写前全文/选区检查、会话差异与重定位改为 utf16.elementsEqual,并加入原文“😀é错字”变为分解编码时旧建议过期、拒绝写回的回归。任务报告记录修复前 6 个断言失败、修复后 24 项测试及 release 构建/打包通过,提交 bf096ab 的 push/PR CI 均通过;未合并。此处依据 result4.md 与其日志,不替代真实 AX 控件和完整 App 兼容验收。通用理解见《前端与交互设计》4.4。

2026-11-06 至 08 的发布与运行验证(待学习)

开发环境里能找到资源,独立 App 里也可能缺文件。一次编译和单测通过后,仍须把产物移到独立目录核对 Resources 和启动。后续同一 ZIP 用两种解包工具,严格签名校验出现不同结果,因此要按用户实际的解包、安装、首次启动流程重试。临时签名、公证、升级后保留辅助功能权限和普通用户首次使用分别验收。

在开发机上,启动时读一次旧凭据也曾是弹窗风险。运行时凭据来源与构建签名分开后,仍要从安装后的启动路径观察。还有一次输入框可读,黄色提示实际是模型请求参数不兼容。诊断分别保留读取、请求、界面显示的结果,连接测试应走和正式建议相同的请求构造。这里记录当时的对照和改动,正式分发与各 App 的行为按具体版本验证。

独立产物启动 · 运行时凭据路径 · 实际请求错误 · ZIP 解包对照

复用时仍需核对的边界(待学习)

凭据来源的优先级也要明示:当时方案是 vault 优先、受限权限文件兜底;外部配置改后手动重载,高优先级仍存在时本地保存不会覆盖它。此处保留历史选择,不能直接推广成所有桌面工具都应改用文件。签名通过与启动通过也分开;曾有原位覆盖可执行文件触发 Invalid Page,换新文件后恢复,更新先退出并替换完整 bundle。

A.7.3 从源码写 README:验证“看懂”要拆成三项

2026-11-05 的两个本地技能案例说明:自动 verify 通过、陌生人能认出项目用途、盲选更喜欢新版,是不同证据。readme-from-code 第三轮报告为 55 项测试通过、两案例 verify 21 通过/1 明确跳过,陌生人识别均只有 4/5,forWhom 未命中词表;盲选胜出也不能抹掉这个缺口。design-from-sites 的 fixture 与 CI 后续通过,真实站复测仍有未完成阶段,不能用原创测试图替代真站可用性。

这些技能实现仍以各自仓库为准,知识库只留下评价方法和边界:README 技能 PR #2、设计提取技能 PR #2。来源为本地归档 ~/归档/claude-旧/原始/codex-tasks/rfc-v03-result.md、dfs-v01-result2.md 至 dfs-v01-result4.md,本次没有重新执行或核实当前 PR 状态。

2026-11-08 的反例,允许保留旧版(待学习)

自动扫描先查项目清单、CI 和发布方式。一次 SwiftPM App 有 Package.swift 且 CI 在跑 swift test,扫描器却给了安装技能的命令。测试同时放入真正的技能、App 和没有可识别清单的项目,最后一种可以返回待确认。

公平对照前先给旧版的运行要求、许可证、真实状态徽章和关键图示留快照。候选删去其中一项,要能说明原因。一次补回徽章后新版仍是 0/3,读者更喜欢原版的来源图、间距和可见安装命令。没有足够改进证据时,保留旧版并交付反馈与候选改进即可。视觉输入控制见《前端与交互设计》5.4。

保留旧版的对照 · 项目类型误判