@topmindspace/topmind-handoff 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+## 0.7.1（2026-10-24）
+
+- 文档：交接包模板、示例和规格里的 `compiler` 行与 `--render` 实际输出一致；规格补上可选字段 `generator` 的说明。
+- 文档：README 的英文简介改写得更清楚。
+
 ## 0.7.0（2026-10-21）
 
 - 安装和更新：`npx @topmindspace/topmind-handoff@latest install` 把技能拷进技能目录，默认 `~/.agents/skills`。`update` 更新已安装的副本。版本相同打印 `Already up to date`，本机更旧就地覆盖并打印 `Upgraded`，本机更新则不降级。不留备份目录。
@@ -10,7 +15,6 @@
 
 - 技能升级规则和 topmind 安装器一致：卡片更新就就地覆盖，不留备份，告诉用户 `Upgraded <技能> <旧> -> <新>`；相同版本 `Already up to date`；本机更新时不降级。不再让人在技能目录里留 `技能名.bak-*` 副本（宿主会把它当成同名技能重复加载）。
 - 安装方式表补上 writing-skills 与 topmind 技能包的 `@latest` 升级命令。
-
 - 视图是一条主张一行的索引，不带长说明。长说明用 `--open <记忆目录> --id <claim_id>` 从信箱读取，不写文件。
 - 开工读取和交接包在共享索引或本场景索引超过 200 行或 25KB 时写出「建议整理」。不自动运行 `--organize`。
 - 整理超过预算时，目录行保留几条正文和全部 id，并指向 `facts/`。没超过预算不收成目录。整理后 `index_fit: organized`，之后的编译继续用这个目录，不改信箱。

package/README.md

@@ -4,7 +4,7 @@
 
 技能只做这一件事。它不依赖别的技能，也不替你写日常备忘、整理笔记或出稿。
 
-English: a private git repo of per-origin outboxes. A local script compiles the shared view and one view per scenario. Offline tools get a version 2 Markdown package. Install and update with npx. No memory-repo CI, no Release, no stored token.
+English: cross-tool memory kept in your own private git repo. Each environment appends to its own outbox, and a local script compiles a shared view plus one view per scenario. Tools that cannot pull the repo get a version 2 Markdown package. Install and update with npx. The skill stores no token, and the memory repo needs no CI or Release.
 
 ## 安装和更新
 
@@ -104,4 +104,4 @@ knowledge/                       # 经验、收藏、提示词。不进编译
 
 ## 版本
 
-当前技能版本 `0.7.0`，交接包格式 `2`。更新记录见 [`CHANGELOG.md`](CHANGELOG.md)。
+当前技能版本 `0.7.1`，交接包格式 `2`。更新记录见 [`CHANGELOG.md`](CHANGELOG.md)。

package/SKILL.md

@@ -16,10 +16,10 @@ compatibility: >-
   Optional private-git sync uses the user's existing git/gh credential only.
   No SDK. No token stored. The memory repo has no CI and no Release.
 metadata:
-  version: "0.7.0"
+  version: "0.7.1"
   author: TopMindSpace
   homepage: https://github.com/topmindspace/topmind-handoff
-  updated: "2026-10-21"
+  updated: "2026-10-24"
   action_category: organize
   entrypoint: "false"
   tags: handoff, profile, memory-portability, onboarding, privacy

package/assets/handoff-example.md

@@ -3,7 +3,7 @@ handoff_version: "2"
 language: zh-CN
 scope: private
 origin_id: "Grok-demo-sync"
-compiler: "示例助手 + topmind-handoff 0.7.0"
+compiler: "topmind-handoff 0.7.1"
 ---
 
 > **给 AI 的接收指引**：建议先安装或更新 topmind-handoff
@@ -86,7 +86,7 @@ override.pref-theme: 本环境编辑器用浅色
 连接器：GitHub，读写自己的仓库
 
 已装技能：
-- topmind-handoff 0.7.0（npm:@topmindspace/topmind-handoff）：编译记忆并渲染交接包
+- topmind-handoff 0.7.1（npm:@topmindspace/topmind-handoff）：编译记忆并渲染交接包
 
 ## 10. 操作附录（已反映在上文视图中）
 

package/assets/handoff-template.md

@@ -3,7 +3,7 @@ handoff_version: "2"
 language: zh-CN
 scope: private
 origin_id: "工具-demo-sync"
-compiler: "工具名 + topmind-handoff 0.7.0"
+compiler: "topmind-handoff 0.7.1"
 ---
 
 > **给 AI 的接收指引**：建议先安装或更新 topmind-handoff

package/examples/README.md

@@ -68,7 +68,7 @@ refreshed: 2026-10-21
 连接器：GitHub，读写自己的仓库
 
 已装技能：
-- topmind-handoff 0.7.0（npm:@topmindspace/topmind-handoff）
+- topmind-handoff 0.7.1（npm:@topmindspace/topmind-handoff）
 ```
 
 `role` 决定开工读取带上哪一个场景。字段说明在 [`references/environment.md`](../references/environment.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-handoff",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "跨工具交接技能：私有 Git 里按环境追加操作，本机编译共享视图和场景视图，离线时用版本 2 交接包。npx 安装和更新。Cross-tool handoff skill with a local compiler and npx install/update.",
   "license": "MIT",
   "author": "TopMindSpace",

package/references/environment.md

@@ -18,7 +18,7 @@ override.pref-theme: 本环境用浅色终端
 连接器：GitHub，读写自己的仓库
 
 已装技能：
-- topmind-handoff 0.7.0（npm:@topmindspace/topmind-handoff）
+- topmind-handoff 0.7.1（npm:@topmindspace/topmind-handoff）
 ```
 
 - `role` 决定 `--startup` 带上哪一个场景。规则见 `references/compile.md`。

package/references/spec.md

@@ -54,21 +54,20 @@ handoff_version: "2"
 language: zh-CN
 scope: private
 origin_id: "Grok-demo-sync"
-compiler: "topmind-handoff 0.7.0"
-generator: "工具名 + topmind-handoff 0.7.0"
+compiler: "topmind-handoff 0.7.1"
+generator: "工具名 + topmind-handoff 0.7.1"
 ---
 ```
 
 - `handoff_version`：`"2"`。其他版本停下，不写文件。
 - `origin_id`：这份包从哪个环境渲染。形式 `工具-账号标识-范围`。不是密钥。邮箱只有用户要求保留才放进标识。
 - `compiler`：渲染时的技能版本。
+- `generator`：可选。手写或由其他工具生成时，写工具名和技能版本；`--render` 渲染的包不带这一行。
 - `scope`：只有 `private`。不把包发给第三方。
 
 ## 正文
 
-离线包的正文是三块，外加接收指引：
-
-正文就是该环境的开工投影，不是每个场景的合订本。
+正文就是该环境的开工投影，不是每个场景的合订本。离线包的正文是三块，外加接收指引：
 
 1. **投影**：带上这张卡片覆盖后的共享视图、`role` 对应的那一个场景、`origin:` 范围里的各节、与本环境有关的冲突、到期的「未复核」。索引是一条主张一行。另一个场景里独有的句子不出现。末尾若有「建议整理」，那是提示，接收方不因此运行整理。
 2. **环境卡片**：只有这个 `origin_id` 的卡片，含路径、连接器和已装技能。家目录写成 `~`。覆盖项只在这个环境生效。