nested-flag-settings-auto-disable
该条目讨论 Kotlin 设置界面中嵌套开关的三层防护：子开关行在父条件关闭时自动将自身置为关闭，状态持有者在撤回父条件时清除子开关，消费方拒绝单独依赖子开关。文中给出基于 LaunchedEffect(isEnable) 的 Compose 示例、用 if (childEnabled) 守卫回调避免写入循环、以及灰色禁用而非隐藏行的做法，并说明懒列表中离屏行不执行副作用、门控值需来自可观察状态等限制，附 grep 排查命令。
Skill 广场
找到适合任务的 Agent Skill，阅读介绍并复制安装命令。
更新于 11-15 00:13
编程与开发
41,126 个结果
no-use-case-layer-decision
这是一份面向 Kotlin 中型应用的架构技能文档，讨论是否需要在展示层与仓库层之间保留交互器（interactor）或用例（use-case）层。核心观点是：这一层并非必需，真正的边界在于仓库接口而非交互器。文档给出替代方案（领域模块中的仓库接口、数据模块内 internal 的纯映射函数、仓库返回统一结果封装）、如何用多种 grep 命令证明“不存在用例层”、去掉该层后失去的四项能力、何时应局部重新引入，以及文件过大、仓库泄露传输类型、映射函数膨胀等陷阱和对策。
noop-actual-not-platform-limit
核实 Kotlin 跨平台空实现背后的真实原因。
nowplaying-pager-no-feedback-loop
一个 Kotlin/Compose 的“正在播放”封面 pager 实现模式，解决双向绑定（播放器切歌驱动 pager 滑动，用户滑页触发播放器 seek）时产生的反馈循环问题。核心是用自己维护的 isAnimatingFromPlayer 标志包住程序化滚动，用 settledPage 而非 currentPage/targetPage 分发 seek，并把 seek 决策提取为纯函数 computeSeekAction；同时处理后退滑动、随机播放索引、队列缩短和单曲循环等边界情况。
oauth-callback-not-through-nav
这是一份 Kotlin 多平台开发中的避坑指南，专门说明 OAuth 登录回调不应通过导航来传递令牌。当登录流程交由系统浏览器完成时，回调会直接到达应用进程，而发起登录的屏幕仍留在返回栈上；若把令牌作为参数导航到该屏幕，就会压入一份重复副本，导致用户显示为已登录却停留在登录页。正确做法是把令牌直接写入会话状态，并让登录屏幕观察已存储的会话自行关闭。文档还列出了进程被杀死后的冷启动、内嵌 WebView 与系统浏览器行为差异、request token 的两种流程、链接规范化改写回调、待处理链接未清除导致令牌重复提交、令牌一次性短时效，以及无 scheme handler 时的手动粘贴回调 URL 兜底等陷阱，并给出 grep 验证命令与三种行为测试方式。
on-demand-dictionary-asset
这是一个面向 Kotlin Multiplatform 的按需字典资源技能：把约 13 MB 的日语分词词典（8 个 .bin 文件）从 Android APK 中剔除，改为按需下载，桌面端与 iOS 则在类路径上直接携带并走恒真实现。通过一个 expect/actual 接口统一三端行为，涵盖就绪状态从磁盘校验而非缓存标志、staging 目录加原子重命名避免半安装、大小与 SHA-256 两级完整性校验、白名单式解压、惰性构建不缓存失败、功能门控不阻塞选择、Mutex 保证单次下载等要点，并给出 grep 验证命令。
one-setting-two-backends
本条目是一份技术实践说明，主题是：如何让同一个已存储的音频均衡器设置，在两个互不相关的音频后端上表达出完全一致的效果。核心做法是把频段中心频率、频带宽度（Q 值）和增益范围只定义一次，供两个后端共同引用，并用一个中立的第三方实现来验证两边系数是否正确。文中给出十条频段中心频率常量（31 Hz 至 16 kHz）和 Q=1.41 的 Kotlin 代码示例，说明常量漂移、单位混淆、平台自带效果 API 的局限、增益级相对频段的位置、外部配置文件的兼容契约、本地化数字格式（Locale.ROOT）、UI 标签列表重复定义等问题，并附上以 ffmpeg 生成脉冲响应、用 Python 做解析对比的验证脚本和 grep 复查步骤。
order-preserving-section-mapping
这是一则面向 Kotlin 开发者的编码实践指南，主张把分节（sectioned）API 响应按到达顺序映射为 (title, items) 的列表，而不是把 result[0]、result[1] 读入具名的固定字段。文档指出，按位置映射在响应新增一个前置分节时会整体错位，导致名称错配、最后一个分节被丢弃，且不会抛异常或记日志，很难复现。它建议用列表作为领域模型，消费者改用遍历而非索引，并提醒解构、固定长度校验、zip、按索引分支等同样隐含数量假设；标题若随账户或地区本地化，不能当作查找分节的键。文档还提到 forEachIndexed 可能重新引入位置耦合、空分节会原样保留需显式处理、列表缓存时顺序反映写入时状态。验证方法：抓取未登录与登录、两种语言环境下的同一请求对比分节标题和数量，并加入分节插入首位的测试用例。
parallel-chunked-download
该技能介绍一种基于 Kotlin 协程的并行分块下载实现：先通过 Range 探测判断服务器是否支持分段下载，再将文件按字节区间拆成 N 个分片请求并发发出，每片写入独立临时文件，按序合并为最终文件，并通过 Flow 上报进度。内容重点列举了常见陷阱，包括把任意 2xx 响应误判为支持 Range、分片校验 206 状态、单分片重试需截断重写、整数除法余数导致末片边界丢失、进度发送结果被丢弃、进度粒度不足、并行度上下限以及失败时清理临时目录与传递异常等，并给出用 grep 检查实现是否合规的验证方法。
periodic-worker-dedup
periodic-worker-dedup 是一个面向 Android 的周期性通知器实现模式，目标是让后台周期任务既不漏掉条目，又最多只重复一条。它说明平台只保证周期任务最终会运行且会再次运行，任务可能被中途杀死，因此 worker 内不能保存“已处理”状态，必须依靠数据库去重；同时结合发布时间窗口和数据库存在性检查双重条件，并按发布时间从旧到新处理，以保证延迟运行仍能补发、中断后剩余的是最新条目。文档还列出内存状态不可靠、去重键应使用稳定标识、坏日期不能默认为当前时间、先通知后记录会留下窄重复窗口等陷阱，并给出连续运行两次、删除记录重跑、跳过一轮、校验窗口与间隔、喂入畸形数据等验证方法。
play-intent-decided-before-load
这是一个关于 Android 播放器开发中加载与播放意图时序问题的技术条目（来自 kotlin-footguns 系列）。它指出：在跟随远端播放控制时，应当先决定新加载的内容“是否播放、从何处开始播放”，再把这两个决策作为参数传入加载调用，而不是先加载再事后修正。事后修正会与加载路径产生竞态，导致在已暂停的房间中短暂出声；文章还讨论了位置处理的三种情形（队列重建时保留播放头、位置为零时从头开始、以及新加入者对齐到房间进度）、非可空参数、追加队列时不应重复携带播放标志、以及用 grep 审计硬编码加载点等做法，并给出了需要两个客户端的验证方法。
playback-position-persist-restore
该技能围绕音乐播放器“记住用户播放到哪里”这一问题，对比两种保存形态：在应用生命周期边界（切歌、暂停、退出）进行完整的队列重写是一件重活，而每隔五秒仅写入曲目 ID 与播放位置则是一件轻活。技能指出，若把重活放在定时器上会造成浪费；若只在生命周期边界做轻活，则会漏掉最关键的场景——长时间后台播放被系统结束，且没有暂停或切歌来触发保存。正文给出重、轻两种保存代码，并列出定时器复用已有进度循环、重启前取消上一循环、队列重建期间跳过重保存、在发出会改变值的播放器命令前先做快照、保存曲目可能不在保存队列中、seek 前等待加载完成、seek 后重新发布位置与时长、用带阻塞开关的单一保存体，以及位置与时长并非同一时钟、持久化受用户设置门控时恢复需干净降级等陷阱，最后给出验证方法。
polymorphic-load-media-entry-point
该技能介绍如何用一个通用入口函数统一处理多种媒体条目的加载与播放：用泛型参数把歌曲、视频、分享链接等不同类型的条目规范化为内部 Track，再用类型判别串（type）决定队列的填充策略（相关推荐、歌单、专辑、电台、恢复会话等）。它强调播放控制策略（如是否允许播放显式内容）必须在改动播放器之前执行，自动播放状态应由判别串推导而非额外布尔参数传入，未知类型应安静返回，并建议用 sealed type 或 enum 避免 String 判别串因拼写错误或缺失分支而静默失败。文档还给出用 grep 校验所有播放来源都经过该入口的方法。
position-based-group-sync
这是一个关于实时同步多人播放位置的 Kotlin 工程模式说明。核心做法是：每条命令都携带播放位置，并依据命令在途时间修正位置，仅在偏差超过容差时执行 seek。资料详细列出实现要点（位置随命令发布、仅在播放中推进、时钟未校准回退、非正位置含义等）、常见陷阱（容差与检测阈值分离、定时广播无益、恢复性 seek 不应受容差限制等），以及验证方法（检查容差常量命名、审计 seek 调用、双客户端行为测试）。
preset-identity-read-back-from-value
本技能介绍一种 Kotlin 状态建模实践：不额外存储“当前选中哪个预设”的标签，而是通过将预设列表与当前生效的数值进行比较，反推所选预设。这样任意编辑都会自然落入“Custom”，把数值改回后又会自动重新选中预设；同时给出容差比较、重复预设、长度不对称、派生字段和 -0.0f 等注意点及验证方法。
protobuf-without-codegen-kmp
这是一个面向 Kotlin Multiplatform（KMP）项目的技能，介绍如何在不生成代码的情况下，直接使用共享 Kotlin 中普通的 data class 和字段编号注解来收发 protobuf 消息。它说明了序列化器需要设置 encodeDefaults = false 的原因，分析了字节数组属性在相等性比较和往返测试上造成的假象，并给出用一致性测试固定字节级行为、对压缩设置阈值、划分模块边界等方法，还列出用于静态检查的 grep 命令。
publish-a-snapshot-on-taking-the-role
该技能文档针对 Kotlin 共享会话中的发布者设计问题，指出仅依赖边沿触发（edge-triggered）的发布者会导致“已在播放时才加入”的参与者收不到任何状态，因为没有任何变化事件被触发。文档提出增加两个电平触发（level-triggered）发布者：一个在取得发布者角色时发布快照，另一个在有成员加入时发布快照，从而覆盖角色切换和新成员到达两种场景。文中详细列出多项陷阱，包括中继只记住最后一条命令、快照需同时发送条目和播放状态、应读取意图标志而非观测状态、快照必须写入与变更发布者共享的记账字段、按成员数量而非成员列表作为键、快照需独立收集器、角色标志应放入键中、空快照要提前返回、以及交接时需先翻转角色标志。最后给出用 grep 清点发布者并验证键的检查方法，以及一个端到端验证场景。
queue-rebuild-state-machine
本项目介绍一种 Kotlin 队列重建状态机实践：在队列状态对象上放置重建状态标志，用单个枚举区分“重建中”与“稳定”两种有效取值，从而同时实现重入保护和快照保护。资料给出了 QueueData 数据类与 StateSource 枚举示例，说明了在每个追加或重建入口处检查并设置 STATE_INITIALIZING 的写法，并指出成功路径与错误路径都必须复位状态。还强调持久化读取需使用同一标志，避免在重建中途保存不完整队列，并提醒不要把该标志当作 UI 加载状态使用。
readiness-barrier-needs-every-answer
该技能条目记录了一种“就绪屏障”（readiness barrier）协作模式下的常见陷阱与实现要点：每个客户端各自解析同一内容，服务端公布仍在等待的成员名单，被点名的客户端在内容加载后回应，最后一人回应后全体才继续。条目强调应基于缓冲/加载信号而非播放状态作答、仅在名单中出现时回应、按被等待的内容 ID 回应、保持回应可重复、在界面显示等待成员名称，并在屏障完成时清除两侧状态。同时给出了跨协议、应答收集器和界面三层的排查命令与双客户端慢网测试方法。
readonly-stateflow-cold-to-hot
这是 Kotlin 状态管理领域的一条技能说明，重点讲两个容易出错、但每个只需改一行的细节：一是对外暴露 StateFlow 时，要用 asStateFlow() 包装为只读，而不是用向上转型把 MutableStateFlow 赋给更窄的静态类型；因为向上转型会泄漏可写对象，而 asStateFlow() 返回的是独立的只读包装。二是把冷流变成热流：用 stateIn(scope, SharingStarted.WhileSubscribed(超时), 初始值) 共享一次订阅。资料还讲了几个陷阱：get() 访问器、WhileSubscribed 超时值是策略而非固定常量、Eagerly/Lazily 的差别、初始值会被直接显示、stateIn 必须放在属性上而不能放在函数里、SharedFlow 与 StateFlow 的语义区别，并给出校验方法（尝试把公共属性转回 MutableStateFlow，以及在冷源构建器里打日志观察订阅）。
realtime-biquad-dsp
实时双二阶（biquad）IIR 滤波器，用纯 Kotlin 实现，无需第三方库，适用于音频回调中不能分配内存的场景。支持低通、高通以及多段峰值滤波组级联，依据 audio-EQ-cookbook 公式计算系数。资料重点说明实现细节与常见陷阱：每通道需独立维护状态变量，级联每级需独立状态集，旁路或流变更时需清空历史，截止频率需钳制在安全范围，系数用脏标记在缓冲区边界惰性重算，扫频采用对数插值。还给出可复现的数值验证方法。适合音频处理开发者参考。
remoteviews-bitmap-budget
面向 Android 桌面小组件（RemoteViews）开发的位图内存预算技能。该技能指出：小组件中每个被绘制的位图都会被复制进跨进程传递的 RemoteViews 载荷，平台对单次更新携带的位图内存设有上限，超限的更新会被直接拒绝且不抛异常。技能给出位图内存计算公式（宽×高×4 字节）、按绘制尺寸解码的建议、硬件位图限制、磁盘缓存键与解码尺寸需成对统一等要点，并提供用 grep 核查请求尺寸、硬件标志与缓存键的验证命令。
removing-a-feature-audit-shared-handles
该技能用于在删除与新版功能重复的旧功能时进行共享句柄审计与安全移除。核心内容包括：识别共享句柄的真实使用方、清理跨平台空实现桩、删除设置项与字符串资源、迁移或显式处理存储偏好、检查清单文件与广播等非代码引用，并通过带期望计数的 grep 命令和运行时验证确认移除彻底。适用于 Android/Kotlin 项目中存在新旧功能并存、共享音频会话等句柄场景的功能下线操作。
repository-flow-conventions
按数据来源选择 Repository 方法的 Flow 与 suspend 形式。