- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add SwotAtmk/infinite-creation --skill ic-writer -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add SwotAtmk/infinite-creation --skill ic-writer -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add SwotAtmk/infinite-creation --skill ic-writer -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add SwotAtmk/infinite-creation --skill ic-writer -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/SwotAtmk/infinite-creation/tree/HEAD/harness-skills/ic-writerTừ nhà phát hành
外部 Agent 通过 HTTP API 把文本内容写进一个已在运行的 infinite-creation 实例。
只写文字:项目、小说原文、剧本、分镜、人物圣经/风格、素材提示词。既能写新项目,也能改已生成的 LLM 产物。
绝不触发生成(图片/视频/语音/音乐/导出),绝不删除项目,只经 HTTP API 读写(不直连 data/ic.db、不手改 data/ 与 config.json)。
DELETE /api/projects/:id。日志的唯一清理时机就是用户在界面手动删项目。回滚接口也会拒绝「回滚掉项目创建」。GET 现在的状态(章节标题、分镜 idx、已有内容),写完再 GET 回读校验。用户可能同时在界面上改;要覆盖已有内容时,先读回来确认自己要覆盖的就是它。cmd.exe 的 %* 会把裸换行当成命令结束,静默截断你传的小说。用 Node 读文件拼 JSON,或 curl --data-binary @body.json。PUT …/storyboard),不要一条条乱序插;整章一次调用 = 一个批次,写坏了整批回滚。batch_id,可整批回滚。GET /api/projects/:id 看 status:是 running 就等(或让用户先停任务)——运行中的任务正持着当前分镜行,删除类写入会被直接拒(409),内容类写入也可能被任务用旧数据覆盖,最后「成片与分镜表对不上」。duration 1~15 秒;dialogue 字数 ≤ duration × 5.5(超速会被 TTS/H3 压成听不清的模糊声);单个分镜说话人 ≤ 2(每说话人一段参考音色);resolution ∈ 360P/480P/720P/768P/1080P/2K/4K/custom(空串 = 继承项目设置);aspect_ratio ∈ 1:1/2:3/3:2/3:4/4:3/9:16/16:9/21:9;idx 从 1 起、同章内不重复。项目级同名两项(POST /api/projects、PATCH /api/projects/:id)用同一份枚举:分镜会继承项目设置,项目这一层写错会让整个项目在渲染阶段才炸,同样 400。{base}/api/... 读和写:禁止打开 data/ic.db(node:sqlite/sqlite3/任何 DB 客户端,读也不许)、禁止直接改 data/ 下的文件或 config.json。绕过去就没有变更日志(不可回滚、source 记不上、批次不成立),详见下一节。本技能的唯一读写通道是 {base}/api/...。即使 data/ic.db 就在手边,也不要打开它——绕过去等于把本技能赖以成立的三样东西一起毁掉:每次变更的原始行快照、source(这条改动是谁写的)、batch_id(整个操作可整批回滚)。
API 读不到、或改不了的 → 直接告诉用户缺什么,不要自己去库/文件里补(接口没提供的能力就不在本技能范围内,例如删除项目)。
写文本时若发现「这个字段要等生成才有值」(如 shots.status、video_path),直接跳过——那是生成链路的产物,不是你要写的东西。
IC_BASE_URL,默认 http://127.0.0.1:4600。server.host 配成 0.0.0.0,它就是一台对局域网开放的写入端点——遇到这种配置先提醒用户改回本机。GET {base}/api/health 期望 {"ok":true}。node -e 发请求:跨 shell 一致、不用跟引号搏斗。# 探活
node -e "fetch(process.env.IC_BASE_URL||'http://127.0.0.1:4600'+'/api/health').then(r=>r.json()).then(o=>console.log(o))"
以下示例统一用这个辅助写法(PowerShell / cmd / bash 通用):
# 读:列项目
node -e "fetch('http://127.0.0.1:4600/api/projects').then(r=>r.json()).then(o=>console.log(JSON.stringify(o,null,2)))"
# 写:body 从文件读(长文本必用)
node -e "const fs=require('fs');fetch('http://127.0.0.1:4600/api/projects/PID/chapters',{method:'POST',headers:{'content-type':'application/json'},body:fs.readFileSync('body.json')}).then(async r=>console.log(r.status,JSON.stringify(await r.json())))"
分镜可写字段(白名单外一律 400 报错):
chapter, idx, scene_name, camera, visual, dialogue, narration, sub_shots,
duration, resolution, aspect_ratio, video_prompt,
character_ids, scene_ids, prop_ids, costume_ids, age_ids, audio_ids, references
status / error / video_path / video_prompt_used / prompt_id / seed 是生成产物,不可写(防伪造「已生成」)。
seed 尤其别写:渲染链路从不读 shots.seed,每次渲染都现取一个随机种子回写,所以写进去的值下一次渲染就被覆盖,且它不进变更日志、回滚也恢复不了——写了等于没写。
resolution / aspect_ratio 只接受枚举值(见铁律 8);duration / idx 有区间约束。
数组字段的元素必须是字符串:塞对象([{id:'x'}])会被 400 拒绝,不会静默变成 "[object Object]"。
同一个写入 API 也用于修正已经生成过的内容——正是本技能的常见用途:
注意两点:
video_prompt 改过之后,应用下次跑渲染阶段会重出这条镜头(应用自己按 video_prompt_used 判定,不需要你触发)。这在预期内,但要在交付说明里告诉用户。status / error / video_path / video_prompt_used / prompt_id / seed 一律 400 拒绝——它们是生成链路的结果,写不进去也伪造不出「已生成」;seed 还会被下一次渲染覆盖。BASE=http://127.0.0.1:4600
# 0) 探活 + 建项目(记下返回的 id)
# 1) 写 3 章小说:chapters POST ×3(title 省略则自动「第N章」)
# 2) 写每章剧本:chapters/:cid PATCH {script:"..."}
# 3) 整章写分镜:chapters/:cid/storyboard PUT {shots:[{scene_name,camera,visual,dialogue,duration,...}]}
# 4) 回读校验:GET chapters → shotCount;GET shots → 逐条核对 idx/字段
分镜一条的示例:
{
"scene_name": "雨夜巷口",
"camera": "中景缓推",
"visual": "少女撑黑伞立于巷口,霓虹倒映积水,雨丝斜落",
"dialogue": "(低声)你终于来了。",
"narration": "",
"sub_shots": "0-3s 推近;3-5s 停住",
"duration": 5,
"character_ids": [],
"video_prompt": ""
}
# 看最近日志(谁改的、改了哪条、前后快照)
node -e "fetch('$BASE/api/projects/PID/logs?limit=20').then(r=>r.json()).then(o=>{for(const l of o.items)console.log(l.ts,l.source,l.entity,l.action,l.entity_id)})"
# 撤销一次调用:用那次的 batch_id 整批回滚
node -e "fetch('$BASE/api/projects/PID/logs/rollback',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({batch_id:'BATCH_ID'})}).then(async r=>console.log(r.status,await r.text()))"
log_id(单条)/ batch_id(整批)/ since_ts(该时刻含之后全部内容变更)。
batch_id:单条 log_id 只恢复那一条——回滚「删章节」时章节回来了,它的分镜不会(分镜各有自己的删除日志)。要「整个操作一起还原」就用那次的 batch_id。since_ts 只覆盖内容变更,不会反转此前的回滚(要重做请显式回滚那条 action='rollback' 的日志)。conflicts(当前值 vs 期望值)。确认要覆盖新改动才加 force:true。skipped 里的 reason 会说明为什么某条没回滚(例如「项目创建不可回滚(禁止删项目)」)。applied: [] + rolled_back: true(不会留下「改了一半」的状态)。{base}/api/...:没打开过 data/ic.db(只读也不行),没改 data/ 下的文件与 config.jsonDELETE /api/projects/... 一次都没调用GET /api/projects/:id,status 不是 runningnovel/script 都回读确认非空;被改写的内容与用户要求一致shotCount 与预期一致,idx 连续、chapter 落在正确章节把内容写进一个正在运行的 infinite-creation 实例(本地漫剧/短视频创作 Agent):新建项目、写小说原文、写剧本、写分镜、写人物圣经/风格,也能改写**已经生成过的** LLM 产物。只走它的文本写入 API:读写一律通过 HTTP API,不直连数据库/文件;不触发生图/生视频/配音/配乐/导出,不删除项目。触发场景:用户要把小说/剧本/分镜「写进 infinite-crea
---name: ic-writerdescription: 把内容写进一个正在运行的 infinite-creation 实例(本地漫剧/短视频创作 Agent):新建项目、写小说原文、写剧本、写分镜、写人物圣经/风格,也能改写**已经生成过的** LLM 产物。只走它的文本写入…---# harness-skills/ic-writer/SKILL.mdTổng quan
把内容写进一个正在运行的 infinite-creation 实例(本地漫剧/短视频创作 Agent):新建项目、写小说原文、写剧本、写分镜、写人物圣经/风格,也能改写**已经生成过的** LLM 产物。只走它的文本写入 API:读写一律通过 HTTP API,不直连数据库/文件;不触发生图/生视频/配音/配乐/导出,不删除项目。触发场景:用户要把小说/剧本/分镜「写进 infinite-creation」「导入项目」「批量建项目」「写入分镜表」,或要改写/覆盖已有项目里已生成的章节、剧本、分镜、提示词。不负责也无法触发生成链路(那些在应用界面里跑)。
Câu hỏi thường gặp
Tải harness-skills/ic-writer/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/SwotAtmk/infinite-creation.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.
replace:falseidx| GET / POST | /api/projects/:id/shots | POST 见下 | 列 / 建单个分镜 |
| PATCH / DELETE | /api/projects/:id/shots/:sid | PATCH 见下 | 改 / 删单个分镜(删除在任务运行中 409) |
| GET | /api/projects/:id/logs | 查询串 entity/action/source/limit/offset | 变更日志(回滚依据) |
| POST | /api/projects/:id/logs/rollback | {log_id} | {batch_id} | {since_ts},可加 force:true | 回滚。章节改名会级联迁移该章分镜、两者同属一个 batch_id:要撤销改名请按 batch_id 回滚(只给 log_id 只还原章节那一行,分镜仍指向旧标题 → 从章节视图消失、成片里被排到最末) |
| GET | /api/projects/:id/assets | — | 素材(人物/场景/道具/音色/音乐),只读为主 |