mudden2380078550-creator/write-chinese-long-screenplay 预览 preview

mudden2380078550-creator/write-chinese-long-screenplay

面向中文小说与剧本的本地创作控制工具。AI负责理解与创作,本程序保存作品状态、构建上下文、检查候选并共同提交正文与状态。保留 write-chinese-long-screenplay 作为Codex Skill入口。

catalog descriptioncatalog 简介 / catalog description:中文电影与剧集长剧本写作 skill

Project Overview项目介绍

This is a local creation control tool built for Chinese long-form novels and screenplays. It functions as a compatible agent skill across multiple AI agent platforms, including DeepSeek Harness (DSH), Claude Code, and Codex. It does not generate content on its own; instead, it manages project state, structures context for the hosting AI agent, checks AI-generated candidate drafts, and stores both finalized text and project state in a standardized directory structure. The tool keeps its source code, user installation instances, and individual work directories completely separate, and it never automatically calls LLMs, syncs projects to cloud servers, or publishes user works.

It is designed for independent Chinese creators who collaborate with AI on long-form writing. To start a new project, users run a command line script to initialize a new project directory with a specified title and format. Next, the user imports raw source material, and the hosting AI extracts entities, writing rules, and chapter outlines into a structured JSON proposal, which the user reviews before the tool applies the proposal to the project. Each writing unit is then processed sequentially, with the tool managing state and archiving approved content.

The tool is written in pure Python, requires Python 3.10 or newer, and has no third-party runtime dependencies, so users can install it as a global command via pip. It is released under the open-source GPL-3.0 license, and currently only supports single-user local writing workflows. It does not include distributed locking for cross-device collaboration, and full end-to-end testing has only been completed on Windows. Cross-platform continuous integration is configured but not yet validated, so users are advised to back up projects and store them in separate private repositories for version control.

这是一款面向中文小说与长篇剧本的本地创作控制工具,可作为AI代理技能适配DeepSeek Harness(DSH)、Claude Code和Codex多个平台。它的核心功能是保存创作状态、为AI构建上下文、检查AI生成的候选内容,并统一归档正文和创作状态。本工具不会自动调用大模型,也不会同步作品到云端或发布作品,始终保持工具源码、安装副本和用户作品目录相互独立。

工具面向独立中文创作者,用于配合AI完成长篇小说和剧本创作。用户先通过命令行创建新的创作项目,导入原始创作素材资料,再由AI整理实体、创作规则和章节大纲生成结构化提案,创作者审定确认后工具将提案应用到项目中。之后AI逐创作单元准备上下文、生成正文候选,工具检查状态后归档正式内容。

本工具基于Python开发,要求Python 3.10及以上版本,无第三方运行依赖,可通过pip安装为全局命令。它遵循GPL-3.0开源协议,目前仅支持单用户本地创作,不提供跨设备分布式锁,仅在Windows平台完成完整实测,跨平台CI已配置但尚未验证。创作过程中建议用户单独为作品建立私有仓库同步备份。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 22 stars - an early-stage project星标 22,属于早期项目
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
  • Not DSH-native: a multi-platform tool that may require Node / Electron or another runtime first非 DSH 原生,是多平台兼容工具:可能要先装 Node / Electron 等运行时
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:mudden2380078550-creator/write-chinese-long-screenplay

把 mudden2380078550-creator/write-chinese-long-screenplay 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Narrative Harness 0.4.0

面向中文小说与剧本的本地创作控制工具。AI负责理解与创作,本程序保存作品状态、构建上下文、检查候选并共同提交正文与状态。保留 write-chinese-long-screenplay 作为Codex Skill入口。

工具源码、安装副本和作品目录彼此独立。本项目不会自动调用模型、同步云端或发布作品。

使用

本项目自 v0.4.0 起采用本布局,main 即当前版本;旧版布局以 legacy/ 形式保留在仓库内,历史 Release 与 tag 不受影响。下载请使用 v0.4.0 Release,或直接克隆 main:

git clone https://github.com/mudden2380078550-creator/write-chinese-long-screenplay.git narrative-harness
cd narrative-harness

需要Python 3.10+。源码直接运行,无第三方运行依赖:

python scripts/harness.py project new --root ../my-book --title 我的小说 --format novel
python scripts/harness.py import stage --project ../my-book --source ../资料包.md

之后让AI读取归档资料并填写 proposals/<source-id>.json 中的实体、政策和章节大纲,再执行import apply。用户不必手填JSON;格式由宿主AI处理。程序只做可靠归档,不假装能独立理解自由文本。

安装为命令:

python -m pip install .
harness --help

安装到Codex(destination使用你自己的Skill目录):

python scripts/install_skill.py --destination <skills目录>/write-chinese-long-screenplay --backup-root <备份目录>

安装器先验证独立启动器,再备份已有目录,复制修订后的兼容脚本、Skill及核心运行包。备份路径在输出JSON里。安装副本能移动到另一台有Python的设备,不引用本机源码路径。

不要再把整个工具仓库直接复制到 skills 目录。 请运行上面的安装器。安装后可以对AI说:“使用 write-chinese-long-screenplay,新建一本系统流小说,项目放在工具目录之外;这是资料包,请整理人物、技能、作者控制和大纲,列出仍需我确认的问题。” AI负责填提案,未解决的关键问题仍需审定,不能保证任意宿主都会正确执行。

升级前备份作品和旧Skill。v2作品使用 project migrate --help 查看复制迁移入口,审定迁移报告后再续写,不直接覆盖旧作品。内部开发版0.3.0的锁文件与0.4.0不同,保留原工具处理旧开发项目;不要手工修改版本锁绕过检查。

工具Git仓库只管理工具;每本作品单独建目录、单独选择私有仓库或其他同步方式。本项目没有自动同步功能,同一本作品不要在多个设备同时写入。

完整输入示例见 工作流协议。示范资料见 examples/package.json。

主要命令

命令 用途
project new/configure/doctor/recover 创建、作者配置、完整性检查、恢复中断事务
import stage/apply 原资料归档、接受审定后的结构化资料
unit prepare/submit/check/accept 准备上下文、提交候选、检查、接受正文与状态
unit revalidate 按新政策核对既有章节,不重扣资源
state show --before-unit 查询某章写前状态
revision impact/fork 影响范围、从写前状态创建独立修订作品
project migrate 复制迁移旧v2项目,保留原始文件与历史未知标记
export 只导出已接受且无需重新审查的正文

每个命令可加--help。--budget以字符为单位,不冒充准确token数。业务输出为JSON;0成功,1待审/阻断,2参数/环境错误,3冲突,4需恢复。

作品格式与控制

  • project.json 是项目清单,harness.lock.json 锁定工具/数据版本。
  • canon/entities/ 保存技能、资源、物品、人物等正式实体;canon/policies/ 独立保存作者规则。
  • outline/ 保存独立章节任务书,manuscript/ 保存已接受正文。
  • canon/history/ 保存初始状态、接受事件及对应候选和检查报告,可重放核对当前状态。
  • runs/ 保存本轮上下文、候选与报告,sources/ 保留原件,proposals/ 保存导入提案。
  • .harness/ 是本机锁和中断恢复日志,exports/ 是可再生输出。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev project-blueprint 下一个 Next skills-management →