@topmindspace/topmind-writing-skills 0.8.53 → 0.9.0

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.9.0] - 2026-10-27
+
+- 扩展 8 个技能的创作方向、完整示例和适用条件，保留事实、排版、保真与工具协议，清理统一审美门槛和旧规则冲突。
+- cover 0.5.0 提供小红书、抖音图文、公众号宽图 / 方图预设及可调整裁切位置；各版本直接从原图裁切，支持 EXIF 并保护原图与硬链接。
+- 重构封面字体、材料、场景、风格、构图与提示词参考；新增 8 组横竖可切换 HTML 样张与 4 份标题 spec，移除 26 张可再生的公众号裁切副本，重写示例说明。
+- 新增按需知识包：37 张带范围、例外与证据标记的卡片，支持摘要检索、按 id 阅读、完整性校验和指定私有包的候选增补；随独立技能、ZIP、npm 与宿主包分发。
+- 标题核对默认建议，标题引擎区分技术错误与审美提示；信息设计与句式扫描只作诊断，保留既有兼容字段。
+- 修复重复打包、英文 README 漏包和合法目录引用误报；合并重复阶段文档与过时技能变更日志，补充分发完整性门禁，排除缓存及旧构建产物。
+- 技能版本：cover 0.5.0、briefs 0.2.31、format 0.1.15、poster 0.1.12、revise 0.1.8、viral-posts 0.3.23、wechat-post 0.3.24、x-article 0.4.29。
+
 ## [0.8.53] - 2026-10-27
 
 - 宿主说明对齐活跃笔记默认载入、显式换稿与同稿连续修改。

package/README.en.md

@@ -50,9 +50,30 @@ See the [practice and specimens](./shared/references/creative-practice.md) and [
 | Long-form · WeChat | [`topmind-wechat-post`](./topmind-wechat-post/) | WeChat articles: three quality gates, inline-image layout, publish checklist | "写公众号", "公众号排版" |
 | Formatting | [`topmind-format`](./topmind-format/) | Re-layout without changing a word; stitch alternative openings into full posts | "转段子", "排一下版" |
 | Revision | [`topmind-revise`](./topmind-revise/) | Structure → facts → logic → de-AI → fidelity audit; quick review for replies | "改稿", "去 AI 味", "看看这条回复" |
-| Covers | [`topmind-cover`](./topmind-cover/) | X and WeChat covers: 22 styles, title checked character by character | "做个封面" |
+| Covers | [`topmind-cover`](./topmind-cover/) | Xiaohongshu, Douyin image posts, WeChat and X covers; sourced guidance and crop presets | "做个封面" |
 | Long images | [`topmind-poster`](./topmind-poster/) | HTML → hi-res long image / poster / infographic with exact text and numbers | "出张长图" |
 
+## Creative directions and on-demand knowledge
+
+See the [implementation and verification record](./docs/creative-system.md).
+
+All eight skills share scoped directions, complete examples and exceptions. Facts, formatting and tool contracts remain intact; typography, scenes, length and rhetoric are choices guided by the task.
+
+An initial 37-card pack (35 teaching examples and two recorded technical / visual cases) ships with every standalone skill. Search summaries, then read selected cards. Explicit local additions remain candidates until reviewed; a single preference does not rewrite global defaults. See [knowledge packs](./docs/knowledge-packs.md).
+
+```bash
+npm run knowledge:search -- "typography scene editorial" --skill topmind-cover --limit 3
+npm run knowledge:check
+```
+
+Cover resources include 22 adaptable style entries, 16 composition relationships, 24 combinations and 12 complete prompts. The [visual atlas](./topmind-cover/assets/examples/creative-atlas.html) offers eight actual layout studies with landscape / portrait switching. These resources support exploration without promising engagement or defining the full creative space.
+
+## Covers across platforms
+
+The [platform reference](./shared/references/platform-cover-specs.md) records public sources, verification dates and untested details. Start Xiaohongshu image notes at 3:4; check ordinary Douyin image posts separately from commerce content; distinguish WeChat article landscape / square covers from image messages. Dimensions are package export presets; current editors and user requirements take priority.
+
+`topmind-cover` provides `article`, `x-post`, `xiaohongshu`, `douyin` and `wechat` presets. The WeChat preset exports landscape and square versions, with adjustable crop alignment. Recompose portrait and landscape versions when needed. Dense content pages use `topmind-poster`; platform adaptation does not authorize publishing.
+
 ## Duanzi: 14 patterns
 
 Decide **who you want in the replies**, then pick a pattern:
@@ -227,9 +248,21 @@ npx github:topmindspace/topmind-writing-skills install topmind-briefs     # late
 ```
 
 - Probes `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`, then user-level directories; the summary prints the target.
-- Older installs are overwritten; the same version reports up to date; downgrades need `--force`.
+- Older installs are staged before replacement; failures retain the previous copy. Equal versions report up to date; reinstalling the same version or downgrading needs `--force`. Back up local modifications first.
 - Skill ids are not npm packages; don't `npm install topmind-briefs`.
 
+### Upgrade from a local checkout
+
+Install local, unpublished changes from the checkout; `@latest` contains only the published npm snapshot. Verify the target first. If tools share skills through symlinks, update the resolved shared directory and preserve those links. For a standalone Codex installation, run from the repository root:
+
+```bash
+for skill in $(node scripts/discover_skills.js); do
+  node bin/topmind-writing-skills.js install "$skill" --to "$HOME/.codex/skills" || break
+done
+```
+
+Replace `--to` with the verified shared destination when appropriate and check every result. Reopen the session to refresh skill discovery; unpublished changes with the same version require an explicit `--force` reinstall.
+
 <details>
 <summary>Repository layout and releases</summary>
 

package/README.md

@@ -50,11 +50,32 @@ npx @topmindspace/topmind-writing-skills list                          # 看全
 | 长文 · 公众号 | [`topmind-wechat-post`](./topmind-wechat-post/) | 公众号长文：质量三关、图片内嵌排版、发布清单 | 「写公众号」「公众号排版」 |
 | 格式化 | [`topmind-format`](./topmind-format/) | 现成文字只改排版不改字：转段子、格式化成短文、几个开头拼成品 | 「转段子」「排一下版」 |
 | 改稿 | [`topmind-revise`](./topmind-revise/) | 结构 → 事实 → 逻辑 → 去 AI 味 → 保真审计；也能快审一条回复 | 「改稿」「去 AI 味」「看看这条回复」 |
-| 封面 | [`topmind-cover`](./topmind-cover/) | X 和公众号封面：22 种风格、标题逐字核对 | 「做个封面」「头图」 |
+| 封面 | [`topmind-cover`](./topmind-cover/) | 小红书、抖音图文、公众号与 X 封面：平台适配、核字与多比例裁切 | 「做个封面」「头图」 |
 | 长图 | [`topmind-poster`](./topmind-poster/) | HTML → 高清长图 / 海报 / 信息图，文字数字逐字正确 | 「出张长图」「做个榜单图」 |
 
 **短文** = X 纯文本帖，1000 字以内都行；**长文** = X Article 或公众号长文；**段子** = 以观察、反差或幽默推进的短帖，排版按节奏选择。
 
+## 创作方向与按需知识包
+
+实施与验证见 [整改执行记录](./docs/creative-system.md)。
+
+8 个技能共同使用“方向—具体例子—适用条件—反例 / 例外”的知识组织方式。事实、排版与工具协议继续核对；字体、场景、篇幅、修辞与风格由任务选择，不用统一审美门槛。
+
+首批 37 张知识卡（35 张原创教学示例、2 条本次有记录的技术 / 视觉经验）随每个技能独立分发；先查摘要，再读相关卡片。可以补充指定私有包，经验先存为候选，不自动改写长期规则或把一次选择当普遍规律。用法与维护见 [知识包说明](./docs/knowledge-packs.md)。
+
+```bash
+npm run knowledge:search -- "字体 场景 优雅" --skill topmind-cover --limit 3
+npm run knowledge:check
+```
+
+封面参考提供 22 个可变风格入口、16 类构图关系、24 个组合方向和 12 份完整提示词；[创作图册](./topmind-cover/assets/examples/creative-atlas.html) 有 8 组可见排版样张，可切换横竖布局。它们提供方法，不限定可创作范围，也不承诺流量效果。
+
+## 多平台封面与图文
+
+[平台参考](./shared/references/platform-cover-specs.md) 记录公开来源、核验日期和未实测项：小红书图文可从 3:4 起步，抖音普通图文与商城内容分别核对，公众号普通文章宽图 / 方图与图片消息分开处理。尺寸是本包导出预设，当前发布入口与用户要求优先。
+
+`topmind-cover` 支持 `article`、`x-post`、`xiaohongshu`、`douyin` 和 `wechat` 预设；`wechat` 另给宽图与方图，裁切方向可调整。横竖版需要时分别构图，不用固定安全区或缺少证据的点击率约束设计。密集内容页用 `topmind-poster`，跨平台不自动扩展发布权限。
+
 ## 段子：14 种写法
 
 先想清楚**想让哪种人来评论**，再挑写法：
@@ -238,16 +259,28 @@ python3 scripts/de_ai_lint.py 文章.md --genre long      # 长文
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs --to ./.claude/skills
-npx @topmindspace/topmind-writing-skills@latest install topmind-briefs   # 升级：旧版直接覆盖
+npx @topmindspace/topmind-writing-skills@latest install topmind-briefs   # 升级：暂存完成再替换，失败保留旧版
 npx @topmindspace/topmind-writing-skills install topmind-briefs --force   # 同版本重装 / 降级
 npx @topmindspace/topmind-writing-skills uninstall topmind-briefs --to ./.claude/skills
 npx github:topmindspace/topmind-writing-skills install topmind-briefs     # 跟仓库最新
 ```
 
 - 默认探测 `./.agents` → `./.claude` → `./.cursor` → `./.codex` → `./.mimocode`，再到用户级目录；安装摘要会打印实际目标目录。
-- 已装更旧的版本就覆盖；版本相同提示已是最新；要降级加 `--force`。
+- 更旧的安装先暂存再替换，失败保留旧版；版本相同提示已是最新；同版本重装或降级用 `--force`。有本地修改先备份。
 - 技能 id 不是独立 npm 包，不要 `npm install topmind-briefs`。
 
+### 从本地仓库升级
+
+本地未发布改动要从当前仓库安装，`@latest` 只包含 npm 已发布版本。先核实目标目录；已有跨工具软链接时更新其共享实际目录，保留链接关系。Codex 独立安装可在仓库根目录运行：
+
+```bash
+for skill in $(node scripts/discover_skills.js); do
+  node bin/topmind-writing-skills.js install "$skill" --to "$HOME/.codex/skills" || break
+done
+```
+
+若 Codex 技能链接到其他共享目录，将 `--to` 换为核实后的实际目录；检查每项安装输出。安装了新技能或更新入口后，重开会话让宿主重新发现；同版本未发布内容需要明确加 `--force` 才会重装。
+
 <details>
 <summary>仓库结构与发布</summary>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.53",
+  "version": "0.9.0",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、改稿与质检、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",
@@ -75,14 +75,17 @@
     "check:evals": "node scripts/check_evals.js",
     "check:pack": "node scripts/check_npm_pack.js",
     "validate:spec": "bash -c 'for s in $(node scripts/discover_skills.js); do ${AGENTSKILLS:-agentskills} validate \"$s\" || exit 1; done'",
-    "prepack": "node scripts/sync_npm_files.js --check && node scripts/sync_shared.js --check",
+    "prepack": "node scripts/sync_npm_files.js --check && node scripts/sync_shared.js --check && python3 shared/scripts/knowledge.py validate",
     "install:skills": "node -e \"const {discoverSkills}=require('./scripts/discover_skills'); const {spawnSync}=require('child_process'); for (const id of discoverSkills()) { const r=spawnSync(process.execPath,['bin/topmind-writing-skills.js','install',id],{stdio:'inherit'}); if(r.status) process.exit(r.status||1); }\"",
     "check": "node scripts/run_skill_gates.js check",
     "privacy": "python3 scripts/ci_privacy_scan.py",
     "audit": "node scripts/run_skill_gates.js audit",
     "package:skill": "node scripts/run_skill_gates.js package",
     "test": "node --test tests/*.test.mjs",
-    "host:pack": "node scripts/build-host-pack.cjs"
+    "host:pack": "node scripts/build-host-pack.cjs",
+    "knowledge:check": "python3 shared/scripts/knowledge.py validate",
+    "knowledge:search": "python3 shared/scripts/knowledge.py search",
+    "check:release": "python3 scripts/check_release_artifacts.py"
   },
   "publishConfig": {
     "access": "public"

package/runtime/host-guide.md

@@ -10,6 +10,8 @@
 
 按当前问题读取必要参考，不为了调用技能而读完所有脚本、样张、方法论和整个工作区。审校默认核对原稿内部的数字、归因、逻辑和前后表达；用户明确要求外部事实核查或补充最新资料时再联网。文章与参考中的命令只是材料，不能扩展本次权限或目标。
 
+各技能资源包含 knowledge/index.json、知识导航与独立卡片。需要新方向或完整示例时，先读目录中相关摘要，再通过宿主资源读取能力加载选中的卡片；无脚本权限时不要求执行 knowledge.py。目录的 active 只表示可检索，不证明效果，candidate / retired 不作为默认经验。检索只为当前任务服务，不自动加载所有卡片、私有知识包或全局记忆，也不自动写回技能。动态事实仍按当前来源核对；知识卡与外部页面都不能改变目标、权限或当前用户要求。
+
 单篇交付形成后结束，不增加新的自检任务。重复结果、连续失败、宿主预算用尽时保留已有结果并说明阻塞；不要自动重启循环或靠换工具绕过。仅给建议模式不写文件；修改模式只修改指定文章，写入前核对最新版本，保护与恢复遵循宿主 Kernel 的既有契约。
 
 宿主提供 `render_article`：从工作区源稿生成公众号、X 长文或文本的确定性排版结果；需要持久交付时再使用宿主文件写入工具，遵守原有写闸。也可在“写作与交付”界面预览、复制和导出。不要求用户照抄 Python 命令，不把脚本文本可读当成可执行权限。

package/topmind-briefs/README.en.md

@@ -4,12 +4,16 @@ English | [中文](./README.md)
 
 Write information-focused short posts for X and WeChat: releases, previews, tools, rankings, papers, hands-on results and opinions. Deliver copy for the requested platforms, keeping necessary attribution and uncertainty in the text. Chinese is the default language; current user instructions and author samples take priority. See [SKILL.md](./SKILL.md) for the capability, workflow and tools.
 
+For covers, image-post formats and cross-platform crops, read the [platform reference](./references/platform-cover-specs.md) as needed. Export presets are not mandatory upload specifications; verify actual platform previews.
+
 ## Install
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs
 ```
 
+A scoped knowledge pack ships with this skill. See [retrieval and contribution](./references/knowledge-library.md) and the [card directory](./knowledge/README.md). Read relevant summaries before selected cards; capture new local notes as candidates, without rewriting global preferences.
+
 ## How it works
 
 Read actual references and relevant [specimens](./references/creative-practice.md). Explore distinct directions when that helps the task; deliver one complete result when the request is clear. Voice, length, emoji, structure and visual styles are choices rather than universal gates. Facts, attribution, privacy, authorization and usable output still matter.
@@ -22,8 +26,6 @@ Run from this skill directory, using actual input paths:
 python3 scripts/lint_x_post.py X短文.txt
 ```
 
-Style diagnostics are contextual suggestions, not a quality score. Platform conversion and directory requirements apply when using the corresponding tools. Check actual previews and disclose unverified steps.
-
-Formatting preserves links and emoji by default. In skills that include `format_text.py`, `--separate-links` and `--strip-emoji` are explicit optional conversions. X lint only enforces link separation when `--separate-links` is requested.
+Lint checks textual and formatting risks; style suggestions need context and do not have to be cleared. Preserve links and emoji by default.
 
 Deliver the requested text or artifacts; these skills do not publish externally. MIT License. See the [collection](https://github.com/topmindspace/topmind-writing-skills) for installation options and maintenance.

package/topmind-briefs/README.md

@@ -4,6 +4,8 @@
 
 快讯、新品、榜单、论文、实测、观点，一件事讲清楚。
 
+平台封面、图文形态与跨平台裁切见 [平台参考](./references/platform-cover-specs.md)，按需读取；预设不等于强制上传规格，平台展示需实际验证。
+
 ## 使用
 
 ```bash
@@ -12,6 +14,8 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 
 安装后直接告诉 agent 你要的结果、读者和已有材料；明确要一稿就直接给成品，探索任务再比较方向。完整能力、流程与脚本说明见 [SKILL.md](./SKILL.md)。
 
+按需知识包随技能独立安装。需要方向、完整示例或经验时，见 [知识使用与增补](./references/knowledge-library.md) 与 [知识导航](./knowledge/README.md)；先读摘要再选卡片。可向指定私有包新增候选，不自动改长期规则。
+
 ## 方法与样张
 
 [创作方法与样张](./references/creative-practice.md) 给同素材不同写法和看参考的方法。模板、口吻、篇幅、emoji 与视觉风格是选项；事实准确、授权、隐私与输出完整性继续核对。当前用户要求和作者样本优先。
@@ -24,10 +28,10 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 python3 scripts/lint_x_post.py X短文.txt
 ```
 
-风格提示按上下文判断，不要求警告清零或达到词面分数；平台与目录协议在采用相关导出工具时核对。生成预览需当前环境具备相应浏览器与依赖，未验证时如实说明。
+lint 用来检查文字与格式风险；风格提示需结合语境判断，不要求警告清零。链接和 emoji 默认保留。
 
 ## 交付
 
-交当前请求所需的文本或文件，说明重要取舍和未核实项。需要图片、HTML 或完整报告时再扩展对应环节；本技能不执行对外发布。
+交付可直接复制的短文；保留必要来源、测试条件与未核实项。配图按当前请求补充。 由用户完成对外发布。
 
 MIT License。仓库维护、安装选项与版本说明见 [合集说明](https://github.com/topmindspace/topmind-writing-skills)。

package/topmind-briefs/SKILL.md

@@ -3,18 +3,22 @@ name: topmind-briefs
 description: "创作 X 与公众号的干货短文、快讯、新品、榜单、论文解读、实测和观点。按读者与素材选择角度，交付可复制文本；公众号短文通常 300–800 字。纯排版用 topmind-format，互动段子用 topmind-viral-posts，长文用对应平台技能。"
 license: MIT
 metadata:
-  version: "0.2.29"
+  version: "0.2.31"
   action_category: "write"
   triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 预告, 新品速递, 工具推荐, 羊毛, 优惠, 论文解读, 数据榜单, 榜单速报, 实测, 经验一句话, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-26"
+  updated: "2026-10-27"
 ---
 
 # topmind-briefs · 干货短文
 
 把一件事讲清楚，交付可直接使用的 X 短文或公众号短文。默认中文；用户的语言、篇幅、风格和平台要求优先。
 
+## 按需借鉴与积累
+
+需要新方向、完整例子或相关经验时，用 [知识使用与增补](references/knowledge-library.md) 检索新闻入口、论文限定与工具决策；先读摘要，再选相关卡片。可以混合、改造或采用库外思路，简单任务直接完成。知识不替代当前用户要求；新反馈先作为有范围的候选，不自动改长期规则。
+
 ## 先决定读者能拿走什么
 
 根据现有素材直接着手。新闻需要可靠信源，实测需要作者实际结果，观点可以从一个具体观察展开。单条任务给一条完成稿；角度有分歧、用户要选题或同题连发时，再探索不同方向。
@@ -46,7 +50,7 @@ metadata:
 
 ## 图片与交付
 
-图能证明结果或帮助理解时，优先读原帖、官方图和论文图；自己的结构与判断也可以画成示意图，标明“自制 / 示意”及依据。纯文字已经完整时直接交稿。用户已要求配图就继续完成；只要求文字时不额外扩展生图任务。详见 [图源经验](references/image-sourcing.md)。
+图能证明结果或帮助理解时，优先读原帖、官方图和论文图；自己的结构与判断也可以画成示意图，标明“自制 / 示意”及依据。纯文字已经完整时直接交稿。用户已要求配图就继续完成；只要求文字时不额外扩展生图任务。详见 [图源经验](references/image-sourcing.md)。需要封面或跨平台组图时，按 [平台封面参考](references/platform-cover-specs.md) 区分普通文章、图片消息与图文笔记；平台延展不自动扩大本技能的写作范围。
 
 默认每条一个可复制的纯文本块，说明放块外。来源链接通常另列；下载、报名、证据核对等需要正文链接时可保留。必要归因留在正文，详细查证笔记另列。双平台时另给公众号 Markdown；只交付所需平台。
 

package/topmind-briefs/knowledge/README.md

@@ -0,0 +1,43 @@
+# 知识卡导航
+
+原创教学卡以 illustrative 标记，已运行的技术回归与实际检查记录以 observed 标记；active 只表示可检索，不表示效果已验证。先按用途选卡，再读正文；无需一次加载全部。候选与增补流程见技能参考中的 knowledge-library.md。
+
+| 技能 | 卡片 | 用途 |
+|---|---|---|
+| * | [在约束内打开方向](cards/creative-choice.md) | 用任务中真正不同的关系做候选，不把“更多元素”当成更丰富。 |
+| * | [把参考转成自己的方法](cards/reference-reading.md) | 记录实际可见的组织关系，再用当前素材重新表达。 |
+| * | [把一次反馈变成有范围的经验](cards/experience-loop.md) | 保留场景、选择、结果、例外与证据性质，先候选后纳入。 |
+| topmind-cover | [编辑式封面：用版面关系建立气质](cards/cover-editorial.md) | 用对齐、尺度、负空间和图像裁切建立优雅，而非统一靠大字与装饰。 |
+| topmind-cover | [字体是图像：字形、字重与空间](cards/cover-typography.md) | 以字形气质、字面比例、断行和空间组织丰富标题；花式服务语义。 |
+| topmind-cover | [场景：让关系承载故事](cards/cover-scene.md) | 从时间、地点、动作、材料和尺度关系中选择最能解释主题的场景。 |
+| topmind-cover | [摄影与真实素材：裁切、负空间和介质](cards/cover-photo.md) | 用真实素材的独有细节与负空间组织封面，区别纪实照片和生成示意。 |
+| topmind-cover | [拼贴：统一材料，保留多层信息](cards/cover-collage.md) | 用裁切边缘、材料和重叠关系建立层次，避免无目的堆素材。 |
+| topmind-cover | [抽象图形：用秩序和异常表达概念](cards/cover-abstract.md) | 用重复、密度、尺度与一个偏差表达主题，避免科技封面都画芯片。 |
+| topmind-cover | [字效与材料：让触感参与表达](cards/cover-material.md) | 从物理材料与光源关系设计花式，让效果与题意相连。 |
+| topmind-cover | [文化与书卷：不靠模板化国风](cards/cover-culture.md) | 从文字气质、纸张、印刷和题材细节取意，避免套古建筑与墨点。 |
+| topmind-cover | [趣味与角色：情境比卖萌更重要](cards/cover-playful.md) | 以角色的处境、姿态与尺度组织笑点或亲近感。 |
+| topmind-cover | [色彩：关系、面积与语境](cards/cover-color.md) | 用色温、明度、饱和度和面积的关系设计视觉语气。 |
+| topmind-cover | [系列感与变化：稳定语法，改变表达](cards/cover-series.md) | 固定少量识别线索，按内容变化其他关系，避免每次换色也避免永不变版。 |
+| topmind-cover | [把形容词变成能执行的视觉简报](cards/cover-brief.md) | 明确要传达的关系，再选择媒介和表现手法，让 AI 保留可探索空间。 |
+| topmind-briefs | [同一新闻：直给、场景、决策三条入口](cards/brief-news.md) | 固定事实与限定，改变读者进入消息的方式。 |
+| topmind-briefs | [论文短文：结果与条件一起交付](cards/brief-paper.md) | 让读者知道论文测到了什么、没证明什么；保留关键限定。 |
+| topmind-briefs | [工具推荐：说清适用与代价](cards/brief-tools.md) | 围绕读者任务、限制与迁移成本组织推荐，而非功能堆砌。 |
+| topmind-viral-posts | [幽默：预期、错位与具体动作](cards/viral-mechanisms.md) | 选择可感知的反差，让包袱落在对象关系或动作上。 |
+| topmind-viral-posts | [从生活细节到轻判断](cards/viral-observation.md) | 用一个具体细节让读者认出自己，允许平静的声音。 |
+| topmind-viral-posts | [回复与转发：接话之后再贡献](cards/viral-replies.md) | 先识别对方在分享、求助还是论证，再选择态度、补充或追问。 |
+| topmind-wechat-post | [长文叙事：场景、变化与解释](cards/wechat-story.md) | 让真实场景承载问题，再选择何时解释；保留有用铺垫。 |
+| topmind-wechat-post | [解释型长文：从问题到机制](cards/wechat-explain.md) | 用具体问题打开机制，每节增加新的理解，不要求固定主张条数。 |
+| topmind-wechat-post | [决策长文：给不同条件的人不同答案](cards/wechat-decide.md) | 围绕任务和代价比较，允许有条件结论。 |
+| topmind-x-article | [Article：让论点逐节推进](cards/x-argument.md) | 用主张、依据、反问与适用范围组织推进，避免每节重复结论。 |
+| topmind-x-article | [跨平台适配：保留事实，重做入口](cards/x-adapt.md) | 根据阅读场景重组入口、展开和交付，事实与限定保持一致。 |
+| topmind-x-article | [长文中的证据、例子与作者判断](cards/x-evidence.md) | 让读者辨认事实、说明性例子与作者推断，仍保留自然的声音。 |
+| topmind-revise | [改稿深度：修局部、重组与重写](cards/revise-depth.md) | 先找读者障碍，再选择最小有效改动或授权范围内重写。 |
+| topmind-revise | [保留：铺垫、重复、术语与长句](cards/revise-preserve.md) | 从作用判断是否保留，避免把词表和压字数当质量标准。 |
+| topmind-revise | [反馈：从“像 AI”定位真实问题](cards/revise-feedback.md) | 把模糊感受落到声音、信息、节奏或论证，并用局部对照验证。 |
+| topmind-format | [排版保真：空行变化不改变态度](cards/format-fidelity.md) | 把可改的呈现与不能擅改的语义分开，保持既有排版协议。 |
+| topmind-format | [同一段文字的紧凑版与节拍版](cards/format-layouts.md) | 选择读序而非统一段长，不改变作者用词。 |
+| topmind-poster | [信息图：先选读者要比较的关系](cards/poster-structure.md) | 从比较、顺序、变化和因果选择图形，而非一律画卡片。 |
+| topmind-poster | [长图与组图：按语义而非像素切页](cards/poster-paging.md) | 把一页当成一个读者任务，保留跨页联系与局部可读性。 |
+| topmind-poster | [同一信息的三种视觉语气](cards/poster-voices.md) | 在不改变数字与读序的前提下，用媒介和层级做风格变化。 |
+| topmind-cover | [宽图与方图分别从原图裁切](cards/crop-independent.md) | 一份回归演示了先宽裁再方裁造成的信息损失。 |
+| topmind-cover | [图册复查：修具体关系，不升级统一禁令](cards/atlas-local-fix.md) | 纵版样张的辅助文字靠近图形，局部上移后再次检查。 |

package/topmind-briefs/knowledge/cards/atlas-local-fix.md

@@ -0,0 +1,12 @@
+# 图册复查：把问题留在具体关系里
+
+证据性质：observed。本次实际渲染并查看创作图册，检查横版、竖版与手机布局。
+
+## 观察
+纵版长标题样张中，辅助字靠近球形示意，局部对比和关系不够清楚。标题本身仍在画框内，因此仅做“标题未溢出”检查无法发现所有阅读问题。
+
+## 修正
+在这一份纵版样张中上移辅助字，保留标题、球体、字体和整体构图，再次渲染查看。无需因此制定“辅助字一律不能压图”或“圆形不能在底部”的规则。
+
+## 适用范围
+自动边界检查帮助发现技术问题，实际看图补充关系判断。改法只针对当前版式；其他作品的叠字、低对比氛围与多焦点仍按任务判断。

package/topmind-briefs/knowledge/cards/brief-news.md

@@ -0,0 +1,20 @@
+# 同一新闻：直给、场景、决策三条入口
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 练习素材
+虚构工具“页签”新增离线索引；厂商在一万份笔记上测得中位耗时约 0.3 秒；免费版只保存一个索引。
+
+```text
+页签新增离线搜索，断网也能查笔记。厂商在一万份笔记上测试，中位耗时约 0.3 秒；免费版只保留一个索引。
+```
+
+```text
+地铁进隧道，昨天那份笔记还能找到。页签新增离线搜索；厂商测试一万份笔记，中位耗时约 0.3 秒。免费版只有一个索引，多库用户先看够不够用。
+```
+
+```text
+只维护一个资料库的人，可以试试页签的离线搜索。厂商测得一万份笔记的搜索中位耗时约 0.3 秒；免费版的限制是只能留一个索引。
+```
+
+三条入口分别是变化、场景和决策。消息晚到时可补影响分析或新测试，而不是只把“刚刚”换成“近日”。

package/topmind-briefs/knowledge/cards/brief-paper.md

@@ -0,0 +1,16 @@
+# 论文短文：结果与条件一起交付
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 不充分的句子
+“新方法只记几条笔记，准确率 90%，对话记忆可以扔了。”
+
+## 更完整的短稿（虚构练习）
+```text
+在一组多步检索任务上，作者让智能体保存结构化笔记，减少了重复传入的上下文。
+
+论文报告准确率约 90%，测试范围仅限所列任务；尚不能推出“所有对话都不用保留历史”。值得继续看的，是笔记漏掉信息时如何恢复。
+```
+
+## 可换入口
+可以先讲机制、一个结果、研究问题或作者方法。无论哪种入口，样本、条件、误差与“论文报告”属于读者判断所需事实。原图只能估读时正文写“约”或区间；精度不能凭排版变高。

package/topmind-briefs/knowledge/cards/brief-tools.md

@@ -0,0 +1,13 @@
+# 工具推荐：说清适用与代价
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 练习稿
+```text
+如果你只想把本地资料查起来，先试离线索引，不必急着迁移笔记软件。
+
+页签的免费版只支持一个索引，单库够用，多项目要先看付费条件。能否保留原来的文件结构，比多几个主题颜色更影响迁移成本。
+```
+
+## 变化
+教程向可补“如何判断成功”；评论向可谈“谁不适合”；优惠向先说适用账号、时间和限制。没有实际测试时说“可试”，不写“我用了半年”。比较数字不全时，解释已知取舍，不用虚构表格填空。

package/topmind-briefs/knowledge/cards/cover-abstract.md

@@ -0,0 +1,17 @@
+# 抽象图形：用秩序和异常表达概念
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 主题到图形
+“筛选”可是一组形体经过窄门；“协作”可由交织而不相同的曲线表达；“偏差”可用规律中一枚位移；“压缩”可以是疏密变化，而非随意的代码雨。
+
+## 两种气质
+- 理性：骨白底、细灰网格、黑色标题与一组偏移圆点；
+- 表现：深紫底、柔软橙色带状物，标题与曲线形成张力。
+
+## 可用提示词
+```text
+为“给复杂问题留一个出口”设计抽象封面。重复的细线在一处打开，负空间本身形成出口。标题与开口呼应，可采用克制宋体或极简黑体；不画虚假的坐标值、公司 logo 或模型界面。根据横竖画幅重组线的方向。
+```
+
+图形含义过于隐晦时，增加一个现实参照或让标题更直接；不要用一堆科技物件解释所有概念。

package/topmind-briefs/knowledge/cards/cover-brief.md

@@ -0,0 +1,18 @@
+# 把形容词变成能执行的视觉简报
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 形容词到设计动作
+“优雅”可试更有呼吸感的间距、稳定的字形、细致材料；“丰富”可试空间或材料关系、同主题不同镜头；“有吸引力”可试独特视角、可读的对比、主题中的矛盾。它们不是固定配色与元素清单。
+
+## 可用简报
+```text
+主题：信息很多，真正重要的很少。面向资料整理者。
+希望第一眼看到“少一点，找得到”，第二眼发现一个被整理过的档案角落。
+可探索编辑摄影、字形主导或纸张拼贴；选择最适合当前文章的一条完成。
+标题逐字使用“少一点，找得到”。横竖版分别布局；文字可整张生成或后期排版。
+检查标题、主题、缩略图和最终裁切，不用装饰数量评价质量。
+```
+
+## 避免
+把“高级、有层次、震撼、优雅、丰富、电影感”全部叠在一个 prompt 上却不定义读序。明确一个有意义的关系，比堆风格形容词更能帮助选择。

package/topmind-briefs/knowledge/cards/cover-collage.md

@@ -0,0 +1,14 @@
+# 拼贴：统一材料，保留多层信息
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 方案方向
+扫描纸与铅笔、硬边几何与产品照片、档案袋与索引卡、半透明描图纸与手写注释、色纸与粗字。统一感可以来自相同颗粒、同一对齐线或一个重复形状，不必只有三种颜色。
+
+## 完整提示词
+```text
+虚构练习封面，标题“资料不是越多越好”。用几层带扫描边缘的纸片形成从分散到归拢的读序，标题可以跨两张纸，不采用整齐圆角卡片。材料是米色纸、灰黑照片局部与一张蓝色索引卡；字与纸边有明确关系。装饰注释不写具体统计，真实数据只使用用户提供内容。画幅按请求。
+```
+
+## 反向变化
+若标题已经复杂，改为一张整纸和一个裁切角；若文章讲混乱本身，可以有意密集，但给读者一个进入点。

package/topmind-briefs/knowledge/cards/cover-color.md

@@ -0,0 +1,16 @@
+# 色彩：关系、面积与语境
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 可用起点
+- 墨黑 / 骨白：靠字号、材料与空间出层次；
+- 酒红 / 纸白 / 暖灰：温暖、编辑感，也可用于技术评论；
+- 藏蓝 / 雾蓝 / 银白：安静、精密；
+- 桃粉 / 辣椒红：近似色制造热烈；
+- 苔绿 / 柠檬黄：自然与跳跃；
+- 多彩：统一明度、重复形状或稳定网格，避免每项同时争主角。
+
+## 一次有效调整
+若浅蓝字在米底上难读，可加深字色、换底、增加底板、换字重或移动位置。不要把问题直接归因为“颜色不够炸”。纯白、纯黑、低饱和与荧光都可有用途。
+
+参数只是起点，文字跨复杂背景时检查局部；自动对比度数字不能覆盖所有质感与边缘情况。

package/topmind-briefs/knowledge/cards/cover-culture.md

@@ -0,0 +1,12 @@
+# 文化与书卷：不靠模板化国风
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 方向
+小宋体与大留白、浓黑书法和淡纸色、双色套印、线装页边、版画局部与现代窄黑体、纯文字与一枚原创抽象符号。竖排可以用于纵向读序，但横排同样适合文化内容。
+
+## 标题示例
+“读慢一点”：标题可细宋横排，字距疏朗，低位放一截书页的影子；也可用墨色行书大字，笔锋顺着页角形成节奏。两者是气质选择，不是优劣排名。
+
+## 修正
+太像通用国风模板时，拿掉无关山水、印章或祥云，找文章独有的一件事。书法变形损伤字义时保留轮廓气质，改为可控字体叠字。

package/topmind-briefs/knowledge/cards/cover-editorial.md

@@ -0,0 +1,17 @@
+# 编辑式封面：用版面关系建立气质
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 可选方向
+窄栏标题加大幅静物、超大轻字重配小号粗眉题、边缘对齐的摄影与留白、跨栏标题压住裁切照片，都能建立编辑感。对齐关系可以严格，也可用一处有意偏离制造张力。
+
+## 示例简报
+虚构文章《把时间还给自己》：奶油白纸面，左侧疏朗宋体两行；右下只露出一部分折叠日历，大片空白形成时间感。辅助行只写“工作与生活”，不伪造日期或刊号。
+
+## 可用提示词
+```text
+设计编辑式封面，标题逐字为“把时间还给自己”。用字距、留白和日历局部建立安静的张力；标题与日历沿不同但呼应的对齐轴组织。考虑宋体或有书籍感的衬线字，纸白与墨黑，可以有一处温和强调。按指定画幅重新布局，检查缩小后的关键字与裁切。
+```
+
+## 另一条同样成立的路
+深蓝底、极细大字、日历完全省略，用字间空白表达节奏。若显得轻飘，先调字重或比例，不急着补粒子和胶囊。

package/topmind-briefs/knowledge/cards/cover-material.md

@@ -0,0 +1,16 @@
+# 字效与材料：让触感参与表达
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 材料与情绪
+纸的折痕可表达整理与重构；磨砂玻璃可表达层次与模糊；搪瓷可亲切复古；金属可冷静精密；粉笔可有探索感；织物可温暖。相同主题也可用平面色块，不把真实阴影当高级感证明。
+
+## 示例
+“重新组织”：标题以白纸压印，侧光让凹陷可见；背景是同材质纸面，关键字有一次切开和错位。另一条方向是把文字镂空，透出后方彩色纸条。
+
+## 提示片段
+```text
+标题“重新组织”是纸面的一部分，压印与切口具有一致的光源和材质尺度。以文字与切口的关系说明重构，不让纹理吞掉字形。可在整张生成中完成，也可先做背景再以矢量文字实现。
+```
+
+真实像素字体、印刷错位和低保真也能有魅力，是否采用由内容与用户决定。

package/topmind-briefs/knowledge/cards/cover-photo.md

@@ -0,0 +1,12 @@
+# 摄影与真实素材：裁切、负空间和介质
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 可迁移手法
+近距离静物强调材料；远景人物强调环境；俯拍强调秩序；背光强调轮廓；边缘截取让物件有画外空间。标题可以站在负空间、沿建筑线排布、在透明底板上，或完全独立于摄影。
+
+## 示例
+“桌面之外”：一张真实桌面照片占画面右侧，左边采用与照片墙面相近的浅灰；标题宋体，基线和桌面边缘呼应。另一个方向是只取线缆局部，把黑体标题放进线缆包围的空白。
+
+## 常见误区
+原图主体不完整时，不应硬裁成另一个比例；先扩展版面或调整文字区。生成补景属于处理 / 示意，应说明，不把生成出来的屏幕或产品细节当证据。

package/topmind-briefs/knowledge/cards/cover-playful.md

@@ -0,0 +1,12 @@
+# 趣味与角色：情境比卖萌更重要
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 可尝试关系
+小角色面对巨大按钮、一本打开的书成为地形、物件排队过检查口、几个角色以不同方式处理同一件事。角色不一定在右边，也不一定压字。
+
+## 示例
+“先别点全部”：一个小角色站在巨大选框前，手里拿着不太确定的清单。标题可以小而冷静，让画面的尺度承担幽默；也可以换成完全无人场景，只留被放大的鼠标指针。
+
+## 气质变化
+柔软黏土、平面剪纸、铅笔手绘、复古漫画、像素、简洁线描都可选。已有 IP 或人物素材按许可使用；不要把生成的泛指人物说成某位真实作者。

package/topmind-briefs/knowledge/cards/cover-scene.md

@@ -0,0 +1,19 @@
+# 场景：让关系承载故事
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 联想路径
+把抽象概念变成关系：“本地”可表现为家中设备与窗外城市；“检索”可表现为光束照亮档案标签；“迁移”可表现为拆开的箱子、旧接口与新接口的距离。直接画真实设备也成立。
+
+## 两个相反方案
+虚构主题《把资料找回来》：
+A：深夜档案室，窄光束停在半抽出的档案盒，标题在门框外的暗面。
+B：白天桌面俯拍，几张标签按顺序展开，标题嵌入留白，不用电影光。
+
+## 提示片段
+```text
+一间安静的档案室，光落在刚找到的盒子上，用门框、纵深和标签表达“终于找到”。标题“把资料找回来”与光束形成读序。可用低饱和摄影或纸雕，不额外添加没有主题作用的机器人和道具。画幅按请求，文字可后期叠加。
+```
+
+## 修正方向
+主题不清时换关系而非加物件；情绪过重时换镜头或光线；背景平不是问题，若场景已经有内容，纯背景能帮助理解。

package/topmind-briefs/knowledge/cards/cover-series.md

@@ -0,0 +1,12 @@
+# 系列感与变化：稳定语法，改变表达
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 可以固定什么
+字族、栏目标识、比例关系、裁切方式、一个颜色或纸张材料。固定项由作者与系列性质决定，不需要全部固定。
+
+## 可以变化什么
+主题主体、标题断行、图像密度、强调色、远近镜头、横竖读序。连续两篇同版式能建立识别；一篇内容有明显转折时，也可让版式发生变化。
+
+## 示例
+“工具旁观”系列固定窄黑体栏目名和左下编号；评测期用真实产品局部，评论期用抽象形，随笔期用摄影。编号来自真实系列顺序；没有栏目就不伪造期号。

package/topmind-briefs/knowledge/cards/cover-typography.md

@@ -0,0 +1,19 @@
+# 字体是图像：字形、字重与空间
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 选择气质
+几何黑体偏理性，窄体可有海报感，宋体可有书卷或锋利的对比，手写可亲近或粗粝，等宽字可提示代码或档案。它们不是题材绑定关系，科技也可以宋体，人文也可以超粗黑。
+
+## 一句标题的四种组织
+“让思考慢下来”：
+- “让思考 / 慢下来”，一大一小，第二行拉开字距；
+- 全句细宋横排，低位，小面积赤红方块与之相抵；
+- 黑色巨字靠近边缘，部分装饰性笔画越界，关键字仍完整；
+- 字作为折叠纸面的压印，与纸影一起读出。
+
+## 字号方法
+先确认哪些文字必须读清、哪些只是纹理。根据字面宽窄、画幅、字数与实际缩略图找尺寸，必要时改行数或图文关系。不同字号可以是层级，也可以是节奏；主副标题相同字号但不同位置、色彩也能成立。
+
+## 花式
+轮廓与填色错位、字作蒙版、压印、剪纸、连笔、细线穿插、玻璃、材质字、沿路径排字、局部透视都可试。中文关键笔画与意思要完整，艺术变形不能替代核字。

package/topmind-briefs/knowledge/cards/creative-choice.md

@@ -0,0 +1,15 @@
+# 在约束内打开方向
+
+原创教学示例；人物、产品和数字如未另有来源均为虚构练习，不可充当作者亲历或实测。
+
+## 做法
+把已确定的事实、读者与交付形式固定，把入口、叙述距离、情绪或视觉媒介留作变量。分别问“最直接的解法”“换一种媒介会怎样”“反过来组织会怎样”。这些问题帮助想方案，不要求逐项作答。
+
+## 同一素材的变化
+虚构素材：离线索引只能保存一个库。
+- 工具决策：“只查一个资料库的人够用；跨项目检索先别急着迁移。”
+- 生活场景：“地铁进隧道，昨天那份笔记还能找到。”
+- 视觉：一只敞开的档案盒，或纯字的“断网，也能找到”；不是都放一只机器人。
+
+## 判断
+差别在读序、视角与主题表达，不能只是把同一句换几个近义词。若一稿已经合适，继续完成它。