@fifine/aim-studio 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mindfold LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+<p align="center">
+  <img src="assets/trellis.png" alt="AIM Studio Logo" width="500" style="image-rendering: -webkit-optimize-contrast; image-rendering: crisp-edges;">
+</p>
+
+# AIM Studio (原 Trellis)
+
+> **专注于 AI 漫剧与小说创作的智能 CLI 工作流工具**
+>
+> *让规范成为习惯，让创意无限延伸*
+
+[![npm version](https://img.shields.io/npm/v/@fifine/aim-studio.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@fifine/aim-studio)
+> **Note**: This is a specialized CLI tool for AI-assisted comic and drama creation.
+[![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
+
+---
+
+## 📖 简介
+
+**AIM Studio** 是一个专为 AI 辅助创作（漫剧、小说、剧本）设计的 CLI 工具。它继承了 Trellis 的核心能力——**全自动上下文注入**，并针对创作场景进行了专门优化。
+
+无论你是使用 Claude Code、Cursor 还是其他 AI 助手，AIM Studio 都能确保 AI 始终遵循你设定的世界观、角色档案和剧本格式，彻底解决 AI "写着写着就忘了设定" 的痛点。
+
+## ✨ 核心特性
+
+| 特性 | 解决的问题 |
+| --- | --- |
+| **全自动设定注入 (Spec Injection)** | 角色、世界观、剧本格式自动注入 AI 上下文。写一次，永久生效。 |
+| **AI 漫剧主笔 (Story Agent)** | 专用的 AI 代理，懂得先完善设定再写剧本，严格遵守分镜规范。 |
+| **一键启动 (Quick Start)** | `/aim:story` 指令一键初始化创作项目，零门槛上手。 |
+| **多任务并行 (Parallel Sessions)** | 同时推进多个故事线，互不干扰。 |
+| **持久化记忆 (Session Persistence)** | 自动记录创作日志，AI 永远记得上一次的剧情进展。 |
+
+## 🚀 快速开始
+
+### 1. 安装
+
+```bash
+npm install -g @mindfoldhq/aim-studio
+```
+
+### 2. 初始化项目
+
+在你的创作目录下：
+
+```bash
+aim init -u 你的笔名
+```
+
+### 3. 开始创作
+
+使用专用指令启动漫剧创作模式：
+
+```bash
+# 创建并启动一个新故事
+/aim:story "由AI统治的古代王朝"
+```
+
+或者手动启动：
+
+```bash
+aim task create "第一章：觉醒" --type story
+aim start
+```
+
+## 📚 创作工作流
+
+### 第一步：完善设定 (World Building)
+
+AIM Studio 会并在 `.aim-studio/spec/story/` 目录下生成标准模板：
+- `character.md` (角色档案)
+- `world.md` (世界观)
+- `script.md` (剧本规范)
+
+**AI 会自动读取这些文件**。你只需要告诉 AI："帮我完善主角'林风'的性格设定"，它就会基于模板进行填充。
+
+### 第二步：剧本生成 (Scripting)
+
+AI 将严格按照 `script.md` 定义的格式输出剧本，支持直接导出为分镜描述：
+
+> **场次 1：废弃仓库 - 深夜 - 紧张**
+> 
+> 李明：(喘着粗气) 别过来！
+
+### 第三步：AI 绘画对接 (Visualizing)
+
+Story Agent 懂得将剧本描述转换为 Stable Diffusion 或 Midjourney 的提示词 (Prompts)，助力漫剧视觉化。
+
+## � 指令参考手册
+
+### 1. 终端命令 (CLI)
+这些命令在你的系统终端（Terminal/PowerShell）中运行：
+
+| 命令 | 说明 | 示例 |
+| --- | --- | --- |
+| `aim init` | 初始化一个新的 AIM Studio 项目 | `aim init -u 笔名` |
+| `aim update` | 更新当前项目的配置和脚本到最新版本 | `aim update` |
+
+### 2. AI Slash 命令
+这些命令在 AI 助手（如 Claude Code）的对话框中运行：
+
+| 命令 | 说明 | 使用场景 |
+| --- | --- | --- |
+| `/aim:story` | **[核心]** 启动漫剧/小说创作模式 | 创作新故事、开始新章节 |
+| `/aim:visualize` | **[创作]** 生成分镜提示词 | 将剧本转换为 AI 绘画指令 |
+| `/aim:check-story` | **[质检]** 检查剧情逻辑 | 检查 OOC、逻辑漏洞、设定冲突 |
+| `/aim:export` | **[发布]** 导出排版 | 生成适合发布的最终文本 |
+| `/aim:start` | 启动通用开发任务 | 日常创作、维护 |
+| `/aim:finish-work` | 结束当前任务并生成进度日志 | 每次结束工作前必做 |
+| `/aim:record-session` | 记录当前会话摘要（不结束任务） | 长时间工作的中途存档 |
+
+> **提示**: 所有 Slash 命令本质上都是在调用 `.aim-studio/scripts/` 下的 Python 脚本或 Agent 指令。
+
+## �💡 最佳实践示例：小说改漫剧
+
+假设你想将小说**《我真没想重生啊》**改编为漫剧：
+
+1.  **准备素材**:
+    将小说原文保存为 TXT 文件，建议存放在 `.aim-studio/materials/` 目录下。
+    > 例如：`.aim-studio/materials/wozhenmeixiangchongshengan.txt`
+
+2.  **启动项目**:
+    ```bash
+    /aim:story "我真没想重生啊-漫剧版"
+    ```
+
+3.  **下达指令**:
+    在 AI 会话中输入：
+    > "请读取 `.aim-studio/materials/wozhenmeixiangchongshengan.txt` 的第一章内容。
+    > 提取其中的核心冲突和陈汉升的性格特征，完善 `character.md`。
+    > 然后将第一章改编为分镜剧本。"
+
+AI 将会自动分析原文，提取“渣男”陈汉升的性格关键词（腹黑、痞气），并生成第一话的分镜脚本。
+
+## 🛠️ 高级用法
+
+### 并行创作
+
+```bash
+aim parallel
+```
+同时开启多个 AI 会话（Git Worktree 隔离），一边写大纲，一边写细纲，互不阻塞。
+
+### 进度保存
+
+```bash
+/aim:finish-work
+```
+自动生成本次创作的小结，并更新进度索引。下次启动时 AI 会自动回顾。
+
+## 🤝 参与贡献
+
+欢迎提交 Issue 或 PR！
+
+- [GitHub 仓库](https://github.com/mindfold-ai/trellis)
+- [开发指南](CLAUDE.md)
+
+## 📄 许可证
+
+MIT License. Made by [Mindfold LLC](https://github.com/mindfold-ai).

package/bin/aim.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import("../dist/cli/index.js");

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+import { VERSION, PACKAGE_NAME } from "../constants/version.js";
+export { VERSION, PACKAGE_NAME };
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,89 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+import { update } from "../commands/update.js";
+import { DIR_NAMES } from "../constants/paths.js";
+import { VERSION, PACKAGE_NAME } from "../constants/version.js";
+import { compareVersions } from "../utils/compare-versions.js";
+// Re-export for backwards compatibility (consumers should prefer constants/version.js)
+export { VERSION, PACKAGE_NAME };
+/**
+ * Check if a Trellis update is available (compare project version with CLI version)
+ */
+function checkForUpdates(cwd) {
+    const versionFile = path.join(cwd, DIR_NAMES.WORKFLOW, ".version");
+    if (!fs.existsSync(versionFile))
+        return;
+    const projectVersion = fs.readFileSync(versionFile, "utf-8").trim();
+    const cliVersion = VERSION;
+    const comparison = compareVersions(cliVersion, projectVersion);
+    if (comparison > 0) {
+        // CLI is newer than project - update available
+        console.log(chalk.yellow(`\n⚠️  Trellis update available: ${projectVersion} → ${cliVersion}`));
+        console.log(chalk.gray(`   Run: trellis update\n`));
+    }
+    else if (comparison < 0) {
+        // CLI is older than project - CLI needs updating
+        console.log(chalk.yellow(`\n⚠️  Your CLI (${cliVersion}) is older than project (${projectVersion})`));
+        console.log(chalk.gray(`   Run: npm install -g ${PACKAGE_NAME}\n`));
+    }
+}
+// Check for updates at CLI startup (only if .aim-studio exists)
+const cwd = process.cwd();
+if (fs.existsSync(path.join(cwd, DIR_NAMES.WORKFLOW))) {
+    checkForUpdates(cwd);
+}
+const program = new Command();
+program
+    .name("trellis")
+    .description("AI-assisted development workflow framework for Cursor, Claude Code and more")
+    .version(VERSION, "-v, --version", "output the version number");
+program
+    .command("init")
+    .description("Initialize trellis in the current project")
+    .option("--claude", "Include Claude Code commands")
+    .option("-y, --yes", "Skip prompts and use defaults")
+    .option("-u, --user <name>", "Initialize developer identity with specified name")
+    .option("-f, --force", "Overwrite existing files without asking")
+    .option("-s, --skip-existing", "Skip existing files without asking")
+    .option("-t, --template <name>", "Use a remote spec template (e.g., electron-fullstack)")
+    .option("--overwrite", "Overwrite existing spec directory when using template")
+    .option("--append", "Only add missing files when using template")
+    .action(async (options) => {
+    try {
+        await init(options);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program
+    .command("update")
+    .description("Update trellis configuration and commands to latest version")
+    .option("--dry-run", "Preview changes without applying them")
+    .option("-f, --force", "Overwrite all changed files without asking")
+    .option("-s, --skip-all", "Skip all changed files without asking")
+    .option("-n, --create-new", "Create .new copies for all changed files")
+    .option("--allow-downgrade", "Allow downgrading to an older version")
+    .option("--migrate", "Apply pending file migrations (renames/deletions)")
+    .action(async (options) => {
+    try {
+        await update({
+            dryRun: options.dryRun,
+            force: options.force,
+            skipAll: options.skipAll,
+            createNew: options.createNew,
+            allowDowngrade: options.allowDowngrade,
+            migrate: options.migrate,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,13 @@
+interface InitOptions {
+    claude?: boolean;
+    yes?: boolean;
+    user?: string;
+    force?: boolean;
+    skipExisting?: boolean;
+    template?: string;
+    overwrite?: boolean;
+    append?: boolean;
+}
+export declare function init(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAmSA,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsR9D"}