@hi-man/himan 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -6,6 +6,13 @@ The format is based on Keep a Changelog, and this project follows semver for the
 
 ## [Unreleased]
 
+## [0.3.5] - 2026-05-12
+
+### Changed
+
+- Changed the CLI version shortcut from `-V` to `-v`; `--version` remains supported.
+- Changed the default install mode to `copy`; pass `--mode link` to install resources as symlinks.
+
 ## [0.3.4] - 2026-05-11
 
 ### Changed

package/README.md

@@ -66,7 +66,7 @@ himan publish rule my-rule --patch
   - `command` -> `.himan/dev/command/<name>`
   - `skill` -> `.himan/dev/skill/<name>`
 - lock 文件：项目安装 `install <type> <name[@version]>` 会写入 `himan.lock`，记录 source、精确版本、agent 和安装模式；`himan install`（无参数）会按 lock 记录的 source 批量恢复安装，不受当前 default source 切换影响。`--global` 安装不写当前项目的 `himan.lock`。
-- 安装模式：默认 `--mode link` 使用软链；也可用 `--mode copy` 将资源复制到目标 agent 目录，lock 会记录并复现该模式。
+- 安装模式：默认 `--mode copy` 将资源复制到目标 agent 目录；也可用 `--mode link` 使用软链，lock 会记录并复现该模式。
 - 默认 agent：`agent use <agent>` 默认写当前项目 `.himan/config.json`；加 `--global` 写入 `~/.himan/config.json`。当前项目配置优先于全局配置。
 
 版本以 Git tag 为准，格式：`rule/my-rule@1.0.0`。更多设计见 [docs/mvp](./docs/mvp/README.md)。

package/dist/cli/shared.js

@@ -12,7 +12,7 @@ export function createBaseProgram(name, description) {
             // Parse/usage errors are unified by writeCliError().
         },
     });
-    program.name(name).description(description).version(PACKAGE_VERSION);
+    program.name(name).description(description).version(PACKAGE_VERSION, "-v, --version");
     return program;
 }
 export async function runAction(action) {

package/dist/services/index.js

@@ -183,11 +183,11 @@ export class ServiceFactory {
         const source = await this.loadSourceFromConfig();
         return source.history(type, name);
     }
-    async install(type, name, version, projectDir, agents, mode = "link") {
+    async install(type, name, version, projectDir, agents, mode = "copy") {
         const { source, sourceInfo } = await this.loadSourceWithInfoFromConfig();
         return this.installWithSource(source, sourceInfo, type, name, version, projectDir, agents, mode);
     }
-    async installGlobal(type, name, version, projectDir, agents, mode = "link") {
+    async installGlobal(type, name, version, projectDir, agents, mode = "copy") {
         const source = await this.loadSourceFromConfig();
         return this.installWithSource(source, undefined, type, name, version, projectDir, agents, mode, "global");
     }
@@ -431,7 +431,7 @@ export class ServiceFactory {
         await fs.symlink(sourcePath, targetPath, "dir");
     }
     resolveInstallMode(mode) {
-        return mode === "copy" ? "copy" : "link";
+        return mode === "link" ? "link" : "copy";
     }
     async resolveInstalledResource(projectDir, type, name) {
         const locked = await this.getLockedResource(projectDir, type, name);

package/docs/development.md

@@ -13,7 +13,7 @@
 ```bash
 pnpm install
 pnpm run build
-pnpm run dev -- --help
+pnpm cli --help
 node dist/bin/himan.js --help
 ```
 
@@ -28,6 +28,7 @@ pnpm test
 | 命令 | 作用 |
 |------|------|
 | `pnpm run clean` | 删除 `dist/` |
+| `pnpm cli <subcommand>` | 从源码运行主 CLI |
 | `pnpm run build` | 清理并编译 TypeScript 到 `dist/` |
 | `pnpm run typecheck` | 运行 TypeScript 类型检查，不输出文件 |
 | `pnpm test` | 运行 Vitest 一次 |

package/docs/mvp/README.md

@@ -43,7 +43,7 @@
 - 也支持 `himan install`（无参数）按 `himan.lock` 批量复现安装。
 - 未指定版本则安装该资源最新 tag 对应版本。
 - 若本地 store 中已有该版本缓存，则复用、不重新从 Git 导出；否则导出到 store。
-- 在项目下按安装模式创建目标（默认 `--mode link` 软链；`--mode copy` 复制）。
+- 在项目下按安装模式创建目标（默认 `--mode copy` 复制；`--mode link` 软链）。
 - 目标路径由 agent 和资源类型共同决定：
   - `cursor` -> `.cursor/{rules|commands|skills}/<name>`
   - `claude-code` -> `.claude/{rules|commands|skills}/<name>`
@@ -91,7 +91,7 @@
 - **领域**：资源类型、版本、路径约定
 - **适配**：Git 实现 + Registry 预留；扫描与解析元数据；版本计算；配置与全局路径
 
-**原则：** store 按版本目录追加、不覆盖已有缓存；开发目录与项目安装目标分离；项目侧默认以软链引用资源，也支持复制。
+**原则：** store 按版本目录追加、不覆盖已有缓存；开发目录与项目安装目标分离；项目侧默认复制资源，也支持软链引用。
 
 ### 3.2 目录与数据
 

package/docs/mvp/impl.md

@@ -44,7 +44,7 @@
 - 命令层接受 `rule|command|skill`
 - 无版本则取该资源历史中的最新 semver
 - 若本地 store 已有该版本目录则不再从 Git 导出；否则从对应 tag 导出资源树到 store
-- 在项目中按 agent 和资源类型创建/更新安装目标，例如 `cursor -> .cursor/{rules|commands|skills}`、`codex -> .agents/{rules|commands|skills}`；默认软链到 store 中该版本，也可通过 `--mode copy` 复制内容
+- 在项目中按 agent 和资源类型创建/更新安装目标，例如 `cursor -> .cursor/{rules|commands|skills}`、`codex -> .agents/{rules|commands|skills}`；默认复制 store 中该版本，也可通过 `--mode link` 软链引用
 
 ### 2.5 `dev <type> <name>`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hi-man/himan",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Prompt and agent asset management CLI",
   "keywords": [
     "ai",
@@ -51,7 +51,7 @@
     "clean": "rm -rf dist",
     "prebuild": "rm -rf dist",
     "build": "tsc -p tsconfig.json",
-    "dev": "tsx src/bin/himan.ts",
+    "cli": "tsx src/bin/himan.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",