编程

platform-pitfalls

试用

Cross-platform engineering pitfalls playbook: Chinese/non-ASCII encoding defense (Python entrypoints, child processes, file IO, CMake execute_process ENCODING, MSVC /utf-8 vs VSLANG, Windows console code pages, doctest/CTest discovery), PowerShell 5.1 mojibake three-layer fix (UTF-8 BOM + chcp + byte arrays), and 11 C++20 coroutine pitfalls (lambda captures, catch co_await, mutex resume, handle lifetimes, container-overflow spans). Load when authoring or debugging cross-platform build tooling, CI, installers or async C++ — especially anything that must run on Chinese Windows (cp936/GBK) or Windows runners (cp1252). Triggers: 中文乱码, mojibake, UnicodeEncodeError charmap, doctest CTest Chinese test names, PYTHONIOENCODING, VSLANG, code page 936, 璇峰鎻朵, coroutine UAF, ASan container-overflow.

它能做什么

疑难杂症不是玄学:每一条都是「本机全绿、目标平台爆炸」的事故换来的。 本手册把三类高频平台坑收敛成可执行的防御清单。

技能文档

Platform Pitfalls Playbook

疑难杂症不是玄学:每一条都是「本机全绿、目标平台爆炸」的事故换来的。 本手册把三类高频平台坑收敛成可执行的防御清单。

When to use

遇到以下任一情况,读对应章节(references/ 下):

症状读哪章
Windows 上中文变 璇峰•鎻•朵 / UnicodeEncodeError: 'charmap'/'gbk' codec@references/chinese-utf8-pipeline.md
跨平台脚本/构建工具要处理中文路径、中文测试名、重定向日志@references/chinese-utf8-pipeline.md
.ps1 脚本在中文 Windows PowerShell 5.1 上乱码@references/windows-powershell-utf8.md
Python CLI 在 Windows 控制台 print 中文/emoji 炸@references/windows-powershell-utf8.md
C++20 协程 -O3 悬空、mutex 内 resume 崩、ASan container-overflow@references/cpp20-coroutines.md

核心原则(全章通用)

  1. 任何一层默认编码都不可信。每个边界显式声明 UTF-8。
  2. 本机 macOS/Linux 全绿不算数——默认 UTF-8 locale 掩盖一切, 中文 Windows 和 Windows runner 才是考场。
  3. 写完必须推真实 Windows CI 验收,含中文路径、中文内容、 重定向日志与失败诊断的可读性。
  4. 不静默吞错。errors='replace'、空 except、降级跳过都是把 事故变成更晚更难的排查。

沉淀新坑(本手册的维护方式)

踩到新平台坑并修复后,按「症状 → 原因 → 解法 → 验收命令」四段式追加进 对应章节;开新章节的标准:同类坑第二次出现、或独立成一个技术域。 不要记「某次会话里 AI 说了什么」,记可复现的工程事实。

章节索引

  • references/chinese-utf8-pipeline.md — 中文编码五层防线 (Python 入口 / 子进程 / 文件 IO / CMake / MSVC + 控制台)+ 验收 标准 + 常见误区(含 MSYS2/MinGW 关系澄清)
  • references/windows-powershell-utf8.md — PowerShell 5.1 三层修复 (UTF-8 BOM + chcp 65001 + 关键字符串字节数组)+ Python 控制台姊妹问题
  • references/cpp20-coroutines.md — C++20 协程 11 坑速查 (症状→原因→解法)+ TaskScope/事件循环/TLS 异步集成验收补充

相关技能

把自然语言描述转为结构化 JSON,并由 mcp-diagram-generator MCP 服务生成 Draw.io、Mermaid 或 Excalidraw 图表文件。

作者 nssa.io1.0k 次安装47 星标

诊断生产力系统反复失效的根因,给出最小干预——容量测算、瓶颈定位、可靠的本地记录。

作者 Iván855 次安装69 星标

在本地磁盘以分类纯 Markdown 文件保存需要长期留存的事实,与智能体内置记忆并存。

作者 Iván559 次安装18 星标

执行 Git 操作(提交、分支、合并、变基、冲突解决与恢复)时强制套用安全规则。

作者 Iván535 次安装31 星标

以 AI 机器人身份加入视频会议,提供语音、虚拟形象与屏幕共享四种模式。

作者 johnpatternai22 次安装8 星标

dqsjqian 的更多技能

浏览全部技能

从日常 AI 对话里沉淀人格档案,本地明文 JSON 存储,同机器任意工具可读。

作者 dqsjqian32 次安装2 星标

智能体协会(agent-guild)— local-first shared memory and opt-in task handoff. 本机多个 AI agent 共享身份、规则与长期记忆;任务各有独立目录,支持 Markdown、JSON、脚本、图片与检查点。新对话不自动加载其他任务。 触发:身份/偏好、记住、回忆、加入协会、跨 agent 消息、换设备、整理协会; “我有哪些事没做完 / 待处理 / todos”只列元信息,用户选择后才恢复该任务。 实质工作保存任务检查点,验收闭环整包归档。会话隔离、版本检查防覆盖; 历史统一1GiB预算,维护先预览、确认后执行,不静默删除或上传记忆。

作者 dqsjqian

用「编写 SVG」的方式生成图片——让没有多模态生图能力的模型也能产出任意宽高比、任意复杂度的矢量图,并导出为 SVG / PNG / 动图(GIF/APNG/WebP/MP4),或内嵌进 HTML。 适用场景:用户要「生成一张图 / 画个图 / 做张配图 / 做海报 / 信息图 / 图表 / 流程图 / 架构图 / 图标 / 封面 / OG 图」,要求指定宽高比(16:9 / 1:1 / 9:16 等)或导出 PNG;也包括「做个动图 / GIF / 加载动画 / loading 动效」。 能力:① 按指令编写复杂 SVG(图表/插画/流程图/海报);② SVG→PNG 高清渲染(Chrome 优先,cairosvg/resvg 兜底);③ 多帧/模板 SVG→GIF/APNG/WebP/MP4 动图;④ 任意宽高比与 DPR。 关键词:生图、画图、SVG、矢量图、配图、海报、信息图、图表、流程图、架构图、图标、封面、OG image、转 PNG、动图、GIF、动画、loading。

作者 dqsjqian

通用「图文笔记发布」框架:把本地 markdown 文案 + 配图,通过你指定的 MCP 发布后端,一键发布为图文笔记(含 note_id 回查)。 只负责登录与发布编排,不碰内容创作;不绑定任何特定平台,后端地址由用户自己配置。 触发词:图文笔记发布、笔记发布、社交笔记发布、登录发布、发布失败重试。

作者 dqsjqian

AI 八信条(AI Eight Creed)—— 一套最高优先级的 AI 行为守则(八耻八荣)。 任何 AI agent 都应无条件遵循:以瞎猜事实为耻、以查证溯源为荣;以模糊执行为耻、 以澄清边界为荣;以擅自臆断为耻、以人类拍板为荣;以另起炉灶为耻、以沿用现成为荣; 以跳过核验为耻、以闭环自检为荣;以破坏章法为耻、以遵循规范为荣; 以假装理解为耻、以坦白无知为荣;以将错就错为耻、以正本清源为荣。 Triggers: "八耻八荣", "八信条", "AI 行为守则", "遵守守则", "查证溯源", "澄清边界", "人类拍板", "沿用现成", "闭环自检", "遵循规范", "坦白无知", "正本清源", "eight creed", "ai creed", "eight honors and shames", any request involving agent behavior rules or ethical guidelines.

作者 dqsjqian